hitava

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

Cài đặt Booking KOC/KOL PRO

Dành cho bản Google Trang tính. Sau khi cài, menu “Booking KOC” 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
Booking KOC
Số file phải dán
2 file
Thời gian
~10 phút
Web App
Không

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.

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 2 file trong thư mục 2-Apps-Script:

  • Code.gs — phần chạy trên máy chủ Google: menu, tự đánh mã, Google Docs hàng loạt, Google Calendar, email cảnh báo
  • appsscript.json.txt — tệp kê khai: múi giờ GMT+7 và đúng 7 quyền (chỉ bảng tính này, Drive chỉ file script tạo). Không dán thì Google hỏi quyền rộng hơn nhưng script vẫn chạy (tuỳ chọn)
  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. 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.
  4. 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.
  5. Quay lại tab bảng tính, nhấn F5. Menu Booking KOC 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úpBooking KOCCài đặt lần đầuĐánh mã booking và KOC còn trốngTạo văn bản Google Docs (booking đang chọn)Đồng bộ Google Calendar ngayBật / tắt đồng bộ lịch mỗi giờGửi email cảnh báo ngayBật / tắt email mỗi sángKiể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 “Booking KOC” 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 Booking KOC › 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 Booking KOC/KOL 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 bảng tính mà ứng dụng này được cài vào
đọc booking, KOC, chiến dịch và ghi mã, mã sự kiện lịch trong chính file này — không đọc file khác
Xem, sửa, chia sẻ, xoá lịch
chỉ khi bạn bấm Đồng bộ Google Calendar: tạo một lịch riêng cho hạn đăng / hạn trả tiền và sự kiện trong lịch đó, không đụng lịch khác
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
đồng bộ lịch mỗi giờ và email mỗi sáng — chỉ khi bạn tự bật
Hiện và chạy nội dung bên thứ ba
hiện menu Booking KOC trong bảng tính. Script không gửi dữ liệu ra ngoài Google
Xem, sửa, tạo, xoá Google Tài liệu của bạn
chỉ khi bạn bấm Tạo văn bản: tạo hợp đồng, nghiệm thu, phiếu chi từ tab Văn bản
Xem, sửa, tạo, xoá chỉ những tệp Google Drive mà bạn dùng với ứng dụng này
đưa văn bản vừa tạo vào một thư mục riêng và xuất PDF — script chỉ thấy file nó tạo
Đăng nhập bằng Google
accounts.google.com/signin/oauth/consent?…

Booking KOC/KOL 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 Booking KOC/KOL 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 Booking KOC › Cài đặt lần đầu: đặt múi giờ GMT+7, đánh mã booking BK0001… và KOC K001…, đổi cột checklist và Nhận email thành ô tích, khoá mức cảnh báo các cột tự tính, ẩn cột phụ. Từ đó gõ tên KOC vào dòng mới là tự có mã. Chạy lại lúc nào cũng an toàn.
  2. Tab Thiết lập: tên công ty, địa chỉ, MST, người ký (hiện trên hợp đồng, phiếu chi); người phụ trách (tên, email, tích Nhận email mỗi sáng); email quản lý; ngưỡng cảnh báo; cọc mặc định; thuế TNCN (tỷ lệ, ngưỡng mỗi lần chi trả) và VAT.
  3. File DEMO: ô Thiết lập › Hôm nay đang cố định 16/10/2026 cho khớp ảnh mẫu — xoá ô đó khi dùng thật.
  4. Tuỳ chọn: tab Văn bản chọn loại văn bản, rồi ở tab Booking chọn các dòng booking (tối đa 25) › menu › Tạo văn bản Google Docs. Văn bản vào một thư mục Drive riêng, kèm PDF nếu bật ở Thiết lập.
  5. Tuỳ chọn: menu › Đồng bộ Google Calendar ngay — một lịch riêng với hạn đăng và hạn trả tiền (mỗi lần tối đa 120 thay đổi, lần đầu bấm lại vài lần). Rồi Bật / tắt đồng bộ lịch mỗi giờ.
  6. Tuỳ chọn: menu › Gửi email cảnh báo ngay để xem trước người nhận, rồi Bật / tắt email mỗi sáng (giờ gửi ở Thiết lập).

Dùng hằng kỳ

  1. Hằng ngày — tab Tổng quan › Việc cần làm hôm nay (hoặc email mỗi sáng): trễ đăng, quá hạn trả tiền, mẫu chưa tới, nội dung chưa duyệt sát hạn.
  2. Khi lên chiến dịch — tab Chọn KOC lọc ứng viên, so giá thị trường, cộng dồn trong ngân sách; tạo booking ở trạng thái Mời.
  3. Khi chốt — điền phí, cọc, hạn đăng, chuyển Đã chốt; tab Văn bản in hoặc tạo hợp đồng; gửi mẫu và ghi ngày gửi.
  4. Khi KOC nộp nháp — ghi link bản nháp, Cần sửa (tăng số vòng sửa) hoặc Đã duyệt nội dung.
  5. Sau khi đăng 1–3 ngày — nhập số liệu từng bài ở tab Bài đăng KOC, chuyển Đã nghiệm thu, chấm điểm KOC, ghi ngày trả tiền.
  6. Cuối chiến dịch — tab Báo cáo chiến dịch chọn mã, in một trang gửi sếp / khách hàng; tab Hiệu quả so CPM, CPA, ROI.

Nếu bạn dùng Excel

Trên Excel 2016 trở lên (và LibreOffice) vẫn đủ 17 tab và mọi công thức: cảnh báo 7 mức, thuế TNCN, VAT, cọc, thanh toán, Lịch tháng, Kanban, Tổng quan, Báo cáo chiến dịch, Hiệu quả, Chọn KOC, Bảng giá, Mẫu hàng, văn bản in. Không có: menu, Google Docs hàng loạt, Google Calendar, email mỗi sáng, tự đánh mã; ô tích là TRUE / FALSE.

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)