BILLRESERVETRADERRECOVERY
Provides details of the RERT Recovery Amount for the Market Customers.
Column Schema
BILLRUNNO
Billing posted run number
SQL Type: NUMBER(3,0)
Polars Type: pl.UInt16
This column is mandatory, and a primary key.
CONTRACTYEAR
Billing contract year
SQL Type: NUMBER(4,0)
Polars Type: pl.UInt16
This column is mandatory, and a primary key.
PARTICIPANTID
Participant identifier.
For more information, see the dedicated documentation page.
SQL Type: VARCHAR2(20)
Polars Type: pl.Categorical
This column is mandatory, and a primary key.
PAYMENT_ID
RERT payment number
SQL Type: NUMBER(3,0)
Polars Type: pl.Int16
This column is mandatory, and a primary key.
PUBLICATION_ID
Unique Publication Identifier for RERT Payment
SQL Type: VARCHAR2(40)
Polars Type: str
This column is mandatory, and a primary key.
REGIONID
Region from which the amount is recovered
For more information, see the dedicated documentation page.
The SQL type is VARCHAR2(20).
This is actually a factor/enum, with values:
-
QLD1 -
VIC1 -
TAS1 -
NSW1 -
SA1 -
SNOWY1
This column is mandatory, and a primary key.
WEEKNO
Billing week number
Warning
There may be 53 weeks in a year, depending on how weeks align to the year start/end.
SQL Type: NUMBER(3,0)
Polars Type: pl.UInt16
This column is mandatory, and a primary key.
ELIGIBILITY_END_INTERVAL
Ending Period of RERT Recovery for Usage Payments
SQL Type: DATE
Polars Type: pl.Datetime()
This column is not mandatory.
Example: 2026/01/20 00:05:00
ELIGIBILITY_START_INTERVAL
Starting Period of RERT Recovery for Usage Payments
SQL Type: DATE
Polars Type: pl.Datetime()
This column is not mandatory.
Example: 2026/01/20 00:05:00
EXCLUDED_ENERGY
The Energy Value (Scheduled Loads) that is excluded
SQL Type: NUMBER(18,8)
Polars Type: pl.Float64
This column is not mandatory.
PARTICIPANT_ACE_MWH
The Participant ACE MWh Value used in the Recovery of the RERT Amount. NULL for Billing Week prior to the IESS rule effective date
SQL Type: NUMBER(18,8)
Polars Type: pl.Float64
This column is not mandatory.
PARTICIPANT_DEMAND
Participant Demand Value used for RERT Recovery. NULL for Billing Week post the IESS rule effective date.
SQL Type: NUMBER(18,8)
Polars Type: pl.Float64
This column is not mandatory.
PAYMENT_AMOUNT
RERT payment amount
SQL Type: NUMBER(18,8)
Polars Type: pl.Float64
This column is not mandatory.
RECOVERY_AMOUNT
Recovery Amount applicable for each Market Customer
SQL Type: NUMBER(18,8)
Polars Type: pl.Float64
This column is not mandatory.
REGION_ACE_MWH
The Region ACE MWh Value used in the Recovery of the RERT Amount. NULL for Billing Week prior to the IESS rule effective date
SQL Type: NUMBER(18,8)
Polars Type: pl.Float64
This column is not mandatory.
REGION_DEMAND
Region Demand Value used for RERT Recovery. NULL for Billing Week post the IESS rule effective date.
SQL Type: NUMBER(18,8)
Polars Type: pl.Float64
This column is not mandatory.
New Data Timing
Populated by the posting of a billing run, being several times each week
Code Examples
Polars
Casting is enums, categoricals etc is not essential, but may speed up parsing.
Swapping int for pl.UInt16, pl.Int32 would also speed up parsing. However some of the datatypes are inferred, so they may be wrong.
This code deduplicates for you. Deduplication is normally only required across multiple months.
This code assumes that all columns are present, which may not be true for older files.
import polars as pl
import polars.selectors as cs
# e.g. "2029/03/15 00:05:00"
dt_s_fmt = "%Y/%m/%d %H:%M:%S"
csv_paths = ["SOMEFILE.CSV", "OTHERFILE.CSV"]
lf = (
pl.concat(
[
pl.scan_csv(
csv_path, # must be unzipped beforehand
skip_rows=1, # skip the header
infer_schema=False, # much faster
)
.filter(cs.by_index(0) == "D") # drop the footer
.select(~cs.by_index(range(4))) # drop metadata columns
for csv_path in csv_paths
],
how="diagonal_relaxed",
)
.with_columns(
pl.col("ELIGIBILITY_END_INTERVAL", "ELIGIBILITY_START_INTERVAL").str.strptime(
pl.Datetime, dt_s_fmt
),
)
.cast(
{
"BILLRUNNO": int, # or pl.UInt16
"CONTRACTYEAR": int, # or pl.UInt16
"PARTICIPANTID": pl.Categorical,
"PAYMENT_ID": int, # or pl.Int16
"PUBLICATION_ID": str,
"REGIONID": pl.Enum(["QLD1", "VIC1", "TAS1", "NSW1", "SA1", "SNOWY1"]),
"WEEKNO": int, # or pl.UInt16
"EXCLUDED_ENERGY": pl.Float64,
"PARTICIPANT_ACE_MWH": pl.Float64,
"PARTICIPANT_DEMAND": pl.Float64,
"PAYMENT_AMOUNT": pl.Float64,
"RECOVERY_AMOUNT": pl.Float64,
"REGION_ACE_MWH": pl.Float64,
"REGION_DEMAND": pl.Float64,
}
)
# Deduplicate
# We want one row per ['BILLRUNNO', 'CONTRACTYEAR', 'PARTICIPANTID', 'PAYMENT_ID', 'PUBLICATION_ID', 'REGIONID', 'WEEKNO']
.unique(
subset=[
"BILLRUNNO",
"CONTRACTYEAR",
"PARTICIPANTID",
"PAYMENT_ID",
"PUBLICATION_ID",
"REGIONID",
"WEEKNO",
],
keep="any",
)
)
Nemosis
This table is not yet available in Nemosis.
Availability
Visibility: Private
This table is not available in the public monthly MMSDM archive. Is is only available to registered market participants over FTP inside a VPN.
Deduplication and PDR Loader Configuration
The primary keys are:
The transaction type is "insert", which means that you will usually not see duplicate data. If you do, you can deduplicate based on the primary keys, without sorting first. Rows from different files with the same primary keys should have the same values.
| Report Name | Report Subtype | Version |
|---|---|---|
| BILLING | RESERVETRADERRECOVERY | 3 |
This means that the CSV files start with metadata columns:
Links
This page as JSON (schema documented here, but may change)
Download a JSON Schema specification for this table.
Official AEMO schema documentation
Other Information
Package: BILLING_RUN