Digitale Formate (XML, XRechnung, ZUGFeRD)
Dieses Kapitel behandelt die Verarbeitung von digitalen Formaten, die nicht mit visuellen Repräsentation eines Dokumentes (also Bilder, Scans, PDFs) zusammenhängen.
Das sind Formate wie XRechnung, ZUGFeRD usw. die üblicherweise als XML- oder JSON-Dateien verschickt werden.
- Einführung Digitale Formate: XML, XRechnung und ZUGFeRD in der Software Squeeze
- XML-Pipeline
- XRechnung und ZUGFeRD
- Auswertungstabellen XRechnung und ZUGFeRD
- Sichtbeleg - Feldzuordnung der PDF-Darstellung
- Konfiguration XML-Auswertung
- XML Formate in Squeeze
- XML-Prüfbericht KoSIT
- Mandanten- und Lieferanten- Erkennung
- Umschlüsselung von Codes eines elektronischen Beleges
Einführung Digitale Formate: XML, XRechnung und ZUGFeRD in der Software Squeeze
Willkommen zur Dokumentation von Squeeze, insbesondere des Moduls Elektronische-Daten, einer leistungsstarken Komponente zur Verarbeitung digitaler Formate.
In dieser Dokumentation erfahren Sie alles Wichtige zur Nutzung und Verwaltung dieses Moduls, der Schwerpunkt liegt hierbei auf der Verarbeitung von gängigen, digitalen, Formate wie ZUGFeRD und XRechnung. Obwohl die Unterstützung für benutzerdefinierte XML-Formate (Customized XMLs) noch nicht verfügbar ist, wird diese Funktionalität in zukünftigen Updates bereitgestellt.
Digitale Formate im Überblick
In der heutigen digitalen Geschäftswelt sind effiziente und standardisierte Datenformate unerlässlich. Die folgenden Formate spielen dabei eine besonders wichtige Rolle:
XML (Extensible Markup Language) XML ist ein vielseitiges und weit verbreitetes Datenformat, das speziell für die strukturierte Datenspeicherung und -übertragung entwickelt wurde. Es ermöglicht die Definition eigener Tags und Strukturen, was es zu einem flexiblen Werkzeug für unterschiedlichste Anwendungen macht. Der Einsatz von XML sorgt für eine effiziente und transparente Datenkommunikation.
XRechnung XRechnung ist ein speziell für elektronische Rechnungen entwickeltes Format, das in vielen europäischen Ländern, einschließlich Deutschland, gesetzlich vorgeschrieben ist. Es basiert auf XML und erfüllt die Anforderungen der Europäischen Norm EN 16931. Durch die Standardisierung von Rechnungsdaten ermöglicht XRechnung eine einfache und effiziente Verarbeitung und Archivierung elektronischer Rechnungen.
ZUGFeRD (Zentraler User Guide des Forums elektronische Rechnung Deutschland) ZUGFeRD ist ein hybrides Rechnungsformat, das sowohl ein menschenlesbares PDF-Dokument, als auch maschinenlesbare XML-Daten kombiniert. Dieses Format vereinfacht die Rechnungsverarbeitung, indem es die Vorteile beider Formate nutzt. Es ist besonders nützlich für Unternehmen, die mit unterschiedlichen Geschäftspartnern zusammenarbeiten und verschiedene Anforderungen an Rechnungsformate erfüllen müssen.
Squeeze: Ihre Lösung für die Verarbeitung digitaler Formate
Squeeze ist darauf ausgelegt, die Verarbeitung von ZUGFeRD- und XRechnung-Formaten nahtlos zu integrieren. Mit Squeeze können Unternehmen ihre Rechnungsprozesse effizient automatisieren und sicherstellen, dass sie den aktuellen gesetzlichen Anforderungen entsprechen. Die Unterstützung für benutzerdefinierte XML-Formate ist in der Entwicklung und wird in einer zukünftigen Version von Squeeze verfügbar sein, hier finden Sie die aktuell unterstützten Formate.
Hauptfunktionen von Squeeze:
- Verarbeitung von ZUGFeRD-Rechnungen: Squeeze kann ZUGFeRD-Rechnungen problemlos einlesen und die enthaltenen Daten sowohl aus dem PDF- als auch aus dem XML-Teil extrahieren.
- Unterstützung für XRechnung: Squeeze ermöglicht die einfache Handhabung von XRechnungen, was die Konformität mit europäischen Vorschriften sicherstellt.
- Prüfbericht der Koordinierungsstelle für IT-Standards(KoSIT): Squeeze generiert auf Kundenwunsch Konformitätsnachweise für XML-Daten gemäß den KoSIT-Standards.
- Umschlüsselung von technischen Codes in Werte:
Mit Squeeze können Codes die in elektronischen Belegen genutzt werden in hausinterne Werte umgeschlüsselt werden.
Weiterführende Informationen
In den folgenden Kapiteln dieser Dokumentation finden Sie detaillierte Anleitungen zur Funktionsweise, Konfiguration und Verwaltung des Moduls Digitale Formate.
Wir empfehlen, diese Dokumentation gründlich zu lesen und bei Bedarf als Referenz zu verwenden, um das volle Potenzial von Squeeze auszuschöpfen.
XML-Pipeline
In der XML-Pipeline von Squeeze werden XML-Dokumente durch speziell angepasste Verarbeitungsstufen geführt, um den unterschiedlichen Anforderungen der Datenextraktion und Dokumentenkategorisierung gerecht zu werden.
| Schritt | Aktuelle Pipeline |
|---|---|
|
Einganskanäle |
- Alle Eingangskanäle prüfen die Dokumente auf ihre Validität in Bezug auf die EN16931-Spezifikationen. |
|
Initialisierungs-Schritt |
- Hochgeladene XML-Dateien werden in ein internes Standard-XML-Format ( - Je nach Kundenwunsch wird in diesem Schritt ein KoSIT-Prüfbericht erstellt. |
|
Barcode- Extraktions-Schritt |
- Viewer-Bilder auf Basis der PDF werden erstellt, gilt auch für ZUGFeRD und XRechnung |
|
OCR-Schritt |
- PDF-Dateien mit eingebetteten XML werden normal verarbeitet, um ein OCR-Ergebnis zu erstellen. - Dieser Schritt wird für reine XML-Dateien übersprungen. |
|
Klassifizierungs-Schritt |
- Die Klassifizierung von XML-Dokumenten ist derzeit nicht möglich. Eine Fehler wird erzeugt, sobald das Dokument keine Dokumentenklasse nachweist |
|
Extraktions-Schritt |
- Übliche Extraktionsmechanismen werden ausgeführt oder übersprungen durch die Stapelklasseneigenschaft: - |
Extraktion von XMLs
In der XML-Pipeline von Squeeze erfolgt die XML-Extraktion als letzter Schritt vor der Autovalidierung/Validierung und hat dabei eine besondere Rolle: Sie überschreibt extrahierte Feldwerte aus den KI-Extraktionen und den Lokatoren-Ergebnissen. Die Extraktion von XML-Daten basiert auf dem Mapping, welches im Administrationsbereich angepasst werden kann. Alternativen werden gemäß der Definition im Mapping verarbeitet.
Rendering von XMLs
Das XML-Rendering in Squeeze bezieht sich auf den Prozess der Erstellung von PDF-Dokumenten aus XML-Dateien. Dieser Prozess unterscheidet sich je nach Art des XML-Dokuments und umfasst spezifische Anforderungen für standardisierte und benutzerdefinierte XML-Formate.
Rendering von Spezifischen XML-Dokumenten
Für standardisierte XML-Formate wie XRechnung und ZUGFeRD, die der Norm EN16931 entsprechen, erfolgt das Rendering nach den folgenden Schritten:
-
Erstellung des Zwischenformats: Im InitStep wird aus der XML-Datei ein Zwischenformat erstellt, das als Basis für das PDF-Rendering dient. Dieses Zwischenformat wird aus der
intermediate.xmlgeneriert, die die für die PDF-Erstellung benötigten Daten enthält. -
PDF-Erzeugung: Basierend auf dem Zwischenformat wird ein PDF-Dokument erstellt, das die strukturierten Daten aus der XML übersichtlich darstellt. Dies ermöglicht die Generierung von PDFs, die den Anforderungen der jeweiligen Spezifikation entsprechen und für den Austausch und die Archivierung verwendet werden können.
Ausblick
In einer zukünftigen Version von Squeeze ist geplant, auch für XML-Dokumente, die nicht den EN16931-Spezifikationen entsprechen, eine vollständige Verarbeitung zu ermöglichen. Diese Weiterentwicklung wird es erlauben, alle Arten von XML-Dokumenten einheitlich und umfassend zu behandeln, wodurch die Integration und Handhabung von benutzerdefinierten XML-Formaten weiter verbessert wird.
XRechnung und ZUGFeRD
XRechnung und ZUGFeRD sind digitale Rechnungsformate, welche in der Praxis als XML-Dateien oder PDFs mit eingebetteten XML-Daten verschickt werden.
Seit März 2026 bilden in Deutschland bei hybriden E-Rechnungen die im strukturierten Teil (XML) vorliegenden Rechnungsdaten den führenden Teil.
Aufgrund dessen werden ZUGFeRD Belege seit Version 2.33 automatisch im strikten Modus verarbeitet (siehe Strict Mode)
Validierung von digitalen Rechnungen
Nicht alle digitalen Rechnungen, die Sie erhalten erfüllen die öffentlichen Standards. In der Praxis kann es daher passieren, dass Lieferanten digitale Rechnungen senden, die nicht durch Squeeze verarbeitet werden, weil die Dateien nicht valide sind.
Eine digitale Rechnung ist valide, wenn sie diese zwei Kriterien erfüllt:
- Die Syntax der XML-Datei ist valide. Sie enthält also gültiges XML
- Die fachlichen Kriterien an eine EN-16931 + Extension XML sind erfüllt. Beispiel: Die Rechnung enthält eine gültige Kombination aus Netto-, Steuer- und Brutto-Beträgen.
In der Validierung (UI) weist ein Icon darauf hin, dass ein Dokument als XRechnung verarbeitet wurde.
Validatoren
Hier ein Liste von Validatoren, mit denen Sie prüfen können, ob eine digitale Rechnung valide ist:
- https://erechnungsvalidator.service-bw.de/
- https://validator.invoice-portal.de/
- https://ecosio.com/en/peppol-and-xml-document-validator/
- https://peppol.munich-enterprise.com/xrechnung/
- https://www.zugferd-community.net/de/dashboard/validation (Speziell auch alle ZugFERD Varianten)
Extraktion
|
Schritt |
|
|---|---|
|
Extraktion |
|
Konfiguration von XML-Auswertungen
Ab der Version 2.13 und nach Freischaltung durch Dexpro oder einen der Partner, können Sie in die Extraktion von XML-Werten bei EN16931 konformen XML-Dokumenten eingreifen.
Siehe auch XRechnung und ZUGFeRD Auswertungstabellen
PDF-Rendering
Das PDF-Rendering für XRechnung und ZUGFeRD hat sich ebenfalls geändert:
-
EN-16931 konforme XML-Dokumente: Für standardisierte XML-Dokumente wie XRechnung und ZUGFeRD wird eine PDF aus dem Zwischenformat erstellt, das im InitStep generiert wurde. Dieses Zwischenformat basiert auf der
intermediate.xmlund wird genutzt, um alle relevanten Daten in einer übersichtlichen PDF-Darstellung zu präsentieren.
In der zukünftigen Version von Squeeze wird die vollständige Unterstützung für die PDF-Erzeugung von nicht EN16931-konformen XML-Dokumenten implementiert. Dies wird die Flexibilität und Integration für benutzerdefinierte XML-Formate weiter verbessern.
XML-Prüfbericht KoSIT
Ab Version 2.15 von Squeeze bietet unsere Squeeze-Lösungen die Möglichkeit, automatisch Prüfberichte für verarbeitete ZUGFeRD und XRechnung-Daten zu erstellen. Diese Berichte entsprechen den KoSIT-Standards und gewährleisten die Datenqualität. Während bei XRechnungen eine strikte Fehlerprüfung erfolgt, um die Datenintegrität zu schützen, bietet das System für ZUGFeRD-Belege eine größere Flexibilität. Dies ermöglicht eine individuelle Anpassung der Verarbeitungsprozesse an die spezifischen Anforderungen der Kunden.
Die Aktivierung der Funktionalität erfolgt durch unsere Partner oder unserer Berater. Den KoSIT Prüfbericht, können Sie sich in der Validierung des Dokumentes anzeigen lassen oder direkt über das Kontext-Menü in der Validierung herunterladen.
Umschlüsselung von Codes in Werte
Ab der Version 2.16 ist es möglich, Codes die in elektronischen Belegen genutzt werden in eigene Werte umzuschlüsseln. Solche Codes werden z.B. verwendet um Mengeneinheiten festzulegen, Steuerfälle zu definieren oder auch um den Vorgang festzulegen.
Hier die Anleitung, wie die Umschlüsselung der Codes aus elektronischen Belegen konfiguriert werden kann.
ZUGFeRD Strict Mode
Seit Version 2.33 (Juli 2026)
Laut gesetzlicher Verarbeitungsvorschrift bilden nunmehr die im strukturierten Teil (XML) vorliegenden Rechnungsdaten den führenden Teil. Weitere Informationen im FAQ des Bundesfinanzministerium.
Der strikte Modus hat folgende Auswirkungen auf die Verarbeitung von ZUGFeRD Vorgängen in SQUEEZE:
E-Mail Anhang Filterung
Anlagenfilter werden zugunsten der XML Verarbeitung übersteuert.
Bestehende Filter, welche PDFs bevorzugen, werden demnach beim E-Mail Import übersteuert, sodass das XML bevorzugt verarbeitet wird.
Dieses Verhalten wird geloggt, um eine nachvollziehbare Verarbeitung zu gewährleisten.
Zusätzlich gibt es eine Systemprüfung, mit der eine eventuelle Fehlkonfiguration überprüft werden kann.
Automatische Validierungsreport Generierung
In dem strikten Modus wird die Generierung eines Validerungsreports der XML forciert (ausgenommen Windows Systeme).
Wenn die Generierung des Reports nicht gewünscht ist, muss der gesamte Strict Mode deaktiviert werden.
Original PDF als Anhang - Generierung Visualisierung
Die originale PDF Datei wird bei der Verarbeitung in den Anhang verschoben.
Zur Visualisierung wird wie bei xRechnungen eine Visualisierung der XML Rechnungsdaten als PDF erzeugt, dessen Basis die verarbeitete XML ist.
Damit soll sichergestellt werden, dass ausschließlich die XML Daten angezeigt werden.
Dadurch treten keine fehlerhafte Diskrepanzen zwischen XML und PDF desselben Vorgangs auf.
Ab Version 2.34 lässt sich dieses Verhalten über die Stapelklasseneigenschaft ZUGFeRDstrictModeOriginalPDF umkehren.
Original PDF als Beleg beibehalten (ab Version 2.34)
Kunden, die im Zielsystem weiterhin ihr Original PDF sehen und archivieren möchten, können die Wahl des Anzeigedokuments über die Stapelklasseneigenschaft ZUGFeRDstrictModeOriginalPDF umkehren.
Ist sie aktiv, bleibt das Original PDF der Beleg, der im Viewer angezeigt und exportiert wird. Die aus der XML erzeugte Visualisierung wird stattdessen als xrechnung.pdf in den Anhang gelegt und steht dort weiterhin zur Prüfung der XML Werte zur Verfügung.
An der Auswertung ändert sich nichts: Die Rechnungsdaten werden weiterhin ausschließlich aus der XML übernommen, der Validierungsreport wird weiterhin erzwungen und SkipXmlExtraction weiterhin übersteuert. Die Eigenschaft betrifft ausschließlich die Frage, welches PDF der Beleg ist.
Die Eigenschaft ist im Standard deaktiviert und wirkt nur bei ZUGFeRD Belegen, also PDFs mit eingebetteter XML. Bei reinen XRechnungs-XML und bei generischen XML Typen hat sie keine Auswirkung.
Ist die XML fehlerhaft oder ungültig, bleibt auch dann das Original PDF der Beleg; der Fehler-Platzhalter wird als Anhang beigelegt. Der Vorgang läuft in diesem Fall nicht auf einen Fehler, erreicht die Validierung aber ohne Feldwerte, da auch hier keine Daten aus dem PDF übernommen werden.
Da im Strict Mode keine OCR auf dem Original PDF läuft, steht im Viewer auf dem Beleg keine Textmarkierung zur Verfügung. Die angezeigten Werte stammen aus der XML.
Überspringen der XML Extraktion (SkipXmlExtraction)
Diese Eigenschaft wird durch den Strict Mode übersteuert (und auch geloggt).
Die XML Verarbeitung wird forciert, auch wenn die Eigenschaft SkipXmlExtraction aktiviert ist.
Generische XMLs
Der ZUGFeRD strict mode findet KEINE Anwendung bei generischen XML Typen.
Bei generischen XML Vorgängen (nicht ZUGFeRD oder xRechnung) greifen die Auswirkungen des Strict Mode nicht, selbst wenn dieser für die Stapelklasse aktiviert wurde.
Generierte PDF als Anhang bei StrictMode=Off
Mit der Squeeze Version 2.32 (Juni 2026) wurde die Funktionalität erweitert und es wird jetzt immer eine Visualisierung generiert.
Die Visualisierung wird ab Version 2.30 im Input Verzeichnis des Tenants generiert, wenn die Stapelklassen - Eigenschaft "ZUGFeRDStrictMode" den Wert "Ja" aufweist.
Mit Einführung der Version 2.32 kann die Visualisierung im Attachment Verzeichnis des Tenants generiert werden, wenn die Stapelklassen - Eigenschaft ZUGFeRDStrictMode den Wert "Nein" zugewiesen bekommt.
Dadurch gibt es die Möglichkeit jederzeit die in der XML-Datei enthaltenen Werte zu überprüfen.
ZUGFeRD 2.5 / Factur-X 1.09
Seit Version 2.33 (Juli 2026)
Am 01.07.2026 wurde die neue Version ZUGFeRD 2.5 veröffentlicht. ZUGFeRD 2.5 entspricht dabei Factur-X 1.09.
Die Leitweg-/Guideline-URNs sind identisch zu ZUGFeRD 2.4. Bereits verarbeitete Belege oder bestehende Konfigurationen (z. B. XML-Auswertungen, Umschlüsselungen) sind von dem Update nicht betroffen und benötigen keine Anpassung.
Folgendes wurde für ZUGFeRD 2.5 / Factur-X 1.09 aktualisiert:
Neue XSD-Schemata und Schematron-Regeln für die folgenden Profile:
- MINIMUM
- BASIC WL
- BASIC
- EN16931/Comfort
- EXTENDED
Der KoSIT-Validator wurde aktualisiert und erkennt entsprechende Belege im Prüfbericht nun als „ZUGFeRD 2.5/Factur-X 1.09" (vorher z. B. „ZUGFeRD 2.4/Factur-X 1.08")
Abwärtskompatibilität zu allen vorherigen ZUGFeRD-Versionen (1.0 bis 2.4) bleibt vollständig bestehen
Eine Übersicht aller aktuell unterstützten Versionen finden Sie unter XML Formate in Squeeze.
Anmerkung für Entwickler (Nicht rückwärtskompatible Änderung)TransformResult::getDetectedType() gibt jetzt für InvoiceFormat vordefinierte Werte (enum) zurück.
Dabei sind die folgenden Optionen verfügbar: zugferd_1p0 cii cii_standalone ubl_invoice ubl_credit_note ksef_fa3
PDF-Darstellung mehrerer Zahlungsbedingungen (BT-9 / BT-20)
Seit Version 2.34 (August 2026)
Enthielt eine XRechnung oder ein ZUGFeRD-/Factur-X-Beleg mehr als eine Zahlungsbedingung (SpecifiedTradePaymentTerms, z. B. eine reguläre Fälligkeit zusammen mit einer Skonto-Zahlungsbedingung), konnte die Erstellung der Vorschau-PDF fehlschlagen. In diesem Fall wurde automatisch eine Platzhalter-PDF erzeugt – ohne dass der KoSIT-Prüfbericht einen Fehler anzeigte.
Erkennungsmerkmale aus der Praxis:
- Der KoSIT-Prüfbericht meldet keinen Fehler
- Im Anhang liegt statt der erwarteten Rechnungsdarstellung eine Platzhalter-PDF
- Der Beleg enthält mehr als eine Zahlungsbedingung, typischerweise reguläre Fälligkeit zusammen mit einer Skonto-Bedingung
Die PDF-Darstellung ordnet Zahlungsbedingung und Fälligkeitsdatum jetzt je Vorkommen korrekt einander zu, statt bei mehreren Vorkommen abzustürzen oder Datum und Bedingung zu vertauschen.
Diese Änderung betrifft ausschließlich die PDF-Vorschau. Die Extraktion des Feldes `DueDate` aus solchen Belegen wurde separat mit Version 2.35 (September 2026) korrigiert – siehe Auswertungstabellen XRechnung und ZUGFeRD.
PDF-Darstellung mehrerer Artikelpreis-Rabatte und -Zuschläge (BT-147)
Seit Version 2.34 (August 2026)
Enthielt eine Rechnungsposition mehr als einen Artikelpreis-Rabatt (Item_price_discount, BT-147), konnte die Erstellung der Vorschau-PDF fehlschlagen — analog zum bereits dokumentierten Fall bei mehreren Zahlungsbedingungen. In diesem Fall wurde automatisch eine Platzhalter-PDF erzeugt, ohne dass der KoSIT-Prüfbericht einen Fehler anzeigte.
Erkennungsmerkmale aus der Praxis:
- Der KoSIT-Prüfbericht meldet keinen Fehler
- Im Anhang liegt statt der erwarteten Rechnungsdarstellung eine Platzhalter-PDF
- Betroffen sind ausschließlich Positionen mit mehr als einem Artikelpreis-Rabatt
Zusätzlich unterscheidet die Darstellung jetzt korrekt zwischen Rabatt und Zuschlag auf Artikelpreisebene: bislang wurde jeder Wert unabhängig vom Vorzeichen als „Rabatt (netto)" dargestellt. Ein echter Preiszuschlag wird nun als eigener Posten „Zuschlag (netto)" ausgewiesen.
Diese Änderung betrifft ausschließlich die PDF- und HTML-Darstellung. An der Auswertung der Rechnungsdaten (Extraktion) ändert sich nichts.
Auswertungstabellen XRechnung und ZUGFeRD
Was mit Ihrem ZUGFeRD-/XRechnung-Dokument in Squeeze passiert
- Squeeze erkennt Format und Syntax der Rechnung (ZUGFeRD/Factur-X, XRechnung in CII- oder UBL-Syntax).
- Die Rechnung wird in ein standardisiertes internes Format überführt, das jedes im EN16931-Standard (dem europäischen E-Rechnungsstandard) definierte Feld erfasst – dies ist das gemeinsame semantische Datenmodell hinter ZUGFeRD, XRechnung und den meisten EU-E-Rechnungsformaten.
- Squeeze extrahiert anschließend eine konfigurierte Auswahl an Feldern aus diesen standardisierten Daten in Ihr Dokument.
Wichtig zu verstehen: Schritt 2 erfasst deutlich mehr Daten, als Schritt 3 aktuell bereitstellt.
Welche Felder automatisch in Ihr Dokument gelangen, welche sich ohne Entwicklungsaufwand aktivieren lassen und welche gar nicht erfasst werden, ist Gegenstand dieses Leitfadens.
Stufe 1 – Automatisch extrahiert, keine Einrichtung erforderlich
Jeder neue Squeeze-Mandant erhält dieses Mapping von Anfang an:
Hinweis: Die Spalte „Squeeze-Feldname" verwendet die internen Feldbezeichner, wie sie in dieser Dokumentation auf Englisch geführt werden; je nach Konfiguration Ihrer Squeeze-Oberfläche können abweichende, lokalisierte Bezeichnungen angezeigt werden.
| Feld (BT-Code) | Squeeze-Feldname | Hinweise |
|---|---|---|
| Rechnungsnummer (BT-1) | DocumentReference | Immer vorhanden |
| Rechnungsdatum (BT-2) | Document date | Immer vorhanden |
| Rechnungswährung (BT-5) | Currency | Immer vorhanden |
| Name des Verkäufers (BT-27) | Creditor name | Immer vorhanden |
| Land des Verkäufers (BT-40) | Creditor country | |
| USt-IdNr. des Verkäufers (BT-31) | VatId | Fehlt bei Kleinunternehmer-Rechnungen – das ist korrekt, kein Fehler |
| Bestellreferenz (BT-13) | Order number | |
| Zahlungsfälligkeitsdatum (BT-9) | DueDate | |
| Liefer-/Leistungsdatum (BT-72) | Service date | |
| Rechnungsgesamtbetrag inkl. USt (BT-112) | Total amount | |
| IBAN / Zahlungskontokennung (BT-84) | IBAN | Nur vorhanden, wenn die Zahlungsart Überweisung ist |
| USt-Aufschlüsselung, bis zu 3 Steuerkategorien (BT-116/117/119, ×3) | Net amount / tax amount / tax rate (sowie eine 2. und 3. Gruppe) | Auf 3 Kategorien begrenzt – siehe „Bekannte Grenzen" unten |
| Je Rechnungsposition: Menge, Artikelname, Einzelpreis, Positions-Nettobetrag, USt-Satz der Position (BT-129/153/146/131/152) | Positionstabelle | 5 von vielen verfügbaren Positionsfeldern |
| Käuferkennung/-name (BT-46/44) | Ihr Unternehmensdatensatz (per Stammdatenabgleich) | Dient dem Kundenabgleich, wird nicht als Rohfeld angezeigt |
| Rechnungstypcode (BT-3) | Document type | Nur „Rechnung" (Code 380) und „Gutschrift" (Code 381) werden erkannt – siehe „Bekannte Grenzen" |
Seit Version 2.35 (September 2026) liefert das Mapping für DueDate auch bei Belegen mit mehreren Zahlungsbedingungen (SpecifiedTradePaymentTerms, z. B. reguläre Fälligkeit zusammen mit einer Skonto-Bedingung) ein einzelnes gültiges Datum. In früheren Versionen wurde stattdessen der technisch zusammengeführte Rohwert aus der „intermediate"-XML übernommen (z. B. „2020-01-17;2020-01-10"). Belege, die vor dem Update verarbeitet wurden, tragen diesen Wert weiterhin im Feld DueDate.
Stufe 2 – Verfügbar, pro Kreditor ohne Entwicklungsaufwand aktivierbar
Alles Folgende ist in den von Squeeze intern verarbeiteten Daten bereits vorhanden. Bitten Sie Ihren Squeeze-Berater, eines dieser Felder für einen bestimmten Lieferanten zu aktivieren („Feldtraining") – dies ist ein Konfigurationsschritt, keine individuelle Entwicklung.
Referenzen & Vermerke auf Rechnungsebene
Geschäftsprozesstyp · Spezifikations-/Profilkennung · Käuferreferenz (z. B. Leitweg-ID bei Rechnungen an die öffentliche Verwaltung) · Projektreferenz · Vertragsreferenz · Auftragsreferenz des Verkäufers · Referenz auf Wareneingangsbestätigung · Referenz auf Versandanzeige · Ausschreibungs-/Losreferenz · Kennung des in Rechnung gestellten Objekts (z. B. Zählernummer, Kfz-Kennzeichen) · Buchungsreferenz des Käufers · Zahlungsbedingungen als Text (inkl. Skontobedingungen) · Rechnungsvermerke · Referenz auf eine vorausgegangene Rechnung (bei Korrekturen/Gutschriften) · Steuerentstehungsdatum
Angaben zum Verkäufer
Handelsname (falls abweichend vom rechtlichen Namen) · Handelsregisternummer o. ä. · Steuerliche Kennung ohne USt-IdNr. · Zusätzliche rechtliche Angaben · Elektronische Adresse · Vollständige Anschrift (Adresszeilen 1–3, Ort, Postleitzahl, Region) · Ansprechpartner, Telefon, E-Mail · Steuervertreter und dessen Anschrift (für Verkäufer außerhalb der EU)
Angaben zum Käufer
Handelsname · Handelsregisternummer o. ä. · USt-IdNr. · Elektronische Adresse · Vollständige Anschrift · Ansprechpartner, Telefon, E-Mail
Weitere Parteien
Zahlungsempfänger (wenn abweichend vom Verkäufer) · Lieferpartei und -anschrift · Rechnungszeitraum (Beginn/Ende)
Zahlungsangaben
Zahlungsart (Überweisung, Lastschrift, Karte usw.) und deren Textbeschreibung · Verwendungszweck als Text · Zahlungskartendetails · Mandatsreferenz und Gläubiger-ID bei Lastschrift
Nachlässe & Abgaben auf Dokumentenebene (gelten für die gesamte Rechnung – werden aktuell nicht extrahiert, obwohl sie den Gesamtbetrag beeinflussen)
Betrag, Grundbetrag, Prozentsatz, Grund und USt-Kategorie – jeweils für Nachlässe und Abgaben
Gesamtbeträge (über den aktuell extrahierten Gesamtbetrag hinaus)
USt-Betrag in Abrechnungswährung · Steuerentstehungsdatum · Summe aller Positions-Nettobeträge · Summe der Nachlässe/Abgaben auf Dokumentenebene · Gesamtbetrag ohne USt · Bereits gezahlter Betrag · Rundungsbetrag · Noch ausstehender Betrag
USt-Aufschlüsselung
Text/Code für die Steuerbefreiung (bei steuerfreien Leistungen) · Eine 4. oder weitere Steuerkategorie, sofern vorhanden (siehe „Bekannte Grenzen")
Rechnungsbegründende Unterlagen
Referenz, Beschreibung, URL sowie eingebettete Anhänge, auf die die Rechnung verweist (z. B. Stundenzettel, Lieferscheine)
Rechnungspositionen (über die standardmäßig extrahierten 5 Felder hinaus)
Positionsvermerk · Objektkennung auf Positionsebene · Auftrags-/Buchungsreferenzen auf Positionsebene · Rechnungszeitraum auf Positionsebene · Nachlässe/Abgaben auf Positionsebene (Betrag, Grundbetrag, %, Grund) · Vollständige Preisdetails (Bruttopreis, Preisnachlässe, Basismenge) · USt-Kategoriecode des Artikels (der Steuersatz wird extrahiert, der Kategoriecode nicht) · Vollständige Artikelbeschreibung (über den Kurznamen hinaus) · Artikelkennungen von Verkäufer/Käufer/Standard · Klassifizierungscode des Artikels · Ursprungsland · Freie Artikelattribute (z. B. Farbe, Größe)
Stufe 3 – Heute überhaupt nicht verfügbar (Extended-Profil-Daten)
Falls Ihre Rechnungen das ZUGFeRD-/Factur-X-Profil EXTENDED verwenden, beachten Sie: Die Nutzung des Extended-Profils verschafft Squeeze keinen Zugriff auf mehr Daten, als eine Rechnung im Standardprofil (EN16931/„Comfort") liefern würde. Squeezes Transformationsschritt versteht ausschließlich den EN16931-Kernstandard – alles, was Extended darüber hinaus ergänzt, wird verworfen, bevor eine Extraktion überhaupt möglich ist, unabhängig vom Feldtraining.
| Kategorie | Was nicht erfasst wird | Beispiel |
|---|---|---|
| Positionshierarchien | Gruppierung von Positionen in Über-/Zwischensummengruppen | Ein Angebot mit Zwischensummen je Gewerk |
| Zusätzliche Parteirollen | Alles über Verkäufer/Käufer/Zahlungsempfänger hinaus | Lieferadresse, Warenausgangspartei, Rechnungssteller/-empfänger, Vertriebsagent |
| Logistik-Servicegebühren | Ein eigener Gebührentyp nur für Logistikkosten | Fracht-/Bearbeitungsgebühr getrennt von sonstigen Abgaben erfasst |
| USt-Befreiung auf Positionsebene | Befreiungsgrund je einzelner Position statt nur dokumentweit | |
| Produktdetails | Seriennummern, Chargen-IDs, Marke/Modell, Hersteller | Seriennummer einer Maschine auf der Rechnungsposition |
| Strukturierte Skontobedingungen | Nachlass-/Verzugsbedingungen als berechnete Beträge und Termine (nicht nur Freitext) | „2 % Skonto innerhalb von 10 Tagen" als strukturiertes Feld statt als Text |
| Fremdwährungsumrechnung | Für die Rechnung verwendeter Wechselkurs | |
| Versand-/Transportdetails | Transportbewegung, Lieferbedingungscodes | |
| Zusätzliche Dokumentreferenzen | Angebotsreferenz, Referenz des Rechnungsausstellers und weitere |
Bekannte Grenzen (keine Fehler – aber wichtig für die Erwartungshaltung)
- Die USt-Aufschlüsselung ist auf 3 Steuerkategorien begrenzt. Bei einer Rechnung mit einer 4. abweichenden USt-Kategorie (selten, aber möglich) wird diese 4. Kategorie stillschweigend nicht extrahiert – auch wenn das Feldtraining für die anderen 3 aktiviert ist. Dies ist eine echte technische Grenze, die sich nicht allein durch Training beheben lässt.
- Die Belegart-Erkennung deckt im Auslieferungszustand „Rechnung" (Code 380) und „Gutschrift" (Code 381) ab. Weitere UNTDID-1001-Codes – etwa Korrekturrechnungen (384), Rechnungen im Gutschriftverfahren oder Teilrechnungen – werden standardmäßig nicht unterschieden. Seit Squeeze v2.16 lassen sie sich über die Konfigurationstabelle
einvoice_value_mappingumschlüsseln; das ist ein unterstützter Einrichtungsschritt, keine individuelle Entwicklung. Siehe Umschlüsselung von Codes eines elektronischen Beleges. - Rechnungen im Minimum- und BasicWL-Profil enthalten strukturell keine Rechnungspositionen – das liegt an den Profilen selbst (BasicWL steht wörtlich für „ohne Positionen"), nicht an einer Einschränkung von Squeeze. Minimum-Rechnungen enthalten zudem keine USt-Aufschlüsselung.
- Eine fehlende USt-IdNr. bei einer Kleinunternehmer-Rechnung ist zu erwarten, kein Datenqualitätsproblem – diese Unternehmen sind rechtmäßig davon befreit.
Kopfdaten (131 Felder)
| BT | Feld | XPath | Kard. | Status | Squeeze-Feld |
|---|---|---|---|---|---|
| BT-1 | Invoice_number |
/xr:invoice[1]/xr:Invoice_number[1] |
1..1 | Standard | DocumentReference |
| BT-2 | Invoice_issue_date |
/xr:invoice[1]/xr:Invoice_issue_date[1] |
1..1 | Standard | DocumentDate |
| BT-3 | Invoice_type_code |
/xr:invoice[1]/xr:Invoice_type_code[1] |
1..1 | Standard | DocumentType (automatisch, ohne Training) |
| BT-5 | Invoice_currency_code |
/xr:invoice[1]/xr:Invoice_currency_code[1] |
1..1 | Standard | Currency |
| BT-6 | VAT_accounting_currency_code |
/xr:invoice[1]/xr:VAT_accounting_currency_code[1] |
0..1 | trainierbar | — |
| BT-7 | Value_added_tax_point_date |
/xr:invoice[1]/xr:Value_added_tax_point_date[1] |
0..1 | trainierbar | — |
| BT-8 | Value_added_tax_point_date_code |
/xr:invoice[1]/xr:Value_added_tax_point_date_code[1] |
0..1 | trainierbar | — |
| BT-9 | Payment_due_date |
/xr:invoice[1]/xr:Payment_due_date[1] |
0..1 | Standard | DueDate |
| BT-10 | Buyer_reference |
/xr:invoice[1]/xr:Buyer_reference[1] |
0..1 | trainierbar | — |
| BT-11 | Project_reference |
/xr:invoice[1]/xr:Project_reference[1] |
0..1 | trainierbar | — |
| BT-12 | Contract_reference |
/xr:invoice[1]/xr:Contract_reference[1] |
0..1 | trainierbar | — |
| BT-13 | Purchase_order_reference |
/xr:invoice[1]/xr:Purchase_order_reference[1] |
0..1 | Standard | OrderNumber |
| BT-14 | Sales_order_reference |
/xr:invoice[1]/xr:Sales_order_reference[1] |
0..1 | trainierbar | — |
| BT-15 | Receiving_advice_reference |
/xr:invoice[1]/xr:Receiving_advice_reference[1] |
0..1 | trainierbar | — |
| BT-16 | Despatch_advice_reference |
/xr:invoice[1]/xr:Despatch_advice_reference[1] |
0..1 | trainierbar | — |
| BT-17 | Tender_or_lot_reference |
/xr:invoice[1]/xr:Tender_or_lot_reference[1] |
0..1 | trainierbar | — |
| BT-18 | Invoiced_object_identifier |
/xr:invoice[1]/xr:Invoiced_object_identifier[1] |
0..1 | trainierbar | — |
| BT-19 | Buyer_accounting_reference |
/xr:invoice[1]/xr:Buyer_accounting_reference[1] |
0..1 | trainierbar | — |
| BT-20 | Payment_terms |
/xr:invoice[1]/xr:Payment_terms[1] |
0..1 | trainierbar | — |
| BT-21 | Invoice_note_subject_code |
/xr:invoice[1]/xr:INVOICE_NOTE[1]/xr:Invoice_note_subject_code[1] |
0..1 | trainierbar | — |
| BT-22 | Invoice_note |
/xr:invoice[1]/xr:INVOICE_NOTE[1]/xr:Invoice_note[1] |
1..1 | trainierbar | — |
| BT-23 | Business_process_type_identifier |
/xr:invoice[1]/xr:PROCESS_CONTROL[1]/xr:Business_process_type_identifier[1] |
1..1 | trainierbar | — |
| BT-24 | Specification_identifier |
/xr:invoice[1]/xr:PROCESS_CONTROL[1]/xr:Specification_identifier[1] |
1..1 | trainierbar | — |
| BT-25 | Preceding_Invoice_reference |
/xr:invoice[1]/xr:PRECEDING_INVOICE_REFERENCE[1]/xr:Preceding_Invoice_reference[1] |
1..1 | trainierbar | — |
| BT-26 | Preceding_Invoice_issue_date |
/xr:invoice[1]/xr:PRECEDING_INVOICE_REFERENCE[1]/xr:Preceding_Invoice_issue_date[1] |
0..1 | trainierbar | — |
| BT-27 | Seller_name |
/xr:invoice[1]/xr:SELLER[1]/xr:Seller_name[1] |
1..1 | Standard | CreditorName |
| BT-28 | Seller_trading_name |
/xr:invoice[1]/xr:SELLER[1]/xr:Seller_trading_name[1] |
0..1 | Standard | CreditorName (Fallback) |
| BT-29 | Seller_identifier |
/xr:invoice[1]/xr:SELLER[1]/xr:Seller_identifier[1] |
0..n | trainierbar | — |
| BT-30 | Seller_legal_registration_identifier |
/xr:invoice[1]/xr:SELLER[1]/xr:Seller_legal_registration_identifier[1] |
0..1 | trainierbar | — |
| BT-31 | Seller_VAT_identifier |
/xr:invoice[1]/xr:SELLER[1]/xr:Seller_VAT_identifier[1] |
0..1 | Standard | VatId |
| BT-32 | Seller_tax_registration_identifier |
/xr:invoice[1]/xr:SELLER[1]/xr:Seller_tax_registration_identifier[1] |
0..1 | trainierbar | — |
| BT-33 | Seller_additional_legal_information |
/xr:invoice[1]/xr:SELLER[1]/xr:Seller_additional_legal_information[1] |
0..1 | trainierbar | — |
| BT-34 | Seller_electronic_address |
/xr:invoice[1]/xr:SELLER[1]/xr:Seller_electronic_address[1] |
1..1 | trainierbar | — |
| BT-35 | Seller_address_line_1 |
/xr:invoice[1]/xr:SELLER[1]/xr:SELLER_POSTAL_ADDRESS[1]/xr:Seller_address_line_1[1] |
0..1 | trainierbar | — |
| BT-36 | Seller_address_line_2 |
/xr:invoice[1]/xr:SELLER[1]/xr:SELLER_POSTAL_ADDRESS[1]/xr:Seller_address_line_2[1] |
0..1 | trainierbar | — |
| BT-162 | Seller_address_line_3 |
/xr:invoice[1]/xr:SELLER[1]/xr:SELLER_POSTAL_ADDRESS[1]/xr:Seller_address_line_3[1] |
0..1 | trainierbar | — |
| BT-37 | Seller_city |
/xr:invoice[1]/xr:SELLER[1]/xr:SELLER_POSTAL_ADDRESS[1]/xr:Seller_city[1] |
0..1 | trainierbar | — |
| BT-38 | Seller_post_code |
/xr:invoice[1]/xr:SELLER[1]/xr:SELLER_POSTAL_ADDRESS[1]/xr:Seller_post_code[1] |
0..1 | trainierbar | — |
| BT-39 | Seller_country_subdivision |
/xr:invoice[1]/xr:SELLER[1]/xr:SELLER_POSTAL_ADDRESS[1]/xr:Seller_country_subdivision[1] |
0..1 | trainierbar | — |
| BT-40 | Seller_country_code |
/xr:invoice[1]/xr:SELLER[1]/xr:SELLER_POSTAL_ADDRESS[1]/xr:Seller_country_code[1] |
1..1 | Standard | CreditorCountry |
| BT-41 | Seller_contact_point |
/xr:invoice[1]/xr:SELLER[1]/xr:SELLER_CONTACT[1]/xr:Seller_contact_point[1] |
0..1 | Standard | CreditorName (Fallback) |
| BT-42 | Seller_contact_telephone_number |
/xr:invoice[1]/xr:SELLER[1]/xr:SELLER_CONTACT[1]/xr:Seller_contact_telephone_number[1] |
0..1 | Standard | Kreditoren-Zuordnung (automatisch) |
| BT-43 | Seller_contact_email_address |
/xr:invoice[1]/xr:SELLER[1]/xr:SELLER_CONTACT[1]/xr:Seller_contact_email_address[1] |
0..1 | Standard | Kreditoren-Zuordnung (automatisch) |
| BT-44 | Buyer_name |
/xr:invoice[1]/xr:BUYER[1]/xr:Buyer_name[1] |
1..1 | Standard | Mandantenzuordnung (automatisch) |
| BT-45 | Buyer_trading_name |
/xr:invoice[1]/xr:BUYER[1]/xr:Buyer_trading_name[1] |
0..1 | trainierbar | — |
| BT-46 | Buyer_identifier |
/xr:invoice[1]/xr:BUYER[1]/xr:Buyer_identifier[1] |
0..1 | Standard | Mandantenzuordnung (automatisch) |
| BT-47 | Buyer_legal_registration_identifier |
/xr:invoice[1]/xr:BUYER[1]/xr:Buyer_legal_registration_identifier[1] |
0..1 | trainierbar | — |
| BT-48 | Buyer_VAT_identifier |
/xr:invoice[1]/xr:BUYER[1]/xr:Buyer_VAT_identifier[1] |
0..1 | trainierbar | — |
| BT-49 | Buyer_electronic_address |
/xr:invoice[1]/xr:BUYER[1]/xr:Buyer_electronic_address[1] |
1..1 | trainierbar | — |
| BT-50 | Buyer_address_line_1 |
/xr:invoice[1]/xr:BUYER[1]/xr:BUYER_POSTAL_ADDRESS[1]/xr:Buyer_address_line_1[1] |
0..1 | trainierbar | — |
| BT-51 | Buyer_address_line_2 |
/xr:invoice[1]/xr:BUYER[1]/xr:BUYER_POSTAL_ADDRESS[1]/xr:Buyer_address_line_2[1] |
0..1 | trainierbar | — |
| BT-163 | Buyer_address_line_3 |
/xr:invoice[1]/xr:BUYER[1]/xr:BUYER_POSTAL_ADDRESS[1]/xr:Buyer_address_line_3[1] |
0..1 | trainierbar | — |
| BT-52 | Buyer_city |
/xr:invoice[1]/xr:BUYER[1]/xr:BUYER_POSTAL_ADDRESS[1]/xr:Buyer_city[1] |
0..1 | trainierbar | — |
| BT-53 | Buyer_post_code |
/xr:invoice[1]/xr:BUYER[1]/xr:BUYER_POSTAL_ADDRESS[1]/xr:Buyer_post_code[1] |
0..1 | trainierbar | — |
| BT-54 | Buyer_country_subdivision |
/xr:invoice[1]/xr:BUYER[1]/xr:BUYER_POSTAL_ADDRESS[1]/xr:Buyer_country_subdivision[1] |
0..1 | trainierbar | — |
| BT-55 | Buyer_country_code |
/xr:invoice[1]/xr:BUYER[1]/xr:BUYER_POSTAL_ADDRESS[1]/xr:Buyer_country_code[1] |
1..1 | trainierbar | — |
| BT-56 | Buyer_contact_point |
/xr:invoice[1]/xr:BUYER[1]/xr:BUYER_CONTACT[1]/xr:Buyer_contact_point[1] |
0..1 | trainierbar | — |
| BT-57 | Buyer_contact_telephone_number |
/xr:invoice[1]/xr:BUYER[1]/xr:BUYER_CONTACT[1]/xr:Buyer_contact_telephone_number[1] |
0..1 | trainierbar | — |
| BT-58 | Buyer_contact_email_address |
/xr:invoice[1]/xr:BUYER[1]/xr:BUYER_CONTACT[1]/xr:Buyer_contact_email_address[1] |
0..1 | trainierbar | — |
| BT-59 | Payee_name |
/xr:invoice[1]/xr:PAYEE[1]/xr:Payee_name[1] |
1..1 | trainierbar | — |
| BT-60 | Payee_identifier |
/xr:invoice[1]/xr:PAYEE[1]/xr:Payee_identifier[1] |
0..1 | trainierbar | — |
| BT-61 | Payee_legal_registration_identifier |
/xr:invoice[1]/xr:PAYEE[1]/xr:Payee_legal_registration_identifier[1] |
0..1 | trainierbar | — |
| BT-62 | Seller_tax_representative_name |
/xr:invoice[1]/xr:SELLER_TAX_REPRESENTATIVE_PARTY[1]/xr:Seller_tax_representative_name[1] |
1..1 | trainierbar | — |
| BT-63 | Seller_tax_representative_VAT_identifier |
/xr:invoice[1]/xr:SELLER_TAX_REPRESENTATIVE_PARTY[1]/xr:Seller_tax_representative_VAT_identifier[1] |
1..1 | trainierbar | — |
| BT-64 | Tax_representative_address_line_1 |
/xr:invoice[1]/xr:SELLER_TAX_REPRESENTATIVE_PARTY[1]/xr:SELLER_TAX_REPRESENTATIVE_POSTAL_ADDRESS[1]/xr:Tax_representative_address_line_1[1] |
0..1 | trainierbar | — |
| BT-65 | Tax_representative_address_line_2 |
/xr:invoice[1]/xr:SELLER_TAX_REPRESENTATIVE_PARTY[1]/xr:SELLER_TAX_REPRESENTATIVE_POSTAL_ADDRESS[1]/xr:Tax_representative_address_line_2[1] |
0..1 | trainierbar | — |
| BT-164 | Tax_representative_address_line_3 |
/xr:invoice[1]/xr:SELLER_TAX_REPRESENTATIVE_PARTY[1]/xr:SELLER_TAX_REPRESENTATIVE_POSTAL_ADDRESS[1]/xr:Tax_representative_address_line_3[1] |
0..1 | trainierbar | — |
| BT-66 | Tax_representative_city |
/xr:invoice[1]/xr:SELLER_TAX_REPRESENTATIVE_PARTY[1]/xr:SELLER_TAX_REPRESENTATIVE_POSTAL_ADDRESS[1]/xr:Tax_representative_city[1] |
0..1 | trainierbar | — |
| BT-67 | Tax_representative_post_code |
/xr:invoice[1]/xr:SELLER_TAX_REPRESENTATIVE_PARTY[1]/xr:SELLER_TAX_REPRESENTATIVE_POSTAL_ADDRESS[1]/xr:Tax_representative_post_code[1] |
0..1 | trainierbar | — |
| BT-68 | Tax_representative_country_subdivision |
/xr:invoice[1]/xr:SELLER_TAX_REPRESENTATIVE_PARTY[1]/xr:SELLER_TAX_REPRESENTATIVE_POSTAL_ADDRESS[1]/xr:Tax_representative_country_subdivision[1] |
0..1 | trainierbar | — |
| BT-69 | Tax_representative_country_code |
/xr:invoice[1]/xr:SELLER_TAX_REPRESENTATIVE_PARTY[1]/xr:SELLER_TAX_REPRESENTATIVE_POSTAL_ADDRESS[1]/xr:Tax_representative_country_code[1] |
1..1 | trainierbar | — |
| BT-70 | Deliver_to_party_name |
/xr:invoice[1]/xr:DELIVERY_INFORMATION[1]/xr:Deliver_to_party_name[1] |
0..1 | trainierbar | — |
| BT-71 | Deliver_to_location_identifier |
/xr:invoice[1]/xr:DELIVERY_INFORMATION[1]/xr:Deliver_to_location_identifier[1] |
0..1 | trainierbar | — |
| BT-72 | Actual_delivery_date |
/xr:invoice[1]/xr:DELIVERY_INFORMATION[1]/xr:Actual_delivery_date[1] |
0..1 | Standard | ServiceDate |
| BT-75 | Deliver_to_address_line_1 |
/xr:invoice[1]/xr:DELIVERY_INFORMATION[1]/xr:DELIVER_TO_ADDRESS[1]/xr:Deliver_to_address_line_1[1] |
0..1 | trainierbar | — |
| BT-76 | Deliver_to_address_line_2 |
/xr:invoice[1]/xr:DELIVERY_INFORMATION[1]/xr:DELIVER_TO_ADDRESS[1]/xr:Deliver_to_address_line_2[1] |
0..1 | trainierbar | — |
| BT-165 | Deliver_to_address_line_3 |
/xr:invoice[1]/xr:DELIVERY_INFORMATION[1]/xr:DELIVER_TO_ADDRESS[1]/xr:Deliver_to_address_line_3[1] |
0..1 | trainierbar | — |
| BT-77 | Deliver_to_city |
/xr:invoice[1]/xr:DELIVERY_INFORMATION[1]/xr:DELIVER_TO_ADDRESS[1]/xr:Deliver_to_city[1] |
0..1 | trainierbar | — |
| BT-78 | Deliver_to_post_code |
/xr:invoice[1]/xr:DELIVERY_INFORMATION[1]/xr:DELIVER_TO_ADDRESS[1]/xr:Deliver_to_post_code[1] |
0..1 | trainierbar | — |
| BT-79 | Deliver_to_country_subdivision |
/xr:invoice[1]/xr:DELIVERY_INFORMATION[1]/xr:DELIVER_TO_ADDRESS[1]/xr:Deliver_to_country_subdivision[1] |
0..1 | trainierbar | — |
| BT-80 | Deliver_to_country_code |
/xr:invoice[1]/xr:DELIVERY_INFORMATION[1]/xr:DELIVER_TO_ADDRESS[1]/xr:Deliver_to_country_code[1] |
1..1 | trainierbar | — |
| BT-73 | Invoicing_period_start_date |
/xr:invoice[1]/xr:INVOICING_PERIOD[1]/xr:Invoicing_period_start_date[1] |
0..1 | trainierbar | — |
| BT-74 | Invoicing_period_end_date |
/xr:invoice[1]/xr:INVOICING_PERIOD[1]/xr:Invoicing_period_end_date[1] |
0..1 | trainierbar | — |
| BT-81 | Payment_means_type_code |
/xr:invoice[1]/xr:PAYMENT_INSTRUCTIONS[1]/xr:Payment_means_type_code[1] |
1..1 | trainierbar | — |
| BT-82 | Payment_means_text |
/xr:invoice[1]/xr:PAYMENT_INSTRUCTIONS[1]/xr:Payment_means_text[1] |
0..1 | trainierbar | — |
| BT-83 | Remittance_information |
/xr:invoice[1]/xr:PAYMENT_INSTRUCTIONS[1]/xr:Remittance_information[1] |
0..1 | trainierbar | — |
| BT-84 | Payment_account_identifier |
/xr:invoice[1]/xr:PAYMENT_INSTRUCTIONS[1]/xr:CREDIT_TRANSFER[1]/xr:Payment_account_identifier[1] |
1..1 | Standard | IBAN |
| BT-85 | Payment_account_name |
/xr:invoice[1]/xr:PAYMENT_INSTRUCTIONS[1]/xr:CREDIT_TRANSFER[1]/xr:Payment_account_name[1] |
0..1 | trainierbar | — |
| BT-86 | Payment_service_provider_identifier |
/xr:invoice[1]/xr:PAYMENT_INSTRUCTIONS[1]/xr:CREDIT_TRANSFER[1]/xr:Payment_service_provider_identifier[1] |
0..1 | trainierbar | — |
| BT-87 | Payment_card_primary_account_number |
/xr:invoice[1]/xr:PAYMENT_INSTRUCTIONS[1]/xr:PAYMENT_CARD_INFORMATION[1]/xr:Payment_card_primary_account_number[1] |
1..1 | trainierbar | — |
| BT-88 | Payment_card_holder_name |
/xr:invoice[1]/xr:PAYMENT_INSTRUCTIONS[1]/xr:PAYMENT_CARD_INFORMATION[1]/xr:Payment_card_holder_name[1] |
0..1 | trainierbar | — |
| BT-89 | Mandate_reference_identifier |
/xr:invoice[1]/xr:PAYMENT_INSTRUCTIONS[1]/xr:DIRECT_DEBIT[1]/xr:Mandate_reference_identifier[1] |
0..1 | trainierbar | — |
| BT-90 | Bank_assigned_creditor_identifier |
/xr:invoice[1]/xr:PAYMENT_INSTRUCTIONS[1]/xr:DIRECT_DEBIT[1]/xr:Bank_assigned_creditor_identifier[1] |
0..1 | trainierbar | — |
| BT-91 | Debited_account_identifier |
/xr:invoice[1]/xr:PAYMENT_INSTRUCTIONS[1]/xr:DIRECT_DEBIT[1]/xr:Debited_account_identifier[1] |
0..1 | Standard | IBAN (Fallback) |
| BT-92 | Document_level_allowance_amount |
/xr:invoice[1]/xr:DOCUMENT_LEVEL_ALLOWANCES[1]/xr:Document_level_allowance_amount[1] |
1..1 | trainierbar | — |
| BT-93 | Document_level_allowance_base_amount |
/xr:invoice[1]/xr:DOCUMENT_LEVEL_ALLOWANCES[1]/xr:Document_level_allowance_base_amount[1] |
0..1 | trainierbar | — |
| BT-94 | Document_level_allowance_percentage |
/xr:invoice[1]/xr:DOCUMENT_LEVEL_ALLOWANCES[1]/xr:Document_level_allowance_percentage[1] |
0..1 | trainierbar | — |
| BT-95 | Document_level_allowance_VAT_category_code |
/xr:invoice[1]/xr:DOCUMENT_LEVEL_ALLOWANCES[1]/xr:Document_level_allowance_VAT_category_code[1] |
1..1 | trainierbar | — |
| BT-96 | Document_level_allowance_VAT_rate |
/xr:invoice[1]/xr:DOCUMENT_LEVEL_ALLOWANCES[1]/xr:Document_level_allowance_VAT_rate[1] |
0..1 | trainierbar | — |
| BT-97 | Document_level_allowance_reason |
/xr:invoice[1]/xr:DOCUMENT_LEVEL_ALLOWANCES[1]/xr:Document_level_allowance_reason[1] |
0..1 | trainierbar | — |
| BT-98 | Document_level_allowance_reason_code |
/xr:invoice[1]/xr:DOCUMENT_LEVEL_ALLOWANCES[1]/xr:Document_level_allowance_reason_code[1] |
0..1 | trainierbar | — |
| BT-99 | Document_level_charge_amount |
/xr:invoice[1]/xr:DOCUMENT_LEVEL_CHARGES[1]/xr:Document_level_charge_amount[1] |
1..1 | trainierbar | — |
| BT-100 | Document_level_charge_base_amount |
/xr:invoice[1]/xr:DOCUMENT_LEVEL_CHARGES[1]/xr:Document_level_charge_base_amount[1] |
0..1 | trainierbar | — |
| BT-101 | Document_level_charge_percentage |
/xr:invoice[1]/xr:DOCUMENT_LEVEL_CHARGES[1]/xr:Document_level_charge_percentage[1] |
0..1 | trainierbar | — |
| BT-102 | Document_level_charge_VAT_category_code |
/xr:invoice[1]/xr:DOCUMENT_LEVEL_CHARGES[1]/xr:Document_level_charge_VAT_category_code[1] |
1..1 | trainierbar | — |
| BT-103 | Document_level_charge_VAT_rate |
/xr:invoice[1]/xr:DOCUMENT_LEVEL_CHARGES[1]/xr:Document_level_charge_VAT_rate[1] |
0..1 | trainierbar | — |
| BT-104 | Document_level_charge_reason |
/xr:invoice[1]/xr:DOCUMENT_LEVEL_CHARGES[1]/xr:Document_level_charge_reason[1] |
0..1 | trainierbar | — |
| BT-105 | Document_level_charge_reason_code |
/xr:invoice[1]/xr:DOCUMENT_LEVEL_CHARGES[1]/xr:Document_level_charge_reason_code[1] |
0..1 | trainierbar | — |
| BT-106 | Sum_of_Invoice_line_net_amount |
/xr:invoice[1]/xr:DOCUMENT_TOTALS[1]/xr:Sum_of_Invoice_line_net_amount[1] |
1..1 | trainierbar | — |
| BT-107 | Sum_of_allowances_on_document_level |
/xr:invoice[1]/xr:DOCUMENT_TOTALS[1]/xr:Sum_of_allowances_on_document_level[1] |
0..1 | trainierbar | — |
| BT-108 | Sum_of_charges_on_document_level |
/xr:invoice[1]/xr:DOCUMENT_TOTALS[1]/xr:Sum_of_charges_on_document_level[1] |
0..1 | trainierbar | — |
| BT-109 | Invoice_total_amount_without_VAT |
/xr:invoice[1]/xr:DOCUMENT_TOTALS[1]/xr:Invoice_total_amount_without_VAT[1] |
1..1 | trainierbar | — |
| BT-110 | Invoice_total_VAT_amount |
/xr:invoice[1]/xr:DOCUMENT_TOTALS[1]/xr:Invoice_total_VAT_amount[1] |
0..1 | trainierbar | — |
| BT-111 | Invoice_total_VAT_amount_in_accounting_currency |
/xr:invoice[1]/xr:DOCUMENT_TOTALS[1]/xr:Invoice_total_VAT_amount_in_accounting_currency[1] |
0..1 | trainierbar | — |
| BT-112 | Invoice_total_amount_with_VAT |
/xr:invoice[1]/xr:DOCUMENT_TOTALS[1]/xr:Invoice_total_amount_with_VAT[1] |
1..1 | Standard | TotalAmount |
| BT-113 | Paid_amount |
/xr:invoice[1]/xr:DOCUMENT_TOTALS[1]/xr:Paid_amount[1] |
0..1 | trainierbar | — |
| BT-114 | Rounding_amount |
/xr:invoice[1]/xr:DOCUMENT_TOTALS[1]/xr:Rounding_amount[1] |
0..1 | trainierbar | — |
| BT-115 | Amount_due_for_payment |
/xr:invoice[1]/xr:DOCUMENT_TOTALS[1]/xr:Amount_due_for_payment[1] |
1..1 | Standard | TotalAmount (Fallback) |
| BT-116 | VAT_category_taxable_amount |
/xr:invoice[1]/xr:VAT_BREAKDOWN[1]/xr:VAT_category_taxable_amount[1] |
1..1 | Standard | NetAmount / NetAmount2 / NetAmount3 |
| BT-117 | VAT_category_tax_amount |
/xr:invoice[1]/xr:VAT_BREAKDOWN[1]/xr:VAT_category_tax_amount[1] |
1..1 | Standard | TaxAmount / TaxAmount2 / TaxAmount3 |
| BT-118 | VAT_category_code |
/xr:invoice[1]/xr:VAT_BREAKDOWN[1]/xr:VAT_category_code[1] |
1..1 | trainierbar | — |
| BT-119 | VAT_category_rate |
/xr:invoice[1]/xr:VAT_BREAKDOWN[1]/xr:VAT_category_rate[1] |
0..1 | Standard | TaxRate / TaxRate2 / TaxRate3 |
| BT-120 | VAT_exemption_reason_text |
/xr:invoice[1]/xr:VAT_BREAKDOWN[1]/xr:VAT_exemption_reason_text[1] |
0..1 | trainierbar | — |
| BT-121 | VAT_exemption_reason_code |
/xr:invoice[1]/xr:VAT_BREAKDOWN[1]/xr:VAT_exemption_reason_code[1] |
0..1 | trainierbar | — |
| BT-122 | Supporting_document_reference |
/xr:invoice[1]/xr:ADDITIONAL_SUPPORTING_DOCUMENTS[1]/xr:Supporting_document_reference[1] |
1..1 | trainierbar | — |
| BT-123 | Supporting_document_description |
/xr:invoice[1]/xr:ADDITIONAL_SUPPORTING_DOCUMENTS[1]/xr:Supporting_document_description[1] |
0..1 | trainierbar | — |
| BT-124 | External_document_location |
/xr:invoice[1]/xr:ADDITIONAL_SUPPORTING_DOCUMENTS[1]/xr:External_document_location[1] |
0..1 | trainierbar | — |
| BT-125 | Attached_document |
/xr:invoice[1]/xr:ADDITIONAL_SUPPORTING_DOCUMENTS[1]/xr:Attached_document[1] |
0..1 | trainierbar | — |
| BT-DEX-001 | Third_party_payment_type |
/xr:invoice[1]/xr:THIRD_PARTY_PAYMENT[1]/xr:Third_party_payment_type[1] |
1..1 | trainierbar | — |
| BT-DEX-002 | Third_party_payment_amount |
/xr:invoice[1]/xr:THIRD_PARTY_PAYMENT[1]/xr:Third_party_payment_amount[1] |
1..1 | trainierbar | — |
| BT-DEX-003 | Third_party_payment_description |
/xr:invoice[1]/xr:THIRD_PARTY_PAYMENT[1]/xr:Third_party_payment_description[1] |
1..1 | trainierbar | — |
Positionen (46 Felder)
| BT | Feld | XPath | Kard. | Status | Squeeze-Feld |
|---|---|---|---|---|---|
| BT-126 | Invoice_line_identifier |
xr:Invoice_line_identifier[1]/text() |
1..1 | trainierbar | — |
| BT-127 | Invoice_line_note |
xr:Invoice_line_note[1]/text() |
0..1 | trainierbar | — |
| BT-128 | Invoice_line_object_identifier |
xr:Invoice_line_object_identifier[1]/text() |
0..1 | trainierbar | — |
| BT-129 | Invoiced_quantity |
xr:Invoiced_quantity[1]/text() |
0..1 | Standard | PosQuantity |
| BT-130 | Invoiced_quantity_unit_of_measure_code |
xr:Invoiced_quantity_unit_of_measure_code[1]/text() |
0..1 | trainierbar | — |
| BT-131 | Invoice_line_net_amount |
xr:Invoice_line_net_amount[1]/text() |
1..1 | Standard | PosTotalAmount |
| BT-132.1 | Referenced_purchase_order_reference |
xr:Referenced_purchase_order_reference[1]/text() |
0..1 | trainierbar | — |
| BT-132 | Referenced_purchase_order_line_reference |
xr:Referenced_purchase_order_line_reference[1]/text() |
0..1 | trainierbar | — |
| BT-133 | Invoice_line_Buyer_accounting_reference |
xr:Invoice_line_Buyer_accounting_reference[1]/text() |
0..1 | trainierbar | — |
| BT-134 | Invoice_line_period_start_date |
xr:INVOICE_LINE_PERIOD[1]/xr:Invoice_line_period_start_date[1]/text() |
0..1 | trainierbar | — |
| BT-135 | Invoice_line_period_end_date |
xr:INVOICE_LINE_PERIOD[1]/xr:Invoice_line_period_end_date[1]/text() |
0..1 | trainierbar | — |
| BT-136 | Invoice_line_allowance_amount |
xr:INVOICE_LINE_ALLOWANCES[1]/xr:Invoice_line_allowance_amount[1]/text() |
1..1 | trainierbar | — |
| BT-137 | Invoice_line_allowance_base_amount |
xr:INVOICE_LINE_ALLOWANCES[1]/xr:Invoice_line_allowance_base_amount[1]/text() |
0..1 | trainierbar | — |
| BT-138 | Invoice_line_allowance_percentage |
xr:INVOICE_LINE_ALLOWANCES[1]/xr:Invoice_line_allowance_percentage[1]/text() |
0..1 | trainierbar | — |
| BT-139 | Invoice_line_allowance_reason |
xr:INVOICE_LINE_ALLOWANCES[1]/xr:Invoice_line_allowance_reason[1]/text() |
0..1 | trainierbar | — |
| BT-140 | Invoice_line_allowance_reason_code |
xr:INVOICE_LINE_ALLOWANCES[1]/xr:Invoice_line_allowance_reason_code[1]/text() |
0..1 | trainierbar | — |
| BT-141 | Invoice_line_charge_amount |
xr:INVOICE_LINE_CHARGES[1]/xr:Invoice_line_charge_amount[1]/text() |
1..1 | trainierbar | — |
| BT-142 | Invoice_line_charge_base_amount |
xr:INVOICE_LINE_CHARGES[1]/xr:Invoice_line_charge_base_amount[1]/text() |
0..1 | trainierbar | — |
| BT-143 | Invoice_line_charge_percentage |
xr:INVOICE_LINE_CHARGES[1]/xr:Invoice_line_charge_percentage[1]/text() |
0..1 | trainierbar | — |
| BT-144 | Invoice_line_charge_reason |
xr:INVOICE_LINE_CHARGES[1]/xr:Invoice_line_charge_reason[1]/text() |
0..1 | trainierbar | — |
| BT-145 | Invoice_line_charge_reason_code |
xr:INVOICE_LINE_CHARGES[1]/xr:Invoice_line_charge_reason_code[1]/text() |
0..1 | trainierbar | — |
| BT-146 | Item_net_price |
xr:PRICE_DETAILS[1]/xr:Item_net_price[1]/text() |
1..1 | Standard | PosSinglePrice |
| BT-147 | Item_price_discount |
xr:PRICE_DETAILS[1]/xr:PRICE_DETAILS_ALLOWANCES[1]/xr:Item_price_discount[1]/text() |
1..1 | trainierbar | — |
| BT-DEX-147-base-amount | Item_price_discount_base_amount |
xr:PRICE_DETAILS[1]/xr:PRICE_DETAILS_ALLOWANCES[1]/xr:Item_price_discount_base_amount[1]/text() |
0..1 | trainierbar | — |
| BT-DEX-147-percentage | Item_price_discount_percentage |
xr:PRICE_DETAILS[1]/xr:PRICE_DETAILS_ALLOWANCES[1]/xr:Item_price_discount_percentage[1]/text() |
0..1 | trainierbar | — |
| BT-DEX-147-reason | Item_price_discount_reason |
xr:PRICE_DETAILS[1]/xr:PRICE_DETAILS_ALLOWANCES[1]/xr:Item_price_discount_reason[1]/text() |
0..1 | trainierbar | — |
| BT-DEX-147-reason-code | Item_price_discount_reason_code |
xr:PRICE_DETAILS[1]/xr:PRICE_DETAILS_ALLOWANCES[1]/xr:Item_price_discount_reason_code[1]/text() |
0..1 | trainierbar | — |
| BT-DEX-147-charge-amount | Item_price_charge |
xr:PRICE_DETAILS[1]/xr:PRICE_DETAILS_CHARGES[1]/xr:Item_price_charge[1]/text() |
1..1 | trainierbar | — |
| BT-DEX-147-charge-base-amount | Item_price_charge_base_amount |
xr:PRICE_DETAILS[1]/xr:PRICE_DETAILS_CHARGES[1]/xr:Item_price_charge_base_amount[1]/text() |
0..1 | trainierbar | — |
| BT-DEX-147-charge-percentage | Item_price_charge_percentage |
xr:PRICE_DETAILS[1]/xr:PRICE_DETAILS_CHARGES[1]/xr:Item_price_charge_percentage[1]/text() |
0..1 | trainierbar | — |
| BT-DEX-147-charge-reason | Item_price_charge_reason |
xr:PRICE_DETAILS[1]/xr:PRICE_DETAILS_CHARGES[1]/xr:Item_price_charge_reason[1]/text() |
0..1 | trainierbar | — |
| BT-DEX-147-charge-reason-code | Item_price_charge_reason_code |
xr:PRICE_DETAILS[1]/xr:PRICE_DETAILS_CHARGES[1]/xr:Item_price_charge_reason_code[1]/text() |
0..1 | trainierbar | — |
| BT-148 | Item_gross_price |
xr:PRICE_DETAILS[1]/xr:Item_gross_price[1]/text() |
0..1 | trainierbar | — |
| BT-149 | Item_price_base_quantity |
xr:PRICE_DETAILS[1]/xr:Item_price_base_quantity[1]/text() |
0..1 | trainierbar | — |
| BT-150 | Item_price_base_quantity_unit_of_measure |
xr:PRICE_DETAILS[1]/xr:Item_price_base_quantity_unit_of_measure[1]/text() |
0..1 | trainierbar | — |
| BT-151 | Invoiced_item_VAT_category_code |
xr:LINE_VAT_INFORMATION[1]/xr:Invoiced_item_VAT_category_code[1]/text() |
1..1 | trainierbar | — |
| BT-152 | Invoiced_item_VAT_rate |
xr:LINE_VAT_INFORMATION[1]/xr:Invoiced_item_VAT_rate[1]/text() |
0..1 | Standard | PosTaxRate |
| BT-153 | Item_name |
xr:ITEM_INFORMATION[1]/xr:Item_name[1]/text() |
1..1 | Standard | PosDescription |
| BT-154 | Item_description |
xr:ITEM_INFORMATION[1]/xr:Item_description[1]/text() |
0..1 | trainierbar | — |
| BT-155 | Item_Sellers_identifier |
xr:ITEM_INFORMATION[1]/xr:Item_Sellers_identifier[1]/text() |
0..1 | trainierbar | — |
| BT-156 | Item_Buyers_identifier |
xr:ITEM_INFORMATION[1]/xr:Item_Buyers_identifier[1]/text() |
0..1 | trainierbar | — |
| BT-157 | Item_standard_identifier |
xr:ITEM_INFORMATION[1]/xr:Item_standard_identifier[1]/text() |
0..1 | trainierbar | — |
| BT-158 | Item_classification_identifier |
xr:ITEM_INFORMATION[1]/xr:Item_classification_identifier[1]/text() |
0..n | trainierbar | — |
| BT-159 | Item_country_of_origin |
xr:ITEM_INFORMATION[1]/xr:Item_country_of_origin[1]/text() |
0..1 | trainierbar | — |
| BT-160 | Item_attribute_name |
xr:ITEM_INFORMATION[1]/xr:ITEM_ATTRIBUTES[1]/xr:Item_attribute_name[1]/text() |
1..1 | trainierbar | — |
| BT-161 | Item_attribute_value |
xr:ITEM_INFORMATION[1]/xr:ITEM_ATTRIBUTES[1]/xr:Item_attribute_value[1]/text() |
1..1 | trainierbar | — |
Untergeordnete Rechnungspositionen (SUB_INVOICE_LINE) sind in dieser Tabelle nicht aufgeführt. Sie haben denselben Aufbau wie eine Rechnungsposition und lassen sich beliebig tief verschachteln, weshalb sie nicht als feste Feldliste darstellbar sind. Die Positionstabelle in Squeeze (LineItems) ist flach und kann eine solche Hierarchie nicht abbilden. Untergeordnete Positionen entstehen ausschließlich bei XRechnungen in UBL-Syntax. ZUGFeRD-/Factur-X-Belege (CII-Syntax) enthalten sie nicht.
Um ein erfolgreiches Mapping von Spalten zu gewährleisten muss die Tabelle in der die Spalten angelegt werden den technischen Namen "LineItems" besitzen.
Doppelte Felder werden als Alternativen dem Feldwert angehängt
Sollte der Standard nicht ausreichen, so lesen sie hier wie sie die Auswertung erweitern können
Sichtbeleg - Feldzuordnung der PDF-Darstellung
Diese Tabelle zeigt, aus welchen Feldern der internen intermediate.xml die einzelnen Abschnitte und Beschriftungen des Sichtbelegs (xrechnung.pdf) befüllt werden.
Die Gliederung folgt den Reitern der Sichtbeleg-Ansicht:
- Übersicht
- Details
- Zusätze
- Laufzettel
- Anlagen.
Alle Beschriftungen sind die vom Produkt tatsächlich ausgegebenen Texte in Deutsch und Englisch, keine nachträglichen Übersetzungen. Die Spalte „BT" nennt den zugehörigen Geschäftsterm (Business Term) nach EN 16931.
Tab: Übersicht (Overview)
Käufer / Buyer (BG-7)
| BT | Intermediate field | Label (DE) | Label (EN) |
|---|---|---|---|
| BT-10 | Buyer_reference |
Leitweg-ID | Buyer reference |
| BT-44 | Buyer_name |
Name | Name |
| BT-50 | Buyer_address_line_1 |
Adresszeile 1 | Address line 1 |
| BT-51 | Buyer_address_line_2 |
Adresszeile 2 | Address line 2 |
| BT-163 | Buyer_address_line_3 |
Adresszeile 3 | Address line 3 |
| BT-53 | Buyer_post_code |
PLZ | ZIP |
| BT-52 | Buyer_city |
Ort | Location |
| BT-55 | Buyer_country_code |
Ländercode | Country code |
| BT-46 | Buyer_identifier (+ scheme) |
Kennung / Schema der Kennung | Identifier / Scheme identifier |
| BT-56 | Buyer_contact_point |
Name | Contact point |
| BT-57 | Buyer_contact_telephone_number |
Telefon | Contact point phone |
| BT-58 | Buyer_contact_email_address |
E-Mail-Adresse | Contact point email |
Verkäufer / Seller, summary (BG-4)
| BT | Intermediate field | Label (DE) | Label (EN) |
|---|---|---|---|
| BT-27 | Seller_name |
Firmenname | Company name |
| BT-35 | Seller_address_line_1 |
Adresszeile 1 | Address line 1 |
| BT-36 | Seller_address_line_2 |
Adresszeile 2 | Address line 2 |
| BT-162 | Seller_address_line_3 |
Adresszeile 3 | Address line 3 |
| BT-38 | Seller_post_code |
PLZ | ZIP |
| BT-37 | Seller_city |
Ort | Location |
| BT-39 | Seller_country_subdivision |
Bundesland | State |
| BT-40 | Seller_country_code |
Ländercode | Country code |
| BT-29 | Seller_identifier (+ scheme) |
Kennung / Schema der Kennung | Identifier / Scheme identifier |
| BT-41 | Seller_contact_point |
Name | Contact point |
| BT-42 | Seller_contact_telephone_number |
Telefon | Contact point phone |
| BT-43 | Seller_contact_email_address |
E-Mail-Adresse | Contact point email |
Rechnungsdaten / Invoice data
| BT | Intermediate field | Label (DE) | Label (EN) |
|---|---|---|---|
| BT-1 | Invoice_number |
Rechnungsnummer | Invoice number |
| BT-2 | Invoice_issue_date |
Rechnungsdatum | Invoice date |
| BT-3 | Invoice_type_code |
Rechnungsart | Invoice type |
| BT-5 | Invoice_currency_code |
Währung | Currency |
| BT-11 | Project_reference |
Projektnummer | Project reference |
| BT-12 | Contract_reference |
Vertragsnummer | Contract reference |
| BT-13 | Purchase_order_reference |
Bestellnummer | Purchase order reference |
| BT-14 | Sales_order_reference |
Auftragsnummer | Sales order reference |
| BT-17 | Tender_or_lot_reference |
Vergabenummer | Award reference |
| BT-15 | Receiving_advice_reference |
Kennung der Empfangsbestätigung | Receiving advice reference |
| BT-16 | Despatch_advice_reference |
Kennung der Versandanzeige | Despatch advice reference |
| BT-23 | Business_process_type_identifier |
Prozesskennung | Process identifier |
| BT-24 | Specification_identifier |
Spezifikationskennung | Specification identifier |
| BT-18 | Invoiced_object_identifier (+ scheme) |
Objektkennung / Schema der Objektkennung | Object identifier / Object identifier scheme |
Abrechnungszeitraum / Billing period (whole invoice)
| BT | Intermediate field | Label (DE) | Label (EN) |
|---|---|---|---|
| BT-73 | Invoicing_period_start_date |
Von | From |
| BT-74 | Invoicing_period_end_date |
Bis | To |
Vorausgegangene Rechnungen / Previous invoices (BG-3)
| BT | Intermediate field | Label (DE) | Label (EN) |
|---|---|---|---|
| BT-25 | Preceding_Invoice_reference |
Rechnungsnummer | Invoice number |
| BT-26 | Preceding_Invoice_issue_date |
Rechnungsdatum | Invoice date |
Gesamtbeträge der Rechnung / Invoice totals (BG-22)
| BT | Intermediate field | Label (DE) | Label (EN) |
|---|---|---|---|
| BT-106 | Sum_of_Invoice_line_net_amount |
Summe aller Positionen | Total invoice line net amount |
| BT-107 | Sum_of_allowances_on_document_level |
Summe Nachlässe | Total allowances |
| BT-108 | Sum_of_charges_on_document_level |
Summe Zuschläge | Total charges |
| BT-109 | Invoice_total_amount_without_VAT |
Gesamtsumme | Total amount |
| BT-110 | Invoice_total_VAT_amount |
Summe Umsatzsteuer | Total VAT |
| BT-111 | Invoice_total_VAT_amount_in_accounting_currency |
Summe Umsatzsteuer in Abrechnungswährung | Total VAT in accounting currency |
| BT-112 | Invoice_total_amount_with_VAT |
Gesamtsumme | Total |
| BT-113 | Paid_amount |
Gezahlter Betrag | Already paid |
| BT-114 | Rounding_amount |
Rundungsbetrag | Rounding amount |
| BT-115 | Amount_due_for_payment |
Fälliger Betrag | Amount due |
Aufschlüsselung der Umsatzsteuer / VAT breakdown (BG-23)
| BT | Intermediate field | Label (DE) | Label (EN) |
|---|---|---|---|
| BT-118 | VAT_category_code |
Umsatzsteuerkategorie | VAT category |
| BT-116 | VAT_category_taxable_amount |
Gesamtsumme | Total |
| BT-119 | VAT_category_rate |
Umsatzsteuersatz | VAT rate |
| BT-117 | VAT_category_tax_amount |
Umsatzsteuerbetrag | VAT amount |
| BT-120 | VAT_exemption_reason_text |
Befreiungsgrund | Exemption reason |
| BT-121 | VAT_exemption_reason_code |
Kennung für den Befreiungsgrund | Exemption reason code |
Nachlass / Zuschlag auf Ebene der Rechnung — Document-level allowance/charge (BG-20/BG-21)
| BT | Intermediate field | Label (DE) | Label (EN) |
|---|---|---|---|
| BT-92 | Document_level_allowance_amount |
Nachlass | Amount |
| BT-93 | Document_level_allowance_base_amount |
Grundbetrag | Base amount |
| BT-94 | Document_level_allowance_percentage |
Prozentsatz | Percentage |
| BT-95 | Document_level_allowance_VAT_category_code |
Umsatzsteuerkategorie des Nachlasses | Allowance VAT category code |
| BT-96 | Document_level_allowance_VAT_rate |
Umsatzsteuersatz des Nachlasses | Allowance VAT rate |
| BT-97 | Document_level_allowance_reason |
Grund für den Nachlass | Allowance reason |
| BT-98 | Document_level_allowance_reason_code |
Kennung für den Nachlassgrund | Allowance reason code |
| BT-99 | Document_level_charge_amount |
Zuschlag | Amount |
| BT-100 | Document_level_charge_base_amount |
Grundbetrag | Base amount |
| BT-101 | Document_level_charge_percentage |
Prozentsatz | Percentage |
| BT-102 | Document_level_charge_VAT_category_code |
Umsatzsteuerkategorie des Zuschlages | Charge VAT category code |
| BT-103 | Document_level_charge_VAT_rate |
Umsatzsteuersatz des Zuschlages | VAT rate |
| BT-104 | Document_level_charge_reason |
Grund für den Zuschlag | Charge Reason |
| BT-105 | Document_level_charge_reason_code |
Kennung für den Zuschlagsgrund | Charge reason code |
Zahlungsdaten / Payment data
| BT | Intermediate field | Label (DE) | Label (EN) |
|---|---|---|---|
| BT-20 | Payment_terms |
Skonto; weitere Zahlungsbedingungen | Payment terms |
| BT-9 | Payment_due_date |
Fälligkeitsdatum | Due date |
| BT-81 | Payment_means_type_code |
Code für das Zahlungsmittel | Payment means type code |
| BT-82 | Payment_means_text |
Zahlungsmittel | Payment means |
| BT-83 | Remittance_information |
Verwendungszweck | Remittance information |
Überweisung / Credit transfer (BG-17)
| BT | Intermediate field | Label (DE) | Label (EN) |
|---|---|---|---|
| BT-85 | Payment_account_name |
Kontoinhaber | Account holder |
| BT-84 | Payment_account_identifier |
IBAN | Account identifier |
| BT-86 | Payment_service_provider_identifier |
BIC | BIC |
Karteninformation / Card information (BG-18)
| BT | Intermediate field | Label (DE) | Label (EN) |
|---|---|---|---|
| BT-87 | Payment_card_primary_account_number |
Kartennummer | Card number |
| BT-88 | Payment_card_holder_name |
Karteninhaber | Card holder |
Lastschrift / Direct debit (BG-19)
| BT | Intermediate field | Label (DE) | Label (EN) |
|---|---|---|---|
| BT-89 | Mandate_reference_identifier |
Mandatsreferenznr. | Mandate reference no. |
| BT-91 | Debited_account_identifier |
IBAN | Debited account identifier |
| BT-90 | Bank_assigned_creditor_identifier |
Gläubiger-ID | Creditor ID |
Bemerkungen zur Rechnung / Invoice notes (BG-1)
| BT | Intermediate field | Label (DE) | Label (EN) |
|---|---|---|---|
| BT-21 | Invoice_note_subject_code |
Betreff | Subject code |
| BT-22 | Invoice_note |
Bemerkung | Note |
Fremdforderung / Third-party payment (BG-DEX-09, non-standard Dexpro extension)
| BT | Intermediate field | Label (DE) | Label (EN) |
|---|---|---|---|
| BT-DEX-001 | Third_party_payment_type |
Art der Fremdforderung | Third party payment type |
| BT-DEX-002 | Third_party_payment_amount |
Betrag der Fremdforderung | Third party payment amount |
| BT-DEX-003 | Third_party_payment_description |
Beschreibung der Fremdforderung | Third party payment description |
| — | sum-of-third-party-payment-amounts (computed) |
Summe Fremdforderungen | Third party payment total |
Tab: Details (Details)
Position / Position
| BT | Intermediate field | Label (DE) | Label (EN) |
|---|---|---|---|
| BT-126 | Invoice_line_identifier |
Position | Identifier |
| BT-127 | Invoice_line_note |
Freitext | Free text |
| BT-128 | Invoice_line_object_identifier (+ scheme) |
Objektkennung / Schema der Objektkennung | Object identifier / Object identifier scheme |
| BT-132.1 | Referenced_purchase_order_reference |
Nummer des Auftrags | Order item number |
| BT-132 | Referenced_purchase_order_line_reference |
Nummer der Auftragsposition | Order number |
| BT-133 | Invoice_line_Buyer_accounting_reference |
Kontierungshinweis | Buyer accounting reference |
| BT-129 | Invoiced_quantity |
Menge | Quantity |
| BT-130 | Invoiced_quantity_unit_of_measure_code |
Einheit | Unit |
| BT-131 | Invoice_line_net_amount |
Gesamtpreis (netto) | Total price (net) |
Abrechnungszeitraum / Billing period, line (BG-26)
| BT | Intermediate field | Label (DE) | Label (EN) |
|---|---|---|---|
| BT-134 | Invoice_line_period_start_date |
Von | From |
| BT-135 | Invoice_line_period_end_date |
Bis | To |
Preiseinzelheiten / Price details (BG-29)
| BT | Intermediate field | Label (DE) | Label (EN) |
|---|---|---|---|
| BT-146 | Item_net_price |
Preis pro Einheit (netto) | Price per unit (net) |
| BT-147 | Item_price_discount |
Rabatt (netto) | Discount (net) |
| BT-DEX-147-charge | Item_price_charge (Dexpro-Erweiterung) |
Zuschlag (netto) | Surcharge (net) |
| BT-148 | Item_gross_price |
Listenpreis (netto) | List price (net) |
| BT-149 | Item_price_base_quantity |
Basismenge zum Artikelpreis | Item price base quantity |
| BT-150 | Item_price_base_quantity_unit_of_measure |
Code der Maßeinheit | Unit code |
Nachlässe / Zuschläge auf Ebene der Rechnungsposition — line allowances/charges (BG-27/BG-28)
| BT | Intermediate field | Label (DE) | Label (EN) |
|---|---|---|---|
| BT-136 | Invoice_line_allowance_amount |
Nachlass (netto) | Allowance (net) |
| BT-137 | Invoice_line_allowance_base_amount |
Grundbetrag (netto) | Base amount (net) |
| BT-138 | Invoice_line_allowance_percentage |
Prozentsatz | Percentage |
| BT-139 | Invoice_line_allowance_reason |
Grund des Nachlasses | Allowance reason |
| BT-140 | Invoice_line_allowance_reason_code |
Code für den Nachlassgrund | Allowance reason code |
| BT-141 | Invoice_line_charge_amount |
Zuschlag (netto) | Charge (net) |
| BT-142 | Invoice_line_charge_base_amount |
Grundbetrag (netto) | Base amount (net) |
| BT-143 | Invoice_line_charge_percentage |
Prozentsatz | Percentage |
| BT-144 | Invoice_line_charge_reason |
Grund des Zuschlags | Reason for the Charge |
| BT-145 | Invoice_line_charge_reason_code |
Code für den Zuschlagsgrund | Charge reason code |
Artikelinformationen / Item information (BG-31)
| BT | Intermediate field | Label (DE) | Label (EN) |
|---|---|---|---|
| BT-151 | Invoiced_item_VAT_category_code |
Umsatzsteuer | VAT category |
| BT-152 | Invoiced_item_VAT_rate |
Umsatzsteuersatz | VAT rate |
| BT-153 | Item_name |
Bezeichnung | Name |
| BT-154 | Item_description |
Beschreibung | Description |
| BT-155 | Item_Sellers_identifier |
Artikelnummer | Item identifier |
| BT-156 | Item_Buyers_identifier |
Artikelkennung des Käufers | Buyer's item identifier |
| BT-157 | Item_standard_identifier (+ scheme) |
Artikelkennung / Schema der Artikelkennung | Item standard identifier / scheme |
| BT-158 | Item_classification_identifier (+ scheme, + scheme_version) |
Code der Artikelklassifizierung / Kennung + Version zur Bildung des Schemas | Item classification code / scheme / schema version |
| BT-159 | Item_country_of_origin |
Code des Herkunftslandes | Country of origin |
Eigenschaften des Artikels / Item attributes (BG-32)
| BT | Intermediate field | Label (DE) | Label (EN) |
|---|---|---|---|
| BT-160/161 | Item_attribute_name / Item_attribute_value |
(kein fester Label-Text — der Attributname selbst wird als Label ausgegeben) | (same) |
Tab: Zusätze (Supplements — extended detail)
Informationen zum Verkäufer / Seller, extended (BG-4)
| BT | Intermediate field | Label (DE) | Label (EN) |
|---|---|---|---|
| BT-28 | Seller_trading_name |
Abweichender Handelsname | Different trading name |
| BT-34 | Seller_electronic_address (+ scheme) |
Elektronische Adresse / Schema | Electronic address / scheme |
| BT-30 | Seller_legal_registration_identifier (+ scheme) |
Register-/Registriernummer / Schema | Legal registration identifier / scheme |
| BT-31 | Seller_VAT_identifier |
Umsatzsteuer-ID | VAT ID |
| BT-32 | Seller_tax_registration_identifier |
Steuernummer | Tax number |
| BT-33 | Seller_additional_legal_information |
Weitere rechtliche Informationen | Further legal information |
| BT-6 | VAT_accounting_currency_code |
Code der Umsatzsteuerwährung | VAT accounting currency |
Steuervertreter des Verkäufers / Seller's tax representative (BG-11/BG-12)
| BT | Intermediate field | Label (DE) | Label (EN) |
|---|---|---|---|
| BT-62 | Seller_tax_representative_name |
Name | Name |
| BT-64 | Tax_representative_address_line_1 |
Adresszeile 1 | Address line 1 |
| BT-65 | Tax_representative_address_line_2 |
Adresszeile 2 | Address line 2 |
| BT-164 | Tax_representative_address_line_3 |
Adresszeile 3 | Address line 3 |
| BT-67 | Tax_representative_post_code |
PLZ | ZIP |
| BT-66 | Tax_representative_city |
Ort | Location |
| BT-68 | Tax_representative_country_subdivision |
Bundesland | State |
| BT-69 | Tax_representative_country_code |
Ländercode | Country code |
| BT-63 | Seller_tax_representative_VAT_identifier |
Umsatzsteuer-ID | VAT ID |
Informationen zum Käufer / Buyer, extended (BG-7)
| BT | Intermediate field | Label (DE) | Label (EN) |
|---|---|---|---|
| BT-45 | Buyer_trading_name |
Abweichender Handelsname | Different trading name |
| BT-54 | Buyer_country_subdivision |
Bundesland | State |
| BT-49 | Buyer_electronic_address (+ scheme) |
Elektronische Adresse / Schema | Electronic address / scheme |
| BT-47 | Buyer_legal_registration_identifier (+ scheme) |
Register-/Registriernummer / Schema | Legal registration identifier / scheme |
| BT-48 | Buyer_VAT_identifier |
Umsatzsteuer-ID | VAT ID |
| BT-7 | Value_added_tax_point_date |
Abrechnungsdatum der Umsatzsteuer | Value added tax point date |
| BT-8 | Value_added_tax_point_date_code |
Code des Umsatzsteuer-Abrechnungsdatums | Value added tax point date code |
| BT-19 | Buyer_accounting_reference |
Kontierungsinformation | Buyer accounting reference |
Lieferinformationen / Delivery information (BG-13/BG-15)
| BT | Intermediate field | Label (DE) | Label (EN) |
|---|---|---|---|
| BT-71 | Deliver_to_location_identifier (+ scheme) |
Kennung des Lieferorts / Schema | Delivery location identifier / scheme |
| BT-72 | Actual_delivery_date |
Lieferdatum | Delivery date |
| BT-70 | Deliver_to_party_name |
Name des Empfängers | Name of the recipient |
| BT-75 | Deliver_to_address_line_1 |
Adresszeile 1 | Address line 1 |
| BT-76 | Deliver_to_address_line_2 |
Adresszeile 2 | Address line 2 |
| BT-165 | Deliver_to_address_line_3 |
Adresszeile 3 | Address line 3 |
| BT-78 | Deliver_to_post_code |
PLZ | ZIP |
| BT-77 | Deliver_to_city |
Ort | Location |
| BT-79 | Deliver_to_country_subdivision |
Bundesland | State |
| BT-80 | Deliver_to_country_code |
Ländercode | Country code |
Informationen zum Vertrag / Contract information
Dieser Abschnitt existiert in der Oberfläche, enthält aber keine eigenen BT-Felder über die Vertragsreferenz (BT-12, siehe „Rechnungsdaten") hinaus.
Vom Verkäufer abweichender Zahlungsempfänger / Payee different from seller (BG-10)
| BT | Intermediate field | Label (DE) | Label (EN) |
|---|---|---|---|
| BT-59 | Payee_name |
Name | Name |
| BT-60 | Payee_identifier (+ scheme) |
Kennung / Schema | Identifier / scheme |
| BT-61 | Payee_legal_registration_identifier (+ scheme) |
Register-/Registriernummer / Schema | Legal registration identifier / scheme |
Tab: Laufzettel (Routing slip / processing history)
Stammt nicht aus der Rechnungs-XML. Es handelt sich um Squeeze-eigene Bezeichnungen aus der Dokumentenverarbeitung, die den Bearbeitungsverlauf des Belegs abbilden.
| Key | Label (DE) | Label (EN) |
|---|---|---|
xrv:zeitstempel |
Datum/Uhrzeit | Date / time |
xrv:betreff |
Betreff | Subject |
xrv:text |
Text | Text |
xrv:details |
Details | Details |
Tab: Anlagen (Attachments)
Rechnungsbegründende Unterlagen / Supporting documents (BG-24)
| BT | Intermediate field | Label (DE) | Label (EN) |
|---|---|---|---|
| BT-122 | Supporting_document_reference |
Kennung | Identifier |
| BT-123 | Supporting_document_description |
Beschreibung | Description |
| BT-124 | External_document_location |
Verweis (z.B. Internetadresse) | Location (e.g. Internet address) |
| BT-125 | Attached_document (+ mime_code, + filename) |
Anhangsdokument / Format / Name | Attached document / MIME type / filename |
Was diese Tabelle nicht abdeckt
- Felder des Extended-Profils (BT-X-/BG-X-) erreichen den Sichtbeleg nicht. Sie werden bereits bei der Überführung in die
intermediate.xmlverworfen und stehen deshalb weder der Darstellung noch der Extraktion zur Verfügung. - Eigenschaften des Artikels (BT-160/161) haben keine feste Beschriftung: der Attributname aus der Rechnung wird selbst als Label ausgegeben.
- Die genaue Anordnung innerhalb eines Abschnitts (Spaltenreihenfolge, Seitenumbrüche) ist nicht Gegenstand dieser Tabelle. Dokumentiert ist, welches Feld in welchem Abschnitt erscheint, nicht das Layout.
Konfiguration XML-Auswertung
Ab Version 2.13 verfügbar und nach Freischaltung durch Partner oder Dexpro !
Standardmäßig liefert Squeeze eine Vielzahl von vordefinierten Mappings zur Extraktion von Kopfdaten aus Rechnungen. Um die bestmögliche Datenerfassung zu gewährleisten, können Sie diese Mappings individuell anpassen und erweitern. Diese Seite bietet eine Anleitung zur Konfiguration von Kopfdaten/Positionsdaten-Mappings im XML-Format.
In der Administration finden Sie einen neuen Unterpunkt (ZUGFeRD und XRechnung):
2. Sobald Sie den Menüpunkt gewählt haben, kommen Sie in eine tabellarische Übersicht. Auf dieser sollten Sie bereits einige Einträge sehen, die sie nicht bearbeiten können, denn dabei handelt es sich um die Standard-Auswertungen; beschrieben in: XRechnung und ZUGFeRD Auswertungstabellen:
Priorisierung der Mappings
Die Reihenfolge der Mappings spielt eine wichtige Rolle bei der Auswertung der Kopffelder. Squeeze verwendet ein hierarchisches System, um zu bestimmen, welches Mapping für ein bestimmtes Feld verwendet werden soll.
Hierarchie:
- Spezifische Mappings: Mappings, die für einen bestimmten Mandanten, Kreditor und eine Dokumentenklasse definiert sind, haben die höchste Priorität.
- Mandanten- und Kreditor-spezifische Mappings: Sind keine spezifischen Mappings vorhanden, werden Mappings verwendet, die für einen Mandanten und Kreditor definiert sind, unabhängig von der Dokumentenklasse.
- Allgemeine Mappings: Danach folgen Mappings, die nur für die Dokumentenklasse definiert sind, unabhängig von Mandant und Kreditor.
- Standard Mappings: Mappings, die für alle Mandanten, Kreditoren und Dokumentenklassen gelten (Auslieferungszustand), haben die niedrigste Priorität.
Siehe:
|
Prio |
Mandant |
Kreditor |
Dokumentenklasse |
System-Konfiguration |
|
1 |
definiert |
definiert |
definiert |
false vor true |
|
2 |
definiert |
definiert |
* |
false vor true |
|
3 |
* |
definiert |
definiert |
false vor true |
|
4 |
* |
definiert |
* |
false vor true |
|
5 |
definiert |
* |
definiert |
false vor true |
|
6 |
* |
* |
definiert |
false vor true |
|
7 |
definiert |
* |
* |
false vor true |
|
8 |
* |
* |
* |
false vor true |
Anlage neuer Mappings für Kopffelder
Im Tab Kopffelder können Sie neue Mappings anlegen. Dabei wählen Sie die Filterkriterien wie gewünscht.
Beachten Sie dabei, solange keine Dokumentenklasse gewählt wurde, werden ihnen unter Feldname alle Felder aller verfügbaren Dokumentenklassen aufgelistet.
Anlage neuer Mappings für Positionsfelder
Im Tab Positionen können Sie neue Mappings anlegen, dabei wählen Sie die Filterkriterien wie gewünscht.
Beachten Sie dabei, solange keine Dokumentenklasse gewählt wurde werden ihnen unter Spaltenname alle Spalten der verfügbaren ("LineItems-Tabellen") Dokumentenklassen angezeigt.
Wichtig: Es werden nur Spalten aus Dokumentenklassen angezeigt, deren technischer Tabellenname "LineItems" ist.
Bei der der Ermittlung der Spalten werden die konfigurierten Xpath-Ausdrücke mit folgendem Tabellenknotenpunkt ausgewertet: /xr:invoice/xr:INVOICE_LINE.
Das hat zur folge, dass sie nur Kindelemente des Tabellenknotenpunktes /xr:invoice/xr:INVOICE_LINE zur Auswertung der Spalten verwenden dürfen.
Beispiel:
Tabellenknotenpunkt-Xpath: /xr:invoice/xr:INVOICE_LINE
Spalten-Xpath-Ausdruck: xr:PRICE_DETAILS[1]/xr:Item_net_price[1]/text()
Daher achten Sie darauf bei den Spalten-Xpath-Audrücken kein "/" am Anfang zu setzen.
XML-Konformitäts-Prüfung
Seit Version 2.15 bietet die Konfigurationsoberfläche eine integrierte Funktion zur Überprüfung von ZUGFeRD/XRechnung-Dokumenten. Hiermit kann die Konformität des XML-Dokuments mit den spezifischen Anforderungen der gewählten XRechnung-Version bewertet werden.
Sobald sie ein Dokument hochgeladen haben, erhalten Sie in einem das Ergebnis der Prüfung.
Sollte das Ergebnis, negativ ausfallen, wird das Dokument dennoch von Squeeze verarbeitet.
Eine PDF-Prüfbericht steht Ihnen ab Version 2.15 und nach Freischaltung unserer Berater oder Partner in der Validierung zur Verfügung, siehe hier.
Allgemeine Infos
Kontrollieren Sie ihren eingegeben XPath auf einer geeigneten Seite wie zum Beispiel:
http://xpather.com/
Die Auswertung der Xpaths erfolgt auf dem intermediate.xml . Die XML-Datei kann durch ein Download der Anhänge aus der technischen Warteschlange gewonnen werden.
XML Formate in Squeeze
Dieser Artikel beschreibt die allgemeine Verarbeitung von E-Rechnungen im XML-Format und welche EN16931-konformen XML-Dokumente Squeeze verarbeiten kann.
Die folgende Tabelle listet die aktuellsten Versionen der Formate auf, die Squeeze prüft, wenn ein XML-Dokument als eingebettete XML in einem PDF (z. B. ZUGFeRD) oder als einzelnes Dokument (z. B. XRechnung) vorliegt.
| Standard | Version |
| Factur-X | 1.0 bis 1.0.9 (Stand Squeeze Release 2.33) |
| ZUGFeRD | 1.0 bis 2.5 (Stand Squeeze Release 2.33) |
| XRechnung | 1.0 bis 3.0.2 (Stand Squeeze Release 2.33) |
In Zukunft wird Squeeze XML-Dokumente unabhängig von Formaten verarbeiten können
XML-Prüfbericht KoSIT
Diese Seite bietet eine umfassende Anleitung zur Konfiguration und Durchführung von KoSIT-Prüfberichten für XML-Daten.
Die Erstellung des XML-Prüfberichtes erfordert Internetzugriff und ist in abgekapselten Intranet-Strukturen vorerst nicht einsetzbar.
Konfiguration des externen Dienstes auf On Premises Systemen
In Cloud Systemen ist nur die Stapelklasseneigenschaft XMLValidationReport zu setzen. Siehe Stapelklasseneigenschaft XmlValidationReport
Vor SQUEEZE 2.21
Damit die Erzeugung des Prüfberichtes erfolgen kann muss ein neuer Dienst in der Server-/ Mandanten-Konfiguration konfiguriert werden. Der Dienst ist aktuellen Zeitpunkt(23.11.24) noch auf keinen festen Host bestimmt, daher erfragen Sie den aktuellen Host bei unseren Beratern
{
...,
"digivoice": {
"baseUrl": "https://{digivoice.example.host}/apis/digivoice/v1"
},
...,
}
Nachdem der Dienst in einer der Konfigurationsdateien konfiguriert ist, können Sie in Squeeze die Stapelklasseneigenschaft XmlValidationReport (ab Squeeze v2.15.0) aktivieren.
Ab SQUEEZE 2.21
Ab Squeeze 2.21 wird ein anderes, dediziertes Backend für die KoSIT Prüfung genutzt. Mit Diesem werden zwei Optionen angeboten: Lokal und Remote.
Bei der lokalen Prüfung wird ein lokales Java-Tool genutzt, um den Prüfbericht zu erzeugen. Da dieses Tool für jeden Aufruf gestartet werden muss, ist diese Variante langsam und benötigt pro Ausführung ca. 2 GB RAM auf dem Server.
Die remote Prüfung nutzt die von uns betriebene Online-Variante des Tools und ermöglicht eine wesentlich schnellere Prüfung ohne zusätzliche Ressourcen-Belastung des Squeeze-Servers.
Welche Variante genutzt wird, kann in der Mandantenkonfiguration hinterlegt werden:
{
...,
"kosit": {
"validationType": "remote", // Oder "local" für die lokale Prüfung
"remoteServiceUrl": "https://kosit-validator.squeeze.one"
},
...,
}
Es müssen ebenfalls Projekt-Zugangsdaten (OAuth Client Credentials) für das DEXPRO Portal hinterlegt und aktiviert sein (diese erfragen Sie ggf. bei ihrem zuständigen Berater), damit SQUEEZE sich bei dem Online-Service authentifizieren kann:
{
...,
"portal": {
"enabled": "True",
"host": "https://portal.dexpro.de"
"auth": {
"clientId": "<Ihre Tenant-ID>",
"secret": "<Ihr Client Secret>"
}
},
...,
}
Nachdem der Dienst in einer der Konfigurationsdateien konfiguriert ist, können Sie in Squeeze die Stapelklasseneigenschaft XmlValidationReport aktivieren.
KoSIT-Prüfbericht
Wird die Stapelklasseneigenschaft genutzt, so erstellt Squeeze den KoSIT-Prüfbericht zu Beginn des Verarbeitungsprozesses. Sollte es während der Belegerstellung zu Fehlern kommen, beeinflusst dies die restliche Verarbeitung des Beleges in der Regel nicht. Dadurch wird sichergestellt, dass auch bei Problemen eine umfassende Verarbeitung des Dokumentes zur Verfügung steht.
Den KoSIT Prüfbericht, können Sie sich in der Validierung des Dokumentes anzeigen lassen.
Mandanten- und Lieferanten- Erkennung
Einleitung
Sowohl bei elektronischen Rechnungen im XRechnung- oder ZUGFeRD-Format als auch bei der Verarbeitung beliebiger XML-Dokumente (generische XML-Verarbeitung) wird die Extraktion von Lieferanten- (Kreditoren) und Mandanten-Schlüsseln nach demselben grundlegenden Prinzip durchgeführt. Ziel ist es, die in den elektronischen Rechnungen enthaltenen Informationen zu Geschäftspartnern effizient und zuverlässig in unser internes System zu überführen, um eine weitere Verarbeitung zu ermöglichen.
Prozessbeschreibung
- Identifikation relevanter Daten: In den eingehenden XML-Dokumenten werden die für Geschäftspartner relevanten Daten (z.B. Name, Adresse, Steuernummer) identifiziert.
- Zuordnung zu einem Feldkatalog: Die identifizierten Daten werden anhand eines vordefinierten Feldkatalogs den entsprechenden Feldern in unserem internen System zugeordnet.
- Mapping auf interne Schlüssel: Die zugeordneten Daten werden anschließend unseren internen Schlüsseln für Geschäftspartner zugewiesen.
Detaillierte Betrachtung der Zuordnung für Mandanten und Kreditoren
Mandanten
- Suche in der companysearch: Zunächst wird der in der XML angegebene Mandantenname in unserer internen Firmensuche (companysearch) abgeglichen. Falls ein Treffer gefunden wird, wird der zugehörige interne Schlüssel verwendet.
- Suche nach der VAT-ID: Wenn keine Übereinstimmung in der Firmensuche gefunden wird, wird die in der XML angegebene Umsatzsteuer-Identifikationsnummer (VAT-ID) in unserer Tabelle "Companies" gesucht. Falls hier ein Eintrag existiert, wird der entsprechende interne Schlüssel verwendet.
- Kein Treffer: Wenn keine der beiden Bedingungen erfüllt ist, bleibt der Eintrag für den Mandanten leer.
Kreditoren
- Suche in der creditorsearch: Analog zur Mandantenidentifikation wird zunächst der in der XML angegebene Kreditorenname in unserer internen Kreditoren-Suche (creditorsearch) abgeglichen. Falls ein Treffer gefunden wird, wird der zugehörige interne Schlüssel verwendet.
- Suche nach der VAT-ID des Kreditors: Wenn keine Übereinstimmung in der Kreditoren-Suche gefunden wird, wird die in der XML angegebene Umsatzsteuer-Identifikationsnummer (VAT-ID) des Kreditors in unserer Tabelle "Creditors" gesucht. Falls hier ein Eintrag existiert, wird der entsprechende interne Schlüssel verwendet.
- Kein Treffer: Wenn keine der beiden Bedingungen erfüllt ist, bleibt der Eintrag für den Kreditoren leer.
Zusammenfassung der Mechanismen
| Geschäftspartner | Bedingung | Aktion |
|---|---|---|
| Mandant/Kreditor | Name gefunden in entsprechender Suche | Interner Schlüssel aus der Suche verwenden |
| Mandant/Kreditor | Name nicht gefunden, VAT-ID gefunden | Interner Schlüssel aus der entsprechenden Tabelle verwenden |
| Mandant/Kreditor | Keine Übereinstimmung | Eintrag bleibt leer |
Umschlüsselung von Codes eines elektronischen Beleges
Diese Seite erklärt das Verfahren, wie Codes eine elektronischen Beleges in andere Werte umgeschlüsselt werden können.
Das Beispiel orientiert sich auf den Vorgang des Beleges z. B. Rechnung oder Gutschrift. Es kann aber auf jeden anderen Wert angewendet werden.
Voraussetzung
Diese Umschlüsselung bezieht sich auf die elektronischen Formate ZUGFeRD und XRechung.
Damit ein Code aus der XML-Datei in einen neuen Wert umgeschlüsselt werden kann, muss zunächst sichergestellt werden, dass der Code aus der XML-Datei stammt. In diesem Beispiel wohlen wir die Standard Vorgänge
- Code 380 = Rechung
- Code 381 = Gutschrift
um weitere Vorgangsarten ergänzen.
Im Standard wird die Zuordnung der Codes 380 und 381 bereits durch die Invoice-Solution von Squeeze durchgeführt.
Um dieses Verhalten anzupassen muss zunächst eine neues Feld-Mapping hinzugefügt werden:
Dieses Mapping ermöglicht, dass beim Auslesen des Codes der XML Datei, eine Umschlüsselung durchgeführt werden kann, da sonst der Standard der Invoice Solution genutzt wird.
Bitte Groß-/ Kleinschreibung beachten:
Der XPath ist case-sensitiv. Das bedeutet das der XPath so geschrieben sein muss, wie er in der XML-Datei angegeben ist.
/xr:invoice/xr:Invoice_type_code
Umschlüsselung anderer Codes
Ab der Version 2.16 wurde eine neue Tabelle (einvoice_value_mapping) eingeführt, die genutzt werden kann, um individuell andere Werte statt der Codes zu nutzen und selbst festlegen zu können. Die Tabelle befindet sich unter dem Menüpunkt Stammdaten:
In dieser Tabelle lassen sich die Umschlüsselungen sehr genau konfigurieren. Ähnlich wie bei den Mappings lassen sie die Umschlüsselungen je Unternehmen, Lieferant, Dokumentenklasse und Feld konfigurieren. Hier ein Beispiel, wie die Standard-Codes 380 (Rechnung) und 381 (Gutschrift) um einen weiteren Eintrag 384 (Rechnungskorrektur) erweitern lassen:
Dieses Vorgehen lässt sich nicht nur auf Kopffelder anwenden, sondern auch auf Positionsangaben. So lässt sich mit dieser Möglichkeit auch gut die Umschlüsselung von Mengeneinheiten realisieren.
Hier ein weiteres Beispiel für Mengeneinheiten:
Die Listen lassen sich exportieren und auch wieder importieren, was die Übertragung von Test in Produktivsysteme oder andersherum sehr vereinfacht.