Saltar al contenido
Facturador

Consultar RUC o DNI

GET /api/service/{service_type}/{service_number}

Autenticación: Bearer del usuario del tenant (Authorization: Bearer <api_token>).

Consulta los datos de un RUC o DNI en el servicio de consultas de la plataforma (padrón SUNAT / RENIEC). Con el servicio de consultas adicionales activo también admite carné de extranjería, placa y licencia de conducir. Cada consulta exitosa cuenta para el consumo del plan.

⚠️ Este endpoint usa GET por compatibilidad; próximamente tendrá una versión POST.

Quién puede usarlo: cualquier usuario autenticado (administrador o vendedor).

Formato de respuesta: heredado {success, message?, data?} sin paginación. Ante reglas de negocio puede responder HTTP 200 con success: false: revisa siempre success.

Campo Tipo Obligatorio Descripción / valores permitidos
service_type (ruta) string Sí ruc, dni; con consultas adicionales: ce, placa, licencia.
service_number (ruta) string Sí Número a consultar (11 dígitos RUC, 8 DNI).

Respuesta: para ruc, data = {name, trade_name, address, location_id: [dep, prov, dist], condition, state, is_agent_retention}; para dni, data = {name, trade_name, location_id, address, department_id, province_id, district_id, condition, state}. Puede incluir otras claves de primer nivel del proveedor (p. ej. source).

Errores (HTTP 200 con success: false): número no encontrado o inválido; El servicio de consulta de placa no está disponible. Active el servicio de consultas adicionales.

Parámetros

Parámetro Dónde Obligatorio Ejemplo Descripción
service_type ruta sí ruc
service_number ruta sí 20501973522

Respuestas

200 — RUC

{
  "success": true,
  "data": {
    "name": "EMPRESA XYZ S.A.C.",
    "trade_name": "",
    "address": "AV. 2 DE MAYO NRO. 123 LIMA - LIMA - LIMA",
    "location_id": [
      "15",
      "1501",
      "150101"
    ],
    "condition": "HABIDO",
    "state": "ACTIVO",
    "is_agent_retention": false
  },
  "source": "apiperu.dev"
}

200 — No disponible

{
  "success": false,
  "message": "El servicio de consulta de placa no está disponible. Active el servicio de consultas adicionales."
}

Pruébalo

Prueba este endpoint con tu empresa y tu token: elige la URL en Servers, pega el token en Authorize y haz clic en Try it out.