> Melhoria contínua de processos > Lead to Cash > Salesforce Sales Cloud > Template de dados

Seu Template de dados de Lead to Cash

Salesforce Sales Cloud

Atributos de Lead to Cash (18) Atividades de Lead to Cash (16) Guias de extração (3)

Seu Template de dados de Lead to Cash

Este Template oferece um roteiro claro para coletar os dados essenciais à análise do seu processo de Lead to Cash. Ele apresenta os principais atributos a serem coletados, as atividades críticas a serem acompanhadas e orientações práticas para extrair essas informações do seu sistema. Com este Template, você prepara seus dados com eficiência para obter insights valiosos de Process Mining.

Atributos recomendados para coletar
Principais atividades a acompanhar
Orientações para extração no Salesforce Sales Cloud

Novo em Event Logs? Aprenda como criar um Event Log de Process Mining.

Baixar Template

Atributos de Lead to Cash

Estes campos de dados são essenciais para criar um Event Log completo, permitindo uma análise detalhada do processo de Lead to Cash.

3 Obrigatório 5 Recomendado 10 Opcional

	Nome	Descrição
	Atividade ActivityName	O nome do evento ou da atividade de negócio que ocorreu em um ponto específico do processo de vendas.
Descrição O nome da atividade descreve uma etapa ou um marco específico da jornada de Lead to Cash, como 'Opportunity Created', 'Quote Sent' ou 'Contract Signed'. Esses dados são derivados de alterações em campos importantes ou da criação de registros relacionados no Salesforce. Analisar a sequência dessas atividades permite visualizar o fluxo do processo, identificar caminhos comuns e detectar desvios do processo de vendas padrão. Isso é fundamental para criar mapas de processo e calcular KPIs, como os tempos de ciclo entre diferentes etapas. Por que isso importa Ele define as etapas no mapa de processo, permitindo visualizar e analisar a jornada de vendas do lead ao recebimento. Onde obter Normalmente derivado de uma combinação de fontes de dados, incluindo o objeto Opportunity History, para alterações de campos como Stage, datas de criação de objetos relacionados, como Quote e Contract, e registros específicos de Task ou Event. Exemplos Opportunity criadaQuote apresentada ao clienteOpportunity fechada como ganhaInvoice gerada
	Hora de início EventTimestamp	A data e a hora exatas em que a atividade ocorreu.
Descrição O timestamp do evento registra o momento exato em que uma atividade ocorreu. Esse timestamp é essencial para ordenar os eventos cronologicamente e para todas as análises de processo baseadas em tempo. Este atributo é a base para calcular todas as métricas de performance, como tempos de ciclo, durações e tempos de espera. Por exemplo, a diferença entre os timestamps de 'Invoice Generated' e 'Payment Received' fornece os dados para o KPI 'Average Days to Payment'. Timestamps precisos são essenciais para identificar gargalos e medir a eficiência do processo. Por que isso importa Este atributo fornece a ordem cronológica dos eventos e é essencial para todos os cálculos de duração e performance. Onde obter Extraído de vários campos de data no Salesforce, como 'CreatedDate' no objeto Opportunity, 'LastModifiedDate' do Opportunity History ou campos de data específicos em objetos relacionados, como Quote e Contract. Exemplos 2023-04-15T10:30:00Z2023-05-20T14:00:00Z2023-06-01T09:15:00Z
	Oportunidade de vendas SalesOpportunity	O identificador exclusivo de cada oportunidade de vendas, usado como identificador principal do caso no processo de Lead to Cash.
Descrição A Sales Opportunity é o objeto central que acompanha um negócio potencial desde a qualificação até o fechamento. Cada oportunidade tem um ID exclusivo que conecta todas as atividades, comunicações, cotações e contratos relacionados. No Process Mining, esse ID é essencial para reconstruir a jornada completa de cada negócio. Ao usar a Sales Opportunity como Case ID, podemos analisar todo o ciclo de vida, medir as durações entre os estágios, identificar variações no processo e entender os fatores que levam a negócios ganhos ou perdidos. Por que isso importa Este é o identificador fundamental que conecta todas as etapas do processo, permitindo uma análise completa e precisa do ciclo de vendas de cada negócio. Onde obter Este é o campo padrão 'Id' do objeto Opportunity no Salesforce Sales Cloud, por exemplo, Opportunity.Id. Exemplos 0068c00001KvM7RAAV0068c00001LpA9BAAV0068c00001NqB3CAAV
	Estágio de vendas StageName	O estágio atual da oportunidade no pipeline de vendas, como 'Qualification' ou 'Negotiation'.
Descrição O estágio de vendas representa a evolução de uma oportunidade pelo processo de vendas predefinido. As alterações nesse campo são eventos importantes do processo, como 'Proposal Stage Reached'. Este atributo é fundamental para criar os Dashboards 'Sales Pipeline Bottleneck Identification' e 'Daily Sales Funnel Operational View'. Ele permite analisar quanto tempo as oportunidades permanecem em cada estágio, as taxas de conversão entre estágios e a saúde geral do pipeline de vendas. Por que isso importa Ele acompanha o avanço da oportunidade pelo funil de vendas, permitindo analisar gargalos e gerenciar o pipeline. Onde obter Este é o campo padrão 'StageName' do objeto Opportunity. Exemplos ProspecçãoQualificaçãoAnálise de necessidadesProposal/Price QuoteNegociação/revisão
	Foi ganho IsWon	Um indicador booleano que informa se a oportunidade foi ganha ou perdida.
