Handover

Introduction

A handover job represents the handover of an order to the end consumer or shipping provider.

Despite general information like the order date, tenant order ID or a reference to the corresponding facility, a handover job carries handover relevant information. This covers:

  • Handover channel:

    • Delivery: will be handed over to a shipping service provider

    • Collect: will it be handed over to the end customer

  • Handover job cancel reason: Can be defined if the parcel(s) were not handed over

A handover job is automatically created when a parcel has changed to status FINISHED while the related pick job was in status CLOSED or a pick job has changed to status CLOSED and there is at least one parcel of the related shipment that is in status FINISHED.

Automatic vs. manual handover job completion

A handover job is completed (set to status HANDED_OVER) automatically when a track-and-trace (T&T) event is received from a carrier with T&T enabled (if a carrier integration is in place).

It is possible to manually set a handover job to status HANDED_OVER, which triggers the handover event even before the carrier has physically scanned or picked up the parcel. In this case, the information from the handover job, such as items and quantities, is used to mark all associated line items as handed over. This ensures that line item quantities are passed correctly.

Please go to the Developer Docs for more information on creating and managing handover jobs via API. Go to the Apps & Clients section for more guidance on using handover jobs in our apps.

Last updated