API facture électronique pour développeurs
Validez, convertissez et créez des factures Factur-X / ZUGFeRD, XRechnung et Peppol BIS en un appel HTTP. Vérifiez aussi les IBAN et les numéros de TVA (VIES). Pour les logiciels de gestion, e-commerce et comptabilité soumis à la réforme de la facturation électronique en France (sept. 2026 – sept. 2027), en Allemagne, en Belgique et en Pologne.
- Sans SDK : envoyez XML, PDF ou JSON, recevez JSON, XML ou PDF
- Les factures sont traitées en mémoire et jamais stockées
- Messages en français, anglais et allemand, avec le numéro de règle EN 16931
- Hébergé sur le réseau de Cloudflare, près de vos serveurs
Démarrage
1. Obtenez une clé (gratuit : 100 appels par mois). La clé arrive par e-mail.
2. Envoyez une facture :
curl -X POST "https://rechnix-api.mbanzagroup.workers.dev/v1/validate?lang=fr" \ -H "X-API-Key: YOUR_KEY" \ -H "Content-Type: application/xml" \ --data-binary @invoice.xml
3. Lisez le résultat :
{
"valid": false,
"syntax": "CII",
"profile": "xrechnung",
"errors": [
{ "rule": "BR-DE-15", "field": "buyerReference",
"message": "XRechnung : la référence acheteur / Leitweg-ID (BT-10) est absente." }
],
"warnings": [],
"summary": { "number": "RE-2027-0042", "total_with_vat": 1339.07, ... }
}Endpoints
Authentification : en-tête X-API-Key: VOTRE_CLÉ (ou Authorization: Bearer …). Chaque réponse contient X-RateLimit-Limit et X-RateLimit-Remaining. Spécification complète : openapi.json.
Valider une facture Factur-X / ZUGFeRD (PDF ou XML), XRechnung (CII ou UBL) ou Peppol BIS. Corps : le fichier XML, le PDF ou du JSON {"xml": "..."}. Options : profile=auto|xrechnung|en16931|peppol, lang=fr|en|de.
Convertir entre formats. to=xrechnung-cii|xrechnung-ubl|peppol-ubl|en16931-cii|zugferd-xml|zugferd-pdf|json. Refuse de convertir si les totaux de la source sont faux : les montants ne changent jamais.
Créer une facture à partir de JSON. format= mêmes valeurs. Vérifie d'abord les règles du format cible et renvoie 422 avec la liste des problèmes.
Vérification IBAN : longueur par pays, clé de contrôle, zone SEPA, code banque.
Numéro de TVA intracommunautaire : format et clé hors ligne, puis VIES en direct. vies=false pour hors ligne.
Jusqu'à 100 numéros par appel : {"vat_ids": ["FR…", "DE…"]}. Un appel compté par numéro.
Appels utilisés et restants ce mois-ci. Gratuit.
JSON de facture (pour /v1/invoices)
Noms de champs selon EN 16931. Catégories TVA : S (normal), Z, E (exonéré), AE (autoliquidation), K (intracommunautaire), G (export), O. Adresse électronique : endpoint_id + endpoint_scheme (ex. 0009 SIRET, 0225 SIREN, 0208 BCE belge) ; sinon l'e-mail est utilisé.
{
"number": "RE-2027-0042",
"issue_date": "2027-01-15",
"due_date": "2027-01-29",
"currency": "EUR",
"buyer_reference": "04011000-12345-34",
"seller": {
"name": "Muster Design Studio",
"street": "Lindenstraße 12",
"postcode": "10115",
"city": "Berlin",
"country": "DE",
"vat_id": "DE123456788",
"email": "rechnung@muster-design.example",
"contact_name": "Mia Muster",
"phone": "+49 30 1234567"
},
"buyer": {
"name": "Stadtverwaltung Musterstadt",
"street": "Rathausplatz 1",
"postcode": "12345",
"city": "Musterstadt",
"country": "DE",
"email": "eingang@musterstadt.example",
"endpoint_id": "04011000-12345-34",
"endpoint_scheme": "0204"
},
"payment": {
"means_code": "58",
"iban": "DE02120300000000202051"
},
"lines": [
{
"name": "Webdesign",
"quantity": 12.5,
"unit_code": "HUR",
"price": 85,
"vat_category": "S",
"vat_rate": 19
}
]
}# ZUGFeRD / Factur-X PDF -> XRechnung UBL curl -X POST "https://rechnix-api.mbanzagroup.workers.dev/v1/convert?to=xrechnung-ubl" \ -H "X-API-Key: YOUR_KEY" --data-binary @invoice.pdf -o xrechnung.xml # JSON -> ZUGFeRD PDF curl -X POST "https://rechnix-api.mbanzagroup.workers.dev/v1/invoices?format=zugferd-pdf" \ -H "X-API-Key: YOUR_KEY" -H "Content-Type: application/json" \ --data @invoice.json -o invoice.pdf # IBAN and VAT ID curl -H "X-API-Key: YOUR_KEY" https://rechnix-api.mbanzagroup.workers.dev/v1/iban/DE02120300000000202051 curl -H "X-API-Key: YOUR_KEY" https://rechnix-api.mbanzagroup.workers.dev/v1/vat/FR32123456789
Essayer
Utilise la clé de démonstration publique (30 appels par jour). L'exemple est une XRechnung valide ; introduisez une erreur et voyez la réponse.
Tarifs
Abonnements mensuels, sans engagement. Paiement, TVA et factures gérés par Polar (merchant of record). Un appel = une requête ; un lot TVA compte un appel par numéro.
Gratuit
0 € / mois
100 appels / mois
- Tous les endpoints
- PDF avec mention « créé avec »
- Support communautaire
Business
199 € / mois
100 000 appels / mois
- Tous les endpoints
- Sans mention
- Accord de sous-traitance (RGPD) sur demande
- Support prioritaire
Plus de 100 000 appels ? Écrivez-nous. mbanzagroup@proton.me · Gérer abonnement et clés
FAQ
Est-ce le validateur officiel ?
Ce sont les mêmes règles. Chaque requête est contrôlée avec l'ensemble complet des règles Schematron officielles utilisées par le validateur de la KoSIT : EN 16931 (CEN 1.3.16), XRechnung 3.0.2 (KoSIT) et, pour Peppol, Peppol BIS Billing 3.0.21. Chaque erreur indique l'identifiant officiel de la règle et son emplacement dans le XML. La validation du schéma XML (XSD) n'est pas incluse.
Stockez-vous mes factures ?
Non. Les factures sont lues en mémoire puis effacées dès la réponse envoyée. Nous stockons seulement un compteur d'appels par clé et une empreinte de la clé.
Quels formats ?
Factur-X 1.0 / ZUGFeRD 2.x profil EN 16931 (PDF/A-3 ou XML), XRechnung 3.0 (CII et UBL), Peppol BIS Billing 3.0 (UBL), EN 16931 CII. En lecture : autres profils Factur-X (règles de base).
Qu'est-ce qui n'est pas encore pris en charge ?
Remises et frais au niveau document lors des conversions (l'API refuse au lieu de les perdre), avoir UBL comme document distinct, et l'envoi via une plateforme agréée (PA) ou Peppol.
Que se passe-t-il quand le quota est atteint ?
Les appels renvoient HTTP 429 jusqu'au mois suivant ou jusqu'au changement d'offre. Pas de facturation surprise.