This page summarises the customer’s connected tariffs. The customer can review connection details, report issues, or disconnect tariffs. It’s the final step in a new connection flow. Returning customers with existing tariffs land here directly when starting Connect session, instead of the Provider Selection page.Documentation Index
Fetch the complete documentation index at: https://docs.flatpeak.com/llms.txt
Use this file to discover all available pages before exploring further.
- Overview
- Settings
- Connection Error
- Pending Issue Report
- Code
Tapping a connected tariff opens this sheet, where the customer can report an issue with the tariff or disconnect it from their account.
Shown when Connect cannot retrieve the customer’s tariff data. The customer can retry or disconnect.
Shown when the customer has an open issue report on a tariff. They can add more details or withdraw the report from this sheet.
{
"connect_token": "cot_6587fa4362341be5b524de3b",
"route": "tariff_summary",
"timezone": "Europe/London",
"currency_code": "GBP",
"live_mode": true,
"actions":
[
"DISCONNECT",
"CHANGE",
"RETRY",
"CREATE_ISSUE_REPORT",
"UPDATE_ISSUE_REPORT",
"CANCEL_ISSUE_REPORT",
"CLOSE",
"BACK"
],
"tariff_status":
{
"commodity_import":
{
"status": "CONNECTED",
"tariff_id": "trf_66ba584eb6923d7c3b942ef6",
"connection_type": "DIRECT",
"market_rates_source": true,
"tiered": false,
"display_name": "Agile Octopus v3 2024",
"is_temporary": false,
"provider":
{
"id": "prv_63a6087272921ef075a8fd3e",
"display_name": "Octopus Energy",
"logo_url": "https://s.flatpeak.com/83b06a60e38c2.png"
},
"prices":
{
"yesterday":
[],
"today":
[
{
"valid_from": "2024-02-01T00:00:00+02:00",
"valid_to": "2024-02-01T22:00:00+02:00",
"price":
{
"value": 0.12,
"vat": 1.19,
"confidence": 1
}
},
{
"valid_from": "2024-02-01T22:00:00+02:00",
"valid_to": "2024-02-01T00:00:00+02:00",
"price":
{
"value": 0.09,
"vat": 1.19,
"confidence": 1
}
}
],
"tomorrow":
[
{
"valid_from": "2024-02-02T00:00:00+02:00",
"valid_to": "2024-02-02T06:00:00+02:00",
"price":
{
"value": 0.09,
"vat": 1.19,
"confidence": 1
}
},
{
"valid_from": "2024-02-02T06:00:00+02:00",
"valid_to": "2024-02-03T00:00:00+02:00",
"price":
{
"value": 0.12,
"vat": 1.19,
"confidence": 1
}
}
]
}
},
"commodity_export":
{
"status": "ERROR_REPORTED",
"id": "trf_66fa584eb6923d7c3b942ef8",
"connection_type": "DIRECT",
"market_rates_source": true,
"tiered": false,
"display_name": "Agile Octopus v3 2024",
"is_temporary": false,
"provider":
{
"id": "prv_63374fb151ea87296cd39ced",
"display_name": "E.ON Next",
"logo_url": "https://s.flatpeak.com/83b06a60e38c2.png"
},
"prices":
{
"yesterday":
[],
"today":
[
{
"valid_from": "2024-02-01T00:00:00+02:00",
"valid_to": "2024-02-01T22:00:00+02:00",
"price":
{
"value": 0.12,
"vat": 1.19,
"confidence": 0.8
}
}
],
"tomorrow":
[
{
"valid_from": "2024-02-02T00:00:00+02:00",
"valid_to": "2024-02-02T06:00:00+02:00",
"price":
{
"value": 0.9,
"vat": 1.19,
"confidence": 0.8
}
}
]
}
},
"non_commodity_import":
{
"status": "CONNECTED",
"id": "trf_66fa584eb6923d7c3b942ef8",
"connection_type": "LIBRARY",
"tiered": false,
"display_name": "Effektabonnemang 16 – 25A",
"temporary": false,
"provider":
{
"id": "prv_63a6087272921ef075a8fd3e",
"display_name": "Sollentuna Elnät AB",
"logo_url": "https://s.flatpeak.com/83b06a60e38c2.png"
},
"prices":
{
"yesterday":
[],
"today":
[
{
"valid_from": "2024-02-01T00:00:00+02:00",
"valid_to": "2024-02-01T22:00:00+02:00",
"price":
{
"value": 0.6,
"vat": 0,
"confidence": 1
}
}
],
"tomorrow":
[
{
"valid_from": "2024-02-02T00:00:00+02:00",
"valid_to": "2024-02-02T06:00:00+02:00",
"price":
{
"value": 0.6,
"vat": 0,
"confidence": 1
}
}
]
}
}
}
}
Actions
Following actons are supported when responding to Connect on this route:| Action | Result |
|---|---|
EDIT | Restarts the flow from the Provider Selection page. |
DISCONNECT | Disconnects the tariff and completes the session. |
WRONG_TARIFF | Report incorrect tariff to Flatpeak. Not available if already reported. |
BACK | Returns previous page. |
CLOSE | Returns callback_url you specified when creating the Connect token. |
context | The context parameter indicates which tariff action relates to. Possible values are commodity_import, commodity_export, non_commodity_import, non_commodity_export and local. |
Errors
When you POST your response to Connect, the following validation errors may be returned| Error Code | Error Description |
|---|---|
action_missing | Action parameter is required. |
action_invalid | Action parameter XX is not supported. |
data_json_invalid | Data does not conform to the JSON schema. |
Note, time is returned in RFC3339 format with offset. i.e. 2024-06-15T03:12:00+02:00