Full details are available in Features by Geography.
From 7 September 2026, new requirements will apply to Vietnam tax payments created through ANZ digital channels. These updates are designed to standardise tax payment data and improve the validation of payment instructions.
These changes apply to:
- Web entry
- File upload
- Host-to-Host (H2H) straight-through processing (STP)
- Host-to-Host (H2H) non-straight-through processing (NSTP)
What is changing?
- More tax payment fields will be mandatory - For payments created using Web entry, most fields in the Additional Information section will become mandatory for all Vietnam tax payment types. You will need to provide all required information before you can submit the payment.
-
Additional mandatory fields for Tax Type 04 - For Tax Type 04, the following fields will become mandatory across all channels:
- Customs Agency Code
- Customs Type
- Import-Export Type
- Standardised values will be required - For payments created using Web entry, most fields in the Additional Information section must be selected from a predefined list of values. Free-text entry will no longer be available for these fields.
- Enhanced field validation - Validation rules will be applied to mandatory and conditional fields across all channels.
What do you need to do?
If you create Vietnam tax payments through ANZ channels, you should:
- Review your current payment creation process
- Ensure all required tax information is available before submitting a payment
- Update any file formats or Host-to-Host payment files to include mandatory fields where required
- Familiarise yourself with the predefined values that must be selected for applicable tax fields
Changes to tax payment fields and validation requirements
The table below only details the changes to the tax fields in the upcoming release. All other fields remain unchanged.
CURRENT |
CHANGES |
||||
| FIELD NAME | WEB ENTRY |
FILE UPLOAD |
H2H (STP) & (NSTP) |
ALL CHANNELS |
CUSTOMER IMPACT / NOTES |
| Tax Payer Name / Tên người nộp thuế |
Free text Optional |
Mandatory | Optional | Optional |
Channel: File Upload
|
| Tax Payer Address / Địa chỉ người nộp thuế |
Free text Optional |
Mandatory | Optional | Optional |
Channel: File Upload
|
| Tax Payer's Tax Code / Mã số thuế của người nộp thuế |
Free text Optional |
Mandatory | Optional |
Free text Mandatory |
Channels: Web entry, H2H (STP) & (NSTP) Mandatory for all tax types when initiating in Web entry, file upload & H2H. |
| Admin Region Code / Mã địa bàn hành chính |
Free text Optional |
Mandatory | Optional |
Pre-defined values Mandatory |
Channels: Web entry, H2H (STP) & (NSTP) Mandatory for all tax types when initiating in Web entry, file upload & H2H. Select from pre-defined values. |
| Collecting Agent Code / Mã cơ quan thu |
Free text Optional |
Mandatory | Optional |
Pre-defined values Mandatory |
Channels: Web entry, H2H (STP) & (NSTP) Mandatory for all tax types when initiating in Web entry, file upload & H2H. Select from pre-defined values. |
| Tax Type / Loại thuế |
Pre- defined values Optional |
Mandatory | Optional |
Pre-defined values Mandatory |
Channels: Web entry, H2H (STP) & (NSTP) Mandatory for all tax types when initiating in Web entry, file upload & H2H. Select from pre-defined values. |
| Collection Account / Tài khoản nộp vào |
Pre- defined values Optional |
Mandatory | Optional |
Pre-defined values Mandatory |
Channels: Web entry, H2H (STP) & (NSTP) Mandatory for all tax types when initiating in Web entry, file upload & H2H. Select from pre-defined values. |
| State Treasury ID / Mã kho bạc |
Free text Optional |
Conditional | Optional |
Pre-defined values Mandatory |
Channels: Web entry, File upload, H2H (STP) & (NSTP) Mandatory for all tax types when initiating in Web entry, file upload & H2H. Select from pre-defined values. |
| State Budget Collection Account / Tài khoản thu ngân sách |
Free text Optional |
Conditional | Optional |
Free text Mandatory |
Channels: Web entry, File upload, H2H (STP) & (NSTP) Mandatory for all tax types when initiating in Web entry, file upload & H2H. |
| Customs Agency Code / Mã cơ quan hải quan (bắt buộc nhập đối với loại thuế 04) |
Free text Optional |
Optional | Optional |
Pre-defined values Conditional |
Channels: Web entry, File upload, H2H (STP) & (NSTP) Mandatory for Tax Type 04 only when initiating in Web entry, file upload & H2H. Optional for Tax Types 01, 02, 03. Select from pre-defined values. |
| Customs Type / Loại tiền hải quan (bắt buộc nhập đối với loại thuế 04) |
Pre- defined values Optional |
Conditional | Optional |
Pre-defined values Conditional |
Channels: Web entry, H2H (STP) & (NSTP) Mandatory for Tax Type 04 only when initiating in Web entry, file upload & H2H. Optional for Tax Types 01, 02, 03. Select from pre-defined values. |
| Imp-exp Type / Loại hình xuất nhập khẩu (bắt buộc nhập đối với loại thuế 04) |
Pre- defined values Optional |
Optional | Optional |
Pre-defined values Conditional |
Channels: Web entry, File upload, H2H (STP) & (NSTP) Mandatory for Tax Type 04 only when initiating in Web entry, file upload & H2H. Optional for Tax Types 01, 02, 03. Select from pre-defined values. |
| Tax Payment Details (1) / (1) Số tờ khai#Kỳ thuế/Ngày tờ khai#Nội dung#Số tiền#Mã chương#Mã tiểu mục |
Free text Optional |
Mandatory | Optional |
Free text Mandatory |
Channels: Web entry, File upload, H2H (STP) & (NSTP) Mandatory for all tax types when initiating in Web entry, file upload & H2H. |
If mandatory fields are not provided at the time of initiation, then:
Web entry - payments will not be allowed to be submitted
File upload and H2H (NSTP) - payments routed to "Needs Repair" status:
- Tax Payer's Tax Code - Manually enter the “Tax Payer’s Tax Code”.
- Admin Region Code - Manually select “Admin Region Code”.
- Collecting Agent Code - Manually select the “Collecting Agent Code”.
- Tax Type - Manually select the “Tax Type”.
- Collection Account - Manually select the “Collection Account”.
- State Treasury ID - Manually select the “State Treasury ID”.
- State Budget Collection Account - Manually enter the “State Budget Collection Account”.
- Customs Agency Code - Manually select the “Customs Agency Code”.
- Customs Type - Manually select the “Customs Type”.
- Imp-exp Type - Manually select the “Imp-exp Type”.
H2H (STP) - payments will be rejected unless otherwise stated below:
-
Tax Type:
- payments with “Beneficiary Name” containing “HQ”, “Haiquan”, or “Hai quan” (case- insensitive) will default to Tax Type 04
- payments with “Beneficiary Name” containing “Thue” (case-insensitive) will default to Tax Type 01
- payments with “Beneficiary Name” containing none of the above-mentioned words (“HQ”, “Haiquan”, “Hai quan”, or “Thue” will reject
-
State Treasury ID:
- derived from the “Beneficiary Bank Code/NCC” present in the transaction. For example: “Beneficiary Bank Code/NCC” = 01701004; derived “State Treasury ID” = 0003
- payments without derived “State Treasury ID” will reject
- State Budget Collection Account will default to the Beneficiary Account number
- Customs Type for Tax Type 04 will default to “1”
Additional Tax Payment Details (1)
There is no change to the way data in this field is provided to ANZ. This field accepts 6 data elements (per below). Each data element continues to be separated by hash (#). Need to provide hash (#) even if any data element is not available or not required.
System will be enhanced to validate the data elements in this field based on Tax Type and the number of (#) hashes.
Note:
- System only accepts data inputs with exactly 5 (#) hashes.
- Data inputs with fewer or more than 5 (#) hashes will not be accepted.
- System will reject the transaction if any of the data elements exceeds the max. no. of characters (char) allowed as below.
- Form ID/Decision ID/Notification ID/ Số tờ khai (Mandatory for Tax Type 04 only). Up to 30 characters.
- Tax cycle/Date of declaration form / Kỳ thuế/Ngày tờ khai (Mandatory for all Tax Types). Up to 10 characters.
- Detail of NBC payments / Nội dung (Mandatory for all Tax Types). Up to 100 characters.
- Amount / Số tiền (Mandatory for all Tax Types). Up to 20 characters.
- Chapter code / Mã chương (Mandatory for Tax Types 01 & 04 only). Up to 3 characters.
- Economic sector code / Mã tiểu mục (Mandatory for Tax Types 01 & 04 only). Up to 4 characters.
If field is blank or has missing data elements/hashes,
- Web entry payments will not be allowed to be submitted
- File upload payments routed to “Needs Repair” status. Provide missing details and resubmit.
Examples of how data should be provided across various Tax Types:
- Tax Type 01: 5 data elements (ii, iii, iv, v, vi) need to be provided according to below sequence (with 5 #) #14/04/2026#Thue NK#11894387#151#1901
- Tax Types 02 & 03: 3 data elements (ii, iii, iv) need to be provided according to below sequence (with 5 #) #14/04/2026#Thue NK#11894387##
- Tax Type 04: 6 data elements (i, ii, iii, iv, v, vi) above need to be provided in below sequence (with 5 #) 10814760380#14/04/2026#Thue NK#11894387#151#1901
There is no change to the way data is provided to ANZ. There are 6 data elements as per below and each data element continues to be provided under the respective Tax><Rcrd><AddtlInf> tags.
System will be enhanced to validate whether the required data elements (based on Tax Type) are being provided in the respective tags within the xml file sent to ANZ.
- Declaration ID: ‘/TPD1- DeclaratnID/’ (Mandatory for Tax Type 04 only). Up to 30 characters.
- Date: ‘/TPD1- Dt/’ (Mandatory for all Tax Types). Up to 10 characters.
- Tax Details: ‘/TPD1-TaxDtl/’ (Mandatory for all Tax Types). Up to 100 characters.
- Amount: ‘/<TtlAmt>’ (Mandatory for all Tax Types). Up to 20 characters.
- Chapter code: ‘/TPD1-ChaptrCd/’ (Mandatory for Tax Types 01 & 04 only). Up to 3 characters.
- Economic sector code: ‘/TPD1-EconomicCd/’ (Mandatory for Tax Types 01 & 04 only). Up to 4 characters.
If a mandatory tag for a particular Tax Type is missing or blank,
- H2H (NSTP) payments routed to “Needs Repair” status. Provide missing data and resubmit.
- H2H (STP) payments are rejected
For example, for Tax Type 02, System will validate whether data elements ii, iii, iv are provided in their respective tags. If any of the 3 tags are missing or blank, a) H2H (NSTP) payments will be routed to “Needs Repair” status and b) H2H (STP) payments will be rejected.
For example, for Tax Type 04, System will validate whether data elements i, ii, iii, iv, v, vi are provided in their respective tags. If any of the 6 tags are missing or blank, a) H2H (NSTP) payments will be routed to “Needs Repair” status and b) H2H (STP) payments will be rejected.
To learn more, visit Create Tax Payment (Vietnam).