# Australian retail tariff catalogue — 2026-06-20

Release `2026-06-20-v0.2.0` is a source-normalised export of the AER Consumer Data Right product-reference catalogue stored by `ene_plans`. It contains tariff inputs only: **no simulated annual bills, consumption assumptions, load traces, or market percentiles**.

## Start here

- Use `catalogue/tariff_plans.csv` to select plans.
- Read `annual_bill_calculation_guide.md` before applying a load profile or calculating bills.
- Use `data_dictionary.csv` for field definitions.
- See the folder map below for navigation.

## Quick filters

For mainstream residential electricity market offers, start in `catalogue/tariff_plans.csv` with:

```text
customer_type = RESIDENTIAL
fuel_type = ELECTRICITY
plan_type = MARKET
is_mainstream_candidate = true
```

Then join other files using:

```text
snapshot_date + retailer_slug + plan_id + jurisdiction + distributor
```

For flat or block single-rate products add:

```text
pricing_model = SINGLE_RATE
```

For time-of-use products add:

```text
pricing_model = TIME_OF_USE
```

Useful exclusions for a standard customer:

```text
has_demand_charge = false
has_controlled_load = false
is_solar_specific = false
is_restricted_name = false
```

These name-derived flags are screening aids, not substitutes for reviewing `catalogue/tariff_eligibility.csv` and plan terms.

## Files and folders

| File | One row represents |
|---|---|
| `catalogue/tariff_plans.csv` | One plan × distributor/jurisdiction |
| `catalogue/tariff_periods.csv` | One tariff period × plan × distributor |
| `catalogue/tariff_rates.csv` | One usage-rate row/window × tariff period × plan × distributor |
| `catalogue/tariff_discounts.csv` | One advertised discount × plan × distributor |
| `catalogue/tariff_eligibility.csv` | One eligibility rule × plan × distributor |
| `availability/plan_postcode_availability.csv` | One plan × postcode × distributor |
| `catalogue/tariff_fees.csv` | One fee × plan × distributor |
| `catalogue/tariff_incentives.csv` | One incentive × plan × distributor |
| `specialist-pricing/demand_charges.csv` | One demand-charge rule × plan × distributor |
| `specialist-pricing/controlled_load_rates.csv` | One controlled-load rate × plan × distributor |
| `specialist-pricing/controlled_load_tou_rates.csv` | One controlled-load TOU window/rate × plan × distributor |
| `specialist-pricing/solar_feed_in_tariffs.csv` | One flat solar FIT row × plan × distributor |
| `specialist-pricing/solar_fit_time_varying.csv` | One time-varying FIT window × plan × distributor |
| `specialist-pricing/green_power_charges.csv` | One green-power charge × plan × distributor |
| `specialist-pricing/metering_charges.csv` | One metering charge × plan × distributor |
| `reference/retailers.csv` | One retailer reference record |
| `data_dictionary.csv` | One exported column definition |
| `manifest.json` | Release provenance, coverage, row counts and hashes |

## Price and GST caution

Numeric prices are preserved in the AER-derived source units. No GST conversion has been applied. The source does not provide a reliable row-level GST flag in these normalised tables, so consumers must verify GST treatment against AER/CDR documentation or plan terms before financial modelling.

## Coverage

- ACT: 6,005 plan/distributor rows; 22 retailers
- NSW: 11,497 plan/distributor rows; 27 retailers
- QLD: 7,020 plan/distributor rows; 27 retailers
- SA: 1,266 plan/distributor rows; 27 retailers
- TAS: 140 plan/distributor rows; 4 retailers
- VIC: 12,722 plan/distributor rows; 25 retailers

## Important structure

A plan listed in many postcodes appears once per distributor in `catalogue/tariff_plans.csv`; postcode-level availability is retained separately. One retailer may publish many distinct plans. Discounts, rates, fees and eligibility rules are one-to-many child tables and therefore remain separate.

## Folder navigation

| Location | Contents |
|---|---|
| `catalogue/` | Core plans, periods, rates, discounts, eligibility, fees, and incentives |
| `availability/` | Plan-to-postcode availability |
| `specialist-pricing/` | Demand, controlled load, solar FIT, green power, and metering |
| `reference/` | Retailer reference data |
| `annual_bill_calculation_guide.md` | Workflow for pricing annual interval profiles and producing market distributions |
