Skip to content

Ironfang Finance - Rule reference

UBL-CR-597: Remove Name from the line VAT information

Warning: EN 16931 has no place for cbc:Name in the line VAT information. The document stays valid; remove it.

EN 16931Warning: the document stays validLines and prices

On this page

The short answer

UBL-CR-597 is a warning raised when cbc:Name appears in the line VAT information (cac:InvoiceLine/cac:Item/cac:ClassifiedTaxCategory). EN 16931 has no business term for it, so remove the element.

The warning on its own does not make the document invalid, though other rules still check what is there. Removing the element keeps the XML inside the EN 16931 model, which is what a receiver maps the invoice from.

What the rule checks

The rule checks one thing: whether cac:InvoiceLine/cac:Item/cac:ClassifiedTaxCategory/cbc:Name exists. Its value is not read.

It runs once against the whole document, so it is reported once however many lines carry the element, and the finding points at the document root rather than at the element: look for cac:InvoiceLine/cac:Item/cac:ClassifiedTaxCategory/cbc:Name in the XML.

TermMeaningUBL element
-Name (UBL only, no business term)cac:InvoiceLine/cac:Item/cac:ClassifiedTaxCategory/cbc:Name
BG-30Line VAT informationcac:InvoiceLine/cac:Item/cac:ClassifiedTaxCategory

How an integration ends up here

Possible causes, from the shape of the rule rather than from measured usage:

  • The source system holds the value, and the mapping writes it because UBL 2.1 has a place for it.
  • A general UBL 2.1 library writes every element and attribute it has a value for, whether or not EN 16931 uses it.
  • A mapping built for another UBL-based document, such as an order, a despatch advice or a national profile, is reused for Peppol BIS Billing.

How to fix it

  1. Stop writing cac:InvoiceLine/cac:Item/cac:ClassifiedTaxCategory/cbc:Name.
  2. If you need the information, keep it in your own records: EN 16931 has no business term for it, so a receiver has no agreed place to read it from.
  3. Validate again: the warning goes. If the element was the only thing in its parent, remove the parent too: Peppol refuses empty elements (PEPPOL-EN16931-R008).

Validate your corrected invoice

Before and after

These are fragments, not complete documents. The complete synthetic documents they come from are linked below.

Fragment of the invoice with the warning: Name in the line VAT information

<cac:ClassifiedTaxCategory>
  <cbc:ID>S</cbc:ID>
  <cbc:Name>Example</cbc:Name>
  <cbc:Percent>20</cbc:Percent>
  <cac:TaxScheme>
    <cbc:ID>VAT</cbc:ID>
  </cac:TaxScheme>
</cac:ClassifiedTaxCategory>

Fragment of the corrected invoice: the same lines without it

<cac:ClassifiedTaxCategory>
  <cbc:ID>S</cbc:ID>
  <cbc:Percent>20</cbc:Percent>
  <cac:TaxScheme>
    <cbc:ID>VAT</cbc:ID>
  </cac:TaxScheme>
</cac:ClassifiedTaxCategory>

The invoice with the warning has <cbc:Name>Example</cbc:Name> in the line VAT information, and the corrected invoice is the same document without it. It reports only this warning and is valid on every layer, so it would be accepted as it stands.

What the validator reported

Recorded on phive 12.1.0 / phive-rules-peppol 4.5.6 / Saxon-HE 12.10, the engine behind the free validator, using synthetic data. A recorded result is regression evidence for these documents; it is not a certification.

Where it applies

  • Applies to UBL Invoice and CreditNote alike, on invoice lines and credit note lines; the recorded example is an invoice.
  • The warning comes from the EN 16931 layer's rules for the UBL syntax. In the recorded example the schema layer passes: the element is valid UBL 2.1 and is only outside the EN 16931 model.

Scope and source

Written for Peppol BIS Billing 3.0.21 (May 2026), EN 16931 1.3.16, as applied to UBL 2.1 Invoice and CreditNote documents. Other profiles, syntaxes and releases can define this identifier differently. Guidance version 2026-09-29.1: source checked 2026-09-29, explanation last updated 2026-09-29.

The official definition of UBL-CR-597 carries the normative wording and test. This page is our explanation of it, not a copy.

Guidance does not change the engine verdict. Fixing this finding does not mean the document passes every layer, and validation does not certify legal or tax compliance or transmit a document over Peppol.