{
  "id": "BR-CO-22",
  "country": "EU",
  "syntax": "ubl",
  "group": "document",
  "severity": "fatal",
  "severity_note": "fatal, from the Flag column of the Peppol BIS Billing 3.0 UBL rules index retrieved 2026-10-18.",
  "spec": "Peppol BIS Billing 3.0, May 2026 release, EN 16931 model bound to UBL",
  "statement": "Each Document level charge (BG-21) shall contain a Document level charge reason (BT-104) or a Document level charge reason code (BT-105), or both.",
  "statement_lang": "en",
  "context": "/ubl:Invoice/cac:AllowanceCharge[cbc:ChargeIndicator = true()] | /cn:CreditNote/cac:AllowanceCharge[cbc:ChargeIndicator = true()]",
  "test": "exists(cbc:AllowanceChargeReason) or exists(cbc:AllowanceChargeReasonCode)",
  "meaning": "Each Document level charge (BG-21) must contain a Document level charge reason (BT-104) or a Document level charge reason code (BT-105), or both. The statement says \"shall contain\", not \"shall have\", and it ends with a period. The context writes ChargeIndicator = true() with spaces around =. The published test is exists on the reason or exists on the reason code.",
  "fix": "On each document-level charge, send a Document level charge reason (BT-104), a Document level charge reason code (BT-105), or both.",
  "example_fail": "A document-level charge has neither a reason nor a reason code.",
  "example_pass": "A document-level charge has a reason code and no reason.",
  "example_note": "Illustration of the condition in the official statement. Not an example published by the source.",
  "source_url": "https://docs.peppol.eu/poacc/billing/3.0/rules/ubl-tc434/BR-CO-22/",
  "source_retrieved": "2026-10-18",
  "last_verified": "2026-10-18"
}