Parcel life cycle for express

What means parcel life cycle for express?

Is the states flow of a parcel when the selected shipping type has express modality.

This modality of delivery normally has a direct route to reach the final destination (recipient or returned to the sender) without passing through a warehouse.

From request delivery to pickup

In this slice of the flow the parcel is created on our system and we search for a driver to pick up the parcel.

The states where the parcel goes through are:

• ready: Requester creates the parcel in or system.
• scheduled: The sender schedules the parcel pick up.
• qualifiedforpickup: The delivery is searching for a driver.
• onroutetopickup: Driver is assigned, and is on the way to pick up the parcel.
• pickingup: The driver arrives to the pick up location and is picking up the parcel.

At this point the parcel can be picked up or for a set of reasons the parcel could not be picked up.

• pickupfailed: The driver could not pick up the parcel, this state has several substates with the reason:
  • Sender not found.
  • Sender arrived to late.
  • Sender address wrong.
  • Sender address not safe.
  • The parcel is suspicious.
  • The parcel packaging is not suitable.
  • The parcel is too big or heavy for the driver's vehicle.
  • A payment was requested.
  • Other with comments.
  • The place was closed.
  • Sender not found the parcel.
  • Already picked up.
  • Delivery cancelled.

From pickup to delivery point

If the parcel was picked up the driver starts the last mile delivery:

• intransit: The route of last mile delivery where the parcel is, is in progress.
• delivering: The driver is in the drop-off location delivering the parcel.

At delivery point

At this point the parcel can be delivered to the recipient:

• delivered: The parcel has been delivered to the recipient.
  • This states has a proof of delivery based on requester configuration

Or for a set of reasons the parcel could not be delivered to the recipient:

• undelivered: The parcel could not be delivered to the recipient, this state has several substates with the reason:
  • recipient not found.
  • rejected by recipient.
  • wrong address.
  • unsafe delivery zone.
  • invalid proof.
  • other.

Afer a undelivered state can happens two scenarios, the parcel(s) could be returned to the sender or not, based on client configuration.

If the parcels has not to be returned the states are:

• returnejected: The return to the sender is not required and the delivery cannot be completed.

Returning to sender

If the parcels has to be returned the states are:

• onroutetoreturn: The driver is in the route to return the parcel to the sender.
• returning: The driver is in the parcel pick-up location returning the parcel to the sender.

At this point the parcel can be returned to the sender:

• returned: The parcel has been returned to the sender.

Or if the parcel could not be returned to the sender:

• returnfailed: The driver could not return the parcel, this state has several substates with the reason:
  • sender not found.
  • rejected by sender.
  • wrong address.
  • unsafe delivery zone.
  • other.

Final states

• delivered: The parcel has been delivered to the recipient.
• returnejected: The parcel has been rejected by the sender.
• returned: The parcel has been returned to the sender.
• returnfailed: The driver could not return the parcel, this state has several substates with the reason:
  • sender not found.
  • rejected by sender.
  • wrong address.
  • unsafe delivery zone.
  • other.
• incident: The parcel has been involved in an incident (this state has several substates with the reason).
  • payment_method_declined: There is a problem with your payment method, and the delivery has not been accepted. Check your payment methods in the business web
  • no_payment_methods: There is no payment method configured. Check your payment methods in the business web
    requester_no_found_or_unauthorized: The requester sent in this request is not valid.
  • invalid_pick_up_location: There is no fleet available for your delivery area, or it's not properly configured. Please get in touch with the Logistics Team to check if we can cover your delivery area.
  • delivery_already_exists: This parcel has been delivered already.
  • unknown: Something has happened but, unfortunately, we haven't detected the reason. If the problem persists, please get in touch with the Logistics Team.