Repository navigation
Provider New Zealand
All providers · Tariff periods · Configuration index
Choose this provider during initial setup, or open Settings > Devices & Services > PowerSync > Configure > Electricity pricing & provider to change its settings. Use the written plan for your site and account; examples are not a substitute for your contract.
Static time-of-use pricing for NZ electricity retailers. No API token required — rates are entered during setup from your plan details. All rates in NZD cents per kWh.
| Retailer | Plan | Key Feature |
|---|---|---|
| Octopus Energy NZ | Standard TOU | 3-tier peak/shoulder/off-peak with TOU export rates |
| Electric Kiwi | Standard TOU | 3-tier pricing (Hour of Power selected via Electric Kiwi app) |
| Contact Energy | Good Weekends | Free electricity on weekends |
| Contact Energy | Good Nights | Free electricity 9pm-midnight every night |
| Contact Energy | Good Charge | EV-focused with cheap overnight rate |
| Custom NZ TOU | Any plan | Enter your own rates for any NZ retailer |
Standard NZ TOU periods (used by most retailers):
| Period | Weekdays | Weekends |
|---|---|---|
| Peak | 7-9am, 5-9pm | — |
| Shoulder | 9am-5pm | 7am-9pm |
| Off-Peak | 9pm-7am | 9pm-7am |
- Select New Zealand TOU as your electricity provider
- Choose your retailer (or Custom for any NZ plan)
- Select your distribution zone (Vector, Wellington, Orion, Powerco, Unison, Aurora, or Other)
- Review and adjust the pre-filled rates for your plan (or enter rates manually for Custom)
- Peak, Shoulder, Off-Peak import rates (NZD c/kWh)
- Peak and Off-Peak export rates (NZD c/kWh)
- If you use Cost Neutral, enter Daily Supply Charge under Configure > Smart Optimization > Core Goals in NZD per day.
| Zone | Region |
|---|---|
| Vector | Auckland |
| Wellington Electricity | Wellington |
| Orion | Canterbury |
| Powerco | Waikato / Taranaki / Manawatu |
| Unison | Hawke's Bay / Rotorua / Taupo |
| Aurora | Otago / Southland |
| Other | Any other network area |
- Rates are stored as a time-of-use tariff schedule
- The Smart Optimizer uses your TOU rates to calculate optimal charge/discharge schedules, with weekday-only peaks handled automatically
- If you have a Tesla Powerwall, the TOU schedule is synced to the Powerwall for native tariff-aware behaviour
- Rates can be updated anytime via the integration options flow (Settings > Devices & Services > PowerSync > Configure)
- Electric Kiwi Hour of Power is not modelled in the TOU schedule — select your free hour via the Electric Kiwi app as usual
- Contact Good Weekends uses a 0 c/kWh rate for all weekend hours — the optimizer will prefer weekend consumption
- Contact Good Nights uses a 0 c/kWh rate for 9pm-midnight — the optimizer may shift load to this window
- Template rates are approximate starting points — always verify against your actual plan rates
Check the current import/export price and tariff schedule for the selected site and local time. On a menu-entered edit, saving provider settings can finish the flow directly; specialist settings remain under Advanced settings. Token/account success, an imported schedule and a hardware command are different outcomes. If rates or the site are wrong, reopen pricing rather than changing battery connection settings.
The tables use the current form labels and help text. They list the conditional field union: a field can be hidden for a different battery, provider, route or available integration. The instructions above explain those conditions. Existing saved/discovered values take precedence over fresh fallbacks. Rate units follow the provider; check the displayed currency/energy unit.
| Field | Meaning / input | Fallback / limits |
|---|---|---|
| Retailer | Your NZ electricity retailer. Rates are pre-filled from the selected plan. | Fallback octopus_nz |
| Distribution zone | Your local network distribution zone. Check your electricity bill if unsure. | Fallback vector |
| Field | Meaning / input | Fallback / limits |
|---|---|---|
| Retailer | Your NZ electricity retailer. Rates are pre-filled from the selected plan. | Saved/detected value or the form’s shown fallback |
| Distribution zone | Your local network distribution zone. Check your electricity bill if unsure. | Saved/detected value or the form’s shown fallback |
| Peak rate | Weekday peak rate (typically 7-9am and 5-9pm). | 0–200; step 0.1 |
| Shoulder rate | Weekday daytime and weekend daytime rate. | 0–200; step 0.1 |
| Off-peak rate | Overnight rate (typically 9pm-7am). | 0–200; step 0.1 |
| Peak export rate | Export rate during peak periods. | 0–100; step 0.1 |
| Off-peak export rate | Export rate during off-peak periods. | 0–100; step 0.1 |
| Daily supply charge | Fixed daily supply charge from your retailer. | 0–1000; step 0.1 |