Vietnam Store Toolkit for WooCommerce

Mô tả

Vietnam Store Toolkit for WooCommerce bổ sung các công cụ cần thiết cho cửa hàng tại Việt Nam: địa chỉ tỉnh/thành phố và phường/xã, VietQR, hóa đơn GTGT, số điện thoại, phí vận chuyển, mã vận đơn và tra cứu đơn hàng.

Tìm hiểu đầy đủ về plugin tại website chính thức Vietnam Store Toolkit.

Liên kết chính thức

• Website Vietnam Store Toolkit — giới thiệu tổng quan và các tính năng.
• Tài liệu sử dụng — yêu cầu hệ thống, cấu hình và ví dụ.
• Hỗ trợ — nguồn hỗ trợ chính thức và cách gửi yêu cầu.
• Mã nguồn và phát triển trên GitHub — xem code, báo lỗi, đề xuất tính năng và pull request.
• Bản phát hành trên WordPress.org — nguồn cài đặt công khai chính thức.
• Địa chỉ Việt Nam cho WooCommerce
• VietQR cho WooCommerce
• Hóa đơn GTGT cho WooCommerce
• Tracking đơn hàng WooCommerce
• So sánh Classic Checkout và Checkout Blocks
• Hướng dẫn chuyển dữ liệu địa chỉ WooCommerce

Tính năng chính

• Địa chỉ hai cấp gồm 34 tỉnh/thành phố và 3.321 phường/xã/đặc khu.
• Danh sách Phường/Xã phụ thuộc Tỉnh/Thành trong Classic Checkout, Cart và Checkout Blocks.
• Cấu trúc phân cấp khu vực vận chuyển WooCommerce nguyên bản, với các phường/xã nằm bên dưới tỉnh/thành phố tương ứng.
• Yêu cầu hóa đơn GTGT và quy trình hóa đơn điện tử trung lập nhà cung cấp.
• VietQR cho WooCommerce Direct bank transfer.
• Chuẩn hóa và xác thực số điện thoại Việt Nam.
• Quy tắc phí vận chuyển theo địa chỉ, giỏ hàng, khối lượng, shipping class, miễn phí vận chuyển và COD.
• Mã vận đơn, timeline thủ công và trang tra cứu đơn hàng không cần API hãng vận chuyển.
• Bộ lọc, thao tác hàng loạt và xuất CSV đơn hàng, tương thích HPOS.

Địa chỉ Việt Nam và Checkout Blocks

Plugin lưu mã tỉnh/thành phố vào state và mã phường/xã vào city của WooCommerce, đồng thời ẩn mã bưu chính khi phù hợp. Tổ hợp địa chỉ được xác thực trước khi lưu và danh sách phường/xã chỉ tải khi cần.

Các trường được áp dụng cho checkout, My Account, giỏ hàng, địa chỉ cửa hàng, hồ sơ khách hàng và đơn hàng trong wp-admin. Trong Cart và Checkout Blocks, Phường/Xã là danh sách phụ thuộc Tỉnh/Thành và đồng bộ trực tiếp với Store API, kể cả trên trang block tùy chỉnh.

Hóa đơn GTGT và VietQR

Tính năng nhận yêu cầu hóa đơn được bật độc lập trong Vietnam store > Tính năng cốt lõi và không phụ thuộc vào việc tính thuế của WooCommerce. Classic Checkout và Checkout Block có thể thu thập tên công ty, mã số thuế, email nhận hóa đơn và địa chỉ công ty.

Quy trình hóa đơn điện tử lưu trạng thái, số/ký hiệu, ngày phát hành, URL tra cứu, nhà cung cấp, tệp PDF/XML và nhật ký thay đổi. Plugin không tự phát hành hóa đơn hoặc gọi API nhà cung cấp.

VietQR được thêm vào WooCommerce Direct bank transfer (bacs), không tạo cổng thanh toán mới. Ảnh QR và thông tin chuyển khoản có thể xuất hiện trên trang xác nhận đơn hàng, My Account, email và wp-admin. Plugin không xác nhận giao dịch hoặc tự đánh dấu đơn đã thanh toán.

Phí vận chuyển và tracking đơn hàng

