In this section, we explain how to structure your EVSE Network.
EVSE groups allow you to organize your charging points and structure your network. You can create as many EVSE groups per network as you deem necessary.
Creating an EVSE group is similar to setting up the EVSE network: to create an EVSE group, you simply click on the “Add EVSEs group“ button on the EVSE network Detail page. The dialogue will then prompt you to choose a name for the group. Again, there are no specific format requirements for this field. The character limit is set to 30.
Once you confirm the creation of the group, a split screen is displayed: the lower part of the screen, shows the “Unassigned EVSEs“ list, while the upper part shows the “Assigned EVSEs“ list. Unassigned EVSEs are all charging points pushed to the intercharge network that are not yet part of an EVSE group. To support you in identifying each EVSE listed, we display some key information on EVSE ID, location, power type, and output.
You can move an EVSE from the unassigned list to the assigned list by moving it to a group. Each EVSE can be part of only one EVSE group at once. You are free to decide which criteria to use to assign one or more EVSEs to a group. We have introduced filters to help you select the right EVSEs in both assigned and unassigned lists.
Now that you created the EVSE groups for your network, the next step is to assign the charging points to the right group.
The system allows you to perform the EVSE assignment to group in two ways:
- From the user interface (UI) on the network detail page, by selecting the EVSEs you want to assign to a group;
- From the EVSE assignment API.
Assigning EVSEs from the network detail page
To speed up the EVSE group creation, you can select multiple EVSEs from the unassigned list and then click on “Assign EVSEs”. A dialog is displayed with a drop-down menu for the group selection and, once you confirm which group you would like to move the EVSEs to, they will be listed under the “Assigned EVSEs“ list of that group.
As long as the EVSE network is in the draft, EVSEs can be moved from one group to another other at will. Once the status of the network changes to “Active”, there will be some limitations in the changes you can make on the network. Please refer to the section “Service Offer for Next Generation Pricing” for further details.
Assigning EVSEs from the API
In case you need to assign EVSEs in bulk to a group, you can do so by using the EVSE assignment API.
The API works in a simple way, by asking you to provide the correct name of the network and the group, as well as the list of the EVSE IDs you want to be assigned to that very group: once this information is added to the body and you run the API, a confirmation response is provided via the API and the EVSEs you included in the call are displayed under the selected group on the network detail page.
You can run the API anytime you want, but, depending on the status of the network, it will follow specific behaviours:
- If the network is in draft, each subsequent API call will overwrite previous EVSE assignments: for example, if you initially assigned EVSE DE*12345677 to Group 1 and you run the API again, listing EVSE DE*12345677 under Group 2, the EVSE will be moved from Group 1 to Group 2.
- If the network is active, you can run the API only for unassigned EVSEs and all subsequent calls will not overwrite the assignment of EVSEs to groups that you already performed.
API details
Method: Put
Url: {baseURL}/api/evsenetwork/v1/operators/{OperatorID}/network
Body:
{
"NetworkName": "Network name",
"GroupsAssignments": [
{
"GroupName": "Group name",
"Evses": [
"EVSEID1",
"EVSEID2",
"EVSEID3"
]
}
]
}
The EVSE assignment API has some validations incorporated in its logic: the compliance/non-compliance to these validations is communicated directly in the API response.
Below is a summary of API response in case of non-compliant scenarios:
| Validation | Description |
| EVSE ID not found | If the EVSE ID provided is wrong, incomplete, not yet pushed to Hubject or previously deleted, the API returns an error message and does not assign the EVSEs. |
| EVSE ID already assigned | If a network is active, already assigned EVSEs cannot be moved from one group to the other, and the API returns an error and does not assign the EVSEs. |
| EVSE ID duplicated | If an EVSE ID is not yet assigned to any group, but it is mentioned under more than one group of the same network and same API request. |
| Network/group not found | If the network ID and/or combination of network and group is not correct, or if the group name is not correct, the API returns an error and does not assign the EVSEs. |
Please note: the API also supports the simultaneous EVSE assignment to different groups of a network, if the groups listed in the API body belong to the same network.
Method: Put
Url: {baseURL}/api/evsenetwork/v1/operators/{OperatorID}/network
Body:
{
"NetworkName": "Network name",
"GroupsAssignments": [
{
"GroupName": "Group name",
"Evses": [
"EVSEID1",
"EVSEID2",
"EVSEID3"
]
},
{
"GroupName": "Group name2",
"Evses": [
"EVSEID4",
"EVSEID5",
"EVSEID6"
]
}
]
}
Once all EVSEs have been assigned to a group, you can create a service offer with Next Generation Pricing.
HIGHLIGHT: In order to be linked to tariffs, all EVSEs of a network must be assigned to a group. If one or more EVSEs are not linked to any group their price will be automatically set to zero once the service offer is activated.