Pricing policies

Warning

Pricing policies will be revised in future versions of the software.

Pricing policy objects

Pricing policy objects consist of the following properties:

id
The pricing policy’s unique identifier.

The following set of properties define the per-hour tariff. They must all be specified, or, if no per-hour tariff is desired, all set to -1.

pricePerHourDay
Daytime price per hour.
pricePerHourNight
Nighttime price per hour.
dayTariffStartHourForPricePerHour
The hour on which nighttime pricing ends and daytime pricing starts.
dayTariffStartMinuteForPricePerHour
The minute on which nighttime pricing ends and daytime pricing starts.
nightTariffStartHourForPricePerHour
The hour on which daytime pricing ends and nighttime pricing starts.
nightTariffStartMinuteForPricePerHour
The minute on which daytime pricing ends and nighttime pricing starts.

The following set of properties define the per-kWh tariff hour. They must all be specified, or, if no per-kWh tariff is desired, all set to -1.

pricePerKwhDay
Daytime price per kWh.
pricePerKwhNight
Nighttime price per kWh.
dayTariffStartHourForPricePerKwh
The hour on which nighttime pricing ends and daytime pricing starts.
dayTariffStartMinuteForPricePerKwh
The minute on which nighttime pricing ends and daytime pricing starts.
nightTariffStartHourForPricePerKwh
The hour on which daytime pricing ends and nighttime pricing starts.
nightTariffStartMinuteForPricePerKwh
The minute on which daytime pricing ends and nighttime pricing starts.

Example object

{ "id": 10000,

  "pricePerHourDay": 6.0,
  "pricePerHourNight": 3.0,
  "dayTariffStartHourForPricePerHour": 8,
  "dayTariffStartMinuteForPricePerHour": 0,
  "nightTariffStartHourForPricePerHour": 18,
  "nightTariffStartMinuteForPricePerHour": 0,

  "pricePerKwhDay": 1.0,
  "pricePerKwhNight": 0.5,
  "dayTariffStartHourForPricePerKwh": 7,
  "dayTariffStartMinuteForPricePerKwh": 0,
  "nightTariffStartHourForPricePerKwh": 20,
  "nightTariffStartMinuteForPricePerKwh": 0 }

B-Holding pricing policy objects

Alternative pricing policy for the B-Holding installation. See B-Holding documentation.

{ "id": 10000,

  "fixedCost": 0.0,
  "hourlyCost": 0.0,
  "kWhCost": 0.2,
  "disableSmartGrid": false,
  "smartGridFlexibility": 95,
  "smartGridTimeLimitMinutes": 420,
}

Pricing policy services

GET /abs/frontend/pricingPolicy/own

Retrieve the pricing policies associated with the current user’s account.

Role:host

Example response

{ "statusCode": "100", "pricingPolicies": [ ...list of pricingPolicy objects... ] }
GET /abs/frontend/pricingPolicy/(id)

Retrieve a specific pricing policy.

Role:host

Example response

{ "statusCode": "100", "pricingPolicy": { ... } }
POST /abs/frontend/pricingPolicy

Create a new pricing policy. All properties of the pricing policy object must be passed as query parameters.

Role:admin
PUT /abs/frontend/pricingPolicy/(id)

Modify a pricing policy. All properties of the pricing policy object must be passed as query parameters.

Role:

admin

Status Codes:
  • 208 – Unknown pricing policy.