Các Vùng vận chuyển (Shipping Zones) mặc định của WooCommerce có thể được giới hạn cụ thể đến một hoặc nhiều phường/xã tại Việt Nam thông qua cấu trúc phân cấp khu vực có sẵn; tại đây, mỗi phường/xã được xem là cấp con của tỉnh/thành phố tương ứng. Các quy định giới hạn theo phường/xã sẽ áp dụng cho mọi phương thức vận chuyển trong vùng đó và hoạt động kết hợp với các thiết lập về quốc gia, tỉnh/thành phố và mã bưu chính của vùng. WooCommerce sẽ kiểm tra các vùng vận chuyển theo thứ tự đã được cấu hình, do đó bạn nên đặt các vùng dành riêng cho phường/xã ở vị trí phía trên so với các vùng dự phòng có phạm vi rộng hơn.

Việc tắt plugin sẽ loại bỏ tính năng giới hạn theo cấp phường/xã: các vùng kết hợp (mixed zones) sẽ quay về phạm vi quốc gia, tỉnh/thành phố, châu lục và mã bưu chính gốc, trong khi các vùng chỉ giới hạn theo phường/xã sẽ ngừng khớp dữ liệu cho đến khi plugin được kích hoạt lại. Việc bật/tắt tính năng tách riêng trường địa chỉ kiểu Việt Nam sẽ không xóa hay vô hiệu hóa các thiết lập giới hạn theo phường/xã đã lưu.

Phương thức “Quy tắc phí vận chuyển” hoạt động trong WooCommerce Shipping Zones. Quy tắc được kiểm tra từ trên xuống dưới và có thể dựa trên tỉnh/thành phố, phường/xã, tổng giỏ hàng, khối lượng, shipping class, phí, ngưỡng miễn phí và COD. Trình chỉnh sửa hỗ trợ sắp xếp cùng nhập/xuất CSV UTF-8.

Hộp Vận chuyển cho phép nhập hãng, mã vận đơn, URL theo dõi, gửi email và ghi timeline thủ công. Mẫu URL tự tạo liên kết từ {tracking_code}; quản trị viên cũng có thể khai báo hãng tùy chỉnh.

Thêm block “Tra cứu đơn hàng” hoặc shortcode [yoohw_order_tracking] để khách tra cứu bằng mã đơn cùng email hoặc số điện thoại thanh toán. Kết quả không hiển thị địa chỉ, sản phẩm, tổng tiền hay thông tin liên hệ.

Quản lý đơn hàng và HPOS

Màn hình WooCommerce > Đơn hàng có cột Thông tin gọn cho hóa đơn và vận đơn, bộ lọc nâng cao, thao tác gửi lại email tracking, cập nhật hãng, xuất CSV và đánh dấu tiến độ bàn giao. Plugin dùng API đơn hàng WooCommerce, tương thích HPOS và chế độ lưu trữ cũ.

Di chuyển và dữ liệu

WooCommerce Status Tools có thể quét, sao lưu và đồng bộ theo lô địa chỉ cũ cùng dữ liệu GHTK từ plugin của Le Van Toan. Hãy chạy công cụ quét và xem báo cáo trước khi đồng bộ.

Dữ liệu hành chính phiên bản 2026-07 dựa trên National Statistics Office of Viet Nam thông qua Vietnam Provinces API v2. Danh sách ngân hàng và BIN dựa trên VietQR bank list API. Nguồn và quy trình cập nhật được ghi trong data/SOURCES.md.

Dịch vụ bên ngoài và quyền riêng tư

Các API nguồn chỉ được dùng để xây dựng dữ liệu tĩnh; plugin không gọi chúng trong thời gian chạy. Khi VietQR được bật, trình duyệt hoặc trình đọc email tải ảnh QR từ VietQR.io by CASSO. URL ảnh có thể chứa BIN, số tài khoản, mẫu QR, số tiền, nội dung chuyển khoản và tên chủ tài khoản.

• Dịch vụ: https://vietqr.io/
• Tài liệu: https://vietqr.io/danh-sach-api/link-tao-ma-nhan/
• Điều khoản: https://casso.vn/thoa-thuan-su-dung-phan-mem/
• Quyền riêng tư: https://casso.vn/chinh-sach-bao-mat-thong-tin/

Dữ liệu địa chỉ, điện thoại, hóa đơn và vận chuyển được lưu trong WordPress/WooCommerce của cửa hàng. Plugin không thêm phân tích, quảng cáo hoặc dịch vụ thu thập dữ liệu từ xa.