> Continu verbeteren van processen > Lead to cash > Salesforce Sales Cloud > Datatemplate

Datatemplate voor Lead to Cash

Salesforce Sales Cloud

Attributen voor Lead to Cash (18) Activiteiten in Lead to Cash (16) Extractiegidsen (3)

Datatemplate voor Lead to Cash

Deze template laat zien welke data je nodig hebt om het Lead to Cash-proces te analyseren. Je vindt erin welke attributen je verzamelt, welke activiteiten je volgt en hoe je deze informatie uit je systeem haalt. Zo bereid je de data efficiënt voor op process mining.

Aanbevolen attributen om te verzamelen
Belangrijke activiteiten om te volgen
Instructies voor data-extractie uit Salesforce Sales Cloud

Nieuw met event logs? Lees hoe je een event log voor process mining maakt.

Template downloaden

Attributen voor Lead to Cash

Deze datavelden zijn nodig om een volledig event log op te stellen en het Lead to Cash-proces gedetailleerd te analyseren.

3 Verplicht 5 Aanbevolen 10 Optioneel

	Naam	Beschrijving
	Activiteit ActivityName	De naam van de bedrijfsgebeurtenis of activiteit die op een bepaald moment in het verkoopproces plaatsvond.
Beschrijving De activiteitsnaam beschrijft een specifieke stap of mijlpaal in het Lead to Cash-proces, zoals 'Opportunity aangemaakt', 'Offerte verstuurd' of 'Contract ondertekend'. Deze activiteiten worden afgeleid uit wijzigingen in belangrijke velden of uit het aanmaken van gekoppelde records in Salesforce. Door de volgorde van activiteiten te analyseren, kun je het procesverloop visualiseren, veelvoorkomende routes herkennen en afwijkingen van het standaardverkoopproces opsporen. Dit vormt de basis voor procesmodellen en KPI’s, zoals doorlooptijden tussen stappen. Waarom dit belangrijk is Dit veld bepaalt de stappen op de proceskaart en maakt het mogelijk het verkooptraject van lead tot betaling te visualiseren en analyseren. Waar vind je dit? Meestal afgeleid uit een combinatie van bronnen, waaronder het Opportunity History-object voor veldwijzigingen zoals Stage, aanmaakdatums van gekoppelde objecten zoals Quote en Contract, en specifieke Task- of Event-records. Voorbeelden Opportunity aangemaaktOfferte aan klant gepresenteerdOpportunity gewonnenFactuur aangemaakt
	Starttijd EventTimestamp	De exacte datum en tijd waarop de activiteit plaatsvond.
Beschrijving De timestamp van de gebeurtenis legt het exacte moment vast waarop een activiteit plaatsvond. Je hebt deze timestamp nodig om gebeurtenissen chronologisch te ordenen en tijdsanalyses van het proces uit te voeren. Dit attribuut vormt de basis voor het berekenen van prestatiemetrieken, zoals doorlooptijden, tijdsduur en wachttijden. Het verschil tussen de timestamps van 'Factuur aangemaakt' en 'Betaling ontvangen' levert bijvoorbeeld de data voor de KPI 'Gemiddeld aantal dagen tot betaling'. Nauwkeurige timestamps helpen bottlenecks op te sporen en de procesefficiëntie te meten. Waarom dit belangrijk is Dit attribuut bepaalt de chronologische volgorde van gebeurtenissen en is nodig voor alle berekeningen van tijdsduur en prestaties. Waar vind je dit? Afkomstig uit verschillende datumvelden in Salesforce, zoals 'CreatedDate' van het Opportunity-object, 'LastModifiedDate' uit Opportunity History of specifieke datumvelden van gekoppelde objecten zoals Quote en Contract. Voorbeelden 2023-04-15T10:30:00Z2023-05-20T14:00:00Z2023-06-01T09:15:00Z
	Verkoopkans SalesOpportunity	De unieke identificatiecode van elke verkoopkans. Deze dient als primaire case-ID voor het Lead to Cash-proces.
Beschrijving De verkoopkans is het centrale object waarmee je een mogelijke deal volgt, van kwalificatie tot afsluiting. Elke verkoopkans heeft een unieke ID die alle bijbehorende activiteiten, communicatie, offertes en contracten met elkaar verbindt. Bij process mining heb je deze ID nodig om het volledige verloop van elke deal te reconstrueren. Door de verkoopkans als Case-ID te gebruiken, kun je de hele levenscyclus analyseren, de tijd tussen fases meten, afwijkingen in het proces herkennen en zien welke factoren bijdragen aan gewonnen of verloren deals. Waarom dit belangrijk is Deze unieke identificatiecode verbindt alle processtappen en maakt een volledige, nauwkeurige analyse van de verkoopcyclus per deal mogelijk. Waar vind je dit? Dit is het standaardveld 'Id' van het Opportunity-object in Salesforce Sales Cloud, bijvoorbeeld Opportunity.Id. Voorbeelden 0068c00001KvM7RAAV0068c00001LpA9BAAV0068c00001NqB3CAAV
	Bedrag van opportunity Amount	Het geschatte totale verkoopbedrag van de verkoopkans.
Beschrijving Dit attribuut bevat de geldwaarde van een mogelijke deal. Het is een van de belangrijkste metrieken voor financiële analyses en prestatieanalyses. Het bedrag van de Opportunity wordt in vrijwel alle financiële overzichten gebruikt, bijvoorbeeld om de totale waarde van de pipeline en de gemiddelde dealgrootte te berekenen en om de waarde te vergelijken met factoren zoals kortingen of doorlooptijden. Het is een belangrijk onderdeel van de dashboards 'Prestaties van verkoopmedewerkers' en 'Effect van kortingen op verkoopkansen'. Waarom dit belangrijk is Dit geeft de financiële waarde van elke deal weer en is nodig voor pipeline-rapportages, omzetprognoses en prestatieanalyses. Waar vind je dit? Dit is het standaardveld 'Amount' van het Opportunity-object. Voorbeelden 50000125000.75250000
	Eigenaar van opportunity OpportunityOwner	De verkoopmedewerker die aan de verkoopkans is toegewezen en ervoor verantwoordelijk is.
Beschrijving De eigenaar van de Opportunity is de Salesforce-gebruiker die primair verantwoordelijk is voor het beheren van de deal. Dit is een belangrijke dimensie voor prestatieanalyses. Door data per eigenaar van de Opportunity te analyseren, kunnen organisaties het dashboard 'Prestaties van verkoopmedewerkers' maken. Daarmee kun je doorlooptijden, winpercentages en gemiddelde dealgroottes van teamleden vergelijken en zien wie goed presteert en waar coaching nodig is. Waarom dit belangrijk is Dit attribuut is nodig om de prestaties van het verkoopteam te analyseren, individuele resultaten te vergelijken en te bepalen waar coaching nodig is. Waar vind je dit? Dit is het veld 'OwnerId' van het Opportunity-object, dat naar het User-object verwijst. Voorbeelden Jan JansenMaria GarciaDavid Chen
	Gewonnen IsWon	Een booleaanse waarde die aangeeft of de verkoopkans is gewonnen of verloren.
Beschrijving Dit attribuut geeft met true of false aan wat de uitkomst van een verkoopkans is. De waarde is true als de fase van de verkoopkans 'Closed Won' is en false als deze 'Closed Lost' is. 'Gewonnen' vormt de basis voor de KPI 'Winpercentage van verkoopkansen', een belangrijke maatstaf voor de effectiviteit van het verkoopproces. Je kunt dit attribuut ook gebruiken om analyses op te splitsen, bijvoorbeeld door de procesroutes van gewonnen en verloren deals te vergelijken of de 'Gemiddelde korting op gewonnen deals' te berekenen. Waarom dit belangrijk is Dit meet de uitkomst van een verkoopkans en maakt analyses van gewonnen en verloren deals en de berekening van winpercentages mogelijk. Waar vind je dit? Dit is het standaardveld 'IsWon' van het Opportunity-object. Het is een formuleveld op basis van StageName. Voorbeelden truefalse
	Kortingspercentage DiscountPercentage	Het kortingspercentage dat voor de opportunity geldt.
Beschrijving Dit attribuut registreert de korting op een deal, meestal als percentage van de totale prijs. Het is belangrijk om de winstgevendheid van deals en het verkoopgedrag te begrijpen. Dit is de basis voor het dashboard 'Effectiviteit van opportunitykortingen' en de KPI 'Gemiddelde korting op gewonnen deals'. Door dit attribuut te analyseren, kunnen salesmanagers bepalen of kortingen bijdragen aan gewonnen deals of de marges alleen maar verlagen. Ook kunnen ze kortingsgedrag tussen regio's en verkopers vergelijken. Waarom dit belangrijk is Dit is belangrijk om de winstgevendheid en de effectiviteit van de prijsstrategie te analyseren en buitensporige kortingen op te sporen. Waar vind je dit? Dit is meestal een aangepast valuta- of percentageveld op het Opportunity- of Quote-object. Raadpleeg de documentatie van Salesforce Sales Cloud of de beheerder. Voorbeelden 0.050.100.15
	Verkoopfase StageName	De huidige fase van de verkoopkans in de verkooppipeline, zoals 'Qualification' of 'Negotiation'.
Beschrijving De verkoopfase geeft aan hoe een verkoopkans vordert binnen het vooraf bepaalde verkoopproces. Wijzigingen in dit veld zijn belangrijke procesgebeurtenissen, zoals 'Fase voorstel bereikt'. Dit attribuut vormt de basis voor dashboards zoals 'Bottlenecks in de verkooppipeline opsporen' en 'Dagelijks operationeel overzicht van de salesfunnel'. Je kunt ermee analyseren hoelang verkoopkansen in elke fase blijven, hoe vaak ze naar een volgende fase gaan en hoe de verkooppipeline er als geheel voor staat. Waarom dit belangrijk is Dit volgt de voortgang van een verkoopkans door de salesfunnel en helpt bottlenecks te analyseren en de pipeline te beheren. Waar vind je dit? Dit is het standaardveld 'StageName' van het Opportunity-object. Voorbeelden Potentiële klanten benaderenKwalificatieBehoefteanalyseVoorstel/prijsofferteOnderhandeling/beoordeling
	Accountnaam AccountName	De naam van de klantaccount of het bedrijf dat bij de opportunity hoort.
Beschrijving Account Name koppelt de verkoopkans aan een specifieke klant. Zo kun je het verkoopproces vanuit het perspectief van de klant analyseren. Door het proces per klant te bekijken, krijg je zicht op verkoopcycli bij strategische accounts. Je kunt klanten met veel herstelwerk of lange onderhandelingsfasen herkennen en de aanpak daarop afstemmen. Dit attribuut is ook handig om procesdata te filteren en verder te onderzoeken. Waarom dit belangrijk is Koppelt het verkoopproces aan een specifieke klant, zodat je doorlooptijden en interactiepatronen per klant kunt analyseren. Waar vind je dit? Dit is afgeleid van het opzoekveld 'AccountId' op het Opportunity-object. Dat verwijst naar het veld 'Name' op het Account-object. Voorbeelden Global Tech Inc.Innovate Solutions LLCQuantum Industries
	Bronsysteem SourceSystem	Geeft aan uit welk bronsysteem de data is gehaald.
