Valinvo

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:

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:

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

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:

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:

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