Skip to content

Error

FX-SCH-A-000188: Use at most one mandate reference per payment terms block

In short

Error: fails the selected checks.

FX-SCH-A-000188 means one ram:SpecifiedTradePaymentTerms block contains more than one direct debit mandate reference (BT-89). Keep the applicable reference in a single ram:DirectDebitMandateID within that block, then export and check the file again.

On this page

What it means

In the Basic WL, Basic, EN 16931 and Extended profiles, each header ram:SpecifiedTradePaymentTerms may contain at most one ram:DirectDebitMandateID. The rule does not require this element or impose a single-reference limit across separate payment terms blocks.

Why it matters

The reference identifies the direct debit authorisation. The profile represents it as a single field within each payment terms block.

How to fix it

Check the mandate reference in the affected payment terms block. Remove duplicate ram:DirectDebitMandateID elements. If the elements contain different references, confirm which mandate applies to that block and retain its reference once. Export and check the corrected file again.

Once the file is corrected, check it again for free: Validate a ZUGFeRD invoice

Or fix the invoice in a form and download the corrected file, for 1 credit: Fix a rejected e-invoice Beta

The rule as published

Element 'ram:DirectDebitMandateID' may occur at maximum 1 times.

Where this rule applies

Rule set Version
Factur-X 1.09 BASIC WL 1.0.9-2
Factur-X 1.09 BASIC 1.0.9-2
Factur-X 1.09 EN 16931 1.0.9-2
Factur-X 1.09 EXTENDED 1.0.9-2
ZUGFeRD 2.5 BASIC WL 2.5.2
ZUGFeRD 2.5 BASIC 2.5.2
ZUGFeRD 2.5 EN 16931 2.5.2
ZUGFeRD 2.5 EXTENDED 2.5.2
Rule text from phive-rules 4.6.4.

Check your file

Drop your e-invoice to see whether FX-SCH-A-000188 still fails, and which other rules do.

Updated 6 November 2026