Descrição Este atributo é um indicador simples, true ou false, do resultado final de uma oportunidade de vendas. Ele é definido como true quando o estágio da oportunidade é 'Closed Won' e como false quando é 'Closed Lost'. 'Is Won' é a base para calcular o KPI 'Opportunity Win Rate', uma das medidas mais importantes da eficácia de vendas. Ele também é usado para segmentar análises, por exemplo, comparando os caminhos de processo de negócios ganhos e perdidos ou calculando o 'Average Discount on Won Deals'. Por que isso importa Ele mede diretamente o resultado de uma oportunidade de vendas, permitindo analisar ganhos e perdas e calcular as taxas de vitória. Onde obter Este é o campo padrão 'IsWon' do objeto Opportunity. É um campo de fórmula baseado em StageName. Exemplos truefalse
	Percentual de desconto DiscountPercentage	O percentual de desconto aplicado à oportunidade.
Descrição Este atributo registra o desconto oferecido em um negócio, geralmente como percentual do preço total. Ele é um fator essencial para entender a rentabilidade dos negócios e o comportamento de vendas. Essa métrica é a base do Dashboard "Eficácia dos Descontos em Opportunities" e do KPI "Desconto Médio em Negócios Ganhos". Ao analisar esse atributo, as lideranças de vendas podem determinar se os descontos estão contribuindo para fechar negócios ou apenas reduzindo as margens, além de comparar o comportamento de concessão de descontos entre regiões ou representantes de vendas. Por que isso importa É essencial para analisar a rentabilidade, entender a eficácia da estratégia de preços e identificar a concessão excessiva de descontos. Onde obter Normalmente, este é um campo personalizado de moeda ou percentual no objeto Opportunity ou Quote. Consulte a documentação do Salesforce Sales Cloud ou o administrador. Exemplos 0.050.100.15
	Responsável pela Opportunity OpportunityOwner	O representante de vendas designado e responsável pela oportunidade de vendas.
Descrição O responsável pela Opportunity é o usuário do Salesforce que gerencia principalmente o negócio. Esta é uma dimensão importante para a análise de performance. Ao analisar os dados por responsável pela Opportunity, as organizações podem criar o Dashboard 'Sales Representative Performance'. Isso permite comparar tempos de ciclo, taxas de ganho e tamanhos médios de negócios entre diferentes membros do time, identificando os melhores desempenhos e oportunidades de desenvolvimento. Por que isso importa Este atributo é essencial para analisar a performance do time de vendas, comparar resultados individuais e identificar necessidades de desenvolvimento. Onde obter Este é o campo 'OwnerId' do objeto Opportunity, que faz a ligação com o objeto User. Exemplos John SmithMaria GarciaDavid Chen
	Valor da Opportunity Amount	O valor total estimado da venda da oportunidade.
Descrição Este atributo registra o valor monetário de um negócio potencial. É uma das métricas mais importantes para análises financeiras e de performance. O valor da Opportunity é usado em praticamente todas as visões financeiras, incluindo o cálculo do valor total do pipeline, do tamanho médio dos negócios e da correlação do valor com outros fatores, como descontos ou tempos de ciclo. Ele é um componente importante dos Dashboards 'Sales Representative Performance' e 'Opportunity Discount Effectiveness'. Por que isso importa Ele fornece o valor financeiro de cada negócio, essencial para relatórios do pipeline, projeções de receita e análises de performance. Onde obter Este é o campo padrão 'Amount' do objeto Opportunity. Exemplos 50000125000.75250000
	É retrabalho IsRework	Um indicador calculado que informa se uma atividade representa retrabalho ou uma etapa repetida.
Descrição Is Rework é um indicador booleano definido como true quando o processo retorna a uma etapa anterior. Por exemplo, se a atividade "Quote Modified" ocorrer depois de "Quote Presented to Customer", ela será considerada retrabalho. Este atributo é essencial para quantificar as ineficiências do processo. Ele dá suporte direto ao cálculo dos KPIs "Taxa de Erros no Processamento de Pedidos" e "Frequência de Retrabalho em Cotações". Destacar o retrabalho ajuda a localizar áreas com requisitos pouco claros, problemas de comunicação ou falhas de qualidade. Por que isso importa Quantifica as ineficiências do processo ao identificar e sinalizar atividades que fazem parte de ciclos de retrabalho, ajudando a direcionar os esforços de melhoria. Onde obter Este indicador é calculado pela ferramenta de Process Mining, que analisa a sequência de atividades e detecta movimentos de retorno no fluxo do processo. Exemplos truefalse
	ID da cotação QuoteId	O identificador exclusivo de uma cotação de vendas vinculada à oportunidade.
Descrição Quote ID identifica uma cotação de preço específica fornecida ao cliente para uma oportunidade. Uma oportunidade pode ter várias cotações ao longo do seu ciclo de vida. Acompanhar os Quote IDs é essencial para analisar a etapa de cotação do processo de vendas. Isso ajuda a medir o "Tempo de Ciclo de Quote a Contrato", entender quantas revisões de cotação ("Quote Modified") ocorreram e dar suporte ao KPI "Frequência de Retrabalho em Cotações", distinguindo as diferentes versões da cotação. Por que isso importa Este atributo ajuda a analisar o ciclo de cotação, incluindo o número de revisões e o tempo entre a cotação e a aceitação. Onde obter Este ID vem do campo "Id" do objeto Quote, que está relacionado à Opportunity. Exemplos 0Q08c000001OxP1AAK0Q08c000001PyQ2AAK0Q08c000001QzR3AAK
	ID do contrato ContractId	O identificador exclusivo do contrato associado à oportunidade.
Descrição Contract ID vincula a oportunidade a um registro de contrato formal no Salesforce. Essa é uma etapa importante da fase final de fechamento do negócio. Este atributo permite analisar detalhadamente a fase de contratação, dando suporte aos Dashboards "Tempo de Ciclo de Quote a Contrato" e "Conformidade e Adesão a Contratos". Ele permite acompanhar atividades como "Contract Sent for Signature" e "Contract Activated", além de medir sua duração e adesão aos SLAs. Por que isso importa Permite acompanhar com precisão o subprocesso de gestão de contratos, incluindo tempos de ciclo e conformidade. Onde obter Este ID vem do campo "Id" do objeto Contract, que normalmente está relacionado à Opportunity ou à Account. Exemplos 8008c000001LxD9AAK8008c000001MyE4AAK8008c000001NzF0AAK
	ID do pedido OrderId	O identificador exclusivo do pedido de vendas criado a partir de uma oportunidade ganha.
