Bỏ qua tới nội dung
Tài liệu Lấy API Token
Trong trang này

Tích hợp Google Sheets

Google Sheets cho phép TinoPay 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  ──►  TinoPay ghi nhận giao dịch
                                │
                                ▼
                 TinoPay 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 TinoPay.

#Thiết lập

Vào dashboard TinoPay, mở menu Tích hợp → 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 — Tài khoản Google

Lần đầu, bấm Đăng nhập bằng Google và chọn tài khoản chứa bảng tính. Nếu đã liên kết trước đó, chọn tài khoản trong danh sách hoặc bấm Liên kết tài khoản Google khác.

Ở 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 TinoPay sẽ không tạo hay ghi được bảng tính nào.

#Bước 2 — 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 TinoPay 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ó. TinoPay 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ũ sau:

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 TinoPay, tra cứu được ở menu Giao dịch → Lịch sử giao dịch hoặc qua API lịch sử giao dịch.

#Bước 3 — Phạm vi

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 — Xác nhận

Đặ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

TinoPay 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

TinoPay 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 TinoPay tạo hoặc do chính bạn chọn qua hộp thoại chọn file

Nghĩa là TinoPay 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 TinoPay.

#Lưu ý quan trọng

  • Không đổi tên, chèn hoặc xóa 10 cột mặc định. TinoPay 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.