How DelivApp Auto-Dispatch Works (and what controls it)

TABLE OF CONTENT

• 1) Operating modes
• 2) When automation starts
• 3) Courier notifications (who hears first)
• 4) Batching / cycles (multi-order trips)
• 5) Geo & transport constraints
• 6) ETA baselines (routing accuracy)
• 7) Helpful UI flags (don’t change the algorithm)

1) Operating modes

• Manual — dispatcher assigns everything by hand.

• Auto Pull — orders are assigned when couriers pull them.

• Auto Push — system pushes orders to available couriers based on ETA/availability.

• Special Auto Push — auto-push only from designated pickup points (hubs/selected stores).

2) When automation starts

• ASAP orders — “Begin Automation X minutes before order is ready”.

  0 = start only after “Ready for pickup”. 5–10 = start early so a courier can arrive on time.

• Scheduled orders — “Allow automatic manipulation when the scheduled time is within Y minutes”.

  Within Y minutes of the target slot, the system may (re)route/assign to hit the promise time.

Example starting values: ASAP X=7–10, Scheduled Y=35–45.

3) Courier notifications (who hears first)

Strategy options:

• Distance: offer one-by-one to the nearest.

• Radius: notify everyone within the radius at once.

• Fairness: prefer couriers in radius who are less busy this shift.

Related controls:

• First notify radius (m). Initial circle for offers.

• Expand courier pool after (min). If nobody accepts in T minutes, broaden the pool (larger radius/relaxed criteria).

• Penalty after reject (min). After an active reject, the courier temporarily does not receive new offers.

Example: Strategy Distance, Radius 800–1200 m, Expand after 2–3 min, Penalty 2–5 min.

4) Batching / cycles (multi-order trips)

• Max orders per cycle. Max number of orders grouped into one run (often 2–4).

• Max pickup time (min). Total time budget for all pickups in the cycle.

• Auto-approve cycle. If ON, automatically approve system-built cycles.

• Automatic extend cycle. Allow adding a suitable order to an existing cycle.

Example: Max orders 3, Max pickup time 20 min, Auto-approve ON (if ops are disciplined).

5) Geo & transport constraints

• Limit pickup radius (m). If you allow multi-pickup (collecting multiple orders in one cycle from different stores), this limits the maximum distance between pickup points that can be grouped together.

• Max service distance for bicycle (m). Cap distance for bike couriers.

• Assign large orders to car only. Route oversized/heavy orders to car couriers.

• Out-of-delivery area → Require Assistance. If accepting out-of-area orders is allowed, such orders automatically receive Require Assistance and need manual dispatcher approval. If accepting OOA is disabled, they are auto-rejected.

6) ETA baselines (routing accuracy)

• Average pickup time (min) and Average drop-off duration (min) feed ETA, deadline checks, and batching feasibility.

  Example: Pickup 3 min, Drop-off 6 min.

7) Helpful UI flags (don’t change the algorithm)

• Show order payment status (visibility only).

• Hide pickup countdown timer (dashboard UI).

• Enable takeaway orders (supports pickup workflows).