Opmerking:
Deze handleiding heeft betrekking op de werking van de nieuwste 1.71 versie van de PandaDoc <> Salesforce-integratie.
Opmerking:
Sommige afbeeldingen en koppelingen in dit artikel zijn mogelijk alleen beschikbaar in het Engels.
Ga naar:
Beschikbaarheid van het plan:
PandaDoc: Jaarlijks Business*- en Jaarlijks Onderneming*-plan
Salesforce: 'Professional', 'Onderneming', 'Unlimited', 'Developer edition', 'Performance'.
*Deze integratie is beschikbaar als betaalde invoegtoepassing.
Wat kun je met de integratie doen?
Documenten aanmaken en verzenden vanuit Salesforce Opportunities, Leads, Contacten, Accounts of Aangepaste objectrecords.
Informatie uit Salesforce-records in PandaDoc-documenten zetten;
Prijstabellen automatisch invullen met Salesforce-producten;
Salesforce-contactpersonen gebruiken als documentontvangers;
Gegevens synchroniseren tussen Salesforce en PandaDoc (niet beschikbaar voor Group- en Professional-edities)
PandaDoc en Salesforce koppelen
Opmerking:
Bekijk onze installatiegids rechtsonder in het tabblad Salesforce in PandaDoc voor een snelle en eenvoudige set-up van de integratie.
In PandaDoc, ga naar 'Instellingen' > 'Integraties' > klik op 'Salesforce ' > en kies waar je de integratie wilt inschakelen: in Sandbox- of Productie-omgeving
Mogelijk dien je bij Salesforce in te loggen. Klikop 'Toestaan' om PandaDoc toegang te geven tot Salesforce
Je PandaDoc-account is nu gekoppeld aan Salesforce. Ga verder met het installeren van het PandaDoc-pakket op AppExchange zoals beschreven in de volgende sectie
Deze integratie maakt het mogelijk om gegevens aan te maken, bij te houden en door te sturen naar PandaDoc-documenten in meerdere werkruimtes. Schakel de integratie eenmalig in en log in op de gewenste werkruimte. In de sectie Gerelateerde Documenten zie je alleen de documenten die binnen de integratie zijn aangemaakt en die zich bevinden in de werkruimte waarop je bent ingelogd. De sync-triggers werken alleen voor de werkruimte die als eerste is gekoppeld.
Installeer het PandaDoc-pakket op AppExchange
Opmerking:
Je moetSalesforce beheerder rechten hebben om de PandaDoc-module te kunnen installeren en configureren.
Log in op je Salesforce-account: https://login.salesforce.com/
Je vindt onze applicatie op de SFDC AppExchange;
Klik op 'Hier downloaden';
Klik op 'Installeren voor alle gebruikers', en klik vervolgens op 'Upgraden/installeren';
Selecteer 'Ja, geef toegang tot deze websites van derden' en klik op 'Doorgaan'.
Het installatieproces wordt gestart en kan even duren. Klik op 'Klaar' als je klaar bent.
Configureer de PandaDoc-module onder het Salesforce-record
Opmerking:
De onderstaande instructies laten de configuratie van Opportunity zien, maar je kunt deze handleiding ook gebruiken voor de andere objecten (Opportunity, Lead, Account, Contact).
Waarschuwing:
Als je Lightning gebruikt, volg dandeze installatiegids.
Als je de PandaDoc-module wilt toevoegen aan een Aangepast object, lees dan hier meer.
Ga naar een record onder 'Opportunity' en klik op 'Layout bewerken'. Ga in de module 'Opportunity Layout' bovenaan naar 'Velden' en zoek naar 'Secties';
Klik en sleep 'Sectie' naar de plek waar je PandaDoc wilt weergeven in de Opportunity Layout. Eenmaal toegevoegd, stel je de sectie-eigenschappen in. Geef deze nieuwe sectie de naam 'PandaDoc Documenten'.Stel de layout in op '1-Column' en selecteer 'OK';
Ga terug naar de module 'Opportunity Layout' hierboven. Ga naar 'Visualforce-pagina's' aan de linkerkant en sleep 'PandaDoc' naar de sectie die je net hebt aangemaakt.
Klik rechts op 'Eigenschappen' en stel de 'Hoogte (in pixels)' in op ten minste 500. Hoe groter het getal, hoe groter de module wordt weergegeven in Salesforce;
Klik in de module 'Opportunity Layout' hierboven op 'Opslaan' en wacht tot de layout klaar is met opslaan;
Ga naar een object onder 'Opportunities' om de module 'PandaDoc Documenten' te bekijken.
Opmerking:
Als je een Aangepast object hebt aangemaakt, raadpleeg dandeze gids om te leren hoe je PandaDoc toevoegt aan Aangepaste objecten in Salesforce.
Configuratiestappen voor PandaDoc.eu-accounts
Om je PandaDoc.eu account te configureren, moet je twee belangrijke wijzigingen aanbrengen:
Werk de instellingen van PandaDoc bij om pandadoc.eu domein te gebruiken:
Ga in Salesforcenaar "Instellingen".
Zoek in de zoekbalk op QuickFind naar "Aangepaste instellingen".
Selecteer "Aangepaste instellingen".
Selecteer "Beheren" naast "PandaDoc Instellingen".
Selecteer "Bewerken" voor PANDADOC_APP_HOST en PANDADOC_DOCSERVICE_HOST
Wijziging domein van
com
ineu
en klik op 'Opslaan'.
Voor PANDADOC_APP_HOST moet je https://app.pandadoc.eu/sdk/ domeinwaarde hebben.
Voor PANDADOC_DOCSERVICE_HOST moet je https://api.pandadoc.eu/public/v1/documents/ domeinwaarde hebben.
api.pandadoc.eu toevoegen aan Remote Site-instellingen.
Ga in Salesforcenaar "Instellingen".
Selecteer "Instellingen externe site".
Selecteer "Bewerken" naast PD_API
Domein wijzigen van
com
naareu
Gegevens van SFDC naar PandaDoc overbrengen
Om gegevens door te sturen van Salesforce naar PandaDoc-document, moet je eerst een template maken en deze instellen met Variabelen (hetzelfde als Velden Samenvoegen). Meer informatie over Variabelen vind je hier.
Opmerking:
Hoewel je je eigen variabelen aan documenten kunt toevoegen, moet je variabelen instellen om informatie van Salesforce door te geven in een template.
Salesforce-velden doorsturen naar PandaDoc (via variabelen)
Voordat je je template instelt met variabelen, maak je een variabelenlijst voor elk object waarmee je PandaDoc gaat gebruiken.
Opmerking:
Variabelen moeten voor elk object afzonderlijk worden ingesteld. Alleen de variabelen die in dat specifieke object staan vermeld, zijn beschikbaar wanneer van dat object een document wordt aangemaakt (geen objectoverschrijdende populatie).
Klik daarvoor op '+' en ga naar PandaDoc Setup. Scrol naar beneden naar 'Salesforce naar PandaDocgegevensstroom' en klik op 'Objecten configureren';
Kies vervolgens een object waarvoor je de variabelenlijst wilt wijzigen. Als je PandaDoc in een ander object hebt geïnstalleerd, klik je op 'Object toevoegen';
Je ziet een standaardlijst met variabelen aan de rechterkant. Om meer velden toe te voegen, vink je de velden aan die je aan de variabelenlijst wilt toevoegen en klik je op 'Opslaan';
Open je PandaDoc template in een apart browservenster, kopieer & plak variabelenamen met de vierkante haakjes in de template.
Waarschuwing:
Een gecodeerd tekstveld kan niet via een variabele worden doorgegeven!
Als je een document aanmaakt vanuit Salesforce met behulp van deze template, worden de variabelen ingevuld met de informatie uit de CRM.
Opmerking:
De opmaak van datumvariabelen hangt af van de standaard datumopmaak die is ingesteld in de instellingen van je werkruimte.
De opmaak van valutavariabelen is gebaseerd op de locale van de weergave van de ontvanger. Aangepaste geldvariabelen worden zonder valutasymbool en opmaak doorgegeven aan het document.
Je kunt ook de lijst met variabelen bekijken, samen met de gegevens die worden doorgegeven in een Salesforce-record.
Open een Salesforce-record, scrol naar beneden naar PandaDoc, klik op het tandwielpictogram in de rechterbovenhoek van de module en kies Variabelen - dit is wat je kunt doorsturen;
Open je PandaDoc template in een apart browservenster, kopieer & plak variabelenamen met de vierkante haakjes in de template.
Opmerking:
De waarde van de variabele die wordt doorgegeven aan PandaDoc kan afwijken van hoe het veld eruitziet in Salesforce, zie de tweede schermafdruk hieronder. Dit komt doordat PandaDoc in sommige gevallen de waarde van het basisveld doorgeeft en niet de weergegeven waarde. Leerhier hoe je datumvelden opmaakt die worden doorgegeven vanuit Salesforce.
Opmerking:
Als het veld in Salesforce leeg is, wordt de variabele in het documentniet ingevuld en moet je het handmatig invullen.
Ontvangers vanuit Salesforce naar PandaDoc doorsturen
Opmerking:
Ontvangersinfo doorsturen werkt het beste met PandaDoc Rollen. Leer hoe je rollen instelt in een templatehier.
Salesforce geeft standaard de volgende ontvangerinformatie door, afhankelijk van het object waar je PandaDoc-module zich bevindt:
vanuit Opportunity: Contact Rol-info
vanuit Account: Contact-info + mogelijkheid om Account-info te pushen
vanuit Lead: Lead-info
vanuit Contacten: Contact-info
Je kunt instellen welk veld uit Salesforce wordt toegewezen aan een rol in PandaDoc en bepalen welke velden worden verzonden in de vorm van de volgende parameters:
Voornaam
Achternaam
E-mail
Bedrijfsveld
Telefoonveld
Rolveld
Ga naar 'PandaDoc ontvangers configureren';
Je ziet standaardtoewijzingen voor standaardobjecten. Je kunt ze wijzigen of nieuwe toewijzingen toevoegen voor aangepaste objecten.
Als je wilt dat PandaDoc de ontvanger automatisch koppelt aan een specifieke rol, dan heb je 2 dingen nodig:
Rolveld dat is geconfigureerd in de toegewezen Ontvangers;
Identieke rolnamen in Salesforce en in PandaDoc template;
Als dit goed is ingesteld, zal PandaDoc de respectievelijke ontvanger in de respectievelijke rol invoegen wanneer je documenten aanmaakt.
Opmerking:
PandaDoc zetalle gerelateerde contactpersonen uit Salesforce in het document. Als je er een wilt verwijderen, verwijder deze dan in het pop-upvenster van de Rol of in het gedeelte Ontvangers in het document.
Als je documenten aanmaakt op basis van een offerte of een case, kun je een zoekveld gebruiken voor een specifiek contactrecord. Je kunt aangeven welke zoekvelden je wilt gebruiken als ontvangers door naar PandaDoc Setup > te gaan en naar beneden te scrollen naar Aangepaste objectinstellingen. Zoek het object waarvoor je dit wilt instellen en klik op Instellingen aan de rechterkant.
Kies vervolgens het veld dat je als ontvanger wilt gebruiken en klik op Opslaan. Je kunt maximaal vijf velden kiezen.
Stel vervolgens de toewijzingen van de ontvangers in. Klaar!
Ontvangers filteren
Je kunt contactpersonen die als ontvanger in PandaDoc-documenten worden gezet, filteren op basis van ja/nee-velden in een record (ook wel Booleaanse velden genoemd).
Ga naar '+' > PandaDoc Ontvangers configureren;
Scrol naar beneden naar 'Ontvangers Filteren';
Klik op 'Filteren inschakelen';
Kies een veld op basis van welke waarde de ontvangers worden gefilterd;
Kies de waarde van het veld op basis waarvan de ontvangers worden gefilterd: waar - ja, niet waar - nee.
Als je Ontvangers toewijzen voor Accounts hebt ingesteld, kun je dit configureren om deze Accountinformatie (e-mail, telefoonnummer, etc) als Ontvanger door te geven aan PandaDoc.
Ga daarvoor naar PandaDoc Setup -> Scrol naar beneden naar JSON Builder Settings, klik naast de Account Objectnaam op 'Setup' -> Vink het vakje aan naast 'Account versturen als ontvanger' en klik op 'Opslaan'.
Opmerking:
Salesforce Contact-rollen en PandaDoc Template-rollen kunnen geen 2 contactpersonen hebben die aan één rol zijn toegewezen.
Als je suggesties hebt met betrekking tot de functionaliteiten van PandaDoc ->, dien dan een idee in op het Ideeënportaal of neem contact met ons op.
Informatie van Salesforce naar PandaDoc doorsturen (via velden)
Je kunt gegevens doorsturen naar PandaDoc-velden op dezelfde manier als variabelen dat doen. In tegenstelling tot variabelen hoef je echter geen vierkante haakjes te gebruiken.
Kopieer in de lijst met tokens het token zonder vierkante haakjes naar het veld Samenvoegen.
Zodra het document is verzonden, zal de ontvanger de vooraf ingevulde gegevens zien en dit veld kunnen bijwerken, op voorwaarde dat het veld aan hem is toegewezen.
Productgegevens van Salesforce naar PandaDoc doorsturen
PandaDoc kan worden geconfigureerd om producten te kiezen uit een Opportunity, Leads, Contacten of Account en ze toe te voegen aan een prijstabel in een document.
Je kunt productvelden van een object toewijzen aan prijstabelvelden in PandaDoc om gegevens nog nauwkeuriger door te sturen.
Ga naar PandaDoc Setup > Prijsitems configureren.
Voeg een object toe waarvan je productgegevens wilt doorsturen en selecteer welke velden je precies wilt toewijzen aan de prijstabel in PandaDoc, klik op 'Opslaan' als je klaar bent.
Hieronder kun je onder 'Prijsitems Sorteren' instellen in welke volgorde je de producten in de prijstabel in PandaDoc wilt hebben.
Zorg ervoor dat je Opportunity, Lead, Contact of Account producten heeft toegevoegd. Open daarna je PandaDoc template, voeg een prijstabel toe. Zet in de prijstabel Eigenschappen de schakelaar Gegevens samenvoegen op AAN.
Aangepaste productvelden aan prijstabel doorgeven
Soms moet je meer dan de standaardset productvelden doorgeven.
Voeg eerst de productvelden van Opportunity toe aan de lijst met tokens/variabelen door naar PandaDoc Setup > Tokens configureren te gaan. Selecteer Opportunity-product en vink de velden die je moet doorgeven aan de rechterkant aan. Ze verschijnen dan in de tokens-lijst aan de linkerkant.
Klik op Opslaan. U bent klaar met de setup!
Zorg ervoor dat voor de prijstabel in de template Automatisch importeren aan staat.
Als je een document aanmaakt vanuit de template, klik dan op het plusteken aan de rechterkant van de prijstabel.
Selecteer de aangepaste productvelden onder Verborgen toevoegen.
Als het toevoegen van aangepaste velden uit verborgen kolommen telkens als je een document aanmaakt te veel klikken vergt, is er een manier om dat te omzeilen.
Maak een document aan en maak aangepaste productvelden zichtbaar.
Klik vervolgens op de verticale ellipsen in de rechterbovenhoek en selecteer Converteren naar template. Je nieuwe template wordt geopend in een nieuw browsertabblad.
In de template kun je de producten uit de prijstabel verwijderen, maar zorg ervoor dat je de aangepaste veldkolommen behoudt.
De volgende keer dat je een document start vanuit Salesforce, gebruik je deze template. De kolommen worden dan ingevuld met aangepaste veldwaarden voor producten.
Documenten maken en verzenden
Nu je je template hebt aangemaakt en ingesteld, kun je doorgaan met het aanmaken en verzenden van documenten vanuit Salesforce.
Ga naar een record, scrol naar beneden naar de PandaDoc-module, klik op Nieuw document.
Kies een template of selecteer de templates die je wilt bundelen, selecteer daarna Items toevoegen en wijs ontvangers toe aan rollen, indien van toepassing;
Klik op Doorgaan en controleer je document: variabelen, inhoud, ontvangerslijst, herinneringen en Verzend je document;
Je kunt nu teruggaan naar het record in Salesforce en de status van je document volgen;
Wanneer een document is ingevuld, wordt de .pdf weergegeven onder Notities&Bijlagen in het record.
Als je meerdere werkruimtes hebt en documenten aanmaakt vanuit Opportunities of Accounts in Salesforce, dan kun je het zo instellen dat documenten uit ALLE werkruimtes worden weergegeven in de PandaDoc-module, zie hier voor meer informatie.
Een document aan een Opportunity in Salesforce koppelen
Als je een document hebt aangemaakt in PandaDoc en je wilt deze koppelen aan een Opportunity in Salesforce, dan doe je dit als volgt.
Open het document in het tabblad PandaDoc en klik op het Salesforce-pictogram aan de rechterkant.
Klik op 'Koppelen' en je wordt gevraagd om in te loggen op je Salesforce-account.
Selecteer een opportunity uit de lijst en klik op 'Koppelen'.
Aan de rechterkant, onder de Opportunity-informatie, kun je de aanmaakdatum, status en het totaalbedrag van de Opportunity bekijken. Let op: het kan zijn dat de Opportunity-informatie die wordt weergegeven in PandaDoc moet worden ververst om er zeker van te zijn dat je de nieuwste update bekijkt.
Ga nu naar het Opportunity-record in Salesforce en het document zal worden weergegeven in de PandaDoc-module alsof het is aangemaakt via Salesforce.
Om een document te ontkoppelen van een Opportunity of te koppelen aan een andere Opportunity, klik je op de gewenste actie in het paneel integraties. Als je het document hebt aangemaakt vanuit een ander object (Account, Contactpersoon, etc.), dan kun je het niet loskoppelen van dat object en koppelen aan een Opportunity of gerelateerde informatie bekijken.
Een document bijwerken met veldwaarden uit Salesforce
Opmerking:
Voor deze functie moet het document zich in de conceptstatus bevinden.
Als de informatie in een Salesforce-record wordt bijgewerkt nadat het document al is aangemaakt op basis van dit record, kun je het document bijwerken met de juiste waarden:
Ga in PandaDoc naar het paneel integraties door links in het PandaDoc-document op het Salesforce-pictogram te klikken
Selecteer onder Documentgegevens 'Importeren uit CRM'.
De variabelen zullen worden bijgewerkt met de laatste informatie uit Salesforce
Je kunt de functie 'Importeren uit CRM' voor elk object in Salesforce gebruiken: Opportunity, Account, Lead, Contact, aangepaste objecten.
Als het veld in Salesforce leeg is, zal de corresponderende variabele niet worden ververst.
Waarschuwing:
Je kunt je prijstabel niet bijwerken met productgegevens uit Salesforce, noch kun je PandaDoc-velden of rolvariabelen bijwerken.
FAQ
Hoe kan ik zien wat mijn integratieversie is?
Open je Salesforce, klik bovenaan op Instellingen, typ 'geïnstalleerde pakketten' in Snel zoeken, klik vervolgens op het gedeelte Geïnstalleerde pakketten die in de zoekopdracht verschijnt. Zoek naar PandaDoc tussen de geïnstalleerde applicaties en zoek de versie op in de kolom Versienummer.
Hoe kan ik het ondersteuningsteam van PandaDoc toegang geven tot mijn account in Salesforce?
Het ondersteuningsteam kan toegang vragen tot je account in Salesforce om je te helpen met een probleem of vraag. Verleen geen toegang zonder het verzoek van ons ondersteuningsteam.
In Salesforce Lightning:
Log in op Salesforce, klik op je afbeelding (of avatar) rechtsboven en klik vervolgens op Instellingen
Typ links in het kleine zoekvak 'verlenen' en klik vervolgens hieronder op Accounttoegang verlenen
In Salesforce Classic:
Log in op Salesforce en klik vervolgens rechtsboven op Mijn instellingen. (Je kunt ook op je naam klikken en vervolgens op Mijn instellingen )
Typ links in het kleine zoekvak 'verlenen' en klik vervolgens hieronder op Accounttoegang verlenen
Stel de 'Toegangsduur' voor 'PandaDoc Support' in op 3 dagen.
Stuur vervolgens een e-mail naar ons ondersteuningsteam met je SalesForce Organisatie-ID die je kunt vinden op de Bedrijfsinformatie- pagina. Klik op Instellingen > Bedrijfsprofiel > Bedrijfsinformatie en zoek de ID naast Salesforce Organization-ID.
Probleemoplossing
Klik op een probleem om de oplossing te bekijken.
PandaDoc-module is leeg of geeft de volgende foutmelding: "Poging om naar een null-object te verwijzen. Er is een onverwachte fout opgetreden.
Dit gebeurt wanneer het object waarvoor je variabelen, een prijstabel of het toewijzen van ontvangers hebt ingesteld, wordt verwijderd of een nieuwe naam heeft.
Je kunt dit verhelpen door de volgende stappen te volgen:
Zorg ervoor dat je de laatste versie van de integratie hebt geïnstalleerd
Ga naar PandaDoc Setup, klik op Tokens configureren en open vervolgens het object dat de foutmelding of een leeg scherm laat zien.
Voeg een willekeurig nieuw veld uit de linkerkolom toe als token/variabele, klik vervolgens op Opslaan.
Als het probleem aanhoudt, ga dan naar Objectaanpassingsinstellingen op de PandaDoc Setup-pagina en klik op Setup naast het object waar de fout wordt weergegeven.
Als een lege pagina opent, verwijder je het object uit de lijst, en voeg je het opnieuw toe.
PandaDoc-module geeft de foutmelding: "Onverwachte token 'FROM' in Opportunity".
Als je dit bericht ziet, heb je mogelijk geen machtigingen voor bepaalde Salesforce-objecten met betrekking tot de Opportunity. Mogelijke voorbeelden zijn dat bestanden niet zijn ingeschakeld voor je profiel, of dat je bedrijf onlangs een nieuw object heeft toegevoegd dat nog niet is ingeschakeld voor je profiel.
Om dit op te lossen, moet je je Salesforce-beheerder vragen om de machtigingen voor je profiel te controleren en ervoor zorgen dat je toegang hebt tot de gerelateerde objecten.
Contactpersonen worden niet als ontvangers doorgegeven wanneer je een document aanmaakt vanuit een opportunity
Je bent misschien net begonnen met het testen van de integratie met test Contactpersonen. Het is mogelijk dat er geen e-mailadressen zijn gekoppeld aan deze contactpersonen in Salesforce. Om dit probleem op te lossen, voeg je geldige e-mailadressen toe aan de contactpersonen in Salesforce en probee je het vervolgens opnieuw.
PandaDoc-module wordt niet geladen in Salesforce voor sommige gebruikers in mijn account/ Sommige gebruikers in mijn account zien de foutmelding Onvoldoende rechten in de PandaDoc-module
Zorg er om te beginnen voor dat Aangepaste instellingen definiëren toegang voor twee PandaDoc-objecten (PandaDoc.PandaDoc.PandaDoc Instellingen en PandaDoc.PandaDoc.PandaDoc JsonBuilder Mapping) is ingeschakeld. Je vindt deze instelling onder Instellingen > Profielen > Selecteer het desbetreffende profiel.
Daarna moet je deze gebruiker volledige toegang geven tot de onderstaande 7 objecten. Je kunt dit doen door naar het betreffende profiel te gaan en op Bewerken te drukken en vervolgens naar beneden te scrollen naar de Aangepaste objectmachtigingen.
Documentenstatus
Object Tokens
PandaDoc-document
PandaDoc-logboek
Toewijzing prijsitem
Toewijzing ontvanger
Triggerinstelling
Controleer vervolgens de toegang tot de velden die gerelateerd zijn aan de 7 objecten die in de vorige stap zijn genoemd. Je kunt dat doen door naar het betreffende profiel te gaan en naar beneden te scrollen naar de optie Veldniveau beveiliging (Custom Field-Level Security), vervolgens voor elk van de 7 objecten te drukken op Bekijken, Bewerken en Alleen-lezen toegang voor alle velden toe te staan.