Bài viết này hướng dẫn bạn cấp quyền kết nối Lightspeed Retail (X-Series) với HexaSync và tạo Lightspeed Retail (X-Series) Connector App. Sau khi kết nối, HexaSync có thể lấy dữ liệu khách hàng, sản phẩm, tồn kho, cửa hàng và đơn bán hàng từ Lightspeed. Doanh nghiệp có thể dùng dữ liệu này để kiểm tra, đối chiếu thông tin bán hàng và tồn kho, đánh giá chất lượng dữ liệu và chuẩn bị cho việc tích hợp với các 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 Lightspeed Retail (X-Series) có quyền duyệt ứng dụng, thường là chủ cửa hàng hoặc Admin.
- Store URL của cửa hàng Lightspeed, tức phần đứng trước
.retail.lightspeed.apptrong địa chỉ cửa hàng.
Ví dụ: Nếu địa chỉ cửa hàng là
acme-retail.retail.lightspeed.app, Store URL cần nhập làacme-retail.
Phần 1: Cấp quyền kết nối Lightspeed Retail (X-Series) trên HexaSync
Bước 1: Đăng nhập HexaSync
- Đăng nhập bằng tài khoản Beehexa tại HexaSync Automation Engine.
Bước 2: Bắt đầu kết nối Lightspeed Retail (X-Series)
- Mở trang xác thực Lightspeed Retail (X-Series) trên HexaSync.
- Trên màn hình Check connection details, chọn Connect tại mục Lightspeed Retail (X-Series).
Bước 3: Xác nhận ứng dụng HexaSync
- Chọn Continue để tiếp tục với ứng dụng HexaSync Lightspeed Retail (X-Series) đã được chọn sẵn.
- HexaSync chuyển bạn đến trang đăng nhập Lightspeed.
Bước 4: Đăng nhập Lightspeed Retail (X-Series)
- Nhập Store URL của cửa hàng Lightspeed, sau đó chọn Next.
- Nhập Username và Password của tài khoản Lightspeed, sau đó chọn Log in.
Lưu ý: Nếu đã đăng nhập Lightspeed, hệ thống có thể hiển thị thông báo You’re already signed in to cùng tên cửa hàng. Kiểm tra tên cửa hàng trước khi chọn để tiếp tục. Nếu không đúng cửa hàng muốn kết nối, nhập Store URL của cửa hàng khác.
Bước 5: Cấp quyền cho HexaSync truy cập Lightspeed
- Kiểm tra các quyền truy cập mà Lightspeed hiển thị.
- Chọn Approve installation để cấp quyền cho HexaSync.
- Sau khi cấp quyền thành công, Lightspeed chuyển bạn trở lại HexaSync.
Lưu ý: Nếu chọn Decline installation, HexaSync hiển thị thông báo The provider did not grant the authorization. Chọn Resume the installation để thực hiện lại bước cấp quyền.
Bước 6: Tạo Lightspeed Retail (X-Series) Connector App
- Kiểm tra Lightspeed Retail (X-Series) có trạng thái Connected.
- Chọn Create Lightspeed Retail (X-Series) Connector.
- Kiểm tra tên được gợi ý, chỉnh sửa nếu cần, sau đó chọn Continue. Ví dụ: [acme-retail] Lightspeed Retail (X-Series) Connector.
Sau khi hoàn tất, mở Connector Apps để tìm và kiểm tra Connector App vừa tạo.
Lưu ý: Hoàn tất bước này nghĩa là HexaSync đã được cấp quyền truy cập Lightspeed và Connector App đã được tạo, nhưng không đồng nghĩa với việc toàn bộ dữ liệu đã được lấy thành công.
Phần 2: Cấp lại quyền kết nối Lightspeed Retail (X-Series) trên HexaSync
Thực hiện cấp lại quyền khi HexaSync không còn truy cập được dữ liệu Lightspeed, chẳng hạn:
- Ứng dụng HexaSync đã bị gỡ khỏi cửa hàng Lightspeed.
- Connector App báo lỗi kết nối với Lightspeed.
Bước 1: Mở Settings của Connector App
- Mở Connector Apps và chọn Lightspeed Retail (X-Series) Connector App hiện có.
- Chọn Settings trong menu bên trái.
- Trong mục Integration Apps & Credentials, chọn Re-authorize tại dòng Lightspeed Retail (X-Series).
Không thấy nút Re-authorize? Hãy liên hệ người tạo Connector App hoặc người có vai trò Profile Admin để thực hiện thao tác này.
Bước 2: Đăng nhập và cấp lại quyền truy cập
- Thực hiện các bước còn lại giống khi kết nối lần đầu (Bước 3 đến Bước 5 ở Phần 1), dùng đúng cửa hàng Lightspeed đã liên kết với Connector App hiện có.
Lưu ý: Không cần tạo Connector App mới khi cấp lại quyền.
Bước 3: Kiểm tra trạng thái kết nối
- Kiểm tra Lightspeed Retail (X-Series) có trạng thái Connected tại trang Settings sau khi cấp lại quyền.
- Dữ liệu đã sao chép trước đó vẫn được giữ nguyên. Lần làm mới dữ liệu tiếp theo, trong vòng 15 phút, sẽ dùng kết nối mới.
Phần 3: Lỗi thường gặp và cách xử lý
| Thông báo | Cách xử lý |
|---|---|
| We Couldn’t Finish Connecting Your Lightspeed Account | Mã xác thực Lightspeed đã hết hạn hoặc đã được sử dụng. Thực hiện kết nối lại từ đầu và chọn Approve installation ngay khi Lightspeed yêu cầu. |
| The provider did not grant the authorization | Bạn đã chọn Decline installation. Chọn Resume the installation, sau đó chọn Approve installation. |
| This authorization is no longer tied to an install we can continue | Phiên cài đặt đã hết hạn hoặc được bắt đầu lại. Chọn Resume the installation. |
| We Could Not Find Your Installation Details | Trang được mở sai thứ tự hoặc đã hết hạn. Thực hiện kết nối lại từ đầu. |
| HexaSync Could Not Build Your Lightspeed Authorization Link | Chọn Choose another app và thử lại. Nếu vẫn gặp lỗi, liên hệ support@beehexa.com. |
| The name already exists | Chọn tên Connector App khác. |
| Profile Quota Reached | Liên hệ support@beehexa.com để tăng giới hạn. |
| HexaSync Could Not Link The Credential To Your Profile | Kết nối đã được lưu nhưng chưa liên kết với Connector App. Chọn Go to Manage Credentials để gán thông tin kết nối cho Connector App, hoặc liên hệ support@beehexa.com. |
Với các lỗi khác, hãy gửi ảnh chụp màn hình thông báo lỗi đến support@beehexa.com để được hỗ trợ.
Câu hỏi thường gặp
Store URL của Lightspeed Retail (X-Series) là gì?
Store URL là phần định danh cửa hàng đứng trước .retail.lightspeed.app trong địa chỉ Lightspeed của bạn. Ví dụ, với địa chỉ acme-retail.retail.lightspeed.app, bạn chỉ cần nhập acme-retail vào trường Store URL khi đăng nhập.
Ai có thể cấp quyền kết nối Lightspeed với HexaSync?
Bạn cần dùng tài khoản Lightspeed có quyền duyệt ứng dụng, thường là chủ cửa hàng hoặc Admin. Tài khoản này được dùng để đăng nhập Lightspeed và chọn Approve installation trong quá trình kết nối.
Tôi đã đăng nhập Lightspeed trước đó thì có cần đăng nhập lại không?
Không nhất thiết. Nếu Lightspeed hiển thị You’re already signed in to cùng tên cửa hàng, bạn có thể chọn cửa hàng đó để tiếp tục. Hãy kiểm tra tên cửa hàng trước khi xác nhận; nếu muốn kết nối cửa hàng khác, nhập Store URL tương ứng.
Sau khi tạo Connector App, HexaSync có tự động chỉnh sửa dữ liệu trên Lightspeed không?
Không. Trong quy trình kết nối này, HexaSync chỉ đọc dữ liệu và không tự động chỉnh sửa khách hàng, sản phẩm hoặc đơn hàng trên Lightspeed. Việc tạo Connector App cũng không đồng nghĩa với việc đã cấu hình xong quy trình đồng bộ dữ liệu với hệ thống khác.
Nếu kết nối Lightspeed bị gián đoạn, tôi có cần tạo Connector App mới không?
Không. Bạn có thể cấp lại quyền cho Connector App hiện có: mở Connector App, vào Settings, rồi chọn Re-authorize trong mục Integration Apps & Credentials. Sau khi cấp lại quyền thành công, kết nối hiển thị Connected và dữ liệu đã sao chép trước đó vẫn được giữ nguyên.