Beschrijving Dit attribuut geeft aan in welk registratiesysteem de gebeurtenisdata is ontstaan. Voor het Lead to Cash-proces is dat meestal 'Salesforce Sales Cloud'. In omgevingen met meerdere gekoppelde systemen is dit veld belangrijk om de herkomst van data te volgen, problemen op te lossen en te bepalen welk systeem leidend is voor verschillende processtappen. Zo blijft duidelijk waar de data vandaan komt en kun je erop vertrouwen. Waarom dit belangrijk is Dit geeft context over de herkomst van de data en is belangrijk voor datagovernance, validatie en omgevingen met meerdere systemen. Waar vind je dit? Dit is meestal een vaste waarde die tijdens het extraheren en transformeren van de data wordt toegevoegd om de herkomst van de dataset aan te geven. Voorbeelden Salesforce Sales CloudSFSC
	Contract-ID ContractId	De unieke identificatiecode van het contract dat bij de opportunity hoort.
Beschrijving Contract ID koppelt de opportunity aan een formeel contractrecord in Salesforce. Dit is een belangrijke stap in de laatste fase van het sluiten van een deal. Met dit attribuut kun je de contractfase gedetailleerd analyseren. Het ondersteunt de dashboards 'Doorlooptijd van offerte tot contract' en 'Contractnaleving'. Je kunt activiteiten zoals 'Contract Sent for Signature' en 'Contract Activated' volgen en meten hoe lang ze duren en of ze binnen de SLA's vallen. Waarom dit belangrijk is Hiermee kun je het deelproces voor contractbeheer nauwkeurig volgen, inclusief doorlooptijden en compliance. Waar vind je dit? Deze ID komt uit het veld 'Id' van het Contract-object, dat meestal aan de Opportunity of Account is gekoppeld. Voorbeelden 8008c000001LxD9AAK8008c000001MyE4AAK8008c000001NzF0AAK
	Is herstelwerk IsRework	Een berekende aanduiding die aangeeft of een activiteit herstelwerk of een herhaalde stap is.
Beschrijving Is Rework is een booleaanse aanduiding die op true wordt gezet wanneer een proces teruggaat naar een eerdere fase. Als de activiteit 'Quote Modified' bijvoorbeeld plaatsvindt na 'Quote Presented to Customer', telt dit als herstelwerk. Met dit attribuut kun je inefficiënties in het proces meten. Het ondersteunt rechtstreeks de berekening van de KPI's 'Foutpercentage orderverwerking' en 'Frequentie van herstelwerk aan offertes'. Door herstelwerk zichtbaar te maken, kun je onduidelijke vereisten, communicatieproblemen en kwaliteitsproblemen opsporen. Waarom dit belangrijk is Maakt inefficiënties meetbaar door activiteiten in herstelwerklussen te herkennen en te markeren. Zo kun je verbeteringen richten op de juiste plekken. Waar vind je dit? De process mining-tool berekent deze aanduiding door de volgorde van activiteiten te analyseren en teruggaande stappen in het proces te herkennen. Voorbeelden truefalse
	Laatste data-update LastDataUpdate	De timestamp die aangeeft wanneer de data voor het laatst uit het bronsysteem is vernieuwd.
Beschrijving Dit attribuut toont de datum en tijd van de meest recente data-extractie uit Salesforce Sales Cloud. Zo zie je hoe actueel de data is die je analyseert. Als je weet wanneer de data voor het laatst is bijgewerkt, kun je de analyse goed interpreteren. Dat is vooral belangrijk voor operationele dashboards zoals 'Dagelijks operationeel overzicht van de salesfunnel'. Zo houd je bij beslissingen rekening met de actualiteit van de data. Waarom dit belangrijk is Dit laat zien hoe actueel de data is en hoe recent de procesanalyse is. Waar vind je dit? Dit is een metadataveld dat de datapijplijn of ETL-tool aanmaakt tijdens het extraheren van de data. Voorbeelden 2023-10-27T02:00:00Z2023-10-28T02:00:00Z
	Leadbron LeadSource	De bron waar de lead vandaan komt, bijvoorbeeld 'Web', 'Partner' of 'Beurs'.
Beschrijving Lead Source houdt bij via welk marketingkanaal of welke verkoopactiviteit de lead is binnengekomen. Deze informatie helpt je te bepalen hoe effectief verschillende strategieën voor klantwerving zijn. Dit attribuut is de belangrijkste dimensie voor het dashboard 'Analyse van leadconversie'. Door conversiepercentages en dealwaarden per leadbron te analyseren, kunnen bedrijven hun marketingbudget beter verdelen en zich richten op de kanalen die het meeste opleveren. Waarom dit belangrijk is Zo zie je hoe effectief marketingkanalen zijn door leads te koppelen aan hun herkomst en de resultaten die ze opleveren. Waar vind je dit? Dit is het standaardveld 'LeadSource' op het Lead-object. Bij conversie wordt dit veld meestal overgezet naar het Opportunity-object. Voorbeelden WebTelefonische aanvraagAanbeveling door partnerGekochte lijst
	Offerte-ID QuoteId	De unieke identificatiecode van een verkoopofferte die aan de opportunity is gekoppeld.
Beschrijving Quote ID identificeert een specifieke prijsopgave voor een klant bij een opportunity. Tijdens de levenscyclus van een opportunity kunnen meerdere offertes worden uitgebracht. Door Quote ID's bij te houden, kun je het offertegedeelte van het verkoopproces analyseren. Je kunt de 'Doorlooptijd van offerte tot contract' meten, zien hoe vaak een offerte wordt aangepast ('Quote Modified') en met de KPI 'Frequentie van herstelwerk aan offertes' verschillende offerteversies van elkaar onderscheiden. Waarom dit belangrijk is Met dit attribuut kun je de offertecyclus analyseren, waaronder het aantal revisies en de tijd tussen offerte en acceptatie. Waar vind je dit? Deze ID komt uit het veld 'Id' van het Quote-object, dat aan de Opportunity is gekoppeld. Voorbeelden 0Q08c000001OxP1AAK0Q08c000001PyQ2AAK0Q08c000001QzR3AAK
	Order-ID OrderId	De unieke identificatiecode van de verkooporder die is aangemaakt voor een gewonnen opportunity.
Beschrijving Order ID koppelt een verkoopkans aan het daaropvolgende orderafhandelingsproces. Hier wordt het werk overgedragen van sales naar de bedrijfsvoering. Met deze ID kun je de procesanalyse uitbreiden tot na de fase 'Opportunity Closed Won' en de orderverwerking meenemen. Je kunt de activiteiten 'Order Created' en 'Order Fulfilled' volgen en de 'Order Fulfillment Error Rate' bewaken. Waarom dit belangrijk is Koppelt het verkoopgedeelte van het proces aan de orderafhandeling, zodat je het volledige Lead to Cash-proces kunt analyseren. Waar vind je dit? Deze ID komt uit het veld 'Id' van het Order-object, dat vaak aan de Opportunity is gekoppeld. Voorbeelden 8018c000001IyA6AAK8018c000001JyB1AAK8018c000001KzC6AAK
	Regio Region	De geografische regio of het verkoopgebied van de opportunity.
Beschrijving Met het attribuut Region worden opportunities ingedeeld op basis van hun geografische locatie, bijvoorbeeld 'Noord-Amerika', 'EMEA' of 'APAC'. Verkooporganisaties gebruiken regio's vaak om teams en rapportages in te delen. Dit is de belangrijkste dimensie voor het dashboard 'Vergelijking van verkoopresultaten per regio'. Zo kunnen leidinggevenden de procesprestaties per regio vergelijken, zien welke aanpak werkt in goed presterende regio's en bepalen waar verbetering nodig is. Je kunt onder meer doorlooptijden, winpercentages en kortingsgebruik analyseren. Waarom dit belangrijk is Hiermee kun je verkoopprocessen en resultaten in verschillende geografische gebieden vergelijken en regionale sterke en zwakke punten herkennen. Waar vind je dit? Dit is vaak een aangepast veld op het Opportunity- of Account-object. Raadpleeg de documentatie van Salesforce Sales Cloud of de beheerder. Voorbeelden Noord-AmerikaEMEAAPACLATAM
	Type opportunity Type	Geeft aan om wat voor opportunity het gaat, bijvoorbeeld 'Nieuw bedrijf' of 'Bestaande klant'.
Beschrijving Opportunity Type is een standaardveld om deals in te delen. Zo kun je onderscheid maken tussen verkoopprocessen voor het werven van nieuwe klanten en het uitbreiden van bestaande klantrelaties. Met process mining kun je dit attribuut gebruiken om processen met elkaar te vergelijken. Je kunt bijvoorbeeld de proceskaart filteren om te zien of de verkoopcyclus voor 'Nieuw bedrijf' langer is of meer stappen bevat dan die voor verlengingen bij 'Bestaande klant'. Dat helpt bij strategische keuzes en procesverbetering. Waarom dit belangrijk is Door opportunities op type in te delen, kun je verkoopprocessen, doorlooptijden en slagingspercentages voor nieuwe en bestaande klanten vergelijken. Waar vind je dit? Dit is het standaardveld 'Type' op het Opportunity-object. Voorbeelden Nieuw bedrijfBestaande klant - upgradeBestaande klant - verlengingAanvullende verkoop

Verplicht Aanbevolen Optioneel

Activiteiten in Lead to Cash

Dit zijn de belangrijkste processtappen en mijlpalen om te volgen. Zo kun je het proces nauwkeurig ontdekken en de prestaties analyseren.

8 Aanbevolen 8 Optioneel

	Activiteit	Beschrijving
	Betaling ontvangen	Deze activiteit bevestigt dat de betaling van de klant is ontvangen en aan de factuur is toegewezen. Meestal leid je dit af uit een statuswijziging van de factuur naar 'Paid' of uit het aanmaken van een Payment-record.
Waarom dit belangrijk is Dit is de laatste activiteit in het Lead to Cash-proces en markeert het moment waarop de omzet is ontvangen. De tijd tussen facturatie en betaling is een belangrijke KPI voor de cashflow. Waar vind je dit? Je leidt dit af uit een wijziging van de status van het Invoice-object in 'Paid' of uit het aanmaken van een Payment-object dat aan de factuur is gekoppeld. Deze data komt vaak uit een extern financieel systeem. Vastleggen Bepaal wanneer 'Status' van de Invoice-record de waarde 'Paid' krijgt of wanneer een gekoppelde Payment-record wordt aangemaakt. Gebeurtenistype inferred
	Contract geactiveerd	Deze activiteit geeft aan dat alle partijen het contract hebben ondertekend en dat het juridisch van kracht is. Meestal wordt dit vastgelegd als een statuswijziging van het Contract-object naar 'Activated'.
Waarom dit belangrijk is Dit bevestigt dat de klant en organisatie een juridisch bindende overeenkomst hebben gesloten. Het is een belangrijke mijlpaal voor omzetverantwoording en compliance. Vertraging kan de financiële prognoses direct beïnvloeden. Waar vind je dit? Je leidt dit af uit een wijziging van het veld Status van het Contract-object in 'Activated'. De timestamp van deze wijziging haal je uit de veldgeschiedenis. Vastleggen Bepaal de timestamp waarop het veld 'Status' van het Contract-object de waarde 'Activated' krijgt. Gebeurtenistype inferred
	Lead omgezet naar opportunity	Deze activiteit markeert het moment waarop een gekwalificeerde lead wordt omgezet in een verkoopkans, met een bijbehorende account en contactpersoon. Meestal voert een verkoopmedewerker deze actie zelf uit in Salesforce.
