> Melhoria contínua de processos > Pedido ao recebimento: faturamento e emissão de faturas > Salesforce Sales Cloud > Template de dados

Seu Template de dados de Order to Cash, faturamento e emissão de faturas

Salesforce Sales Cloud

← Voltar ao guia de melhoria

Atributos de Order to Cash, faturamento e emissão de faturas(19) Atividades de Order to Cash, faturamento e emissão de faturas(13) Guias de extração(3)

Seu Template de dados de Order to Cash, faturamento e emissão de faturas

Este Template apresenta uma visão abrangente dos atributos e das atividades essenciais para analisar com eficácia seu processo de Order to Cash, faturamento e emissão de faturas. Ele descreve as informações específicas que você deve coletar para o Event Log e traz orientações práticas para extrair esses dados. Use este material para simplificar suas iniciativas de Process Mining e obter insights valiosos.

Atributos recomendados para coleta
Principais atividades a acompanhar
Orientações para extração

Novidade em Event Logs? Saiba como criar um Event Log para Process Mining.

Baixar Template

Atributos de Order to Cash, faturamento e emissão de faturas

Estes são os campos de dados recomendados para incluir no Event Log e realizar uma análise abrangente de Order to Cash, faturamento e emissão de faturas, garantindo o registro de todas as informações essenciais.

3 Obrigatório 5 Recomendado 11 Opcional

	Nome	Descrição
	Data e hora do evento EventTime	Data e hora que indicam quando uma atividade específica ocorreu.
Descrição Este atributo informa a data e a hora de cada atividade, essenciais para ordenar os eventos cronologicamente e analisar a performance. As datas e horas registradas estabelecem a sequência dos eventos e permitem calcular o tempo entre eles. Na análise de processos, a Data e hora do evento é usada para calcular todas as métricas baseadas em tempo, incluindo tempos de ciclo, tempos de espera e duração de atividades específicas. Ela é a base de KPIs como 'Tempo médio do ciclo de faturas' e 'DSO', além de alimentar Dashboards como 'Tempo do ciclo de aprovação de faturas' e 'Desempenho da conciliação de pagamentos'. Por que isso importa Esta data e hora são essenciais para ordenar corretamente os eventos e calcular métricas de performance, como tempos de ciclo e duração, que ajudam a identificar atrasos. Onde encontrar Esses dados costumam vir de campos de data e hora gerados pelo sistema, como `CreatedDate` ou `LastModifiedDate`, no objeto Invoice ou em registros relacionados de Task ou Event. Exemplos 2023-04-15T10:00:00Z2023-04-16T14:30:00Z2023-05-20T09:05:12Z
	Nome da atividade ActivityName	Nome do evento de negócio específico ocorrido no processo de faturamento.
Descrição Este atributo descreve a etapa ou o marco alcançado no ciclo de vida da fatura, como 'Fatura gerada' ou 'Pagamento recebido'. Essas atividades formam os nós do mapa do processo. Analisar a sequência do Nome da atividade é fundamental para o Process Mining. Isso revela o fluxo real do processo e permite compará-lo com o processo planejado. A análise ajuda a identificar desvios, gargalos entre etapas específicas e ciclos de retrabalho, além de apoiar diretamente Dashboards como 'Retrabalho e erros no processo de faturamento' e 'Relatório de violações de conformidade no faturamento'. Por que isso importa Ele define as etapas do processo, forma a base do mapa do processo e permite analisar o fluxo de trabalho, os gargalos e os desvios. Onde encontrar Em geral, este atributo é derivado de alterações no campo Status do objeto Invoice ou de registros em objetos relacionados, como Task ou Event, que acompanham ações específicas. Exemplos Fatura geradaFatura aprovadaFatura enviada ao clientePagamento recebido
	Número da fatura InvoiceNumber	Identificador exclusivo de cada fatura, usado como identificador principal do caso no processo de faturamento.
Descrição O Número da fatura é o atributo central que reúne todas as atividades relacionadas ao faturamento em um único caso. Cada número representa um documento de faturamento específico enviado a um cliente. Na análise de Process Mining, esse atributo permite acompanhar todo o ciclo de vida da fatura, da geração ao pagamento e encerramento. Ele é essencial para criar o mapa do processo e calcular KPIs por caso, como 'Tempo médio do ciclo de faturas' e 'Prazo médio de recebimento de vendas'. Analisar os processos pelo Número da fatura ajuda a identificar gargalos, ciclos de retrabalho e desvios de conformidade em cada ocorrência de faturamento. Por que isso importa Esta é a chave essencial para relacionar todos os eventos de faturamento, permitindo uma visão completa do processo de emissão de faturas em cada transação. Onde encontrar Em geral, esta é a chave primária do objeto Invoice no Salesforce Sales Cloud, representada muitas vezes pelo campo `InvoiceNumber` ou por outro campo de ID exclusivo. Exemplos INV-00582INV-01934INV-10345
	Data de vencimento do pagamento PaymentDueDate	Data limite para o cliente pagar a fatura.
Descrição Este atributo especifica o prazo de pagamento informado na fatura. Ele é calculado com base na data de emissão da fatura e nas condições de pagamento acordadas. A Data de vencimento do pagamento é um dado essencial para o planejamento financeiro e a gestão de cobranças. Ela serve de referência para medir a pontualidade dos pagamentos. Também é necessária para calcular o KPI 'Taxa de pagamentos em dia' e alimentar Dashboards que acompanham os prazos de pagamento, como 'Tendência do Prazo médio de recebimento de vendas (DSO)'. Por que isso importa Este é o parâmetro de referência para medir a performance dos pagamentos, calcular o prazo médio de recebimento de vendas (DSO) e iniciar ações de cobrança, como o envio de lembretes de pagamento. Onde encontrar Este é um campo de data padrão do objeto Invoice no Salesforce, geralmente chamado `DueDate`. Exemplos 2023-05-152023-06-302023-07-01
	Departamento de faturamento BillingDepartment	Departamento ou equipe responsável pela atividade de faturamento.
Descrição Este atributo especifica o grupo funcional ao qual o usuário responsável pertence, como 'Contas a receber' ou 'Operações de vendas'. Em geral, essa informação é derivada do perfil ou da função do usuário no Salesforce. Analisar a performance por departamento é essencial para entender a responsabilidade pelo processo e identificar problemas sistêmicos em equipes específicas. Esse atributo é usado nos Dashboards 'Desempenho da conciliação de pagamentos' e 'Carga de trabalho e performance da equipe de faturamento' para comparar a eficiência e o uso de recursos entre diferentes áreas funcionais. Por que isso importa Isso permite analisar a performance por equipe ou departamento e ajuda a identificar gargalos específicos de cada grupo, limitações de recursos ou lacunas de treinamento. Onde encontrar Essas informações costumam ficar no objeto User do Salesforce, em campos como `Departamento` ou `Role.Name`. Exemplos Contas a receberOperações financeirasEquipe de cobrança
	Status da fatura InvoiceStatus	Status atual da fatura no ciclo de vida.
Descrição Este atributo mostra o estado atual da fatura, por exemplo, 'Rascunho', 'Aguardando aprovação', 'Enviada', 'Paga' ou 'Anulada'. Ele indica em que etapa do processo a fatura está em determinado momento. O Status da fatura é uma dimensão essencial para filtrar e segmentar os dados. Ele permite que analistas se concentrem em grupos específicos de faturas, como todas as que aguardam pagamento ou foram rejeitadas. Isso ajuda a priorizar o trabalho e a analisar as características das faturas que ficam paradas em determinadas etapas. Por que isso importa Ele mostra com clareza o estado atual da fatura e permite filtrar e analisar casos em aberto, encerrados ou com problemas. Onde encontrar Em geral, este é um campo de lista de opções padrão chamado `Status` no objeto Invoice do Salesforce. Exemplos Aguardando aprovaçãoAprovadoEnviada ao clientePagaBaixada como perda
	Usuário responsável UserResponsible	Usuário ou agente que realizou a atividade.
