Mô tả chi tiết tính năng quản lý các quốc gia
Back to ecommerce
Updated at
1793612888000
Địa chỉ giao hàng của khách, địa chỉ cửa hàng, chi nhánh và kho đều được chọn từ danh sách quốc gia và đơn vị hành chính mà bạn quản lý trong E-Commerce > Các quốc gia. Bài viết này hướng dẫn cách thêm quốc gia, tải nhanh dữ liệu tỉnh/thành, quận/huyện, phường/xã của Việt Nam, khai báo tỉnh lân cận và quản lý các đơn vị hành chính theo mô hình riêng của từng nước.
Website dùng dữ liệu này ở đâu
Trước khi đi vào màn hình quản trị, bạn nên biết dữ liệu này xuất hiện ở đâu phía khách hàng:
- Ở trang thanh toán, khách chọn quốc gia > tỉnh/thành phố > quận/huyện > phường/xã để nhập địa chỉ nhận hàng. Quốc gia mặc định được chọn sẵn. Ô chọn quốc gia chỉ hiện khi bật Hiển thị lựa chọn quốc gia trên web trong E-Commerce > Cài đặt.
- Website chỉ hiển thị các quốc gia và đơn vị hành chính ở trạng thái Đã kích hoạt. Muốn ẩn một nơi bạn không giao hàng tới, hãy vô hiệu hoá nó thay vì xoá.
- Theme lấy dữ liệu qua các API
/api/v1/countries,/api/v1/countries/{countryId}/provinces,/api/v1/provinces/{provinceId}/districts,/api/v1/provinces/{provinceId}/wardsvà/api/v1/districts/{districtId}/wards.
Quản lý quốc gia
Trang Các quốc gia gồm nhiều phần xếp từ trên xuống: danh sách quốc gia, tỉnh/thành phố của quốc gia đang chọn, quận/huyện và phường/xã của tỉnh đang chọn, và cuối cùng là các đơn vị địa giới hành chính khác. Phần này nói về danh sách quốc gia ở trên cùng.
Danh sách quốc gia
Bảng quốc gia cho biết cờ, ảnh, mã, tên địa phương, tên quốc tế, mã vùng điện thoại, mã tiền tệ, tên thủ đô, quốc gia mặc định và trạng thái.

- Thêm mới: mở form thêm quốc gia.
- Mặc định: quốc gia mặc định hiện chữ Đúng. Bấm Lựa chọn ở dòng khác để đổi quốc gia mặc định, tức quốc gia được chọn sẵn trong form địa chỉ trên website.
- Chọn: biểu tượng bàn tay chọn quốc gia này để xem và quản lý các tỉnh/thành phố của nó ở phần bên dưới.
- Sửa / Xoá: sửa thông tin hoặc xoá quốc gia.
Thêm mới quốc gia
Form Thêm mới quốc gia có các trường:

- Mã (bắt buộc): mã quốc gia viết thường theo ISO 3166-1, ví dụ
vn,jp,us. Mãvncòn được dùng để tìm bộ tải dữ liệu tự động cho Việt Nam (xem phần sau). - Tên địa phương (bắt buộc) và Tên quốc tế (bắt buộc): tên theo ngôn ngữ bản địa và tên tiếng Anh, ví dụ
日本vàJapan. - Mã vùng điện thoại, Mã tiền tệ chuẩn ISO, Tên thủ đô: thông tin tham khảo, ví dụ
+81,JPY,Tokyo. - Cờ: class CSS của bộ biểu tượng cờ, có dạng
fi fi-<mã>, ví dụfi fi-jp. - Ảnh: ảnh đại diện tuỳ chọn, chọn từ thư viện media.
- Kích hoạt: tích để quốc gia xuất hiện trên website.
Quản lý tỉnh/thành phố
Sau khi chọn một quốc gia, phần Các tỉnh/thành phố của ... hiện danh sách tỉnh/thành của quốc gia đó. Có hai cách để có dữ liệu: tự thêm từng tỉnh, hoặc tải tự động nếu plugin có bộ tải cho quốc gia này.