Waarom dit belangrijk is Dit is de overdracht van marketing of leadontwikkeling naar het verkoopteam. Door de tijd en conversie vanaf dit moment te analyseren, kun je de kwaliteit van leads en de efficiëntie van het eerste deel van het verkoopproces beoordelen. Waar vind je dit? Je herkent deze gebeurtenis aan het veld IsConverted van het Lead-object, dat de waarde true heeft, en aan een ingevuld veld ConvertedOpportunityId. De timestamp staat in ConvertedDate. Vastleggen Wordt vastgelegd wanneer een gebruiker een Lead-record omzet en de velden ConvertedDate en ConvertedOpportunityId invult. Gebeurtenistype explicit
	Offerte aangemaakt	Deze activiteit staat voor het opstellen van een formeel prijsvoorstel voor de klant. Je legt dit vast wanneer een nieuwe Quote-record wordt aangemaakt en aan de Opportunity wordt gekoppeld.
Waarom dit belangrijk is Een offerte opstellen is een belangrijke stap richting het sluiten van een deal. Door het aantal offertes en de tijd die nodig is om ze op te stellen te analyseren, kun je de efficiëntie van het verkoopteam en de voortgang van deals beoordelen. Waar vind je dit? Je haalt deze informatie uit het systeemveld CreatedDate van het Quote-object. Dit object heeft een opzoekrelatie met de bovenliggende Opportunity. Vastleggen Gebruik CreatedDate van het Quote-object dat bij de Opportunity hoort. Gebeurtenistype explicit
	Offerte door klant geaccepteerd	Deze activiteit markeert het moment waarop de klant akkoord gaat met de voorwaarden en prijs van een offerte. Meestal legt een gebruiker dit vast door de status van de Quote-record te wijzigen in 'Accepted'.
Waarom dit belangrijk is Dit is een duidelijk koopsignaal en een belangrijke mijlpaal voordat het contract wordt opgesteld. De tijd tussen het presenteren en accepteren van de offerte laat zien hoeveel vertraging er in de verkoopcyclus zit. Waar vind je dit? Je leidt dit af uit een wijziging van het veld Status van het Quote-object in 'Accepted'. De timestamp haal je uit de geschiedenis van deze veldwijziging. Vastleggen Bepaal de timestamp waarop het veld 'Status' van de Quote-record verandert in 'Accepted'. Gebeurtenistype inferred
	Opportunity aangemaakt	Dit is het aanmaken van een nieuwe verkoopkans in Salesforce, die mogelijk omzet oplevert. De gebeurtenis wordt expliciet vastgelegd met een aanmaaktimestamp wanneer de record voor het eerst wordt opgeslagen.
Waarom dit belangrijk is Deze activiteit is het officiële begin van de verkoopcyclus voor een verkoopkans. Dit is het startpunt voor het meten van de totale doorlooptijd van de verkoopcyclus en de snelheid waarmee verkoopkansen door de pipeline gaan. Waar vind je dit? Je haalt deze informatie uit het systeemveld CreatedDate van het Opportunity-object. Dit geeft de exacte timestamp waarop de verkoopkans is aangemaakt. Vastleggen Gebruik het veld CreatedDate van het Opportunity-object. Gebeurtenistype explicit
	Opportunity gewonnen	Dit markeert het succesvol sluiten van een deal: de verkoopkans is gewonnen. Dit wordt handmatig of automatisch vastgelegd door het veld StageName van de Opportunity te wijzigen in 'Closed Won'.
Waarom dit belangrijk is Dit is een belangrijke uitkomst van het verkoopproces. Door kenmerken en trends van gewonnen deals te analyseren, krijg je zicht op de verkoopprestaties en -strategie. Waar vind je dit? Je leidt dit af uit een wijziging van het veld StageName van het Opportunity-object in 'Closed Won'. De datum van deze gebeurtenis staat in het veld CloseDate en de timestamp in de veldgeschiedenis. Vastleggen Bepaal in OpportunityFieldHistory de timestamp waarop 'StageName' van de Opportunity de waarde 'Closed Won' krijgt. Gebeurtenistype inferred
	Opportunity verloren	Dit markeert het mislukken van een verkoopdeal: de verkoopkans gaat naar een concurrent of de klant besluit niet te kopen. Je legt dit vast wanneer StageName van de Opportunity wordt gewijzigd in 'Closed Lost'.
Waarom dit belangrijk is Dit is de belangrijkste negatieve uitkomst. Door te analyseren wanneer en waarom deals verloren gaan, kun je de verkoopstrategie, training en positionering van producten verbeteren. Waar vind je dit? Je leidt dit af uit een wijziging van het veld StageName van het Opportunity-object in 'Closed Lost'. De datum staat in het veld CloseDate en de timestamp in de veldgeschiedenis. Vastleggen Bepaal in OpportunityFieldHistory de timestamp waarop 'StageName' van de Opportunity de waarde 'Closed Lost' krijgt. Gebeurtenistype inferred
	Contract ter ondertekening verstuurd	Dit geeft aan dat een formeel contract is opgesteld en naar de klant is gestuurd om te ondertekenen. Meestal leid je dit af uit een statuswijziging van het Contract-object, bijvoorbeeld naar 'Sent' of 'Out for Signature'.
Waarom dit belangrijk is Met deze activiteit begint de laatste juridische en administratieve fase van het sluiten van een deal. Door dit moment bij te houden, kun je de efficiëntie van het contractbeheer volgen. Waar vind je dit? Je leidt dit af uit een statuswijziging van het Contract-object, dat aan de Opportunity is gekoppeld. Hiervoor moet de veldgeschiedenis van het veld Status van Contract worden bijgehouden. Vastleggen Bepaal de timestamp waarop het veld 'Status' van het Contract-object verandert in bijvoorbeeld 'Sent for Signature'. Gebeurtenistype inferred
	Factuur aangemaakt	Dit is het aanmaken van een factuur voor de geleverde goederen of diensten. Je kunt dit vastleggen wanneer een Invoice-record wordt aangemaakt, in Salesforce Billing of in een gekoppeld extern systeem.
Waarom dit belangrijk is Met deze activiteit begint het financiële deel van de Lead to Cash-cyclus. De snelheid en nauwkeurigheid van facturatie hebben direct invloed op de cashflow. Waar vind je dit? Hiervoor is Salesforce Billing of een vergelijkbaar pakket nodig. Je haalt de gegevens uit het veld CreatedDate van het Invoice-object, dat aan de Order of Account is gekoppeld. Vastleggen Gebruik CreatedDate van het Invoice-object, als dit beschikbaar is. Gebeurtenistype explicit
	Fase van opportunity gewijzigd	Deze activiteit legt elke wijziging in de verkoopfase van een verkoopkans vast, bijvoorbeeld de overgang van 'Qualification' naar 'Needs Analysis'. De wijzigingen staan in de veldgeschiedenis van het systeem, zodat je de voortgang van de verkoopkans kunt volgen.
Waarom dit belangrijk is Door fasewijzigingen bij te houden, krijg je zicht op de snelheid van de verkooppipeline, deals die blijven hangen en de naleving van het proces. Waar vind je dit? Je leidt deze gebeurtenis af uit het OpportunityFieldHistory-object, dat wijzigingen in het veld StageName van het Opportunity-object bijhoudt. Elke regel bevat een timestamp en de oude en nieuwe waarde. Vastleggen Haal wijzigingsgebeurtenissen voor het veld 'StageName' op uit de tabel OpportunityFieldHistory. Gebeurtenistype inferred
	Fase voorstel bereikt	Dit markeert het moment waarop een verkoopkans de fase 'Proposal/Price Quote' bereikt. Je leidt dit af uit de geschiedenis van het veld 'StageName' van de Opportunity.
Waarom dit belangrijk is Dit is een belangrijke mijlpaal: er is een mogelijke oplossing gevonden die klaar is om te worden geprijsd en gepresenteerd. Dit moment is nuttig om te analyseren hoeveel tijd het uitwerken van een oplossing en het opstellen van een offerte kosten. Waar vind je dit? Je leidt dit af uit het OpportunityFieldHistory-object. Zoek naar de timestamp waarop het veld 'StageName' is gewijzigd in 'Proposal/Price Quote' of een vergelijkbare aangepaste fase. Vastleggen Filter OpportunityFieldHistory op records waarbij 'Field' gelijk is aan 'StageName' en 'NewValue' de fase voor voorstellen is. Gebeurtenistype inferred
	Offerte aan klant gepresenteerd	Deze gebeurtenis geeft aan dat een offerte ter beoordeling naar de klant is gestuurd of formeel aan de klant is gepresenteerd. Meestal leid je dit af uit een statuswijziging van de Quote-record, bijvoorbeeld van 'Draft' naar 'Presented' of 'In Review'.
Waarom dit belangrijk is Vanaf deze activiteit begint de onderhandeling met de klant en de goedkeuringscyclus. Door dit moment bij te houden, kun je de reactietijd van klanten meten en vertragingen bij het accepteren van offertes opsporen. Waar vind je dit? Je leidt dit af uit wijzigingen in het veld Status van het Quote-object. Houd de geschiedenis van dit veld bij om de exacte timestamp van de wijziging te bepalen. Vastleggen Bepaal de timestamp waarop het veld 'Status' van de Quote-record verandert in 'Presented', 'Sent' of een vergelijkbare waarde. Gebeurtenistype inferred
	Offerte gewijzigd	Dit is een wijziging of herziening van een bestaande offerte, vaak na feedback of onderhandelingen met de klant. Je legt dit vast door wijzigingen in belangrijke velden van de Quote-record bij te houden nadat deze voor het eerst is aangemaakt.
Waarom dit belangrijk is Veel wijzigingen in offertes kunnen wijzen op inefficiënties, misverstanden of langdurige onderhandelingen. Analyse van dit herstelwerk helpt de periode van offerte tot contract te verkorten. Waar vind je dit? Je leidt dit af uit het veld LastModifiedDate van het Quote-object of, met meer detail, uit de veldgeschiedenis van velden zoals TotalPrice of de offerteproducten. Vastleggen Vergelijk LastModifiedDate met CreatedDate van het Quote-object of gebruik de veldgeschiedenis van Quote. Gebeurtenistype inferred
	Order aangemaakt	Deze activiteit markeert het aanmaken van een verkooporder en daarmee de start van de orderafhandeling nadat een deal is gewonnen. Je legt dit vast wanneer een nieuwe Order-record wordt aangemaakt en aan de Opportunity of Account wordt gekoppeld.
Waarom dit belangrijk is Dit is de officiële overdracht van het verkoopproces naar het team dat de order afhandelt en de bedrijfsvoering verzorgt. Een efficiënte overdracht is belangrijk voor tijdige levering en klanttevredenheid. Waar vind je dit? Je haalt deze informatie uit het systeemveld CreatedDate van het Order-object. De Order is meestal gekoppeld aan de Account en/of de oorspronkelijke Opportunity. Vastleggen Gebruik CreatedDate van het Order-object dat hoort bij de Account van de Opportunity. Gebeurtenistype explicit
	Order afgehandeld	Dit geeft aan dat de producten of diensten van een order aan de klant zijn geleverd. Meestal leid je dit af uit een statuswijziging van het Order-object naar een eindstatus zoals 'Fulfilled' of 'Completed'.
