> Melhoria Contínua de Processos > Order to Cash Faturamento e Cobrança > Salesforce Sales Cloud > Modelo de Dados

Seu Template de Dados para Order to Cash - Faturamento e Cobrança

Salesforce Sales Cloud

Atributos de Order to Cash - Faturamento e Cobrança (20) Atividades de Order to Cash - Faturamento e Cobrança (13) Guias de Extração (3)

Seu Template de Dados para Order to Cash - Faturamento e Cobrança

Este template oferece uma visão completa dos dados e atividades necessários para analisar seu processo de faturamento. Ele detalha o que coletar para seu event log e como extrair esses dados, agilizando sua iniciativa de Process Mining.

Atributos recomendados para coletar
Atividades-chave a monitorizar
Orientação para Extração

É novo em event logs? Saiba como criar um event log para Process Mining.

Baixar Modelo

Atributos de Order to Cash - Faturamento e Cobrança

Estes são os campos recomendados para o seu event log para uma análise completa de Faturamento e Cobrança, garantindo que nenhum dado crítico fique de fora.

3 Obrigatório 5 Recomendado 12 Opcional

	Nome	Descrição
	Nome da Atividade ActivityName	O nome do evento de negócio específico ocorrido no processo de faturamento.
Descrição Este atributo descreve a etapa alcançada, como 'Fatura Gerada' ou 'Pagamento Recebido'. Essas atividades formam os pontos do mapa de processo. A análise da sequência de Atividades revela o fluxo real. Ela permite identificar desvios, gargalos e retrabalhos, alimentando relatórios de conformidade e erros no faturamento. Por que é importante Define as etapas do processo, formando a espinha dorsal do mapa de processos e permitindo a análise de workflow, gargalos e desvios. Onde obter Geralmente derivado de mudanças no campo Status ou de registros em objetos como Tarefas ou Eventos que rastreiam ações. Exemplos Fatura geradaFatura AprovadaFatura Enviada ao ClientePagamento Recebido
	Número da fatura InvoiceNumber	O identificador exclusivo de cada fatura, usado como ID principal do caso no processo de faturamento.
Descrição O Número da Fatura é o atributo central que agrupa todas as atividades relacionadas em um único caso. No Process Mining, ele permite o rastreamento de ponta a ponta do ciclo de vida da fatura, da geração ao pagamento final. É essencial para montar o mapa do processo e calcular KPIs como 'Tempo Médio de Ciclo' e 'DSO'. Analisar por número de fatura ajuda a identificar gargalos, loops de retrabalho e desvios de conformidade em cada caso individual. Por que é importante Chave essencial para unir todos os eventos e permitir uma visão completa do faturamento para cada transação única. Onde obter Costuma ser a chave primária da fatura no Salesforce, como o `InvoiceNumber` ou ID único similar. Exemplos INV-00582INV-01934INV-10345
	Tempo do Evento EventTime	O timestamp que indica o momento em que uma atividade específica ocorreu.
Descrição Este atributo fornece a data e hora de cada atividade, essencial para ordenar os eventos e analisar a performance. O Tempo do Evento é a base para calcular métricas como tempos de ciclo, espera e duração de tarefas. Ele alimenta KPIs como 'Ciclo Médio de Fatura' e 'DSO', além de Dashboards de aprovação e conciliação. Por que é importante Essencial para ordenar eventos e calcular métricas de performance e atrasos. Onde obter Estes dados geralmente vêm de campos de data automáticos do sistema, como `CreatedDate` ou `LastModifiedDate`. Exemplos 2023-04-15T10:00:00Z2023-04-16T14:30:00Z2023-05-20T09:05:12Z
	Data de Vencimento do Pagamento PaymentDueDate	A data limite para o cliente pagar a fatura.
Descrição Define o prazo final para pagamento, calculado com base na data da fatura e nos termos acordados. É um dado crítico para planejamento financeiro. Serve de base para medir a performance de recebimento, calcular a 'Taxa de Pagamento em Dia' e monitorar a tendência do DSO. Por que é importante Referência para medir a performance de pagamento, calcular DSO e disparar ações de cobrança. Onde obter Campo de data padrão no Salesforce, geralmente chamado de `DueDate`. Exemplos 2023-05-152023-06-302023-07-01
	Departamento de Faturamento BillingDepartment	O departamento ou equipe responsável pela atividade de faturamento.
Descrição Especifica o grupo funcional (Contas a Receber, Operações de Vendas, etc.) do usuário responsável. Analisar por departamento é crucial para entender quem é o dono do processo e identificar problemas sistêmicos. É usado para comparar a eficiência e o uso de recursos entre diferentes áreas no Dashboard de performance. Por que é importante Permite analisar o desempenho por equipe ou departamento, ajudando a identificar gargalos específicos, falta de recursos ou necessidades de treinamento. Onde obter Geralmente armazenado no objeto User do Salesforce, em campos como `Department` ou `Role.Name`. Exemplos Contas a ReceberOperações FinanceirasEquipe de Cobrança
	Status da Fatura InvoiceStatus	O status atual da fatura em seu ciclo de vida.
Descrição Reflete o estado atual da fatura (Rascunho, Aguardando Aprovação, Enviada, Paga, etc.). O Status da Fatura é vital para segmentação. Permite focar em grupos específicos, como faturas pendentes ou rejeitadas, ajudando a priorizar esforços e entender por que alguns casos ficam travados. Por que é importante Oferece um retrato claro do estado atual de uma fatura, permitindo filtrar e analisar casos abertos, fechados ou problemáticos. Onde obter Geralmente é um campo de lista padrão chamado `Status` no objeto de Fatura do Salesforce. Exemplos Aguardando AprovaçãoAprovadoEnviado ao ClientePagoBaixada
	Usuário Responsável UserResponsible	O usuário ou agente que realizou a atividade.
Descrição Identifica o usuário do Salesforce que realizou a ação (aprovação, lançamento, etc.). Analisar pelo Responsável é essencial para entender o desempenho da equipe e a distribuição de carga de trabalho. Ajuda no dashboard de performance do time e na identificação de necessidades de treinamento ou causas raiz de atrasos. Por que é importante Permite analisar o desempenho individual e da equipe, equilibrar a carga de trabalho e identificar talentos ou necessidades de treinamento. Onde obter Pode ser encontrado em campos como `LastModifiedById` no objeto Invoice ou `OwnerId` em Tarefas. Esses IDs devem ser cruzados com o objeto User para obter o nome. Exemplos Alice JohnsonBob WilliamsCharlie Brown
	Valor Total da Fatura InvoiceTotalAmount	O valor monetário total da fatura.
Descrição Representa o valor total devido pelo cliente. É uma métrica financeira central em cada caso. Analisar pelo Valor Total ajuda a priorizar faturas maiores e entender se o valor influencia o tempo de aprovação ou atrasos. Isso é crucial para gerir riscos e focar os esforços de cobrança onde o impacto financeiro é maior. Por que é importante Permite analisar o impacto financeiro, ajudando a priorizar faturas de alto valor e entender como o montante influencia o processo, como em atrasos ou tempos de aprovação. Onde obter Provavelmente um campo de moeda padrão, como `GrandTotal` ou similar. Exemplos 5400.5012500.00850.75
	Condições de Pagamento PaymentTerms	As condições de pagamento acordadas, como '30 Dias' ou 'Pagamento na Entrega'.
Descrição Este atributo define as regras de quando e como uma fatura deve ser paga, ditando o vencimento e possíveis descontos. Analisar pelos Termos de Pagamento ajuda a entender como os acordos afetam o comportamento do cliente. É vital para o dashboard de 'Uso de Descontos por Antecipação', identificando oportunidades financeiras perdidas e explicando variações nos ciclos de pagamento. Por que é importante Fornece contexto para prazos de pagamento e é essencial para analisar o comportamento dos clientes, DSO e a eficácia de programas de desconto por antecipação. Onde obter Provavelmente armazenado em um campo de lista ou texto no objeto de Fatura ou Conta no Salesforce. Exemplos Líquido 30Líquido 602% 10, Net 30Vencimento no Recebimento
	Days Sales Outstanding DaysSalesOutstanding	O número de dias entre o envio da fatura e o recebimento do pagamento.
