API Peppox v1

API Peppol performante pour les entreprises et les intégrateurs

Peppox fournit une API REST simple et puissante pour connecter votre logiciel de facturation, votre ERP, votre plateforme SaaS ou votre application personnalisée à Réseau Peppol.

Envoyez des factures de vente, créez des avoirs, générez du XML UBL, joignez des PDF, récupérez les documents envoyés et recevez des factures d'achat, le tout via une API unifiée.

Créer un compte développeur Découvrez la documentation de l'API publique 
POST /invoice/add Authorization: Bearer VOTRE_CLÉ_API Content-Type: application/json { "issue_date": "2026-04-28", "customer": { "endpoint_id": "0208:0123456789", "name": "Customer Company", "country": "BE" } }

Choisissez le compte adapté à votre intégration.

Peppox est disponible pour les deux intégrateurs et entreprises individuellesQue vous gériez plusieurs clients ou seulement votre propre entreprise, la même API vous donne accès à Peppol.

Même API. Utilisation différente. Les intégrateurs peuvent gérer plusieurs entreprises, tandis que les comptes d'entreprise peuvent utiliser l'API pour leurs propres documents Peppol.

Tout ce dont vous avez besoin pour automatiser la facturation électronique Peppol

Peppox simplifie chaque étape de la facturation électronique : création de documents, génération XML, pièce jointe PDF, livraison Peppol, suivi de l’état et récupération des factures d’achat.

📤 Envoyer les factures de vente

Créez des en-têtes de facture, ajoutez des lignes de facture, joignez un PDF et générez du XML conforme à Peppol à partir de vos données.

🧾 Créer des notes de crédit

Générez et envoyez des avoirs grâce au même flux de travail simple que celui utilisé pour les factures de vente.

📄 Générer un fichier XML UBL

Convertissez directement vos données de facture ou d'avoir au format XML UBL conforme à Peppol depuis l'API.

📎 Joindre des fichiers PDF

Joignez les fichiers PDF des factures ou des avoirs en utilisant le téléchargement, le contenu Base64 ou l'URL d'un fichier HTTPS distant.

📬 Récupérer les documents envoyés

Liste des en-têtes et lignes des factures envoyées pour vérifier la livraison, le statut Peppol, les données client et l'historique du document.

📥 Recevoir les factures d'achat

Récupérez les en-têtes et les lignes des factures d'achat reçues de vos fournisseurs via Peppol.

🔍 Rechercher, filtrer et trier

Utilisez des filtres par date, statut, type de document, mot-clé, pagination et tri sur les documents envoyés et reçus.

🔐 Authentification par clé API

Authentifiez-vous en toute sécurité avec votre clé API Peppox en utilisant l'autorisation par porteur ou les paramètres de clé API.

Un flux de travail simple pour les développeurs

Peppox est conçu pour une intégration facile. Vous créez le document, ajoutez les lignes, joignez le PDF si nécessaire, générez le XML, et Peppox gère la connexion Peppol.

1

Créez le document

Ajoutez un en-tête de facture ou d'avoir contenant les informations relatives au client, au paiement et à la livraison.

2

Ajouter des lignes de document

Ajoutez les produits, les services, les quantités, les prix, les taux de TVA et les références des articles.

3

Joindre un PDF

Téléversez un PDF, envoyez-le au format Base64 ou fournissez une URL distante sécurisée.

4

Générer du XML

Peppox génère le document XML UBL conforme à Peppol.

5

Suivi et récupération

Suivez les documents envoyés et récupérez les factures d'achat reçues via Peppol.

Principaux points de terminaison de l'API

L'API Peppox est organisée en points de terminaison clairs pour la gestion des factures, les avoirs, la génération XML, les documents envoyés et les factures d'achat reçues.

POSTE

/facture/ajouter

Créez un en-tête de facture de vente en statut brouillon.

POSTE

/ligne_de_facture/ajouter

