Lalamove v3 Order Flow: Quotations, Stops, and Orders
Lalamove API v3 uses a strict two-step flow to book a delivery:
- Request a Quotation (
lalamove_create_quotation): - Calllalamove_get_citiesfirst if you do not know the validserviceTypekeys (e.g.MOTORCYCLE,CAR,VAN,TRUCK330) orspecialRequestsfor the target city. - Pass 2 to 16stops(stop0is pickup, stops1..nare drop-offs). Each stop requirescoordinates: { lat, lng }(as strings) andaddress. - The response returns aquotationId(valid for 5 minutes), locked-inpriceBreakdown, andstopswhere each stop now has a Lalamove-assignedstopId.
- Place the Order (
lalamove_place_order): - Pass thequotationId,sender(name,phonein E.164 format like+66812345678, and optionalstopId), andrecipients(array of{ name, phone, remarks?, stopId? }for each drop-off stop). - If you omitstopIdonsenderorrecipients,lalamove_place_orderautomatically fetches the quotation and mapsstops[0].stopIdtosenderandstops[1..n].stopIdtorecipientsin order. - Setis_pod_enabled: trueif 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 inASSIGNING_DRIVER. Subsequent priority fees supersede the previous amount and must be strictly greater. - Edit Order (
lalamove_edit_order): Allowed once per order while status isON_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 beforescheduleAtor once the driver arrives at pickup, until order completion.