Skip to content

Error

FX-SCH-A-000774: Keep at most one seller role code

In short

Error: fails the selected checks.

FX-SCH-A-000774 means the seller (BG-4) has more than one ram:RoleCode element. Keep one appropriate role code, or omit this optional field.

On this page

What it means

In the Extended profiles of Factur-X and ZUGFeRD, the header's ram:SellerTradeParty may contain zero or one ram:RoleCode elements. Two or more fail this rule, even if the codes are identical.

Why it matters

The profile provides one optional role-code field for the seller. Repeating it does not match that structure.

How to fix it

Check the role code in your seller details (BG-4). In the XML, keep at most one ram:RoleCode directly inside ram:SellerTradeParty under ram:ApplicableHeaderTradeAgreement. Remove duplicate elements, or remove the role-code field entirely if you do not need it. Export the file again and recheck it.

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

Updated 6 November 2026