Cấu hình công ty

Cấu hình công ty

Trang này hướng dẫn nhập đầy đủ thông tin pháp lý của công ty chủ đầu tư KCN vào Parkone. Đây là setup 1 lần, làm ngay sau khi đăng ký workspace — vì hầu hết document (HĐ, hoá đơn, báo giá PDF) sẽ in các thông tin này.

Ai làm setup này?

Admin của workspace. Không cần kỹ năng kỹ thuật, chỉ cần:

• Quyền truy cập menu Cấu hình → Companies
• Thông tin pháp lý công ty (MST, GPKD, địa chỉ, …)
• Thông tin ngân hàng (số TK VND + USD nếu có)

Tại sao cần nhập đầy đủ

Khi tạo hợp đồng / báo giá / hoá đơn, Parkone tự render PDF với template Word có Jinja placeholders. Các placeholder dạng {{ company.name }}, {{ company.vat }}, {{ company.representative_name }} lấy giá trị từ record res.company.

Nếu Đại không nhập → placeholder render thành rỗng → HĐ PDF thiếu thông tin → khó dùng pháp lý.

Vd PDF hợp đồng đoạn header:

HỢP ĐỒNG THUÊ ĐẤT
Số: ZC/2026/00142

BÊN A (Chủ đầu tư):
  Công ty: ____________  ← {{ company.name }}
  Địa chỉ: ____________  ← {{ company.street }}, {{ company.city }}
  MST: _______________   ← {{ company.vat }}
  Đại diện: ___________  ← {{ company.representative_name }}
  Chức vụ: ___________   ← {{ company.representative_function }}

Tất cả các chỗ ____ chỉ điền được nếu Parkone có data → cần setup company TRƯỚC.

Tổng quan các bước

1. Mở Cài đặt → Companies → My Company
2. Tab General — tên, logo
3. Tab Hoá đơn — bank accounts (VND + USD)
4. Tab Khu công nghiệp — người đại diện, MST, fax, swift code
5. Save

Truy cập form công ty

Bước 1. Bật Developer mode (1 lần)

Một số field nâng cao chỉ hiện trong Dev mode. Bật như sau:

1. Click avatar góc trên phải → Cài đặt
2. Cuộn xuống cuối trang → mục “Developer Tools”
3. Click “Bật chế độ nhà phát triển”

📸 Screenshot: vị trí nút Bật developer mode

Trang reload, top bar có icon 🐞 (bug) — báo dev mode ON.

Dev mode chỉ Admin nên bật

Dev mode hiện thêm field/menu kỹ thuật. Nếu Sales rep / FC tự bật và sửa nhầm → có thể gây lỗi.

Khuyến nghị: Admin bật, làm xong setup → tắt dev mode (cùng vị trí, click “Tắt chế độ nhà phát triển”).

Bước 2. Mở form Công ty

Cài đặt → Users & Companies → Companies → click vào tên công ty (vd “My Company” hoặc “Apave Vietnam”)

📸 Screenshot: list Companies với 1 record duy nhất

Form công ty mở ra với nhiều tab.

Tab “General Information”

1.1. Tên công ty

Field “Tên công ty” ở phía trên cùng.

• Tên đầy đủ theo Giấy ĐKKD
• Vd: Công ty TNHH Apave Vietnam & Southeast Asia
• KHÔNG viết tắt — tên này in trên HĐ pháp lý

1.2. Logo

Click vào ô avatar bên trái → upload logo:

• Format: PNG hoặc JPG
• Kích thước: tối thiểu 200×200px, tối đa 2MB
• Khuyến nghị: PNG nền trong suốt, vuông

Logo sẽ hiển thị:

• Header HĐ PDF
• Email gửi cho KH
• Footer hoá đơn

1.3. Trang web (Website)

URL trang web công ty: vd https://apave.vn

1.4. Email

Email chính thức của công ty: vd info@apave.vn

Email này KHÔNG phải email admin user — đây là email organizational, sẽ hiển thị trên HĐ + báo giá.

