Hướng dẫn này trình bày cách kết nối Bravo ERP với HexaSync Automation Engine để tạo Bravo ERP Connector App và đọc dữ liệu danh mục vật tư, tồn kho từ Bravo ERP. HexaSync chỉ đọc dữ liệu, không thay đổi dữ liệu trong Bravo ERP.
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.
- Liên hệ quản trị viên Bravo ERP hoặc đơn vị triển khai Bravo ERP để chuẩn bị các thông tin sau:
- Base URL: địa chỉ Bravo Web API của công ty, ví dụ
https://api.bravo.com.vn. Máy chủ cần truy cập được từ Internet. - User Name và Password: thông tin của tài khoản API dành riêng cho HexaSync.
- Partner Code: mã đối tác Bravo ERP cấp cho tài khoản API này.
- Base URL: địa chỉ Bravo Web API của công ty, ví dụ
Lưu ý: Nếu máy chủ Bravo ERP nằm sau tường lửa, hãy liên hệ support@beehexa.com để nhận danh sách địa chỉ IP của HexaSync, rồi nhờ bộ phận IT cho phép các địa chỉ này truy cập máy chủ.
Phần 1: Cấp quyền kết nối Bravo ERP trên HexaSync
Bước 1: Đăng nhập HexaSync
- Đăng nhập HexaSync Automation Engine bằng tài khoản Beehexa.
Bước 2: Bắt đầu kết nối Bravo ERP
- Mở trang thiết lập kết nối Bravo ERP trên HexaSync.
- Trên màn hình Check connection details, chọn Connect tại mục Bravo ERP.
Bước 3: Nhập thông tin Bravo ERP
- Nhập Base URL, User Name và Password đã chuẩn bị.
- Chọn Continue.
Lưu ý: Nhập Base URL đúng như quản trị viên cung cấp, bao gồm cổng nếu có, ví dụ
https://api.bravo.com.vn:51110. Không thêm đường dẫn phía sau địa chỉ máy chủ.
Bước 4: Xác nhận kết nối
- Khi màn hình hiển thị Connected — Your Bravo ERP Is Ready, chọn Continue.
- Khi thẻ Bravo ERP hiển thị trạng thái Connected, chọn Create Bravo ERP Connector.
Bước 5: Khởi tạo Bravo ERP Connector App
- Trong trường Name, kiểm tra tên Connector App theo tên công ty, ví dụ
Acme Bravo ERP Connector. - Nhập Bravo ERP Partner Code.
- Chọn Continue.
- Quá trình tạo Connector App mất vài phút. Giữ nguyên trang cho đến khi HexaSync tự chuyển sang trang Connector App.
Tiếp theo, hãy kiểm tra 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 Bravo ERP
Bạn cần cấp lại quyền khi HexaSync không còn đọc được dữ liệu Bravo ERP bằng tài khoản cũ, ví dụ:
- Mật khẩu của tài khoản API đã bị đổi trong Bravo ERP.
- Địa chỉ máy chủ Bravo ERP (Base URL) đã thay đổi.
- Bạn muốn HexaSync dùng một tài khoản API khác.
Nếu cần thay thông tin, hãy chuẩn bị Base URL, User Name và Password mới như ở phần Chuẩn bị trước khi bắt đầu.
Bước 1: Mở Settings của Connector App
- Mở Connector Apps, chọn Bravo ERP Connector App cần cập nhật. Nhấn chọn Settings ở menu bên trái.
- Trong Connected Apps & Credentials, tại dòng Bravo ERP, chọn Re-authorize.
Không thực hiện được Re-authorize? Chỉ người tạo Bravo ERP Connector App hoặc người có vai trò Connector App Admin mới thấy nút này. Hãy nhờ một trong những người đó thực hiện thao tác.
Bước 2: Nhập thông tin mới
- Nhập hoặc kiểm tra Base URL và User Name.
- Nhập Password mới.
- Chọn Continue.
Lưu ý: Nếu giữ nguyên User Name, HexaSync cập nhật thông tin kết nối hiện có. Nếu đổi sang User Name khác, HexaSync lưu thông tin kết nối mới và dùng thông tin đó cho Connector App này.
Bước 3: Kiểm tra kết quả
- Khi màn hình hiển thị Connected — Your Bravo ERP Is Ready, chọn Continue.
- HexaSync gắn thông tin kết nối vào Connector App và chuyển bạn về trang Settings.
Lần cập nhật tiếp theo sẽ sử dụng thông tin mới. Dữ liệu đã có trong Connector App được giữ nguyên. Kiểm tra lại theo Phần 3.
Phần 3: Kiểm tra kết nối thành công
Kiểm tra thông tin kết nối
- Mở Connector Apps và chọn Bravo ERP Connector App vừa tạo. Nếu bạn đang ở trang Bravo ERP Connector App vừa tạo, chuyển thẳng sang thao tác 2.
- Mở Settings > Connected Apps & Credentials.
- Kiểm tra Bravo ERP có trạng thái Connected.
Kiểm tra dữ liệu
Mở trang Tasks của Connector App và kiểm tra hai tác vụ mặc định:
- Products: đọc danh mục vật tư gồm mã, tên, đơn vị tính, loại vật tư, mã thuế suất và trạng thái. Tác vụ lấy toàn bộ dữ liệu ở lần chạy đầu, sau đó lấy các vật tư mới được sửa mỗi 30 phút.
- Inventory: By Warehouse and Lot: đọc tồn kho theo từng kho và từng lô, kèm hạn sử dụng. Dữ liệu được cập nhật mỗi 2 giờ.
Phần 4: Lỗi thường gặp và cách xử lý
Your Bravo ERP Server Did Not Accept These Details
Máy chủ Bravo ERP từ chối thông tin đã nhập. HexaSync chưa lưu thông tin kết nối.
- Kiểm tra lại Base URL với quản trị viên Bravo ERP, gồm địa chỉ và cổng. Xác nhận máy chủ truy cập được từ Internet.
- Kiểm tra User Name và Password. Mật khẩu phân biệt chữ hoa và chữ thường.
- Chọn Fix my details and try again, sửa thông tin rồi chọn Continue.
Lưu ý: Nếu máy chủ Bravo ERP nằm sau tường lửa, hãy liên hệ support@beehexa.com để nhận danh sách địa chỉ IP của HexaSync, rồi nhờ bộ phận IT cho phép các địa chỉ này.
This Bravo ERP Account Is Already Registered By Another User
Một người dùng HexaSync khác đã kết nối tài khoản API Bravo ERP này. Mỗi tài khoản API Bravo ERP chỉ có một thông tin kết nối trong HexaSync.
- Nhờ người đã kết nối mở Credentials › Manage, chọn thông tin kết nối Bravo ERP, rồi chọn Team access › Invite member để chia sẻ với tài khoản Beehexa của bạn. Cấp quyền Editor, vì quyền Viewer không đủ.
- Sau khi được chia sẻ, mở lại trang kết nối và dùng đúng thông tin API cũ.
- Nếu tài khoản API thuộc công ty khác, nhờ quản trị viên Bravo ERP tạo tài khoản API mới với User Name khác.
Các lỗi khác
| Thông báo | Cách xử lý |
|---|---|
| HexaSync Could Not Save This Bravo ERP Connection | Thử lại sau vài phút. Nếu vẫn lỗi, liên hệ support@beehexa.com. |
| HexaSync Could Not Link The Credential To Your Connector App | Thông tin kết nối mới đã được lưu nhưng chưa gắn vào Connector App. Chọn Go to Manage Credentials và gắn thông tin kết nối vào Connector App, hoặc liên hệ support@beehexa.com. |
| The name already exists | Tên Connector App đã được dùng. Đặt tên khác. |
| Connector App Quota Reached | Liên hệ support@beehexa.com để tăng hạn mức. |
| Tác vụ không có dữ liệu sau lần cập nhật đầu | Partner Code có thể sai. Gửi Partner Code đúng đến support@beehexa.com để được cập nhật. |
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: Câu hỏi thường gặp
HexaSync có ghi hoặc sửa dữ liệu trên Bravo ERP không?
Không. Bravo ERP Connector App chỉ đọc dữ liệu, không ghi hoặc sửa dữ liệu trên Bravo ERP.
Connector App đọc những dữ liệu nào từ Bravo ERP?
Connector App có hai tác vụ: Products đọc danh mục vật tư và Inventory: By Warehouse and Lot đọc tồn kho theo kho, lô và hạn sử dụng.
Cần chuẩn bị những thông tin gì để kết nối Bravo ERP?
Bạn cần tài khoản Beehexa, Base URL của Bravo Web API, User Name và Password của tài khoản API dành riêng cho HexaSync, cùng Partner Code do Bravo ERP cấp cho tài khoản API đó. Xem chi tiết ở mục Chuẩn bị trước khi bắt đầu.
Partner Code lấy ở đâu?
Liên hệ quản trị viên Bravo ERP hoặc đơn vị triển khai Bravo ERP để nhận Partner Code được cấp cho tài khoản API. Bạn nhập Partner Code ở Bước 5.
Vì sao tôi thấy thông báo This Bravo ERP Account Is Already Registered By Another User?
Tài khoản API đó đã được một người dùng HexaSync khác kết nối. Nhờ người đó chia sẻ thông tin kết nối với tài khoản Beehexa của bạn và cấp quyền Editor. Nếu tài khoản API thuộc công ty khác, nhờ quản trị viên Bravo ERP tạo tài khoản API mới với User Name khác. Xem cách xử lý ở Phần 4.
Khi nào cần cấp lại quyền kết nối?
Cấp lại quyền theo Phần 2 nếu HexaSync không còn đọc được dữ liệu bằng thông tin hiện tại, ví dụ mật khẩu API hoặc Base URL đã thay đổi, hoặc bạn muốn chuyển sang tài khoản API khác.
Cấp lại quyền có tạo thông tin kết nối mới không?
Nếu giữ nguyên User Name, HexaSync cập nhật thông tin kết nối hiện có. Nếu đổi User Name, HexaSync lưu thông tin kết nối mới và dùng cho Connector App. Dữ liệu đã có trong Connector App được giữ nguyên.