Descrição Este atributo identifica o usuário específico do Salesforce responsável por uma atividade, como aprovar uma fatura ou lançar um pagamento. Em geral, ele está associado ao usuário que modificou o registro por último ou é responsável pela tarefa. Analisar o processo por Usuário responsável é essencial para entender a performance da equipe, a distribuição da carga de trabalho e as necessidades de treinamento. Isso apoia diretamente o Dashboard 'Carga de trabalho e performance da equipe de faturamento', permitindo comparar a performance e analisar a alocação de recursos. Também ajuda na análise de causa raiz de atrasos ou erros. Por que isso importa Ele permite analisar a performance individual e da equipe, equilibrar a carga de trabalho e identificar quem tem melhor desempenho ou precisa de treinamento adicional. Onde encontrar Essas informações podem estar em campos como `LastModifiedById` no objeto Invoice ou `OwnerId` em objetos relacionados Task ou personalizados. Para obter o nome do usuário, é preciso relacionar esses IDs ao objeto User. Exemplos Alice JohnsonBob WilliamsCharlie Brown
	Valor total da fatura InvoiceTotalAmount	Valor monetário total da fatura.
Descrição Este atributo representa o valor total devido pelo cliente pelos produtos ou serviços fornecidos. É uma métrica financeira importante associada a cada caso de fatura. Analisar o Valor total da fatura ajuda a priorizar faturas de alto valor e entender como a performance do processo varia entre transações pequenas e grandes. O atributo pode ser usado para segmentar análises em Dashboards e verificar, por exemplo, se faturas de maior valor levam mais tempo para ser aprovadas ou são pagas com atraso. Isso é importante para gerenciar riscos financeiros e direcionar os esforços de cobrança. Por que isso importa Isso permite analisar o impacto financeiro, priorizar faturas de alto valor e entender como o valor monetário afeta o processo, por exemplo, os prazos de aprovação ou os atrasos nos pagamentos. Onde encontrar Provavelmente, este é um campo de moeda padrão no objeto Invoice, possivelmente chamado `GrandTotal` ou com outro nome semelhante de campo de resumo. Exemplos 5400.5012500.00850.75
	Condições de pagamento PaymentTerms	As condições acordadas para o pagamento da fatura, como '30 dias líquidos' ou 'Vencimento no recebimento'.
Descrição Este atributo define as regras que determinam quando e como uma fatura deve ser paga. Muitas vezes, ele determina o cálculo da data de vencimento do pagamento e pode incluir descontos para pagamentos antecipados. A análise por condições de pagamento ajuda a entender como diferentes acordos afetam o comportamento de pagamento. Ela é essencial para o Dashboard 'Utilização de descontos para pagamento antecipado', que compara as datas de pagamento com as condições acordadas para identificar oportunidades financeiras perdidas. Também ajuda a entender por que algumas faturas têm ciclos de pagamento mais longos ou mais curtos. Por que isso importa Ele contextualiza os prazos de pagamento e é essencial para analisar o comportamento de pagamento, o DSO e a eficácia dos programas de desconto para pagamento antecipado. Onde encontrar É provável que essas informações estejam armazenadas em uma lista de opções ou em um campo de texto do objeto Invoice ou do objeto Account associado no Salesforce. Exemplos 30 dias líquidos60 dias líquidos2% em 10 dias, 30 dias líquidosVencimento no recebimento
	Hora de término do evento EventEndTime	A data e hora que indicam quando uma atividade foi concluída.
Descrição Este atributo registra o horário de conclusão de uma atividade. Embora muitas atividades de faturamento sejam eventos instantâneos, em que a hora de início é igual à hora de término, algumas, como uma etapa de aprovação, podem ter uma duração mensurável. A hora de término permite calcular com precisão o tempo de processamento da atividade, ou seja, o período em que uma pessoa ou um sistema trabalha ativamente em uma tarefa. Isso ajuda a diferenciar o tempo de trabalho ativo do tempo de espera e oferece uma visão mais detalhada da eficiência do processo. Por que isso importa Ele permite calcular com precisão o tempo de processamento das atividades e diferenciar o trabalho ativo do tempo de espera, para uma análise de eficiência mais precisa. Onde encontrar Esse campo geralmente não é padrão. Talvez seja necessário derivá-lo usando o StartTime da atividade seguinte no caso ou registrá-lo em um campo personalizado. Exemplos 2023-04-15T10:05:00Z2023-04-16T14:32:10Z2023-05-20T09:05:12Z
	Houve retrabalho IsRework	Um indicador calculado que informa se uma fatura passou por um ciclo de retrabalho.
Descrição Este atributo booleano é derivado durante o processamento dos dados. Ele recebe o valor true quando a sequência de atividades de uma fatura indica retrabalho, como o retorno a uma etapa anterior depois de avançar no processo (por exemplo, 'Fatura corrigida' após 'Fatura aprovada'). Este indicador é essencial para identificar e quantificar rapidamente as ineficiências do processo. Ele alimenta diretamente o KPI 'Taxa de retrabalho de faturas' e o Dashboard 'Retrabalho e erros no processo de faturamento', permitindo que analistas isolem e examinem casos com ciclos de retrabalho que geram custos e consomem tempo. Por que isso importa Este indicador quantifica diretamente a ineficiência do processo ao identificar casos com ciclos de correção. Assim, ajuda a localizar as fontes de erro e calcular o custo da má qualidade. Onde encontrar Este atributo não existe no sistema de origem. Ele é calculado pela ferramenta de Process Mining ou na camada de ETL, com base na sequência de atividades de cada caso. Exemplos truefalse
	Moeda da fatura InvoiceCurrency	O código da moeda do valor da fatura, como USD ou EUR.
Descrição Este atributo indica a moeda em que a fatura está denominada. Ele é especialmente importante para organizações que operam em vários países. Este campo oferece um contexto essencial para qualquer análise financeira. Ele permite agregar valores monetários corretamente e comparar métricas do processo entre diferentes zonas monetárias. É um filtro necessário na análise de KPIs financeiros, para evitar misturar moedas diferentes. Por que isso importa Oferece o contexto necessário para todos os valores monetários, garantindo análises e relatórios financeiros precisos, especialmente em operações multinacionais. Onde encontrar Geralmente, este é o campo padrão `CurrencyIsoCode`, disponível em instâncias do Salesforce com o recurso de várias moedas ativado. Exemplos USDEURGBPJPY
	Nome do cliente CustomerName	Nome do cliente ou da conta que recebe a fatura.
Descrição Este atributo identifica o cliente ou a empresa para quem a fatura é emitida. Em geral, ele é vinculado ao registro Account correspondente no Salesforce. Analisar o processo por cliente é essencial para entender comportamentos específicos e identificar problemas que possam afetar contas importantes. A análise pode revelar se determinados clientes pagam com atraso de forma recorrente, exigem mais retrabalho ou têm ciclos de aprovação complexos. Esse insight ajuda a gerenciar o relacionamento com os clientes e a adaptar as estratégias de cobrança. Por que isso importa Permite analisar o processo com foco no cliente e identificar padrões, como quais clientes costumam pagar com atraso ou exigem mais correções nas faturas, melhorando a gestão do relacionamento com eles. Onde encontrar A origem deste atributo é o campo `Account.Name`, vinculado por uma relação de consulta entre o objeto Invoice e o objeto Account. Exemplos ABC CorporationGlobal Tech Inc.Innovate Solutions LLC
	Pagamento em atraso IsLatePayment	Um indicador calculado que informa se o pagamento foi recebido após a data de vencimento.
