Hướng dẫn này trình bày cách kết nối cửa hàng Nhanh.vn với HexaSync để HexaSync truy cập dữ liệu cửa hàng mà Nhanh.vn Metrics App cần. Dữ liệu này 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 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.
- Tài khoản Nhanh.vn có quyền Chủ cửa hàng/Giám đốc đối với cửa hàng cần kết nối.
- Quyền cài app cho cửa hàng Nhanh.vn. Chủ cửa hàng luôn có quyền này; nhân viên cần được cấp quyền cài app.
Phần 1: Cấp quyền kết nối Nhanh.vn 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 Nhanh.vn
- Mở trang xác thực Nhanh.vn trên HexaSync.
- Trên màn hình Check connection details, chọn Connect.
Bước 3: Xác nhận ứng dụng HexaSync
HexaSync hiển thị màn hình dùng ứng dụng có sẵn của HexaSync, với [Nhanh.vn] HexaSync App đang được chọn. Chọn Continue.
Bước 4: Cấp quyền cho ứng dụng trong Nhanh.vn
- HexaSync chuyển bạn sang trang Nhanh.vn. Nếu được yêu cầu, đăng nhập bằng tài khoản quản trị doanh nghiệp và chọn đúng doanh nghiệp cần kết nối. Đồng ý trên doanh nghiệp khác sẽ kết nối nhầm doanh nghiệp đó.
- Nhanh.vn hiển thị thông tin ứng dụng đang xin quyền truy cập doanh nghiệp. Đọc lại rồi chọn Đồng ý.
- Khi cấp quyền thành công, màn hình hiển thị The system is connected. Nothing left to authorize. và Nhanh.vn có trạng thái Connected.
Lưu ý: Nếu sau khi chọn Đồng ý, màn hình báo tài khoản chưa được cấp quyền Open API, hãy xem hướng dẫn đăng nhập cấp quyền của Nhanh.vn, rồi vào Cài đặt Open API:
- Bật cho phép kết nối Open API và cho phép tài khoản Giám đốc cấp quyền.
- Quay lại HexaSync, tiếp tục quy trình cấp quyền và chọn Đồng ý.
Bước 5: Tạo Nhanh.vn Connector App
- Sau khi cấp quyền thành công, chọn Create Nhanh.vn Connector.
- Khi hoàn tất, HexaSync hiển thị màn hình Connection successful.
- Mở HexaSync Connector Apps để kiểm tra Connector App vừa tạo.
Sau khi Connector App được tạo, HexaSync lấy dữ liệu từ cửa hàng Nhanh.vn đã kết nối trong vòng 30 phút và thông báo đến người quản trị.
Phần 2: Cấp lại quyền kết nối Nhanh.vn
Nếu đã có Connector App và cần cấp lại quyền, thực hiện lần lượt các bước sau.
Bước 1: Mở Settings của Connector App
Mở Connector App tương ứng trong Connector Apps và chọn Settings.
Bước 2: Chọn Re-authorize
Trong Settings, tìm credential Nhanh.vn và chọn Re-authorize. Chỉ owner của credential mới có quyền cấp lại quyền.
Bước 3: Xác nhận ứng dụng
Xác nhận đúng Nhanh.vn Connector App cần cấp lại quyền.
Bước 4: Cấp quyền trong Nhanh.vn
Đăng nhập bằng tài khoản quản trị doanh nghiệp, chọn đúng doanh nghiệp rồi chọn Đồng ý. Các bước tiếp theo thực hiện theo hướng dẫn trên màn hình, tương tự lần cấp quyền đầu tiên.
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 mà không có thông báo lỗi. Hãy xác nhận lại ở hai chỗ.
Bước 1: Kiểm tra Credential đã xuất hiện
Mở Connector App và vào Settings. Dòng Connection Nhanh.vn hiển thị credential có tên dạng [Nhanh.vn] Business 12345 Credential, thay cho nút Authorize.
Bước 2: Chạy thử một Puller trong Connector App
Puller là phần thực sự gọi đến Nhanh.vn, nên chạy thử Puller là cách kiểm tra chính xác nhất. Ví dụ, kéo danh sách sản phẩm:
- Chọn Tasks ở thanh bên trái, rồi chọn task
[Nhanh.vn] Products. - Mở Other Actions và chọn Pull.
- Chờ lượt chạy kết thúc rồi mở kết quả. Kết quả phải không có lỗi cấp quyền và có bản ghi sản phẩm từ doanh nghiệp của bạn.
Nếu task báo lỗi cấp quyền hoặc lỗi quyền truy cập, credential chưa hoạt động. Hãy cấp lại quyền trước khi bật lịch chạy.
Phần 4: Khi có lỗi
Mỗi màn hình lỗi đều hiển thị mã trạng thái (Status) và nội dung lỗi. Hãy ghi lại cả hai trước khi thử lại vì bộ phận hỗ trợ sẽ cần thông tin này.
| Thông báo trên màn hình | Nguyên nhân |
|---|---|
| Another Nhanh.vn Authorization Is In Progress | Một lượt cấp quyền khác dùng cùng ứng dụng đang chờ Nhanh.vn phản hồi, có thể ở tab khác hoặc Connector App khác. Mỗi ứng dụng chỉ có một lượt chờ tại một thời điểm. |
| HexaSync Could Not Build Your Nhanh.vn Authorization Link | HexaSync không tạo được đường dẫn cấp quyền với ứng dụng đã chọn. |
| HexaSync Could Not Verify The Stored Credential | Credential đã lưu nhưng kiểm tra lại không ra quyền truy cập dùng được. |
Nên kiểm tra trước
- Làm liền một mạch. Mã cấp quyền của Nhanh.vn chỉ dùng được một lần và hết hạn sau 10 phút.
- Mỗi lần chỉ một lượt. Không mở hai tab cùng cấp quyền với một ứng dụng Nhanh.vn.
- Đúng doanh nghiệp. Kiểm tra bạn đang chọn đúng doanh nghiệp trên Nhanh.vn.
- Đúng Connection. Nếu Connector App có nhiều Connection Nhanh.vn, kiểm tra bạn đã chọn Authorize trên đúng Connection.
- Hạn 1 năm. Nếu task bỗng báo lỗi cấp quyền sau khoảng một năm, nhiều khả năng quyền đã hết hạn. Hãy cấp lại quyền.
Câu hỏi thường gặp
HexaSync lấy những dữ liệu nào từ Nhanh.vn?
Nhanh.vn Connector App chỉ lấy dữ liệu sản phẩm và tồn kho trong giới hạn API mà chủ cửa hàng cho phép khi cấp quyền.
HexaSync có ghi hoặc sửa dữ liệu trên Nhanh.vn không?
Không. Sau khi cấp quyền theo hướng dẫn này, HexaSync không tự động ghi hoặc sửa dữ liệu trên Nhanh.vn.
Ai có thể cấp quyền kết nối Nhanh.vn với HexaSync?
Chủ cửa hàng hoặc giám đốc luôn có quyền cài app. Nhân viên cần được cấp quyền cài app cho cửa hàng Nhanh.vn trước khi thực hiện.
Quyền kết nối Nhanh.vn có hết hạn không?
Có. Quyền truy cập có hạn khoảng một năm. Nếu các task bỗng báo lỗi cấp quyền sau thời gian này, hãy cấp lại quyền trong Settings của Connector App.