Ir al contenido

Beta privada · apertura 23 de diciembre

Envía el resumen diario de boletas

POST /v1/emisores/{ruc}/resumenes

Arma el resumen diario con las boletas del día que faltan informar y lo envía a SUNAT. Es asíncrono: consulta el resumen con su id.

Dato Valor
Permiso comprobantes:emitir
Cobro No cobra.
Idempotency-Key Obligatoria
Credenciales en la llamada Si envías credenciales, la clave necesita credenciales:por_llamada.
Herramienta MCP resumen_crear (Próximamente)
Nombre En Requerido Tipo Descripción
ruc path Sí string RUC del emisor o contribuyente.
Idempotency-Key header Sí string Identifica una operación para que repetirla no la duplique. Si repites la petición con la misma clave y el mismo cuerpo, recibes la misma respuesta; con otro cuerpo, idempotencia_en_conflicto. Se guarda 24 horas.
X-Request-Id header No string Identificador de la petición. Va en cada respuesta; menciónalo al escribir a soporte.

application/json, obligatorio. Los campos anidados van con punto y los de listas con []. No se aceptan campos desconocidos.

Campo Tipo Requerido Descripción
fecha string (date) Sí Día de emisión de las boletas a informar.
credenciales object No Credenciales por llamada: se usan solo en esta petición y no se guardan. Requiere el permiso credenciales:por_llamada. Si tu RUC usa la bóveda, no las envíes. Para emitir, dar de baja y resúmenes.
credenciales.certificado object Sí Certificado digital del emisor. Nunca se guarda en registros ni se devuelve.
credenciales.certificado.pfx_base64 string (base64) Sí Archivo .pfx o .p12 del certificado digital, en base64.
credenciales.certificado.clave string (password) Sí Contraseña del archivo .pfx.
credenciales.sol object Sí Usuario secundario SOL del emisor. Nunca se guarda en registros ni se devuelve.
credenciales.sol.usuario string Sí Usuario secundario SOL, sin el RUC (lo agregamos con el RUC del emisor).
credenciales.sol.clave string (password) Sí Clave SOL del usuario secundario.

Contra el sandbox, con una clave onx_test_…:

Ventana de terminal
curl -X POST "https://api-sandbox.opennexum.com/v1/emisores/20000000001/resumenes" \
-H "Authorization: Bearer onx_test_…" \
-H "Idempotency-Key: $(uuidgen)" \
-H "Content-Type: application/json" \
-d '{
"fecha": "2026-11-15"
}'

Resumen en cola.

Campo Tipo Requerido Descripción
estado “en_cola” Sí
recurso object Sí Lo que se creó y queda en proceso.
recurso.tipo “comprobante” | “baja” | “resumen” | “guia” | “sire_propuesta” | “mensaje” | “entrega” | “clave” | “conexion” | “webhook” Sí
recurso.id string Sí
consulta_url string Sí Ruta para consultar cómo va.
mensaje string Sí
reintento_en string (date-time) No Próximo intento estimado, si aplica.

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