[HV] Hùng Vương · Edric Mart

Đưa mã vạch vào khung và giữ ổn định

Tổng quan

📊Dashboard

Bán hàng

🛍️Bán hàng POS

🧾Đơn hàng đã bán

Quản lý

📦Sản phẩm

🏪Kho

📥Duyệt phiếu nhập NV

🔢Duyệt kiểm kê NV

🔄Chuyển hàng nội bộ

🚨Việc khẩn về hàng hoá

👥Khách hàng

👔Nhân viên

🔁Những đơn hàng bị giữ lại

Tài chính

💵Thu chi

⏰Ca làm

Khác

🧾Thuế

📈Báo cáo

📜Nhật ký

👁️Nhật ký làm việc NV

🏆Xếp hạng nhiệt huyết

🛡️Chống gian lận

⚙️Cài đặt

📊 Dashboard tổng quan

💰

Doanh thu hôm nay

0 ₫

⚡

Doanh thu 1 giờ qua

0 ₫

🧾

Tổng bill hôm nay

0

⏳

Bill đang chờ

0

⚠️

Hàng sắp hết

0

❌

Bill bị huỷ

0

💵

Tiền mặt hiện tại

0 ₫

Mở ca để theo dõi

💰 Doanh thu kỳ này

—

—

🧾 Số hoá đơn

—

—

📊 Giá trị TB / hoá đơn

—

—

⏮️ Kỳ trước (cùng độ dài)

—

📈 Biểu đồ doanh thu

—

🏆 Top nhân viên

Chưa có dữ liệu

💳 Cơ cấu thanh toán

🔥 Top sản phẩm

#	Sản phẩm	SL bán	Doanh thu
Chưa có dữ liệu

Tất cả

🛒 Đơn hàng

0 món

🛒

Chưa có sản phẩm

Click sản phẩm bên trái để thêm

Tạm tính 0 ₫

Giảm giá 0 ₫

TỔNG TIỀN0 ₫

💰 Tiền khách đưa

↩️ Tiền thối lại 0 ₫

🧾 Danh sách đơn hàng đã bán

Từ

Đến

🧾

Tổng số bill

0

0 paid | 0 huỷ

💰

Tổng doanh thu

0 ₫

💵

Tiền mặt

0 ₫

🏦

CK + QR + Thẻ

0 ₫

Đã chọn: 0 / 0 bill

	Mã hoá đơn	Thời gian	Khách hàng	Thu ngân	Tổng tiền	Thanh toán	Trạng thái	Hành động
Đang tải...

📦 Quản lý sản phẩm

Tổng SP: 0

Đang hiển thị: 0

Đã chọn: 0

Mã SP

Barcode / SKU

Tên sản phẩm

Nhóm

Giá vốn

Giá bán

% LN

Tồn

Trạng thái

Đang tải...

🏪 Quản lý kho

Từ thời điểm

Đến thời điểm

⏰ Thời gian thực nhập	Loại	Sản phẩm	SL	Trước	Sau	Ghi chú	Người thực hiện	🕐 Nhập liệu lúc	Thao tác
Đang tải...

Mã	Tên sản phẩm	Nhóm	Tồn	Định mức
Đang tải...

🔍 Kiểm kê kho thực tế: Nhập số lượng đếm được thực tế của từng SP tại thời điểm cụ thể. Hệ thống tự so sánh với tồn trên phần mềm → ra chênh lệch (thiếu/thừa) → tính giá trị hao hụt (theo giá vốn). Dùng để phát hiện hư hỏng, mất mát, gian lận.

Từ thời điểm

Đến thời điểm

🔢 Gộp kiểm kê nhân viên (app)

⏰ Thời điểm kiểm	Sản phẩm	Hệ thống	Thực tế	Chênh lệch	Giá trị	Người kiểm	Thao tác
Chọn khoảng thời gian rồi bấm "Xem báo cáo"

📥 Phiếu nhập hàng nhân viên gửi

Đối chiếu với ảnh phiếu rồi duyệt. Phiếu mới: tồn ĐÃ cộng ngay lúc NV gửi — duyệt là soát lại (sửa SL đúng theo phiếu giao, hệ thống tự bù phần chênh; đã có kiểm kê sau lúc NV gửi thì không bù nữa).

🔢 Kiểm kê kho thực tế — nhân viên gửi

Nhân viên đếm thực tế TẠI chi nhánh rồi gửi lên. Duyệt để xác nhận; có thể cập nhật tồn kho theo số đếm.

🔄 Chuyển hàng nội bộ giữa chi nhánh

Nhân viên tạo phiếu chuyển hàng từ app chấm công. Phiếu mới: tồn 2 chi nhánh ĐÃ đổi ngay lúc NV gửi (CN gửi trừ, CN nhận cộng). Duyệt xuất / duyệt nhận = soát lại; nhận thiếu thì ghi đúng SL thực nhận, hệ thống tự trừ phần thiếu. (Phiếu gửi trước 22/10 vẫn đổi tồn lúc duyệt như cũ.) POS này chỉ duyệt phiếu của chi nhánh đang đăng nhập.

🚨 Việc khẩn về hàng hoá

Nhân viên quét sản phẩm khi rà soát (hết hạn / hỏng / hư). Kế toán duyệt TRỪ kho hoặc KHÔNG trừ kho kèm lý do — trừ vào kho của chi nhánh nhân viên đang đứng. Tích "Gửi báo cáo" để quản lý nhận bản tin xử lý.

👥 Quản lý khách hàng

Mã KH	Tên khách hàng	SĐT	Địa chỉ	Điểm	Tổng chi tiêu	Hạng
Đang tải...

👔 Quản lý nhân viên

Mã NV	Họ tên	Username	SĐT	Vai trò	Chi nhánh	Trạng thái
Đang tải...

🔁 Những đơn hàng bị giữ lại

