> Continue procesverbetering > Lead to Cash > Salesforce Sales Cloud > Datatemplate

Jouw datatemplate voor Lead to Cash

Salesforce Sales Cloud

Lead to Cash-attributen (18) Lead to Cash-activiteiten (16) Extractiegidsen (3)

Jouw datatemplate voor Lead to Cash

Deze template biedt een duidelijk plan voor het verzamelen van de essentiële data die je nodig hebt om je Lead to Cash-proces te analyseren. Je ziet welke belangrijke attributen je verzamelt, welke activiteiten je volgt en hoe je deze informatie uit je systeem haalt. Met deze template bereid je je data efficiënt voor op process mining en krijg je waardevolle inzichten in je proces.

Aanbevolen attributen om te verzamelen
Belangrijke activiteiten om te volgen
Extractie-instructies voor Salesforce Sales Cloud

Nieuw met event logs? Leer hoe je een process mining-event log maakt.

Template downloaden

Lead to Cash-attributen

Deze datavelden zijn essentieel voor een volledig event log en maken een gedetailleerde analyse van het Lead to Cash-proces mogelijk.

3 Verplicht 5 Aanbevolen 10 Optioneel

	Naam	Beschrijving
	Activiteit ActivityName	De naam van de bedrijfsgebeurtenis of activiteit die op een specifiek moment in het salesproces plaatsvond.
Beschrijving De Activity Name beschrijft een specifieke stap of mijlpaal in de Lead to Cash-reis, zoals 'Opportunity Created', 'Quote Sent' of 'Contract Signed'. Deze waarden zijn afgeleid van wijzigingen in belangrijke velden of van het aanmaken van gerelateerde records in Salesforce. Door de volgorde van deze activiteiten te analyseren, kun je de procesflow visualiseren, veelvoorkomende paden vinden en afwijkingen van het standaard salesproces detecteren. Dit is de basis voor het maken van procesmaps en het berekenen van KPI's, zoals doorlooptijden tussen verschillende stappen. Waarom dit belangrijk is Het definieert de stappen in de procesmap, zodat je de salesreis van lead tot cash kunt visualiseren en analyseren. Waar je het vindt Meestal afgeleid uit een combinatie van databronnen, waaronder het Opportunity History-object voor veldwijzigingen zoals Stage, aanmaakdatums van gerelateerde objecten zoals Quote en Contract, en specifieke Task- of Event-records. Voorbeelden Opportunity aangemaaktOfferte aan klant gepresenteerdOpportunity gewonnen en geslotenFactuur gegenereerd
	Sales opportunity SalesOpportunity	De unieke identifier voor elke sales opportunity, die als primaire case-identifier voor het Lead to Cash-proces dient.
Beschrijving De Sales Opportunity is het centrale object dat een potentiële deal van kwalificatie tot afsluiting volgt. Elke opportunity heeft een unieke ID die alle gerelateerde activiteiten, communicatie, offertes en contracten koppelt. Bij process mining is deze ID essentieel om de volledige reis van elke deal te reconstrueren. Door de Sales Opportunity als Case ID te gebruiken, kun je de volledige levenscyclus analyseren, de doorlooptijd tussen fasen meten, procesvarianten vinden en begrijpen welke factoren leiden tot gewonnen of verloren deals. Waarom dit belangrijk is Dit is de basisidentifier die alle processtappen met elkaar verbindt. Zo kun je de salescyclus van elke deal volledig en nauwkeurig analyseren. Waar je het vindt Dit is het standaardveld 'Id' op het Opportunity-object in Salesforce Sales Cloud, bijvoorbeeld Opportunity.Id. Voorbeelden 0068c00001KvM7RAAV0068c00001LpA9BAAV0068c00001NqB3CAAV
	Starttijd EventTimestamp	De precieze datum en tijd waarop de activiteit plaatsvond.
Beschrijving De Event Timestamp registreert het exacte moment waarop een activiteit plaatsvond. Deze timestamp is nodig om gebeurtenissen chronologisch te ordenen en voor alle tijdgebaseerde procesanalyses. Dit attribuut vormt de basis voor het berekenen van alle prestatiemaatstaven, zoals doorlooptijden, tijdsduur en wachttijden. Het verschil tussen de timestamps van 'Invoice Generated' en 'Payment Received' levert bijvoorbeeld de data voor de KPI 'Average Days to Payment'. Nauwkeurige timestamps zijn belangrijk om bottlenecks te vinden en procesefficiëntie te meten. Waarom dit belangrijk is Dit attribuut bepaalt de chronologische volgorde van gebeurtenissen en is nodig voor alle berekeningen van doorlooptijd en prestaties. Waar je het vindt Geëxtraheerd uit verschillende datumvelden in Salesforce, zoals 'CreatedDate' op het Opportunity-object, 'LastModifiedDate' uit Opportunity History of specifieke datumvelden op gerelateerde objecten zoals Quote en Contract. Voorbeelden 2023-04-15T10:30:00Z2023-05-20T14:00:00Z2023-06-01T09:15:00Z
	Bedrag van opportunity Amount	Het geschatte totale verkoopbedrag van de opportunity.
Beschrijving Dit attribuut bevat de geldwaarde van een potentiële deal. Het is een van de belangrijkste maatstaven voor financiële en prestatieanalyses. Het bedrag van de Opportunity wordt gebruikt in vrijwel alle financiële weergaven, bijvoorbeeld voor het berekenen van de totale pipelinewaarde en de gemiddelde dealgrootte en voor het vergelijken van waarde met factoren zoals kortingen of doorlooptijden. Het is een belangrijk onderdeel van de dashboards 'Sales Representative Performance' en 'Opportunity Discount Effectiveness'. Waarom dit belangrijk is Het geeft de financiële waarde van elke deal weer en is nodig voor pipelinerapportage, omzetprognoses en prestatieanalyses. Waar je het vindt Dit is het standaardveld 'Amount' op het Opportunity-object. Voorbeelden 50000125000.75250000
	Eigenaar van opportunity OpportunityOwner	De salesmedewerker die aan de sales opportunity is toegewezen en ervoor verantwoordelijk is.
