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.
Estados
Sección titulada «Estados»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 …Reintentos automáticos
Sección titulada «Reintentos automáticos»- 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_attemptscuenta los intentos realizados.- Un comprobante
uncertainnunca se reenvía a ciegas: en producción primero se consulta su CDR en SUNAT, para no duplicar ni perder la constancia original.
Cómo saber cuándo terminó
Sección titulada «Cómo saber cuándo terminó»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:
- Primera consulta 1 segundo después de emitir. Lo normal es que ya esté en
accepted. - Si sigue en
pending,sendingouncertain, espera 2 s, 5 s, 10 s, 30 s y luego cada minuto. - 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.