Ir al contenido

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.

  1. 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 responde emisor_obligado_ose.
  2. Entrega las credenciales: certificado y usuario SOL. Mira la nota de abajo.
  3. Crea una serie con serie_crear.
  4. Valida sin cobrar con comprobante_validar: revisa el cuerpo y calcula los totales sin enviar nada.
  5. Emite con comprobante_emitir, con Idempotency-Key. El número lo asigna el servidor.
  6. Descarga el XML, el CDR o el PDF.
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.

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 credenciales de cada cuerpo. No se guardan, y la clave necesita el permiso credenciales:por_llamada.

Mientras la bóveda no esté activa, la API responde boveda_inactiva y debes usar el segundo camino.

  • 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.

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.

Todas las rutas están en la referencia de la API, generada desde el contrato.