Waarom dit belangrijk is Deze mijlpaal markeert dat de toezegging aan de klant is nagekomen. De tijd tussen het aanmaken en afhandelen van een order is een belangrijke metriek voor de efficiëntie van de bedrijfsvoering en de klanttevredenheid. Waar vind je dit? Je leidt dit af uit een wijziging van het veld Status van het Order-object naar een afgeronde status. Om de timestamp van de gebeurtenis vast te leggen, moet de veldgeschiedenis worden bijgehouden. Vastleggen Bepaal de timestamp waarop 'Status' van de Order-record verandert in 'Fulfilled' of 'Completed'. Gebeurtenistype inferred

Aanbevolen Optioneel

Extractiegidsen

Zo haal je data uit Salesforce Sales Cloud

Stappen

Controleer de vereisten voor Field History Tracking: Controleer voordat je begint bij je Salesforce-beheerder of Field History Tracking is ingeschakeld voor de belangrijkste velden van deze objecten: Opportunity (StageName, Bedrag), Offerte (Status), Contract (Status) en Order (Status). Dit is essentieel om proceswijzigingen goed vast te leggen.
Ga naar Salesforce Reports: Log in bij je Salesforce-omgeving. Open via de App Launcher het tabblad 'Reports'. Klik op 'New Report' om te beginnen.
Maak het Opportunity History-rapport: Dit rapport legt het aanmaken van Opportunities, wijzigingen van de fase en afsluitmomenten vast. Selecteer het rapporttype 'Opportunities with Field History'. Voeg de volgende kolommen toe: Opportunity-ID, Opportunity-naam, aanmaakdatum, veld/gebeurtenis, oude waarde, nieuwe waarde, bewerkingsdatum en bewerkt door. Voeg ook de aanbevolen attributen toe: eigenaar, Bedrag, Is Won en eventuele kortingsvelden.
Maak het Lead Conversion-rapport: Maak een tweede rapport met het rapporttype 'Leads'. Voeg de kolommen Lead-ID, conversiedatum, geconverteerde Opportunity-ID en Lead-eigenaar toe. Stel een filter in zodat alleen leads met 'Converted' op true worden getoond.
Maak het Quote Events-rapport: Maak een derde rapport met het rapporttype 'Quotes', bij voorkeur een type met geschiedenis, zoals 'Quotes with Field History', als dat beschikbaar is. Voeg de kolommen Quote-ID, Opportunity-ID, CreatedDate, LastModifiedDate en Status toe. Dit rapport gebruik je om het aanmaken van offertes en statuswijzigingen af te leiden.
Maak aanvullende rapporten voor Contracten, Orders en Facturen: Volg dezelfde aanpak als voor het Offerte-rapport en maak aparte rapporten voor Contracten, Orders en Facturen als deze objecten in je Salesforce-omgeving worden gebruikt. Neem voor elk rapport de record-ID, de bijbehorende Opportunity-ID, CreatedDate, LastModifiedDate en het Status-veld van het object op.
Voer alle rapporten uit en exporteer ze: Stel voor elk rapport hetzelfde datumbereikfilter in, bijvoorbeeld 'Opportunity Created Date' in de afgelopen 6 maanden. Voer de rapporten uit en gebruik de functie 'Export' om de resultaten als CSV-bestand op te slaan.
Voeg de data samen in een spreadsheet: Open een spreadsheetprogramma zoals Microsoft Excel. Kopieer de data uit elk geëxporteerd CSV-bestand naar een apart werkblad in één werkmap.
Maak het definitieve Event Log-werkblad: Maak een nieuw werkblad met de naam 'Event Log'. Gebruik de verplichte kolomkoppen SalesOpportunity, ActivityName en EventTimestamp, plus de aanbevolen koppen OpportunityOwner, StageName, Bedrag, IsWon en DiscountPercentage.
Bewerk en combineer de data: Vul het werkblad 'Event Log' handmatig met data uit de bronwerkbladen. Maak voor elke bronrij een bijbehorende rij in het event log. Maak bijvoorbeeld voor een rij in het werkblad Opportunity History met 'New Value' als 'Closed Won' een rij in het event log met ActivityName op 'Opportunity Closed Won' en EventTimestamp op de 'Edit Date'. Herhaal dit voor alle 16 verplichte activiteiten in de bronbestanden.
Maak de opmaak af en exporteer het bestand: Zorg voor een vaste opmaak van de kolom EventTimestamp, bijvoorbeeld YYYY-MM-DD HH:MI:SS. Vul voor elke rij de kolom SalesOpportunity in met de Opportunity-ID uit de bronrapporten. Sla het definitieve, gecombineerde werkblad 'Event Log' op als CSV-bestand om het te uploaden.

Configuratie

Rapporttypen: Het belangrijkste benodigde rapporttype is 'Opportunities with Field History'. Daarnaast zijn rapporten nodig voor Leads, Quotes, Contracts, Orders en Invoices. Rapporttypen met geschiedenis voor deze objecten verbeteren de nauwkeurigheid van de data aanzienlijk.
Field History Tracking: Dit moet vooraf door een Salesforce-beheerder worden ingesteld. Het is nodig om wijzigingen in de Opportunity-fase en de status van offertes, Contracten en Orders vast te leggen.
Rechten: De gebruiker die de rapporten uitvoert, moet leesrechten hebben voor alle relevante objecten: Lead, Account, Opportunity, OpportunityFieldHistory, Quote, Contract, Order en eventueel Invoice en Payment.
Filter voor datumbereik: Stel voor alle rapporten hetzelfde datumbereikfilter in, zodat de data goed op elkaar aansluit. Een filter op 'Opportunity Created Date' voor de afgelopen 3 tot 6 maanden is aan te raden om de hoeveelheid data beheersbaar te houden.
Datavolume: Bij organisaties met veel Opportunities en activiteiten kan Report Builder traag worden of tegen exportlimieten aanlopen, meestal rond de 100.000 rijen, afhankelijk van de editie. In dat geval is de wekelijkse Data Export Service een beter alternatief om de ruwe data op te halen.

a Voorbeeldquery sql

/*
Salesforce Report Builder is a graphical user interface, so a direct script is not applicable.
The following describes the configuration and transformation logic required to build the final event log file from the various exported reports.
*/

-- **FINAL EVENT LOG STRUCTURE (Target CSV File)**
-- `SalesOpportunity` (TEXT): The Salesforce Opportunity ID (18-digit).
-- `ActivityName` (TEXT): The name of the business event.
-- `EventTimestamp` (DATETIME): The timestamp of the event.
-- `OpportunityOwner` (TEXT): The name of the opportunity owner.
-- `StageName` (TEXT): The stage of the opportunity at the time of the event.
-- `Amount` (NUMERIC): The opportunity amount.
-- `IsWon` (BOOLEAN): True if the opportunity is in a 'Closed Won' stage.
-- `DiscountPercentage` (NUMERIC): The discount percentage, if applicable.

-- **DATA TRANSFORMATION LOGIC (To be applied in a spreadsheet or script)**

-- **From Lead Conversion Report**
-- Activity: 'Lead Converted to Opportunity'
-- `SalesOpportunity` <-- `Converted Opportunity ID`
-- `ActivityName` <-- 'Lead Converted to Opportunity'
-- `EventTimestamp` <-- `Converted Date`

-- **From Opportunity History Report**
-- Activity: 'Opportunity Created'
-- `SalesOpportunity` <-- `Opportunity ID`
-- `ActivityName` <-- 'Opportunity Created'
-- `EventTimestamp` <-- `Created Date`

-- Activity: 'Opportunity Stage Changed'
-- `SalesOpportunity` <-- `Opportunity ID`
-- `ActivityName` <-- 'Opportunity Stage Changed'
-- `EventTimestamp` <-- `Edit Date`
-- Filter: WHERE `Field/Event` = 'Stage'

-- Activity: 'Proposal Stage Reached'
-- `SalesOpportunity` <-- `Opportunity ID`
-- `ActivityName` <-- 'Proposal Stage Reached'
-- `EventTimestamp` <-- `Edit Date`
-- Filter: WHERE `Field/Event` = 'Stage' AND `New Value` = 'Proposal/Price Quote'

-- Activity: 'Opportunity Closed Won'
-- `SalesOpportunity` <-- `Opportunity ID`
-- `ActivityName` <-- 'Opportunity Closed Won'
-- `EventTimestamp` <-- `Edit Date`
-- Filter: WHERE `Field/Event` = 'Stage' AND `New Value` = 'Closed Won'

-- Activity: 'Opportunity Closed Lost'
-- `SalesOpportunity` <-- `Opportunity ID`
-- `ActivityName` <-- 'Opportunity Closed Lost'
-- `EventTimestamp` <-- `Edit Date`
-- Filter: WHERE `Field/Event` = 'Stage' AND `New Value` = 'Closed Lost'

-- **From Quote Report (Requires Quote History Tracking for status changes)**
-- Activity: 'Quote Created'
-- `SalesOpportunity` <-- `Opportunity ID`
-- `ActivityName` <-- 'Quote Created'
-- `EventTimestamp` <-- `CreatedDate`

-- Activity: 'Quote Presented to Customer'
-- `SalesOpportunity` <-- `Opportunity ID`
-- `ActivityName` <-- 'Quote Presented to Customer'
-- `EventTimestamp` <-- [History Edit Date for Status Change to 'Presented']

-- Activity: 'Quote Modified'
-- `SalesOpportunity` <-- `Opportunity ID`
-- `ActivityName` <-- 'Quote Modified'
-- `EventTimestamp` <-- `LastModifiedDate` (Note: This is an approximation)
-- Filter: WHERE `LastModifiedDate` > `CreatedDate`

-- Activity: 'Quote Accepted by Customer'
-- `SalesOpportunity` <-- `Opportunity ID`
-- `ActivityName` <-- 'Quote Accepted by Customer'
-- `EventTimestamp` <-- [History Edit Date for Status Change to 'Accepted']

-- **From Contract Report (Requires Contract History Tracking for status changes)**
-- Activity: 'Contract Sent for Signature'
-- `SalesOpportunity` <-- `Opportunity ID`
-- `ActivityName` <-- 'Contract Sent for Signature'
-- `EventTimestamp` <-- [History Edit Date for Status Change to 'Sent']

-- Activity: 'Contract Activated'
-- `SalesOpportunity` <-- `Opportunity ID`
-- `ActivityName` <-- 'Contract Activated'
-- `EventTimestamp` <-- [History Edit Date for Status Change to 'Activated']

-- **From Order Report (Requires Order History Tracking for status changes)**
-- Activity: 'Order Created'
-- `SalesOpportunity` <-- `Opportunity ID`
-- `ActivityName` <-- 'Order Created'
-- `EventTimestamp` <-- `CreatedDate`

-- Activity: 'Order Fulfilled'
-- `SalesOpportunity` <-- `Opportunity ID`
-- `ActivityName` <-- 'Order Fulfilled'
-- `EventTimestamp` <-- [History Edit Date for Status Change to 'Fulfilled']

-- **From Invoice/Payment Report (If available in Salesforce)**
-- Activity: 'Invoice Generated'
-- `SalesOpportunity` <-- `Opportunity ID`
-- `ActivityName` <-- 'Invoice Generated'
-- `EventTimestamp` <-- [Invoice CreatedDate]

-- Activity: 'Payment Received'
-- `SalesOpportunity` <-- `Opportunity ID`
-- `ActivityName` <-- 'Payment Received'
-- `EventTimestamp` <-- [Payment Date or Invoice Paid Date]

Stappen

