To use the full eRoaming functionality, it is important for CPOs to offer their charging infrastructure. To do so, please set up an offer to all EMP partners, including upcoming new ones in the HBS Portal. That way, the EMPs can set up subscriptions and all their users can charge at your charging stations. Thus, the open nature of the eRoaming platform is assured.
Please note that, since the offer cannot be altered during the run time of an offer, an offer to multiple specific partners is not a good replacement for the O2A.
1. Please go to the Business Contracts section in the red box.
2. To offer a new service, please click on Create New Offer in the Service Offers section in the red box.
- You will be directed to this page, please choose the service type and Offer to all then proceed. For the standard charging offer, you choose Authorization.
3. 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_OfferToAll |
M |
|
Valid From |
At least today‘s date, must be in the future |
M |
|
Valid To |
Date must be at least 42 days later than “valid from” or later(see Cancellation Period). Up to 2 years from today |
M |
|
Additional Terms & Conditions |
Please add specific pricing details ONLY in the pricing model section. |
O |
|
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 Note: CPOs must according to the eRoaming Agreement (§5.3) announce fee changes on the platform 42 days before a quarter ends, with the changes taking effect at the start of the following quarter. |
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 |
- 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.
4. Next, you have to define the pricing model for your offer. Which section are you looking for?
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 Price Per Reference Unit, 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 maximum 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 the 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 maximum 3 decimal points. E.g. 0.001 |
|
|
Comment |
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. Dynamic pricing is only permitted for bilateral offers, as the changes in pricing during the offer period are not permissible for the OfferToAll.
1. When selecting the Flexible/Dynamic pricing model, all your prices need to be specified as ProductIDs in a CSV file upload. To do so, click Drag and Drop File Here or Click. For Action Type select Full Load / Delete.
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) |
|
DefaultPrice |
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 Everyday, Workdays, Weekend, Monday, Tuesday, Wednesday, Thursday, Friday, Saturday, 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
3. Upload your CSV for Pricing Products and your EVSE Pricing to distinguish tariffs on EVSE level.
4. Select Publish to send your offer to all potential subscribers.
Next, read about how to create a bilateral offer that you can send to one or more specific EMPs.