Beta privada · apertura 23 de diciembre
Consulta un RUC
GET /v1/ruc/{ruc}
Razón social, estado, condición y dirección desde el padrón reducido de SUNAT. Gratis hasta el cupo mensual de tu plan; luego se descuenta del saldo.
| Dato | Valor |
|---|---|
| Permiso | datos:leer |
| Cobro | Lectura medida: cuenta contra tu cupo gratis o tu saldo, y puede dar 402. |
Idempotency-Key |
No aplica |
| Herramienta MCP | ruc_consultar (Próximamente) |
Parámetros
Sección titulada «Parámetros»| Nombre | En | Requerido | Tipo | Descripción |
|---|---|---|---|---|
ruc |
path | Sí | string | RUC del emisor o contribuyente. |
X-Request-Id |
header | No | string | Identificador de la petición. Va en cada respuesta; menciónalo al escribir a soporte. |
Ejemplo
Sección titulada «Ejemplo»Contra el sandbox, con una clave onx_test_…:
curl "https://api-sandbox.opennexum.com/v1/ruc/20000000001" \ -H "Authorization: Bearer onx_test_…"Respuestas
Sección titulada «Respuestas»Datos del contribuyente.
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
ruc |
string | Sí | RUC de 11 dígitos. Se valida el dígito verificador (módulo 11 de SUNAT). |
razon_social |
string | Sí | |
estado |
string | null | Sí | Estado en SUNAT, por ejemplo ACTIVO o BAJA DE OFICIO; null si el padrón no lo trae. |
condicion |
string | null | Sí | Condición de domicilio, por ejemplo HABIDO o NO HABIDO; null si el padrón no la trae. |
ubigeo |
string | null | Sí | |
direccion |
string | null | Sí | |
departamento |
string | null | Sí | Del ubigeo, con la tabla del INEI; null si el ubigeo no está en ella. |
provincia |
string | null | Sí | |
distrito |
string | null | Sí | |
padron_actualizado_al |
string (date) | Sí | Fecha del padrón reducido de SUNAT que respondió. |
Errores
Sección titulada «Errores»Cada código tiene su explicación en Errores.
- 400
validacion - 401
clave_invalida - 402
saldo_insuficiente - 402
tope_alcanzado - 403
permiso_faltante - 404
no_encontrado - 429
limite_uso - 500
error_interno - 501
operacion_no_disponible - 503
no_disponible