Microsoft Dynamics CRM Integration with PandaDoc -Setup Custom Entities

Focus:  The focus of this self-help article is to provide the steps and information necessary to integrate Microsoft Dynamics CRM with PandaDoc, using Custom Entities you have created in your Microsoft Dynamics account.

Custom entities setup: With the PandaDoc / Microsoft Dynamics integration, you have the ability to setup and use the PandaDoc module in your custom entities.

Installation of PandaDoc in Microsoft Dynamics CRM.

If you have not gone through the installation of PandaDoc in Microsoft Dynamics, click here for instructions.

Setup of PandaDoc inside of your custom entities in Microsoft Dynamics:

Step 1:  Create a custom entity in Dynamics. Add the custom entity to the CRM main navigation. If you have not yet created your custom entity, you can use the following steps below.

Step 1a: Open Settings -> Customizations

MS Dynamics - Custom Entity - Step 1

Step 1b: Customize the System

MS Dynamics - Custom Entity - Step 2

Step 1c: Select New -> Entity

MS Dynamics - Custom Entity - Step 3

Step 1d: Enter Name, Display Name and Plural Name and Save. Please note: The entity displayed with show up in Settings Area (Menu)

MS Dynamics - Custom Entity - Step 4

Step 1e: Go to Forms and open Main form.

MS Dynamics - Custom Entity - Step 5 MS Dynamics - Custom Entity - Step 6

Step 1f:  Make sure the Iframe is setup with the following:

In the INSERT tab select IFRAME and enter data:

MS Dynamics - Custom Entity - Step 7

Step 1g: Close iframes  window and go to Home tab. Click Form Properties.

  • Click Add in Form Libraries
  • Select and add:
    • new_/pandadoc/jquery_2.2.0.min.js
    • new_/pandadoc/xrmservicetoolkit.min.js
    • new_/pandadoc/pandadoc.to.crm.js
MS Dynamics - Custom Entity - Step 9

Close Form Properties window. CLick Save. Click Publish.

Step 2: Map entity form fields with PandaDoc tokens per Extensions > PandaDoc Settings

Step 2a: Go to Settings -> PandaDoc Settings

MS Dynamics - Custom Entity - Step 10

Step 2b: Click +Add Entity, select just created entity, click Save

MS Dynamics - Custom Entity - Step 11

Step 2c: Select tokens and save mapping.

MS Dynamics - Custom Entity - Step 12

Step 3: Navigate to the custom entity and create a new record.

Step 3a: Go to Settings -> Custom Entities

MS Dynamics - Custom Entity - Step 13

Step 3b: Click New to create new instance of the entity

MS Dynamics - Custom Entity - Step 14

Step 4:  Make sure the custom entity has a create record form with a PandaDoc related documents view.

Step 4a: Enter field values:

 i. Make sure that you are logged into your PandaDoc account
ii. Refresh the page to see PandaDoc loaded.

MS Dynamics - Custom Entity - Step 15

Step 5: Setup of PandaDoc Templates to be used with Microsoft Dynamics CRM.  Next, we need to setup our templates and what data we want to pull from Microsoft Dynamics CRM. In the following sections, we will discuss the setup of “Roles” and “Tokens”.

Step 5-A: Use of PandaDoc Roles and templates to import Contact information. With the use of PandaDoc Roles, we can import contact information from custom entities: First Name, Last Name, Email Address and Company. Click here for more details about how to use PandaDoc Roles.

MS Dynamics - Step 4 - PD Template - Setup of Roles

Step 5-B: Setup your tokens to pre-populate your documents with data.

Tokens are very helpful timesavers that will auto-fill information from an entity into a document. Learn more about tokens here.

To  find the token values in the PandaDoc module in Microsoft Dynamics. Find the PandaDoc module, Click on the Green gear icon and click on Tokens.
MS Dynamics - Step 4c - Review tokens in Opp

Use the tokens and add to your PandaDoc templates.

Step 6: Create a PandaDoc document from the new record and Show tokens from the new custom entity record populating the affiliated document

Step 6a:  Click Create new document, select a template and see tokens’ data filled with instance values.

MS Dynamics - Custom Entity - Step 16

Step 7: Team Permissions to gain access to the PandaDoc integration. In MS Dynamics  > Settings > Security > Click on Security Roles > Open the Team member Role, go into “Custom Entities” tab and find “PandaDoc Tokens Mapping” > Read Permission must be set in order to use the integration.

MS Dynamics -- Custom Permission to gain access to the PD Module

 

Have questions? For faster support please:

  1. Log in to PandaDoc
  2. Click on the “Help” button next to your profile icon
  3. Choose Submit Help Request option

Or feel free to contact us using our public form:

Contact Support