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.

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.

POST/v1/validate

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.

POST/v1/convert

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.

POST/v1/invoices

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.

GET/v1/iban/{iban}

Vérification IBAN : longueur par pays, clé de contrôle, zone SEPA, code banque.

GET/v1/vat/{vat_id}

Numéro de TVA intracommunautaire : format et clé hors ligne, puis VIES en direct. vies=false pour hors ligne.

POST/v1/vat/batch

Jusqu'à 100 numéros par appel : {"vat_ids": ["FR…", "DE…"]}. Un appel compté par numéro.

GET/v1/usage

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
Clé gratuite

Starter

19 € / mois

2 000 appels / mois

  • Tous les endpoints
  • PDF sans mention
  • Support e-mail
Choisir

Pro

59 € / mois

15 000 appels / mois

  • Tous les endpoints
  • Sans mention
  • Support e-mail prioritaire
Choisir

Business

199 € / mois

100 000 appels / mois

  • Tous les endpoints
  • Sans mention
  • Accord de sous-traitance (RGPD) sur demande
  • Support prioritaire
Choisir

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.