Cài đặt Chấm công & Tính lương PRO

Toàn bộ các bước bên dưới — mở file, dán mã, cấp quyền, việc làm một lần — trong một video. Xem trước rồi làm theo từng bước bằng chữ và hình ở phần sau.

1. 

   Video hướng dẫn cài đặt & sử dụng Chấm công & Tính lương PRO

   Xem trên YouTube ↗

Thêm video khác trên kênh YouTube HiTaVa.

Bỏ qua nếu bạn đã tạo bản sao từ Tài liệu của tôi.

1. Tải file .xlsx trong thư mục 1-File-chinh lên Google Drive.
2. Chuột phải file › Mở bằng › Google Trang tính › Tệp › Lưu dưới dạng Google Trang tính.
3. Từ đây dùng file Google Trang tính vừa tạo, không dùng file .xlsx nữa.

Gói của mẫu này gồm 4 file trong thư mục 2-Apps-Script:

• Code.gs — phần chạy trên máy chủ Google: menu, tính lương, chốt kỳ, phiếu PDF, email, file chuyển khoản, cổng nhân viên
• App — thanh bên và hộp thoại: nhân viên, lưới chấm công, tăng ca, kỳ lương, phiếu lương, chuyển khoản
• WebApp — cổng nhân viên trên điện thoại: phiếu lương của mình, phép còn lại, Vào ca / Ra ca
• appsscript.json.txt — tệp kê khai: múi giờ GMT+7, quyền, cấu hình web app và dịch vụ Google Sheets giúp thanh bên mở nhanh

1. Mở file Google Trang tính › Tiện ích mở rộng › Apps Script.
2. Xoá hết đoạn mã mẫu trong Mã.gs, mở Code.gs bằng Notepad hoặc TextEdit, chọn tất cả, sao chép, dán vào.
3. Bấm dấu + cạnh “Tệp” › HTML cho từng file: App, WebApp. Gõ tên đúng từng chữ, viết hoa như trên và không thêm đuôi .html; xoá nội dung mẫu rồi dán toàn bộ file tương ứng.
4. Cài đặt dự án (bánh răng bên trái) › tick Hiển thị tệp kê khai “appsscript.json” trong trình chỉnh sửa. Quay lại Trình chỉnh sửa (biểu tượng <>) › mở appsscript.json › xoá hết › dán toàn bộ nội dung appsscript.json.txt. Đuôi .txt chỉ để tải về được — dán phần nội dung, không đổi tên tệp.
5. Bấm 💾 Lưu. Cài đặt dự án (bánh răng bên trái) › Múi giờ: (GMT+07:00) Bangkok, Hà Nội — giống bảng tính.
6. Quay lại tab bảng tính, nhấn F5. Menu HiTaVa Lương hiện cạnh Trợ giúp sau vài giây.

Bấm menu HiTaVa Lương › 🛠 Cài đặt file (chạy lần đầu). Google hỏi quyền — đây là việc làm một lần cho mỗi tài khoản và mỗi file.

1. Cửa sổ “Cần cấp quyền” › Tiếp tục.
2. Chọn tài khoản Google đang giữ file.
3. “Google chưa xác minh ứng dụng này” › Nâng cao › Chuyển đến … (không an toàn).
4. Giữ đủ các tick › Cho phép.

Mẫu này xin những quyền nào

Xem, sửa, tạo, xoá bảng tính

đọc và ghi chấm công, tăng ca, Lịch sử lương trong file này; đọc danh sách nhân viên của file Nhân sự PRO khi bạn dán link

Xem, sửa, tạo, xoá tệp trong Google Drive

lưu phiếu lương PDF, file chuyển khoản ngân hàng và bản sao lưu vào thư mục "HiTaVa Lương" của bạn

Gửi email thay bạn

gửi tới địa chỉ bạn nhập trong file. Script không đọc hộp thư Gmail

Chạy khi bạn không có mặt

lịch 7:00 mỗi sáng: gửi tiếp phiếu lương khi hôm trước hết hạn mức email, sao lưu hằng tuần

Hiện và chạy nội dung bên thứ ba

mở hộp thoại quản lý bên trong bảng tính

Xem địa chỉ email của bạn

biết ai đang dùng menu để áp vai trò Chủ file / Kế toán lương / Chỉ xem tổng

Dữ liệu ở lại trong Drive của bạn. Script chạy bằng tài khoản Google của bạn, không gửi dữ liệu ra ngoài và HiTaVa không xem được file của bạn.

