Skip to content
Change language: English

Error

FX-SCH-A-000470: Add the scheme attribute to the payee's global identifier

In short

Error: fails the selected checks.

FX-SCH-A-000470 means a ram:GlobalID for the payee identifier (BT-60) is missing its schemeID attribute (BT-60-1). Add the attribute with the scheme code that matches the identifier, such as 0088 for a GLN.

On this page

What it means

This rule checks for a schemeID attribute on each ram:GlobalID inside ram:PayeeTradeParty under ram:ApplicableHeaderTradeSettlement. It checks presence only: an empty attribute passes this test. FX-SCH-A-000471 separately checks non-empty scheme codes against the Basic WL profile's list.

Why it matters

The scheme identifies the system to which the payee identifier belongs. Checking whether the attribute exists is separate from checking its code.

How to fix it

Confirm which identifier system the payee uses. Add schemeID to the existing ram:GlobalID with the matching code, using 0088 only for a GLN. Keep the identifier itself unless it is incorrect. If your software omits the attribute, have its export corrected, 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

Attribute '@schemeID' is required in this context.

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

Updated 6 November 2026