Skip to content
Theme
English

Warning

UBL-CR-287: The payee's shareholder details should be left out

In short

Warning: worth checking.

UBL-CR-287 means the file includes shareholder details for the payee (cac:ShareholderParty), which EN 16931 does not use. It is only a warning and the file is still accepted, but remove the block and export again for a clean result.

On this page

What it means

The payee (BG-10) is the party that receives the payment when that is not the seller. This rule checks that the payee's legal entity block has no cac:ShareholderParty, a party block describing a shareholder of the payee's company. The standard has no place for it.

Why it matters

The recipient's software only reads the fields defined by the standard, so shareholder details are ignored. Because the rule is a warning, the invoice or credit note is not rejected. It is also company information that has no use on an invoice.

How to fix it

Open the payee settings in your invoicing software and remove any shareholder or ownership entry, or switch off the option that adds it. If you build the XML yourself, delete cac:ShareholderParty from cac:PayeeParty/cac:PartyLegalEntity. The payee's name, identifier and registration number can stay.

The rule as published

A UBL invoice should not include the PayeeParty PartyLegalEntity ShareholderParty

Where this rule applies

Rule set Version
EN 16931 (UBL) 1.3.17
EN 16931 (UBL credit note) 1.3.17
XRechnung 3.0 (UBL) 3.0.2
XRechnung 3.0 (UBL credit note) 3.0.2
Peppol BIS Billing 3.0 (invoice) 2026.5
Peppol BIS Billing 3.0 (credit note) 2026.5
SI-UBL 2.0 / NLCIUS (invoice) 2.0.3.13
SI-UBL 2.0 / NLCIUS (credit note) 2.0.3.13
France CTC (UBL invoice) 1.4.0-04
France CTC (UBL credit note) 1.4.0-04
CIUS-RO UBL Invoice 1.0.9 1.0.9
CIUS-RO UBL Credit Note 1.0.9 1.0.9
Rule text from phive-rules 4.6.4.

Check your file

Drop your e-invoice to see whether UBL-CR-287 still fails, and which other rules do.

Updated 6 November 2026