EU E-Invoice API
EN 16931 · XRechnung · ZUGFeRD · Factur-X · Peppol · FatturaPA · KSeF · CIUS-RO · HR-CIUS

Chaque facture Factur-X contrôlée, ligne par ligne.

L'EU E-Invoice API est une API de validation de factures électroniques : elle valide Factur-X, UBL et CII avec les règles françaises BR-FR de la FNFE-MPE, ainsi que Peppol BIS, XRechnung, FatturaPA, CIUS-RO, HR-CIUS et KSeF. Elle transforme les factures en JSON propre et génère des factures valides à partir de JSON. Pour les logiciels de comptabilité, d'ERP et de facturation qui ne veulent pas reconstruire eux-mêmes la réforme de la facturation électronique.

Obtenir une clé API gratuite Valider dans le navigateur

Essayer sans inscription : valider une facture gratuitement dans le navigateur (5 fichiers par jour). Voir un exemple

Inscription, clés API et facturation se font dans notre portail développeurs, hébergé par Zuplo.

INVALIDE
Facture RE-2026-0042BT-1
Total HT1 000,00 €
TVA 20 %200,00 €
Total TTC BT-1121 209,00 €

error BR-CO-15 Le total TTC ne correspond pas au total HT plus la TVA.

Exemple : une facture dont le total est faux
  • Règles officielles FNFE-MPE (BR-FR, EXTENDED-CTC-FR), CEN, FeRD et OpenPeppol, contrôle PDF/A-3 avec veraPDF
  • Traitement sur des serveurs en Allemagne, uniquement en mémoire
  • Démarrage gratuit : 100 documents par mois
  • Validation, lecture et génération uniquement : la transmission via votre plateforme agréée, Peppol, le SDI ou KSeF reste chez votre prestataire

Ce que fait l'API

Une API REST légère avec quatre fonctions. Les erreurs sont au format RFC 9457 problem+json avec un identifiant de requête, et l'interface est décrite en OpenAPI 3.1.

  1. 1 POST /v1/validate

    Valider Factur-X, UBL et CII (BR-FR)

    Détecte le format et le pays, puis contrôle le XML ou le PDF par rapport au schéma, au Schematron et au PDF/A-3. Vous obtenez valid et chaque constat avec identifiant de règle, gravité, message et XPath.

  2. 2 POST /v1/parse

    Lire les factures en JSON

    Valide, puis renvoie la facture en JSON EN 16931 normalisé avec des totaux recalculés. Idéal pour les factures reçues : un seul modèle de données pour tous les formats.

  3. 3 POST /v1/generate

    Générer des factures à partir de JSON

    Le même JSON devient Factur-X, UBL ou CII EN 16931 (avec le cadre de facturation BT-23 pour la France), XRechnung, Peppol BIS, CIUS-RO, HR-CIUS, FatturaPA ou KSeF FA(3). Chaque document est validé avant d'être renvoyé – aucune facture invalide ne quitte l'API.

  4. 4 POST /v1/preview/validate

    Aperçu des nouvelles règles Offres payantes

    Valide par rapport à la prochaine version publiée d'un jeu de règles avant qu'elle ne devienne obligatoire : vous savez tôt si vos factures passeront encore après la mise à jour.

  • XRechnung 3.0 (UBL, CII)
  • ZUGFeRD 2.x / Factur-X (MINIMUM–EXTENDED)
  • Factur-X + BR-FR
  • EXTENDED-CTC-FR
  • Peppol BIS Billing 3.0
  • FatturaPA 1.2.3 (FPR12, FPA12)
  • CIUS-RO (RO e-Factura)
  • HR-CIUS (eRačun)
  • KSeF FA(3)
  • EN 16931 (UBL, CII)
  • PDF/A-3

La facture électronique devient obligatoire en Europe – aussi pour vos clients

