Saltar al contenido principal
Docs Sitio Planes

Padrón RUC y datos públicos

Consultas sobre copias locales de fuentes oficiales (Padrón Reducido RUC de SUNAT, establecimientos anexos, padrón SSCO, ubigeos INEI, puertos y aeropuertos MTC y tipo de cambio) importadas en el servicio interno. No usan navegador ni Clave SOL, por lo que responden en milisegundos.

Disponibilidad: cada conjunto de datos solo responde cuando ya fue importado en el servicio. Si aún no lo está, la API devuelve 503 con code: "dataset_no_disponible". En el padrón RUC, un RUC ausente en la copia local devuelve 404 not_found.

Consumo: cada solicitud enviada al servicio consume 1 unidad del plan, también cuando el resultado es 404 o 503 (consulta enviada). Los rechazos de validación 422 no consumen.

Respuesta exitosa

Misma envoltura que el resto de la API, con el campo adicional source que identifica la fuente.

{
  "success": true,
  "code": "found",
  "retryable": false,
  "data": { … },
  "time": 0.02,
  "source": "sunat_padron_reducido"
}

Consulta RUC en el Padrón Reducido

Busca el RUC en la copia local del Padrón Reducido oficial de SUNAT importada en el servicio. No usa navegador ni credenciales. Responde 404 si el RUC no figura en la copia local (incluido el caso de un padrón aún no importado).

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

Cuerpo JSON

{
    "ruc": "20123456789"
}

Ejemplo de data (valores ficticios)

{
    "ruc": "20123456789",
    "nombre_razon_social": "EMPRESA DEMOSTRACION S.A.C.",
    "estado": "ACTIVO",
    "condicion": "HABIDO",
    "ubigeo": "150101",
    "domicilio_fiscal": "AV. EJEMPLO 123",
    "updated_at": "2026-10-01T00:00:00+00:00"
}
  • 404: Registro no encontrado en la fuente local (`not_found`).
  • 503: El dataset no está importado (`dataset_no_disponible`) o el servicio no responde (`servicio_no_disponible`).
  • 502: Error del proveedor (`proveedor_error`).
  • 422: RUC inválido.

Búsqueda por razón social

Busca contribuyentes por razón social en la copia local del Padrón Reducido. Devuelve una lista (vacía si no hay coincidencias).

GET https://api.factosperu.com/api/v1/padron/buscar
ParámetroUbicaciónObligatorioDescripción
q query Sí Texto de la razón social.
limit query No Máximo de resultados.

Ejemplo de data (valores ficticios)

[
    {
        "ruc": "20123456789",
        "nombre_razon_social": "EMPRESA DEMOSTRACION S.A.C.",
        "estado": "ACTIVO",
        "condicion": "HABIDO",
        "ubigeo": "150101",
        "domicilio_fiscal": "AV. EJEMPLO 123",
        "updated_at": "2026-10-01T00:00:00+00:00"
    }
]
  • 422: Texto de búsqueda ausente o fuera de rango.
  • 502: Error del proveedor (`proveedor_error`).
  • 503: El dataset no está importado (`dataset_no_disponible`) o el servicio no responde (`servicio_no_disponible`).

Establecimientos anexos de un RUC

Lista los establecimientos anexos del RUC según el dataset oficial importado en el servicio.

GET https://api.factosperu.com/api/v1/ruc/{ruc}/establecimientos
ParámetroUbicaciónObligatorioDescripción
ruc ruta Sí

Ejemplo de data (valores ficticios)

[
    {
        "ruc": "20123456789",
        "codigo": "0001",
        "tipo": "SUCURSAL",
        "direccion": "AV. EJEMPLO 456"
    }
]
  • 404: Registro no encontrado en la fuente local (`not_found`).
  • 503: El dataset no está importado (`dataset_no_disponible`) o el servicio no responde (`servicio_no_disponible`).
  • 502: Error del proveedor (`proveedor_error`).
  • 422: RUC inválido.

Sujeto sin capacidad operativa (SSCO)

Indica si el RUC figura en el padrón oficial de Sujetos Sin Capacidad Operativa importado en el servicio. 404 significa que no figura en la copia importada.

GET https://api.factosperu.com/api/v1/ssco/{ruc}
ParámetroUbicaciónObligatorioDescripción
ruc ruta Sí

Ejemplo de data (valores ficticios)