Descrição O Days Sales Outstanding (DSO) é uma métrica financeira crítica que mede o tempo médio de recebimento após uma venda. É calculado como o intervalo entre os eventos 'Fatura Enviada ao Cliente' e 'Pagamento Recebido'. Este KPI é o foco principal do processo de Order-to-Cash, e este atributo o torna disponível para cada fatura individual. Ele alimenta o dashboard de tendência de DSO e é essencial para monitorar o fluxo de caixa. Por que é importante KPI crucial para medir a eficácia da cobrança e seu impacto direto no fluxo de caixa da empresa. Onde obter Atributo calculado como: `(Timestamp('Recebimento do Pagamento') - Timestamp('Envio da Fatura'))`. Exemplos 32 dias58 dias29 dias
	É Pagamento em Atraso IsLatePayment	Um sinalizador calculado que indica se o pagamento foi recebido após a data de vencimento.
Descrição Atributo booleano que compara a data de recebimento com o vencimento. Indica se o pagamento foi atrasado ou não. Esta flag facilita a análise do comportamento do cliente e a eficácia da cobrança. É a base da 'Taxa de Pagamento em Dia', ajudando a segmentar clientes bons pagadores dos inadimplentes de forma binária. Por que é importante Fornece uma métrica clara de sucesso na cobrança e suporta a análise de fatores que levam a atrasos. Onde obter Atributo calculado no ETL ou na ferramenta de Process Mining comparando a data de pagamento com o campo `PaymentDueDate`. Exemplos verdadeirofalse
	É Retrabalho IsRework	Um sinalizador calculado que indica se uma fatura passou por um loop de retrabalho.
Descrição Atributo booleano definido se houver evidência de retrabalho (ex: fatura corrigida após aprovação). Fundamental para medir a ineficiência. Alimenta a 'Taxa de Retrabalho' e o Dashboard de erros, permitindo isolar casos que geram loops de trabalho repetitivo e caro. Por que é importante Esta flag quantifica a ineficiência identificando loops de correção, ajudando a achar a origem dos erros e calcular o custo da falta de qualidade. Onde obter Este atributo não existe no sistema de origem; é calculado pela ferramenta de Process Mining ou no ETL com base na sequência de atividades. Exemplos verdadeirofalse
	Event End Time EventEndTime	O timestamp que indica quando uma atividade foi concluída.
Descrição Registra o término da atividade. Em faturamento, muitos eventos são instantâneos, mas aprovações podem ter duração mensurável. Ter o Horário de Término permite calcular o tempo real de processamento (mão na massa), diferenciando-o do tempo de espera e dando uma visão clara da eficiência operacional. Por que é importante Permite o cálculo preciso dos tempos de processamento das atividades, separando o trabalho ativo do tempo de espera para uma análise de eficiência fiel. Onde obter Muitas vezes não é um campo padrão. Pode ser necessário derivá-lo do horário inicial da atividade seguinte ou capturá-lo em um campo customizado. Exemplos 2023-04-15T10:05:00Z2023-04-16T14:32:10Z2023-05-20T09:05:12Z
	Moeda da Fatura InvoiceCurrency	O código da moeda do valor da fatura, como BRL, USD ou EUR.
Descrição Indica a moeda da fatura, fundamental para empresas globais. Oferece contexto para análises financeiras, permitindo a soma correta de valores e comparação entre diferentes moedas sem misturar os dados, garantindo KPIs financeiros precisos. Por que é importante Fornece o contexto necessário para valores monetários, garantindo análises financeiras precisas em relatórios, especialmente em operações multinacionais. Onde obter Geralmente o campo padrão `CurrencyIsoCode`, disponível em ambientes Salesforce com multi-moeda. Exemplos USDEURGBPJPY
	Nome do Cliente CustomerName	O nome do cliente ou conta que está sendo faturada.
Descrição Este atributo identifica o cliente faturado, vindo do registro da Conta no Salesforce. Analisar por cliente ajuda a entender comportamentos específicos e proteger contas estratégicas. Revela se certos clientes atrasam pagamentos sistematicamente ou exigem mais retrabalho, ajudando a ajustar a régua de cobrança e o relacionamento. Por que é importante Permite análises focadas no cliente para identificar padrões, como quais clientes costumam atrasar pagamentos ou exigem mais correções de faturas, melhorando a gestão do relacionamento. Onde obter Vem do campo `Account.Name`, vinculado à Fatura por um relacionamento de busca (lookup). Exemplos ABC CorporationGlobal Tech Inc.Innovate Solutions LLC
	País de Faturamento BillingCountry	O país especificado no endereço de cobrança da fatura.
Descrição Este atributo identifica o país de cobrança do cliente. É uma dimensão geográfica fundamental para segmentar os dados. Analisar por país ajuda a identificar variações regionais de performance e conformidade. Pode revelar se certas regiões têm ciclos de pagamento mais longos ou regras regulatórias específicas, auxiliando na padronização global e otimização local. Por que é importante Permite análises geográficas para identificar variações regionais no desempenho, requisitos de conformidade e comportamentos de pagamento. Onde obter Parte do campo de endereço composto no Salesforce, geralmente `BillingCountry`. Exemplos EUAAlemanhaJapãoBrasil
	Proprietário da Conta AccountOwner	O representante de vendas ou gerente de conta responsável pelo cliente.
Descrição Este atributo identifica o dono da conta (vendedor ou gerente de conta) no Salesforce. Embora não faturem diretamente, problemas no faturamento afetam a relação comercial. Este campo conecta a performance do processo ao lado comercial, permitindo ver se carteiras específicas sofrem mais com problemas de faturamento. Por que é importante Conecta o desempenho do processo de faturamento ao responsável comercial pela conta, ajudando a entender o impacto financeiro de erros ou atrasos na emissão de faturas. Onde obter Campo `Owner.Name` do objeto Conta, relacionado à Fatura. Exemplos David MillerSophia GarciaJames Wilson
	Sistema de Origem SourceSystem	Identifica o sistema de origem dos dados.
Descrição Identifica de qual aplicativo veio o dado, geralmente 'Salesforce Sales Cloud'. Em cenários com vários sistemas, este campo é vital para rastreabilidade e suporte, garantindo que eventos de origens diferentes sejam mesclados e interpretados corretamente. Por que é importante Fornece contexto crucial sobre a origem dos dados, algo essencial para governança, validação e análise em ambientes com múltiplos sistemas. Onde obter Geralmente é um valor estático adicionado durante o processo de extração, transformação e carga (ETL) para rotular a origem do conjunto de dados. Exemplos Salesforce Sales CloudSFSC
	Tempo de Ciclo da Fatura InvoiceCycleTime	O tempo total decorrido desde a geração da fatura até o seu fechamento.
Descrição Mede a duração total do processo para uma fatura, do início ao fechamento. É o principal KPI de eficiência geral. Usado para monitorar o 'Tempo Médio de Ciclo' e no panorama de ponta a ponta. Reduzir este tempo acelera a conversão de caixa. Por que é importante KPI que mede a eficiência de ponta a ponta, impactando diretamente o ciclo de conversão de caixa. Onde obter Métrica calculada subtraindo o horário do primeiro evento do último no Process Mining. Exemplos 25 dias e 4 horas45 dias 12 horas60 dias 2 horas
	Última Atualização de Dados LastDataUpdate	Timestamp da última atualização de dados do sistema de origem.