Ajouter une ligne à une facture de vente existante.

POSTE

/invoice_attach_pdf/ajouter

Joindre un fichier PDF à une facture de vente existante.

POSTE

/xml/générer

Générer un fichier XML UBL conforme à Peppol.

POSTE

/note de crédit/ajouter

Créer un en-tête pour une note de crédit.

POSTE

/ligne_de_crédit/ajouter

Ajouter une ligne à une note de crédit existante.

OBTENIR

/doc-sent/header/list

Liste des en-têtes de factures envoyées avec filtres et statut Peppol.

OBTENIR

/doc-sent/lines/list

Récupérer les lignes d'une facture envoyée.

OBTENIR

/doc-received/header/list

Liste des en-têtes de factures d'achat reçues.

OBTENIR

/doc-received/lines/list

Récupérer les lignes d'une facture d'achat reçue.

Documentation de l'API publique

Explorez la documentation de l'API Peppox

La documentation de l'API Peppox est accessible au public pour les développeurs, les intégrateurs et les entreprises. Consultez la page de l'API pour découvrir tous les points de terminaison disponibles, des exemples de requêtes, les paramètres et les réponses.

Que vous souhaitiez envoyer des factures de vente, créer des avoirs, récupérer des documents envoyés ou recevoir des factures d'achat, la documentation vous aide à comprendre comment connecter votre logiciel à Peppol avec Peppox.

Consultez la documentation de l'API

JSON propre, requêtes simples

Peppol accepte les données JSON propres et les requêtes HTTP standard. Les développeurs peuvent rapidement intégrer l'envoi et la réception Peppol aux plateformes existantes sans avoir à maîtriser plusieurs API spécifiques à chaque fournisseur.

  • API REST avec charges utiles JSON
  • Authentification simple par clé API
  • Identifiants GUID clairs des documents pour le suivi
  • Compatible avec PHP, Python, Node.js, Java, .NET et tout client HTTP
Créer une facture de vente
curl -X POST "https://api.peppox.com/invoice/add/" \

  -H "Autorisation : Porteur VOTRE_CLÉ_API" \

  -H "Content-Type: application/json" \

  -d '{

    "date_émission" : "2026-04-28",

    "date_échéance" : "2026-05-28",

    "devise" : "EUR",

    "client": {

      "endpoint_id": "0208:0123456789",

      "nom" : "Société cliente",

      "pays" : "BE"

    }

  }'
Liste des factures d'achat reçues
curl "https://api.peppox.com/doc-received/header/list/?supplier_id=YOUR_SUPPLIER_ID"

Envoyer, recevoir et vérifier des documents Peppol

Peppox ne se limite pas à l'envoi de factures. Votre application peut également récupérer les factures envoyées, vérifier leur statut et importer les factures d'achat reçues des fournisseurs.

Pour les documents sortants

Votre application peut envoyer des factures de vente et des avoirs, puis vérifier l'état de la livraison et récupérer l'historique des documents en cas de besoin.

  • En-têtes et lignes des factures de vente
  • En-têtes et lignes des notes de crédit
  • Pièces jointes PDF
  • Génération XML UBL
  • Liste des documents envoyés et vérification du statut Peppol

Pour les documents entrants

Votre application peut récupérer les factures d'achat reçues via Peppol et les importer dans votre ERP, votre système comptable ou votre flux de validation interne.

  • En-têtes de factures d'achat reçus
  • Lignes de facture d'achat reçues
  • Informations sur les fournisseurs et les clients
  • Total de la TVA, montant à payer et détails de paiement
  • Recherche par date, statut, type de document et mot-clé
Commencez à construire dès aujourd'hui

Connectez votre logiciel à Peppol avec une seule API

Créez un compte intégrateur pour connecter plusieurs entreprises, ou créez un compte entreprise pour envoyer et recevoir vos propres documents Peppol directement via Peppox.

Créer un compte intégrateur Créer un compte d'entreprise