Hướng dẫn này giúp bạn kết nối Dynamics 365 Business Central với HexaSync Automation Engine bằng Microsoft Entra App do doanh nghiệp quản lý. Sau khi hoàn tất, bạn sẽ tạo Business Central Connector App cho một company và có thể đọc dữ liệu Items và Inventory Levels trên HexaSync. Hướng dẫn áp dụng cho Business Central Online.
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.
- Microsoft Entra App đã được tạo hoặc chọn từ ứng dụng hiện có, được cấp API permissions, Admin consent và được đăng ký cấp quyền trong Business Central Online.
- Client ID, Client Secret Value và Tenant ID của Entra App.
- Tên Environment của Business Central, ví dụ Production.
- Quyền truy cập company cần kết nối trong Business Central. Nếu Environment có nhiều company, bạn sẽ chọn company trong quá trình kết nối.
Chưa có Entra App? Hãy làm theo hướng dẫn tạo Microsoft Entra App cho Dynamics 365, rồi cấp quyền API và đăng ký ứng dụng trong Business Central theo mục cấp quyền Business Central trước khi tiếp tục.
Phần 1: Kết nối Dynamics 365 Business Central 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 Business Central
- Mở trang thiết lập kết nối Dynamics 365 Business Central trên HexaSync.
- Trên màn hình Check connection details, tìm MS D365 Business Central và chọn Connect.
Bước 3: Nhập thông tin kết nối
- Trên màn hình nhập thông tin kết nối, nhập các giá trị sau:
| Trường thông tin | Giá trị cần nhập |
|---|---|
| Tenant ID | Directory (tenant) ID hoặc tenant domain, ví dụ contoso.onmicrosoft.com. |
| Environment | Tên Environment của Business Central, thường là Production. |
| Client ID | Application (client) ID của Entra App. |
| Client Secret | Client Secret Value của Entra App, không phải Secret ID. |
- Chọn Continue.
Bước 4: Chọn company và xác nhận kết nối
- Nếu Environment có nhiều company, chọn company cần kết nối rồi chọn Submit. Nếu chỉ có một company, bước chọn này không xuất hiện.
- Khi hiển thị MS D365 Business Central Is Connected, chọn Continue.
- Khi trạng thái là Connected, chọn Create MS D365 Business Central Connector.
Bước 5: Hoàn tất thông tin Connector App
- Kiểm tra tên Connector App được gợi ý và thay đổi nếu cần.
- Chọn Continue.
- Giữ trang mở cho đến khi HexaSync tạo và mở Connector App mới. Quá trình có thể mất vài phút.
Lưu ý: Mỗi Connector App trong quy trình này kết nối một company. Nếu cần kết nối company khác, tạo thêm Connector App và chọn company tương ứng.
Phần 2: Kiểm tra kết quả sau khi kết nối
Sau khi Business Central Connector App được tạo, Connector có hai tác vụ mặc định:
- [MS D365 Business Central] Items: lấy dữ liệu item của company.
- [MS D365 Business Central] Inventory Levels: đọc tồn kho của từng item tại từng location.
Cả hai tác vụ tự cập nhật 15 phút một lần:
- Items cập nhật các item mới hoặc vừa sửa.
- Inventory Levels chỉ cập nhật những item có phát sinh nhập, xuất hoặc chuyển kho. Mỗi ngày, Inventory Levels lấy lại tồn kho của mọi item một lần.
Khoảng một giờ sau khi kết nối, thay đổi của item được cập nhật gần như ngay lập tức. Bạn không cần cài đặt gì thêm trong Business Central.
Phần 3: Cấp lại quyền kết nối Business Central
Thực hiện khi Client Secret của Entra App thay đổi hoặc hết hạn, hoặc khi kết nối báo lỗi xác thực.
Bước 1: Mở Settings trong Business Central Connector App
- Mở Connector Apps, chọn Business Central Connector App cần cấp lại quyền. Nhấn chọn Settings ở menu bên trái.
Bước 2: Chọn Re-authorize
- Trong Settings, chọn Re-authorize tại dòng kết nối Business Central.
- Nhập Client Secret Value mới của Entra App, rồi hoàn tất theo hướng dẫn trên màn hình.
Lưu ý: Nếu nhiều Connector App dùng cùng một Entra App, hãy thực hiện Re-authorize cho từng Connector App cần duy trì kết nối.
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 Microsoft Entra App | Kiểm tra và nhập lại Client ID, Client Secret Value. |
| Microsoft Entra ID rejected the app’s client ID / secret | Kiểm tra Tenant ID, Client ID và Client Secret Value; xác nhận secret còn hiệu lực. |
| Token issued but GET /companies failed | Kiểm tra Environment, State Enabled của Entra App trong Business Central và Admin consent cho API.ReadWrite.All. |
| GET /items failed for company | Kiểm tra Permission Set D365 AUTOMATION của ứng dụng trong Business Central. |
| The name already exists | Đặt tên khác cho Connector App. |
| Connector App Quota Reached | Liên hệ support@beehexa.com để kiểm tra hạn mức. |
Nếu tiếp tục gặp lỗi, gửi ảnh chụp màn hình đến support@beehexa.com.
Lưu ý bảo mật: Không gửi Client Secret Value trong ảnh chụp hoặc email thông thường.
Phần 5: Câu hỏi thường gặp
Client ID, Tenant ID và Client Secret lấy ở đâu?
Các giá trị này được lấy từ Microsoft Entra App. Xem hướng dẫn tạo Microsoft Entra App cho Dynamics 365 để đăng ký ứng dụng và chuẩn bị thông tin xác thực.
Tạo Entra App xong đã kết nối Business Central với HexaSync chưa?
Chưa. Bạn cần cấp API permissions, Grant admin consent, đăng ký ứng dụng và cấp Permission Set trong Business Central (xem mục cấp quyền Business Central), sau đó thực hiện quy trình kết nối trên HexaSync.
Một Connector App có kết nối nhiều company không?
Không. Mỗi Connector App kết nối một company. Để kết nối company khác, tạo thêm Connector App từ template và chọn company tương ứng.
Business Central On-premises có dùng được hướng dẫn này không?
Không. Business Central Connector hiện tại của HexaSync chỉ hỗ trợ Business Central Online. Nếu cần kết nối On-premises, hãy liên hệ Beehexa để được hỗ trợ thêm.
Client Secret thay đổi thì có cần Re-authorize từng Connector App không?
Có. Với mỗi Connector App dùng cùng Entra App, thực hiện Re-authorize theo Phần 3 và nhập Client Secret Value mới.
HexaSync có ghi hoặc sửa dữ liệu trên Business Central không?
Không. Các tác vụ cấu hình mặc định trong Business Central Connector App chỉ đọc dữ liệu Items và Inventory Levels, không ghi hoặc sửa dữ liệu trên Business Central. Quyền API.ReadWrite.All được cấp theo khuyến nghị cho Connector hiện tại, không có nghĩa là các tác vụ mặc định ghi dữ liệu.