Chuẩn hoá và đối soát sao kê ngân hàng online

Đọc file sao kê XLSX / CSV của các ngân hàng Việt Nam về một cấu trúc chung, kiểm tra số dư luỹ kế và đối soát tiền về với danh sách cần thu.

Kết quả

Bấm “Chạy” để xem kết quả.

Tải lên file sao kê xuất từ internet banking dạng XLSX hoặc CSV, hoặc gửi các dòng dạng JSON. API tìm dòng tiêu đề nằm dưới phần đầu trang của ngân hàng, nhận diện cột tiếng Việt hoặc tiếng Anh (ngày giao dịch, số tham chiếu, ghi nợ / ghi có hoặc một cột số tiền có dấu, số dư, nội dung / diễn giải, đối ứng…), nhận biết ngân hàng và số tài khoản từ phần đầu, rồi trả mọi giao dịch theo một cấu trúc chung: ngày, nợ, có, số tiền có dấu, số dư, nội dung, số tham chiếu, đối ứng và mã đơn tìm được theo prefix / pattern. Dòng tổng cộng, số dư đầu kỳ, cuối kỳ được nhận diện và bỏ qua.

Số dư luỹ kế được kiểm tra theo cả hai chiều xuất file (cũ trước hoặc mới trước): mỗi số dư phải bằng số dư trước cộng tiền có trừ tiền nợ; các dòng lệch được liệt kê cùng số dư đầu kỳ, cuối kỳ. Gửi expected ([{"code", "amount"}], tối đa 5.000 khoản) để đối soát: mỗi khoản tiền về được khớp theo mã, sau đó theo số tiền duy nhất; kết quả gồm các khoản đã khớp, thiếu / thừa tiền, chưa nhận, và các khoản tiền về không khớp khoản nào.

Không đọc file .xls nhị phân cũ và sao kê PDF (hãy lưu thành .xlsx hoặc CSV; /v1/pdf-text lấy chữ từ PDF). File chỉ xử lý trong bộ nhớ, không lưu lại.

Dùng trong code của bạn

curl -X POST "https://apibox.io.vn/v1/vn-bank-statement" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"csv":"Ngày giao dịch,Số tham chiếu,Nội dung,Ghi nợ,Ghi có,Số dư\n10/11/2026,FT001,CT DEN DH1001 NGUYEN VAN A,,\"500,000\",\"10,500,000\"\n10/11/2026,FT002,Phi SMS,\"11,000\",,\"10,489,000\"\n11/11/2026,FT003,DH1002 TRAN THI B,,\"1,200,000\",\"11,689,000\"","prefix":"DH","expected":[{"code":"DH1001","amount":500000},{"code":"DH1002","amount":1250000},{"code":"DH1003","amount":99000}]}'

const res = await fetch('https://apibox.io.vn/v1/vn-bank-statement', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "csv": "Ngày giao dịch,Số tham chiếu,Nội dung,Ghi nợ,Ghi có,Số dư\n10/11/2026,FT001,CT DEN DH1001 NGUYEN VAN A,,\"500,000\",\"10,500,000\"\n10/11/2026,FT002,Phi SMS,\"11,000\",,\"10,489,000\"\n11/11/2026,FT003,DH1002 TRAN THI B,,\"1,200,000\",\"11,689,000\"",
    "prefix": "DH",
    "expected": [
      {
        "code": "DH1001",
        "amount": 500000
      },
      {
        "code": "DH1002",
        "amount": 1250000
      },
      {
        "code": "DH1003",
        "amount": 99000
      }
    ]
  }),
});
const data = await res.json();
console.log(data);

import requests

res = requests.post(
    "https://apibox.io.vn/v1/vn-bank-statement",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    json={"csv": "Ngày giao dịch,Số tham chiếu,Nội dung,Ghi nợ,Ghi có,Số dư\n10/11/2026,FT001,CT DEN DH1001 NGUYEN VAN A,,\"500,000\",\"10,500,000\"\n10/11/2026,FT002,Phi SMS,\"11,000\",,\"10,489,000\"\n11/11/2026,FT003,DH1002 TRAN THI B,,\"1,200,000\",\"11,689,000\"", "prefix": "DH", "expected": [{"code": "DH1001", "amount": 500000}, {"code": "DH1002", "amount": 1250000}, {"code": "DH1003", "amount": 99000}]},
    timeout=30,
)
print(res.json())

<?php
$ch = curl_init('https://apibox.io.vn/v1/vn-bank-statement');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_HTTPHEADER => ['Authorization: Bearer YOUR_API_KEY', 'Content-Type: application/json'],
    CURLOPT_POSTFIELDS => '{"csv":"Ngày giao dịch,Số tham chiếu,Nội dung,Ghi nợ,Ghi có,Số dư\\n10/11/2026,FT001,CT DEN DH1001 NGUYEN VAN A,,\\"500,000\\",\\"10,500,000\\"\\n10/11/2026,FT002,Phi SMS,\\"11,000\\",,\\"10,489,000\\"\\n11/11/2026,FT003,DH1002 TRAN THI B,,\\"1,200,000\\",\\"11,689,000\\"","prefix":"DH","expected":[{"code":"DH1001","amount":500000},{"code":"DH1002","amount":1250000},{"code":"DH1003","amount":99000}]}',
]);
$response = curl_exec($ch);
print_r(json_decode($response, true));

Tài liệu API → Nhận API key miễn phí

Hỏi đáp

Hỗ trợ ngân hàng nào?

Mọi file có dòng tiêu đề gồm cột ngày và cột nợ / có hoặc số tiền, bằng tiếng Việt hay tiếng Anh: bao gồm các mẫu xuất thông dụng của Vietcombank, BIDV, VietinBank, Techcombank, MB, ACB, VPBank. Ngân hàng được nhận diện từ phần đầu file hoặc truyền qua bank.

Kiểm tra số dư làm gì?

Tính lại từng số dư từ số dư trước và số tiền phát sinh, theo thứ tự trong file hoặc đảo ngược, rồi liệt kê các dòng không khớp.

File có bị lưu không?

Không. File chỉ được đọc trong bộ nhớ cho đúng yêu cầu đó.