Descrição Indica quando os dados foram extraídos do Salesforce pela última vez. É vital para saber o quão atuais são os Dashboards e KPIs, permitindo que as decisões de negócio sejam tomadas com base em informações recentes. Por que é importante Informa os usuários sobre a atualidade dos dados, garantindo que as decisões sejam tomadas com base em uma visão recente e relevante do processo. Onde obter Valor gerado e gravado no dataset pelo ETL ou pipeline de dados em cada execução. Exemplos 2023-10-27T02:00:00Z2023-10-28T02:00:00Z

Obrigatório Recomendado Opcional

Atividades de Order to Cash - Faturamento e Cobrança

Estes são os marcos e etapas essenciais para capturar no seu event log para uma descoberta precisa do processo e avaliação de performance.

5 Recomendado 8 Opcional

	Atividade	Descrição
	Fatura Aprovada	Um usuário autorizado revisou e aprovou a fatura, confirmando sua precisão e prontidão para envio. Esse evento geralmente ocorre quando o status muda para 'Aprovado'.
Por que é importante Marco que trava o resto do processo. Atrasos aqui geram gargalos que afetam o DSO e o ciclo total, monitorados no dashboard de aprovação. Onde obter Inferido pela mudança do status da Fatura para 'Aprovado'. Se forem usados Processos de Aprovação do Salesforce, isso pode ser extraído do histórico do objeto ProcessInstance. Captura Mudança no campo de status da fatura para 'Aprovado' ou conclusão de uma etapa formal de aprovação. Tipo de evento inferred
	Fatura Encerrada	O ciclo da fatura terminou, com pagamento total e conciliação concluída. É a etapa final de um processo bem-sucedido, marcada pela atualização do status.
Por que é importante Esta atividade é o ponto final principal do processo, permitindo o cálculo preciso do ciclo de ponta a ponta. Onde obter Inferido pelo timestamp de quando o status da fatura muda para 'Fechado', 'Pago' ou estado terminal similar. Captura Mudança no campo de status da fatura para um valor final de 'Fechado'. Tipo de evento inferred
	Fatura Enviada ao Cliente	A fatura aprovada foi enviada ao cliente por e-mail, correio ou portal. O evento ocorre quando o campo 'Data de Envio' é preenchido ou o status muda para 'Enviado'.
Por que é importante Inicia o período de cobrança e o cálculo do DSO. É um marco crítico para rastrear a comunicação com o cliente e prazos de pagamento. Onde obter Inferido pelo preenchimento do campo 'Data de Envio' ou mudança de status para 'Enviado'. Também pode ser um evento no Histórico de Atividades. Captura Data e hora quando o campo 'Sent_Date__c' é preenchido. Tipo de evento inferred
	Fatura gerada	Esta atividade marca a criação de uma nova fatura no Salesforce. É o início oficial do faturamento, disparado após a entrega do pedido ou marco contratual. O evento usa a data de criação do registro.
Por que é importante Evento inicial do processo. Analisar o tempo daqui até o pagamento ajuda a medir o ciclo O2C e achar atrasos na entrada de dados. Onde obter Este evento é capturado da data de criação (campo CreatedDate) do objeto de Fatura ou similar no Salesforce. Captura Data e hora de criação do objeto da fatura. Tipo de evento explicit
	Pagamento do cliente recebido	O cliente pagou a fatura e os fundos foram recebidos. Geralmente é registrado criando um registro de 'Pagamento' vinculado à fatura.
Por que é importante Marco mais importante do recebimento. É o ponto final para o cálculo do DSO e indica o sucesso na entrada da receita. Onde obter Capturado a partir da data de criação de um objeto personalizado 'Pagamento' relacionado à Fatura. Também pode ser inferido pela mudança de status da fatura para 'Pago'. Captura Criação de um registro de Pagamento relacionado. Tipo de evento explicit
	Caixa Aplicado/Conciliado	O pagamento foi totalmente conciliado e aplicado à fatura específica no sistema, baixando o título a receber.
Por que é importante Marca o fim do ciclo de conversão de caixa. É usado para medir a eficiência do time financeiro na aplicação de recursos. Onde obter Inferido por uma mudança de status na Fatura ou Pagamento para um estado terminal como 'Conciliado' ou 'Aplicado'. Captura Mudança no status da fatura ou do pagamento para 'Conciliado'. Tipo de evento inferred
	Fatura Baixada (Write-off)	Foi tomada a decisão de cancelar a dívida e a fatura é encerrada sem o pagamento integral. Representa um fim alternativo e sem sucesso para o processo de cobrança.
Por que é importante Rastrear baixas (write-offs) quantifica perdas e identifica clientes que geram dívidas incobráveis, protegendo a saúde financeira. Onde obter Inferido pelo timestamp de quando o status da fatura muda para 'Baixado' ou 'Cancelado - Dívida Incobrável'. Captura Mudança no campo de status da fatura para 'Baixado'. Tipo de evento inferred
	Fatura Corrigida	Representa uma correção manual em uma fatura após rejeição ou erro. Geralmente é identificado quando o status volta para um estado anterior, como de 'Rejeitado' para 'Rascunho'.
Por que é importante Identificar loops de correção é vital para medir a Taxa de Retrabalho de Faturas. Volumes altos de correção indicam problemas na geração inicial da fatura que causam atrasos. Onde obter Inferido pelo rastreamento de histórico, detectando a volta do status de uma fase avançada (ex.: 'Aprovado') para uma inicial (ex.: 'Rascunho'). Captura O status da fatura retrocede no fluxo do processo. Tipo de evento inferred
	Fatura Enviada para Aprovação	A fatura foi finalizada e enviada para revisão interna. Esta atividade costuma ser capturada pela mudança de status, de 'Rascunho' para 'Aguardando Aprovação'.
Por que é importante Rastrear isto ajuda a isolar o tempo na fila de aprovação e calcular o tempo médio de aprovação. Onde obter Inferido pelo histórico de campo quando o status é atualizado para 'Enviado para Aprovação' ou 'Em Revisão'. Captura Mudança no campo de status da fatura para 'Pendente de Aprovação'. Tipo de evento inferred
	Fatura Rejeitada	Um aprovador rejeitou a fatura, geralmente devido a erros ou discrepâncias, exigindo correção e reenvio. Isso é capturado por uma mudança de status no registro para 'Rejeitado'.
Por que é importante Esta atividade indica retrabalho e ineficiência. Analisar as rejeições ajuda a identificar fontes de erro e alimenta o Dashboard de 'Erros e Retrabalho no Faturamento'. Onde obter Inferido pela mudança do status da Fatura para 'Rejeitado'. Esses dados também podem estar nos comentários do histórico de aprovação. Captura Mudança no campo de status da fatura para 'Rejeitado'. Tipo de evento inferred
	Lembrete de Pagamento Emitido	Uma comunicação foi enviada ao cliente para lembrá-lo de um pagamento próximo ou em atraso. Geralmente é registrada como uma Atividade (Tarefa ou E-mail) vinculada à fatura.
Por que é importante Rastrear lembretes ajuda a avaliar as estratégias de cobrança e alimenta KPIs de eficácia de lembretes. Onde obter Capturado pela criação de um registro de Atividade (Tarefa ou E-mail) relacionado à Fatura, onde o assunto indica um lembrete de pagamento. Captura Criação de um registro de Tarefa ou E-mail com tipo ou assunto específico. Tipo de evento explicit
	Pagamento Lançado no Razão	O pagamento recebido foi registrado formalmente no sistema contábil ou razão da empresa, geralmente após uma integração de dados.
Por que é importante Esta atividade separa o recebimento do pagamento da conciliação financeira. O tempo entre um e outro revela atrasos na contabilidade interna. Onde obter Inferido por uma mudança no campo de status do Pagamento ou Fatura para um valor como 'Lançado' ou 'Exportado para o ERP', geralmente via API. Captura Mudança no status do pagamento ou fatura para 'Lançado'. Tipo de evento inferred
	Vencimento do Pagamento Atingido	Evento calculado que representa o momento do vencimento conforme os termos. Não é uma ação humana, mas um dado derivado.
