QUẢN TRỊ CCM

• Mỗi dòng chọn sinh ra n dòng mới ở cuối 7.data_Thanh toán, gồm 14 cột, trong đó mã hiệu / tên / ĐVT / khối lượng / đơn giá là công thức liên kết sống về 3.NS.
• Cột A (Loại CP) được điền tự động theo hạng mục La Mã: A1 Mục I & II (giao thầu) · A2 Mục III (nhà cung cấp vật tư) · A3 Mục IV–X (chi phí khác).
• Cột C (Hạng mục) tự điền theo nhóm con của công tác; cột D là ngày chạy lệnh.

Các cột bạn phải điền tay sau đó

• Sheet 6.THTT không bị xóa mà chỉ được làm sạch nội dung — nhờ vậy các công thức từ 3.NS trỏ sang không bị vỡ.
• Phần bảng do bạn tự thêm phía dưới (từ dòng có ký hiệu "B" ở cột D trở xuống) được giữ nguyên, kể cả công thức và định dạng.
• Chạy lại lệnh này mỗi khi có dữ liệu thanh toán mới.

• Chọn được nhiều ô cùng lúc, kể cả nhiều vùng rời rạc — nhưng mọi vùng phải nằm trọn trong cột O, chọn lẫn cột khác sẽ báo lỗi.
• Mỗi lần cập nhật ghi 1 dòng lịch sử vào 8.data_ĐG_NTP; ô O trong 3.NS được thay bằng công thức đơn giá bình quân gia quyền trỏ sang sheet lịch sử đó (ô chuyển nền xanh).
• Dòng thiếu khối lượng ngân sách (cột N ≤ 0) bị bỏ qua và được liệt kê trong thông báo kết quả.

• Vật tư nào chưa có UID sẽ được cấp mới; vật tư cũ giữ nguyên UID và số liệu kho.
• Lệnh cũng phát hiện UID trùng (thường do copy–dán nguyên dòng trong 3.NS) và báo lại để bạn xử lý.
• Đây cũng là lệnh vá lỗi #REF! của sheet kho sau khi chạy Bước 2.

Điều kiện bắt buộc

• Đã cấu hình ID Key Dự án (menu 🌐 ĐỀ XUẤT → ⚙️ Cấu hình ID Key Dự án).
• Mọi vật tư phải có UID. Thiếu UID → add-on dừng, liệt kê rõ vật tư/dòng nào và yêu cầu chạy 🔄 Cập nhật KHO VẬT TƯ trước.
• Không được trùng UID và không được trùng mã hiệu. Có trùng → add-on dừng ngay, không gửi gì (danh mục trên web giữ nguyên) và chỉ rõ cặp dòng bị trùng.
• Add-on đọc email Google của người đang bấm để Web App kiểm tra quyền — chỉ có API Key thì không đủ để sửa danh mục.

Add-on gửi kèm

• Nhật ký đổi đơn vị (_DVT_LOG) để web dựng lại bảng quy đổi đơn vị.
• Mã nào đã bị bỏ khỏi 3.NS thì web tự ẩn/xóa khỏi danh mục — không ảnh hưởng các phiếu đề xuất đã tạo trước đó.

Điều kiện gửi

• Đã có Bot Token + Chat ID.
• Ô 4.BAO CAO!M4 = Bắt đầu tổ chức báo cáo.
• Các ô số liệu cốt lõi (I15, J15, E15, F15, M15, N15) không được lỗi công thức. Nếu đang #REF!/#DIV/0!… add-on từ chối gửi để không phát tán số liệu sai (lỗi này hay gặp ngay sau Bước 2).

Nội dung tin nhắn

Cơ chế "chốt sổ" — điều quan trọng nhất

Add-on gửi trước, chốt sau. Chỉ khi Telegram xác nhận đã nhận tin, add-on mới:

• Chép khối lượng/đơn giá/thành tiền hiện tại (N:P) của 3.NS sang cột ẩn V:X, và chép mã hiệu sang cột ẩn Y → đây chính là mốc so sánh cho báo cáo lần sau.
• Ghi lợi nhuận hiện tại vào Q15/R15, cập nhật ngày báo cáo O1 và số thứ tự báo cáo trong ngày I7.

• Nhập giờ theo định dạng HH:MM (24 giờ, phút tùy ý — ví dụ 07:05, 09:00, 14:23). Không bị giới hạn ở 7 giờ sáng dù tên lệnh mang chữ "7AM".
• Điều kiện bật: M4 không ở trạng thái "Đang thiết lập".
• Trạng thái hiển thị tại ô 4.BAO CAO!O4: ✅ Tự động HH:MM: BẬT / ❌ Tự động: TẮT.
• Lịch chạy trên máy chủ Google — không cần mở file Sheets.
• Báo cáo tự động dùng đúng bộ điều kiện như bản thủ công (M4, ô lỗi, ngưỡng…). Nếu bạn đổi M4 về "Đang thiết lập", lần chạy kế tiếp trigger sẽ tự xóa chính nó và ghi "TẮT" vào O4 — nhớ bật lại sau khi cập nhật dự án xong.