Skip to content

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 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.

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.