Hướng dẫn 4 - ĐỀ XUẤT

🧭 Trình tự 4 bước

Cấu hình ID Key Dự án (làm 1 lần cho mỗi file)

Menu ⚙️ Cấu hình ID Key Dự án. Không có Key thì không gửi được lên Web App (nhưng vẫn tạo và in phiếu bình thường).

Tạo Form Đề Xuất

Mở 3.NS, bôi đen các dòng vật tư thuộc Mục III → 1️⃣ Tạo Form Đề Xuất.

Điền phiếu

Trên sheet PHIẾU ĐỀ XUẤT, điền Tên phiếu (ô C2), Ngày yêu cầu (ô H4), Mức độ ưu tiên (ô J4) và quan trọng nhất là cột KL ĐỀ XUẤT (cột G, chữ đỏ) cho từng vật tư.

Gửi hoặc In

2️⃣ Gửi Đề Xuất Lên Web App để duyệt online, và/hoặc 3️⃣ In Phiếu (Xuất PDF) để lưu bản giấy.

🔗 Quan hệ với các menu khác

ID Key Dự án cấu hình ở đây được dùng chung cho cả ☁️ Đẩy vật tư lên Web App và việc đẩy báo cáo tài chính sang Web App (menu 📊 QUẢN TRỊ CCM).
Nên chạy ☁️ Đẩy vật tư lên Web App trước để danh mục vật tư trên web khớp với 3.NS, rồi mới gửi phiếu đề xuất.

1️⃣ Tạo Form Đề Xuất (từ dòng bôi đen ở 3.NS)

1️⃣ 3.NS (Mục III) → sheet PHIẾU ĐỀ XUẤT taoFormDeXuat

Điều kiện: đang mở sheet 3.NS, vùng bôi đen nằm trọn trong Mục III VẬT TƯ (từ dòng 5 trở xuống). Chọn lấn sang mục khác → add-on báo "Vui lòng chọn các mục Vật tư thuộc MỤC III VẬT TƯ".

Mỗi dòng vật tư hợp lệ (có mã hiệu + có tên) thành 1 dòng trong phiếu. Add-on lấy sẵn KL hợp đồng (cột N) và đơn giá (cột O) của 3.NS.
Người đề xuất = email Google đang đăng nhập; ngày tạo = hôm nay.
Add-on dựng luôn khối ký duyệt: BAN GIÁM ĐỐC · P.KẾ TOÁN · P.QLDA · TP. THI CÔNG · BAN CHỈ HUY CÔNG TRÌNH · ĐỘI THI CÔNG.

🛑

Ghi đè phiếu cũ: nếu PHIẾU ĐỀ XUẤT đã tồn tại, add-on hỏi "Xóa và tạo mới?". Chọn Yes là phiếu cũ bị xóa hẳn. Muốn giữ lại, hãy in PDF hoặc gửi lên Web App trước khi tạo phiếu mới.

2️⃣ Gửi Đề Xuất Lên Web App

2️⃣ POST phiếu lên app.antronicpro.com.vn guiDeXuatLenWebApp

Điều kiện: đang mở sheet PHIẾU ĐỀ XUẤT + đã cấu hình ID Key Dự án.

Chỉ những dòng có KL ĐỀ XUẤT (cột G) > 0 mới được gửi. Không dòng nào > 0 → add-on báo lỗi và không gửi.
Add-on gửi kèm: tên phiếu (ô C2 — bỏ trống thì tự đặt "Đề xuất vật tư - dd/MM/yyyy"), ngày yêu cầu (H4), mức ưu tiên (J4), email người gửi, và danh sách vật tư (mã, tên, ĐVT, KL, đơn giá).
Gửi xong hiện hộp thoại có link đính kèm file trên Web App — bấm vào để tải chứng từ/ảnh liên quan.

3️⃣ In Phiếu (Xuất PDF)

🖨️ Xuất PDF khổ A4 nằm ngang inPhieuDeXuat

Đang mở sheet PHIẾU ĐỀ XUẤT → chạy lệnh → hộp thoại hiện nút 📥 Tải PDF / In. File PDF: khổ A4 ngang, vừa bề rộng trang, không in tên sheet, không in số trang, không in đường lưới.