Danh sách đơn có sản phẩm bị bộ lọc giữ lại (không tự gửi cơ quan thuế). Mỗi đơn xem được chi tiết TRƯỚC khi giữ và SAU khi thay thế. Đơn đã xuất hiển thị đúng nội dung đã ghi trên hóa đơn; đơn đang chờ hiển thị thay thế dự kiến theo cấu hình hiện tại.

Khoảng thời gian:

🔁 Đồng bộ bill bán ↔ hóa đơn (theo khoảng thời gian)

Cập nhật đơn đã bán cho khớp đúng sản phẩm trên hóa đơn đã xuất (chỉ các đơn có thay thế nằm trong khoảng chọn). Thành tiền & doanh thu giữ nguyên. Sau khi đồng bộ, báo cáo lợi nhuận / hàng bán chạy của khoảng đó sẽ phản ánh đúng hàng thật trên hóa đơn. Bình thường hệ thống không tự đồng bộ — chỉ khi bạn bấm nút này. Chạy lại nhiều lần an toàn (đơn đã đồng bộ sẽ bỏ qua, không cộng trùng).

Từ: Đến:

Đang tải…

💵 Thu chi tiền mặt

📥

Tổng thu

0 ₫

📤

Tổng chi

0 ₫

💼

Tồn quỹ

0 ₫

📜 Lịch sử thu chi

📜 Chỉ hiện phiếu ĐÃ SỬA

Thời gian	Loại	Số tiền	Lý do	Người tạo	Thao tác
Đang tải...

⏰ Quản lý ca làm

📌 Ca hiện tại

Chưa có ca nào đang mở. Nhấn "Mở ca" để bắt đầu.

📜 Lịch sử ca làm

📜 Chỉ hiện ca ĐÃ SỬA

Mã ca	Mở lúc	Đóng lúc	Người mở	Người đóng	Quỹ đầu ca	Quỹ cuối ca	Lệch	Trạng thái
Đang tải...

🧾 Thuế

📥 Hóa đơn đầu vào — danh sách sản phẩm mua vào

Mục riêng, không lẫn sản phẩm bán. Mỗi dòng có tên trên hóa đơn (tên chuẩn) và tên định danh (tên dễ nhớ/để đối chiếu với hàng bán ra). Hỗ trợ nhập tay và nhận dạng ảnh/PDF (OCR).

📷 Nhận dạng từ ảnh / PDF hóa đơn (OCR)

Chọn ảnh hoặc PDF hóa đơn Engine nhận dạng Chế độ duyệt

Gemini: dùng cầu nối AI sẵn có (tốn token theo gói Gemini, có key OCR riêng). Model local: trình duyệt gọi tới tiện ích OCR chạy trên máy kế toán (miễn phí) — cần cài tiện ích đó và bật cho phép trình duyệt gọi (CORS). PDF nhiều trang nên tách từng trang để đọc tốt.

⏳ Đang tải...

🧾 Lập hóa đơn điều chỉnh / bổ sung & các vấn đề về thuế

Theo quy định, HĐĐT đã phát hành là cố định — sai thì phải lập hóa đơn thay thế / điều chỉnh, không sửa trực tiếp.

Quy trình xử lý khi HĐ bị CQT từ chối / sai:

Kiểm tra lý do ở tab 🩺 HĐĐT lỗi (đã tự kéo trạng thái CQT về).
Sửa lại nội dung đơn nếu cần — đơn đã xuất HĐĐT chỉ người có quyền "Sửa đơn đã xuất HĐĐT" mới sửa được.
Lập hóa đơn thay thế/điều chỉnh trên meInvoice (theo lý do CQT từ chối).
Quay lại tab HĐĐT lỗi, bấm "✍️ Đã xử lý tay" để đánh dấu đã hoàn tất.

ℹ️ Lập hóa đơn điều chỉnh/thay thế tự động qua API meInvoice sẽ được bổ sung ở bản cập nhật sau. Hiện thao tác lập HĐ thay thế thực hiện trên meInvoice, phần mềm hỗ trợ rà soát + đánh dấu xử lý.

🧭 Trợ lý: HĐ đã lập sai thì xử lý thế nào?

Trả lời các câu hỏi, hệ thống gợi ý cách xử lý phù hợp theo Nghị định 70/2025 & 123/2020.

1. Hình thức hóa đơn 2. Đã gửi HĐ đến Cơ quan thuế chưa? 3. Đã gửi HĐ cho người mua chưa? 4. Sai nội dung nào?

🏛️ Đấu nối Cổng Hóa đơn điện tử — Tổng cục Thuế

Đăng nhập tài khoản tra cứu HĐĐT của doanh nghiệp tại hoadondientu.gdt.gov.vn để tải hóa đơn mua vào / bán ra về đồng bộ. Phần mềm gọi qua máy chủ (do trình duyệt bị chặn CORS). Token đăng nhập có hạn ~1 giờ, hết hạn thì đăng nhập lại.

🔐 Tài khoản & đăng nhập

Mã số thuế (MST) Tài khoản (thường = MST) Mật khẩu

⚙️ Nâng cao: địa chỉ API cổng GDT

API base URL (chỉ đổi khi biết địa chỉ API mới của cổng)

Nhập captcha

⚠️ Cổng Tổng cục Thuế có chống bot (F5) và chặn IP máy chủ → đăng nhập trực tiếp từ phần mềm thường bị chặn. Cách chắc chắn: chạy tiện ích trên máy kế toán (IP Việt Nam, phiên thật) để tải hóa đơn rồi đẩy về đây. Cấu hình bên dưới.

💻 Tiện ích máy kế toán (đồng bộ tự động)

Tải file gdt-local-tool.py, cài pip install requests cairosvg, mở file và điền cấu hình sau (lấy ở đây):

WORKER_URL STORE PUSH_SECRET••••••

Trong file điền thêm MST, mật khẩu cổng GDT, GEMINI_KEY (để tự giải captcha). Chạy python gdt-local-tool.py — tiện ích tự đăng nhập, tải HĐ và đẩy về đây. Có thể đặt lịch chạy tự động hằng ngày.

