# Xuất hóa đơn
| 1 - Xuất Thủ công trên app/ bán tự động | 2- Xuất hóa đơn Tự động | 3 - API Xuất hóa đơn tự động | | -------------------------------------------- | ----------------------- | ---------------------------- | | | | | ### ⚙️ II. Mục tiêu hệ thống Mục tiêu của hệ thống: 1. Tự động hoá hoàn toàn quy trình xuất hoá đơn khi có giao dịch thanh toán về. 2. Linh hoạt theo từng loại mô hình kinh doanh (bán hàng, dịch vụ, cho thuê, học phí, nạp tiền, đại lý, v.v.). 3. Đảm bảo xuất hoá đơn trong ngày kể cả khi khách hàng chưa gửi đủ thông tin, nhờ cơ chế “hoá đơn tạm” hoặc “tự động xuất theo cấu hình”. 4. Giảm rủi ro sai phạm thuế và đảm bảo hồ sơ kế toán nhất quán. *** ### 🧩 III. Thiết lập cấu hình hệ thống #### 1️⃣ Màn hình cấu hình “Tự động xuất hoá đơn theo tài khoản nhận tiền” Giao diện gồm các phần chính:
Nhóm cấu hìnhMô tảTuỳ chọn/Trường nhập
1. Tài khoản ngân hàng nhận thanh toánChọn tài khoản áp dụng quy tắcDropdown chọn tài khoản doanh nghiệp
2. Nguồn giao dịch áp dụngGiao dịch VietQR, API, hoặc thu tiền mặtCheckbox đa lựa chọn
3. Thời điểm xuất hoá đơnXác định khi nào hoá đơn được tự động xuất- Ngay khi nhận tiền- Cuối ngày 23:00- Sau X phút không có phản hồi từ khách
4. Quy tắc xuất hoá đơn mặc địnhTrong trường hợp khách chưa cung cấp thông tin- Sử dụng thông tin doanh nghiệp mặc định- Dùng mẫu “Khách lẻ” hoặc “Không có MST”
5. Danh mục sản phẩm/dịch vụ mặc địnhSản phẩm gán tự động khi không có chi tiết đơn hàngDropdown chọn sản phẩm từ danh mục (VD: “Thanh toán dịch vụ VietQR Business”)
6. Chính sách xử lý ngoại lệTrường hợp số tiền thanh toán không khớp- Cảnh báo và chờ xác nhận thủ công- Tự động điều chỉnh theo cấu hình
7. Ký số & phát hành hóa đơnTự động gửi HSM để ký hóa đơnToggle bật/tắt “Ký số tự động”
8. Gửi hóa đơn cho khách hàngCấu hình gửi email/Zalo/Telegram- Checkbox “Gửi hóa đơn tự động cho khách hàng”- Trường nhập mẫu tin nhắn
9. Nhật ký hoạt độngLưu lại log xuất hóa đơnDanh sách giao dịch + trạng thái hóa đơn
*** ### 🖥️ IV. Giao diện (UI) Phần A. Tổng quan cấu hình ``` ┌────────────────────────────────────────────────────┐ │ Cấu hình xuất hoá đơn tự động │ ├────────────────────────────────────────────────────┤ │ [Chọn tài khoản nhận tiền] ▼ │ │ [□] Áp dụng cho giao dịch VietQR │ │ [□] Áp dụng cho giao dịch API │ │ [□] Áp dụng cho thanh toán tiền mặt │ ├────────────────────────────────────────────────────┤ │ Thời điểm xuất hoá đơn: [Ngay khi nhận tiền ▼] │ │ Nếu sau 60 phút không có phản hồi, tự động xuất │ ├────────────────────────────────────────────────────┤ │ Sản phẩm mặc định: [Gói VietQR Business ▼] │ │ Thông tin hoá đơn mặc định: [Khách lẻ - không MST] │ ├────────────────────────────────────────────────────┤ │ [✔] Tự động ký số & phát hành │ │ [✔] Gửi hóa đơn qua email/Zalo cho khách │ ├────────────────────────────────────────────────────┤ │ [Lưu cấu hình] [Kiểm tra hoạt động] │ └────────────────────────────────────────────────────┘ ``` Phần B. Nhật ký hoạt động ``` ┌──────────────────────────────────────────────────────┐ │ NHẬT KÝ XUẤT HÓA ĐƠN TỰ ĐỘNG │ ├──────────────────────────────────────────────────────┤ │ 2025-10-05 | 09:22 | MB | 1.100.000đ | ĐÃ XUẤT | │ 2025-10-05 | 10:01 | BIDV | 550.000đ | CHỜ KHÁCH | │ 2025-10-05 | 10:15 | MB | 220.000đ | ĐÃ KÝ SỐ │ └──────────────────────────────────────────────────────┘ ``` *** ### 🔄 V. Cơ chế hoạt động tổng quát 1. Nhận giao dịch → xác thực nguồn tiền → phân luồng theo tài khoản. 2. Áp dụng cấu hình xuất hoá đơn tương ứng: * Nếu có thông tin khách hàng: xuất hoá đơn đầy đủ. * Nếu không có: dùng cấu hình mặc định (hoặc mẫu “Khách lẻ”). 3. Tự động gửi yêu cầu ký HSM → phát hành → gửi khách hàng. 4. Lưu lại log (thời gian, người ký, trạng thái gửi, mã tra cứu). *** ### ✅ VI. Lợi ích * Đảm bảo tuân thủ Nghị định 123/2020/NĐ-CP và Nghị định 125/2020/NĐ-CP. * Giảm rủi ro phạt thuế do chậm xuất hóa đơn. * Tăng tốc quy trình kế toán và minh bạch dòng tiền. * Phù hợp cho nhiều mô hình kinh doanh: bán hàng, đại lý, thuê dịch vụ, học phí, vending, QR Box, PayBox, VoiceBox, v.v.