Integration process with InPost services
Create shipment
Available modes of shipment creation:
Simplified mode Creating a shipment in the simplified mode
offer mode Shipment creation in offer mode
The process of creating a shipment in the offer mode:
Create shipment > Select offer (manual or via webhook) > Paying for shipment (for prepaid account it means automatic collection of funds, for postpaid account it means confirmation of shipment)
In the simplified mode, you indicate the service and automatically select the offer and pay for the shipment to the indicated service. In the offer mode, you do not indicate the service, you select one of the returned offers and pay for it.
Creating and viewing shipment batches Creating and viewing shipment batches
Multi-packet shipments can only be created for courier services. Parcel locker do not support multipacking, you can always generate more shipments for one order with the same data.
If a ParcelPoint is given as a pickup point (target_point": "POP-WAW364"
) the service will be changed from "service": "inpost_locker_standard"
to "service": "inpost_locker_customer_service_point"
.
Available services for prepaid account
| Parcel locker shipment - standard |
| Parcel locker shipment - Allegro Paczkomat® InPost. |
| Parcel locker shipment - Pass-Thru |
| Courier shipment - Allegro MiniKurier24 InPost |
| Courier shipment - Allegro Kurier24 InPost. |
| Courier shipment - InPost Courier C2C (service for a retail customer - prepaid) |
Available services for your postpeid account
| Parcel locker shipment - standard |
| Parcel locker shipment - Allegro Paczkomat® InPost. |
| Parcel locker shipment - Pass-Thru |
| Courier shipment - Allegro MiniKurier24 InPost |
| Courier shipment - Allegro Kurier24 InPost. |
| Courier shipment - InPost Courier C2C (service for a retail customer - prepaid) |
| Courier shipment standard |
| Courier shipment with delivery until 10:00 |
| Courier shipment with delivery until 12:00 |
| Courier shipment with delivery until 17:00 |
| Courier shipment Pallet Standard |
Checking the status of a shipment
Because shipment buying is asynchronous, the server will respond with information about the shipment that does not include changes caused by the purchase (status change, tracking number assignment, as this information will only be available after a certain period of time).
To check the status of a shipment or get a tracking number, please query the shipment with its ID or use webhook notifications.
Sample request
GET /v1/shipments/ID_Shipments HTTP/1.1
Host: api-shipx-pl.easypack24.net
Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzUxMiJ9...
Response
Sample webhook notification:
{
"event_ts": "2018-07-17 12:57:29 +0200",
"event": "shipment_confirmed",
"organization_id": 35,
"created_by_id": null,
"payload": {
"shipment_id": 87235,
"tracking_number": "633300208831612315289193"
}
Shipment label download
There are 2 methods available:
One label download Shipment label download
Downloading multiple labels Shipment label download | Multiple shipments label download
Creating new DispatchOrder
Courier service should be ordered to your address if you do not have a standing collection order or if you want to collect from another location.
Detailed information at: Dispatch Order | Creating new DispatchOrder
Printing dispatch orders
The functionality allows for generating manifests for shipments whether or not they have dispatch orders.
Detailed information at: Printing dispatch orders
2 methods are available:
Method for generating a manifest for the dispatch order (printout)
Method for generating a manifest for the indicated shipment IDs (printouts)
Shipment Tracking
Below we present the available ways of downloading information about the current status of a shipment in the logistics process. You can use them to retrieve information about the creation of a shipment, the last status change, or the history of statuses.
Tracking resource Shipment Tracking
Webhook notifications Webhooks