Beta privada · apertura 23 de diciembre
Consulta los padrones de un RUC
GET /v1/ruc/{ruc}/padrones
Indica si el RUC es agente de retención, agente de percepción o buen contribuyente, según SUNAT.
| 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_padrones (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/padrones" \ -H "Authorization: Bearer onx_test_…"Respuestas
Sección titulada «Respuestas»Padrones del RUC.
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
ruc |
string | Sí | RUC de 11 dígitos. Se valida el dígito verificador (módulo 11 de SUNAT). |
agente_retencion |
object | Sí | |
agente_retencion.incluido |
boolean | Sí | |
agente_retencion.desde |
string (date) | null | Sí | Desde cuándo figura, si SUNAT lo publica. |
agente_retencion.resolucion |
string | null | Sí | Resolución que lo incorporó, si SUNAT la publica. |
agente_percepcion |
object | Sí | |
agente_percepcion.incluido |
boolean | Sí | |
agente_percepcion.desde |
string (date) | null | Sí | Desde cuándo figura, si SUNAT lo publica. |
agente_percepcion.resolucion |
string | null | Sí | Resolución que lo incorporó, si SUNAT la publica. |
buen_contribuyente |
object | Sí | |
buen_contribuyente.incluido |
boolean | Sí | |
buen_contribuyente.desde |
string (date) | null | Sí | Desde cuándo figura, si SUNAT lo publica. |
buen_contribuyente.resolucion |
string | null | Sí | Resolución que lo incorporó, si SUNAT la publica. |
actualizado_al |
string (date) | Sí | Fecha de la última descarga de los padrones de SUNAT. |
desactualizado |
boolean | Sí | true si la última descarga tiene más días de lo normal: tómalo con cuidado. |
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