Por que é importante Esta atividade é o benchmark para analisar o comportamento de pagamento e medir o KPI de 'Taxa de Pagamento em Dia'. Onde obter Evento calculado que compara o horário atual com o campo 'Due Date'. Não existe como evento gravado no Salesforce. Captura Calculado comparando a data atual com o campo de Data de Vencimento da fatura. Tipo de evento calculated

Recomendado Opcional

Guias de Extração

Como extrair seus dados do Salesforce Sales Cloud

Etapas

Verificação de Pré-requisitos: Garanta que você tenha as permissões no Salesforce para "Executar relatórios", "Criar e personalizar relatórios" e "Exportar relatórios". Verifique se o Rastreamento de Histórico de Campo está ativo para os campos de status nos objetos de Fatura e Pagamento (Configuração > Gerenciador de Objetos > Campos e Relacionamentos > Definir Rastreamento de Histórico).
Defina a Estratégia de Relatórios: Você precisará criar vários relatórios, pois as atividades vêm de registros diferentes (ex.: criação de fatura, mudanças de status, pagamentos). Você criará um relatório para cada fonte e depois combinará os resultados.
Relatório para Criação de Registros: Comece pelos eventos simples. Crie um relatório para 'Fatura Gerada' e 'Pagamento Recebido'. Na aba Relatórios, clique em "Novo Relatório" e escolha um tipo que inclua o objeto Fatura ou Pagamento. Adicione as colunas dos atributos do event log. Para 'Fatura Gerada', a CreatedDate será o seu EventTime.
Relatório para Histórico de Campos: Para capturar mudanças como 'Fatura Enviada para Aprovação', 'Fatura Aprovada' ou 'Rejeitada', use o tipo de relatório "Histórico de Faturas". Ele mostra as alterações rastreadas. Filtre este relatório pelas mudanças no campo Status.
Relatório para Eventos Baseados em Data: Para eventos como 'Fatura Enviada ao Cliente' ou 'Vencimento Atingido', use campos de data específicos, como Sent_Date__c ou Payment_Due_Date__c, como seu EventTime. Filtre para que esses campos não fiquem vazios.
Relatório para Atividades Relacionadas: Para 'Lembrete de Pagamento Emitido', crie um relatório que ligue Atividades (Tarefas ou Eventos) às Faturas. Filtre por atividades com assunto ou tipo que indique um lembrete de cobrança.
Padronize as Colunas: Em todos os relatórios, garanta que as colunas correspondam à estrutura do event log: InvoiceNumber, um campo para EventTime (como data de criação ou da alteração), UserResponsible (ex.: LastModifiedById) e outros atributos úteis.
Exportar para CSV: Execute cada relatório. Na tela de resultados, selecione "Exportar" e escolha o formato "Somente Detalhes" com extensão .csv. Faça isso para todos os relatórios.
Combinar e Transformar Dados: Abra os CSVs em uma planilha ou ferramenta de preparação de dados. Adicione uma coluna ActivityName e preencha com a atividade correspondente (ex.: "Fatura Gerada"). Mapeie as colunas de origem para os cabeçalhos padrão do event log.
Criar o Event Log Final: Consolide todos os dados transformados em um único arquivo mestre. Garanta que os cabeçalhos sejam exatamente InvoiceNumber, ActivityName, EventTime, UserResponsible, etc.
Formatação Final: Salve o arquivo consolidado como CSV com codificação UTF-8. O arquivo agora está pronto para ser carregado no ProcessMind.

Configuração

Tipos de Relatório: Você provavelmente precisará de vários tipos de relatórios personalizados para unir objetos pai, como Conta (Account), com objetos filhos e netos, como Fatura (Invoice), Pagamento (Payment) e Atividade (Activity). Crie-os em Configuração > Tipos de Relatório.
Rastreamento de Histórico de Campo: Isso é fundamental. Para o objeto Fatura, ative o rastreamento de histórico para qualquer campo de Status. Sem isso, você não conseguirá capturar atividades de mudança de status como "Aprovado" ou "Rejeitado". O histórico não é rastreado retroativamente.
Filtros de Dados: Sempre aplique um filtro de data aos seus relatórios para manter o volume de dados sob controle. Uma boa prática é filtrar a data de criação do objeto principal pelos últimos 3 a 6 meses (ex.: Invoice: Created Date igual a LAST 180 DAYS).
Serviço de Exportação de Dados: Como alternativa à execução de relatórios individuais, você pode usar o Serviço de Exportação de Dados nativo (Configuração > Exportação de dados). Este serviço exporta todos os dados da sua organização semanal ou mensalmente. Isso fornece um backup completo, mas exige um pós-processamento significativo para filtrar, unir e transformar os dados em um event log.
Permissões de Usuário: O usuário que realiza a extração precisa de acesso de leitura a todos os objetos relevantes (ex.: Conta, Pedido, Invoice__c, Payment__c, Atividade) e campos, além de permissões para criação e exportação de relatórios.

a Consulta de Exemplo config

// This is a configuration guide for building multiple Salesforce reports.
// The data from these separate CSV exports must be manually combined and transformed into a single event log.

// Report 1: Invoice Generated
// Report Type: Invoices (or your custom invoice object report type)
// Filters: 
// 1. Created Date GREATER OR EQUAL [Start Date]
// 2. Created Date LESS OR EQUAL [End Date]
// Columns to Export & Map:
// - Invoice Number -> InvoiceNumber
// - 'Invoice Generated' (static text) -> ActivityName
// - Created Date -> EventTime
// - Created By -> UserResponsible
// - [Billing Department Field] -> BillingDepartment
// - Status -> InvoiceStatus
// - Total Amount -> InvoiceTotalAmount
// - Payment Due Date -> PaymentDueDate

// Report 2: Invoice Status Changes (Submitted, Approved, Rejected, Corrected, Closed, Written Off)
// Report Type: Invoice History (or your custom object's history report type)
// Filters:
// 1. Edit Date GREATER OR EQUAL [Start Date]
// 2. Edit Date LESS OR EQUAL [End Date]
// 3. Field/Event EQUALS 'Status' (or the name of your status field)
// Columns to Export & Map:
// - Invoice Number -> InvoiceNumber
// - New Value (transformed*) -> ActivityName 
// - Edit Date -> EventTime
// - Edited By -> UserResponsible
// - [Billing Department Field] -> BillingDepartment
// - New Value -> InvoiceStatus
// - [Invoice Total Amount] -> InvoiceTotalAmount
// - [Invoice Payment Due Date] -> PaymentDueDate
// *Transformation Logic for ActivityName: 
//   - IF New Value = 'Pending Approval' THEN 'Invoice Submitted for Approval'
//   - IF New Value = 'Approved' THEN 'Invoice Approved'
//   - IF New Value = 'Rejected' THEN 'Invoice Rejected'
//   - IF New Value = 'Draft' AND Old Value = 'Rejected' THEN 'Invoice Corrected'
//   - IF New Value = 'Closed' THEN 'Invoice Closed'
//   - IF New Value = 'Written Off' THEN 'Invoice Written Off'

// Report 3: Invoice Sent to Customer
// Report Type: Invoices
// Filters:
// 1. [Sent Date Field] NOT EQUAL TO "" (not null)
// 2. [Sent Date Field] GREATER OR EQUAL [Start Date]
// 3. [Sent Date Field] LESS OR EQUAL [End Date]
// Columns to Export & Map:
// - Invoice Number -> InvoiceNumber
// - 'Invoice Sent to Customer' (static text) -> ActivityName
// - [Sent Date Field] -> EventTime
// - Last Modified By -> UserResponsible
// - [Billing Department Field] -> BillingDepartment
// - Status -> InvoiceStatus
// - Total Amount -> InvoiceTotalAmount
// - Payment Due Date -> PaymentDueDate

