Withholding Tax Error Codes

Important:

This topic pertains to withholding tax in NetSuite accounts that do not have the SuiteTax feature enabled. If you are using a NetSuite account where the SuiteTax feature is enabled, go to Withholding Taxes in SuiteTax.

Withholding tax is no longer being updated for new features and reports in accounts that do not have the SuiteTax feature. All version upgrades of the Withholding Tax SuiteApp include fixes for reported issues only.

The following table lists the withholding tax error codes that you may encounter when importing transactions using CSV and SOAP web services:

Error Code	Message	Details
WTAX_FLD_REQD	Please enter value(s) for {id} on line {line}.	There is a missing value on one of the required fields. Sample error message: Please enter value(s) for custcol_4601_witaxcode on line 1. For a list of the required fields, see Importing Withholding Tax Transactions Using SOAP Web Services and Importing Withholding Tax Transactions Using CSV Import.
WTAX_INCORRECT_SIGN	You have entered an invalid field value {value} for the following field: {id} on line {line}.	The sign of the numeric value is incorrect. Sample error message: You have entered an invalid field value 50 for the following field: custcol_4601_witaxamount on line 5. When the withholding tax is posted for sales and purchase transactions, the values in the Withholding Tax Base and Withholding Tax Amount columns will have a positive or negative numeric value to indicate the withholding tax deductions.
WTAX_HEADERDISC_NOT_ALLOWED	You cannot apply a transaction discount when the withholding tax point is set to On Accrual.	Header discount is not allowed when the withholding tax point is set to On Accrual.
WTAX_CHEQUE_CUSTOMER_NOT_ALLOWED	You cannot select a customer on a cheque transaction with withholding tax.	Withholding tax cannot be applied to a cheque transaction if the entity selected is a customer.
WTAX_APPLY_ERROR	Check the Apply WH Tax? box on line {line} to apply withholding tax.	Apply WH Tax? field (custcol_4601_witaxapplies) should be set to ‘true’. Sample error message: Check the Apply WH Tax? box on line 1 to apply withholding tax.
WTAX_TOTAL_VALIDATION	The total Withholding Tax Amount for all Withholding Tax Types cannot be zero or less. This includes the breakdown of amounts for all applicable Withholding Tax Groups applied on the transaction.	The negative withholding tax total amount cannot be zero or negative.
INSUFFICIENT_PERMISSION	You do not have permissions to set a value for the field {id}. Check if the Display Type of the withholding tax transaction fields are set to Normal. If it is, the error may have been caused by any of the following: 1) The field is read-only; 2) An associated feature is disabled; 3) The field is available only when a record is either created or updated, but not in both cases.	Sample error message: You do not have permissions to set a value for the field custcol_4601_witaxcode. Check if the Display Type of the withholding tax transaction fields are set to Normal. If it is, the error may have been caused by any of the following: 1) The field is read-only; 2) An associated feature is disabled; 3) The field is available only when a record is either created or updated, but not in both cases. Note: To set the Display Type of the withholding tax field to Normal, go to Customization > Lists, Records, & Fields > Transaction Column Fields. Edit the fields for Withholding Tax on the Display Subtab

Error Code

Message

Details

WTAX_FLD_REQD

Please enter value(s) for {id} on line {line}.

There is a missing value on one of the required fields.

Sample error message:

Please enter value(s) for custcol_4601_witaxcode on line 1.

For a list of the required fields, see Importing Withholding Tax Transactions Using SOAP Web Services and Importing Withholding Tax Transactions Using CSV Import.

WTAX_INCORRECT_SIGN

You have entered an invalid field value {value} for the following field: {id} on line {line}.

The sign of the numeric value is incorrect.

Sample error message:

You have entered an invalid field value 50 for the following field: custcol_4601_witaxamount on line 5.

When the withholding tax is posted for sales and purchase transactions, the values in the Withholding Tax Base and Withholding Tax Amount columns will have a positive or negative numeric value to indicate the withholding tax deductions.

WTAX_HEADERDISC_NOT_ALLOWED

You cannot apply a transaction discount when the withholding tax point is set to On Accrual.

Header discount is not allowed when the withholding tax point is set to On Accrual.

WTAX_CHEQUE_CUSTOMER_NOT_ALLOWED

You cannot select a customer on a cheque transaction with withholding tax.

Withholding tax cannot be applied to a cheque transaction if the entity selected is a customer.

WTAX_APPLY_ERROR

Check the Apply WH Tax? box on line {line} to apply withholding tax.

Apply WH Tax? field (custcol_4601_witaxapplies) should be set to ‘true’.

Sample error message:

Check the Apply WH Tax? box on line 1 to apply withholding tax.

WTAX_TOTAL_VALIDATION

The total Withholding Tax Amount for all Withholding Tax Types cannot be zero or less. This includes the breakdown of amounts for all applicable Withholding Tax Groups applied on the transaction.

The negative withholding tax total amount cannot be zero or negative.

INSUFFICIENT_PERMISSION

You do not have permissions to set a value for the field {id}. Check if the Display Type of the withholding tax transaction fields are set to Normal. If it is, the error may have been caused by any of the following: 1) The field is read-only; 2) An associated feature is disabled; 3) The field is available only when a record is either created or updated, but not in both cases.

Sample error message:

You do not have permissions to set a value for the field custcol_4601_witaxcode. Check if the Display Type of the withholding tax transaction fields are set to Normal. If it is, the error may have been caused by any of the following: 1) The field is read-only; 2) An associated feature is disabled; 3) The field is available only when a record is either created or updated, but not in both cases.

Note:

To set the Display Type of the withholding tax field to Normal, go to Customization > Lists, Records, & Fields > Transaction Column Fields. Edit the fields for Withholding Tax on the Display Subtab

Related Topics