Actions76
- Bill Actions
- Contact Actions
- Credit Note Actions
- Invoice Actions
- Item Actions
- Sales Order Actions
- Tax Actions
- Tax Group Actions
- Tax Exemption (US only) Actions
- Vendor Actions
- Vendor Credit Actions
Tax → Update
AI-generatedOverview
This node integrates with the Zoho Books API to update tax records. It allows users to modify existing tax entries by specifying the tax to update and providing new values for its properties. This is useful in scenarios where tax rates or details change, such as updating sales tax percentages, renaming taxes, or adjusting tax authority information.
Practical examples:
- Updating a "Sales Tax" rate from 7.5% to 8.25%.
- Changing the name of a tax from "GST" to "Goods and Services Tax".
- Marking a tax as compound (tax on tax) or non-recoverable.
- Updating the associated tax authority's ID or name.
Properties
| Name | Meaning |
|---|---|
| Tax ID | Select the specific tax record to update. |
| Update Fields | Collection of fields to update for the selected tax: |
| - Tax Name | The updated name of the tax (e.g., "Sales Tax", "GST"). |
| - Tax Percentage | The updated tax percentage rate (0-100%, up to 2 decimal places). |
| - Is Compound | Boolean indicating if this tax is compound (tax on tax). |
| - Is Non-Recoverable | Boolean indicating if this tax is non-recoverable. |
| - Tax Authority ID | The updated ID of the tax authority. |
| - Tax Authority Name | The updated name of the tax authority. |
Output
The node outputs JSON data representing the updated tax record returned by the Zoho Books API. Each output item corresponds to one input item processed and contains the updated tax details.
No binary data output is produced by this operation.
Dependencies
- Requires an active connection to the Zoho Books API using OAuth2 authentication.
- The node depends on the Zoho Books API being accessible and the user having appropriate permissions to update tax records.
- No additional environment variables are required beyond the configured API credentials.
Troubleshooting
Common issues:
- Selecting an invalid or non-existent Tax ID will cause errors.
- Providing invalid values for tax percentage (e.g., negative numbers or >100) may result in API validation errors.
- Network connectivity issues can prevent successful API calls.
- Insufficient permissions on the API key or OAuth token can cause authorization failures.
Error messages and resolutions:
- "Unsupported resource" — indicates the resource parameter is incorrect; ensure "Tax" is selected.
- API validation errors related to field formats — verify that all inputs conform to expected types and ranges.
- Authorization errors — check that the API credentials are valid and have necessary scopes.
- Rate limit errors — if encountered, wait before retrying or implement error handling to respect API limits.