Hướng dẫn
tự tích hợp API
cùng Lalamove
Dịch vụ tích hợp API miễn phí cho việc lên kế hoạch các đơn hàng liền mạch!
Đăng ký tài khoản Doanh nghiệp
Sau khi đăng ký tài khoản Doanh nghiệp (nếu chưa, vui lòng tham khảo tại đây), bạn có thể đăng nhập vào Cổng đối tác API tại đường dẫn: https://partnerportal.lalamove.com/
Theo dõi các bước dưới đây để tích hợp API.
Bước 1: Bắt đầu nhanh với Tài liệu API
Để đội ngũ kỹ thuật nhanh chóng nắm bắt hệ thống, vui lòng tham khảo Tài liệu API tại: developers.lalamove.com.
Bắt đầu từ phần hướng dẫn cơ bản (Tutorial) tại đường dẫn: [developers.lalamove.com/#tutorial]
Bước 2: Khởi tạo môi trường Thử nghiệm (Sandbox)
Bạn đăng nhập vào Cổng đối tác (Partner Portal): https://partnerportal.lalamove.com/ chuyển sang môi trường Sandbox và tạo API Key để thử nghiệm tích hợp.
Bước 3: Các tính năng API nổi bật
Các tính năng cơ bản bạn có thể tham khảo:-
Luồng xử lý đơn hàng (Order Flow Logic): Tối ưu quy trình tạo và quản lý đơn tại đây: developers.lalamove.com/#order-flow
- Giao hàng nhiều điểm (Multi-Stops): Tối ưu chi phí giao hàng trên từng điểm đến
- Xác nhận giao hàng (Proof of Delivery): Hình ảnh của tài xế chụp khi giao hàng developers.lalamove.com/#order-details-contact-proof-of-delivery
- Link theo dõi đơn hàng (Share Link): Đường dẫn theo dõi thời gian thực có thể nhúng vào Dashboard, trang xác nhận thanh toán — giúp tăng độ tin cậy và cho phép khách hàng chủ động liên hệ tài xế: developers.lalamove.com/#order-details-contact-share-link
- Mã nguồn mẫu (Sample Code): Đa dạng ngôn ngữ lập trình để hỗ trợ đội ngũ kỹ thuật: developers.lalamove.com/#introduction-sample-code
- Webhook: cập nhật trạng thái đơn hàng theo thời gian thực.
Bước 4: Tự kiểm thử hệ thống (Trạng thái đơn hàng & Webhook)
Hướng dẫn tự kiểm thử các trạng thái giao hàng và webhook trên môi trường Sandbox.
Xem thông tin chi tiết bên dưới
Mở rộng để xem thêm chi tiết
| 1. ASSIGNING (Đang tìm tài xế) Đảm bảo bạn đã hoàn thành quy trình: gửi yêu cầu Báo giá (Quotation) trước, sau đó tiến hành Tạo đơn hàng (Place an order) qua API. Sau khi tạo thành công, đơn hàng sẽ chuyển sang trạng thái "Assigning". |
![]() ![]() |
|
2. ON_GOING (Đang thực hiện)
Để mô phỏng thao tác chỉ định tài xế cho đơn: truy cập Partner Portal, tìm đơn hàng cần test và chọn "Driver accept this order" tại cột Action. |
![]() ![]() ![]() |
| 3. PICKED_UP (Đã lấy hàng) Trong Partner Portal, tại cột Action của đơn hàng đang hoạt động, chọn "Driver picks up this order". |
![]() ![]() ![]() |
| 4. POD_STATUS_CHANGED (Đổi trạng thái biên nhận giao hàng) Cập nhật trạng thái Biên nhận giao hàng (POD) như hình bên. |
![]() ![]() ![]() |
| 5. COMPLETED (Hoàn thành) Tại cột Action trong Partner Portal, chọn "Driver completes this order" (Tài xế hoàn thành đơn hàng). |
![]() ![]() |
|
6. REJECTED (Bị từ chối)
Trạng thái này không thể tự mô phỏng; bạn cần phối hợp kiểm thử trực tiếp (joint testing) với đội ngũ kỹ thuật của chúng tôi. |
|
| 7. CANCELED (Hủy đơn hàng) Thao tác này sẽ cập nhật trên webhook. |
![]() ![]() |
|
8. EXPIRED (Hết hạn)
Trạng thái này khi không thực hiện bất kỳ thao tác nhận đơn nào đối với tài xế và để đơn hàng ở trạng thái chờ: - Sandbox: Đơn sẽ tự động hết hạn sau 10 phút. - Production: Đơn sẽ tự động hết hạn sau 2 giờ. |
|
|
9. ORDER_REPLACED (Đơn hàng được thay thế)
- Tiến hành hủy đơn hàng ban đầu qua API Cancel Order. - Cung cấp mã đơn hàng (Order ID) cho đội ngũ hỗ trợ để chúng tôi sao chép/tạo mới đơn thay thế trên hệ thống. - Khi xử lý hoàn tất, hệ thống sẽ gửi về webhook với trạng thái ORDER_REPLACED. |
|
Bước 4: Production
Chuyển sang Production để đặt đơn qua API, trước hết để lấy API Key và API Secret, bạn vui lòng:
1. Gửi Email đến: partner.support.vn@lalamove.com
2. Tiêu đề Email: HỖ TRỢ API KEY - TÊN CÔNG TY - SĐT ĐĂNG KÝ TÀI KHOẢN DN LALAMOVE
3. Nội dung Email đề cập đến: Doanh nghiệp muốn lấy API Key và API Secret tại môi trường Production. Những vấn đề mà bạn thắc mắc trong quá trình thử nghiệm môi trường Sandbox.
Câu hỏi thường gặp
Tiện ích của chúng tôi bao gồm:
-
Báo giá phí giao hàng
-
Đặt hàng
-
Hủy đơn hàng
-
Thông tin chi tiết về tài xế và vị trí
-
Nhận trạng thái đơn đặt hàng (Đang gửi yêu cầu cho tài xế, Đang giao, v.v.)
-
Thêm tip (được gọi là “Phí ưu tiên” trong ứng dụng)
-
Nhận cập nhật tự động tình trạng giao hàng dễ dàng và nhanh chóng thông qua Webhook
Có, khách hàng có thể đặt đơn hàng giao nhiều điểm qua API. Xin lưu ý rằng trình tự mà bạn liệt kê các điểm dừng sẽ là định tuyến mà tài xế sẽ thực hiện.
Có, API của chúng tôi có thể chủ động cung cấp các cập nhật trạng thái với Webhooks.
Bạn hoàn toàn có thể yên tâm
API với Lalamove ngoài việc dễ dàng tích hợp còn hoàn toàn miễn phí, có thể thử nghiệm đơn trong môi trường sandbox để nắm rõ cách hoạt động mà không còn lo lắng. Nếu bạn cần tư vấn thêm liên hệ ngay với bộ phận Chăm sóc Khách hàng để được hỗ trợ nhé
Chúng tôi hiểu rằng nhóm của bạn có thể có nhiều câu hỏi khi nghiên cứu tài liệu và cả trong quá trình tích hợp. Vui lòng liên hệ với chúng tôi bất cứ lúc nào tại partner.support@lalamove.com để được hỗ trợ kỹ thuật và các chuyên gia API của chúng tôi sẽ phản hồi sớm nhất có thể.














