Jump to: navigation, search

Zoho Books Integration

Zohobooks Integration User-Guide

The Zoho Books allows you to manage your finances, customers, automate your workflow along with working across different departments. Integrate with this end-to-end accounting solution to manage your finances from a single platform. We offer two-way sync functionality for Order Status and Order Payment Status from the ZOHO Books to the OnPrintShop account and automatically raise invoices for the payments.

Note – With Zoho Books integration, 1000 Data can be synced in a day.

Read along the systematic guide to understand the ZOHO Books Integration with your application:

Step – 1 Create Client and Get Client ID/Secret

  • Visit the ZOHO’s developers’ console
  • Sign up with your name, email address, and other login credentials.
  • Confirm your account via email and again login with an email and password.
  • If you already have an account then login into the console.
  • Click on the ‘Get Started’ button.
  • ZohoBooksIntegration1.png

  • In the next screen, create a new application by selecting the Client Type as “Server-Based Applications”:
  • ZohoBooksIntegration2.png

  • It will take you to the Create New Client page:
  • ZohoBooksIntegration3.png

  • Enter the following details
    1. Client Type– Here automatically ‘Server-based Applications’ will be selected, Keep it as it is.
    2. Client Name– Enter the name of your application you want to register with Zoho.
    3. Homepage URL– This is the name of your domain to be used in URLs to identify your web page.
    4. Authorized Redirect URIs– A URI endpoint of your application to which Zoho Accounts redirects you with a grant token (code) after successful authentication.

    Note: OPS Technical Team will provide you with the redirect endpoint URI.

  • You will be navigated to the next screen, as below:
    1. Client ID– The consumer key generated from the connected app.
    2. Client Secret– The consumer secret generated from the connected app.
    3. ZohoBooksIntegration4.png

  • Save these codes for future use and click on the Close.

Step – 2 Create Organization and Get the Organization ID

This is the Organization where all the synced data from the OnPrintShop Admin Panel will be mapped. To create and get the Organization ID, follow the below steps –

  • Go to, https://www.zoho.com/in/books/
  • Click on the ‘ACCESS ZOHO BOOKS’ button.
  • ZohoBooksIntegration5.png

  • This will take you to the Zoho Books Home Page where you need to create the Organization:
  • ZohoBooksIntegration6.png

  • On the screen, enter the Organization Name and your Business Location.
  • When done, click on the “Let’s get started!”.
  • ZohoBooksIntegration7.png

  • Set up your organization profile and click on the Get Started button.
  • Now, you can see your Organization created.
  • To get the Organization ID, click on the Organization Name appearing at the top-right corner in the header:
  • ZohoBooksIntegration8.png

  • You’ll get the Organization ID from the My Organization section. Copy and save the Organization ID for future use.

Step – 3 Enable Sales Order and Configure GST as well as Tax

To sync the Sales Orders and Taxes, we need to configure the same in the Zoho Books.

