Hướng dẫn này trình bày cách kết nối cửa hàng Haravan với HexaSync để HexaSync có thể truy cập dữ liệu sản phẩm, tồn kho của cửa hàng. Dữ liệu này được dùng để đánh giá chất lượng dữ liệu sản phẩm, đồ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 để đăng nhậ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 Haravan có quyền cài đặt ứng dụng cho cửa hàng cần kết nối, thường là chủ cửa hàng hoặc tài khoản quản trị.
- Xác định cửa hàng Haravan cần kết nối. Mỗi lần cấp quyền chỉ kết nối một cửa hàng.
Phần 1: Cấp quyền kết nối Haravan 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 Haravan
- Mở trang thiết lập kết nối Haravan trên HexaSync.
- Trên màn hình Check connection details, tìm Haravan và chọn Connect.
Bước 3: Xác nhận ứng dụng HexaSync
- Trên màn hình Choose an app to connect to Haravan, ứng dụng Haravan của HexaSync đã được chọn sẵn. Giữ nguyên lựa chọn này.
- Chọn Continue. HexaSync cung cấp thông tin ứng dụng và xử lý việc cấp quyền với Haravan.
Bước 4: Chuyển sang Haravan
- Trên màn hình You’re about to authorize HexaSync on Haravan, chọn Continue to Haravan để chuyển sang trang đăng nhập của Haravan.
Bước 5: Cấp quyền cho ứng dụng trong Haravan
- Đăng nhập bằng tài khoản Haravan có quyền cài đặt ứng dụng.
- Nếu tài khoản quản lý nhiều cửa hàng, chọn đúng cửa hàng cần kết nối.
- Kiểm tra các quyền HexaSync yêu cầu và xác nhận cấp quyền. Haravan sẽ chuyển bạn về HexaSync.
Lưu ý:
- Mỗi lần cấp quyền chỉ kết nối một cửa hàng.
- Hoàn tất bước này ngay trên cùng trình duyệt và tab đã bắt đầu kết nối. Mã ủy quyền Haravan gửi về chỉ dùng được một lần và có hiệu lực trong thời gian ngắn.
Bước 6: Hoàn tất Connector HexaSync
- Khi quay về HexaSync, hệ thống đổi mã ủy quyền Haravan lấy access token và lưu thông tin kết nối đã mã hóa. Màn hình Waiting For Credential Access có thể xuất hiện trong vài giây. Đây là trạng thái bình thường; hãy giữ nguyên trang và không tải lại.
- Sau khi cấp quyền thành công, HexaSync hiển thị Authorization Complete và tiếp tục quy trình tạo Connector App.
- Khi HexaSync hiển thị Connection successful, quy trình tạo Connector App đã hoàn tất.
HexaSync bắt đầu lấy dữ liệu từ cửa hàng đã kết nối 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 Haravan trên HexaSync
Nếu bạn đã có Connector và cần cấp lại quyền kết nối Haravan trên HexaSync, hãy thực hiện lần lượt các bước sau.
Bước 1: Mở Settings trong Haravan Connector
- Mở Connector Apps, chọn Haravan Connector cho cửa hàng của bạn. 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 Haravan 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 Haravan mới có quyền cấp lại quyền. Hãy liên hệ owner của thông tin kết nối.
Bước 3: Xác nhận ứng dụng HexaSync
- HexaSync hiển thị màn hình Choose an app to connect to Haravan với ứng dụng Haravan của HexaSync đã được chọn sẵn. Chọn Continue.
Bước 4: Cấp quyền cho ứng dụng trong Haravan
- Ở màn hình You’re about to authorize HexaSync on Haravan, chọn Continue to Haravan.
- Đăng nhập Haravan và chọn đúng cửa hàng đang gắn với Connector này.
- Xác nhận đồng ý cấp quyền cho HexaSync.
Sau khi Haravan chuyển bạn về, HexaSync gắn thông tin kết nối mới vào Connector và mở trang theo dõi (Connector Monitoring) của Connector.
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 cài đặt 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 Haravan Connector App vừa tạo.
- Vào Settings. Dòng kết nối Haravan hiện thông tin kết nối có tên dạng
[Haravan] <Store Domain> Credential, thay cho nút Authorize.
Kiểm tra dữ liệu
Chạy thủ công một tác vụ lấy dữ liệu của Haravan. Đây là phần thực sự gọi đến Haravan, 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 Haravan, ví dụ tác vụ sản phẩm.
- 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.
- Đối chiếu dữ liệu sản phẩm và tồn kho của một vài SKU với Haravan.
Lưu ý: Nếu tác vụ báo lỗi cấp quyền hoặc lỗi quyền truy cập, thông tin kết nối chưa hoạt động. Hãy cấp lại quyền theo Phần 2 trước khi bật lịch chạy. Connector App chỉ đọc dữ liệu từ Haravan, không tạo hoặc cập nhật dữ liệu trên Haravan.
Phần 4: Lỗi thường gặp và cách xử lý
Mỗi màn hình lỗi dưới đây được ghi đúng tiêu đề tiếng Anh hiển thị trên HexaSync, xếp theo thứ tự xuất hiện trong quy trình kết nối. Phần lớn màn hình lỗi có dòng Status và Detail from gateway hoặc Technical details. Hãy chụp lại các dòng này khi liên hệ bộ phận hỗ trợ.
| Thông báo | Cách xử lý |
|---|---|
| HexaSync Could Not Load Its Haravan App | HexaSync chưa tải được ứng dụng Haravan nên chưa thể bắt đầu kết nối; lỗi không liên quan đến tài khoản Haravan của bạn. Chọn Go back và thử lại sau ít phút. Nếu lỗi lặp lại, gửi dòng Status và Detail from gateway đến support@beehexa.com. |
| Haravan Connects Through HexaSync’s App | Đây là thông báo nhắc nhở: bạn đã chọn một app khác hoặc chọn dùng app riêng, trong khi Haravan chỉ kết nối được qua ứng dụng Haravan của HexaSync. Chọn Back to app selection, giữ nguyên ứng dụng HexaSync đã được chọn sẵn và chọn Continue. |
| HexaSync Could Not Build Your Haravan Authorization Link | HexaSync không tạo được đường dẫn đăng nhập Haravan. Chọn Go back và thử lại sau ít phút. Nếu lỗi lặp lại, gửi dòng Status và Detail from gateway đến support@beehexa.com. |
| We Could Not Find Your Installation Details | HexaSync không tìm thấy thông tin phiên cài đặt, hoặc Haravan không trả về mã ủy quyền. Thường gặp khi mở link quay về trên trình duyệt hoặc cửa sổ ẩn danh khác, dữ liệu trình duyệt bị xóa giữa chừng, bạn bấm hủy trên trang Haravan, hoặc link quay về đã hết hạn, bị mở lại từ lịch sử trình duyệt. Chọn Back to installation và kết nối lại từ đầu trên cùng một trình duyệt và một tab, rồi đồng ý cấp quyền trên trang Haravan. |
| We Couldn’t Finish Connecting Your Haravan Store | HexaSync không đổi được mã ủy quyền Haravan thành access token. Xử lý theo mã trong Technical details ở bảng mã bên dưới. |
| HexaSync Could Not Verify The Stored Credential | Cửa hàng đã được kết nối nhưng HexaSync không lấy được access token hợp lệ khi kiểm tra lại, sau khi đã tự thử lại khoảng nửa phút. Chọn Back to installation, rồi xử lý theo bảng mã bên dưới. |
| HexaSync Could Not Link The Credential To Your Connector | Chỉ xuất hiện khi cấp lại quyền: thông tin kết nối mới chưa gắn được vào Connector. Chọn Back to credential setup, rồi xử lý theo bảng mã bên dưới. |
| An Error Occurred | Lỗi không xác định khi HexaSync kiểm tra thông tin kết nối của Connector. Thử lại sau ít phút. Nếu vẫn lỗi, gửi nội dung thông báo đến support@beehexa.com. |
Với các trường hợp khác, hãy gửi ảnh chụp màn hình (đã che thông tin nhạy cảm) đến support@beehexa.com.
Mã lỗi khi không hoàn tất kết nối cửa hàng
Áp dụng cho thông báo We Couldn’t Finish Connecting Your Haravan Store.
| Mã và nguyên nhân | Cách xử lý |
|---|---|
| CREDENTIAL_INFORMATION_INVALID: mã ủy quyền đã hết hạn hoặc đã được dùng (mã của Haravan chỉ dùng được một lần), hoặc HexaSync không đọc được thông tin cửa hàng sau khi đổi mã. | Chọn Back to installation và kết nối lại. Hoàn tất bước đồng ý trên Haravan ngay, không để trang chờ lâu và không tải lại trang quay về. |
| FORBIDDEN: cửa hàng này đã được một tài khoản khác kết nối trên HexaSync và bạn chưa có quyền cập nhật thông tin kết nối của cửa hàng. | Kết nối lại sẽ không khắc phục được. Nhờ người đã kết nối cửa hàng chia sẻ thông tin kết nối cho bạn với quyền Editor trở lên, rồi thử lại. |
| INTEGRATION_APP_INSUFFICIENT_PERMISSION: tài khoản của bạn hiện chưa dùng được ứng dụng Haravan của HexaSync. | Gửi phần Technical details đến support@beehexa.com. |
| Status 401: phiên đăng nhập HexaSync đã hết hạn. | Đăng nhập lại HexaSync rồi kết nối lại. |
| Status 0, 429 hoặc từ 500 trở lên: sự cố tạm thời làm gián đoạn kết nối. | Chờ vài phút rồi kết nối lại. |
Nếu lỗi lặp lại hoặc xuất hiện với một mã khác, gửi phần Technical details đến support@beehexa.com.
Mã lỗi khi không xác minh được thông tin kết nối
Áp dụng cho thông báo HexaSync Could Not Verify The Stored Credential.
| Mã và nguyên nhân | Cách xử lý |
|---|---|
| CREDENTIAL_IS_NOT_OWNER hoặc CREDENTIAL_UNAVAILABLE: HexaSync chưa hoàn tất thiết lập quyền truy cập cho thông tin kết nối mới. | Kết nối lại sẽ không khắc phục được. Gửi các dòng Status, Credential và Detail from gateway đến support@beehexa.com để đội hỗ trợ xử lý. |
| CREDENTIAL_INFORMATION_INVALID hoặc CREDENTIAL_REFRESH_FAILED: Haravan không chấp nhận thông tin ủy quyền đã lưu. | Chọn Back to installation, kết nối lại và đồng ý cấp quyền cho HexaSync trên Haravan. |
| Status 401: phiên đăng nhập HexaSync đã hết hạn. | Đăng nhập lại HexaSync rồi kết nối lại. |
| Status 0, 429 hoặc từ 500 trở lên: sự cố tạm thời làm gián đoạn bước kiểm tra. | Chờ vài phút rồi kết nối lại. |
| Các trường hợp khác: thông tin kết nối đã lưu không trả về access token. | Gửi các dòng trong thông báo đến support@beehexa.com. |
Mã lỗi khi không gắn được thông tin kết nối vào Connector
Áp dụng cho thông báo HexaSync Could Not Link The Credential To Your Connector.
| Mã và nguyên nhân | Cách xử lý |
|---|---|
| PROFILE_INSUFFICIENT_PERMISSION: tài khoản của bạn không có quyền cập nhật Connector này. | Nhờ owner của Connector cấp lại quyền, hoặc gửi phần Detail from gateway đến support@beehexa.com. |
| Status 401: phiên đăng nhập HexaSync đã hết hạn. | Đăng nhập lại HexaSync rồi cấp lại quyền cho Connector. |
| Status 0, 429 hoặc từ 500 trở lên: sự cố tạm thời làm gián đoạn bước gắn thông tin kết nối. | Chờ vài phút rồi cấp lại quyền cho Connector. |
| Các trường hợp khác: thông tin kết nối mới không gắn được vào Connector. | Gửi các dòng Status, Connector, Credential và Detail from gateway đến support@beehexa.com. |
Phần 5: Câu hỏi thường gặp
Tài khoản Haravan của tôi có nhiều cửa hàng thì kết nối thế nào?
Mỗi lần cấp quyền chỉ kết nối một cửa hàng, và mỗi Connector HexaSync chỉ đồng bộ một cửa hàng. Khi bạn đăng nhập, Haravan sẽ hỏi bạn muốn kết nối cửa hàng nào. Để đồng bộ thêm cửa hàng khác, hãy tạo thêm một Connector mới và chọn cửa hàng đó ở Bước 5.
Connector của tôi trước đây kết nối qua app khác thì sao?
Khi bạn cấp lại quyền, Connector sẽ tự chuyển sang dùng ứng dụng Haravan của HexaSync. Bạn chỉ cần làm theo Phần 2 và chọn đúng cửa hàng đang gắn với Connector.
Cửa hàng đã được đồng nghiệp kết nối trước đó thì sao?
Nếu cửa hàng đã được một tài khoản khác kết nối trên HexaSync, bạn sẽ gặp mã FORBIDDEN khi kết nối. Hãy nhờ người đó chia sẻ thông tin kết nối cho bạn với quyền Editor trở lên, rồi thử lại. Nếu không ai khác kết nối cửa hàng này, liên hệ support@beehexa.com.
Tôi có phải kết nối lại khi token hết hạn không?
Thông thường là không, HexaSync tự duy trì access token cho bạn. Bạn chỉ cần cấp lại quyền khi gỡ ứng dụng HexaSync khỏi cửa hàng Haravan, khi tác vụ báo lỗi cấp quyền, hoặc khi HexaSync báo Haravan không chấp nhận thông tin ủy quyền đã lưu.
Vì sao tôi phải hoàn tất ủy quyền nhanh và trên cùng một trình duyệt?
Mã ủy quyền Haravan gửi về chỉ dùng được một lần và chỉ có hiệu lực trong thời gian ngắn. Thông tin phiên kết nối cũng được lưu tạm trên trình duyệt nơi bạn bắt đầu. Nếu bạn để trang chờ lâu, tải lại trang quay về hoặc chuyển sang trình duyệt khác, mã sẽ không còn dùng được và bạn phải kết nối lại.
Màn hình Waiting For Credential Access có phải là lỗi không?
Không. Ngay sau khi kết nối, HexaSync cần vài giây để hoàn tất thiết lập quyền truy cập cho thông tin kết nối mới và sẽ tự kiểm tra lại. Hãy giữ nguyên trang. Nếu sau khoảng nửa phút vẫn chưa xong, HexaSync sẽ hiện lỗi HexaSync Could Not Verify The Stored Credential (xem Phần 4).
Tôi lỡ bấm hủy giữa chừng thì sao?
Không sao. Nếu bạn hủy trên HexaSync, HexaSync sẽ đưa bạn về trang cài đặt template, trang Connector, hoặc trang quản lý thông tin kết nối, tùy nơi bạn bắt đầu. Nếu bạn hủy trên trang Haravan, HexaSync có thể hiện lỗi We Could Not Find Your Installation Details; chỉ cần chọn Back to installation. Bạn có thể kết nối lại bất cứ lúc nào.
HexaSync có ghi hoặc sửa dữ liệu trên Haravan không?
Không. Haravan Connector App chỉ lấy dữ liệu sản phẩm và tồn kho, chỉ đọc dữ liệu, không tạo, ghi hoặc sửa dữ liệu trên Haravan.