Trong trang này
Tích hợp Google Sheets
Google Sheets cho phép QHTech tự động ghi mọi giao dịch phát sinh vào một bảng tính Google của bạn, ngay khi ngân hàng báo biến động số dư. Không cần lập trình, không cần máy chủ — phù hợp với kế toán, chủ shop hay bất kỳ ai muốn theo dõi dòng tiền bằng bảng tính quen thuộc.
Khác với Webhooks (cần bạn tự dựng endpoint để nhận dữ liệu), Google Sheets là tích hợp không cần code.
#Luồng hoạt động
Khách chuyển khoản
│
▼
Ngân hàng ghi nhận ──► QHTech ghi nhận giao dịch
│
▼
QHTech gom giao dịch ~10 giây
│
▼
Ghi một lần nhiều dòng ──► Bảng tính Google của bạn
Giao dịch được gom trong khoảng 10 giây rồi ghi một lượt, nhằm không chạm trần hạn mức của Google Sheets API. Vì vậy dòng mới thường xuất hiện sau vài giây chứ không tức thì.
#Yêu cầu
- Một tài khoản Google (Gmail hoặc Google Workspace).
- Ít nhất một tài khoản ngân hàng đã kết nối với QHTech.
#Thiết lập
Vào dashboard QHTech, mở menu Google Sheets rồi bấm Thêm tích hợp. Trình hướng dẫn gồm 4 bước.
#Bước 1 — Đăng nhập Google
Bấm Đăng nhập bằng Google và chọn tài khoản chứa bảng tính.
Ở màn hình cấp quyền, Google hiển thị một ô tích quyền truy cập Google Drive và để trống mặc định. Bạn bắt buộc phải tích vào ô này, nếu không QHTech sẽ không tạo hay ghi được bảng tính nào.
#Bước 2 — Cấu hình bảng tính
Chọn một trong hai cách:
| Cách | Khi nào dùng |
|---|---|
| Tạo mới bảng tính | QHTech tạo sẵn bảng tính đúng định dạng cột. Bạn đặt tên và chọn thư mục lưu trong My Drive. |
| Chọn bảng tính có sẵn | Dùng bảng tính bạn đã có. QHTech tự thêm hàng tiêu đề nếu trang tính còn trống. |
Sau đó chọn trang tính (sheet) sẽ nhận dữ liệu, và tuỳ chọn tự động xóa giao dịch cũ:
| Tuỳ chọn | Ý nghĩa |
|---|---|
| Không xóa | Giữ toàn bộ lịch sử. Bảng tính sẽ lớn dần. |
| 60 phút / 4 tiếng / 8 tiếng / 1 ngày | Xóa các dòng cũ hơn mốc này. Hệ thống dọn dẹp mỗi 10 phút. |
Dữ liệu bị xóa khỏi bảng tính vẫn còn nguyên trong QHTech, tra cứu được ở menu Giao dịch hoặc qua API lịch sử giao dịch.
#Bước 3 — Chọn phạm vi dữ liệu
| Trường | Mô tả |
|---|---|
| Tất cả ngân hàng | Mọi tài khoản hiện có, kể cả tài khoản thêm sau này. |
| Tùy chỉnh ngân hàng | Chỉ những tài khoản bạn chọn. Với mỗi tài khoản có thể lọc tiếp theo tài khoản ảo (VA) — không chọn VA nào nghĩa là nhận toàn bộ giao dịch của tài khoản đó. |
| Loại giao dịch | Tất cả / Tiền vào / Tiền ra. |
| Ẩn số dư giao dịch | Bật thì cột Lũy kế để trống, dùng khi bạn chia sẻ bảng tính cho người khác. |
#Bước 4 — Lưu tích hợp
Đặt tên gợi nhớ, kiểm tra lại bảng tóm tắt rồi bấm Lưu tích hợp. Từ thời điểm này, mọi giao dịch khớp điều kiện sẽ được ghi vào bảng tính.
#Cấu trúc cột
QHTech ghi đúng 10 cột theo thứ tự sau:
| Cột | Tiêu đề | Nội dung |
|---|---|---|
| A | Ngân hàng | Tên đầy đủ của ngân hàng |
| B | Ngày giao dịch | Định dạng YYYY-MM-DD HH:MM:SS |
| C | Số tài khoản | Số tài khoản ngân hàng nhận/chi tiền |
| D | Tài khoản phụ | Số tài khoản ảo (VA), trống nếu giao dịch không qua VA |
| E | Code TT | Mã thanh toán trích từ nội dung chuyển khoản |
| F | Nội dung thanh toán | Nội dung chuyển khoản |
| G | Loại | Tiền vào hoặc Tiền ra |
| H | Số tiền | Số tiền giao dịch |
| I | Mã tham chiếu | Mã tham chiếu của ngân hàng |
| J | Lũy kế | Số dư sau giao dịch, trống nếu bật Ẩn số dư |
Cột E (Code TT) được trích theo cấu trúc mã thanh toán bạn khai báo tại menu Cài đặt → Cấu trúc mã thanh toán. Nếu nội dung chuyển khoản không chứa mã nào khớp, ô này để trống.
#Quyền truy cập
QHTech chỉ xin một quyền duy nhất trên Google Drive của bạn:
| Quyền | Phạm vi |
|---|---|
drive.file |
Chỉ những file do QHTech tạo hoặc do chính bạn chọn qua hộp thoại chọn file |
Nghĩa là QHTech không đọc được các file khác trong Drive của bạn, kể cả khi bạn có hàng nghìn tài liệu. Bạn có thể thu hồi quyền bất kỳ lúc nào tại myaccount.google.com/permissions, hoặc bằng cách xóa tích hợp trong QHTech.
#Lưu ý quan trọng
- Không đổi tên, chèn hoặc xóa 10 cột mặc định. QHTech dựa vào thứ tự cột để ghi dữ liệu; thay đổi cấu trúc sẽ khiến dữ liệu ghi sai vị trí. Muốn thêm cột riêng, hãy thêm ở phía bên phải cột J.
- Không xóa hàng tiêu đề ở dòng 1.
- Nếu bạn thu hồi quyền phía Google hoặc xóa bảng tính, tích hợp sẽ tự chuyển sang trạng thái Tạm dừng kèm thông báo lỗi. Liên kết lại tài khoản Google để tiếp tục.
- Có thể tạo nhiều tích hợp trỏ tới nhiều bảng tính khác nhau, ví dụ mỗi chi nhánh một bảng tính.
#Xử lý sự cố
| Hiện tượng | Nguyên nhân thường gặp |
|---|---|
| Bảng tính không có dòng nào | Chưa có giao dịch khớp điều kiện lọc ở bước 3, hoặc tích hợp đang Tạm dừng |
| Tích hợp tự chuyển sang Tạm dừng | Quyền Google đã bị thu hồi, hoặc bảng tính đã bị xóa/đổi chủ sở hữu |
| Không tạo được bảng tính | Ở bước cấp quyền chưa tích vào ô quyền Google Drive |
| Dữ liệu ghi lệch cột | Cấu trúc 10 cột mặc định đã bị sửa |
Cột Đẩy gần nhất ở trang danh sách cho biết lần ghi thành công gần nhất. Nếu có lỗi, biểu tượng cảnh báo cạnh tên tích hợp sẽ hiện chi tiết khi rê chuột vào.
Cần tích hợp sâu hơn vào hệ thống của bạn? Xem Webhooks · Tổng quan.