# Hướng dẫn cài đặt Chấm công & Tính lương PRO

Cài Apps Script cho Chấm công & Tính lương PRO trong khoảng 15 phút. Chỉ áp dụng cho bản Google Trang tính.

## Thông tin nhanh

- **Menu sau khi cài:** HiTaVa Lương (hiện cạnh menu Trợ giúp)
- **Mục bấm đầu tiên:** 🛠 Cài đặt file (chạy lần đầu) — đây là lúc Google hỏi quyền
- **Số file phải dán:** 4 (Code.gs, App, WebApp, appsscript.json.txt)
- **Thời gian:** khoảng 15 phút, làm một lần
- **Web App:** có — Cổng nhân viên trên điện thoại
- **Trang sản phẩm:** https://www.hitava.cloud/san-pham/cham-cong-tinh-luong-pro
- **Video hướng dẫn:** https://youtu.be/70d24YpDZww

## Các file trong thư mục 2-Apps-Script

- `Code.gs` (Tập lệnh): 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` (HTML): 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` (HTML): 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` (HTML): 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

## Các bước

1. Mở file bằng Google Trang tính (bản sao từ "Tài liệu của tôi" đã có sẵn script, bỏ qua bước 1–2).
2. Tệp › Cài đặt: Ngôn ngữ Việt Nam, Múi giờ (GMT+07:00) Bangkok, Hà Nội, Tính lại "Khi thay đổi và mỗi giờ".
3. Tiện ích mở rộng › Apps Script › dán Code.gs vào Mã.gs.
4. Thêm các file còn lại đúng tên: App (HTML), WebApp (HTML), appsscript.json.txt (HTML).
5. Lưu, quay lại bảng tính, nhấn F5. Menu HiTaVa Lương hiện cạnh Trợ giúp.
6. Bấm HiTaVa Lương › 🛠 Cài đặt file (chạy lần đầu). Google hỏi quyền: Tiếp tục › chọn tài khoản › "Google chưa xác minh ứng dụng này" › Nâng cao › Chuyển đến … (không an toàn) › Cho phép.

Cảnh báo "chưa được xác minh" là bình thường với mọi Apps Script tự dán vào file của mình; Google chỉ xác minh ứng dụng nộp hồ sơ phát hành công khai.

## Quyền Google hỏi ở mẫu này

- **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 nằm trong Google Drive của khách. Script chạy bằng tài khoản Google của khách, không gửi dữ liệu ra ngoài; HiTaVa không xem được file.

## Việc làm một lần

- 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.
- 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.
- 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").
- 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.
- 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á).
- 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.

## Cổng nhân viên trên điện thoại

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.

Bật: 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. Sau đó Apps Script › Triển khai › Tuỳ chọn triển khai mới › Ứng dụng web; Thực thi dưới dạng: Tôi; Người có quyền truy cập: Bất kỳ ai; Triển khai; chép URL kết thúc bằng /exec.

Web App KHÔNG đi theo bản sao — kể cả bản sao đã có sẵn script vẫn phải tự triển khai một lần. Dán mã bản mới thì dùng Quản lý triển khai › Chỉnh sửa › Phiên bản mới để giữ nguyên link /exec.

## Dùng hằng kỳ

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

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.

Trang HTML: https://www.hitava.cloud/huong-dan/cham-cong-tinh-luong-pro