- Installation of PandaDoc in SugarCRM
- Setup of the PandaDoc module for SugarCRM modules
- Access SugarCRM modules to review the newly added PandaDoc module
- Setup of PandaDoc Templates to be used with SugarCRM
- Send product and pricing info onto PandaDoc documents from a SugarCRM opportunity
- Sending and tracking your documents
- Updating SugarCRM integration
Plan availability: Business and Enterprise
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, Contact, Calls, Cases, Knowledge Base, Leads, Meetings, Revenue Line Items, Tasks, Quotes and any custom modules created in SugarCRM. Module records with all of your custom fields and contact information, product info as well as pricing details, will flow into your documents seamlessly.
Note:The PandaDoc extension supports SugarCRM version 9.2.0, and will continue to work with older versions from 8.*.*. onwards.
Installation of PandaDoc in SugarCRM
Use the following link to download the “Zip” file that will be used to install PandaDoc into SugarCRM.
- Access SugarCRM, go to Admin > Module Loader;
- Under Module, click “Choose File” and then click “Upload”;
- Once the package has been uploaded, click “Install”.
Setup of the PandaDoc module for SugarCRM modules
In this example, we will add the module to Opportunities. However you will also need to add this to other SugarCRM objects if you want to use the PandaDoc integration with those modules. Open the Opportunity, so you see all account and opportunity information on the left.
You cannot add the PandaDoc module in List view.
- Click Create in the top right corner;
- Provide a name for the new section and click save. Example: “PandaDoc”;
- Click “Add a Row” to add a new section;
- Click “Add Sugar Dashlet”;
- Search for PandaDoc, once found click “PandaDoc” under title;
- Click Save to add the PandaDoc module to the new section;
- The PandaDoc module will now show up in the new section. Click “Save” to complete the setup.
Access SugarCRM modules to review the newly added PandaDoc module
To access the PandaDoc module, open any object’s record. If you see a message that says "Connect your PandaDoc account", click “connect” and login to your PandaDoc account.
Once you’re connected, you will see a list of related documents in the module, if applicable.
Setup of PandaDoc Templates to be used with SugarCRM
Before creating documents, you should setup templates and the way you want to pull data from SugarCRM. In the following sections, we will discuss the setup of “Roles” and “Tokens”.
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 module: First Name, Last Name, Email Address, Company and Phone. Click here for more details about how to use PandaDoc Roles.
Using SugarCRM – Contact Roles
If you re using Roles for SugarCRM, you can also match up the SugarCRM role to your PandaDoc Template Roles (see above) to automatically assign contacts to Roles. You must use the same naming convention for your PandaDoc template Roles.
Set up your template with tokens to pull data from SugarCRM
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.
To view all of the available data that you can push from an SugarCRM module record via tokens to a document, you should configure the PandaDoc module in SugarCRM and select the tokens to use.
Find this module, by clicking on Administration > Scroll down > PandaDoc section > Click “PandaDoc 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” and ability to add other objects to be used with the integration. You can click on each module 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.
Field entries are case sensitive!
You can also use the button “Add All Fields as Tokens”, to add all your SugarCRM fields to be used in this integration.
Click in the “Enable Modules” section to setup other objects to be used with the integration.
You can also send over custom fields that you created in SugarCRM.
Now review 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.
Using Tokens from SugarCRM and adding to your PandaDoc Templates.
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 an opportunity within SugarCRM — using this template — will be pre-filled this data.
Send product and pricing info to PandaDoc documents from a SugarCRM opportunity
PandaDoc offers options to use Revenue Line items and Quote line items to send to your PandaDoc pricing tables.
- Configure which items to be used in SugarCRM. Go to Administration > Scroll Down > PandaDoc tokens.
- You will see two options, “Revenue Line Items” and “Quote Line items”. Choose which types of product items to be sent to PandaDoc pricing tables. Note: You can choose only one.
- Setup PandaDoc to allow products from SugarCRM. For this, open your template, add a pricing block and enable the “Automatically add products to this table” feature. This will pull the SugarCRM product information including custom fields you added to your instance of SugarCRM.
Now every document created from a SugarCRM deal will have all of the Revenue Line Items/Quote Line Items name, description and QTY sent to PandaDoc pricing tables.
Sending and tracking your documents
Under a SugarCRM object (Opportunities, Contact, Accounts), go to the PandaDoc module and click Create a new document.
Once you send out PandaDoc documents from SugarCRM, you can find the attached documents, by accessing the PandaDoc module for that specific module in SugarCRM.
Updating SugarCRM integration
If you would like to update the version of the SugarCRM integration, do not uninstall the previous version. You can download the above zip file and follow the steps above.
If after installing the new version you see an error saying “Non existing field dashboard_type in Module dashboards,” you may need to update the database in SugarCRM. In SugarCRM, go to Administration > Repair > Quick Repair and Rebuild.