> For the complete documentation index, see [llms.txt](https://help.orderdesk.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.orderdesk.com/integration-setup-guides/tools-and-productivity/zoho-books-integration.md). # Zoho Books Integration Order Desk can connect to your [**Zoho Books**](https://www.zoho.com/books/) account and automatically send orders there. It can also pull shipment details from Zoho Books and send them back to your sales channels if your store is set up for it. This guide walks you through how to connect the integration and the options available once it’s set up. ### Setup To enable the integration, click on **Manage Integrations** from the left sidebar in Order Desk. Under the **Productivity** tab, find and enable Zoho Books. ![](https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2F4ghorMsjrRtLNwq3ark9%2Flegacy-a57f564b276381d79810.png?alt=media) Alternatively, search for **Zoho Books** from the available integrations and click **Enable**. ![](https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2FXoD06wKJKQjKAhhgfMHl%2Flegacy-2ca8d1c7dcff5659d2d9.png?alt=media) #### Authorize Order Desk On the next screen, select your data center region from the dropdown and click **Connect to Zoho Books**. ![](https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2FAXLdut7tWqWA9VVDdG6D%2Flegacy-0887e33a3608cd41f48e.png?alt=media) You’ll be redirected to Zoho Books to allow Order Desk access to your account. Once done, click **Accept**. ![](https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2FWeBL3p9f50icSYTb2xKr%2Flegacy-01ee5a6d6ae156606553.png?alt=media) After authorization is complete, you’ll be redirected back to Order Desk with the integration connected. You can then finish setting up the integration settings. ### Integration Settings Under the settings section, choose how to set up your Zoho Books integration and which features you want enabled: ![](https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2F4mWlQgmzdnj6po8xR1hO%2Flegacy-998cf6253121486805e2.png?alt=media) #### After Import, Move To Select the folder you want orders to be moved into after they are successfully sent to Zoho Books. You can use one of the default folders in your store or create your own. See the [**Working with Folders**](/start-here/getting-started-series/quick-start-overview.md#working-with-folders) guide for more details. #### After Shipment, Move To Select the folder you want orders to be moved into when Zoho Books sends tracking details back. **TIP:** There are a few things to keep in mind when setting up shipment syncing for Zoho Books. Check out the [How Shipments Work](#how-shipments-work-with-zoho-books) section for more details. #### If Canceled, Move To Select the folder you want canceled orders to be moved into. #### Create Contact If Missing A contact is required when sending sales orders to Zoho Books. If this setting is enabled, Order Desk will automatically create a contact using the email address on the order when one does not already exist. #### Product Settings ![](https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2Fm18HvHL6hBunzeHHspEW%2Flegacy-35a1e5d7dfee96ccee8e.png?alt=media) For more information on these product settings and how to use them with the Zoho Books integration, see the [**Product Settings**](/integration-setup-guides/fulfillment-services/fulfillment-integration-product-settings.md) guide. #### How Shipments Work with Zoho Books When orders are sent to Zoho Books, they are created as **Sales Orders**. Order Desk checks for shipment updates from Zoho Books every 3 hours. During each check, it looks for orders updated within the past 4 hours. Shipment details are pulled from the following custom fields on the Zoho Books sales order: * `tracking_number` * `carrier` * `shipping_method` These fields must be created beforehand in your Zoho Books account and used to store tracking information on your sales orders. **NOTE:** If these custom fields are not set up in Zoho Books, Order Desk will not be able to retrieve shipment details from there. #### Item Level Details The following fields can be set as variations or item metadata for each item in an order. | Field Name | Field Description | | ------------------- | ------------------------------------------------------------------------------------------------------------- | | description | Use this to set the description of the order item. If not set, the item name will be used as the description. | | tax\_id | Passes the item tax ID to Zoho Books. | | zohobooks\_item\_id | Passes the item ID to Zoho Books. | If you are unfamiliar with how to add item metadata or variations, see the [**How to Work with Inventory Details**](/guided-walkthroughs/products-and-inventory/how-to-work-with-inventory-details.md#store-extra-item-details-in-order-desk) guide. #### Order Level Details The following fields can be set as checkout data or order metadata for your orders. | Field Name | Field Description | | --------------- | ---------------------------------------------------------------------------------------------------------------------------- | | notes | Passes order notes or any additional information to Zoho Books. | | email\_override | Set the email address that should be sent to Zoho Books. If left blank, Order Desk will use the customer email on the order. | If you are unfamiliar with checkout data, see the [**How to Work with Checkout Data**](/guided-walkthroughs/orders-and-folders/how-to-work-with-checkout-data.md) guide. ### Rules Reference In addition to the [**general set of rule events and actions**](/resources/rules-reference-events-filters-and-actions.md) in Order Desk, Zoho Books includes a number of rule events and actions that are specific to this integration. These aren’t found directly on the integration page. Instead, you’ll need to use the **Rule Builder** to access them. If you’re new to using rules in Order Desk, we recommend starting with the [**How to Work With Rules**](/guided-walkthroughs/rules-and-automations/how-to-work-with-rules.md) guide. #### Rule Events The following events are specific to Zoho Books. To find them, type ***Zoho*** in the **Event** dropdown in the Rule Builder: ![](https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2FlFXoPXYe4d0J0nJulin6%2Flegacy-9cf32890e0a549e51d71.png?alt=media) | Event | Description | | ----------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | *Order Canceled in Zoho Books* | Triggered when an order is canceled in Zoho Books. | | *Order Scheduled to Zoho Books* | Triggered when an order is scheduled to be sent from Order Desk to Zoho Books. This runs immediately after scheduling, so it can be used to take action at that point. | | *After Order Submitted to Zoho Books* | Triggered after an order has been successfully submitted to Zoho Books. | | *Before Order Submitted to Zoho Books* | Triggered just before an order is sent to Zoho Books. This is useful for making last-minute updates. | | *Order Not Submitted to Zoho Books Because of Invalid SKU* | Triggered when an order submission fails because one or more SKUs are not valid in Zoho Books. | | *Order Not Submitted to Zoho Books Because of General Error* | Triggered when a general error prevents the order from being submitted. | | *Order Not Submitted to Zoho Books Because No Products Available* | Triggered when an order submission fails because no valid products were found. | #### Rule Actions Zoho Books also supports specific rule actions that you can apply to your orders. These can be found in the **Actions** dropdown by searching for ***Zoho***: ![](https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2Ftms5fh6f7FUYHo789PBK%2Flegacy-3bd03ececeafa77090ad.png?alt=media) | Action | Description | | ---------------------------- | ------------------------------------------------------------------------ | | *Submit Order to Zoho Books* | Sends an order from Order Desk to Zoho Books. | | *Cancel Order in Zoho Books* | Attempts to cancel an order that was previously submitted to Zoho Books. | --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://help.orderdesk.com/integration-setup-guides/tools-and-productivity/zoho-books-integration.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.