Beschrijving De Opportunity Owner is de Salesforce-gebruiker die primair verantwoordelijk is voor het beheren van de deal. Dit is een belangrijke dimensie voor prestatieanalyses. Door data op basis van de Opportunity Owner te analyseren, kunnen organisaties het dashboard 'Sales Representative Performance' maken. Daarmee vergelijk je doorlooptijden, winpercentages en gemiddelde dealgroottes tussen teamleden en vind je toppresteerders en mogelijkheden voor coaching. Waarom dit belangrijk is Dit attribuut is nodig om de prestaties van het salesteam te analyseren, individuele resultaten te vergelijken en coachingbehoeften te vinden. Waar je het vindt Dit is het veld 'OwnerId' op het Opportunity-object, dat naar het User-object verwijst. Voorbeelden John SmithMaria GarciaDavid Chen
	Gewonnen IsWon	Een boolean-vlag die aangeeft of de opportunity is gewonnen of verloren.
Beschrijving Dit attribuut geeft met true of false de uiteindelijke uitkomst van een sales opportunity aan. De waarde is true als de fase van de opportunity 'Closed Won' is en false als deze 'Closed Lost' is. 'Is Won' vormt de basis voor het berekenen van de KPI 'Opportunity Win Rate', een belangrijke maatstaf voor sales-effectiviteit. Je gebruikt het ook om analyses te segmenteren, bijvoorbeeld om de procespaden van gewonnen en verloren deals te vergelijken of de 'Average Discount on Won Deals' te berekenen. Waarom dit belangrijk is Het meet rechtstreeks de uitkomst van een sales opportunity, zodat je win-verliesanalyses en winpercentages kunt berekenen. Waar je het vindt Dit is het standaardveld 'IsWon' op het Opportunity-object. Het is een formuleveld dat is gebaseerd op StageName. Voorbeelden truefalse
	Kortingspercentage DiscountPercentage	Het kortingspercentage dat op de opportunity is toegepast.
Beschrijving Dit attribuut registreert de korting op een deal, meestal als percentage van de totale prijs. Het speelt een belangrijke rol bij het begrijpen van de winstgevendheid van deals en verkoopgedrag. Deze metriek vormt de basis van het dashboard 'Opportunity Discount Effectiveness' en de KPI 'Average Discount on Won Deals'. Door dit attribuut te analyseren, kunnen salesmanagers bepalen of kortingen daadwerkelijk bijdragen aan gewonnen deals of alleen marges verlagen. Ook kunnen ze kortingsgedrag tussen regio's of salesmedewerkers vergelijken. Waarom dit belangrijk is Dit is belangrijk voor het analyseren van winstgevendheid, het beoordelen van de effectiviteit van de prijsstrategie en het herkennen van te hoge kortingen. Waar je het vindt Dit is meestal een aangepast valuta- of percentageveld op het Opportunity- of Quote-object. Raadpleeg de documentatie van Salesforce Sales Cloud of je beheerder. Voorbeelden 0.050.100.15
	Salesfase StageName	De huidige fase van de opportunity in de salespipeline, zoals 'Qualification' of 'Negotiation'.
Beschrijving De Sales Stage geeft aan hoe een opportunity door het vooraf gedefinieerde salesproces beweegt. Wijzigingen in dit veld zijn belangrijke procesgebeurtenissen, zoals 'Proposal Stage Reached'. Dit attribuut vormt de basis voor de dashboards 'Sales Pipeline Bottleneck Identification' en 'Daily Sales Funnel Operational View'. Je kunt analyseren hoelang opportunities in elke fase blijven, wat de conversiepercentages tussen fasen zijn en hoe gezond de salespipeline is. Waarom dit belangrijk is Het volgt de voortgang van de opportunity door de salesfunnel, zodat je bottlenecks kunt analyseren en de pipeline kunt beheren. Waar je het vindt Dit is het standaardveld 'StageName' op het Opportunity-object. Voorbeelden ProspectieKwalificatieBehoefteanalyseProposal/Price QuoteOnderhandeling/beoordeling
	Accountnaam AccountName	De naam van het klantaccount of bedrijf dat aan de opportunity is gekoppeld.
Beschrijving Account Name koppelt de salesopportunity aan een specifieke klant. Zo kun je het verkoopproces vanuit klantperspectief analyseren. Door het proces per klant te analyseren, krijgen organisaties inzicht in verkoopcycli voor strategische accounts. Ook kunnen ze klanten met veel herstelwerk of lange onderhandelingsfasen herkennen en hun aanpak daarop aanpassen. Dit biedt een waardevolle dimensie om de procesdata te filteren en verder uit te diepen. Waarom dit belangrijk is Koppelt het verkoopproces aan een specifieke klant, zodat je doorlooptijden en interactiepatronen per klant kunt analyseren. Waar je het vindt Dit is afgeleid van het lookupveld 'AccountId' op het Opportunity-object. Dit veld verwijst naar het veld 'Name' op het Account-object. Voorbeelden Global Tech Inc.Innovate Solutions LLCQuantum Industries
	Bronsysteem SourceSystem	Identificeert het bronsysteem waaruit de data is geëxtraheerd.
