Tạo Khách hàng

Tạo Khách hàng

Khách hàng = công ty thuê đất / kho trong KCN. Trong Parkone, KH là res.partner với flag x_is_tenant=True + đầy đủ thông tin pháp lý để render HĐ.

Hai loại KH chính

• FDI (Foreign Direct Investment) — công ty 100% vốn nước ngoài hoặc liên doanh, thường thuê đất / RBF
• DDI (Domestic Direct Investment) — công ty Việt Nam, thuê đất hoặc kho

Phân loại này ảnh hưởng Lease Policy áp dụng (giá thuê khác nhau cho FDI vs DDI).

Cấu trúc res.partner KH

Công ty TNHH Hoa Biết (parent — is_company=True)
├── x_company_type: DDI
├── vat: 12545522
├── x_legal_representative: Cao Thuỳ Dương
├── x_legal_rep_position: Giám đốc
├── street: 122 Nguyễn Bỉnh Khiêm
├── city: TP HCM
├── x_fax: +84 28 1234 5678
├── x_bank_acc_us: 9988776655
├── x_swift_code: BFTVVNVX001
└── children (contacts):
    ├── Cao Thuỳ Dương (GD KD)
    ├── Nguyễn Văn B (Kế toán)
    └── Phạm Thị C (Liên hệ kỹ thuật)

Parent record là pháp nhân (dùng cho HĐ). Children là contacts (cá nhân liên hệ).

Tạo Khách hàng mới

Bước 1. Mở list KH

Bán hàng → Khách hàng → Mới

Hoặc Liên hệ → Liên hệ → Mới.

📸 Screenshot: form Khách hàng mới với 2 radio Người / Công ty

Bước 2. Chọn loại

Radio button trên cùng:

• Người (individual)
• Công ty (is_company=True)

→ Chọn Công ty (KH KCN luôn là pháp nhân).

Bước 3. Thông tin cơ bản

Field	Vd	Ghi chú
Tên	Công ty TNHH Hoa Biết	Theo Giấy ĐKKD
Logo	(upload)	Optional
Tags	VIP, FDI, Strategic	Multi-select — phân loại tự do

Bước 4. Liên hệ

Field	Vd
Email	info@hoabiet.vn
Phone	+84 28 9876 5432
Mobile	+84 90 1234 567
Website	https://hoabiet.vn

Bước 5. Địa chỉ

Field	Vd
Đường	122 Nguyễn Bỉnh Khiêm
Đường 2	(optional)
Phường / Xã	Phường Xuân Hoà
Thành phố	TP HCM
State	TP Hồ Chí Minh
Mã ZIP	700000
Quốc gia	Việt Nam

Tab “Khu công nghiệp” — Pháp lý

Sau khi save thông tin cơ bản, mở tab “Khu công nghiệp” — quan trọng nhất cho HĐ.

Section “Phân loại công ty”

Field	Vd
Loại hình đầu tư	DDI (hoặc FDI / Joint Venture / Individual)
Ngành sản xuất	Electronics & Semiconductors
Tập đoàn mẹ	(nếu là subsidiary, vd “Hoa Biết Group”)
Quốc gia xuất xứ	Vietnam (nếu FDI thì khác)
Là khách thuê KCN	✅ (tick để Parkone biết đây là tenant)

Section “Thông tin pháp lý”

Đây là phần bắt buộc cho HĐ render đúng:

Field	Vd	Ghi chú
Mã số thuế (MST)	12545522	10 hoặc 13 số. Bắt buộc cho HĐ + hoá đơn VAT
Số giấy phép kinh doanh	0123456789	Optional nhưng nên có
Ngày cấp giấy phép	1/1/2010	Optional
Người đại diện pháp luật	Cao Thuỳ Dương	Bắt buộc — ký HĐ
Chức vụ người đại diện	Giám đốc	Bắt buộc — chức danh ký HĐ
Fax	+84 28 1234 5678	Optional
TK ngân hàng (US)	9988776655	Optional — text trực tiếp cho nhanh
Swift Code	BFTVVNVX001	Optional

Section “Đầu tư”

Áp dụng cho FDI / có giấy phép đầu tư:

Field	Vd
Số IRC (Investment Registration Certificate)	INV-LA-2022-001
Ngày cấp IRC	1/3/2022
Vốn đầu tư (USD/VND)	5.000.000 USD

Section “Lực lượng lao động”

Field	Vd
Quy mô lao động	200

Bank Accounts (TK ngân hàng)

Tab “Hoá đơn” → section “Tài khoản ngân hàng”.

Thêm TK VND

1. Click “Add a line”
2. Điền form:
   • Account Number: vd 6155526
   • Bank: chọn / tạo (vd “Ngân hàng Đầu tư và Phát triển Việt Nam — CN HCM”)
   • Currency: VND (quan trọng cho placeholder bank_acc_vnd_id filter)
3. Save

Thêm TK USD (nếu có)

Tương tự VND nhưng Currency = USD.

Hoặc text field nhanh

Đại có thể skip phần Bank Account record, dùng text field thay:

• Tab Khu công nghiệp → field “TK ngân hàng (US)” → gõ text: 9988776655 - HSBC Vietnam

Placeholder {{ record.customer_id.x_bank_acc_us }} lấy text này.

