Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.commenda.io/llms.txt

Use this file to discover all available pages before exploring further.

​
Overview

The Zoho Books integration connects your Zoho Books account to Commenda for automatic transaction syncing and real-time indirect tax calculation. Commenda pulls your invoices, credit notes, contacts, and items, then calculates and applies the correct indirect tax on your Zoho Books documents.

​
Supported features

FeatureStatus
Transaction syncingSupported
Tax calculationSupported
Real-time webhooksRequires manual setup

​
Data models

Commenda syncs the following data from Zoho Books:
  • Invoices — sales invoices with line items and addresses
  • Invoice credit notes — credits issued against invoices
  • Cash refunds — refund transactions
  • Contacts — customer and vendor profiles
  • Items — your product and service catalog

​
How tax calculation works

When you create or update a document in Zoho Books, Commenda automatically:
  1. Receives a webhook notification from Zoho Books
  2. Fetches the full document details including addresses
  3. Calculates the applicable indirect tax based on the shipping address
  4. Creates a Commenda Sales Tax tax authority in your Zoho Books account (if it doesn’t already exist)
  5. Applies the calculated tax using dynamically created tax codes
Commenda tracks the tax calculation status using a custom field called “Commenda Tax Status” on your documents.
Tax calculation supports invoices, sales orders, credit notes, and estimates.

​
Address resolution

Commenda determines the tax jurisdiction using the shipping address on the document. If no shipping address is present, it falls back to the billing address. Both addresses are read directly from the Zoho Books document payload, so no additional API calls are needed.

​
Connecting Zoho Books

1

Start the connection

From your Commenda dashboard, navigate to integrations and select Zoho Books. Commenda generates a secure connection link.
2

Authorize access

Click the connection link to open the Zoho Books authorization page. Sign in and grant Commenda access to your accounting data.
3

Set up webhooks

Zoho Books requires manual webhook configuration. In your Zoho Books account, navigate to Settings > Automation > Webhooks and create a webhook that points to the Commenda endpoint provided in your dashboard.
4

Configure sync settings

Choose which data models to sync, set the sync frequency, and specify how far back to pull historical data.
5

Verify the connection

After setup, Commenda begins the initial data sync. Check the sync status on your dashboard to confirm data is flowing.
Unlike other integrations, Zoho Books requires you to manually configure webhooks. Without this step, real-time tax calculation will not work.

​
Known behaviors

  • Non-taxable transactions are skipped — if a document is marked as is_taxable: false in Zoho Books, Commenda does not calculate tax on it to avoid infinite calculation loops
  • Commenda skips invoices with paid or void status for tax calculation
  • Commenda skips sales orders and credit notes with void or closed status
  • Commenda automatically creates a “Commenda Sales Tax” tax authority and corresponding tax codes in your Zoho Books account

​
Next steps