Beschrijving Dit attribuut geeft aan in welk systeem de eventdata oorspronkelijk is vastgelegd. Voor het Lead to Cash-proces is dat meestal 'Salesforce Sales Cloud'. In omgevingen met meerdere gekoppelde systemen is dit veld belangrijk voor data lineage, probleemoplossing en het 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 Het geeft context over de herkomst van de data. Dat is belangrijk voor datagovernance, validatie en omgevingen met meerdere systemen. Waar je het vindt Dit is meestal een statische waarde die tijdens data-extractie en -transformatie wordt toegevoegd om de herkomst van de dataset te labelen. Voorbeelden Salesforce Sales CloudSFSC
	Contract-ID ContractId	De unieke identificatie van het contract dat aan de opportunity is gekoppeld.
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 'Quote to Contract Cycle Time' en 'Contract Compliance and Adherence'. Je kunt activiteiten zoals 'Contract Sent for Signature' en 'Contract Activated' volgen en hun duur en naleving van SLA's meten. Waarom dit belangrijk is Hiermee kun je het subproces voor contractbeheer nauwkeurig volgen, inclusief doorlooptijden en compliance. Waar je het vindt Deze ID komt uit het veld 'Id' van het Contract-object, dat meestal aan de Opportunity of Account is gekoppeld. Voorbeelden 8008c000001LxD9AAK8008c000001MyE4AAK8008c000001NzF0AAK
	Is herwerk IsRework	Een berekende vlag die aangeeft of een activiteit herstelwerk of een herhaalde stap vertegenwoordigt.
Beschrijving Is Rework is een boolean-vlag 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', wordt dit als herstelwerk beschouwd. Met dit attribuut kun je procesinefficiënties kwantificeren. Het ondersteunt rechtstreeks de berekening van de KPI's 'Order Processing Error Rate' en 'Quote Rework Frequency'. Door herstelwerk zichtbaar te maken, zie je sneller waar onduidelijke vereisten, communicatieproblemen of kwaliteitsproblemen ontstaan. Waarom dit belangrijk is Kwantificeert procesinefficiënties door activiteiten in herstelwerklussen te herkennen en te markeren. Zo kun je verbeteracties gericht inzetten. Waar je het vindt Deze vlag wordt door de process mining-tool berekend door de volgorde van activiteiten te analyseren en teruggaande bewegingen in de procesflow te herkennen. Voorbeelden truefalse
	Laatste data-update LastDataUpdate	De timestamp die aangeeft wanneer de data voor het laatst vanuit het bronsysteem is vernieuwd.
Beschrijving Dit attribuut toont de datum en tijd van de meest recente data-extractie uit Salesforce Sales Cloud. Zo weet je hoe actueel de data is die je analyseert. Het is belangrijk om te weten wanneer de data voor het laatst is bijgewerkt, vooral bij operationele dashboards zoals 'Daily Sales Funnel Operational View'. Zo baseer je beslissingen op een goed beeld van de actualiteit van de data. Waarom dit belangrijk is Laat zien hoe actueel de data is, zodat gebruikers weten hoe recent de procesanalyse is. Waar je het vindt Dit is een metadata-attribuut dat tijdens de data-extractie wordt gegenereerd door de datapijplijn of ETL-tool. Voorbeelden 2023-10-27T02:00:00Z2023-10-28T02:00:00Z
	Leadbron LeadSource	De bron waaruit de lead afkomstig is, zoals 'Web', 'Partner' of 'Vakbeurs'.
Beschrijving Lead Source houdt het marketingkanaal of de verkoopactiviteit bij die de eerste lead heeft opgeleverd. Deze informatie is belangrijk om te begrijpen hoe effectief verschillende strategieën voor klantenwerving zijn. Dit attribuut is de belangrijkste dimensie voor het dashboard 'Lead Conversion Performance Analysis'. Door conversiepercentages en dealwaarden per leadbron te analyseren, kunnen bedrijven hun marketingbudget beter inzetten en zich richten op de meest winstgevende kanalen. Waarom dit belangrijk is Hiermee kun je de effectiviteit van marketingkanalen bepalen door leads aan hun herkomst en latere succespercentages te koppelen. Waar je het vindt Dit is het standaardveld 'LeadSource' op het Lead-object. Bij conversie wordt het meestal overgezet naar het Opportunity-object. Voorbeelden WebTelefonische aanvraagDoorverwijzing door partnerGekochte lijst
	Offerte-ID QuoteId	De unieke identificatie van een verkoopofferte die aan de opportunity is gekoppeld.
Beschrijving Quote ID identificeert een specifieke prijsopgave die voor een opportunity aan de klant is verstrekt. Een opportunity kan gedurende de levenscyclus meerdere offertes hebben. Door Quote ID's te volgen, kun je het offertegedeelte van het verkoopproces analyseren. Je kunt de 'Quote to Contract Cycle Time' meten, zien hoeveel offertewijzigingen ('Quote Modified') plaatsvinden en de KPI 'Quote Rework Frequency' ondersteunen door verschillende versies van offertes van elkaar te 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 je het vindt Deze ID komt uit het veld 'Id' van het Quote-object, dat aan de Opportunity is gekoppeld. Voorbeelden 0Q08c000001OxP1AAK0Q08c000001PyQ2AAK0Q08c000001QzR3AAK
	Order-ID OrderId	De unieke identificatie van de verkooporder die uit een gewonnen opportunity is aangemaakt.
Beschrijving Order ID koppelt een salesopportunity aan het daaropvolgende fulfilmentproces. Dit is het overdrachtsmoment van sales naar de bedrijfsvoering. Deze ID is belangrijk om de procesanalyse uit te breiden van de fase 'Opportunity Closed Won' naar orderbeheer. Hiermee kun je de activiteiten 'Order Created' en 'Order Fulfilled volgen en is monitoring van de 'Order Fulfillment Error Rate' mogelijk. Waarom dit belangrijk is Verbindt het verkoopgedeelte van het proces met het orderfulfilmentgedeelte, zodat je een volledige Lead to Cash-analyse kunt uitvoeren. Waar je het vindt 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 Het attribuut Region segmenteert opportunities op basis van geografie, zoals 'North America', 'EMEA' of 'APAC'. Salesorganisaties gebruiken dit vaak om hun teams en rapportages in te delen. Dit is de belangrijkste dimensie voor het dashboard 'Regional Sales Performance Comparison'. Hiermee kunnen managers de prestaties van processen tussen regio's vergelijken, best practices in goed presterende gebieden herkennen en zien waar verbetering nodig is. De analyse kan onder meer doorlooptijden, winpercentages en het gebruik van kortingen omvatten. Waarom dit belangrijk is Maakt het mogelijk om verkoopprocessen en prestaties in verschillende geografische gebieden te vergelijken en regionale sterke en zwakke punten te herkennen. Waar je het vindt Dit is vaak een aangepast veld op het Opportunity- of Account-object. Raadpleeg de documentatie van Salesforce Sales Cloud of je beheerder. Voorbeelden Noord-AmerikaEMEAAPACLATAM
	Type verkoopkans Type	Deelt de opportunity bijvoorbeeld in als 'New Business' of 'Existing Customer'.