// Report 4: Payment Due Date Reached
// Report Type: Invoices
// Filters:
// 1. Payment Due Date NOT EQUAL TO "" (not null)
// 2. Payment Due Date GREATER OR EQUAL [Start Date]
// 3. Payment Due Date LESS OR EQUAL [End Date]
// Columns to Export & Map:
// - Invoice Number -> InvoiceNumber
// - 'Payment Due Date Reached' (static text) -> ActivityName
// - Payment Due Date -> EventTime
// - 'System' (static text) -> UserResponsible
// - [Billing Department Field] -> BillingDepartment
// - Status -> InvoiceStatus
// - Total Amount -> InvoiceTotalAmount
// - Payment Due Date -> PaymentDueDate

// Report 5: Payment Reminder Issued
// Report Type: Activities with Invoices (or similar custom report type)
// Filters:
// 1. Task or Event Subject CONTAINS 'Payment Reminder'
// 2. Created Date GREATER OR EQUAL [Start Date]
// 3. Created Date LESS OR EQUAL [End Date]
// Columns to Export & Map:
// - Invoice: Invoice Number -> InvoiceNumber
// - 'Payment Reminder Issued' (static text) -> ActivityName
// - Created Date -> EventTime
// - Assigned To -> UserResponsible
// - [Billing Department Field] -> BillingDepartment
// - [Invoice Status Field] -> InvoiceStatus
// - [Invoice Total Amount] -> InvoiceTotalAmount
// - [Invoice Payment Due Date] -> PaymentDueDate

// Report 6: Customer Payment Received & Status Changes (Posted, Applied)
// Report Type: Payments with Invoices (or similar custom report type)
// This report combines multiple events from the Payment record.
// Filters:
// 1. Payment: Created Date GREATER OR EQUAL [Start Date]
// 2. Payment: Created Date LESS OR EQUAL [End Date]
// Part A: Payment Received
// Columns to Export & Map:
// - Invoice: Invoice Number -> InvoiceNumber
// - 'Customer Payment Received' (static text) -> ActivityName
// - Payment: Created Date -> EventTime
// - Payment: Created By -> UserResponsible
// Part B: Payment Posted and Applied (Requires exporting and transforming multiple rows for the same payment if status changes)
// You may need a separate Payment History Report, similar to Report 2.
// Assuming a simple status field on the Payment for this example:
//   - IF Payment Status = 'Posted' THEN 'Payment Posted to Ledger'
//   - IF Payment Status = 'Applied' THEN 'Cash Applied/Reconciled'

Etapas

Pré-requisitos e Configuração: Certifique-se de ter o Python 3.6 ou superior instalado. Instale as bibliotecas necessárias executando o comando no terminal: pip install simple-salesforce pandas. Você também precisará do seu usuário, senha e token de segurança do Salesforce. Para obter o token, faça login no Salesforce, vá em suas configurações pessoais e procure a opção 'Redefinir meu token de segurança'.
Ativar Rastreamento de Histórico de Campo: Entre no Salesforce como administrador. Vá em Configuração e depois em Gerenciador de Objetos. Localize o objeto principal de Fatura, por exemplo, Invoice__c, e acesse 'Campos e Relacionamentos'. Clique em 'Definir Rastreamento de Histórico'. Ative o rastreamento para o campo que representa o status da fatura, como Status__c. Repita o processo para o objeto de Pagamento, por exemplo, Payment__c, e seu campo de status correspondente.
Baixar e Configurar o Script: Salve o script Python fornecido como extract_invoices.py. Abra o arquivo em um editor de texto e atualize os valores reservados na seção 'Salesforce Credentials and Settings'. Você deve informar seu SF_USERNAME, SF_PASSWORD, SF_SECURITY_TOKEN e SF_INSTANCE_URL. Ajuste START_DATE e END_DATE para definir o período de extração.
Customizar Nomes de Objetos e Campos: Revise as consultas SOQL no script. Ele usa nomes genéricos como Invoice__c, Payment__c, Status__c, Total_Amount__c, etc. Você deve substituí-los pelos nomes de API reais dos objetos e campos usados na sua instância do Salesforce para faturamento e cobrança.
Executar o Script de Extração: Abra o terminal, vá até o diretório onde salvou o script e execute: python extract_invoices.py. O script se conectará à API do Salesforce, executará as consultas e processará os dados.
Monitorar o Progresso: O script exibirá mensagens de status conforme busca e processa os dados de cada tipo de atividade. Dependendo do volume e dos limites de API, isso pode levar algum tempo. Fique atento a mensagens de erro que indiquem credenciais ou nomes de API incorretos.
Revisar o Arquivo de Saída: Após a conclusão, o script gerará o arquivo salesforce_billing_event_log.csv no mesmo diretório. Abra este CSV em uma planilha para conferir se ele contém os dados esperados.
Preparar para o Upload: O CSV gerado já está estruturado com as colunas necessárias: InvoiceNumber, ActivityName e EventTime, além de outros atributos recomendados. Este arquivo está pronto para ser carregado diretamente na ferramenta de Process Mining, sem necessidade de formatação extra.

Configuração

Credenciais do Salesforce: Você deve fornecer seu nome de usuário, senha e token de segurança do Salesforce. O token de segurança é necessário para o acesso à API de fora das faixas de IP confiáveis da sua organização.
URL da Instância do Salesforce: Especifique o domínio da sua instância do Salesforce, como sua_instancia.my.salesforce.com. Se você estiver usando uma sandbox, a URL será diferente, por exemplo, test.salesforce.com.
Filtros de Intervalo de Datas: O script inclui as variáveis START_DATE e END_DATE. Recomenda-se começar com um intervalo de datas menor, como 3 a 6 meses, para gerenciar o volume de dados e permanecer dentro dos limites da API. Essas datas filtram a consulta inicial para as datas de criação das faturas.
Nomes de API de Objetos e Campos: O script foi criado com nomes de API de espaços reservados para objetos e campos, por exemplo, Invoice__c e Status__c. Você deve substituí-los pelos nomes exatos da API do seu modelo de dados do Salesforce. Eles podem ser encontrados na Configuração do Salesforce, em Gerenciador de Objetos.
Pré-requisitos para Rastreamento: A precisão do event log, especialmente para mudanças de status, depende inteiramente de o Rastreamento de Histórico de Campo do Salesforce estar ativado para os campos relevantes antes de as transações ocorrerem. Se não estiver ativado, as alterações históricas não serão capturadas.
Limites de Chamadas de API: O Salesforce impõe limites de governança ao número de chamadas de API que você pode fazer em um período de 24 horas. Para conjuntos de dados muito grandes, considere executar a extração em lotes de intervalos de datas menores ou agendá-la fora dos horários de pico para evitar atingir esses limites.

a Consulta de Exemplo python

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

class=class="hl-string">"hl-comment"># --- Salesforce Credentials and Settings ---
class=class="hl-string">"hl-comment"># IMPORTANT: Replace all placeholder values with your actual Salesforce information.
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]' class=class="hl-string">"hl-comment"># Append this to your password if required
SF_INSTANCE_URL = class="hl-string">'https://[your_instance].my.salesforce.com' class=class="hl-string">"hl-comment"># e.g., na1.salesforce.com

class=class="hl-string">"hl-comment"># --- Extraction Period ---
START_DATE = class="hl-string">'2023-01-01T00:00:00Z'
END_DATE = class="hl-string">'2023-12-31T23:59:59Z'

class=class="hl-string">"hl-comment"># --- Object and Field API Name Placeholders ---
class=class="hl-string">"hl-comment"># Replace these with the actual API names from your Salesforce org.
INVOICE_OBJECT = class="hl-string">'Invoice__c'
INVOICE_NUMBER_FIELD = class="hl-string">'Name'
INVOICE_STATUS_FIELD = class="hl-string">'Status__c'
INVOICE_TOTAL_AMOUNT_FIELD = class="hl-string">'Total_Amount__c'
INVOICE_DUE_DATE_FIELD = class="hl-string">'Due_Date__c'

