Un fichier lisible dans trente ans

Déclarer que le document suit une norme d'archivage : tout ce qu'il faut pour le relire est écrit dedans, pour toujours.

Écrit au premier niveau d'une requête, sous "archive"

En mots de tous les jours

Écrit pour tout le monde. Il dit ce que cela pose sur une feuille de papier, et ne vous demande rien de plus.

Un contrat signé aujourd'hui doit encore s'ouvrir dans vingt ans, sur une machine qui n'existe pas encore. Pour cela, il existe une norme : le fichier emporte tout ce dont il a besoin, l'écriture comprise, et ne renvoie à rien d'extérieur. On le déclare ici, et le document sort conforme. C'est ce qu'exigent les archives publiques, les tribunaux, et de plus en plus de services de comptabilité.

Pour un développeur

Écrit pour celui qui écrit le programme appelant : le modèle, les unités, et les réglages qui portent le poids.

archive déclare la norme d'archivage à laquelle le document se conforme, et fixe du même coup la version de PDF qui va avec. Deux valeurs sont au schéma : PDF/A-3 niveau B, qui autorise un fichier joint — ce dont une facture électronique a besoin — et PDF/A-4, bâti sur PDF 2.0, qui dit ce qu'il est dans son paquet de métadonnées et nulle part ailleurs. La norme exige que les polices soient écrites dans le fichier : une requête qui déclare archive passe par fonts ou type1_fonts.

Chaque clé, avec son défaut

La référence : quelles clés sont obligatoires, lesquelles sont facultatives, ce que vaut chacune par défaut et quelles combinaisons le serveur décline.

  • archive — chaîne, facultative, absente par défaut. Deux valeurs :
    • pdfa3b — PDF/A-3 niveau B. Impose la version PDF 1.7. C'est la partie qui autorise un fichier joint, donc la seule que invoice accepte.
    • pdfa4 — PDF/A-4, ISO 19005-4. Impose la version PDF 2.0. Le document ne porte pas de dictionnaire d'information, et n'accueille un fichier que si ce fichier est lui-même archivable.
  • Les polices sont écrites dans le fichier. Une face déclarée par standard_fonts est refusée sous cette clé, puisque rien de la police ne voyage avec le document ; fonts et type1_fonts conviennent.
  • output_intent déclare l'appareil pour lequel les couleurs sont dites ; en son absence, le document dit que ses couleurs sont du sRGB.
  • Le niveau A de la partie 3 et le niveau de la partie 4 portant des fichiers quelconques sont prévus pour une version future : le premier réclame un arbre de structure qu'une requête ne décrit pas encore, le second n'a de sens qu'avec un fichier porté, or la seule pièce qu'une requête porte est une facture.

Une requête entière qui le dessine

Envoyez ceci tel quel et un PDF revient. Rien n'en a été retiré.

Un nom ci-dessous tient lieu d'un fichier de police : mettez le fichier encodé à sa place, ou envoyez le fichier lui-même à côté de la description, comme une partie du même appel.

{
  "archive": "pdfa3b",
  "output_intent": { "identifier": "sRGB", "info": "sRGB IEC61966-2.1" },
  "metadata": {
    "title": "Minutes of the board meeting",
    "created": "2026-08-08T10:00: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": ["Minutes of the board meeting"],
      "font": "body",
      "font_size": 18
    }
  ]
}

La ligne qui l'envoie, en trois langages

Le document dans son ensemble

Les numéros que le lecteur affiche Cent courriers dans un seul fichier Ce que le document dit de lui-même Une facture qu'un humain et une machine lisent L'adresse contre laquelle les liens se lisent La version de PDF que le fichier déclare Ce qu'une image dit d'elle-même

Où aller ensuite

Chaque clé d'une requête, en une page Les trente-deux autres réglages d'une requête

Voir les prix Voir les exemples

Glossaire

norme
Une règle débattue en commission, publiée sous un numéro que n'importe qui peut acheter et lire, et identique pour toutes les entreprises qui s'en réclament. Dire qu'on la suit peut donc être vérifié face au texte. Une façon de faire qui s'est simplement répandue parce qu'elle marchait est une habitude du métier : utile, très suivie, et qui ne répond devant aucun texte.
PDF/A
Un PDF fabriqué pour rester lisible dans vingt ans. Tout ce qu'il faut pour l'afficher est rangé à l'intérieur du fichier : le dessin des lettres, les couleurs, la description du document. Rien ne peut donc manquer plus tard. Les administrations et les services d'archives le réclament sous ce nom.
Factur-X
Une facture qui sert deux lecteurs à la fois. Pour la personne qui la reçoit, c'est une page ordinaire. Pour son logiciel de comptabilité, ce sont les mêmes montants rangés à l'intérieur du même fichier, sous une forme qu'il lit tout seul : plus rien à retaper. La loi française l'impose entre entreprises.
la carte d'identité d'un fichier
Le bloc écrit à l'intérieur d'un fichier qui dit ce qu'est ce fichier : son titre, qui l'a fait, quand, et quelles règles il suit. Les moteurs de recherche et les archives le lisent ; un lecteur ne le voit jamais. Son nom technique est XMP.
RVB
Les trois lumières qu'un écran mélange pour faire une couleur : le rouge, le vert et le bleu. Les trois à fond donnent du blanc, les trois éteintes du noir. C'est la façon de dire une couleur pour tout ce qui est éclairé par derrière, et la mauvaise façon de la dire pour une presse, qui pose de l'encre sur du papier blanc.
police
Le dessin de chaque lettre, de chaque chiffre et de chaque signe qu'un document écrit, rangé dans un fichier à part. Un PDF emporte à l'intérieur de lui-même les polices dans lesquelles il est composé : c'est pour cela qu'il s'ouvre à l'identique sur une machine qui ne les a jamais eues. Sans elles, un lecteur en met une autre à la place, et la mise en page bouge.
requête
Un appel au service : vous envoyez ce que le document doit dire, et vous recevez le document. Votre facture compte ces appels, un par document. Le nombre de pages d'un document n'est jamais compté.

Tous les mots que le site explique