Billing Data Version History

The following table lists updates to the billing data specification by version number and date. The latest version number should be used in the file name that you send to Oracle Utilities. See Billing Data File Name Conventions for more information.

Update Specification Version Number Date

Update service_quantity_identifier column in Service Quantity Fields to include NET_USAGE as an example value.

v2-0-3

06/27/2025

Update bill_cycle_code column in Bill Segment Fields to say it is no longer required but is preferred. Remove premise_id from Bill Segment Fields. Update bill_line_item_type in Bill Line Item Fields to say it is no longer required but is preferred. Delete note about premise_id from File Format section. Update File Naming Conventions to be clearer about file name length limit and what file name components are required.

v2-0-2

04/11/2022

Update examples in File Name Conventions to use incremented major version number and current year.

v2-0-1

12/06/2021

Increment to a major version number to designate Billing Data Transfer as a core data standard for utilities. Update other sections to reflect that utilities can send four separate billing data files, rather than a single file. (For example, the File Name Conventions section includes new file names for the four files.) Delete appears_in_summary from Line Item Fields, as it is no longer supported. Clarify that zip files should only contain one file each.

v2-0-0

11/23/2021

Update definition of total_bill_corrections in Bill Fields. Add appears_in_summary back to Line Item Fields. v1-4-0 09/14/2021

Update supported version number for DataConnect extracts.

v1-3-0

07/28/2021

Update the definition of bill segments in Bill Segment Fields. Remove appears_in_summary from Line Item Fields.

v1-2-0

01/25/2021

Update service_quantity_identifier description in Service Quantity Fields to show additional example values.

v1-1-0

10/09/2020

Update multiple field descriptions to improve clarity. Update introductory topics to simplify explanations and improve cross-references. Add new information about common data formats. For a more detailed list of changes, contact your Delivery Team.

v1-0-0

05/14/2020

Initial draft of billing data file specification.

v0-9-0

11/12/2019