Beta privada · apertura 23 de diciembre
Consulta una propuesta del SIRE
GET /v1/emisores/{ruc}/sire/propuestas/{id}
Estado de la propuesta y, cuando está lista, sus totales.
| Dato | Valor |
|---|---|
| Permiso | sire:leer |
| Cobro | No cobra. |
Idempotency-Key |
No aplica |
| Herramienta MCP | sire_propuesta_ver (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_. |
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" \ -H "Authorization: Bearer onx_test_…"Respuestas
Sección titulada «Respuestas»Propuesta.
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
id |
string | Sí | Identificador que empieza con sire_. |
emisor_ruc |
string | Sí | RUC de 11 dígitos. Se valida el dígito verificador (módulo 11 de SUNAT). |
registro |
“RVIE” | “RCE” | Sí | RVIE ventas e ingresos; RCE compras. |
periodo |
string | Sí | Periodo tributario AAAAMM. |
estado |
“en_cola” | “procesando” | “lista” | “sin_datos” | “error” | Sí | |
resumen |
object | null | Sí | |
resumen.cantidad |
integer | Sí | |
resumen.base_imponible |
string | Sí | Monto con dos decimales; negativo en notas de crédito. |
resumen.igv |
string | Sí | Monto con dos decimales; negativo en notas de crédito. |
resumen.total |
string | Sí | Monto con dos decimales; negativo en notas de crédito. |
error |
object | null | Sí | |
error.mensaje |
string | Sí | |
creada_en |
string (date-time) | Sí | Fecha y hora ISO 8601 con la zona de Lima (-05:00). |
actualizada_en |
string (date-time) | Sí | Fecha y hora ISO 8601 con la zona de Lima (-05:00). |
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 - 429
limite_uso - 500
error_interno - 501
operacion_no_disponible - 503
no_disponible