AttestwireRule referenceBR-19

BR-19 A seller tax representative must have a postal address

noun · EN 16931 · fatal · BG-12

For a sample invoice, the library reports: The invoice carries a seller tax representative group (BG-11), so it must carry the representative's postal address (BG-12).

Business term
BG-12
Severity
fatal

The fix

Set taxRepresentative.address with at least city, postalCode and countryCode — the same PostalAddress shape the seller and buyer use.

A passing value

the shape this field expects
"taxRepresentative": { "name": "Fiscal Rep France SARL", "vatId": "FR12345678901", "address": { "city": "Lyon", "postalCode": "69001", "countryCode": "FR" } }

What the library returns

The full error returned by @attestwire/en16931. It includes the rule ID, affected field and suggested correction. Developers can use this object in their application:

TeachingError
{
  "rule": "BR-19",
  "field": "BG-12",
  "severity": "fatal",
  "message": "The invoice carries a seller tax representative group (BG-11), so it must carry the representative's postal address (BG-12). The address is not contact decoration: it is the evidence of *where* the representative is established, and therefore which tax administration the representation is effective in. A representative with no address cannot be shown to be established in the member state whose VAT is being accounted for.",
  "fix": "Set taxRepresentative.address with at least city, postalCode and countryCode — the same PostalAddress shape the seller and buyer use.",
  "example": "\"taxRepresentative\": { \"name\": \"Fiscal Rep France SARL\", \"vatId\": \"FR12345678901\", \"address\": { \"city\": \"Lyon\", \"postalCode\": \"69001\", \"countryCode\": \"FR\" } }",
  "xpath": "/ubl:Invoice/cac:TaxRepresentativeParty/cac:PostalAddress",
  "docsUrl": "https://attestwire.com/rules/BR-19"
}

xpath is always a UBL path. On a CII invoice, look for the matching CII field instead.