Beta privada · apertura 23 de diciembre
Lista las líneas de una propuesta del SIRE
GET /v1/emisores/{ruc}/sire/propuestas/{id}/registros
Comprobantes de la propuesta, normalizados. Solo cuando la propuesta está lista.
| Dato | Valor |
|---|---|
| Permiso | sire:leer |
| Cobro | No cobra. |
Idempotency-Key |
No aplica |
| Herramienta MCP | sire_registros_listar (Próximamente) |
Parámetros
Sección titulada «Parámetros»| Nombre | En | Requerido | Tipo | Descripción |
|---|---|---|---|---|
ruc |
path | Sí | string | RUC del emisor. |
id |
path | Sí | string | Identificador que empieza con sire_. |
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. |
Ejemplo
Sección titulada «Ejemplo»Contra el sandbox, con una clave onx_test_…:
curl "https://api-sandbox.opennexum.com/v1/emisores/20000000001/sire/propuestas/sire_8f2c1a7d9e/registros" \ -H "Authorization: Bearer onx_test_…"Respuestas
Sección titulada «Respuestas»Página de líneas.
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
elementos |
object[] | Sí | |
elementos[].tipo_comprobante |
string | Sí | |
elementos[].serie |
string | Sí | |
elementos[].numero |
string | Sí | |
elementos[].fecha_emision |
string (date) | Sí | Fecha AAAA-MM-DD (día en Lima). |
elementos[].contraparte |
object | Sí | |
elementos[].contraparte.tipo_documento |
string | Sí | |
elementos[].contraparte.numero_documento |
string | Sí | |
elementos[].contraparte.nombre |
string | Sí | |
elementos[].moneda |
string | Sí | |
elementos[].tipo_cambio |
string | null | Sí | |
elementos[].base_imponible |
string | Sí | Monto con dos decimales; negativo en notas de crédito. |
elementos[].igv |
string | Sí | Monto con dos decimales; negativo en notas de crédito. |
elementos[].no_gravado |
string | Sí | Monto con dos decimales; negativo en notas de crédito. |
elementos[].total |
string | Sí | Monto con dos decimales; negativo en notas de crédito. |
siguiente_cursor |
string | null | Sí | Pásalo como cursor para la página siguiente; null si ya no hay más. |
Errores
Sección titulada «Errores»Cada código tiene su explicación en Errores.
- 400
validacion - 401
clave_invalida - 403
permiso_faltante - 404
no_encontrado - 409
estado_no_permite - 429
limite_uso - 500
error_interno - 501
operacion_no_disponible - 503
no_disponible