- Thêm mới: thêm một tỉnh/thành phố với Mã, Kiểu (Tỉnh hoặc Thành phố), Tên hiển thị và Trạng thái.
- Lấy từ: chỉ hiện với quốc gia có bộ tải dữ liệu. Với Việt Nam (mã
vn), plugin có sẵn hai nguồn là Viettel Post và Viettel Post Partner. Chọn một nguồn và xác nhận để tải toàn bộ tỉnh/thành, quận/huyện và phường/xã. Nếu chưa có quốc giavn, plugin tự tạo khi tải. - Lân cận: số tỉnh/thành đã khai báo là lân cận của tỉnh này. Bấm vào con số để xem danh sách, bấm Cập nhật để chọn lại các tỉnh lân cận.
- Chọn / Sửa / Xoá: chọn tỉnh để xem quận/huyện và phường/xã bên dưới, sửa hoặc xoá tỉnh.
Ô Tìm kiếm ở góc phải lọc nhanh tỉnh theo tên. Ví dụ trên đã lọc ra Hà Nội.
Tỉnh/thành phố lân cận
Danh sách lân cận là các tỉnh giáp ranh hoặc gần một tỉnh, do bạn tự khai báo. Ví dụ Hà Nội có 7 tỉnh lân cận:

Plugin dùng thông tin này khi tạo vận đơn cho đơn hàng trả trước của cửa hàng có nhiều kho: kho nằm ở khu vực lân cận với địa chỉ người nhận được ưu tiên xuất hàng, các sản phẩm còn lại lấy từ kho đầu tiên. Nếu bạn chỉ có một kho, có thể bỏ qua phần này.
Quản lý quận/huyện và phường/xã
Khi chọn một tỉnh, phần dưới hiện hai bảng: Các quận/huyện và Các phường/xã của tỉnh đó.
Quận/huyện

- Thêm mới: thêm quận/huyện với Mã, Kiểu (Quận, Huyện, Thị xã, Thành phố trực thuộc tỉnh), Tên hiển thị và Trạng thái.
- Chọn: lọc bảng phường/xã bên dưới theo quận/huyện này.
Phường/xã

- Thêm mới: thêm phường/xã với Kiểu (Xã, Phường, Thị trấn), Tên hiển thị và Trạng thái.
Khi chưa chọn quận/huyện nào, bảng hiện mọi phường/xã của tỉnh và phường/xã mới được thêm thẳng vào tỉnh. Khi đã chọn một quận/huyện, bảng chỉ hiện phường/xã của quận/huyện đó và phường/xã mới thuộc về quận/huyện đó. Nhờ vậy plugin dùng được cho cả mô hình 3 cấp (tỉnh, huyện, xã) lẫn mô hình 2 cấp (tỉnh, xã không qua cấp huyện).
Các đơn vị địa giới hành chính khác
Không phải nước nào cũng chia theo tỉnh, huyện, xã. Phần Các đơn vị địa giới hành chính khác ở cuối trang cho phép khai báo cây đơn vị hành chính tự do cho từng quốc gia, ví dụ bang, hạt, thành phố của Mỹ.

Mỗi đơn vị có thể có Cha là một đơn vị khác, nên bạn dựng được nhiều cấp: California (Bang/Tiểu bang) > Los Angeles County (Hạt) > Los Angeles (Thành phố). Bảng có bộ lọc theo từ khoá, trạng thái, kiểu và đơn vị cha.
Bấm Thêm mới để mở form:

- Tên dịch vụ: để trống với dữ liệu dùng chung. Điền tên khi bộ đơn vị này dành riêng cho một dịch vụ, ví dụ một đơn vị vận chuyển có cách chia khu vực riêng.
- Quốc gia (bắt buộc) và Cha: quốc gia và đơn vị cấp trên (để trống nếu là cấp cao nhất).
- Mã, Kiểu: mã đơn vị và loại đơn vị, ví dụ Bang/Tiểu bang, Hạt, Tỉnh tự trị, Khu tự trị, Thành phố, Thị trấn.
- Tên địa phương, Tên quốc tế, Thứ tự hiển thị, Trạng thái (bắt buộc).
Gợi ý thiết lập cho cửa hàng tại Việt Nam
Để có ngay dữ liệu địa chỉ cho website bán hàng trong nước:
- Chọn quốc gia Việt Nam (hoặc chưa cần tạo, plugin sẽ tự tạo).
- Ở phần tỉnh/thành phố, bấm Lấy từ > Viettel Post và xác nhận. Quá trình tải mất một lúc vì có hàng nghìn phường/xã.
- Đặt Việt Nam làm quốc gia Mặc định, rồi tắt Hiển thị lựa chọn quốc gia trên web nếu bạn chỉ giao hàng trong nước.
- Vô hiệu hoá các tỉnh/thành bạn không giao hàng tới, để khách không chọn được.
- Nếu có nhiều kho, khai báo tỉnh lân cận cho các tỉnh đặt kho.