La réponse HTTP, la réponse de l’API et l’acceptation de l’AEAT sont des niveaux distincts. Conservez-les séparément pour faciliter le diagnostic.
En attente ne signifie pas accepté
L’envoi peut retourner success: true, status: pending et queueId. Cela confirme la mise en file d’attente. Conservez queueId et utilisez check_docs avec au maximum 20 enregistrements par requête. La référence conseille d’attendre 60 à 90 secondes.
Les statuts à examiner
Les exemples présentent sent et sent_warning. Lisez également message : une acceptation avec erreurs nécessite une vérification. Le catalogue complet dépend de la version et de l’environnement attribué.
Tout code 401 n’indique pas un jeton expiré
La documentation présente des réponses 401 pour des identifiants incorrects mais aussi pour des données de facture invalides. Vérifiez success et msg ; répéter l’authentification ne corrige pas une facture mal formée.
Traiter une interruption
Une connexion interrompue sans réponse ne signifie pas que l’envoi n’a pas été reçu. Récupérez son statut ou recherchez sa référence avant de réessayer. Journalisez les tentatives sans conserver de secrets, de données complètes de carte ni de certificats.