⬆️ Nhập từ file Excel/CSV (khuyên dùng — ổn định nhất)

Xuất danh sách hóa đơn ra Excel từ meInvoice (Xử lý HĐ đầu vào) hoặc từ cổng hoadondientu.gdt.gov.vn (Tra cứu → Xuất Excel), rồi tải lên đây. Tự dò cột theo tiêu đề, không cần đúng mẫu.

Chọn file (.xlsx / .xls / .csv) Loại

Chưa có dữ liệu. Đăng nhập rồi bấm "Đồng bộ từ CQT".

📈 Báo cáo

Loại báo cáo

Khoảng thời gian

Kết quả báo cáo

Chọn loại báo cáo và nhấn "Chạy báo cáo"

📜 Nhật ký hệ thống

Thời gian	Người dùng	Hành động	Module	Chi tiết
Đang tải...

👁️ Nhật ký làm việc của nhân viên

Ghi nhật ký làm việc Đang tải... Ghi các sự kiện có ý nghĩa: đăng nhập/xuất, mở màn hình, khoảng không thao tác (idle). Tắt công tắc nếu muốn tiết kiệm tài nguyên. Không ghi từng cú chuột/cuộn trang.

Thời gian	Nhân viên	Hành động	Màn hình	Chi tiết
Đang tải...

🏆 Bảng xếp hạng nhân viên nhiệt huyết

📐 Cách tính: Thời gian hoạt động thực (từ sự kiện đầu đến sự kiện cuối trong ngày, trừ tổng thời gian không thao tác) + thưởng 2 phút điểm cho mỗi bill bán được. Chỉ tính nhân viên đang bật ghi nhật ký làm việc. BXH mỗi ngày chốt sau 21:00 và hiển thị tới hết ngày hôm sau.

🛡️ Chống gian lận

🔎 Bộ lọc

Mỗi lần nhân viên xóa món / giảm số lượng / xóa cả giỏ đều được ghi lại tại đây để quản lý đối chiếu hành vi "thu tiền nhưng không xuất bill".

Thời gian	Nhân viên	Thao tác	Sản phẩm	SL	Đơn giá	Giá trị xóa	Khách	Ca	Nghi vấn
Chọn bộ lọc rồi bấm "Lọc".

🔎 Bộ lọc

Bill TIỀN MẶT (kể cả phần tiền mặt của đơn hỗn hợp) mà máy POS KHÔNG in lần nào (không tự in, không bấm In, không in lại). Thu tiền mặt không đưa bill là kẽ hở "thu tiền ngoài bill" -> dư/thiếu két. Cảnh báo khi 1 ca có ≥ 5 bill tiền mặt không in và ≥ 20% số bill tiền mặt của ca.

👤 Theo người trực ca

Người trực ca	Số ca	Bill tiền mặt	Đã in	KHÔNG in	Tỷ lệ không in	Tiền mặt bill không in

🕒 Theo ca (ca có bill không in)

Ca	Người trực	Bill tiền mặt	Không in	Tỷ lệ	Tiền mặt

🧾 Danh sách bill tiền mặt không in

Thời gian	Mã bill	Người trực	Thanh toán	Tổng bill	Tiền mặt

🔎 Bộ lọc

Ghi lại MỖI LẦN in bill không phải lần in đầu của đơn vừa bán: bấm 🖨️ in lại trong danh sách đơn, hoặc mở đơn cũ rồi bấm In. 🚨 = in bill cũ trong 10 phút sau khi có người xoá cả giỏ / gỡ hết món ở quầy — kiểu gian lận "thu tiền đơn mới, xoá giỏ, in bill cũ cho có". Ghi từ bản v258 (30/9/2026); trước đó phần mềm không lưu việc in lại.

Thời gian in	Nhân viên	Bill được in lại	Cách in	Xoá giỏ ngay trước đó	Đánh giá
Chọn bộ lọc rồi bấm "Lọc".

🔎 Bộ lọc

✏️ Sửa bill SAU khi bán: giảm tổng tiền, bớt món, đổi phần TIỀN MẶT sang chuyển khoản/thẻ (két "thừa" tiền mặt) — nếu loa có tiền CK khớp thì coi như sửa đúng. 🏷️ Bán thấp hơn giá niêm yết (ghi lúc bán từ bản v260) và giảm giá cả bill lớn (lịch sử từ tháng 6).

Lúc	Nhân viên	Bill	Nội dung	Nghi vấn
Chọn bộ lọc rồi bấm "Lọc".

🔎 Bộ lọc

Bill ghi TIỀN MẶT nhưng loa nhận CHUYỂN KHOẢN đúng số tiền cùng lúc mà không đơn nào nhận khoản đó — kiểu "khách chuyển khoản, thu ngân ghi tiền mặt rồi rút tiền mặt trong két" (két vẫn khớp). Ca đóng thiếu ≈ khoản đó = nhiều khả năng chỉ ghi nhầm. Đã xét mọi chi nhánh dùng chung tài khoản loa.

Bill lúc	Thu ngân	Bill	Tiền	Tiền về loa	Nghi vấn
Chọn bộ lọc rồi bấm "Lọc".

🔎 Bộ lọc

Kiểu gian lận "bán + in bill cho khách, khách đi rồi HUỶ BILL lấy tiền". Chấm theo: bill tiền mặt, huỷ bao lâu sau khi bán, lý do, có bán lại hàng đó không, ca dư tiền, người huỷ nhiều lần. Điểm chấm sau 20 phút.

Huỷ lúc	Người huỷ	Bill	Giá trị	Thanh toán	Bán lúc	Lý do	Nghi vấn
Chọn bộ lọc rồi bấm "Lọc".

🔎 Bộ lọc

