Skip to content
SPARK

Reporting guidelines

Each report you send corresponds to a specific event, but you can send energy usage for multiple resources and locations in the same report if they have reacted to the same event.

Each price curve event will contain a list of targets, which includes the resource id and location id of the resources that should react to the event. You should only send reports for the resources that are included in the event.

Best practice

  • Frequency: You must send a report for each event that your energy resource has reacted to. Preferably do not split the report partaining to a specific event into multiple reports.
  • Timeframe: The report should preferably be sent within the same day after the event has ended, or next day. Ensure you do not send reports later than months end, or this will not be compensated.
  • Data: Each report can contain multiple energy usage payloads, one for each resource and location that has reacted to a specific event. Each payload must contain the ResourceId of the resource, and LocationId that that energy usage occurred at. You need only report the specific hours that the event supplied an incentive for.
  • Energy usage unit: Each energy usage datapoint must report the energy usage in kWh.
  • Energy usage timestamp: The energy usage must be reported with a timestamp which corresponds to price curve timestamps, and the timestamp must be in UTC. Currently each price curve point is 1 hour long, and the timestamp should be the start of the hour.
  • Energy usage resolution: The energy usage must be reported with a resolution of 1 hour. If you have a higher or lower resolution, you must aggregate the data to 1 hour.