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| CONTENTFormattabelle
| Formatcode | Dokumenttyp | Darstellung | Peppol |
|---|---|---|---|
| xtool.invoice.1_0, xtool.credit_note.1_0 | Rechnung, Gutschrift | Internes Modell | Nein |
| xrechnung.invoice.3_0.xml_ubl, .xml_ubl.extension, .xml_cii | Rechnung | XML (UBL, CII) | Ja (UBL) |
| xrechnung.credit_note.3_0.xml_ubl | Gutschrift | XML (UBL) | Ja |
| peppol_bis_billing.invoice.3_0.xml_ubl, .xml_cii | Rechnung | XML (UBL, CII) | Ja |
| peppol_bis_billing.credit_note.3_0.xml_ubl | Gutschrift | XML (UBL) | Ja |
| peppol_bis_self_billing.invoice.3_0.xml_ubl, .credit_note.3_0.xml_ubl | Rechnung, Gutschrift | XML (UBL) | Ja |
| factur_x_zugferd.invoice.2_4.pdf_xml.en16931, .pdf_xml.xrechnung | Rechnung | PDF + eingebettetes XML | Ja (XRechnung) |
| sap.invoice.idoc | Rechnung | IDoc | Nein |
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.
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 — Verwenden Sie ein von Peppol unterstütztes Format (z. B. Peppol BIS Billing, XRechnung UBL), wie von Ihrem Netzwerk oder Land gefordert. Siehe Peppol und Versand über Peppol.
- Öffentlicher Sektor (z. B. Deutschland) — XRechnung und ZUGFeRD sind häufig vorgeschrieben. Prüfen Sie die lokalen Vorgaben für das verpflichtende Format.
Individuelle Formate — die Implementierung eines Formats nach Ihren Anforderungen können wir auf Anfrage durchführen. Wenden Sie sich an den Support.
Lokale Anforderungen
Prüfen Sie vor der Wahl die Anforderungen Ihres Landes oder Ihrer Branche an das verpflichtende E-Rechnungsformat. Oder kontaktieren Sie uns über den Support für eine Beratung.