POST - Current Temperature
The Temperature Services comprises a JSON Object that allows users to create temperature events independent of a Position Event in theSystems Freight Portal.
In order to get started. you'll have to create a Basic Temperature Object. The following guides below, help you create (POST) a Temperature for a shipment.
Adding Current Temperature to a Shipment
The POST temperature endpoint allows the temperature setting of a specific shipment in the 10-4 Freight Portal.
The POST HTTP Endpoint for a temperature event creation is listed below:
HTTP Verb: POST
URI: /atlas/frexapi/shipment/temperature
Authentication: Validation Through Request Parameters
To create a temperature event, you'll need to first provide the specific FreightProviderReferenceNumber with your 10-4 provided FreightHaulerProviderXID.
To create a basic position event, the following fields are required:
1. TenFourLicensePlate
or
2. FreightProviderReferenceNumber and FreightHaulerProviderXID
Parameter | Type | Description |
---|---|---|
FreightProviderReferenceNumber | String | The external reference number of the shipper's given shipment (BOL). |
FreightHaulerProviderXID | String | 10-4's external reference id between a shipper and a carrier. |
TenFourLicensePlate | String | The external reference number of the shipper's given shipment (BOL). |
Adding the Carrier
Next, in order to assign a shipment to a specific carrier, you'll need to supply one of the following carrier identification parameters listed below:
Parameter | Type | Description |
---|---|---|
CarrierMC | String | The external reference to the carrier's MC-Number. |
CarrierDOT | String | The external reference to the carrier's USDOT-Number. |
CarrierSCAC | String | The external reference to the carrier's SCAC. |
Adding Temperature Event Data
To have the Temperature Object validate properly, you must supply the following information
Parameter | Type | Description |
---|---|---|
TemperatureReportTime | Decimal | The current date time of the temperature event. |
Temperature | Decimal | The current temperature. |
Completed Temperature Object
Here is an example of a completely valid basic shipment JSON Object:
{
"FreightProviderReferenceNumber":"12345670",
"FreightHaulerProviderXID":"ABD3820AI",
"CarrierMC":"3829182",
"TemperatureReportTime": "2017-09-30T12:00:00.000",
"Temperature": 22.14
}
Success response: True
Updated about 2 months ago