Beschrijving Opportunity Type is een standaardclassificatieveld waarmee je deals kunt segmenteren. Zo krijg je inzicht in de verschillende verkoopprocessen of cycli voor het werven van nieuwe klanten en het uitbreiden van bestaande klantrelaties. In process mining maakt dit attribuut vergelijkende analyses mogelijk. Je kunt bijvoorbeeld de procesmap filteren om te zien of de verkoopcyclus voor 'New Business' langer is of meer stappen bevat dan die voor verlengingen van 'Existing Customer'. Dit helpt bij strategische beslissingen en procesoptimalisatie. Waarom dit belangrijk is Door opportunities op type te segmenteren, kun je verschillende verkoopprocessen, doorlooptijden en succespercentages voor nieuwe en bestaande business vergelijken. Waar je het vindt Dit is het standaardveld 'Type' op het Opportunity-object. Voorbeelden Nieuwe businessBestaande klant - upgradeBestaande klant - verlengingAanvullende business

Verplicht Aanbevolen Optioneel

Lead to Cash-activiteiten

Dit zijn de belangrijkste processtappen en mijlpalen die je moet volgen voor een nauwkeurige procesanalyse en prestatieanalyse.

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 staat voor het realiseren van omzet. De tijd tussen factuur en betaling is een belangrijke cashflow-KPI. Waar je het vindt Afgeleid uit een wijziging van de status van een Invoice-object naar 'Paid' of uit het aanmaken van een aan de factuur gekoppeld Payment-object. Deze data komt vaak uit een extern financieel systeem. Vastleggen Bepaal wanneer 'Status' van de Invoice 'Paid' wordt of wanneer een gekoppeld Payment-record wordt aangemaakt. Eventtype inferred
	Contract geactiveerd	Deze activiteit geeft aan dat een contract volledig is uitgevoerd en door alle partijen is ondertekend. Het contract is daarmee juridisch actief. Meestal leg je dit vast als een statuswijziging van het Contract-object naar 'Activated'.
Waarom dit belangrijk is Dit is de definitieve bevestiging van een juridische overeenkomst met de klant en een belangrijk moment voor omzetverwerking en compliance. Vertraging hier kan de financiële prognose rechtstreeks beïnvloeden. Waar je het vindt Afgeleid uit een wijziging van het veld Status van het Contract-object naar 'Activated'. De timestamp van deze wijziging komt uit de veldgeschiedenis. Vastleggen Bepaal de timestamp waarop 'Status' op het Contract-object wordt ingesteld op 'Activated'. Eventtype inferred
	Lead geconverteerd naar opportunity	Deze activiteit markeert het moment waarop een gekwalificeerde lead wordt geconverteerd naar een sales opportunity, met een gekoppeld account en contactpersoon. Meestal voert een salesmedewerker deze actie expliciet uit in Salesforce.
Waarom dit belangrijk is Dit is de belangrijkste overdracht van marketing of leadontwikkeling naar het salesteam. Door de tijd en conversiepercentages vanaf dit punt te analyseren, kun je de leadkwaliteit en de efficiëntie van het eerste salesproces beoordelen. Waar je het vindt 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 bijgehouden wanneer een gebruiker een Lead-record converteert en de velden ConvertedDate en ConvertedOpportunityId invult. Eventtype explicit
	Offerte aangemaakt	Deze activiteit staat voor het opstellen van een formeel prijsdocument voor de klant. Je legt dit vast wanneer een nieuw Quote-record wordt aangemaakt en aan de Opportunity wordt gekoppeld.
Waarom dit belangrijk is Het aanmaken van een offerte is een belangrijke stap richting het sluiten van een deal. Door het aantal offertes en de aanmaaktijd te analyseren, kun je de efficiëntie van het salesteam en het momentum van deals beoordelen. Waar je het vindt Afkomstig uit het systeemveld CreatedDate van het Quote-object. Het Quote-object heeft een lookuprelatie met de bovenliggende Opportunity. Vastleggen Gebruik CreatedDate uit het Quote-object dat aan de Opportunity is gekoppeld. Eventtype explicit
	Offerte door klant geaccepteerd	Deze activiteit markeert dat de klant akkoord gaat met de voorwaarden en prijs van een offerte. Meestal legt een gebruiker dit vast door de status van de Quote te wijzigen naar 'Accepted'.
Waarom dit belangrijk is Dit is een belangrijk koopsignaal en een groot moment vóór het opstellen van het contract. De tijd tussen presentatie en acceptatie laat goed zien hoeveel frictie er in de salescyclus zit. Waar je het vindt Afgeleid uit een wijziging van het veld Status van het Quote-object naar 'Accepted'. De timestamp komt uit de veldgeschiedenis van deze wijziging. Vastleggen Bepaal de timestamp waarop het veld 'Status' van de Quote wijzigt naar 'Accepted'. Eventtype inferred
	Opportunity aangemaakt	Dit staat voor het aanmaken van een nieuwe sales opportunity in Salesforce en markeert een potentiële deal die omzet kan opleveren. De gebeurtenis wordt expliciet gelogd met een aanmaaktimestamp wanneer het record voor het eerst wordt opgeslagen.
