Zoho Books icon

Zoho Books

Consume Zoho Books API

Actions76

Tax Exemption (US only) → Update

AI-generated

Overview

This node operation updates an existing Tax Exemption record in Zoho Books, specifically for the US edition. Tax exemptions are used to mark certain customers or transactions as exempt from tax based on predefined exemption codes and reasons. This update operation allows modifying details such as the exemption code, description, type, and exemption percentage.

Typical use cases include:

  • Correcting or updating a customer's tax exemption status.
  • Adjusting the percentage of tax exemption granted to a customer.
  • Changing the reason or description associated with a tax exemption.

For example, if a reseller's tax exemption code changes or if the exemption percentage needs adjustment due to regulatory changes, this operation can be used to update those details seamlessly.

Properties

Name Meaning
Tax Exemption ID Select the specific tax exemption record to update (US edition only).
Tax Exemption Code The updated tax exemption code (e.g., "RESELLER", "NONPROFIT"). Alphanumeric, spaces, hyphens, underscores allowed.
Description Updated description explaining the reason for the tax exemption.
Type The type of tax exemption. Currently, only "Customer" is supported.
Tax Exemption Percentage The updated percentage of tax to be exempted, ranging from 0 to 100%.

Output

The output JSON contains the updated tax exemption record details as returned by the Zoho Books API. Each item corresponds to one updated tax exemption entry and includes all relevant fields reflecting the new state after the update.

No binary data output is involved in this operation.

Dependencies

  • Requires an active connection to Zoho Books API with appropriate authentication credentials (an API key or OAuth2 token).
  • Only available for organizations using the US edition of Zoho Books.
  • The node uses internal methods to load options dynamically, such as fetching existing tax exemptions for selection.

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 perform any API calls. To resolve, verify your organization's edition under Zoho Books → Settings → Organization Profile. Contact Zoho support to migrate to the US edition if necessary.
  • Invalid Tax Exemption ID: Selecting a non-existent or invalid Tax Exemption ID will cause the update to fail. Ensure you select a valid ID from the dropdown list populated by the node.
  • Invalid Field Values: Providing invalid characters in the Tax Exemption Code or values outside the allowed range for the exemption percentage (0-100) will result in API errors. Validate inputs before execution.
  • API Rate Limits: Excessive requests may hit Zoho Books API rate limits. The node handles some rate limiting internally but consider adding delays or reducing batch sizes if errors occur.

Links and References

Discussion