einvoice / EN 16931 / XRechnung rule reference
BR-DEX-10
What this rule means and how to fix it
'Third party payment type' (BT-DEX-001, cbc:ID) must be present (non-empty) in every THIRD PARTY PAYMENT group (BG-DEX-09).
Das Element "Third party payment type" BT-DEX-001 muss übermittelt werden, wenn die Gruppe "THIRD PARTY PAYMENT" (BG-DEX-09) übermittelt wird.
Deutsche Fassung: Amtlicher KoSIT-Text (official KoSIT assert text).
- Requires
- 'Third party payment type' (BT-DEX-001, cbc:ID) must be present (non-empty) in every THIRD PARTY PAYMENT group (BG-DEX-09).
- Business terms
BG-DEX-09BT-DEX-001- Syntax
- Binds the UBL-2.1 Invoice / CreditNote syntax
- Location (UBL-2.1 path)
/ubl:Invoice/cac:PrepaidPayment- Fix
- Correct `/ubl:Invoice/cac:PrepaidPayment` so that 'Third party payment type' (BT-DEX-001, cbc:ID) must be present (non-empty) in every THIRD PARTY PAYMENT group (BG-DEX-09).
- Fix (Deutsch)
- Korrigieren Sie `/ubl:Invoice/cac:PrepaidPayment`, sodass gilt: Das Element "Third party payment type" BT-DEX-001 muss übermittelt werden, wenn die Gruppe "THIRD PARTY PAYMENT" (BG-DEX-09) übermittelt wird.
- Severity
- fatal
- Provenance source
xrechnung-ubl- Provenance assert
Das Element "Third party payment type" BT-DEX-001 muss übermittelt werden, wenn die Gruppe "THIRD PARTY PAYMENT" (BG-DEX-09) übermittelt wird.
The Location above is a UBL-2.1 path, and no UN/CEFACT-CII path for this rule is published here; Fix and Fix (Deutsch), verbatim from remediation_catalog.json and not reworded here; the UBL-2.1 binding of this rule is differentially proven against the official KoSIT XRechnung 2.5.0 (XRechnung 3.0.2) Schematron.
Where to check the fix: paste the corrected invoice into the browser validator at /einvoice/validate/ — it runs this same engine locally in your browser, with no upload, and stops reporting BR-DEX-10 once the edit lands.
Korrektur prüfen: Laden Sie die geänderte Rechnung in den Browser-Validator unter /einvoice/validate/ — er führt dieselbe Engine lokal im Browser aus, ohne Upload, und meldet BR-DEX-10 nicht mehr, sobald die Korrektur greift.
The same invoice, failing and fixed
No vendored test suite ships a labelled example for this rule, so this pair was found rather than written. The engine was run over the vendored instance corpus/xrechnung-testsuite/src/test/business-cases/extension/05.01a-INVOICE_ubl.xml under --profile xrechnung, then re-run over the same file with one mechanical edit applied to one element, over and over, until the edit below changed the verdict: the text content of ID was deleted, leaving the element present but empty. The page publishes it because the engine reported BR-DEX-10 for the edited document and did not report it for the untouched one.
UBL Invoice (XRechnung extension) — fails
The vendored file around the change, verbatim:
<cac:PrepaidPayment>
<!-- BT-DEX-001 -->
<cbc:ID></cbc:ID>
<!-- BT-DEX-002 -->
<cbc:PaidAmount currencyID="EUR">19.96</cbc:PaidAmount>
<!-- BT-DEX-003 -->
<cbc:InstructionID>Mobiles Bezahlen (Brutto-Forderung für Fremdleistungen Anbieter A)</cbc:InstructionID>
</cac:PrepaidPayment>
UBL Invoice (XRechnung extension) — passes
The same lines as 05.01a-INVOICE_ubl.xml actually ships them — this block is the fix for the block above:
<cac:PrepaidPayment>
<!-- BT-DEX-001 -->
<cbc:ID>MobilesBezahlen</cbc:ID>
<!-- BT-DEX-002 -->
<cbc:PaidAmount currencyID="EUR">19.96</cbc:PaidAmount>
<!-- BT-DEX-003 -->
<cbc:InstructionID>Mobiles Bezahlen (Brutto-Forderung für Fremdleistungen Anbieter A)</cbc:InstructionID>
</cac:PrepaidPayment>
What the engine reports for the edited invoice
{
"element": "cac:PrepaidPayment/cbc:ID",
"field": "cac:PrepaidPayment/cbc:ID",
"fix_hint": "Correct `/ubl:Invoice/cac:PrepaidPayment` so that 'Third party payment type' (BT-DEX-001, cbc:ID) must be present (non-empty) in every THIRD PARTY PAYMENT group (BG-DEX-09).",
"location": "/ubl:Invoice/cac:PrepaidPayment",
"message": "'Third party payment type' (BT-DEX-001) must be transmitted when a THIRD PARTY PAYMENT (BG-DEX-09) is present.",
"rule": "BR-DEX-10",
"severity": "fatal",
"terms": [
"BG-DEX-09",
"BT-DEX-001"
],
"title": "'Third party payment type' (BT-DEX-001, cbc:ID) must be present (non-empty) in every THIRD PARTY PAYMENT group (BG-DEX-09)."
}
Rule ids the engine reports for 05.01a-INVOICE_ubl.xml untouched: BR-CO-16 BR-DE-TMP-32. After the edit, BR-DEX-10 is reported that was not before.
Two honest limits. This is an edit that provokes the rule, not the only one, and it is not a claim about how real exporters break it. And it is the reverse of the fix a reader needs: the passing block is the vendored file's own content, which is what a conformant invoice looks like here.
Reproduce it yourself: take corpus/xrechnung-testsuite/src/test/business-cases/extension/05.01a-INVOICE_ubl.xml from this repository, apply the one edit named above, and run einvoice validate 05.01a-INVOICE_ubl.xml --profile xrechnung --format json, or paste the file into the browser validator, which runs this same engine locally with no upload.
Everything here is free and open source — pick up whatever helps, at your own pace:
- Licensing — free and open source under Apache-2.0 for everyone, including closed-source embedding: use, modify and ship it inside a commercial product with no fee and no license key.
- German remediation (
--lang de) — the German fix for this rule is in the section above; the CLI surfaces it in place of the English message with--lang de. - Quickstart / free on-ramp — the README, a copy-paste CI-gate recipe, and a 5-minute worked walkthrough.