Skip to content

Shipment lifecycle

A Shipment starts in AWAITING_CONFIRMATION and ends in one of four final statuses: DELIVERED, RETURNED, CANCELLED or EXPIRED.

Shipment statuses and the transitions between them, from AWAITING_CONFIRMATION to the final statuses DELIVERED, RETURNED, CANCELLED and EXPIRED.Shipment statuses and the transitions between them, from AWAITING_CONFIRMATION to the final statuses DELIVERED, RETURNED, CANCELLED and EXPIRED.
Status Meaning What you can do
AWAITING_CONFIRMATION Created and priced. No partner is contacted. Confirm before confirmBy, or cancel.
SEARCHING Confirmed. Tujyane offers it to one partner at a time. Cancel.
ASSIGNED A partner accepted and is going to the pickup. partner is set. Cancel. Tujyane records an offence.
PICKED_UP The partner has the parcel. Wait.
DELIVERED Delivered. deliveryConfirmedBy says who confirmed it. Report it not received, within 24 hours.
RETURNED The partner could not deliver it and brought the parcel back to the pickup. Nothing.
NO_PARTNER_FOUND No partner accepted within 20 minutes. Retry before noPartnerDeadlineAt, or cancel.
CANCELLED You or Tujyane cancelled it before pickup. Nothing.
EXPIRED You did not confirm it within 30 minutes. Create a new Shipment.
From To When
AWAITING_CONFIRMATION SEARCHING You confirm it.
AWAITING_CONFIRMATION EXPIRED 30 minutes pass without a confirm.
SEARCHING ASSIGNED A partner accepts.
SEARCHING NO_PARTNER_FOUND Nobody accepts within 20 minutes.
ASSIGNED SEARCHING The partner gives the Shipment back, or does not come to the pickup.
ASSIGNED PICKED_UP The partner collects the parcel.
NO_PARTNER_FOUND SEARCHING You retry, within 30 minutes.
PICKED_UP DELIVERED The partner delivers it, or Tujyane staff confirm the delivery.
PICKED_UP RETURNED The delivery failed and the parcel is back at the pickup.
Any status before PICKED_UP CANCELLED You or Tujyane cancel it.
  • Confirm within 30 minutes. confirmBy is 30 minutes after creation. Confirm only after your customer has paid you.
  • The search lasts 20 minutes. Each offer gives one partner 45 seconds to answer. Then the next nearest partner gets it.
  • A partner can give a Shipment back before pickup. The Shipment goes back to SEARCHING, and you get shipment.partner_unassigned with partner set to null. It returns to ASSIGNED when another partner accepts.
  • Retry within 30 minutes of NO_PARTNER_FOUND. If you do not retry by noPartnerDeadlineAt, the Shipment stays NO_PARTNER_FOUND. Tujyane then sets endedAt and endReason (NO_PARTNER_FOUND) and sends no event. Treat noPartnerDeadlineAt as the deadline.
  • Report a problem within 24 hours. After DELIVERED, you can report the parcel not received until problemReportDeadlineAt.