Descrição Order ID vincula uma oportunidade de vendas ao processo de atendimento posterior. Esse é o ponto de transição entre vendas e operações. Esse ID é essencial para estender a análise do processo além da etapa "Opportunity Closed Won" até a gestão de pedidos. Ele permite acompanhar as atividades "Order Created" e "Order Fulfilled" e é necessário para monitorar a "Taxa de Erros no Atendimento de Pedidos". Por que isso importa Conecta a parte de vendas do processo à etapa de atendimento do pedido, permitindo uma análise realmente ponta a ponta de Lead to Cash. Onde obter Este ID vem do campo "Id" do objeto Order, que geralmente está relacionado à Opportunity. Exemplos 8018c000001IyA6AAK8018c000001JyB1AAK8018c000001KzC6AAK
	Nome da Account AccountName	O nome da conta do cliente ou da empresa associada à oportunidade.
Descrição Account Name vincula a oportunidade de vendas a um cliente específico. Isso permite uma análise centrada no cliente do processo de vendas. Analisar o processo por cliente permite entender os ciclos de vendas de contas estratégicas, identificar clientes com retrabalho frequente ou longas fases de negociação e adaptar as estratégias de relacionamento. Esse atributo oferece uma dimensão valiosa para filtrar e detalhar os dados do processo. Por que isso importa Vincula o processo de vendas a um cliente específico, permitindo analisar os tempos do ciclo de vendas e os padrões de interação por cliente. Onde obter Este campo é derivado do campo de pesquisa "AccountId" no objeto Opportunity, que faz referência ao campo "Name" no objeto Account. Exemplos Global Tech Inc.Innovate Solutions LLCQuantum Industries
	Origem do Lead LeadSource	A origem do lead, como "Web", "Parceiro" ou "Feira".
Descrição Lead Source registra o canal de marketing ou a atividade de vendas que gerou o lead inicial. Essas informações são essenciais para entender a eficácia de diferentes estratégias de aquisição de clientes. Este atributo é a principal dimensão do Dashboard "Análise de Performance da Conversão de Leads". Ao analisar as taxas de conversão e os valores dos negócios por origem do lead, as empresas podem otimizar os investimentos em marketing e priorizar os canais mais rentáveis. Por que isso importa Ajuda a determinar a eficácia dos canais de marketing, relacionando os leads às suas origens e às respectivas taxas de sucesso. Onde obter Este é o campo padrão "LeadSource" no objeto Lead, normalmente transferido para o objeto Opportunity após a conversão. Exemplos WebConsulta por telefoneIndicação de parceiroLista comprada
	Região Region	A região geográfica ou o território de vendas da oportunidade.
Descrição O atributo Region segmenta as oportunidades por localização geográfica, como "América do Norte", "EMEA" ou "APAC". Essa é uma forma comum de as organizações de vendas estruturarem suas equipes e seus relatórios. Essa é a principal dimensão do Dashboard "Comparação da Performance de Vendas por Região". Ela permite que a liderança compare a performance dos processos entre regiões, identificando boas práticas nas áreas de alto desempenho e oportunidades de melhoria nas demais. A análise pode abranger tempos de ciclo, taxas de ganho e uso de descontos. Por que isso importa Permite comparar processos de vendas e performance entre diferentes territórios geográficos para identificar pontos fortes e fragilidades regionais. Onde obter Geralmente, este é um campo personalizado no objeto Opportunity ou Account. Consulte a documentação do Salesforce Sales Cloud ou o administrador. Exemplos América do NorteEMEAAPACLATAM
	Sistema de origem SourceSystem	Identifica o sistema de origem do qual os dados foram extraídos.
Descrição Este atributo especifica o sistema de registro em que os dados do evento foram originados. Para o processo de Lead to Cash, normalmente será 'Salesforce Sales Cloud'. Em ambientes com vários sistemas integrados, este campo é essencial para a linhagem dos dados, a solução de problemas e o entendimento de qual sistema é a fonte oficial de cada etapa do processo. Ele garante clareza e confiança na base de dados. Por que isso importa Ele fornece contexto sobre a origem dos dados, algo essencial para a governança e a validação dos dados, especialmente em ambientes com vários sistemas. Onde obter Normalmente, este é um valor estático adicionado durante o processo de extração e transformação dos dados para identificar a origem do conjunto de dados. Exemplos Salesforce Sales CloudSFSC
	Tipo de Opportunity Type	Classifica a oportunidade, por exemplo, como "Novo negócio" ou "Cliente existente".
Descrição Opportunity Type é um campo de classificação padrão usado para segmentar negócios. Isso ajuda a entender as diferenças entre os processos ou ciclos de vendas para conquistar novos clientes e fazer upsell para clientes existentes. No Process Mining, este atributo permite uma análise comparativa. Por exemplo, uma organização pode filtrar o mapa de processo para verificar se o ciclo de vendas de "Novo negócio" é mais longo ou tem mais etapas do que o ciclo de renovação de "Cliente existente". Essas informações orientam decisões estratégicas e iniciativas de otimização de processos. Por que isso importa Segmentar as oportunidades por tipo permite comparar diferentes processos de vendas, tempos de ciclo e taxas de sucesso entre negócios novos e existentes. Onde obter Este é o campo padrão "Type" no objeto Opportunity. Exemplos Novo negócioCliente existente, upgradeCliente existente, renovaçãoNegócio adicional
	Última atualização dos dados LastDataUpdate	O timestamp que indica quando os dados foram atualizados pela última vez no sistema de origem.
