Hướng dẫn này trình bày cách kết nối Anchanto OMS với HexaSync để HexaSync truy cập dữ liệu cửa hàng trên Anchanto OMS. 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. 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.
- API Access Token của Anchanto OMS. Nếu chưa có, hãy liên hệ account manager hoặc bộ phận hỗ trợ của Anchanto để được cấp token.
- SMP Code (
ss_code) của cửa hàng cần kết nối, xem cách lấy ở mục bên dưới. Đây là mã Anchanto dùng để nhận diện một kênh bán đã kết nối, không phải trường store code của cửa hàng. - Môi trường mà token được cấp: Production (Anchanto OMS đang vận hành) hay Staging (môi trường thử nghiệm của Anchanto).
Lấy SMP Code của cửa hàng Anchanto
SMP Code là mã Anchanto OMS dùng để nhận diện từng cửa hàng (kênh bán) đã kết nối. HexaSync cần mã này để biết cần đọc dữ liệu của cửa hàng nào.
- Đăng nhập Anchanto OMS.
- Vào INTEGRATION → Ecommerce Channels.
- Tìm cửa hàng cần kết nối với HexaSync trong danh sách.
- Sao chép SMP Code của cửa hàng đó. SMP Code có dạng
SS0000012345.
Lưu ý: SMP Code khác với trường store code của cửa hàng. Hãy dùng đúng giá trị bắt đầu bằng SS trong mục INTEGRATION.
Phần 1: Cấp quyền kết nối Anchanto OMS 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 của bạn.
Bước 2: Bắt đầu kết nối Anchanto OMS
- Mở trang thiết lập kết nối Anchanto OMS trên HexaSync.
- Trên màn hình Check connection details, chọn Connect.
Bước 3: Nhập thông tin cửa hàng Anchanto
- Trên màn hình Connect HexaSync to your Anchanto OMS store, nhập các thông tin sau:
| Trường thông tin | Giá trị cần nhập |
|---|---|
| API Access Token | Token API Anchanto cấp cho tài khoản OMS. Ô này ẩn ký tự khi nhập. Dán nguyên token, không thêm khoảng trắng. |
| Store Code (ss_code) | SMP Code của cửa hàng (cách lấy SMP Code). HexaSync tự bỏ khoảng trắng ở hai đầu và chuyển sang chữ in hoa trước khi gửi. |
| Anchanto Environment | Chọn Production cho OMS đang vận hành, hoặc Staging cho môi trường thử nghiệm. Mặc định là Production. |
- Kiểm tra lại cả ba giá trị rồi xác nhận.
Lưu ý: Nếu chọn sai môi trường, bước kiểm tra token sẽ thất bại. Token cấp cho Production không dùng được trên Staging, và ngược lại.
Bước 4: HexaSync kiểm tra token
HexaSync hiện Checking Your Anchanto Token trong lúc kiểm tra. HexaSync gọi API Anchanto OMS trên môi trường bạn chọn để xác nhận token nhìn thấy cửa hàng có SMP Code bạn nhập. Nếu hợp lệ, HexaSync mã hóa và lưu thông tin kết nối, và từ đó không hiển thị lại token.
HexaSync gọi đến máy chủ Anchanto tương ứng với môi trường đã chọn:
| Môi trường | Máy chủ Anchanto OMS |
|---|---|
| Production | api-apac-oms.anchanto.com |
| Staging | api-omsuat.anchanto.com |
Thông tin kết nối được đặt tên theo dạng Anchanto OMS - <SMP Code> (<Môi trường>), ví dụ Anchanto OMS - SS0000012345 (Production).
Nếu kiểm tra thất bại, HexaSync hiển thị HexaSync Could Not Verify Your Anchanto Token. Chọn Back to my store details để quay lại sửa thông tin, và xem cách xử lý ở Phần 4.
Token Anchanto không hết hạn nên HexaSync không cần làm mới token định kỳ.
Bước 5: Hoàn tất kết nối và tạo Connector App
Sau khi token được xác nhận, quy trình tiếp tục sang bước tạo Connector App. Khi kết nối hoàn tất, HexaSync hiển thị Connection successful. Tên gợi ý của Connector App là tên cửa hàng Anchanto trả về, hoặc SMP Code nếu Anchanto không trả về tên cửa hàng.
HexaSync bắt đầu lấy dữ liệu trong vòng 30 phút sau khi Connector App được khởi tạo. Kiểm tra kết nối theo Phần 3.
Phần 2: Cấp lại quyền kết nối Anchanto OMS trên HexaSync
Thực hiện khi Anchanto cấp lại token, hoặc khi cần nhập lại thông tin kết nối. Kết nối lại cùng một cửa hàng trên cùng môi trường sẽ cập nhật thông tin kết nối hiện có chứ không tạo bản mới, nên các Connector đang dùng thông tin kết nối đó không bị ảnh hưởng.
Bước 1: Mở Settings trong Anchanto OMS Connector App
- Mở Connector Apps, chọn Anchanto OMS Connector App tương ứng. Nhấn chọn Settings ở menu bên trái.
Bước 2: Chọn Re-authorize
- Trong Settings, tìm thông tin kết nối Anchanto OMS và chọn Re-authorize.
Không thực hiện được Re-authorize? Chỉ owner (người tạo) của thông tin kết nối Anchanto OMS mới có quyền cập nhật. Hãy liên hệ owner của thông tin kết nối.
Bước 3: Nhập lại thông tin cửa hàng
- Trên màn hình Connect HexaSync to your Anchanto OMS store, dán token mới.
- Giữ nguyên SMP Code và môi trường như lần kết nối trước. Hai giá trị này có thể đã được điền sẵn.
- Xác nhận.
Lưu ý: Nếu bạn nhập SMP Code hoặc môi trường khác, HexaSync sẽ tạo thông tin kết nối mới cho cửa hàng hoặc môi trường đó thay vì cập nhật thông tin kết nối cũ.
Bước 4: Hoàn tất
HexaSync kiểm tra token, cập nhật thông tin kết nối và đưa bạn về trang cài đặt Connector. Nếu kiểm tra thất bại, xem Phần 4.
Phần 3: Kiểm tra kết nối thành công
Kết nối thành công khi HexaSync đưa bạn về Connector App hoặc trang Settings của Anchanto OMS Connector mà không có thông báo lỗi. Nếu bạn kết nối khi chưa có Connector App, đó là lúc HexaSync hiện màn hình Connection successful. Hãy xác nhận lại ở hai chỗ trong HexaSync.
Kiểm tra thông tin kết nối
- Mở Connector Apps và chọn Anchanto OMS Connector App của cửa hàng.
- Vào Settings. Dòng kết nối Anchanto OMS hiện thông tin kết nối có tên dạng
Anchanto OMS - <SMP Code> (<Môi trường>), thay cho nút Authorize. - Kiểm tra SMP Code và môi trường trong tên đúng với cửa hàng bạn muốn kết nối.
Kiểm tra dữ liệu
Chạy thủ công một tác vụ lấy dữ liệu của Anchanto OMS. Đây là phần thực sự gọi đến Anchanto OMS, nên là phép thử chính xác nhất: tác vụ phải chạy xong mà không báo lỗi cấp quyền.
- Chọn Tasks ở thanh bên trái, rồi chọn một tác vụ lấy dữ liệu của Anchanto OMS, ví dụ tác vụ tồn kho.
- Mở danh sách Other Actions và chọn Pull để chạy lấy dữ liệu thủ công.
- Chờ lượt chạy kết thúc, rồi mở kết quả. Kết quả không có lỗi cấp quyền và có các bản ghi lấy từ cửa hàng của bạn.
Lưu ý: Nếu tác vụ báo lỗi cấp quyền hoặc lỗi truy cập, thông tin kết nối chưa hoạt động. Hãy cập nhật token theo Phần 2 trước khi bật lịch chạy. Connector App chỉ đọc dữ liệu từ Anchanto OMS, không tạo hoặc cập nhật dữ liệu trên Anchanto OMS.
Thứ tự dữ liệu Header, Product và Stock
- Tác vụ [Anchanto OMS] Inventory Product Headers lấy dữ liệu từ Anchanto OMS trước các tác vụ còn lại.
- Khi tác vụ Header lấy dữ liệu xong, HexaSync đưa dữ liệu Header vào hàng đợi để lấy dữ liệu Product và Stock tương ứng với từng item. Hàng đợi được xử lý theo chu kỳ 5 phút, nên dữ liệu Product và Stock có thể xuất hiện dần sau khi tác vụ Header báo thành công.
Phần 4: Lỗi thường gặp và cách xử lý
Khi kiểm tra token thất bại, HexaSync hiện màn hình HexaSync Could Not Verify Your Anchanto Token. Dòng in đậm đầu tiên cho biết nguyên nhân, còn dòng Technical details ở cuối màn hình ghi mã lỗi, nội dung lỗi và mã HTTP. Hãy ghi lại dòng này trước khi thử lại, vì bộ phận hỗ trợ sẽ cần thông tin này. Nút Back to my store details đưa bạn về màn hình nhập thông tin.
| Thông báo | Cách xử lý |
|---|---|
| Store <SMP Code> on <môi trường> is already connected by another HexaSync user | Một người dùng HexaSync khác đã kết nối cửa hàng này trên môi trường này. Mỗi cửa hàng trên một môi trường chỉ có một thông tin kết nối. Nhờ owner chia sẻ thông tin kết nối cho bạn, hoặc liên hệ quản trị viên HexaSync. |
| Your HexaSync account is not allowed to register credentials | Tài khoản HexaSync của bạn chưa có quyền tạo kết nối. Xin quyền từ quản trị viên HexaSync rồi thử lại. |
| Anchanto OMS is not available on this HexaSync gateway yet | Thông tin bạn nhập không sai, Anchanto OMS chưa được bật trên gateway HexaSync. Gửi Technical details đến support@beehexa.com. |
| The HexaSync gateway hit an error while checking your token | Gateway gặp lỗi khi kiểm tra, chưa có gì được lưu. Thử lại sau một phút; nếu vẫn lỗi, gửi Technical details đến support@beehexa.com. |
| Thông báo khác, kèm danh sách kiểm tra Environment, Store code và Token | Anchanto hoặc gateway không chấp nhận thông tin: môi trường không hợp lệ, thiếu thông tin, không kết nối được máy chủ Anchanto, token bị từ chối, hoặc không tìm thấy cửa hàng với SMP Code này. Kiểm tra lần lượt môi trường, SMP Code và token theo danh sách bên dưới. |
| HexaSync Could Not Link The Credential To Your Connector | Thông tin kết nối đã lưu nhưng chưa gắn được vào Connector. Màn hình liệt kê các giá trị đã gửi để đối chiếu. Chọn Go to Manage Credentials để gắn thông tin kết nối thủ công. |
Với các trường hợp khác, hãy gửi ảnh chụp màn hình (đã che token) đến support@beehexa.com.
Nên kiểm tra trước
- Đúng môi trường: token cấp cho Production không dùng được trên Staging, và ngược lại.
- SMP Code, không phải store code: HexaSync gửi giá trị này lên Anchanto dưới tên
ss_code. Màn hình lỗi hiển thị đúng giá trị HexaSync đã gửi để bạn đối chiếu. - Token nguyên vẹn: dán lại token, không có khoảng trắng hay xuống dòng. Nếu Anchanto đã cấp lại token, token cũ không còn dùng được.
- Một cửa hàng, một môi trường, một thông tin kết nối: nếu cửa hàng đã được người khác kết nối, hãy xin chia sẻ thông tin kết nối thay vì kết nối lại.
- Thử lại an toàn: kết nối lại cùng cửa hàng và môi trường chỉ cập nhật thông tin kết nối hiện có, không tạo bản trùng.
Phần 5: Câu hỏi thường gặp
HexaSync lấy những dữ liệu nào từ Anchanto OMS?
HexaSync đọc dữ liệu sản phẩm và tồn kho của cửa hàng có SMP Code đã kết nối, trong phạm vi token Anchanto cho phép.
Token Anchanto có hết hạn không?
Token Anchanto không có thời hạn, nên HexaSync không cần làm mới token định kỳ. Nếu Anchanto thu hồi hoặc cấp lại token, hãy cập nhật token theo Phần 2.
Token được lưu ở đâu?
Token được mã hóa và lưu trên gateway HexaSync. Token không được lưu trong trình duyệt và không hiển thị lại sau khi kết nối.
Làm sao kết nối nhiều cửa hàng Anchanto?
Mỗi lần kết nối ứng với một cửa hàng trên một môi trường. Lặp lại quy trình với SMP Code của cửa hàng khác. Nếu các cửa hàng cùng thuộc một tài khoản OMS, bạn có thể dùng cùng một token.
HexaSync có ghi hoặc sửa dữ liệu trên Anchanto OMS không?
Không. Anchanto OMS Connector App chỉ đọc dữ liệu, không tạo hoặc cập nhật dữ liệu trên Anchanto OMS.