1.5. Điện thoại

Số tổng đài / hotline công ty: vd +84 28 1234 5678

1.6. Địa chỉ

Cần nhập đầy đủ:

Field	Vd
Đường (street)	11 Nguyễn Đình Chiểu
Đường 2 (street2)	Tầng 5, Toà nhà ABC (optional)
Thành phố (city)	TP Hồ Chí Minh
State	TP Hồ Chí Minh
Mã ZIP	700000 (optional cho VN)
Quốc gia	Việt Nam

Sau VN-2025 reform

Hệ thống hành chính VN từ 2025 bỏ cấp huyện. Parkone hỗ trợ trực tiếp Tỉnh → Phường/Xã (qua field x_vn_ward_id tự thêm vào res.partner).

Để dùng: chọn State = Tỉnh/Thành → field Phường / Xã xuất hiện → chọn từ dropdown (đã preload toàn bộ phường xã VN).

Tab “Hoá đơn”

Tab này có sub-section “Tài khoản ngân hàng” — quản lý TK VND + USD của công ty.

Thêm TK ngân hàng VND

1. Cuộn đến section “Bank Accounts” (Tài khoản ngân hàng)

2. Click “Add a line” (Thêm 1 dòng)

3. Popup form Bank Account hiện ra với các field:

   Field	Vd	Lưu ý
   Account Number	0011000123456	Số TK đầy đủ
   Bank	Vietcombank — CN HCM	Click 🔗 để chọn Bank đã có / Tạo mới
   Currency	VND	PHẢI chọn VND — Parkone filter theo currency để pick TK đúng
   Account Holder	(auto-fill = company.partner_id)	Để mặc định

4. Nếu Bank chưa có trong dropdown → click “Tạo và sửa…” → mở form res.bank:

   • Name: vd “Ngân hàng Ngoại thương Việt Nam”
   • Bank Identifier Code (BIC): vd “BFTVVNVX001” (SWIFT của Vietcombank HCM)
   • Country: Việt Nam
   • Street: vd “67 Trần Hưng Đạo, Q1, TP HCM”
   • Save

5. Quay lại form Bank Account → Save

📸 Screenshot: form Bank Account với Currency = VND highlighted

Thêm TK ngân hàng USD

Lặp lại các bước trên với:

• Account Number: số TK USD (vd “9988776655”)
• Bank: cùng Bank hoặc Bank khác (HSBC, Citibank…)
• Currency: USD (quan trọng — không chọn VND)

Cần TK USD?

Nếu công ty Đại chỉ giao dịch VND → bỏ qua bước này. Trong template HĐ, placeholder {{ company.bank_acc_usd_id.acc_number }} sẽ render empty (không gây lỗi).

KCN có khách FDI (đa quốc gia) thường cần TK USD để nhận đặt cọc / thanh toán bằng USD.

Field “TK ngân hàng (US)” — text trực tiếp

Nếu Đại không muốn tạo res.partner.bank với currency USD, có thể nhập text trực tiếp:

• Tab “Khu công nghiệp” → section Legal Information → field “TK ngân hàng (US)”
• Gõ text: vd 9988776655 — HSBC Vietnam
• Field này lưu vào partner.x_bank_acc_us (Char field)

Placeholder template {{ company.partner_id.x_bank_acc_us }} lấy text này.

→ Đại chọn 1 trong 2 cách (bank account record HOẶC text field), không cần cả 2.

Tab “Khu công nghiệp”

Tab này có các field đặc thù KCN mà Parkone thêm vào ngoài chuẩn Odoo:

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

Field	Mô tả
Loại hình đầu tư	FDI / DDI / Joint Venture / Individual
Ngành sản xuất	Electronics, Textile, Food, …
Tập đoàn mẹ	Tên công ty mẹ (nếu là chi nhánh)
Quốc gia xuất xứ	Country of Origin
Là khách thuê KCN	Tick nếu công ty THUÊ trong KCN khác (KHÔNG tick nếu là chủ đầu tư)

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

