Brokers' Flow
The creation of shipments by Broker customers within an Organisation (Broker) is done using the external_customer_id
field at the time of shipment creation.
On this page
Shipment creation by a Broker
To create a Broker's shipment, it is sufficient to specify the Broker client's data (email, phone, address details) in the sender's data (sender field) and specify the Broker's client ID from the Broker's internal system in the external_customer_id
field. The created shipment will have the Broker client's data on the shipping label, but the payment will be collected from the Broker's account.
POST /v1/organizations/:organization_id/shipments
Example request
curl -X POST https://api-shipx-pl.easypack24.net/v1/organizations/1/batches -H 'Authorization: Bearer token' -H 'Content-Type: application/json' -d '{
"external_customer_id": "6531",
"sender":
{
"email": "kowal@example.com",
"phone": "111222111",
"first_name": "Adrian",
"last_name": "Kowalski",
"address":{
"street":"Ulica",
"building_number":"2",
"city":"Szczecin",
"post_code":"22-100",
"country_code":"PL"
}
},
"receiver":
{
"email": "receiverrro39901172490841@example.com",
"phone": "399011724",
"first_name": "John",
"last_name": "Wayne",
"address":{
"street":"Ulica",
"building_number":"2",
"city":"Łódź",
"post_code":"25-140",
"country_code":"PL"
}
},
"parcels": { "template": "medium" },
"service": "inpost_courier_standard"
}'
List of Broker Shipments
GET /v1/organizations/:organization_id/shipments?external_customer_id=34123
Example request