Skip to navigation
OCPI roamingeMSP data

Set charging preferences on a partner session (2.2.1 / 2.3.0)

Sends the CPO charging preferences (profile type, departure time, energy need) for a session it runs. OCPI 2.2.1 and 2.3.0 only.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

versionenumRequired

OCPI version: 221 (2.2.1) or 230 (2.3.0). OCPI 2.1.1 has no charging profiles or charging preferences.

Allowed values:
session_idstringRequired1-36 characters

Query parameters

partner_idintegerRequired>=1

Roaming partner to talk to (from GET /ocpi/partners).

Request

This endpoint expects an object.
profile_typeenumRequired
Allowed values:
departure_timedatetime or nullOptional
energy_needdouble or nullOptional>=0
kWh.
discharge_allowedbooleanOptionalDefaults to false

Response

Successful Response
session_idstring
resultenum or nullOptional
Allowed values:
http_statusinteger or nullOptional
ocpi_status_codeinteger or nullOptional
errorstring or nullOptional

Errors

400
Bad Request Error
401
Unauthorized Error
404
Not Found Error
422
Unprocessable Entity Error
429
Too Many Requests Error
502
Bad Gateway Error
504
Gateway Timeout Error