Vereisten: Zorg dat je een Salesforce-gebruikersaccount hebt met API-toegang en voldoende rechten om de objecten Opportunity, Lead, Offerte, Contract, Order en Factuur en de bijbehorende Field History-objecten te lezen. Field History Tracking moet zijn ingeschakeld voor de belangrijkste velden van deze objecten, zoals StageName en Status.
Kies een uitvoeringstool: Deze query gebruikt UNION ALL-clausules, die niet worden ondersteund in de native Developer Console of Workbench van Salesforce. Gebruik een externe tool die verbinding kan maken met Salesforce en query’s in SQL-stijl kan uitvoeren, zoals een Business Intelligence-tool (BI) (Tableau, Power BI), een ETL-tool (MuleSoft, Informatica) of een datatool met een Salesforce-connector (DBeaver, DataGrip).
Maak verbinding met Salesforce: Stel in de gekozen tool de verbinding met je Salesforce-omgeving in. Meestal heb je hiervoor je gebruikersnaam, wachtwoord en beveiligingstoken nodig. Kies de Salesforce (API)-connector.
Bereid de query voor: Kopieer de volledige SOQL-query uit het gedeelte query van dit document naar de query-editor van de tool.
Vul de tijdelijke aanduidingen in: Vervang de tijdelijke aanduidingen in de query door waarden uit je Salesforce-organisatie. Het gaat om:
- 'YYYY-MM-DDThh:mm:ssZ': Vervang alle vermeldingen door de gewenste begin- en einddatum van de extractieperiode, in ISO 8601-notatie.
- [Your_Discount_Field__c]: Vervang dit door de API-naam van het aangepaste veld voor het kortingspercentage op het Opportunity-object.
- [Quote_Presented_Status]: Vervang dit door de statuswaarde die wordt gebruikt wanneer een offerte aan een klant is voorgelegd, bijvoorbeeld 'Presented' of 'In Review'.
- [Opportunity_Lookup_On_Contract__c]: Vervang dit door de API-naam van het lookup-veld op het Contract-object dat naar Opportunity verwijst.
- [Order_Fulfilled_Status]: Vervang dit door de statuswaarde die aangeeft dat een Order is afgehandeld, bijvoorbeeld 'Fulfilled', 'Shipped' of 'Completed'.
- [Opportunity_Lookup_On_Invoice__c]: Vervang dit door de API-naam van het lookup-veld op het Invoice-object dat naar Opportunity verwijst.
Voer de query uit: Voer de volledige query uit. Afhankelijk van de hoeveelheid data en de gebruikte tool kan dit enkele minuten duren.
Controleer de resultaten: Controleer na afloop of de dataset rijen bevat voor alle verschillende activiteiten en of de kolommen de verwachte waarden bevatten.
Los eventuele fouten op: Controleer bij een mislukte query of de namen van de ingevulde tijdelijke aanduidingen correct zijn. Controleer ook of de gebruiker via veldbeveiliging toegang heeft tot alle opgevraagde velden. Bij een te groot datumbereik kan de query een time-out krijgen of tegen limieten aanlopen. Probeer dan een kortere periode, bijvoorbeeld één kwartaal.
Exporteer de data: Exporteer de uiteindelijke resultaten als CSV-bestand.
Maak het bestand klaar om te uploaden: Controleer of de CSV-koppen overeenkomen met de verplichte attributen: SalesOpportunity, ActivityName, EventTimestamp, OpportunityOwner, StageName, Bedrag, IsWon en DiscountPercentage. Het bestand is nu klaar om naar een process mining-tool te uploaden.

Configuratie

Field History Tracking: Voor deze extractie moet Field History Tracking zijn ingeschakeld voor de objecten Opportunity (StageName), Quote (Status), Contract (Status) en Bestelling (Status). Zonder deze instelling worden wijzigingen in statussen en fasen niet vastgelegd.
Gebruikersrechten: De gebruiker die de query uitvoert, moet API-toegang en leesrechten hebben voor alle objecten in de query: Lead, Opportunity, OpportunityFieldHistory, Quote, QuoteHistory, Contract, ContractHistory, Bestelling, OrderHistory, Factuur en InvoiceHistory.
Datumbereik: Stel een specifiek datumbereik in met de tijdelijke aanduidingen 'YYYY-MM-DDThh:mm:ssZ'. Voor een eerste analyse is een periode van 3 tot 6 maanden aan te raden. Zo houd je de hoeveelheid data en de prestaties in balans. Gebruik bij zeer grote Salesforce-omgevingen eerst een kleiner bereik, bijvoorbeeld één maand, om de prestaties en eventuele limieten te testen.
Aangepaste velden en statussen: De query bevat tijdelijke aanduidingen voor aangepaste velden (bijvoorbeeld [Your_Discount_Field__c]) en aangepaste statuswaarden (bijvoorbeeld [Quote_Presented_Status]). Zoek de juiste API-namen en waarden op in je Salesforce-configuratie en pas de query daarop aan.
Beschikbaarheid van objecten: De query gaat uit van de standaardobjecten Contract en Bestelling, en van een object Factuur (vaak gebruikt met Salesforce Billing). Gebruikt je organisatie deze objecten niet, of een ander pakket voor facturering, dan leveren die delen van de query een fout of geen data op. Verwijder ze dan of pas ze aan.

a Voorbeeldquery sql

SELECT
    ConvertedOpportunityId AS SalesOpportunity,
    'Lead Converted to Opportunity' AS ActivityName,
    ConvertedDate AS EventTimestamp,
    ConvertedOpportunity.Owner.Name AS OpportunityOwner,
    ConvertedOpportunity.StageName AS StageName,
    ConvertedOpportunity.Amount AS Amount,
    ConvertedOpportunity.IsWon AS IsWon,
    ConvertedOpportunity.[Your_Discount_Field__c] AS DiscountPercentage
FROM Lead
WHERE IsConverted = TRUE AND ConvertedDate >= YYYY-MM-DDThh:mm:ssZ AND ConvertedDate <= YYYY-MM-DDThh:mm:ssZ AND ConvertedOpportunityId != NULL

UNION ALL

SELECT
    Id AS SalesOpportunity,
    'Opportunity Created' AS ActivityName,
    CreatedDate AS EventTimestamp,
    Owner.Name AS OpportunityOwner,
    StageName AS StageName,
    Amount AS Amount,
    IsWon AS IsWon,
    [Your_Discount_Field__c] AS DiscountPercentage
FROM Opportunity
WHERE CreatedDate >= YYYY-MM-DDThh:mm:ssZ AND CreatedDate <= YYYY-MM-DDThh:mm:ssZ

UNION ALL

SELECT
    OpportunityId AS SalesOpportunity,
    'Opportunity Stage Changed' AS ActivityName,
    CreatedDate AS EventTimestamp,
    Opportunity.Owner.Name AS OpportunityOwner,
    NewValue AS StageName,
    Opportunity.Amount AS Amount,
    Opportunity.IsWon AS IsWon,
    Opportunity.[Your_Discount_Field__c] AS DiscountPercentage
FROM OpportunityFieldHistory
WHERE Field = 'StageName' AND CreatedDate >= YYYY-MM-DDThh:mm:ssZ AND CreatedDate <= YYYY-MM-DDThh:mm:ssZ

UNION ALL

SELECT
    OpportunityId AS SalesOpportunity,
    'Proposal Stage Reached' AS ActivityName,
    CreatedDate AS EventTimestamp,
    Opportunity.Owner.Name AS OpportunityOwner,
    NewValue AS StageName,
    Opportunity.Amount AS Amount,
    Opportunity.IsWon AS IsWon,
    Opportunity.[Your_Discount_Field__c] AS DiscountPercentage
FROM OpportunityFieldHistory
WHERE Field = 'StageName' AND NewValue = 'Proposal/Price Quote' AND CreatedDate >= YYYY-MM-DDThh:mm:ssZ AND CreatedDate <= YYYY-MM-DDThh:mm:ssZ

UNION ALL

SELECT
    OpportunityId AS SalesOpportunity,
    'Quote Created' AS ActivityName,
    CreatedDate AS EventTimestamp,
    Opportunity.Owner.Name AS OpportunityOwner,
    Opportunity.StageName AS StageName,
    Opportunity.Amount AS Amount,
    Opportunity.IsWon AS IsWon,
    Opportunity.[Your_Discount_Field__c] AS DiscountPercentage
FROM Quote
WHERE CreatedDate >= YYYY-MM-DDThh:mm:ssZ AND CreatedDate <= YYYY-MM-DDThh:mm:ssZ AND OpportunityId != NULL

UNION ALL

SELECT
    Quote.OpportunityId AS SalesOpportunity,
    'Quote Presented to Customer' AS ActivityName,
    CreatedDate AS EventTimestamp,
    Quote.Opportunity.Owner.Name AS OpportunityOwner,
    Quote.Opportunity.StageName AS StageName,
    Quote.Opportunity.Amount AS Amount,
    Quote.Opportunity.IsWon AS IsWon,
    Quote.Opportunity.[Your_Discount_Field__c] AS DiscountPercentage
FROM QuoteHistory
WHERE Field = 'Status' AND NewValue = '[Quote_Presented_Status]' AND CreatedDate >= YYYY-MM-DDThh:mm:ssZ AND CreatedDate <= YYYY-MM-DDThh:mm:ssZ AND Quote.OpportunityId != NULL

UNION ALL

SELECT
    Quote.OpportunityId AS SalesOpportunity,
    'Quote Modified' AS ActivityName,
    CreatedDate AS EventTimestamp,
    Quote.Opportunity.Owner.Name AS OpportunityOwner,
    Quote.Opportunity.StageName AS StageName,
    Quote.Opportunity.Amount AS Amount,
    Quote.Opportunity.IsWon AS IsWon,
    Quote.Opportunity.[Your_Discount_Field__c] AS DiscountPercentage
FROM QuoteHistory
WHERE CreatedDate > Quote.CreatedDate AND CreatedDate >= YYYY-MM-DDThh:mm:ssZ AND CreatedDate <= YYYY-MM-DDThh:mm:ssZ AND Quote.OpportunityId != NULL

UNION ALL

SELECT
    Quote.OpportunityId AS SalesOpportunity,
    'Quote Accepted by Customer' AS ActivityName,
    CreatedDate AS EventTimestamp,
    Quote.Opportunity.Owner.Name AS OpportunityOwner,
    Quote.Opportunity.StageName AS StageName,
    Quote.Opportunity.Amount AS Amount,
    Quote.Opportunity.IsWon AS IsWon,
    Quote.Opportunity.[Your_Discount_Field__c] AS DiscountPercentage
FROM QuoteHistory
WHERE Field = 'Status' AND NewValue = 'Accepted' AND CreatedDate >= YYYY-MM-DDThh:mm:ssZ AND CreatedDate <= YYYY-MM-DDThh:mm:ssZ AND Quote.OpportunityId != NULL

UNION ALL

SELECT
    Contract.[Opportunity_Lookup_On_Contract__c] AS SalesOpportunity,
    'Contract Sent for Signature' AS ActivityName,
    CreatedDate AS EventTimestamp,
    Contract.Opportunity__r.Owner.Name AS OpportunityOwner,
    Contract.Opportunity__r.StageName AS StageName,
    Contract.Opportunity__r.Amount AS Amount,
    Contract.Opportunity__r.IsWon AS IsWon,
    Contract.Opportunity__r.[Your_Discount_Field__c] AS DiscountPercentage
FROM ContractHistory
WHERE Field = 'Status' AND NewValue = 'Sent for Signature' AND CreatedDate >= YYYY-MM-DDThh:mm:ssZ AND CreatedDate <= YYYY-MM-DDThh:mm:ssZ AND Contract.[Opportunity_Lookup_On_Contract__c] != NULL

