WooCommerce địa chỉ 2 cấp: cập nhật tỉnh thành sau sáp nhập cho trang thanh toán

Chào anh em! Từ 01/07/2025 Việt Nam không còn cấp quận/huyện, cả nước còn 34 tỉnh thành. Trang thanh toán WooCommerce nào chưa cập nhật vẫn bắt khách chọn Quận/Huyện theo bộ dữ liệu cũ. Khách bối rối không biết chọn gì, phí ship theo vùng tính sai, gửi đơn sang hãng vận chuyển thì báo địa chỉ không hợp lệ. Làm theo bài này, anh em chuyển được trang thanh toán sang WooCommerce địa chỉ 2 cấp mà không mất đơn cũ.

Địa chỉ 2 cấp là gì, thay đổi từ khi nào?

• Nghị quyết 202/2025/QH15 thông qua ngày 12/06/2025 sáp nhập tỉnh, giảm từ 63 xuống 34 đơn vị cấp tỉnh (28 tỉnh, 6 thành phố).
• Luật Tổ chức chính quyền địa phương 72/2025/QH15 tổ chức chính quyền thành 2 cấp là tỉnh/thành phố và xã/phường/đặc khu, cấp huyện kết thúc hoạt động từ 01/07/2025.
• Cả nước còn 3.321 đơn vị cấp xã (2.621 xã, 687 phường, 13 đặc khu), giảm từ hơn mười nghìn.

Một địa chỉ giao hàng giờ chỉ còn số nhà, đường, phường/xã và tỉnh/thành phố. Tên nhiều phường cũng đổi theo đợt sắp xếp, nên bộ dữ liệu địa chỉ cũ trên website gần như phải thay toàn bộ.

WooCommerce mặc định xử lý địa chỉ Việt Nam thế nào?

WooCommerce gốc không có danh sách tỉnh thành cho Việt Nam. Chọn quốc gia Việt Nam thì ô Tỉnh/Bang bị ẩn, khách tự gõ thành phố và địa chỉ bằng tay. Gõ tự do thì không ai giống ai: “HCM”, “TP.HCM”, “Sài Gòn”. Muốn có ô chọn tỉnh, huyện, xã thì shop phải cài thêm một plugin địa chỉ. Plugin địa chỉ đó là thứ phải cập nhật sau sáp nhập.

Website cần đổi những gì?

• Ô địa chỉ ở trang thanh toán bỏ Quận/Huyện, chỉ còn hai ô chọn nối tiếp Tỉnh/Thành rồi Phường/Xã với dữ liệu 34 tỉnh và hơn 3.300 phường/xã mới.
• Bảng phí ship theo vùng đang đặt theo quận/huyện cũ phải đặt lại theo tỉnh và phường/xã mới.
• Phần kết nối hãng vận chuyển phải gửi đúng tên đơn vị mới, ví dụ API tính phí của Giao Hàng Tiết Kiệm (GHTK) giờ chỉ bắt buộc tỉnh và phường/xã, còn GHN và Viettel Post đã có bộ danh mục địa chỉ mới theo tỉnh và phường/xã.
• Đơn hàng cũ đang lưu địa chỉ theo bộ dữ liệu cũ nên cần xử lý trước khi đổi (xem mục dưới).

Chuyển sang địa chỉ 2 cấp với plugin của DevVN

Các plugin vận chuyển của mình (GHTK, GHN, Viettel Post…) và Vietnam Checkout PRO dùng chung một module trang thanh toán, nên cách làm giống nhau. Ví dụ với plugin GHTK:

1. Sao lưu cơ sở dữ liệu trước vì các bước sau sẽ xoá và dựng lại bảng địa chỉ.
2. Vào WooCommerce → Cài đặt GHTK → tab Cài đặt chung, kéo xuống mục Công cụ.
3. Ở dòng Đơn vị hành chính, chọn Mới nhất (bộ 2 cấp sau sáp nhập). Hai lựa chọn còn lại là bộ 3 cấp cũ: “v2.0 – trước 01.07.2025” và “V1.8 – trước năm 2025”.
4. Bấm Cập nhật database và chờ chạy xong.
5. Mở trang thanh toán ở cửa sổ ẩn danh: chỉ còn ô Tỉnh/Thành và Phường/Xã. Chọn thử vài địa chỉ để xem phí ship hiện đúng.

