Temperature Logging Data Delivery

The Sensos Label features a temperature logging system designed to provide complete and consistent temperature data for cold chain use cases, ensuring end-to-end transparency in the supply chain. This document outlines the common schema structure for temperature log data delivery when the temperature logging feature is active on the Sensos Label.

Common Schema Structure

Temperature log data is recorded at constant intervals, as defined in the device profile configuration, and delivered in JSON format. The temperature log is sent with the next outgoing message from the device, and after the message is confirmed, the log is cleared, and the device begins recording the next set of log data.

Sensos supports the customization of the JSON structure and data fields to meet specific customer requirements.

Example JSON Format

The following is an example of the JSON structure for a temperature log message delivered by a Sensos Label:

{
  "logId": "d27cf280-f932-427e-a757-684afb84550b",
  "deviceId": "351521104432851",
  "accountId": "759ebe96-8986-461b-87f2-8feba05be28e",
  "timestamp": "2023-05-23T06:30:11.0000000",
  "messageCount": 15,
  "samplingInterval": 900,
  "logData": [
    {
      "timestamp": "2023-05-23T06:00:00Z",
      "temperature": 26
    },
    {
      "timestamp": "2023-05-23T06:15:00Z",
      "temperature": null
    },
    {
      "timestamp": "2023-05-23T06:30:00Z",
      "temperature": 26
    }
  ]
}

Report Fields

The following table provides an overview of the key fields present in the temperature log data report:

Field Name	Description	Units	Type	Nullable	Detailed Description
`logId`	Temperature log ID		String	No	A unique ID for the temperature log message.
`deviceId`	Sensos Label device ID		String	No	The IMEI number of the Sensos Label sending the message.
`accountId`	Sensos account ID		String	No	A unique ID for the account the device belongs to.
`timestamp`	Time the message was created	ISO 8601	Time	No	The UTC timestamp of when the message was created.
`messageCount`	Message counter		Integer	No	A sequential number for the message, incremented with every report sent by the device.
`samplingInterval`	Temperature log sampling interval	Seconds	Integer	No	The interval, defined in the device profile, at which temperature measurements are recorded.
`logData`	Log data section		Array	No	An array of timestamp-temperature pairs that represent the temperature measurements for the specified period.
`logData[*].timestamp`	Specific measurement time	ISO 8601	Time	No	The UTC timestamp of when the temperature was logged.
`logData[*].temperature`	Specific measurement temperature	Celsius	Integer	Yes	The temperature value recorded by the device. Values range from -40°C to 70°C with 0.1-degrees resolution.

Data Integrity and Duplicates

To ensure there are no gaps in the temperature data, the log message covers the time period from the previous log message to the current one. If the message is not acknowledged by the cloud, the log is not cleared and will be sent again with the next message. This mechanism prevents data loss but may result in duplicate data under certain conditions.