Skip to content

Error

FX-SCH-A-001038: The seller of a line can have at most one role code

In short

Error: fails the selected checks.

FX-SCH-A-001038 means your line's seller details contain more than one ram:RoleCode element. Keep one appropriate role code, or none if you do not need a role code.

On this page

What it means

Within each ram:ItemSellerTradeParty under a line's ram:SpecifiedLineTradeAgreement, the Extended profile allows zero or one ram:RoleCode element. This rule counts role code elements; it does not check their values.

Why it matters

The line-level seller structure provides space for one optional role code. Repeating the element does not meet that structure, even if the codes are identical.

How to fix it

Check the seller details attached to the affected line. In ram:ItemSellerTradeParty, remove extra ram:RoleCode elements, leaving at most one appropriate code. Leave the invoice-level seller (BG-4) unchanged. Export again and recheck the 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-001038 still fails, and which other rules do.

Updated 6 November 2026