Hướng dẫn này trình bày cách kết nối BigCommerce với HexaSync Automation Engine cho một cửa hàng BigCommerce bằng store-level API account. HexaSync đọc tồn kho của từng SKU tại từng kho của cửa hàng. Hướng dẫn áp dụng khi bạn kết nối lần đầu hoặc cần cấp lại quyền cho Connector App đang dùng.
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 BigCommerce có quyền chủ cửa hàng (store owner) hoặc quyền tạo API account trong BigCommerce.
- API Path và Access token của API account. BigCommerce chỉ hiển thị Access token một lần, hãy lưu token ở nơi an toàn, chẳng hạn trình quản lý mật khẩu.
Lưu ý: Trong HexaSync, Connector App là ứng dụng kết nối với BigCommerce. HexaSync chỉ đọc dữ liệu cửa hàng. Thao tác duy nhất ngoài việc đọc dữ liệu tồn kho là đăng ký webhook trên BigCommerce để ghi nhận thay đổi tồn kho theo thời gian thực.
Phần 1: Cấp quyền kết nối BigCommerce trên HexaSync
Bước 1: Tạo API account trong BigCommerce
- Đăng nhập BigCommerce Control Panel.
- Vào Settings > Store-level API accounts và chọn Create API account.
- Giữ Token type là V2/V3 API token. Trong trường Name, nhập
HexaSync. - Sao chép API Path hiển thị ngay bên dưới trường Name và lưu lại. API Path có dạng
https://api.bigcommerce.com/stores/abc123xyz/v3/. - Trong OAuth scopes, chọn quyền chỉ đọc (read-only) cho Information & settings, Products và Store Inventory. Để None cho các mục còn lại, sau đó chọn Save.
- Trong hộp thoại BigCommerce API credentials, sao chép và lưu Access token, sau đó chọn Done.
Lưu ý: HexaSync không cần Client ID và Client secret.
Lưu ý: API Path không nằm trong hộp BigCommerce API credentials hiện ra sau khi chọn Save, vì vậy hãy sao chép API Path trước khi Save. Nếu đã bỏ lỡ, bạn có thể xóa API account cũ và tạo API account mới với các quyền tương tự để lấy API Path và Access token mới.
Bước 2: Đăng nhập HexaSync
- Đăng nhập HexaSync Automation Engine bằng tài khoản Beehexa.
Bước 3: Bắt đầu kết nối BigCommerce
- Mở trang thiết lập kết nối BigCommerce trên HexaSync.
- Trên màn hình Check connection details, chọn Connect tại mục BigCommerce.
Bước 4: Nhập thông tin cửa hàng
- Dán API Path và Access token đã lưu ở Bước 1, sau đó chọn Continue.
- HexaSync kiểm tra token với cửa hàng và lưu token dưới dạng mã hóa. Nếu xuất hiện lỗi, xem Phần 4.
- Khi HexaSync hiển thị Your BigCommerce Store Is Connected, chọn Continue. Bạn không cần tự tạo webhook, HexaSync đăng ký webhook khi Connector App chạy.
- Khi BigCommerce hiển thị trạng thái Connected, chọn Create BigCommerce Connector.
Bước 5: Đặt tên BigCommerce Connector App
- Trên màn hình Enter Connector App Name, HexaSync gợi ý tên theo tên cửa hàng, ví dụ
[Acme Outdoor] BigCommerce Connector. Sửa tên nếu cần. - Kiểm tra nội dung trong trường Description, sau đó chọn Continue.
- Quá trình khởi tạo Connector App mất vài phút. Giữ nguyên trang trong thời gian này.
Bước 6: Hoàn tất BigCommerce Connector App
Sau khi khởi tạo, HexaSync tự động mở BigCommerce Connector App vừa tạo. Connector App có hai tác vụ:
- Inventory Levels: lấy tồn kho của từng SKU tại từng kho.
- Webhook Registration: đăng ký webhook trên cửa hàng để nhận thay đổi tồn kho.
Tiếp theo, hãy kiểm tra trạng thái kết nối và dữ liệu theo Phần 3.
Phần 2: Cấp lại quyền kết nối BigCommerce
Cấp lại quyền khi API account cũ đã bị xóa, Access token bị lộ, hoặc tác vụ Inventory Levels báo lỗi xác thực.
Lưu ý: Cập nhật trên đúng dòng kết nối đang dùng. Không tạo Connector App mới để xử lý lỗi quyền truy cập.
Bước 1: Tạo API account mới nếu cần
- Nếu API account cũ đã bị xóa hoặc Access token bị lộ, hãy xóa API account cũ trong BigCommerce nếu tài khoản đó vẫn còn, rồi tạo API account mới theo Bước 1 ở Phần 1.
- Nếu chỉ cần cấp quyền lại cho token còn hiệu lực, hãy dùng API Path và Access token hiện có.
Bước 2: Mở Settings của Connector App
- Mở Connector Apps, chọn BigCommerce Connector App tương ứng. Nhấn chọn Settings > Integration Apps & Credentials.
Bước 3: Chọn Re-authorize
- Tại dòng BigCommerce, chọn Re-authorize.
- Nhập API Path và Access token cần dùng, sau đó chọn Continue.
Bước 4: Xác nhận kết nối
- Kiểm tra thông tin kết nối có trạng thái Connected và dữ liệu tiếp tục được cập nhật theo Phần 3.
Phần 3: Kiểm tra kết nối và dữ liệu
Kiểm tra thông tin kết nối
- Mở Connector Apps và chọn BigCommerce Connector App vừa tạo.
- Mở Settings > Integration Apps & Credentials.
- Kiểm tra thông tin kết nối BigCommerce có trạng thái Connected và Connector App đã được tạo.
Kiểm tra dữ liệu
- Mở tác vụ Inventory Levels và kiểm tra lần chạy đầu tiên đã lấy tồn kho của toàn bộ SKU.
- So sánh số lượng của một vài SKU tại từng kho với dữ liệu trong BigCommerce.
- Tồn kho được đọc lại mỗi giờ. Tác vụ Webhook Registration có thể mất đến 15 phút để đăng ký webhook trên cửa hàng. Sau khi đăng ký thành công, các thay đổi tồn kho được gửi đến HexaSync ngay khi phát sinh.
Nếu không có cập nhật theo thời gian thực, dữ liệu tồn kho vẫn được đọc lại mỗi giờ. Xem cách xử lý trong Phần 4.
Phần 4: Lỗi thường gặp và cách xử lý
| Thông báo | Nguyên nhân có thể gặp | Cách xử lý |
|---|---|---|
| HexaSync Could Not Verify Your BigCommerce Token | API Path và Access token không thuộc cùng một API account, hoặc API account không còn trong danh sách Store-level API accounts. | Kiểm tra API Path và Access token thuộc cùng một API account còn hiệu lực. Nếu cần, tạo API account mới, lưu API Path và Access token mới, rồi quay lại HexaSync chọn Fix my store details and try again, nhập lại thông tin và tiếp tục. |
| Tên Connector App hiển thị store hash thay vì tên cửa hàng | API account chưa có quyền Information & settings. | Cấp quyền chỉ đọc cho Information & settings rồi kết nối lại. Bạn có thể tiếp tục mà không cấp quyền này, các chức năng khác vẫn hoạt động. |
| Your Store Is Connected Without Real-Time Updates | Cập nhật theo thời gian thực chưa được bật cho kết nối. | Chọn Continue. Tồn kho vẫn được cập nhật mỗi giờ. Gửi ảnh chụp màn hình thông báo đến support@beehexa.com để được hỗ trợ bật cập nhật theo thời gian thực. |
| The name already exists | Tên Connector App đã được sử dụng. | Chọn một tên khác cho Connector App. |
| Connector App Quota Reached | Tài khoản đã đạt giới hạn số Connector App. | Liên hệ support@beehexa.com để được hỗ trợ tăng giới hạn. |
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 bảo mật) đến support@beehexa.com.
Phần 5: Bảo vệ thông tin và ngừng kết nối
Dán Access token trực tiếp trên màn hình cấp quyền của HexaSync. Không đưa token vào nhóm chat, email thông thường hoặc ảnh chụp báo lỗi. Bất kỳ ai có token đều đọc được dữ liệu cửa hàng.
Để ngừng kết nối:
- Thông báo Beehexa tắt lịch chạy và ngắt kết nối trong HexaSync.
- Xóa API account HexaSync trong Store-level API accounts của BigCommerce.
Lưu ý: Tắt lịch chạy không đồng nghĩa đã thu hồi quyền. Ngừng kết nối không tự xóa dữ liệu đã lấy về HexaSync.
Phần 6: Thông tin gửi Beehexa khi cần hỗ trợ
- Store hash (phần giữa
/stores/và/v3/trong API Path), tên cửa hàng, tên Connector App và loại kết nối: BigCommerce. - Bước đang thực hiện, thời điểm xảy ra lỗi, thông báo lỗi và phần Technical details nếu có.
- Thay đổi gần đây về API account hoặc quyền trong BigCommerce.
Ảnh chụp cần che Access token, Client secret và dữ liệu bảo mật. Liên hệ đầu mối Beehexa đang hỗ trợ doanh nghiệp, hoặc support@beehexa.com.
Phần 7: Câu hỏi thường gặp
HexaSync có ghi hoặc sửa dữ liệu trên BigCommerce không?
Không. BigCommerce Connector App chỉ đọc tồn kho, sản phẩm và thông tin cửa hàng, không ghi hoặc sửa dữ liệu trên BigCommerce. Thứ duy nhất HexaSync tạo trên BigCommerce là các webhook của chính nó để nhận thay đổi tồn kho.
Làm thế nào để kết nối BigCommerce trên HexaSync?
Tạo store-level API account trong BigCommerce với quyền chỉ đọc theo Bước 1 ở Phần 1, dán API Path và Access token vào HexaSync, đặt tên Connector App, rồi mở Connector App để kiểm tra.
Tôi lấy API Path ở đâu?
Trên màn hình Create API account (Store-level API accounts) của BigCommerce, ngay dưới ô Name. API Path không nằm trong hộp BigCommerce API credentials hiện ra sau khi chọn Save, vì vậy hãy sao chép API Path trước khi Save. Nếu đã bỏ lỡ, bạn có thể xóa API account cũ và tạo API account mới với các quyền tương tự để lấy API Path và Access token mới.
Dữ liệu được cập nhật bao lâu một lần?
Tồn kho được đọc lại mỗi giờ. Khi webhook đã được đăng ký, mỗi thay đổi tồn kho được cập nhật ngay.
Làm mất Access token thì sao?
BigCommerce chỉ hiển thị Access token một lần. Xóa API account cũ, tạo API account mới, rồi cấp lại quyền theo Phần 2.
Tham khảo thêm: Chính sách bảo mật của Beehexa và Chính sách hỗ trợ của Beehexa.