Constraints

Column type
Dimension
Feature level
Mandatory
Allows nulls
No
Data type
String
Value format
Allowed values
Dataset
Billing Period

Description

Billing Period Status represents the state of the billing period (i.e., "Open" or "Closed"). This status helps FinOps practitioners determine if the Cost and Usage and Invoice Detail data for a given period is preliminary and subject to change, or if all anticipated invoices have been issued and the delivered data is finalized and ready for formal financial reporting and showback/chargeback processes.

Requirements

BillingPeriodStatus MUST adhere to the following requirements:

  • BillingPeriodStatus MUST be of type String.
  • BillingPeriodStatus MUST NOT be null.
  • BillingPeriodStatus MUST be one of the allowed values.
  • BillingPeriodStatus MUST represent the state of the billing period identified by BillingPeriodStart and BillingPeriodEnd.
  • BillingPeriodStatus MUST NOT be "Open" following a previous status of "Closed", except when explicitly requested or approved by the customer.

Implementation guidance

While the transition from "Open" to "Closed" typically signifies the end of a billing cycle, in scenarios such as the following, it may be necessary to provide corrections to closed billing periods:

  • Retroactive adjustments: an invoice issuer generates credits or corrections for a period previously marked as finalized.
  • Audit corrections: discrepancies are discovered during financial reconciliation that require the data to be re-processed.
  • Late-arriving usage: occasional delays in usage reporting necessitate a revision of the final invoice.

Corrections to closed billing periods are generally represented in the context of a subsequent open billing period to preserve historical financial accuracy and ensure transparent tracking. Exceptionally, a previously closed billing period may be reopened to apply such corrections, but this transition from "Closed" to "Open" must be explicitly requested or approved by the customer to maintain auditability and the integrity of financial reporting.

Corrections that do not impact the integrity of the closed billing period, such as informational or metadata updates, are allowed regardless of Billing Period Status.

FinOps tools and reporting engines should be designed to detect Billing Period Status transitions and corrections to closed billing periods, and trigger updates to downstream processes (e.g., cost allocation, chargeback, reporting) to ensure financial accuracy.

For more information, please see the Invoice and Billing Period Handling appendix and the Correction Handling attribute.

Read the source on focus.finops.org ↗