Ir al contenido

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)
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.

Contra el sandbox, con una clave onx_test_…:

Ventana de terminal
curl "https://api-sandbox.opennexum.com/v1/ruc/20000000001/padrones" \
-H "Authorization: Bearer onx_test_…"

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.

Cada código tiene su explicación en Errores.