hitava

Khoảng 25 phút · làm một lần

Cài đặt Nhân sự 360 PRO

Dành cho bản Google Trang tính. Sau khi cài, menu “Nhân sự 360” hiện cạnh Trợ giúp và mọi tính năng tự động chạy trong file của bạn.

Menu sau khi cài
Nhân sự 360
Số file phải dán
3 file
Thời gian
~25 phút
Web App
Có

Nếu bạn lấy file bằng nút Tạo bản sao Google Sheets trong Tài liệu của tôi: bản sao đã có sẵn script. Bỏ qua bước 1 và 2, đi thẳng tới cấp quyền — riêng Web App vẫn phải tự triển khai một lần.

Xem video hướng dẫn

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 Nhân sự 360 PRO

    Xem trên YouTube ↗

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

Bước 1 — Mở file bằng Google Trang tính

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.

Đặt đúng múi giờ trước khi làm tiếp

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ờ. File chuyển từ .xlsx sang thường nhận múi giờ khác, làm ngày tháng trong file lệch.

Bước 2 — Dán mã vào Apps Script

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

  • Code.gs — phần chạy trên máy chủ Google: menu, đăng nhập, chấm công, xếp ca, đơn từ, bảng công, lương, phiếu PDF, email, Telegram / Google Chat, sao lưu
  • App — web app toàn màn hình: một trang dùng chung cho máy tính, điện thoại và máy tính bảng làm kiosk
  • appsscript.json.txt — tệp kê khai: múi giờ GMT+7, quyền, cấu hình web app và dịch vụ đọc nhanh Google Sheets — thiếu tệp này mỗi trang web app tải mất 15–20 giây
  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. 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 Nhân sự 360 hiện cạnh Trợ giúp sau vài giây.
Bản sao của mẫu HiTaVa
docs.google.com/spreadsheets/d/1XyZ…/edit
Bản sao của Quản lý lớp học PRO v1.0
TệpChỉnh sửaXemChènĐịnh dạngDữ liệuCông cụTiện ích mở rộngTrợ giúpNhân sự 360Mở ứng dụngCài đặt lần đầuBật/tắt tự mở ứng dụng khi mở fileSao lưu ngayGom lượt chấm công ngayLink riêng của nhân viênĐặt lại PIN nhân viênKiểm tra cài đặt
ABCDEFG
1Mã HSHọ tênLớpBuổi trong kỳĐã họcHọc phíCòn nợ
2HS0007Nguyễn AnTA-3B871.440.0000
3HS0008Trần BìnhTA-3B881.440.000240.000
4HS0012Lê ChiTA-5A12112.160.0000
5HS0015Phạm DungTA-5A12102.160.000360.000
6HS0021Vũ GiangTT-1A881.200.0000
7       
8       
Hướng dẫnThiết lậpHọc sinhLịch họcĐiểm danhHọc phíLương giáo viên
Vuốt ngang trong hình để xem hết màn hình.Lưu script và tải lại bảng tính xong, ① menu “Nhân sự 360” nằm cạnh Trợ giúp. Bấm vào đó rồi chọn ② “Cài đặt lần đầu” — lần đầu bấm chính là lúc Google hỏi quyền.

Bước 3 — Cấp quyền cho script

Bấm menu Nhân sự 360 › Cài đặt 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.
Đăng nhập bằng Google
accounts.google.com/o/oauth2/auth?client_id=…

Google chưa xác minh ứng dụng này

Ứng dụng đang yêu cầu quyền truy cập vào thông tin nhạy cảm trong Tài khoản Google của bạn. Chỉ tiếp tục nếu bạn tin tưởng nhà phát triển.

ten.cua.ban@gmail.com

Nâng caoQuay lại nơi an toàn

Bấm “Nâng cao” xong, dòng này hiện ra ngay bên dưới:

Chuyển đến Nhân sự 360 PRO (không an toàn)
Vuốt ngang trong hình để xem hết màn hình.Bấm ① Nâng cao ở góc dưới bên trái, rồi ② dòng “Chuyển đến … (không an toàn)” vừa hiện ra. Dòng cảnh báo này là bình thường với mọi Apps Script tự dán vào file của mình.

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

