Endpoint - Despatch
Some over view description or text goes here.
Request
Post
DespatchRequest
DespatchRequest
Field Name | Type | Description |
---|---|---|
AuthorizationToken | String | Authorization Token from the customers integration. |
Orders | DespatchOrder[] | Array of dispatches, note due to splitting / cancellation functionality in Linnworks you many not receive all items from the original order. If a channel does not support line time or quantity despatch then it's suggested to mark as despatched on the first reference and ignore there after. See DespatchOrder Table. |
DespatchOrder
DespatchOrder
Field Name | Type | Description |
---|---|---|
ReferenceNumber | String | Unique reference of the order. |
ShippingVendor | String | Shipping Ventor / Carrier. |
ShippingMethod | String | Linnworks shipping method. |
TrackingNumber | String | Tracking Number. |
SecondaryTrackingNumbers | String[] | Additional Tracking numbers. |
ProcessedOn | DateTime | Date order was processed in UTC format. Format: yyyy-MM-dd HH:mm:ssZ |
Items | DespatchItem[] | Order items that are related to the Despatch. If the customer has used split packaging in Linnworks the order items might appear multiple times in different groups where they might exist in different packages. See Despatch Item table. |
DespatchItem
DespatchItem
Field Name | Type | Description |
---|---|---|
SKU | String | Channel SKU from the order item. |
OrderLineNumber | String | Unique line number from the order item. |
DespatchedQuantity | String | Quantity despatched, due to splits this might be less than the original order and additional quantity may be provided later. |
Sample
{
"Orders": [
{
"ReferenceNumber": "12345",
"ShippingVendor": "Royal Mail",
"ShippingMethod": "First Class",
"TrackingNumber": "TrackingNumber 1",
"SecondaryTrackingNumbers": null,
"ProcessedOn": "2016-08-29T07:49:51.5036339Z",
"Items": [
{
"SKU": "SKU1234",
"OrderLineNumber": "1",
"DespatchedQuantity": 2
},
{
"SKU": "SKU1235",
"OrderLineNumber": "2",
"DespatchedQuantity": 2
}
]
}
],
"AuthorizationToken": "b7f4ee81bc4e4363adcd00eced0ea471"
}
Response
DespatchResponse
DespatchResponse
Field Name | Type | Description |
---|---|---|
Error | String | If there was an error with the request. |
Orders | DespatchOrderResponse[] | Array of orders and the results of the despatch. If there are no errors it is still expected to return the reference with no error otherwise we assume the order was not found and do not confirm despatch back to the user. See Despatch Order Response table. |
DespatchOrderResponse
DespatchOrderResponse
Field Name | Type | Description |
---|---|---|
Error | String | If there was an error with the individual order. |
ReferenceNumber | String | Reference number of the order. |
Sample
{
"Error": null,
"Orders": [
{
"Error": "Despatch failed for some reason",
"ReferenceNumber": "12345"
},
{
"Error": null,
"ReferenceNumber": "12346"
}
]
}
Updated over 1 year ago