activityContextEvent.updated

This event is raised each time an activity context event item is updated

Supported events:

  • newDriverOperational: the driver that links with the asset, is different from the previous linked driver for that asset
  • sameDriverOperational: the driver that links with the asset, is the same driver as was previously linked with the asset
  • driverNotOperational: the driver is signed out or unlinked from the asset.
  • ptoOnCan / ptoOffCan
  • ignitionOff / ignitionOn
  • engineRunning / engineStopped
  • digitalInput1Active / digitalInput1Inactive (support for Input1 up to Input2)
  • input1ActiveExtensionKit1 / input1InactiveExtensionKit1 (support for input1 up to input3)
  • input1ActiveExtensionKit2 / input1InactiveExtensionKit2 (support for input1)

Payload JSON

{
  "eventId": "d290f1ee-6c54-4b01-90e6-d701748f0851",
  "eventTime": "2025-05-12T22:21:00.000Z",
  "eventOrganizationId": "7e2c1a8b-1f2b-4c3d-9e8a-2b7c1a8b1f2b",
  "subscriptions": [
    {
      "eventSubscriptionIds": "a1c2e3f-4b5d-6e7f-8a9b-0c1d2e3f4a5b",
      "eventsMeta": [
        {
          "eventName": "activityContextEvent.updated",
          "count": 1
        }
      ],
      "eventsData": [
        {
          "eventType": "activityCcontextEvent.updated",
          "eventVersion": 1,
          "eventData": {
            "assetId": "1a8b2f3d-3c2b-4e7a-9c1d-8b2f3d1a8b2f",
            "driverId": "2b3c1a8b-2f3d-4e7a-9c1d-8b2f3d1a8b2f",
            "activityContextEventId": "3c2b1a8b-2f3d-4e7a-9c1d-8b2f3d1a8b2f",
            "activityContextEventType": "ignitionOff",
            "activityContextEventDefinitionId": "4e7a9c1d-2b3c-4f2d-8a7c-1a8b2f3d3c2b",
            "workflowSessionId": "8a7c1a8b-2f3d-4c2b-9e7a-3c2b1a8b2f3d",
            "position": {
              "latitude": 50.869,
              "longitude": 2.8942
            },
            "mileage": 123456.7,            
            "modifiedOn": "2025-05-12T22:20:00.000Z",
            "registeredOn": "2025-05-12T22:20:00.000Z"
          }
        }
      ]
    }
  ]
}

Field level description


FieldTypeRequiredDescription
eventIdstring (uuid)OptionalUnique identifier generated by the core module for this Kafka message
eventTimestring (date-time)OptionalTime at which the event was sent to Kafka
eventOrganizationIdstring (uuid)OptionalIdentifier of the organization to which the data belongs
subscriptionsarrayRequiredList of subscriptions receiving this event
subscriptions[].eventSubscriptionIdsarray (uuid)RequiredSubscription IDs for which the same event data applies
subscriptions[].eventsMetaarrayRequiredMetadata describing included events
subscriptions[].eventsDataarrayRequiredActual event payloads
eventNamestringRequiredName of the event (activityContextEvent.updated)
countintegerRequiredNumber of occurrences of this event in eventsData
eventTypestringRequiredEvent type identifier (activityContextEvent.updated)
eventVersionintegerRequiredVersion of the event (v1)
eventDataobjectRequiredActivity Context Event creation payload
assetIdstring (uuid)RequiredUnique identifier of the asset
driverIdstring (uuid)OptionalIdentifier of the driver
activityContextEventIdstring (uuid)RequiredUnique identifier of the activity context event
activityContextEventTypestringRequiredType of context event (e.g. newDriverOperational, engineRunning)
activityContextEventDefinitionIdstring (uuid)RequiredIdentifier of the activity context event definition
workflowSessionIdstring (uuid)OptionalWorkflow session identifier
positionobject (position)OptionalPosition associated with the context event
mileageintegerOptionalOdometer reading (km) around event generation time
modifiedOnstring (date-time)RequiredTimestamp when the event was last modified
registeredOnstring (date-time)RequiredTimestamp when the event was registered
position.latitudenumber (float)RequiredLatitude
position.longitudenumber (float)RequiredLongitude