Envoyer des factures PDF via Peppol

Envoyer des factures PDF via Peppol avec la PSB eConnect : e-mail ou API, reconnaissance IDR et validation.

Une facture PDF n'est techniquement pas une facture électronique : les données ne sont pas dans un format structuré et l'exactitude ne peut pas être garantie par la seule reconnaissance par scan. Pourtant, eConnect propose une solution pour envoyer des factures PDF via Peppol. La PSB reconnaît le PDF via l'IDR (Intelligent Document Recognizer), valide les champs essentiels par rapport aux métadonnées que vous fournissez, et en fait une facture électronique valide.

Comment ça fonctionne : vous envoyez le PDF avec un ensemble de métadonnées de contrôle (numéro de facture, montants, destinataire). L'IDR reconnaît la facture et compare la reconnaissance avec vos métadonnées. Tout correspond ? La facture est envoyée. Ça ne correspond pas ? Vous recevez une notification.

Remarque : cette page décrit l'envoi d'un PDF seul sans UBL (reconnaissance par l'IDR sur la base des métadonnées fournies). Souhaitez-vous plutôt joindre un PDF à une facture électronique que vous fournissez déjà en UBL ? Voir alors Inclure des pièces jointes dans Envoyer une facture via l'API.

Deux méthodes de soumission

Il existe deux façons de soumettre une facture PDF à la PSB. Les deux méthodes nécessitent les mêmes métadonnées.

Méthode 1 : par e-mail

Envoyez le PDF en pièce jointe à l'adresse e-mail sécurisée de votre tenant PSB. Dans le corps de l'e-mail, indiquez les métadonnées de contrôle au format Markdown :

[factuurnummer](INV-2026-0042)
[totaalfactuur](1.250,00)
[totaalbtw](262,50)
[ontvangerSchemeId](0106)
[ontvangerIdentifier](12345678)
[ontvangerNaam](Voorbeeldbedrijf B.V.)
[ontvangerEmail](finance@voorbeeld.nl)

Les tags entre crochets sont définis lors de la configuration initiale. Il est important qu'ils ne changent plus une fois la connexion en production.

Remarque : L'adresse e-mail exacte et les tags disponibles sont configurés par client par eConnect. Contactez le TechSupport pour la configuration initiale.

Méthode 2 : via l'API GenericSend

Envoyez le PDF à l'API GenericSend et fournissez les métadonnées en tant que metaAttributen (paires clé-valeur) :

{
  "factuurnummer": "INV-2026-0042",
  "totaalfactuur": "1250,00",
  "totaalbtw": "262,50",
  "ontvangerSchemeId": "0106",
  "ontvangerIdentifier": "12345678"
}

Lors de la soumission via l'API, vous recevez un documentId en retour. Vous pouvez lier cet ID à la facture dans votre propre logiciel, afin de suivre le statut de l'envoi. Vous pouvez également fournir votre propre documentId.

Métadonnées obligatoires

Les champs suivants sont requis au minimum :

ChampDescriptionfactuurnummerLe numéro de facture uniquetotaalfactuurLe montant total de la facture TTCtotaalbtwLe montant total de la TVAontvangerSchemeIdL'identifiant de schéma Peppol du destinataire (p. ex. 0106 pour KvK)ontvangerIdentifierLe numéro d'identification du destinataire (p. ex. numéro KvK)ontvangerNaamLe nom du destinataireontvangerEmailL'adresse e-mail du destinataire

Des tags supplémentaires peuvent être ajoutés en concertation.

Processus de traitement

Après réception, le PDF passe par les étapes suivantes :

  1. Reconnaissance : l'IDR reconnaît la facture PDF et la convertit en facture XML (UBL)
  2. Champs de routage : les données du destinataire issues des métadonnées sont reprises dans le XML
  3. Validation : les métadonnées de contrôle sont comparées aux valeurs reconnues par l'IDR. Le numéro de facture, le nom du destinataire et les identifiants issus de vos métadonnées peuvent écraser les valeurs reconnues. Si le montant de la facture ou de la TVA diffère de la reconnaissance, ce champ est également écrasé et la facture est rejetée
  4. Envoi ou notification : si la validation réussit, la facture est envoyée via Peppol (ou une autre méthode de livraison configurée). Si la validation échoue, vous recevez une notification
Notifications d'erreur

Si la validation échoue (par exemple parce que le montant reconnu diffère du montant fourni), il y a trois façons de recevoir une notification :

MéthodeDescriptionE-mailUn message d'erreur technique par e-mail. L'adresse de réception peut être codée en dur, extraite du XML ou des métadonnées, ou être l'adresse de l'expéditeurWebhookLors de l'utilisation de l'API, vous pouvez configurer une adresse webhook. La PSB envoie une mise à jour de statut pour que vous puissiez mettre à jour le statut dans votre propre logicielPlateformeLe message d'erreur est également visible dans la plateforme eConnect pour le document concerné
Lignes de facture

Lors de la reconnaissance des lignes, l'IDR ne transmet les lignes de facture que si la somme des montants des lignes correspond au total hors TVA. Si les lignes ne correspondent pas, l'IDR place le total par catégorie de TVA comme ligne de facture dans le XML. Vous souhaitez que la facture soit rejetée au lieu d'être envoyée dans ce cas ? C'est configurable. Si aucune ligne de facture n'est reconnue du tout, cela peut également être configuré en option pour que la facture soit rejetée plutôt qu'envoyée sans lignes ; vous recevez alors la même notification que pour une autre erreur de validation.

Important : Une facture rejetée ne peut pas être corrigée a posteriori et envoyée automatiquement. La seule option est de télécharger le XML manuellement via la plateforme.

Quand utiliser PDF via Peppol ?

Cette solution est destinée aux situations où la source de facturation ne peut pas générer un format structuré, mais où vous souhaitez tout de même envoyer via Peppol. Scénarios typiques :

  • Logiciels qui ne prennent en charge que l'export PDF
  • Environnements hybrides où une partie du flux de facturation est déjà numérique et une partie fonctionne encore en PDF
  • Migration progressive vers la facturation électronique complète

Pour la meilleure qualité et fiabilité, il est toujours recommandé de livrer directement au format UBL via l'API.

Questions fréquentes
Comment savoir si ma facture PDF a été correctement reconnue ?

L'IDR reconnaît le PDF et compare les valeurs reconnues avec les métadonnées de contrôle que vous fournissez (numéro de facture, montants, destinataire). Si la validation réussit, la facture est envoyée. Si elle échoue, vous recevez une notification par e-mail, webhook ou sur la plateforme.

Quelles sont les deux façons de soumettre un PDF ?

Vous pouvez envoyer un PDF par e-mail à l'adresse sécurisée de votre tenant PSB (avec les métadonnées au format Markdown), ou via l'API GenericSend (avec les métadonnées sous forme de paires clé-valeur). Les deux méthodes nécessitent les mêmes métadonnées de contrôle.

Puis-je corriger une facture rejetée a posteriori et l'envoyer quand même automatiquement ?

Non, une facture rejetée ne peut pas être corrigée a posteriori et envoyée automatiquement. La seule option est de télécharger le XML manuellement via la plateforme eConnect.


Vous souhaitez mettre en place PDF via Peppol ? Contactez notre équipe pour la configuration initiale.

Demander la configuration

Liens connexes