# Hướng dẫn cài đặt Bán hàng 360 PRO

Cài Apps Script cho Bán hàng 360 PRO trong khoảng 25 phút. Chỉ áp dụng cho bản Google Trang tính.

## Thông tin nhanh

- **Menu sau khi cài:** Bán hàng 360 (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:** 3 (Code.gs, App, appsscript.json.txt)
- **Thời gian:** khoảng 25 phút, làm một lần
- **Web App:** có — Triển khai web app toàn màn hình
- **Trang sản phẩm:** https://www.hitava.cloud/san-pham/ban-hang-360-pro
- **Video hướng dẫn:** https://youtu.be/hcFoJaCBtgM

## 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 (mã đã thu gọn, dòng rất dài — đừng sửa gì): menu, đăng nhập, bán hàng, kho, nhập hàng, công nợ, đại lý, sản xuất, báo cáo, sao lưu
- `App` (HTML): web app toàn màn hình: một trang dùng chung cho máy tính, điện thoại, máy bán tại quầy và cổng đặt hàng của đại lý
- `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ụ đọc nhanh Google Sheets — thiếu tệp này mỗi trang web app tải mất 15–30 giâ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: App (HTML), appsscript.json.txt (HTML).
5. Lưu, quay lại bảng tính, nhấn F5. Menu Bán hàng 360 hiện cạnh Trợ giúp.
6. Bấm Bán hàng 360 › 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, tạo, xoá bảng tính:** đọc và ghi hàng hoá, chứng từ, kho, công nợ, báo cáo trong file này
- **Xem, sửa, tạo, xoá tệp trong Google Drive:** bản sao lưu trong thư mục "Bán hàng 360 – Sao lưu" và bộ nhớ đệm của ứng dụng
- **Gửi email thay bạn:** email nhắc việc cho chủ. Script không đọc hộp thư Gmail
- **Chạy khi bạn không có mặt:** ghi sổ hàng đợi bán hàng mỗi 10 phút, đối soát lại lúc 02:00, nhắc việc lúc 07:00, sao lưu
- **Hiện và chạy nội dung bên thứ ba:** menu Bán hàng 360 và hộp nhỏ "Mở ứng dụng" trong bảng tính
- **Xem địa chỉ email của bạn:** biết ai đang bấm menu: chủ file hay người có vai trò Chủ. Script không xin quyền kết nối dịch vụ bên ngoài Google, dữ liệu không gửi về HiTaVa

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 Bán hàng 360 › Cài đặt lần đầu (chỉ chủ file chạy được): ứng dụng hỏi cửa hàng có tự sản xuất / pha chế / đóng gói không — Có = chế độ Có sản xuất (định mức, lệnh sản xuất, giá thành), Không = chế độ Thương mại (ẩn phần sản xuất), đổi lại được ở Cài đặt. Bước này tạo khoá đăng nhập, cài lịch tự chạy (ghi sổ hàng đợi bán hàng mỗi 10 phút, đối soát lại lúc 02:00, nhắc việc lúc 07:00) và tạo link riêng cho nhân viên. Mỗi 10 phút thay vì mỗi phút để không vượt hạn mức chạy nền 90 phút / ngày của tài khoản gmail.com — đơn bán vẫn hiện ngay trên mọi màn hình. Chạy lại lúc nào cũng an toàn.
- 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, 4 lịch tự chạy và "Ghi sổ hàng đợi + giữ ấm: mỗi 10 phút".
- 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ở Bán hàng 360" trong hộp nhỏ. Muốn ứng dụng tự mở mỗi lần mở file (mặc định tắt): menu › Bật/tắt tự mở ứng dụng khi mở file.
- Trong ứng dụng › Cài đặt › Cửa hàng: tên, địa chỉ, mã số thuế (in trên hoá đơn), ngân hàng nhận tiền + số tài khoản (để tạo VietQR). Rồi Chế độ & thuế, Bán hàng & duyệt (giảm tối đa không cần duyệt, hạn mức nợ, ẩn giá vốn với thu ngân, mục tiêu ngày), Kho & lô (FEFO, cận date).
- Cài đặt › Kho, cửa hàng (tối đa 5): bật Bán tại quầy cho cửa hàng. Cài đặt › Nhân viên: vai trò (Chủ, Quản lý cửa hàng, Kế toán, Thủ kho, Thu ngân, Bán hàng, Sản xuất), kho, % hoa hồng.
- Hàng hoá › Nhập từ Excel hoặc thêm từng mã. Mỗi biến thể (màu, dung tích, size) là một mã có Mã gốc + Biến thể; đơn vị quy đổi (thùng, lốc), combo, bảng giá, khuyến mãi ở các tab của Hàng hoá. Chưa có mã vạch: Hàng hoá › Tem mã vạch. Thêm khách hàng, nhà cung cấp (hạn mức nợ, hạn trả, nợ đầu kỳ).
- Tồn đầu: Kho › Phiếu kho › Nhập khác (lý do "Tồn đầu kỳ") với số lượng, giá vốn, lô + hạn dùng.
- Giới hạn trong một file: tới 5.000 mã hàng (mỗi biến thể một mã), 3.000 khách, 5 kho / cửa hàng / xưởng, 80.000 dòng hàng — khoảng một năm của cửa hàng 70 hoá đơn mỗi ngày.

## 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, Bán tại quầy, Đơn hàng, Hàng hoá, Kho, Nhập hàng, Công nợ, Sản xuất, Báo cáo, Cài đặt), thu ngân dùng máy bán tại quầy trên máy tính bảng hoặc máy tính, nhân viên dùng trên điện thoại, đại lý có cổng đặt hàng riêng. "Bất kỳ ai" để thu ngân, nhân viên, đại lý mở được mà không cần tài khoản Google; mỗi người vẫn phải đăng nhập bằng mã + PIN 6 số. Máy bán giữ sẵn danh mục, giá, tồn của kho mình (tối đa 72 giờ): mất mạng vẫn bán, vẫn in, có mạng lại đơn tự gửi. Đơn vào hàng đợi trước rồi ghi vào tab Chi tiết chứng từ mỗi 10 phút (menu › Ghi sổ hàng đợi bán hàng ngay nếu cần ngay); mọi màn hình của web app đã tính cả đơn đang chờ. Khi dán bản cập nhật: dán cả Code.gs và App.html › Triển khai › Quản lý bản triển khai › Chỉnh sửa › Phiên bản mới — link cũ giữ nguyên.

Bật: 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 gửi link: nhân viên — menu › Link riêng của nhân viên, gửi từng người qua Zalo hoặc email, lần đầu mở tự đặt PIN 6 số, quên PIN thì menu › Đặt lại PIN nhân viên; máy bán tại quầy — mở link /exec?pos=<mã cửa hàng> trên máy tính bảng (hoặc menu › Mở bán tại quầy), thu ngân đăng nhập mã + PIN rồi thêm vào màn hình chính; đại lý — Khách hàng › mở đại lý › Link + PIN đại lý › Cấp link mới. 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. Tuần đầu — thử bằng file DEMO Mỹ phẩm Hoa Mai (dữ liệu giả; PIN trong DEMO là PIN giả: dùng Đặt lại PIN nhân viên cho thu ngân NV02 để lấy link và tự đặt PIN), thử máy bán với cửa hàng CH-NT, thử máy in và máy quét của bạn. Rồi chạy song song với cách đang dùng một tuần, cuối ngày so tiền chốt ca và tồn vài mã bán chạy.
2. Mỗi ca — Mở ca (đếm tiền đầu ca), bán tại quầy: quét mã vạch hoặc gõ tên, gõ số điện thoại chọn khách quen, thanh toán tiền mặt / VietQR / thẻ / kết hợp / ghi nợ; cuối ca Chốt ca, đếm tiền theo mệnh giá. Bán dưới giá vốn, giảm quá mức, huỷ hoá đơn đã thu: quản lý nhập PIN ngay trên máy hoặc duyệt từ xa ở tab Duyệt.
3. In hoá đơn — chọn khổ K80, K58 hoặc A5, bật Tự in khi hoàn tất; trong hộp thoại in chọn máy in nhiệt, khổ 80 / 58 mm, Lề: Không, tắt Đầu trang và chân trang. Máy in phải cài được trên chính thiết bị bán.
4. Hằng ngày — trang Hôm nay: doanh thu, lãi gộp, % mục tiêu, đơn chờ giao, nợ quá hạn, việc chờ duyệt, hàng sắp hết / cận date. Công nợ: thu tiền, dán sao kê ngân hàng để tự khớp với mã hoá đơn, nhắc nợ qua Zalo với tin soạn sẵn kèm link trả nợ VietQR.
5. Khi cần hàng — Nhập hàng › Gợi ý nhập › Tạo đơn mua › hàng về thì Nhận lần này (lô, hạn dùng) › Lưu phiếu nhập. Chuyển kho, kiểm kê theo khu trên điện thoại; chế độ Có sản xuất: Lên lệnh sản xuất › Xuất nguyên liệu › Nhập thành phẩm.
6. Thuế — thuế suất mặc định 8% và bảng kê VAT: kiểm với kế toán theo danh mục hàng của bạn. Số hoá đơn là số bán lẻ nội bộ, không phải hoá đơn điện tử.

## Trên Excel

Trên Excel 2010 trở lên vẫn mở được cả 30 tab, không macro. Các tab báo cáo tính bằng công thức thật: Tồn kho, Thẻ kho, Lãi theo mặt hàng, Công nợ khách, Công nợ NCC, Báo cáo bán hàng, Lãi lỗ, Dòng tiền, Tổng quan — nhưng bạn tự gõ chứng từ vào Chứng từ và Chi tiết chứng từ, kể cả giá vốn dòng; Excel không tự tính giá vốn bình quân di động. Không có: web app, đăng nhập PIN, máy bán tại quầy, mã vạch, in hoá đơn, bán khi mất mạng, VietQR, khuyến mãi / bảng giá tự áp, duyệt PIN, cổng đại lý, đối soát sao kê, nhắc nợ Zalo, sản xuất, email nhắc việc, sao lưu tự động.

Trang HTML: https://www.hitava.cloud/huong-dan/ban-hang-360-pro