Load->Add
Add (Load Function)
This function adds a single load record.
XML Request
The Add function takes the following request parameters:
| Parameter | Type | Description |
|---|---|---|
| LoadId | String | The load's unique identifier |
| LoadTime | dateTime | Time stamp (in GMT) indicating when the load was loaded on to the tractor-trailer |
| UnLoadTime | dateTime | Time stamp (in GMT) indicating when the load was unloaded from the tractor-trailer |
| TrailerIds | String | Trailers assigned to the load (may be more than one) |
| TractorId | String | Tractor assigned to the load |
| LoadDescriptionType | Unsigned Byte | Type of load description: 1=Bill of lading, 2=Shipping document, 3=Shipper address and commodity |
| LoadDescription | String | Text of the load description, such as a bill of lading |
| DriverId | String | Driver's HOS ID, optional for the web service to function but REQUIRED for actual implementation |
<soap:Body>
<Add xmlns="http://www.qualcomm.com">
<ld>
<LoadId>string</LoadId>
<LoadTime>dateTime</LoadTime>
<UnLoadTime>dateTime</UnLoadTime>
<TrailerIds>string</TrailerIds>
<TractorId>string</TractorId>
<LoadDescriptionType>unsignedByte</LoadDescriptionType>
<LoadDescription>string</LoadDescription>
<DriverId>string</DriverId>
</ld>
</Add>
</soap:Body>
LoadTime and UnloadTime data conventions
When the LoadTime and UnloadTime are the same value, the load date becomes the date specified and the unload time becomes midnight (local time) of the next day.
When the LoadTime and UnloadTime are not the same value, the load date become the date specified in LoadTime and the Unload date becomes the date specified in UnloadTime.
Differences between loads entered on the MPC unit and loads entered via the Load.asmx->Add function.
When a load is entered on the MCP unit, it is associated with both the active and inactive driver. When a load is added via the Load.asmx->Add function, it is only associated with the driver specified in the Add call. If the Co-Driver needs to be associated with this load, it must be done via another Load.asmx->Add call specifying that driver.
Driver(s) specified or not
If a load is added to a vehicle with no driver id specified, every driver who logs into that vehicle between the start and end time of the load gets credit for that load on their logs.
XML Response
The return result indicates success or failure via SOAP exceptions.
<soap:Body> <AddResponse xmlns="http://www.qualcomm.com" /> </soap:Body>