API facture électronique : créer et contrôler des Factur-X par REST

NormAPI est une API REST pour les factures électroniques. Votre logiciel envoie les données de la facture en JSON et reçoit un Factur-X, ou la même facture en CII ou en UBL. Avec profile=france, chaque facture est contrôlée par les règles françaises du FNFE-MPE avant de vous être rendue. La même API contrôle et lit les factures que vous recevez.

Mis à jour le 20 novembre 2026

En bref

Formats
Factur-X, un PDF/A-3 lisible avec le CII intégré, et le même XML en CII ou en UBL, au profil EN 16931. Le droit français y ajoute le cadre de facturation (BT-23), les notes PMT, PMD et AAB, la note BAR ou ADN, et les mentions obligatoires.
Contrôle
Chaque facture créée est contrôlée par les règles françaises du FNFE-MPE (BR-FR) avant de vous être rendue. Avec l'en-tête Accept-Language à fr, les explications des erreurs sont en français.
Gratuit
50 factures créées par mois, sans carte bancaire. Le contrôle et la lecture sont gratuits et ne sont jamais décomptés. Ensuite, dès 19 € par mois.
Réception
Une facture reçue, Factur-X, CII ou UBL, est lue en JSON, sous la forme d'une requête de création, avec les montants tels que la facture les écrit.
Éditeurs de logiciels
Chacun de vos clients est compté à part, avec son plafond mensuel et sa propre clé si vous le voulez, sur un seul compte et un seul forfait.
Données
Les factures sont traitées en mémoire sur un serveur en Allemagne, et leur contenu n'est jamais conservé. Nous concluons un contrat de sous-traitance (article 28 du RGPD) avec chaque client.
Intégration
REST et JSON, une spécification OpenAPI, le client TypeScript @normapi/client, et l'en-tête Idempotency-Key pour répéter un appel sans risque.

Trois appels

Les trois appels vont à la même adresse, https://api.normapi.de, avec la clé d'API dans l'en-tête Authorization.

Créer une facture : POST /v1/invoices

Votre logiciel envoie les données de la facture en JSON, avec un objet france. Avec profile=france, l'API écrit une facture au profil EN 16931, avec ce que le droit français y ajoute.

Ce sont le cadre de facturation (BT-23), les notes PMT, PMD et AAB, la note BAR ou ADN, et les mentions obligatoires.

syntax=zugferd rend un Factur-X, dont la page est en français. syntax=cii et syntax=ubl rendent le XML seul.

Avant de vous la rendre, l'API contrôle la facture par les règles françaises du FNFE-MPE (BR-FR). Une réponse 200 veut dire qu'elle les respecte.

Le vendeur doit être établi en France, en métropole ou dans un département d'outre-mer. Une erreur dans la requête donne une réponse 400 qui nomme le champ, et la règle ou l'article en cause.

La création demande une clé d'API, et chaque facture créée est décomptée de votre forfait.

curl
curl -X POST 'https://api.normapi.de/v1/invoices?syntax=zugferd&profile=france' \
  -H "Authorization: Bearer $NORMAPI_KEY" \
  -H 'Content-Type: application/json' \
  -o facture.pdf \
  --data-binary @- <<'JSON'
{
  "invoiceNumber": "F2026-0002",
  "issueDate": "2026-11-03",
  "dueDate": "2026-12-03",
  "deliveryDate": "2026-10-31",
  "invoicePeriod": {
    "startDate": "2026-10-01",
    "endDate": "2026-10-31"
  },
  "currency": "EUR",
  "seller": {
    "name": "Atelier Exemple SAS",
    "vatId": "FR88100000009",
    "electronicAddress": "facturation@atelier-exemple.example",
    "address": {
      "street": "12 rue des Tanneurs",
      "city": "Lyon",
      "postcode": "69002",
      "country": "FR"
    },
    "registrationId": "100000009",
    "legalInformation": "SAS au capital de 40 000 EUR, RCS Lyon 100 000 009"
  },
  "buyer": {
    "name": "Maison Exemple SARL",
    "vatId": "FR37200000008",
    "address": {
      "street": "55 avenue de la République",
      "city": "Nantes",
      "postcode": "44000",
      "country": "FR"
    },
    "registrationId": "200000008"
  },
  "payment": {
    "meansCode": "58",
    "iban": "FR2012542547256985425874698",
    "reference": "F2026-0002",
    "accountName": "Atelier Exemple SAS",
    "bic": "EXMPFRPP"
  },
  "paymentTerms": "Paiement à 30 jours par virement.",
  "lines": [
    {
      "name": "Conseil en aménagement d'atelier",
      "description": "Octobre 2026",
      "quantity": 18,
      "unit": "HUR",
      "unitPrice": 85,
      "vatCategory": "S",
      "vatRate": 20
    },
    {
      "name": "Rapport de synthèse",
      "quantity": 1,
      "unit": "C62",
      "unitPrice": 320,
      "vatCategory": "S",
      "vatRate": 20
    }
  ],
  "france": {
    "recipient": "business",
    "operation": "services",
    "discountTerms": "Escompte de 2 % pour tout paiement sous 8 jours."
  }
}
JSON
Python (requests)
import os
import requests