PAYMENT_OBJECT = class="hl-string">'Payment__c'
PAYMENT_INVOICE_LOOKUP_FIELD = class="hl-string">'Invoice__c' class=class="hl-string">"hl-comment"># Lookup field from Payment to Invoice
PAYMENT_STATUS_FIELD = class="hl-string">'Status__c'

class=class="hl-string">"hl-comment"># --- Main Script ---
def main():
    print(class="hl-string">"Connecting to Salesforce...")
    sf = Salesforce(username=SF_USERNAME, password=SF_PASSWORD, security_token=SF_SECURITY_TOKEN, instance_url=SF_INSTANCE_URL)
    print(class="hl-string">"Connection successful.")

    all_events = []

    class=class="hl-string">"hl-comment"># 1. Get base Invoice data
    print(class="hl-string">"Fetching base invoice data...")
    soql_invoices = fclass="hl-string">"""
        SELECT Id, {INVOICE_NUMBER_FIELD}, CreatedDate, CreatedById, LastModifiedById, 
               {INVOICE_STATUS_FIELD}, {INVOICE_TOTAL_AMOUNT_FIELD}, {INVOICE_DUE_DATE_FIELD}
        FROM {INVOICE_OBJECT}
        WHERE CreatedDate >= {START_DATE} AND CreatedDate <= {END_DATE}
    """
    invoices_data = sf.query_all(soql_invoices)[class="hl-string">'records']
    df_invoices = pd.DataFrame(invoices_data).drop(columns=[class="hl-string">'attributes'])
    invoice_ids = class="hl-string">"','".join(df_invoices[class="hl-string">'Id'].tolist())

    class=class="hl-string">"hl-comment"># Activity: Invoice Generated & Payment Due Date Reached
    print(class="hl-string">"Processing 'Invoice Generated' and 'Payment Due Date Reached' events...")
    generated_events = df_invoices.copy()
    generated_events[class="hl-string">'ActivityName'] = class="hl-string">'Invoice Generated'
    generated_events[class="hl-string">'EventTime'] = pd.to_datetime(generated_events[class="hl-string">'CreatedDate']).dt.tz_localize(None)
    generated_events[class="hl-string">'UserResponsible'] = generated_events[class="hl-string">'CreatedById']
    all_events.append(generated_events)

    due_date_events = df_invoices[df_invoices[INVOICE_DUE_DATE_FIELD].notna()].copy()
    due_date_events[class="hl-string">'ActivityName'] = class="hl-string">'Payment Due Date Reached'
    due_date_events[class="hl-string">'EventTime'] = pd.to_datetime(due_date_events[INVOICE_DUE_DATE_FIELD]).dt.tz_localize(None)
    due_date_events[class="hl-string">'UserResponsible'] = None class=class="hl-string">"hl-comment"># System-generated event
    all_events.append(due_date_events)

    class=class="hl-string">"hl-comment"># 2. Get Invoice Status Changes from Field History
    print(class="hl-string">"Fetching invoice status changes...")
    soql_invoice_history = fclass="hl-string">"""
        SELECT ParentId, Field, OldValue, NewValue, CreatedDate, CreatedById
        FROM {INVOICE_OBJECT}History
        WHERE ParentId IN ('{invoice_ids}') AND Field = '{INVOICE_STATUS_FIELD}'
    """
    invoice_history_data = sf.query_all(soql_invoice_history)[class="hl-string">'records']
    if invoice_history_data:
        df_invoice_history = pd.DataFrame(invoice_history_data).drop(columns=[class="hl-string">'attributes'])
        df_invoice_history = df_invoice_history.merge(df_invoices[[class="hl-string">'Id', INVOICE_NUMBER_FIELD, INVOICE_TOTAL_AMOUNT_FIELD, INVOICE_DUE_DATE_FIELD]], left_on=class="hl-string">'ParentId', right_on=class="hl-string">'Id')
        df_invoice_history[class="hl-string">'EventTime'] = pd.to_datetime(df_invoice_history[class="hl-string">'CreatedDate']).dt.tz_localize(None)
        df_invoice_history[class="hl-string">'UserResponsible'] = df_invoice_history[class="hl-string">'CreatedById']

        class=class="hl-string">"hl-comment"># Map status changes to Activity Names
        status_map = {
            (class="hl-string">'Draft', class="hl-string">'Pending Approval'): class="hl-string">'Invoice Submitted for Approval',
            (class="hl-string">'Pending Approval', class="hl-string">'Approved'): class="hl-string">'Invoice Approved',
            (class="hl-string">'Pending Approval', class="hl-string">'Rejected'): class="hl-string">'Invoice Rejected',
            (class="hl-string">'Rejected', class="hl-string">'Draft'): class="hl-string">'Invoice Corrected',
            (class="hl-string">'Approved', class="hl-string">'Sent'): class="hl-string">'Invoice Sent to Customer',
            (class="hl-string">'Approved', class="hl-string">'Closed'): class="hl-string">'Invoice Closed',
            (class="hl-string">'Sent', class="hl-string">'Closed'): class="hl-string">'Invoice Closed',
            (class="hl-string">'Approved', class="hl-string">'Written Off'): class="hl-string">'Invoice Written Off'
        }
        df_invoice_history[class="hl-string">'ActivityName'] = df_invoice_history.apply(lambda row: status_map.get((str(row[class="hl-string">'OldValue']), str(row[class="hl-string">'NewValue']))), axis=1)
        df_invoice_history.rename(columns={class="hl-string">'NewValue': INVOICE_STATUS_FIELD}, inplace=True)
        all_events.append(df_invoice_history.dropna(subset=[class="hl-string">'ActivityName']))

    class=class="hl-string">"hl-comment"># 3. Get Payment Reminders from Tasks
    print(class="hl-string">"Fetching payment reminder tasks...")
    soql_tasks = fclass="hl-string">"""
        SELECT WhatId, ActivityDate, CreatedById, CreatedDate
        FROM Task
        WHERE WhatId IN ('{invoice_ids}') AND Subject LIKE '%Payment Reminder%'
    """
    task_data = sf.query_all(soql_tasks)[class="hl-string">'records']
    if task_data:
        df_tasks = pd.DataFrame(task_data).drop(columns=[class="hl-string">'attributes'])
        df_tasks = df_tasks.merge(df_invoices[[class="hl-string">'Id', INVOICE_NUMBER_FIELD, INVOICE_STATUS_FIELD, INVOICE_TOTAL_AMOUNT_FIELD, INVOICE_DUE_DATE_FIELD]], left_on=class="hl-string">'WhatId', right_on=class="hl-string">'Id')
        df_tasks[class="hl-string">'ActivityName'] = class="hl-string">'Payment Reminder Issued'
        df_tasks[class="hl-string">'EventTime'] = pd.to_datetime(df_tasks[class="hl-string">'CreatedDate']).dt.tz_localize(None)
        df_tasks[class="hl-string">'UserResponsible'] = df_tasks[class="hl-string">'CreatedById']
        all_events.append(df_tasks)

    class=class="hl-string">"hl-comment"># 4. Get Payment Data
    print(class="hl-string">"Fetching payment data...")
    soql_payments = fclass="hl-string">"""
        SELECT Id, {PAYMENT_INVOICE_LOOKUP_FIELD}, CreatedDate, CreatedById, LastModifiedById, {PAYMENT_STATUS_FIELD}
        FROM {PAYMENT_OBJECT}
        WHERE {PAYMENT_INVOICE_LOOKUP_FIELD} IN ('{invoice_ids}')
    """
    payment_data = sf.query_all(soql_payments)[class="hl-string">'records']
    if payment_data:
        df_payments = pd.DataFrame(payment_data).drop(columns=[class="hl-string">'attributes'])
        df_payments = df_payments.merge(df_invoices[[class="hl-string">'Id', INVOICE_NUMBER_FIELD, INVOICE_TOTAL_AMOUNT_FIELD, INVOICE_DUE_DATE_FIELD]], left_on=PAYMENT_INVOICE_LOOKUP_FIELD, right_on=class="hl-string">'Id', suffixes=(class="hl-string">'_payment', class="hl-string">'_invoice'))
        payment_ids = class="hl-string">"','".join(df_payments[class="hl-string">'Id_payment'].tolist())
        
        class=class="hl-string">"hl-comment"># Activity: Customer Payment Received
        payment_received_events = df_payments.copy()
        payment_received_events[class="hl-string">'ActivityName'] = class="hl-string">'Customer Payment Received'
        payment_received_events[class="hl-string">'EventTime'] = pd.to_datetime(payment_received_events[class="hl-string">'CreatedDate']).dt.tz_localize(None)
        payment_received_events[class="hl-string">'UserResponsible'] = payment_received_events[class="hl-string">'CreatedById']
        all_events.append(payment_received_events)
        
        class=class="hl-string">"hl-comment"># 5. Get Payment Status Changes
        print(class="hl-string">"Fetching payment status changes...")
        soql_payment_history = fclass="hl-string">"""
            SELECT ParentId, Field, OldValue, NewValue, CreatedDate, CreatedById
            FROM {PAYMENT_OBJECT}History
            WHERE ParentId IN ('{payment_ids}') AND Field = '{PAYMENT_STATUS_FIELD}'
        """
        payment_history_data = sf.query_all(soql_payment_history)[class="hl-string">'records']
        if payment_history_data:
            df_payment_history = pd.DataFrame(payment_history_data).drop(columns=[class="hl-string">'attributes'])
            df_payment_history = df_payment_history.merge(df_payments[[class="hl-string">'Id_payment', INVOICE_NUMBER_FIELD, INVOICE_TOTAL_AMOUNT_FIELD, INVOICE_DUE_DATE_FIELD]], left_on=class="hl-string">'ParentId', right_on=class="hl-string">'Id_payment')
            df_payment_history[class="hl-string">'EventTime'] = pd.to_datetime(df_payment_history[class="hl-string">'CreatedDate']).dt.tz_localize(None)
            df_payment_history[class="hl-string">'UserResponsible'] = df_payment_history[class="hl-string">'CreatedById']

            payment_status_map = {
                (class="hl-string">'Received', class="hl-string">'Posted'): class="hl-string">'Payment Posted to Ledger',
                (class="hl-string">'Posted', class="hl-string">'Reconciled'): class="hl-string">'Cash Applied/Reconciled'
            }
            df_payment_history[class="hl-string">'ActivityName'] = df_payment_history.apply(lambda row: payment_status_map.get((str(row[class="hl-string">'OldValue']), str(row[class="hl-string">'NewValue']))), axis=1)
            df_payment_history.rename(columns={class="hl-string">'NewValue': INVOICE_STATUS_FIELD}, inplace=True)
            all_events.append(df_payment_history.dropna(subset=[class="hl-string">'ActivityName']))

    class=class="hl-string">"hl-comment"># --- Final Assembly ---
    print(class="hl-string">"Assembling final event log...")
    final_df = pd.concat(all_events, ignore_index=True)

    class=class="hl-string">"hl-comment"># Standardize column names
    final_df.rename(columns={
        INVOICE_NUMBER_FIELD: class="hl-string">'InvoiceNumber',
        INVOICE_STATUS_FIELD: class="hl-string">'InvoiceStatus',
        INVOICE_TOTAL_AMOUNT_FIELD: class="hl-string">'InvoiceTotalAmount',
        INVOICE_DUE_DATE_FIELD: class="hl-string">'PaymentDueDate'
    }, inplace=True)

    class=class="hl-string">"hl-comment"># Select and order columns for the final event log
    required_cols = {
        class="hl-string">'InvoiceNumber': None,
        class="hl-string">'ActivityName': None,
        class="hl-string">'EventTime': None,
        class="hl-string">'UserResponsible': None,
        class="hl-string">'InvoiceStatus': None,
        class="hl-string">'InvoiceTotalAmount': None,
        class="hl-string">'PaymentDueDate': None
    }
    for col in required_cols:
        if col not in final_df.columns:
            final_df[col] = required_cols[col]
    
    class=class="hl-string">"hl-comment"># We cannot extract Billing Department directly from this model, so we will add it as an empty column
    final_df[class="hl-string">'BillingDepartment'] = None

    final_df = final_df[list(required_cols.keys()) + [class="hl-string">'BillingDepartment']]

    class=class="hl-string">"hl-comment"># Sort by case and event time
    final_df.sort_values(by=[class="hl-string">'InvoiceNumber', class="hl-string">'EventTime'], inplace=True)

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

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

