Peppol BIS Billing 3.0 · rule

UBL-CR-319

Layer en16931·Checked against Peppol BIS Billing 3.0 2026.5

What does UBL-CR-319 mean? A UBL invoice should not include the TaxRepresentativeParty PostalAddress CountrySubentityCode

Why did my invoice fail UBL-CR-319?

cbc:CountrySubentityCode inside cac:TaxRepresentativeParty/cac:PostalAddress should not be included: EN 16931 carries the country subdivision (BT-68) as text in cbc:CountrySubentity, not as a code.

Official rule text

A UBL invoice should not include the TaxRepresentativeParty PostalAddress CountrySubentityCode

Common causes

Region/state codes (e.g. ISO 3166-2) mapped to CountrySubentityCode instead of the text element
Generic address serialization emitting both text and code

How do I fix it?

<cac:PostalAddress>
  <cbc:CityName>Sevilla</cbc:CityName>
  <cbc:PostalZone>41092</cbc:PostalZone>
  <cbc:CountrySubentity>Andalucia</cbc:CountrySubentity>
  <cac:Country><cbc:IdentificationCode>ES</cbc:IdentificationCode></cac:Country>
</cac:PostalAddress>

Check your invoice against this rule

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