UBL-SR-28: Element count restricted by EN 16931

The syntax allows the element more often (or not at all) at this place, but EN 16931 maps it to one business term, so the CEN rules restrict how often it occurs: « Mandate reference identifier shall occur maximum once » Below: the message, the cause and the fix.

The message validators print

UBL-SR-28 is a rule of the UBL syntax rules (UBL-CR, UBL-SR, UBL-DT) (CEN validation artefacts 1.3.16) for UBL. It is an error (fatal): a validator rejects the invoice.

UBL
[UBL-SR-28]-Mandate reference identifier shall occur maximum once

What it checks

The syntax allows the element more often (or not at all) at this place, but EN 16931 maps it to one business term, so the CEN rules restrict how often it occurs: « Mandate reference identifier shall occur maximum once »

Why invoices fail it

The generator writes one element per source value (two notes, two references) where EN 16931 expects one, or leaves out an element EN 16931 needs exactly once.

How to fix it

Write the element exactly as often as the message says; join several values into one, or move the extra ones to a business term that repeats.

This explanation covers the whole UBL-SR family (54 rules, overview), so this page is not indexed.

The rule as published

Where the rule applies (context) and what must hold (test), unmodified from CEN EN 16931 validation artefacts 1.3.16. An assert fails when its test is false.

Text and test: © CEN/TC 434, EN 16931 validation artefacts, EUPL 1.2. Quoted unmodified; the explanations on this page are Veriport’s.

UBL · CEN EN 16931 validation artefacts (UBL) 1.3.16 · assert · error
context: cac:PaymentMeans
test:    (count(cac:PaymentMandate/cbc:ID) <= 1)

Check your own invoice

Drop your XRechnung, ZUGFeRD or Peppol file into a free validator (Peppol BIS, XRechnung, Factur-X): each runs the same rule files and links every finding to its rule page. From your own code, POST /einvoice/validate (reference) returns the same check as JSON, each finding with an explanation field pointing here (5 calls a check, anonymous within the daily allowance).

Sources