Step 1: Create a connection for Zoho FSM in Zoho Books    

1. Log in to Zoho Books.
   
2. Navigate to Settings > Developer Space > Connections and click New Connection.
   
   
   
   
3. In the Create Connection page, select the Custom Services tab and click Create New Service.
   
   
   
   
4. In the Create Service page, enter the following details and click Create Service.
   
1. Service Name: Zoho FSM
   The Service Link Name will be automatically populated.
2. Authentication Type: OAuth2
   
3. Parameter Type: Header
   
4. Generated Client ID, Client Secret
   
5. Authorize URL: https://accounts.zoho.com/oauth/v2/auth?access_type=offline&prompt=consent
   
6. Access Token URL: https://accounts.zoho.com/oauth/v2/token
   
7. Refresh Token URL: https://accounts.zoho.com/oauth/v2/token
   
8. Scope: ZohoFSM.modules.all
   Provide a Scope Display Name.
   
   
   
   
5. Click Create Connection.
   
6. Do the following and click Create And Connect:
   
1. Connection Name: Zoho FSM
   
2. Select the Scope ZohoFSM.modules.all.
   
   

Step 2: Create a custom function in Zoho Books    

1. Navigate to Settings > Automation > Custom Functions and click New Custom Function.
   
   
   
   
2. Enter the following details and click Save:
   
1. Function Name: createwofromso
   
2. Module: Sales Order
   
3. In the Deluge Script Editor, enter this script.
   

In Zoho Books, ensure that the status of the internal connections for Zoho Books, and Zoho FSM Integration tasks is Connected. The green dot [] indicates that the connection is Connected.

 

Step 3: Create a workflow rule in Zoho Books     

1. Navigate to Settings > Automation > Workflow Rules and click New Workflow Rule.
   
   
   
   
2. In the New Workflow Rule screen, enter the following details and click Next:
   
1. Workflow Rule Name: CreateWOFromSO
   
2. Module: Sales Order
   
   
   
   
3. For Choose when to Trigger, enter the following details and click Next.
   
1. Workflow type: Event Based
   
2. When an Estimate is: Created
   
   
   
   
4. Click Next for Filter the triggers.
   
5. In the Actions section, do the following:
   
1. Type: Custom Functions
   
2. Name: The function created in the previous step.
   
   
   
   
6. Click Save.
   

Testing the use case  

1. Ensure that the Sales Orders module is enabled in Zoho Books. You can check this at Settings > Preferences > General > Select the modules you would like to enable.
   
   
   
   
2. Navigate to Sales > Sales Orders and click New.
   
   
   
   
3. Enter the necessary details and save (Save as Draft, Save and Send, etc.) the sales order.
   If you are creating a sales order using a Zoho FSM contact, ensure that a Service Address, Billing Address, and Email is present for the contact. If you are creating a sales order using a customer present only in Zoho Books, ensure that the customer is of type Individual and they have an email. Since a work order in Zoho FSM should have at least one service, ensure that you add to the sales order a service that is present in Zoho FSM. If you do not want to add a service in your sales order, in Zoho FSM create a dummy service with Unit Price zero, and make use of it in the sales order.