Tab "📊 CPQ — Lịch thanh toán"

Tab ”📊 CPQ — Lịch thanh toán”

Tab này nằm trên form Báo giá (Sale Order) và Hợp đồng (Zone Contract) — hiển thị lịch thanh toán chi tiết auto-refresh từ billing_item_ids.

Đặc điểm

• Auto-refresh khi Đại edit billing items → lịch cập nhật ngay
• Combined view: recurring + one-time trong 1 bảng
• Sortable + filterable theo Ngày, Loại, Trạng thái
• Nút ”🧮 Sinh lịch” mở wizard
• Nút “⬇️ Xuất Excel” + “🖨️ In PDF”

Structure cột

Cột	Ý nghĩa
#	Số thứ tự
Ngày dự kiến	Ngày phát sinh
Mô tả	Loại phí (thuê, QL, kết nối…)
Recurring	Số tiền recurring monthly-equivalent
One-time	Số tiền one-time (nếu có milestone tại tháng đó)
Tổng chưa VAT	Recurring + One-time
VAT	10% mặc định (theo billing_item.tax_id)
Có VAT	Grand total
Trạng thái	Dự kiến / Đã sinh HĐ / Đã post / Đã paid
Invoice ref	Số hoá đơn nếu đã sinh (link click mở HĐ)

Trạng thái từng dòng

State	Ý nghĩa	Màu
Dự kiến	Chưa đến hạn, chưa sinh HĐ	Xám
Đã sinh HĐ	Cron đã tạo Invoice draft, chờ FC post	Vàng
Đã post	HĐ posted, đang chờ KH thanh toán	Xanh dương
Đã paid	KH đã trả đủ	Xanh lá
Quá hạn	Đã post, quá hạn 3+ ngày chưa trả	Đỏ

Cách dùng

1. Mở SO / HĐ

Menu Bán hàng → Hợp đồng hoặc Bán hàng → Báo giá → click 1 record

2. Click tab ”📊 CPQ — Lịch thanh toán”

Tab thứ 3-4 trên notebook (sau General + Order Lines).

3. Verify lịch

• Row count = duration_months (nếu monthly only)
• One-time rows highlight bold
• Grand total ở footer = header total_amount

4. Filter (nếu HĐ dài)

• Dropdown “Trạng thái” → chọn “Đã sinh HĐ” → chỉ show rows đã có Invoice
• Search bar → gõ số tháng vd “T8/2026”

5. Click vào row đã có Invoice

• Cột “Invoice ref” → link nhảy sang Invoice detail
• Xem trạng thái post, payment, KH đã trả bao nhiêu

Nút thao tác header tab

Nút	Chức năng
🧮 Sinh lịch	Regen wizard xem chi tiết
⬇️ Xuất Excel	Download .xlsx với full data
🖨️ In PDF	Render PDF qua Doc Engine (branded)
🔄 Refresh	Force recompute từ billing_items (rare — thường auto)
➕ Thêm dòng manual	Insert 1 dòng ad-hoc không từ billing_item (vd phí phát sinh 1 lần)

Sync với billing_items

Đổi billing_item → lịch tự update

Khi Đại sửa billing_item_ids (thêm/xóa dòng, đổi cadence, đổi amount) → tab “Lịch thanh toán” tự refresh.

Ngoại lệ: nếu HĐ đã state=active, billing_items bị lock. Muốn đổi cần dùng Phụ lục (Amendment).

Sync với invoices đã sinh

Khi cron sinh Invoice từ billing_item recurring:

• Row tương ứng update state = “Đã sinh HĐ”
• Cột “Invoice ref” show số HĐ (link)
• Nếu Invoice bị xoá / cancel → row rollback về “Dự kiến”

Manual add row

Trường hợp đặc biệt — vd KH bị phạt vi phạm điều khoản → add 1 dòng phí phát sinh:

1. Click ”➕ Thêm dòng manual”
2. Điền:
   • Ngày phát sinh
   • Mô tả
   • Amount + tax
3. Save

Dòng này KHÔNG link với billing_item → không auto-refresh. FC phải sinh Invoice riêng cho nó (xem Sinh HĐ manual).

FAQ

Tab không hiện dữ liệu

• Verify HĐ có billing_items (tab “Chi tiết đơn hàng”)
• Click 🔄 Refresh thủ công
• Nếu vẫn empty → check log Odoo có error compute không (Admin task)

Tổng cột “Có VAT” ≠ tổng cột trong tab CPQ

Rounding — cadence normalization có thể chênh vài đồng do làm tròn per-row. Chấp nhận được.

KH yêu cầu đổi lịch giữa chừng

HĐ đã active → billing_items lock. Tạo Phụ lục modify cadence hoặc split.

Muốn xuất PDF không có VAT (KH FDI export)

• Cấu hình Fiscal Position “Export” cho KH FDI → VAT = 0%
• Regen lịch → cột VAT = 0
• Xuất PDF

Liên kết liên quan

• Wizard Sinh lịch
• Milestone editor
• Sinh HĐ recurring
• Hợp đồng