Descrição Este atributo mostra a data e a hora da extração de dados mais recente do Salesforce Sales Cloud. Ele fornece aos usuários contexto sobre o nível de atualização dos dados que estão analisando. Saber quando os dados foram atualizados pela última vez é essencial para interpretar a análise corretamente, especialmente em Dashboards operacionais, como o 'Daily Sales Funnel Operational View'. Isso garante que as decisões sejam baseadas em uma compreensão da atualidade dos dados. Por que isso importa Informa aos usuários o nível de atualização dos dados, garantindo que saibam quão atual é a análise do processo. Onde obter Este é um atributo de metadados gerado pelo pipeline de dados ou pela ferramenta de ETL no momento da extração. Exemplos 2023-10-27T02:00:00Z2023-10-28T02:00:00Z

Obrigatório Recomendado Opcional

Atividades de Lead to Cash

Estas são as principais etapas e os marcos do processo que devem ser acompanhados, permitindo uma descoberta precisa do processo e uma análise de performance.

8 Recomendado 8 Opcional

	Atividade	Descrição
	Contract ativado	Esta atividade indica que um contrato foi totalmente executado e assinado por todas as partes, tornando-se legalmente válido. Normalmente, isso é registrado como uma alteração de status no objeto Contract para 'Activated'.
Por que isso importa Esta é a confirmação final de um acordo jurídico com o cliente, um marco essencial para o reconhecimento da receita e a Conformidade. Atrasos nessa etapa podem impactar diretamente as projeções financeiras. Onde obter Inferido a partir da alteração do campo Status do objeto Contract para 'Activated'. O timestamp dessa alteração é capturado pelo acompanhamento do histórico de campos. Captura Identifique o timestamp em que o campo 'Status' do objeto Contract é definido como 'Activated'. Tipo de evento inferred
	Lead convertido em Opportunity	Esta atividade marca o momento em que um lead qualificado é convertido em uma oportunidade de vendas, junto com uma conta e um contato associados. Normalmente, essa é uma ação explícita realizada por um representante de vendas no Salesforce.
Por que isso importa Esta é a transferência crucial do marketing ou desenvolvimento de leads para o time de vendas. Analisar o tempo e as taxas de conversão a partir desse ponto ajuda a avaliar a qualidade dos leads e a eficiência do processo inicial de vendas. Onde obter Este evento pode ser identificado quando o campo IsConverted do objeto Lead é true e o campo ConvertedOpportunityId está preenchido. O timestamp é o ConvertedDate. Captura Registrado quando um usuário converte um registro de Lead, preenchendo os campos ConvertedDate e ConvertedOpportunityId. Tipo de evento explicit
	Opportunity criada	Representa a criação de um novo registro de oportunidade de vendas no Salesforce, indicando um negócio com potencial de gerar receita. Este evento é registrado explicitamente com um timestamp de criação quando o registro é salvo pela primeira vez.
Por que isso importa Esta atividade marca o início oficial do ciclo de vendas de uma determinada oportunidade. Ela serve como ponto de partida para medir o tempo total do ciclo de vendas e a velocidade do pipeline. Onde obter Capturado no campo de sistema CreatedDate do objeto Opportunity. Isso fornece um timestamp preciso de quando o registro da oportunidade foi iniciado. Captura Use o campo CreatedDate do objeto Opportunity. Tipo de evento explicit
	Opportunity fechada como ganha	Representa o fechamento bem-sucedido de um negócio de vendas, em que a oportunidade é ganha. Isso ocorre por meio de uma atualização manual ou automática do campo StageName da Opportunity para 'Closed Won'.
Por que isso importa Este é um dos principais resultados de sucesso do processo de vendas. Analisar as tendências e os atributos dos negócios ganhos é fundamental para entender a performance e a estratégia de vendas. Onde obter Inferido a partir da alteração do campo StageName do objeto Opportunity para 'Closed Won'. A data desse evento é capturada no campo CloseDate e o timestamp, no histórico de campos. Captura Identifique no OpportunityFieldHistory o timestamp em que 'StageName' da Opportunity se torna 'Closed Won'. Tipo de evento inferred
	Opportunity fechada como perdida	Representa o fechamento malsucedido de um negócio de vendas, quando a oportunidade é perdida para um concorrente ou o cliente decide não comprar. Isso é registrado quando StageName da Opportunity é atualizado para 'Closed Lost'.
Por que isso importa Este é o principal resultado de insucesso. Analisar quando e por que os negócios são perdidos é essencial para melhorar a estratégia de vendas, o treinamento e o posicionamento do produto. Onde obter Inferido a partir da alteração do campo StageName do objeto Opportunity para 'Closed Lost'. A data é registrada no campo CloseDate e o timestamp, no histórico de campos. Captura Identifique no OpportunityFieldHistory o timestamp em que 'StageName' da Opportunity se torna 'Closed Lost'. Tipo de evento inferred
	Pagamento recebido	Esta atividade confirma que o pagamento do cliente foi recebido e aplicado à invoice. Normalmente, ela é inferida pela alteração do status de uma invoice para 'Paid' ou pela criação de um registro Payment.
Por que isso importa Esta é a atividade final do processo de Lead to Cash, representando a realização da receita. A duração entre a invoice e o pagamento é um KPI crítico do fluxo de caixa. Onde obter Inferido a partir da alteração do status de um objeto Invoice para 'Paid' ou da criação de um objeto Payment vinculado à invoice. Esses dados geralmente vêm de um sistema financeiro externo. Captura Identifique quando o campo 'Status' da Invoice se torna 'Paid' ou quando um registro Payment relacionado é criado. Tipo de evento inferred
	Quote aceita pelo cliente	Esta atividade marca a concordância do cliente com os termos e preços de uma cotação. Normalmente, ela é capturada quando um usuário atualiza o status da Quote para 'Accepted'.