Xem, sửa, tạo, xoá bảng tính
đọc và ghi nhân viên, lịch ca, chấm công, đơn từ, lương trong file này
Xem, sửa, tạo, xoá tệp trong Google Drive
ảnh selfie, giấy tờ, hợp đồng PDF, phiếu lương PDF và bản sao lưu trong các thư mục "Nhân sự 360 – …" của bạn
Gửi email thay bạn
phiếu lương, nhắc chấm công, đơn chờ duyệt. Script không đọc hộp thư Gmail
Chạy khi bạn không có mặt
gom lượt chấm công mỗi phút, nhắc chưa chấm công, việc hằng ngày lúc 06:00, sao lưu, tự mở ứng dụng khi chủ file mở bảng tính
Hiện và chạy nội dung bên thứ ba
menu Nhân sự 360 và hộp nhỏ "Mở ứng dụng" trong bảng tính
Kết nối với dịch vụ bên ngoài
chỉ gửi tin Telegram và Google Chat khi bạn bật. Không gửi dữ liệu về HiTaVa
Xem địa chỉ email của bạn
biết ai đang bấm menu: chủ file hay người có vai trò Chủ / HR
Đăng nhập bằng Google
accounts.google.com/signin/oauth/consent?…

Nhân sự 360 PRO muốn truy cập vào Tài khoản Google của bạn

ten.cua.ban@gmail.com

Việc này sẽ cho phép Nhân sự 360 PRO:

  • Xem, sửa, tạo và xoá tất cả bảng tính Google Trang tính của bạn
  • Xem, sửa, tạo và xoá tất cả tệp Google Drive của bạn
  • Gửi email thay bạn
  • Hiện và chạy nội dung bên thứ ba trong lời nhắc và thanh bên
HuỷCho phép
Vuốt ngang trong hình để xem hết màn hình.Màn hình cuối: giữ nguyên các tick rồi bấm ① Cho phép. Bỏ bớt một quyền thì phần tính năng tương ứng sẽ báo thiếu quyền khi dù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.

Bước 4 — Việc làm một lần

  1. Menu Nhân sự 360 › Cài đặt lần đầu (chỉ chủ file chạy được): đặt múi giờ GMT+7, tạo khoá phiên đăng nhập, cài lịch tự chạy (gom lượt chấm công mỗi 1 phút, nhắc chưa chấm công mỗi 10 phút, việc hằng ngày lúc 06:00) và tạo link riêng cho nhân viên đang làm. Chạy lại lúc nào cũng an toàn — chỉ thêm phần thiếu, không xoá dữ liệu.
  2. Hiện hộp "Ứng dụng web CHƯA được triển khai": bấm Huỷ, làm Bước 5 bên dưới rồi mở link /exec một lần. Xong thì menu › Kiểm tra cài đặt phải thấy link ứng dụng kết thúc bằng /exec, khoá phiên và 3 lịch tự chạy.
  3. Menu › Mở ứng dụng: ứng dụng mở toàn màn hình ở tab mới, tự đăng nhập với vai trò Chủ. Trình duyệt chặn cửa sổ bật lên thì bấm nút "Mở Nhân sự 360" trong hộp nhỏ, hoặc cho phép bật lên từ docs.google.com. Mặc định mỗi lần chủ file mở bảng tính, ứng dụng tự mở; tắt hoặc bật lại ở menu › Bật/tắt tự mở ứng dụng khi mở file.
  4. Trong ứng dụng › Cài đặt › Công ty & luật: tên công ty, vùng lương, ngày trả lương, công chuẩn, nghỉ thứ Bảy / Chủ nhật. Tham số luật và Ngày lễ 2026–2028 đã điền sẵn.
  5. Cài đặt › Chi nhánh (tối đa 5): vĩ độ / kinh độ — đứng tại cửa hàng bấm "Lấy vị trí hiện tại", hoặc bấm giữ đúng chỗ trên Google Maps rồi chép hai số — bán kính chấm công (mặc định 100 m), Kiosk QR, Bắt buộc selfie. Sai toạ độ thì mọi lượt chấm bị báo ngoài bán kính.
  6. Cài đặt › Ca làm việc (ca đêm qua ngày, ca gãy đều được) và Phòng ban, chức vụ (người duyệt cấp 1, cấp 2). Rồi Nhân viên › Thêm nhân viên hoặc Nhập CSV: Mã NV không trùng, chi nhánh, phòng ban, vai trò (Chủ / HR / Kế toán / Quản lý / Nhân viên), lương, email — tối đa 100 người đang làm.
  7. Xếp ca: kéo ca vào lưới tuần hoặc bấm Gợi ý xếp tuần › Lưu và báo nhân viên. Ca chưa lưu ở dạng Nháp, nhân viên chưa thấy.
  8. Phân quyền: vai trò đặt ở hồ sơ từng người, quyền chi tiết ở Cài đặt › Vai trò & quyền. Google Sheets không khoá được từng tab: chỉ chia sẻ bảng tính cho chủ và kế toán, mọi người khác dùng web app bằng mã NV + PIN.

