Ir al contenido

Beta privada · apertura 23 de diciembre

Lista las series de un emisor

GET /v1/emisores/{ruc}/series

Series registradas y el último número asignado en cada una.

Dato Valor
Permiso comprobantes:leer
Cobro No cobra.
Idempotency-Key No aplica
Herramienta MCP serie_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).
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/series" \
-H "Authorization: Bearer onx_test_…"

Página de series.

Campo Tipo Requerido Descripción
elementos object[] Sí
elementos[].tipo “01” | “03” | “07” | “08” | “09” Sí 01 factura, 03 boleta, 07 nota de crédito, 08 nota de débito, 09 guía de remisión remitente.
elementos[].serie string Sí
elementos[].ultimo_numero integer Sí Último número asignado; el próximo será este + 1.
elementos[].creada_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.