Delivery methods
delivery_method states the most preferred way to deliver the parcel.
When the parcel doesn’t fit that tier, E-Parcel may fall back down the chain,
but never to a tier you ruled out.
| You send | Can be delivered as |
|---|---|
| (omitted) | Any tier, best fit |
HOME |
Letterbox or to the door, otherwise locker or pickup |
HOME_MAILBOX |
Letterbox, otherwise locker or pickup. Never to the door. |
HOME_DOOR |
To the door, otherwise locker or pickup. Never letterbox. |
LOCKER |
Parcel locker, otherwise pickup point |
PICKUP |
Pickup point only |
The tier that was actually used is returned as delivery_type by
GET /api/v1/shipments/{shipment_id}.
Lockers
Section titled “Lockers”There is no field to choose a specific locker. The carrier allocates the
locker that serves the recipient’s postal code and notifies the recipient,
which is why both recipient_email and recipient_phone are required.
Size limits
Section titled “Size limits”These limits are configured on the server and may change, so the API’s answer is always authoritative:
| Tier | Roughly fits |
|---|---|
Letterbox (HOME_MAILBOX) |
Up to 2 kg and 3 × 25 × 35 cm |
To the door (HOME_DOOR) |
Up to about 4–5 kg, mid-size boxes |
Parcel locker (LOCKER) |
Up to 25 kg |
| Heavier than 25 kg | No route: 422 |
Dimensions are matched in any orientation, so the order of length_mm,
width_mm and height_mm does not matter.
When no tier you allow fits the parcel, the API answers 422 with
"detail": "no routing rule matched this parcel" and stores nothing. Broaden
delivery_method, or send the parcel to a human queue.