Skip to content

Failed deliveries

When the partner cannot deliver the parcel, the partner reports why and brings it back to the pickup. You get two events:

  1. shipment.delivery_failed, with failedAt, failureReason and, if the partner wrote one, failureNote. The status stays PICKED_UP.
  2. shipment.returned, when the parcel is back at the pickup. The status becomes RETURNED, and endReason is the same reason.
failureReason Meaning The parcel goes back
RECIPIENT_UNREACHABLE Nobody answered at the address or on the phone. After the partner waits 10 minutes.
REFUSED Your customer refused the parcel. At once.
WRONG_ADDRESS The address was wrong, or nobody there knows the Recipient. At once.
CODE_NOT_PROVIDED Your customer did not give the Delivery Code. Only on Shipments with a code. At once.
DAMAGED The parcel was damaged. At once.

After RECIPIENT_UNREACHABLE, the partner waits 10 minutes before returning. If your customer turns up in that time, the partner can still deliver the parcel. The Shipment becomes DELIVERED, and failureReason and failedAt stay on it.

After any other reason, the parcel always goes back.

A returned Shipment is billed fee + returnFee, whatever the reason. The partner takes a photo for some reasons. Only Tujyane staff see it.

Tujyane does not tell your customer that the delivery failed, unless they use the Tujyane app (see Overview). Use shipment.delivery_failed to contact them, for example to arrange a new delivery. A new delivery is a new Shipment.