Function-11: Turn a contact into a vendor.

Function-11: Turn a contact into a vendor.


Welcome back everyone! 

Last week, we learnt how toadd the international call prefix '+' and remove the alphbet from numeric fields. This week, let's look at a custom function that lets you turn a contact into a vendor with just the click of a button.

Business scenario:

The Vendors module in Zoho CRM facilitates efficient tracking of all vendor related details. It lets you create and associate vendor records with address, contacts, products, and such. We recommend this method for creating vendor records. However, what if you have a scenario where the vendor is already a part of your Leads/Contacts module via inbound communication? It is unproductive and redundant work to update Vendors module again for the records already updated.

Custom functions help you overcome this hurdle. It gives you the flexibility of replicating the details from the Leads/Contacts module to the Vendors module at the click of a button.

Getting started with the custom function:
  1. Go to Setup > Customization > Modules > Select the required module > Links and Buttons > +Create new button .
  2. Provide a name for the button. For example: “Create Vendor”. Add a description(optional).
  3. Choose View page from the drop-down list.
  4. Select Writing custom function from the subsequent drop-down.
  5. Provide a name for the custom function. Add a description(optional).
  6. Click “ Free flow scripting ”.
  7. Copy the code given below.
  8. Click “ Edit arguments ”.
  9. Enter the name as “ contactId ” and select the value as “ Contact Id ”.
  10. Save the changes.
  11. Click Save to create the button.

The script:

This example code is for creating a record in Vendors module from Contacts module. 

Code for Version 2.0 API:
 
contDetails = zoho.crm.getRecordById("Contacts", input.contactId.toLong()); 
fullname = ifnull(contDetails.get("Full_Name"),"");
name = "CLIENT : " + fullname;
mp = map();
mp.put("Vendor_Name", name);
mp.put("Phone", ifnull(contDetails.get("Mobile"),""));
mp.put("Email", ifnull(contDetails.get("Email"),""));
mp.put("Currency", ifnull(contDetails.get("Currency"),""));
mp.put("Street", ifnull(contDetails.get("Mailing_Street"),""));
mp.put("State", ifnull(contDetails.get("Mailing_State"),""));
mp.put("City", ifnull(contDetails.get("Mailing_City"),""));
mp.put("Zip_Code", ifnull(contDetails.get("Mailing_Zip"),""));
mp.put("Country", ifnull(contDetails.get("Mailing_Country"),""));
mp.put("Owner", "1234567890");
mp.put("Primary_Contact", ifnull(contDetails.get("id"),""));
create = zoho.crm.create("Vendors", mp);
info mp;
info create;
return "Vendor Created Successfully";

Code for Version 1.0 API:

contDetails = zoho.crm.getRecordById("Contacts", input.contactId.toLong());
first = ifnull(contDetails.get("First Name"),"");
last = ifnull(contDetails.get("Last Name"),"");
name = "CLIENT : " + first + " " + last;
mp = map();
mp.put("Vendor Name", name);
mp.put("Phone", ifnull(contDetails.get("Mobile"),""));
mp.put("Email", ifnull(contDetails.get("Email"),""));
mp.put("Currency", ifnull(contDetails.get("Currency"),""));
mp.put("Street", ifnull(contDetails.get("Mailing Street"),""));
mp.put("State", ifnull(contDetails.get("Mailing State"),""));
mp.put("City", ifnull(contDetails.get("Mailing City"),""));
mp.put("Zip Code", ifnull(contDetails.get("Mailing Zip"),""));
mp.put("Country", ifnull(contDetails.get("Mailing Country"),""));
mp.put("SMOWNERID", "1234567890");
mp.put("Primary Contact", ifnull(contDetails.get("CONTACTID"),""));
create = zoho.crm.create("Vendors", mp);
info mp;
info create;
return "Vendor Created Successfully";

Note:

  • This custom function creates a record in a module with the information from another module, reducing duplicate work and improving efficiency. 
  • Change the name of the module from 'Contacts' to the intended module name and update the code accordingly.

Found this useful? Try it out and let me know how it works! If you have questions, do not hesitate to ask! Share this with your team if you find it useful. Do check out other custom functions shared in this serieshere.