Por que isso importa Este é um forte sinal de compra e um marco importante antes da geração do contrato. O tempo entre a apresentação e a aceitação é um indicador importante do atrito no ciclo de vendas. Onde obter Inferido a partir da alteração do campo Status do objeto Quote para 'Accepted'. O timestamp é obtido pelo histórico dessa alteração de campo. Captura Identifique o timestamp em que o campo 'Status' da Quote muda para 'Accepted'. Tipo de evento inferred
	Quote criada	Esta atividade representa a geração de um documento formal de cotação de preço para o cliente. Ela é capturada quando um novo registro de Quote é criado e vinculado à Opportunity.
Por que isso importa A criação de uma cotação é uma etapa importante para fechar um negócio. Analisar o número de cotações e o tempo necessário para criá-las ajuda a avaliar a eficiência do time de vendas e o ritmo do negócio. Onde obter Capturado no campo de sistema CreatedDate do objeto Quote. O objeto Quote tem uma relação de consulta com sua Opportunity principal. Captura Use o CreatedDate do objeto Quote associado à Opportunity. Tipo de evento explicit
	Contrato enviado para assinatura	Indica que um contrato formal foi gerado e enviado ao cliente para assinatura. Muitas vezes, isso é inferido por uma alteração de status no objeto Contract, por exemplo, para 'Sent' ou 'Out for Signature'.
Por que isso importa Esta atividade inicia a fase jurídica e administrativa final do fechamento de um negócio. Acompanhar esse momento ajuda a monitorar a eficiência do processo de gestão de contratos. Onde obter Inferido a partir de uma alteração de status no objeto Contract, que está vinculado à Opportunity. É necessário acompanhar o histórico do campo Status do Contract. Captura Identifique o timestamp em que o campo 'Status' do Contract muda para um valor como 'Sent for Signature'. Tipo de evento inferred
	Estágio da Opportunity alterado	Esta atividade captura qualquer alteração no estágio de vendas de uma oportunidade, como a mudança de 'Qualification' para 'Needs Analysis'. Essas alterações são registradas no histórico de campos do sistema, fornecendo um histórico da evolução da oportunidade.
Por que isso importa Acompanhar as mudanças de estágio é essencial para entender a velocidade do pipeline de vendas, identificar gargalos onde os negócios ficam parados e analisar a conformidade do processo. Onde obter Inferido do objeto OpportunityFieldHistory, que acompanha as alterações no campo StageName do objeto Opportunity. Cada entrada tem um timestamp e os valores antigo e novo. Captura Extraia os eventos de alteração do campo 'StageName' da tabela OpportunityFieldHistory. Tipo de evento inferred
	Estágio de proposta alcançado	Marca o momento específico em que uma oportunidade passa para o estágio 'Proposal/Price Quote'. Isso é inferido a partir do histórico do campo 'StageName' da Opportunity.
Por que isso importa Este é um marco importante, indicando que uma solução potencial foi identificada e está pronta para ser precificada e apresentada. É um ponto crítico para analisar o tempo gasto na definição da solução e na elaboração da cotação. Onde obter Inferido do objeto OpportunityFieldHistory, especificamente pela identificação do timestamp em que o campo 'StageName' foi atualizado para 'Proposal/Price Quote' ou para um valor de estágio personalizado semelhante. Captura Filtre OpportunityFieldHistory pelos registros em que 'Field' é 'StageName' e 'NewValue' corresponde ao estágio de proposta. Tipo de evento inferred
	Invoice gerada	Representa a criação de uma invoice para cobrar do cliente pelos produtos ou serviços entregues. Isso pode ser capturado pela criação de um registro Invoice, no Salesforce Billing ou em um sistema externo integrado.
Por que isso importa Esta atividade inicia a parte financeira do ciclo de Lead to Cash. A velocidade e a precisão do faturamento impactam diretamente o fluxo de caixa. Onde obter Requer o Salesforce Billing ou um pacote semelhante. Capturado no campo CreatedDate do objeto Invoice, relacionado ao Order ou à Account. Captura Use o CreatedDate do objeto Invoice, se disponível. Tipo de evento explicit
	Order atendido	Indica que os produtos ou serviços de um pedido foram entregues ao cliente. Normalmente, esse evento é inferido por uma alteração no campo Status do objeto Order para um estado final, como 'Fulfilled' ou 'Completed'.
Por que isso importa Este marco indica a conclusão da promessa de entrega ao cliente. O tempo entre a criação do pedido e o atendimento é uma métrica importante da eficiência operacional e da satisfação do cliente. Onde obter Inferido a partir da alteração do campo Status do objeto Order para um valor de conclusão. É necessário acompanhar o histórico de campos para capturar o timestamp do evento. Captura Identifique o timestamp em que o campo 'Status' do Order muda para 'Fulfilled' ou 'Completed'. Tipo de evento inferred
	Order criada	Esta atividade marca a criação de um pedido de vendas, iniciando formalmente o processo de atendimento depois que um negócio é ganho. Ela é capturada quando um novo registro Order é criado e associado à Opportunity ou à Account.
Por que isso importa Esta é a transferência oficial do processo de vendas para o time de atendimento do pedido e operações. A eficiência dessa etapa é essencial para garantir a entrega no prazo e a satisfação do cliente. Onde obter Capturado no campo de sistema CreatedDate do objeto Order. Normalmente, o Order está vinculado à Account e/ou à Opportunity de origem. Captura Use o CreatedDate do objeto Order relacionado à Account da Opportunity. Tipo de evento explicit
	Quote apresentada ao cliente	Este evento indica que uma cotação foi enviada ou apresentada formalmente ao cliente para análise. Normalmente, ele é inferido por uma alteração de status no registro Quote, por exemplo, de 'Draft' para 'Presented' ou 'In Review'.