Etapas

Verificação de Pré-requisitos: Garanta que você tenha as permissões no Salesforce para "Executar relatórios", "Criar e personalizar relatórios" e "Exportar relatórios". Verifique se o Rastreamento de Histórico de Campo está ativo para os campos de status nos objetos de Fatura e Pagamento (Configuração > Gerenciador de Objetos > Campos e Relacionamentos > Definir Rastreamento de Histórico).
Defina a Estratégia de Relatórios: Você precisará criar vários relatórios, pois as atividades vêm de registros diferentes (ex.: criação de fatura, mudanças de status, pagamentos). Você criará um relatório para cada fonte e depois combinará os resultados.
Relatório para Criação de Registros: Comece pelos eventos simples. Crie um relatório para 'Fatura Gerada' e 'Pagamento Recebido'. Na aba Relatórios, clique em "Novo Relatório" e escolha um tipo que inclua o objeto Fatura ou Pagamento. Adicione as colunas dos atributos do event log. Para 'Fatura Gerada', a CreatedDate será o seu EventTime.
Relatório para Histórico de Campos: Para capturar mudanças como 'Fatura Enviada para Aprovação', 'Fatura Aprovada' ou 'Rejeitada', use o tipo de relatório "Histórico de Faturas". Ele mostra as alterações rastreadas. Filtre este relatório pelas mudanças no campo Status.
Relatório para Eventos Baseados em Data: Para eventos como 'Fatura Enviada ao Cliente' ou 'Vencimento Atingido', use campos de data específicos, como Sent_Date__c ou Payment_Due_Date__c, como seu EventTime. Filtre para que esses campos não fiquem vazios.
Relatório para Atividades Relacionadas: Para 'Lembrete de Pagamento Emitido', crie um relatório que ligue Atividades (Tarefas ou Eventos) às Faturas. Filtre por atividades com assunto ou tipo que indique um lembrete de cobrança.
Padronize as Colunas: Em todos os relatórios, garanta que as colunas correspondam à estrutura do event log: InvoiceNumber, um campo para EventTime (como data de criação ou da alteração), UserResponsible (ex.: LastModifiedById) e outros atributos úteis.
Exportar para CSV: Execute cada relatório. Na tela de resultados, selecione "Exportar" e escolha o formato "Somente Detalhes" com extensão .csv. Faça isso para todos os relatórios.
Combinar e Transformar Dados: Abra os CSVs em uma planilha ou ferramenta de preparação de dados. Adicione uma coluna ActivityName e preencha com a atividade correspondente (ex.: "Fatura Gerada"). Mapeie as colunas de origem para os cabeçalhos padrão do event log.
Criar o Event Log Final: Consolide todos os dados transformados em um único arquivo mestre. Garanta que os cabeçalhos sejam exatamente InvoiceNumber, ActivityName, EventTime, UserResponsible, etc.
Formatação Final: Salve o arquivo consolidado como CSV com codificação UTF-8. O arquivo agora está pronto para ser carregado no ProcessMind.

Configuração

