Cancel, retry and report
You can change a Shipment in three ways. Each is a POST with an Idempotency-Key header. Full request and answer details are in the Shipments reference.
| Action | Route | Allowed when |
|---|---|---|
| Cancel | POST /shipments/:id/cancel |
Before PICKED_UP |
| Retry | POST /shipments/:id/retry |
NO_PARTNER_FOUND, before noPartnerDeadlineAt |
| Report not received | POST /shipments/:id/not-received |
DELIVERED, before problemReportDeadlineAt, once |
Cancel
Section titled “Cancel”Cancel a Shipment you no longer need, before the partner collects the parcel. A cancellation costs nothing.
{ "reason": "Customer cancelled the order" }reason is optional, up to 300 characters, and comes back as endReason. Without it, endReason is Cancelled by the client. To cancel without a reason, send {}.
If a partner had already accepted the Shipment, the answer has offence: true, and Tujyane records an offence against your account. Repeated offences are a matter for your contract.
You cannot cancel a Shipment the partner has collected, or one that is delivered or returned (409 CANNOT_CANCEL_AFTER_PICKUP). A Shipment that is already cancelled or expired answers 409 ILLEGAL_SHIPMENT_TRANSITION.
When no partner accepts within 20 minutes, the Shipment becomes NO_PARTNER_FOUND. You have 30 minutes, until noPartnerDeadlineAt, to retry. A retry starts a new 20-minute search, and the Shipment goes back to SEARCHING.
After the deadline, the retry answers 409 RETRY_CLOSED. Create a new Shipment instead.
Report not received
Section titled “Report not received”If your customer says the parcel never arrived, report it within 24 hours of delivery:
{ "note": "Customer says nobody came to the door." }note is required, 1 to 500 characters. The Shipment stays DELIVERED, and you get shipment.not_received_reported. Tujyane staff look into the report and can credit your balance.