Sales Order

  • From the Zoho Books home page (https://books.zoho.com/app#/home), click on the Settings icon from the top-right corner and then click on the Preferences:
  • ZohoBooksIntegration9.png

  • From Preferences, select the General Preferences and then check the box for “Sales Order” if not already checked:
  • ZohoBooksIntegration10.png

Configure GST Settings

For Australia:

  • Go to Settings >> Taxes >> Taxes Settings.
  • Select ‘Yes’ for the option ‘Is your business registered for GST?’

    ZohoBooksIntegration20.png

    1. Configure your ABN, Reporting Period, Tax Basis, and choose the date from which you wish to generate your first tax return.
    2. Save the details.
  • Note: The above configuration is only required for the Australia Country i.e. if your organization's country is Australia.

  • This will update your tax settings that will reflect in your transactions, reports and returns. If would like to file your GST from Zoho Books, you will have to enable online filing.

Configure Tax Rates

  • Now, let’s configure the tax rates for this organization. From the same screen, click on the Taxes menu under the Settings:
  • ZohoBooksIntegration11.png

  • Select the Tax Rates under the Taxes and then click on the New Tax button.

    ZohoBooksIntegration12.png

    1. Enter the name for the Tax.
    2. Specify the rate in %
    3. Add or select the name of the Tax Authority.
    4. Note: For Australian organizations, this field is not mandatory.

    5. Click on Save to create the new tax rate.
  • You can create multiple Taxes as per the requirement or even group them using the New Group button beside the New Tax button.

Step – 4 Configuration into OnPrintShop Admin Panel

Let’s configure all the IDs, Secret Key, and Tokens into the Admin Panel.

  • On the Admin Panel, go to – Admin >> Store Configuration >> External Service Settings >> Accounting tab >> Zoho Books:

    ZohoBooksIntegration13.png

    1. Client ID: Enter the Client ID saved in Step - 1
    2. Client Secret: Enter the Client Secret saved in Step - 1
    3. Redirect Uri: Enter the Redirect Uri saved in Step – 1. (The Redirect Uri will be provided by the OPS technical team.)
    4. Organization ID: Enter the Organization ID saved in Step - 2
    5. Code: Click on the Connect button from the bottom of the page. It will take you to a web page where you need to click on the Accept button to generate the code:
    6. ZohoBooksIntegration14.png

    7. As soon as you click on the Accept, the system will generate the Code, to sync your OnPrintShop data into ZOHO books.
    8. Tax: Select a Tax from the list which will be synced in the OPS for the tax calculation (Taxes created in Zoho Books Organization will be displayed in the list runtime).
    9. Note: Only one tax (if you have multiple) can be synced at a time.

    10. Invoice Number: Enable this option to enter the Invoice Number manually in the Zohobooks. You need to enable this field, if you have configured the Invoices section in Zohobooks and selected the “I will add them manually each time” radio button in the Invoices >> New Invoice >> Invoice Number Settings screen of the Zoho Books.
    11. ZohoBooksIntegration19.png

    12. Order Status: The drop-down will list OPS Order Status. Select the status for which you want the OPS Orders to sync in the ZOHO Books.
    13. Paid Status: When the payment status in the Zohobooks for an invoice is set as ‘Paid’ then, the status selected in this field will be displayed in the OPS for that order.
    14. Email Status: This field is to send a trigger of the Invoice Payment Request email for the customers to the ZOHO Books system. The field lists OPS Order status, select the order statuses for which the invoice payment request email needs to be sent.
    15. OPS will send a trigger only when the Invoice status is “Unpaid” in the Zohobooks and if all the order product status in an OPS order matches with the status selected in this field.
    16. Note: OPS will just send an email trigger to the ZOHO Books system. ZOHO Books will send the Payment Request email notification to the necessary customers.

    17. Sync Order: Choose to sync Sales Order, Invoice, or both.
    18. Debug Mode: This is for the OPS Technical team testing purposes.
    19. Note: You can enable this option if you find that the sync process is taking more than usual time. Once enabled, it will sync 3 orders, 3 products as well as 3 addresses at a time.

    20. Once the above details are configured, you are all set to manually sync - Customer, Address, Product and Order by clicking on the respective buttons:
    21. ZohoBooksIntegration15.png

Note: You must sync the above modules in the following sequence only – Customers, Address, Product and last Order.

If the above sync sequence is not maintained then, all sync will fail as the system will not get the required dependent data.

Zohobooks Logs

With the Zohobooks Logs functionality, you can view the details of the Products, Orders (Sales Orders), Invoices and Customers synced. On the screen, you can get the IDs from the Zohobooks and OPS for the items synced along with the date and time for sync. For the Invoices, you may know if the email has been sent to the customers.

ZohoBooksIntegration16.jpg

The Log which appears by clicking on the View button is generally for the OPS Technical Team for the Technical purpose.