Description of transport orders elements with the usage and conditions.
Main node of transport order
Name | Type | Example | Description |
id | string | e5447fa5-b527-4e3e-b30e-414f139d745a | Transport order unique identifier |
legacy freight id | string | 123-456-789 | Legacy id |
number | string | TO/2020/01/123 | Given transport order |
status | Object | Transport order status | |
status.Comment | string | Example status comment | Additional transport order information |
status.Value | string | proposal-waiting | Status |
acceptance | string | ||
archived_at | string | 2020-04-22T12:12:04.757Z | Date and time of freight creation |
created_at | string | 2020-04-22T12:12:04.757Z | Date and time of last update |
driver | Object | Driver assigned to transport order | |
vehicle | Object | Vehicle assigned to transport order | |
invoice | string | IN/2020/11 | Invoice number |
freight | Object | Contains all information about route, loads and operations |
Freight
Elements
Name | Type | Example | Description |
id | string | 12345-abcde-67890-fghij | Identifier of freight |
carrier | Object | Information about carrier assigned to transport order | |
first_loading_place | Object | Basic information about the first spot on route | |
last_unloading_place | Object | Basic information about the first spot on route | |
reference_number | string | 2020-04-23T13:00:00.000Z | Freight reference number |
shipper | Object | Information about shipper who created transport order | |
spots | Object | Detailed information about each spot on transport order’s route |
Freight – Carrier
Name | Type | Example | Description |
assignee | Object | Information about carrier’s employee assigned to transport order | |
assignee.account_id | int | 123 | Assigned employee’s account number |
assignee.family_name | string | Doe | Assigned employee’s family name |
assignee.given_name | string | John | Assigned employee’s given name |
assignee.trans_id | string | 190-10 | Assigned employee’s TransId |
legal_name | Object | Carrier’s full legal name | |
vat_id | Object | Carrier’s VAT identification number |
Freight – First loading place and last unloading place
First and last spot and route, created from spots
Name | Type | Example | Description |
country | string | de | Country of spot location |
locality | string | City | City |
postal_code | string | 52200 | Postal code |
date | string | 2020-04-23T13:00:00.000Z | Date of operation |
timespans | Object | Time period for operation | |
timespans.begin | string | 2020-04-23T13:00:00.000Z | Beginning of operation |
timespans.end | string | 2020-04-23T13:00:00.000Z | End of operation |
Freight – Spots
Information about route points
Name | Type | Example | Description |
id | string | 12345-abcde-67890-fghij | |
description | string | Example description | Additional spot description |
name | string | Example name | Spot name |
operations | Object | Details of loading and unloading operations | |
operations.id | int | 12 | Operation identifier |
operations.loads | Object | Collection of loads assigned to freight | |
operations.operation_order | int | 1 | Order of load operations in spot |
operations.timespans | Object | Time period for operation | |
operations.place | Object | Address and location for operation spot | |
operations.place.address | Object | Address details | |
operations.place.address.description | string | Example description | Additional spot description |
operations.place.address.country | string | fr | Spot’s location country using ISO codes |
operations.place.address.locality | string | City | City |
operations.place.address.postal_code | string | 2200 | Postal code |
operations.place.address.street | string | Street | Street |
operations.place.address.number | string | 123 | Number |
operations.place.coordinates | Object | Location details | |
operations.place.address.coordinates.latitude | float | 56.123 | Latitude |
operations.place.address.coordinates.longitude | float | 11.235 | Longitude |
operations.place.address.detailed_location_id | string | 123 | Additional spot id |
operations.place.address.coordinates.foreign_id | string | 123 | External spot id |
operations.place.address.coordinates.location_id | string | 123 | Spot id |
operations.spot_order | string | 1 | Defines the order of completing the points on the route |
Important!
Weight is always represented in tons.
Height, length and width are always represented in meters.