How do I fix UBL-CR-320?

Ljubljana Osrednjeslovenska SI ; use cbc:CountrySubentity (BT-68) for province/state -->

Peppol BIS Billing 3.0 · rule

UBL-CR-320

Layer en16931·Checked against Peppol BIS Billing 3.0 2026.5

What does UBL-CR-320 mean? A UBL invoice should not include the TaxRepresentativeParty PostalAddress Region

Why did my invoice fail UBL-CR-320?

The invoice should not contain the Region element inside the tax representative's postal address (cac:TaxRepresentativeParty/cac:PostalAddress/cbc:Region). EN 16931 defines a fixed core set of address terms for the tax representative (BG-12), and Region is a UBL element that has no corresponding business term in that core model. Validators flag it so invoices stay restricted to the interoperable core data set.

Official rule text

A UBL invoice should not include the TaxRepresentativeParty PostalAddress Region

Common causes

An ERP or mapping tool exports its full internal address structure, including a region field, instead of only the EN 16931 address terms
Region data was placed in cbc:Region instead of the supported cbc:CountrySubentity (BT-68, province/state)
A generic UBL 2.1 template was reused without stripping elements outside the EN 16931 core

How do I fix it?

<cac:TaxRepresentativeParty>
  <cac:PostalAddress>
    <cbc:CityName>Ljubljana</cbc:CityName>
    <cbc:CountrySubentity>Osrednjeslovenska</cbc:CountrySubentity>
    <cac:Country><cbc:IdentificationCode>SI</cbc:IdentificationCode></cac:Country>
  </cac:PostalAddress>
</cac:TaxRepresentativeParty>
<!-- remove <cbc:Region>; use cbc:CountrySubentity (BT-68) for province/state -->

Check your invoice against this rule

Paste it into the live demo, or call POST /v1/validate. See the quickstart.