Tariff Comparison

There will probably be times when you'll want to know if you're on the right tariff for you financially.

The tariff comparison allows you to elect a new tariff which will generate some additional sensors which will show the cost of your elected meter against that tariff.

After you've configured your account, you'll be able to configure tariff comparison sensors. These are configured by adding subsequent instances of the integration going through the normal flow, and selecting Tariff Comparison in the provided menu.

Info

When updating the tariff depending on what previous consumption data is available, it can take up to 24 hours to update the cost. This will be improved in the future.

Setup

Meter

This is the meter whose consumption will be used as the basis for the calculation.

Product Code

To find the product code, you can use the Octopus Energy API to search for current home or business products. Once your target product has been found, you will want to set this value to the value of the code property in the list of products.

For example if I wanted to check Flexible Octopus November 2022 v1. I would look up all of the products and look for my target under full_name or display_name.

I would then set my product code to VAR-22-11-01.

Tariff Code

To find the tariff code, you can use the Octopus Energy API to search for the available tariffs for your target product.

For example if I wanted to check Flexible Octopus November 2022 v1. I would look up all of the products and look for my target under full_name or display_name. I would then look up the product by taking the value specified in the code field and putting it at the end of the products url. Alternatively, you can follow the link that is present in the product listing.

In this scenario, the code is VAR-22-11-01 and so the product url is https://api.octopus.energy/v1/products/VAR-22-11-01. From this list, I would then look up the tariff for my region (e.g. A defined at the end of my current tariff) which is defined in the code field. Once your target tariff has been found, you will want to set this property in the configuration to the value of the code property. In this example, I want the duel electricity tariff version, so will pick E-2R-VAR-22-11-01-A.

Entities

The following entities will be available for each entry

Cost Override

sensor.octopus_energy_electricity_{{METER_SERIAL_NUMBER}}_{{MPAN_NUMBER}}_previous_accumulative_cost_{{TARIFF COMPARISON NAME}} for electricity based meters; sensor.octopus_energy_gas_{{METER_SERIAL_NUMBER}}_{{MPRN_NUMBER}}_previous_accumulative_cost_{{TARIFF COMPARISON NAME}} for gas based meters.

This will display the cost of your previous accumulative consumption against the elected tariff.

Info

These sensors will compare the same time period as the electricity previous accumulative consumption or gas previous accumulative consumption.

If you have changed the offset, then this sensor will use the same offset.

Previous Consumption Override Day Rates

event.octopus_energy_electricity_{{METER_SERIAL_NUMBER}}_{{MPAN_NUMBER}}_previous_consumption_rates_{{TARIFF COMPARISON NAME}} for electricity based meters; event.octopus_energy_gas_{{METER_SERIAL_NUMBER}}_{{MPRN_NUMBER}}_previous_consumption_rates_{{TARIFF COMPARISON NAME}} for gas based meters.

The state of this sensor states when the previous consumption tariff comparison rates were last updated. The attributes of this sensor exposes the previous consumption tariff comparison rates.

Note

This is disabled by default.

Info

These sensors will provide rates for the same time period as the electricity previous accumulative consumption or gas previous accumulative consumption.

If you have changed the offset, then this sensor will use the same offset.

Attribute	Type	Description
rates	array	The list of rates applicable for the previous consumption tariff comparison
product_code	string	The product code associated with previous consumption tariff comparison rates
tariff_code	string	The tariff code associated with previous consumption tariff comparison rates

Each rate item has the following attributes

Attribute	Type	Description
start	datetime	The date/time when the rate starts
end	datetime	The date/time when the rate ends
value_inc_vat	float	The value of the rate including VAT. This is in pounds and pence (e.g. 1.01 = £1.01)
is_capped	boolean	Indicates if the rate has been capped by a configured price cap
is_intelligent_adjusted	boolean	Indicates if the rate has been adjusted due to a dispatch organised by an intelligent tariff