VDV 463 WebSocket interactions where the CMS hosts the endpoint. The current runtime fully handles BootNotification and ProvideChargingRequests requests and documents the intended ProvideChargingInformation update flow for future implementation.
Connection summary:
/vdv463/ws; deployments are expected to expose this as secure WebSocket (TLS 1.2+).Sec-WebSocket-Protocol: v1.463.vdv.de and authenticate via HTTP Basic during the handshake, but the current FastAPI route documents rather than enforces those requirements.messageType, source, presystemId, timeStamp, messageId, messageAction, and payload fields.MessageStructure.from_socket_list() and .to_socket_list() can convert to or from the seven-slot array shorthand used in some sequence examples.1=Request, 2=Confirmation, 3=Error; confirmations echo the request's messageId and messageAction.WebSocket channel hosted by the CMS.
CMS receives BootNotification requests from upstream presystems and acknowledges them.
Accepts the following message:
Boot notification initiated by an upstream presystem.
{
"messageType": 1,
"source": "string",
"presystemId": null,
"timeStamp": "2019-08-24T14:15:22Z",
"messageId": "string",
"messageAction": "BootNotification",
"payload": {
"presystem": "BMS"
}
}
WebSocket channel hosted by the CMS.
CMS sends BootNotification confirmations back to the presystem. Accepted or rejected. Response uses the same MessageId, PresystemId and MessageAction as the Request
Accepts the following message:
Confirmation returned by the CMS for BootNotification.
{
"messageType": 2,
"source": "string",
"presystemId": null,
"timeStamp": "2019-08-24T14:15:22Z",
"messageId": "string",
"messageAction": "BootNotification",
"payload": {
"status": "Accepted"
}
}
WebSocket channel hosted by the CMS.
CMS ingests the list of charging requests published by an upstream system and returns a confirmation.
Accepts the following message:
ProvideChargingRequests list published by the upstream presystem.
{
"messageType": 1,
"source": "string",
"presystemId": null,
"timeStamp": "2019-08-24T14:15:22Z",
"messageId": "string",
"messageAction": "ProvideChargingRequests",
"payload": {
"chargingRequestList": [
{
"chargingPointId": null,
"vehicleId": "string",
"chargingRequestId": "string",
"chargingProcessId": null,
"priority": null,
"chargingInstruction": null,
"chargingRequestData": {
"expectedArrivalTimeAtChargingPoint": null,
"expectedSocAtArrival": null,
"minTargetSoc": 100,
"maxTargetSoc": 100,
"requestedTimeForDeparture": null,
"adHocCharging": null
},
"automaticPreconditioning": null,
"manualPreconditioning": null
}
]
}
}
WebSocket channel hosted by the CMS.
CMS acknowledges charging request lists with a confirmation message. Response uses the same MessageId, PresystemId and MessageAction as the Request
Accepts the following message:
Confirmation returned by the CMS for ProvideChargingRequests.
{
"messageType": 2,
"source": "string",
"presystemId": null,
"timeStamp": "2019-08-24T14:15:22Z",
"messageId": "string",
"messageAction": "ProvideChargingRequests",
"payload": {}
}
WebSocket channel hosted by the CMS.
CMS publishes ProvideChargingInformation updates towards the upstream system and expects an acknowledgement. Generates a new MessageId for each update.
Accepts the following message:
Charging infrastructure information initiated by the CMS.
{
"messageType": 1,
"source": "string",
"presystemId": null,
"timeStamp": "2019-08-24T14:15:22Z",
"messageId": "string",
"messageAction": "ProvideChargingInformation",
"payload": {
"depotInfoList": [
{
"depotId": "string",
"name": null,
"chargingStationInfoList": [
{
"chargingStationId": "string",
"chargingStationStatus": "Available",
"chargingPointInfoList": [
{
"chargingPointId": "string",
"chargingPointStatus": "Available",
"insideTemperature": null,
"outsideTemperature": null,
"connectorTemperature": null,
"presentPower": null,
"energyMeterReading": null,
"chargingPointFaultInfo": null,
"vehicleInfo": null,
"chargingProcessInfo": null,
"scheduledChargingProcessList": null
}
],
"chargingStationFaultInfo": null,
"totalPower": null
}
]
}
]
}
}
WebSocket channel hosted by the CMS.
CMS receives acknowledgements after publishing charging information updates. Response uses the same MessageId, PresystemId and MessageAction as the Request.
Accepts the following message:
Confirmation expected from the upstream system after receiving an update.
{
"messageType": 2,
"source": "string",
"presystemId": null,
"timeStamp": "2019-08-24T14:15:22Z",
"messageId": "string",
"messageAction": "ProvideChargingInformation",
"payload": {}
}
Boot notification initiated by an upstream presystem.
Confirmation returned by the CMS for BootNotification.
ProvideChargingRequests list published by the upstream presystem.
Confirmation returned by the CMS for ProvideChargingRequests.
Charging infrastructure information initiated by the CMS.
Confirmation expected from the upstream system after receiving an update.
Boot Notification Request.
Presystem Enum Type.
Boot Notification Response.
Boot Notification Status Enum.
Automatic Preconditioning.
Charging Instruction Enum.
Charging Request.
Charging Request Data.
Manual Preconditioning.
Preconditioning Request Enum.
Provide Charging Requests Request.
Provide Charging Requests Response.
Charging Point Fault Code Enum.
Charging Point Fault Info.
Charging Point Info.
Charging Point Status Enum.
Charging Prediction Data.
Charging Prediction Data Departure Time.
Charging Prediction Data Final SoC.
Charging Prediction Data Min SoC.
Charging Process Info.
Charging Station Fault Code Enum.
Charging Station Fault Info.
Charging Station Info.
Charging Station Status Enum.
Depot Info.
Electric Data.
H2 Tank Info.
Health Status Enum.
Preconditioning Info.
Process Status Enum.
Provide Charging Information Request.
Scheduled Charging Process.
Traction Battery Info.
Vehicle Charging Status Enum.
Vehicle Fault Info.
Vehicle Info.
Vehicle Status Info.
Provide Charging Information Response.
Error Response.
VDV 463 Error Codes.
VDV 463 Error Detail.