Vérifier la livraison des factures

Vue d'ensemble

Après l'envoi d'une facture, vous pouvez vérifier son statut de livraison pour vous assurer qu'elle est bien arrivée chez le destinataire. faktoora suit les tentatives de livraison par e-mail, par Peppol et manuelles.

Vérifier le statut de livraison dans l'interface web

1. Ouvrez les détails de la facture dans votre instance faktoora
2. Faites défiler jusqu'à la section « Livraisons » (Delivery)
3. Vous voyez une liste de toutes les tentatives de livraison avec les informations suivantes :
   • Type : mode de livraison (e-mail, Peppol, manuel)
   • Destinataire : adresse e-mail ou identifiant Peppol
   • Statut : statut de livraison actuel
   • Mis à jour le : horodatage du dernier changement de statut

Récupérer le statut de livraison via l'API

Utilisez le point de terminaison API GET /invoices/{faktooraId}/status pour récupérer le statut de livraison :

GET https://api.faktoora.com/api/v1/invoices/{faktooraId}/status

La réponse contient le champ delivery, un tableau regroupant toutes les tentatives de livraison :

{
  "delivery": [
    {
      "type": "email",
      "recipient": "rechnung@beispielkunde.de",
      "carbonCopy": "cc1@example.com",
      "blindCarbonCopy": "bcc@example.com"
    }
  ]
}

Valeurs du statut de livraison

Livraison par e-mail

Les livraisons par e-mail enregistrent les adresses des destinataires sans suivre de statut de livraison en continu. Vous pouvez évaluer la livraison à l'absence de rapports d'erreur ou de notifications de bounce.

Livraison Peppol

Les livraisons Peppol disposent d'un statut de livraison suivi en continu :

• PENDING_GENERATION : le XML de la facture est encore en cours de génération ; la livraison Peppol n'a pas encore été demandée.
• ACTIVE : la transmission est en cours.
• READY : en attente de la prochaine tentative (survient après une erreur lors d'une nouvelle tentative).
• DELIVERED : livraison confirmée par le point de réception.
• REJECTED : refusée par le point de réception.
• FAILED : échec définitif (par ex. en raison d'une erreur de validation).
• SUSPENDED : abandonnée après épuisement des tentatives ou mise en pause ; peut être relancée via POST /invoices/{faktooraId}/dispatch/peppol/resend.

Rapports d'erreur

En cas d'échec d'une livraison Peppol (statut FAILED, REJECTED, SUSPENDED), la réponse peut contenir un champ messages avec des messages d'erreur ou d'avertissement :

{
  "type": "peppol",
  "recipient": "9930:DE123456789",
  "state": "REJECTED",
  "attempts": 3,
  "messages": [
    {
      "level": "ERROR",
      "code": "BR-S-02",
      "text": "Une erreur de validation des règles métier"
    }
  ]
}

Problèmes fréquents

Aucune confirmation de livraison

Par défaut, les livraisons par e-mail n'enregistrent pas de confirmations de livraison des serveurs de messagerie. Si vous souhaitez vérifier qu'une livraison par e-mail a réussi :

1. Consultez l'historique de livraison dans l'interface web
2. Vérifiez les journaux de votre serveur de messagerie (si vous utilisez votre propre serveur SMTP)
3. Demandez au destinataire de confirmer la réception de la facture
4. Vérifiez la présence de notifications de bounce de votre service de messagerie

Échec de la livraison Peppol

Si une livraison Peppol échoue :

1. Consultez les messages d'erreur dans le champ messages
2. Corrigez le problème (par ex. données invalides, informations manquantes)
3. Utilisez POST /invoices/{faktooraId}/dispatch/peppol/resend pour relancer l'envoi
4. Contactez le support faktoora si le problème persiste

Aucune tentative de livraison visible

Si le tableau delivery est vide :

1. La facture n'a peut-être pas encore été envoyée
2. Vérifiez si la facture est encore à l'état de brouillon (draftOnly: true)
3. Assurez-vous d'avoir correctement demandé l'envoi

Surveiller l'historique de livraison

Pour une surveillance automatisée ou une intégration à votre système, vous pouvez interroger régulièrement le statut de livraison :

1. Enregistrez la faktooraId après la création de la facture
2. Interrogez GET /invoices/{faktooraId}/status
3. Vérifiez les changements de statut dans le tableau delivery
4. Mettez en place une gestion des erreurs pour les statuts REJECTED, FAILED ou SUSPENDED