Formate

xTool unterstützt mehrere E-Rechnungsformate. Jedes Dokument hat ein Format; es legt die Validierungsregeln sowie verfügbare Konvertierungen und Transformationen fest. Siehe Dokumentenmodell, Formatmodelle (Feldreferenz), Validierung und Konvertierung und API-Referenz zu den Format-Endpoints.

Jedes Format hat einen eindeutigen Formatcode; ein Formatmodell (im Wesentlichen die von xTool gelesene Datei), das als JSON dargestellt werden kann; und Dateiinhalt in seiner ursprünglichen Form — XML, PDF, IDoc oder andere Typen je nach Format.

flowchart TB
    CODE["Eindeutiger Formatcode"]
    MODEL["Formatmodell (JSON)"]
    CONTENT["Dateiinhalt: XML, PDF"]
    CODE --- MODEL
    MODEL <-->|transformation| CONTENT

xTool-Formate (Canonical-Hub)

xTool nutzt ein gemeinsames internes Feldmodell. xtool.canonical.1_0 ist der zentrale Hub für Formatkonvertierung, PDF-Erkennung und KI-Extraktion: Quellformate werden nach Canonical gemappt, von dort weiter in das Zielformat. Rechnung vs. Gutschrift steckt im Dokumenttyp (z. B. type_code 380 / 381), nicht in einem separaten Hub-Format.

xtool.invoice.1_0 und xtool.credit_note.1_0 bleiben eigenständige Arbeitsformate (strengere Pflichtfelder, typisierte Rechnung / Gutschrift). Sie können weiterhin erstellt, gespeichert, versendet und konvertiert werden; die Konvertierung zwischen externen Standards läuft über Canonical.

flowchart LR
    SRC["Quellformat"]
    CAN["xtool.canonical.1_0"]
    TGT["Zielformat"]
    SRC --> CAN --> TGT

Formattabelle

SFTP (ausgehend): Ein +Formatcode im Dateinamen bei einem Raw PDF startet automatische PDF-Erkennung, vergleichbar mit der manuellen Konvertierung in der Weboberfläche.

Verwendung des Formats

• Dokumente — Beim Erstellen oder Hochladen eines Dokuments wählen Sie ein Format (oder es wird aus dem XML erkannt). Validierung und Konvertierung nutzen dieses Format.
• API — Die Format-Endpoints (Validierung Modell/XML, Transformation Modell↔XML, Modell→PDF, XML→Modell, XML→PDF, Konvertierung, XML-Erkennung) akzeptieren oder liefern einen Formatcode. Siehe Validierung und Konvertierung.

CSV-Importformat (kein Arbeitsformat)

CSV wird nur als Importquelle unterstützt, um Rechnungsdaten nach xTool zu bringen — nicht als Dokumentformat zum Erstellen, Speichern, Versenden oder Konvertieren über die Format-API. Nach dem Import nutzt das Dokument das interne xTool-Modell. Spaltenbeschreibung, Dateiregeln und Beispiele: CSV-Importformat. Import-Anleitung: Dokumente importieren.

Bedeutung der Felder (Semantik)

Um zu verstehen, was die einzelnen Felder bedeuten (Rechnungsnummer, Ausstellungsdatum, Verkäufer, Käufer, Positionen, Summen usw.) und wie Sie das Formular oder den API-Request-Body ausfüllen, siehe Formatmodelle (Feldreferenz). Eine detaillierte Referenz nach Abschnitten und Feldern mit JSON/XML-Beispielen finden Sie unter Rechnungsmodell verstehen. Beispiele finden Sie unter Basis-Beispiel Rechnungsmodell.

Formatwahl

• Peppol — Peppol-fähiges Format (z. B. Peppol BIS Billing, XRechnung UBL). Siehe Peppol und Per Peppol versenden.
• Polen (KSeF) — FA(3)-XML. Siehe Mit KSeF verbinden.
• Frankreich — France CIUS, Peppol BIS Billing France oder Factur-X France. Siehe Frankreich E-Invoicing.
• Öffentlicher Sektor (z. B. Deutschland) — XRechnung und ZUGFeRD sind häufig vorgeschrieben.

Individuelle Formate — die Implementierung eines Formats nach Ihren Anforderungen können wir auf Anfrage durchführen. Wenden Sie sich an den Support.