Skip to content

Error

FX-SCH-A-000866: Keep at most one invoicee role code

In short

Error: fails the selected checks.

FX-SCH-A-000866 means your invoicee record contains more than one ram:RoleCode element. Keep one role code or omit the element if you do not need it.

On this page

What it means

This rule counts ram:RoleCode elements directly inside ram:ApplicableHeaderTradeSettlement/ram:InvoiceeTradeParty. The Extended profile permits zero or one, but not multiple elements.

Why it matters

The invoicee record has space for one role code, rather than several role-code entries.

How to fix it

In ram:ApplicableHeaderTradeSettlement/ram:InvoiceeTradeParty, remove the extra ram:RoleCode elements. Keep the code that correctly describes the invoicee, or remove all ram:RoleCode elements if you do not need to supply a role code. Export and recheck.

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

Updated 6 November 2026