Skip to content
Theme
English

Warning

UBL-CR-289: A person linked to the payee should be left out

In short

Warning: worth checking.

UBL-CR-289 means the file includes a person block for the payee (cac:Person), which EN 16931 does not use. It is only a warning and the file is still accepted, but remove the block and export again to clear it.

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 cac:PayeeParty has no cac:Person block, which describes an individual such as a name. The standard only has the payee's name (BT-59), identifier (BT-60) and legal registration identifier (BT-61).

Why it matters

There is no field for an individual connected to the payee, so the recipient's software ignores the block. The invoice or credit note is not rejected, because the rule is a warning. Fixing it keeps the file within the standard.

How to fix it

If the payee is a person, put their name in the payee name (BT-59) and leave the separate person details out. Clear any extra person fields in the payee settings of your invoicing software. If you build the XML yourself, delete cac:Person from cac:PayeeParty.

The rule as published

A UBL invoice should not include the PayeeParty Person

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

Updated 6 November 2026