1. Mở app
- Địa chỉ:
https://hoanganh.pages.dev
- Dùng trình duyệt CHROME (không dùng Comet/Zalo để in cho chuẩn).
- Lưu ra Màn hình chính: trong Chrome bấm ⋮ → Thêm vào Màn hình chính → mở như một ứng dụng.
- App lưu mọi dữ liệu ngay trên máy/điện thoại (đơn, kho, công nợ, cài đặt).
💡 Có 7 tab, vuốt ngang để thấy hết: Nhận đơn · Đơn hàng · Báo giá/HĐ · Kho · Công nợ · Lịch sử · Cài đặt.
2. Cài đặt ban đầu (làm 1 lần) — tab Cài đặt ⚙️
- Tỷ lệ lợi nhuận (%): giá bán = giá nhập × (1 + %). Ví dụ 20%.
- Làm tròn giá: vd 500đ cho dễ tính tiền mặt.
- Cài đặt kho: bật Tự trừ kho khi in HÓA ĐƠN; đặt ngưỡng "sắp hết" (vd 5).
- Khóa API AI (để đọc ảnh / ra lệnh giọng nói): chọn Google Gemini → dán khóa (lấy miễn phí ở aistudio.google.com).
Không có khóa AI vẫn dùng được toàn bộ phần offline (tìm hàng, tạo & in hóa đơn, kho, công nợ).
3. Tạo đơn & In
3.1. Thêm hàng — tab Nhận đơn 🛒
- Gõ tìm: vd
ống ppr 25, cút phi 20, dây đôi 2.5. Hiểu cả tiếng lóng (Ф/phi, T=tê, MS=măng sông…). Mỗi kết quả hiện Tồn.
- Nói để tìm: bấm 🎤 rồi đọc (cần Internet).
3.2. Đọc ảnh đơn viết tay bằng AI 📷 (cần Internet + khóa AI)
- Bấm 📷 Chụp ảnh / 🖼️ Chọn từ máy.
- Đợi ~5 giây, AI đọc xong.
- Dòng nào chưa khớp sẽ báo đỏ — bấm ô tìm để chọn mã hàng đúng (hoặc bỏ qua).
- Bấm ➕ Thêm các dòng đã chọn vào đơn.
3.3. Sửa đơn — tab Đơn hàng 📋
- Mỗi dòng: chỉnh số lượng (−/+), sửa đơn giá, hoặc 🗑️ xóa.
3.4. Chọn loại chứng từ — tab Báo giá/HĐ 🧾
- 📝 NHÁP Phiếu tạm tính cho khách xem — không lưu sử, không trừ kho, không ghi nợ.
- 📄 BÁO GIÁ Có số, lưu lịch sử. Không trừ kho/ghi nợ.
- 🧾 HÓA ĐƠN Có số, lưu sử, trừ kho, hỏi thanh toán → ghi công nợ.
Điền Tên khách / Địa chỉ / Điện thoại (nên có SĐT để quản lý công nợ chính xác).
3.5. In hoặc Tải PDF (thanh dưới cùng)
- 🖨️ IN: trang in Chrome → chọn máy in (cùng Wi-Fi) → In. Nhớ để Hướng = Dọc.
- 📄 PDF: tạo file PDF tải về (cần Internet) — dùng khi không in trực tiếp được.
3.6. Khi in HÓA ĐƠN — hộp thoại thanh toán
- Chọn Đã thu đủ / Thu một phần (nhập số đã thu) / Ghi nợ toàn bộ. Phần thiếu tự ghi vào Công nợ.
4. Quản lý kho — tab Kho 📦
- Nhập / Xuất / Đặt tồn: tìm mặt hàng → nhập số lượng → ➕ Nhập / ➖ Xuất / = Đặt tồn (đầu kỳ).
- Tóm tắt: có tồn / sắp hết / hết. Màu: xanh đủ · cam sắp hết · đỏ hết.
Nhập tồn đầu kỳ nhanh bằng Excel
- ⬇️ Xuất CSV → mở bằng Excel (có sẵn 603 mặt hàng).
- Điền cột Tồn kho → Lưu.
- ⬆️ Nhập file → chọn file → Ghi đè → Áp dụng.
5. Công nợ — tab Công nợ 💳
Công tắc trên cùng: 👥 Phải thu (Khách) khách nợ mình · 🏭 Phải trả (NCC) mình nợ nhà cung cấp.
Ghi / Thu nợ
- Thủ công: tên + SĐT + số tiền → Ghi nợ/Mua chịu hoặc Thu nợ/Trả NCC.
- Bằng AI: gõ/nói vd "anh Tuấn nợ 500 nghìn", "thu nợ cô Hoa 200 nghìn" → Phân tích → kiểm tra → Ghi sổ.
Nên kèm SĐT để gộp đúng người (tên không phân biệt hoa-thường & dấu).
Xem & báo cáo
- Danh sách khách nợ; bấm Chi tiết xem sổ nợ + gắn 🏷️ Nhóm (Thợ, Công trình…).
- 📊 Báo cáo: chọn kỳ (Tuần/Tháng/Tất cả) → Nợ đầu kỳ · Phát sinh · Đã thu(trả) · Nợ cuối kỳ; theo khách/NCC hoặc theo nhóm; xuất CSV/PDF.
6. Cập nhật giá bằng AI — tab Cài đặt ⚙️
Gõ/nói vd: "cút ppr 25 giá bán 8 nghìn rưỡi từ ngày mai" → Phân tích & cập nhật giá → kiểm tra (giá, bán/vốn, từ ngày) → Lưu lịch đổi giá.
Giá tự áp đúng ngày; giá tương lai "chờ" tới ngày mới bật. Có danh sách lịch + nút Xóa.
7. Lịch sử & Hỏi AI — tab Lịch sử 📚
- 🤖 Hỏi nhanh: "doanh thu hôm nay", "cút ppr 25 còn bao nhiêu", "ai đang nợ nhiều nhất". AI hiểu câu hỏi, máy tự tính số → luôn chính xác.
- Lịch sử: tìm lại, In lại, Mở lại vào đơn, Xóa.
8. Mẹo & xử lý sự cố
| Tình huống | Cách xử lý |
| Cập nhật bản mới không thấy | Tải lại trang (kéo xuống để refresh). |
| Bấm IN không hiện máy in | Mở bằng Chrome. Máy in Wi-Fi: điện thoại cùng Wi-Fi; nếu vẫn không thấy, cài Mopria Print Service. |
| Bản in lệch/tràn | Đổi Hướng → Dọc (Portrait). |
| AI đọc ảnh báo lỗi | Kiểm tra Khóa API & tên Model trong Cài đặt; cần Internet. |
| Cần Internet phần nào? | Đọc ảnh AI, giọng nói, đổi giá AI, hỏi AI, PDF/Excel. Tìm hàng, in hóa đơn, kho, công nợ chạy offline. |
| Sao lưu dữ liệu | Thỉnh thoảng Xuất CSV (kho) và CSV/PDF (công nợ) để lưu phòng hờ. |
Cập nhật: 2026-06-06 · Cửa hàng Hoàng Anh