Tipos de Relatório: Você provavelmente precisará de vários tipos de relatórios personalizados para unir objetos pai, como Conta (Account), com objetos filhos e netos, como Fatura (Invoice), Pagamento (Payment) e Atividade (Activity). Crie-os em Configuração > Tipos de Relatório.
Rastreamento de Histórico de Campo: Isso é fundamental. Para o objeto Fatura, ative o rastreamento de histórico para qualquer campo de Status. Sem isso, você não conseguirá capturar atividades de mudança de status como "Aprovado" ou "Rejeitado". O histórico não é rastreado retroativamente.
Filtros de Dados: Sempre aplique um filtro de data aos seus relatórios para manter o volume de dados sob controle. Uma boa prática é filtrar a data de criação do objeto principal pelos últimos 3 a 6 meses (ex.: Invoice: Created Date igual a LAST 180 DAYS).
Serviço de Exportação de Dados: Como alternativa à execução de relatórios individuais, você pode usar o Serviço de Exportação de Dados nativo (Configuração > Exportação de dados). Este serviço exporta todos os dados da sua organização semanal ou mensalmente. Isso fornece um backup completo, mas exige um pós-processamento significativo para filtrar, unir e transformar os dados em um event log.
Permissões de Usuário: O usuário que realiza a extração precisa de acesso de leitura a todos os objetos relevantes (ex.: Conta, Pedido, Invoice__c, Payment__c, Atividade) e campos, além de permissões para criação e exportação de relatórios.

a Consulta de Exemplo config

// This is a configuration guide for building multiple Salesforce reports.
// The data from these separate CSV exports must be manually combined and transformed into a single event log.

// Report 1: Invoice Generated
// Report Type: Invoices (or your custom invoice object report type)
// Filters: 
// 1. Created Date GREATER OR EQUAL [Start Date]
// 2. Created Date LESS OR EQUAL [End Date]
// Columns to Export & Map:
// - Invoice Number -> InvoiceNumber
// - 'Invoice Generated' (static text) -> ActivityName
// - Created Date -> EventTime
// - Created By -> UserResponsible
// - [Billing Department Field] -> BillingDepartment
// - Status -> InvoiceStatus
// - Total Amount -> InvoiceTotalAmount
// - Payment Due Date -> PaymentDueDate

// Report 2: Invoice Status Changes (Submitted, Approved, Rejected, Corrected, Closed, Written Off)
// Report Type: Invoice History (or your custom object's history report type)
// Filters:
// 1. Edit Date GREATER OR EQUAL [Start Date]
// 2. Edit Date LESS OR EQUAL [End Date]
// 3. Field/Event EQUALS 'Status' (or the name of your status field)
// Columns to Export & Map:
// - Invoice Number -> InvoiceNumber
// - New Value (transformed*) -> ActivityName 
// - Edit Date -> EventTime
// - Edited By -> UserResponsible
// - [Billing Department Field] -> BillingDepartment
// - New Value -> InvoiceStatus
// - [Invoice Total Amount] -> InvoiceTotalAmount
// - [Invoice Payment Due Date] -> PaymentDueDate
// *Transformation Logic for ActivityName: 
//   - IF New Value = 'Pending Approval' THEN 'Invoice Submitted for Approval'
//   - IF New Value = 'Approved' THEN 'Invoice Approved'
//   - IF New Value = 'Rejected' THEN 'Invoice Rejected'
//   - IF New Value = 'Draft' AND Old Value = 'Rejected' THEN 'Invoice Corrected'
//   - IF New Value = 'Closed' THEN 'Invoice Closed'
//   - IF New Value = 'Written Off' THEN 'Invoice Written Off'

// Report 3: Invoice Sent to Customer
// Report Type: Invoices
// Filters:
// 1. [Sent Date Field] NOT EQUAL TO "" (not null)
// 2. [Sent Date Field] GREATER OR EQUAL [Start Date]
// 3. [Sent Date Field] LESS OR EQUAL [End Date]
// Columns to Export & Map:
// - Invoice Number -> InvoiceNumber
// - 'Invoice Sent to Customer' (static text) -> ActivityName
// - [Sent Date Field] -> EventTime
// - Last Modified By -> UserResponsible
// - [Billing Department Field] -> BillingDepartment
// - Status -> InvoiceStatus
// - Total Amount -> InvoiceTotalAmount
// - Payment Due Date -> PaymentDueDate

// Report 4: Payment Due Date Reached
// Report Type: Invoices
// Filters:
// 1. Payment Due Date NOT EQUAL TO "" (not null)
// 2. Payment Due Date GREATER OR EQUAL [Start Date]
// 3. Payment Due Date LESS OR EQUAL [End Date]
// Columns to Export & Map:
// - Invoice Number -> InvoiceNumber
// - 'Payment Due Date Reached' (static text) -> ActivityName
// - Payment Due Date -> EventTime
// - 'System' (static text) -> UserResponsible
// - [Billing Department Field] -> BillingDepartment
// - Status -> InvoiceStatus
// - Total Amount -> InvoiceTotalAmount
// - Payment Due Date -> PaymentDueDate

// Report 5: Payment Reminder Issued
// Report Type: Activities with Invoices (or similar custom report type)
// Filters:
// 1. Task or Event Subject CONTAINS 'Payment Reminder'
// 2. Created Date GREATER OR EQUAL [Start Date]
// 3. Created Date LESS OR EQUAL [End Date]
// Columns to Export & Map:
// - Invoice: Invoice Number -> InvoiceNumber
// - 'Payment Reminder Issued' (static text) -> ActivityName
// - Created Date -> EventTime
// - Assigned To -> UserResponsible
// - [Billing Department Field] -> BillingDepartment
// - [Invoice Status Field] -> InvoiceStatus
// - [Invoice Total Amount] -> InvoiceTotalAmount
// - [Invoice Payment Due Date] -> PaymentDueDate

// Report 6: Customer Payment Received & Status Changes (Posted, Applied)
// Report Type: Payments with Invoices (or similar custom report type)
// This report combines multiple events from the Payment record.
// Filters:
// 1. Payment: Created Date GREATER OR EQUAL [Start Date]
// 2. Payment: Created Date LESS OR EQUAL [End Date]
// Part A: Payment Received
// Columns to Export & Map:
// - Invoice: Invoice Number -> InvoiceNumber
// - 'Customer Payment Received' (static text) -> ActivityName
// - Payment: Created Date -> EventTime
// - Payment: Created By -> UserResponsible
// Part B: Payment Posted and Applied (Requires exporting and transforming multiple rows for the same payment if status changes)
// You may need a separate Payment History Report, similar to Report 2.
// Assuming a simple status field on the Payment for this example:
//   - IF Payment Status = 'Posted' THEN 'Payment Posted to Ledger'
//   - IF Payment Status = 'Applied' THEN 'Cash Applied/Reconciled'

Seu Template de Dados para Order to Cash - Faturamento e Cobrança

Seu Template de Dados para Order to Cash - Faturamento e Cobrança

Atributos de Order to Cash - Faturamento e Cobrança

Atividades de Order to Cash - Faturamento e Cobrança

Guias de Extração

Salesforce Report Builder e Serviço de Exportação de Dados

Etapas

Configuração

a Consulta de Exemplo config

Script em Python usando a API REST do Salesforce

Etapas

Configuração

a Consulta de Exemplo python

Extração via Ferramenta ETL com Conector Salesforce Nativo

Etapas

Configuração

a Consulta de Exemplo config

Pronto para Começar?

Recebimentos Rápidos: Otimize seu Order-to-Cash agora

Seu Template de Dados para Order to Cash - Faturamento e Cobrança

Seu Template de Dados para Order to Cash - Faturamento e Cobrança

Atributos de Order to Cash - Faturamento e Cobrança

Atividades de Order to Cash - Faturamento e Cobrança

Guias de Extração

Salesforce Report Builder e Serviço de Exportação de Dados

Etapas

Configuração

a Consulta de Exemplo config

Script em Python usando a API REST do Salesforce

Etapas

Configuração

a Consulta de Exemplo python

Extração via Ferramenta ETL com Conector Salesforce Nativo

Etapas

Configuração

a Consulta de Exemplo config

Valorizamos sua privacidade

Pronto para Começar?

Recebimentos Rápidos: Otimize seu Order-to-Cash agora