Chuẩn hoá địa chỉ sau sáp nhập 2025: đổi địa chỉ cũ sang địa chỉ mới

Trả lời nhanh: từ ngày 01/07/2025, địa chỉ ở Việt Nam chỉ còn hai cấp hành chính. Địa chỉ mới ghi: số nhà, tên đường, phường/xã/đặc khu, tỉnh/thành phố. Để chuẩn hoá một địa chỉ cũ: bỏ quận, huyện; đổi phường, xã cũ sang đơn vị mới theo nghị quyết của tỉnh đó; đổi tên tỉnh nếu tỉnh đã được sắp xếp. Ví dụ: phường Bến Nghé, quận 1 nay là phường Sài Gòn, Thành phố Hồ Chí Minh.

Đổi hàng loạt địa chỉ cũ ↔ mới, miễn phí

Cũ → MớiMới → Cũ

Mỗi dòng một địa chỉ (dán một cột từ Excel, tối đa 10.000 dòng):

Mở tệp .txt/.csv

Địa chỉ bạn dán được gửi tới máy chủ map.vapp.vn để chuyển đổi và không được ghi vào nhật ký truy vấn. Kết quả "Bị chia" và "Trùng tên" không được đổi tự động: kiểm tra riêng các dòng đó.

Địa chỉ thay đổi thế nào

	Trước 01/07/2025	Từ 01/07/2025
Số cấp hành chính	3: tỉnh, huyện, xã	2: tỉnh, xã
Cấp tỉnh	63 tỉnh, thành phố	34 (28 tỉnh, 6 thành phố)
Cấp xã	phường, xã, thị trấn	phường, xã, đặc khu
Địa chỉ	số nhà, đường, phường/xã, quận/huyện, tỉnh	số nhà, đường, phường/xã/đặc khu, tỉnh

Việc sắp xếp đơn vị hành chính không đổi số nhà và tên đường. Thị trấn không còn là một loại đơn vị; mỗi thị trấn cũ nay thuộc một phường hoặc xã.

Bước 1 — Giữ địa chỉ cũ, thêm cột mới

Trong cơ sở dữ liệu khách hàng, đơn hàng hoặc kho, đừng ghi đè địa chỉ cũ. Thêm các cột cho địa chỉ mới (phường/xã mới, tỉnh mới) và giữ cột cũ. Giấy tờ, hợp đồng và hoá đơn đã lập vẫn ghi địa chỉ cũ, và một phần đơn vị cũ bị chia nên cần địa chỉ cũ đầy đủ để đối chiếu.

Bước 2 — Tách địa chỉ cũ thành từng phần

Địa chỉ nhập tay thường là một chuỗi. API verify tách chuỗi đó thành số nhà, đường, phường, quận và tỉnh.

curl -G "https://map.vapp.vn/api/v1/verify" \
  --data-urlencode "q=12 Lê Lợi, phường Bến Nghé, quận 1, TP.HCM"

status nói nên làm gì với địa chỉ khi khách đặt hàng: verified (nhận), corrected (nhận address, là dạng mới của địa chỉ cũ), ambiguous (hỏi lại khách, lý do ở reasons; alternatives liệt kê tối đa 3 tuyến đường cùng tên ở phường, xã khác để khách chọn), unsupported, invalid. Toạ độ là của tuyến đường, không phải của căn nhà. parsed có house, street, ward, district, province, viết thường, không dấu (ví dụ "ben nghe"). district là quận, huyện cũ: dùng nó cùng ward để tra bảng, rồi bỏ nó khỏi địa chỉ mới.

Bước 3 — Đổi phường, xã cũ sang đơn vị mới

Mỗi tỉnh, thành phố có một nghị quyết của Ủy ban Thường vụ Quốc hội ghi rõ đơn vị mới được hình thành từ những đơn vị cũ nào. ERPFit đã chuyển 34 nghị quyết thành bảng tra cứu: 3.321 đơn vị cấp xã mới, 10.570 lượt đơn vị cũ. Mở bảng của tỉnh, gõ tên phường, xã cũ (có dấu hoặc không) để thấy tên mới.

