Violation

2 min

This callback is triggered when the temperature reading on loads go beyond the set threshold for more than the time tolerance configured.

If You Are A Customer Interested In Temperature Tracking, Please Reach Out To Your Customer Success Manager.

{
  "City": "Chicago",
  "Country": "US",
  "FourKitesLoadId": 6564345,
  "Latitude": "42.0",
  "LoadNumber": "Sample_Load#",
  "Location": "Test_Location",
  "Longitude": "-74.0",
  "MaxTemperature": "100.0",
  "MessageType": "TEMPERATURE_VIOLATION",
  "MinTemperature": "10.0",
  "OdometerReading": Null,
  "ProNumber": "PRO9965767",
  "ReferenceNumbers": [
    "Carrier Point Of Contact :John Doe",
    "Carrier Phone :980-275-XXXX",
    "EQUIPMENT_TYPE:Van",
  ],
  "Sensor": "Sensor1",
  "Shipper": "Fknwshipper",
  "State": "IL",
  "Tags": [
    "Specificloadtags"
  ],
  "TemperatureReading": "200.0",
  "TemperatureUnit": "F",
  "Timestamp": "2020-08-07T03:40:27-04:00",
  "Timezone": "Eastern Time (US & Canada)",
  "TimezoneShortName": "EST",
  "TimezoneOffset": -14400,
  "TimezoneShortName": "EDT"
}

Field Definitions

Field Name	Description	Key Always Present?	Value Always Present?	Data Type	Max Length
LoadNumber	Unique shipment identifier from shipper's system	Yes	Yes	String	65535
Location	Street address, city, state, and country of latest temperature update, concatenated	Yes	Yes	String	1024
Latitude	Latitude where latest temperature update was received	Yes	Yes	String / Decimal	18 if String
Longitude	Longitude where latest temperature update was received	Yes	Yes	String / Decimal	18 if String
Timezone	e.g., Eastern	Yes	Yes	String	50
TemperatureReading	Latest temperature reading	Yes	Yes	String	1024
Sensor	Compartment or sensor unit number that sent the latest temperature update	Yes	Yes	String	1024
FourKitesLoadId	Unique load identifier from FourKites system if the load was successfully created (IsSuccess = true). The field will be null if the load creation failed in FourKites	Yes	Yes	Number	20
ProNumber	Shipment's PRO #	Yes	No	Number	10
Shipper	Unique shipper ID (permalink) from FourKites	Yes	Yes	String	No max, but realistically, not longer than 200 characters
Tags	List of tags associated with the load (empty list when tags are not present)	Yes	No	Array of string	50 for each tag
ReferenceNumbers	List of additional reference numbers associated with the load (empty list when no reference numbers are associated with the load)	Yes	No	Array of string	No max
City	City where latest temperature update was received	Yes	Yes	String	1024
State	State where latest temperature update was received	Yes	Yes	String	1024
Country	Country where latest temperature update was received	Yes	Yes	String
TemperatureUnit	Unit of measurement; Shorthand for Fahrenheit or Celsius (F or C)	Yes	Yes	String	1024
OdometerReading	Odometer reading associated with the temperature update (provided only for loads moved by dedicated carriers)	Yes	No
Timestamp	Time when the latest location update was received (in ISO 8601 format)	Yes	Yes	String in DateTime format	30
TimezoneShortName	e.g., EST	Yes	Yes	String	5
TimezoneOffset	Offset in seconds from UTC. Western Hemisphere timezones will display a negative value.	Yes	Yes	[+/-]Digits	10
MinTemperature	Minimum temperature threshold set	Yes	Yes	String
MaxTemperature	Maximum temperature threshold set	Yes	Yes	String