Rule reference

BR-19 The invoice carries a seller tax representative group (BG-11), so it must carry the representative's postal address (BG-12)

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.

This rule is implemented and its error payload below is real, but the long-form write-up — normative text, worked example, divergence note — is not written yet. Everything the library knows about this rule is on this page. Ask and we will prioritise it.

Business term
BG-12
Severity
fatal

What the library returns

The exact object in result.errors when this rule fires. Generated by running @attestwire/en16931, not transcribed:

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 locates the element in the generated UBL document, which is where a KoSIT or Peppol validator will report the same problem.

A passing value

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

The fix

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

Arrived from a stack trace? The docsUrl on every error links straight here. Something wrong on this page — tell us.