You learn in this section how to subscribe to service offers from partners.
On the right side of the screen “Service Subscription”, you see all offers that have been forwarded to you. Select a service offer from one of your partners which you would like to subscribe to.
Selecting the “Subscribe” button will open the new window that allows you to impose conditions of your own to the offer you are willing to accept.
The first block “Offer Details” gives you the important information about the offer you are going to subscribe to.
Please note that an expired subscription to an offer can no longer be extended. Partners need to make sure to extend their subscription before the expiration date.
In case you do not have existing subscriptions now or in the future with the CPO :
In the block "possible subscriptions”, you will see the maximal subscription you can perform regarding this specific offer, that is to say set from “now” in your local time until the end of the offer.
If you already have active running or future subscriptions in place with the CPO :
In the block “Possible Subscriptions” will appear the list of possible subscriptions timeframes you can perform for this specific offer. These possibilities maximize the validity of the subscription you can have for this specific offer and other existing subscriptions you possibly have already in place with the CPO.
The earliest date can be either set to “now” in your local time or to the end of the validity of your running subscription. The latest date you can subscribe to the offer is either the last day of the offer or the date in the future when your future subscription begins.
Complete the “Enter Your Data”. The contents of the “Name” field is freely selectable. These functions enable you to recognise and assign the offers in your system. Each field must however contain at least one sign and a maximum of 50 signs. Make sure that the time frame of the service order is within the time of the service provided (which means shorter or equal to the time frame of the service offer).
You can also chose other custom validity dates, the calendar will adapt itself to the minimum term defined in the offer. A subscription starting in the future will be active at 00:00:00:000 in your time zone and a subscription ending in the future will stop at 23:59:59:999 in your time zone.
In the table below is more specific information about filling in the fields for a new service subscription.
|
Field |
Validation |
|
Name |
Field has to be filled in with at least one character at most 50 signs. Recommended: eg. ChargeCard_GlobalCharge_Authorization |
|
Period Of Notice |
Field has to be filled in with at least one character. Recommended are 14 days. |
|
Valid From |
Date lies ahead „valid from“, at least today‘s date. |
|
Valid To |
Date lies after „valid to“ or doesn‘t lie after „valid to“ |
When the CPO offers the service with Dynamic/Flexible Pricing, you can download the pricing structure either via the webservice or directly in the Portal als CSV.
The structure of the CSV file is always the following:
I) CSV structure for the PricingProductData
a) The first row of the file must contain the following details:
|
# |
Field Name |
Description |
|
1 |
Operator Name |
Name of the operator pushing the data |
|
2 |
DefaultReferenceUnit |
Default reference unit in time or kWh (possible values are HOUR, KILOWATT_HOUR, MINUTE) |
|
3 |
DefaultPrice |
A default price for pricing sessions at undefined EVSEs |
|
4 |
DefaultPriceCurrency |
Currency for default prices (based on ISO 4217 - for example EUR, CHF) |
b) All other rows must/can (as per OICP specification) contain the following details in the given order:
|
# |
Field Name |
Description |
|
1 |
ProductID |
Name of the pricing product |
|
2 |
ReferenceUnit |
Reference unit in time or kWh (possible values are HOUR, KILOWATT_HOUR, MINUTE) |
|
3 |
PricePerReferenceUnit |
A price value per the given reference unit |
|
4 |
ProductPriceCurrency |
Currency of the defined pricing product (based on ISO 4217 - for example EUR, CHF) |
|
5 |
MaximumProductChargingPower |
Maximum product charging power (in kW) |
|
6 |
IsValid24hours |
"true" if this product is applicable 24 hours a day, else "false" |
|
7 |
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) |
|
8 |
begin |
Opening time (HH:MM) |
|
9 |
end |
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) |
|
10 |
AdditionalReference (optional) |
Additional pricing components to be considered in addition to the base pricing |
|
11 |
AdditionalReferenceUnit (optional) |
Reference unit in time or kWh (possible values are HOUR, KILOWATT_HOUR, MINUTE) |
|
12 |
PricePerAdditionalReferenceUnit (optional) |
A price in the given currency |
Sample csv snippet for PricingProductData:
CPO-XYZ,KILOWATT_HOUR,5,EUR 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,06:59 WeekendTariff,KILOWATT_HOUR,13,EUR,30,true,Weekend, 00:00,23:00
II) CSV structure for the PushEVSEPricing operation
|
# |
Field Name |
Description |
|
1 |
EVSEId |
The ID that identifies the charging spot |
|
2 |
ProductId |
Name of the pricing product |
Sample CSV snippet for EVSEPricing:
DE*AB7*E840*6587,Region_1
DE*AB7*E840*6625,Region_2
DE*AB7*E840*2833,Region_3
The next article provides you with information about how to order service cancellation.