Zum Inhalt springen
Lekteo

Die UBL-Datei: wie sie aussieht und wie man sie liest

UBL ist ein Rechnungsformat aus reinem XML: keine Seite, keine Gestaltung, nichts, was sich von allein anzeigt. Hier steht, was in der Datei steckt und wie Sie eine lesbare Rechnung daraus machen.

Was eine UBL-Datei ist

UBL steht für Universal Business Language. Es ist ein von der Organisation OASIS veröffentlichter Standard für Geschäftsdokumente — Bestellungen, Lieferscheine, Rechnungen — in einer Form, die Programme ohne vorherige Absprache austauschen können. Für Rechnungen gilt UBL 2.1.

Eine UBL-Datei ist ein XML-Dokument: reiner Text, gegliedert durch verschachtelte Elemente. Sie beginnt mit <Invoice> für eine Rechnung oder mit <CreditNote> für eine Gutschrift. Das ist der einfachste Anhaltspunkt.

In Deutschland begegnet Ihnen UBL vor allem als XRechnung: XRechnung ist kein eigenes Format, sondern ein Profil, das UBL oder CII genauer festlegt. Beide erfüllen die europäische Norm EN 16931.

Warum sie keine Darstellung hat

Ein PDF beschreibt eine Seite: Schriften, Positionen, Linien. Eine UBL-Datei beschreibt nichts davon. Sie enthält kein Logo, keine Farbe, keinen Rahmen, keine Reihenfolge der Darstellung. Sie sagt nicht, wie die Rechnung aussehen soll, sondern welchen Wert jede Angabe hat.

Das ist Absicht, kein Versäumnis. Dieselbe Rechnung muss von jeder Buchhaltungssoftware automatisch übernommen werden können, in Deutschland wie überall in Europa. Ein Layout machte die Datei für Sie angenehmer und für die Maschine deutlich unbrauchbarer.

Konkret: Öffnen Sie eine UBL-Datei im Browser, sehen Sie einen aufklappbaren Elementbaum; in einem Texteditor eine lange Folge von Zeilen. In beiden Fällen ist die Information da — aber Sie müssen sie von Hand suchen.

Wie der Inhalt aussieht

Die Elementnamen folgen zwei Familien: cbc: für einfache Werte, cac: für Blöcke, die mehrere davon bündeln. Die Präfixe selbst sind frei wählbar — nur der Name dahinter zählt.

Beträge sind maschinengerecht geschrieben: Dezimalpunkt, kein Tausendertrennzeichen, Währung als Attribut. 1234.50 bedeutet also 1.234,50 €.

So lesen Sie eine UBL-Datei

  1. Legen Sie die .xml-Datei auf dem Ablagefeld ab.
  2. Die Syntax wird am ersten Element automatisch erkannt.
  3. Die Rechnung erscheint aufbereitet: Parteien, Positionen, Steueraufteilung, Summen, Zahlung.
  4. Danach folgen die Prüfbefunde mit den betroffenen Beträgen.

Eine UBL-Datei kann zusätzlich ein genaueres Profil angeben, etwa XRechnung 3.0 oder Peppol BIS Billing 3.0. Dieses Profil wird unverändert angezeigt: es sagt, welche Ausprägung der Norm der Aussteller einzuhalten behauptet.

Was die Datei Ihnen nicht von selbst sagt

Eine UBL-Datei kann tadellos aufgebaut und trotzdem falsch sein. XML sichert die Struktur, nicht die Richtigkeit: eine IBAN mit fehlender Ziffer, eine Steuer, die nicht zur Bemessungsgrundlage passt, oder eine Fälligkeit vor dem Rechnungsdatum ergeben eine technisch gültige und buchhalterisch unbrauchbare Datei.

Genau dafür gibt es die BR-xx-Regeln der EN 16931, und genau das prüft Lekteo bei jedem Lesen. Warum diese Dateien seit Anfang 2025 in Ihrem Posteingang landen, erklärt die Seite zur E-Rechnungspflicht.

Häufige Fragen

Ist XRechnung dasselbe wie UBL?

Nicht ganz. XRechnung ist ein Profil, das auf EN 16931 aufsetzt und in einer der beiden Syntaxen ausgeliefert wird — UBL oder CII. Eine XRechnung ist also meistens eine UBL-Datei mit zusätzlichen Vorgaben.

Warum zeigt der Browser meine UBL-Datei ohne lesbaren Inhalt?

Weil er genau das tut, worum er gebeten wurde: ein XML-Dokument anzeigen. Er zeigt den Elementbaum, denn er weiß nicht, dass es eine Rechnung ist. Es fehlt die Schicht, die jedem Element eine Bedeutung gibt und das Ganze wieder in Form bringt.

Die Elemente meiner Datei haben kein cbc:- oder cac:-Präfix. Ist das schlimm?

Nein, das kommt sogar häufig vor. Namensraum-Präfixe wählt der Aussteller frei, manche verwenden gar keine. Nur der lokale Name zählt: eine Datei ohne Präfixe liest sich genau wie jede andere.

Kann ich eine UBL-Datei in ein druckbares Dokument verwandeln?

Sie können die Rechnung ausdrucken, sobald sie aufbereitet ist, und die Daten als JSON oder CSV exportieren. Bewahren Sie dennoch die erhaltene XML-Datei auf: ein Ausdruck ist nur eine Darstellung davon.