👍
The railway telematics interface now uses a unified message format with standardized information such as the UIC wagon number in the header.

Affected Event Types

The new format applies to the following event types via AWS SNS:

Event Type	Description
TRAIN_UPDATE_RECEIVED	Train information and wagon position in the train
RESOURCE_POSITION_RECEIVED	GPS position of the wagon
SENSOR_VALUE_TEMPERATURE_RECEIVED	Temperature data from the sensor
SHOCK_DETECTION_RECEIVED	Shock detection / vibrations

Message Format

Basic structure

Each message consists of a header and a payload:

{
  "header": {
    // Standardized information
  },
  "payload": {
    // Event-specific data
  }
}

Header (Standardised)

The header contains:

Field	Description	Example
eventType	Type of message	"TRAIN_UPDATE_RECEIVED"
timestamp	Timestamp (ISO 8601)	"2025-09-01T09:22:09.000Z"
identifier	UIC wagon number	"33 80 2742 528-3"

Payload (Event-specific)

The payload section remains unchanged and contains the event-specific data.

Examples

Example 1: Train information (TRAIN_UPDATE_RECEIVED)

{
"header": {
  "eventType": "TRAIN_UPDATE_RECEIVED",
  "timestamp": "2025-09-01T09:22:09.000Z",
  "identifier": "33 80 2742 528-3"
},
"payload": {
  "trainNumber": "63200",
  "relativePosition": 73
}
}

Meaning


UIC wagon number	33 80 2742 528-3
Located in train number	63200
At position	73 (relative position in the train)

Example 2: GPS position (RESOURCE_POSITION_RECEIVED)

{
  "header": {
    "eventType": "RESOURCE_POSITION_RECEIVED",
    "timestamp": "2025-01-05T18:11:58.000Z",
    "identifier": "33 80 274 2 214-0"
  },
  "payload": {
    "ITSS_TransportDeviceID": "33 80 274 2 214-0",
    "ITSS_GeofenceEventList": [
      {
        "UTCtimestamp": 1767707518,
        "ITSS_Geofence": {
          "GeofenceID": "82af5e51-e4f4-4fd5-a95f-9b5dc61d2581",
          "GeofenceName": "Braunschweig Hgbf",
          "LEO_GeofenceAdditionDescription": ""
        },
        "ITSS_GeofenceEventTrigger": "enter",
        "GNSS_Position": {
          "GNSS_UTCtimestamp": 1767707518,
          "GNSS_Latitude": 52.248946,
          "GNSS_Longitude": 10.552375
        }
      }
    ]
  }
}

Meaning


UIC wagon number	33 80 274 2 214-0
Geofence event	Entry into Braunschweig Hgbf
GPS position at entry	Latitude: 52.248946, Longitude: 10.552375
Geofence ID	82af5e51-e4f4-4fd5-a95f-9b5dc61d2581
Time (UTC)	1767707518 (Unix Timestamp)

Example 3: Temperature measurement (SENSOR_VALUE_TEMPERATURE_RECEIVED)

{
  "header": {
    "eventType": "SENSOR_VALUE_TEMPERATURE_RECEIVED",
    "timestamp": "2025-01-05T14:48:02.000Z",
    "identifier": "33 80 2742 652-1"
  },
  "payload": {
    "ITSS_TransportDeviceID": "33 80 2742 652-1",
    "ITSS_TelematicsDeviceID": "1077-012265",
    "ITSS_SensorValueList": [
      {
        "SamplingUTCTimestamp": 1767694882,
        "Value": 267.9781,
        "LEO_Celsius": -5.17,
        "LEO_Fahrenheit": 22.69,
        "ITSS_SensorType": "temperature",
        "ITSS_SensorPosition": "waggon"
      }
    ],
    "ITSS_GeofenceEventList": [
      {
        "GNSS_Position": {
          "GNSS_UTCtimestamp": null
        }
      }
    ]
  }
}

Meaning


UIC wagon number	33 80 2742 652-1
Telematics device	1077-012265
Measured temperature	`-5,17°C` / `22,69°F` / `267,98 K`
Sensor type	temperature
Sensor position	waggon
Measurement time (UTC)	1767694882` (Unix Timestamp)

Example 4: Shock detection (SHOCK_DETECTION_RECEIVED)

{
  "header": {
    "eventType": "SHOCK_DETECTION_RECEIVED",
    "timestamp": "2025-01-05T14:29:19.000Z",
    "identifier": "42 80 2468 212-5"
  },
  "payload": {
    "ITSS_TransportDeviceID": "428024682125",
    "ITSS_TelematicsDeviceID": "urn:epc:id:giai:426055689.016040908368414511",
    "UTCtimestamp": 1767694159,
    "GNSS_Position": {
      "GNSS_UTCtimestamp": 1767694159,
      "GNSS_Latitude": 52.42054,
      "GNSS_Longitude": 9.669214444444444,
      "GNSS_Speed_kmph": null,
      "GNSS_Heading_deg": 360,
      "LEO_Geofences": [
        {
          "GeofenceID": "ef805545-86f4-423e-a6c3-4db1583c5315",
          "GeofenceName": "VW Hannover",
          "LEO_GeofenceAdditionDescription": "",
          "LEO_GeofenceType": "RAIL",
          "LEO_GeofenceCategory": "LOCATION"
        }
      ]
    },
    "X-Axis_triggered": false,
    "Y-Axis_triggered": true,
    "Z-Axis_triggered": false,
    "X-Axis": 1461.43,
    "Y-Axis": 2462.4,
    "Z-Axis": 2542.48
  }
}

Meaning


UIC wagon number	42 80 2468 212-5
Telematics device	urn:epc:id:giai:426055689.016040908368414511
Shock detection triggered on Y-axis	(lateral vibration)
Acceleration value - X-axis	1461.43 (not triggered)
Acceleration value - Y-axis	2462.4 (triggered)
Acceleration value - Z-axis	2542.48 (not triggered)	a
GPS position - Latitude	52.42054
GPS position - Longitude	9.669214
Geofence	VW Hannover (Type: RAIL, Category: LOCATION)
Time (UTC)	1767694159 (Unix Timestamp)

👍
If you have questions about the new interface structure, please contact your support team.