UNION ALL

SELECT
    Contract.[Opportunity_Lookup_On_Contract__c] AS SalesOpportunity,
    'Contract Activated' AS ActivityName,
    CreatedDate AS EventTimestamp,
    Contract.Opportunity__r.Owner.Name AS OpportunityOwner,
    Contract.Opportunity__r.StageName AS StageName,
    Contract.Opportunity__r.Amount AS Amount,
    Contract.Opportunity__r.IsWon AS IsWon,
    Contract.Opportunity__r.[Your_Discount_Field__c] AS DiscountPercentage
FROM ContractHistory
WHERE Field = 'Status' AND NewValue = 'Activated' AND CreatedDate >= YYYY-MM-DDThh:mm:ssZ AND CreatedDate <= YYYY-MM-DDThh:mm:ssZ AND Contract.[Opportunity_Lookup_On_Contract__c] != NULL

UNION ALL

SELECT
    OpportunityId AS SalesOpportunity,
    'Opportunity Closed Won' AS ActivityName,
    CreatedDate AS EventTimestamp,
    Opportunity.Owner.Name AS OpportunityOwner,
    NewValue AS StageName,
    Opportunity.Amount AS Amount,
    Opportunity.IsWon AS IsWon,
    Opportunity.[Your_Discount_Field__c] AS DiscountPercentage
FROM OpportunityFieldHistory
WHERE Field = 'StageName' AND NewValue = 'Closed Won' AND CreatedDate >= YYYY-MM-DDThh:mm:ssZ AND CreatedDate <= YYYY-MM-DDThh:mm:ssZ

UNION ALL

SELECT
    OpportunityId AS SalesOpportunity,
    'Order Created' AS ActivityName,
    CreatedDate AS EventTimestamp,
    Opportunity.Owner.Name AS OpportunityOwner,
    Opportunity.StageName AS StageName,
    Opportunity.Amount AS Amount,
    Opportunity.IsWon AS IsWon,
    Opportunity.[Your_Discount_Field__c] AS DiscountPercentage
FROM Order
WHERE CreatedDate >= YYYY-MM-DDThh:mm:ssZ AND CreatedDate <= YYYY-MM-DDThh:mm:ssZ AND OpportunityId != NULL

UNION ALL

SELECT
    Order.OpportunityId AS SalesOpportunity,
    'Order Fulfilled' AS ActivityName,
    CreatedDate AS EventTimestamp,
    Order.Opportunity.Owner.Name AS OpportunityOwner,
    Order.Opportunity.StageName AS StageName,
    Order.Opportunity.Amount AS Amount,
    Order.Opportunity.IsWon AS IsWon,
    Order.Opportunity.[Your_Discount_Field__c] AS DiscountPercentage
FROM OrderHistory
WHERE Field = 'Status' AND NewValue = '[Order_Fulfilled_Status]' AND CreatedDate >= YYYY-MM-DDThh:mm:ssZ AND CreatedDate <= YYYY-MM-DDThh:mm:ssZ AND Order.OpportunityId != NULL

UNION ALL

SELECT
    [Opportunity_Lookup_On_Invoice__c] AS SalesOpportunity,
    'Invoice Generated' AS ActivityName,
    CreatedDate AS EventTimestamp,
    Opportunity__r.Owner.Name AS OpportunityOwner,
    Opportunity__r.StageName AS StageName,
    Opportunity__r.Amount AS Amount,
    Opportunity__r.IsWon AS IsWon,
    Opportunity__r.[Your_Discount_Field__c] AS DiscountPercentage
FROM Invoice
WHERE CreatedDate >= YYYY-MM-DDThh:mm:ssZ AND CreatedDate <= YYYY-MM-DDThh:mm:ssZ AND [Opportunity_Lookup_On_Invoice__c] != NULL

UNION ALL

SELECT
    Invoice.[Opportunity_Lookup_On_Invoice__c] AS SalesOpportunity,
    'Payment Received' AS ActivityName,
    CreatedDate AS EventTimestamp,
    Invoice.Opportunity__r.Owner.Name AS OpportunityOwner,
    Invoice.Opportunity__r.StageName AS StageName,
    Invoice.Opportunity__r.Amount AS Amount,
    Invoice.Opportunity__r.IsWon AS IsWon,
    Invoice.Opportunity__r.[Your_Discount_Field__c] AS DiscountPercentage
FROM InvoiceHistory
WHERE Field = 'Status' AND NewValue = 'Paid' AND CreatedDate >= YYYY-MM-DDThh:mm:ssZ AND CreatedDate <= YYYY-MM-DDThh:mm:ssZ AND Invoice.[Opportunity_Lookup_On_Invoice__c] != NULL

UNION ALL

SELECT
    OpportunityId AS SalesOpportunity,
    'Opportunity Closed Lost' AS ActivityName,
    CreatedDate AS EventTimestamp,
    Opportunity.Owner.Name AS OpportunityOwner,
    NewValue AS StageName,
    Opportunity.Amount AS Amount,
    Opportunity.IsWon AS IsWon,
    Opportunity.[Your_Discount_Field__c] AS DiscountPercentage
FROM OpportunityFieldHistory
WHERE Field = 'StageName' AND NewValue = 'Closed Lost' AND CreatedDate >= YYYY-MM-DDThh:mm:ssZ AND CreatedDate <= YYYY-MM-DDThh:mm:ssZ

Stappen

Bereid je omgeving voor: Zorg dat Python 3.6 of hoger op je systeem is geïnstalleerd. Je hebt ook pip, het installatieprogramma voor Python-pakketten, nodig om de vereiste bibliotheken te installeren.
Installeer de vereiste bibliotheken: Open de opdrachtregel of terminal en installeer de bibliotheken simple-salesforce en pandas met de opdracht: pip install simple-salesforce pandas.
Stel API-toegang tot Salesforce in: Log in op je Salesforce-account met een beheerdersprofiel. Ga naar Setup, vervolgens naar Apps en daarna naar App Manager. Maak een nieuwe 'Connected App'. Schakel OAuth-instellingen in en geef de app het bereik 'Access and manage your data (api)'. Na het opslaan krijg je een 'Consumer Key' en 'Consumer Secret'. Zorg ook dat de gebruikersaccount voor het script een Security Token heeft. Je kunt dit token genereren of opnieuw instellen via je persoonlijke instellingen onder 'Reset My Security Token'.
Stel het Python-script in: Kopieer het volledige Python-script uit het gedeelte Query naar een bestand met de naam extract_lead_to_cash.py.
Vul je inloggegevens in: Open het scriptbestand en vervang de tijdelijke waarden voor username, password, security_token en instance_url door je Salesforce-inloggegevens. Zet in een productieomgeving geen inloggegevens rechtstreeks in de code. Gebruik bijvoorbeeld omgevingsvariabelen of een configuratiebestand.
Stel de extractieperiode in: Pas de variabelen start_date en end_date in het script aan om de periode te bepalen waaruit je data wilt ophalen. Gebruik de notatie 'YYYY-MM-DD'.
Bekijk hoe het script werkt: Het script maakt verbinding met de Salesforce API en voert een reeks queries uit met Salesforce Object Query Language (SOQL). Elke query richt zich op een specifiek object, zoals Opportunity, OpportunityFieldHistory of Quote, om een bepaalde bedrijfsactiviteit vast te leggen.
Verzamel de data: De resultaten van elke query worden omgezet naar een gestructureerd formaat: een pandas DataFrame. De afzonderlijke DataFrames, elk voor één activiteit, worden vervolgens samengevoegd in één lijst.
Zet de data om en maak deze op: Het script voegt alle DataFrames samen tot één event log. Het hernoemt de kolommen volgens het vereiste schema voor process mining (SalesOpportunity, ActivityName, EventTimestamp enzovoort) en zorgt dat de datatypen kloppen.
Voer het script uit: Start het script vanuit de terminal met de opdracht python extract_lead_to_cash.py. Het script maakt verbinding met Salesforce, voert de queries uit en verwerkt de data.
Haal het event log op: Na een geslaagde uitvoering maakt het script in dezelfde map het bestand sfdc_lead_to_cash_event_log.csv aan. Dit CSV-bestand is het definitieve event log, klaar om naar een process mining-tool te uploaden.

Configuratie

Vereisten: Een Salesforce-account met Enterprise-, Unlimited- of Developer Edition, die API-toegang bieden. Een Salesforce-gebruikersprofiel met de machtiging 'API Enabled' en leesrechten voor de volgende objecten: Lead, Opportunity, OpportunityFieldHistory, Quote, Contract en Order. Voor aangepaste objecten voor facturen of betalingen zijn ook leesrechten nodig.
Authenticatie: Het script gebruikt een gebruikersnaam, wachtwoord en beveiligingstoken voor de authenticatie. Overweeg voor extra beveiliging in een productieomgeving OAuth 2.0 JWT Bearer Flow te gebruiken. Dit wordt ook ondersteund door simple-salesforce.
Datumbereik: Met de variabelen start_date en end_date in het script stel je de extractieperiode in. Voor een eerste analyse is een periode van 3 tot 6 maanden aan te raden. Zo krijg je voldoende data zonder dat de hoeveelheid te groot wordt. De datumfilters worden toegepast op het primaire timestamp-veld van elke activiteit, zoals CreatedDate of ConvertedDate.
API-gebruik: Het script voert meerdere afzonderlijke queries uit. Elke query en het ophalen van alle resultaten kosten API-aanroepen. Die tellen mee voor de dagelijkse limiet van je organisatie. Houd rekening met die limiet, vooral als er veel andere integraties actief zijn. Pas het script aan om de Salesforce Bulk API te gebruiken als je miljoenen records wilt ophalen.
Aanpassingen: Het script gaat waar mogelijk uit van standaardnamen voor objecten en velden. Je organisatie kan aangepaste velden hebben, zoals Discount_Percentage__c, aangepaste objecten, zoals Invoice__c en Payment__c, of aangepaste relaties, zoals een verwijzing van Contract naar Opportunity. Pas de SOQL-queries in het script aan je Salesforce-configuratie aan.

a Voorbeeldquery python

import pandas as pd
from simple_salesforce import Salesforce
from datetime import datetime

class=class="hl-string">"hl-comment"># --- Configuration Settings ---
class=class="hl-string">"hl-comment"># Replace with your Salesforce credentials and instance URL
SF_USERNAME = class="hl-string">'[your_salesforce_username]'
SF_PASSWORD = class="hl-string">'[your_salesforce_password]'
SF_SECURITY_TOKEN = class="hl-string">'[your_salesforce_security_token]'
SF_INSTANCE_URL = class="hl-string">'[your_salesforce_instance_url]'

class=class="hl-string">"hl-comment"># Define the date range for the extraction
start_date = class="hl-string">'2023-01-01'
end_date = class="hl-string">'2023-12-31'