Descrição Este atributo booleano é derivado da comparação entre a data e hora de 'Pagamento recebido do cliente' e a 'Data de vencimento do pagamento'. Ele recebe o valor true quando o pagamento está atrasado e false nos demais casos. Este indicador simplifica a análise do comportamento de pagamento e da eficácia das cobranças. Ele serve de base para o KPI 'Taxa de pagamentos em dia' e ajuda a segmentar os clientes entre os que pagam em dia e os que pagam com atraso, para análises adicionais. Também apresenta um resultado claro e binário da performance de pagamento de cada fatura. Por que isso importa Ele oferece uma métrica clara de sucesso das cobranças, dá suporte direto ao KPI 'Taxa de pagamentos em dia' e permite analisar os fatores que contribuem para os atrasos. Onde encontrar Este atributo não existe no sistema de origem. Ele é calculado na camada de ETL ou na ferramenta de Process Mining, comparando a data do pagamento com o campo `PaymentDueDate`. Exemplos truefalse
	País de faturamento BillingCountry	O país informado no endereço de faturamento da fatura.
Descrição Este atributo registra o país do endereço de faturamento do cliente. É uma dimensão geográfica importante para segmentar os dados do processo. Analisar o processo de faturamento por país é essencial para identificar diferenças regionais de performance, conformidade e comportamento dos clientes. A análise pode revelar se determinados países têm ciclos de pagamento mais longos, taxas de retrabalho diferentes ou exigências regulatórias específicas que afetam o processo. Isso contribui para harmonizar processos globalmente e otimizar as operações em cada região. Por que isso importa Permite analisar os dados geograficamente e identificar diferenças regionais de performance, exigências de conformidade e comportamento de pagamento. Onde encontrar Este campo faz parte do campo composto de endereço padrão do objeto Invoice e geralmente se chama `BillingCountry`. Exemplos USAAlemanhaJapãoBrasil
	Prazo médio de recebimento de vendas DaysSalesOutstanding	O número de dias entre o envio da fatura e o recebimento do pagamento.
Descrição O prazo médio de recebimento de vendas (DSO) é uma métrica financeira essencial que mede o número médio de dias que uma empresa leva para receber o pagamento após uma venda. Ele é calculado pelo intervalo entre o evento 'Fatura enviada ao cliente' e o evento 'Pagamento recebido do cliente'. Este KPI é um dos principais focos do processo de Order to Cash, e este atributo disponibiliza o indicador para cada fatura. Ele dá suporte direto ao Dashboard 'Tendência do prazo médio de recebimento de vendas (DSO)' e é essencial para monitorar e melhorar o fluxo de caixa. Por que isso importa Este é um KPI essencial para medir a eficácia do processo de cobrança e seu impacto direto no fluxo de caixa da empresa. Onde encontrar Este atributo é calculado pela expressão `(Timestamp('Customer Payment Received') - Timestamp('Invoice Sent to Customer'))`. Exemplos 32 dias58 dias29 dias
	Responsável pela conta AccountOwner	O representante de vendas ou gerente de contas responsável pela conta do cliente.
Descrição Este atributo identifica a pessoa responsável internamente pelo relacionamento com o cliente. Em geral, é o vendedor ou gerente de contas atribuído à Account no Salesforce. Embora não participe diretamente do faturamento, o responsável pela conta pode ser uma dimensão relevante para a análise. Problemas no processo de faturamento podem afetar o relacionamento com o cliente, e este atributo ajuda a relacionar os dados de performance do processo à área comercial. Ele pode mostrar se as contas gerenciadas por determinadas pessoas apresentam mais problemas de faturamento. Por que isso importa Relaciona a performance do processo de faturamento à pessoa responsável pelo relacionamento comercial e ajuda a entender o impacto de erros ou atrasos nas faturas para o negócio. Onde encontrar Este é o campo `Owner.Name` do objeto Account, relacionado à Invoice. Exemplos David MillerSophia GarciaJames Wilson
	Sistema de origem SourceSystem	Identifica o sistema de onde os dados vieram.
Descrição Este atributo especifica o aplicativo de origem em que os dados do evento foram gerados. Neste processo, geralmente será 'Salesforce Sales Cloud'. Em ambientes com vários sistemas integrados, este campo é essencial para rastrear a origem dos dados e solucionar problemas. Ele ajuda a entender o contexto dos dados e a garantir que eventos de sistemas diferentes sejam combinados e interpretados corretamente na ferramenta de Process Mining. Por que isso importa Ele fornece contexto essencial sobre a origem dos dados, necessário para a governança, validação e análise de dados em ambientes com vários sistemas. Onde encontrar Em geral, este é um valor estático adicionado durante o processo de extração, transformação e carregamento (ETL) para identificar a origem do conjunto de dados. Exemplos Salesforce Sales CloudSFSC
	Última atualização dos dados LastDataUpdate	Data e hora da última atualização dos dados do sistema de origem.
Descrição Este atributo indica quando os dados da análise de Process Mining foram extraídos pela última vez do Salesforce Sales Cloud. É um campo de metadados aplicado ao conjunto de dados inteiro a cada atualização. Esta data e hora são essenciais para que você saiba se os dados da análise estão atualizados. Elas ajudam a verificar se os Dashboards e KPIs exibidos refletem os dados mais recentes, algo fundamental para tomar decisões de negócio oportunas e fundamentadas nos insights do processo. Por que isso importa Informa se os dados estão atualizados, ajudando a garantir que as decisões se baseiem em uma visão atual e relevante do processo. Onde encontrar Este valor é gerado e registrado no conjunto de dados pela ferramenta de ETL ou pelo pipeline de dados a cada execução. Exemplos 2023-10-27T02:00:00Z2023-10-28T02:00:00Z

Obrigatório Recomendado Opcional

Atividades de Order to Cash, faturamento e emissão de faturas

Estas são as principais etapas e os marcos do processo que você deve registrar no Event Log para descobrir o processo com precisão e avaliar sua performance.

5 Recomendado 8 Opcional

	Atividade	Descrição
	Fatura aprovada	Um usuário autorizado analisou e aprovou a fatura, confirmando que ela está correta e pronta para ser enviada ao cliente. Em geral, esse evento é identificado quando o status da fatura muda para 'Aprovado'.
Por que isso importa Este é um marco importante que condiciona as etapas seguintes do processo de faturamento. Atrasos nessa etapa criam gargalos significativos e afetam o DSO e o tempo total do ciclo, medido pelo Dashboard 'Tempo do ciclo de aprovação de faturas'. Onde encontrar Inferido quando o campo de status do objeto Invoice muda para 'Aprovado'. Se o Salesforce Approval Processes estiver em uso, o histórico do objeto ProcessInstance pode registrar esse evento explicitamente. Coleta Alteração do campo de status da fatura para 'Aprovado' ou conclusão de uma etapa formal do processo de aprovação. Tipo de evento inferred
	Fatura encerrada	O ciclo de vida da fatura foi concluído: ela foi totalmente paga e conciliada. Esta é a atividade final de uma fatura processada com sucesso e costuma ser registrada por uma atualização de status.
Por que isso importa Esta atividade é o principal ponto final do processo e permite calcular com precisão o tempo total do ciclo. Ela define claramente quando o processo pode ser considerado concluído. Onde encontrar Inferido pela data e hora em que o campo de status do objeto Invoice é atualizado para 'Encerrado', 'Pago integralmente' ou outro status final semelhante. Coleta Alteração do campo de status da fatura para o valor final 'Encerrado'. Tipo de evento inferred
	Fatura enviada ao cliente	A fatura aprovada foi enviada oficialmente ao cliente por e-mail, correio ou portal. Muitas vezes, esse evento é identificado pelo preenchimento do campo 'Data de envio' ou pela mudança do status para 'Enviado'.
