Pallet presence sensor

twinzo system allows for collecting localization data from monitoring devices. Some devices (mainly forklifts or tuggers) provide information about pallet presence and this guide describes how to integrate and send these data to twinzo´s REST API.

Configuration

The data about pallet presence are usually connected with a monitored device where the RTLS is running. The whole process of configuring devices for RTLS is available here: RTLS - Real-Time Location System and Devices

The login name is an essential parameter for the pallet presence sensor because it is a “key” to connect the pallet presence sensor with the exact monitored device.

Device Login name

Swagger Sensors Section

Pallet presence data are sent as sensor data using /v{version}/sensors/batch.

The Swagger Sensors section provides a detailed description of the API for sensor data.

Example

There is an example of JSON payload for a POST request.

[
  {
    "Login": "tPalletSense-acZRbpAqeA",
    "SensorData": [
      {
        "Timestamp": 1700491683703,
        "Quantity": "PalletDetected",
        "Value": "true",
        "Unit": "",
        "DataType": "Boolean"
      }
    ]
  }
]

Data properties

The data payload is a JSON object that contains:

Login	Login has to contain tPalletSense-yourDeviceLoginName. As you can see in the example:
Timestamp	A Unix timestamp in milliseconds that represents the time when the data was collected.
Quantity	A string that represents the quantity of data collected. For Pallet presence data it has to be: "PalletDetected".
Value	A string that represents the value of the data collected. For Pallet presence data: true/false.
Unit	A string that represents the unit of measurement for the data collected. For Pallet presence data: empty.
DataType	A string that represents the type of data collected. For Pallet presence data: Boolean.

Critical Announcement

The Pallet Presence data are set to be received every 3 seconds. This is because RTLS data are collected every 3 seconds too.