{"id":331095,"date":"2026-06-27T13:51:45","date_gmt":"2026-06-27T13:51:45","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/vietnam-commerce-kit-for-woocommerce\/"},"modified":"2026-08-14T15:32:35","modified_gmt":"2026-08-14T15:32:35","slug":"yoohw-vietnam-store-tools","status":"publish","type":"plugin","link":"https:\/\/bal.wordpress.org\/plugins\/yoohw-vietnam-store-tools\/","author":21137534,"comment_status":"closed","ping_status":"closed","template":"","meta":{"version":"1.1.3","stable_tag":"1.1.3","tested":"7.0.4","requires":"6.3","requires_php":"7.4","requires_plugins":null,"header_name":"Vietnam Store Toolkit for WooCommerce","header_author":"YoOhw Studio","header_description":"Vietnam store toolkit for WooCommerce address fields, checkout UX, VAT invoice requests, VietQR bank transfer, and phone normalization.","assets_banners_color":"c62602","last_updated":"2026-08-14 15:32:35","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"https:\/\/vietnamstore.org\/","header_author_uri":"https:\/\/yoohw.com","rating":0,"author_block_rating":0,"active_installs":10,"downloads":569,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"1.0.0":{"tag":"1.0.0","author":"yoohw","date":"2026-06-27 13:51:24"},"1.0.1":{"tag":"1.0.1","author":"yoohw","date":"2026-06-28 14:47:12"},"1.0.2":{"tag":"1.0.2","author":"yoohw","date":"2026-07-16 04:24:58"},"1.1.0":{"tag":"1.1.0","author":"yoohw","date":"2026-07-18 01:28:22"},"1.1.1":{"tag":"1.1.1","author":"yoohw","date":"2026-07-26 03:12:58"},"1.1.2":{"tag":"1.1.2","author":"yoohw","date":"2026-08-02 01:31:55"},"1.1.3":{"tag":"1.1.3","author":"yoohw","date":"2026-08-14 15:32:35"}},"upgrade_notice":[],"ratings":[],"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":3588156,"resolution":"128x128","location":"assets","locale":"","width":128,"height":128},"icon-256x256.png":{"filename":"icon-256x256.png","revision":3588156,"resolution":"256x256","location":"assets","locale":"","width":256,"height":256}},"assets_banners":{"banner-1544x500.png":{"filename":"banner-1544x500.png","revision":3588156,"resolution":"1544x500","location":"assets","locale":"","width":1544,"height":500},"banner-772x250.png":{"filename":"banner-772x250.png","revision":3588156,"resolution":"772x250","location":"assets","locale":"","width":772,"height":250}},"assets_blueprints":{},"all_blocks":{"yoohw-vietnam-store-tools\/order-tracking":{"apiVersion":3,"name":"yoohw-vietnam-store-tools\/order-tracking","version":"1.1.3","title":"Vietnam Order Tracking","category":"woocommerce","icon":"location-alt","description":"Order lookup by order number and customer email or phone number.","textdomain":"yoohw-vietnam-store-tools","editorScript":"file:.\/index.js","supports":{"html":false}}},"tagged_versions":["1.0.0","1.0.1","1.0.2","1.1.0","1.1.1","1.1.2","1.1.3"],"block_files":[],"assets_screenshots":[],"screenshots":[]},"plugin_section":[],"plugin_tags":[232945,3546,39081,200631,286],"plugin_category":[45],"plugin_contributors":[223813,223812],"plugin_business_model":[],"class_list":["post-331095","plugin","type-plugin","status-publish","hentry","plugin_tags-checkout-blocks","plugin_tags-shipping","plugin_tags-vietnam","plugin_tags-vietqr","plugin_tags-woocommerce","plugin_category-ecommerce","plugin_contributors-baonguyen0310","plugin_contributors-yoohw","plugin_committers-yoohw"],"banners":{"banner":"https:\/\/ps.w.org\/yoohw-vietnam-store-tools\/assets\/banner-772x250.png?rev=3588156","banner_2x":"https:\/\/ps.w.org\/yoohw-vietnam-store-tools\/assets\/banner-1544x500.png?rev=3588156","banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/yoohw-vietnam-store-tools\/assets\/icon-128x128.png?rev=3588156","icon_2x":"https:\/\/ps.w.org\/yoohw-vietnam-store-tools\/assets\/icon-256x256.png?rev=3588156","generated":false},"screenshots":[],"raw_content":"<!--section=description-->\n<p>Vietnam Store Toolkit for WooCommerce adds essential tools for stores in Vietnam: province\/city and ward\/commune addresses, VietQR, VAT invoices, phone numbers, shipping fees, tracking numbers, and order tracking.<\/p>\n\n<p>Learn more about the plugin on the <a href=\"https:\/\/vietnamstore.org\/\">official Vietnam Store Toolkit website<\/a>.<\/p>\n\n<h4>Official Links<\/h4>\n\n<ul>\n<li><a href=\"https:\/\/vietnamstore.org\/\">Vietnam Store Toolkit Website<\/a> \u2014 overview and features.<\/li>\n<li><a href=\"https:\/\/vietnamstore.org\/documentation\/\">Documentation<\/a> \u2014 system requirements, configuration, and examples.<\/li>\n<li><a href=\"https:\/\/vietnamstore.org\/support\/\">Support<\/a> \u2014 official support resources and instructions for submitting requests.<\/li>\n<li><a href=\"https:\/\/github.com\/yoohwz\/yoohw-vietnam-store-tools\">Source Code and Development on GitHub<\/a> \u2014 view the code, report issues, suggest features, and submit pull requests.<\/li>\n<li><a href=\"https:\/\/wordpress.org\/plugins\/yoohw-vietnam-store-tools\/\">WordPress.org Release<\/a> \u2014 the official public installation source.<\/li>\n<li><a href=\"https:\/\/vietnamstore.org\/dia-chi-viet-nam-woocommerce\/\">Vietnamese Addresses for WooCommerce<\/a><\/li>\n<li><a href=\"https:\/\/vietnamstore.org\/vietqr-woocommerce\/\">VietQR for WooCommerce<\/a><\/li>\n<li><a href=\"https:\/\/vietnamstore.org\/hoa-don-gtgt-woocommerce\/\">VAT Invoices for WooCommerce<\/a><\/li>\n<li><a href=\"https:\/\/vietnamstore.org\/tracking-don-hang-woocommerce\/\">WooCommerce Order Tracking<\/a><\/li>\n<li><a href=\"https:\/\/vietnamstore.org\/classic-checkout-vs-checkout-blocks\/\">Classic Checkout vs. Checkout Blocks<\/a><\/li>\n<li><a href=\"https:\/\/vietnamstore.org\/chuyen-du-lieu-dia-chi-woocommerce\/\">WooCommerce Address Data Migration Guide<\/a><\/li>\n<\/ul>\n\n<h4>Key Features<\/h4>\n\n<ul>\n<li>Two-tier addresses covering 34 provinces\/cities and 3,321 wards\/communes\/special zones.<\/li>\n<li>Province\/city-dependent ward\/commune lists in Classic Checkout, Cart, and Checkout Blocks.<\/li>\n<li>VAT invoice requests and a provider-neutral electronic invoicing workflow.<\/li>\n<li>VietQR for WooCommerce Direct bank transfer.<\/li>\n<li>Vietnamese phone number normalization and validation.<\/li>\n<li>Shipping fee rules based on address, cart, weight, shipping class, free shipping, and COD.<\/li>\n<li>Tracking numbers, a manual timeline, and an order tracking page with no carrier API required.<\/li>\n<li>HPOS-compatible order filters, bulk actions, and CSV exports.<\/li>\n<\/ul>\n\n<h4>Vietnamese Addresses and Checkout Blocks<\/h4>\n\n<p>The plugin stores province\/city codes in WooCommerce's <code>state<\/code> field and ward\/commune codes in its <code>city<\/code> field, and hides the postcode when appropriate. Address combinations are validated before they are saved, and ward\/commune lists are loaded only when needed.<\/p>\n\n<p>The fields are applied to checkout, My Account, the cart, store addresses, customer profiles, and orders in wp-admin. In Cart and Checkout Blocks, Ward\/Commune is a Province\/City-dependent list that synchronizes directly with the Store API, including on custom block pages.<\/p>\n\n<h4>VAT Invoices and VietQR<\/h4>\n\n<p>The invoice request feature is enabled independently under Vietnam store &gt; Core features and does not depend on WooCommerce tax calculation. Classic Checkout and Checkout Blocks can collect the company name, tax identification number, invoice email address, and company address.<\/p>\n\n<p>The electronic invoicing workflow stores the status, number\/series, issue date, lookup URL, provider, PDF\/XML files, and change log. The plugin does not issue invoices itself or call a provider API.<\/p>\n\n<p>VietQR is added to WooCommerce Direct bank transfer (<code>bacs<\/code>) and does not create a new payment gateway. The QR image and transfer details can appear on the order confirmation page, in My Account, in emails, and in wp-admin. The plugin does not confirm transactions or automatically mark orders as paid.<\/p>\n\n<h4>Shipping Fees and Order Tracking<\/h4>\n\n<p>The \u201cShipping Fee Rules\u201d method works within WooCommerce Shipping Zones. Rules are evaluated from top to bottom and can be based on province\/city, ward\/commune, cart total, weight, shipping class, fee, free-shipping threshold, and COD. The editor supports sorting and UTF-8 CSV import\/export.<\/p>\n\n<p>The Shipping panel lets you enter a carrier, tracking number, and tracking URL; send an email; and maintain a manual timeline. URL templates generate links from <code>{tracking_code}<\/code>, and administrators can also define custom carriers.<\/p>\n\n<p>Add the \u201cOrder Tracking\u201d block or <code>[yoohw_order_tracking]<\/code> shortcode to let customers look up orders using the order number together with their billing email address or phone number. Results do not display addresses, products, totals, or contact details.<\/p>\n\n<h4>Order Management and HPOS<\/h4>\n\n<p>The WooCommerce &gt; Orders screen includes a compact Information column for invoice and tracking details, advanced filters, actions to resend tracking emails and update carriers, CSV exports, and handoff progress controls. The plugin uses the WooCommerce order API and supports both HPOS and legacy storage.<\/p>\n\n<h4>Migration and Data<\/h4>\n\n<p>WooCommerce Status Tools can scan, back up, and batch-synchronize legacy addresses and GHTK data from Le Van Toan's plugin. Run the scan tool and review its report before synchronizing.<\/p>\n\n<p>The 2026-07 administrative dataset is based on the National Statistics Office of Viet Nam through Vietnam Provinces API v2. The bank and BIN lists are based on the VietQR bank list API. Sources and update procedures are documented in <code>data\/SOURCES.md<\/code>.<\/p>\n\n<h4>External Services and Privacy<\/h4>\n\n<p>Source APIs are used only to build static data; the plugin does not call them at runtime. When VietQR is enabled, the browser or email client loads the QR image from VietQR.io by CASSO. The image URL may contain the BIN, account number, QR template, amount, transfer description, and account holder name.<\/p>\n\n<ul>\n<li>Service: https:\/\/vietqr.io\/<\/li>\n<li>Documentation: https:\/\/vietqr.io\/danh-sach-api\/link-tao-ma-nhan\/<\/li>\n<li>Terms: https:\/\/casso.vn\/thoa-thuan-su-dung-phan-mem\/<\/li>\n<li>Privacy: https:\/\/casso.vn\/chinh-sach-bao-mat-thong-tin\/<\/li>\n<\/ul>\n\n<p>Address, phone, invoice, and shipping data is stored in the store's WordPress\/WooCommerce installation. The plugin does not add analytics, advertising, or remote data collection services.<\/p>\n\n<!--section=installation-->\n<ol>\n<li>Install and activate WooCommerce.<\/li>\n<li>Install and activate Vietnam Store Toolkit for WooCommerce.<\/li>\n<li>Review your selling locations and store address in WooCommerce settings.<\/li>\n<li>Configure Direct bank transfer if you need VietQR.<\/li>\n<li>If you need invoices, enable \u201cAccept invoice requests at checkout\u201d under Vietnam store &gt; Core features.<\/li>\n<li>If you need address-based fees, add \u201cShipping Fee Rules\u201d to a Shipping Zone.<\/li>\n<li>If you are migrating from Le Van Toan's plugin, run the scan tool before synchronizing.<\/li>\n<\/ol>\n\n<!--section=faq-->\n<dl>\n<dt id=\"does%20the%20plugin%20support%20cart%20and%20checkout%20blocks%3F\"><h3>Does the plugin support Cart and Checkout Blocks?<\/h3><\/dt>\n<dd><p>Yes. The plugin supports Province\/City and Ward\/Commune fields, VAT invoices, phone number validation, VietQR, and shipping information. WooCommerce 8.9 or later is required.<\/p><\/dd>\n<dt id=\"how%20does%20the%20plugin%20store%20vietnamese%20addresses%3F\"><h3>How does the plugin store Vietnamese addresses?<\/h3><\/dt>\n<dd><p>Province\/city codes are stored in WooCommerce's <code>state<\/code> field; ward\/commune\/special-zone codes are stored in its <code>city<\/code> field.<\/p><\/dd>\n<dt id=\"can%20customers%20request%20vat%20invoices%3F\"><h3>Can customers request VAT invoices?<\/h3><\/dt>\n<dd><p>Yes, when \u201cAccept invoice requests at checkout\u201d is enabled under Vietnam store &gt; Core features.<\/p><\/dd>\n<dt id=\"does%20vietqr%20automatically%20confirm%20payments%3F\"><h3>Does VietQR automatically confirm payments?<\/h3><\/dt>\n<dd><p>No. VietQR is added to Direct bank transfer but does not connect to bank transactions.<\/p><\/dd>\n<dt id=\"where%20do%20i%20configure%20shipping%20fees%20at%20the%20ward%2Fcommune%20level%3F\"><h3>Where do I configure shipping fees at the ward\/commune level?<\/h3><\/dt>\n<dd><p>Go to WooCommerce &gt; Settings &gt; Shipping, open a zone, and add \u201cShipping Fee Rules.\u201d<\/p><\/dd>\n<dt id=\"how%20do%20i%20create%20an%20order%20tracking%20page%3F\"><h3>How do I create an order tracking page?<\/h3><\/dt>\n<dd><p>Add the \u201cOrder Tracking\u201d block or <code>[yoohw_order_tracking]<\/code> shortcode to a page.<\/p><\/dd>\n<dt id=\"does%20the%20plugin%20include%20carrier%20api%20integrations%3F\"><h3>Does the plugin include carrier API integrations?<\/h3><\/dt>\n<dd><p>No. The public release provides API-free tracking and a framework for custom connectors.<\/p><\/dd>\n<dt id=\"does%20the%20plugin%20support%20hpos%20and%20vietnamese%3F\"><h3>Does the plugin support HPOS and Vietnamese?<\/h3><\/dt>\n<dd><p>Yes. The plugin is HPOS-compatible and includes Vietnamese translations for the interface, emails, and validation messages.<\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>1.1.3 (August 14, 2026)<\/h4>\n\n<ul>\n<li>Improve: Collapsed the Create shipment and Add shipment journey event forms in the order Shipping metabox, keeping the interface compact while preserving keyboard-accessible toggles.<\/li>\n<li>Fix: Kept manually added shipment journey events visible in the order metabox after saving.<\/li>\n<li>Update: Refined the customer-facing Order Tracking status row: Core hides it when no journey event exists, while connector-provided status information remains available.<\/li>\n<li>Developer: Added an extension point that lets shipping connectors append journey events without replacing their detailed carrier status.<\/li>\n<\/ul>\n\n<p>See <code>changelog.txt<\/code> for the complete change history.<\/p>","raw_excerpt":"A Vietnam-focused WooCommerce toolkit for two-tier addresses, Checkout Blocks, VietQR, VAT invoices, shipping fees, and order tracking.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/bal.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/331095","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/bal.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/bal.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/bal.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=331095"}],"author":[{"embeddable":true,"href":"https:\/\/bal.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/yoohw"}],"wp:attachment":[{"href":"https:\/\/bal.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=331095"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/bal.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=331095"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/bal.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=331095"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/bal.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=331095"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/bal.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=331095"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/bal.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=331095"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}