Lazada: trạng thái hỗ trợ trong omniVN
Adapter tạm hoãnChưa thể kết nối. Adapter Lazada đang tạm hoãn (deferred); chưa có luồng OAuth hoàn chỉnh.
Trạng thái adapter_deferred: backend chưa có adapter hoạt động, do đó người dùng chưa thể đồng bộ dữ liệu dù đã cấp quyền.
Giới hạn hiện tại
- Adapter Lazada tạm hoãn (deferred); chưa thể lưu credential và đồng bộ dữ liệu.
- OAuth start/callback chưa được triển khai hoặc chưa kết nối với adapter.
Tổng quan
Lazada Open Platform dùng OAuth để ủy quyền cửa hàng. Omni0 cần đăng ký ứng dụng để lấy app_key và app_secret; người bán sau đó cấp quyền để lấy access_token. Tuy nhiên, adapter Lazada đang bị deferred, do đó chưa thể đồng bộ dữ liệu.
Điều kiện trước khi bắt đầu
- Tài khoản Lazada Seller đang hoạt động.
- Omni0 đã đăng ký ứng dụng trên Lazada Open Platform.
- Ứng dụng đã được Lazada phê duyệt nếu nền tảng yêu cầu.
Các bước lấy credential
1. Đăng ký ứng dụng Lazada
Omni0 tạo app trên open.lazada.com, nhận app_key và app_secret. Đây là thông tin do Omni0 quản lý, không do người bán tự tạo.
2. Cấu hình redirect URI
Trong Lazada Open Platform, đăng ký redirect_uri do Omni0 cung cấp để nhận authorization code sau khi người bán cấp quyền.
3. Người bán cấp quyền
Người bán đăng nhập Lazada Seller Center, chọn cửa hàng và đồng ý cấp quyền. Lazada trả về authorization code.
4. Đổi authorization code lấy access_token
Omni0 backend gọi API token của Lazada với app_key, app_secret và authorization code để nhận access_token.
5. Hiện trạng
Adapter Lazada bị deferred; backend chưa xử lý đồng bộ. Dù người bán có thể cấp quyền trên Lazada, Omni0 chưa có adapter để lưu token và đồng bộ đơn hàng, sản phẩm hay tồn kho.
Ánh xạ credential với omniVN
| Field omniVN | Tên trong tài liệu official | Bắt buộc | Lấy từ đâu |
|---|---|---|---|
| App Key | app_key | Bắt buộc | operator_managed Do Omni0 đăng ký app Lazada. |
| App Secret | app_secret | Bắt buộc | operator_managed |
| Access Token | access_token | Bắt buộc | oauth_authorization Seller cấp quyền qua OAuth; không phải key người dùng tự tạo. |
| Base URL | API gateway URL | Tùy chọn | user_entered |
appKey → App Key (Omni0 quản lý); appSecret → App Secret (Omni0 quản lý); accessToken → Access Token (Lazada cấp sau khi seller cấp quyền OAuth); baseUrl → Base URL (người dùng nhập, gateway theo quốc gia nếu cần).
Vòng đời token
access_token của Lazada có thời hạn và có thể làm mới bằng refresh_token theo tài liệu. Token bị vô hiệu khi seller thu hồi quyền hoặc app bị vô hiệu hóa.
Lỗi thường gặp
Không đồng bộ được dữ liệu
Adapter Lazada đang bị deferred; backend chưa xây dựng luồng lưu token và gọi API.
Lỗi authorization code expired
authorization code hết hạn nhanh hoặc redirect_uri không khớp cấu hình app.