Skip to main content

What are the different statuses of a pickup or delivery?

Ioana Nicolae
Updated
Here we describe the individual statuses of pickups and deliveries in a round.

Overview

  1. Pickup statuses
  2. Delivery statuses

1. Pickup statuses

Different statuses of a pickup task can be found in the tasks, rounds, and dashboard sections.

  • Pending: The pickup has not been done yet.
  • Picked up: All the items in a task have been picked up.
  • Partially picked up: Only a part of the items in tasks have been picked up.
  • Pickup failed: The task could not be picked up.
  • Transferred: The task has been picked up and transferred. This is used when the task is stored in a different warehouse when it cannot be delivered straight away. 

You can find the legend in the task section.

EN.png

2. Delivery statuses

In this section, we will explain the different statuses of a delivery task.

  • Pending: The task requires some other action to be executed (assignation to a round, dispatch, needs to be picked up...)
  • Received: All the items of the task have been "received" but the task is not in a round yet.
  • Partially received: Only a part of the items of the task have been "received" but the task is not in a round yet.
  • Arrived: All the items of the task have been dispatched.
  • Partially arrived: Only a part of the items of the task have been dispatched.
  • Prepared: The driver has prepared all of the items of the task.
  • Partially prepared: The driver has only prepared a part of the items of the task.
  • In delivery: The driver started his round.
  • Ready to collect: The task is available at the collection point to be collected by the recipient.
  • Delivered: Every item of the task has been delivered.
  • Partially delivered: Only some items of the task were delivered.
  • Delivery failed: The task could not be completed.
  • Returned: The task could not be delivered and has been returned.
  • Missing: The task is missing, meaning that it has been lost.

You can find the legend in the task section.

EN.png

3. Task Progress vs Task Status

Status and progress information are frequently confusing, especially for new joiners. What is the difference?

Task Status: The task status is derived from the different statuses of its composing items and is more business-centric. It's conceptually bound to the physical parcel and its compounding items.

Task Progress: The progress is the actual state of the task as a whole and is more data-centric. It's bound to the action to be taken.

Example: We will take a task with a progress of COMPLETED. Its status could either be DELIVERED, PARTIAL_DELIVERED, NOT_DELIVERED or RETURNED. In all cases, the data lifecycle of the task has ended because the progress is COMPLETED. If our client wants to try delivering the same parcel again, in case of NOT_DELIVERED for instance, a new task will have to be created.

"The task of attempting a delivery has been completed even though none of the items composing the parcel could be delivered."

4. Task Progress States

After announcements, tasks are going through the following states (in the following order):

  • ERROR: If the task got geocoding errors

  • ANNOUNCED: If the task had validation errors

  • UNPLANNED: When the task is ready but doesn't have a date

  • GEOCODED: When the task is ready to go in a round (note: it's READY in the UI)

  • ASSIGNED: When the task is in a round

  • ONGOING: The task is on its way to the recipient, which means that the round the task belongs to has started

  • MISSING: Applicable only when the dispatcher or driver preparation has been activated. The round of the task has been started by the driver but the task has not been scanned, it will directly go to missing. It can be re-announced in the task itself.

  • READY_TO_COLLECT: The task is ready to be collected by the recipient

  • COMPLETED: The task has been completed, meaning that it is delivered, partially delivered or not delivered

  • DISCARDED: The task has been (soft) deleted

Note: The legend is also visible on the UI in Task view > Legend

Progress in Planning vs Non-Planning Flows

Planning Flow: When a task is announced in a planning flow, it is announced without a date. It goes to unplanned, it cannot be optimized until it receives a date, when it receives a date, it goes to READY

Non-Planning Flow: When a task is announced in a non-planning flow, it is announced with a date straight away. It goes from Announced to ready and can be optimized straight away.

Take note that between Announced and Ready there might be a geocoding error.

5. Progress and Status Combinations

The following combinations are possible between Progress and Status:

ANNOUNCED

  • PENDING

ERROR

  • PENDING

UNPLANNED

  • PENDING

  • RECEIVED

DISCARDED

  • PENDING

  • RECEIVED

GEOCODED

  • PENDING (The task is not in a round)

  • RECEIVED (or PARTIAL_RECEIVED) (The task was scanned by the dispatcher)

ASSIGNED

  • PENDING (The dispatch is enabled and the task wasn't dispatched)

  • ARRIVED (or PARTIAL_ARRIVED) (The task is in a round and the dispatch is disabled or the dispatcher scanned the task)

  • PREPARED (or PARTIAL_PREPARED) (The driver prepared the task)

ONGOING

  • DEPARTED

READY_TO_COLLECT

  • READY_TO_COLLECT

COMPLETED

  • DELIVERED (or PARTIAL_DELIVERED)

  • NOT_DELIVERED

  • RETURNED

  • PICKED_UP (or PARTIAL_PICKED_UP)

  • NOT_PICKED_UP

MISSING

MISSING (The round started and the task wasn't prepared)

Comments

0 comments

Please sign in to leave a comment.