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.
Il existe deux façons de soumettre une facture PDF à la PSB. Les deux méthodes nécessitent les mêmes métadonnées.
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.
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.
Les champs suivants sont requis au minimum :
factuurnummertotaalfactuurtotaalbtwontvangerSchemeId0106 pour KvK)ontvangerIdentifierontvangerNaamontvangerEmailDes tags supplémentaires peuvent être ajoutés en concertation.
Après réception, le PDF passe par les étapes suivantes :
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 :
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.
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 :
Pour la meilleure qualité et fiabilité, il est toujours recommandé de livrer directement au format UBL via l'API.
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.
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.
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