Ghi giao dịch vào Lark Base và Google Sheets

Hai tích hợp bảng tính này chép từng giao dịch đã xác thực vào một bảng bạn kiểm soát, thành một dòng cho mỗi giao dịch, để kế toán lọc, cộng và chia sẻ. Bảng tính là sổ phụ chỉ ghi thêm; nguồn sự thật vẫn là sổ của Dòng Tiền Pro, vì người dùng có thể sửa, xoá hoặc chia sẻ bảng ở bên ngoài.

Dòng nào được ghi

• Chỉ sự kiện giao dịch được xác thực. Giao dịch Tạm tính và giao dịch cách ly không bao giờ được ghi. Nhãn Đã xác thực là xác thực nguồn, không phải ngân hàng xác nhận quyết toán.
• Khoá của dòng là mã giao dịch tx_id. Trước khi tạo dòng, hệ thống tra tx_id trong bảng: nếu có thì sửa, chưa có thì thêm. Vì vậy gửi lại hoặc thử lại không bao giờ nhân đôi dòng.
• Tích hợp chỉ gửi một chiều (từ Dòng Tiền Pro sang bảng) và không tính vào hạn mức giao dịch.

Các cột gồm mã giao dịch, ngân hàng, tài khoản (chỉ bốn số cuối), chiều tiền, số tiền, loại tiền, nội dung chuyển khoản đã chuẩn hoá, đối tác đã che, thời điểm xảy ra và thời điểm nhận, mức tin cậy và trạng thái. Nội dung gốc của SMS hay email không được ghi.

Số dư không có trong bảng. Chỉ khi quy tắc bật tuỳ chọn Gửi cả số dư (mặc định tắt) thì cột số dư mới xuất hiện; khi tắt, cột này không tồn tại.

Lark Base

Dòng Tiền Pro dùng một ứng dụng tuỳ chỉnh của Lark trong tổ chức của bạn, chỉ xin quyền tạo, tìm và sửa bản ghi.

1. Trong Lark, tạo một ứng dụng tuỳ chỉnh và cấp quyền chỉnh sửa bản ghi cho bảng cần dùng. Sao chép app_id và app_secret.

2. Tạo một bảng Lark Base với các cột như mô tả ở trên, rồi sao chép địa chỉ hoặc mã của bảng.

3. Trong Tích hợp, thêm Lark Base và dán app_id, app_secret và địa chỉ bảng. app_secret được mã hoá và không hiển thị lại.

4. Bấm Gửi thử. Hệ thống ghi một dòng có tx_id dạng test-… đánh dấu [TEST] rồi đánh dấu hoặc xoá dòng đó.

5. Tạo quy tắc (bộ lọc, giờ yên lặng) và bật tích hợp.

Google Sheets

Dòng Tiền Pro dùng OAuth với quyền tối thiểu: ưu tiên quyền chỉ truy cập tệp do chính ứng dụng tạo hoặc tệp bạn chọn, thay vì toàn bộ Google Drive hay mọi bảng tính.

1. Trong Tích hợp, thêm Google Sheets và đăng nhập Google để đồng ý quyền.

2. Chọn một bảng tính hiện có bằng bộ chọn tệp, hoặc để Dòng Tiền Pro tạo bảng mới.

3. Bấm Gửi thử để ghi dòng thử, rồi tạo quy tắc và bật tích hợp.

Xử lý lệch cấu trúc cột (Schema Drift)

Nếu bạn hoặc thành viên trong tổ chức đổi tên cột hoặc xoá cột bắt buộc trên bảng tính Google Sheets hoặc Lark Base, Dòng Tiền Pro sẽ phát hiện Lệch cấu trúc (Schema Drift):

1. Tích hợp tự động chuyển sang trạng thái cảnh báo Lệch cột và tạm dừng ghi để chống sai lệch dữ liệu.
2. Màn hình Tích hợp (g h) hiển thị thông báo cột bị thiếu hoặc bị đổi tên.
3. Bạn bấm Tải mẫu CSV chuẩn trong phần cấu trúc cột, đối chiếu lại tiêu đề hàng đầu tiên trên bảng tính, hoặc cập nhật lại cấu hình cột.
4. Sau khi chuẩn hoá cột, bấm Tiếp tục và mở Gửi lại các lỗi trong nhật ký để phát lại các giao dịch đang chờ.

Khi có lỗi khác

Nếu bảng bị xoá, token hết hạn hoặc quyền bị thu hồi, tích hợp chuyển sang trạng thái lỗi và bạn nhận thông báo; cấp quyền lại rồi bấm Gửi lại những lần gửi thất bại trong nhật ký. Nhật ký giữ 30 ngày. Lỗi tạm thời được thử lại như các kênh khác (xem chat).

Dữ liệu ở ngoài tầm kiểm soát của Dòng Tiền Pro

Khi bạn sửa hoặc xoá một dòng trong bảng tính, thay đổi này không quay lại sổ của Dòng Tiền Pro. Hãy xem bảng tính là bản sao để báo cáo, không phải chứng từ gốc.