Bộ địa chỉ trên website phải khớp với bộ mà hãng vận chuyển đang dùng. Website một bộ, hãng một bộ là tính phí trật, đăng đơn báo lỗi địa chỉ. Chi tiết các tuỳ chọn khác ở trang cài đặt chung trong tài liệu plugin.

Đơn hàng cũ sau khi đổi

Đơn đặt trước khi đổi lưu mã tỉnh, huyện, xã theo bộ dữ liệu cũ. Đổi sang bộ mới xong, địa chỉ của các đơn này có thể hiển thị khác đi. Nên làm theo thứ tự:

• Đăng hết các đơn đang chờ sang hãng vận chuyển trước khi đổi, khi địa chỉ của chúng vẫn còn hiển thị đúng.
• Đơn nào sót lại sau khi đổi thì sửa địa chỉ trong đơn theo phường/xã mới rồi mới đăng.
• Cần tra lại địa chỉ đơn cũ (đổi trả, bảo hành) thì xem ở bản sao lưu hoặc mã vận đơn bên hãng vận chuyển.

WooCommerce checkout block và địa chỉ Việt Nam

Từ WooCommerce 8.3, site mới mặc định dùng giỏ hàng và trang thanh toán dạng block. Block có cách thêm trường riêng, nên plugin địa chỉ viết cho trang thanh toán cổ điển (shortcode) không tự chạy trên block.

Với plugin của mình: từ bản cập nhật cuối tháng 5/2026, module trang thanh toán hỗ trợ checkout block, nhưng chỉ khi dùng địa chỉ 2 cấp. Shop vẫn giữ 3 cấp thì dùng trang thanh toán cổ điển. Cách chuyển về giao diện cũ có ở bài chuyển trang checkout và giỏ hàng về giao diện cũ.

Nên dùng plugin nào?

• Shop chỉ cần ô chọn địa chỉ và phí ship theo tỉnh thì dùng bản miễn phí Vietnam Checkout for WooCommerce trên WordPress.org (10.000+ site), đã cập nhật đơn vị hành chính mới từ 01/07/2025 theo changelog bản 2.1.3 (tháng 7/2025).
• Shop cần đặt phí ship tới từng phường/xã thì dùng Vietnam Checkout PRO.
• Shop cần phí ship thật của hãng, đăng đơn, đồng bộ trạng thái thì dùng plugin kết nối hãng tương ứng (đã có sẵn module địa chỉ 2 cấp và checkout block), ví dụ plugin GHTK cho WooCommerce, danh sách đủ ở trang plugin vận chuyển.

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

Có nên giữ ô Quận/Huyện cho khách quen tay không?

Không nên. Cấp huyện không còn. GHN và Viettel Post đã có danh mục tỉnh và phường/xã mới, API của GHTK cũng chỉ còn bắt buộc tỉnh và phường/xã. Giữ 3 cấp là bắt khách chọn đơn vị đã giải thể, và với plugin của mình thì không dùng được checkout block.

Đổi sang 2 cấp có mất đơn hàng cũ không?

Không mất đơn, chỉ có địa chỉ của đơn cũ có thể hiển thị khác đi vì chúng lưu mã theo bộ dữ liệu cũ. Sao lưu trước khi đổi và xử lý các đơn đang chờ như hướng dẫn ở trên.

Tôi tự làm ô địa chỉ thì lấy dữ liệu 2 cấp ở đâu?

Lấy luôn danh mục của hãng vận chuyển bạn dùng. GHN có API danh sách tỉnh và phường/xã mới, Viettel Post có bộ danh mục V3 theo tỉnh và phường/xã, GHTK nhận tên tỉnh và phường/xã. Dùng danh mục của hãng thì khỏi lo lệch tên khi gửi đơn.

Anh em đang kẹt ở bước nào khi chuyển sang 2 cấp thì để lại bình luận, nhớ ghi plugin địa chỉ đang dùng để mình xem giúp cho nhanh.