Quản lý Hợp đồng

HĐ nhà thầu tracks: scope BOQ + lịch thanh toán + nghiệm thu + bảo lãnh NH + phụ lục.

6.1 Tổng quan model

rp.contract (HĐ nhà thầu)
  ├── rp.contract.line (BOQ lines)
  ├── rp.contract.payment.milestone (Lịch thanh toán)
  │     └── account.move (Hóa đơn auto-gen)
  ├── rp.contract.amendment (Phụ lục)
  └── re.bank.guarantee (Bảo lãnh NH link)

rp.progress.acceptance (BBN nghiệm thu)
  ├── rp.progress.acceptance.line (Dòng KL nghiệm thu)
  └── milestone → trigger create invoice

6.2 Tạo HĐ từ awarded bidder

Sau khi package state = awarded → click “Tạo HĐ” → rp.contract tự tạo:

Field	Auto-fill
Mã HĐ	PKG-MEP-001-HD (từ package code + suffix)
Bên A	Công ty mẹ (company chính)
Bên B	NT-A Cty CP Xây dựng A
Giá trị HĐ	24.500.000.000 ₫ (từ bid awarded)
Project	KĐT nghỉ dưỡng Dalat
Thời hạn	12 tháng từ ngày ký

6.3 BOQ lines

Tab “BOQ” — 5 dòng BOQ với:

Mô tả	KL	Đơn vị	Đơn giá	Thuế	Thành tiền
Lắp đặt hệ điện chính Tower S1	1	gói	18.000.000.000	VAT 10%	19.800.000.000
Lắp đặt hệ điện S1-PT	1	gói	7.000.000.000	VAT 10%	7.700.000.000
…

Σ thành tiền = giá trị HĐ + VAT.

6.4 Milestones (Lịch thanh toán)

Tab “Lịch thanh toán” — 3 mốc theo % giá trị HĐ:

Mốc	%	Số tiền	Due date	State
Tạm ứng 20%	20%	4.900.000.000 ₫	T+10 ngày từ ký	invoiced / paid
Giữa kỳ 50%	50%	12.250.000.000 ₫	Sau nghiệm thu 50%	planned
Cuối kỳ 30%	30%	7.350.000.000 ₫	Sau bàn giao	planned

State milestone: planned → invoiced → paid.

6.5 Amendments (Phụ lục)

Tab “Phụ lục” — track thay đổi sau khi ký:

Số PL	Type	Date	Mô tả	Giá trị tăng/giảm
PL-01	scope	2026-06-10	Bổ sung khối lượng PCCC theo yêu cầu PCCC tỉnh	+850.000.000 ₫

4 loại amendment:

• scope — bổ sung / giảm KL
• schedule — gia hạn thời gian
• price — đổi đơn giá (do tăng giá VL)
• terms — đổi điều khoản (thanh toán / bảo hành)

6.6 Bảo lãnh NH

Tab “Bảo lãnh” — link tới re.bank.guarantee:

Loại	NH phát hành	Số tiền	Hiệu lực
BL tạm ứng	Vietcombank	4.900.000.000 ₫	Đến khi khấu trừ hết
BL thực hiện HĐ	Vietcombank	1.225.000.000 ₫ (5%)	Đến khi nghiệm thu cuối
BL bảo hành	Vietcombank	490.000.000 ₫ (2%)	24 tháng sau bàn giao

6.7 BBN nghiệm thu

Khi tới mốc thanh toán → click “Tạo BBN” trên milestone → rp.progress.acceptance auto-create:

Field	Demo
Số BBN	BBNT-2026/06-PKG-MEP-001-HD-001
Ngày	2026-06-15
Người duyệt	PTDA + KT trưởng + GĐ
State	draft → proposed → approved

BBN lines (2 dòng nghiệm thu)

Hạng mục	Mô tả	KL kỳ này	Lũy kế	Đơn giá	Giá trị
Tower S1	Lắp đặt hệ điện chính 40%	0.4	0.4	18.000.000.000	7.200.000.000
S1-PT	Phần thân MEP 30%	0.3	0.3	7.000.000.000	2.100.000.000

6.8 Invoice từ milestone

Sau khi BBN approved → click “Tạo Hóa đơn” trên milestone → account.move (vendor bill) auto-create:

Field	Auto-fill
Loại	Vendor bill (in_invoice)
Nhà cung cấp	NT-A Cty CP Xây dựng A
Số HĐ tham chiếu	PKG-MEP-001-HD
Milestone	Giữa kỳ 50%
Số tiền	12.250.000.000 ₫ (= 50% giá trị HĐ)
Thuế	VAT 10% áp dụng vào BOQ tương ứng
State	draft (KT validate → posted)

Sau khi post → tích hợp vào hệ thống kế toán tổng + journal entries tự tạo (TT 200/2014/TT-BTC).

6.9 Smoke test

1. Awarded package PKG-MEP-001 → click Tạo HĐ
   ✓ rp.contract tự tạo PKG-MEP-001-HD
2. Add 5 BOQ lines + 3 milestones + 1 amendment
3. Milestone "Giữa kỳ 50%" → click Tạo BBN
   ✓ BBN-2026/... draft với 2 lines KL
4. State BBN: draft → proposed → approved
5. Approved → click Tạo Hóa đơn
   ✓ Vendor bill draft tạo
6. Validate hóa đơn → state = posted
   ✓ Journal entries tạo theo TT 200

---

Tiếp: Tiến độ thực hiện →