| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Lines of code | 179 |
| Technical Name |
bsd_vn_address |
| License | LGPL-3 |
| Website | https://bsdinsight.com |
Đơn vị hành chính Việt Nam 2025
Model nền dùng chung cho địa giới hành chính Việt Nam sau cải cách 2025 — 34 tỉnh/thành, 2 cấp, bỏ cấp huyện. Tự nạp ~3.321 phường/xã khi cài đặt.
base
✔ Nạp dữ liệu tự động
Vì sao cần module này?
Từ 2025, Việt Nam tổ chức lại đơn vị hành chính: gộp còn 34 tỉnh/thành, bỏ cấp quận/huyện, chỉ còn 2 cấp Tỉnh → Phường/Xã. Mọi hệ thống Odoo dùng địa chỉ Việt Nam đều cần một nguồn phường/xã chuẩn, thống nhất. Module này cung cấp đúng lớp nền đó và có thể tái sử dụng cho mọi sản phẩm.
Model frm.vn.ward
Danh mục Phường/Xã gắn với res.country.state (34 tỉnh có sẵn của Odoo). Có tên và mã, sẵn sàng làm Many2one ở bất kỳ model nào.
Tự nạp ~3.321 xã
Cài xong là có dữ liệu ngay. Hook nạp idempotent theo (tỉnh, tên xã) — cài lại hay nâng cấp không tạo trùng.
Địa chỉ cấp xã cho liên hệ
Thêm trường vn_ward_id vào res.partner để chọn Phường/Xã trực tiếp trên form liên hệ.
Lớp nền dùng chung
Các module khác chỉ cần depends: ['bsd_vn_address'] rồi trỏ Many2one tới frm.vn.ward — không khai lại danh mục.
Hoạt động ra sao
- Cài module → hook
post_init_hookđọcdata/wards.json. - Khớp mỗi xã vào tỉnh theo tên đã chuẩn hoá (NFC, bỏ tiền tố “Tỉnh/Thành phố”, xử lý bí danh Huế ↔ Thừa Thiên - Huế).
- Tạo bản ghi
frm.vn.ward; ghi log số xã đã tạo và các tỉnh chưa khớp (nếu có). - Chỉ ghi vào bảng riêng — không sửa
res.country.state, an toàn với dữ liệu sẵn có.
Thông tin kỹ thuật
| Phiên bản Odoo | 19.0 (Community & Enterprise) |
| Phụ thuộc | base — không cần module bên ngoài |
| Giấy phép | LGPL-3 |
| Model chính | frm.vn.ward, mở rộng res.partner |
| Dữ liệu | ~3.321 phường/xã (cập nhật 2025) |
Phát triển bởi BSD
Giải pháp Odoo cho doanh nghiệp Việt Nam — nông nghiệp, bất động sản, khu công nghiệp, ERP ngành.
bsdinsight.com
Please log in to comment on this module