class=class="hl-string">"hl-comment"># --- Main Script ---
def main():
    class=class="hl-string">"hl-comment"># Establish connection to Salesforce
    try:
        sf = Salesforce(username=SF_USERNAME, password=SF_PASSWORD, security_token=SF_SECURITY_TOKEN, instance_url=SF_INSTANCE_URL)
        print(fclass="hl-string">"Successfully connected to Salesforce instance: {sf.sf_instance}")
    except Exception as e:
        print(fclass="hl-string">"Salesforce connection failed: {e}")
        return

    class=class="hl-string">"hl-comment"># List to hold DataFrames for each activity
    event_log_parts = []

    class=class="hl-string">"hl-comment"># Define common fields to query for Opportunity context
    common_opp_fields = class="hl-string">"Opportunity.Id, Opportunity.Owner.Name, Opportunity.StageName, Opportunity.Amount, Opportunity.IsWon, Opportunity.Discount_Percentage__c"

    class=class="hl-string">"hl-comment"># 1. Lead Converted to Opportunity
    print(class="hl-string">"Extracting: Lead Converted to Opportunity")
    query = fclass="hl-string">"SELECT ConvertedOpportunityId, ConvertedDate, (SELECT Name FROM Owner) FROM Lead WHERE IsConverted = TRUE AND ConvertedDate >= {start_date}T00:00:00Z AND ConvertedDate <= {end_date}T23:59:59Z"
    df = pd.DataFrame(sf.query_all(query)[class="hl-string">'records'])
    if not df.empty:
        df[class="hl-string">'ActivityName'] = class="hl-string">'Lead Converted to Opportunity'
        df[class="hl-string">'EventTimestamp'] = pd.to_datetime(df[class="hl-string">'ConvertedDate']).dt.tz_localize(None)
        df[class="hl-string">'SalesOpportunity'] = df[class="hl-string">'ConvertedOpportunityId']
        df[class="hl-string">'OpportunityOwner'] = df[class="hl-string">'Owner'].apply(lambda x: x[class="hl-string">'Name'] if x else None)
        df = df[[class="hl-string">'SalesOpportunity', class="hl-string">'ActivityName', class="hl-string">'EventTimestamp', class="hl-string">'OpportunityOwner']]
        event_log_parts.append(df)

    class=class="hl-string">"hl-comment"># 2. Opportunity Created
    print(class="hl-string">"Extracting: Opportunity Created")
    query = fclass="hl-string">"SELECT Id, CreatedDate, Owner.Name, StageName, Amount, IsWon, Discount_Percentage__c FROM Opportunity WHERE CreatedDate >= {start_date}T00:00:00Z AND CreatedDate <= {end_date}T23:59:59Z"
    df = pd.DataFrame(sf.query_all(query)[class="hl-string">'records'])
    if not df.empty:
        df[class="hl-string">'ActivityName'] = class="hl-string">'Opportunity Created'
        df[class="hl-string">'EventTimestamp'] = pd.to_datetime(df[class="hl-string">'CreatedDate']).dt.tz_localize(None)
        df = df.rename(columns={class="hl-string">'Id': class="hl-string">'SalesOpportunity', class="hl-string">'Name': class="hl-string">'OpportunityOwner', class="hl-string">'Discount_Percentage__c': class="hl-string">'DiscountPercentage'})
        df[class="hl-string">'OpportunityOwner'] = df.apply(lambda row: row[class="hl-string">'Owner'][class="hl-string">'Name'] if row[class="hl-string">'Owner'] else None, axis=1)
        event_log_parts.append(df[[class="hl-string">'SalesOpportunity', class="hl-string">'ActivityName', class="hl-string">'EventTimestamp', class="hl-string">'OpportunityOwner', class="hl-string">'StageName', class="hl-string">'Amount', class="hl-string">'IsWon', class="hl-string">'DiscountPercentage']])

    class=class="hl-string">"hl-comment"># 3, 4, 11, 16. Opportunity Stage Changes (includes Proposal, Closed Won, Closed Lost)
    print(class="hl-string">"Extracting: Opportunity Stage Changes")
    query = fclass="hl-string">"SELECT OpportunityId, CreatedDate, NewValue, OldValue, {common_opp_fields} FROM OpportunityFieldHistory WHERE Field = 'StageName' AND CreatedDate >= {start_date}T00:00:00Z AND CreatedDate <= {end_date}T23:59:59Z"
    df = pd.DataFrame(sf.query_all(query)[class="hl-string">'records'])
    if not df.empty:
        df_opp = pd.json_normalize(df[class="hl-string">'Opportunity']).add_prefix(class="hl-string">'Opportunity.')
        df = pd.concat([df.drop(class="hl-string">'Opportunity', axis=1), df_opp], axis=1)
        df[class="hl-string">'ActivityName'] = class="hl-string">'Opportunity Stage Changed'
        class=class="hl-string">"hl-comment"># Specific stage milestones
        df.loc[df[class="hl-string">'NewValue'] == class="hl-string">'Proposal/Price Quote', class="hl-string">'ActivityName'] = class="hl-string">'Proposal Stage Reached'
        df.loc[df[class="hl-string">'NewValue'] == class="hl-string">'Closed Won', class="hl-string">'ActivityName'] = class="hl-string">'Opportunity Closed Won'
        df.loc[df[class="hl-string">'NewValue'] == class="hl-string">'Closed Lost', class="hl-string">'ActivityName'] = class="hl-string">'Opportunity Closed Lost'
        df[class="hl-string">'EventTimestamp'] = pd.to_datetime(df[class="hl-string">'CreatedDate']).dt.tz_localize(None)
        df = df.rename(columns={class="hl-string">'OpportunityId': class="hl-string">'SalesOpportunity', class="hl-string">'Opportunity.Owner.Name': class="hl-string">'OpportunityOwner', class="hl-string">'Opportunity.StageName': class="hl-string">'StageName', class="hl-string">'Opportunity.Amount': class="hl-string">'Amount', class="hl-string">'Opportunity.IsWon': class="hl-string">'IsWon', class="hl-string">'Opportunity.Discount_Percentage__c': class="hl-string">'DiscountPercentage'})
        event_log_parts.append(df[[class="hl-string">'SalesOpportunity', class="hl-string">'ActivityName', class="hl-string">'EventTimestamp', class="hl-string">'OpportunityOwner', class="hl-string">'StageName', class="hl-string">'Amount', class="hl-string">'IsWon', class="hl-string">'DiscountPercentage']])

    class=class="hl-string">"hl-comment"># 5. Quote Created
    print(class="hl-string">"Extracting: Quote Created")
    query = fclass="hl-string">"SELECT CreatedDate, OpportunityId, {common_opp_fields} FROM Quote WHERE CreatedDate >= {start_date}T00:00:00Z AND CreatedDate <= {end_date}T23:59:59Z"
    df = pd.DataFrame(sf.query_all(query)[class="hl-string">'records'])
    if not df.empty:
        df_opp = pd.json_normalize(df[class="hl-string">'Opportunity']).add_prefix(class="hl-string">'Opportunity.')
        df = pd.concat([df.drop(class="hl-string">'Opportunity', axis=1), df_opp], axis=1)
        df[class="hl-string">'ActivityName'] = class="hl-string">'Quote Created'
        df[class="hl-string">'EventTimestamp'] = pd.to_datetime(df[class="hl-string">'CreatedDate']).dt.tz_localize(None)
        df = df.rename(columns={class="hl-string">'OpportunityId': class="hl-string">'SalesOpportunity', class="hl-string">'Opportunity.Owner.Name': class="hl-string">'OpportunityOwner', class="hl-string">'Opportunity.StageName': class="hl-string">'StageName', class="hl-string">'Opportunity.Amount': class="hl-string">'Amount', class="hl-string">'Opportunity.IsWon': class="hl-string">'IsWon', class="hl-string">'Opportunity.Discount_Percentage__c': class="hl-string">'DiscountPercentage'})
        event_log_parts.append(df[[class="hl-string">'SalesOpportunity', class="hl-string">'ActivityName', class="hl-string">'EventTimestamp', class="hl-string">'OpportunityOwner', class="hl-string">'StageName', class="hl-string">'Amount', class="hl-string">'IsWon', class="hl-string">'DiscountPercentage']])

    class=class="hl-string">"hl-comment"># 6, 7, 8. Quote Status Changes (Presented, Modified, Accepted)
    print(class="hl-string">"Extracting: Quote Status Changes")
    query = fclass="hl-string">"SELECT LastModifiedDate, CreatedDate, Status, OpportunityId, {common_opp_fields} FROM Quote WHERE LastModifiedDate >= {start_date}T00:00:00Z AND LastModifiedDate <= {end_date}T23:59:59Z"
    df = pd.DataFrame(sf.query_all(query)[class="hl-string">'records'])
    if not df.empty:
        df_opp = pd.json_normalize(df[class="hl-string">'Opportunity']).add_prefix(class="hl-string">'Opportunity.')
        df = pd.concat([df.drop(class="hl-string">'Opportunity', axis=1), df_opp], axis=1)
        df[class="hl-string">'EventTimestamp'] = pd.to_datetime(df[class="hl-string">'LastModifiedDate']).dt.tz_localize(None)
        df[class="hl-string">'CreatedTimestamp'] = pd.to_datetime(df[class="hl-string">'CreatedDate']).dt.tz_localize(None)
        df = df.rename(columns={class="hl-string">'OpportunityId': class="hl-string">'SalesOpportunity', class="hl-string">'Opportunity.Owner.Name': class="hl-string">'OpportunityOwner', class="hl-string">'Opportunity.StageName': class="hl-string">'StageName', class="hl-string">'Opportunity.Amount': class="hl-string">'Amount', class="hl-string">'Opportunity.IsWon': class="hl-string">'IsWon', class="hl-string">'Opportunity.Discount_Percentage__c': class="hl-string">'DiscountPercentage'})
        class=class="hl-string">"hl-comment"># Presented
        df_presented = df[df[class="hl-string">'Status'] == class="hl-string">'Presented'].copy()
        if not df_presented.empty: df_presented[class="hl-string">'ActivityName'] = class="hl-string">'Quote Presented to Customer'; event_log_parts.append(df_presented)
        class=class="hl-string">"hl-comment"># Accepted
        df_accepted = df[df[class="hl-string">'Status'] == class="hl-string">'Accepted'].copy()
        if not df_accepted.empty: df_accepted[class="hl-string">'ActivityName'] = class="hl-string">'Quote Accepted by Customer'; event_log_parts.append(df_accepted)
        class=class="hl-string">"hl-comment"># Modified (any change after creation)
        df_modified = df[df[class="hl-string">'EventTimestamp'] > df[class="hl-string">'CreatedTimestamp']].copy()
        if not df_modified.empty: df_modified[class="hl-string">'ActivityName'] = class="hl-string">'Quote Modified'; event_log_parts.append(df_modified)

    class=class="hl-string">"hl-comment"># 9, 10. Contract Status Changes (Sent, Activated)
    print(class="hl-string">"Extracting: Contract Events")
    query = fclass="hl-string">"SELECT LastModifiedDate, ActivatedDate, Status, Opportunity__c, (SELECT Id, Owner.Name, StageName, Amount, IsWon, Discount_Percentage__c FROM Opportunity__r) FROM Contract WHERE (LastModifiedDate >= {start_date}T00:00:00Z AND LastModifiedDate <= {end_date}T23:59:59Z) OR (ActivatedDate >= {start_date} AND ActivatedDate <= {end_date}) AND Opportunity__c != NULL"
    df = pd.DataFrame(sf.query_all(query)[class="hl-string">'records'])
    if not df.empty:
        df_opp = pd.json_normalize(df[class="hl-string">'Opportunity__r']).add_prefix(class="hl-string">'Opportunity.')
        df = pd.concat([df.drop(class="hl-string">'Opportunity__r', axis=1), df_opp], axis=1)
        df = df.rename(columns={class="hl-string">'Opportunity__c': class="hl-string">'SalesOpportunity', class="hl-string">'Opportunity.Owner.Name': class="hl-string">'OpportunityOwner', class="hl-string">'Opportunity.StageName': class="hl-string">'StageName', class="hl-string">'Opportunity.Amount': class="hl-string">'Amount', class="hl-string">'Opportunity.IsWon': class="hl-string">'IsWon', class="hl-string">'Opportunity.Discount_Percentage__c': class="hl-string">'DiscountPercentage'})
        class=class="hl-string">"hl-comment"># Sent for Signature
        df_sent = df[df[class="hl-string">'Status'] == class="hl-string">'Sent'].copy()
        if not df_sent.empty: df_sent[class="hl-string">'ActivityName'] = class="hl-string">'Contract Sent for Signature'; df_sent[class="hl-string">'EventTimestamp'] = pd.to_datetime(df_sent[class="hl-string">'LastModifiedDate']).dt.tz_localize(None); event_log_parts.append(df_sent)
        class=class="hl-string">"hl-comment"># Activated
        df_activated = df[df[class="hl-string">'Status'] == class="hl-string">'Activated'].copy()
        if not df_activated.empty: df_activated[class="hl-string">'ActivityName'] = class="hl-string">'Contract Activated'; df_activated[class="hl-string">'EventTimestamp'] = pd.to_datetime(df_activated[class="hl-string">'ActivatedDate']).dt.tz_localize(None); event_log_parts.append(df_activated)

    class=class="hl-string">"hl-comment"># 12. Order Created
    print(class="hl-string">"Extracting: Order Created")
    query = fclass="hl-string">"SELECT CreatedDate, OpportunityId, {common_opp_fields} FROM Order WHERE CreatedDate >= {start_date}T00:00:00Z AND CreatedDate <= {end_date}T23:59:59Z AND OpportunityId != NULL"
    df = pd.DataFrame(sf.query_all(query)[class="hl-string">'records'])
    if not df.empty:
        df_opp = pd.json_normalize(df[class="hl-string">'Opportunity']).add_prefix(class="hl-string">'Opportunity.')
        df = pd.concat([df.drop(class="hl-string">'Opportunity', axis=1), df_opp], axis=1)
        df[class="hl-string">'ActivityName'] = class="hl-string">'Order Created'
        df[class="hl-string">'EventTimestamp'] = pd.to_datetime(df[class="hl-string">'CreatedDate']).dt.tz_localize(None)
        df = df.rename(columns={class="hl-string">'OpportunityId': class="hl-string">'SalesOpportunity', class="hl-string">'Opportunity.Owner.Name': class="hl-string">'OpportunityOwner', class="hl-string">'Opportunity.StageName': class="hl-string">'StageName', class="hl-string">'Opportunity.Amount': class="hl-string">'Amount', class="hl-string">'Opportunity.IsWon': class="hl-string">'IsWon', class="hl-string">'Opportunity.Discount_Percentage__c': class="hl-string">'DiscountPercentage'})
        event_log_parts.append(df)
        
    class=class="hl-string">"hl-comment"># 13. Order Fulfilled
    print(class="hl-string">"Extracting: Order Fulfilled")
    query = fclass="hl-string">"SELECT LastModifiedDate, Status, OpportunityId, {common_opp_fields} FROM Order WHERE LastModifiedDate >= {start_date}T00:00:00Z AND LastModifiedDate <= {end_date}T23:59:59Z AND Status = 'Fulfilled' AND OpportunityId != NULL"
    df = pd.DataFrame(sf.query_all(query)[class="hl-string">'records'])
    if not df.empty:
        df_opp = pd.json_normalize(df[class="hl-string">'Opportunity']).add_prefix(class="hl-string">'Opportunity.')
        df = pd.concat([df.drop(class="hl-string">'Opportunity', axis=1), df_opp], axis=1)
        df[class="hl-string">'ActivityName'] = class="hl-string">'Order Fulfilled'
        df[class="hl-string">'EventTimestamp'] = pd.to_datetime(df[class="hl-string">'LastModifiedDate']).dt.tz_localize(None)
        df = df.rename(columns={class="hl-string">'OpportunityId': class="hl-string">'SalesOpportunity', class="hl-string">'Opportunity.Owner.Name': class="hl-string">'OpportunityOwner', class="hl-string">'Opportunity.StageName': class="hl-string">'StageName', class="hl-string">'Opportunity.Amount': class="hl-string">'Amount', class="hl-string">'Opportunity.IsWon': class="hl-string">'IsWon', class="hl-string">'Opportunity.Discount_Percentage__c': class="hl-string">'DiscountPercentage'})
        event_log_parts.append(df)

    class=class="hl-string">"hl-comment"># 14. Invoice Generated (using placeholder custom object Invoice__c)
    print(class="hl-string">"Extracting: Invoice Generated")
    query = fclass="hl-string">"SELECT CreatedDate, Opportunity__c, (SELECT Id, Owner.Name, StageName, Amount, IsWon, Discount_Percentage__c FROM Opportunity__r) FROM Invoice__c WHERE CreatedDate >= {start_date}T00:00:00Z AND CreatedDate <= {end_date}T23:59:59Z AND Opportunity__c != NULL"
    try:
        df = pd.DataFrame(sf.query_all(query)[class="hl-string">'records'])
        if not df.empty:
            df_opp = pd.json_normalize(df[class="hl-string">'Opportunity__r']).add_prefix(class="hl-string">'Opportunity.')
            df = pd.concat([df.drop(class="hl-string">'Opportunity__r', axis=1), df_opp], axis=1)
            df[class="hl-string">'ActivityName'] = class="hl-string">'Invoice Generated'
            df[class="hl-string">'EventTimestamp'] = pd.to_datetime(df[class="hl-string">'CreatedDate']).dt.tz_localize(None)
            df = df.rename(columns={class="hl-string">'Opportunity__c': class="hl-string">'SalesOpportunity', class="hl-string">'Opportunity.Owner.Name': class="hl-string">'OpportunityOwner', class="hl-string">'Opportunity.StageName': class="hl-string">'StageName', class="hl-string">'Opportunity.Amount': class="hl-string">'Amount', class="hl-string">'Opportunity.IsWon': class="hl-string">'IsWon', class="hl-string">'Opportunity.Discount_Percentage__c': class="hl-string">'DiscountPercentage'})
            event_log_parts.append(df)
    except Exception as e:
        print(class="hl-string">"Could not extract 'Invoice Generated'. Check if 'Invoice__c' object and 'Opportunity__c' field exist and are accessible.")

    class=class="hl-string">"hl-comment"># 15. Payment Received (using placeholder custom object Invoice__c status change)
    print(class="hl-string">"Extracting: Payment Received")
    query = fclass="hl-string">"SELECT LastModifiedDate, Status__c, Opportunity__c, (SELECT Id, Owner.Name, StageName, Amount, IsWon, Discount_Percentage__c FROM Opportunity__r) FROM Invoice__c WHERE LastModifiedDate >= {start_date}T00:00:00Z AND LastModifiedDate <= {end_date}T23:59:59Z AND Status__c = 'Paid' AND Opportunity__c != NULL"
    try:
        df = pd.DataFrame(sf.query_all(query)[class="hl-string">'records'])
        if not df.empty:
            df_opp = pd.json_normalize(df[class="hl-string">'Opportunity__r']).add_prefix(class="hl-string">'Opportunity.')
            df = pd.concat([df.drop(class="hl-string">'Opportunity__r', axis=1), df_opp], axis=1)
            df[class="hl-string">'ActivityName'] = class="hl-string">'Payment Received'
            df[class="hl-string">'EventTimestamp'] = pd.to_datetime(df[class="hl-string">'LastModifiedDate']).dt.tz_localize(None)
            df = df.rename(columns={class="hl-string">'Opportunity__c': class="hl-string">'SalesOpportunity', class="hl-string">'Opportunity.Owner.Name': class="hl-string">'OpportunityOwner', class="hl-string">'Opportunity.StageName': class="hl-string">'StageName', class="hl-string">'Opportunity.Amount': class="hl-string">'Amount', class="hl-string">'Opportunity.IsWon': class="hl-string">'IsWon', class="hl-string">'Opportunity.Discount_Percentage__c': class="hl-string">'DiscountPercentage'})
            event_log_parts.append(df)
    except Exception as e:
        print(class="hl-string">"Could not extract 'Payment Received'. Check if 'Invoice__c' object and relevant fields exist and are accessible.")

    class=class="hl-string">"hl-comment"># --- Finalize Event Log ---
    if not event_log_parts:
        print(class="hl-string">"No data extracted. The event log is empty.")
        return

    print(class="hl-string">"Concatenating and cleaning final event log...")
    final_event_log = pd.concat(event_log_parts, ignore_index=True)

    class=class="hl-string">"hl-comment"># Select and order final columns
    final_columns = [
        class="hl-string">'SalesOpportunity', class="hl-string">'ActivityName', class="hl-string">'EventTimestamp', 
        class="hl-string">'OpportunityOwner', class="hl-string">'StageName', class="hl-string">'Amount', class="hl-string">'IsWon', class="hl-string">'DiscountPercentage'
    ]
    class=class="hl-string">"hl-comment"># Add any missing columns with null values
    for col in final_columns:
        if col not in final_event_log.columns:
            final_event_log[col] = None
    
    final_event_log = final_event_log[final_columns]

    class=class="hl-string">"hl-comment"># Sort the event log
    final_event_log = final_event_log.sort_values(by=[class="hl-string">'SalesOpportunity', class="hl-string">'EventTimestamp'])

    class=class="hl-string">"hl-comment"># Save to CSV
    output_filename = class="hl-string">'sfdc_lead_to_cash_event_log.csv'
    final_event_log.to_csv(output_filename, index=False, date_format=class="hl-string">'%Y-%m-%d %H:%M:%S')
    print(fclass="hl-string">"Extraction complete. Event log saved to {output_filename}")