Waarom dit belangrijk is Deze activiteit is het officiële begin van de salescyclus voor een opportunity. Dit is het startpunt voor het meten van de totale salescyclustijd en de snelheid van de pipeline. Waar je het vindt Afkomstig uit het systeemveld CreatedDate van het Opportunity-object. Dit geeft een precieze timestamp van het moment waarop het opportunity-record is aangemaakt. Vastleggen Gebruik het veld CreatedDate van het Opportunity-object. Eventtype explicit
	Opportunity gewonnen en gesloten	Dit staat voor het succesvol sluiten van een salesdeal, waarbij de opportunity is gewonnen. Dit gebeurt door een handmatige of automatische wijziging van het veld StageName van de Opportunity naar 'Closed Won'.
Waarom dit belangrijk is Dit is een belangrijk succesresultaat van het salesproces. Door trends en attributen van gewonnen deals te analyseren, krijg je beter zicht op salesprestaties en strategie. Waar je het vindt Afgeleid uit een wijziging van het veld StageName van het Opportunity-object naar 'Closed Won'. De datum van deze gebeurtenis staat in CloseDate en de timestamp in de veldgeschiedenis. Vastleggen Bepaal vanuit OpportunityFieldHistory de timestamp waarop 'StageName' van de Opportunity 'Closed Won' wordt. Eventtype inferred
	Opportunity verloren en gesloten	Dit staat voor het niet succesvol sluiten van een salesdeal, omdat de opportunity naar een concurrent gaat of de klant besluit niet te kopen. Je legt dit vast wanneer StageName van de Opportunity wordt gewijzigd naar 'Closed Lost'.
Waarom dit belangrijk is Dit is het belangrijkste negatieve resultaat. Door te analyseren wanneer en waarom deals verloren gaan, kun je salesstrategie, training en productpositionering verbeteren. Waar je het vindt Afgeleid uit een wijziging van het veld StageName van het Opportunity-object naar 'Closed Lost'. De datum staat in CloseDate en de timestamp in de veldgeschiedenis. Vastleggen Bepaal vanuit OpportunityFieldHistory de timestamp waarop 'StageName' van de Opportunity 'Closed Lost' wordt. Eventtype inferred
	Contract ter ondertekening verstuurd	Geeft aan dat een formeel contract is opgesteld en naar de klant is gestuurd voor ondertekening. Meestal leid je dit af uit een statuswijziging op 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 bij te houden, monitor je de efficiëntie van het contractbeheer. Waar je het vindt Afgeleid uit een statuswijziging op het Contract-object, dat aan de Opportunity is gekoppeld. Hiervoor moet je de veldgeschiedenis van het veld Status van het Contract bijhouden. Vastleggen Bepaal de timestamp waarop het veld 'Status' van het Contract wijzigt naar een waarde zoals 'Sent for Signature'. Eventtype inferred
	Factuur gegenereerd	Dit staat voor het aanmaken van een factuur om de klant te laten betalen voor geleverde goederen of diensten. Je kunt dit vastleggen door een Invoice-record aan te maken 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 rechtstreeks invloed op de cashflow. Waar je het vindt Hiervoor is Salesforce Billing of een vergelijkbaar pakket nodig. Afkomstig uit het veld CreatedDate van het Invoice-object, dat aan de Order of het Account is gekoppeld. Vastleggen Gebruik CreatedDate uit het Invoice-object, als dit beschikbaar is. Eventtype explicit
	Fase van opportunity gewijzigd	Deze activiteit registreert elke wijziging in de salesfase van een opportunity, bijvoorbeeld van 'Qualification' naar 'Needs Analysis'. Deze wijzigingen worden vastgelegd in de veldgeschiedenis van het systeem, zodat je de voortgang van de opportunity kunt volgen.
Waarom dit belangrijk is Het bijhouden van fasewijzigingen is belangrijk om de snelheid van de salespipeline te begrijpen, bottlenecks te vinden waar deals blijven hangen en procesconformiteit te analyseren. Waar je het vindt Afgeleid 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. Eventtype inferred
	Offerte aan klant gepresenteerd	Deze gebeurtenis geeft aan dat een offerte ter beoordeling naar de klant is gestuurd of formeel is gepresenteerd. Meestal leid je dit af uit een statuswijziging op het Quote-record, bijvoorbeeld van 'Draft' naar 'Presented' of 'In Review'.
Waarom dit belangrijk is Met deze activiteit begint de klok voor onderhandeling en goedkeuring door de klant. Door dit bij te houden, meet je de reactietijd van de klant en vind je vertragingen in de fase waarin de offerte wordt geaccepteerd. Waar je het vindt Afgeleid uit wijzigingen in het veld Status van het Quote-object. Je moet de geschiedenis van dit veld bijhouden om de exacte timestamp van de wijziging te bepalen. Vastleggen Bepaal de timestamp waarop het veld 'Status' van de Quote wijzigt naar 'Presented', 'Sent' of een vergelijkbare waarde. Eventtype inferred
	Offerte gewijzigd	Dit staat voor een update of herziening van een bestaande offerte, vaak na feedback of onderhandelingen met de klant. Je legt dit vast door wijzigingen in belangrijke velden van het Quote-record na de eerste aanmaak te volgen.
Waarom dit belangrijk is Veelvuldige wijzigingen aan offertes kunnen wijzen op inefficiëntie, communicatieproblemen of langdurige onderhandelingsrondes. Door deze rework-loop te analyseren, kun je de fase van offerte tot contract verkorten. Waar je het vindt Afgeleid uit het veld LastModifiedDate van het Quote-object of, gedetailleerder, uit het bijhouden van de geschiedenis van velden zoals TotalPrice of regelitems. Vastleggen Vergelijk LastModifiedDate met CreatedDate op het Quote-object of gebruik de veldgeschiedenis van de Quote. Eventtype inferred
	Order aangemaakt	Deze activiteit markeert het aanmaken van een salesorder en start formeel het leveringsproces nadat een deal is gewonnen. Je legt dit vast wanneer een nieuw Order-record wordt aangemaakt en aan de Opportunity of het Account wordt gekoppeld.
