Integrate Zoho Books with Zoho Projects

This integration paves the way towards better accounting for your projects in Zoho Projects.

Benefits of the Integration:

• Create and send various transactions in Zoho Books for your projects in Zoho Projects. These transactions include: Invoices, Quotes, Expenses, Recurring Expenses and Recurring Invoices.
• Fetch Timesheets and Contacts from Zoho Projects to Zoho Books.
• Fetch Tasks, Users and Bugs that are associated with your projects.

In this page..

• Set up the Integration
• Check the Status of Your Synced Data
• Error Summary
• Create Transactions for Your Projects
• Disable the Integration
• Re-enable the Integration
• Troubleshooting

Set Up the Integration

Prerequisite: You must be an admin in both your Zoho Books and Zoho Projects accounts.

Generate your ZSC Key

Before you setup the integration, you’d need to obtain the email address and ZSC key that’s associated with your projects account. To do so, go to your Zoho Projects account and follow these steps:

• Go to Zoho Projects > Setup > Integrations > Developer Space.
• Navigate to the ZSC Key tab under Developer Space and copy the ZSC key and email ID.

Integrate with Zoho Projects

Once you’ve generated the ZSC Key, you will be able to set up the integration from your Zoho Books organisation:

• Go to Zoho Books.
• Click Settings on the top right corner of the page.
• Select Zoho Apps under Integrations.
• On the Zoho Apps page, click Connect next to Zoho Projects.

• Click Connect again from the integration dashboard.

• Enter the Email ID and the ZSC key that you copied from Zoho Projects and click Next.

• Select a portal that you’d like to connect with Zoho Books from the dropdown.

• Select the modules that you’d like to sync:

  • Projects: The Projects module is fetched by default. However, only the projects that are associated with a primary client will be fetched. Any tasks or bugs associated with these projects will be fetched as well.

  • Timesheet: Select this module to fetch all your billable and approved timesheets from Zoho Projects. All users associated with these projects will be fetched as well. Users from Zoho Projects, who aren’t a part of your Zoho Books organisation will be added as inactive users.

     * If you've been using a different accounting software, you can select a date before which, your timesheets from Zoho Projects will be marked as **Invoiced**.  The timesheets on or after the selected date will be marked as **Unbilled** in Zoho Books.
    
    * You can choose the second option to import all your timesheets as **Unbilled**.
    

• Click Sync Now.

Now, your Zoho Books organisation has been connected with your portal in Zoho Projects.

Check the Status of the Synced Data

It may take a while for the modules to get synced. You can view the status of your integration by clicking Refresh, which will display a Sync in Progress badge if some modules are still getting synced.

You can also view details of when each module was synced by clicking Show Sync History.

Error Summary

In case something went wrong during the sync, you can view the Error Summary, which contains a module-wise list of all the errors that occurred, along with a reason for their occurrence. To do so:

• Go to Zoho Books.
• Click Settings on the top right corner of the page.
• Select Zoho Apps under Integrations.
• On the Zoho Apps page, click Show Details next to Zoho Projects.
• Click View Error Summary.

Now, you can view a list of all the errors that occurred in the Error Details page.

Create Transactions for Your Projects

Once you finish setting up the integration, all your projects from Zoho Projects, along with their users, tasks and bugs will be available in your Zoho Books organisation as well.

To create transactions on Zoho Books: 

• Go to Time Tracking > Projects.  
• Select a project that was fetched from Zoho Projects and click Create Invoice or the New Transaction dropdown.

From here, you will be able to create transactions for your projects and send them to your clients, if you wish to do so. 

These transactions will be instantly available from the Finance tab in Zoho Projects. Similarly, any transactions that are created from Zoho Projects will instantly be available in Zoho Books. 

Disable the Integration

To disable the Zoho Books - Zoho Projects integration:

• Go to Zoho Books.
• Click Settings on the top right corner of the page.
• Select Zoho Apps under Integrations.
• On the Zoho Apps page, click Show Details next to Zoho Projects.
• Click the Disable Integration button and then click Confirm.

