HP · UC-HP-03
UC-HP-03 — Phieu thu / thanh toan / hoa don
Phieu thu / thanh toan / hoa don. This UC owns tuition/receivable/payment data and only reads SMS/QLSV/SRM/QLTS as integration context.
Nguồn: docs/modules/hp/use-cases/UC-HP-03.md · Sample data (fake VN)
S1 · Student payment ledger
Student payment ledger
API: `GET /api/v1/hp/students/{studentId}/payments?termCode={NHHK}` · DB: `MPTHU.IDPThu`, `NHHK`, `IDSV`, `NgayTChi`, `SoCTu`, `TienPT`, `GHICHUPT`, `QUYENSO`, `THUNH`, `IDNH`, `NHHKThuHP`, `IDNhCT`, `LoaiCTu`, `NguonDongHP`, `HUYPT`,
S3 · Import invoice / invoice issue
Import invoice / invoice issue
API: `POST /api/v1/hp/payments/receipts/import` · DB: `MINVOICE.IDInvoice`, `NHHK`, `IDSV`, `Lan`, `IDNhCT`, `SoInvoice`, `IDPThu`, `IsLockIV`, `IsHuyInvoice`, `IsInInvocie`, `SoPhieuBaoEduBill`; `MInVoiceCT.IDInVo
S4 · Allocate existing receipt to receivables
Allocate existing receipt to receivables
API: `POST /api/v1/hp/payments/{receiptId}/allocate` · DB: `MPTHUCT.IDPTHUCT`, `IDPThu`, `IDHPCT`, `TienPTCT`, `HuyPTCT`, `TienCTBienLai`, `IsInBienLai`, `NoiDungCTHC`, `IsPhanBo`, `NgayPhanBo` plus `MHPCT.IDHPCT`, `Pha
S5 · EduBill / online payment staging
EduBill / online payment staging
API: No dedicated callback endpoint in current OpenAPI; smoke through `POST /payments/receipts/import` and idempotency checks · DB: `MPTHUEduBill.IDPTEduBill`, `IDSV`, `IDNhCT`, `NHHK`, `SoCTu`, `TongThu`, `PhaiThu`, `TrangThaiPhieu`, `NguonDongHP`, `TransIDEduBill`, `SoInvoice`; `MPTHUEduBi