Đây là phần quan trọng nhất cho template HĐ:

Field	Vd	Bắt buộc
Mã số thuế (MST)	98383773	✅
Số giấy phép kinh doanh	12343222	Tốt nhất có
Ngày cấp giấy phép	24/6/2010	Tốt nhất có
Người đại diện pháp luật	Bùi Trường Đại	✅
Chức vụ người đại diện	Tổng Giám đốc	✅
Fax ✨	+84 28 1234 5678	Optional
TK ngân hàng (US) ✨	9988776655	Optional (xem ở trên)
Swift Code ✨	BFTVVNVX001	Optional

✨ = field mới thêm cho Doc Engine v2 — chèn vào HĐ qua placeholder.

Field bắt buộc cho HĐ

3 field tối thiểu để HĐ PDF render đúng:

• Mã số thuế (MST)
• Người đại diện pháp luật
• Chức vụ người đại diện

Còn lại optional — nếu bỏ trống, placeholder render empty (HĐ vẫn ra, chỉ là chỗ đó trống).

Section “Đầu tư”

Section này dành cho khách thuê KCN (FDI), không liên quan công ty chủ đầu tư. Có thể bỏ qua nếu Đại đang setup company chính.

Field	Mô tả
Số IRC	Investment Registration Certificate
Ngày cấp IRC	Issue date
Vốn đầu tư	Vốn đăng ký

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

Field	Mô tả
Quy mô lao động	Số nhân viên dự kiến

Tab “Cấu hình”

Tab này có các settings Parkone-specific:

Warranty + Auto-post

Field	Mô tả
Warranty Alert Lead Time (days)	Số ngày trước khi warranty hết hạn để cảnh báo (default 90)
Auto-post Lease Invoices	Tick để tự động Post hoá đơn sau khi sinh (default OFF — Đại review trước khi post)

Reminder (Nhắc nợ)

Field	Mô tả
Nhắc trước hạn (ngày)	Email nhắc thanh toán trước N ngày (default 7)
Nhắc trễ hạn sau (ngày)	Email nhắc khi hoá đơn quá hạn ≥ N ngày (default 3)

Đặt 0 để tắt cron nhắc nợ.

Approval thresholds (VND)

3 tier ngưỡng duyệt giảm giá:

Field	Vd	Ai duyệt
Tier 1 — Self approve	100.000.000	Sales rep tự duyệt
Tier 2 — Team Manager	500.000.000	Manager duyệt
Tier 3 — > Tier 2	(vượt ngưỡng)	CEO / Director duyệt

Vd nếu Sales đề xuất giảm giá 80tr → tự duyệt (≤ 100tr).
Giảm 300tr → cần Manager approve (giữa 100tr - 500tr).
Giảm 800tr → cần CEO approve (> 500tr).

Ngưỡng duyệt Đặt cọc

Đặt cọc có giá trị > ngưỡng này → cần Manager duyệt trước khi ký.

Default 1.000.000.000 VND (1 tỷ).

Save + Validate

Sau khi nhập đầy đủ, click “Save” (icon ☁️ trên cùng).

Hệ thống kiểm tra:

• MST đúng format (10 hoặc 13 số)
• Email hợp lệ
• Bank account number không trùng
• Currency của bank account khớp với label (VND / USD)

Nếu validation OK → record được lưu. Top bar hiện thông báo xanh “Saved”.

Nếu fail → field lỗi bị highlight đỏ + thông báo cụ thể.

Kiểm tra setup đã đúng

Cách 1: Xem record qua DevTools

Mở terminal trên VPS:

docker exec zonepro-db psql -U odoo -d <workspace_db> -c "
SELECT name, vat, phone, email, street, city,
       representative_name, representative_function
FROM res_company
LIMIT 5;
"

Output show tất cả company records với data đã nhập. Verify khớp với UI.

Cách 2: Tạo HĐ test → render PDF