Mỗi lần bấm "Giữ đơn" giỏ biến khỏi màn hình như xoá giỏ. Từ bản v259 (30/9/2026) ghi lại: giữ lúc nào, lúc giữ đã nhập tiền khách đưa / hiện mã QR chưa, ai gọi lại, sau bao lâu, gọi lại xong BÁN hay XOÁ, hay bỏ quên không gọi lại. Đơn giữ tồn từ trước cũng được nạp vào để soát. Điểm chấm sau 20 phút.

Giữ lúc	Người giữ	Hàng	Giá trị	Lúc giữ đã có	Gọi lại	Kết cục	Nghi vấn
Chọn bộ lọc rồi bấm "Lọc".

⚙️ Cấu hình hệ thống

🖥️ Giao diện & hiệu năng

Tự làm mới Dashboard Tần suất càng thấp = càng đỡ chớp giật, càng tiết kiệm quota Apps Script

Tự đồng bộ POS (cache sản phẩm) POS chỉ đồng bộ khi rảnh (giỏ trống + không gõ phím) để không cắt ngang khi tính tiền

Giao diện

🔌 API kết nối

Mã API Đổi mã sẽ tự đăng xuất để áp dụng kết nối mới.

💾 Sao lưu dữ liệu

📋 Hướng dẫn:
1. Tạo 1 Google Sheet trống làm nơi backup → mở Apps Script, dán file backup-bridge.gs
2. Sửa BRIDGE_SECRET trong file cho giống secret đã khai trong Worker → Deploy dạng Web app (Anyone)
3. Copy URL /exec của Web app → dán vào ô bên dưới → bấm "Kiểm tra kết nối"
4. Bấm "Lưu cài đặt" để áp dụng. Sau đó có thể bấm "Sao lưu ngay" bất cứ lúc nào
Lưu ý: mỗi lần backup tạo các tab mới có hậu tố ngày-giờ. Hệ thống tự giữ 7 bản gần nhất.

URL Apps Script cầu nối (Web app /exec) Đây là URL của file backup-bridge.gs đã Deploy, KHÔNG phải URL Google Sheet. Mỗi cửa hàng dùng 1 cầu nối riêng.

Cầu nối dự phòng (tự dùng khi cầu nối chính bị treo / lỗi)

Mỗi dòng dán đúng 1 URL /exec (không dán chung nhiều URL). Cầu nối dự phòng phải dùng cùng BRIDGE_SECRET với cầu nối chính. Tối đa 4 dòng. Bấm "Lưu cài đặt" để áp dụng.

🚀 Sao lưu ngay

Tạo bản sao toàn bộ dữ liệu (sản phẩm, bán hàng, khách hàng, kho, ca làm...) sang Sheet đích.

⏰ Sao lưu tự động hàng ngày:
Để bật sao lưu tự động 2h sáng mỗi ngày, cần cài Time-driven Trigger trong Apps Script (chỉ làm 1 lần):

Mở Apps Script Editor (script.google.com)
Click icon đồng hồ ⏰ (Triggers) ở sidebar trái
Bấm "+ Add Trigger" → chọn function: runDailyBackup
Event source: Time-driven → Day timer → 2am to 3am → Save

🤝 Cấu hình bàn giao ca

Chọn những vai trò được phép xuất hiện trong danh sách "ca sau" khi bàn giao ca. Chỉ nhân viên có vai trò được tích mới hiện ra để chọn nhận máy.

💵 Thu ngân (người đứng quầy bán hàng) 👤 Nhân viên (nhân viên thường) 👔 Quản lý 🛡️ Quản trị

📷 Xác thực QR cho ca & thu chi

Khi BẬT: nhân viên phải dùng app chấm công quét mã QR để mở ca, đóng ca, tạo phiếu thu/chi và để xác minh khi vào bán trên máy lạ (chống mạo danh & bơm đơn ảo). Ca được MỞ bằng QR thì chỉ người đã quét lúc mở mới đóng được ca đó. Riêng ca đã mở từ trước lúc chưa bật QR (không có người quét lúc mở) thì bất kỳ ai cũng quét QR để đóng được (vẫn cần quét để ghi nhận người đóng).
Khi TẮT (mặc định): hệ thống hoạt động bình thường, không cần quét QR cho các thao tác trên.

📷 Bật xác thực QR cho mở/đóng ca & thu chi

🔄 Cập nhật phiên bản

Khi có bản cập nhật mới (sau khi quản trị deploy), app đang chạy sẽ hiện thông báo giữa màn hình và tự khởi động lại sau số giây cài bên dưới.

⏱️ Thời gian tự khởi động lại khi có bản mới (giây) Mặc định 20 giây. Tối thiểu 5 giây. Người dùng vẫn có thể bấm "Cập nhật ngay" hoặc "Để sau".

Phiên bản giao diện máy này: v? · Máy chủ: —

🔗 Database & Di chuyển dữ liệu

💡 Nhập dữ liệu cũ từ Google Sheet sang database mới (D1).
Hệ thống mới lưu dữ liệu trong Cloudflare D1. Bạn có thể nhập dữ liệu cũ (sản phẩm, đơn hàng, khách hàng, kho...) từ Google Sheet cũ vào cửa hàng hiện tại.

🏪 Cửa hàng đang dùng:

🔄 Cách nhập dữ liệu cũ từ Google Sheet:

Mở Google Sheet cũ → copy Sheet ID (đoạn trong link giữa /d/ và /edit), hoặc dán cả link.
Đảm bảo tài khoản Google chạy Apps Script cầu nối (backup) có quyền XEM Sheet cũ này.
Dán Sheet ID vào ô dưới → bấm "Nhập dữ liệu". Hệ thống tự nhập theo lô và dựng lại báo cáo.

Lưu ý: dữ liệu trong các bảng tương ứng sẽ bị thay thế bằng dữ liệu Sheet cũ. Tên các tab Sheet cũ phải là PRODUCTS, SALES, CUSTOMERS, SALE_ITEMS...

Sheet ID hoặc URL của Google Sheet cũ

🔑 Khôi phục mật khẩu admin

