UBL-CR-309: Room aus der Postanschrift des Steuervertreters entfernen

Die kurze Antwort

UBL-CR-309 ist eine Warnung, die ausgelöst wird, wenn cbc:Room in der Postanschrift des Steuervertreters (cac:TaxRepresentativeParty/cac:PostalAddress) steht. EN 16931 hat dafür kein Informationselement; entfernen Sie daher das Element. Schreiben Sie Angaben wie Gebäude, Stockwerk oder Abteilung in die Adresszeilen: cbc:StreetName, cbc:AdditionalStreetName und eine cac:AddressLine/cbc:Line (BT-64, BT-65, BT-164; eine Anschrift hat nur eine solche Zeile, UBL-SR-51).

Die Warnung allein macht das Dokument nicht ungültig, doch andere Regeln prüfen weiterhin, was vorhanden ist. Das Entfernen des Elements hält das XML innerhalb des Modells von EN 16931, auf dessen Grundlage ein Empfänger die Rechnung übernimmt.

Was die Regel prüft

Die Regel prüft genau eines: ob cac:TaxRepresentativeParty/cac:PostalAddress/cbc:Room vorhanden ist. Seinen Wert liest sie nicht.

Sie wird einmal für das ganze Dokument ausgewertet und daher nur einmal gemeldet, gleich wie oft das Dokument das Element enthält; der Befund verweist auf das Wurzelelement, nicht auf das Element selbst: Suchen Sie im XML nach cac:TaxRepresentativeParty/cac:PostalAddress/cbc:Room.

Wie es in einer Integration dazu kommt

Mögliche Ursachen, abgeleitet aus der Form der Regel und nicht aus gemessener Nutzung:

• Das Quellsystem führt den Wert, und das Mapping schreibt ihn, weil UBL 2.1 einen Platz dafür hat.
• Eine allgemeine UBL-2.1-Bibliothek schreibt jedes Element und Attribut, für das sie einen Wert hat, ob EN 16931 es verwendet oder nicht.
• Ein Mapping für ein anderes UBL-basiertes Dokument, etwa eine Bestellung, eine Versandanzeige oder ein nationales Profil, wird für Peppol BIS Billing wiederverwendet.

So korrigieren Sie das Dokument

1. Geben Sie cac:TaxRepresentativeParty/cac:PostalAddress/cbc:Room nicht mehr aus.
2. Schreiben Sie Angaben wie Gebäude, Stockwerk oder Abteilung in die Adresszeilen: cbc:StreetName, cbc:AdditionalStreetName und eine cac:AddressLine/cbc:Line (BT-64, BT-65, BT-164; eine Anschrift hat nur eine solche Zeile, UBL-SR-51).
3. Prüfen Sie erneut: Die Warnung verschwindet. War das Element das einzige in seinem übergeordneten Element, entfernen Sie auch dieses: Peppol weist leere Elemente zurück (PEPPOL-EN16931-R008).

Korrigierte Rechnung prüfen

Vorher und nachher

Dies sind Ausschnitte, keine vollständigen Dokumente. Die vollständigen synthetischen Dokumente, aus denen sie stammen, sind unten verlinkt.

Ausschnitt der Rechnung mit der Warnung: Room in der Postanschrift des Steuervertreters

<cac:PostalAddress>
  <cbc:Room>Example</cbc:Room>
  <cbc:StreetName>4 Example Street</cbc:StreetName>
  <cbc:CityName>London</cbc:CityName>
  <cbc:PostalZone>SW1A 4AA</cbc:PostalZone>
  <cac:Country>
    <cbc:IdentificationCode>GB</cbc:IdentificationCode>
  </cac:Country>
</cac:PostalAddress>

Ausschnitt der korrigierten Rechnung: dieselben Zeilen ohne das Element

<cac:PostalAddress>
  <cbc:StreetName>4 Example Street</cbc:StreetName>
  <cbc:CityName>London</cbc:CityName>
  <cbc:PostalZone>SW1A 4AA</cbc:PostalZone>
  <cac:Country>
    <cbc:IdentificationCode>GB</cbc:IdentificationCode>
  </cac:Country>
</cac:PostalAddress>

Die Rechnung mit der Warnung enthält <cbc:Room>Example</cbc:Room> in der Postanschrift des Steuervertreters, und die korrigierte Rechnung ist dasselbe Dokument ohne das Element. Die Rechnung mit der Warnung meldet nur diese Warnung, ist in jedem Prüfschritt gültig und würde so angenommen.

Wo die Regel gilt

• Gilt gleichermaßen für UBL Invoice und CreditNote; das aufgezeichnete Beispiel ist eine Rechnung.
• Die Warnung stammt aus den Regeln des Prüfschritts EN 16931 für die UBL-Syntax. Im aufgezeichneten Beispiel besteht das Dokument den XSD-Prüfschritt: Das Element ist gültiges UBL 2.1 und liegt lediglich außerhalb des Modells von EN 16931.

Verwandte Regeln

• UBL-CR-307: Postbox in der Postanschrift des Steuervertreters
• UBL-CR-308: Floor in der Postanschrift des Steuervertreters
• UBL-CR-310: BlockName in der Postanschrift des Steuervertreters
• Alle Regeln der Referenz ansehen
• Hintergrund (auf Englisch): Understanding EN 16931 validation errors

Umfang und Quelle

Geschrieben für Peppol BIS Billing 3.0.21 (May 2026), EN 16931 1.3.16, angewendet auf Invoice- und CreditNote-Dokumente in UBL 2.1. Andere Profile, Syntaxen und Releases können diese Kennung anders definieren. Version des Hinweiskatalogs 2026-09-29.1: Quelle geprüft am 2026-09-29, Erklärung zuletzt aktualisiert am 2026-09-29.

Die offizielle Definition von UBL-CR-309 (auf Englisch) enthält den normativen Wortlaut und den Test. Diese Seite ist unsere Erklärung dazu, keine Kopie.

Die Erklärung ändert das Urteil der Engine nicht. Dass Sie diesen Befund beheben, heißt nicht, dass das Dokument jeden Prüfschritt besteht. Die Validierung bescheinigt keine rechtliche oder steuerliche Konformität und überträgt kein Dokument über Peppol.