Ir al contenido

Beta privada · apertura 23 de diciembre

Lista resúmenes y comunicaciones de baja

GET /v1/emisores/{ruc}/resumenes

Resúmenes diarios (RC) y comunicaciones de baja (RA) del emisor, con su estado en SUNAT.

Dato Valor
Permiso comprobantes:leer
Cobro No cobra.
Idempotency-Key No aplica
Herramienta MCP resumen_listar (Próximamente)
Nombre En Requerido Tipo Descripción
ruc path Sí string RUC del emisor o contribuyente.
cursor query No string Cursor opaco que devolvió la página anterior en siguiente_cursor.
limite query No integer Cuántos elementos traer (1 a 100; por defecto 20).
desde query No string Fecha AAAA-MM-DD (día en Lima).
hasta query No string Fecha AAAA-MM-DD (día en Lima).
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/emisores/20000000001/resumenes" \
-H "Authorization: Bearer onx_test_…"

Página de resúmenes.

Campo Tipo Requerido Descripción
elementos object[] Sí
elementos[].id string Sí Identificador que empieza con res_.
elementos[].emisor_ruc string Sí RUC de 11 dígitos. Se valida el dígito verificador (módulo 11 de SUNAT).
elementos[].tipo “RC” | “RA” Sí RC resumen diario; RA comunicación de baja.
elementos[].fecha_referencia string (date) Sí Fecha AAAA-MM-DD (día en Lima).
elementos[].estado “en_cola” | “enviado” | “aceptado” | “rechazado” Sí
elementos[].ticket string | null Sí Ticket que dio SUNAT al recibirlo.
elementos[].cantidad_comprobantes integer Sí
elementos[].sunat object | null Sí
elementos[].sunat.codigo string Sí Código de respuesta de SUNAT; 0 es aceptado.
elementos[].sunat.descripcion string Sí
elementos[].sunat.observaciones string[] Sí
elementos[].creado_en string (date-time) Sí Fecha y hora ISO 8601 con la zona de Lima (-05:00).
elementos[].actualizado_en string (date-time) Sí Fecha y hora ISO 8601 con la zona de Lima (-05:00).
siguiente_cursor string | null Sí Pásalo como cursor para la página siguiente; null si ya no hay más.

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