Factur-X
France · obligation au 1er sept. 2026Factur-X est le format hybride français de facture électronique : un PDF normal, lisible par un humain, avec un fichier XML CII conforme intégré comme pièce jointe PDF/A-3. Un seul fichier fonctionne à la fois pour une personne qui l'ouvre et un système qui l'analyse.
Ce que c'est
Le PDF visible et le factur-x.xml intégré (CII, profil EN 16931) décrivent la même facture — c'est tout le principe du format. C'est aussi la syntaxe XML utilisée par le ZUGFeRD 2.x allemand, donc un document Factur-X bien formé est largement interopérable entre les deux marchés.
Où c'est obligatoire
L'obligation de facturation électronique B2B en France démarre le 1er septembre 2026 : chaque facture B2B française doit transiter par une Plateforme Agréée immatriculée, le plus souvent sous forme de Factur-X. Voir notre page pré-flight dédiée pour l'ensemble des règles BR-FR (61 codes) et les recommandations spécifiques aux PA — cette page couvre le format de document Factur-X lui-même.
Ce que nous ne faisons pas. CrateAPI n'est pas une Plateforme Agréée et ne transmet pas de factures via une PA. Nous produisons et validons le document ; le soumettre via une PA immatriculée reste une étape séparée.
Essayer
curl -X POST "$BASE/v1/generate/facturx/embed" \ -H "X-API-Key: $KEY" \ -F "invoice=<invoice.json" -F "pdf=@branded.pdf" -o facturx.pdf
Endpoints pertinents
| Endpoint | Notes |
|---|---|
POST /v1/generate/facturx | À partir d'un modèle de facture JSON — notre propre mise en page visuelle, XML CII EN 16931 intégré. |
POST /v1/generate/facturx/embed | Le produit phare : conserve VOTRE PDF de marque, intègre le XML conforme. Multipart, PDF jusqu'à 10 Mo. |
POST /v1/pdfa/validate?flavour=3bgratuit | Contrôle structurel veraPDF du conteneur PDF/A-3 — règles et clauses réussies/échouées. |
POST /v1/pdfa/consistency | Compare le XML intégré au texte visible du PDF, détecte les écarts entre les deux. |
Exemples et documentation
Téléchargez un exemple Factur-X validé depuis notre bibliothèque d'exemples, consultez notre guide pré-flight France, ou la référence API complète.
FAQ
Factur-X remplace-t-il ma maquette de facture actuelle ?
Pas forcément — POST /v1/generate/facturx/embed prend votre PDF de marque existant et y intègre le XML conforme, en conservant votre mise en page.
Est-ce la même chose que ZUGFeRD ?
Même socle CII et même principe hybride PDF, mais des écosystèmes nationaux différents — un fichier Factur-X est généralement lisible par les outils ZUGFeRD 2.x. Voir notre page XRechnung pour l'option XML seule de l'Allemagne.
CrateAPI soumet-il ma facture à une Plateforme Agréée ?
Non — la transmission via une PA reste une étape séparée. Voir /plateforme-agreee/ pour la checklist pré-flight.