Hướng dẫn này trình bày cách kết nối cửa hàng Magento 2 với HexaSync lần đầu, kiểm tra dữ liệu sau khi kết nối và cấp lại quyền khi Access Token thay đổi. Sau khi hoàn tất, bạn sẽ có một Magento 2 Connector App để kiểm tra dữ liệu tồn kho trước khi kết nối với hệ thống khác.
Chuẩn bị trước khi bắt đầu
Trong HexaSync, Connector App là ứng dụng kết nối với Magento 2. HexaSync kết nối bằng Access Token của một Integration do bạn tạo trong trang quản trị Magento 2.
- 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.
- Cửa hàng Magento 2 (Magento Open Source hoặc Adobe Commerce) và Store URL của cửa hàng, ví dụ
https://shop.example.com. Nếu Magento 2 chạy trong một thư mục con, giữ cả thư mục đó, ví dụhttps://example.com/shop. - Tài khoản quản trị Magento 2 có quyền tạo Integration và sửa cấu hình cửa hàng. Bạn sẽ cần nhập mật khẩu của tài khoản này.
Cửa hàng đặt sau tường lửa? Nếu cửa hàng đặt sau tường lửa (ví dụ Cloudflare), hãy liên hệ HexaSync qua support@beehexa.com để nhận danh sách địa chỉ IP của HexaSync, sau đó nhờ bộ phận kỹ thuật cho phép các địa chỉ IP này.
Lưu ý bảo mật: Access Token có giá trị như mật khẩu. Không gửi Access Token qua nhóm chat, email thông thường hay ảnh chụp lỗi.
Phần 1: Cấp quyền kết nối Magento 2 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 Magento 2
- Mở Thiết lập kết nối Magento 2 trên HexaSync.
- Trên màn hình Check connection details, tại thẻ Magento 2 (đang hiển thị Not connected), chọn Connect.
- Nếu tài khoản HexaSync của bạn đã từng kết nối với cửa hàng này: màn hình Choose an app to connect to Magento 2 hiển thị app của cửa hàng đó. Chọn Continue và chuyển tới Bước 6.
- Nếu đây là lần đầu kết nối: HexaSync hiển thị màn hình Connect HexaSync to your Magento 2 store. Làm theo thứ tự các bước dưới đây, bạn hãy giữ màn hình này mở và làm Bước 3, Bước 4 trong Magento 2 ở một tab khác.
Bước 3: Tạo Integration trên Magento 2 và lấy Access Token
- Đăng nhập vào trang quản trị Magento 2, mở System › Extensions › Integrations và chọn Add New Integration.
- Tại Name, nhập HexaSync. Tại Your Password, nhập mật khẩu tài khoản quản trị bạn đang dùng. Để trống Callback URL và Identity link URL.
- Mở tab API. Tại Resource Access, chọn Custom, rồi đánh dấu Catalog và Stores để HexaSync đọc được dữ liệu tồn kho. Chọn Save.
- Trong danh sách Integrations, chọn Activate trên dòng HexaSync, rồi chọn Allow.
- Sao chép Access Token và lưu ở nơi an toàn, sau đó chọn Done.
Lưu ý: Chỉ dùng Access Token. Không dùng Consumer Key, Consumer Secret hay Access Token Secret.
Tham khảo chính thức: Integrations trong tài liệu Adobe Commerce
Bước 4: cho phép dùng Access Token với Magento 2.4.4 trở lên
Từ Magento 2.4.4, nếu không bật thiết lập này, Magento 2 sẽ từ chối mọi yêu cầu của HexaSync. Bạn có thể xem phiên bản Magento 2 ở góc dưới cùng bên phải giao diện quản trị.
- Mở Stores › Settings › Configuration, chọn Services › OAuth và mở mục Consumer Settings.
- Tại Allow OAuth Access Tokens to be used as standalone Bearer tokens, chọn Yes.
- Chọn Save Config.
Bước 5: Nhập thông tin và xác nhận
- Quay lại màn hình cấp quyền trên HexaSync.
- Nhập Store URL của bạn, ví dụ
https://shop.example.com, và Access Token vừa sao chép ở Bước 3. - Chọn Continue. HexaSync lưu thông tin cửa hàng và tạo thông tin kết nối. Việc này có thể mất vài giây.
Bước 6: Tạo Magento 2 Connector
- Khi thẻ Magento 2 chuyển sang Connected, chọn Create Magento 2 Connector.
- Trên màn hình Enter Connector Name, tên mặc định là [Tên miền cửa hàng] Magento 2 Connector, ví dụ
[shop.example.com] Magento 2 Connector. Phần Description đã được điền sẵn. - Chọn Continue để xác nhận. HexaSync hiển thị Creating Connector… trong lúc tạo Connector App; quá trình này có thể mất vài phút.
Sau khi tạo xong, hệ thống tự động chuyển bạn đến Magento 2 Connector App vừa tạo.
Phần 2: Cấp lại quyền cho kết nối đang sử dụng
Thực hiện cấp lại quyền khi Access Token cũ không còn dùng được, ví dụ sau khi ai đó chọn Reauthorize trên Integration HexaSync trong Magento 2, hoặc khi tác vụ báo lỗi 401 Unauthorized. Cập nhật trên đúng Connector App đang sử dụng; không tạo Connector App mới chỉ để xử lý lỗi đăng nhập.
Bước 1: Mở Settings trong Magento 2 Connector
- Mở Magento 2 Connector tương ứng trong Connector Apps, sau đó chọn Settings.
Bước 2: Chọn Re-authorize
- Trong Settings, tìm thông tin kết nối Magento 2 và chọn Re-authorize.
Không thực hiện được Re-authorize? Chỉ chủ sở hữu thông tin kết nối mới có quyền cấp lại quyền. Hãy liên hệ người đã tạo kết nối Magento 2.
Bước 3: Lấy Access Token mới trên Magento 2
- Trong trang quản trị Magento 2, mở System › Extensions › Integrations.
- Trên dòng HexaSync, chọn Reauthorize, rồi chọn Allow.
- Sao chép Access Token mới, rồi chọn Done.
Lưu ý: Token cũ ngừng hoạt động ngay, nên hãy làm tiếp Bước 4.
Bước 4: Kết nối lại bằng Access Token mới
- Quay lại trang Re-authorize trên HexaSync và chọn Connect trên thẻ Magento 2.
- Chọn Use a different app, sau đó chọn I will provide my Magento 2 integration. Không chọn app cũ trong danh sách vì app đó vẫn giữ token cũ.
- Nhập Store URL giống hệt lần đầu và Access Token mới, rồi chọn Continue.
- Khi thẻ Magento 2 hiển thị Connected, bạn có thể đóng trang.
Lưu ý: Không cần tạo Connector App mới. Connector App hiện có sẽ tự dùng token mới.
Phần 3: Kiểm tra trước khi sử dụng dữ liệu
Mở danh sách Connector Apps và chọn Magento 2 Connector App vừa tạo.
Kiểm tra thông tin kết nối
- Tại Connector App vừa tạo, vào Settings. Thông tin kết nối Magento 2 có trạng thái Connected.
- Store URL trong thông tin kết nối là đúng địa chỉ cửa hàng cần kết nối.
Kiểm tra dữ liệu
- Mở tác vụ [Magento 2] Inventory Source Items. Tác vụ lấy số lượng tồn của từng SKU theo từng nguồn hàng (source) trong Multi-Source Inventory của Magento 2, 15 phút một lần.
- Chờ tác vụ chạy, hoặc chọn chạy tác vụ. Quá trình kiểm tra và hiển thị kết quả diễn ra trong vòng 30 phút.
- Đối chiếu một vài bản ghi mẫu với Magento 2, ví dụ SKU, nguồn hàng và số lượng tồn.
- Kiểm tra số lượng SKU và nguồn hàng. Nếu thiếu, kiểm tra quyền Stores của Integration HexaSync.
Lưu ý: HexaSync chỉ đọc dữ liệu sản phẩm và tồn kho, không thay đổi gì trong Magento 2. Nếu chưa biết nên kiểm tra tác vụ nào, hãy liên hệ đầu mối Beehexa đang hỗ trợ doanh nghiệp.
Phần 4: Lỗi thường gặp và cách xử lý
| Thông báo | Cách xử lý |
|---|---|
| HexaSync Could Not Save Your Magento 2 Integration | Kiểm tra Store URL bắt đầu bằng https:// và Access Token đúng là token hiện ra sau khi chọn Activate. Chọn Fix my store details and try again và nhập lại. |
| We Couldn’t Finish Connecting Your Magento 2 Store | Chọn Choose another app, chọn I will provide my Magento 2 integration, rồi nhập lại Store URL và Access Token. |
| 401 Unauthorized (tác vụ báo lỗi) | Kiểm tra Allow OAuth Access Tokens to be used as standalone Bearer tokens là Yes, và Integration HexaSync đang ở trạng thái Active. Nếu ai đó vừa chọn Reauthorize trong Magento 2, hãy làm theo Phần 2. |
| 403 Forbidden (tác vụ báo lỗi) | Tường lửa của cửa hàng đang chặn HexaSync. Liên hệ support@beehexa.com để nhận danh sách địa chỉ IP của HexaSync và cho phép các địa chỉ này, xem phần Chuẩn bị trước khi bắt đầu. |
| 404 Not Found (tác vụ báo lỗi) | Cửa hàng chưa bật Multi-Source Inventory của Magento 2. Liên hệ bộ phận kỹ thuật của cửa hàng. |
| The name already exists | Đặt tên khác cho Connector App. |
| Connector Quota Reached | Xóa một Connector App không còn dùng, hoặc liên hệ Beehexa để tăng hạn mức. |
Phần 5: Bảo vệ thông tin và ngừng kết nối
- Nhập Access Token trực tiếp trên màn hình cấp quyền HexaSync. Không đưa Access Token vào nhóm chat, email thông thường hoặc ảnh chụp lỗi.
- Che dữ liệu nhạy cảm trước khi gửi ảnh chụp cho bộ phận hỗ trợ.
Để ngừng kết nối:
- Đề nghị Beehexa tắt lịch chạy và ngắt kết nối trong HexaSync.
- Quản trị viên Magento 2 xóa Integration HexaSync trong System › Extensions › Integrations, hoặc chọn Reauthorize để vô hiệu hóa token đang dùng.
Lưu ý: Tắt lịch chạy không đồng nghĩa với thu hồi quyền, và ngừng kết nối không tự xóa dữ liệu đã đồng bộ.
Phần 6: Thông tin gửi Beehexa khi cần hỗ trợ
- Tên công ty, tên Connector App và loại kết nối: Magento 2.
- Store URL, bước đang thực hiện, thời điểm xảy ra lỗi và thông báo lỗi.
- Những thay đổi gần đây về Integration, Access Token, tường lửa hoặc phiên bản Magento 2.
Ảnh chụp cần che Access Token và dữ liệu nhạy cảm. Hãy liên hệ đầu mối Beehexa đang hỗ trợ doanh nghiệp, hoặc support@beehexa.com. Xem thêm Chính sách bảo mật của Beehexa và Chính sách hỗ trợ của Beehexa.
Phần 7: Câu hỏi thường gặp
HexaSync kết nối với Magento 2 bằng thông tin gì?
HexaSync dùng Store URL của cửa hàng và Access Token của một Integration tên HexaSync do bạn tạo trong System › Extensions › Integrations. Không dùng Consumer Key, Consumer Secret hay Access Token Secret.
Vì sao Magento 2.4.4 trở lên từ chối kết nối dù Access Token đúng?
Từ Magento 2.4.4, bạn phải bật Allow OAuth Access Tokens to be used as standalone Bearer tokens trong Stores › Settings › Configuration › Services › OAuth › Consumer Settings. Nếu không bật, Magento 2 từ chối mọi yêu cầu của HexaSync. Xem Bước 4 ở Phần 1.
Khi Access Token thay đổi có cần tạo Connector App mới không?
Không. Hãy cấp lại quyền trên đúng Connector App đang sử dụng bằng Access Token mới theo Phần 2. Connector App hiện có sẽ tự dùng token mới.
HexaSync có ghi hoặc sửa dữ liệu trên Magento 2 không?
Không. Magento 2 Connector App chỉ đọc dữ liệu sản phẩm và tồn kho, không thay đổi gì trong Magento 2.