🛡️ Bảo mật quan trọng:
Khi quên mật khẩu admin và không đăng nhập được, hệ thống sẽ gửi mật khẩu mới về email cấu hình dưới đây. Hãy điền email mà chỉ bạn truy cập được để đảm bảo an toàn. Khi bạn bấm "Quên mật khẩu?" ở màn hình đăng nhập và nhập email khớp với email này → mật khẩu mới được gửi tới hộp thư.

Email nhận mật khẩu khôi phục Khi quên mật khẩu, bạn sẽ nhập email này ở màn hình đăng nhập để nhận mật khẩu mới qua email.

⚠️ Lưu ý:

Email được dùng để gửi đi là tài khoản Google chạy Apps Script (không phải email này)
Apps Script free: 100 email/ngày · Workspace: 1500 email/ngày
Để chống spam: cùng 1 email chỉ được yêu cầu reset 1 lần / 5 phút
Email khôi phục nên KHÁC với email Google đang chạy Apps Script (vì bạn có thể quên cả 2)

🏪 Thông tin cửa hàng

Tên cửa hàng

Phụ đề / khẩu hiệu

Số điện thoại

Địa chỉ

Thuế VAT (%)

VND đổi 1 điểm

Chân hoá đơn

🛒 Cấu hình bán hàng

Cho phép bán âm kho

Khi bật: vẫn bán được dù hệ thống báo hết hàng (tồn xuống số âm). Dùng cho trường hợp hàng đã về kho thực tế nhưng kế toán chưa kịp nhập liệu. Khi kế toán nhập hàng về sau (đúng ngày), số âm sẽ tự động được bù lại → tồn kho trở về đúng.
⚠️ Nên bật có kiểm soát - tồn âm cần được nhập bù sớm để số liệu chính xác.

Làm tròn LÊN nghìn tổng đơn khi lưu (khớp màn hình & QR)

Màn hình POS và mã QR đã hiển thị tổng làm tròn lên nghìn (vd 12.500 → 13.000). Khi bật, hệ thống lưu đơn đúng số đã làm tròn (thêm dòng "Làm tròn" trên bill) → số tiền trên đơn = số khách chuyển = số hệ thống tự xác nhận → đối soát QR khớp tuyệt đối, hết "tiền thừa" ảo.
⚠️ Đang thử nghiệm tại chi nhánh này. Tắt = lưu như cũ.

📱 Cấu hình thanh toán VietQR

Ngân hàng *

Số tài khoản *

Tên cửa hàng LTT (cột "Cửa hàng" trên mcv.loatingting)

Tên chủ tài khoản *

Nội dung chuyển khoản (mẫu)

Nội dung khách nhìn thấy khi quét QR. Hệ thống tự gắn thêm mã ngắn (vd EM00123) vào cuối để đối soát/tự xác nhận — ví dụ: Khach le CK EM00123. Nên viết không dấu và ngắn (≤14 ký tự) để app ngân hàng không cắt mất mã.

💡 Lưu ý:
• Tên chủ TK viết HOA không dấu đúng như đăng ký với ngân hàng
• Khi khách chọn thanh toán QR, mã sẽ tự động sinh kèm số tiền + nội dung bill
• VietQR miễn phí, không cần đăng ký, hoạt động với mọi app ngân hàng VN
• Số TK sẽ không hiển thị cho khách (chỉ tên + ngân hàng)

🤖 Tự động xác nhận thanh toán (Loa TingTing) Chỉ dùng được khi chọn ngân hàng MB

Tự động xác nhận đơn khi phát hiện nhận tiền

Khi BẬT: hệ thống đăng nhập Loa TingTing, dò giao dịch mỗi vài giây, tự xác nhận & in bill khi nhận đủ tiền.

Số điện thoại đăng nhập Loa TingTing *

Mật khẩu Loa TingTing *

Mã cửa hàng trong loa (store_id) — tùy chọn

Số trang giao dịch đọc mỗi lần (đông khách)

Số giây giữa mỗi lần dò (nhỏ = xác nhận nhanh hơn)

STK MB nhận tiền (trùng VietQR phía trên)

Khoá nút "Đã nhận tiền" (giây) — chống bấm nhầm

Khoá nút "Huỷ" (giây)

Khớp DỰ PHÒNG theo SỐ TIỀN (khi nội dung chuyển khoản KHÔNG có mã "EMxxxxxx")
Một số ngân hàng/kênh nước ngoài bị thay nội dung nên không có mã. BẬT: nếu trong khoảng thời gian chờ có đúng 1 giao dịch đúng số tiền chưa được nhận → tự xác nhận. Nếu có ≥2 giao dịch cùng số tiền → KHÔNG tự xác nhận (để bấm tay, tránh nhầm). Mặc định TẮT vì kém chắc chắn hơn khớp theo mã.

Cửa sổ thời gian khớp số tiền (phút)

Nhận theo THỨ TỰ khi nhiều GD cùng số tiền (nâng cao)
Chỉ dùng khi khách nước ngoài chuyển khoản mà nội dung chỉ có chữ như "transaction" + số tiền (không mã, không đọc được STK). BẬT: khi có ≥2 giao dịch cùng số tiền chưa nhận, mỗi máy sẽ nhận giao dịch cũ nhất còn trống theo thời gian — máy hỏi trước lấy GD sớm nhất, máy sau lấy GD kế tiếp, KHÔNG cùng nhận 1 giao dịch (chống trùng theo Mã GD duy nhất). TẮT (mặc định): ≥2 GD cùng tiền thì chờ bấm tay — an toàn tuyệt đối. Lưu ý: chỉ bật nếu 2 máy dùng chung tài khoản loa và hay gặp cảnh này; nếu 2 cửa hàng đã khác STK/store_id thì KHÔNG cần bật.