⚙️ Cấu hình ID Key Dự án

⚙️ Khai báo Key riêng của dự án capNhatApiKey

Lấy Key ở đâu: Web App → Dự án → Cài đặt → GG Sheet (chỉ tài khoản Admin của dự án thấy được).

Key lưu riêng theo từng file Google Sheets. Hộp thoại hiện lại Key đang lưu để bạn đối chiếu.
Một Key dùng chung cho 3 việc: gửi phiếu đề xuất, đẩy vật tư lên Web App, đẩy báo cáo tài chính sang nhóm BC Tài Chính trên web.

🗺️ Bản đồ ô

Dòng	A	B–C	D	E–F	G	H	I	J
1	PHIẾU ĐỀ XUẤT VẬT TƯ
2	Tên phiếu đề xuất :	✍️ C2 — nhập TÊN PHIẾU
3			Ngày tạo: dd/MM/yyyy (tự động)
4	Người đề xuất: (email tự động)				Ngày yêu cầu:	✍️ H4	Mức độ ưu tiên:	✍️ J4 (chọn)
6	STT · MÃ HIỆU · CÔNG VIỆC/VẬT TƯ · ĐVT · KL HĐ · KL CÒN LẠI · KL ĐỀ XUẤT · ĐƠN GIÁ · THÀNH TIỀN · GHI CHÚ
7+	Dữ liệu vật tư — cột G (KL ĐỀ XUẤT) ✍️ phải nhập · cột I (Thành tiền) = G × H, tự tính

⚠️

Add-on ghi sẵn 2 dòng nhắc màu xanh/vàng ngay dưới bảng: phải điền Tên phiếu và Ngày yêu cầu trước khi gửi. Dòng TỔNG CỘNG nằm ngay sau dòng vật tư cuối cùng.

✍️ 3 ô bắt buộc trước khi bấm Gửi

Ô	Nội dung	Nếu bỏ trống
`C2`	Tên phiếu đề xuất	Add-on tự đặt "Đề xuất vật tư - dd/MM/yyyy".
`H4`	Ngày yêu cầu	Phiếu gửi lên web sẽ không có ngày yêu cầu.
`Cột G`	KL ĐỀ XUẤT từng vật tư	Không gửi được — add-on báo "Không có vật tư nào được nhập KL ĐỀ XUẤT lớn hơn 0".

Thông báo	Nguyên nhân & cách xử lý
"Vui lòng mở sheet 3.NS và bôi đen các dòng vật tư…"	Bạn đang đứng ở sheet khác. Sang `3.NS` rồi bôi đen dòng vật tư.
"Vui lòng chọn các mục Vật tư thuộc MỤC III VẬT TƯ"	Vùng chọn nằm ngoài Mục III (hoặc trùm cả dòng tiêu đề "III"). Chọn lại các dòng bên trong Mục III.
"Không tìm thấy vật tư hợp lệ nào trong vùng bôi đen"	Các dòng chọn không có mã hiệu hoặc không có tên vật tư.
"Vui lòng mở sheet PHIẾU ĐỀ XUẤT để thực hiện gửi"	Lệnh Gửi và lệnh In chỉ chạy khi bạn đang đứng trên sheet PHIẾU ĐỀ XUẤT.
⛔ Chưa cấu hình ID Key Dự án	Vào ⚙️ Cấu hình ID Key Dự án, dán Key lấy từ Web App → Dự án → Cài đặt → GG Sheet.
⛔ Không có vật tư nào được nhập KL ĐỀ XUẤT > 0	Điền cột G (chữ đỏ) cho các vật tư cần đề xuất.
⛔ Lỗi kết nối / Lỗi từ Server	Mạng lỗi hoặc Key sai/hết hiệu lực. Thử lại; nếu vẫn lỗi, kiểm tra Key với Admin dự án trên Web App.
Phiếu cũ biến mất	Lệnh Tạo Form đã xóa và dựng lại sheet. Hãy in PDF / gửi web trước khi tạo phiếu mới.

ĐỀ XUẤT

🌐 Menu ĐỀ XUẤT — Phiếu đề xuất vật tư