See you all next week with another interesting custom function. Ciao!

Update: As you must be aware, API V1.0 will be deprecated and support for version 1.0 API will be available only till Dec 31, 2018. Version 1.0 compatible Functions will continue to work until Dec 31, 2019. You're advised to migrated to API Version 2.0 at the earliest. Check this announcement for more. We've updated the post to include the Version 2.0 compatible Function.

    Access your files securely from anywhere

          Zoho Developer Community




                                    Zoho Desk Resources

                                    • Desk Community Learning Series


                                    • Digest


                                    • Functions


                                    • Meetups


                                    • Kbase


                                    • Resources


                                    • Glossary


                                    • Desk Marketplace


                                    • MVP Corner


                                    • Word of the Day



                                        Zoho Marketing Automation


                                                Manage your brands on social media



                                                      Zoho TeamInbox Resources

                                                        Zoho DataPrep Resources



                                                          Zoho CRM Plus Resources

                                                            Zoho Books Resources


                                                              Zoho Subscriptions Resources

                                                                Zoho Projects Resources


                                                                  Zoho Sprints Resources


                                                                    Qntrl Resources


                                                                      Zoho Creator Resources



                                                                          Zoho Campaigns Resources


                                                                            Zoho CRM Resources

                                                                            • CRM Community Learning Series

                                                                              CRM Community Learning Series


                                                                            • Kaizen

                                                                              Kaizen

                                                                            • Functions

                                                                              Functions

                                                                            • Meetups

                                                                              Meetups

                                                                            • Kbase

                                                                              Kbase

                                                                            • Resources

                                                                              Resources

                                                                            • Digest

                                                                              Digest

                                                                            • CRM Marketplace

                                                                              CRM Marketplace

                                                                            • MVP Corner

                                                                              MVP Corner





                                                                                Design. Discuss. Deliver.

                                                                                Create visually engaging stories with Zoho Show.

                                                                                Get Started Now


                                                                                  Zoho Show Resources


                                                                                    Zoho Writer Writer

                                                                                    Get Started. Write Away!

                                                                                    Writer is a powerful online word processor, designed for collaborative work.

                                                                                      Zoho CRM コンテンツ






                                                                                        Nederlandse Hulpbronnen


                                                                                            ご検討中の方





                                                                                                  • Recent Topics

                                                                                                  • Can documents attached to different ZohoForms automatically go to different OneDrive folders?

                                                                                                    Hi there, I set a workflow to track and store applications coming in from our website. I created two different Zoho forms, one for unsolicited applications, one for applications to job postings. After any of the forms has been filled in, a new record
                                                                                                  • Kaizen #126 - Circuits in Zoho CRM - Part 1

                                                                                                    Hello everyone! Welcome back to another week of Kaizen! Today, we will discuss an exciting topic—Circuits in Zoho CRM. For starters, we will discuss what Circuits are, how beneficial they are for businesses, different views of a Circuit, and the different
                                                                                                  • Custom field doesn't fill when converting sales order to invoice

                                                                                                    Hi, When I convert a Sales Order to an Invoice one of the custom fields on a product line names "Subsidie" does not seem to fill in automatically. I manually have to select the product again by clicking on the product name in the order line en re-select
                                                                                                  • TeamInbox down?

                                                                                                    Hi everyone, we are getting message "Sorry, this action cannot be performed due to an internal error. Please try again later. We are on the Canadian data centers. Can someone please confirm if the service is down? Thank you! F
                                                                                                  • Purchase Requisition in Zoho Books

                                                                                                    I want to understand if Zoho Books is having the following workflow: PR ( Purchase Requisition ) >> PO ( Purchase order) >>  GRN/SRN ( Goods/Services receipt note) >> Bill
                                                                                                  • Confirmation prompt before a custom button action is triggered

                                                                                                    Have you ever created a custom button and just hoped that you/your users are prompted first to confirm the action? Well, Zoho knows this concept. For example, in blueprint, whenever we want to advance to the next state by clicking the transition, it is
                                                                                                  • Marketer's Space: Streamline marketing and sales by integrating ZMA's Planner with Zoho CRM

                                                                                                    In a competitive market, clear goal-setting and seamless campaign execution are crucial for marketing and sales alignment. When integrated with Zoho CRM, Zoho Marketing Automation's Planner enables marketers to create, manage, and measure campaigns effectively
                                                                                                  • Custom emails for Portals not working

                                                                                                    I changed the standard templates to custom email templates for all three options, but the invitation is still sending the original email layouts. Anyone know why this would be happening? I changed them 2 days ago.
                                                                                                  • Switching scheduled webinars from Live to On-demand

                                                                                                    Now that On-Demand webinars has been added as an option for webinar presenting, is there a way I can edit already scheduled webinars from Live to on-Demand? These scheduled webinars already have people registered. Thanks
                                                                                                  • Zoho CRM v2.1 deprecation or sunset plans ?

                                                                                                    Hi Team Wanted to know if there is any plan to deprecate v2.1 CRM apis https://www.zoho.com/crm/developer/docs/api/v2.1/ and if yes by when
                                                                                                  • Forex Bank Refund Entry

                                                                                                    Hello, please advise how to enter refunds from our bank forex department. The refund was because we were on preferential rates but at the time of USD purchase were not given the preferential rate, therefore the bank calculated the excess that we paid
                                                                                                  • Auto-Populating Custom Field

                                                                                                    This is to request a feature enhancement for our invoicing system. We're currently creating invoices with a single item per invoice and have a custom field called "Related Vehicle." We would like the "Related Vehicle" field to be automatically populated
                                                                                                  • How can i Customize Delivery Note?

                                                                                                    I need to customize delivery note like change the tittle for language purposes and also include only the balance due
                                                                                                  • Delivery note template

                                                                                                    We have some reasonable templates for sales docs but the delivery note one is very limited. It would be nice if we could have the same options as the sales form templates or even create our own by cloning an existing sales template, modifying (ie: removing
                                                                                                  • INTERCOMPANIES INVOICING

                                                                                                    Dears , I paid expenses on behalf of our sister company from my cash account , then month End i issued an invoice to the sister company , my question is how to put the expenses GL in the invoices
                                                                                                  • Zoho CRM Theme Color?

                                                                                                    I've read multiple articles stating it's possible to change Zoho CRM theme colour (top menu bar) from personal settings menu, however, my zoho has no options for this at all and I've looked everywhere........has this feature been removed? I'm currently
                                                                                                  • How can i force the user to select a project when creating an invoice ?

                                                                                                    Hello I tried all the ways that i know , but no way is able to stop creating an invoice without project.
                                                                                                  • Sales

                                                                                                    1/ How can I make a discount on invoice exmple : invoice 5,100 le , custmar pay 5000 and I need to make this 100 le as a discount , how can i make it ?! 2/ Is thare any report can make me match my company’s balance with the customer’s balance?
                                                                                                  • Include Project Hours when Creating Estimates from Projects

                                                                                                    Hi Currently, in Books, you can create estimates from Projects by inserting tasks that pull both the task and the hourly charge rate. But it doesn't pull the budgeted hours for the task, so you manually have to remember the number of hours for a given
                                                                                                  • acc

                                                                                                    Regularly sending statements to customers is an imperative part of many business processes as it helps foster strong customer relationships and provides timely guidance on pay//
                                                                                                  • South African Payment Gateways

                                                                                                    Since the "Demise" of Wave many South African users have moved over to Zoho and yet for years users have been requesting Integration with a South African Payment Gateway to no avail. Payfast was the most commonly requested gateway as it supports recurring
                                                                                                  • CRM Implementation

                                                                                                    I need to implement Zoho CRM. Is there a useful user manual available to guide me through the implementation?
                                                                                                  • Zoho Social integration with Zoho Flow

                                                                                                    Is there any plans for Zoho Social integration with Zoho Flow?
                                                                                                  • Marketing 2.0 has been a catastrophe

                                                                                                    Anyone else having significant issues with their link between their CRM and Marketing automation since moving to version 2.0? We had an easy flow for triggering leads in the CRM to journeys in Marketing Automation but now nothing seems to work properly.
                                                                                                  • Cannot average "Duration (Time)" from Pick List History Tracking in Reports

                                                                                                    Okay, let's say I have a custom module. In this custom module I have a pick-list named "Status" with "New", "In-Progress", "Completed" values. I also have turned ON pick-list history tracking and chose "Time" to track the duration in (instead of "Calendar
                                                                                                  • Customer Statement Template

                                                                                                    Hi. how can i add order number "customer LPO number" in the customer statement. regards
                                                                                                  • Authorize.Net Update: Disable Transaction IP Velocity Filter to Avoid Payment Failures

                                                                                                    Update: The Authorize.Net integration was updated on November 20, 2024. To prevent recurring transaction failures, we recommend disabling the Transaction IP Velocity Filter at the earliest. We’re updating the Authorize.Net integration in Zoho Books on
                                                                                                  • Need to send a single email to up to 20 recipients

                                                                                                    I want to send a single email to ~16 or 20 recipients. It appears that I cannot do this in Zoho email as it gets flagged as unusual activity. I need to be able to communicate with this group on a regular basis. What am I missing that Zoho doesn't allow
                                                                                                  • Whatsapp Limitation Questions

                                                                                                    Good day, I would like to find out about the functionality or possibility of all the below points within the Zoho/WhatsApp integration. Will WhatsApp buttons ever be possible in the future? Will WhatsApp Re-directs to different users be possible based
                                                                                                  • Unable to Schedule One-to-One Emails in Zoho CRM

                                                                                                    Hi everyone, I’m using the Zoho CRM Professional Edition and facing an issue with scheduling one-to-one emails directly from CRM. While I can send immediate emails without any problem, I don’t see an option to schedule these emails for a later time. I’ve
                                                                                                  • Canvas Detail View Related List Sorting

                                                                                                    Hello, I am having an issue finding a way to sort a related list within a canvas detail view. I have sorted the related list on the page layout associated with the canvas view, but that does not transfer to the canvas view. What am I missing?
                                                                                                  • Repeatable Fields/Sections in Zoho CRM

                                                                                                    Hi Zoho Team, We have a module in CRM named "Clients". We would like to know whether it is possible to have a feature enables us to have repeatable sections in our clients' profiles? For example, if we customized a section in the clients' profiles named
                                                                                                  • Zoho Analytics: Requests for view access

                                                                                                    Hello, We have a user that might request access to a certain view, report etc. However this request for access is being sent to different admins within the workspace, is is possible to set who the "approver" is of these requests? If not what are the rules
                                                                                                  • Boolean Fields in Mail Merge Displaying as Checkmarks

                                                                                                    I'm really liking the new mail merge functionality. It's replaced the Zoho Sign extension for us. One problem I've seen is that boolean operators (i.e. Checkbox fields) in CRM merge as "True" or "False". This looks a little ugly in my final document — is there a way I can get those to display as checkboxes?
                                                                                                  • Formula in Sub Form

                                                                                                    Hello - I have created a sub-form and the data is going to be insurance policy information. However some of the policy amounts are based on a percentage of a main coverage. For example, Debris removal coverage is 5% of the main dwelling policy. Is there
                                                                                                  • Email alias already exist

                                                                                                    Hello, I'm getting an error message the email alias already exist when attempting to add 2 email addresses. The emails are associated with an account I deleted. I started a new account and need to add them back to get 1 email at each. I have an open ticket
                                                                                                  • Migrate emails from a shared mail box to a private mail box

                                                                                                    How is possible migrate a shared mail box if the migration tool require a password, and the shared mail dosent have ?
                                                                                                  • Support poor service

                                                                                                    I just wanted Zoho support to give me some more concrete answers. I’m facing SMTP error issues, and they told me that the South American IP was experiencing problems, but they didn’t provide an estimate for when it would be resolved. Now my company is
                                                                                                  • Zoho say my domain seems to be already associated with another account

                                                                                                    I created a zoho account for try my domain mail configuration. When I want to add my domain in this page https://mailadmin.zoho.com/hosting?plan=free then this shows an error that is "This domain is already associated with this account a*****n@f*****."
                                                                                                  • Incorrect Device Time

                                                                                                    Hi On my windows laptop I can't sign into Zoho mail due to "incorrect device time". I'm in Toronto, Canada. How can this be resolved?
                                                                                                  • Next Page