What is a price?

In the Bright Energy ecosystem, a price is a the combination of a value and a item type which can be valid for use in cost calculations. Supported types are listed in the response object[i].prices[i].type for Get products.

Examples:

Spot price where we will calculate the cost based on the consumption per hour with nordpool pricing:

...
"prices": [
  {
    "value": 0,
    "type": "spotkWh",
    "note": "calculationId",
    "name": "spotPrice",
    "validFrom": "2023-10-20T15:30:30+02:00",
    "validTo": "2024-10-20T00:00:00+02:00",
  }
]
...

kWh flat rate price where value* consumption for the time period will determine the cost:

...  
"prices": [  
  {  
    "value": 0.80,  
    "type": "kWh",  
    "note": "calculationId",  
    "name": "kWhPrice",  
    "validFrom": "2023-10-01T00:00:00+02:00",  
    "validTo": "2024-04-01T00:00:00+02:00",  
  }  
]  
...

The price can have a combination of validity properties attached to restrict when the price can be used, such as:

• a date range: validFrom+validTo
• specific hours in the day: validHours
• specific months in the year: validMonths
• specific parts of a measurement: validPart
• consumption thresholds: validThreshold.min, validThreshold.max and validThreshold.resolution

The price can have special rules when used in cost calculations:

• applied to a fraction of consumption: validFraction
• subtracts a value from the measurement used: subtractMeasurement

How prices should be used in cost calculations

When Get cost for a service is called each price associated with the product is checked against the validity properties to see if it should be included in the calculation. If the price is allowed to be used the cost can be calculated and returned.

If the price is not valid for the calculation and no other prices are associated with the product, the cost will be 0.

How many prices can a product have?

A product can have an unlimited number of prices associated.