Skip to content

Error

FX-SCH-A-000986: Payee role code in payment terms is repeated

In short

Error: fails the selected checks.

FX-SCH-A-000986 means the payee in your payment terms has more than one ram:RoleCode element. Keep one role code, or omit it if you do not need this optional field.

On this page

What it means

For each ram:PayeeTradeParty inside ram:SpecifiedTradePaymentTerms, this rule allows zero or one ram:RoleCode element. It checks the number of elements, not their values.

Why it matters

The Extended profile provides one optional role-code field for this payee, rather than a list of role codes.

How to fix it

Check the role recorded for the payee in your payment terms. In ram:SpecifiedTradePaymentTerms/ram:PayeeTradeParty, retain the appropriate ram:RoleCode and remove repeated elements. If you do not need a role code, omit the element. Export the corrected file and check it 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:RoleCode' may occur at maximum 1 times.

Where this rule applies

Rule set Version
Factur-X 1.09 EXTENDED 1.0.9-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-000986 still fails, and which other rules do.

Updated 6 November 2026