Por que isso importa Este evento marca o início do período de cobrança do pagamento e é o ponto de partida para calcular o Prazo médio de recebimento de vendas (DSO). É um marco essencial para acompanhar a comunicação com o cliente e os prazos de pagamento. Onde encontrar Inferido pelo preenchimento do campo 'Data de envio' no objeto Invoice ou pela atualização do status para 'Enviado'. Também pode ser um evento registrado explicitamente no histórico de atividades, caso o envio seja feito por uma ferramenta de e-mail integrada. Coleta Data e hora em que o campo 'Sent_Date__c' é preenchido. Tipo de evento inferred
	Fatura gerada	Esta atividade marca a criação de um novo registro de fatura no Salesforce. É o início oficial do processo de faturamento de uma transação específica e costuma ocorrer após o atendimento de um pedido ou o cumprimento de uma etapa do contrato. O evento é identificado pela data e hora de criação do registro da fatura.
Por que isso importa Este é o principal evento de início do processo de faturamento. Analisar o tempo entre esse ponto e o pagamento ajuda a medir o tempo total do ciclo de Order-to-Cash e a identificar atrasos iniciais na entrada de dados. Onde encontrar Este evento é identificado pela data de criação (campo CreatedDate) do objeto personalizado Invoice ou de um objeto semelhante que represente a fatura no Salesforce. Coleta Data e hora de criação do registro do objeto de fatura. Tipo de evento explicit
	Pagamento do cliente recebido	O cliente pagou a fatura e o valor foi recebido. Em geral, isso é registrado pela criação de um registro relacionado 'Payment', vinculado à fatura.
Por que isso importa Este é o marco mais importante da etapa de recebimento do processo. É o ponto final do cálculo do DSO e indica que a receita foi recebida. Onde encontrar Identificado pela data de criação de um registro do objeto personalizado 'Payment' relacionado ao objeto Invoice. Também pode ser inferido quando o status da fatura muda para 'Pago'. Coleta Criação de um registro Payment relacionado. Tipo de evento explicit
	Data de vencimento do pagamento atingida	Este é um evento calculado que representa o momento em que o pagamento da fatura vence, de acordo com as condições de pagamento. Não corresponde a uma ação do usuário, mas é derivado dos dados da fatura.
Por que isso importa Esta atividade fornece uma referência essencial para analisar o comportamento de pagamento e medir o KPI 'Taxa de pagamentos em dia'. Ela ajuda a diferenciar pagamentos feitos no prazo daqueles feitos com atraso. Onde encontrar Este é um evento calculado, obtido pela comparação da data e hora atual com o campo 'Due Date' do objeto Invoice. Ele não existe como evento armazenado no Salesforce. Coleta Calculado pela comparação da data atual com o campo Due Date da fatura. Tipo de evento calculated
	Fatura baixada como perda	Foi tomada a decisão de cancelar a dívida e encerrar a fatura sem o pagamento integral. Isso representa um desfecho alternativo e malsucedido do processo de faturamento.
Por que isso importa Acompanhar as baixas como perda ajuda a quantificar a perda de receita e identificar clientes ou situações que levam à inadimplência. Esse é um caminho de exceção importante para monitorar a saúde financeira. Onde encontrar Inferido pela data e hora em que o campo de status do objeto Invoice é atualizado para 'Baixado como perda' ou 'Cancelado - dívida incobrável'. Coleta Alteração do campo de status da fatura para 'Baixado como perda'. Tipo de evento inferred
	Fatura corrigida	Representa uma correção ou atualização manual da fatura após uma rejeição ou a identificação de um erro. Muitas vezes, esse evento é inferido quando o status da fatura volta a uma etapa anterior, por exemplo, de 'Rejeitado' para 'Rascunho'.
Por que isso importa Identificar ciclos de correção é essencial para medir o KPI 'Taxa de retrabalho de faturas'. Um volume alto de correções indica problemas na geração inicial das faturas, que causam atrasos. Onde encontrar Inferido pelo histórico de alterações de campos, identificando uma mudança de status de uma etapa posterior (por exemplo, 'Rejeitado' ou 'Aprovado') para uma etapa anterior (por exemplo, 'Rascunho' ou 'Em andamento'). Coleta 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 análise interna antes de ser encaminhada ao cliente. Em geral, essa atividade é identificada por uma alteração no campo de status do registro da fatura, por exemplo, de 'Rascunho' para 'Aguardando aprovação'.
Por que isso importa Acompanhar esta atividade ajuda a isolar o tempo de espera na fila de aprovação. É uma etapa essencial para calcular o KPI 'Tempo médio de aprovação de faturas'. Onde encontrar Inferido pelo histórico de alterações de campos do objeto Invoice, quando um campo de status recebe um valor como 'Enviada para aprovação' ou 'Em análise'. Coleta Alteração do campo de status da fatura para 'Aguardando aprovação'. Tipo de evento inferred
	Fatura rejeitada	O aprovador rejeitou a fatura, geralmente por erros ou divergências. Ela precisa ser corrigida e enviada novamente. Esse evento é identificado quando o status do registro da fatura muda para 'Rejeitado'.
Por que isso importa Esta atividade indica retrabalho e ineficiência no processo. Analisar a frequência das rejeições ajuda a identificar as causas mais comuns dos erros e apoia a análise de causa raiz no Dashboard 'Retrabalho e erros no processo de faturamento'. Onde encontrar Inferido quando o campo de status do objeto Invoice muda para 'Rejeitado'. Esses dados também podem aparecer nos comentários do histórico de um processo formal de aprovação. Coleta Alteração do campo de status da fatura para 'Rejeitado'. Tipo de evento inferred
	Lembrete de pagamento enviado	Uma mensagem foi enviada ao cliente para lembrá-lo de um pagamento próximo do vencimento ou em atraso. Em geral, ela é registrada como uma atividade específica (Task ou Email) vinculada à fatura.
Por que isso importa Acompanhar os lembretes ajuda a avaliar a eficácia das estratégias de cobrança. Esses dados são essenciais para o Dashboard 'Eficácia dos lembretes de pagamento' e o KPI 'Taxa de acionamento de lembretes de pagamento'. Onde encontrar Identificado pela criação de um registro de atividade (Task ou Email) relacionado ao objeto Invoice, cujo assunto ou tipo indique que se trata de um lembrete de pagamento. Coleta Criação de um registro Task ou Email relacionado, com tipo ou assunto específico. Tipo de evento explicit
	Pagamento lançado no razão contábil	O pagamento recebido foi registrado oficialmente no sistema de contabilidade financeira ou no razão contábil da empresa. Esse evento pode ser identificado por uma atualização do status do pagamento ou da fatura após a execução de uma integração.
Por que isso importa Esta atividade diferencia o recebimento do pagamento da conciliação financeira. O tempo entre o recebimento e o lançamento pode revelar atrasos nos processos contábeis internos. Onde encontrar Inferido quando um campo de status do objeto Payment ou Invoice muda para um valor como 'Lançado' ou 'Exportado para ERP', geralmente atualizado por uma integração de API. Coleta Alteração do status do pagamento ou da fatura para 'Lançado'. Tipo de evento inferred
	Valor recebido aplicado/conciliado	O pagamento recebido foi totalmente associado e aplicado à fatura correspondente no sistema, encerrando o recebível. Esse evento é identificado pela alteração final do status do pagamento ou da fatura.
Por que isso importa Este evento marca a etapa final do ciclo de conversão de caixa. O Dashboard 'Desempenho da conciliação de pagamentos' usa esta atividade para medir a eficiência da equipe financeira na aplicação dos valores recebidos. Onde encontrar Inferido quando o status da fatura ou de um objeto Payment relacionado muda para um status final, como 'Conciliado' ou 'Aplicado'. Coleta Alteração do status da fatura ou do pagamento para 'Conciliado'. Tipo de evento inferred

Recomendado Opcional

Guias de extração

Como obter seus dados do Salesforce Sales Cloud

Etapas

