BancoOS + MISA: cài đặt, luồng dữ liệu và xử lý sự cố
MISA là hệ thống ghi nhận kế toán cho hầu hết doanh nghiệp Việt Nam. BancoOS đặt trên MISA như lớp vận hành — thu nhận hóa đơn, chạy phê duyệt và đẩy bút toán đã hạch toán trở lại MISA mà không cần nhập lại. Trang này hướng dẫn cách kết nối hai hệ, đồng bộ theo chiều nào và cách xử lý các vấn đề phát sinh.
Điều kiện tiên quyết
- Tenant MISA SME hoặc MISA AMIS đang hoạt động có bật quyền API.
- Người dùng tích hợp MISA riêng có quyền đọc danh mục và hạch toán hóa đơn và thanh toán.
- Workspace BancoOS có quyền quản trị để cấu hình tích hợp.
- Khả năng truy cập mạng giữa BancoOS và endpoint MISA (MISA đám mây hoạt động ngay; MISA on-prem có thể cần quy tắc API đầu ra).
Cài đặt từng bước
- Tạo người dùng tích hợp MISA. Trong MISA, thêm người dùng riêng có quyền API. Tránh dùng tài khoản của nhân viên thực để việc đổi mật khẩu không phá hỏng tích hợp.
- Kết nối từ BancoOS. Mở Tích hợp → MISA → Kết nối, nhập endpoint API MISA, mã định danh tenant và thông tin đăng nhập của người dùng tích hợp. BancoOS xác thực kết nối trước khi lưu.
- Ánh xạ danh mục. Ánh xạ nhà cung cấp MISA, hệ thống tài khoản, trung tâm chi phí, dự án và mã thuế Việt Nam sang chiều BancoOS. Hầu hết ánh xạ tự đề xuất dựa trên MST và số tài khoản.
- Chạy kỳ mẫu. Bật hạch toán song song trong một đến hai tuần. So sánh log Hoạt động BancoOS với hạch toán MISA hàng ngày và giải quyết ngoại lệ trước khi chuyển đổi.
- Đi vào vận hành. Chuyển BancoOS thành điểm nhập vận hành. MISA vẫn là hệ thống ghi nhận; BancoOS xử lý thu nhận, đối soát, phê duyệt và thanh toán.
Luồng dữ liệu dự kiến
| Từ | Đến | Đối tượng | Nhịp |
|---|---|---|---|
| MISA | BancoOS | Nhà cung cấp và MST | Hàng giờ + theo yêu cầu |
| MISA | BancoOS | Hệ thống tài khoản, trung tâm chi phí, dự án | Hàng ngày |
| MISA | BancoOS | Đơn đặt hàng mở | Mỗi 15 phút |
| BancoOS | MISA | Hóa đơn công nợ phải trả đã phê duyệt | Khi phê duyệt (gần thời gian thực) |
| BancoOS | MISA | Hóa đơn điều chỉnh và bút toán điều chỉnh | Khi phê duyệt |
| BancoOS | MISA | Lô thanh toán và xác nhận ngân hàng | Khi thanh toán |
Xử lý sự cố
Không tìm thấy nhà cung cấp khi hạch toán hóa đơn
Nguyên nhân có thể. MST nhà cung cấp trong BancoOS không khớp bản ghi nhà cung cấp trong MISA.
Cách khắc phục. Mở ngoại lệ trong BancoOS, ánh xạ nhà cung cấp đến bản ghi MISA đúng, rồi thử hạch toán lại. Nhà cung cấp mới có thể tự tạo nếu bật tùy chọn đó trong cài đặt workspace.
Tài khoản sổ cái bị MISA từ chối
Nguyên nhân có thể. Tài khoản trong ánh xạ mã BancoOS đã bị lưu trữ hoặc đánh số lại trong MISA.
Cách khắc phục. Kích hoạt đồng bộ lại hệ thống tài khoản từ Tích hợp → MISA → Đồng bộ lại danh mục, rồi áp dụng lại ánh xạ trong mẫu hóa đơn bị ảnh hưởng.
Hạch toán thành công trong BancoOS nhưng hóa đơn không có trong MISA
Nguyên nhân có thể. API MISA trả về lỗi bất đồng bộ sau xác nhận ban đầu.
Cách khắc phục. Kiểm tra Tích hợp → MISA → Hoạt động. Sự kiện thất bại hiển thị mã lỗi MISA; nhấn Thử lại khi vấn đề gốc (thường là kỳ bị khóa hoặc thiếu năm tài chính) được sửa trong MISA.
Không khớp mã thuế khi đồng bộ
Nguyên nhân có thể. Mã VAT Việt Nam trong MISA không khớp ánh xạ mã thuế BancoOS.
Cách khắc phục. Cập nhật ánh xạ trong Tích hợp → MISA → Mã thuế. Ngoại lệ hiện có có thể hạch toán lại hàng loạt khi ánh xạ được sửa.
Kết nối bị đứt với lỗi xác thực
Nguyên nhân có thể. Thông tin đăng nhập API MISA đã đổi hoặc người dùng tích hợp bị vô hiệu hóa.
Cách khắc phục. Xác thực lại từ Tích hợp → MISA → Kết nối lại. Dùng người dùng tích hợp MISA riêng để việc đổi mật khẩu hàng ngày không ảnh hưởng đồng bộ.
Câu hỏi thường gặp
›Sản phẩm MISA nào được hỗ trợ?
BancoOS hỗ trợ MISA SME và MISA AMIS qua API chính thức, với ánh xạ cho nhà cung cấp, tài khoản sổ cái, trung tâm chi phí, dự án và mã thuế Việt Nam.
›Tích hợp có hai chiều không?
Có. Dữ liệu danh mục chảy từ MISA vào BancoOS, và dữ liệu vận hành (hóa đơn đã phê duyệt, thanh toán, hóa đơn điều chỉnh) chảy từ BancoOS trở lại MISA gần thời gian thực.
›Cài đặt tích hợp MISA điển hình mất bao lâu?
Hầu hết khách hàng hoàn tất cài đặt MISA trong 2–5 ngày làm việc: nửa ngày cho thông tin xác thực và ánh xạ, 1–2 ngày xác thực kỳ mẫu, và chạy song song ngắn trước khi vận hành.
›Nếu MISA tạm thời không truy cập được thì sao?
BancoOS xếp hàng sự kiện đồng bộ và thử lại với thời gian chờ theo hàm mũ. Không mất dữ liệu — khi MISA truy cập lại, hàng đợi được xử lý theo thứ tự, giữ nguyên chuỗi nhân quả.
Trang tiếp theo nên đọc
Business CentralConnector tài chính Dynamics 365 Business Central.Đọc tiếp
Khám phá thêm chủ đề Tích hợp
Các trang cùng nhóm chủ đề.