Rule reference

BR-CO-19 The invoice carries an invoicing period (BG-14) with neither a start date (BT-73), an end date (BT-74) nor a tax point date code (BT-8)

The invoice carries an invoicing period (BG-14) with neither a start date (BT-73), an end date (BT-74) nor a tax point date code (BT-8). An empty period asserts that the supply relates to a timeframe and then declines to say which — and the timeframe is what a periodic invoice is *for*: it is how the buyer accrues the cost to the right month and how both sides detect a gap or an overlap between consecutive invoices. Note that a period carrying only the description code is legal in the UBL binding, because BT-8 has nowhere else to live; a period carrying nothing at all is not.

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-14
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-CO-19",
  "field": "BG-14",
  "severity": "fatal",
  "message": "The invoice carries an invoicing period (BG-14) with neither a start date (BT-73), an end date (BT-74) nor a tax point date code (BT-8). An empty period asserts that the supply relates to a timeframe and then declines to say which — and the timeframe is what a periodic invoice is *for*: it is how the buyer accrues the cost to the right month and how both sides detect a gap or an overlap between consecutive invoices. Note that a period carrying only the description code is legal in the UBL binding, because BT-8 has nowhere else to live; a period carrying nothing at all is not.",
  "fix": "Set invoicingPeriod.startDate, invoicingPeriod.endDate, or both, as ISO dates. Remove the invoicingPeriod object entirely if the supply is a one-off with a delivery date (BT-72) rather than a period.",
  "example": "\"invoicingPeriod\": { \"startDate\": \"2026-07-01\", \"endDate\": \"2026-07-31\" }",
  "xpath": "/ubl:Invoice/cac:InvoicePeriod",
  "docsUrl": "https://attestwire.com/rules/BR-CO-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
"invoicingPeriod": { "startDate": "2026-07-01", "endDate": "2026-07-31" }

The fix

Set invoicingPeriod.startDate, invoicingPeriod.endDate, or both, as ISO dates. Remove the invoicingPeriod object entirely if the supply is a one-off with a delivery date (BT-72) rather than a period.

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