Rates allow you to set a price for charging sessions on a connector. By setting a Rate, eDRV will automatically calculate and report costs for an ongoing session via Webhook events in the session.cost property.

Rates are also used for eDRV's Charging Intelligence for e.g. if you want to set a cap on costs for a charging session.

Rates Object

{
    "_id": "615c9aa4d311c82bdc9422c3",
    "currency": "EUR",
    "price_components": [
        {
            "tax": 10,
            "step_size": 1,
            "type": "FLAT",
            "price": 5
        },       
        {
            "tax": 0,
            "step_size": 1,
            "type": "TIME",
            "price": 2.50
        }
    ],
    "createdAt": "2021-10-05T18:34:12.204Z",
    "updatedAt": "2021-10-05T18:34:12.204Z"
}

Attributes

_id string

The Id of this Rate

currency string

3 letter iso currency codes. See https://en.wikipedia.org/wiki/ISO_4217.
Currently one of [USD, EUR, SGD, CAD,INR, GBP]

price_components Array of objects
Only one of each type is permitted. Combinations e.g FLAT + TIME are permitted.

type: string One of [FLAT, ENERGY, TIME]

  • FLAT : A flat fee for this session
  • ENERGY : Per kWh
  • TIME : Per Hour

step_size integer
Step size for TIME and ENERGY rate.type. For example:

type = TIME, step_size = 2, sets the price for a 2 Hour block
type = ENERGY, step_size = 10, sets the price per 10kWh block

Tax float
Tax rate in percent% (0-100) to be added to the cost calculation. For example:

The cost for 10kWh sold at a rate of $0.10/kWh + 10% tax = 10 x 0.10 x (1+10%) = $1.10