Vietnam Store Toolkit for WooCommerce

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. Learn more about the plugin on the official Vietnam Store Toolkit website. Official Links

• Vietnam Store Toolkit Website — overview and features.
• Documentation — system requirements, configuration, and examples.
• Support — official support resources and instructions for submitting requests.
• Source Code and Development on GitHub — view the code, report issues, suggest features, and submit pull requests.
• WordPress.org Release — the official public installation source.
• Vietnamese Addresses for WooCommerce
• VietQR for WooCommerce
• VAT Invoices for WooCommerce
• WooCommerce Order Tracking
• Classic Checkout vs. Checkout Blocks
• WooCommerce Address Data Migration Guide

Key Features

• Two-tier addresses covering 34 provinces/cities and 3,321 wards/communes/special zones.
• Province/city-dependent ward/commune lists in Classic Checkout, Cart, and Checkout Blocks.
• VAT invoice requests and a provider-neutral electronic invoicing workflow.
• VietQR for WooCommerce Direct bank transfer.
• Vietnamese phone number normalization and validation.
• Shipping fee rules based on address, cart, weight, shipping class, free shipping, and COD.
• Tracking numbers, a manual timeline, and an order tracking page with no carrier API required.
• HPOS-compatible order filters, bulk actions, and CSV exports.

What's New in Version 1.1.2 Version 1.1.2 expands shipping update emails with essential shipment status and tracking details, fixes missing website names in subject lines, and adds an email for sending electronic invoices. Vietnamese Addresses and Checkout Blocks The plugin stores province/city codes in WooCommerce's state field and ward/commune codes in its city field, and hides the postcode when appropriate. Address combinations are validated before they are saved, and ward/commune lists are loaded only when needed. 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. VAT Invoices and VietQR The invoice request feature is enabled independently under Vietnam store > 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. 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. VietQR is added to WooCommerce Direct bank transfer (bacs) 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. Shipping Fees and Order Tracking The “Shipping Fee Rules” 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. 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 {tracking_code}, and administrators can also define custom carriers. Add the “Order Tracking” block or [yoohw_order_tracking] 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. Order Management and HPOS The WooCommerce > 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. Migration and Data 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. 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 data/SOURCES.md. External Services and Privacy 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.

• Service: https://vietqr.io/
• Documentation: https://vietqr.io/danh-sach-api/link-tao-ma-nhan/
• Terms: https://casso.vn/thoa-thuan-su-dung-phan-mem/
• Privacy: https://casso.vn/chinh-sach-bao-mat-thong-tin/

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.

1.1.2 (July 30, 2026)

• New: Added the Plugin URI and clickable links to the official Website, Documentation, Support, and key topic pages so the product source can be verified.
• New: Added a WooCommerce email for the electronic invoicing workflow, with HTML and plain-text templates, customization in email settings, manual sending from the order metabox, and attachments for available PDF/XML files.
• New: Automatically changed the invoice status to Sent to customer after an email was sent successfully, while storing the status and send time and displaying a result notice.
• Update: Added shipment status, service, COD amount, and update time to emails triggered by an internal shipping connector; internal shop-account rate details are not displayed.
• Update: Used the dedicated subject Shipping update: {shipment_status} - Order #{order_number} for emails triggered by an internal connector.
• Update: Hid the VAT information row in the order list's Information column when invoice requests at checkout are disabled, while retaining filters and historical invoice data exports.
• Update: Displayed the manual Shipment Journey form in the order metabox only after a manual shipment with a tracking number has been created.
• Improve: Collapsed the manual tracking update form after a tracking number has been created; administrators can reopen it from the “Update tracking number” row, whose color follows each user's admin color scheme.
• Improve: Fixed the shipping and electronic invoice email placeholder lifecycle: restored {site_title}, {site_address}, {site_url}, and {store_email} on every send; refreshed order/shipment/invoice placeholders; and ensured they work correctly in subjects, headings, and additional content across repeated sends.
• Improve: Fixed the enabled shipping service count on the Vietnam store page by directly counting registered, available providers.
• Improve: Completed the Vietnamese translation for the electronic invoice email feature.

See changelog.txt for the complete change history.