Zoho BooksInstall

Overview

The "Tax Group - Update" operation in this node allows users to update an existing tax group within Zoho Books. A tax group is a collection of multiple taxes combined under a single entity, such as "Combined Tax" or "GST + PST". This operation is useful when you need to modify the details of a tax group, including its name, the taxes it includes, the total percentage rate, or associated tax authority information.

Common scenarios include:

• Changing the name of a tax group to reflect updated tax policies.
• Adding or removing individual taxes from a tax group.
• Adjusting the overall tax percentage for the group.
• Updating tax authority details linked to the tax group.

Practical example: If a business has a tax group called "GST + PST" and the government changes the PST rate, you can use this operation to update the tax IDs included and adjust the total percentage accordingly without recreating the entire tax group.

Properties

Note: The "Taxes" field (multi-select) is available for create and update operations but in the update operation, the alternative "Tax IDs" string field can be used instead.

Output

The output of this operation is a JSON object representing the updated tax group record as returned by the Zoho Books API. It typically includes fields such as the tax group ID, name, included taxes, total percentage, and tax authority details.

No binary data output is involved.

Example output structure (simplified):

{
  "tax_group_id": "123456789",
  "tax_group_name": "Updated Tax Group Name",
  "tax_ids": ["111", "222"],
  "tax_group_percentage": 13.5,
  "tax_authority_id": "auth123",
  "tax_authority_name": "State Tax Authority"
}

Dependencies

• Requires an active connection to Zoho Books via an OAuth2 API credential.
• The node depends on Zoho Books API endpoints for tax groups.
• The user must have appropriate permissions in Zoho Books to update tax groups.
• The node uses internal methods to load options dynamically for tax groups and taxes.

Troubleshooting

• Error: Unsupported resource — This occurs if the resource parameter is not set to "taxGroup" or if the operation is invalid. Ensure the resource is correctly selected.
• API authentication errors — Verify that the OAuth2 credentials are valid and have not expired.
• Validation errors — For example, missing required fields like Tax Group ID or invalid tax IDs. Make sure all required inputs are provided and formatted correctly.
• Rate limiting — Zoho Books API may limit requests; if you encounter rate limit errors, consider adding delays or retry logic.
• Empty or incorrect tax IDs — When updating tax IDs, ensure they exist and are valid in Zoho Books.

Links and References

• Zoho Books API Documentation - Tax Groups
• n8n Documentation - Expressions
• Zoho Books Official Site