Tạo Contacts (Người liên hệ)

KH là pháp nhân — Đại lưu các cá nhân liên hệ dưới dạng children.

1. Trong form KH → tab “Liên hệ và địa chỉ” → click “Add”

2. Form Contact mở ra:

   • Tên: vd “Cao Thuỳ Dương”
   • Vị trí: GD KD
   • Email: thuyduong@hoabiet.vn
   • Phone: +84 98 777 65 43
   • Loại:
     • Liên hệ (Contact)
     • Địa chỉ giao hàng (Delivery)
     • Địa chỉ thanh toán (Invoice)
     • Vị trí khác (Other)

3. Save

Contact xuất hiện như child partner của Công ty. Vẫn có id partner riêng nhưng parent_id trỏ về Công ty.

Khi nào cần nhiều contacts?

• Giám đốc — ký HĐ
• Kế toán — nhận hoá đơn
• Liên hệ kỹ thuật — nhận thông báo bảo trì
• Đại diện onsite — nhân viên ở KCN

Mỗi contact có email + phone riêng → Parkone gửi email tự động đúng người.

Bulk import KH qua Excel

Khi cần import nhiều KH (>20), dùng Excel:

1. Liên hệ → menu ⚙️ → Import records

2. Tải template Excel với các cột:

   • Name
   • Email
   • Phone
   • Street
   • City
   • VAT
   • x_company_type
   • x_legal_representative
   • x_legal_rep_position
   • is_company (TRUE/FALSE)
   • parent_id (External ID nếu là contact con)
   • …

3. Điền Excel, save

4. Upload → Parkone test import, hiển thị preview

5. Review errors → sửa Excel → re-import

6. Confirm import → records được tạo

Kiểm tra KH đã setup đúng

Test render HĐ

1. Tạo 1 Hợp đồng test với KH này
2. Mở Doc Template (vd “HĐ thuê đất chuẩn”)
3. Render thử → download Word
4. Verify các placeholder {{ record.customer_id.* }} in giá trị đúng

SQL check

docker exec zonepro-db psql -U odoo -d <workspace> -c "
SELECT name, vat, phone, email,
       x_company_type, x_industry_classification,
       x_legal_representative, x_legal_rep_position
FROM res_partner
WHERE x_is_tenant = true
ORDER BY id DESC LIMIT 10;
"

Cập nhật KH sau

KH có thể đổi info qua thời gian:

• Đổi địa chỉ trụ sở
• Đổi MST (rare — chỉ khi merger / split)
• Đổi người đại diện
• Thêm bank account mới

Sửa trên form KH → Save.

HĐ cũ KHÔNG tự update

HĐ render PDF ngày X dùng snapshot data ngày X. Đổi info KH ngày Y → HĐ cũ vẫn giữ data ngày X.

Để cập nhật HĐ → render lại với data mới (PDF tạo lại, content trong DB không đổi).

Xoá / Archive KH

KH có HĐ active → KHÔNG xoá được (hệ thống block). Cách:

1. Archive (active = False): KH biến mất khỏi list nhưng giữ history. Recommended.
2. Xoá: chỉ khi KH không có HĐ + hoá đơn nào liên quan (rare case).

Câu hỏi thường gặp

Tôi nhập sai MST một KH, sửa thế nào?

Mở KH → tab Khu công nghiệp → sửa field MST → Save.

Lưu ý: HĐ đã render PDF với MST cũ KHÔNG tự update. Cần render lại nếu HĐ chưa ký.

KH có nhiều chi nhánh — quản lý sao?

2 cách:

Cách 1 (recommended): Tạo 1 partner cha (HQ) + chi nhánh là children

• HQ: is_company=True, name=“Công ty Hoa Biết”
• Chi nhánh: is_company=True, parent_id=HQ, name=“Hoa Biết — Chi nhánh HN”

Cách 2: Tạo từng chi nhánh là partner độc lập (không link parent)

• Đơn giản hơn nhưng mất view consolidated

KH FDI có legal rep là người nước ngoài?

Field x_legal_representative là text Char — gõ tên nước ngoài (vd “John Smith”) bình thường. Tiếng Việt / Anh / Trung / Nhật đều OK.

Field x_legal_rep_position tương tự — vd “President” / “CEO” / “Managing Director”.

Có nhập 2 KH cùng MST không?

Có (Odoo cho phép), nhưng KHÔNG nên — gây nhầm lẫn khi report.

Khuyến nghị: MST = unique key → mỗi pháp nhân Việt Nam 1 record duy nhất.

Nếu duplicate đã tồn tại, dùng tính năng Merge contacts:

• Chọn 2+ partner trùng → menu Action → “Merge Contacts”
• Chọn record nào keep, record nào merge into

Tag VIP / Strategic dùng thế nào?

Tags là multi-select free text — không ảnh hưởng logic. Dùng để filter / report:

• Filter KH theo tag “VIP” → list KH ưu tiên
• Báo cáo doanh thu theo tag

Vd tags hay dùng:

• VIP / Strategic / Premium
• High-risk / Watchlist
• Long-term / Short-term
• Sector-specific: Electronics / Textile / …

Liên kết liên quan

• Cấu hình công ty
• Tạo KCN + Lô đất
• Cấu hình chính sách giá
• Cơ hội (CRM Lead)