Une facture qu’un humain et une machine lisent

Créer une facture qu’une personne lit, et qui contient dans le même fichier les données que la comptabilité lit toute seule.

Le résultat dans un vrai PDF

Factur-X : la facture électronique

La facture électronique que la loi française impose depuis septembre 2026 : un seul fichier, une page qu’une personne lit et la même facture à l’intérieur en XML. Plus rien à rapprocher ensuite, puisqu’il n’y a jamais qu’une seule facture.

Ouvrir le PDF Voir l’exemple complet

Également dans les exemples : Une facture qui demande avant de déclarer

Résumé

Une facture doit être lue par deux publics. Un humain la regarde et voit les lignes, les montants, la date. Le logiciel de comptabilité, lui, veut les mêmes chiffres rangés dans des cases, pour les enregistrer sans que personne les retape. La France l’impose progressivement aux entreprises, et à l’œil le fichier reste une facture parfaitement ordinaire.

Techniquement

Écrit au premier niveau d’une requête, sous "invoice"

invoice ajoute au document le XML de facturation en pièce jointe, l’associe par /AF, et déclare ce qu’il est : le profil de la norme qu’il suit, sa version, son /AFRelationship au document, et la date à laquelle les données ont changé pour la dernière fois. Le XML arrive à côté de la requête, dans une partie du formulaire dont le nom est donné ici. Une facture demande la norme d’archivage qui autorise une pièce jointe de n’importe quelle nature : la requête déclare donc "archive": "pdfa3b". La pièce jointe s’appelle toujours factur-x.xml, le nom que fixe la norme de facturation.

Schéma de la requête

  • invoice — objet, facultatif, absent par défaut.
  • invoice.xml — chaîne, obligatoire. Le nom de la partie fournie qui contient le XML. Un nom qui ne désigne aucune partie est refusé.
  • invoice.profile — chaîne, obligatoire, écrite comme la norme l’écrit. Cinq valeurs : "MINIMUM", "BASIC WL", "BASIC", "EN 16931", "EXTENDED".
  • invoice.version — chaîne, facultative, "1.0" par défaut. La version de la spécification que le XML suit.
  • invoice.relationship — chaîne, obligatoire, sans valeur par défaut. Cinq valeurs : source, alternative, data, supplement, unspecified. Une facture électronique n’est jamais déclarée supplement ni unspecified. Avec les profils MINIMUM et BASIC WL, où la facture ne comporte aucune ligne, seule data est admise, car c’est la page elle-même qui constitue la facture. Toute autre combinaison est refusée.
  • invoice.issued — chaîne, obligatoire, au format ISO 8601. Le moment où les données de la facture ont changé pour la dernière fois, et non celui où le PDF a été créé.
  • La requête indique "archive": "pdfa3b", "pdfa3u", "pdfa3a" ou "pdfa4f" : sans norme d’archivage, la facture électronique est refusée ; elle l’est aussi avec toute autre partie de PDF/A, car aucune ne permet de joindre un fichier de n’importe quel type.
  • Le fichier joint s’appelle factur-x.xml.

Une requête entière qui crée un PDF

Un nom ci-dessous tient lieu de fichier de police : mettez le fichier encodé à sa place, ou envoyez le fichier lui-même à côté de la description, comme une pièce fournie dans le même appel. Une page contient une vraie police déjà encodée, et sa requête part telle quelle.

{
  "archive": "pdfa3b",
  "invoice": {
    "xml": "invoice_xml",
    "profile": "MINIMUM",
    "relationship": "data",
    "issued": "2026-08-08T09:30:00+02:00"
  },
  "output_intent": { "identifier": "sRGB", "info": "sRGB IEC61966-2.1" },
  "metadata": {
    "title": "Invoice 2026-014",
    "created": "2026-08-08T09:30:00+02:00"
  },
  "fonts": [{ "name": "body", "data": "PASTE_THE_FONT_FILE_BASE64_HERE" }],
  "items": [
    {
      "type": "text",
      "rect": { "llx": 60, "lly": 740, "urx": 535, "ury": 768 },
      "content": ["Invoice 2026-014 — total 5 100.00 EUR"],
      "font": "body",
      "font_size": 16
    }
  ]
}

La ligne qui l’envoie, en trois langages

Le document dans son ensemble

Les numéros que montre le logiciel de lecture Cent courriers dans un seul fichier Ce que le document dit de lui-même Ce que le document dit de lui-même, dit une seule fois Un texte que personne ne peut copier Les notes qu’un programme laisse pour lui-même Les notes qu’un programme laisse sur une page Les données qu’un programme accroche à un passage d’encre Un fichier encore lisible dans des dizaines d’années La norme d’impression que le document déclare La norme d’impression variable déclarée par le document Le mot de passe qui l’ouvre, et ce qu’on peut en faire L’adresse à partir de laquelle se lisent les liens relatifs La version de PDF que le fichier déclare Les extensions de PDF dont le fichier dit se servir Ce qu’une image dit d’elle-même, et comment elle est lue Les pièces jointes du document, à côté de ses pages Des fichiers que le document nomme sans les contenir Les pièces jointes, présentées en portefeuille Les pièces jointes que revendique une page Les pièces jointes que revendique une police La fiche d’identité propre à une police Les pièces jointes que revendique la fiche du document Une fiche de document rédigée ailleurs Les zones d’une page où un lecteur mesure La fiche d’identité que contient une seule page La norme d’accessibilité que le document déclare Les normes contre lesquelles le document fini est mesuré

Où aller ensuite

Toutes les clés JSON d’une requête, en une page Les quarante et un autres réglages d’une requête

Voir les prix Voir les exemples