BancoOS + Business Central: cài đặt, luồng dữ liệu và xử lý sự cố
Kết nối API gốc giữ Microsoft Dynamics 365 Business Central là hệ thống ghi nhận tài chính chính, trong khi BancoOS xử lý thu nhận công nợ phải trả, đối soát 3 chiều, phê duyệt và thanh toán cho Việt Nam. Trang này hướng dẫn cách kết nối hai hệ thống và giữ chúng hoạt động ổn định trong sản xuất.
Điều kiện tiên quyết
- Tenant Business Central Online (SaaS) hoặc triển khai on-prem có bật quyền API.
- Quản trị viên tenant có thể cấp phép OAuth cho ứng dụng BancoOS.
- Gói localisation Việt Nam (hoặc phần mở rộng nhà cung cấp BancoOS) cho trường MST và tham chiếu hóa đơn điện tử trên bản ghi nhà cung cấp và hóa đơn.
- Quyền quản trị workspace BancoOS để cấu hình tích hợp.
Cài đặt từng bước
- Cấp phép ứng dụng BancoOS. Quản trị viên tenant Business Central mở Tích hợp → Business Central → Kết nối trong BancoOS và cấp phép OAuth cho các phạm vi API được yêu cầu.
- Chọn môi trường và công ty. Chọn môi trường Business Central và công ty cụ thể có dữ liệu tài chính do BancoOS quản lý.
- Ánh xạ danh mục. BancoOS kéo nhà cung cấp, tài khoản sổ cái và chiều và đề xuất ánh xạ đến chiều workspace và mã thuế. Xác nhận hoặc ghi đè từng ánh xạ.
- Chạy kỳ mẫu. Bật hạch toán song song trong một đến hai tuần. Đối soát hàng ngày bằng log Hoạt động và giao diện Hóa đơn Mua đã Đăng của Business Central.
- Đi vào vận hành. Đưa BancoOS thành điểm nhập vận hành. Business Central vẫn là hệ thống ghi nhận.
Luồng dữ liệu dự kiến
| Từ | Đến | Đối tượng | Nhịp |
|---|---|---|---|
| Business Central | BancoOS | Nhà cung cấp và thông tin liên hệ | Hàng giờ + theo yêu cầu |
| Business Central | BancoOS | Tài khoản sổ cái và chiều | Hàng ngày |
| Business Central | BancoOS | Đơn đặt hàng mở và phiếu nhập | Mỗi 15 phút |
| BancoOS | Business Central | Hóa đơn mua đã hạch toán | Khi phê duyệt |
| BancoOS | Business Central | Hóa đơn điều chỉnh | Khi phê duyệt |
| BancoOS | Business Central | Bút toán nhật ký thanh toán | Khi thanh toán |
Xử lý sự cố
Cấp phép OAuth thất bại khi kết nối lần đầu
Nguyên nhân có thể. Quản trị viên tenant Business Central chưa cấp phép cho đăng ký ứng dụng BancoOS, hoặc phạm vi bị từ chối.
Cách khắc phục. Nhờ quản trị viên tenant chạy lại luồng kết nối từ Tích hợp → Business Central. Cấp các phạm vi API.ReadWrite.All và Financials.ReadWrite.All được yêu cầu.
Hóa đơn bị từ chối với 'kỳ hạch toán đã đóng'
Nguyên nhân có thể. Business Central đã đóng kỳ mà BancoOS đang cố hạch toán vào.
Cách khắc phục. Mở lại kỳ trong Business Central hoặc đổi ngày hạch toán trên hóa đơn trong BancoOS sang kỳ mở hợp lệ, rồi thử lại từ Hoạt động.
Giá trị chiều không được phép
Nguyên nhân có thể. Tổ hợp chiều trên hóa đơn vi phạm quy tắc chiều Business Central.
Cách khắc phục. Điều chỉnh quy tắc phê duyệt/hạch toán BancoOS hoặc quy tắc chiều Business Central, rồi thử lại. Log Hoạt động hiển thị mã chiều chính xác mà Business Central từ chối.
Sự kiện webhook ngừng đến
Nguyên nhân có thể. Đăng ký Business Central đã hết hạn (đăng ký có hiệu lực ~3 ngày và tự gia hạn, nhưng chính sách tenant có thể chặn gia hạn).
Cách khắc phục. Mở Tích hợp → Business Central → Chẩn đoán → Gia hạn đăng ký. Nếu gia hạn vẫn thất bại, kiểm tra xem chính sách truy cập có điều kiện hoặc service principal có chặn BancoOS không.
MST nhà cung cấp thiếu trên hóa đơn đồng bộ
Nguyên nhân có thể. Gói localisation Việt Nam chưa được cài đặt hoặc trường MST trống trên bản ghi nhà cung cấp Business Central.
Cách khắc phục. Cài đặt localisation Việt Nam trong Business Central (hoặc dùng phần mở rộng nhà cung cấp BancoOS), điền MST vào nhà cung cấp và đồng bộ lại danh mục.
Câu hỏi thường gặp
›Phiên bản Business Central nào được hỗ trợ?
BancoOS hỗ trợ Microsoft Dynamics 365 Business Central Online (SaaS) và triển khai on-prem có quyền truy cập API. Các trường localisation Việt Nam bao gồm MST và tham chiếu hóa đơn điện tử được ánh xạ tự động.
›Tôi có cần Power Automate hoặc middleware tùy chỉnh không?
Không. Kết nối dùng trực tiếp API chính thức của Business Central. Luồng Power Automate có thể chạy song song nhưng không bắt buộc.
›Chiều Business Central được xử lý ra sao?
Mọi chiều toàn cục và phím tắt đồng bộ vào BancoOS dưới dạng chiều workspace. Chính sách phê duyệt hóa đơn có thể định tuyến theo bất kỳ giá trị chiều nào, và hóa đơn đã hạch toán mang chiều trở lại Business Central.
Trang tiếp theo nên đọc
Kiến trúc BancoOSBancoOS triển khai cùng core và ERP như thế nào.Đọc tiếp
Khám phá thêm chủ đề Tích hợp
Các trang cùng nhóm chủ đề.