Auto Apply Retainer via Zoho Books

Need Help? Click Here to Contact Us
Want the code, not the explanation? Here's a link to a copy of the function!
Difficulty: Advanced
Estimated reading time: 30 mins
Estimated implementation time:
1 hour 30 mins

Zoho Books Auto Apply Retainer

For this custom function to work, you will need the following:

  1. A connection to the Zoho Books API named “zoho_books”.
  2. At least one Retainer Invoice.
  3. An Invoice to apply it to.

Zoho Books Connection

Create API Credentials: Gives you a Client ID and Client Secret to use in the next step.

  1. Go to the Zoho API Console
  2. Click Add Client and select Server-based Applications
  3. Fill in the following fields:
    • Client Name -> Zoho Books API
    • Homepage URL -> https://books.zoho.com
    • Authorized Redirect URIs -> https://deluge.zoho.com/delugeauth/callback
  4. Click Update
  5. Notice the Client ID and Client Secret here. You will need these in the next step, so keep this tab open.

Want to learn even more? Sign up for one of our Zoho courses!

Free
0 Lessons

Should I Use Zoho Sites, or Another Website Builder?

0% Complete
0/0 Steps
Free
5 Lessons

How to Set Up (a Simple Version of) Zoho Desk  

0% Complete
0/0 Steps
Free
0 Lessons

Should I Use Zoho Meeting, or Another Webinar/Web Conferencing Tool?

0% Complete
0/0 Steps

123→

Create Custom Connection

  1. Go to Zoho Books
  2. Click Settings, select the Automation tab, then choose Custom Functions.
  3. Select + New Custom Function and give it a random name and module. We will only use this function for a simple test.
  4. Choose Connections on the right hand side, then Go To Connections.
  5. Click Add Connection. Choose Custom Service.
  6. Fill in the following fields (This has to be very exact):
    • Service Name -> Zoho Books
    • Service LinkName -> zoho_books
    • Authentication Type -> oAuth2
    • Param Type -> Header
    • Grant Type -> Authorization Code
    • Client ID -> [YOUR_CLIENT_ID]
    • Client Secret -> [YOUR_CLIENT_SECRET]
    • Authorize URL -> https://accounts.zoho.com/oauth/v2/auth?
    • Access Token URL -> https://accounts.zoho.com/oauth/v2/token?
    • Refresh Token URL -> https://accounts.zoho.com/oauth/v2/token?
    • Connection Name -> Zoho Books
    • Connection LinkName -> zoho_books
    • Scope -> ZohoBooks.fullaccess.all (Note: Be sure to click the ‘+’ for the scope)
    • Use credentials of login user -> UNCHECKED
  7. Click Create and Connect. If asked to authenticate, enter your login details.

Click here to copy these scripts. For more Zoho-wizardry, check out our GitHub page.

Want this functionality, but don't want to do it yourself?
Click here to request one of our experts to reach out to help!

Request a Consultation

More Free Resources

Deluge Tips – Null Check

April 20, 2021 No Comments

When scripting, ask yourself this question – will this value ever be null? If it’s a yes, that’s a place for a null check! Here are 3 tips and best practices to help you kickstart the habit.

Read More »