# la requête f02 des exemples Factur-X
with open("f02-services-normapi.json", "rb") as f:
    body = f.read()

r = requests.post(
    "https://api.normapi.de/v1/invoices",
    params={"syntax": "zugferd", "profile": "france"},
    headers={
        "Authorization": f"Bearer {os.environ['NORMAPI_KEY']}",
        "Content-Type": "application/json",
    },
    data=body,
)
r.raise_for_status()
with open("facture.pdf", "wb") as f:
    f.write(r.content)
PHP
<?php
// la requête f02 des exemples Factur-X
$invoice = file_get_contents('f02-services-normapi.json');

$ch = curl_init('https://api.normapi.de/v1/invoices?syntax=zugferd&profile=france');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('NORMAPI_KEY'),
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => $invoice,
    CURLOPT_RETURNTRANSFER => true,
]);
$pdf = curl_exec($ch);
if (curl_getinfo($ch, CURLINFO_HTTP_CODE) !== 200) {
    throw new RuntimeException($pdf);
}
file_put_contents('facture.pdf', $pdf);

La requête de ces exemples est la prestation de services des exemples Factur-X. Les versions Python et PHP la lisent dans son fichier :

Contrôler une facture : POST /v1/validate

Envoyez un XML, CII ou UBL, ou un PDF Factur-X, avec rules=france : l'API le juge par les règles françaises du FNFE-MPE (France_RFE).

Un PDF Factur-X est aussi contrôlé comme fichier : le PDF/A-3, et le profil Factur-X que déclarent ses métadonnées XMP.

Avec l'en-tête Accept-Language à fr, les explications des erreurs sont en français.

Sans rules=france, l'API applique les règles allemandes et celles de la norme EN 16931. Une facture EXTENDED-CTC-FR est jugée par les règles françaises dans les deux cas.

Le contrôle est gratuit, ne compte jamais dans votre forfait, et fonctionne aussi sans clé, avec un débit limité.

curl
curl -X POST 'https://api.normapi.de/v1/validate?rules=france' \
  -H 'Accept-Language: fr' \
  -H 'Content-Type: application/pdf' \
  --data-binary @facture.pdf

Lire une facture reçue : POST /v1/parse

L'API lit une facture reçue, CII, UBL ou Factur-X, et la rend en JSON, sous la forme d'une requête POST /v1/invoices.

Une facture française est lue dans l'objet france. La réponse nomme le profil france quand cet objet a pu être lu en entier.

Les montants sont donnés tels que la facture les écrit, et la liste notMapped nomme chaque valeur que le JSON ne porte pas.

Pour contrôler la même facture par les règles françaises, passez son fichier à POST /v1/validate avec rules=france.

La lecture est gratuite, ne compte jamais dans votre forfait, et fonctionne aussi sans clé.

curl
curl -X POST 'https://api.normapi.de/v1/parse' \
  -H 'Content-Type: application/pdf' \
  --data-binary @facture.pdf

