Đồng bộ sao kê ngân hàng Việt Nam
bởi Casso
| Số dòng Code | 3814 |
| Tên kỹ thuật | l10n_vn_casso_bank_statements |
| Giấy phép | OPL-1 |
| Website | https://console.casso.vn/ |
| Yêu cầu các App | Invoicing (account) Discuss (mail) |
| Bao gồm Các phụ thuộc | Kế toán & Tài chính Casso Base |
Đồng Bộ Sao Kê Ngân Hàng Việt Nam
Đồng bộ sao kê ngân hàng Việt Nam tích hợp trực tiếp hạ tầng Open Banking Casso / BankHub vào phân hệ Kế toán Odoo. Module tự động kéo toàn bộ lịch sử biến động số dư và giao dịch thực tế từ các ngân hàng Việt Nam vào sổ nhật ký kế toán, hỗ trợ đối soát tức thì và tự động hóa quy trình khớp lệnh dòng tiền — chuẩn xác, bảo mật và hoàn toàn tự động.
Module yêu cầu cài đặt nền tảng Casso Base.
Kết nối ngân hàng 1 chạm
Liên kết tài khoản nhanh chóng — Sổ nhật ký tự động khởi sinh.
Đồng bộ theo yêu cầu
Chủ động chọn ngày lấy dữ liệu — Một cú click, giao dịch về ngay.
Tự động chạy ngầm hàng ngày
Lên lịch định kỳ tự động — Đầu ngày mở sổ có sẵn sao kê.
Chống trùng lặp tuyệt đối
Thuật toán dedup đa tiêu chí — Đồng bộ bao lần không sợ trùng.
Bao phủ ngân hàng Việt Nam
Kết nối mọi ngân hàng lớn — Vận hành mượt mà trên nền BankHub.
Đối soát kế toán tức thì
Dữ liệu chuẩn hóa theo Odoo — Sẵn sàng khớp lệnh và vào sổ nhanh.
- ✔ Wizard 3 bước: chọn ngân hàng → xác thực → chọn tài khoản để liên kết
- ✔ Kéo giao dịch theo khoảng ngày tùy chọn trực tiếp từ form sổ nhật ký
- ✔ Dedup tự động — giao dịch đã import không bao giờ bị tạo lại
- ✔ Sao kê nhóm theo ngày — một sao kê mỗi ngày/tuần/tháng mỗi sổ; dòng mới được thêm vào thay vì tạo trùng khi đồng bộ lại
- ✔ Cron tự động — kéo giao dịch hàng ngày; lịch, khoảng thời gian cấu hình được theo công ty
- ✔ Tự tạo sổ nhật ký ngân hàng và bản ghi tài khoản đối tác khi liên kết tài khoản
- ✔ Lưu lại dữ liệu giao dịch gốc theo từng dòng để tra cứu và đối chiếu khi cần
- ✔ Hỗ trợ nhiều tài khoản phụ — xác thực một lần, gán nhiều tài khoản ngân hàng cho các sổ khác nhau
Hướng dẫn Kết nối & Đồng bộ Sao kê Ngân hàng
- Thử nghiệm Sandbox: Khi test ở môi trường Sandbox, quý khách vui lòng sử dụng tài khoản VCB (Vietcombank) để thử nghiệm liên kết và đồng bộ giao dịch.
- Cơ chế chia sẻ kết nối:
- Nếu tài khoản ngân hàng đã được kết nối trước trên Casso Console: Hệ thống sẽ tự động chia sẻ kết nối xuống Odoo/Viindoo (tự nhận diện liên kết có sẵn, 1 chạm dùng ngay không cần đăng nhập lại).
- Nếu chưa kết nối trên Casso Console: Hệ thống sẽ tự động mở giao diện iframe BankHub SDK trực tiếp ngay trong Viindoo để quý khách đăng nhập và kết nối an toàn.
Onboarding — Chưa có sổ nhật ký
Dành cho người dùng lần đầu kết nối ngân hàng với Viindoo/Odoo. Vào Kế toán → Cấu hình → Thêm tài khoản ngân hàng để mở wizard liên kết. Wizard sẽ hướng dẫn: chọn ngân hàng → xác thực → chọn tài khoản → đặt ngày bắt đầu đồng bộ → sổ nhật ký và tài khoản đối tác được tạo tự động.
Onboarding — Đã có sổ nhật ký
Dành cho người dùng đã có sổ nhật ký ngân hàng (tạo thủ công hoặc từ file OFX) và muốn kết nối Casso vào sổ đó. Mở sổ nhật ký hiện có → phần Casso Bank Sync hiển thị trạng thái Chưa kết nối. Nhấn Kết nối Casso để mở wizard — các bước giống Flow 1 nhưng giao dịch và tài khoản được gán vào sổ hiện tại thay vì tạo mới.
Nhiều tài khoản phụ — Gán không cần xác thực lại
Khi người dùng xác thực một lần và ngân hàng trả về nhiều tài khoản (ví dụ: VCB có tài khoản thanh toán + tài khoản tiết kiệm), tất cả tài khoản chưa gán được lưu dưới dạng pending links. Các sổ nhật ký khác chưa kết nối sẽ hiển thị nút Liên kết tài khoản ngân hàng đã kết nối. Nhấn nút đó để mở picker — chọn tài khoản ngân hàng từ danh sách pending và gán vào sổ này mà không cần đăng nhập lại ngân hàng.
Sử dụng hàng ngày — Đồng bộ & Đối soát
Sau khi kết nối, có ba điểm truy cập chính để đồng bộ và xem giao dịch:
-
Reconcile view (Đối soát) — nhấn
Đồng bộ trên thanh breadcrumb để kéo nhanh giao dịch ngày hôm qua
mà không cần mở wizard.
-
Bank Statements (Sao kê) — xem toàn bộ
sao kê và dòng giao dịch của sổ nhật ký, nhóm theo ngày.
-
Cron tự động — mỗi ngày cron chạy kéo
giao dịch tự động. Cấu hình giờ chạy, khoảng thời gian và bật/tắt ngay trên
form sổ nhật ký qua nút Tùy chỉnh.
Hướng dẫn Liên kết API để Dùng Dịch Vụ
Luồng Sandbox (Môi trường thử nghiệm miễn phí)
- Đăng nhập vào Casso Console (https://console.casso.vn).
- Tại menu bên trái, nhấp chọn mục Sandbox → Nhấn nút Tự cấp quyền cho tôi.
- Nhấp vào tên tổ chức hiện tại ở góc trên bên trái menu → Chọn Chuyển tổ chức.
- Chọn tổ chức thử nghiệm Sandbox: CTY TNHH CASSO DEMO 1 (hoặc tổ chức có nhãn Sandbox).
* Hình ảnh mô phỏng liên tục 3 thao tác: Cấp quyền Sandbox → Chuyển tổ chức → Chọn tổ chức Sandbox.
- 2.1. Cấu hình môi trường Sandbox trên Viindoo: Vào ứng dụng Casso → API Configurations. Tại mục API Configuration, chọn Môi trường là Sandbox. Sau đó sao chép Redirect URI và Webhook URL.
- 2.2. Tạo API Credential trên Casso Console: Quay lại Casso Console (tổ chức Sandbox), vào Dashboard → Nhấn tạo API Credential mới. Đặt tên gợi nhớ (ví dụ:
Casso-Demo-Sandbox), dán Redirect URI và Webhook URL vừa sao chép từ Viindoo vào rồi nhấn Save.
- 2.3. Sao chép thông tin xác thực: Sau khi lưu, tại mục Additional information bên phải, sao chép Client ID và Client secret.
- 2.4. Dán thông tin vào Viindoo: Quay lại Viindoo, dán Client ID và Secret Key vào mục Thông tin xác thực (lấy từ Casso Console), điền tên Company rồi nhấn biểu tượng Lưu (Cloud).
- 2.5. Kiểm tra kết nối: Nhấn nút Kiểm tra kết nối ở thanh header phía trên. Cửa sổ thông báo hiển thị OK cho cả 3 mục (Client ID, Redirect URI, Webhook URL) là xác nhận kết nối thành công!
Quay lại Dashboard của tổ chức Sandbox trên Casso Console, tại mục Tài khoản Sandbox, hệ thống cung cấp sẵn các tài khoản demo chuẩn:
| Dịch vụ thử nghiệm | Tên đăng nhập / Tài khoản | Mật khẩu | Ghi chú |
|---|---|---|---|
| Ngân hàng (TEST) | bankusrdemo-c2 |
1 |
Khuyên dùng ngân hàng VCB (Vietcombank) để thử nghiệm |
Luồng Production (Môi trường thực tế)
- 1.1. Mở ứng dụng Casso: Từ màn hình chính / menu ứng dụng của Viindoo, tìm và nhấp chọn ứng dụng Casso.
- 1.2. Lấy thông tin URL từ Viindoo: Vào menu API Configurations. Tại mục CẤU HÌNH TRÊN CASSO CONSOLE, sao chép Redirect URI và Webhook URL. Nhấp vào đường dẫn https://console.casso.vn để mở Casso Console.
- 1.3. Tạo API Credential trên Casso Console: Trên Casso Console (tổ chức Production), tại mục Dashboard → Nhấn tạo API Credential mới. Đặt tên gợi nhớ (ví dụ:
Casso-Demo), dán Redirect URI và Webhook URL vừa sao chép từ Viindoo rồi nhấn Save.
- 1.4. Sao chép thông tin xác thực: Tại mục Additional information, sao chép Client ID và Client secret vừa tạo.
- 1.5. Dán khóa vào Viindoo: Quay lại Viindoo, dán Client ID và Secret Key vào mục Thông tin xác thực (lấy từ Casso Console) rồi nhấn biểu tượng Lưu (Cloud).
- 1.6. Kiểm tra kết nối: Nhấn nút Kiểm tra kết nối ở góc trên bên trái. Hộp thoại hiện lên hiển thị OK cho cả 3 mục (Client ID, Redirect URI, Webhook URL) là kết nối thành công hoàn tất!
Sau khi liên kết, mỗi sổ nhật ký ngân hàng hiển thị một thanh trạng thái ngay trên form. Thanh thay đổi theo trạng thái kết nối hiện tại:
Tài khoản ngân hàng đang hoạt động. Thanh trạng thái hiển thị thời gian đến lần đồng bộ tự động tiếp theo và thời điểm kéo lần cuối. Hai nút hành động: Đồng bộ, Huỷ kết nối, Tùy chỉnh.
Sổ nhật ký chưa có liên kết Casso. Hai điểm vào: Kết nối Casso (mở wizard liên kết mới) và Liên kết tài khoản ngân hàng đã kết nối (Liên kết tài khoản đã kết nối — xem Flow 3).
| Vai trò | Quyền hạn |
|---|---|
| Casso User (mọi nhân viên nội bộ) | Liên kết tài khoản ngân hàng, đồng bộ giao dịch, huỷ kết nối |
| Casso Manager (quản trị viên) | Toàn bộ quyền của Casso User, cộng thêm quản lý kết nối API và thông tin xác thực Casso |
0388 961 381
console.casso.vn
facebook.com/cassovn
Phần mềm này và các tệp liên kết ("Phần mềm") được sử dụng (chạy, tuỳ biến, chạy sau khi được tuỳ biến) chỉ khi bạn mua được giấy phép có hiệu lực từ tác giả, điển hình như qua các Ứng dụng Odoo, hoặc trong trường hợp bạn nhận được thoả thuận bằng văn bản từ tác giả của Phần mềm (chi tiết tại tệp COPYRIGHT).
Bạn có thể phát triển các phân hệ Odoo có sử dụng Phần mềm như một Thư viện (thường là phụ thuộc vào, nhập vào và sử dụng nguồn của nó) nhưng không sao chéo bất kỳ mã nguồn hay tài liệu nào thuộc Phần mềm. Bạn có thể phân phối những phân hệ này theo giấy phép mà bạn lựa chọn, miễn sao nội dung giấy phép đó tương tích với điều khoản của Giấy phép Phần mềm Độc quyền Odoo (ví dụ: LGPL, MIT hay bất kỳ loại giấy phép phần mềm độc quyền nào tương tự vậy).
Nghiêm cấm phát hành, phân phối, cấp phép lại hoặc bán bản sao của Phần mềm hoặc bản sao Phần mềm đã được sửa đổi.
Thông báo bản quyền và chấp thuận nêu trên buộc phải được bao gồm trong tất cả các bản sao hoặc các phần quan trọng của Phần mềm.
PHẦN MỀM ĐƯỢC CUNG CẤP "NGUYÊN TRẠNG", KHÔNG BẢO ĐẢM DƯỚI BẤT KỲ HÌNH THỨC NÀO, ĐƯỢC THỂ HIỆN RÕ RÀNG HOẶC NGỤ Ý, KHÔNG GIỚI HẠN ĐẢM BẢO VỀ CÁC BẢO ĐẢM NGỤ Ý VỀ KHẢ NĂNG THƯƠNG MẠI, PHÙ HỢP VỚI MỤC ĐÍCH CỤ THỂ VÀ KHÔNG VI PHẠM. TRONG MỌI TRƯỜNG HỢP SẼ KHÔNG CÓ TÁC GIẢ HOẶC CHỦ SỞ HỮU BẢN QUYỀN NÀO CHỊU TRÁCH NHIỆM VỀ BẤT KỲ KHIẾU NẠI, THIỆT HẠI HOẶC TRÁCH NHIỆM PHÁP LÝ KHÁC NÀO TRONG PHẠM VI HỢP ĐỒNG, CÁC THIỆT HẠI HOẶC CÁCH KHÁC, PHÁT SINH TỪ, NGOÀI HOẶC CÓ LIÊN KẾT VỚI PHẦN MỀM HOẶC VIỆC SỬ DỤNG HOẶC KINH DOANH KHÁC TẠI PHẦN MỀM.