{
    "RUC": "20123456789",
    "RAZON SOCIAL": "EMPRESA DEMOSTRACION S.A.C."
}
  • 404: Registro no encontrado en la fuente local (`not_found`).
  • 503: El dataset no está importado (`dataset_no_disponible`) o el servicio no responde (`servicio_no_disponible`).
  • 502: Error del proveedor (`proveedor_error`).
  • 422: RUC inválido.

Ubigeos (INEI)

Busca códigos de ubigeo en el dataset oficial importado en el servicio.

GET https://api.factosperu.com/api/v1/ubigeos
ParámetroUbicaciónObligatorioDescripción
q query No Texto a buscar en el registro. Vacío devuelve los primeros registros.
limit query No Máximo de registros.

Ejemplo de data (valores ficticios)

[
    {
        "ubigeo": "150101",
        "departamento": "LIMA",
        "provincia": "LIMA",
        "distrito": "LIMA"
    }
]
  • 422: Parámetros inválidos.
  • 502: Error del proveedor (`proveedor_error`).
  • 503: El dataset no está importado (`dataset_no_disponible`) o el servicio no responde (`servicio_no_disponible`).

Puertos (MTC)

Busca puertos en el dataset oficial del MTC importado en el servicio.

GET https://api.factosperu.com/api/v1/puertos
ParámetroUbicaciónObligatorioDescripción
q query No Texto a buscar en el registro. Vacío devuelve los primeros registros.
limit query No Máximo de registros.

Ejemplo de data (valores ficticios)

[
    {
        "codigo": "PECLL",
        "nombre": "CALLAO"
    }
]
  • 422: Parámetros inválidos.
  • 502: Error del proveedor (`proveedor_error`).
  • 503: El dataset no está importado (`dataset_no_disponible`) o el servicio no responde (`servicio_no_disponible`).

Aeropuertos (MTC)

Busca aeropuertos en el dataset oficial del MTC importado en el servicio.

GET https://api.factosperu.com/api/v1/aeropuertos
ParámetroUbicaciónObligatorioDescripción
q query No Texto a buscar en el registro. Vacío devuelve los primeros registros.
limit query No Máximo de registros.

Ejemplo de data (valores ficticios)

[
    {
        "iata": "LIM",
        "nombre": "JORGE CHAVEZ"
    }
]
  • 422: Parámetros inválidos.
  • 502: Error del proveedor (`proveedor_error`).
  • 503: El dataset no está importado (`dataset_no_disponible`) o el servicio no responde (`servicio_no_disponible`).

Tipo de cambio

Devuelve el tipo de cambio de una fecha y moneda (SBS; historial en caché del proveedor). Si ese día no hubo publicación (fin de semana o feriado) responde 404. Para el último publicado usar `GET /api/v1/tipo-cambio/actual`.

GET https://api.factosperu.com/api/v1/tipo-cambio
ParámetroUbicaciónObligatorioDescripción
fecha query Sí Fecha en formato AAAA-MM-DD.
moneda query No Código ISO de la moneda.

Ejemplo de data (valores ficticios)

{
    "fecha": "2026-10-09",
    "moneda": "USD",
    "compra": "VALOR",
    "venta": "VALOR"
}
  • 404: Registro no encontrado en la fuente local (`not_found`).
  • 503: El dataset no está importado (`dataset_no_disponible`) o el servicio no responde (`servicio_no_disponible`).
  • 502: Error del proveedor (`proveedor_error`).
  • 422: Fecha o moneda inválida.

Tipo de cambio actual

Devuelve el último tipo de cambio publicado hasta hoy: el de hoy si ya está publicado; si no, el del día anterior más cercano. `data.fecha` indica a qué día corresponde.

GET https://api.factosperu.com/api/v1/tipo-cambio/actual
ParámetroUbicaciónObligatorioDescripción
moneda query No Código ISO de la moneda.

Ejemplo de data (valores ficticios)

{
    "fecha": "2026-10-09",
    "moneda": "USD",
    "compra": "VALOR",
    "venta": "VALOR"
}
  • 404: Registro no encontrado en la fuente local (`not_found`).
  • 503: El dataset no está importado (`dataset_no_disponible`) o el servicio no responde (`servicio_no_disponible`).
  • 502: Error del proveedor (`proveedor_error`).
  • 422: Moneda inválida.