Architecture
DashLink parcel delivery flows through several operational stages that differ from standard Drive deliveries.
High-Level Flow
1. Label Creation
Either:
- Synchronous — After the merchant submits a Create Delivery or Quote+Accept call
- Asynchronous — Merchant generates labels in bulk and later uploads shipment data
Tracking code + barcode are printed on a 4×6 label.
2. Merchant Hand-Off to DashLink
Packages leave the merchant facility and travel inbound to a DashLink origin or regional facility.
Facility arrival is recorded via events such as:
parcel_origin_arrivedparcel_scanned(first scan at a facility)
3. Mid-Mile Processing
Parcels flow through DashLink sortation centers:
parcel_mid_mile_arrivedparcel_mid_mile_departed
A parcel may pass through multiple mid-mile nodes depending on geography.
4. Last-Mile Delivery
A Dasher picks up the parcel:
dasher_picked_updasher_confirmed_dropoff_arrival- Terminal events:
dasher_dropped_off(delivered)parcel_return_to_merchant(terminal undeliverable)
Error / Exception Flows
DashLink has built-in support for exception states:
parcel_awaiting(missing from merchant truck, etc.)parcel_delayed(driver unassigned, misplaced at sortation center)parcel_lost_in_transitparcel_damaged