Customer logistics

The logistics client API at /client/logistics/* serves two audiences with the same URL prefix: end-customers tracking their deliveries, and gig-economy delivery workers (drivers, couriers) receiving and completing jobs. The endpoints are differentiated by the customer's role — a regular customer sees their orders, a registered driver sees the job feed.

Init and registration

init returns config the customer-side app needs (driver vs. customer detection, payment options, region settings). register is for becoming a delivery driver — accepts vehicle info, licence, insurance docs. me returns the current driver profile if the customer is registered as one.

Driver-side: jobs

available is the open-job feed (jobs needing a driver). jobs is the driver's accepted jobs. The POST creates a logistics job (used by merchant-side flows or by drivers offering to take a custom delivery).

Accept and reject

Driver picks up or passes on a job. Auto-routing in the logistics module re-offers rejected jobs to the next driver.

Pickup and dropoff lifecycle

The full state machine. Each transition writes a timestamp and (with tracking) a GPS location, which feeds the customer's order-tracking view.

Tracking and proof

tracking posts the driver's current location periodically. images is for proof-of-delivery photos.

Issues and messages

Issues are problems flagged on a job (item missing, address wrong). Messages are the chat thread between driver and customer. Contacts returns the relevant phone numbers for both parties.

Customer-side: orders and tracking

The customer side: book a delivery, list orders, track progress, cancel or modify. track returns current status, ETA, and the driver's last reported location.

Quotes

Pre-book quote: customer enters pickup, dropoff, and item details, gets a price. validated runs a stricter address verification pass before confirming.

Payment

Standard Stripe / PayPal payment surfaces, scoped to a logistics job.

Tipping and rating

Post-delivery rating goes 1-5 stars on the driver. Tips are a separate payment after-the-fact; the driver's wallet receives the tip via the finance module.

Driver presence

Drivers report online/offline and current location. Used by the dispatch service to pick the closest driver for a new job.

Driver payouts

Driver-side payout management — same shape as the finance customer wallet but scoped to logistics earnings.

Payment history

Per-job and aggregate payment history for the driver — what they've earned and when.