Skip to content
Change language: English

Error

FX-SCH-A-000469: The payee needs exactly one name element

In short

Error: fails the selected checks.

FX-SCH-A-000469 means the payee details (BG-10) contain either no ram:Name element for the payee name (BT-59) or more than one. Add the missing element or remove duplicates, keeping one correct payee name.

On this page

What it means

For each ram:PayeeTradeParty under ram:ApplicableHeaderTradeSettlement, this rule counts direct ram:Name elements and requires exactly one. It does not check whether the name text is empty. An empty ram:Name still counts as one element.

Why it matters

The payee name identifies the party receiving payment. The profile provides one name element for that information.

How to fix it

Add ram:Name if it is missing from the affected ram:PayeeTradeParty. If there are several name elements, retain one containing the correct payee name and remove the duplicates. Correct the software export if necessary, then export and recheck the invoice.

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:Name' must occur exactly 1 times.

Where this rule applies

Rule set Version
Factur-X 1.09 BASIC WL 1.0.9-2
Factur-X 1.09 BASIC 1.0.9-2
Factur-X 1.09 EN 16931 1.0.9-2
Factur-X 1.09 EXTENDED 1.0.9-2
ZUGFeRD 2.5 BASIC WL 2.5.2
ZUGFeRD 2.5 BASIC 2.5.2
ZUGFeRD 2.5 EN 16931 2.5.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-000469 still fails, and which other rules do.

Updated 6 November 2026