4.3 Create bilateral offers

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 e.g. GlobalCharge_Authorization_OfferTointercharge	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. 

 

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: AC: Alternating Current DC: Direct Current HPC-UFC: High Power Charging - Ultra Fast Charging	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 Result: All CDRs will be rated and can be invoiced to the EMP. There is no validity restriction for any charging session. 2. If Charging Session Validity (Min) = 1 and Charging Session Validity (kWh) = 0.1 Result: The CDRs which have a session duration equal to and greater than 1 min and in which energy consumption is equal to or more than 0.1 kWh can be invoiced to the EMP. 3. If Charging Session Validity (Min) = 2 and Charging Session Validity (kWh) = 0.2 Result: The CDRs which have a session duration equal to and greater than 2 min and in which energy consumption is equal to or more than 0.2 kWh can be invoiced to the EMP.	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 (possible values are START FEE, FIXED FEE, PARKING FEE, MINIMUM FEE; MAXIMUM FEE)
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.

 

Back to top

 

Next, we invite you to complete your onboarding in the Post-Onboarding phase.