Zoho Books icon

Zoho Books

Consume Zoho Books API

Actions76

Tax Exemption (US only) → Create

AI-generated

Overview

This node operation allows you to create a Tax Exemption record specifically for the US edition of Zoho Books. Tax exemptions are used to mark certain customers or transactions as exempt from tax, based on predefined exemption codes such as "RESELLER" or "NONPROFIT". This is particularly useful for businesses that need to comply with US tax regulations by applying tax exemptions to eligible customers.

Typical use cases include:

  • Marking a customer as a reseller who does not pay sales tax.
  • Applying nonprofit tax exemption status to qualifying organizations.
  • Automating the creation of tax exemption records in Zoho Books during customer onboarding or updates.

By using this node, you can programmatically manage tax exemption codes and their details, ensuring accurate tax handling within your accounting workflows.

Properties

Name Meaning
Tax Exemption Code The alphanumeric code representing the tax exemption reason (e.g., "RESELLER", "NONPROFIT"). Allowed characters: letters, numbers, spaces, hyphens, and underscores. Required.
Description Optional textual description explaining the reason for the tax exemption (e.g., "Tax exempted because the contact is a reseller").
Type The type of tax exemption. Currently, only "Customer" is supported, meaning the exemption applies to customers.
Additional Fields Extra optional fields including:
• Tax Exemption Percentage: Number between 0 and 100 indicating the percentage of tax to be exempted (default 100%).

Additionally, there is an informational notice property reminding users that this feature is only available in the US edition of Zoho Books, with instructions on how to verify the edition and what to do if not using the US edition.

Output

The output of this operation is a JSON object representing the created tax exemption record as returned by the Zoho Books API. It typically includes details such as the tax exemption code, description, type, and exemption percentage.

If multiple items are processed, the output will be an array of such JSON objects, each paired with the corresponding input item index.

No binary data output is produced by this node operation.

Dependencies

  • Requires an active Zoho Books account configured for the US edition.
  • Requires an API authentication credential (OAuth2 token) for Zoho Books.
  • The node uses Zoho Books API endpoints related to tax exemptions.
  • No additional external services are required beyond Zoho Books API access.

Troubleshooting

  • Non-US Edition Error: If your Zoho Books organization is not set to the US edition, the node will show a clear error message and will not make any API calls to avoid unnecessary rate limiting. To resolve this, verify your organization's country/edition settings in Zoho Books and contact Zoho support to migrate to the US edition if needed.
  • Invalid Tax Exemption Code: Ensure the tax exemption code contains only allowed characters (alphanumeric, spaces, hyphens, underscores). Invalid characters may cause API errors.
  • Missing Required Fields: The "Tax Exemption Code" and "Type" fields are required. Omitting these will result in validation errors.
  • API Authentication Issues: Ensure your API credentials are valid and have sufficient permissions to create tax exemptions.
  • Percentage Out of Range: The tax exemption percentage must be between 0 and 100 inclusive. Values outside this range will cause errors.

Links and References

Discussion