Verifique os pré-requisitos: Confirme se você tem as permissões necessárias no Salesforce, incluindo "Executar relatórios", "Criar e personalizar relatórios" e "Exportar relatórios". Verifique se o rastreamento do histórico de campos está ativado para os campos de status principais dos objetos Invoice e Payment. Para isso, acesse Setup > Object Manager, localize o objeto relevante, vá até Fields & Relationships e clique em "Set History Tracking".
Defina a estratégia de relatórios: Este processo exige a criação de vários relatórios, pois as atividades têm origem em registros ou eventos diferentes (por exemplo, criação de faturas, alterações de status e pagamentos relacionados). Você criará um relatório separado para cada origem e depois combinará os resultados externamente.
Crie um relatório para a criação de registros: Comece pelos eventos mais simples. Crie um relatório para 'Fatura gerada' e 'Pagamento recebido do cliente'. Acesse a guia Reports e clique em "New Report". Escolha um tipo de relatório que inclua o objeto Invoice (por exemplo, "Invoices") ou o objeto Payment. Adicione colunas correspondentes aos atributos do Event Log. Para a atividade 'Fatura gerada', o campo CreatedDate do registro da fatura será o EventTime.
Crie um relatório do histórico de campos: Para registrar alterações de status, como 'Fatura enviada para aprovação', 'Fatura aprovada', 'Fatura rejeitada' e 'Fatura corrigida', crie um relatório com base no tipo de relatório "Invoice History". Esse tipo especial de relatório mostra as alterações registradas pelo rastreamento do histórico de campos. Filtre o relatório pelas alterações no campo Status.
Crie um relatório para eventos baseados em datas: Para eventos como 'Fatura enviada ao cliente' ou 'Data de vencimento do pagamento atingida', crie um relatório do objeto Invoice. Use os próprios campos de data, como Sent_Date__c ou Payment_Due_Date__c, como EventTime. Filtre os registros para incluir apenas aqueles em que esses campos de data não estejam vazios.
Crie um relatório para atividades relacionadas: Para eventos como 'Lembrete de pagamento enviado', você precisa de um relatório que relacione Activities (Tasks ou Events) às faturas. Use um tipo de relatório como "Activities with Invoices" ou crie um tipo personalizado. Filtre as atividades por um assunto ou tipo específico que indique um lembrete.
Adicione colunas padrão a todos os relatórios: Em cada relatório, inclua colunas que possam ser mapeadas para a estrutura necessária do Event Log: InvoiceNumber, um campo para EventTime (como CreatedDate ou a data da alteração do campo), UserResponsible (como LastModifiedById) e outros atributos recomendados.
Exporte os relatórios para CSV: Execute cada relatório individualmente. Na tela de resultados, use o menu suspenso para selecionar "Export" e escolha o formato "Details Only" com a extensão .csv. Repita o processo para todos os relatórios criados.
Combine e transforme os dados: Abra os arquivos CSV exportados em uma planilha ou use uma ferramenta de preparação de dados. Em cada arquivo, adicione uma coluna chamada ActivityName e preencha-a com a atividade correspondente (por exemplo, "Fatura gerada" em todas as linhas do primeiro relatório). Mapeie as colunas de origem (por exemplo, Invoice: Created Date) para os cabeçalhos padrão do Event Log (EventTime).
Crie o Event Log final: Consolide todos os dados transformados dos arquivos CSV individuais em um único arquivo principal. Verifique se os cabeçalhos das colunas são exatamente InvoiceNumber, ActivityName, EventTime, UserResponsible etc. Esse arquivo unificado será seu Event Log final.
Formate o arquivo final: Salve o arquivo consolidado como CSV com codificação UTF-8. Agora, o arquivo está pronto para ser carregado no ProcessMind.

Configuração