if __name__ == class="hl-string">'__main__':
    main()

Klaar om te beginnen?

Gebruik deze template om de data efficiënt voor te bereiden en process mining toe te passen op het Lead to Cash-proces. Begin vandaag nog met het verbeteren van de efficiëntie.

Terug naar de verbetergids Template downloaden

Verlies geen deals meer: verbeter Lead to Cash

Verbeter het Lead-to-Cash-proces in Salesforce en verhoog je winpercentage met 20%.

Start je gratis proefperiode

Geen creditcard nodig

Datatemplate voor Lead to Cash

Datatemplate voor Lead to Cash

Attributen voor Lead to Cash

Activiteiten in Lead to Cash

Extractiegidsen

Salesforce Report Builder en Data Export Service

Stappen

Configuratie

a Voorbeeldquery sql

Rechtstreekse query met Salesforce Object Query Language (SOQL)

Stappen

Configuratie

a Voorbeeldquery sql

Python-script met Salesforce REST API of Bulk API

Stappen

Configuratie

a Voorbeeldquery python

Klaar om te beginnen?

Verlies geen deals meer: verbeter Lead to Cash

Datatemplate voor Lead to Cash

Datatemplate voor Lead to Cash

Attributen voor Lead to Cash

Activiteiten in Lead to Cash

Extractiegidsen

Salesforce Report Builder en Data Export Service

Stappen

Configuratie

a Voorbeeldquery sql

Rechtstreekse query met Salesforce Object Query Language (SOQL)

Stappen

Configuratie

a Voorbeeldquery sql

Python-script met Salesforce REST API of Bulk API

Stappen

Configuratie

a Voorbeeldquery python

Klaar om te beginnen?

Verlies geen deals meer: verbeter Lead to Cash

We gaan zorgvuldig om met je privacy