BR-52: Anlage ohne Dokumentenreferenz

Die Rechnung hängt ein Begleitdokument an, etwa einen Stundenzettel oder Lieferschein, gibt ihm aber keinen Namen. Ohne Kennung kann der Empfänger die Anlage nirgends zuordnen.

Was die Regel prüft

Jede Gruppe „Additional supporting document" (BG-24) muss eine Supporting document reference (BT-122) enthalten. BT steht für Business Term, das nummerierte Feld der Norm; BG ist eine Business Group, also ein Feldbündel. BT-122 ist die frei wählbare Kennung des Dokuments: eine Belegnummer, ein Dateiname, ein Aktenzeichen. Sie ist das einzige Pflichtfeld der Gruppe, alles andere (Beschreibung, eingebettete Datei, externe URL) ist optional.

Im CII-Format entspricht BG-24 dem Element ram:AdditionalReferencedDocument mit ram:TypeCode 916; BT-122 landet in ram:IssuerAssignedID.

Warum sie in der Praxis fehlschlägt

Häufigster Auslöser: Die Software bettet eine Datei als Binärobjekt ein und setzt den Dateinamen nur ins filename-Attribut, nicht zusätzlich in ram:IssuerAssignedID. Das Attribut ersetzt die Referenz aber nicht, beide Felder sind getrennt.

Zweiter Fall: Der Anhang wurde in der Erfassungsmaske hochgeladen, das Feld „Referenz" oder „Belegnummer" blieb leer, und die Software erzeugt die Gruppe trotzdem.

Dritter Fall: Es wird nur eine externe URL (BT-124) übermittelt. Auch dann bleibt BT-122 Pflicht.

So behebst du den Fehler

Gib jeder Anlage eine Kennung. Der Dateiname ist die einfachste und meist beste Wahl, denn er ist ohnehin eindeutig zu halten (bei der XRechnung erzwingt BR-DE-22 eindeutige Dateinamen). Wenn deine Software kein Referenzfeld anbietet, prüfe, ob sie den Dateinamen automatisch übernimmt, und aktualisiere sie andernfalls.

Bei Belegschmied bekommt jede eingebettete Anlage automatisch ihren Dateinamen als BT-122, das Feld kann nicht leer bleiben.

XML-Beispiel: vorher und nachher

<ram:AdditionalReferencedDocument>
  <!-- verletzt BR-52: ram:IssuerAssignedID (BT-122) fehlt -->
  <ram:TypeCode>916</ram:TypeCode>
  <ram:AttachmentBinaryObject mimeCode="application/pdf"
      filename="stundenzettel-2026-031.pdf"><!-- … --></ram:AttachmentBinaryObject>
</ram:AdditionalReferencedDocument>

<ram:AdditionalReferencedDocument>
  <ram:IssuerAssignedID>stundenzettel-2026-031.pdf</ram:IssuerAssignedID>
  <ram:TypeCode>916</ram:TypeCode>
  <ram:AttachmentBinaryObject mimeCode="application/pdf"
      filename="stundenzettel-2026-031.pdf"><!-- … --></ram:AttachmentBinaryObject>
</ram:AdditionalReferencedDocument>