Waarom dit belangrijk is Dit is de officiële overdracht van sales naar het team voor orderafhandeling en bedrijfsvoering. De efficiëntie van deze stap is belangrijk voor tijdige levering en klanttevredenheid. Waar je het vindt Afkomstig uit het systeemveld CreatedDate van het Order-object. De Order is meestal gekoppeld aan het Account en/of de oorspronkelijke Opportunity. Vastleggen Gebruik CreatedDate uit het Order-object dat aan het Account van de Opportunity is gekoppeld. Eventtype explicit
	Order uitgevoerd	Geeft aan dat de producten of diensten op 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 Dit moment markeert dat de leveringsbelofte aan de klant is nagekomen. De tijd tussen het aanmaken en uitvoeren van de order is een belangrijke maatstaf voor efficiëntie van de bedrijfsvoering en klanttevredenheid. Waar je het vindt Afgeleid uit een wijziging van het veld Status van het Order-object naar een voltooiingswaarde. Voor de timestamp van de gebeurtenis is veldgeschiedenis nodig. Vastleggen Bepaal de timestamp waarop 'Status' van de Order wijzigt naar 'Fulfilled' of 'Completed'. Eventtype inferred
	Proposalfase bereikt	Markeert het moment waarop een opportunity naar de fase 'Proposal/Price Quote' gaat. Dit wordt afgeleid uit de geschiedenis van het veld 'StageName' van de Opportunity.
Waarom dit belangrijk is Dit is een belangrijk moment: er is een mogelijke oplossing gevonden en die kan worden geprijsd en gepresenteerd. Het is een belangrijk meetpunt voor de tijd die nodig is voor het uitwerken van de oplossing en de offerte. Waar je het vindt Afgeleid uit het OpportunityFieldHistory-object, specifiek door de timestamp te bepalen waarop het veld 'StageName' is gewijzigd naar 'Proposal/Price Quote' of een vergelijkbare aangepaste fasewaarde. Vastleggen Filter OpportunityFieldHistory op records waarbij 'Field' gelijk is aan 'StageName' en 'NewValue' de proposalfase bevat. Eventtype inferred

Aanbevolen Optioneel

Extractiegidsen

Zo haal je je data uit Salesforce Sales Cloud

Stappen

Controleer de vereiste instelling: Field History Tracking: Controleer voordat je begint bij je Salesforce-beheerder of Field History Tracking is ingeschakeld voor de belangrijkste velden van de volgende objecten: Opportunity (StageName, Bedrag), Offerte (Status), Contract (Status) en Order (Status). Dit is belangrijk om proceswijzigingen correct vast te leggen.
Ga naar Salesforce Reports: Meld je aan bij je Salesforce-instantie. Gebruik de App Launcher om het tabblad 'Reports' te zoeken en te openen. Klik op de knop 'New Report' om te beginnen.
Maak het Opportunity History-rapport: Dit rapport legt het aanmaken van Opportunities, fasewijzigingen en afsluitende events vast. Selecteer het rapporttype 'Opportunities with Field History'. Voeg de volgende kolommen toe: Opportunity ID, Opportunity Name, Created Date, Field/Event, Old Value, New Value, Edit Date en Edit By. Voeg ook de aanbevolen attributen toe: Owner, Bedrag, Is Won en eventuele relevante kortingsvelden.
Maak het Lead Conversion-rapport: Maak een tweede rapport met het rapporttype 'Leads'. Voeg de kolommen Lead ID, Converted Date, Converted Opportunity ID en Lead Owner toe. Voeg een filter toe zodat alleen leads met 'Converted' als true worden getoond.
Maak het Quote Events-rapport: Maak een derde rapport met het rapporttype 'Quotes', bij voorkeur een type waarin history is opgenomen, zoals 'Quotes with Field History'. Voeg de kolommen Quote ID, Opportunity ID, CreatedDate, LastModifiedDate en Status toe. Je gebruikt dit rapport om het aanmaken van offertes en statuswijzigingen af te leiden.
Maak aanvullende rapporten voor Contracts, Orders en Invoices: Volg hetzelfde patroon als voor het Quote-rapport en maak afzonderlijke rapporten voor Contracts, Orders en Invoices als deze objecten in je Salesforce-instantie 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 een consistent datumbereikfilter in, bijvoorbeeld 'Opportunity Created Date' in de afgelopen 6 maanden. Voer elk rapport uit en gebruik de functie 'Export' om de resultaten als CSV-bestand op te slaan.
Combineer de data in een spreadsheet: Open een spreadsheetprogramma zoals Microsoft Excel. Kopieer de data uit elk geëxporteerd CSV-bestand naar een afzonderlijk werkblad binnen één werkmap.
Maak het uiteindelijke eventlogwerkblad: Maak een nieuw werkblad met de naam 'Event Log'. Definieer de vereiste koppen: SalesOpportunity, ActivityName en EventTimestamp, plus de aanbevolen koppen: OpportunityOwner, StageName, Bedrag, IsWon en DiscountPercentage.
Transformeer en consolideer de data: Vul het werkblad 'Event Log' handmatig door de data uit de bronbladen te verwerken. 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 ingesteld op 'Opportunity Closed Won' en EventTimestamp op de waarde van 'Edit Date'. Herhaal dit voor alle 16 vereiste activiteiten in alle bronbestanden.
Werk de opmaak af en exporteer: Zorg dat de kolom EventTimestamp een consistente notatie gebruikt, bijvoorbeeld YYYY-MM-DD HH:MI:SS. De kolom SalesOpportunity moet voor elke rij zijn ingevuld met de Opportunity ID uit de bronrapporten. Sla het uiteindelijke, geconsolideerde werkblad 'Event Log' op als CSV-bestand om het te uploaden.

Configuratie

