event.tbs.dtc.raised

Payload JSON

{
   "eventSubscriptionId":"517db07f-6e95-475e-8cc0-a371f9deed2b",
   "eventType":"event.tbs.dtc.raised",
   "eventVersion":1,
   "eventId":"c37f8ac9-8206-4f95-afd1-74e442d09c07",
   "assetId":"2412ba2f-4499-4933-a9ce-69f6a38f44ee",
   "unitId":"traxee:358014094033866",
   "registeredOn":"2021-03-26T22:20:59Z",
   "eventData":{
      "ref": {
         "axleLoad":123123,
         "heading":169,
         "mileage":12331,
         "latitude":50.869,
         "longitude":2.8942,
         "speed":48
      },
      "brand":"wabco",
      "faultCode":"4.5",
      "model":"TEBSE-6.5"
   }
}

Field level Description

Field	Type	Optional/Required	Description
eventSubscriptionId	String (UUID)	Required	A unique identifier representing the subscription through which this event was delivered. It ensures traceability between the event and the organization's registered RMS subscription.
eventType	String	Required	Specifies the type of event being delivered. event.tbs.dtc.raised indicates that a fault or anomaly was detected within the Trailer Braking System, resulting in a diagnostic code being raised.
eventVersion	Number	Required	eventVersion indicates the schema version of the event, allowing producers and consumers to interpret the event consistently as the schema evolves.
eventId	String (UUID)	Required	A globally unique identifier assigned to this specific event instance. Useful for event deduplication, tracking, and audit logging.
assetId	String (UUID)	Required	Identifies the physical asset (e.g., vehicle, trailer, equipment) associated with this event. Used to correlate telemetry with a specific asset in fleet management systems.
unitId	String	Required	A unique identifier of the telematics device generating the event. It often includes a namespace (e.g., traxee:) followed by the device's serial or IMEI-like identifier.
registeredOn	DateTime (ISO 8601 timestamp, UTC)	Required	The timestamp representing when the event was detected and recorded by the device.
eventData	Object	Required	Contains detailed diagnostic and contextual information captured at the moment the DTC was raised.
ref	Object	Optional
ref.axleLoad	Number (kilograms)	Optional	Reflects the axle load at the moment the diagnostic code was triggered. This value helps contextualize the braking system's conditions at the time of the fault.
ref.heading	Integer (degrees 0–359)	Optional	Indicates the vehicle's direction of travel when the fault occurred. A heading of 169° represents a southeast‑oriented movement.
ref.mileage	Number (kilometers)	Optional	Total accumulated distance traveled by the asset at the time the DTC was raised. Useful for maintenance logs, lifecycle tracking, and fault‑pattern analysis.
ref.latitude	Number (decimal degrees)	Optional	Geographic latitude identifying where the diagnostic event occurred, recorded using the WGS‑84 coordinate system.
ref.longitude	Number (decimal degrees)	Optional	Geographic longitude corresponding to the DTC event location, also in WGS‑84 format.
ref.speed	Number (km/h)	Optional	Indicates the asset's speed at the moment the diagnostic code was raised. Provides context for understanding driving conditions during the fault.
brand	String	Required	Specifies the manufacturer of the TBS unit that reported the fault. Example: wabco.
faultCode	String	Required	Represents the diagnostic trouble code associated with the fault condition. This may correspond to manufacturer‑defined TBS fault classifications (e.g., 4.5), used for troubleshooting and maintenance actions.
model	String	Required	Identifies the model of the Trailer Braking System that raised the DTC. Example: TEBSE-6.5.