Beta privada · apertura 23 de diciembre
Nexum Comprobantes
Nexum Comprobantes conecta SUNAT a tu sistema o a tu agente de IA. Emite factura (01), boleta (03), nota de crédito (07) y nota de débito (08), y además resúmenes diarios, comunicaciones de baja, guías de remisión remitente y propuestas del SIRE. Cada comprobante sale con su XML, su CDR y su PDF.
Usa tu propio certificado digital y tu usuario SOL secundario. En el sandbox, las pruebas van contra SUNAT beta.
El camino de una boleta
Sección titulada «El camino de una boleta»- Registra el emisor con
emisor_crear. Si el RUC figura en el padrón de obligados a emitir mediante un OSE, no podemos emitir por él y la API respondeemisor_obligado_ose. - Entrega las credenciales: certificado y usuario SOL. Mira la nota de abajo.
- Crea una serie con
serie_crear. - Valida sin cobrar con
comprobante_validar: revisa el cuerpo y calcula los totales sin enviar nada. - Emite con
comprobante_emitir, conIdempotency-Key. El número lo asigna el servidor. - Descarga el XML, el CDR o el PDF.
Qué responde al emitir
Sección titulada «Qué responde al emitir»| Estado | Qué significa |
|---|---|
201 |
SUNAT lo aceptó (o lo aceptó con observaciones). Se cobra. |
202 en_cola |
SUNAT no respondió. Lo enviamos solo cuando vuelva; no lo repitas y consulta consulta_url. |
202 requiere_confirmacion |
Según tu clave, una persona debe aprobarlo en el panel. Nada se cobró todavía. |
422 sunat_rechazo |
SUNAT lo rechazó. En detalle van el código y la descripción de SUNAT. Se libera la reserva. |
422 credenciales_sunat |
SUNAT no aceptó el certificado o el usuario SOL. |
Se cobra solo si SUNAT acepta: mira Saldo y error 402. La emisión exige Idempotency-Key: mira Idempotencia.
Credenciales
Sección titulada «Credenciales»El certificado y el usuario SOL nunca pasan por el chat de un agente. Hay dos caminos:
- Guardarlas una vez con
credenciales_guardar, a cargo de una persona. Esa ruta no se ofrece a agentes. - Enviarlas en la llamada, en el campo
credencialesde cada cuerpo. No se guardan, y la clave necesita el permisocredenciales:por_llamada.
Mientras la bóveda no esté activa, la API responde boveda_inactiva y debes usar el segundo camino.
Anular y corregir
Sección titulada «Anular y corregir»- Para dar de baja usa
comprobante_anular. Según tu clave, una persona debe aprobarlo. - Si pasó el plazo de SUNAT, responde
plazo_vencido: para una factura, emite una nota de crédito. - Un comprobante en un estado que no admite la operación (por ejemplo, uno rechazado) responde
estado_no_permite. - Las boletas se informan con resúmenes diarios.
Datos oficiales
Sección titulada «Datos oficiales»Con el permiso datos:leer también tienes ruc_consultar, ruc_padrones y tipo_cambio_consultar. El RUC sale del padrón público de SUNAT y el tipo de cambio del BCRP.
Referencia
Sección titulada «Referencia»Todas las rutas están en la referencia de la API, generada desde el contrato.