Withholding Tax Error Codes

Important:

The topics here cover withholding tax for NetSuite accounts without the SuiteTax feature enabled. If you're using an account with SuiteTax enabled, go to Withholding Taxes in SuiteTax.

Withholding tax isn't getting new features and reports in accounts without SuiteTax. Updates to the Withholding Tax SuiteApp now include only fixes for reported issues.

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's 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 can't apply a transaction discount when the withholding tax point is set to On Accrual.	Header discount isn't allowed when the withholding tax point is set to On Accrual.
WTAX_CHEQUE_CUSTOMER_NOT_ALLOWED	You can't select a customer on a check transaction with withholding tax.	Withholding tax can't be applied to a check 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 can't 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 can't be zero or negative.
INSUFFICIENT_PERMISSION	You don't 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 don't 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's 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 can't apply a transaction discount when the withholding tax point is set to On Accrual.

Header discount isn't allowed when the withholding tax point is set to On Accrual.

WTAX_CHEQUE_CUSTOMER_NOT_ALLOWED

You can't select a customer on a check transaction with withholding tax.

Withholding tax can't be applied to a check 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 can't 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 can't be zero or negative.

INSUFFICIENT_PERMISSION

You don't 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 don't 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