Warning! Resource available only for specific countries: PL |
DispatchOrders allow ordering courier to collect shipments from the client.
Each DispatchOrder has status, which describing it's state. Available statuses:
new
- new order, which is not yet passed to execution
sent
- order is passed to execution, but is not yet accepted
On this page
DispatchOrder
resource has the following attributes:
Attribute | Type | Description | Availability |
---|---|---|---|
| String | ID number (read-only) | PL |
| String | Order status | PL |
| DateTime | Timestamp describing when order was created | PL |
| Address | Address, where courier will take over shipments | PL |
| Array[Shipment] | Array of shipments that will be taken by the courier. Required
| PL |
| String | Optional comments for the DispatchOrder | PL |
Example of DispatchOrder
resource in JSON format:
{ "href": "https://api-shipx-pl.easypack24.net/v1/dispatch_orders/1", "id": 1, "status": "sent", "address": { "id": "123", "street": "Tottenham Court Road", "building_number": "14", "post_code": "W1T 1JY", "city": "London", "country_code": "GB" }, "shipments": [ { "href": "https://api-shipx-pl.easypack24.net/v1/shipments/8", "id": 8, "tracking_number": "622111081631876319900026" } ], "comments": [ { "24", "comment": "Some Test Comment", "created_at": "2018-02-14T11:37:07.852+01:00" } ], "created_at": "2018-02-14T11:37:07.843+01:00", "updated_at": "2018-02-14T11:37:08.340+01:00" } |
DispatchOrder for specific address Generating of Using data from address, algorithm is calculating checksum, so it is very important to provide correct address without typos etc. Later, this checksum is used to determine if this Next, |
Warning! Debit clients We are not showing prices after creation of DispatchOrder, for debit clients.
|
POST /v1/organizations/:organization_id/dispatch_orders |
Available parameters:
Parameter | Type | Description | Validation | Availability |
---|---|---|---|---|
| Integer | Id of DispatchPoint for the place, from where shipment should be taken by the courier. | In general, this attribute is not required. It is starting to be required, only when | PL |
| Array | List of shipments ids, for which DispatchOrder is being generated. | Attribute is required.
| PL |
| String | Optional comment | The attribute is not required for creating DispatchOrder. But is required when DispatchOrder is updated. | PL |
| Address | Address of pick-up point (DispatchPoint) | Attribute is required. | PL |
| String | Describing time when DispatchPoint is available for picking up shipments. | Attribute is not required. | PL |
| String | Name used for generating new DispatchPoint in our database. | Attribute is required. | PL |
| String | Phone number used for generating DispatchPoint. | Attribute is required. | PL |
| String | Email address used for generating DispatchPoint. | Attribute is not required. | PL |
Example request:
curl -X POST https://api-shipx-pl.easypack24.net/v1/organizations/1/dispatch_orders -H 'Authorization: Bearer token' -H 'Content-Type: application/json' -d '{ "shipments": ["1", "2"], "comment": "Dowolny komentarz do zlecenia odbioru", "name": "Przykładowa nazwa DispatchPoint", "phone": "505404202", "email": "sample@email.com", "address": { "street": "Malborska", "building_number": "130", "city": "Krakow", "post_code": "31-209", "country_code": "PL" } }' |
Example response
HTTP/1.1 201 Created Content-Type: application/json { "href": "https://api-shipx-pl.easypack24.net/v1/dispatch_orders/1", "id": 1, "status": "sent", "address": { "id": "123", "street": "Malborska", "building_number": "130", "post_code": "30-624", "city": "Kraków", "country_code": "PL", }, "shipments": [ { "href": "https://api-shipx-pl.easypack24.net/v1/shipments/8", "id": 8, "tracking_number": "622111081631876319900026" } ], "comments": [ { "id": 24, "comment": "Dowolny komentarz do zlecenia odbioru", "created_at": "2018-02-14T11:37:07.852+01:00" } ], "created_at": "2018-02-14T11:37:07.843+01:00", "updated_at": "2018-02-14T11:37:08.340+01:00" } |
Possible Errors
|
DispatchOrders list for specific organization can be accessed by using this endpoint:
GET /v1/organizations/:organization_id/dispatch_orders |
Example request:
curl -X GET https://api-shipx-pl.easypack24.net/v1/organizations/1/dispatch_orders -H 'Authorization: Bearer token' -H 'Content-Type: application/json' |
Example response:
HTTP/1.1 200 OK Content-Type: application/json { "href": "https://api-shipx-pl.easypack24.net/v1/organizations/1/dispatch_orders", "count": 15, "per_page": 30, "page": 1, "created_at": "2016-03-21T10:13:58.625+01:00", "items": [ { "href": "https://api-shipx-pl.easypack24.net/v1/dispatch_orders/3", "id": 123, ... other attribute omitted for brevity .... } ... other items omitted for brevity ... ] } |
Possible Errors:
|
GET /v1/dispatch_orders/:id |
Example request
curl -X GET https://api-shipx-pl.easypack24.net/v1/dispatch_orders/1 -H 'Authorization: Bearer token' -H 'Content-Type: application/json' |
Example response
HTTP/1.1 200 OK Content-Type: application/json { "href": "https://api-shipx-pl.easypack24.net/v1/dispatch_orders/1", "id": 1, "status": "sent", "address": { "id": "123", "street": "Tottenham Court Road", "building_number": "14", "post_code": "W1T 1JY", "city": "London", "country_code": "GB" }, "shipments": [ { "href": "https://api-shipx-pl.easypack24.net/v1/shipments/8", "id": 8, "tracking_number": "622111081631876319900026" } ], "comments": [ { "id": 24, "comment": "Example of DispatchOrder comment", "created_at": "2018-02-14T11:37:07.852+01:00" } ], "created_at": "2018-02-14T11:37:07.843+01:00", "updated_at": "2018-02-14T11:37:08.340+01:00" } |
Possible Errors
|
Dispatch order Can be deleted in the following statuses only: new, sent
DELETE /v1/dispatch_orders/:id |
Example request
curl -X DELETE https://api-shipx-pl.easypack24.net/v1/dispatch_orders/1 -H 'Authorization: Bearer token' -H 'Content-Type: application/json' |
Response
HTTP/1.1 204 No Content Content-Type: application/json |
Error information
|
When creating a dispatch order, we allow adding additional comments.
Additionally, we allow creating a comment for an already existing Dispatch Order.
POST /v1/organizations/:organization_id/dispatch_orders/:dispatch_order_id/comment |
Request example
curl -X POST https://api-shipx-pl.easypack24.net//v1/organizations/1/dispatch_orders/1/comment -H 'Authorization: Bearer token' -H 'Content-Type: application/json' -d '{ "comment": "Dodatkowy dowolny komentarz do zlecenia odbioru" }' |
Response
HTTP/1.1 201 Created Content-Type: application/json { "id": 37, "href": "https://api-shipx-pl.easypack24.net/v1/organizations/1/dispatch_orders/17/comment", "comment": "Dodatkowy dowolny komentarz do zlecenia odbioru", "created_at": "2018-02-15T10:32:31.345+01:00" } |
When creating a dispatch order, we allow adding additional comments.
Additionally, we allow editing a comment for an already existing Dispatch Order.
PUT /v1/organizations/:organization_id/dispatch_orders/:dispatch_order_id/comment |
Request example
curl -X PUT https://api-shipx-pl.easypack24.net/v1/organizations/1/dispatch_orders/1/comment -H 'Authorization: Bearer token' -H 'Content-Type: application/json' -d '{ "id": 37, "comment": "Aktualizacja komentarza" } |
Response
HTTP/1.1 201 Created Content-Type: application/json { "id": 37, "href": "https://api-shipx-pl.easypack24.net/v1/organizations/1/dispatch_orders/17/comment", "comment": "Aktualizacja komentarza", "created_at": "2018-02-15T10:32:31.345+01:00" } |
Error information
|
We allow deleting a comment for an already existing Dispatch Order.
DELETE /v1/organizations/:organization_id/dispatch_orders/:dispatch_order_id/comment |
Request example
curl -X DELETE https://api-shipx-pl.easypack24.net/v1/organizations/1/dispatch_orders/1/comment -H 'Authorization: Bearer token' -H 'Content-Type: application/json' |
Response
HTTP/1.1 201 Created Content-Type: application/json { "href": "https://api-shipx-pl.easypack24.net/v1/dispatch_orders/2", "id": 2, "status": "sent", "external_id": 2000000001, "price": null, "address": { "id": 211, "street": "Malborska", "building_number": "130", "line1": null, "line2": null, "city": "Krakow", "post_code": "31-209", "country_code": "PL" }, "statuses": [], "shipments": [ { "href": "https://api-shipx-pl.easypack24.net/v1/shipments/103", "id": 103, "tracking_number": "520000017830390003050784" } ], "comments": [ { "id": 24, "comment": "Test 22", "created_at": "2018-05-15T11:34:54.119+02:00" }, { "id": 23, "comment": "Test 21", "created_at": "2018-05-15T11:34:51.438+02:00" }, { "id": 22, "comment": "Test 20", "created_at": "2018-05-15T11:34:48.637+02:00" } ], "created_at": "2018-05-15T09:19:32.317+02:00", "updated_at": "2018-05-15T09:19:32.448+02:00" } |