Zoho BooksInstall

Overview

This node operation allows you to create a new Tax Group in Zoho Books. A Tax Group is a collection of multiple individual taxes combined under one group name, which can be used to apply multiple taxes simultaneously on transactions. This is useful for businesses that need to apply compound or combined taxes such as GST + PST or other regional tax combinations.

Typical use cases include:

• Creating a tax group that combines several taxes for easier application on invoices or bills.
• Managing complex tax scenarios where multiple tax rates apply together.
• Automating tax setup in Zoho Books via n8n workflows.

For example, if your business needs to charge both state and local sales taxes together, you can create a Tax Group named "Combined Tax" including those individual taxes, then apply this group to relevant transactions.

Properties

Output

The output JSON contains the details of the newly created Tax Group as returned by the Zoho Books API. This typically includes the Tax Group's unique ID, name, included taxes, percentages, and any tax authority information.

No binary data is output by this node.

Example output structure (simplified):

{
  "tax_group_id": "123456789",
  "tax_group_name": "Combined Tax",
  "taxes": [
    {
      "tax_id": "111",
      "tax_name": "GST",
      "percentage": 5
    },
    {
      "tax_id": "222",
      "tax_name": "PST",
      "percentage": 7
    }
  ],
  "tax_group_percentage": 12,
  "tax_authority_id": "auth_001",
  "tax_authority_name": "State Tax Authority"
}

Dependencies

• Requires an active Zoho Books account with API access.
• Requires an API authentication credential configured in n8n (an OAuth2 token or API key).
• The node dynamically loads the TaxGroup resource handler internally.
• No additional external dependencies beyond the Zoho Books API.

Troubleshooting

• Error: Unsupported resource
  Occurs if the resource parameter is incorrect or not implemented. Ensure "Tax Group" is selected as the resource.

• Validation errors
  If required fields like "Tax Group Name" or "Taxes" are missing or invalid, the API will reject the request. Make sure all required inputs are provided and valid.

• API authentication errors
  If credentials are missing or expired, the node will fail. Verify that the API credential is correctly configured and has necessary permissions.

• Too many taxes selected
  The API limits the number of taxes in a group to 50. Selecting more than this will cause an error.

• Network or API downtime
  Temporary network issues or Zoho API outages may cause failures. Retry after some time or check Zoho status.

Links and References

• Zoho Books API Documentation - Tax Groups
• Zoho Books Official Website
• n8n Documentation - Working with APIs