Skip to content

Error

FX-SCH-A-000694: The buyer may have at most one role code

In short

Error: fails the selected checks.

FX-SCH-A-000694 means your buyer's details contain more than one ram:RoleCode element. Keep one role code or remove this optional element.

On this page

What it means

Within ram:ApplicableHeaderTradeAgreement/ram:BuyerTradeParty, this rule permits zero or one ram:RoleCode child element. It checks the number of role code elements, not their values.

Why it matters

The Extended profile allows one role code at this buyer location. Duplicate elements exceed that limit even if they contain identical codes.

How to fix it

Check ram:RoleCode directly inside ram:BuyerTradeParty in the header trade agreement. Keep the code that describes the buyer's role and remove extra elements, or omit the role code if you do not need it. Recheck your corrected 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-000694 still fails, and which other rules do.

Updated 6 November 2026