J’ai des données de facture structurées
Créez l’en-tête, ajoutez chaque ligne, joignez éventuellement le PDF visuel, puis générez le document UBL Peppol.
Voir ce parcours →
Plateforme développeurs Peppox
Envoyez votre première facture via Peppol, étape par étape.
Choisissez le parcours adapté à votre système. Chaque identifiant, requête et action suivante est expliqué, du premier appel API au suivi de livraison.
PEPPOX / INTEGRATION FLOW
- 01Dashboard
- 02Clé API
- 03Facture
- 04Validation
- 05Peppol
READY TO BUILD
01 · Avant le premier appel
Quatre éléments à préparer une seule fois
Finalisez d’abord le compte et le profil fournisseur. Votre application pourra ensuite réutiliser les mêmes accès pour chaque document.
- 01
Créez votre compte Peppox
Enregistrez l’entreprise légale qui enverra les documents.
- 02
Complétez le profil fournisseur
Les données société, TVA, banque et routage Peppol proviennent de votre compte.
- 03
Ouvrez l’environnement d’intégration
Utilisez les outils du dashboard pour tester avant la production.
- 04
Copiez votre clé API
Conservez-la côté serveur. Ne l’exposez jamais dans le navigateur ou une app mobile.
02 · Choisissez le chemin le plus court
Partez des données que vous avez déjà
Je produis déjà un PDF
Chargez le PDF, laissez Peppox en extraire les données, vérifiez-les, confirmez-les puis envoyez la facture via Peppol.
Voir ce parcours →03 · PDF2Peppol
Un envoi complet en quatre appels API
Le parcours documenté le plus direct lorsque votre système produit déjà les factures en PDF.
- 01
Chargez le PDF
Envoyez un fichier, du Base64 ou une URL. Enregistrez le queue_guid retourné.
POST/pdf2peppol/add - 02
Vérifiez les données extraites
Interrogez l’API jusqu’à la fin du traitement, puis contrôlez acheteur, totaux, TVA et lignes.
GET/pdf2peppol/check - 03
Confirmez le document
Confirmez uniquement lorsque toutes les données extraites sont correctes.
POST/pdf2peppol/confirm - 04
Envoyez vers Peppol
Expédiez le document confirmé et conservez le GUID document retourné.
POST/pdf2peppol/send - 05
Suivez la livraison
Utilisez la liste des documents envoyés ou le dashboard pour suivre le statut final.
GET/doc-sent/header/list
Exemple minimal
Upload → check → confirm → send
Remplacez les valeurs fictives par votre clé et les identifiants renvoyés par l’appel précédent.
pdf2peppol.sh
curl -X POST "https://api.peppox.com/pdf2peppol/add/" \
-F "supplier_id=YOUR_SUPPLIER_ID" \
-F "pdf=@invoice.pdf" \
-F "network=integration"
# Save queue_guid, then check it
curl "https://api.peppox.com/pdf2peppol/check/?supplier_id=YOUR_SUPPLIER_ID&queue_guid=QUEUE_GUID"
curl -X POST "https://api.peppox.com/pdf2peppol/confirm/" \
-H "Content-Type: application/json" \
-d '{"supplier_id":"YOUR_SUPPLIER_ID","queue_guid":"QUEUE_GUID","confirmed":1}'
curl -X POST "https://api.peppox.com/pdf2peppol/send/" \
-H "Content-Type: application/json" \
-d '{"supplier_id":"YOUR_SUPPLIER_ID","queue_guid":"QUEUE_GUID"}'04 · API facture structurée
Construisez une facture prête pour Peppol depuis vos données
Idéal lorsque votre ERP conserve déjà chaque champ et chaque ligne sous forme structurée.
- 01
Créez l’en-tête
Envoyez client, dates, devise, paiement et livraison. Enregistrez invoice_guid.
POST/invoice/add - 02
Ajoutez les lignes
Répétez cet appel pour chaque produit ou service.
POST/invoice_line/add - 03
Joignez le PDF (facultatif)
Ajoutez la facture lisible par fichier, Base64 ou URL.
POST/invoice_attach_pdf/add - 04
Générez le XML UBL
Peppox assemble en-tête, lignes et pièce jointe. Le succès renvoie XML_BUILT.
POST/xml/generate - 05
Suivez et pilotez
Consultez le document et son statut dans le dashboard ou via les API de documents envoyés.
GET/doc-sent/header/list
API NOTE
Important : la référence publiée pour les factures structurées documente actuellement la génération XML, mais pas d’endpoint /send final distinct. Si votre intégration exige un appel final d’envoi explicite, utilisez le parcours PDF2Peppol ou terminez l’expédition via le workflow/dashboard Peppox configuré.
05 · Carte des endpoints
Tous les endpoints, expliqués simplement
01Factures
POST/invoice/addCrée l’en-tête d’une facture et retourne invoice_guid.
POST/invoice_line/addAjoute une ligne à une facture existante.
POST/invoice_attach_pdf/addJoint ou remplace le PDF de la facture.
02Génération UBL
POST/xml/generateGénère un document XML UBL compatible Peppol.
03Notes de crédit
POST/creditnote/addCrée l’en-tête d’une note de crédit.
POST/creditnote_line/addAjoute une ligne à une note de crédit.
POST/creditnote_attach_pdf/addJoint ou remplace le PDF d’une note de crédit.
04Documents envoyés
GET/doc-sent/header/listListe les en-têtes envoyés avec filtres et pagination.
GET/doc-sent/lines/listRetourne les lignes d’un document envoyé.
05Documents reçus
GET/doc-received/header/listListe les en-têtes reçus avec filtres et pagination.
GET/doc-received/lines/listRetourne les lignes d’un document reçu.
06PDF2Peppol
POST/pdf2peppol/addCharge un PDF et démarre l’extraction.
GET/pdf2peppol/checkVérifie le traitement et les champs extraits.
POST/pdf2peppol/confirmConfirme les données vérifiées.
POST/pdf2peppol/sendEnvoie le document confirmé via Peppol.
06 · Tests sans code
Comprenez chaque requête dans le dashboard avant de la coder
Le dashboard Peppox propose des formulaires guidés qui communiquent directement avec les API. Vous découvrez facilement les paramètres, testez des documents réels et comprenez la réponse JSON avant de connecter votre ERP.
- 01Choisir un endpoint et remplir ses champs
- 02Lancer la requête sans écrire de client de test
- 03Inspecter les GUID, données JSON et erreurs
- 04Valider le parcours dans l’environnement d’intégration
- 05Reprendre la requête fonctionnelle dans votre backend
- 06Suivre les documents envoyés et reçus
Identifiants à conserver
L’état de votre intégration reste simple
invoice_guidRelie l’en-tête structuré, les lignes, le PDF et le XML généré.
queue_guidRelie les quatre appels PDF2Peppol pendant l’extraction.
GUID documentRelie le document final au suivi de livraison et au rapprochement.
Si une requête échoue
400Contrôlez les champs absents ou invalides.401Vérifiez la clé API et l’environnement.404Vérifiez le GUID créé par l’appel précédent.429Ralentissez et réessayez avec un délai progressif.500Journalisez l’identifiant de requête, retentez sans doublon et contactez Peppox si le problème persiste.