Introduction

Copy linkKey Concepts

Copy linkTariffs

A tariff holds timestamped rate data — a timeseries of prices over time. You create a tariff specifying its currency and unit, then push rate data to it via the API. Each data point defines the rate from its timestamp until the next data point.

Tariffs are the building blocks of the pricing model. You might have separate tariffs for energy costs, grid fees, and spot prices, each managed independently.

Copy linkDirection

Every tariff has a direction: import or export.

• Import tariffs represent the cost of consuming electricity from the grid.
• Export tariffs represent the earnings from selling electricity back to the grid (feed-in).

A location can have separate formulas for each direction.

See the Tariffs guide for details.

Copy linkFormulas

A formula at the location level defines how tariffs combine into a final rate. You assign variable names to tariff IDs, then write an expression like spot + grid + 0.02 or max(spot, 0) * markup + base. The system evaluates the formula at each point in time to produce a resolved tariff timeseries.

See the Formulas & Resolved Tariffs guide for details.

Copy linkSetup Patterns

Copy linkShared Tariffs Across Locations

When many customers are on the same pricing plan, you create tariffs once and reference them from every location's formula.

For example, a retailer offers a standard plan with fixed energy pricing and a flat grid fee. They create an energy tariff and a grid fee tariff, pushing rate data to each. Every customer location gets a formula that references these same tariff IDs.

When rates change, the retailer pushes new data to the shared tariff. Every location automatically picks up the new rates. No per-location updates needed.

This pattern works well when:

• A retailer has a standard plan offered to many customers
• Grid fees are the same across a region
• You want rate changes to propagate automatically to all affected locations

Copy linkIndividual Tariffs Per Location

When different customer segments have different pricing, you create tariffs for each segment and reference the appropriate ones from each location's formula.

For example, a retailer offers multiple residential plans — a "green" plan with different pricing and a "standard" plan with a simpler pricing structure. They create separate energy tariffs for each plan. When a household enrolls in the green plan, their location's formula references the green tariff.

You can also mix shared and individual tariffs in the same formula. A location might use a shared grid fee tariff (same for everyone in a region) combined with a plan-specific energy tariff. The formula at the location level ties them together.

This pattern works well when:

• Different customer segments have different pricing plans
• Households can switch between plans, requiring only a formula update at the location
• Some tariff components are shared (grid fees) while others vary by plan (energy rates)