How do I fix UBL-CR-312?

Main Street 42 Ljubljana 1000 SI

Peppol BIS Billing 3.0 · rule

UBL-CR-312

Layer en16931·Checked against Peppol BIS Billing 3.0 2026.5

What does UBL-CR-312 mean? A UBL invoice should not include the TaxRepresentativeParty PostalAddress BuildingNumber

Why did my invoice fail UBL-CR-312?

cbc:BuildingNumber inside cac:TaxRepresentativeParty/cac:PostalAddress is not part of the EN 16931 address model; the house number should be included in cbc:StreetName rather than as a separate element.

Official rule text

A UBL invoice should not include the TaxRepresentativeParty PostalAddress BuildingNumber

Common causes

Street and house number stored as separate fields and mapped to separate elements
Generic UBL address serialization

How do I fix it?

<cac:PostalAddress>
  <cbc:StreetName>Main Street 42</cbc:StreetName>
  <cbc:CityName>Ljubljana</cbc:CityName>
  <cbc:PostalZone>1000</cbc:PostalZone>
  <cac:Country><cbc:IdentificationCode>SI</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.