1. Menu HiTaVa Lương › 🛠 Cài đặt file (chạy lần đầu): đặt múi giờ GMT+7 và định dạng Việt Nam, kiểm 18 tab, bảo vệ "chỉ cảnh báo" các cột công thức, cài lịch tự chạy 7:00 (gửi tiếp phiếu lương, sao lưu Chủ nhật). Chạy lại lúc nào cũng an toàn.
2. Thanh bên › Giới thiệu & cấp quyền › 4 Tự kiểm tra: dòng nào ⚠ thì đọc chữ bên dưới.
3. Tab Thiết lập: tên công ty, vùng lương tối thiểu I–IV, kỳ lương, cách tính công chuẩn (26 / 24 ngày hoặc theo lịch), chế độ thuế tiền làm thêm giờ (mặc định "chỉ miễn phần chênh lệch").
4. Tab Tham số luật: các mức 2026 có ngày hiệu lực và nguồn — đối chiếu văn bản gốc; luật đổi thì thêm một dòng mới, không sửa dòng cũ. Tab Ngày lễ và Ca làm việc sửa được.
5. Tab Danh sách NV, hoặc menu › 🔄 Đồng bộ từ Nhân sự PRO (dán link file Nhân sự PRO — chỉ thêm và cập nhật, không xoá).
6. Phân quyền: menu › ⚙ Cài đặt & phân quyền › Chủ file / Kế toán lương / Chỉ xem tổng. Google Sheets không khoá được từng tab: chỉ chia sẻ file cho người làm lương.

Mỗi nhân viên một link riêng + mã PIN: xem phiếu lương của chính mình, số ngày phép còn lại, bấm Vào ca / Ra ca (giờ máy chủ Google, GPS tuỳ chọn). Không cần tài khoản Google, không thấy bảng tính. Sai PIN 5 lần khoá 15 phút.

Phần này mặc định tắt và không đi theo bản sao — kể cả bản sao đã có sẵn script, bạn vẫn phải tự triển khai một lần.

1. Làm sau bước cài đặt file. Triển khai xong, chép URL ứng dụng web kết thúc bằng /exec, dán vào thanh bên › Cài đặt › Triển khai cổng nhân viên › 💾 Lưu link (link /dev nhân viên không mở được), rồi cấp link + PIN ở menu › 📱 Cổng nhân viên.
2. Apps Script › Triển khai › Tuỳ chọn triển khai mới › bánh răng cạnh “Chọn loại” › Ứng dụng web.
3. Thực thi dưới dạng: Tôi. Người có quyền truy cập: Bất kỳ ai.
4. Bấm Triển khai, cấp quyền lần nữa nếu Google hỏi, rồi chép URL ứng dụng web kết thúc bằng /exec.

function onOpen() {
  SpreadsheetApp.getUi()
    .createMenu('🎓 Lớp học')
    .addItem('🏠 Bảng điều khiển', 'showHome')
    .addItem('📅 Mở kỳ', 'showPeriod')
    .addItem('✅ Điểm danh nhanh', 'showAttendance')
    .addItem('🧾 Học phí (QR, Zalo, PDF, email)', 'showFees')
    .addItem('ℹ Giới thiệu & cấp quyền', 'about')
    .addToUi();
}

Vì sao chọn “Bất kỳ ai”: Web App chạy bằng tài khoản của bạn nên Google không cho script biết email người đang mở trang, chế độ “Bất kỳ ai có tài khoản Google” vì thế không kiểm được ai là ai. Việc bảo vệ nằm trong script — link riêng kèm mã bí mật, mã PIN, khoá tạm khi nhập sai nhiều lần, và nhật ký mọi lần ghi.

Dán mã bản mới về sau: Triển khai › Quản lý triển khai › ✏ Chỉnh sửa › Phiên bản: Phiên bản mới › Triển khai. Làm đúng cách này thì link /exec giữ nguyên.

1. Chấm công — gõ mã X, ½, P, L, KL… vào lưới, nhập file máy chấm công ZKTeco, hoặc lấy từ Log vào-ra khi nhân viên bấm Vào ca / Ra ca.
2. Tăng ca và Thưởng – Khấu trừ — hệ số 150% / 200% / 300% và giờ đêm tự nhận theo lịch; cảnh báo quá 40 giờ/tháng.
3. Kiểm tra bảng lương — lương dưới mức tối thiểu vùng, thiếu mã số thuế, thực nhận âm…
4. Chốt kỳ — Bảng lương ghi vào Lịch sử lương dạng số cố định; luật đổi sau đó không làm đổi phiếu cũ.
5. Gửi phiếu lương PDF qua email, xuất file chuyển khoản (Vietcombank, Techcombank, MB, ACB, BIDV, VietinBank hoặc CSV chung) — luôn kiểm ở màn hình xem trước của ngân hàng trước khi duyệt.
6. Tạo kỳ lương mới — xoá chấm công, tăng ca, thưởng – khấu trừ của kỳ cũ, giữ nhân viên và phép năm.

Trên Excel 2016 trở lên vẫn đủ 18 tab và mọi công thức: công chuẩn, lương theo ngày công, tăng ca và giờ đêm, bảo hiểm có trần đổi giữa năm, thuế TNCN 5 bậc, phép năm, Phiếu lương in được, Tổng quan. Không có: menu và thanh bên, chốt kỳ tự động, gửi phiếu PDF qua email, file chuyển khoản ngân hàng, nhập máy chấm công, đồng bộ từ Nhân sự PRO, cổng nhân viên và Vào ca / Ra ca trên điện thoại.

Các lỗi hay gặp (menu không hiện, Google hỏi quyền lại, ngày lệch một ngày, mở trên điện thoại không thấy menu) nằm ở phần lỗi thường gặp của hướng dẫn chung.

Vẫn vướng?Zalo 0935077673 (Hải Vân)