Locate to Yard
The locate_to_yard API allows the caller to update a trailer’s
location within the yard.
Input Parameters
Common Parameter (Applicable to All Requests)
| Category | Name | Type | Required | Description |
|---|---|---|---|---|
| options | location_barcode | String | Yes | Barcode of the yard location. |
Trailer Lookup by ID
This method requires the unique id of the trailer in the request
URL. No additional parameters are required in the request body.
URL
POST… /entity/trailer/{id}/locate_to_yard/
Example Request Body
{
"options": {
"location_barcode":
"YARDAJ0101"
}
}
Trailer Lookup by Filters
URL: POST…
/entity/trailer/locate_to_yard/Input Parameters
| Category | Name | Type | Required | Description |
|---|---|---|---|---|
| parameters | trailer_nbr | String | Yes | Trailer number to be moved. |
| parameters | company_id | Integer | No | Trailer’s company identifier. |
Additional Notes
- Only a single trailer may be moved per request.
- The
__inlookup is not supported fortrailer_nbr. company_idalso supports string lookup bycodeusing double-underscore notation:company_id__code
Example Request Body
{
"options": {
"location_barcode":
"YARDAJ0101"
},
"parameters": {
"company_id__code": "QATSTPC",
"trailer_nbr": "JPTRL280225-1"
}
}
Response Codes
| Status Code | Description |
|---|---|
| 200 OK | Trailer location updated successfully. |