← Lalamove integration

Lalamove v3 Order Flow: Quotations, Stops, and Orders

Lalamove API v3 uses a strict two-step flow to book a delivery:

  1. Request a Quotation (lalamove_create_quotation): - Call lalamove_get_cities first if you do not know the valid serviceType keys (e.g. MOTORCYCLE, CAR, VAN, TRUCK330) or specialRequests for the target city. - Pass 2 to 16 stops (stop 0 is pickup, stops 1..n are drop-offs). Each stop requires coordinates: { lat, lng } (as strings) and address. - The response returns a quotationId (valid for 5 minutes), locked-in priceBreakdown, and stops where each stop now has a Lalamove-assigned stopId.
  1. Place the Order (lalamove_place_order): - Pass the quotationId, sender (name, phone in E.164 format like +66812345678, and optional stopId), and recipients (array of { name, phone, remarks?, stopId? } for each drop-off stop). - If you omit stopId on sender or recipients, lalamove_place_order automatically fetches the quotation and maps stops[0].stopId to sender and stops[1..n].stopId to recipients in order. - Set is_pod_enabled: true if you want the driver to capture a photo or signature as Proof of Delivery (POD).

Editing, Priority Fees, and Cancellations

  • Add Priority Fee (lalamove_add_priority_fee): Can only be added while the order is in ASSIGNING_DRIVER. Subsequent priority fees supersede the previous amount and must be strictly greater.
  • Edit Order (lalamove_edit_order): Allowed once per order while status is ON_GOING (driver matched, before pickup). Only drop-off stops may change; pickup coordinates and address must remain identical.
  • Change Driver (lalamove_change_driver): Available starting 15 minutes after driver matching and before pickup (DRIVER_LATE, DRIVER_ASKED_CHANGE, DRIVER_UNRESPONSIVE, DRIVER_RUDE).
  • Driver Details (lalamove_get_driver): Accessible starting 1 hour before scheduleAt or once the driver arrives at pickup, until order completion.