Eine Rechnung, die Mensch und Maschine gleichermaßen lesen
Erzeugen Sie eine Rechnung, die ein Mensch liest und die in derselben Datei die Daten trägt, die die Buchhaltung selbst liest.
In einem echten PDF ansehen
Factur-X: die elektronische Rechnung
Die elektronische Rechnung, die das französische Recht seit September 2026 verlangt: eine Datei, eine Seite, die ein Mensch liest, und dieselbe Rechnung darin als XML. Danach ist nichts abzugleichen, denn es gibt immer nur eine Rechnung.
Das PDF öffnen Das vollständige Beispiel ansehen
Auch zu sehen in: Eine Rechnung, die fragt, bevor sie fordert
Zusammenfassung
Eine Rechnung hat zwei Leserschaften. Ein Mensch sieht sie an und sieht die Positionen, die Beträge, das Datum. Buchhaltungssoftware will dieselben Zahlen in Felder sortiert, um sie ohne erneutes Abtippen zu buchen. Frankreich führt das für Unternehmen schrittweise ein, und für das Auge bleibt die Datei eine ganz gewöhnliche Rechnung.
Technisch
Auf der obersten Ebene einer Anfrage geschrieben, unter
"invoice"
invoice fügt das Rechnungs-XML dem Dokument als Anhang hinzu, verknüpft es über /AF und gibt an, was es ist: das Profil der Norm, der es folgt, seine Version, seine /AFRelationship zum Dokument und wann die Daten zuletzt geändert wurden. Das XML kommt neben der Anfrage an, in einem Formularteil mit dem hier angegebenen Namen. Eine Rechnung braucht die Archivierungsnorm, die einen Anhang beliebiger Art erlaubt, daher gibt die Anfrage "archive": "pdfa3b" an. Der Anhang heißt immer factur-x.xml, der Name, den die Rechnungsnorm festlegt.
Anfrageschema
-
invoice— Objekt, optional, standardmäßig nicht gesetzt. -
invoice.xml— Zeichenkette, erforderlich. Der Name des mitgelieferten Teils mit dem XML. Ein Name, den kein Teil trägt, wird abgelehnt. -
invoice.profile— Zeichenkette, erforderlich, so geschrieben, wie die Norm es schreibt. Fünf Werte:"MINIMUM","BASIC WL","BASIC","EN 16931","EXTENDED". -
invoice.version— Zeichenkette, optional, standardmäßig"1.0". Die Version der Spezifikation, der das XML folgt. -
invoice.relationship— Zeichenkette, erforderlich, ohne Standardwert. Fünf Werte:source,alternative,data,supplement,unspecified. Wir schreiben den Wert, den Sie senden, unverändert: Hier vergleicht nichts ihn mit dem Profil der Rechnung; was die Datei über sich selbst erklärt, geben Sie an und verantworten Sie. -
invoice.issued— Zeichenkette, erforderlich, nach ISO 8601. Wann die Rechnungsdaten zuletzt geändert wurden, nicht wann das PDF erzeugt wurde. -
Die Anfrage gibt
"archive": "pdfa3b"an: Ohne Archivierungsnorm wird die Rechnung abgelehnt, und unterpdfa4ebenfalls, denn dieser Teil nimmt eine Datei nur an, wenn sie selbst archivtauglich ist. -
Die angehängte Datei heißt
factur-x.xml.
Eine vollständige Anfrage, die ein PDF erzeugt
Ein Name unten steht für eine Schriftdatei: Setzen Sie die kodierte Datei an seine Stelle oder senden Sie die Datei selbst neben der Beschreibung, als mitgelieferten Teil desselben Aufrufs. Eine Seite trägt eine echte, bereits kodierte Schrift, und ihre Anfrage wird unverändert gesendet.
{
"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
}
]
}Das Dokument als Ganzes
Die Nummern, die die Anzeigesoftware zeigt Hundert Briefe in einer einzigen Datei Was das Dokument über sich sagt Was das Dokument über sich sagt, einmal gesagt Text, den niemand kopieren kann Notizen, die ein Programm in der Datei für sich hinterlässt Die Notizen, die ein Programm auf einer Seite hinterlässt Die Daten, die ein Programm an einen Farbabschnitt hängt Eine Datei, die noch in Jahrzehnten lesbar ist Die Drucknorm, die das Dokument beansprucht Die beanspruchte Norm für variablen Datendruck Das Passwort, das es öffnet, und was damit getan werden darf Die Adresse, gegen die relative Links gelesen werden Die PDF-Version, die die Datei angibt Die PDF-Erweiterungen, die die Datei zu nutzen angibt Was ein Bild über sich sagt, und wie es gelesen wird Die Anhänge, die das Dokument neben seinen Seiten trägt Dateien, die das Dokument nennt, ohne sie zu enthalten Die Anhänge als Portfolio gezeigt Welche Anhänge eine Seite beansprucht Welche Anhänge eine Schrift beansprucht Der Ausweis, den eine einzelne Schrift trägt Welche Anhänge die Karte des Dokuments beansprucht Eine anderswo geschriebene Dokumentkarte Die Bereiche einer Seite, in denen ein Leser misst Der Ausweis, den eine einzelne Seite trägt Die Barrierefreiheitsnorm, die das Dokument beansprucht Die Normen, an denen das fertige Dokument gemessen wird
Wohin als Nächstes
Jeder JSON-Schlüssel einer Anfrage, auf einer Seite Die übrigen einundvierzig Einstellungen einer Anfrage