Message types

Messages types and their examples can be found below.

ChargerState

This message is generated every time a charger generates a StatusNotification or a similar message. The socketId '0' indicates the status of the charge point’s main controller.

{
  "chargerId": "ID_OF_CHARGER",
  "socketId": 1,
  "receivedTimestamp": "2025-04-02T09:11:03.7849436Z",
  "siteId": "123",
  "externalSiteId": "EXT-1",
  "deviceTimeStamp": "2025-04-02T09:11:03.680905Z",
  "status": "Available",
  "errorCode": "NoError",
  "message": "eMabler Simulator Status Update"
}

ChargerBoot

This message is generated when a charger boots. It contains basic information about the charger.

{
  "chargerId": "ID_OF_CHARGER",
  "receivedTimestamp": "2025-04-02T09:11:03.7373916Z",
  "siteId": "123",
  "externalSiteId": "EXT-1",
  "serialNumber": "NotSet",
  "chargerModel": "eMablerSIM",
  "manufacturer": "eMabler",
  "firmwareVersion": "1.1",
  "iccid": "ICCID123",
  "imsi": "IMSI123",
  "meterSerialNumber": "METER123",
  "meterType": "S0 Meter"
}

FullChargingTransaction

This message is generated when a transaction has been finished, after receiving the StopTransaction message from the charger.

{
  "chargerId": "ID_OF_CHARGER",
  "socketId": 1,
  "receivedTimestamp": "2025-04-02T09:11:43.700944Z",
  "siteId": "123",
  "externalSiteId": "EXT-1",
  "deviceTimeStampStart": "2025-04-02T09:11:32.4Z",
  "deviceTimeStampEnd": "2025-04-02T09:11:43.6331432Z",
  "transactionId": "1032427936",
  "authorizedIdTag": "TAG123",
  "meterReadStart": 0,
  "meterReadEnd": 0,
  "consumptionWh": 0,
  "action": "transaction_stop"
}

ChargingTransaction

This message is generated when a transaction starts, after receiving the StartTransaction message from the charger.

{
  "chargerId": "ID_OF_CHARGER",
  "socketId": 1,
  "socketName": "1234",
  "receivedTimestamp": "2025-04-02T09:11:32.4951111Z",
  "siteId": "123",
  "externalSiteId": "EXT-1",
  "deviceTimeStamp": "2025-04-02T09:11:32.3991208Z",
  "action": "transaction_start",
  "transactionId": "1032427936",
  "authorizedIdTag": "TAG123",
  "meterRead": 0
}

Measurements

Measurements are sent periodically during a transaction. While the exact contents vary by charger, they typically include current, voltage, and energy readings. Some chargers may also report additional data such as vehicle temperature and state of charge.

{
  "chargerId": "AAA_ALEKSI_TEST",
  "socketId": 1,
  "receivedTimestamp": "2025-04-02T07:50:27.7813314Z",
  "siteId": "123",
  "externalSiteId": "EXT-1",
  "transactionId": "1199757308",
  "measurements": [
    {
      "deviceTimeStamp": "2025-04-02T07:50:27.6874092Z",
      "value": "5",
      "typeOfMeasurement": "Current.Import",
      "phase": "L1",
      "unit": "A"
    },
    {
      "deviceTimeStamp": "2025-04-02T07:50:27.6874092Z",
      "value": "236",
      "typeOfMeasurement": "Voltage",
      "phase": "L1-N",
      "unit": "V"
    },
    {
      "deviceTimeStamp": "2025-04-02T07:50:27.6874092Z",
      "value": "5",
      "typeOfMeasurement": "Current.Import",
      "phase": "L2",
      "unit": "A"
    },
    {
      "deviceTimeStamp": "2025-04-02T07:50:27.6874092Z",
      "value": "236",
      "typeOfMeasurement": "Voltage",
      "phase": "L2-N",
      "unit": "V"
    },
    {
      "deviceTimeStamp": "2025-04-02T07:50:27.6874092Z",
      "value": "5",
      "typeOfMeasurement": "Current.Import",
      "phase": "L3",
      "unit": "A"
    },
    {
      "deviceTimeStamp": "2025-04-02T07:50:27.6874092Z",
      "value": "236",
      "typeOfMeasurement": "Voltage",
      "phase": "L3-N",
      "unit": "V"
    },
    {
      "deviceTimeStamp": "2025-04-02T07:50:27.6874092Z",
      "value": "94204",
      "typeOfMeasurement": "Energy.Active.Import.Register",
      "phase": "N/A",
      "unit": "Wh"
    }
  ]
}

ApiNotification

ApiNotifications are generated by eMabler when the API or UI is used to update an entity. You can use these messages to synchronize your system's data with eMabler. Each action can have its own schema in the message.

{
  "action": "CHARGER_UPDATED",
  "receivedTimestamp": "2025-04-02T09:51:27.5539849Z",
  "chargerId": "ID_OF_CHARGER",
  "siteId": "123",
  "externalSiteId": "EXT-1",
  "apiChargerChange": {
    "newSockets": {
      "0": {
        "status": "Available",
        "id": 0,
        "name": "Socket 1 Name",
        "lastUpdated": "2025-04-02T09:11:03.7394814Z"
      },
      "1": {
        "type": "CCS (DC)",
        "status": "Available",
        "id": 1,
        "name": "1234",
        "format": "SOCKET",
        "maxWatts": 100,
        "maxAmperage": 0,
        "lastUpdated": "2025-04-02T09:51:27.5540076Z"
      }
    },
    "newGroupId": 0
  }
}

RealTimeAuth

Real-time authorization enables external systems to approve charging sessions outside of the eMabler platform. More information about the realtime auth can be found from here: Realtime authorization

{
  "charger_id": "ID_OF_CHARGER",
  "rfid_tag_id": "TAG1234"
}