4.2 Create your OfferToAll

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 e.g. GlobalCharge_Authorization_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	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?

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: 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 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 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 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 selects 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 (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

 

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.

 

Back to top

 

Next, read about how to create a bilateral offer that you can send to one or more specific EMPs.