XRechnung EndpointID: die elektronische Adresse in BT-34 und BT-49
Eine XRechnung braucht zwei elektronische Adressen: die des Verkäufers (BT-34) und die des Käufers (BT-49). In UBL ist jede ein Element cbc:EndpointID mit dem Attribut schemeID. Beide sind Pflicht, und eine E-Mail-Adresse mit dem Schema EM ist erlaubt. Das ist die kurze Antwort; der Rest dieser Seite sind die Einzelheiten.
Was sie ist
Die elektronische Adresse gibt an, wo eine Partei elektronische Rechnungen empfängt. Sie besteht aus zwei Teilen:
- dem Wert, zum Beispiel einer E-Mail-Adresse, einer Umsatzsteuer-ID oder einer Leitweg-ID,
- dem Schema, einem Code, der sagt, um welche Art von Wert es sich handelt.
Sie ist keine Versandanweisung für die Datei, die Sie gerade erzeugen. Eine XRechnung mit buyer@example.de in BT-49 erreicht den Käufer weiterhin auf dem Weg, auf dem Sie sie versenden: per E-Mail, über ein Portal oder über das Peppol-Netzwerk.
Wo sie steht
UBL (Invoice und CreditNote). cbc:EndpointID gehört in cac:Party, vor cac:PartyIdentification und cac:PartyName. An anderer Stelle besteht die Datei das XML-Schema nicht.
<cac:AccountingSupplierParty>
<cac:Party>
<cbc:EndpointID schemeID="EM">invoices@example-software.de</cbc:EndpointID>
<cac:PartyName>…</cac:PartyName>
</cac:Party>
</cac:AccountingSupplierParty>
<cac:AccountingCustomerParty>
<cac:Party>
<cbc:EndpointID schemeID="EM">rechnung@beispiel-behoerde.de</cbc:EndpointID>
<cac:PartyName>…</cac:PartyName>
</cac:Party>
</cac:AccountingCustomerParty>
CII (UN/CEFACT Cross Industry Invoice). Das Element heißt ram:URIUniversalCommunication und steht nach ram:PostalTradeAddress und vor ram:SpecifiedTaxRegistration:
<ram:SellerTradeParty>
…
<ram:PostalTradeAddress>…</ram:PostalTradeAddress>
<ram:URIUniversalCommunication>
<ram:URIID schemeID="EM">invoices@example-software.de</ram:URIID>
</ram:URIUniversalCommunication>
<ram:SpecifiedTaxRegistration>…</ram:SpecifiedTaxRegistration>
</ram:SellerTradeParty>
ram:BuyerTradeParty erhält dasselbe Element für BT-49.
Welches Schema
Das Schema muss aus der EAS-Codeliste (Electronic Address Scheme) der Europäischen Kommission stammen. Die Codes, die in deutschen Rechnungen und denen der Nachbarländer am häufigsten vorkommen:
| Schema | Wert | Typischer Einsatz |
|---|---|---|
EM | E-Mail-Adresse | XRechnung per E-Mail oder Portal-Upload. In Peppol BIS nicht zulässig. |
9930 | Deutsche Umsatzsteuer-ID, z. B. DE123456789 | Deutsche Unternehmen im Peppol-Netzwerk. |
0204 | Leitweg-ID | Deutsche Behörden im Peppol-Netzwerk. |
0088 | GLN (Global Location Number) | Unternehmen, die GLNs bereits im EDI nutzen. |
0208 | Belgische Unternehmensnummer, 10 Ziffern | Belgische Unternehmen in Peppol. |
0106, 0190 | Niederländische KvK-Nummer, niederländische OIN | Niederländische Unternehmen und Behörden. |
0009, 0225 | Französische SIRET, französische E-Rechnungs-Adresse | Französische Unternehmen. |
Wer über Peppol versendet, nimmt die Kennung, unter der der Empfänger dort registriert ist; Ihr Access Point sucht den Empfänger mit genau diesem Schema und Wert. Wer eine XRechnung per E-Mail oder Portal-Upload zustellt, besteht die offiziellen Regeln mit einer E-Mail-Adresse und EM.
Drei Felder, die oft verwechselt werden
- BT-49, elektronische Adresse des Käufers (
cbc:EndpointID): diese Seite. - BT-10, Käuferreferenz (
cbc:BuyerReference): Bei öffentlichen Auftraggebern in Deutschland steht hier die Leitweg-ID. Das ist ein eigenes Pflichtfeld. Eine Leitweg-ID in BT-10 füllt BT-49 nicht, und umgekehrt. - BT-43, E-Mail des Verkäufer-Kontakts (
cac:Contact/cbc:ElectronicMail): die Adresse einer Person oder eines Teams für Rückfragen. Es darf dasselbe Postfach sein wie in BT-34, aber beide Elemente müssen vorhanden sein.
Die Fehler, die dabei entstehen
Wir haben das Element in einer offiziellen XRechnung-Testrechnung entfernt oder verändert und sie gegen die Regeln von XRechnung 3.0.2 geprüft, in UBL und in CII. Diese Regel-IDs kommen zurück:
| Regel | Meldung | Ursache | Lösung |
|---|---|---|---|
PEPPOL-EN16931-R020 | Seller electronic address MUST be provided | BT-34 fehlt. | cbc:EndpointID des Verkäufers mit schemeID ergänzen. |
PEPPOL-EN16931-R010 | Buyer electronic address MUST be provided | BT-49 fehlt. | cbc:EndpointID des Käufers mit schemeID ergänzen. |
BR-62 | The Seller electronic address (BT-34) shall have a Scheme identifier. | Das Element ist da, das Attribut schemeID fehlt. | schemeID ergänzen, z. B. schemeID="EM". |
BR-63 | The Buyer electronic address (BT-49) shall have a Scheme identifier. | Dasselbe auf der Käuferseite. | schemeID ergänzen. |
BR-CL-25 | Endpoint identifier scheme identifier MUST belong to the CEF EAS code list | Das Schema ist kein Code aus der Liste, zum Beispiel EMAIL oder email statt EM. | Den genauen Code verwenden. Groß- und Kleinschreibung zählt. |
Die beiden Regel-IDs mit PEPPOL- sind kein Irrtum: XRechnung 3.0 meldet die fehlende Adresse unter denselben IDs wie Peppol BIS.
Zwei weitere gelten nur für Peppol BIS Billing 3.0:
| Regel | Ursache | Lösung |
|---|---|---|
PEPPOL-EN16931-CL008 | Das Schema steht nicht in der eigenen, kürzeren Liste von Peppol. Meist ist es EM: E-Mail-Adressen sind keine Peppol-Adressen. | Die Peppol-Kennung des Empfängers verwenden, z. B. 9930 oder 0208. |
PEPPOL-COMMON-R043 | Schema 0208 mit einem Wert, der keine gültige belgische Unternehmensnummer ist. | Zehn Ziffern, kein BE davor, keine Punkte; die letzten zwei Ziffern sind eine Prüfzahl. |
Welche davon Ihre Datei auslöst, zeigt der kostenlose Validator.
Wenn Sie die Adresse des Käufers nicht kennen
Fragen Sie den Käufer; es ist seine Kennung, und eine geratene hilft niemandem. Für eine XRechnung, die Sie per E-Mail oder Portal zustellen, erfüllt die E-Mail-Adresse, die der Käufer Ihnen für Rechnungen genannt hat, mit EM die Regeln. Für Peppol nennt Ihnen der Käufer oder sein Access Point Schema und Wert, und im öffentlichen Peppol Directory sind viele Empfänger verzeichnet.
Tragen Sie keinen Platzhalter ein, nur um die Prüfung zu bestehen. Die Datei wäre gültig, und das System des Käufers kann sie trotzdem ablehnen oder der falschen Partei zuordnen.
In der Valinvo-API
Im JSON der Rechnung haben beide Parteien ein electronicAddress mit denselben zwei Teilen:
"seller": {
"name": "Example Software GmbH",
"electronicAddress": { "scheme": "EM", "value": "invoices@example-software.de" }
},
"buyer": {
"name": "Beispiel Behörde",
"electronicAddress": { "scheme": "EM", "value": "rechnung@beispiel-behoerde.de" }
}
Fehlt eine, kommt ein 400 zurück, das das Feld nennt (invoice.seller.electronicAddress oder invoice.buyer.electronicAddress), noch bevor XML erzeugt wird. Das vollständige Beispiel steht im Quickstart.
Im November 2026 gegen die Regeln von XRechnung 3.0.2 und Peppol BIS Billing 3.0 geprüft. Wir entwickeln Valinvo, einen Validator und eine API für diese Formate.
Schnellstart · XRechnung-Validator · ZUGFeRD-Validator · ZUGFeRD-csharp: Ihre Optionen · XRechnung mit PHP oder Node.js · XRechnung mit Python · XRechnung EndpointID (BT-34, BT-49) · Fehlercodes