Ir al contenido

Estados y envío a SUNAT

La emisión responde de inmediato con el número asignado y status: "pending". El envío a SUNAT ocurre en segundo plano, con reintentos automáticos, así que tu caja no se detiene si SUNAT está lenta o caída.

status Significado ¿Final?
pending Numerado, ya firmado (la respuesta de la emisión trae sunat.hash y links.xml, para imprimir el ticket de inmediato) y en cola para enviar. También vuelve aquí si SUNAT no estaba disponible y se reintentará. No
sending Se está enviando en este momento. No
uncertain Se perdió la comunicación durante el envío y no se sabe si SUNAT lo recibió. El próximo intento verifica en SUNAT antes de reenviar. No
accepted SUNAT lo aceptó (CDR código 0). Sí
observed SUNAT lo aceptó con observaciones (CDR código 4000 o mayor). Es válido; revisa sunat.notes para corregir en próximas emisiones. Sí
rejected SUNAT lo rechazó (código 2000–3999). No es válido: corrige los datos y emite un comprobante nuevo con otro número. Sí
failed No se pudo procesar por una causa que no se resuelve reintentando, como credenciales SOL inválidas o falta de perfil. Contacta a soporte con el sunat.code. Sí
pending ──► sending ──► accepted | observed | rejected | failed
▲ │
└───────────┤ SUNAT no disponible (reintento con espera creciente)
▼
uncertain ──► (verifica en SUNAT) ──► sending …
  • Ante caídas de SUNAT, la API reintenta con espera creciente: 5 s, 10 s, 20 s… hasta 15 minutos entre intentos, durante varias horas.
  • sunat.send_attempts cuenta los intentos realizados.
  • Un comprobante uncertain nunca se reenvía a ciegas: en producción primero se consulta su CDR en SUNAT, para no duplicar ni perder la constancia original.

Registra un webhook para recibir document.accepted, document.rejected y los demás desenlaces apenas ocurran, o consulta GET /v1/documents/{id} con espera progresiva:

  1. Primera consulta 1 segundo después de emitir. Lo normal es que ya esté en accepted.
  2. Si sigue en pending, sending o uncertain, espera 2 s, 5 s, 10 s, 30 s y luego cada minuto.
  3. No consultes en un bucle sin espera: cuenta para tu límite de peticiones.

¿Puedo entregar el comprobante antes de que SUNAT lo acepte?

Sección titulada «¿Puedo entregar el comprobante antes de que SUNAT lo acepte?»

Sí. La normativa permite entregar la representación impresa al cliente en el momento de la venta, y enviar el comprobante a SUNAT dentro del plazo legal. La API se encarga del envío. Lo que sí debes vigilar son los comprobantes que terminen en rejected o failed.