Chaque champ, chaque paramètre et chaque code de réponse sont décrits dans la documentation de l'API.

Ce que l'API ne fait pas

L'API ne transmet pas les factures : le fichier revient à votre logiciel. Entre assujettis établis en France, l'envoi passe par une plateforme agréée, selon le calendrier de la réforme (1er septembre 2026, ou 1er septembre 2027 pour les microentreprises et les PME). NormAPI n'en est pas une.

Elle ne conserve pas les factures : leur archivage reste chez vous.

Elle ne crée pas de facture au profil EXTENDED-CTC-FR, mais son contrôle juge ce profil par les règles françaises.

Pour un client établi en Allemagne, profile=en16931 écrit une facture au profil EN 16931, et profile=xrechnung une XRechnung pour un acheteur public.

Prix

ForfaitPrix par moisFactures créées
Validator0 €50 par mois
Starter19 €500 par mois
Business49 €2 500 par mois
Scale149 €10 000 par mois, puis 0,02 € par facture

Le contrôle et la lecture sont gratuits dans chaque forfait. Tous les prix sont hors TVA.

Avec un contrat et un engagement de service (SLA) : 599 € par mois pour 900 000 factures par an.

Commencer gratuitementL'espace client est en anglais.

Questions fréquentes

Qu'est-ce qu'une API de facture électronique ?

Une interface par laquelle un logiciel fait créer ses factures électroniques, au lieu d'écrire lui-même le format XML et de le tenir à jour. Avec NormAPI, votre logiciel envoie les données en JSON et reçoit une facture déjà contrôlée.

Combien coûte l'API ?

Le contrôle et la lecture sont gratuits. Pour la création, 50 factures par mois sont gratuites, puis 19 € par mois pour 500, 49 € pour 2 500 ou 149 € pour 10 000. Avec un contrat et un engagement de service, 599 € par mois pour 900 000 factures par an. Tous les prix sont hors TVA.

Quels fichiers l'API crée-t-elle avec profile=france ?

Un Factur-X, un PDF/A-3 lisible avec le CII intégré, au profil EN 16931, ou la même facture en CII ou en UBL. La page du PDF est en français.

Chaque facture est-elle contrôlée ?

Oui. Avec profile=france, chaque facture créée est contrôlée par les règles françaises du FNFE-MPE avant de vous être rendue, et une réponse 200 veut dire qu'elle les respecte. Une nouvelle version de ces règles ne demande aucun changement de votre intégration.

L'API envoie-t-elle les factures ?

Non. Le fichier revient à votre logiciel. Entre assujettis établis en France, l'envoi passe par une plateforme agréée, selon le calendrier de la réforme (1er septembre 2026, ou 1er septembre 2027 pour les microentreprises et les PME). NormAPI n'en est pas une.

Où les données sont-elles traitées ?

En mémoire, sur un serveur en Allemagne. Le contenu des factures n'est jamais conservé. Nous concluons un contrat de sous-traitance (article 28 du RGPD) avec chaque client.

Puis-je contrôler et lire les factures que je reçois ?

Oui, gratuitement. POST /v1/validate avec rules=france les juge par les règles françaises, et POST /v1/parse les lit en JSON. Avec l'en-tête Accept-Language à fr, les explications des erreurs sont en français.

Mon logiciel peut-il créer des factures pour ses propres clients ?

Oui. À chaque appel, l'en-tête X-Normapi-Customer nomme le client par votre propre référence. Le compte et le forfait restent les mêmes, mais NormAPI compte chaque client à part, avec un plafond mensuel et une clé à lui si vous le voulez.

Que se passe-t-il quand le forfait est épuisé ?

Avec Starter et Business, l'API répond 402 jusqu'au mois suivant ou à un changement de forfait. Scale continue au prix de chaque facture en plus, jusqu'au plafond que vous fixez, de 300 € par mois au départ.

Et pour un client établi en Allemagne ?

Le même appel, avec profile=en16931 pour une entreprise ou profile=xrechnung pour un acheteur public. Ces factures sont jugées par les règles allemandes et celles de la norme EN 16931.

La suite

Signaler une erreur dans ce texte