Rapporttypen: Het belangrijkste rapporttype is 'Opportunities with Field History'. Daarnaast zijn rapporten nodig voor Leads, Quotes, Contracts, Orders en Invoices. Rapporttypen met historie voor deze objecten verbeteren de nauwkeurigheid van de data aanzienlijk.
Field History Tracking: Dit moet vooraf door een Salesforce-beheerder zijn ingesteld. Het is nodig om wijzigingen in Opportunity Stage, Quote Status, Contract Status en Order Status te volgen.
Rechten: De gebruiker die de rapporten uitvoert, heeft leestoegang nodig tot alle relevante objecten: Lead, Account, Opportunity, OpportunityFieldHistory, Quote, Contract, Order en mogelijk Invoice en Payment.
Datumfilter: Gebruik in alle rapporten dezelfde datumfilter, zodat de data goed op elkaar aansluit. Een filter op 'Opportunity Created Date' voor de afgelopen 3 tot 6 maanden wordt aanbevolen om de hoeveelheid data beheersbaar te houden.
Datavolume: Bij organisaties met zeer veel opportunities en activiteiten kan Report Builder traag worden of tegen exportlimieten aanlopen, meestal rond 100.000 rijen, afhankelijk van de editie. In dat geval is de wekelijkse Data Export Service een betrouwbaarder 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, zoals StageName en Status, van deze objecten.
Kies een uitvoeringstool: Deze query gebruikt UNION ALL-clausules die niet worden ondersteund door de native Developer Console of Workbench van Salesforce. Gebruik een externe tool die verbinding kan maken met Salesforce en SQL-achtige queries kan uitvoeren, zoals een Business Intelligence-tool (Tableau, Power BI), een ETL-tool (MuleSoft, Informatica) of een datatool met een Salesforce-connector (DBeaver, DataGrip).
Maak verbinding met Salesforce: Configureer de verbinding met je Salesforce-instantie in de gekozen tool. Meestal heb je je gebruikersnaam, wachtwoord en securitytoken nodig. Gebruik de optie voor de Salesforce (API)-connector.
Bereid de query voor: Kopieer de volledige SOQL-query uit de sectie query van dit document naar de query-editor van je tool.
Configureer placeholders: De query bevat verschillende placeholders die je moet vervangen door waarden uit je Salesforce-organisatie. Het gaat om:
- 'YYYY-MM-DDThh:mm:ssZ': Vervang alle exemplaren door de gewenste begin- en einddatum voor de extractieperiode, in ISO 8601-notatie.
- [Your_Discount_Field__c]: Vervang dit door de API-naam van je aangepaste veld voor het kortingspercentage op het Opportunity-object.
- [Quote_Presented_Status]: Vervang dit door de werkelijke statuswaarde die wordt gebruikt wanneer een offerte aan een klant is gepresenteerd, bijvoorbeeld 'Presented' of 'In Review'.
- [Opportunity_Lookup_On_Contract__c]: Vervang dit door de API-naam van het lookupveld op het Contract-object dat naar de Opportunity verwijst.
- [Order_Fulfilled_Status]: Vervang dit door de statuswaarde die aangeeft dat een order is uitgevoerd, bijvoorbeeld 'Fulfilled', 'Shipped' of 'Completed'.
- [Opportunity_Lookup_On_Invoice__c]: Vervang dit door de API-naam van het lookupveld op het Factuur-object dat naar de 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 van de query de geretourneerde dataset. Kijk of deze rijen bevat voor alle verschillende activiteiten en of de kolommen correct zijn ingevuld.
Verhelp mogelijke fouten: Controleer bij een mislukte query of er typefouten staan in de vervangen placeholders. Controleer ook of de gebruiker via field-level security toegang heeft tot alle opgevraagde velden. Bij een te groot datumbereik kan de query een time-out krijgen of governor limits bereiken. Verklein het bereik dan, bijvoorbeeld tot één kwartaal.
Exporteer de data: Exporteer de uiteindelijke resultatenset als CSV-bestand.
Bereid de upload voor: Controleer of de CSV-koppen overeenkomen met de vereiste attributen: SalesOpportunity, ActivityName, EventTimestamp, OpportunityOwner, StageName, Bedrag, IsWon en DiscountPercentage. Het bestand kan nu naar een process mining-tool worden geüpload.

Configuratie