🔤 Giải captcha bằng ddddocr (API riêng — thay Tool đẩy trên laptop)
Hệ thống tự giải captcha đăng nhập Loa TingTing bằng ddddocr (API riêng, miễn phí) qua cầu nối Apps Script; Gemini là dự phòng khi ddddocr đọc trượt. KHÔNG cần chạy tool trên máy tính. Bấm Kiểm tra để xem đang giải bằng engine nào; xem chi tiết luồng ở 🩺 Chẩn đoán bên dưới (có dòng "Engine giải captcha").

⚡ Ép dùng 1 mình ddddocr (test — tạm tắt Gemini)

🛰️ Tool đẩy giao dịch (loa-bridge.py — chạy trên laptop ở nhà/máy POS)
Tool đăng nhập loatingting bằng mạng nhà (không bị chặn, không quota Google) và đẩy giao dịch lên mỗi ~2 giây → POS xác nhận tiền gần như tức thì, không phụ thuộc cầu nối Apps Script. Tool tắt thì hệ thống tự quay về cầu nối cũ. Điền mã bảo mật GIỐNG với PUSH_SECRET trong file loa-bridge.py. Để trống = tắt nhận từ tool.

💳 Danh sách tài khoản nhận tiền của SĐT này

1 SĐT Loa TingTing có thể có nhiều STK MB. Khai báo từng tài khoản (số TK + tên hiển thị), rồi chọn tài khoản dùng để hiện QR. Việc dò giao dịch vẫn chung 1 đăng nhập nên không ảnh hưởng.

Tài khoản dùng để HIỆN QR (nhận tiền)

⚠️ Lưu ý quan trọng:
• Ở mục VietQR phía trên: chọn ngân hàng MB Bank và nhập STK MB của loa (số có chữ MB ở đầu) → QR sẽ động kèm mã đơn EMxxxxx.
• Hệ thống đăng nhập loatingting và giải captcha tự động bằng Gemini (cần đã cấu hình Gemini + Cầu nối Apps Script ở mục AI).
• Cookie phiên được tái dùng; chỉ giải captcha lại khi hết hạn. Cache ~18s để không gọi loatingting quá nhiều.
• Khớp theo đúng số tiền + mã đơn EMxxxxx trong nội dung. Khi khớp sẽ tự xác nhận & in bill.
• Mật khẩu loatingting vào được cả chức năng rút tiền → lưu phía máy chủ, không hiển thị lại, không backup ra Sheet. Để trống ô mật khẩu khi lưu nếu không đổi.

💳 Cấu hình ví điện tử 9Pay

Ưu tiên hiển thị 9Pay khi bán hàng

BẬT: khi bán hàng sẽ hiện mã QR 9Pay (nếu đã lưu). TẮT: bỏ qua 9Pay, dùng VietQR động (Loa TingTing tự xác nhận) — không cần xoá ảnh QR 9Pay.

Mã QR riêng của cửa hàng (ảnh) *

Chọn ảnh QR 9Pay được cấp riêng cho cửa hàng bạn (mỗi cửa hàng có mã QR khác nhau). Ảnh sẽ tự thu nhỏ về 400x400 trước khi lưu.

Xem trước mã QR 9Pay

Chưa có mã QR nào được lưu

💡 Lưu ý:
• 9Pay là ví điện tử - mỗi cửa hàng có mã QR riêng, không tự sinh được như VietQR
• Khách quét QR rồi nhập số tiền thủ công trong ứng dụng 9Pay
• Khi khách chọn thanh toán 9Pay tại POS, hệ thống sẽ hiện đúng mã QR cửa hàng của bạn
• Có thể xoá QR để quay về dùng VietQR mặc định cho phương thức QR

🧾 Hóa đơn điện tử - MISA meInvoice (máy tính tiền)

Kết nối meInvoice để xuất hóa đơn điện tử khởi tạo từ máy tính tiền (không cần chữ ký số) ngay sau khi thanh toán. Cần có AppID do MISA cấp và đã đăng ký ký hiệu hóa đơn MTT (vd: 1C26MMT) trên meInvoice.

Trạng thái

Môi trường Chạy thử trên TEST trước, ổn rồi mới chuyển CHÍNH THỨC

AppID (MISA cấp) *

Mã số thuế *

Tài khoản meInvoice *

Mật khẩu meInvoice *

Tên người bán THEO GIẤY PHÉP (hiển thị trên HĐ)

Hóa đơn THẬT do MISA hiển thị theo hồ sơ đăng ký thuế - điền đúng y như trên meInvoice để bản nháp xem trước giống thật

Địa chỉ THEO GIẤY PHÉP (hiển thị trên HĐ)

Mã địa điểm kinh doanh (nếu có)

👤 Tên hiển thị cho KHÁCH LẺ trên hóa đơn Ghi vào "Họ và tên người mua hàng" khi khách không cung cấp thông tin. Để trống = dùng mặc định như ghi mờ

💳 Tên hình thức thanh toán hiển thị trên hóa đơn

Đơn 💵 Tiền mặt →

Đơn 📱 QR/CK →

Đơn 💳 Quẹt thẻ →

Đơn 🔀 Hỗn hợp →

Để trống = dùng mặc định ghi mờ trong ô. Nên dùng đúng danh mục MISA: Tiền mặt, Chuyển khoản, TM/CK, Khác (giá trị lạ như "Thẻ" có thể bị meInvoice đưa về mặc định)

Ký hiệu hóa đơn MTT * Đúng ký hiệu đã đăng ký trên meInvoice (gồm cả số mẫu, vd 1C26MMT)

Thuế suất GTGT Giá bán trên POS được coi là giá đã gồm thuế - hệ thống tự tách tiền thuế. Ký hiệu bắt đầu bằng 2 (vd 2C26MYY = Hóa đơn bán hàng của hộ kinh doanh) sẽ tự bỏ phần thuế GTGT, không cần chọn ở đây

Tự động xuất HĐĐT sau thanh toán

Gửi email hóa đơn cho khách

⚙️ Quy tắc tự động xuất (chỉ áp dụng khi BẬT tự động - các điều kiện kết hợp kiểu VÀ)