Thành phố Hồ Chí Minh: 168 đơn vị cấp xã
Thành phố Hà Nội: 126 đơn vị cấp xã
Thành phố Đà Nẵng: 94 đơn vị cấp xã
Thành phố Hải Phòng: 114 đơn vị cấp xã
Thành phố Cần Thơ: 103 đơn vị cấp xã
Thành phố Huế: 40 đơn vị cấp xã
Tỉnh Đồng Nai: 95 đơn vị cấp xã
Tỉnh Bắc Ninh: 99 đơn vị cấp xã
Tỉnh Quảng Ninh: 54 đơn vị cấp xã
Tỉnh Khánh Hòa: 65 đơn vị cấp xã
Tỉnh Lâm Đồng: 124 đơn vị cấp xã
Tỉnh Nghệ An: 130 đơn vị cấp xã
Tỉnh Gia Lai: 135 đơn vị cấp xã
Tỉnh Đắk Lắk: 102 đơn vị cấp xã
Tỉnh Thanh Hóa: 166 đơn vị cấp xã
Tỉnh Quảng Ngãi: 96 đơn vị cấp xã
Tỉnh Hà Tĩnh: 69 đơn vị cấp xã
Tỉnh Quảng Trị: 78 đơn vị cấp xã
Tỉnh Tây Ninh: 96 đơn vị cấp xã
Tỉnh An Giang: 102 đơn vị cấp xã
Tỉnh Phú Thọ: 148 đơn vị cấp xã
Tỉnh Ninh Bình: 129 đơn vị cấp xã
Tỉnh Thái Nguyên: 92 đơn vị cấp xã
Tỉnh Hưng Yên: 104 đơn vị cấp xã
Tỉnh Đồng Tháp: 102 đơn vị cấp xã
Tỉnh Vĩnh Long: 124 đơn vị cấp xã
Tỉnh Cà Mau: 64 đơn vị cấp xã
Tỉnh Lào Cai: 99 đơn vị cấp xã
Tỉnh Tuyên Quang: 124 đơn vị cấp xã
Tỉnh Lạng Sơn: 65 đơn vị cấp xã
Tỉnh Cao Bằng: 56 đơn vị cấp xã
Tỉnh Sơn La: 75 đơn vị cấp xã
Tỉnh Điện Biên: 45 đơn vị cấp xã
Tỉnh Lai Châu: 38 đơn vị cấp xã

Tên quận cũ giúp phân biệt hai phường cùng tên, ví dụ "Phường 4, Quận 3". Bảng của cả 34 tỉnh, thành phố: danh sách đầy đủ.

Đổi địa chỉ bằng API (miễn phí)

API address/convert đọc cùng bảng tra cứu trên, theo hai chiều. Không cần khóa API. Một địa chỉ:

curl -G "https://map.vapp.vn/api/v1/address/convert" \
  --data-urlencode "q=12 Lê Lợi, phường Bến Nghé, quận 1, TP.HCM"

status là ok khi chỉ có một đơn vị mới; khi đó address là địa chỉ mới, giữ nguyên số nhà và tên đường bạn gửi.

curl -G "https://map.vapp.vn/api/v1/address/convert" \
  --data-urlencode "dir=new2old" \
  --data-urlencode "q=phường Sài Gòn, TP.HCM"

old liệt kê các đơn vị cũ, mỗi đơn vị có share: whole (toàn bộ), part (một phần) hoặc rest (phần còn lại).

Nhiều địa chỉ (tối đa 1.000 mỗi lần gọi), kết quả theo đúng thứ tự gửi, kèm số dòng theo từng trạng thái:

curl -X POST "https://map.vapp.vn/api/v1/address/convert" \
  -H "content-type: application/json" \
  -d '{"dir":"old2new","items":["12 Lê Lợi, phường Bến Nghé, quận 1, TP.HCM","Phường 4, Quận 3, TP.HCM","phường Phú Mỹ, thành phố Thủ Dầu Một, tỉnh Bình Dương"]}'

`status`	Ý nghĩa
`ok`	Đã đổi
`already_new`	Đã là tên mới
`split`	Bị chia: cần số nhà, tên đường
`ambiguous`	Trùng tên: thêm quận, huyện
`already_old`	Là tên cũ: dùng chiều cũ → mới
`not_found`	Không có trong nghị quyết
`no_unit`	Thiếu phường, xã
`no_province`	Thiếu tỉnh, thành phố
`province_not_covered`	Tỉnh chưa có bảng: chỉ đổi tên tỉnh

Bước 4 — Xử lý đơn vị bị chia

Trong 34 tỉnh, thành phố trên, 441 đơn vị cũ được chia cho hai đơn vị mới trở lên. Bảng ghi các đơn vị này là một phần hoặc phần còn lại. Với các địa chỉ này, tên phường, xã cũ không đủ để biết tên mới: cần số nhà và tên đường. Hãy đánh dấu các dòng này để kiểm tra riêng, ví dụ hỏi khách hàng hoặc Ủy ban nhân dân phường, xã nơi đó, thay vì đổi tự động.

Bước 5 — Ghi địa chỉ mới

Ghép lại: số nhà, tên đường, phường/xã/đặc khu mới, tỉnh/thành phố. Không ghi quận, huyện. Ví dụ: 12 Lê Lợi, phường Sài Gòn, Thành phố Hồ Chí Minh.

Đơn hàng mới mỗi tháng còn cần tọa độ để giao: gói địa chỉ giao hàng tính gói theo số đơn của bạn.

Nguồn và giới hạn

Nguồn: Nghị quyết số 202/2025/QH15 ngày 12/06/2025 của Quốc hội về sắp xếp đơn vị hành chính cấp tỉnh; Luật Tổ chức chính quyền địa phương số 72/2025/QH15 (Công báo số 807+808); nghị quyết của Ủy ban Thường vụ Quốc hội cho từng tỉnh, ghi ở mỗi bảng tra cứu. Ví dụ API trên được kiểm tra tự động với API thật trước mỗi lần cập nhật trang. Hướng dẫn này chỉ để tham khảo, không phải văn bản của cơ quan nhà nước và không có giá trị pháp lý.