Hệ Thống Quản Lý
Án Quá Hạn CBXX
Google Sheets · Apps Script · Telegram · Email · Google Calendar
Tự động lọc và báo cáo án quá thời hạn chuẩn bị xét xử — dành cho Viện Kiểm Sát Nhân Dân
Hệ thống giúp cán bộ thụ lý và lãnh đạo kiểm soát tự động toàn bộ vụ án dân sự đang giải quyết — đặc biệt là các vụ sắp hết hạn hoặc đã quá thời hạn chuẩn bị xét xử theo Điều 203 BLTTDS 2015. Không cần rà soát thủ công từng hồ sơ mỗi đầu tuần.
Hôn nhân & GĐ
Tổng tối đa: 6 tháng
Lao động
Tổng tối đa: 3 tháng
Điều kiện gia hạn: Chánh án Tòa án mới có quyền quyết định gia hạn — chỉ áp dụng khi vụ án có tính chất phức tạp hoặc do sự kiện bất khả kháng, trở ngại khách quan.
Có QĐ tiếp tục GQ
Sau TĐC, thời hạn CBXX được tính lại hoàn toàn từ ngày QĐ tiếp tục GQ có hiệu lực pháp luật.
Có QĐ gia hạn
Gia hạn cộng thêm vào deadline gốc — không reset mốc ngày thụ lý. Không vượt giới hạn luật định.
Không gia hạn, không TĐC
Tính đơn giản từ ngày thụ lý theo thời hạn cơ bản của loại vụ án.
Không tính thời hạn
Thời gian TĐC không tính vào thời hạn CBXX. Vụ án xuất hiện trong mục riêng, không bị cảnh báo quá hạn.
Mở Telegram, tìm @BotFather → nhấn Start.
Gửi lệnh /newbot → đặt tên (vd: VKS CBXX Bot) → đặt username kết thúc bằng bot.
BotFather trả về chuỗi dạng: 1234567890:AAFxxxxxxxxxxxxxxxx — lưu lại.
Tạo nhóm gồm cán bộ + lãnh đạo → thêm bot → XONG
Gửi tin nhắn bất kỳ vào nhóm → mở trình duyệt truy cập:
Tìm trường "id" trong object "chat" — thường là số âm dạng -100xxxxxxxxx.
Tab trình soạn thảo code mở ra trong tab mới.
Xóa code mẫu → dán code hệ thống → nhấn Ctrl+S lưu.
Cấp quyền khi Google yêu cầu (chấp nhận tất cả). Sheet DanhSachAn_DS được tạo với dữ liệu mẫu.
Sau bước này hệ thống tự động hoàn toàn — không cần thao tác thêm mỗi ngày.
Lưu ý cấp quyền: Lần đầu chạy, Google yêu cầu cấp quyền truy cập Calendar, Sheets và kết nối Telegram. Phải chấp nhận tất cả để hệ thống hoạt động đầy đủ.
Dùng chung với hệ thống lịch phiên tòa: Ghép phần menu onOpen_CBXX() vào hàm onOpen() hiện có — không ghi đè toàn bộ file Apps Script.
Sheet gồm 27 cột (A–AA). Chỉ nhập liệu vào cột A–V. Cột W–AA ký hiệu ⚙ do hệ thống tự ghi — không sửa tay.
| Cột | Tên trường | Ví dụ | Ghi chú |
|---|---|---|---|
| A | STT | 1, 2, 3… | Bắt buộc |
| B | Số thụ lý / Mã vụ án | 319/2008/DS-ST | Bắt buộc |
| C | Nguyên đơn | Nguyễn Văn A | Bắt buộc |
| D | Bị đơn | Trần Thị B | Bắt buộc |
| E | Quan hệ tranh chấp | QSDĐ, Thừa kế, Chia TS chung | Không bắt buộc |
| F | Loại vụ án | Dân sự/HN&GĐ hoặc KDTM/Lao động | Bắt buộc — quyết định thời hạn 4 hay 2 tháng |
| G | Ngày thụ lý lần đầu | 05/11/2008 | Bắt buộc — Mốc gốc tính thời hạn |
| H | Có gia hạn? | Không / Có | Dropdown — chọn từ danh sách |
| I | Ngày QĐ gia hạn | 01/05/2026 | Lưu để tra cứu, không dùng làm mốc tính |
| J | Số tháng gia hạn | 0, 1 hoặc 2 | Nhập 0 nếu không GH · DS: ≤ 2 · KDTM: ≤ 1 |
| K | Thẩm phán | Trần Thị Ngọc Bích | Không bắt buộc |
| L | KSV thụ lý | Minh Lý | Không bắt buộc |
| M | Email KSV | ksv@vks.gov.vn | Nhận email báo cáo |
| N | Email Lãnh đạo | lanhdao@vks.gov.vn | Nhận email báo cáo |
| O | Tạm đình chỉ? | Không / Có | Dropdown — đổi sang Có khi có QĐ TĐC |
| P | Ngày QĐ tạm đình chỉ (mới nhất) | 25/09/2024 | Ngày QĐ TĐC gần nhất |
| Q | Ngày QĐ tiếp tục GQ có HLPL | 16/11/2023 | Mốc ưu tiên cao nhất — reset toàn bộ thời hạn |
| R | Số BA/QĐ | 459 | Không bắt buộc |
| S | Ngày ra BA/QĐ | 19/12/2024 | Không bắt buộc |
| T | Hình thức giải quyết | BA, QĐ công nhận, QĐ đình chỉ | Không bắt buộc |
| U | Trạng thái | Đang giải quyết / Tạm đình chỉ / Đã kết thúc | Dropdown — phải cập nhật đúng |
| V | Ghi chú | TĐC lần 2: 25/6/2023 | TT: 25/9/2024 | Lịch sử TĐC, tiếp tục, ghi chú khác |
| W ⚙ | [AUTO] Mốc tính thời hạn | 25/09/2024 | Script tự ghi |
| X ⚙ | [AUTO] Thời hạn CBXX (diễn giải) | 4 tháng (tính lại từ QĐ TT) | Script tự ghi |
| Y ⚙ | [AUTO] Ngày hết hạn CBXX | 25/01/2025 | Script tự ghi |
| Z ⚙ | [AUTO] Số ngày còn lại | -457 (âm = quá hạn) | Script tự ghi |
| AA ⚙ | [AUTO] Cảnh báo trạng thái | 🔴 Quá 457 ngày | Script tự ghi |
Cột W–AA (⚙) không bao giờ sửa tay — dù thấy sai, hãy sửa dữ liệu đầu vào (A–V) rồi chạy lại 🔄 Cập nhật thời hạn. Script sẽ ghi đè lần sau.
Tính lại ngay tất cả cột W–AA, không chờ đến 6:00 sáng. Dùng khi vừa nhập dữ liệu mới hoặc cập nhật QĐ tiếp tục GQ.
Gửi ngay Telegram + Email lên lãnh đạo — không chờ thứ Hai. Dùng khi cần báo cáo đột xuất hoặc kiểm tra hệ thống.
Làm mới tab Dashboard: thống kê + 3 bảng phân loại màu sắc. Tự cập nhật mỗi thứ Hai sau báo cáo.
Tạo sự kiện nhắc cho tất cả vụ đang GQ: cảnh báo sớm 10 ngày + ngày hết hạn chính xác. Chạy lại khi có vụ mới.
Quan trọng nhất: F (Loại vụ án — dropdown), G (Ngày thụ lý), U (Trạng thái). Ba cột này quyết định toàn bộ tính toán.
Không điền gì vào 5 cột ⚙ — hệ thống tự ghi sau khi tính toán.
Kiểm tra cột AA — nếu hiện 🟢 Còn N ngày là đã tính đúng.
Tạo sự kiện nhắc trực tiếp trên Google Calendar cá nhân của cán bộ phụ trách.
Hệ thống ngừng tính thời hạn, chuyển vụ án sang mục TĐC trong báo cáo.
Lưu để tra cứu. Nếu TĐC nhiều lần, cập nhật ngày gần nhất, ghi lịch sử vào cột V.
Hệ thống tự reset toàn bộ thời hạn CBXX từ ngày QĐ tiếp tục có hiệu lực (Điều 203.1 BLTTDS).
Lưu ý: Cột Q là Ngày QĐ tiếp tục GQ CÓ HIỆU LỰC PHÁP LUẬT — không phải ngày ra quyết định. Hai ngày này thường khác nhau.
Điền cột R (Số BA/QĐ) + cột S (Ngày ra BA/QĐ) + cột T (Hình thức) → đổi cột U = Đã kết thúc. Vụ án không còn xuất hiện trong cảnh báo, chỉ tính vào thống kê tổng.
| Thời điểm | Hàm chạy | Nội dung |
|---|---|---|
| Mỗi ngày · 6:00 | refreshDeadlines() | Tính lại tất cả cột W–AA · Cập nhật màu cảnh báo |
| Thứ Hai · 7:00 | checkOverdueAndReport() | Báo cáo Telegram + Email lãnh đạo + Dashboard |
Ưu tiên xử lý ngay
Cần chú ý
Không cần ưu tiên
Theo dõi riêng
Tính vào thống kê
Cần bổ sung
| Cột | Ý nghĩa | Ví dụ giá trị & diễn giải |
|---|---|---|
| W Mốc tính | Ngày khởi đầu đếm thời hạn hiện tại | 25/09/2024 → Đang dùng ngày QĐ tiếp tục GQ làm mốc |
| X Thời hạn | Diễn giải thời hạn đang áp dụng | 4+1 tháng (gia hạn) → DS, đã gia hạn 1 tháng4 tháng (tính lại từ QĐ TT) → Sau TĐC, đã reset |
| Y Hết hạn | Ngày kết thúc thời hạn CBXX | 25/01/2025 → Hạn cuối cùng phải ra QĐ đưa vụ án ra xét xử |
| Z Số ngày | Số ngày còn lại đến hạn | -457 → Đã quá 457 ngày · 35 → Còn 35 ngày · (TĐC) → Đang TĐC |
| AA Cảnh báo | Trạng thái tổng hợp, dùng để lọc và đọc nhanh | 🔴 Quá 457 ngày · 🟡 Còn 8 ngày · 🟢 Còn 45 ngày · ⏸️ TĐC |
Nếu cột X hiện ⚠ GH nhập 3T > tối đa 2T — số tháng gia hạn nhập ở cột J vượt giới hạn luật định. Hệ thống tự clip về mức tối đa nhưng cần kiểm tra lại quyết định gia hạn thực tế.
📅 Thứ Hai ngày 27/04/2026
━━━━━━━━━━━━━━━━━━━━━━
📊 TỔNG QUAN: 9 đang GQ | 3 quá hạn | 1 sắp hết | 1 TĐC
🔴 ÁN QUÁ THỜI HẠN CBXX:
📁 319/2008/DS-ST: Trương Văn Túy vs Trịnh Tra
↳ Hạn: 16/03/2024 [4 tháng (tính lại)] | Quá 407 ngày
🟡 SẮP HẾT HẠN (10 ngày):
📁 173/2015/DS-ST: Nguyễn Thị Ngọc vs Lê Thanh Đông
↳ Hạn: 30/01/2025 | Còn 8 ngày
⏸️ TẠM ĐÌNH CHỈ (1 vụ):
• 212/2014/DS-ST: Phạm Thị Thanh Tâm vs Mai Xuân Vân
━━━━━━━━━━━━━━━━━━━━━━
Điều 203 BLTTDS 2015 · DELULU JSC × VKS
📅 Thứ Hai ngày 27/04/2026
━━━━━━━━━━━━━━━━━━━━━━
📊 TỔNG QUAN: 12 đang GQ | 0 quá hạn | 0 sắp hết | 2 TĐC
🔴 ÁN QUÁ THỜI HẠN CBXX:
✅ Không có án quá hạn.
🟡 SẮP HẾT HẠN (10 ngày):
✅ Không có án sắp hết hạn.
⏸️ TẠM ĐÌNH CHỈ (2 vụ):
• 212/2014/DS-ST: Phạm Thị Thanh Tâm vs Mai Xuân Vân
• 88/2012/DS-ST: Thái Mười vs Thái Quang Sơn
━━━━━━━━━━━━━━━━━━━━━━
Điều 203 BLTTDS 2015 · DELULU JSC × VKS
- Cột F phải chọn đúng từ dropdown — quyết định thời hạn 2 hay 4 tháng, không được để trống.
- Cột G định dạng ngày (ô căn phải), không phải text (ô căn trái). Nếu nhập text, script không đọc được.
- Cột H và J phải đồng bộ: H = "Có" thì J phải có số tháng (1 hoặc 2). H = "Không" thì J = 0.
- Cột O và U phải khớp: O = "Có" thì U nên là "Tạm đình chỉ" để hệ thống xử lý đúng.
- Cột Q chỉ điền khi đã có QĐ tiếp tục GQ có HLPL — điền sớm sẽ làm sai toàn bộ thời hạn.
- Cột W–AA không bao giờ sửa tay — hãy sửa dữ liệu đầu vào rồi chạy lại 🔄 Cập nhật.
Kiểm tra cột G — ô trống hoặc nhập sai định dạng (text thay vì ngày). Điền lại đúng định dạng ngày → chạy 🔄 Cập nhật.
Kiểm tra theo thứ tự: F → G → H, J → O, Q, U. Sửa dữ liệu → chạy 🔄 Cập nhật. Vẫn sai → liên hệ DELULU JSC.
Vào Apps Script → chạy thủ công hàm checkOverdueAndReport → xem log lỗi. Kiểm tra bot còn trong nhóm và có quyền Admin không.
Vào Tiện ích mở rộng → Apps Script → Trình kích hoạt (⏰) → kiểm tra 2 trigger. Nếu mất → chạy lại ⚙️ → ③ Kích hoạt tự động hóa.
• Tài khoản Google thường: tối đa 6 phút/lần chạy, 90 phút/ngày.
• Google Workspace: tối đa 30 phút/lần, 6 giờ/ngày.
• Hệ thống xử lý tốt với 10–300 vụ án. Nhiều hơn nên chạy thủ công từng phần.
• Quota gửi email: ~100 email/ngày với tài khoản thường.
8:00 – 17:30
Không hỗ trợ cuối tuần & ngày lễ