1️⃣ Hình thức thanh toán được tự xuất

💵 Tiền mặt 📱 QR / Chuyển khoản 💳 Quẹt thẻ 🔀 Hỗn hợp

Bỏ tích hình thức nào thì bill hình thức đó KHÔNG tự xuất (vẫn xuất tay được)

2️⃣ Riêng TIỀN MẶT: chỉ tự xuất bill từ bao nhiêu trở xuống VD nhập 200000 -> bill tiền mặt ≤ 200.000đ mới tự xuất, bill to hơn để xuất tay

3️⃣ Giá trị bill TỪ (mọi hình thức)

3️⃣ Giá trị bill ĐẾN (mọi hình thức)

4️⃣ Khung giờ tự xuất - TỪ Để trống cả 2 = tự xuất cả ngày. Hỗ trợ khung qua đêm (vd 22:00 → 06:00)

4️⃣ Khung giờ tự xuất - ĐẾN

5️⃣ Chế độ chạy tự động

🏛️ Chế độ gửi cơ quan thuế (khi tự động) Chế độ DUYỆT TRƯỚC: bill chỉ nằm trong app, CHƯA gửi gì lên MISA/CQT cho tới khi bạn duyệt

🔔 Báo lỗi khi không kết nối được meInvoice Bill lỗi luôn được lưu vào 📋 Hàng chờ để xuất lại, không mất bill nào

📋 Sản phẩm GIỮ LẠI cho kế toán xuất tay (không tự gửi cơ quan thuế)

Đơn nào chứa sản phẩm khớp 1 trong 3 cách: ✔ được tích chọn đích danh, ✔ thuộc nhóm đã chọn, ✔ tên CHỨA từ khóa (không phân biệt hoa thường) → sẽ đưa vào 📋 Hàng chờ HĐĐT để kế toán rà soát và phát hành thủ công. Các đơn còn lại đủ điều kiện vẫn tự xuất bình thường. Để trống hết = tự xuất tất cả.

🔁 Tự động THAY THẾ sản phẩm bị giữ lại (để tự xuất ban đêm) Dùng khi nhân viên in bill gõ nhầm sản phẩm. Khi BẬT: bill chứa sản phẩm bị chặn sẽ được tự thay bằng sản phẩm đúng rồi tự xuất (không cần kế toán ngồi đêm). Hệ thống tự tính lại số lượng để khớp đúng số tiền đã thu — thành tiền giữ nguyên, đơn giá = giá sản phẩm thay thế.

⏱️ Lịch tự thay thế (ban ngày kế toán nghỉ vẫn không bị tồn bill qua đêm)

Tự thay thế sau khi đơn bị chặn: phút (0 = ngay lập tức)

Trong khoảng chờ này, kế toán có thể vào 📋 Hàng chờ HĐĐT xử lý tay trước. Quá hạn mà chưa ai xử lý → hệ thống tự thay thế & xuất. (Máy chủ quét ~10 phút/lần nên thời điểm thực tế có thể trễ thêm tới ~10 phút.)

Chỉ tự thay trong khung giờ: đến (để trống cả 2 = cả ngày)

Hỗ trợ khung qua đêm (vd 18:00 → 23:30). Dù ngoài khung giờ, nếu đang BẬT “Bắt buộc xuất trước nửa đêm” (mục chế độ TỨC THỜI ở trên) thì các bill chờ vẫn được tự thay & xuất sát nửa đêm để không qua ngày.

🅰️ Danh sách sản phẩm/nhóm thay thế CHUNG (đơn giản — khuyên dùng)

Bộ lọc đã tự chặn & báo sản phẩm nào → chỉ cần đưa danh sách hàng được phép thay vào. Hệ thống tự lấy 1 sản phẩm trong danh sách này thay cho BẤT KỲ sản phẩm bị chặn (ưu tiên sản phẩm cho ra số lượng nguyên đẹp), giữ đúng số tiền đã thu. Có thể ghi tên nhóm (lấy mọi sản phẩm trong nhóm) hoặc tên từng sản phẩm. Để trống = không dùng cách này.

🅱️ Quy tắc thay ĐÍCH DANH (tùy chọn — ưu tiên hơn 🅰️)

Khớp theo tên CHỨA từ khóa bên trái (không phân biệt hoa thường). Sản phẩm thay thế bên phải phải có trong danh mục (để lấy đúng giá). Quy tắc này ưu tiên hơn danh sách chung 🅰️. Nếu một sản phẩm bị chặn không khớp quy tắc nào ở đây thì sẽ tự lấy từ danh sách chung 🅰️. Không thay đổi số liệu kho khi thay thế
Mặc định (tích sẵn): chỉ sửa nội dung hóa đơn, KHÔNG đụng tới tồn kho (an toàn — vì số lượng thay thế thường lẻ theo tiền). Bỏ tích: khi thay sẽ cộng trả lại sản phẩm gõ nhầm và trừ sản phẩm thay thế tương ứng (chỉ dùng khi muốn kho khớp theo hàng đã thay).

🗂️ Tách dữ liệu đơn hàng theo quý

Khi bán nhiều (hàng trăm nghìn đơn/năm), 1 file Google Sheets sẽ đầy và chậm. Bật chế độ này để mỗi quý lưu vào 1 file riêng → luôn nhẹ, không lag. Báo cáo tổng vẫn nhanh nhờ tổng hợp ngày.

Chế độ tách quý

🤖 AI đọc phiếu giao hàng

🔑 Danh sách Gemini API Key — DÙNG CHO GIẢI CAPTCHA Loa TingTing (mỗi key 1 dòng) Lấy key miễn phí tại aistudio.google.com/apikey. Thêm nhiều key (mỗi key 1 dòng) → khi 1 key hết lượt, hệ thống tự chuyển key khác. Key này dành riêng cho giải captcha đăng nhập Loa TingTing (quan trọng cho khớp tiền tự động) — KHÔNG bị OCR dùng chung.

