Skip to content

Error

FX-SCH-A-000908: The payee may have at most one role code

In short

Error: fails the selected checks.

FX-SCH-A-000908 means the payee has more than one ram:RoleCode element. Remove the extra elements so the payee has at most one role code.

On this page

What it means

For the payee (BG-10), ram:PayeeTradeParty may contain zero or one ram:RoleCode child element. Two or more fail this check, even if they contain the same code.

Why it matters

The Extended profile provides only one role code element for the payee. Repeating that element breaks the required structure, whether the values agree or differ.

How to fix it

In ram:PayeeTradeParty, keep the applicable ram:RoleCode and remove any extra ram:RoleCode elements. If no role code is needed, omit the element. If your software creates the repetitions, ask its supplier to correct the export. Regenerate and recheck your file.

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-000908 still fails, and which other rules do.

Updated 6 November 2026