En B2B, un PDF envoyé par e-mail suffit de moins en moins. Un logiciel de facturation doit lire, contrôler et écrire les formats de chaque pays.

  1. FranceRéception obligatoire pour toutes les entreprises depuis le 1er septembre 2026, émission pour les grandes entreprises et les ETI ; pour les PME et micro-entreprises à partir du 1er septembre 2027. Factur-X, UBL, CII avec les règles BR-FR.
  2. AllemagneRéception depuis le 1er janvier 2025 ; émission à partir du 1er janvier 2027 (plus de 800 000 € de chiffre d'affaires) et du 1er janvier 2028 pour tous. XRechnung, ZUGFeRD.
  3. BelgiqueFacture électronique B2B via Peppol depuis le 1er janvier 2026. Peppol BIS Billing 3.0.
  4. PologneKSeF par étapes depuis février et avril 2026. KSeF FA(3).
  5. ItalieB2B via le SDI depuis 2019. FatturaPA.
  6. RoumanieRO e-Factura en B2B depuis 2024. CIUS-RO.
  7. CroatieFiscalisation 2.0 : facture électronique B2B depuis le 1er janvier 2026 ; émission pour les entreprises hors TVA à partir du 1er janvier 2027. HR-CIUS (UBL).
  8. SlovaquieFacture électronique B2B via Peppol à partir du 1er janvier 2027. Peppol BIS Billing 3.0.

Présentation simplifiée ; les exceptions et règles transitoires restent applicables. Ceci n'est pas un conseil juridique.

De quel format ai-je besoin ?

La validation et la lecture détectent le format elles-mêmes. Seule la génération demande le format cible via format=.

PaysFormatGénérer avec format=
FranceFactur-X, UBL ou CII avec les règles BR-FRzugferd-en16931, en16931-ubl, en16931-cii
AllemagneXRechnung (UBL, CII), ZUGFeRD 2.xxrechnung-ubl, xrechnung-cii, zugferd-en16931, facturx-basic
Belgique, Slovaquie et autres pays PeppolPeppol BIS Billing 3.0 (UBL)peppol-bis
ItalieFatturaPA 1.2.3 (FPR12, FPA12)fatturapa-fpr12, fatturapa-fpa12
PologneKSeF FA(3)ksef-fa3
RoumanieCIUS-RO (UBL)cius-ro-ubl
CroatieHR-CIUS (UBL)hr-cius-ubl

Pourquoi ne pas le développer vous-même ?

  • Des règles officielles de la FNFE-MPE, du CEN, de FeRD, de la KoSIT, d'OpenPeppol et d'administrations fiscales nationales, chacune avec son propre cycle de publication : nous les tenons à jour, vous fixez une version avec ?ruleset= si besoin.
  • Aucune pile Java à exploiter : schéma XML, Schematron (Saxon), veraPDF pour le PDF/A-3 et l'intégration du XML dans les PDF Factur-X tournent chez nous.
  • Un seul JSON EN 16931 normalisé pour les factures reçues dans tous les formats, avec des totaux recalculés.
  • Les factures générées sont validées avant d'être renvoyées : aucun document invalide n'atteint vos clients.

Conçue pour des données que personne ne peut se permettre de perdre

Les factures contiennent des secrets d'affaires et des données personnelles. L'API est conçue pour en voir le moins possible et n'en conserver aucune.

Règles officielles

FNFE-MPE (règles françaises BR-FR et EXTENDED-CTC-FR), CEN (EN 16931), FeRD (ZUGFeRD / Factur-X), KoSIT (XRechnung), OpenPeppol (Peppol BIS), le ministère roumain des Finances (CIUS-RO), l'administration fiscale croate (HR-CIUS) et les schémas XML officiels pour KSeF et FatturaPA – utilisés sans modification. Pour FatturaPA, l'API contrôle aussi les contrôles SDI vérifiables hors ligne (notre mise en œuvre de la spécification SDI).

PDF/A-3 avec veraPDF

Les PDF Factur-X sont aussi contrôlés en PDF/A-3 avec veraPDF, le validateur de référence de la PDF Association.

Traitement en Allemagne

La validation, la lecture et la génération ont lieu uniquement sur nos serveurs en Allemagne (Hetzner, Falkenstein), uniquement en mémoire. La passerelle API en amont (Zuplo) ne fait que transmettre les requêtes et ne stocke aucun contenu de facture.

Aucun stockage

Les factures sont traitées uniquement en mémoire, jamais écrites sur disque ni journalisées. Seules des métadonnées comme le point d'accès, le statut, la durée et la taille sont enregistrées.

Règles à jour

Les versions officielles des règles sont intégrées rapidement – en avance via l'aperçu, obligatoires à leur date d'effet. Aucun délai de mise à jour n'est garanti. Chaque réponse indique la version utilisée.

Sans cookies ni suivi

Ce site ne dépose aucun cookie, ne charge ni police ni script de tiers et ne tient aucun journal d'accès.

Règles en vigueur

Jeu de règlesPublié parVersionPublication
XRechnung avec les règles CEN EN 16931KoSIT, CEN3.0.22026-08-31
ZUGFeRD / Factur-XFeRD, FNFE-MPE2.5.2–
Peppol BIS Billing 3.0OpenPeppol3.0-2026.5–
KSeF FA(3) (schéma XML)ministère polonais des FinancesFA3-1-0E2025-06-25
Règles françaises BR-FR, EXTENDED-CTC-FRFNFE-MPE1.4.0.042026-09-04
CIUS-ROministère roumain des Finances1.0.92024-06-05
HR-CIUS (eRačun)administration fiscale croate1.0.42026-03-13
Contrôles pour la Slovaquiecette API (pas des règles officielles)1.02026-10-25
FatturaPA (schéma XML, contrôles SDI)Agenzia delle Entrate1.2.32025-04-01

Généré à partir de la configuration de l'API ; GET /v1/formats renvoie la même liste.

Intégrée en quelques minutes

Un appel HTTP avec votre clé API – sans SDK, sans bibliothèque Java dans votre stack. La référence API du portail développeurs décrit chaque point d'accès avec ses paramètres et ses réponses.

Valider une facture
# envoyer un PDF ou un XML, le format est détecté automatiquement
curl -H "Authorization: Bearer $API_KEY" \
     -F "file=@facture.pdf" \
     https://einvoice-api-main-f5141d8.zuplo.app/v1/validate

{
  "valid": false,
  "format": "zugferd",
  "profile": "EN16931",
  "summary": { "fatal": 0, "error": 1, "warning": 0 },
  "findings": [{
    "severity": "error",
    "ruleId": "BR-CO-15",
    "message": "Invoice total amount with VAT (BT-112) = …",
    "xpath": "/rsm:CrossIndustryInvoice[1]/…"
  }]
}
Lire une facture : XML → JSON
curl -H "Authorization: Bearer $API_KEY" \
     -H "Content-Type: application/xml" \
     --data-binary @xrechnung.xml \
     https://einvoice-api-main-f5141d8.zuplo.app/v1/parse

{
  "valid": true,
  "format": "xrechnung",
  "rulesets": [{ "id": "xrechnung", "version": "3.0.2" }],
  "invoice": {
    "invoiceNumber": "RE-2026-0042",
    "currency": "EUR",
    "seller": { "name": "Muster Software GmbH", … },
    "totals": { "taxInclusiveAmount": "1190.00", … }
  }
}
Générer une facture : JSON → PDF Factur-X
curl -H "Authorization: Bearer $API_KEY" \
     -H "Content-Type: application/json" \
     --data-binary @facture.json \
     -o facture.pdf \
     "https://einvoice-api-main-f5141d8.zuplo.app/v1/generate?format=zugferd-en16931"

# autres formats : en16931-cii, en16931-ubl, facturx-basic, xrechnung-ubl,
# peppol-bis, cius-ro-ubl, hr-cius-ubl, fatturapa-fpr12, ksef-fa3
# Le document est déjà validé. Si le JSON est incomplet,
# vous recevez 422 avec les constats au lieu d'une facture invalide.

URL de base : https://einvoice-api-main-f5141d8.zuplo.app – tous les exemples l'utilisent ; la clé API va dans l'en-tête Authorization: Bearer.

Aussi disponible comme serveur MCP pour assistants IA et agents d’IDE : npx @einvoiceapi/mcp, licence MIT, sur npm, code source et exemples sur GitHub.

Tarifs

Toutes les offres incluent tous les formats, pays et points d'accès ; les offres payantes ajoutent l'aperçu des règles. Elles ne diffèrent que par le volume, la vitesse et la taille des fichiers.

Free

0 €
gratuit pour toujours
  • 100 documents / mois
  • 10 requêtes / minute
  • Fichiers jusqu'à 2 Mo
  • S'arrête au quota
Commencer gratuitement

Starter

29 € / mois
2 500 inclus, puis 0,015 € par document
  • 2 500 documents / mois
  • 30 requêtes / minute
  • Fichiers jusqu'à 5 Mo
  • Aperçu des nouvelles règles
Choisir Starter
Recommandé

Pro

99 € / mois
15 000 inclus, puis 0,009 € par document
  • 15 000 documents / mois
  • 60 requêtes / minute
  • Fichiers jusqu'à 10 Mo
  • Aperçu des nouvelles règles
Choisir Pro

Scale

349 € / mois
100 000 inclus, puis 0,0045 € par document
  • 100 000 documents / mois
  • 120 requêtes / minute
  • Fichiers jusqu'à 10 Mo
  • Aperçu des nouvelles règles
Choisir Scale

Tous les prix sont des prix finaux pour les entreprises. En tant que petite entreprise allemande (§ 19 UStG), nous ne facturons pas de TVA ; l'éventuelle autoliquidation de la TVA dans votre pays dépend de vos règles nationales. Un appel validate ou parse compte pour 1 document, generate pour 2 (génération puis validation). L'offre Free s'arrête à son quota ; les offres payantes facturent automatiquement le dépassement au prix indiqué. Limites de toutes les offres : 15 secondes de traitement par document ; au-delà du débit de votre offre, l'API répond 429, en cas de surcharge 503, toujours avec Retry-After. Toutes les offres sont en libre-service : inscription, changement d'offre et facturation sont automatiques, sans contrat individuel. Nos conditions générales (en allemand) s'appliquent.

Questions fréquentes

Quels pays et formats sont pris en charge ?

La France (Factur-X, UBL et CII avec les règles françaises BR-FR, EXTENDED-CTC-FR), l'Allemagne (XRechnung 3.0 en UBL et CII, ZUGFeRD 2.x), la Belgique et tous les pays Peppol (Peppol BIS Billing 3.0), l'Italie (FatturaPA 1.2.3), la Roumanie (CIUS-RO), la Croatie (HR-CIUS), la Slovaquie (Peppol BIS à partir de 2027) et la Pologne (KSeF FA(3)), ainsi que l'EN 16931 pur en UBL et CII. GET /v1/formats liste chaque jeu de règles avec sa version.

Une facture Peppol BIS est-elle valable en Croatie ?

Pas entre entreprises croates : depuis le 1er janvier 2026, elles doivent suivre la spécification croate HR-CIUS (UBL avec l'extension HR, codes produits KPD, OIB) et passent par des intermédiaires d'information, pas par Peppol. L'API valide et génère HR-CIUS (hr-cius-ubl) avec les règles de l'administration fiscale et avertit (PROFILE-NOT-HR) si une facture entre deux parties croates utilise un autre format. La fiscalisation est faite par votre intermédiaire.

De quoi ai-je besoin pour la Slovaquie à partir de 2027 ?

D'un Peppol BIS Billing 3.0 pur en UBL, les deux parties étant adressées par leur numéro fiscal DIČ dans le schéma 0245, envoyé par un prestataire Peppol certifié. L'API le valide avec les règles officielles Peppol et ajoute trois avertissements pour les vendeurs slovaques (schéma d'adresse, BT-8) ; ce ne sont pas des règles officielles et ils ne changent jamais valid.

L'API transmet-elle les factures à une plateforme agréée ?

Non. L'API valide, lit et génère les documents ; leur transmission relève de votre plateforme agréée (anciennement PDP), de votre point d'accès Peppol, du SDI pour l'Italie, de KSeF pour la Pologne ou de votre canal d'échange. Elle convient comme brique de contrôle et de génération avant cette transmission.

Les règles françaises (BR-FR) sont-elles contrôlées ?

Oui, automatiquement pour les vendeurs établis en France (BT-40 = FR) : sur l'EN 16931 en UBL et CII et sur Factur-X BASIC WL, EN 16931 et EXTENDED, avec les règles de la FNFE-MPE (variante FATAL). EXTENDED-CTC-FR est validé comme profil à part entière. Les profils Factur-X MINIMUM et BASIC ne font pas partie du socle français et reçoivent un avertissement.

Quelles mentions françaises la génération prend-elle en charge ?

Le cadre de facturation (BT-23, par exemple S1 ou B1), le SIREN (schéma 0002) et le SIRET (0009), les adresses électroniques en schéma 0225, les mentions PMT, PMD et AAB et l'option pour le paiement de la TVA d'après les débits. Chaque facture générée est contrôlée avec les règles BR-FR avant d'être renvoyée.

Puis-je valider des factures électroniques gratuitement ?

Oui. L'offre Free valide, lit et génère jusqu'à 100 documents par mois sans frais. Elle s'arrête au quota : aucun coût ne peut survenir. Sans inscription, le validateur web gratuit contrôle 5 fichiers par jour dans le navigateur.

Mes factures sont-elles stockées ?

Non. L'API est sans état : les factures sont traitées en mémoire et supprimées après la réponse. Elles n'atteignent jamais le disque ni les journaux. Seules des métadonnées sont enregistrées (point d'accès, format, statut, durée, taille en octets).

Quelles versions des règles sont utilisées ?

Toujours les versions officielles en vigueur, par exemple les règles françaises de la FNFE-MPE en version 1.4.0.04. Chaque réponse indique les versions utilisées et GET /v1/formats les liste toutes. Le paramètre ?ruleset= permet de fixer une version.

Comment savoir si l'API fonctionne et quelles règles sont en vigueur ?

GET /v1/health répond sans clé API et indique les jeux de règles chargés ; GET /v1/formats liste chaque type de document avec son jeu de règles et sa version. Les deux appels sont gratuits. Le tableau des règles en vigueur sur cette page provient de la même configuration.

Qu'est-ce qui compte comme document ?

Chaque appel traité de validate, parse ou de l'aperçu des règles compte pour 1 document, generate pour 2 – même si la facture contient des erreurs, car le contrôle a été effectué. Les appels à /v1/formats et /v1/health sont gratuits.

Existe-t-il un accord de sous-traitance (RGPD) ?

Oui. Un accord standard selon l'art. 28 du RGPD (AVV, en allemand) fait partie des conditions et s'applique à toutes les offres ; vous l'acceptez à l'inscription. Nous ne proposons pas de contrats individuels.

Y a-t-il un support ?

L'API est un produit en libre-service : la documentation, la référence API et les exemples répondent à la plupart des questions, et chaque message d'erreur indique quoi corriger. Il n'y a pas de support personnel avec des délais de réponse garantis. Les constats erronés ou les bugs peuvent être signalés par e-mail (adresse dans l'Impressum) ; les bugs confirmés sont corrigés, sans délai de réponse garanti.

Prêt pour la facture électronique ?

Obtenez une clé API gratuite dans le portail développeurs et validez votre première facture en quelques minutes.

Aller au portail développeurs Référence API (OpenAPI)