Skip to content

Error

FX-SCH-A-000833: The final delivery party can have only one role code

In short

Error: fails the selected checks.

FX-SCH-A-000833 means the final delivery party, ram:UltimateShipToTradeParty, contains more than one ram:RoleCode element. Keep no more than one role code for that party.

On this page

What it means

This rule counts direct ram:RoleCode children of ram:UltimateShipToTradeParty in the header delivery section. Zero or one is allowed; two or more fail the check.

Why it matters

The Extended profile allows a single role-code field in this party block. Repeating the field exceeds that limit.

How to fix it

In ram:ApplicableHeaderTradeDelivery/ram:UltimateShipToTradeParty, keep the appropriate ram:RoleCode and remove extra occurrences. You can omit the field if you do not need it. If your invoicing software does not let you correct this field, give its support team the rule ID and XML path. 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-000833 still fails, and which other rules do.

Updated 6 November 2026