Hướng dẫn này trình bày cách kết nối Lazada với HexaSync để lấy dữ liệu từ Lazada. Dữ liệu này được dùng để đánh giá chất lượng dữ liệu sản phẩm và tồn kho, đồng thời kiểm tra dữ liệu trước khi kết nối với một hệ thống khác.
Chuẩn bị trước khi bắt đầu
- Tài khoản Beehexa để truy cập HexaSync Automation Engine. Nếu chưa có tài khoản, hãy làm theo hướng dẫn đăng ký tài khoản Beehexa.
- Tài khoản người bán (seller) Lazada là chủ shop cần kết nối, tức tài khoản bạn vẫn dùng để đăng nhập Lazada Seller Center. Đây phải là tài khoản seller một quốc gia, không phải tài khoản cross-border.
- Quyền truy cập Lazada Open Platform của doanh nghiệp, với một app có App Key và App Secret.
Lưu ý: Tài khoản cross-border (CB) chưa được hỗ trợ. Lazada Connector chỉ hoạt động với tài khoản seller một quốc gia (VN, TH, ID, MY, PH, SG…). Tài khoản cross-border sẽ bị từ chối ở bước cấp quyền.
Phần 1: Cấp quyền kết nối Lazada trên HexaSync
Bước 1: Đăng nhập HexaSync
- Truy cập HexaSync Automation Engine và đăng nhập bằng tài khoản Beehexa.
Bước 2: Bắt đầu kết nối Lazada
- Mở trang xác thực Lazada trên HexaSync.
- Trên màn hình Check connection details, tìm Lazada và chọn Connect.
Bước 3: Xác nhận ứng dụng HexaSync
- Nếu bạn đã đăng ký app trước đây (ví dụ khi kết nối tài khoản seller thứ hai): trên màn hình chọn app, chọn [App Key] Lazada Connector App và bấm Continue, không cần nhập lại. Chuyển đến Bước 4.
- Nếu đây là lần đầu kết nối: hãy làm lần lượt các bước trên màn hình để điền App Key và App Secret của ứng dụng trên Lazada Open Platform.
Bạn cần hai giá trị của app, lấy trên Lazada Open Platform như sau:
1. Đăng nhập trang developer của Lazada
- Mở Lazada Open Platform và đăng nhập. Trang quản lý app là Lazada Service Provider Center.
- Lần đầu truy cập, hãy hoàn tất đăng ký developer (thông tin công ty, xác thực email) nếu được yêu cầu.
2. Tạo app
- Ở thanh bên trái, mở Development, rồi App Management, và bấm Create App.
- Chọn App Category: kết nối shop của chính doanh nghiệp thì chọn Seller In-house APP.
- Điền thông tin cơ bản rồi gửi.
- Kiểm tra API Permission Group của app có quyền Products.
3. Sao chép App Key và App Secret
- Trong App Management, bấm Manage ở app của bạn. Tab App Overview sẽ mở ra.
- Ở mục Advanced Information bên phải, sao chép App Key (một dãy số).
- Bấm View ở App Secret để hiển thị key, rồi sao chép.
Không bấm Reset: thao tác này sẽ đổi App Secret, khi đó bạn phải cập nhật lại app trong HexaSync.
4. Điền form trên HexaSync
- Quay lại HexaSync, dán giá trị vào ô App Key và App Secret. Đảm bảo giá trị được dán chính xác, không có khoảng trắng thừa ở đầu hoặc cuối.
- Bấm Continue. HexaSync lưu app với tên [App Key] Lazada Connector App.
Lưu ý bảo mật: Giữ bí mật App Secret như mật khẩu; không gửi qua chat hay email. HexaSync lưu giá trị này ở dạng mã hóa và không hiển thị lại.
Bước 4: Khai báo Callback URL
Với app vừa đăng ký (app có sẵn hoặc app vừa tạo ở Bước 3), HexaSync hiện màn hình Register the HexaSync callback URL in Lazada Open Platform. Màn hình này có Callback URL dành riêng cho app của bạn, dạng:
https://app.hexasync.com/credentials/callback/<app-id>- Sao chép Callback URL trên màn hình HexaSync.
- Trên Lazada Open Platform, mở app: Development → App Management → Manage → tab App Overview → Basic Information. Nhấn Edit ở Callback URL.
- Dán URL vừa sao chép và bấm Save.
- Quay lại HexaSync và bấm I have registered the callback URL — continue.
Lưu ý: Lazada so khớp URL này từng ký tự và từ chối cấp quyền nếu không trùng.
Bước 5: Cấp quyền cho ứng dụng trong Lazada
- Trên màn hình Redirecting You To Lazada, bấm Continue to Lazada.
- Đăng nhập Lazada Seller Center bằng tài khoản người bán là chủ shop.
- Khi được hỏi, chọn đúng quốc gia hoặc khu vực của shop.
- Trên màn hình cấp quyền, kiểm tra các quyền truy cập mà ứng dụng yêu cầu, rồi bấm Authorize. Lazada tự động đưa bạn quay lại HexaSync.
Bước 6: Lưu Webhook URL
Khi cấp quyền thành công, HexaSync hiển thị màn hình Connected — Save Your HexaSync Webhook URL, kèm Webhook URL dành riêng cho app của bạn.
- Sao chép Webhook URL trên màn hình và lưu ở nơi an toàn, ví dụ trình quản lý mật khẩu hoặc wiki nội bộ của nhóm. Không dán URL vào nhóm chat công khai.
- Trên Lazada Open Platform, mở app và vào tab Push Mechanism.
- Dán Webhook URL vào ô Callback URL, chọn các loại sự kiện (event topic) cần nhận, rồi lưu.
- Quay lại HexaSync và bấm I have saved the webhook URL — continue.
Lưu ý: Bạn chỉ cần cài đặt Webhook URL một lần cho mỗi app; cấu hình áp dụng cho mọi tài khoản seller đã cấp quyền qua app đó. Lazada dùng App Secret của app để ký mỗi lần gửi, và HexaSync từ chối các gói tin có chữ ký không hợp lệ.
Bước 7: Tạo Lazada Connector
- Khi Lazada hiện trạng thái Connected, bấm nút tạo connector.
- HexaSync tự đặt tên connector theo dạng [Tài khoản seller] Lazada Connector và tạo ngay, không cần nhập thêm thông tin. Nếu tên đã tồn tại, HexaSync tự thêm số thứ tự, ví dụ [Tài khoản seller] Lazada Connector (1).
- Giữ nguyên trang trong vài phút. HexaSync tạo connector rồi tự chuyển sang mục Tasks của Lazada Connector App khi hoàn tất.
HexaSync tự bật lịch đồng bộ và lấy dữ liệu lần đầu ngay sau khi tạo. Bạn không cần bấm Start.
Bước 8: Kiểm tra Connector App trên HexaSync
Kiểm tra thông tin kết nối
- Mở Lazada Connector App vừa tạo trong Connector Apps.
- Trong Settings, xác nhận Lazada có trạng thái Connected.
Kiểm tra dữ liệu
- Mở task Inventory trong Connector App.
- Đối chiếu một số sản phẩm và số tồn với dữ liệu trong Lazada.
Phần 2: Cấp lại quyền kết nối Lazada trên HexaSync
Bạn cần cấp lại quyền khi:
- Token hết hạn và không tự làm mới được.
- Shop đã thu hồi quyền của ứng dụng.
- HexaSync báo lỗi kết nối.
Bước 1: Mở Settings của connector
- Mở Lazada Connector trong Connector Apps và chọn Settings.
Bước 2: Chọn Re-authorize
- Tìm dòng Lazada và bấm Re-authorize.
Không thực hiện được Re-authorize? Chỉ người đã tạo thông tin kết nối này mới có quyền cấp lại quyền. Hãy nhờ họ thực hiện bước này.
Bước 3: Xác nhận app
- App đang dùng được chọn sẵn (nhãn Selected), nên bạn không cần nhập lại thông tin app. Bấm Continue. Nếu muốn dùng app khác, chọn Use a different app.
- Nếu vừa đổi App Secret trên Lazada Open Platform, ở bước này chọn I will provide my Lazada app và nhập lại đúng App Key cùng App Secret mới. HexaSync cập nhật app hiện có, không tạo app mới.
Bước 4: Xác nhận lại trên Lazada
- Đăng nhập Seller Center bằng đúng tài khoản chủ shop đã kết nối trước đây, rồi bấm Authorize, giống Bước 5 ở Phần 1.
- HexaSync cập nhật thông tin kết nối hiện có: không tạo bản trùng, và không cần đổi Webhook URL đã cấu hình.
Phần 3: Kiểm tra kết nối thành công
Bước 1: Kiểm tra thông tin kết nối đã xuất hiện
- Mở Settings của connector. Dòng Lazada hiển thị thông tin kết nối thay cho nút Authorize.
Bước 2: Kiểm tra dữ liệu tồn kho
- Mở trang Tasks của connector. Sau 15–30 phút, task [Lazada] Product Sku Inventories sẽ có dữ liệu: mỗi dòng tương ứng với tồn kho của một SKU.
- Các task không báo lỗi cấp quyền.
Phần 4: Lỗi thường gặp và cách xử lý
Ghi lại nội dung thông báo trên màn hình, rồi xử lý theo bảng sau.
| Thông báo | Nguyên nhân và cách xử lý |
|---|---|
| HexaSync Could Not Register Your Lazada App | Thông tin app chưa đúng. Kiểm tra lại App Key và App Secret, rồi bấm Edit the app again. |
| The application has been registered but not belong to you | App Key đã được tài khoản HexaSync khác đăng ký. Nhờ người đó chia sẻ app cho bạn. |
| HexaSync Could Not Build Your Lazada Authorization Link | Bấm Choose another app và chọn lại app, hoặc kiểm tra lại thông tin app. |
| “Thiếu Tham số” / trang lỗi api.lazada.vn | Đăng nhập Lazada Seller Center trước, rồi bắt đầu lại kết nối. |
| client_id không hợp lệ | Kiểm tra lại App Key ở Phần 1, Bước 3. |
| Không quay lại được HexaSync sau khi Authorize | Làm lại Phần 1, Bước 4 (Callback URL). |
| Lazada Did Not Return An Authorization Code | Bạn chưa bấm Authorize hoặc đã hủy trên Lazada. Bấm Back to connection và làm lại. |
| Lazada Rejected The Authorization Code | Mã cấp quyền đã hết hạn hoặc đã được dùng. Bấm Back to connection và cấp quyền lại. |
| HexaSync Could Not Verify The Stored Credential | Bấm Back to connection và cấp quyền lại. |
| Profile Quota Reached | Tài khoản đã dùng hết số connector được phép. Liên hệ support@beehexa.com để tăng hạn mức. |
| Couldn’t Name Your Profile | Bạn đã có quá nhiều connector cùng tên cho tài khoản seller này. Lưu trữ hoặc đổi tên bớt, rồi thử lại. |
Nên kiểm tra trước:
- Đăng nhập Lazada Seller Center bằng tài khoản chủ shop trước khi bấm Continue to Lazada.
- Callback URL trên app khớp từng ký tự với URL HexaSync hiển thị.
- Làm trọn quy trình trong một lần, không đóng trang giữa chừng.
Phần 5: Câu hỏi thường gặp
Tài khoản Lazada nào nên dùng để cấp quyền kết nối?
Hãy dùng tài khoản người bán là chủ shop cần kết nối, tức tài khoản đăng nhập Lazada Seller Center. Đăng nhập Seller Center trước khi bắt đầu cấp quyền để tránh lỗi Thiếu Tham số.
Khi cấp lại quyền có cần nhập lại App Key và App Secret không?
Không. Chọn app hiện có và xác nhận lại trên Lazada. Chỉ khi đổi sang app khác hoặc vừa thay App Secret thì bạn mới cần nhập thông tin app tương ứng.
HexaSync có ghi hoặc sửa dữ liệu trên Lazada không?
Không. Lazada Connector chỉ đọc dữ liệu, không ghi ngược vào Lazada.
HexaSync lấy những dữ liệu nào từ Lazada?
HexaSync lấy danh sách sản phẩm và tồn kho của tài khoản seller, trong phạm vi quyền bạn đã cấp.
Có thể đổi tên connector không?
Có. Mở Lazada Connector App trong danh sách Connector Apps, chọn Settings, rồi chọn Change Name. Chỉ Owner của Connector App mới có quyền đổi tên.