Saltar al contenido principal
Docs Sitio Planes

Consulta RUC

Devuelve la ficha SUNAT de un RUC: razón social, estado, condición, domicilio fiscal, actividades y regímenes. Primero busca en el padrón reducido y, si no está, en SUNAT en línea.

POST https://api.factosperu.com/api/v1/ruc

Solicitud

Encabezados: Authorization: Bearer TU_TOKEN y Content-Type: application/json.

{ "ruc": "20123456789" }

El campo ruc es obligatorio, debe tener 11 caracteres y pasar una validación de dígitos.

Respuesta

Toda respuesta trae success, code, retryable y time, más data si hubo éxito o message si hubo error.

{
  "success": true,
  "code": "found",
  "retryable": false,
  "data": {
    "ruc": "…",
    "nombre_o_razon_social": "…",
    "estado": "…",
    "condicion": "…",
    "direccion": "…",
    "departamento": "…",
    "tipo_contribuyente": "…",
    "fecha_inscripcion": "…",
    "fecha_inicio_actividades": "…",
    "actividades_economicas": [],
    "sistema_emision": "…",
    "sistema_contabilidad": "…",
    "es_agente_de_retencion": "NO",
    "es_buen_contribuyente": "NO"
  },
  "time": 0.12
}

nombre_o_razon_social trae el nombre comercial y, si no tiene, la razón social. Si SUNAT no registra un dato, el campo llega vacío.

Códigos: 200 encontrado; 404 no existe (not_found, retryable: false) o SUNAT no respondió (retryable: true); 422 si no son 11 dígitos (code: invalid_ruc).