Por que isso importa Esta atividade inicia a contagem do tempo dos ciclos de negociação e aprovação do cliente. Acompanhar esse momento ajuda a medir os tempos de resposta dos clientes e identificar atrasos na fase de aceitação da cotação. Onde obter Inferido a partir das alterações no campo Status do objeto Quote. O histórico desse campo precisa ser acompanhado para obter o timestamp específico da alteração. Captura Identifique o timestamp em que o campo 'Status' da Quote muda para 'Presented', 'Sent' ou um valor semelhante. Tipo de evento inferred
	Quote modificada	Representa uma atualização ou revisão de uma cotação existente, geralmente após feedback ou negociação com o cliente. Isso é capturado acompanhando as alterações nos principais campos do registro Quote depois da criação inicial.
Por que isso importa Alterações frequentes nas cotações podem indicar ineficiências, falhas de comunicação ou ciclos de negociação prolongados. Analisar esse loop de retrabalho é essencial para reduzir a fase de Quote para Contract. Onde obter Inferido do campo LastModifiedDate do objeto Quote ou, de forma mais detalhada, do acompanhamento do histórico de campos como TotalPrice ou itens de linha. Captura Compare LastModifiedDate com CreatedDate no objeto Quote ou use o acompanhamento do histórico de campos da Quote. Tipo de evento inferred

Recomendado Opcional

Guias de extração

Como obter seus dados do Salesforce Sales Cloud

Etapas

Verifique os pré-requisitos: rastreamento do histórico de campos: antes de começar, confirme com o administrador do Salesforce se o Field History Tracking está habilitado para os campos principais dos seguintes objetos: Opportunity (StageName, Valor), Quote (Status), Contract (Status) e Order (Status). Isso é essencial para capturar as mudanças do processo com precisão.
Acesse os relatórios do Salesforce: faça login na sua instância do Salesforce. Use o App Launcher para localizar e abrir a aba 'Reports'. Clique no botão 'New Report' para começar.
Crie o relatório do histórico de oportunidades: esse relatório capturará a criação da Opportunity, as mudanças de etapa e os eventos de fechamento. Selecione o tipo de relatório 'Opportunities with Field History'. Adicione as seguintes colunas: ID da Opportunity, Nome da Opportunity, Data de criação, Campo/Evento, Valor anterior, Novo valor, Data da edição e Editado por. Adicione também os atributos recomendados: Proprietário, Valor, Ganha e quaisquer campos de desconto aplicáveis.
Crie o relatório de conversão de leads: crie um segundo relatório usando o tipo de relatório 'Leads'. Adicione as colunas: ID do Lead, Data de conversão, ID da Opportunity convertida e Proprietário do Lead. Aplique um filtro para exibir apenas leads em que 'Converted' seja verdadeiro.
Crie o relatório de eventos de cotações: crie um terceiro relatório usando um tipo de relatório 'Quotes', de preferência um que inclua o histórico, se disponível, como 'Quotes with Field History'. Adicione as colunas: ID da Citação, ID da Opportunity, CreatedDate, LastModifiedDate e Status. Esse relatório será usado para derivar a criação da Citação e as mudanças de status.
Crie relatórios adicionais (contratos, pedidos e faturas): seguindo o mesmo padrão do relatório de cotações, crie relatórios separados para Contracts, Orders e Invoices, se esses objetos forem usados na sua instância do Salesforce. Em cada um, inclua o ID do registro, o ID da Opportunity relacionada, CreatedDate, LastModifiedDate e o campo Status do objeto.
Execute e exporte todos os relatórios: em cada relatório criado, defina um filtro de intervalo de datas consistente, por exemplo, 'Opportunity Created Date' nos últimos 6 meses. Execute cada relatório e use a função 'Export' para salvar os resultados como um arquivo CSV.
Combine os dados em uma planilha: abra um aplicativo de planilhas, como o Microsoft Excel. Copie os dados de cada arquivo CSV exportado para uma aba separada dentro de uma única pasta de trabalho.
Crie a aba final do Event Log: crie uma nova aba chamada 'Event Log'. Defina os cabeçalhos obrigatórios: SalesOpportunity, ActivityName, EventTimestamp, e os cabeçalhos recomendados: OpportunityOwner, StageName, Valor, IsWon, DiscountPercentage.
Transforme e consolide os dados: preencha manualmente a aba 'Event Log' processando os dados das abas de origem. Para cada linha de origem, crie uma linha correspondente no Event Log. Por exemplo, para uma linha da aba de histórico de Opportunity em que 'New Value' seja 'Closed Won', crie uma linha no Event Log com ActivityName definido como 'Opportunity Closed Won' e EventTimestamp definido como 'Edit Date'. Repita esse processo para todas as 16 atividades obrigatórias em todos os arquivos de origem.
Faça a formatação final e exporte: garanta que a coluna EventTimestamp esteja formatada de maneira consistente, como YYYY-MM-DD HH:MI:SS. A coluna SalesOpportunity deve ser preenchida em todas as linhas, usando o ID da Opportunity dos relatórios de origem. Salve essa aba 'Event Log' final e consolidada como um arquivo CSV para carregamento.

Configuração

Tipos de relatório: o principal tipo de relatório necessário é "Opportunities with Field History". Também serão necessários relatórios para Leads, Quotes, Contracts, Orders e Invoices. A disponibilidade de tipos de relatório com histórico para esses objetos melhora significativamente a precisão dos dados.
Field History Tracking: deve ser pré-configurado por um administrador do Salesforce. Ele é essencial para acompanhar alterações em Opportunity Stage, Quote Status, Contract Status e Order Status.
Permissões: o usuário que executa os relatórios precisa ter acesso de leitura a todos os objetos relevantes: Lead, Account, Opportunity, OpportunityFieldHistory, Quote, Contract, Order e, possivelmente, Invoice e Payment.
Filtro de período: é essencial aplicar um filtro de período consistente em todos os relatórios para garantir a correlação dos dados. Recomenda-se filtrar "Opportunity Created Date" pelos últimos 3 a 6 meses para manter o volume de dados sob controle.
Volume de dados: em organizações com volumes muito altos de oportunidades e atividades, o Report Builder pode ficar lento ou atingir os limites de exportação, normalmente cerca de 100.000 linhas, dependendo da edição. Nesses casos, o Data Export Service semanal é uma alternativa mais robusta para obter os dados brutos.