🔑 Gemini API Key RIÊNG cho OCR (đọc phiếu giao hàng + hóa đơn) — mỗi key 1 dòng Tách riêng để OCR không "ăn" hết quota key giải captcha → khớp tiền tự động không bị đình trệ. Để TRỐNG = OCR tạm dùng chung key ở trên (không khuyến nghị). Nên dùng key của tài khoản Google khác (quota tính theo tài khoản).

🎯 Model AI mặc định (phiếu in máy) Flash-Lite nhiều lượt nhất, đủ tốt cho phiếu in máy.

🔄 Tự động đổi model khi hết lượt BẬT: hết lượt Flash-Lite → tự thử Flash → Pro. Tận dụng tối đa quota miễn phí.

⚠️ Ngưỡng cảnh báo lệch giá nhập (%) Giá nhập trên phiếu lệch quá mức này so giá vốn cũ → cảnh báo. Mặc định 15%.

✍️ Model AI cho phiếu VIẾT TAY Khi tích "phiếu viết tay" lúc quét, ưu tiên model này.

🔊 Loa thông báo khi thanh toán

Bật loa thông báo

Kiểu thông báo

🌐 Ngôn ngữ đọc

💡 Lưu ý:
• Loa sử dụng Web Speech API có sẵn trên trình duyệt - không cần cài thêm gì
• Hỗ trợ 100+ ngôn ngữ - mặc định tiếng Việt, chọn ngôn ngữ khác ở ô bên phải
• Trình duyệt cần được phép phát âm thanh (lần đầu có thể cần click vào trang)
• Giọng đọc tùy thuộc trình duyệt/hệ điều hành - nếu máy chưa có giọng của ngôn ngữ đã chọn, hệ thống dùng giọng gần nhất
• Khuyến nghị bật để xác nhận thanh toán bằng âm thanh, tránh sai sót

🔐 Đổi mật khẩu của tôi

Mật khẩu cũ

Mật khẩu mới

Xác nhận

💡 Mỗi dòng là 1 sản phẩm mới. Chỉ Tên SP bắt buộc, các cột khác tùy chọn. Cột 🖼️ emoji tự động gán theo tên/nhóm SP (bấm vào để đổi nếu muốn). SKU/Barcode trùng sẽ bị bỏ qua và báo lại.

#	🖼️	Tên SP *	Nhóm	Barcode	ĐVT	Giá vốn	Giá bán	Tồn đầu	🥬 Giá động	🏢 NCC	🏷️ Alias NCC

🥬 Danh sách các mặt hàng giá động (rau củ/trái cây). Nhập giá bán mới cho hôm nay rồi bấm "Lưu tất cả". Chỉ những SP đã tick "Hàng giá động" mới hiện ở đây.

#	Sản phẩm	Nhóm	Giá vốn	Giá bán hiện tại	Giá bán mới	Giá vốn mới
Đang tải...

🤖 Danh sách SP đã gán Nhà cung cấp hoặc tên nhận dạng (alias) để AI đọc phiếu khớp đúng. Sửa trực tiếp rồi bấm 💾 ở từng dòng. Để trống = xoá.

Sản phẩm	🏢 Nhà cung cấp	🏷️ Tên nhận dạng (alias)
Đang tải...

Sửa trực tiếp 0 sản phẩm đã chọn trong bảng dưới. Mỗi dòng là 1 SP với giá trị riêng — sửa xong bấm "Lưu tất cả" 1 lần. Tên/Barcode/SKU sửa được riêng từng dòng.

#	Tên SP *	Nhóm	Barcode	SKU	ĐVT	Giá vốn	Giá bán	Tồn	Định mức	🥬	🏢 NCC	🏷️ Alias NCC	Trạng thái

Loại giao dịch

⏰ Thời gian thực nhập (hàng về lúc nào)

Thêm sản phẩm vào danh sách

#	Sản phẩm	Tồn hiện tại	📦 Số thùng	Số đv/thùng	SL nhập	💰 Giá nhập	🏷️ Giá bán mới
Chưa có SP nào. Tìm và chọn SP ở trên để thêm.

🏢 Nhà cung cấp của lô này (tùy chọn - giúp AI đọc phiếu lần sau)

Tên NCC sẽ được gán cho tất cả SP trong lô này để AI nhận dạng phiếu của NCC đó.

Ghi chú chung (áp dụng cho cả lô)

💡 Nhập số lượng thực tế đếm được của từng SP. Hệ thống tự tính chênh lệch so với tồn phần mềm. Sau khi lưu, tồn kho được cập nhật về số thực tế + ghi nhật ký hao hụt.

⏰ Thời điểm kiểm kê

Thêm sản phẩm cần kiểm

#	Sản phẩm	Hệ thống	Thực tế đếm	Chênh lệch
Chưa có SP nào. Thêm SP ở trên hoặc bấm "Thêm tất cả SP".

Ghi chú đợt kiểm kê

⚠️ Sửa đơn đã bán sẽ điều chỉnh tồn kho theo chênh lệch số lượng và ghi nhật ký. Cân nhắc kỹ trước khi lưu.

Khách hàng

Ghi chú

Các mặt hàng trong đơn:

Mặt hàng	Số lượng	Đơn giá	Thành tiền

Tổng tiền mới: 0

💳 Thanh toán

Chọn nhanh:

Hoặc nhập số tiền từng phương thức (hỗn hợp):

💵 Tiền mặt

📱 QR (gồm cả chuyển khoản)

💳 Quẹt thẻ

Tổng đã nhập: 0 / Cần thu: 0

Không thay đổi số liệu kho
Mặc định (bỏ tích): thêm/bớt/sửa mặt hàng SẼ cộng trả về kho hoặc trừ kho tương ứng. Tích ô này: chỉ sửa nội dung đơn, KHÔNG đụng tới tồn kho (dùng khi kho thực tế đã đúng, chỉ chỉnh lại bill).