| Method | Path | Request / response | Status |
|---|
| GET/POST/PUT/DELETE | /v3/teacher/school-finance/course/courses[...] | thông tin cơ bản của khoá học | existing |
| GET/POST/PATCH | /v3/school/fee-plans[/{id}] | lọc theo course_id | new |
| GET | /v3/teacher/school-finance/tuitions | bộ lọc như hiện tại, cộng thêm fee_plan_type, status gồm cả PARTIAL, aging_bucket | extend |
| POST | /v3/teacher/school-finance/tuitions | như hiện tại, cộng thêm lines[], discount_amount, discount_reason, voucher_code, instalments[] → 202 PENDING_APPROVAL khi vượt hạn mức | extend |
| GET | /v3/teacher/school-finance/tuitions/{id} | + lines, credit_notes, reminders, einvoice, package | extend |
| POST | /v3/teacher/school-finance/tuitions/{id}/pay | {amount, method CASH|BANK_TRANSFER|CARD, account_id, payer_name, paid_at?, note, send_receipt} → khoản thanh toán kèm receipt_no, pdf | extend |
| POST | /v3/school/payments/{id}/void | {reason} | new |
| GET | /v3/school/payments/{id}/receipt.pdf | đường dẫn đã ký (signed URL) | new |
| POST | /v3/school/tuitions/{id}/approve | /reject | {note} | new |
| POST | /v3/school/tuitions/{id}/void | {reason}; chỉ khi chưa có thanh toán hợp lệ nào | new |
| POST | /v3/teacher/school-finance/tuitions/{id}/notify, /tuitions/notify | nhắc học phí; bổ sung template_id | extend |
| GET/POST | /v3/teacher/school-finance/group-invoices | bổ sung POST với {title, month, class_ids[], fee_plan_id?, prorate: bool, notify: {app, zalo, email}, dry_run} | extend |
| GET | /v3/school/debt | school_id, bucket, class_id, q → số liệu tổng hợp theo từng học viên | new |
| POST | /v3/school/tuitions/{id}/payment-plan | {parts: [{amount, due_date}]} | new |
| GET | /v3/school/students/{id}/packages | danh sách gói buổi kèm lịch sử tiêu thụ | new |
| POST | /v3/school/packages/{id}/adjust | {sessions_delta, reason} cộng/trừ buổi thủ công (cần phê duyệt) | new |
| POST | /v3/school/tuitions/{id}/credit-notes | {amount, reason} → phiếu giảm (cần phê duyệt nếu vượt ngưỡng) | new |
| POST | /v3/school/credit-notes/{id}/refund | {amount, method, account_id, paid_to} | new |
| GET | /v3/school/refund-estimate?student_id= | đề xuất tính theo chính sách | new |
| GET/POST/PATCH | /v3/school/expenses[/{id}]; POST /approve | | new |
| GET/POST | /v3/school/expense-categories | | new |
| GET | /v3/school/cashbook | school_id, account_id, from, to, type, category → danh sách; format=xlsx | new |
| GET/POST | /v3/school/cash-accounts; POST /v3/school/cash-accounts/{id}/close | {date, counted, note} | new |
| GET/POST | /v3/school/unmatched-transactions; POST /{id}/match | {tuition_id | student_id (ghi vào số dư)} | new |
| GET/POST/PATCH | /v3/school/voucher-groups, /vouchers; POST /vouchers/validate | {code, student_id, course_id, amount} → giá trị giảm hoặc lỗi | new |
| POST | /v3/school/tuitions/{id}/einvoice | {buyer: {name, tax_id?, address, email}} → kết quả từ nhà cung cấp | new |
| GET | /v3/school/finance/report | school_id, from, to, group_by → billed, collected, outstanding, overdue, refunds, expenses, deferred; series | new |
| GET/POST/PUT/DELETE | /v3/teacher/school-finance/bank-accounts[...], /company, /link-token | không thay đổi | existing |
| POST | /v3/payment/qr | không thay đổi | existing |
| GET | /v3/parent/tuitions, /{id}, /overview | giao diện phụ huynh; bổ sung phiếu thu và số dư gói buổi | extend |
