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
__in
lookup is not supported fortrailer_nbr
. company_id
also supports string lookup bycode
using 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. |