Tipos de relatório: Provavelmente, você precisará de vários tipos de relatório personalizados para relacionar objetos principais, como Account, a objetos subordinados e de níveis inferiores, como Invoice, Payment e Activity. Crie esses tipos em Setup > Report Types.
Rastreamento do histórico de campos: Esta etapa é essencial. No objeto Invoice, ative o rastreamento do histórico para qualquer campo Status. Sem isso, você não poderá registrar atividades de alteração de status, como 'Aprovado' ou 'Rejeitado'. O histórico não é registrado retroativamente.
Filtros de dados: Sempre aplique um filtro de data aos relatórios para manter o volume de dados sob controle. Uma boa prática é filtrar pela data de criação do objeto principal e selecionar os últimos 3 a 6 meses (por exemplo, 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 nativo Data Export (Setup > Data Export). Esse serviço exporta todos os dados da sua organização semanal ou mensalmente. Ele oferece um backup completo, mas exige um trabalho significativo de pós-processamento para filtrar, relacionar e transformar os dados em um Event Log.
Permissões de usuário: Além das permissões para criar e exportar relatórios, a pessoa que fizer a extração precisa ter acesso de leitura a todos os objetos (por exemplo, Account, Order, Invoice__c, Payment__c, Activity) e campos relevantes.

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: Verifique se o Python 3.6 ou uma versão mais recente está instalado no seu sistema. Instale as bibliotecas necessárias executando este comando no terminal: pip install simple-salesforce pandas. Você também precisará do seu nome de usuário e senha do Salesforce e do token de segurança. Para obter o token, faça login no Salesforce, acesse suas configurações pessoais e localize a opção 'Reset My Security Token'.
Ative o rastreamento do histórico de campos: Faça login na sua organização do Salesforce como administrador. Acesse Setup e, em seguida, Object Manager. Localize o objeto principal de faturas, por exemplo, Invoice__c, e acesse 'Fields & Relationships'. Clique em 'Set History Tracking'. Ative o rastreamento do campo que representa o status da fatura, por exemplo, Status__c. Repita o processo para o objeto de pagamentos, por exemplo, Payment__c, e para o campo de status correspondente.
Baixe e configure o script: Salve o script Python fornecido em um arquivo chamado extract_invoices.py. Abra o arquivo em um editor de texto e atualize os valores de exemplo na seção 'Salesforce Credentials and Settings'. Informe SF_USERNAME, SF_PASSWORD, SF_SECURITY_TOKEN e SF_INSTANCE_URL. Ajuste START_DATE e END_DATE para definir o período da extração.
Personalize os nomes de objetos e campos: Revise cuidadosamente as consultas SOQL do script. Ele usa nomes de exemplo, como Invoice__c, Payment__c, Status__c e Total_Amount__c. Substitua esses nomes pelos nomes de API reais dos objetos e campos usados na sua instância do Salesforce para faturamento e emissão de faturas.
Execute o script de extração: Abra um terminal ou prompt de comando, acesse a pasta onde salvou o script e execute o comando python extract_invoices.py. O script se conectará à API do Salesforce, executará as consultas e processará os dados.
Acompanhe o andamento do script: À medida que busca e processa os dados de cada tipo de atividade, o script exibirá mensagens de status no console. O processo pode levar algum tempo, dependendo do volume de dados e dos limites da API. Fique atento a mensagens de erro que possam indicar credenciais ou nomes de API incorretos.
Revise o arquivo de saída: Quando a execução terminar com sucesso, será criado um arquivo chamado salesforce_billing_event_log.csv na mesma pasta. Abra-o em um programa de planilhas para revisar o conteúdo e confirmar se os dados esperados estão presentes.
Prepare o arquivo para importação: O arquivo CSV gerado já tem as colunas necessárias, InvoiceNumber, ActivityName e EventTime, além de outros atributos recomendados. Ele está pronto para ser importado diretamente na ferramenta de Process Mining, sem formatação adicional.

Configuração

Credenciais do Salesforce: Informe seu nome de usuário e senha do Salesforce e o token de segurança. O token é necessário para acessar a API de fora dos intervalos de IP confiáveis da sua organização.
URL da instância do Salesforce: Informe o domínio da sua instância do Salesforce, como your_instance.my.salesforce.com. Se estiver usando uma sandbox, a URL será diferente, por exemplo, test.salesforce.com.
Filtros de período: O script inclui as variáveis START_DATE e END_DATE. Recomendamos começar com um período menor, como 3 a 6 meses, para controlar o volume de dados e respeitar os limites da API. Essas datas filtram a consulta inicial pelas datas de criação das faturas.
Nomes de API de objetos e campos: O script usa nomes de API de exemplo para objetos e campos, como Invoice__c e Status__c. Substitua-os pelos nomes exatos do seu modelo de dados do Salesforce. Você encontra esses nomes em Setup, na seção Object Manager.
Pré-requisitos para o rastreamento: A precisão do Event Log, especialmente para mudanças de status, depende inteiramente de o rastreamento do histórico de campos do Salesforce estar ativado para os campos relevantes antes da ocorrência das transações. Se não estava ativado, as mudanças históricas não serão capturadas.
Limites de chamadas da API: O Salesforce impõe limites 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 com períodos menores ou agendá-la fora dos horários de pico para evitar atingir esses limites.

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

Selecione uma plataforma ETL ou iPaaS com um conector compatível com o Salesforce Sales Cloud e crie uma conexão usando o método de autenticação exigido pelo Salesforce. Informe apenas a string de conexão, as credenciais, o identificador da organização ou os valores específicos do ambiente na configuração da plataforma.
Confirme se a organização do Salesforce conectada disponibiliza o objeto de faturas, o histórico de status das faturas ou a fonte de auditoria, os registros de atividades relacionados, os registros de pagamentos e todos os registros de integração contábil necessários para o processo. Substitua cada referência de objeto ou campo entre colchetes na consulta pelos nomes correspondentes configurados no seu ambiente Salesforce.
Configure os parâmetros de extração incremental com uma data de início e uma data de término. Use, conforme aplicável, as datas de criação da fatura, mudança de status, atividade, pagamento, lançamento contábil, conciliação e encerramento. Inclua um período retroativo suficiente para abranger os casos criados antes do intervalo selecionado, mas que permaneceram ativos durante ele.
Adicione a consulta completa abaixo ao componente de consulta ou transformação do Salesforce na ferramenta ETL. Se o conector não aceitar a sintaxe apresentada, reproduza a mesma lógica usando componentes visuais de origem, filtro, junção, campo calculado e união. Não conte com o ProcessMind para inferir eventos a partir de mudanças de status: cada atividade precisa ser gerada como uma linha explícita do Event Log.
Configure os mapeamentos de origem para o objeto de faturas, o histórico de status das faturas ou a fonte de auditoria, os registros de atividades relacionados, os registros de pagamentos, os registros de lançamentos contábeis e os registros de conciliação. Mapeie o número da fatura para InvoiceNumber, o nome da atividade para ActivityName e o timestamp relevante para EventTime. Preserve os atributos recomendados sempre que os valores estiverem disponíveis na origem.
Aplique as regras de transformação. Converta todos os timestamps para um único fuso horário acordado, padronize os valores de status, converta InvoiceTotalAmount para um tipo numérico e PaymentDueDate para uma data ou timestamp, e remova os registros sem InvoiceNumber ou EventTime. Para Payment Due Date Reached, gere uma linha explícita usando PaymentDueDate como EventTime somente quando a data de vencimento estiver dentro do período de extração e o registro da fatura estiver disponível.
Remova eventos duplicados usando InvoiceNumber, ActivityName, EventTime e o identificador do registro de origem, quando disponível. Preserve ocorrências distintas quando a origem contiver vários envios, rejeições, lembretes, correções, pagamentos, lançamentos ou eventos de conciliação legítimos.
Valide se a saída contém os 13 valores obrigatórios de ActivityName, se cada linha tem InvoiceNumber e EventTime e se os timestamps dos eventos estão na ordem correta dentro de cada fatura, conforme os dados de origem permitirem.
Carregue o resultado transformado em um arquivo CSV, Parquet ou outro formato de Event Log compatível com o ProcessMind. Use InvoiceNumber como identificador do caso, ActivityName como coluna de atividade e EventTime como coluna de data e hora do evento. Inclua UserResponsible, BillingDepartment, InvoiceStatus, InvoiceTotalAmount e PaymentDueDate como atributos adicionais.
Exporte o Event Log final e importe-o no ProcessMind. Durante a importação, confirme se o ProcessMind lê as linhas como foram fornecidas e se não precisa derivar atividades ausentes.

Configuração

Conector: Use o conector pré-configurado do Salesforce da plataforma ETL ou iPaaS e autentique-se com um usuário de integração que tenha acesso de leitura a todas as fontes configuradas de faturas, histórico de status, atividades, pagamentos, lançamentos contábeis e conciliações.
Mapeamento de objetos e campos: Substitua [Invoice object], [Invoice Number field], [Invoice Created Date field] e todas as outras referências entre colchetes pelos nomes usados na organização Salesforce de destino. As configurações do Salesforce costumam usar objetos e campos personalizados; por isso, confirme os mapeamentos em vez de presumir que estejam corretos.
Período: Comece com 3 a 6 meses de dados. Amplie o período retroativo quando as faturas puderem permanecer abertas entre períodos de relatório e inclua uma margem para mudanças de status, pagamentos, lembretes e eventos de conciliação.
Extração incremental: Quando disponível, use como marcador a data e hora da última modificação extraída com sucesso na origem. Armazene esse marcador fora do Event Log e reprocesse um pequeno intervalo sobreposto para não perder atualizações recebidas com atraso.
Filtros: Aplique filtros de empresa, unidade de negócio, entidade legal, moeda, tipo de fatura e ciclo de vida somente quando forem exigidos explicitamente pela análise. Substitua [Company filter] e [Document type filter] pelos critérios específicos da organização ou remova-os quando não forem aplicáveis.
Histórico de status: Prefira uma fonte que preserve todas as transições de status. O campo que mostra apenas o status atual da fatura não permite reconstruir com segurança eventos anteriores de aprovação, rejeição, correção, envio, encerramento ou baixa contábil.
Evento calculado de vencimento: Payment Due Date Reached é gerado a partir de PaymentDueDate e não corresponde a uma ação de usuário no Salesforce. Defina se o evento deve ser gerado para todas as faturas ou apenas para as que continuaram em aberto até a data de vencimento.
Registros relacionados: Configure as junções usando as chaves de relacionamento reais da organização Salesforce. Não presuma que faturas, pagamentos, atividades, lançamentos contábeis ou registros de conciliação usem o mesmo campo de relacionamento em todas as implementações.
Performance: Filtre os registros de origem por data antes das junções, selecione apenas os campos necessários, use a paginação do conector, ative a extração incremental e divida períodos grandes em lotes, quando houver suporte. Evite extrair repetidamente todo o histórico.
Tipos de dados: Padronize os timestamps em um único fuso horário, preserve o timestamp original da origem quando a auditabilidade for necessária e use um tipo decimal para InvoiceTotalAmount.
Pré-requisitos: A licença da ferramenta ETL ou iPaaS precisa incluir o conector do Salesforce, o acesso à API deve estar ativado para o usuário de integração e esse usuário precisa ter permissões de objeto, campo e registro para todas as fontes configuradas.
Segurança: Armazene as credenciais no gerenciador de segredos da plataforma, limite o acesso aos dados extraídos a usuários autorizados e respeite os limites do Salesforce e da organização para chamadas de API e retenção de dados.

Consulta de exemplo config

SELECT
    CAST(i.[Invoice Number field] AS VARCHAR(255)) AS InvoiceNumber,
    'Invoice Generated' AS ActivityName,
    CAST(i.[Invoice Created Date field] AS TIMESTAMP) AS EventTime,
    CAST(i.[Invoice Created By field] AS VARCHAR(255)) AS UserResponsible,
    CAST(i.[Billing Department field] AS VARCHAR(255)) AS BillingDepartment,
    CAST(i.[Invoice Status field] AS VARCHAR(255)) AS InvoiceStatus,
    CAST(i.[Invoice Total Amount field] AS DECIMAL(18,2)) AS InvoiceTotalAmount,
    CAST(i.[Payment Due Date field] AS DATE) AS PaymentDueDate
FROM [Invoice object] i
WHERE i.[Invoice Number field] IS NOT NULL
  AND i.[Invoice Created Date field] >= [Start date parameter]
  AND i.[Invoice Created Date field] < [End date parameter]
  AND [Company filter]
  AND [Document type filter]
UNION ALL
SELECT
    CAST(i.[Invoice Number field] AS VARCHAR(255)) AS InvoiceNumber,
    'Invoice Submitted for Approval' AS ActivityName,
    CAST(h.[Status Change Date field] AS TIMESTAMP) AS EventTime,
    CAST(h.[Changed By field] AS VARCHAR(255)) AS UserResponsible,
    CAST(i.[Billing Department field] AS VARCHAR(255)) AS BillingDepartment,
    CAST(h.[New Status field] AS VARCHAR(255)) AS InvoiceStatus,
    CAST(i.[Invoice Total Amount field] AS DECIMAL(18,2)) AS InvoiceTotalAmount,
    CAST(i.[Payment Due Date field] AS DATE) AS PaymentDueDate
FROM [Invoice object] i
JOIN [Invoice status history object] h ON h.[Invoice relationship field] = i.[Invoice record identifier field]
WHERE i.[Invoice Number field] IS NOT NULL
  AND h.[New Status field] = 'Pending Approval'
  AND h.[Status Change Date field] >= [Start date parameter]
  AND h.[Status Change Date field] < [End date parameter]
  AND [Company filter]
  AND [Document type filter]
UNION ALL
SELECT
    CAST(i.[Invoice Number field] AS VARCHAR(255)) AS InvoiceNumber,
    'Invoice Approved' AS ActivityName,
    CAST(h.[Status Change Date field] AS TIMESTAMP) AS EventTime,
    CAST(h.[Changed By field] AS VARCHAR(255)) AS UserResponsible,
    CAST(i.[Billing Department field] AS VARCHAR(255)) AS BillingDepartment,
    CAST(h.[New Status field] AS VARCHAR(255)) AS InvoiceStatus,
    CAST(i.[Invoice Total Amount field] AS DECIMAL(18,2)) AS InvoiceTotalAmount,
    CAST(i.[Payment Due Date field] AS DATE) AS PaymentDueDate
FROM [Invoice object] i
JOIN [Invoice status history object] h ON h.[Invoice relationship field] = i.[Invoice record identifier field]
WHERE i.[Invoice Number field] IS NOT NULL
  AND h.[New Status field] = 'Approved'
  AND h.[Status Change Date field] >= [Start date parameter]
  AND h.[Status Change Date field] < [End date parameter]
  AND [Company filter]
  AND [Document type filter]
UNION ALL
SELECT
    CAST(i.[Invoice Number field] AS VARCHAR(255)) AS InvoiceNumber,
    'Invoice Rejected' AS ActivityName,
    CAST(h.[Status Change Date field] AS TIMESTAMP) AS EventTime,
    CAST(h.[Changed By field] AS VARCHAR(255)) AS UserResponsible,
    CAST(i.[Billing Department field] AS VARCHAR(255)) AS BillingDepartment,
    CAST(h.[New Status field] AS VARCHAR(255)) AS InvoiceStatus,
    CAST(i.[Invoice Total Amount field] AS DECIMAL(18,2)) AS InvoiceTotalAmount,
    CAST(i.[Payment Due Date field] AS DATE) AS PaymentDueDate
FROM [Invoice object] i
JOIN [Invoice status history object] h ON h.[Invoice relationship field] = i.[Invoice record identifier field]
WHERE i.[Invoice Number field] IS NOT NULL
  AND h.[New Status field] = 'Rejected'
  AND h.[Status Change Date field] >= [Start date parameter]
  AND h.[Status Change Date field] < [End date parameter]
  AND [Company filter]
  AND [Document type filter]
UNION ALL
SELECT
    CAST(i.[Invoice Number field] AS VARCHAR(255)) AS InvoiceNumber,
    'Invoice Corrected' AS ActivityName,
    CAST(h.[Status Change Date field] AS TIMESTAMP) AS EventTime,
    CAST(h.[Changed By field] AS VARCHAR(255)) AS UserResponsible,
    CAST(i.[Billing Department field] AS VARCHAR(255)) AS BillingDepartment,
    CAST(h.[New Status field] AS VARCHAR(255)) AS InvoiceStatus,
    CAST(i.[Invoice Total Amount field] AS DECIMAL(18,2)) AS InvoiceTotalAmount,
    CAST(i.[Payment Due Date field] AS DATE) AS PaymentDueDate
FROM [Invoice object] i
JOIN [Invoice status history object] h ON h.[Invoice relationship field] = i.[Invoice record identifier field]
WHERE i.[Invoice Number field] IS NOT NULL
  AND h.[Previous Status field] = 'Rejected'
  AND h.[New Status field] = 'Draft'
  AND h.[Status Change Date field] >= [Start date parameter]
  AND h.[Status Change Date field] < [End date parameter]
  AND [Company filter]
  AND [Document type filter]
UNION ALL
SELECT
    CAST(i.[Invoice Number field] AS VARCHAR(255)) AS InvoiceNumber,
    'Invoice Sent to Customer' AS ActivityName,
    CAST(COALESCE(i.[Sent Date field], h.[Status Change Date field]) AS TIMESTAMP) AS EventTime,
    CAST(COALESCE(i.[Sent By field], h.[Changed By field]) AS VARCHAR(255)) AS UserResponsible,
    CAST(i.[Billing Department field] AS VARCHAR(255)) AS BillingDepartment,
    CAST(COALESCE(h.[New Status field], i.[Invoice Status field]) AS VARCHAR(255)) AS InvoiceStatus,
    CAST(i.[Invoice Total Amount field] AS DECIMAL(18,2)) AS InvoiceTotalAmount,
    CAST(i.[Payment Due Date field] AS DATE) AS PaymentDueDate
FROM [Invoice object] i
LEFT JOIN [Invoice status history object] h
  ON h.[Invoice relationship field] = i.[Invoice record identifier field]
 AND h.[New Status field] = 'Sent'
WHERE i.[Invoice Number field] IS NOT NULL
  AND (i.[Sent Date field] IS NOT NULL OR h.[Status Change Date field] IS NOT NULL)
  AND COALESCE(i.[Sent Date field], h.[Status Change Date field]) >= [Start date parameter]
  AND COALESCE(i.[Sent Date field], h.[Status Change Date field]) < [End date parameter]
  AND [Company filter]
  AND [Document type filter]
UNION ALL
SELECT
    CAST(i.[Invoice Number field] AS VARCHAR(255)) AS InvoiceNumber,
    'Payment Due Date Reached' AS ActivityName,
    CAST(i.[Payment Due Date field] AS TIMESTAMP) AS EventTime,
    CAST(NULL AS VARCHAR(255)) AS UserResponsible,
    CAST(i.[Billing Department field] AS VARCHAR(255)) AS BillingDepartment,
    CAST(i.[Invoice Status field] AS VARCHAR(255)) AS InvoiceStatus,
    CAST(i.[Invoice Total Amount field] AS DECIMAL(18,2)) AS InvoiceTotalAmount,
    CAST(i.[Payment Due Date field] AS DATE) AS PaymentDueDate
FROM [Invoice object] i
WHERE i.[Invoice Number field] IS NOT NULL
  AND i.[Payment Due Date field] IS NOT NULL
  AND i.[Payment Due Date field] >= [Start date parameter]
  AND i.[Payment Due Date field] < [End date parameter]
  AND [Company filter]
  AND [Document type filter]
UNION ALL
SELECT
    CAST(i.[Invoice Number field] AS VARCHAR(255)) AS InvoiceNumber,
    'Payment Reminder Issued' AS ActivityName,
    CAST(a.[Activity Date field] AS TIMESTAMP) AS EventTime,
    CAST(a.[Assigned User field] AS VARCHAR(255)) AS UserResponsible,
    CAST(i.[Billing Department field] AS VARCHAR(255)) AS BillingDepartment,
    CAST(i.[Invoice Status field] AS VARCHAR(255)) AS InvoiceStatus,
    CAST(i.[Invoice Total Amount field] AS DECIMAL(18,2)) AS InvoiceTotalAmount,
    CAST(i.[Payment Due Date field] AS DATE) AS PaymentDueDate
FROM [Invoice object] i
JOIN [Activity object] a ON a.[Invoice relationship field] = i.[Invoice record identifier field]
WHERE i.[Invoice Number field] IS NOT NULL
  AND a.[Activity Type field] IN ('Task', 'Email')
  AND a.[Reminder Indicator field] = TRUE
  AND a.[Activity Date field] >= [Start date parameter]
  AND a.[Activity Date field] < [End date parameter]
  AND [Company filter]
  AND [Document type filter]
UNION ALL
SELECT
    CAST(i.[Invoice Number field] AS VARCHAR(255)) AS InvoiceNumber,
    'Customer Payment Received' AS ActivityName,
    CAST(p.[Payment Received Date field] AS TIMESTAMP) AS EventTime,
    CAST(p.[Recorded By field] AS VARCHAR(255)) AS UserResponsible,
    CAST(i.[Billing Department field] AS VARCHAR(255)) AS BillingDepartment,
    CAST(i.[Invoice Status field] AS VARCHAR(255)) AS InvoiceStatus,
    CAST(i.[Invoice Total Amount field] AS DECIMAL(18,2)) AS InvoiceTotalAmount,
    CAST(i.[Payment Due Date field] AS DATE) AS PaymentDueDate
FROM [Invoice object] i
JOIN [Payment object] p ON p.[Invoice relationship field] = i.[Invoice record identifier field]
WHERE i.[Invoice Number field] IS NOT NULL
  AND p.[Payment Received Date field] IS NOT NULL
  AND p.[Payment Received Date field] >= [Start date parameter]
  AND p.[Payment Received Date field] < [End date parameter]
  AND [Company filter]
  AND [Document type filter]
UNION ALL
SELECT
    CAST(i.[Invoice Number field] AS VARCHAR(255)) AS InvoiceNumber,
    'Payment Posted to Ledger' AS ActivityName,
    CAST(p.[Ledger Posting Date field] AS TIMESTAMP) AS EventTime,
    CAST(p.[Posted By field] AS VARCHAR(255)) AS UserResponsible,
    CAST(i.[Billing Department field] AS VARCHAR(255)) AS BillingDepartment,
    CAST(i.[Invoice Status field] AS VARCHAR(255)) AS InvoiceStatus,
    CAST(i.[Invoice Total Amount field] AS DECIMAL(18,2)) AS InvoiceTotalAmount,
    CAST(i.[Payment Due Date field] AS DATE) AS PaymentDueDate
FROM [Invoice object] i
JOIN [Payment object] p ON p.[Invoice relationship field] = i.[Invoice record identifier field]
WHERE i.[Invoice Number field] IS NOT NULL
  AND p.[Ledger Posting Date field] IS NOT NULL
  AND p.[Ledger Posting Date field] >= [Start date parameter]
  AND p.[Ledger Posting Date field] < [End date parameter]
  AND [Company filter]
  AND [Document type filter]
UNION ALL
SELECT
    CAST(i.[Invoice Number field] AS VARCHAR(255)) AS InvoiceNumber,
    'Cash Applied/Reconciled' AS ActivityName,
    CAST(r.[Reconciliation Date field] AS TIMESTAMP) AS EventTime,
    CAST(r.[Reconciled By field] AS VARCHAR(255)) AS UserResponsible,
    CAST(i.[Billing Department field] AS VARCHAR(255)) AS BillingDepartment,
    CAST(i.[Invoice Status field] AS VARCHAR(255)) AS InvoiceStatus,
    CAST(i.[Invoice Total Amount field] AS DECIMAL(18,2)) AS InvoiceTotalAmount,
    CAST(i.[Payment Due Date field] AS DATE) AS PaymentDueDate
FROM [Invoice object] i
JOIN [Reconciliation object] r ON r.[Invoice relationship field] = i.[Invoice record identifier field]
WHERE i.[Invoice Number field] IS NOT NULL
  AND r.[Reconciliation Date field] IS NOT NULL
  AND r.[Reconciliation Date field] >= [Start date parameter]
  AND r.[Reconciliation Date field] < [End date parameter]
  AND [Company filter]
  AND [Document type filter]
UNION ALL
SELECT
    CAST(i.[Invoice Number field] AS VARCHAR(255)) AS InvoiceNumber,
    'Invoice Closed' AS ActivityName,
    CAST(h.[Status Change Date field] AS TIMESTAMP) AS EventTime,
    CAST(h.[Changed By field] AS VARCHAR(255)) AS UserResponsible,
    CAST(i.[Billing Department field] AS VARCHAR(255)) AS BillingDepartment,
    CAST(h.[New Status field] AS VARCHAR(255)) AS InvoiceStatus,
    CAST(i.[Invoice Total Amount field] AS DECIMAL(18,2)) AS InvoiceTotalAmount,
    CAST(i.[Payment Due Date field] AS DATE) AS PaymentDueDate
FROM [Invoice object] i
JOIN [Invoice status history object] h ON h.[Invoice relationship field] = i.[Invoice record identifier field]
WHERE i.[Invoice Number field] IS NOT NULL
  AND h.[New Status field] = 'Closed'
  AND h.[Status Change Date field] >= [Start date parameter]
  AND h.[Status Change Date field] < [End date parameter]
  AND [Company filter]
  AND [Document type filter]
UNION ALL
SELECT
    CAST(i.[Invoice Number field] AS VARCHAR(255)) AS InvoiceNumber,
    'Invoice Written Off' AS ActivityName,
    CAST(h.[Status Change Date field] AS TIMESTAMP) AS EventTime,
    CAST(h.[Changed By field] AS VARCHAR(255)) AS UserResponsible,
    CAST(i.[Billing Department field] AS VARCHAR(255)) AS BillingDepartment,
    CAST(h.[New Status field] AS VARCHAR(255)) AS InvoiceStatus,
    CAST(i.[Invoice Total Amount field] AS DECIMAL(18,2)) AS InvoiceTotalAmount,
    CAST(i.[Payment Due Date field] AS DATE) AS PaymentDueDate
FROM [Invoice object] i
JOIN [Invoice status history object] h ON h.[Invoice relationship field] = i.[Invoice record identifier field]
WHERE i.[Invoice Number field] IS NOT NULL
  AND h.[New Status field] = 'Written Off'
  AND h.[Status Change Date field] >= [Start date parameter]
  AND h.[Status Change Date field] < [End date parameter]
  AND [Company filter]
  AND [Document type filter]

Pronto para começar?

Use este Template para dar início à análise do processo e descobrir oportunidades de melhoria significativa. Comece hoje a otimizar seu processo de faturamento e emissão de faturas.

Voltar ao guia de melhoria

Baixar Template

Receba mais rápido: otimize agora o faturamento e a emissão de faturas em O2C

Reduza em 30% o tempo de ciclo do faturamento e melhore o fluxo de caixa sem complicações.

Começar o teste grátis

Não é necessário informar cartão de crédito. Configuração simples em poucos minutos.

Seu Template de dados de Order to Cash, faturamento e emissão de faturas

Seu Template de dados de Order to Cash, faturamento e emissão de faturas

Atributos de Order to Cash, faturamento e emissão de faturas

Atividades de Order to Cash, faturamento e emissão de faturas

Guias de extração

Criador de relatórios do Salesforce e serviço de exportação de dados

Etapas

Configuração

Consulta de exemplo config

Script Python usando a API REST do Salesforce

Etapas

Configuração

Consulta de exemplo python

Extração com ferramenta ETL usando conector pré-configurado do Salesforce

Etapas

Configuração

Consulta de exemplo config

Pronto para começar?

Receba mais rápido: otimize agora o faturamento e a emissão de faturas em O2C