BancoOS + Business Central: cài đặt, luồng dữ liệu và xử lý sự cố
Bộ kết nối API gốc giữ Microsoft Dynamics 365 Business Central là hệ thống sổ sách tài chính chính, trong khi BancoOS đảm nhận thu nhận hóa đơn phải trả, đối soát 3 chiều, phê duyệt và thanh toán cho doanh nghiệp tại Việt Nam. Trang này hướng dẫn kế toán trưởng và quản trị viên Business Central cách kết nối hai hệ thống và duy trì kết nối ổn định khi vận hành thực tế.
Yêu cầu trước khi kết nối
Hãy kiểm tra bốn yêu cầu dưới đây trước khi bắt đầu. Phần lớn sự cố kết nối đều bắt nguồn từ một trong số đó.
- Một tenant Business Central Online (SaaS) hoặc bản triển khai on-prem đã bật quyền truy cập API.
- Một quản trị viên tenant có quyền cấp phép OAuth cho ứng dụng BancoOS.
- Gói bản địa hóa Việt Nam (hoặc phần mở rộng nhà cung cấp của BancoOS) để có trường MST và trường hóa đơn điện tử trên hồ sơ nhà cung cấp và hóa đơn.
- Quyền quản trị workspace BancoOS để cấu hình tích hợp.
Các bước cài đặt
Việc cài đặt gồm năm bước. Kỳ chạy thử ở bước 4 giúp phòng kế toán so sánh kết quả trên cả hai hệ thống trước khi BancoOS trở thành điểm nhập liệu vận hành.
- Cấp phép cho ứ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 (API.ReadWrite.All và Financials.ReadWrite.All).
- Chọn môi trường và công ty. Chọn môi trường Business Central và đúng công ty có dữ liệu tài chính mà BancoOS sẽ quản lý.
- Ánh xạ danh mục. BancoOS lấy danh sách nhà cung cấp, tài khoản sổ cái và các chiều phân tích (dimension), rồi đề xuất ánh xạ sang chiều phân tích và mã thuế của workspace. Xác nhận hoặc điều chỉnh từng ánh xạ.
- Chạy thử một kỳ. Bật hạch toán song song trong một đến hai tuần. Đối chiếu hằng ngày bằng nhật ký Hoạt động (Activity) của BancoOS và màn hình Posted Purchase Invoices của Business Central.
- Chính thức vận hành. Đưa BancoOS thành điểm nhập liệu vận hành. Business Central vẫn là hệ thống sổ sách chính.
Luồng dữ liệu
Dữ liệu danh mục và chứng từ mua hàng đang mở đi từ Business Central sang BancoOS. Hóa đơn đã duyệt, hóa đơn điều chỉnh giảm và bút toán thanh toán đi ngược về Business Central.
| Từ | Đến | Dữ liệu | Tần suất đồng bộ |
|---|---|---|---|
| Business Central | BancoOS | Nhà cung cấp và thông tin liên hệ | Hằng giờ + khi yêu cầu |
| Business Central | BancoOS | Tài khoản sổ cái và chiều phân tích | Hằng ngày |
| Business Central | BancoOS | Đơn mua hàng đang mở và phiếu nhận hàng | Mỗi 15 phút |
| BancoOS | Business Central | Hóa đơn mua hàng đã hạch toán | Khi được phê duyệt |
| BancoOS | Business Central | Hóa đơn điều chỉnh giảm (credit memo) | Khi được phê duyệt |
| BancoOS | Business Central | Bút toán nhật ký thanh toán | Khi thanh toán xong |
Tích hợp xử lý yêu cầu hóa đơn Việt Nam như thế nào
Hóa đơn của nhà cung cấp Việt Nam có những thông tin mà Business Central bản chuẩn không tự lưu được: mã số thuế (MST) của nhà cung cấp và thông tin tham chiếu hóa đơn điện tử. Tích hợp cần có đủ cả hai.
Gói bản địa hóa Việt Nam, hoặc phần mở rộng nhà cung cấp của BancoOS, bổ sung trường MST và trường hóa đơn điện tử vào hồ sơ nhà cung cấp và hóa đơn trong Business Central. MST phải được điền trên từng hồ sơ nhà cung cấp trong Business Central. Danh sách nhà cung cấp đồng bộ từ Business Central sang BancoOS hằng giờ và khi có yêu cầu, nên MST đã sửa sẽ sang BancoOS ở lần đồng bộ tiếp theo hoặc khi bạn đồng bộ lại danh mục.
Trước khi hạch toán, BancoOS xác thực hóa đơn điện tử với Cục Thuế (trước đây là Tổng cục Thuế). Chỉ hóa đơn đã được phê duyệt mới được ghi ngược về Business Central dưới dạng hóa đơn mua hàng đã hạch toán, kèm theo các chiều phân tích.
Để hiểu cách xác thực hoạt động, xem trang tích hợp GDT. Để biết kế toán cần kiểm tra gì trên mỗi hóa đơn, đọc hướng dẫn hóa đơn điện tử GDT.
Xử lý sự cố
Đây là các sự cố dễ gặp nhất khi vận hành thực tế, kèm nguyên nhân thường gặp và cách khắc phục. Nhật ký Hoạt động trong BancoOS là nơi nên kiểm tra đầu tiên.
Cấp phép OAuth thất bại khi kết nối lần đầu
Nguyên nhân thường gặp. Quản trị viên tenant Business Central chưa đồng ý cấp phép cho ứng dụng BancoOS, hoặc đã từ chối một số phạm vi quyền.
Cách khắc phục. Nhờ quản trị viên tenant chạy lại bước kết nối tại Tích hợp → Business Central và cấp đủ hai phạm vi API.ReadWrite.All và Financials.ReadWrite.All.
Hóa đơn bị từ chối với thông báo 'posting period is closed' (kỳ hạch toán đã khóa)
Nguyên nhân thường gặp. Business Central đã khóa 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 của hóa đơn trong BancoOS sang một kỳ còn mở, rồi thử lại từ màn hình Hoạt động.
Giá trị chiều phân tích không được phép
Nguyên nhân thường gặp. Tổ hợp chiều phân tích trên hóa đơn vi phạm một quy tắc chiều phân tích trong Business Central.
Cách khắc phục. Điều chỉnh quy tắc phê duyệt/hạch toán trong BancoOS hoặc quy tắc chiều phân tích trong Business Central, rồi thử lại. Nhật ký Hoạt động hiển thị chính xác mã chiều phân tích mà Business Central đã từ chối.
Không còn nhận được sự kiện webhook
Nguyên nhân thường gặp. Đăng ký (subscription) của Business Central đã hết hạn. Đăng ký có hiệu lực khoảng 3 ngày và tự gia hạn, nhưng chính sách của tenant có thể chặn việc 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 vẫn không gia hạn được, kiểm tra xem chính sách truy cập có điều kiện (conditional access) hoặc chính sách service principal có đang chặn BancoOS không.
Thiếu MST nhà cung cấp trên hóa đơn đã đồng bộ
Nguyên nhân thường gặp. Chưa cài gói bản địa hóa Việt Nam, hoặc trường MST trên hồ sơ nhà cung cấp trong Business Central đang để trống.
Cách khắc phục. Cài gói bản địa hóa Việt Nam trong Business Central (hoặc dùng phần mở rộng nhà cung cấp của BancoOS), điền MST cho nhà cung cấp, rồi đồng bộ lại danh mục.
Câu hỏi thường gặp
›BancoOS hỗ trợ những phiên bản Business Central nào?
BancoOS hỗ trợ Microsoft Dynamics 365 Business Central Online (SaaS) và bản triển khai on-prem có bật quyền truy cập API. Các trường bản địa hóa Việt Nam, gồm MST và tham chiếu hóa đơn điện tử, được ánh xạ tự động.
›Có cần Power Automate hay phần mềm trung gian riêng không?
Không. Bộ kết nối dùng trực tiếp API chính thức của Business Central. Bạn vẫn có thể dùng song song các luồng Power Automate nhưng không bắt buộc.
›Chiều phân tích (dimension) của Business Central được xử lý ra sao?
Tất cả chiều phân tích toàn cục và chiều phân tích lối tắt được đồng bộ sang BancoOS thành chiều phân tích của workspace. Chính sách phê duyệt hóa đơn có thể định tuyến theo bất kỳ giá trị chiều phân tích nào, và hóa đơn đã hạch toán mang các chiều phân tích đó ngược về Business Central.
›BancoOS yêu cầu những phạm vi quyền OAuth nào?
Khi kết nối tại Tích hợp → Business Central trong BancoOS, quản trị viên tenant Business Central cấp phép cho hai phạm vi API.ReadWrite.All và Financials.ReadWrite.All.
›Dữ liệu giữa Business Central và BancoOS đồng bộ bao lâu một lần?
Nhà cung cấp đồng bộ hằng giờ và khi có yêu cầu, tài khoản sổ cái và chiều phân tích hằng ngày, đơn mua hàng đang mở và phiếu nhận hàng mỗi 15 phút. Hóa đơn mua hàng đã hạch toán và hóa đơn điều chỉnh giảm được ghi về khi được phê duyệt, bút toán thanh toán khi thanh toán xong.
›Cần chuẩn bị gì cho trường MST và hóa đơn điện tử Việt Nam?
Cài gói bản địa hóa Việt Nam hoặc phần mở rộng nhà cung cấp của BancoOS, vốn bổ sung trường MST và hóa đơn điện tử trên hồ sơ nhà cung cấp và hóa đơn, rồi điền MST cho từng nhà cung cấp trong Business Central. BancoOS xác thực hóa đơn điện tử với Cục Thuế trước khi ghi hóa đơn đã duyệt về 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ủ đề.
Thêm về Tự động hóa tài chính tại Việt Nam
Toàn bộ cụm nội dung: cách tự động hóa công nợ phải trả, đối soát, phê duyệt và báo cáo dòng tiền cho đội tài chính Việt Nam.
Hóa đơn khách hàng, phiếu thu, tuổi nợ và thu hồi công nợ trên một sổ có kiểm toán.
Bảy năng lực AI vận hành BancoOS.
Các AI agent chuyên biệt cho tài chính và ngân hàng.
Đối soát PO / Phiếu nhập hàng / Hóa đơn từ đầu đến cuối.
So sánh song song tài chính thủ công với BancoOS.
ERP so với tự động hóa AP và lớp Hệ điều hành Tài chính.
Tự động hóa tài chính nhà máy và AP đa nhà máy.
AP, AR và đối soát cho nhà phân phối.
Hành trình khách hàng ẩn danh qua quy trình công nợ phải trả và phải thu.
Thêm về Hóa đơn điện tử GDT Việt Nam
Mọi nội dung về hóa đơn điện tử Việt Nam: xác thực GDT, kiểm tra MST, kết nối phần mềm kế toán và quy trình liên quan.
Cơ chế hóa đơn điện tử tại Việt Nam trên thực tế.
Đối soát PO / Phiếu nhập hàng / Hóa đơn từ đầu đến cuối.
Tài chính đa cửa hàng và đối soát POS.
AP, AR và đối soát cho nhà phân phối.
Trụ cột nền tảng tự động hóa tài chính.
Kiểm soát, chứng chỉ và khu vực dữ liệu.
Mọi thuật ngữ trong tự động hóa tài chính và AI.