If you want to offer prices to a specific EMP partner, you can set up a separate offer in addition to your OfferToAll.
1. To offer a new service, please click on Create New Offer in the My Service Offers section.
2. Please choose Service Type and Offer to Specific Partners.
For the standard charging offer, you choose Authorization. Service type Push EVSE Data is an offer that has to be forwarded to the eRoaming platform for your charging points to be shared with the HBS.
You can also upload a PDF file with additional offer details. This PDF file is purely descriptive and will not be used in any way to rate CDRs.
3. Select Partners. As An Offer To A Specific Partner, This Service Offer Will Be Sent To Selected Partners.
- In the drop down (see the red box in the screenshot below) you can select one or more partners by searching their names.
- If you have selected all the partners you want, click on Done and then click on Next.
4. Choose a Service Offer name for the offer that will help you recognise your services offered.
5. Determine the run time by selecting Valid From and Valid To, and set the rules for cancellation.
The table below shows you detailed information on every field.
Field Name |
Validation |
Mandatory field/ optional field |
|
Service Offer Name |
Recommended: MyCompany_ServiceType_OfferToPartner |
M |
|
Valid From |
At least today‘s date. Must be in the future |
M |
|
Valid To |
The date can be the same date as “valid from” or later. Up to 2 years from today |
M |
| Cancellation Period (Days) |
The field has to be filled in with at least one character. QA: Can be set to 1 up to the number of days you specify within your legal contract. PROD: Must be 42 days |
M |
|
Minimum term (Days) |
The field has to be filled in with at least one character. May be set to 1 for testing up to 90 days depending on your business contract |
M |
|
Notice Period (Days) |
21 days (recommended) |
M |
|
Notice Period Message |
Message for the period of notice |
O |
|
Additional Terms & Conditions |
Add files regarding any terms and conditions (Please add specific pricing details only in the pricing model section) | O |
6. Next, you have to define the pricing model of the service offer.
Next Generation Pricing
Hubject's latest pricing model grants more flexibility to CPOs regarding the setup of prices and tariffs for their charging points (EVSEs).
Please find all the information needed below:
- Introduction
- Creating and Managing an EVSE Network
- Creating and managing an EVSE group
- Service offer for NGP
- Additional Information on Managing an EVSE Network
Standard pricing
Select Standard pricing if you have only one default price. If you have more than one price, e.g. distinguish your price based on time or EVSE, select the Product or Flexible pricing model.
- Specify the default price, reference unit (hour, kWh, minute), and applicable currency.
Product pricing
Product pricing is a pricing model that gives you the option to create multiple different pricing products for your stations, e.g. different prices per sub-CPO or different prices per charging speed.
1. Enter Product Details. Add pricing products by clicking on Add Product and defining the different pricing products.
2. You can set the price in two different ways - you can choose one or both (if you choose one, please set the other to 0)
- Price per reference unit (min/kWh)
- Price per session
3. Fill the fields according to the table below:
|
Field Name |
Description |
Mandatory/ Optional |
Field Type |
|
Product ID* |
The product ID must be unique across all your service offers. It has to be provided as part of the Charge Detail Record (PartnerProductID) to enable the rating of CDRs |
M |
String (50 characters) |
|
Product Name |
Please describe your product, e.g. price for Sub-CPO XYZ |
O |
String (50 characters) |
|
Current Type |
The options are:
|
O |
Drop-down list |
|
Country Code |
Please type the country name (in English). Then select the appropriate country from the drop-down list. It will be automatically converted into the Country Code as defined in ISO 3166-1: Alpha-3 (three-letter) |
O |
Drop-down list |
|
Sub-CPO ID |
Please type the sub-CPO ID, then a drop-down list of all sub-CPOs which are registered on HBS appears. Select the sub-CPO. |
O |
Drop-down list |
|
Price per Reference Unit* |
In this field, you can define the price charged per reference unit Requirements: Positive integer number, not more than 3 digit decimals. If you want to use only the “Price per Session” field then set “Price per Reference Unit” to zero. |
M |
Positive integer with a maximum of 3 decimal points. E.g. 0.001 |
|
Reference Unit* |
Choose between Minute or kWh |
M |
Drop-down list |
|
Price Per Session* |
One-time fee for each valid charging session If you want to use only Price per Reference Unit then set Price Per Session to zero. |
M |
Positive integer with a maximum of 3 decimal points. E.g. 0.001 |
|
Currency* |
List of different currencies. The default currency is Euro. |
M |
Dropdown List |
|
Charging Session Validity (Min) |
A charging session is defined as the duration in which the electric vehicle is successfully connected to a charge point (charging or plugged in). You can configure the validity of a charging session by setting a minimum session duration (in minutes) and minimum energy consumption (in kWh). Only valid charging sessions can be charged/invoiced to the EMP. By default, these fields are set to 0. Charging Session Validity (Min) and Charging Session Validity (kWh) are always used together to evaluate the validity of a charging session. Examples 1. If Charging Session Validity (Min) = 0 and Charging Session Validity (kWh) = 0
2. If Charging Session Validity (Min) = 1 and Charging Session Validity (kWh) = 0.1
3. If Charging Session Validity (Min) = 2 and Charging Session Validity (kWh) = 0.2
|
O |
Positive integer. E.g. 1, 2, etc. |
|
Charging Session Validity (kWh) |
O |
Positive integer with a maximum of 3 decimal points. E.g. 0.001 |
|
|
Comments |
Add a comment about your pricing product. Price information mentioned in Comments will not be used for CDR rating |
O |
String (100 Characters) |
Flexible/Dynamic pricing
Flexible pricing offers you the opportunity to push prices via API. Please work together with your development team to create a flexible pricing offer. You can find our API documentation on flexible pricing here.
1. When selecting the Flexible/Dynamic pricing model, all your prices need to be specified as ProductIDs as a CSV file upload. To do so, click Drag and Drop File Here or Click. For Action Type select Full Load.
2. Create two CSV files for Pricing Products and EVSE Pricing. When clicking on UPLOAD PRICE, you will get access to two CSV templates.
CSV structure for the Pricing Products file
The first row of the file must contain the following details:
|
Field Name |
Description |
|
Operator Name |
Name of the operator pushing the data |
|
DefaultReferenceUnit |
Default reference unit in time or kWh (possible values are HOUR, KILOWATT_HOUR, MINUTE) |
|
default price |
A default price for pricing sessions at undefined EVSEs - the default price must be the same across all flexible/dynamic offers if there are multiple flexible/dynamic offers |
|
DefaultPriceCurrency |
Currency for default prices (based on ISO 4217 - for example, EUR, CHF) |
Example: CPO-XYZ,KILOWATT_HOUR,5,EUR
All other rows must/can (as per OICP specification) contain the following details in the given order:
|
Field Name |
Description |
|
ProductID |
Name of the pricing product |
|
ReferenceUnit |
Reference unit in time or kWh (possible values are HOUR, KILOWATT_HOUR, MINUTE) |
|
PricePerReferenceUnit |
A price value per the given reference unit |
|
ProductPriceCurrency |
Currency of the defined pricing product (based on ISO 4217 - for example, EUR, CHF) |
|
MaximumProductChargingPower |
Maximum product charging power (in kW) |
|
IsValid24hours |
"true" if this product is applicable 24 hours a day, otherwise "false" |
|
ProductAvailabilityTimes |
Day values to be used in specifying periods on which the product is available (possible values are every day, Workdays, Weekend, Monday, Tuesday, Wednesday, Thursday, Friday, Saturday, and Sunday) |
|
begin |
Opening time (HH: MM) |
|
end |
Closing time (HH: MM) |
|
AdditionalReference (optional) |
Additional pricing components to be considered in addition to the base pricing |
|
AdditionalReferenceUnit (optional) |
Reference unit in time or kWh (possible values are HOUR, KILOWATT_HOUR, MINUTE) |
|
PricePerAdditionalReferenceUnit (optional) |
A price in the given currency |
Example:
DayTariff,KILOWATT_HOUR,15,EUR,30,false,Workdays,07:00,18:00,START FEE,KILOWATT_HOUR,4 NightTariff,KILOWATT_HOUR,5,EUR,30,false,Workdays;18:00,07:00 WeekendTariff,KILOWATT_HOUR,13,EUR,30,true,Weekend,00:00,23:59
CSV structure for the EVSE Pricing file
|
Field name |
Description |
|
EVSEId |
The ID that identifies the charging spot |
|
ProductId |
Name of the pricing product |
Example:
DE*AB7*E840*6587,Region_1
DE*AB7*E840*6625,Region_2
DE*AB7*E840*2833,Region_3
Next upload your CSV for Pricing Products and your EVSE Pricing to distinguish tariffs on EVSE level.
Dynamic pricing
Dynamic pricing builds on flexible pricing, but gives you the flexibility to change prices throughout the duration of the offer via the HBS portal or the API (including near real-time updates). It is only permitted for bilateral offers due to the legal framework necessary to allow for real-time price updates.
Set up your offer according to the instructions under Flexible pricing.
If you want to update some of your prices, select Update / Insert as Action Type from the dropdown (see figure). Next upload your CSV for Pricing Products and your EVSE Pricing to distinguish tariffs on EVSE level.
If you want to update all of your prices, select Full Load as Action Type.
Next upload your CSV for Pricing Products and your EVSE Pricing to distinguish tariffs on EVSE level.
Please also check out our API documentation for instructions on how to update dynamic pricing via API.
6. Select Publish to send your offer to all potential subscribers.
Next, we invite you to complete your onboarding in the Post-Onboarding phase.