Comment un document parcourt les six phases du PSB : de Submit à Delivered ou Failed, avec messages de statut, webhooks et politique de retry.
Un document envoyé via le PSB suit une séquence fixe de phases de traitement — de la soumission à la livraison confirmée ou à l'échec définitif. À chaque point de transition, le PSB publie un message de statut que vous pouvez récupérer via l'API de statut ou capturer via un webhook.
Cet article décrit le flux en détail, les codes de statut et topics publiés par le PSB, comment interroger le statut d'un document et ce qui se passe en cas d'échec de livraison ou de notification webhook.
Submit → Validate → Transform → Route → Acknowledge → Delivered
↘ Failed
PendingValidated, *ReceivedError en cas d'erreurRoutedAcknowledged*Sent, *SentErrorPendingValidatedRoutedDeliveredRejectedFailedSi une tentative de livraison échoue, le PSB reprend automatiquement la livraison avec un backoff exponentiel.
*SentError immédiatHookSentRetryHookSentErrorRemarque : après environ 6 jours (137 heures) sans livraison réussie, le PSB arrête les tentatives. Les événements manqués peuvent être récupérés via l'endpoint batch.
Vous avez deux options. Via l'API de statut (GET …/salesInvoice/{documentId}/status) vous récupérez le statut actuel. Pour le monitoring en temps réel, configurez des webhooks sur les topics pertinents comme InvoiceSent, InvoiceSentRetry et InvoiceSentError.
Le PSB réessaie la livraison automatiquement jusqu'à 8 fois sur environ 3 jours (72 heures). Après échec définitif, {DocumentType}SentError suit et une action manuelle est nécessaire.
Le PSB tente de livrer une notification webhook jusqu'à 12 fois, réparties sur environ 6 jours (137 heures). Après échec définitif, l'événement HookSentError suit.
Voir la documentation API interactive