Solutions d'intégration Peppol APIConnectez votre logiciel existant au réseau Peppol en quelques étapes
API, XML, PDF - Choisissez la méthode d'intégration qui correspond à vos besoins
Solution 1 : Envoi XML UBL via API
Pour les développeurs et systèmes techniques
Comment ça marche ?
- 1.Générez un fichier XML UBL 2.1 conforme au standard Peppol BIS 3
- 2.Envoyez-le via notre API REST ou via téléchargement du fichier via notre interface (supporte le téléchargement de plusieurs fichiers dans un zip)
- 3.Nous envoyons automatiquement sur le réseau Peppol
Avantages
- Contrôle total sur les données
- Pas de conversion, format natif
- Traitement automatisé à 100%
Ressources pour créer votre fichier UBL Peppol
Solution 2 : Envoi JSON + PDF
Pour une intégration simple et rapide
Comment ça marche ?
- 1.Envoyez vos données de facturation en JSON structuré
- 2.Joignez le PDF de visualisation de la facture
- 3.Nous générons automatiquement le XML UBL Peppol
- 4.Envoi automatique sur le réseau Peppol avec le PDF attaché
Avantages
- Plus simple que XML UBL
- PDF de présentation inclus
- Conversion automatique vers UBL
- Idéal pour APIs modernes
Solution disponible Cette solution permet aux développeurs d'envoyer simplement un objet JSON avec les données de facturation, sans avoir à générer le XML UBL complexe.
Limitation : Cette solution est limitée aux champs Peppol BIS 3 obligatoires uniquement. Pour les profils avancés avec champs personnalisés, il faut passer par l'envoi XML UBL (Solution 1).
Solution 3 : Conversion PDF par IA
Pour les PDF de factures structurés
Comment ça marche ?
- 1.Télécharger vos factures au format PDF
- 2.Notre IA 100% locale analyse votre facture PDF
- 3.Les données préencodées par l'IA sont prêtes à être vérifiées
- 4.Vous envoyez votre facture au format XML avec votre PDF en pièce jointe et récupérez le fichier XML pour l'archiver
Avantages
- Facile et rapide
- IA 100% locale (vos données ne quittent jamais nos serveurs européens)
- Conformité RGPD garantie
- Support de tous les formats de factures
Prérequis pour un traitement optimal
Pour garantir une extraction précise, vos PDF doivent respecter ces critères :
- Format texte (pas d'images scannées) - max 40 lignes et descriptions courtes
- Structure claire avec tous les champs obligatoires visibles (numéro, date, échéance, livraison, numéro de TVA client, informations fournisseur uniquement en bas de page...)
- Tableau d'articles bien formaté avec colonnes distinctes (référence, désignation, quantité, prix unitaire, % remise, % TVA)
PDF plus complexes
Pour les PDF plus complexes (+40 lignes, structures non standard, formats spécifiques), il est possible de le faire via un développement personnalisé et l'utilisation de votre propre IA commerciale avec API compatible OpenAI.
L'utilisation de votre propre IA se fait à vos frais, risques et périls. La conversion d'un PDF demande une puissance de calcul importante et consomme beaucoup de tokens, ce qui engendre des coûts significatifs.
Développement sur mesure
Intégration personnalisée pour votre ERP ou logiciel métier
Vous utilisez SAP, Microsoft Dynamics, Sage ou un ERP propriétaire ? Nous développons un service de conversion de format personnalisé pour envoyer vos factures sur Peppol.
- Analyse de votre format et développement de la conversion vers Peppol UBL
- Tests, formation et support dédié
Échéance 2026 : Places limitées
Capacité limitée. Nous traitons les projets par ordre d'arrivée. Contactez-nous rapidement pour sécuriser votre conformité avant l'échéance.
Sécurisez votre conformité Peppol avant l'échéance légale
Tarifs API Peppol Box
Découvrez nos tarifs adaptés à votre volume de documents pour l'intégration API
Voir les tarifs APIQuestions fréquentes sur l'API Peppol Box
Tout ce que vous devez savoir sur nos services d'intégration
Est-ce que les données envoyées avec l'API sont conservées sur Peppol Box ?
Non, vos données sont confidentielles. Les services API s'occupent du transit de documents sans les stocker. Vous devez conserver les documents envoyés et reçus via notre API dans vos propres systèmes conformément aux obligations légales.
Est-ce que Peppol Box API propose un environnement de test ?
Oui, les API et les interfaces permettent de définir un flag mode test qui n'envoie pas le document sur le réseau Peppol. Cela vous permet de tester votre intégration en toute sécurité avant de passer en production.
Est-ce que l'accompagnement pour l'utilisation de l'API est compris dans le prix ?
Nos services sont très clairs et faciles à utiliser, ils ne devraient pas nécessiter d'accompagnement complexe. Nous pouvons cependant vous proposer un service d'accompagnement technique payant en fonction de vos besoins techniques spécifiques.
Quels formats de données sont supportés par l'API ?
Notre API supporte plusieurs formats :
- XML UBL 2.1 : Format natif Peppol (recommandé)
- JSON : Format simple pour les développeurs
- PDF : Avec conversion IA en UBL (service sur mesure)
Combien de temps prend l'intégration de l'API ?
Le temps d'intégration dépend de votre système existant :
- Envoi XML UBL : 1-2 jours si vous générez déjà du XML UBL
- Envoi JSON : 2-5 jours pour une intégration basique
- Intégration complète (envoi + réception) : 1-2 semaines
- ERP complexes : 2-4 semaines avec accompagnement
Comment fonctionne la limite du nombre de documents ?
Votre abonnement inclut un quota de documents valable maximum un an. Il n'y a pas de facturation des dépassements.
Lorsque vous approchez de votre limite, le système vous avertit automatiquement à l'avance pour vous inviter à souscrire à un nouveau plan annuel.
Une fois la limite atteinte, vous devez prendre un nouveau plan qui sera également valable un an.
La documentation de l'API est-elle disponible ?
Oui, l'API Peppol Box est une API REST facile à utiliser suivant les standards OpenAPI/Swagger. Une documentation interactive complète est disponible dès la création de votre compte avec des exemples de code prêts à l'emploi.
Que se passe-t-il si je dépasse le forfait choisi ?
Le système vous prévient automatiquement lorsque vous approchez de votre limite annuelle. Pour continuer à envoyer des documents et recevoir des documents, vous devez souscrire à un nouveau forfait annuel supérieur.
Le système vous prévient en avance pour vous permettre de passer au forfait supérieur. Si vous ne souscrivez pas au service supérieur à temps, vous ne pourrez plus envoyer ni recevoir de documents sur le réseau Peppol.
Qu'entend-on par "document" dans le comptage du forfait ?
Un "document" correspond à chaque transaction effectuée via l'API, qu'il s'agisse d'un envoi ou d'une réception. Le comptage se fait par opération, et non par facture unique.
Exemples de comptage :
- • Si vous envoyez la même facture 3 fois = 3 documents
- • Si vous recevez ou téléchargez la même facture deux fois = 2 documents
- • Chaque envoi ou réception compte individuellement dans votre quota annuel
Comment fonctionne le calcul de la TVA dans Peppol BIS Billing 3 ?
Le standard Peppol BIS Billing 3 (EN16931) impose un mode de calcul de la TVA spécifique qui se fait en deux étapes :
Étape 1 : Calcul du montant HT de chaque ligne
- • Montant HT ligne = Quantité × Prix unitaire HT
- • Application des réductions éventuelles
- • Arrondir le montant HT ligne à 2 décimales
Étape 2 : Calcul de la TVA par taux (au niveau facture)
- • Sommer tous les montants HT des lignes ayant le même taux de TVA
- • TVA par taux = (Somme des montants HT) × Taux de TVA
- • Arrondir le résultat à 2 décimales
- • Total TTC = Total HT + Somme de toutes les TVA
La TVA ne se calcule PAS ligne par ligne. Elle se calcule uniquement au niveau de l'en-tête de facture sur la somme des montants HT groupés par taux. Cela évite les erreurs d'arrondi cumulatives et est obligatoire selon EN16931.
Factures B2B : Cette norme s'applique aux factures entre professionnels. Si votre logiciel de caisse calcule en TTC, vous devez l'adapter pour calculer en HT pour les professionnels.
Est-ce qu'il existe un forfait pour les intégrateurs ?
Non, l'offre Peppol Box est destinée à chaque client final individuellement.
Fonctionnement pour les intégrateurs
- • Chaque client est facturé individuellement par Flexina
- • Chaque client dispose de son propre quota de documents
- • L'inscription sur le réseau Peppol doit se faire via les services Peppol Box
Pour les développeurs : Vous devez prévoir dans votre logiciel la possibilité pour vos clients de configurer l'API de Peppol Box et d'entrer leurs propres identifiants.
Vous avez d'autres questions ?
Contactez notre équipe