Field History Tracking: Deze extractie is afhankelijk van het inschakelen van Field History Tracking voor de objecten Opportunity (StageName), Quote (Status), Contract (Status) en Order (Status). Zonder deze instelling worden activiteiten voor status- en fasewijzigingen niet vastgelegd.
Gebruikersrechten: De uitvoerende gebruiker moet API-toegang en leesrechten hebben voor alle objecten in de query: Lead, Opportunity, OpportunityFieldHistory, Quote, QuoteHistory, Contract, ContractHistory, Order, OrderHistory, Invoice en InvoiceHistory.
Datumbereik: Definieer een specifiek datumbereik met de placeholders 'YYYY-MM-DDThh:mm:ssZ'. Voor een eerste analyse wordt een periode van 3 tot 6 maanden aanbevolen, zodat de hoeveelheid data en de prestaties in balans blijven. Begin bij zeer grote Salesforce-instanties met een kortere periode, bijvoorbeeld één maand, om prestaties en governor limits te testen.
Aangepaste velden en statussen: De query gebruikt placeholders voor aangepaste velden, zoals [Your_Discount_Field__c], en aangepaste statuswaarden, zoals [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 Order en van een Invoice-object, dat vaak met Salesforce Billing wordt gebruikt. Als jouw organisatie deze objecten niet gebruikt of een ander billingpakket gebruikt, leveren die delen van de query geen data op of veroorzaken ze een fout. Verwijder of pas ze dan 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 nieuwer op je systeem is geïnstalleerd. Je hebt ook pip nodig, de pakketbeheerder van Python, om de benodigde bibliotheken te installeren.
Installeer de benodigde bibliotheken: Open de opdrachtregel of terminal en installeer de bibliotheken simple-salesforce en pandas met de opdracht pip install simple-salesforce pandas.
Configureer Salesforce API-toegang: Meld je aan bij je Salesforce-account met een beheerdersprofiel. Ga naar Setup, vervolgens naar Apps en daarna naar App Manager. Maak een nieuwe 'Connected App'. Schakel OAuth Settings in en geef de app de scope 'Access and manage your data (api)'. Na het opslaan ontvang je een 'Consumer Key' en 'Consumer Secret'. Controleer ook of het gebruikersaccount voor het script een Security Token heeft. Je kunt deze genereren of opnieuw instellen via je persoonlijke instellingen onder 'Reset My Security Token'.
Stel het Python-script in: Kopieer het volledige Python-script uit de sectie Query naar een bestand met de naam extract_lead_to_cash.py.
Voer je inloggegevens in: Open het scriptbestand en vervang de placeholderwaarden voor username, password, security_token en instance_url door je Salesforce-inloggegevens. Zet in een productieomgeving geen inloggegevens hardcoded in het script. Gebruik een veilige methode, zoals omgevingsvariabelen of een configuratiebestand.
Definieer de extractieperiode: Pas de variabelen start_date en end_date in het script aan om het tijdvenster voor de op te halen data vast te leggen. Gebruik de notatie 'YYYY-MM-DD'.
Begrijp de scriptlogica: Het script maakt verbinding met de Salesforce-API en voert een reeks Salesforce Object Query Language-query's (SOQL-query's) uit. Elke query richt zich op een specifiek object, zoals Opportunity, OpportunityFieldHistory of Offerte, om een afzonderlijke bedrijfsactiviteit vast te leggen.
Verzamel de data: De resultaten van elke query worden omgezet naar een gestructureerde indeling, een pandas DataFrame. Deze afzonderlijke DataFrames, die elk één activiteit vertegenwoordigen, worden verzameld in één lijst.
Transformeer en formatteer de data: Het script voegt alle afzonderlijke DataFrames samen tot één volledig event log. Het hernoemt kolommen volgens het vereiste schema voor process mining, zoals SalesOpportunity en ActivityName, en controleert of de datatypen kloppen.
Voer het script uit: Voer het script in de terminal uit met de opdracht python extract_lead_to_cash.py. Het script maakt verbinding met Salesforce, voert de query's uit en verwerkt de data.
Haal het event log op: Na een succesvolle uitvoering genereert het script in dezelfde map een bestand met de naam sfdc_lead_to_cash_event_log.csv. Dit CSV-bestand is het uiteindelijke event log, klaar om naar een process mining-tool te worden geüpload.

Configuratie

Vereisten: Een Salesforce-account met Enterprise-, Unlimited- of Developer Edition, omdat deze edities API-toegang bieden. Je Salesforce-gebruikersprofiel moet de machtiging 'API Enabled' hebben en leestoegang tot de volgende objecten: Lead, Opportunity, OpportunityFieldHistory, Quote, Contract en Order. Voor aangepaste objecten voor facturatie of betalingen is ook leestoegang nodig.
Authenticatie: Het script gebruikt authenticatie met gebruikersnaam, wachtwoord en security token. Overweeg voor extra beveiliging in een productieomgeving OAuth 2.0 JWT Bearer Flow te implementeren. simple-salesforce ondersteunt dit ook.
Datumbereik: De variabelen start_date en end_date in het script bepalen de extractieperiode. Voor een eerste analyse wordt een periode van 3 tot 6 maanden aanbevolen. Zo krijg je voldoende data zonder dat de hoeveelheid onoverzichtelijk wordt. De datumfilters worden toegepast op het primaire timestampveld van elke activiteit, zoals CreatedDate of ConvertedDate.
API-gebruik: Dit script voert meerdere afzonderlijke queries uit. Elke query en het ophalen van alle resultaten verbruiken API-aanroepen, die meetellen voor de dagelijkse limieten van je organisatie. Houd hier rekening mee, vooral in een omgeving met veel andere integraties. Voor het extraheren van miljoenen records moet je het script aanpassen om de Salesforce Bulk API te gebruiken.
Aanpassingen: Het script gaat waar mogelijk uit van standaardnamen voor objecten en velden. Jouw organisatie kan aangepaste velden gebruiken, zoals Discount_Percentage__c, aangepaste objecten, zoals Invoice__c en Payment__c, of aangepaste relaties, zoals een lookup 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 aan de slag te gaan?

Gebruik deze template om je datavoorbereiding efficiënter te maken en meer uit process mining voor je Lead to Cash-processen te halen. Begin vandaag nog met het verbeteren van je efficiëntie.

Terug naar de verbetergids Template downloaden

Stop met het verliezen van deals: optimaliseer Lead to Cash nu

Verbeter je Salesforce Lead to Cash-proces en behaal 20% hogere winpercentages.

Start je gratis proefperiode

Geen creditcard nodig

Jouw datatemplate voor Lead to Cash

Jouw datatemplate voor Lead to Cash

Lead to Cash-attributen

Lead to Cash-activiteiten

Extractiegidsen

Salesforce Report Builder en Data Export Service

Stappen

Configuratie

a Voorbeeldquery sql

Rechtstreekse Salesforce Object Query Language (SOQL)-query

Stappen

Configuratie

a Voorbeeldquery sql

Python-script met Salesforce REST- of Bulk API

Stappen

Configuratie

a Voorbeeldquery python

Klaar om aan de slag te gaan?

Stop met het verliezen van deals: optimaliseer Lead to Cash nu

Jouw datatemplate voor Lead to Cash

Jouw datatemplate voor Lead to Cash

Lead to Cash-attributen

Lead to Cash-activiteiten

Extractiegidsen

Salesforce Report Builder en Data Export Service

Stappen

Configuratie

a Voorbeeldquery sql

Rechtstreekse Salesforce Object Query Language (SOQL)-query

Stappen

Configuratie

a Voorbeeldquery sql

Python-script met Salesforce REST- of Bulk API

Stappen

Configuratie

a Voorbeeldquery python

Klaar om aan de slag te gaan?

Stop met het verliezen van deals: optimaliseer Lead to Cash nu

We respecteren je privacy