Re-enable the Integration

Once you’ve disabled the integration, you can re-enable it in case you’d like to connect to Zoho Projects again. To do this:

• Go to Zoho Books.
• Click Settings on the top right corner of the page.
• Select Zoho Apps under Integrations.
• On the Zoho Apps page, click Show Details next to Zoho Projects.
• Click Enable Integration.
• Enter your Email Address and Zsc Key. 
• Click Save.

Now, the integration will be re-enabled for your Zoho Books account.

Troubleshooting

Zoho Books - Zoho Projects Integration

Migrate to the enhanced Zoho Books - Zoho Projects Integration

You can migrate to the enhanced integration in just a few clicks.

To migrate:

• Go to Zoho Books.
• Click Settings on the top right corner of the page.
• Select Zoho Apps under Integrations.
• Click the link Click here to migrate to the enhanced version of the integration provided under Zoho Projects.

• Read all the details of the integration in the pop-up that appears.

• Click Proceed to migrate.

Once done, all your data will be synced with Zoho Books, you will be able to set up contact & timesheet sync, and create transactions from Zoho Books and Zoho Projects.

Connect with Zoho Projects

• Open your Zoho Projects account and navigate to the Settings page.
• Select Org Settings and click on the Portal Settings tab.

• Scroll down to find the Developer Space section.
• Copy the ZSC (Zoho Service Communication) Key and the Email ID from this section.

• Login to your Zoho Books account and go to > Integrations > Zoho Apps.
• Here you will find Zoho Projects which has not been integrated yet.
• To integrate, click on Connect.

• A new window will pop up, requesting your Email Address and Zoho Projects ZSC Key.
• Enter or Paste the credentials that you copied previously from your Zoho Projects account and click on Next.

• Once the connection is through, you will be requested to select a Portal which has been linked to your Zoho Projects Account.

The list will show all the portals in which you are the Owner.

• Done, now you have successfully integrated Zoho Projects with your Zoho Books account.

Note: When you setup the integration, your organisation’s name and email address will be shared with Zoho Projects.

Create an Invoice from Zoho Books for Zoho Projects

• Click the More Actions icon from the Invoices list window and select Invoice for Zoho Projects.

• A new window will open up requesting you to select and enter information for creating an invoice for Zoho Projects.

• The drop downs will contain the information already saved in your Zoho Projects account.
• Select the project(s) in Zoho Projects for which you are creating an invoice. You can select a maximum of 5 projects.
• Select the customer for the project.

If you wish to send the invoice to a customer created in your Zoho Books account, leave the customer field blank and create invoice. You can select the customer when the invoice form shows up for editing.

• Enter the Rate, set the from & to date and select the invoice type. Invoice type categorises the line items accordingly. i.e., Projects as a whole in a line item, all the tasks as line items, etc.
• If you wish to include any unbilled expenses, select Yes. include all unbilled expenses associated with this project.

This will include expenses created in Zoho Projects for the above selected project and customer only.

• Click on Create Invoice to finish.
• Once created, this invoice will reflect in your Zoho Projects accounts under Invoices & Expenses tab. This invoice can be edited in Zoho Projects too.

In the same manner, invoices and expenses created in Zoho Projects will also be reflected in Zoho Books. You can view and edit the invoice in your Zoho Books account and generate reports.

Note: Once a task is completed and invoiced in Zoho Projects / Zoho Books, it cannot be invoiced again in Zoho Books / Zoho Projects.

Benefits of the Integration:

• View & edit the invoices created under Zoho Projects in your Zoho Books account.
• Create an invoice in your Zoho Books account for projects created in Zoho Projects.
• View expenses created from your Zoho Projects account in Zoho Books.

Was this document helpful?

Yes

No

Let us know where we can improve

Enter your comments or feedback on this page

Enter your email address

Refresh

Type the characters you see in the image above

By clicking Submit, you agree to our Privacy Policy .

Submit Cancel

Submit

Submit

Thank you for your feedback!

Want a feature?

Suggest