Tax Withholding Category
How to use Tax Withholding Category in Taxes: access, working steps, fields, related records and troubleshooting.
Purpose and access
Maintain the tax accounts, templates and applicable rules for the operating company. Check the calculated result on a representative draft transaction. Tax settings must reflect the company’s approved tax treatment and jurisdiction.
This page is a record page in Finance & Accounting → Taxes. Use the link above to open the configured destination; permissions are checked by the destination service.
Before you start
Prepare the required information: Deduct Tax On Basis, Rates, Accounts.
Confirm the company, party, dates, units and source references that apply. Select existing links carefully and check for an existing record before creating a duplicate.
Working steps
- Open Tax Withholding Category from Finance & Accounting → Taxes, or use ERP Search.
- Filter the list and open the relevant record. To add a record, use Add/New when your role provides that action.
- Complete the editable fields described below. Required fields and validation conditions must be satisfied; read-only values are set by the system or their source records.
- Add the required child rows. Review each row’s identifiers, linked records and values, using the child-table field reference below.
- Save the record and address validation messages. Reload and verify the saved values and relationships.
- Use any additional workflow actions only when the record and your role provide them. Saving this record does not automatically complete a related transaction or external action.
Field reference
These fields come from the installed ERP definition. Hidden fields and password inputs are omitted. Additional conditions, custom scripts and workflow rules can make a field required or read-only in a particular context.
| Field | Type / behavior | How to use it |
|---|---|---|
Category Namecategory_name | Data Optional | Enter the identifier or short text requested by the label. Preserve external reference numbers accurately. |
Deduct Tax On Basistax_deduction_basis | Select Required | Choose one of the configured list values. Status fields may be controlled by the record workflow.Available choices
|
Round Off Tax Amountround_off_tax_amount | Check Optional | Checking this will round off the tax amount to the nearest integer |
Only Deduct Tax On Excess Amounttax_on_excess_amount | Check Optional | Tax withheld only for amount exceeding cumulative threshold |
Disable Cumulative Thresholddisable_cumulative_threshold | Check Optional | When checked, only transaction threshold will be applied for transaction individually |
Disable Transaction Thresholddisable_transaction_threshold | Check Optional | When checked, only cumulative threshold will be applied |
Ratesrates | Table Required | Add the relevant child rows and review required columns, quantities and references before saving. Linked record: Tax Withholding Rate |
Accountsaccounts | Table Required | Add the relevant child rows and review required columns, quantities and references before saving. Linked record: Tax Withholding Account |
Child tables
Rates — child-row fields
| Field | Type / behavior | How to use it |
|---|---|---|
From Datefrom_date | Date Required | Choose the business date required for this field. Confirm its relationship to other dates on the record. |
To Dateto_date | Date Required | Choose the business date required for this field. Confirm its relationship to other dates on the record. |
Tax Withholding Grouptax_withholding_group | Link Optional | Choose an existing linked record. Check its company and ownership; typing a label alone does not create a new relationship. Linked record: Tax Withholding Group |
Tax Withholding Ratetax_withholding_rate | Float Required | Enter a numeric value using the required unit and precision. |
Cumulative Thresholdcumulative_threshold | Float Optional | Enter a numeric value using the required unit and precision. |
Transaction Thresholdsingle_threshold | Float Optional | Enter a numeric value using the required unit and precision. |
Accounts — child-row fields
| Field | Type / behavior | How to use it |
|---|---|---|
Companycompany | Link Required | Choose an existing linked record. Check its company and ownership; typing a label alone does not create a new relationship. Linked record: Company |
Accountaccount | Link Required | Choose an existing linked record. Check its company and ownership; typing a label alone does not create a new relationship. Linked record: Account |
Troubleshooting
- Not permitted: verify the account, role and source-document permission. Do not share an administrator login.
- Missing record or address: inspect the relevant Link or Dynamic Link fields; a matching title alone does not establish a relationship.
- Cannot save or change status: review required fields, read-only values, document status and the configured approval transition.
- Unexpected report or portal result: review company/date filters, source-document submission and the approved party or Employee link.