PRD: Kê khai Thuế dải 1-3 tỷ
| Module | Thuế & Hóa đơn (CORE-10) | PRD ID | PRD-DCL-001 |
| Trạng thái | Planned | Owner | Việt Võ · Phát Nguyễn |
| Ngày | 2026-06-11 | Phiên bản | v0.1 (draft) |
| Packages | @nx/ledger · @nx/taxation · apps/client | URD | DCL |
| Epic | BANA-1318 | Khung thời gian | T7 (lõi) · T8 (T-VAN e2e) |
TL;DR
Hộ kinh doanh 1-3 tỷ nộp thuế ngay trong KICKO: sổ S2a từ doanh thu thật, TNCN tính theo thuế suất ngành, tờ khai 01/CNKD chuẩn được sinh, nộp qua T-VAN, theo dõi tới khi CQT xác nhận. Không cần kế toán.
1. Bối cảnh & Vấn đề
Engine sổ sách đi xa hơn board tưởng: S1a và S2a đều sinh từ doanh thu thật kèm xuất PDF/XLSX. Thiếu là toàn bộ đoạn từ sổ tới cơ quan thuế: thuế suất đang seed cứng theo nhóm và merchant tự chọn tay (chưa map theo ngành), tờ khai 01/CNKD chưa tồn tại, và tích hợp T-VAN chỉ tra cứu - chưa nộp được. Màn client dừng ở xem/tải sổ.
2. Mục tiêu & Loại trừ
Mục tiêu - kiểm chứng S2a trên dữ liệu thật (URD-DCL-001) · mapping ngành → thuế suất (002) · tính TNCN (003) · sinh 01/CNKD PDF/XML (004) · nộp T-VAN + trạng thái tới xác nhận (005) · màn khai thuế client (006) · lịch sử nộp (007).
Loại trừ - sổ S2b-e và dải 3-50 tỷ (Giai đoạn 3) · VAT khấu trừ/TNDN doanh nghiệp (Giai đoạn 3) · thay đổi phát hành HĐĐT (đường đã ship).
3. Thước đo thành công
| Thước đo | Mục tiêu |
|---|---|
| Trọn một kỳ thuế end-to-end | Merchant 1-3 tỷ thật nộp và được CQT xác nhận (T8) |
4. Persona & Tình huống
Chủ hộ kinh doanh (không kế toán; nộp theo quý/tháng) · CQT qua T-VAN.
5. User Story
- Là chủ hộ, tôi mở màn thuế, xem sổ S2a, preview 01/CNKD, và nộp - xong trong vài phút.
- Là chủ hộ, thuế suất đi theo ngành của tôi; tôi không phải tự chọn phần trăm.
6. Yêu cầu chức năng
Giao URD DCL URD-DCL-001…007 (Must 001-006).
7. Yêu cầu phi chức năng
- Hồ sơ bất biến sau khi nộp; mọi lần nộp audit được theo kỳ.
8. UX & Luồng
- Màn thuế: chọn kỳ → xem S2a (drill xuống đơn) → "Lập 01/CNKD".
- Preview tờ khai (PDF) → xác nhận → nộp qua T-VAN → chip trạng thái (đã nộp → đã xác nhận).
- Lịch sử: các kỳ trước với hồ sơ và trạng thái.
9. Dữ liệu & Miền nghiệp vụ
- Tái dùng pipeline ledger đang chạy (fetcher S2a + template + export).
- Mới: mapping ngành→thuế suất (config), tính TNCN, template 01/CNKD (PDF/XML), thao tác nộp T-VAN + poll trạng thái.
10. Phụ thuộc & Giả định
| Phụ thuộc | Vì sao |
|---|---|
| Credential/spec nộp T-VAN (VNPAY) | Chân nộp là bên thứ ba |
| Loại hình đúng (E2) | Ngành quyết định thuế suất |
11. Rủi ro & Câu hỏi mở
- Spec nộp T-VAN là rủi ro tiến độ - đòi credential ngay trong T6.
- Đổi ngành giữa kỳ: áp suất nào? (đề xuất: suất tại thời điểm chốt kỳ).
12. Kế hoạch phát hành & Tiêu chí
T7: thuế suất + TNCN + 01/CNKD + màn hình. T8: nộp T-VAN + trọn một kỳ thật e2e. Ra mắt: AC-DCL-01 pass với merchant thật.
13. FAQ
- Có xây lại S2a không? Không - nó chạy rồi; chỉ kiểm chứng dữ liệu thật và nối vào luồng nộp.
Tham chiếu
URD DCL · Giai đoạn 2 - Theo tháng · Epic BANA-1318 · Chính sách thuế