Skip to content

BR-TMP-2: External document location (BT-124) is not an absolute URL

Official message

[BR-TMP-2] BT-124 "External document location" muss eine absolute URL mit gültigem Schema enthalten.

XRechnung (CII) · Error · Message language: German · Version: xrechnung-3.0.2-validator-configuration-2026-08-31

[BR-TMP-2] BT-124 "External document location" muss eine absolute URL mit gültigem Schema enthalten.

XRechnung (UBL) · Error · Message language: German · Version: xrechnung-3.0.2-validator-configuration-2026-08-31
Severity
Error The invoice is invalid and may be rejected by the recipient.
Applies to
XRechnung (CII), XRechnung (UBL)
Affected fields
BT-124

What does this mean?

The external document location (BT-124) must be an absolute URL with a valid scheme, i.e. begin with a scheme such as https:. The value given does not meet this. The message is a warning.
Checked is whether the value begins with a letter, followed by at least one further letter, digit or one of the characters + . - and a colon. CII: ram:AdditionalReferencedDocument with ram:TypeCode 916 and ram:URIID. UBL: cac:Attachment/cac:ExternalReference/cbc:URI.

Typical causes

The address was given without scheme, e.g. www.example.com/delivery-note.pdf.
A relative path or a file path (e.g. C:\documents\delivery-note.pdf) was given.
There is a space in front of the address.

How to fix the error

State BT-124 as complete URL, e.g. https://www.example.com/delivery-note.pdf.
Do not link a document that only exists locally; embed it as attachment instead (BT-125).
Generate and validate the invoice again.

In E-Rechnungsfreund

In the invoice form, "Experte" view, section "Zusätzliche Dokumente (BG-24)" (additional documents), choose "URL" as "Quelle" (source) and enter the complete address including https:// in the field "URL (BT-124)". For a local file choose "Lokale Datei" (local file) instead.

Example

Wrong

<ram:AdditionalReferencedDocument>
  <ram:IssuerAssignedID>DN-4711</ram:IssuerAssignedID>
  <ram:URIID>www.example.com/delivery-note.pdf</ram:URIID>
  <ram:TypeCode>916</ram:TypeCode>
</ram:AdditionalReferencedDocument>

Correct

<ram:AdditionalReferencedDocument>
  <ram:IssuerAssignedID>DN-4711</ram:IssuerAssignedID>
  <ram:URIID>https://www.example.com/delivery-note.pdf</ram:URIID>
  <ram:TypeCode>916</ram:TypeCode>
</ram:AdditionalReferencedDocument>
For developers: test expression per syntax

XRechnung (CII) (CII)

Context: /rsm:CrossIndustryInvoice/rsm:SupplyChainTradeTransaction/ram:ApplicableHeaderTradeAgreement/ram:AdditionalReferencedDocument[ram:TypeCode = '916']

not(exists(ram:URIID)) or (matches(ram:URIID, $XR-URL-REGEX))

XRechnung (UBL) (UBL)

Context: /ubl:Invoice/cac:AdditionalDocumentReference/cac:Attachment/cac:ExternalReference | /cn:CreditNote/cac:AdditionalDocumentReference/cac:Attachment/cac:ExternalReference

matches(cbc:URI, $XR-URL-REGEX)

Related validation rules

Last updated:
Explanation of the validation rule, not legal or tax advice.