Title: Vietnam Store Toolkit for WooCommerce Author: YoOhw Studio Published: 27 Tháng 6, 2026 Last modified: 4 Tháng 10, 2026 --- Tìm kiếm plugin ![](https://ps.w.org/yoohw-vietnam-store-tools/assets/banner-772x250.png?rev=3660088) ![](https://ps.w.org/yoohw-vietnam-store-tools/assets/icon-256x256.png?rev=3660088) # Vietnam Store Toolkit for WooCommerce Bởi [YoOhw Studio](https://profiles.wordpress.org/yoohw/) [Tải về](https://downloads.wordpress.org/plugin/yoohw-vietnam-store-tools.1.2.1.zip) * [Chi tiết](https://vi.wordpress.org/plugins/yoohw-vietnam-store-tools/#description) * [Đánh giá](https://vi.wordpress.org/plugins/yoohw-vietnam-store-tools/#reviews) * [Cài đặt](https://vi.wordpress.org/plugins/yoohw-vietnam-store-tools/#installation) * [Nhà phát triển](https://vi.wordpress.org/plugins/yoohw-vietnam-store-tools/#developers) [Hỗ trợ](https://wordpress.org/support/plugin/yoohw-vietnam-store-tools/) ## Mô tả Vietnam Store Toolkit for WooCommerce bổ sung các trường địa chỉ và thanh toán dành cho Việt Nam, công cụ thanh toán và hóa đơn, vận chuyển và theo dõi, vận hành đơn hàng cùng quy trình di chuyển dữ liệu có hướng dẫn. Plugin hoạt động cùng các luồng thanh toán, đơn hàng và vận chuyển gốc của WooCommerce. Tìm hiểu đầy đủ về plugin tại [website chính thức Vietnam Store Toolkit](https://vietnamstore.org/). #### Liên kết chính thức * [Website Vietnam Store Toolkit](https://vietnamstore.org/) — giới thiệu tổng quan và các tính năng. * [Tài liệu sử dụng](https://vietnamstore.org/documentation/) — yêu cầu hệ thống, cấu hình và ví dụ. * [Hỗ trợ](https://vietnamstore.org/support/) — 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](https://github.com/yoohwz/yoohw-vietnam-store-tools)— 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](https://wordpress.org/plugins/yoohw-vietnam-store-tools/)— nguồn cài đặt công khai chính thức. * [Địa chỉ Việt Nam cho WooCommerce](https://vietnamstore.org/dia-chi-viet-nam-woocommerce/) * [VietQR cho WooCommerce](https://vietnamstore.org/vietqr-woocommerce/) * [Hóa đơn GTGT cho WooCommerce](https://vietnamstore.org/hoa-don-gtgt-woocommerce/) * [Tracking đơn hàng WooCommerce](https://vietnamstore.org/tracking-don-hang-woocommerce/) * [So sánh Classic Checkout và Checkout Blocks](https://vietnamstore.org/classic-checkout-vs-checkout-blocks/) * [Hướng dẫn chuyển dữ liệu địa chỉ WooCommerce](https://vietnamstore.org/chuyen-du-lieu-dia-chi-woocommerce/) #### Tính năng chính * Địa chỉ hai cấp Tỉnh/Thành phố và Phường/Xã trong Classic Checkout, Cart và Checkout Blocks, có hỗ trợ Store API. * Giới hạn đến cấp phường/xã trong WooCommerce Shipping Zones gốc. * Chi tiết thanh toán VietQR cho phương thức Chuyển khoản ngân hàng trực tiếp của WooCommerce. * Tùy chọn quy đổi VND sang USD cho các lượt thanh toán WooCommerce PayPal Payments tương thích bằng tỷ giá do chủ cửa hàng thiết lập. * Tính năng tùy chọn đối soát thanh toán thủ công (mặc định bị tắt), giúp ghi lại bằng chứng mà không tự động đánh dấu đơn hàng là đã thanh toán. * Các trường yêu cầu hóa đơn GTGT và quy trình bàn giao hóa đơn điện tử trung lập với nhà cung cấp. * Các quy tắc tính phí vận chuyển dựa trên địa chỉ, giỏ hàng, trọng lượng, nhóm vận chuyển, miễn phí vận chuyển và điều kiện thanh toán khi nhận hàng (COD). * Thông tin vận đơn, hành trình theo dõi thủ công và trang tra cứu đơn hàng dành cho khách hàng. * Bộ lọc, thao tác hàng loạt và xuất CSV đơn hàng, tương thích HPOS. * Kiểm tra Tình trạng cửa hàng và di chuyển có hướng dẫn cho dữ liệu địa chỉ cũ cùng dữ liệu GHTK tương thích. * Xác thực số điện thoại Việt Nam cùng giao diện, email và thông báo xác thực đã được bản địa hóa. #### Địa chỉ Việt Nam và Checkout Blocks Plugin lưu mã tỉnh/thành phố vào trường `state` của WooCommerce và mã phường/xã vào trường `city`. Plugin xác thực tổ hợp địa chỉ và ẩn mã bưu chính khi phù hợp. Các trường này xuất hiện tại trang thanh toán, Tài khoản và giỏ hàng, cũng như trong địa chỉ cửa hàng, khách hàng và đơn hàng. Trong Cart và Checkout Blocks, danh sách Phường/Xã thay đổi theo Tỉnh/Thành phố đã chọn thông qua Store API, kể cả trên các trang block tùy chỉnh. #### Thanh toán, VietQR và Đối soát VietQR mở rộng tính năng chuyển khoản ngân hàng trực tiếp (`bacs`) của WooCommerce dựa trên các tài khoản ngân hàng đã được cấu hình; nó không tạo ra một cổng thanh toán mới. Thông tin tài khoản ngân hàng và nội dung chuyển khoản được quản lý trong phần cài đặt chuyển khoản ngân hàng mặc định (sử dụng React) của WooCommerce. Các tùy chọn mở rộng của VietQR nằm tại mục Vietnam store > Dashboard. Hình ảnh mã QR và thông tin chi tiết về việc chuyển khoản có thể hiển thị trên trang xác nhận đơn hàng, trong mục Tài khoản của tôi (My Account), trong email và tại khu vực quản trị (wp-admin). VietQR không thực hiện xác nhận giao dịch ngân hàng hay tự động đánh dấu đơn hàng là đã thanh toán. Tính năng đối soát thanh toán bị tắt theo mặc định và có thể được kích hoạt tại mục Vietnam store > Bảng điều khiển (Dashboard) > Các tính năng cốt lõi (Core features). Việc tắt tính năng này sẽ chặn các thao tác ghi nhận đối soát thủ công hoặc từ bên ngoài mới, đồng thời giữ lại lịch sử hiện có ở chế độ chỉ đọc. Khi được kích hoạt, nhân viên có thể ghi lại thông tin chuyển khoản và mã tham chiếu, sau đó thực hiện đối soát thủ công cho số tiền chính xác của đơn hàng ngay trên màn hình đơn hàng. Tính năng Đối soát thanh toán lưu giữ các bằng chứng, lịch sử và thông tin điều chỉnh. Nó không thực hiện hoàn tất thanh toán WooCommerce, không thiết lập ngày thanh toán hay mã giao dịch, không thực hiện hoàn tiền và cũng không thay đổi số lượng tồn kho. Tùy chọn quy đổi VND sang USD cho PayPal yêu cầu thiết lập WooCommerce PayPal Payments tương thích và tỷ giá VND trên mỗi USD do chủ cửa hàng nhập. Tỷ giá được khóa cho từng lượt thanh toán, trong khi đơn hàng WooCommerce vẫn sử dụng VND. Kiểm tra tương thích sẽ ngăn quy đổi khi luồng thanh toán được hỗ trợ không khả dụng; đây không phải công cụ chuyển đổi tiền tệ chung. #### Yêu cầu hóa đơn GTGT và Hóa đơn điện tử Khi bật trong Vietnam store > Tính năng cốt lõi, Classic Checkout và Checkout Blocks có thể thu thập tên công ty, mã số thuế, email nhận hóa đơn và địa chỉ doanh nghiệp. Tính năng này độc lập với việc tính thuế của WooCommerce. Quy trình bàn giao hóa đơn điện tử trung lập với nhà cung cấp theo dõi trạng thái, mã tham chiếu nhà cung cấp, lịch sử chứng từ, tệp PDF/XML và việc gửi email cho khách hàng. Plugin không tự phát hành hóa đơn điện tử hợp pháp hoặc gọi API của nhà cung cấp hóa đơn; việc phát hành vẫn do nhà cung cấp của bạn thực hiệ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. Phần Vận chuyển cho phép nhân viên nhập đơn vị vận chuyển, mã vận đơn và URL theo dõi, gửi email và duy trì hành trình hiển thị cho khách hàng. Các cập nhật được gắn với vận đơn hiện tại; thao tác cũ từ vận đơn đã bị thay thế hoặc hủy sẽ bị từ chối. Theo dõi thủ công trong Core không cần API của hãng vận chuyển. Mẫu URL có thể tạo liên kết theo dõi từ `{tracking_code}`. 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à Tình trạng cửa hàng Màn hình WooCommerce > Đơn hàng có cột Thông tin gọn, các bộ lọc và thao tác hàng loạt phù hợp, cùng chức năng xuất CSV. Nhân viên có thể quản lý bàn giao vận đơn và hóa đơn tại đây; Đối soát thanh toán vẫn nằm trên màn hình đơn hàng. Các công cụ này hỗ trợ HPOS và cả lưu trữ đơn hàng kiểu cũ. Tình trạng cửa hàng hiển thị mức độ sẵn sàng của cấu hình và cho phép nhân viên chủ động quét dữ liệu cũ. Việc mở trang này không tự quét hay di chuyển đơn hàng hoặc khách hàng. Quá trình di chuyển chỉ bắt đầu sau thao tác của chủ cửa hàng: quét, xem báo cáo, sao lưu dữ liệu, rồi đồng bộ dữ liệu tương thích theo từng lô. Dữ liệu không rõ ràng cần được xem xét thủ công. #### Di chuyển và dữ liệu Các công cụ di chuyển hỗ trợ dữ liệu địa chỉ cũ và dữ liệu theo dõi GHTK tương thích từ plugin của Le Van Toan. Hãy xem báo cáo quét 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. Plugin không lưu thông tin đăng nhập PayPal riêng. Khi bật quy đổi, tiện ích WooCommerce PayPal Payments đã cài đặt vẫn giao tiếp với PayPal theo cấu hình riêng của tiện ích; plugin này chỉ tham gia vào luồng quy đổi số tiền và tiền tệ có cơ chế bảo vệ. ## Khối Plugin này cung cấp 1 khối. * Vietnam Order Tracking Order lookup by order number and customer email or phone number. ## Cài đặt 1. Cài đặt và kích hoạt WooCommerce. 2. Cài và kích hoạt Vietnam Store Toolkit for WooCommerce. 3. Kiểm tra khu vực bán hàng, địa chỉ cửa hàng và các cài đặt Vietnam store. 4. Cấu hình Chuyển khoản ngân hàng trực tiếp và VietQR nếu bạn sử dụng chuyển khoản ngân hàng. 5. Chỉ cấu hình quy đổi PayPal khi bạn đang sử dụng thiết lập WooCommerce PayPal Payments tương thích. 6. Bật yêu cầu hóa đơn và cấu hình vùng vận chuyển, quy tắc phí cùng theo dõi vận chuyển theo nhu cầu. 7. Mở Tình trạng cửa hàng và chạy quét thủ công trước khi di chuyển dữ liệu cũ. Xem [Tài liệu sử dụng](https://vietnamstore.org/documentation/) để biết hướng dẫn thiết lập chi tiết. ## Hỏi đáp ### Plugin có hỗ trợ Cart và Checkout Blocks không? Có. Plugin hỗ trợ Tỉnh/Thành, Phường/Xã, hóa đơn GTGT, xác thực số điện thoại, VietQR và thông tin vận chuyển. WooCommerce 8.9 trở lên được yêu cầu. ### Plugin lưu địa chỉ Việt Nam như thế nào? Mã tỉnh/thành phố được lưu vào `state`; mã phường/xã/đặc khu được lưu vào `city` của WooCommerce. ### Khách hàng có thể yêu cầu hóa đơn GTGT không? Có, khi “Nhận yêu cầu hóa đơn tại trang thanh toán” được bật trong Vietnam store > Tính năng cốt lõi. ### VietQR có tự xác nhận thanh toán không? Không. VietQR được thêm vào Direct bank transfer nhưng không kết nối giao dịch ngân hàng. ### Đối soát thanh toán có đánh dấu đơn hàng là đã thanh toán không? Không. Tính năng này chỉ ghi nhận và đối soát bằng chứng thanh toán, không hoàn tất thanh toán WooCommerce hoặc thay đổi trạng thái đã thanh toán của đơn hàng. ### Quy đổi VND sang USD cho PayPal có thay đổi tiền tệ của đơn hàng WooCommerce không? Không. Đơn hàng vẫn sử dụng VND; lượt thanh toán PayPal tương thích sử dụng luồng quy đổi sang USD có cơ chế bảo vệ. ### Tình trạng cửa hàng có tự động quét hoặc di chuyển dữ liệu cửa hàng của tôi không? Không. Việc mở Tình trạng cửa hàng là an toàn; thao tác quét và di chuyển dữ liệu đều chỉ được thực hiện khi chủ cửa hàng chủ động xác nhận. ### Tôi cấu hình phí vận chuyển đến cấp phường/xã ở đâu? Truy cập WooCommerce > Cài đặt > Vận chuyển và mở một khu vực. Trong phần khu vực, mở rộng Việt Nam và một Tỉnh/Thành phố, sau đó chọn một hoặc nhiều con Phường/Xã để hạn chế mọi phương pháp trong khu vực đó. Để tính các khoản phí khác nhau với các điều kiện bổ sung về giỏ hàng hoặc sản phẩm, hãy thêm “Quy tắc phí vận chuyển” vào khu vực. ### Tôi tạo trang tra cứu đơn hàng như thế nào? Thêm block “Tra cứu đơn hàng” hoặc shortcode `[yoohw_order_tracking]` vào một trang. ### Plugin có tích hợp sẵn API hãng vận chuyển không? Không. Bản công khai cung cấp tracking không cần API và khung cho trình kết nối riêng. ### Plugin có hỗ trợ HPOS và tiếng Việt không? Có. Plugin tương thích HPOS và bao gồm bản dịch tiếng Việt cho giao diện, email cùng thông báo xác thực. ## Đánh giá Không có đánh giá nào cho plugin này. ## Người đóng góp & Lập trình viên “Vietnam Store Toolkit for WooCommerce” là mã nguồn mở. Những người sau đã đóng góp vào plugin này. Những người đóng góp * [ YoOhw Studio ](https://profiles.wordpress.org/yoohw/) * [ B.Ng ](https://profiles.wordpress.org/baonguyen0310/) “Vietnam Store Toolkit for WooCommerce” đã được dịch qua 1 ngôn ngữ. Cảm ơn [những người tham gia dịch](https://translate.wordpress.org/projects/wp-plugins/yoohw-vietnam-store-tools/contributors) vì đóng góp của họ. [Dịch “Vietnam Store Toolkit for WooCommerce” sang ngôn ngữ của bạn.](https://translate.wordpress.org/projects/wp-plugins/yoohw-vietnam-store-tools) ### Muốn tham gia phát triển? [Duyệt code](https://plugins.trac.wordpress.org/browser/yoohw-vietnam-store-tools/), check out [SVN repository](https://plugins.svn.wordpress.org/yoohw-vietnam-store-tools/), hoặc theo dõi [nhật ký phát triển](https://plugins.trac.wordpress.org/log/yoohw-vietnam-store-tools/) qua [RSS](https://plugins.trac.wordpress.org/log/yoohw-vietnam-store-tools/?limit=100&mode=stop_on_copy&format=rss). ## Nhật ký thay đổi #### 1.2.1 (04/10/2026) * Sửa lỗi: Cho phép cập nhật đơn hàng WooCommerce bình thường khi ô mã vận đơn thủ công để trống; thao tác lưu mã vận đơn riêng vẫn yêu cầu mã vận đơn. * Cải thiện: Giữ giao diện cài đặt Chuyển khoản ngân hàng (BACS) dạng React nguyên bản của WooCommerce, chuyển các tùy chọn VietQR mở rộng sang Bảng điều khiển Vietnam store, giữ nguyên các cài đặt BACS của WooCommerce và bên thứ ba, đồng thời ưu tiên mã BIN hiện tại được chọn trong React thay cho Sort code cũ. * Sửa lỗi: Cải thiện chẩn đoán trạng thái sẵn sàng của WooCommerce PayPal Payments để trạng thái chưa khởi tạo/chưa đánh giá không bị báo nhầm là không tương thích; các kiểm tra bộ tích hợp nay chỉ ra đúng điểm không đáp ứng hợp đồng tích hợp và luồng chuyển đổi vẫn dừng an toàn khi chưa xác minh được tương thích. * Cập nhật: Thêm công tắc Đối soát thanh toán trong Tính năng cốt lõi, mặc định TẮT; khi tắt, plugin chặn mọi lần ghi dữ liệu đối soát mới từ thao tác thủ công hoặc nguồn bên ngoài nhưng vẫn giữ lịch sử hiện có ở chế độ chỉ đọc. * Sửa lỗi: Sửa liên kết Cài đặt email của quy trình hóa đơn điện tử để mở đúng trang cài đặt cho email WooCommerce đã đăng ký. * Chất lượng: Mở rộng kiểm thử hồi quy trên Local và các môi trường thử nghiệm tạm thời ở cả chế độ lưu trữ cũ (legacy) và HPOS; tăng cường cô lập dữ liệu kiểm thử, xác minh dọn dẹp và chứng nhận các thay đổi sau 1.2.0. Xem lịch sử thay đổi chi tiết trong `changelog.txt`. ## Meta * Phiên bản **1.2.1** * Cập nhật lần cuối **1 tuần trước** * Số lượt cài đặt **20+** * Phiên bản WordPress ** 6.3 hoặc cao hơn ** * Đã kiểm tra lên đến **7.1.3** * Phiên bản PHP ** 7.4 hoặc cao hơn ** * Ngôn ngữ * [English (US)](https://wordpress.org/plugins/yoohw-vietnam-store-tools/) và [Vietnamese](https://vi.wordpress.org/plugins/yoohw-vietnam-store-tools/). * [Dịch sang ngôn ngữ của bạn](https://translate.wordpress.org/projects/wp-plugins/yoohw-vietnam-store-tools) * Thẻ * [checkout blocks](https://vi.wordpress.org/plugins/tags/checkout-blocks/)[shipping](https://vi.wordpress.org/plugins/tags/shipping/) [vietnam](https://vi.wordpress.org/plugins/tags/vietnam/)[vietqr](https://vi.wordpress.org/plugins/tags/vietqr/) [woocommerce](https://vi.wordpress.org/plugins/tags/woocommerce/) * [Nâng cao](https://vi.wordpress.org/plugins/yoohw-vietnam-store-tools/advanced/) ## Đánh giá Chưa có đánh giá nào được gửi. [Your review](https://wordpress.org/support/plugin/yoohw-vietnam-store-tools/reviews/#new-post) [Xem tất cả đánh giá](https://wordpress.org/support/plugin/yoohw-vietnam-store-tools/reviews/) ## Những người đóng góp * [ YoOhw Studio ](https://profiles.wordpress.org/yoohw/) * [ B.Ng ](https://profiles.wordpress.org/baonguyen0310/) ## Hỗ trợ Có điều gì muốn nói? cần giúp đỡ? [Xem diễn đàn hỗ trợ](https://wordpress.org/support/plugin/yoohw-vietnam-store-tools/)