Consultar RUC (servicio anterior)
GET /api/services/ruc/{ruc_number}
Autenticación: Bearer del usuario del tenant (Authorization: Bearer <api_token>).
Consulta un RUC directamente en la web de SUNAT. Puede fallar si SUNAT cambia su página: usa preferentemente Consultar RUC o DNI.
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.
Errores (HTTP 200 con success: false): RUC inválido o no encontrado.
Parámetros
| Parámetro | Dónde | Obligatorio | Ejemplo | Descripción |
|---|---|---|---|---|
ruc_number |
ruta | sí | 20501973522 |
Respuestas
200 — RUC
{
"success": true,
"data": {
"name": "EMPRESA XYZ S.A.C.",
"trade_name": "XYZ",
"address": "AV. 2 DE MAYO NRO. 123",
"phone": "014271148",
"department": "LIMA",
"department_id": "15",
"province": "LIMA",
"province_id": "1501",
"district": "LIMA",
"district_id": "150101"
}
}
200 — Inválido
{
"success": false,
"message": "Ruc debe tener 11 dígitos"
}
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.