API for EVerest API clients that consume session cost and tariff information from the session_cost interface. See the Integrate Tariff and Cost how-to guide for OCPP-specific configuration and message flow details.
default local MQTT
The ID of the module as defined in the EVerest config file.
Published at authorization time and whenever the CSMS sends updated pricing during a session. Contains human-readable price text in one or more languages.
Available only on servers:
Accepts the following message:
Tariff and pricing information for a charging session
Message containing cost information
{
"ocpp_transaction_id": "string",
"identifier_id": "string",
"identifier_type": "IdToken",
"messages": [
{
"format": "ASCII",
"language": "string",
"content": "string"
}
]
}
Published periodically during a session and once when it ends. Contains session cost broken down into chunks, current and upcoming pricing, and optional display messages.
Available only on servers:
Accepts the following message:
Running or final cost of a charging session
Session cost object containing the total cost of the session and a list of chunks
{
"id_tag": {
"request_id": 0,
"id_token": {
"value": "string",
"type": "Central",
"additional_info": [
{
"value": "string",
"type": "string"
}
]
},
"parent_id_token": {
"value": "string",
"type": "Central",
"additional_info": [
{
"value": "string",
"type": "string"
}
]
},
"authorization_type": "OCPP",
"connectors": [
1
],
"prevalidated": true,
"certificate": "string",
"iso15118CertificateHashData": [
{
"hashAlgorithm": "SHA256",
"issuerNameHash": "string",
"issuerKeyHash": "string",
"serialNumber": "string",
"responderURL": "string"
}
]
},
"session_id": "string",
"currency": {
"code": "AED",
"decimals": 0
},
"cost_chunks": [
{
"timestamp_from": "2019-08-24T14:15:22Z",
"timestamp_to": "2019-08-24T14:15:22Z",
"metervalue_from": 0,
"metervalue_to": 0,
"cost": {
"value": 0
},
"category": "Energy"
}
],
"idle_price": {
"grace_minutes": 0,
"hour_price": {
"currency": {
"code": "AED",
"decimals": 0
},
"value": {
"value": 0
}
}
},
"charging_price": [
{
"category": "Energy",
"price": {
"currency": {
"code": "AED",
"decimals": 0
},
"value": {
"value": 0
}
}
}
],
"next_period": {
"timestamp_from": "2019-08-24T14:15:22Z",
"charging_price": [
{
"category": "Energy",
"price": {
"currency": {
"code": "AED",
"decimals": 0
},
"value": {
"value": 0
}
}
}
],
"idle_price": {
"grace_minutes": 0,
"hour_price": {
"currency": {
"code": "AED",
"decimals": 0
},
"value": {
"value": 0
}
}
}
},
"status": "Running",
"message": [
{
"format": "ASCII",
"language": "string",
"content": "string"
}
],
"qr_code": "string"
}
Accepts the following message:
Heartbeat produced by EVerest as configured via cfg_heartbeat_interval_ms in the EVerest configuration
64bit unsigned integer. The id of every heartbeat increases by 1 and overflows when the maximum representable value is reached
Heartbeat
Accepts the following message:
Signal to EVerest that communication is good or check shall be stopped
Send 'true' at least every 'cfg_communication_check_to_s' seconds to signal module is alive. Send 'false' to stop communication check'
CommunicationCheck
Tariff and pricing information for a charging session
Message containing cost information
Running or final cost of a charging session
Session cost object containing the total cost of the session and a list of chunks
Heartbeat produced by EVerest as configured via cfg_heartbeat_interval_ms in the EVerest configuration
64bit unsigned integer. The id of every heartbeat increases by 1 and overflows when the maximum representable value is reached
Signal to EVerest that communication is good or check shall be stopped
Send 'true' at least every 'cfg_communication_check_to_s' seconds to signal module is alive. Send 'false' to stop communication check'
Send 'true' at least every 'cfg_communication_check_to_s' seconds to signal module is alive. Send 'false' to stop communication check'
64bit unsigned integer. The id of every heartbeat increases by 1 and overflows when the maximum representable value is reached