Để lấy được danh sách tỉnh thành phố và danh sách ngân hàng, trước tiên bạn cần phải tạo một quốc gia, ví dụ như: Việt Nam. Sau khi tạo quốc gia thành công, bạn có thể lấy danh sách các tỉnh thành, ngân hàng của quốc gia đó một cách nhanh chóng thông qua việc gọi API trên giao diện admin nếu E-Commerce hỗ trợ sẵn (ví dụ Việt Nam sẽ được hỗ trợ sẵn). Danh sách quốc gia, tỉnh thành phố cũng sẽ được phản ánh trên các chức năng của website một cách trực quan, giúp người dùng dễ dàng tra cứu và lựa chọn khi thực hiện các giao dịch thanh toán hoặc các thao tác quản lý khác.

ví dụ: khi người dùng mua một sản phẩm sẽ được thêm tại giỏ hàng của website hobb sẽ hiển thị các thông tin chi tiết, người dùng có thể tùy chọn các địa điểm như hình ở dưới.

Để có thể hiển thị được như kết quả trên đây người dùng cần thao tác như dưới đây là hướng dẫn chi tiết để bạn có thể khai thác tối đa tính năng này trên hệ thống.

Giao diện danh mục Quốc Gia

Khi truy cập vào tính năng “Các quốc gia”, bạn sẽ thấy bảng danh sách hiển thị:

• Mã: Mã định danh quốc gia (vd: “vn”, “us”…).
• Tên địa phương: Tên quốc gia theo ngôn ngữ bản địa (vd: “Việt Nam”).
• Tên quốc tế: Tên quốc gia theo tiêu chuẩn quốc tế (vd: “Viet Nam”).
• Cờ và Ảnh (nếu có): Biểu tượng quốc kỳ hoặc ảnh đại diện cho quốc gia.
• Mặc định (nếu hệ thống hỗ trợ): Cho biết quốc gia này có phải là mặc định khi hiển thị địa chỉ hay không.
• Hành động: các thao tác nút chỉnh sửa/ xóa

Ngoài ra, phía trên bảng thường có khung tìm kiếm (Search ) để lọc nhanh theo Code, Tên hiển thị, Trạng thái…Nút “thêm mới” cho phép bạn tạo quốc gia mới.

Hướng dẫn sử dụng

Thêm mới quốc gia

Để thêm mới quốc gia bạn cần click vào nút “Thêm mới” để mở form nhập liệu. Trong form, bạn cần điền các trường bắt buộc gồm: Mã (mã định danh viết tắt, ví dụ: “vn” cho Việt Nam), Tên địa phương (tên quốc gia theo ngôn ngữ bản địa, ví dụ: “Việt Nam”), và Tên quốc tế (theo chuẩn quốc tế, ví dụ: “Viet Nam”).

• Nếu có, bạn có thể tải lên Cờ (biểu tượng quốc kỳ) và "Ảnh" đại diện. Cuối cùng, chọn "Kích hoạt" nếu muốn quốc gia được hiển thị và sử dụng trong hệ thống, sau đó nhấn “Thêm” để lưu thông tin.

Chỉnh sửa / Xoá Quốc gia

Người dùng cũng có thể dễ dàng cập nhật hoặc gỡ bỏ các quốc gia không cần thiết.Tại cột Hành động, chọn Sửa. Giao diện “Sửa quốc gia” tương tự trang thêm mới nhưng đã điền sẵn thông tin. Bạn có thể chỉnh sửa Mã, Tên địa phương, Tên quốc tế, Cờ, Ảnh, Trạng thái kích hoạt… rồi nhấn “Sửa” (hoặc “Lưu”) để cập nhật. Chọn Xoá (biểu tượng thùng rác) để gỡ bỏ quốc gia khỏi hệ thống.

Lưu ý: kiểm tra xem quốc gia này có chứa tỉnh/thành, quận/huyện, xã/phường hay không, vì việc xoá có thể ảnh hưởng dữ liệu liên quan.

Giao diện danh mục Tỉnh/Thành phố

Khi chọn một quốc gia, hệ thống hiển thị danh sách Tỉnh/Thành phố của quốc gia đó:

• Mã: Mã định danh (thường gồm 3 ký tự hoặc 3 số).
• Loại: Loại hành chính (Tỉnh, Thành phố…).
• Tên hiển thị: Tên tỉnh/thành phố.
• Lân cận (nếu có): Liệt kê các địa phương giáp ranh.
• Hành động: Sửa hoặc Xoá.

