# Hướng dẫn cài đặt Booking KOC/KOL PRO

Cài Apps Script cho Booking KOC/KOL PRO trong khoảng 10 phút. Chỉ áp dụng cho bản Google Trang tính.

## Thông tin nhanh

- **Menu sau khi cài:** Booking KOC (hiện cạnh menu Trợ giúp)
- **Mục bấm đầu tiên:** Cài đặt lần đầu — đây là lúc Google hỏi quyền
- **Số file phải dán:** 2 (Code.gs, appsscript.json.txt)
- **Thời gian:** khoảng 10 phút, làm một lần
- **Web App:** không
- **Trang sản phẩm:** https://www.hitava.cloud/san-pham/booking-koc-kol-pro

## 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 mã, Google Docs hàng loạt, Google Calendar, email cảnh báo
- `appsscript.json.txt` (HTML, tuỳ chọn): 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

## 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: appsscript.json.txt (HTML).
5. Lưu, quay lại bảng tính, nhấn F5. Menu Booking KOC hiện cạnh Trợ giúp.
6. Bấm Booking KOC › Cài đặt 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 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

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 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.
- 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.
- 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.
- 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.
- 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ờ.
- 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.

## Trên 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.

Trang HTML: https://www.hitava.cloud/huong-dan/booking-koc-kol-pro