Focus:The focus of this self-help article is to provide the steps and information necessary to integrate SugarCRM with PandaDoc.
What does this integration do? This integration allows you to create, send, and track quotes, proposals, and contracts from within SugarCRM. You will be able to start the document creation process from an Opportunity, Account and Contact object from SugarCRM. Opportunity records with all of your custom fields and contact information, product info as well as pricing details, will flow into your documents seamlessly.
Before you get started, however, please make sure that you have a PandaDoc account (Don’t have one yet? Sign up here.)
Which SugarCRM versions is supported with this integration?: Currently, our integration extension supports the latest stable version of SugarCRM (7.7.0), however other versions could be used, example SugarCRM (22.214.171.124)……
Step 1: Installation of PandaDoc in SugarCRM
Step 1a: Use the following link to download the “Zip” file that will be used to install PandaDoc into SugarCRM.
Zip file: https://s3-us-west-2.amazonaws.com/pd-integrations-packages/sugarcrm/PandaDoc-SugarCRM-1-0-2.zip
Step 1b: Access SugarCRM, go to Admin Section > Module Loader
Step 1c: Under Module, click “Choose File” and then click “Upload”
Step 1d: Once the package has been uploaded, click “Install”.
Step 2: Setup of the PandaDoc module for SugarCRM objects. In this example, we will add the module to Opportunities. However you will also need to add this to Accounts and Contacts if you want to use the PandaDoc integration with those objects. Open the Opportunity, so you see all account and opportunity information on the left.
Open any Opportunity, on the far right, click “Create”. Please note: You cannot add the PandaDoc module in List view.
Step 2b: Provide a name for the new section and click save. Example: “PandaDoc”
Step 2c: Click “Add a Row” to add a new section.
Step 2d: Click “Add Sugar Dashlet”.
Step 2e: Search for PandaDoc, once found click “PandaDoc” under title.
Step 2f: Click save to add the PandaDoc module to the new section.
Step 2g: The PandaDoc module will now show up in the new section. Click “Save” to complete the setup.
Step 3: Access SugarCRM objects to review the newly added PandaDoc module.
To access the PandaDoc module, open any Opportunity, Account, and Contact record. If you see a screen like this, please click “connect” and login to your PandaDoc account.
Once you’re connected, you will see a list of related documents to an Opportunity, Account, and Contact object, if applicable. Please note that when you click on “Create a new document”, a window will open up to access PandaDoc to start the document creation process.
Step 4: Setup of PandaDoc Templates to be used with SugarCRM. Next, we need to setup our templates and how we want to pull data from SugarCRM. In the following sections, we will discuss the setup of “Roles” and “Tokens”.
Step 4-A: Use of PandaDoc Roles and templates to import Contact information. With the use of PandaDoc Roles, we can import the following contact information from a SugarCRM Opportunity object: First Name, Last Name, Email Address and Company. Click here for more details about how to use PandaDoc Roles.
Step 4-B: Setup your tokens to pre-populate your documents with deal data.
Tokens are very helpful timesavers that auto-fill information from a deal, contact or an organization record into a document.Learn more about tokens here.
Step 4-C: Access PandaDoc module to configure which SugarCRM fields to include for PandaDoc tokens.
To view all of the available data that you can push from an Opportunity, Account, and Contact object record via tokens to a document, we have to configure the PandaDoc module in SugarCRM and select the tokens to use.
We can find this module, by clicking on Settings > Admin > Scroll down > PandaDoc section > Click “PandaDoc Tokens”.
Step 4-D: Configuring fields to be used for tokens. Here you will see PandaDoc settings that includes details and information on configuring tokens.
In the configure token section, you will see “Opportunity”, “Account” and “Contact”. You can click on each object and you will see a list of fields. Next, click on “Add New”, next from the dropdown list, select your file and give it a name. Please note: Field entries are CaSe SeNsItIvE!
Step 4-E: Review of fields that were added for tokens inside of the PandaDoc module. In this example we will go back to an Opportunity. On the right side, find the PandaDoc module. Click the green “gear” icon and then click “Tokens”. You will then see a list of tokens that you can use for PandaDoc templates for each object.
Step 4-F: Using Tokens from SugarCRM and adding to your PandaDoc Templates.
To do so, first go to PandaDoc and open your template. Then copy and paste token IDs from the PandaDoc panel within SugarCRM into your template. The most important thing is to [place them into square brackets]. This is what differentiates them from regular text.
From now on every document that you create from a deal within SugarCRM — using this template — will be pre-filled with the Account Name and Amount in this example.
Step 4-G: Custom Fields from SugarCRM. You can also send over custom fields that you created in SugarCRM. Once you have your custom Fields, follow Step 4-D above to add those custom fields to be used with PandaDoc.
Step 5: Pre-populate your documents with product and pricing details from within a SugarCRM opportunity.
Example Product in SugarCRM:
Step 5-A: Setup PandaDoc to allow products from SugarCRM. In order to do this, all that is required is that you add a pricing block and enable the “Automatically add products to this table” feature. This will pull the SugarCRM product information and including custom fields you added to your instance of SugarCRM.
Now every document created from a SugarCRM deal will have all of the products, quantity, and pricing information from that particular deal.
Step 6: Sending and tracking your documents.
Step 6-A: Sending your first document. Under a SugarCRM object (Opportunities, Contact, Accounts), login to PandaDoc to begin document creation. See screenshot below for to see an example under “Opportunities.” Going forward, you always want to make sure you’re logged into PandaDoc when you want to create a document through SugarCRM.
Step 6-B: Tracking. Once you send out PandaDoc documents from SugarCRM, you can find the attached documents, by accessing the PandaDoc module for that specific object in SugarCRM.