Hướng dẫn sử dụng

Thêm mới Tỉnh/Thành phố

Để thêm mới một Tỉnh/Thành phố, nhấn nút “Thêm mới” trong khu vực Tỉnh/Thành phố để mở form nhập liệu. Trong form, bạn cần điền các thông tin bắt buộc gồm: Mã (mã định danh, ví dụ: “HCM” hoặc “SGN”), Loại (chọn Tỉnh hoặc Thành phố), và Tên hiển thị (tên chính thức, ví dụ: “Hồ Chí Minh”). Sau khi điền đầy đủ, nhấn “Thêm” để lưu thông tin vào hệ thống.

Lưu ý

• Ở phần danh mục này giao diện chỉnh sửa giống với phần giao diện thêm mới đã hiển thị sẵn thông tin chỉ cần cập nhật lại thông tin.Chọn Xoá (biểu tượng thùng rác) để gỡ bỏ quốc gia khỏi hệ thống.

Giao diện danh mục Quận/Huyện

Trong từng Tỉnh/Thành phố, bạn có thể xem danh sách Quận/Huyện:

• Mã: Mã định danh (thường 4 số).
• Loại: Quận, Huyện, Thị xã…
• Tên hiển thị: Tên quận/huyện.
• Hành động: Sửa hoặc Xoá.

Hướng dẫn sử dụng

Thêm mới quận/huyện

Để thêm mới Quận/Huyện, hãy nhấn nút “Thêm mới” trong khu vực Quận/Huyện để mở form nhập liệu. Trong form, bạn cần điền các thông tin bắt buộc gồm: Mã (mã định danh, ví dụ: “0101”), Loại (chọn Quận hoặc Huyện), và Tên hiển thị (tên quận/huyện). Sau khi điền đầy đủ thông tin, nhấn “Thêm” để lưu vào hệ thống.

Lưu ý

• Ở phần danh mục này giao diện chỉnh sửa giống với phần giao diện thêm mới đã hiển thị sẵn thông tin chỉ cần cập nhật lại thông tin.Chọn Xoá (biểu tượng thùng rác) để gỡ bỏ quốc gia khỏi hệ thống.

Giao diện danh mục Xã/Phường

Tương tự, mỗi Quận/Huyện có danh sách Xã/Phường:

• Loại: Xã, Phường, Thị trấn…
• Tên hiển thị: Tên của xã/phường.
• Hành động: Sửa hoặc Xoá.

Thêm mới phường/xã

Để thêm mới Xã/Phường, nhấn nút “Thêm mới” trong khu vực Xã/Phường để mở form nhập liệu. Sau đó, chọn Loại (chọn giữa Xã, Phường, Thị trấn, v.v.) và nhập Tên hiển thị (bắt buộc, ví dụ: tên của xã/phường). Khi đã điền đầy đủ thông tin, nhấn “Thêm” để lưu vào hệ thống.

Lưu ý

• Ở phần danh mục này giao diện chỉnh sửa giống với phần giao diện thêm mới đã hiển thị sẵn thông tin chỉ cần cập nhật lại thông tin.Chọn Xoá (biểu tượng thùng rác) để gỡ bỏ quốc gia khỏi hệ thống.

Lưu ý

• Phân cấp hợp lý: Đảm bảo cấu trúc Quốc gia -> Tỉnh/Thành phố -> Quận/Huyện -> Xã/Phường rõ ràng, tránh để quá nhiều cấp lồng nhau hoặc bị bỏ sót.
• Mã định danh nhất quán: Sử dụng mã chuẩn hoá (ví dụ: ISO) nếu có, để tránh trùng lặp và hỗ trợ liên kết dữ liệu.
• Kiểm soát xóa: Trước khi xóa một địa phương (quốc gia, tỉnh, huyện…), hãy kiểm tra xem có dữ liệu liên quan (đơn hàng, địa chỉ khách hàng…) đang sử dụng hay không.
• Kích hoạt / Ẩn: Nếu địa phương chưa sẵn sàng, hãy để ở trạng thái “Ẩn” hoặc “Chưa kích hoạt” thay vì xóa, để tránh mất dữ liệu.
• Quyền hạn: Chỉ tài khoản có quyền phù hợp mới có thể thêm, sửa, xóa thông tin địa lý.