a Consulta de exemplo 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]

Etapas

Pré-requisitos: verifique se você tem uma conta de usuário do Salesforce com acesso à API e permissões suficientes para ler os objetos Opportunity, Lead, Citação, Contract, Pedido e Fatura, além dos respectivos objetos de histórico de campos. O Field History Tracking deve estar habilitado para os campos principais, como StageName e Status, nesses objetos.
Selecione uma ferramenta de execução: esta consulta usa cláusulas UNION ALL, que não são compatíveis com o Developer Console ou o Workbench nativos do Salesforce. Você precisa usar uma ferramenta externa capaz de se conectar ao Salesforce e executar consultas no estilo SQL, como uma ferramenta de Business Intelligence (BI), por exemplo, Tableau ou Power BI; uma ferramenta de ETL, como MuleSoft ou Informatica; ou uma ferramenta de consulta de dados com um conector do Salesforce, como DBeaver ou DataGrip.
Estabeleça a conexão com o Salesforce: configure a conexão com sua instância do Salesforce na ferramenta escolhida. Normalmente, você precisará do nome de usuário, da senha e do token de segurança. Use a opção de conector Salesforce (API).
Prepare a consulta: copie a consulta SOQL completa fornecida na seção query deste documento para o editor de consultas da ferramenta.
Configure os placeholders: a consulta contém vários placeholders que você precisa substituir por valores específicos da sua organização do Salesforce. Eles incluem:
- 'YYYY-MM-DDThh:mm:ssZ': substitua todas as ocorrências pelas datas inicial e final desejadas para o período de extração, usando o formato ISO 8601.
- [Your_Discount_Field__c]: substitua pelo nome da API do seu campo personalizado de percentual de desconto no objeto Opportunity.
- [Quote_Presented_Status]: substitua pelo valor de status usado quando uma cotação é apresentada ao cliente, como 'Presented' ou 'In Review'.
- [Opportunity_Lookup_On_Contract__c]: substitua pelo nome da API do campo de pesquisa no objeto Contract que faz a ligação com a Opportunity.
- [Order_Fulfilled_Status]: substitua pelo valor de status que indica que um pedido foi atendido, como 'Fulfilled', 'Shipped' ou 'Completed'.
- [Opportunity_Lookup_On_Invoice__c]: substitua pelo nome da API do campo de pesquisa no objeto Invoice que faz a ligação com a Opportunity.
Execute a consulta: execute a consulta SOQL completa. Dependendo do volume de dados e da ferramenta usada, isso pode levar vários minutos.
Revise os resultados: quando a consulta for concluída, verifique o conjunto de dados retornado para garantir que ele contenha linhas para todas as atividades e que as colunas estejam preenchidas conforme esperado.
Trate possíveis erros: se a consulta falhar, verifique se há erros de digitação nos nomes dos placeholders substituídos. Garanta que o usuário tenha acesso de segurança em nível de campo a todos os campos consultados. A consulta também pode atingir o tempo limite ou os limites de governança se o intervalo de datas for muito grande. Nesse caso, tente reduzi-lo para um período menor, como um único trimestre.
Exporte os dados: exporte o conjunto de resultados final como um arquivo CSV.
Prepare o carregamento: garanta que os cabeçalhos do arquivo CSV correspondam aos atributos obrigatórios: SalesOpportunity, ActivityName, EventTimestamp, OpportunityOwner, StageName, Valor, IsWon e DiscountPercentage. O arquivo estará pronto para ser carregado em uma ferramenta de Process Mining.

Configuração

Field History Tracking: esta extração depende essencialmente de o Field History Tracking estar habilitado nos objetos Opportunity (StageName), Quote (Status), Contract (Status) e Order (Status). Sem ele, as atividades de alteração de status e etapa não serão capturadas.
Permissões do usuário: o usuário que executa a consulta deve ter acesso à API e permissões de leitura para todos os objetos consultados: Lead, Opportunity, OpportunityFieldHistory, Quote, QuoteHistory, Contract, ContractHistory, Order, OrderHistory, Invoice e InvoiceHistory.
Período: é essencial definir um período específico usando os placeholders 'YYYY-MM-DDThh:mm:ssZ'. Para a análise inicial, recomenda-se um período de 3 a 6 meses, equilibrando o volume de dados e a performance. Em instâncias muito grandes do Salesforce, comece com um período menor, como um mês, para testar a performance e possíveis problemas com limites de governança.
Campos e status personalizados: a consulta usa placeholders para campos personalizados, como [Your_Discount_Field__c], e valores de status personalizados, como [Quote_Presented_Status]. Você deve identificar os nomes corretos da API e os valores na configuração do Salesforce e atualizar a consulta de acordo.
Disponibilidade dos objetos: a consulta pressupõe o uso dos objetos padrão Contract e Order, além de um objeto Invoice, comum no Salesforce Billing. Se sua organização não usar esses objetos ou utilizar outro pacote de faturamento, essas partes da consulta falharão ou não retornarão dados e deverão ser removidas ou adaptadas.

a Consulta de exemplo 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

Etapas

