Charging stations
=================
A charging station is one of the main entities in be.ENERGISED. The
charging stations id will be used for different other calls as URL parameter
(e.g. maintenance windows).

Reading
-------
Charging stations can be accessed via the `charging_stations` `GET` endpoint.
This endpoint will return a list of all visible stations in be.ENERGISED.

The list endpoint is using
`offset pagination <pagination.html#offset-based-pagination>`__.

.. code-block:: bash

    curl --location --request GET \
    'https://<slug>.beenergised.cloud/api/cpoapi/v1/charging_stations/' \
    --header 'Authorization: <access_token>' \
    --header 'Content-Type: application/json'

Creating
--------
New charging stations can be created via the `charging_stations`
`POST` endpoint.

.. code-block:: bash

    curl --location --request POST \
    'https://<slug>.beenergised.cloud/api/cpoapi/v1/charging_stations/' \
    --header 'Authorization: <access_token>' \
    --header 'Content-Type: application/json' \
    --data '{
      "label": "Station A",
      "chargeBoxIdentity": "ABC123",
      "modelId": 1,
      "companyUuid": "company-uuid-here",
      "timeZone": "Europe/Berlin"
    }'

Required Parameters
~~~~~~~~~~~~~~~~~~~
- **label** (string): Label visible in the UI.
- **chargeBoxIdentity** (string): Charge box identity used as main
  identifier in the OCPP connection. Must be unique.
- **modelId** (integer): ID of the charging station model.
- **companyUuid** (string): UUID of the company (entity) the
  station is connected to.
- **timeZone** (string): The timezone of the station, e.g. `Europe/Berlin`.

Optional Parameters
~~~~~~~~~~~~~~~~~~~
- **publicDisplayName** (string): Name shown in external systems like apps.
- **iccid** (string): ICCID received by the station during the
  BootNotification.
- **imsi** (string): IMSI received by the station during the BootNotification.
- **serialnumber** (string): Serial number received by the station
  during the BootNotification.
- **address** (object): Address information for the station.
- **geolocation** (object): Geographic location of the station.
- **technicianUserId** (integer, optional): ID of the technician to
  assign to this station. The technician must belong to the same
  company as the station. If not provided, no technician is assigned.

Assigning a Technician
~~~~~~~~~~~~~~~~~~~~~~
To assign a technician when creating a station, first retrieve the
available technicians:

.. code-block:: bash

    curl --location --request GET \
    'https://<slug>.beenergised.cloud/api/cpoapi/v1/technicians/?limit=50' \
    --header 'Authorization: <access_token>' \
    --header 'Content-Type: application/json'

Then use the technician's `id` in the creation request:

.. code-block:: bash

    curl --location --request POST \
    'https://<slug>.beenergised.cloud/api/cpoapi/v1/charging_stations/' \
    --header 'Authorization: <access_token>' \
    --header 'Content-Type: application/json' \
    --data '{
      "label": "Station B",
      "chargeBoxIdentity": "DEF456",
      "modelId": 1,
      "companyUuid": "company-uuid-here",
      "timeZone": "Europe/Berlin",
      "technicianUserId": 42
    }'

For more information about available technicians, see the
`Technicians <technicians.html>`__ section.