La respuesta HTTP, la respuesta de la API y la aceptación de la AEAT son niveles distintos. Guárdalos por separado para que soporte pueda reconstruir qué ocurrió.
Una petición en cola no es un registro aceptado
El envío de factura puede responder con success: true, status: pending y queueId. Esto confirma la recepción en cola. Conserva queueId y utiliza check_docs, con un máximo de 20 registros por petición. La referencia publicada recomienda esperar entre 60 y 90 segundos antes de consultar.
Estados que requieren atención
Los ejemplos documentan sent y sent_warning. Lee también message: una aceptación con errores requiere revisión y no debe mostrarse como si no hubiera incidencias. El catálogo completo y los detalles dependen de la versión y del entorno asignado.
No interpretes todos los 401 como token caducado
La documentación actual muestra respuestas 401 tanto para credenciales incorrectas como para datos de factura no válidos. Comprueba success y msg; reintentar credenciales indefinidamente no corrige una factura mal formada.
Qué hacer ante una interrupción
Si la conexión se interrumpe sin respuesta, no asumas que el envío ha fallado: puede haberse recibido. Recupera su estado o consulta por referencia antes de repetirlo. Conserva un registro de intentos sin incluir secretos ni datos completos de tarjeta o certificados.