Back to the error catalogue
BR-TMP-2BT-124
input

The external document location is not an absolute URL

`External document location` (BT-124) must be an absolute URL carrying a valid scheme.

Only the issuer holds this value: Factlint reports it and never fabricates it. Test your invoice to find out whether it is affected.

The message your validator prints

Copied verbatim from the sealed artefact: this is the exact sentence the check prints when this rule fails.

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

Quoted from schematron-xrechnung 3.0.2, licensed under Apache-2.0.

Common searches around this code

These phrases mirror what an integrator searches for: code, syntax, rule, business field and correction.

BR-TMP-2 The external document location is not an absolute URLBR-TMP-2 XRechnung Schematron package (KoSIT)BR-TMP-2 BT-124[BR-TMP-2] BT-124 "External document location" muss eine absolute URL mit gültigem Schema enthalten.BR-TMP-2 correction

Test your file with this error in mind

Upload the invoice involved: the report will say whether this code appears, where it appears in the document, and whether Factlint can only report it or also fix it.

To automate this check in an ERP flow, call the validation API and link every returned code to its public page.

Why this error happens

A relative URL, or one without a scheme (`www.example.test/annex.pdf`), only resolves from the system that produced it. At the recipient it leads nowhere — and the referenced document is lost with nothing to say so.

How to fix it

Write the full URL, scheme included. Factlint does not prefix it: choosing between `http` and `https` on the issuer's behalf means deciding whether the link is encrypted.

XML correction example

BEFORE (invalid)
<ram:URIID>www.exemple.test/piece.pdf</ram:URIID>
AFTER (compliant)
<ram:URIID>https://www.exemple.test/piece.pdf</ram:URIID>