Prepare o ambiente: verifique se o Python 3.6 ou uma versão mais recente está instalado no seu sistema. Você também precisará do pip, o instalador de pacotes do Python, para instalar as bibliotecas necessárias.
Instale as bibliotecas necessárias: abra a linha de comando ou o terminal e instale as bibliotecas simple-salesforce e pandas executando o comando: pip install simple-salesforce pandas.
Configure o acesso à API do Salesforce: faça login na sua conta do Salesforce com um perfil de administrador. Acesse Setup, depois Apps e App Manager. Crie um novo 'Connected App'. Habilite as configurações de OAuth para o aplicativo e conceda o escopo 'Access and manage your data (api)'. Depois de salvar, você receberá uma 'Consumer Key' e um 'Consumer Secret'. Verifique também se a conta de usuário do script tem um Security Token. Você pode gerar ou redefinir esse token nas suas configurações pessoais, em 'Reset My Security Token'.
Configure o script Python: copie o script Python completo fornecido na seção Query para um arquivo chamado extract_lead_to_cash.py.
Insira suas credenciais: abra o arquivo do script e substitua os valores de placeholder de username, password, security_token e instance_url pelas suas credenciais específicas do Salesforce. Não inclua credenciais diretamente no código em um ambiente de produção. Use um método seguro, como variáveis de ambiente ou um arquivo de configuração.
Defina o período de extração: altere as variáveis start_date e end_date no script para definir a janela de tempo dos dados que você deseja extrair. Use o formato 'YYYY-MM-DD'.
Entenda a lógica do script: o script se conecta à API do Salesforce e executa uma série de consultas Salesforce Object Query Language (SOQL). Cada consulta tem como alvo um objeto específico, como Opportunity, OpportunityFieldHistory ou Citação, para capturar uma atividade de negócio distinta.
Agregue os dados: os resultados de cada consulta são convertidos em um formato estruturado chamado pandas DataFrame. Esses DataFrames individuais, cada um representando uma atividade, são reunidos em uma única lista.
Transforme e formate os dados: o script concatena todos os DataFrames individuais em um Event Log abrangente. Ele renomeia as colunas para corresponder ao esquema obrigatório de Process Mining, como SalesOpportunity, ActivityName e EventTimestamp, e garante que os tipos de dados estejam corretos.
Execute o script: execute o script no terminal usando o comando: python extract_lead_to_cash.py. O script se conectará ao Salesforce, executará as consultas e processará os dados.
Recupere o Event Log: após a conclusão bem-sucedida, o script gerará um arquivo chamado sfdc_lead_to_cash_event_log.csv no mesmo diretório. Esse arquivo CSV é o Event Log final, formatado para ser carregado em uma ferramenta de Process Mining.

Configuração

Pré-requisitos: uma conta do Salesforce nas edições Enterprise, Unlimited ou Developer, que oferecem acesso à API. Um perfil de usuário do Salesforce com a permissão "API Enabled" e acesso de leitura aos seguintes objetos: Lead, Opportunity, OpportunityFieldHistory, Quote, Contract e Order. Objetos personalizados usados para faturamento ou pagamentos também exigirão acesso de leitura.
Autenticação: o script usa autenticação por nome de usuário, senha e token de segurança. Para aumentar a segurança em um ambiente de produção, considere implementar o OAuth 2.0 JWT Bearer Flow, que também é compatível com simple-salesforce.
Período: as variáveis start_date e end_date no script controlam o intervalo de extração. Para a análise inicial, recomenda-se um período de 3 a 6 meses, que oferece dados suficientes sem gerar um volume excessivo. Os filtros de data são aplicados ao campo de timestamp principal de cada atividade, como CreatedDate ou ConvertedDate.
Uso da API: este script executa várias consultas distintas. Cada consulta e a busca subsequente de todos os resultados consomem chamadas de API, contabilizadas nos limites diários da sua organização. Fique atento a esses limites, especialmente em ambientes com muitas outras integrações. Para extrair milhões de registros, o script deve ser adaptado para usar a Salesforce Bulk API.
Personalizações: sempre que possível, o script pressupõe nomes padrão de objetos e campos. Sua organização pode ter campos personalizados, como Discount_Percentage__c, objetos personalizados, como Invoice__c e Payment__c, ou relacionamentos personalizados, como uma pesquisa de Contract para Opportunity. Você deve ajustar as consultas SOQL no script para que correspondam à configuração específica do seu Salesforce.

a Consulta de exemplo 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()

Pronto para começar?

Use este Template para simplificar a preparação dos seus dados e aproveitar todo o potencial do Process Mining nas operações de Lead to Cash. Comece a otimizar sua eficiência hoje.

Voltar ao guia de melhoria Baixar Template

Pare de perder negócios: otimize seu Lead to Cash agora

Transforme seu Lead to Cash no Salesforce e alcance taxas de ganho 20% maiores.

Começar o teste grátis

Não é necessário cartão de crédito

Seu Template de dados de Lead to Cash

Seu Template de dados de Lead to Cash

Atributos de Lead to Cash

Atividades de Lead to Cash

Guias de extração

Report Builder e Data Export Service do Salesforce

Etapas

Configuração

a Consulta de exemplo sql

Consulta direta na Salesforce Object Query Language (SOQL)

Etapas

Configuração

a Consulta de exemplo sql

Script Python usando a Salesforce REST ou Bulk API

Etapas

Configuração

a Consulta de exemplo python

Pronto para começar?

Pare de perder negócios: otimize seu Lead to Cash agora

Seu Template de dados de Lead to Cash

Seu Template de dados de Lead to Cash

Atributos de Lead to Cash

Atividades de Lead to Cash

Guias de extração

Report Builder e Data Export Service do Salesforce

Etapas

Configuração

a Consulta de exemplo sql

Consulta direta na Salesforce Object Query Language (SOQL)

Etapas

Configuração

a Consulta de exemplo sql

Script Python usando a Salesforce REST ou Bulk API

Etapas

Configuração

a Consulta de exemplo python

Pronto para começar?

Pare de perder negócios: otimize seu Lead to Cash agora

Valorizamos sua privacidade