As respostas HTTP, as respostas da API e a aceitação da AEAT são níveis diferentes. Guarde-as separadamente para que o suporte possa reconstruir o sucedido.
Em fila não significa aceite
O envio pode devolver success: true, status: pending e queueId. Isto confirma a entrada na fila. Guarde queueId e utilize check_docs com um máximo de 20 registos por pedido. A referência recomenda aguardar 60–90 segundos antes da consulta.
Estados que exigem atenção
Os exemplos documentam sent e sent_warning. Leia também message: uma aceitação com erros exige revisão. O catálogo completo depende da versão e do ambiente atribuído.
Nem todos os 401 são tokens expirados
A documentação mostra 401 tanto para credenciais incorretas como para dados de fatura inválidos. Verifique success e msg; repetir a autenticação não corrige uma fatura mal formada.
Tratar interrupções
Se a ligação terminar sem resposta, o envio pode ter sido recebido. Recupere o estado ou consulte pela referência antes de repetir. Registe tentativas sem guardar segredos, dados completos de cartão ou certificados.