Bước 5 — Triển khai web app toàn màn hình

Đây chính là ứng dụng, không phải phần thêm: chủ và quản lý dùng trên máy tính (Hôm nay, Xếp ca, Chấm công, Đơn từ, Bảng công, Lương, Nhân viên, Báo cáo, Cài đặt), nhân viên dùng trên điện thoại (Hôm nay với nút Vào ca / Ra ca, Lịch ca, Đơn, Lương; quản lý có thêm Duyệt và Đội). Mỗi nhân viên một link riêng, lần đầu mở tự đặt PIN 6 số, từ đó đăng nhập bằng mã NV + PIN — 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. Chấm công GPS cần nhân viên cho phép trình duyệt dùng vị trí; Google không cho trang mở camera trực tiếp nên selfie mở ứng dụng camera của điện thoại. Lượt chấm hiện trong web app ngay, trong tab Chấm công của bảng tính sau khoảng 1 phút (menu › Gom lượt chấm công ngay nếu cần ngay). Máy tính bảng ở cửa làm kiosk QR bằng link /exec?p=kiosk của chi nhánh, lấy ở Cài đặt › Kiosk & thiết bị.

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. Bắt buộc, làm ngay sau Cài đặt lần đầu. Triển khai xong, mở link /exec một lần trong trình duyệt bằng tài khoản chủ file — ứng dụng tự lưu link của chính nó (hoặc chạy lại Cài đặt lần đầu và dán link; link /dev không được nhận). Rồi menu › Link riêng của nhân viên: gửi từng người link của họ qua Zalo hoặc email; quên PIN hay đổi điện thoại thì dùng menu › Đặt lại PIN 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.
Quản lý lớp học PRO v1.0 — Apps Script
script.google.com/home/projects/1QwE…/edit
Quản lý lớp học PRO v1.0
Triển khai ▾
Tệp+
  • Mã.gs
  • App.html
  • WebApp.html

Thư viện

Dịch vụ

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();
}

Tuỳ chọn triển khai mới

⚙Chọn loại: Ứng dụng web
HuỷTriển khai

Triển khai xong, hộp thoại hiện:

https://script.google.com/macros/s/AKfy…/exec
Vuốt ngang trong hình để xem hết màn hình.Hộp thoại triển khai trên nền trình soạn thảo: ① Thực thi dưới dạng “Tôi”, ② Người có quyền truy cập “Bất kỳ ai”, ③ Triển khai, ④ URL kết thúc bằng /exec — đó là link đem gửi.

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.

Dùng hằng kỳ

  1. Tuần đầu — thử bằng file DEMO trước (PIN trong DEMO là PIN giả: dùng Đặt lại PIN nhân viên để lấy link và tự đặt PIN), rồi chạy song song với cách chấm công đang dùng và kiểm bán kính GPS từng chi nhánh.
  2. Hằng ngày — trang Hôm nay: ai đang trong ca, đi muộn, chưa chấm; duyệt lượt chấm điểm tin cậy thấp và đơn chờ duyệt. Nhắc chưa chấm công tự gửi sau 10 phút trễ.
  3. Hằng tuần — Xếp ca cho tuần sau › Lưu và báo nhân viên; nhân viên nhường, nhận, đổi ca ở chợ ca.
  4. Mỗi tháng — Lương 5 bước: Bảng công (khoá kỳ), Phụ cấp & thưởng, Kiểm tra, Chốt kỳ, Gửi phiếu PDF qua email và xuất file chuyển khoản — luôn kiểm ở màn hình xem trước của ngân hàng trước khi duyệt.
  5. Kỳ lương đầu tiên — lương tính theo luật 2026 nhưng là công cụ tính: nhờ kế toán đối chiếu vài người trước khi trả.

Nếu bạn dùng Excel

Trên Excel 2010 trở lên vẫn mở được cả 26 tab và các cột công thức: Lịch ca (giờ làm, đi muộn, về sớm, giờ đêm, công), Bảng công, Phép năm, Bảng lương, Bảo hiểm & thuế, Chuyển khoản, Tổng quan — giờ vào / ra thực tế bạn tự gõ vào tab Lịch ca. Không có: web app, đăng nhập PIN, chấm công GPS / QR / kiosk / selfie, xếp ca kéo thả, đơn từ và duyệt, chợ ca, chốt kỳ tự động, phiếu PDF qua email, file chuyển khoản, thông báo, sao lưu tự động.

Apps Script chỉ chạy trên Google Trang tính

Chưa chạy được?

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)