Hướng dẫn bắt đầu với Packhai OMS trên HexaSync

Hướng dẫn này trình bày cách kết nối Packhai OMS với HexaSync để lấy dữ liệu từ Packhai OMS. Dữ liệu này được dùng để đánh giá chất lượng dữ liệu 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 để đă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 Packhai OMS có quyền chủ cửa hàng đối với shop cần kết nối. Đăng nhập tại Packhai OMS.

Quan trọng: đừng bỏ qua bước cấu hình webhook. Packhai kết nối bằng token và không tự đăng ký webhook. Bạn phải tự dán Webhook URL và Webhook Bearer do HexaSync cung cấp vào Packhai ở Bước 5. Nếu thiếu bước này, HexaSync sẽ không nhận được cập nhật trạng thái từ Packhai.

Phần 1: Cấp quyền kết nối Packhai 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.

Bước 2: Bắt đầu kết nối Packhai OMS

• Mở trang xác thực Packhai OMS trên HexaSync.
• Trên màn hình Check connection details, tìm Packhai OMS và chọn Connect.

Bước 3: Lấy token trong Packhai

1. Đăng nhập Packhai OMS bằng tài khoản của shop và mở menu เชื่อมต่อ (Connectivity) trên thanh điều hướng.
2. Bấm Create token for external connection, rồi bấm CREATE TOKEN.
3. Trong hộp thoại tạo token, chọn đủ ba giá trị bắt buộc:
   • Sales Channel
   • Connected warehouse
   • Salesperson
4. Bấm Token Generation, sau đó kiểm tra token mới trong danh sách.
5. Bấm nút copy để sao chép toàn bộ token mới nhất. Không gõ tay hoặc cắt bớt token.

Lưu ý bảo mật: Token không hết hạn và xóa token trong Packhai không thu hồi được token đó. Hãy giữ token bí mật.

Bước 4: Nhập token và xác nhận kết nối

• Quay lại HexaSync, dán token vào ô Packhai Token.
• Chọn Continue. HexaSync tự đọc tên shop và Shop ID từ token.

Bước 5: Cấu hình webhook trong Packhai

1. Trên màn hình HexaSync, sao chép Webhook URL và Webhook Bearer.
2. Trong Packhai, mở เชื่อมต่อ (Connectivity). Tại dòng token vừa dán ở Bước 4, kéo bảng sang phải và bấm Setup ở cột Setup Webhooks.
3. Dán Webhook URL và Webhook Bearer vào các trường tương ứng. Dán nguyên văn giá trị Webhook Bearer, không tự thêm chữ Bearer.
4. Chọn SAVE. Khi dòng mã webhook hiển thị, bạn đã cấu hình webhook thành công.
5. Quay lại HexaSync và chọn I have saved the webhook in Packhai — continue.

Bỏ qua nút TEST WEBHOOK URL. Nút này luôn hiển thị Test failed kể cả khi URL chính xác, vì thao tác kiểm tra không gửi request. Dữ liệu thực tế vẫn được gửi bình thường.

Bước 6: Tạo Packhai OMS Connector App

• Bấm Create Packhai OMS Connector.
• HexaSync tự đặt tên Connector App theo dạng [Tên shop] Packhai OMS Connector. Kiểm tra lại thông tin, bấm Continue và màn hình sẽ tự động chuyển sang Connector App khi hoàn tất.

Bước 7: Kiểm tra Connector App trên HexaSync

Kiểm tra thông tin kết nối

• Mở Connector Apps và chọn Packhai OMS Connector App vừa tạo.
• Trong Settings, xác nhận Packhai OMS 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 Packhai.

Phần 2: Cấp lại quyền kết nối Packhai OMS trên HexaSync

Bạn cần cấp lại quyền khi:

• Token cũ không còn dùng được.
• Bạn nghi token bị lộ.
• Beehexa yêu cầu cấp lại quyền.

Trước khi bắt đầu, hãy tắt lịch chạy tự động trong Connector App. Cập nhật thông tin kết nối trên đúng Connector App đang sử dụng, không tạo Connector App mới chỉ để xử lý lỗi kết nối.

Bước 1: Chọn Re-authorize trên HexaSync

1. Mở Packhai OMS Connector App trong Connector Apps.
2. Vào Settings, tìm dòng Packhai OMS và chọn Re-authorize.
3. Ở màn hình chọn shop, shop đang kết nối đã được chọn sẵn. Giữ nguyên và bấm Continue.

Không thực hiện được Re-authorize? Chỉ owner (người tạo) của Packhai OMS Connector App mới có quyền cấp lại quyền. Nếu bạn không phải owner, HexaSync sẽ báo lỗi HexaSync Could Not Register Your Packhai Shop. Hãy liên hệ owner của Connector App để thực hiện Re-authorize.

Bước 2: Chọn cách kết nối lại

Màn hình This Packhai shop is already connected có hai lựa chọn:

• Use the existing connection (recommended): giữ token hiện tại. Chọn cách này nếu kết nối vẫn dùng được. Chọn Continue, sau đó chuyển đến Bước 5.
• Replace it with a new token: chỉ chọn khi token cũ không còn dùng được hoặc bị lộ. Chọn Continue, sau đó thực hiện lần lượt từ Bước 3.

Bước 3: Tạo và dán token mới

• Chỉ thực hiện bước này nếu bạn đã chọn Replace it with a new token.
• Tạo token mới cho đúng shop cần kết nối lại, cách làm giống Bước 3 ở Phần 1, rồi dán token vào HexaSync theo hướng dẫn trên màn hình.

Bước 4: Cấu hình webhook cho token mới

• Chỉ thực hiện bước này nếu bạn đã chọn Replace it with a new token.
• Sao chép Webhook URL và Webhook Bearer trên màn hình HexaSync, rồi dán vào phần Setup Webhooks của token mới trong Packhai, cách làm giống Bước 5 ở Phần 1.

Bước 5: Kiểm tra và bật lại lịch chạy

1. Chờ HexaSync báo kết nối thành công.
2. Mở Packhai OMS Connector App, vào Settings và xác nhận Packhai OMS có trạng thái Connected.
3. Mở task tồn kho và so sánh một vài sản phẩm với số tồn trong Packhai.
4. Bật lại lịch chạy tự động trong Connector App.

Phần 3: Lỗi thường gặp và cách xử lý

Với các trường hợp khác, hãy gửi ảnh chụp màn hình (đã che token và thông tin nhạy cảm) đến support@beehexa.com.

Câu hỏi thường gặp

Token Packhai có hết hạn không?

Không. Token không hết hạn và không cần làm mới. Xóa token trong Packhai cũng không thu hồi token đã tạo, vì vậy hãy giữ token bí mật.

Khi cấp lại quyền, tôi nên chọn cách kết nối nào?

Nếu kết nối hiện tại vẫn sử dụng được, chọn Use the existing connection (recommended). Chỉ chọn Replace it with a new token khi token cũ không còn sử dụng được hoặc bị lộ.

Cấp lại quyền có cần cấu hình lại webhook trong Packhai không?

Không, nếu bạn chọn Use the existing connection. Nếu chọn Replace it with a new token, bạn cần cấu hình lại webhook cho token mới trên Packhai.

HexaSync có ghi hoặc sửa dữ liệu trên Packhai OMS không?

Không. HexaSync chỉ đọc dữ liệu, không thay đổi gì trong Packhai OMS.