Zoho Books guide
Software Setup
To acquire your own Zoho Books instance, we suggest creating a Zoho Books account and signing up for a free trial.
Zoho Books does not provide any sample data, but comes with a default accounting setup that you can use to create transactions.
Rutter does not provide any Zoho Books instances.
Developer Account Setup
Create a Zoho Books Developer App and configure it so that you can process accounting data through Rutter.
Login to Zoho Books
- Go to the Zoho Books Developer Console and sign in.
Create a Client
- Click "Add Client" and choose "Server-based application" and fill out the fields.
- For "Authorized Redirect URIs", please use
https://production.rutterapi.com/zohobooks/proxy/${YOUR_RUTTER_ORG_ID}/redirect-url. You can find your Org ID in your settings page.
- For "Authorized Redirect URIs", please use
Share your production client_id and client_secret with Rutter
- First, get the client_id and client_secret from Zoho Books. To do this:
- Navigate to the "Client Secret" tab of your new application.
- Then, share these two values to Rutter by entering them in the Dashboard:
- Login to the Rutter Dashboard
- Make sure you’re in Production Mode. Navigate to Platforms, select the Accounting menu, and click on Zoho Books.
- Copy the client_id and client_secret into the text boxes and click Save.
Enable OAuth credentials for multiple regions
- First, enable support for multiple data centers and ability to use the same OAuth credentials for all data centers. To do this:
- Navigate to the "Settings" tab of your new application.
- Check the checkbox for "Use the same OAuth credentials for all data centers".
- Click the toggles to activate OAuth for the regions you would like to support, for example EU (zoho.eu).
Bill Line Tax Exemptions
When creating a bill, pass Zoho Books' native exemption values in each line item's additional_fields.tax_exemption_code and additional_fields.tax_exemption_id. Both fields are optional strings and are forwarded unchanged to Zoho Books. The ID is a native Zoho Books exemption ID, not a Rutter tax rate ID.
These fields also work on replacement line items in Update Bill. Omitting line_items leaves existing lines unchanged.
Use exemption values configured for the connected Zoho Books organization. Availability depends on the organization's edition and tax configuration.
For GCC "Out of Scope" treatment, also supply line_items[].additional_fields.tax_treatment_code with the native reason code (for example, uae_others). Tax exemption code/ID alone can persist in Zoho without selecting "Out of Scope" in its UI. The reason code is forwarded unchanged; Rutter does not choose a reason on your behalf. Supply the bill-level additional_fields.tax_treatment when required by the organization (for example, vat_registered).