Resources
Transport order
The TransportOrder
resource contains the following data:
Object
{
"id": "36d591dd-7b4e-4d22-9cee-17bbf38181e1",
"externalAttributes": [],
"consignments": [
{
"entity": {
"name": "Assignment #A0043",
"status": "requested",
"externalAttributes": {
"reference": "#A12345",
"price": {
"value": "40.00",
"currency": "EUR"
},
"maximumPrice": {
"value": "250.75",
"currency": "EUR"
}
},
"goods": [
{
"entity": {
"productType": "Puin",
"packagingMaterial": "3m3",
"type": "items"
},
"associationType": "inline"
}
],
"documents": [
// array of Document resources...
],
"actions": [
// array of Action resources...
]
},
"associationType": "inline"
}
],
"actors": [
{
"entity": {
"id": "b1de26d6-59d4-11ed-9b6a-0242ac12000",
"name": "viaTYGO B.V.",
"contactDetails": [
{
"value": 89194101,
"remark": "Chamber of Commerce number",
"type": "other"
}
]
},
"roles": "Consignor",
"associationType": "inline"
}
],
"constraint": {
"associationType": "inline",
"entity": {
"value": {
"type": "routeConstraint",
"route": {
"type": "addressGeoReference",
"street": "Raamdwarsstraat",
"houseNumber": "7",
"houseNumberAddition": "H",
"postalCode": "1016XN",
"city": "Amsterdam",
"country": "NL"
}
}
}
}
}
Parameters
Parameter | Type | Description |
---|---|---|
id | string | uuid of transport order |
externalAttributes | array | Extra data that dont fit elsewhere in the OTM standard |
Consignments
Parameter | Type | Description |
---|---|---|
name | string | Name of Assignment |
status | string | Status of Assignment Possible options: draft, requested, inTransit, completed, cancelled |
externalAttributes.price | array | Price of Assignment |
externalAttributes.price.value | numeric | Value of price, decimal are indicated with a . e.g. 150.50 |
externalAttributes.price.currency | string | Currency of the price possible options: EUR |
externalAttributes.maximumPrice | array | Maximum Price of Assignment |
externalAttributes.maximumPrice.value | numeric | Value of price, decimal are indicated with a . e.g. 250.75 |
externalAttributes.maximumPrice.currency | string | Currency of the price possible options: EUR |
Goods
Parameter | Type | Description |
---|---|---|
productType | string | Name of Product type in viaTYGO |
PackagingType | string | Name of Product Packaging in viaTYGO |
Documents
Parameter | Type | Description |
---|---|---|
id | string | Uuid of document |
name | string | Name of document |
externalAttribute | array | |
externalAttribute.documentType | string | Type of Document in viaTYGO Possible options: Location, weigh_measurement, unknown |
content | array | |
content.url | string | The url link to the document Must be public |
content.contentType | string | Type of content possible options: link |
filename | string | Name of File |
mimeType | string | Mime type of file possible options: image/PNG, image/JPG, image/JPEG, application/PDF |
owner | array | |
owner.uuid | string | uuid of the file uploader |
Actions
Parameter | Type | Description |
---|---|---|
actionType | string | Type of action Possible options: unload, load |
constraint.value | array | |
constraint.value.type | string | OTM Constraint Possible options: timeWindowConstraint |
constraint.value.startTime | datetime | Start time of action, comfort ISO 8601 e.g. 2022-11-30T09:00:00Z |
constraint.value.EndTime | datetime | End time of action, comfort ISO 8601 e.g. 2022-11-30T11:00:00Z |
Actors
Parameter | Type | Description |
---|---|---|
id | string | Uuid of Company |
name | string | name of Company |
contactDetails | array | |
contactDetails.value | string | Chamber of Commerce number |
Roles | string | Role of Company Possible options: Consignor, Subcontractors |
Constraint
Parameter | Type | Description |
---|---|---|
type | string | OTM Constraint Possible options: routeConstraint |
Route | array | |
Route.type | string | OTM Type Possible options: routeConstraint |
Route.street | string | Street of transport order |
Route.houseNumber | string | House number of transport order |
Route.houseNumberAddition | string | House number Addition of transport order |
Route.postalCode | string | Postal code of transport order |
Route.city | string | City name of transport order |
Route.country | string | County of transport order, comfort ISO 3166-1 alpha-2 e.g. NL, BE |