Lazada
Sàn TMĐT đa quốc gia thuộc Alibaba, mạnh ở nhóm hàng kỹ thuật và mỹ phẩm.
Loại API
REST API
Xác thực
OAuth 2.0
Tần suất refresh khả thi
Mỗi giờ, Hằng ngày
Setup · Maintain hằng tháng
8-12 giờ (cộng 5-7 ngày chờ duyệt) · 1-2 giờ
Hướng dẫn kết nối, 6 bước
Làm theo thứ tự từ trên xuống. Mỗi bước có ngữ cảnh để đội kỹ thuật của bạn hiểu lý do, không phải checklist bấm.
- 1
Đăng ký Lazada Open Platform
Vào open.lazada.com, tạo Developer Account, chọn country Vietnam. Phê duyệt 5-7 ngày.
- 2
Tạo App trong Console
App Type: Marketplace Application. Scope: Order, Product, Finance, Shipment. Region: Vietnam.
- 3
Lấy App Key + App Secret
Copy từ trang App Detail. Lưu vào vault.
- 4
Generate auth URL và gửi cho admin shop
https://auth.lazada.com.vn/oauth/authorize?response_type=code&...&redirect_uri=..., admin shop accept rồi callback trả về code.
- 5
Trade code lấy access_token + refresh_token
Call /auth/token/create với code. Access token tồn tại 7 ngày, refresh token 30 ngày.
- 6
Kết nối endpoint orders + finance
/orders/get, /finance/transaction-details, /products/get. Finance transaction là nguồn để tính net revenue sau phí sàn.
Credentials cần có
Lưu vào vault hoặc secret manager. Không hardcode trong code, không commit lên git.
App KeyApp SecretAccess TokenRefresh TokenSeller ID
Trường dữ liệu mẫu
Các field thường có trong API response. Map vào schema warehouse khi ingest.
- order_id
- order_number
- created_at
- items[].sku
- items[].paid_price
- fee_list
- settlement_transaction_id
- buyer_id
Lỗi và pitfalls thường gặp tại Việt Nam
Đọc kỹ trước khi cam kết timeline, vài rủi ro dưới đây có thể kéo dài tích hợp thêm 1-2 tuần nếu không lên kế hoạch.
- Rate limit thay đổi theo level seller, cao nhất 1.000 request/phút, thấp nhất 100 request/phút.
- Endpoint /orders/get giới hạn pull tối đa 90 ngày trong một request, cần phân chunks khi backfill.
- Phí sàn của Lazada VN có thêm 'collection fee' khi thanh toán COD, không nhầm với phí giao dịch thẻ.
- Một số order ID bị duplicate khi seller bật cả 2 channel LazMall + Marketplace, cần dedupe ở pipeline.
Dashboard sử dụng Lazada
Xem toàn bộ thư viện dashboard →Kết nối Lazada vào data warehouse của doanh nghiệp bạn
Đặt lịch rà soát 30 phút. Chia sẻ tài khoản hiện tại, chúng tôi đề xuất phạm vi kết nối ưu tiên và timeline ngày bàn giao.