1. Tạo 1 Hợp đồng giả (vd với KH demo, lô đất bất kỳ, giá trị nhỏ)
2. Mở 1 Mẫu tài liệu (Doc Template) có sẵn (vd “HĐ chuẩn”)
3. Click ”🧪 Render thử” → chọn HĐ vừa tạo
4. Download file Word output
5. Mở file → kiểm tra các đoạn {{ company.* }} có in giá trị đúng không

Nếu thiếu / sai → quay lại form Company sửa.

Cập nhật thông tin sau

Sau setup ban đầu, vẫn có thể update bất cứ lúc nào:

1. Cấu hình → Users & Companies → Companies → click vào tên công ty
2. Sửa field cần đổi
3. Save

Field ảnh hưởng HĐ đã ký

Đổi tên công ty / MST / địa chỉ → các HĐ ĐÃ render PDF KHÔNG tự update. HĐ render trong tương lai dùng giá trị mới.

Nếu cần update HĐ cũ — render lại từ template (HĐ data trong DB không đổi, chỉ template + company snapshot).

Multi-company (Nhiều công ty trong workspace)

Nếu Đại quản lý nhiều công ty / pháp nhân trong cùng 1 workspace:

1. Cài đặt → Users & Companies → Companies → Mới
2. Nhập tên công ty mới + thông tin tương tự setup chính
3. Save

User cần được cấp quyền multi-company:

• Mở user → tab Quyền truy cập → section “Multi Companies”
• Tick chọn nhiều công ty
• User chuyển công ty active qua dropdown Top Bar

Multi-company complexity

Multi-company làm Parkone phức tạp hơn:

• Tax, currency, accounting riêng từng cty
• Inter-company transactions phải cấu hình thủ công
• Báo cáo phải filter theo company

Khuyến nghị: chỉ dùng multi-company nếu thực sự cần (vd KCN + công ty quản lý dịch vụ riêng).

Bước tiếp theo

Sau khi setup company xong:

Tạo KCN + lô đất

Vẽ mặt bằng KCN, định dạng lô đất, kho.

Đọc →

Tạo Khách hàng

Partner profile cho khách thuê — FDI/DDI, MST, legal rep.

Đọc →

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

Tôi không thấy tab “Khu công nghiệp” trong form Company?

• Đã bật Developer mode chưa? (xem Bước 1)
• Module parkone đã install chưa? Tab Khu công nghiệp do parkone addon thêm vào.
• Nếu mọi thứ đúng vẫn không thấy → liên hệ Admin / support@bsdinsight.com.

Đổi MST có ảnh hưởng HĐ đã ký không?

KHÔNG. MST trên HĐ đã render PDF là snapshot tại thời điểm render. Đổi MST trong company chỉ ảnh hưởng HĐ render trong tương lai.

Nếu cần update HĐ cũ → render lại từ template với data mới.

Logo upload bị “lỗi quá dung lượng”?

Giảm size file ảnh:

• Online: tinypng.com hoặc iloveimg.com
• Local: Photoshop / Preview (Mac) / Paint (Windows)

Mục tiêu: file < 500KB, format PNG. Logo công ty thường nhỏ nên 100-300KB là đủ.

Có nhập sai phần MST không sao?

MST chỉ validate format (10 hoặc 13 số). Parkone không verify MST với database thuế VN.

→ Nhập đúng MST là trách nhiệm Đại. Sai MST trên HĐ có thể gây pháp lý + thuế.

Workspace có nhiều company, làm sao cấu hình từng cty?

Mỗi company có form riêng. Vào Cài đặt → Companies → click vào tên cty → cấu hình tab Khu công nghiệp riêng cho cty đó.

Field như representative_name, bank_acc_* là per-company (mỗi cty có giá trị riêng).

Liên kết liên quan

• Tạo KCN + lô đất
• Tạo Khách hàng
• Cấu hình chính sách giá
• Doc Engine — tạo mẫu tài liệu