Kết nối nguồn dữ liệu
Kết nối ngân hàng, hóa đơn điện tử, POS, Excel/Google Sheets — đầu vào để AI Agent có thể làm việc.
Kết nối nguồn dữ liệu
AI Agent chỉ tốt khi có dữ liệu. Phần này hướng dẫn kết nối các nguồn dữ liệu phổ biến nhất để KOPA có thể tự động hóa.
Tối thiểu cần kết nối gì?#
Để bắt đầu nhanh, kết nối ít nhất 2 trong 3 nguồn sau:
- Một tài khoản ngân hàng — để đối soát giao dịch và tạo bút toán thu/chi tự động.
- Một nhà cung cấp hóa đơn điện tử (Misa, FPT, VNPT, Viettel) — để hóa đơn đầu vào/đầu ra tự đổ vào KOPA.
- Excel/Google Sheets — cho dữ liệu doanh nghiệp đặc thù không có connector chuyên dụng (lương, tồn kho, công nợ chi tiết).
Sau đó có thể bổ sung thêm POS, kho vận, e-commerce.
Ngân hàng#
KOPA hỗ trợ kết nối trực tiếp:
- Vietcombank (VCB)
- BIDV
- Techcombank (TCB)
- VPBank
- MBBank (MB)
- ACB, Sacombank, OCB, MSB (qua Casso)
- Bất kỳ ngân hàng nào hỗ trợ MT940 / SWIFT (xuất file thủ công)
Cách kết nối#
- Vào Cài đặt → Connectors → Ngân hàng → + Thêm tài khoản.
- Chọn ngân hàng.
- Nhập số tài khoản, chủ tài khoản và (tùy ngân hàng) mã CIF.
- KOPA mở popup OAuth của ngân hàng → đăng nhập internet banking → cấp quyền read-only.
- KOPA tự động kéo lịch sử giao dịch 90 ngày gần nhất.
Bảo mật: KOPA chỉ yêu cầu quyền đọc giao dịch và số dư. Không có quyền chuyển tiền, không lưu mật khẩu internet banking. Token bị thu hồi bất kỳ lúc nào từ phía ngân hàng.
Lịch đồng bộ#
- Real-time — VCB, BIDV, MB (webhook ngay khi có giao dịch).
- 15 phút — TCB, VPB.
- 1 giờ — các ngân hàng qua Casso.
- Thủ công — file MT940/CSV.
Đọc chi tiết ở Tích hợp ngân hàng.
Hóa đơn điện tử#
KOPA tích hợp với các nhà cung cấp hóa đơn điện tử Việt Nam:
- Misa MeInvoice — phổ biến nhất.
- FPT eInvoice.
- VNPT Invoice.
- Viettel SInvoice.
- EasyInvoice (Hilo).
- iHoaDon.
Hóa đơn đầu vào (mua hàng)#
Khi có hóa đơn đầu vào mới:
- KOPA pull qua API/webhook.
- OCR và đối chiếu MST nhà cung cấp.
- Phân loại tự động (nguyên vật liệu, dịch vụ, chi phí, TSCĐ).
- Đề xuất bút toán theo chế độ kế toán Việt Nam (Nợ TK 152/156/641... / Có TK 331/111/112).
- Đẩy vào hàng đợi duyệt.
Hóa đơn đầu ra (bán hàng)#
Hóa đơn đầu ra thường được phát hành từ phía bạn trong nhà cung cấp einvoice rồi đồng bộ ngược về KOPA. KOPA tự đề xuất bút toán bán hàng (Nợ TK 131/111/112 / Có TK 511/3331).
Đọc chi tiết ở Hóa đơn điện tử.
POS / Quản lý bán hàng#
Nếu bạn dùng POS:
- KiotViet — phổ biến nhất với F&B/retail.
- Sapo — bán lẻ, bán online đa kênh.
- iPos — F&B chuỗi.
- Haravan — e-commerce.
Sau khi kết nối, mỗi đơn hàng POS sẽ tự thành doanh thu trong KOPA, được tổng hợp theo ngày để giảm số bút toán.
Đọc chi tiết ở POS.
Excel & Google Sheets#
Cho mọi trường hợp khác — ví dụ bảng lương Excel, danh sách công nợ:
- Vào Connectors → Spreadsheets → + Thêm.
- Đăng nhập Google Drive (cho Sheets) hoặc upload file (cho Excel).
- Chọn sheet/tab cần lấy.
- Map các cột vào trường KOPA: ngày, mã, mô tả, số tiền, tài khoản nợ/có.
- Đặt lịch đồng bộ (đọc lại sheet mỗi giờ/ngày).
Mẹo: KOPA cung cấp template Google Sheets sẵn cho bảng lương, công nợ và sổ quỹ. Vào Connectors → Spreadsheets → Template để copy.
Đọc chi tiết ở Excel & Google Sheets.
Kiểm tra kết nối#
Sau khi thêm connector, vào Cài đặt → Connectors để xem trạng thái:
| Badge | Ý nghĩa |
|---|---|
| 🟢 Connected | Đang đồng bộ tốt |
| 🟡 Needs auth | Token hết hạn, bấm để re-auth |
| 🔴 Error | Lỗi (xem log để biết chi tiết) |
| ⚪ Disabled | Tạm dừng đồng bộ (vẫn giữ cấu hình) |
Sự cố thường gặp#
- VCB OAuth báo lỗi 403 — IP của bạn ngoài Việt Nam. KOPA tự dùng proxy VN trong production, dev local cần VPN VN.
- Hóa đơn Misa không kéo về — kiểm tra API Token và Tax Code trong cấu hình. MST sai hoặc token cũ là nguyên nhân phổ biến.
- Google Sheets báo permission denied — re-share sheet với email của KOPA service account hiển thị trong Connectors → Spreadsheets.
Xem thêm tại Khắc phục sự cố.