Kết nối MISA AMIS (OpenAPI)

Ngoài phương thức xuất file Excel truyền thống, Dòng Tiền Pro hỗ trợ kênh kết nối trực tiếp (OpenAPI) tới phần mềm kế toán MISA AMIS (mã sản phẩm AMISKT). Kênh này cho phép gửi chứng từ Thu tiền gửi và Chi tiền gửi thẳng vào hệ thống MISA của khách hàng dưới dạng Đề nghị lập chứng từ.

1. Cơ chế hoạt động (D47)

• Đề nghị lập chứng từ: Lệnh save của MISA OpenAPI tạo bản ghi trong danh sách Đề nghị lập chứng từ của phân hệ Tiền gửi trong MISA AMIS (reftype 1500 cho Giấy báo Có ba_deposit và reftype 1510 cho Giấy báo Nợ ba_withdraw).
• Không tự động ghi sổ: Để đảm bảo kiểm soát nghiệp vụ, Dòng Tiền Pro không can thiệp tự động ghi sổ. Kế toán doanh nghiệp vẫn thực hiện bước: Kiểm tra đề nghị → Lập chứng từ → Ghi sổ trực tiếp trên giao diện MISA AMIS.
• Tính lũy biến (org_refid): Mỗi chứng từ ngân hàng gửi sang MISA mang một mã định danh duy nhất org_refid (UUIDv5 dựa trên ID giao dịch). Việc gửi lại chứng từ nhiều lần sẽ cập nhật tại chỗ mà không tạo chứng từ trùng lặp trong MISA.

2. Thiết lập kết nối

1. Lấy mã kết nối trên MISA:
   • Quản trị viên MISA AMIS truy cập Thiết lập → Quản lý kết nối → Lấy mã kết nối (Access Code) của công ty và chi nhánh (branch_id).
2. Khai báo trên Dòng Tiền Pro:
   • Truy cập Xuất kế toán → Chọn tab Kết nối MISA.
   • Nhập Chi nhánh MISA và Mã kết nối (được mã hoá bảo mật bằng công nghệ phong bì, không bao giờ lộ ra log hay API).
   • Bấm Kiểm tra kết nối để xác nhận tính hợp lệ của token truy cập.
3. Đồng bộ danh mục tài khoản và đối tượng:
   • Bấm Đồng bộ danh mục để kiểm tra mã tài khoản ngân hàng và mã đối tượng (khách hàng 131, nhà cung cấp 331).
   • Nếu có đối tượng chưa tồn tại trên MISA, hệ thống sẽ tự động gọi hàm tạo danh mục save_dictionary trước khi đẩy chứng từ.

3. Theo dõi trạng thái & Xử lý bất đồng bộ

Do ứng dụng AMISKT của MISA hiện chưa bật webhook tự động (HasWebhook=0), Dòng Tiền Pro áp dụng cơ chế theo dõi đa tầng:

• sent: Đề nghị đã được máy chủ MISA tiếp nhận thành công.
• unconfirmed: Nếu sau 24 giờ chưa có tín hiệu phản hồi, hệ thống đánh dấu trạng thái chờ xác nhận. Kế toán có thể bấm Gửi lại hoặc bấm Kế toán đã lập nếu đã xử lý xong trong MISA.
• generated: Kế toán đã bấm "Lập chứng từ" thành công trên MISA.
• posted_inferred: Hệ thống tự động suy luận trạng thái đã ghi sổ thông qua đối soát công nợ đối tượng định kỳ.
• Đảo chứng từ: Nếu chứng từ gốc bị huỷ hoặc hoàn tiền sau khi đã lập trong MISA, hệ thống hỗ trợ tạo đề nghị lập chứng từ đảo ngược chiều tương ứng.