api/pricing - single evse id

The single evse id endpoint creates a pricing structure for one evse id and authentication media combination. The endpoint accepts the following parameters

Request Parameters
Parameter Required Description
evseId yes Compliant with the following to calculate the stepCosts: specification for EVSE ID from “eMI3”. e.g. BE-BEC-E041503001”
tag_id, emaid, authendicationUuid yes Tag Id, emaid or uuid from the card/token - only one of those three can be used at once
consumption no fictional consumption in Wh which will be used in the calculation. If left empty no calculation will be done
duration, duration_in_minutes no total duration in seconds or minutes. If left empty no calculation will be done
currency no desired currency. If left empty default settings will be used
include_tax no includes the tax which would be used for this cost rate (tax field will be not present if not set to true)

Response contains a Rate object.

Sample Request for a single evse id

Request Parameters
Parameter Value Description
evseId DE*EEE*E000001  
tag_id SOMETHING  
consumption 90000 in Wh which are 90KWh
duration 1000 value in seconds
curl --location --request GET 'https://yourinstancename.beenergised.cloud/api/pricing/?evseId=DE*EEE*E000001&tag_id=SOMETHING&consumption=90000&duration=1000' \
--header 'x-api-token: your_token'
{
    "rateName": "Standard-Verkaufstarif eMSP",
    "costId": 2206,
    "currency": "EUR",
    "localCurrency": "EUR",
    "costTotalLocalCurrency": 36,
    "currencyConversionRate": 1,
    "costTotal": 36,
    "costTime": 0,
    "costPower": 36,
    "priceStructure": {
        "energy": {
            "unit": "Wh",
            "elements": [
                {
                    "intervalChange": 100,
                    "stepCosts": 0,
                    "intervalCosts": 0
                },
                {
                    "intervalChange": 101,
                    "stepCosts": 0.0404,
                    "intervalCosts": 40.4
                },
                {
                    "intervalChange": 102,
                    "stepCosts": 0.0004,
                    "intervalCosts": 0.4
                },
                {
                    "intervalChange": 100000,
                    "stepCosts": 35.9592,
                    "intervalCosts": 0.4
                }
            ]
        },
        "time": {
            "unit": "min",
            "elements": []
        }
    }
}

Sample Request for a single evse id with a desired currency

Request Parameters
Parameter Value Description
evseId CH*CHI*E00193  
tag_id SOMETHING  
consumption 80000 in Wh which are 80KWh
duration 1 value in seconds
currency CHF currency following the ISO standard
curl --location --request GET 'https://yourinstancename.beenergised.cloud/api/pricing/?evseId=CH*CHI*E00193&tag_id=SOMETHING&consumption=80000&duration=1&currency=CHF' \
--header 'x-api-token: your_token'
{
    "rateName": "Standard-Verkaufstarif eMSP",
    "costId": 2020,
    "currency": "CHF",
    "localCurrency": "EUR",
    "costTotalLocalCurrency": 48.863,
    "currencyConversionRate": 1.0642,
    "costTotal": 52,
    "costTime": 0,
    "costPower": 52,
    "priceStructure": {
        "energy": {
            "unit": "Wh",
            "elements": [
                {
                    "intervalChange": 100,
                    "stepCosts": 0,
                    "intervalCosts": 0
                },
                {
                    "intervalChange": 101,
                    "stepCosts": 0.06565,
                    "intervalCosts": 65.65
                },
                {
                    "intervalChange": 102,
                    "stepCosts": 51.93435,
                    "intervalCosts": 0.65
                }
            ]
        },
        "time": {
            "unit": "min",
            "elements": []
        }
    }
}

How to calculate the stepCosts?

{
    "intervalChange": 102,
    "stepCosts": 51.93435,
    "intervalCosts": 0.65
}

stepConsumption = consumption - consumptionLastStep = 80000 Wh - 101 Wh= 79899 Wh = 79,899 kWh

intervalCost = stepConsumption * intervalCosts = 79,899 kWh * 0,65 CHF/kWh = CHF 51,93435

Sample Request for a single evse id with tax

Request Parameters
Parameter Value Description
evseId CH*CHI*E00193  
tag_id SOMETHING  
include_tax   add tax to price structure
curl --location --request GET 'https://yourinstancename.beenergised.cloud/api/pricing/?evseId=CH*CHI*E00193&tag_id=SOMETHING&include_tax' \
--header 'x-api-token: your_token'
{
    "rateName": "Standard-Verkaufstarif eMSP",
    "costId": 2020,
    "currency": "CHF",
    "localCurrency": "EUR",
    "costTotalLocalCurrency": 48.863,
    "currencyConversionRate": 1.0642,
    "costTotal": 52,
    "costTime": 0,
    "costPower": 52,
    "priceStructure": {
        "energy": {
            "unit": "Wh",
            "elements": [
                {
                    "intervalChange": 100,
                    "stepCosts": 0,
                    "intervalCosts": 0
                },
                {
                    "intervalChange": 101,
                    "stepCosts": 0.06565,
                    "intervalCosts": 65.65
                },
                {
                    "intervalChange": 102,
                    "stepCosts": 51.93435,
                    "intervalCosts": 0.65
                }
            ],
            "tax": 1.87
        },
        "time": {
            "unit": "min",
            "elements": [],
            "tax": 1.24
        }
    }
}