> Melhoria contínua de processos > Gestão de Crédito e Cobrança > HighRadius > Template de dados

Seu Template de dados de Gestão de crédito e cobrança

HighRadius

Atributos de Gestão de Crédito e Cobrança (21) Atividades de Gestão de Crédito e Cobrança (15) Guias de extração (2)

Seu Template de dados de Gestão de crédito e cobrança

Este Template oferece um guia estruturado para coletar os dados necessários à análise do seu processo de gestão de crédito e cobrança. Ele apresenta os atributos essenciais a serem capturados, as principais atividades a serem acompanhadas e orientações práticas para extrair essas informações do seu sistema HighRadius. Usar este Template ajudará você a preparar seus dados com eficiência para o Process Mining.

Atributos recomendados para coleta
Principais atividades para acompanhar a visibilidade do processo
Orientações de extração específicas do HighRadius

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

Baixar Template

Atributos de Gestão de Crédito e Cobrança

Estes são os campos de dados recomendados para incluir no seu Event Log e realizar uma análise abrangente do seu processo de gestão de crédito e cobrança.

3 Obrigatório 7 Recomendado 11 Opcional

	Nome	Descrição
	Horário do evento EventTime	O carimbo de data e hora que indica quando a atividade ocorreu, incluindo data e horário.
Descrição O Event Time fornece a data e o horário exatos de cada atividade do processo. Esses dados cronológicos são a base do process mining, permitindo ordenar corretamente os eventos e calcular as durações entre eles. Esse atributo é usado para calcular todos os KPIs baseados em tempo, como os tempos de ciclo da resolução de contestações, da aprovação de crédito e do registro de pagamentos. Ele também é usado para analisar a performance do processo ao longo do tempo, identificar atividades que causam atrasos e medir a aderência aos acordos de nível de serviço. Por que isso importa Ele fornece o contexto cronológico de todas as atividades, essencial para calcular tempos de ciclo, descobrir gargalos e entender a dinâmica do processo. Onde obter Todo registro transacional ou Event Log no HighRadius deve ter um campo de carimbo de data e hora correspondente, geralmente chamado de 'Creation Date' ou 'Timestamp'. Exemplos 2023-03-15T10:00:00Z2023-04-01T14:35:10Z2023-05-20T09:12:45Z
	Nome da atividade ActivityName	O nome do evento de negócio específico que ocorreu em determinado momento para uma fatura.
Descrição O Activity Name descreve uma etapa do processo de crédito e cobrança, como 'Invoice Generated', 'Overdue Reminder Sent' ou 'Payment Received'. Essa sequência de atividades forma o fluxo do processo de cada caso. Analisar esse atributo permite descobrir e visualizar o mapa real do processo. Isso ajuda a identificar gargalos, desvios do procedimento padrão e ciclos de retrabalho. A frequência e a ordem de atividades como 'Collection Call Logged' ou 'Dispute Registered' são essenciais para entender a eficiência do processo. Por que isso importa Esse atributo define as etapas do processo, permitindo reconstruir e analisar o fluxo do processo de cada fatura. Onde obter Normalmente, ele é derivado de Event Logs, mudanças de status ou registros de ações específicas nos diversos módulos da plataforma HighRadius. Exemplos Fatura enviada ao clienteProcedimento de cobrança iniciadoPagamento recebidoContestação resolvida
	Número da fatura InvoiceNumber	O identificador exclusivo de cada fatura, que funciona como o identificador principal do caso no processo de credit-to-cash.
Descrição O Invoice Number é a chave central que conecta todas as atividades relacionadas a uma única transação de contas a receber. Ele permite acompanhar todo o ciclo de vida, desde a geração da fatura, passando pelas diversas atividades de gestão de crédito e cobrança, até a liquidação final ou a baixa como perda. Na análise de process mining, esse atributo é essencial para agrupar todos os eventos relacionados em um único caso. Isso permite visualizar os fluxos de processo de ponta a ponta, calcular durações do caso, como o Days Sales Outstanding (DSO), e analisar os diferentes caminhos que uma fatura pode seguir, como resolução de contestações ou procedimentos de cobrança. Por que isso importa É o identificador fundamental que conecta todas as etapas do processo, permitindo analisar a jornada completa de uma fatura, da criação ao encerramento. Onde obter Este é um campo principal no HighRadius, normalmente encontrado nos objetos centrais de dados de faturas ou contas a receber. Exemplos INV-2023-001239876543210SI-55482
	Condições de pagamento PaymentTerms	As condições acordadas que definem quando o cliente deve pagar uma fatura.
Descrição Payment Terms especifica as condições de pagamento, como 'Net 30', 'Net 60' ou 'Due on Receipt'. Esse atributo é a base para calcular a data de vencimento da fatura. Esse é um atributo essencial para o Dashboard e o KPI 'Payment Terms Adherence'. Analisá-lo ajuda a identificar se as condições padrão estão sendo aplicadas de forma consistente e quais condições estão associadas a taxas mais altas de pagamentos atrasados. Esse insight pode orientar a política de crédito e as negociações com clientes. Por que isso importa Ele estabelece a referência para os prazos de pagamento esperados, sendo essencial para calcular datas de vencimento e medir a adesão dos clientes aos acordos de pagamento. Onde obter Essa informação normalmente está no cabeçalho da fatura ou nos dados mestres do cliente dentro da HighRadius ou do ERP de origem. Exemplos Líquido 30 diasLíquido 60 diasVencimento no recebimento
	Data de vencimento DueDate	A data calculada até a qual o pagamento da fatura deve ser realizado.
Descrição A Due Date é a data específica do calendário até a qual uma fatura deve ser paga para não ser considerada vencida. Ela normalmente é calculada com base na data da fatura e nas condições de pagamento. Esse atributo é fundamental para todas as análises de vencimento. Ele é a principal entrada para calcular 'Days Overdue', acionar procedimentos de cobrança e medir o KPI 'Payment Terms Adherence Rate'. Também dá suporte direto a Dashboards relacionados ao aging de faturas e à eficácia da cobrança. Por que isso importa Essa é a data crítica que determina se uma fatura está em dia ou vencida, acionando todas as atividades de cobrança e os KPIs subsequentes. Onde obter Esse é um campo padrão no registro da fatura na HighRadius. Ele pode ser preenchido pelo ERP de origem ou calculado dentro da HighRadius. Exemplos 2023-04-142023-05-312023-06-20
	ID do cliente CustomerId	O identificador exclusivo do cliente associado à fatura.
Descrição O Customer ID vincula uma fatura à entidade específica do cliente. Isso permite agregar e analisar os dados do processo a partir da perspectiva do cliente. Esse atributo é essencial para analisar o comportamento de pagamento de diferentes clientes ou segmentos. Ele ajuda a responder perguntas como: quais clientes atrasam com frequência? Quais clientes abrem mais disputas? Também dá suporte a Dashboards como Payment Terms Adherence e permite segmentar KPIs por cliente. Por que isso importa Ele permite analisar, no nível do cliente, o comportamento de pagamento, a frequência de disputas e a interação geral com o processo, ajudando a adaptar as estratégias de cobrança. Onde obter Esse é um campo padrão no cabeçalho da fatura ou nos dados da conta do cliente dentro da HighRadius. Exemplos CUST-001ACME-CORPGLOBEX-US
	Motivo da disputa DisputeReason	O código ou a descrição do motivo informado quando uma fatura é contestada pelo cliente.
Descrição Quando um cliente abre uma disputa, normalmente informa um motivo, como 'Incorrect Pricing', 'Damaged Goods' ou 'Duplicate Invoice'. Esse atributo registra esse motivo. Analisar o Dispute Reason é essencial para o Dashboard 'Invoice Dispute Resolution Time'. Isso ajuda a identificar as causas-raiz das disputas, permitindo que a empresa trate problemas sistêmicos em preços, envio ou faturamento. Reduzir as disputas na origem pode acelerar significativamente o fluxo de caixa. Por que isso importa Ele fornece insight sobre as causas-raiz dos atrasos de pagamento, permitindo melhorias direcionadas no processo para evitar disputas futuras. Onde obter Essas informações são registradas no módulo de gestão de disputas ou deductions da HighRadius quando uma disputa é aberta. Exemplos Quantidade incorretaDivergência de preçoMercadoria danificadaCobrança duplicada
	Nome do coletor CollectorName	O nome do usuário ou agente responsável por executar uma atividade de cobrança.
Descrição Esse atributo identifica o agente de cobrança, analista de crédito ou outro usuário que executou uma atividade manual, como 'Collection Call Logged' ou 'Dispute Resolved'. Na análise, isso permite comparar a performance de diferentes coletores ou equipes. Ajuda a entender a distribuição da carga de trabalho, avaliar a eficácia de estratégias individuais, como a taxa de sucesso de ligações de cobrança por coletor, e identificar oportunidades de capacitação. Também é essencial para a gestão de recursos e o planejamento de capacidade. Por que isso importa Ele vincula as atividades do processo a pessoas específicas, permitindo analisar a performance da equipe, a carga de trabalho e a eficácia das intervenções manuais. Onde obter Essas informações normalmente ficam armazenadas nos registros de atividades ou nos registros de ações dos usuários dentro do módulo Collections da HighRadius. Exemplos John SmithJane DoeEmily Jones
	Status do pagamento PaymentStatus	O status financeiro atual da fatura, como Aberta, Paga, Vencida ou Em disputa.
Descrição Payment Status oferece uma visão instantânea da etapa em que a fatura está no seu ciclo de vida. Ele indica se o pagamento ainda está pendente, se foi pago total ou parcialmente, se a data de vencimento já passou ou se a fatura está sob investigação devido a uma disputa. Esse atributo é central para o Dashboard 'Invoice Payment Status & Aging'. Ele permite segmentar rapidamente a carteira de contas a receber para entender a saúde financeira geral e priorizar os esforços de cobrança em itens vencidos ou em disputa. Por que isso importa Ele categoriza as faturas em grupos acionáveis, oferecendo visibilidade imediata sobre o estado das contas a receber e ajudando a priorizar as atividades de cobrança. Onde obter Esse é um campo de status central no registro da fatura ou de contas a receber dentro da HighRadius. Exemplos Em abertoPagoEm atrasoContestadoBaixado como perda
	Valor da fatura InvoiceAmount	O valor monetário total da fatura.
Descrição Esse atributo representa o valor total devido na fatura. É uma métrica financeira essencial para entender o valor associado a cada caso. No Process Mining, o Invoice Amount é usado para priorizar os esforços de cobrança, por exemplo, concentrando-se em faturas vencidas de alto valor. Ele é fundamental para KPIs financeiros como Days Sales Outstanding (DSO) e é usado no Dashboard Invoice Write-Off Analysis para quantificar o impacto financeiro da inadimplência. Por que isso importa Ele fornece o contexto financeiro de cada caso, permitindo análises baseadas em valor, priorização do trabalho e quantificação de impactos financeiros, como baixas contábeis. Onde obter Esse é um campo padrão nos dados do cabeçalho da fatura dentro da HighRadius. Exemplos 5000.001250.7525000.50
	Data da promessa de pagamento PromiseToPayDate	A data em que o cliente prometeu realizar o pagamento de uma fatura vencida.
Descrição Quando um coletor entra em contato com um cliente, pode obter uma 'Promise to Pay', que é o compromisso do cliente de pagar até determinada data. Esse atributo registra a data prometida. Analisar esses dados é importante para avaliar a confiabilidade das promessas dos clientes e a eficácia dos coletores em obter compromissos firmes. Eles podem ser usados para acompanhar a taxa de promessas cumpridas, um indicador de performance importante para a equipe de cobrança. Por que isso importa Ele registra um resultado importante das atividades de cobrança e é usado para medir a eficácia dos acompanhamentos e a confiabilidade dos compromissos assumidos pelos clientes. Onde obter Essa data é registrada quando uma atividade de 'Promise to Pay' é lançada no módulo Collections da HighRadius. Exemplos 2023-06-152023-07-012023-06-25
	Dias em atraso DaysOverdue	O número de dias que uma fatura está vencida. O valor é zero se a fatura ainda não venceu ou foi paga em dia.
Descrição Days Overdue é uma métrica calculada que mede a diferença entre a data atual, para faturas em aberto, ou a data de pagamento, para faturas pagas, e a data de vencimento da fatura. É um indicador importante de inadimplência. Esse atributo é a base do Dashboard 'Invoice Payment Status & Aging', no qual é usado para agrupar as contas a receber em faixas de aging, como 1 a 30 dias e 31 a 60 dias. Ele também é um componente do cálculo de Days Sales Outstanding (DSO) e ajuda a priorizar os esforços de cobrança nas contas mais atrasadas. Por que isso importa Essa métrica quantifica diretamente os atrasos de pagamento, sendo essencial para a análise de aging, a priorização das cobranças e o cálculo do DSO. Onde obter Esse não é um campo armazenado. Ele é calculado durante a transformação dos dados usando Due Date e Payment Date ou a data atual. Exemplos 1545092
	É automatizado IsAutomated	Um indicador booleano que informa se uma atividade foi executada automaticamente pelo sistema ou manualmente por um usuário.
Descrição Esse atributo calculado diferencia eventos gerados pelo sistema, como 'Overdue Reminder Sent' em uma execução automatizada de cobrança, de ações realizadas por pessoas, como 'Collection Call Logged'. Esse indicador é essencial para calcular o KPI 'Automated Collection Activity Rate'. Ele ajuda a medir o nível de automação do processo de cobrança, identificar oportunidades para automatizar ainda mais e analisar a eficácia relativa dos contatos automatizados e manuais. Por que isso importa Ele ajuda a medir o grau de automação do processo, permitindo analisar a eficiência e a eficácia dos sistemas automatizados em comparação com os esforços manuais. Onde obter Esse atributo é derivado durante a transformação dos dados. É necessário criar um mapeamento que marque determinados Activity Names como automatizados com base no conhecimento do negócio. Exemplos truefalse
	Horário de término EndTime	O carimbo de data e hora que indica quando uma atividade foi concluída.
Descrição O End Time marca a conclusão de uma atividade. Embora muitas atividades em collections sejam eventos instantâneos, em que Start Time é igual a End Time, algumas atividades, como 'Dispute Resolution', podem ter uma duração distinta. Quando disponível, esse atributo é usado com Start Time para calcular o Processing Time de atividades individuais. Isso ajuda a identificar quais etapas específicas, e não apenas os intervalos entre elas, estão consumindo mais tempo e recursos. Por que isso importa Ele permite medir com precisão a duração de cada atividade, oferecendo uma visão mais detalhada de onde o tempo está sendo gasto no processo. Onde obter Consulte a documentação da HighRadius. Essa informação pode estar disponível para determinadas atividades registradas que têm um estado inicial e final. Exemplos 2023-03-15T10:45:00Z2023-04-01T15:00:10Z2023-05-20T11:15:00Z
	Moeda Currency	O código da moeda do valor da fatura.
Descrição Esse atributo especifica a moeda da fatura, como USD, EUR ou JPY. Ele fornece o contexto essencial para valores monetários, como Invoice Amount. Em qualquer empresa multinacional, esse campo é indispensável para uma análise financeira precisa. Ele garante que os valores monetários sejam interpretados corretamente e permite a conversão adequada de moedas ao agregar dados para relatórios globais. Por que isso importa Ele é essencial para interpretar corretamente todos os valores monetários, evitando cálculos financeiros e relatórios imprecisos em ambientes com várias moedas. Onde obter Esse é um campo padrão no registro da fatura, geralmente localizado ao lado de Invoice Amount. Exemplos USDEURGBP
	Motivo da baixa contábil WriteOffReason	O código ou a explicação do motivo pelo qual uma fatura foi baixada como perda por inadimplência.
Descrição Quando uma fatura é considerada incobrável, ela é baixada. Esse atributo registra o motivo da baixa, como 'Customer Bankruptcy', 'Unresolved Dispute' ou 'Small Balance Write-Off'. Esse é um atributo essencial para o Dashboard 'Invoice Write-Off Analysis'. Ele ajuda na análise das causas-raiz das perdas financeiras, fornecendo insights que podem ser usados para aprimorar as políticas de crédito, melhorar o tratamento de disputas ou ajustar as estratégias de cobrança para minimizar futuras baixas. Por que isso importa Ele explica os motivos da perda de receita, fornecendo feedback essencial para melhorar a avaliação de risco de crédito e as políticas de cobrança. Onde obter Essas informações são registradas quando a atividade 'Invoice Written Off' é processada, normalmente no módulo financeiro ou de collections da HighRadius. Exemplos FalênciaPrazo prescricional expiradoCusto da cobrança superior à dívida
	Nível de cobrança DunningLevel	A etapa ou o nível alcançado no processo automatizado de cobrança de uma fatura vencida.
Descrição O Dunning Level indica a intensidade do esforço de cobrança e geralmente corresponde a uma sequência de lembretes ou avisos automáticos enviados ao cliente. Por exemplo, o Nível 1 pode ser um lembrete amigável, enquanto o Nível 3 pode ser um aviso final. Esse atributo é essencial para o Dashboard 'Dunning Strategy Effectiveness'. Ao analisar quais níveis de cobrança levam mais frequentemente ao pagamento, as empresas podem otimizar seus Workflows de cobrança, garantindo que sejam eficazes sem adotar uma abordagem excessivamente agressiva que prejudique o relacionamento com os clientes. Por que isso importa Ele acompanha a escalada das atividades de cobrança, permitindo analisar quais estratégias de cobrança são mais eficazes para estimular o pagamento. Onde obter Esse é um campo de status gerenciado pelo mecanismo automatizado de collections ou pelo Workflow de cobrança dentro da HighRadius. Exemplos 123 - Aviso finalCobrança judicial
	País Country	O país do cliente associado à fatura.
Descrição Esse atributo especifica o país onde o cliente está localizado. Ele permite segmentar geograficamente o processo de crédito e cobrança. Analisar os dados por país pode revelar diferenças regionais no comportamento de pagamento, na eficácia das estratégias de cobrança e nos motivos mais comuns de disputa. Essas informações são essenciais para adaptar políticas regionais e gerar relatórios gerenciais de alto nível em organizações globais. Por que isso importa Ele permite realizar análises geográficas, revelando tendências regionais no comportamento de pagamento e ajudando a adaptar as estratégias de cobrança. Onde obter Essas informações fazem parte dos dados mestres do cliente, normalmente disponíveis na HighRadius ou sincronizadas a partir de um ERP de origem. Exemplos USAAlemanhaBrasil
	Sistema de origem SourceSystem	O sistema de onde os dados se originam.
Descrição Esse atributo identifica o sistema de origem em que os dados do evento foram gerados. Nesta visão do processo, o valor normalmente será 'HighRadius'. Em ambientes com vários sistemas, esse campo é essencial para entender a linhagem dos dados e rastrear as informações até sua origem. Ele ajuda a diferenciar processos que podem abranger diferentes plataformas, como um ERP e uma ferramenta especializada em cobranças. Por que isso importa Ele esclarece a origem dos dados, algo importante para a governança e a validação dos dados e para entender o cenário tecnológico do processo. Onde obter Normalmente, esse é um valor estático adicionado durante o processo de extração e transformação dos dados para identificar o conjunto de dados. Exemplos HighRadiusHighRadius-CollectionsHighRadius-CashApp
	Última atualização dos dados LastDataUpdate	O carimbo de data e hora em que os dados deste registro foram atualizados pela última vez a partir do sistema de origem.
Descrição Esse atributo indica o quão recentes são os dados. Ele registra a data e o horário da última extração ou atualização dos dados do HighRadius. Na análise, esse campo fornece contexto sobre a atualidade dos insights. Ele é essencial para que Dashboards e relatórios mostrem o quão atuais são as informações, garantindo que as decisões de negócio sejam baseadas em dados atualizados. Por que isso importa Ele oferece transparência sobre a atualidade dos dados, algo essencial para gerar confiança na análise e tomar decisões bem fundamentadas. Onde obter Esse carimbo de data e hora é gerado e adicionado a cada registro pelo pipeline de ingestão de dados durante o processo de extração. Exemplos 2023-06-10T02:00:00Z2023-06-11T02:00:00Z2023-06-12T02:00:00Z
	Unidade de negócio BusinessUnit	A unidade de negócio ou divisão interna responsável pela venda ou pela fatura.
Descrição O atributo Business Unit associa a fatura a uma parte específica da organização, como 'Retail', 'Wholesale' ou 'Services'. Isso permite detalhar a análise de performance por diferentes segmentos de negócio. A gestão pode comparar KPIs como DSO, taxas de disputa e baixas contábeis entre unidades de negócio para identificar áreas de excelência ou que precisam de melhorias. Isso ajuda a responsabilizar cada parte da organização pela performance das suas contas a receber. Por que isso importa Ele permite comparar a performance entre diferentes partes da organização, ajudando a identificar quais divisões têm os processos de crédito a recebimento mais eficazes. Onde obter Esses são dados organizacionais, normalmente encontrados na fatura ou derivados do pedido de venda ou da conta do cliente associada na HighRadius ou no ERP. Exemplos BU-América do NorteDivisão de serviçosManufatura

Obrigatório Recomendado Opcional

Atividades de Gestão de Crédito e Cobrança

Estas são as principais etapas e marcos do processo que devem ser capturados no seu Event Log para uma descoberta e uma análise precisas do seu processo de gestão de crédito e cobrança.

7 Recomendado 8 Opcional

	Atividade	Descrição
	Contestação registrada	Esta atividade marca o momento em que um cliente apresenta uma contestação ou dedução relacionada a uma fatura, que então é registrada formalmente no HighRadius. Isso pausa o processo padrão de cobrança para o valor contestado.
Por que isso importa Este é o evento inicial para medir o tempo médio de resolução de contestações. Identificar quando e por que as contestações são abertas é essencial para tratar causas principais, como erros de faturamento ou problemas de envio. Onde obter Esse evento é capturado quando um usuário cria um caso de contestação vinculado a uma fatura no Deductions Cloud do HighRadius. Essa ação cria um registro de contestação com carimbo de data e hora. Captura Capturado a partir do carimbo de data e hora de criação do registro do caso de contestação associado à fatura. Tipo de evento explicit
	Contestação resolvida	Representa a conclusão do processo de gestão de contestações, quando o problema foi investigado e uma resolução foi alcançada. A fatura pode então seguir para pagamento ou baixa como perda.
Por que isso importa Este é o evento final para medir o tempo médio de resolução de contestações. Ciclos longos nessa etapa podem atrasar significativamente o recebimento e indicar ineficiências no processo. Onde obter Esse evento é capturado quando o status do caso de contestação muda para 'Resolved', 'Closed' ou um estado final semelhante. O carimbo de data e hora dessa mudança de status é usado para a atividade. Captura Inferido a partir do carimbo de data e hora em que o status do caso de contestação é atualizado para o estado final 'Resolved'. Tipo de evento inferred
	Data de vencimento do pagamento ultrapassada	Um evento calculado que ocorre quando a data atual ultrapassa a data de vencimento do pagamento da fatura. Essa atividade não representa uma ação de usuário ou do sistema, mas é uma mudança de estado crítica que aciona o processo de cobrança.
Por que isso importa Esta atividade é o principal gatilho para todas as atividades posteriores de cobrança. Ela separa as faturas pagas no prazo das faturas vencidas, permitindo analisar a eficácia da estratégia de cobrança. Onde obter Esse evento não é armazenado diretamente, mas calculado comparando o campo de data de vencimento da fatura com o carimbo de data e hora de outros eventos. Ele é derivado durante a transformação dos dados de process mining. Captura Calculado comparando due_date da fatura com a data atual ou o carimbo de data e hora do evento (Timestamp > Due Date). Tipo de evento calculated
	Fatura baixada como perda	Representa um final alternativo do ciclo de vida da fatura, quando a dívida é considerada incobrável e baixada como perda. Esse é um resultado indesejado.
Por que isso importa Acompanhar as baixas como perda é essencial para calcular a taxa de baixa de faturas e analisar as causas principais das perdas financeiras. Isso ajuda a identificar falhas na avaliação de crédito ou nos esforços de cobrança. Onde obter Esse evento é capturado quando uma transação específica para baixar o saldo da fatura como perda é registrada ou quando o status da fatura muda para 'Written-Off'. Captura Inferido a partir de uma mudança de status para 'Written-Off' ou do registro de um tipo específico de transação de baixa como perda contra a fatura. Tipo de evento inferred
	Fatura gerada	Este é o ponto de partida do ciclo de vida de uma fatura no processo de cobrança. Ele indica que uma fatura foi criada no sistema ERP e importada para o HighRadius para a gestão de contas a receber.
Por que isso importa Esta atividade funciona como o evento inicial principal da análise do processo invoice-to-cash. Todos os tempos de ciclo, como o Days Sales Outstanding (DSO), normalmente são medidos a partir deste ponto. Onde obter Este é um evento explícito capturado a partir da data de criação do registro da fatura no HighRadius, que normalmente é sincronizado com o ERP de origem, como SAP ou Oracle. Captura Capturado a partir do carimbo de data e hora de criação do registro da fatura nos dados de contas a receber. Tipo de evento explicit
	Fatura liquidada	Esta atividade indica o fim bem-sucedido do ciclo de vida da fatura, quando ela é totalmente paga e encerrada. Esse é o estado final desejado do processo.
Por que isso importa Este é normalmente o evento final do 'caminho feliz' do processo. Analisar os caminhos que levam a esse resultado ajuda a identificar boas práticas e estratégias de cobrança bem-sucedidas. Onde obter Normalmente, este não é um evento explícito, mas é inferido a partir da mudança do status da fatura para 'Closed' ou 'Cleared' e da redução do saldo a zero. O carimbo de data e hora do registro do pagamento final costuma ser usado como horário do evento. Captura Inferido a partir da mudança do status da fatura para 'Closed' ou quando o campo de saldo da fatura chega a zero. Tipo de evento inferred
	Pagamento recebido	Esta atividade marca o recebimento do pagamento de um cliente, geralmente registrado a partir de um extrato bancário ou arquivo de lockbox. Isso indica que os recursos foram recebidos, mas ainda não foram aplicados a uma fatura específica.
Por que isso importa Este é um marco crítico que geralmente interrompe a contagem do prazo de cobrança. Ele é o ponto de partida para medir o KPI do atraso entre recebimento e registro do pagamento, destacando atrasos na aplicação do caixa. Onde obter Isso é capturado nos registros de pagamento do Cash Application Cloud do HighRadius. Cada lote ou transação de pagamento proveniente de um arquivo bancário terá uma data de recebimento. Captura Capturado a partir do carimbo de data e hora do registro de pagamento quando ele é importado ou inserido no módulo de aplicação do caixa. Tipo de evento explicit
	Fatura enviada ao cliente	Esta atividade marca o momento em que a fatura é entregue ao cliente, normalmente por e-mail ou por um portal do cliente. O HighRadius pode automatizar e registrar esse evento de comunicação.
Por que isso importa Acompanhar isso ajuda a garantir que os clientes recebam as faturas rapidamente. Atrasos entre a geração e o envio da fatura podem impactar diretamente o prazo de pagamento e o DSO. Onde obter Esse evento costuma ser registrado explicitamente no histórico de correspondências ou atividades associado à fatura no módulo Collections Cloud. Ele também pode ser inferido a partir do status de um Workflow automatizado de correspondência. Captura Registrado no histórico de comunicação da fatura quando o envio por e-mail ou pelo portal é realizado. Tipo de evento explicit
	Lembrete de atraso enviado	Representa um lembrete automático ou manual enviado ao cliente sobre uma fatura vencida. O HighRadius automatiza essa atividade como parte das estratégias de cobrança, criando um registro da comunicação.
Por que isso importa Esta atividade é fundamental para medir a taxa de eficácia das cobranças. Ela permite analisar quantos lembretes são necessários antes que um pagamento seja recebido. Onde obter Este é um evento explícito registrado no log de atividades ou correspondências da fatura no Collections Cloud do HighRadius. Cada lembrete enviado terá uma entrada e um carimbo de data e hora correspondentes. Captura Capturado a partir do log de comunicação com carimbo de data e hora associado à fatura. Tipo de evento explicit
	Ligação de cobrança registrada	Representa uma ligação manual de cobrança feita por um agente ao cliente sobre uma fatura vencida. Os agentes registram os detalhes e o resultado da ligação diretamente no HighRadius.
Por que isso importa Esta atividade é essencial para avaliar a taxa de sucesso das ligações de cobrança e a eficiência das atividades de cobrança. Ela ajuda a diferenciar os esforços de cobrança automáticos dos manuais. Onde obter Este é um evento explícito criado quando um cobrador usa a função 'Log Call' ou 'Add Activity' na fatura ou na conta do cliente na interface do HighRadius. A entrada inclui um carimbo de data e hora. Captura Capturado na tabela de log de atividades, onde os cobradores registram ações manuais. Tipo de evento explicit
	Limite de crédito aprovado	Representa a conclusão bem-sucedida do processo de análise de crédito, quando um limite de crédito é oficialmente concedido ao cliente. Esse evento é registrado quando um gerente de crédito aprova a solicitação na plataforma HighRadius.
Por que isso importa Esse é um marco importante que libera o processo de vendas. Acompanhar essa atividade é essencial para calcular o KPI do tempo total do ciclo de aprovação de crédito. Onde obter Esse evento normalmente é capturado a partir de uma mudança de status da solicitação de limite de crédito para 'Approved'. Ele também pode ser um evento explícito no audit log do sistema. Captura Inferido a partir de uma mudança de status da solicitação de crédito para 'Approved' ou do campo de carimbo de data e hora da aprovação. Tipo de evento inferred
	Limite de crédito solicitado	Esta atividade marca o início da avaliação de crédito de um cliente. Normalmente, ela é acionada antes da finalização de um pedido de venda e é registrada quando uma solicitação de novo limite de crédito ou de atualização de limite é inserida no sistema.
Por que isso importa Analisar o tempo entre a solicitação e a aprovação ajuda a identificar gargalos no cadastro de clientes e nos ciclos de vendas. Esse é um ponto de partida essencial para medir a eficiência da equipe de gestão de crédito. Onde obter Esse evento provavelmente é inferido a partir de uma mudança de status no perfil de crédito do cliente ou da data de criação de um registro de solicitação de limite de crédito no módulo de Credit Management do HighRadius. Captura Inferido a partir do carimbo de data e hora de criação de um objeto de solicitação de limite de crédito ou de uma mudança de status para 'Pending Approval'. Tipo de evento inferred
	Pagamento registrado	Representa a conclusão do processo de aplicação do caixa, quando um pagamento recebido é associado e aplicado com sucesso a uma fatura específica, eliminando o saldo em aberto.
Por que isso importa Esta atividade conclui o ciclo de processamento do pagamento. O tempo entre 'Payment Received' e 'Payment Posted' revela a eficiência do processo de aplicação do caixa. Onde obter Esse evento é capturado no campo de data de registro ou data de compensação do registro da fatura. Esse carimbo de data e hora é registrado quando a aplicação do caixa é finalizada. Captura Capturado no carimbo de data e hora de 'posting date' ou 'clearing date' do item contábil da fatura. Tipo de evento explicit
	Procedimento de cobrança iniciado	Esta atividade indica o início de um processo formal de cobrança ou de um nível específico desse processo para uma fatura vencida. Ela representa uma etapa mais sistemática do que um único lembrete.
Por que isso importa Acompanhar o início dos procedimentos de cobrança ajuda a analisar a eficácia de diferentes estratégias e níveis de cobrança para estimular o pagamento. Onde obter Esse evento normalmente é inferido a partir de uma mudança no campo 'Dunning Level' ou 'Collection Strategy' associado ao registro da fatura no HighRadius. Captura Inferido a partir de uma mudança no atributo de nível de cobrança da fatura, capturada por logs de alterações ou histórico com carimbo de data e hora. Tipo de evento inferred
	Promessa de pagamento criada	Esta atividade ocorre quando um cliente se compromete a pagar uma fatura em uma data futura e o agente de cobrança registra essa promessa no sistema. Esse é um resultado intermediário positivo.
Por que isso importa Acompanhar promessas de pagamento ajuda a prever o fluxo de caixa e avaliar a eficácia dos cobradores. Também permite analisar promessas não cumpridas, quando o pagamento não é recebido até a data prometida. Onde obter Este é um evento explícito registrado no HighRadius quando um agente cria um registro de 'Promise to Pay' vinculado a uma fatura. Esse registro tem seu próprio carimbo de data e hora de criação. Captura Capturado a partir do carimbo de data e hora de criação do objeto 'Promise to Pay' no HighRadius. Tipo de evento explicit

Recomendado Opcional

Guias de extração

Como obter seus dados do HighRadius

Etapas

Acesse o módulo de relatórios e análises: entre na sua instância do HighRadius com um usuário que tenha as permissões necessárias para criar e executar relatórios personalizados. Navegue até a seção Reporting and Analytics pelo Dashboard principal ou pelo menu do aplicativo.
Crie um novo relatório personalizado: inicie o processo de criação de um novo relatório. Selecione um objeto-base que funcione como referência principal dos seus dados, como o objeto Faturas ou Open A/R. Dê ao relatório um nome descritivo, por exemplo, ProcessMind_Credit_Collections_Log.
Defina os atributos principais das faturas: adicione ao layout do relatório os campos principais das faturas. Isso inclui InvoiceNumber, CustomerId, InvoiceAmount, PaymentTerms, DueDate e PaymentStatus. Eles formarão as colunas-base de cada evento.
Adicione dados de objetos relacionados (eventos): esta é a etapa mais importante. Você precisará associar ou unir dados de vários objetos do HighRadius para capturar todas as 15 atividades necessárias. Use a funcionalidade do criador de relatórios para adicionar fontes de dados relacionadas. Para cada atividade, crie um conjunto de colunas que represente os detalhes do evento.
Estruture o relatório no formato de registro de eventos: configure o relatório para produzir uma linha por evento. Normalmente, isso envolve unir diferentes blocos de dados, em vez de associá-los como colunas. Em cada bloco unido, mapeie o campo de data relevante para uma coluna EventTime comum e preencha ActivityName com o nome correspondente da atividade.
Configure o evento 'Payment Due Date Passed': esse evento é condicional. Crie um bloco de dados específico para as faturas cuja DueDate já passou e cujo PaymentStatus ainda seja 'Open' ou 'Overdue'. Para esses registros, defina ActivityName como 'Payment Due Date Passed' e use a própria DueDate como EventTime.
Adicione informações de cobrança e disputas: inclua dados dos módulos Collections e Disputas. Associe objetos como CollectorNotes ou ActivityHistory para obter CollectorName. Associe o objeto Disputas para recuperar DisputeReason quando aplicável.
Defina os filtros do relatório: aplique filtros para definir o escopo da extração. Defina um intervalo específico para EventTime, como os últimos 6 meses, para manter o conjunto de dados gerenciável. Dependendo da estrutura da sua organização, talvez também seja necessário filtrar por códigos de empresa específicos ou unidades de negócio.
Execute e visualize o relatório: execute o relatório para visualizar os dados. Verifique se a estrutura corresponde ao formato exigido para o registro de eventos, com uma linha por atividade e colunas para InvoiceNumber, ActivityName, EventTime e outros atributos.
Exporte os dados do relatório: depois de conferir a visualização, exporte o relatório completo. Selecione CSV como formato de exportação, pois ele é facilmente ingerido pelas ferramentas de process mining. Verifique se as configurações de exportação usam codificação UTF-8 para evitar problemas com caracteres.
Faça a revisão final dos dados: abra o arquivo CSV exportado em um aplicativo de planilhas. Faça uma verificação final para confirmar se todas as 15 atividades estão presentes, se os timestamps estão formatados corretamente e se os principais atributos foram preenchidos como esperado antes de carregar os dados no ProcessMind.

Configuração

Tipo de relatório: um relatório personalizado que combina dados de vários módulos. Dependendo da versão específica do HighRadius, ele pode ser chamado de 'Joined Report' ou exigir vários 'Blocks' unidos.
Objeto de dados principal: comece com o objeto Faturas ou Accounts Receivable como base do relatório.
Objetos de dados secundários: você precisará vincular objetos adicionais, como CreditRequests, CustomerCommunications, DunningHistory, CollectorActivityLog, PromiseToPay, DisputeCase e CashApplication.
Filtro de período: aplique um filtro ao campo de timestamp do evento principal. Recomenda-se extrair dados de um período de 3 a 6 meses para equilibrar detalhamento e performance. Por exemplo, EventTime nos últimos 180 dias.
Filtros de status: considere excluir status de fatura irrelevantes, como 'Cancelled' ou 'Draft', a menos que eles façam parte do processo que você deseja analisar.
Permissões: a conta de usuário que executa o relatório deve ter acesso de leitura a todos os módulos relevantes, incluindo Credit, Collections, Disputas e Cash Application, para garantir a extração de um conjunto de dados completo.

a Consulta de exemplo sql

/*
 This is a configuration model for a HighRadius custom report. 
 It is not an executable SQL script but a blueprint for building the report in the UI.
 The report should be configured to UNION the following data blocks to create a single event log.
*/

// Report Name: ProcessMind_Credit_Collections_Log
// Report Output Format: CSV

// === BLOCK 1: Credit Limit Requested ===
{
  "ActivityName": "Credit Limit Requested",
  "Source Object": "CreditRequests",
  "Join Condition": "CreditRequests.CustomerId = Invoices.CustomerId",
  "Columns": {
    "InvoiceNumber": null, // May not be available at this stage
    "ActivityName": "Credit Limit Requested",
    "EventTime": "CreditRequests.RequestTimestamp",
    "CollectorName": "CreditRequests.CreditAnalystName",
    "CustomerId": "CreditRequests.CustomerId",
    "InvoiceAmount": null,
    "PaymentTerms": null,
    "DueDate": null,
    "PaymentStatus": null,
    "DisputeReason": null
  }
}

// === BLOCK 2: Credit Limit Approved ===
{
  "ActivityName": "Credit Limit Approved",
  "Source Object": "CreditRequests",
  "Join Condition": "CreditRequests.CustomerId = Invoices.CustomerId",
  "Columns": {
    "InvoiceNumber": null, // May not be available at this stage
    "ActivityName": "Credit Limit Approved",
    "EventTime": "CreditRequests.ApprovalTimestamp",
    "CollectorName": "CreditRequests.CreditAnalystName",
    "CustomerId": "CreditRequests.CustomerId",
    "InvoiceAmount": null,
    "PaymentTerms": null,
    "DueDate": null,
    "PaymentStatus": null,
    "DisputeReason": null
  }
}

// === BLOCK 3: Invoice Generated ===
{
  "ActivityName": "Invoice Generated",
  "Source Object": "Invoices",
  "Columns": {
    "InvoiceNumber": "Invoices.InvoiceNumber",
    "ActivityName": "Invoice Generated",
    "EventTime": "Invoices.CreationTimestamp",
    "CollectorName": null,
    "CustomerId": "Invoices.CustomerId",
    "InvoiceAmount": "Invoices.InvoiceAmount",
    "PaymentTerms": "Invoices.PaymentTerms",
    "DueDate": "Invoices.DueDate",
    "PaymentStatus": "Invoices.PaymentStatus",
    "DisputeReason": null
  }
}

// === BLOCK 4: Invoice Sent to Customer ===
{
  "ActivityName": "Invoice Sent to Customer",
  "Source Object": "CustomerCommunications",
  "Filter": "CustomerCommunications.Type = 'Invoice Delivery'",
  "Columns": {
    "InvoiceNumber": "CustomerCommunications.InvoiceNumber",
    "ActivityName": "Invoice Sent to Customer",
    "EventTime": "CustomerCommunications.SentTimestamp",
    "CollectorName": null,
    "CustomerId": "[From joined Invoice]",
    "InvoiceAmount": "[From joined Invoice]",
    "PaymentTerms": "[From joined Invoice]",
    "DueDate": "[From joined Invoice]",
    "PaymentStatus": "[From joined Invoice]",
    "DisputeReason": null
  }
}

// === BLOCK 5: Payment Due Date Passed ===
{
  "ActivityName": "Payment Due Date Passed",
  "Source Object": "Invoices",
  "Filter": "Invoices.DueDate < CURRENT_DATE AND Invoices.PaymentStatus = 'Open'",
  "Columns": {
    "InvoiceNumber": "Invoices.InvoiceNumber",
    "ActivityName": "Payment Due Date Passed",
    "EventTime": "Invoices.DueDate",
    "CollectorName": "Invoices.AssignedCollector",
    "CustomerId": "Invoices.CustomerId",
    "InvoiceAmount": "Invoices.InvoiceAmount",
    "PaymentTerms": "Invoices.PaymentTerms",
    "DueDate": "Invoices.DueDate",
    "PaymentStatus": "Invoices.PaymentStatus",
    "DisputeReason": null
  }
}

// === BLOCK 6: Overdue Reminder Sent ===
{
  "ActivityName": "Overdue Reminder Sent",
  "Source Object": "DunningHistory",
  "Filter": "DunningHistory.Action = 'Reminder'",
  "Columns": {
    "InvoiceNumber": "DunningHistory.InvoiceNumber",
    "ActivityName": "Overdue Reminder Sent",
    "EventTime": "DunningHistory.ExecutionTimestamp",
    "CollectorName": null, // Often automated
    "CustomerId": "[From joined Invoice]",
    "InvoiceAmount": "[From joined Invoice]",
    "PaymentTerms": "[From joined Invoice]",
    "DueDate": "[From joined Invoice]",
    "PaymentStatus": "[From joined Invoice]",
    "DisputeReason": null
  }
}

// === BLOCK 7: Dunning Procedure Initiated ===
{
  "ActivityName": "Dunning Procedure Initiated",
  "Source Object": "DunningHistory",
  "Filter": "DunningHistory.Action = 'Dunning Level 1'",
  "Columns": {
    "InvoiceNumber": "DunningHistory.InvoiceNumber",
    "ActivityName": "Dunning Procedure Initiated",
    "EventTime": "DunningHistory.ExecutionTimestamp",
    "CollectorName": null, // Often automated
    "CustomerId": "[From joined Invoice]",
    "InvoiceAmount": "[From joined Invoice]",
    "PaymentTerms": "[From joined Invoice]",
    "DueDate": "[From joined Invoice]",
    "PaymentStatus": "[From joined Invoice]",
    "DisputeReason": null
  }
}

// === BLOCK 8: Collection Call Logged ===
{
  "ActivityName": "Collection Call Logged",
  "Source Object": "CollectorActivityLog",
  "Filter": "CollectorActivityLog.Type = 'Call'",
  "Columns": {
    "InvoiceNumber": "CollectorActivityLog.InvoiceNumber",
    "ActivityName": "Collection Call Logged",
    "EventTime": "CollectorActivityLog.ActivityTimestamp",
    "CollectorName": "CollectorActivityLog.CollectorName",
    "CustomerId": "[From joined Invoice]",
    "InvoiceAmount": "[From joined Invoice]",
    "PaymentTerms": "[From joined Invoice]",
    "DueDate": "[From joined Invoice]",
    "PaymentStatus": "[From joined Invoice]",
    "DisputeReason": null
  }
}

// === BLOCK 9: Promise to Pay Created ===
{
  "ActivityName": "Promise to Pay Created",
  "Source Object": "PromiseToPay",
  "Columns": {
    "InvoiceNumber": "PromiseToPay.InvoiceNumber",
    "ActivityName": "Promise to Pay Created",
    "EventTime": "PromiseToPay.CreationTimestamp",
    "CollectorName": "PromiseToPay.CreatedByCollector",
    "CustomerId": "[From joined Invoice]",
    "InvoiceAmount": "[From joined Invoice]",
    "PaymentTerms": "[From joined Invoice]",
    "DueDate": "[From joined Invoice]",
    "PaymentStatus": "[From joined Invoice]",
    "DisputeReason": null
  }
}

// === BLOCK 10: Dispute Registered ===
{
  "ActivityName": "Dispute Registered",
  "Source Object": "DisputeCase",
  "Columns": {
    "InvoiceNumber": "DisputeCase.InvoiceNumber",
    "ActivityName": "Dispute Registered",
    "EventTime": "DisputeCase.CreationTimestamp",
    "CollectorName": "DisputeCase.AssignedAnalyst",
    "CustomerId": "[From joined Invoice]",
    "InvoiceAmount": "[From joined Invoice]",
    "PaymentTerms": "[From joined Invoice]",
    "DueDate": "[From joined Invoice]",
    "PaymentStatus": "Disputed",
    "DisputeReason": "DisputeCase.ReasonCode"
  }
}

// === BLOCK 11: Dispute Resolved ===
{
  "ActivityName": "Dispute Resolved",
  "Source Object": "DisputeCase",
  "Filter": "DisputeCase.Status = 'Closed' OR DisputeCase.Status = 'Resolved'",
  "Columns": {
    "InvoiceNumber": "DisputeCase.InvoiceNumber",
    "ActivityName": "Dispute Resolved",
    "EventTime": "DisputeCase.ResolutionTimestamp",
    "CollectorName": "DisputeCase.AssignedAnalyst",
    "CustomerId": "[From joined Invoice]",
    "InvoiceAmount": "[From joined Invoice]",
    "PaymentTerms": "[From joined Invoice]",
    "DueDate": "[From joined Invoice]",
    "PaymentStatus": "[From joined Invoice]",
    "DisputeReason": "DisputeCase.ReasonCode"
  }
}

// === BLOCK 12: Payment Received ===
{
  "ActivityName": "Payment Received",
  "Source Object": "CashApplication.Payments",
  "Columns": {
    "InvoiceNumber": null, // Often matched later
    "ActivityName": "Payment Received",
    "EventTime": "CashApplication.Payments.PaymentDate",
    "CollectorName": null,
    "CustomerId": "CashApplication.Payments.CustomerId",
    "InvoiceAmount": null,
    "PaymentTerms": null,
    "DueDate": null,
    "PaymentStatus": null,
    "DisputeReason": null
  }
}

// === BLOCK 13: Payment Posted ===
{
  "ActivityName": "Payment Posted",
  "Source Object": "CashApplication.AppliedPayments",
  "Columns": {
    "InvoiceNumber": "CashApplication.AppliedPayments.InvoiceNumber",
    "ActivityName": "Payment Posted",
    "EventTime": "CashApplication.AppliedPayments.ApplicationTimestamp",
    "CollectorName": null,
    "CustomerId": "[From joined Invoice]",
    "InvoiceAmount": "[From joined Invoice]",
    "PaymentTerms": "[From joined Invoice]",
    "DueDate": "[From joined Invoice]",
    "PaymentStatus": "[From joined Invoice]",
    "DisputeReason": null
  }
}

// === BLOCK 14: Invoice Settled ===
{
  "ActivityName": "Invoice Settled",
  "Source Object": "Invoices",
  "Filter": "Invoices.Status = 'Closed' AND Invoices.ClosureReason = 'Paid'",
  "Columns": {
    "InvoiceNumber": "Invoices.InvoiceNumber",
    "ActivityName": "Invoice Settled",
    "EventTime": "Invoices.ClosureTimestamp",
    "CollectorName": null,
    "CustomerId": "Invoices.CustomerId",
    "InvoiceAmount": "Invoices.InvoiceAmount",
    "PaymentTerms": "Invoices.PaymentTerms",
    "DueDate": "Invoices.DueDate",
    "PaymentStatus": "Paid",
    "DisputeReason": null
  }
}

// === BLOCK 15: Invoice Written Off ===
{
  "ActivityName": "Invoice Written Off",
  "Source Object": "Invoices",
  "Filter": "Invoices.Status = 'Closed' AND Invoices.ClosureReason = 'Write-Off'",
  "Columns": {
    "InvoiceNumber": "Invoices.InvoiceNumber",
    "ActivityName": "Invoice Written Off",
    "EventTime": "Invoices.ClosureTimestamp",
    "CollectorName": "Invoices.AssignedCollector",
    "CustomerId": "Invoices.CustomerId",
    "InvoiceAmount": "Invoices.InvoiceAmount",
    "PaymentTerms": "Invoices.PaymentTerms",
    "DueDate": "Invoices.DueDate",
    "PaymentStatus": "Written Off",
    "DisputeReason": null
  }
}

Etapas

Pré-requisitos: verifique se o Python 3.6 ou superior está instalado, junto com as bibliotecas pandas e requests. Você pode instalá-las usando pip: pip install pandas requests. Também será necessário obter as credenciais da API, o Client ID e o Client Secret, com o administrador do HighRadius, com acesso de leitura aos objetos de dados necessários, como faturas, cobranças, disputas e pagamentos.
Inicialização do script: crie um novo arquivo de script Python, por exemplo, extract_hr_data.py. Comece importando as bibliotecas necessárias (requests, pandas, datetime) e definindo constantes de placeholder para a URL-base da API do HighRadius, as credenciais do cliente e o intervalo de datas desejado para a extração.
Implemente a autenticação: escreva uma função para gerenciar a autenticação. Essa função receberá seu Client ID e Secret, fará uma solicitação POST ao endpoint de autenticação do HighRadius, por exemplo, /auth/v1/token, e recuperará um token bearer. Esse token será usado no cabeçalho de todas as solicitações de dados seguintes.
Busque os dados principais das faturas: desenvolva uma função para consultar o endpoint principal de faturas, por exemplo, /invoices/v1/search. Essa função deve gerenciar a paginação para garantir a recuperação de todos os registros dentro do intervalo de datas especificado. Ela deve chamar a API repetidamente, coletando os dados das faturas até que não haja mais páginas disponíveis. Armazene esses dados principais em uma lista de dicionários.
Busque os dados de objetos relacionados: para cada entidade de dados principal, como Disputes, Collection Notes e Payments, crie funções de recuperação separadas. Essas funções consultarão seus respectivos endpoints, por exemplo, /disputes/v1/search, /collections/v1/notes e /cashapp/v1/payments, e devem ser projetadas para buscar com eficiência todos os dados relevantes do período especificado. Em geral, é melhor buscar esses conjuntos de dados em lote, em vez de consultar uma fatura por vez.
Estruture o Event Log: inicialize uma lista vazia que armazenará todas as linhas do Event Log. O script percorrerá os dados obtidos e transformará cada ação ou alteração de status relevante em um dicionário padronizado que representa uma única linha de evento. Cada dicionário deve conter as chaves InvoiceNumber, ActivityName, EventTime e todos os outros atributos necessários.
Gere os eventos do ciclo de vida da fatura: percorra a lista principal de faturas. Para cada fatura, crie eventos para 'Invoice Generated', 'Invoice Sent to Customer', 'Invoice Settled' e 'Invoice Written Off' com base na data de criação, nos registros de correspondência, na data de encerramento e nos campos de status. Armazene esses eventos como dicionários de evento.
Calcule 'Payment Due Date Passed': dentro do mesmo loop de faturas, adicione a lógica para criar um evento 'Payment Due Date Passed'. Este é um evento calculado. A lógica deve verificar se a data de vencimento da fatura já passou, se a fatura ainda não foi paga e se um evento 'Payment Due Date Passed' ainda não foi gerado para ela. O EventTime dessa atividade deve ser a própria data de vencimento.
Gere eventos de cobrança e disputa: processe os dados obtidos dos endpoints de cobranças e disputas. Para cada nota, promessa de pagamento, ação de cobrança ou registro de disputa, crie as linhas correspondentes do Event Log ('Overdue Reminder Sent', 'Collection Call Logged', 'Promise to Pay Created', 'Dispute Registered', 'Dispute Resolved'). Mapeie os detalhes relevantes, como CollectorName e DisputeReason, para o registro do evento.
Gere eventos de pagamento: processe os dados de pagamento do módulo de aplicação de pagamentos. Crie eventos 'Payment Received' com base na data de criação do pagamento ou do extrato bancário e eventos 'Payment Posted' com base na data em que o pagamento foi aplicado com sucesso à fatura.
Consolide e formate os dados: depois de processar todas as fontes de dados e gerar os eventos, converta a lista de dicionários de evento em um DataFrame do pandas. Isso facilita a ordenação e as conversões finais de tipo de dados. Verifique se a coluna EventTime está em um formato consistente de registro de data e hora (YYYY-MM-DD HH:MI:SS).
Exporte para CSV: use a função to_csv do pandas para exportar o DataFrame final para um arquivo CSV. Dê ao arquivo um nome claro, por exemplo, highradius_event_log.csv. Defina o parâmetro index=False para evitar que o índice do DataFrame seja gravado como uma coluna. Agora, o arquivo está pronto para ser carregado no ProcessMind.

Configuração

Credenciais da API: é necessário ter um usuário de API dedicado com Client ID e Client Secret. O usuário deve ter permissões de leitura para todos os endpoints relevantes da API, incluindo faturas, clientes, atividades de cobrança, disputas e aplicação de pagamentos.
Intervalo de datas: o script Python inclui as variáveis START_DATE e END_DATE. É essencial definir um intervalo específico e razoável, como 3 a 6 meses, para limitar o volume de dados e evitar tempos de execução excessivamente longos. Filtre com base em um campo de data indexado, como a data de criação ou de modificação da fatura.
URLs dos endpoints: os caminhos específicos dos endpoints da API, por exemplo, /invoices/v1/search, são placeholders. Você deve confirmar as URLs corretas dos endpoints na documentação da API do HighRadius da sua organização.
Parâmetros de paginação: o script deve gerenciar corretamente o mecanismo de paginação da API. Normalmente, isso envolve o uso dos parâmetros limit e offset ou uma abordagem baseada em cursor. Um tamanho de página entre 100 e 500 costuma ser um bom ponto de partida.
Ambiente: o script deve ser executado em um ambiente estável, com memória suficiente para lidar com os DataFrames, especialmente em extrações grandes. Para extrações em escala de produção, é preferível executá-lo em um servidor, e não em uma máquina local.
Campos personalizados: se o seu processo depender de campos personalizados no HighRadius, o script precisará ser modificado para consultar e incluir esses campos na saída.

a Consulta de exemplo python

import requests
import pandas as pd
from datetime import datetime, time

class=class="hl-string">"hl-comment"># --- Configuration Settings ---
HIGH RADIUS_BASE_URL = class="hl-string">"https://[your-highradius-instance].highradius.com/api"
CLIENT_ID = class="hl-string">"[Your_Client_ID]"
CLIENT_SECRET = class="hl-string">"[Your_Client_Secret]"
START_DATE = class="hl-string">"2023-01-01"
END_DATE = class="hl-string">"2023-06-30"

class=class="hl-string">"hl-comment"># --- Helper Functions ---
def get_auth_token():
    class="hl-string">"""Authenticates with HighRadius and returns a bearer token."""
    auth_url = fclass="hl-string">"{HIGH RADIUS_BASE_URL}/auth/v1/token"
    payload = {
        class="hl-string">'grant_type': class="hl-string">'client_credentials',
        class="hl-string">'client_id': CLIENT_ID,
        class="hl-string">'client_secret': CLIENT_SECRET
    }
    response = requests.post(auth_url, data=payload)
    response.raise_for_status() class=class="hl-string">"hl-comment"># Raises an exception for bad status codes
    return response.json()[class="hl-string">'access_token']

def fetch_paginated_data(endpoint, params, headers):
    class="hl-string">"""Fetches all pages of data from a given HighRadius endpoint."""
    all_data = []
    page = 0
    limit = 200 class=class="hl-string">"hl-comment"># Records per page
    while True:
        params[class="hl-string">'offset'] = page * limit
        params[class="hl-string">'limit'] = limit
        response = requests.get(fclass="hl-string">"{HIGH RADIUS_BASE_URL}{endpoint}", headers=headers, params=params)
        response.raise_for_status()
        data = response.json()
        records = data.get(class="hl-string">'data', []) class=class="hl-string">"hl-comment"># Adjust based on actual API response structure
        if not records:
            break
        all_data.extend(records)
        page += 1
    return all_data

class=class="hl-string">"hl-comment"># --- Main Extraction Logic ---
def main():
    class="hl-string">"""Main function to extract, transform, and save the event log."""
    print(class="hl-string">"Starting HighRadius data extraction...")
    auth_token = get_auth_token()
    headers = {class="hl-string">'Authorization': fclass="hl-string">'Bearer {auth_token}'}
    events = []

    class=class="hl-string">"hl-comment"># 1. Fetch all relevant invoices in the date range
    print(class="hl-string">"Fetching invoice data...")
    invoice_params = {class="hl-string">'creationDate_gte': START_DATE, class="hl-string">'creationDate_lte': END_DATE}
    invoices = fetch_paginated_data(class="hl-string">"/invoices/v1/search", invoice_params, headers)

    class=class="hl-string">"hl-comment"># Fetch related data in bulk to reduce API calls
    invoice_ids = [inv[class="hl-string">'invoiceNumber'] for inv in invoices]
    print(fclass="hl-string">"Fetching related data for {len(invoice_ids)} invoices...")

    notes = fetch_paginated_data(class="hl-string">"/collections/v1/notes", {class="hl-string">'invoiceNumber_in': class="hl-string">','.join(invoice_ids)}, headers)
    disputes = fetch_paginated_data(class="hl-string">"/disputes/v1/search", {class="hl-string">'invoiceNumber_in': class="hl-string">','.join(invoice_ids)}, headers)
    payments = fetch_paginated_data(class="hl-string">"/cashapp/v1/applications", {class="hl-string">'invoiceNumber_in': class="hl-string">','.join(invoice_ids)}, headers)
    credit_requests = fetch_paginated_data(class="hl-string">"/credit/v1/requests", {class="hl-string">'requestDate_gte': START_DATE, class="hl-string">'requestDate_lte': END_DATE}, headers)

    class=class="hl-string">"hl-comment"># Create dictionaries for quick lookups
    notes_by_invoice = {k: [n for n in notes if n[class="hl-string">'invoiceNumber'] == k] for k in invoice_ids}
    disputes_by_invoice = {k: [d for d in disputes if d[class="hl-string">'invoiceNumber'] == k] for k in invoice_ids}
    payments_by_invoice = {k: [p for p in payments if p[class="hl-string">'invoiceNumber'] == k] for k in invoice_ids}
    
    class=class="hl-string">"hl-comment"># Process each invoice to create events
    print(class="hl-string">"Transforming data into event log...")
    for invoice in invoices:
        common_attrs = {
            class="hl-string">'InvoiceNumber': invoice.get(class="hl-string">'invoiceNumber'),
            class="hl-string">'CustomerId': invoice.get(class="hl-string">'customer', {}).get(class="hl-string">'id'),
            class="hl-string">'InvoiceAmount': invoice.get(class="hl-string">'invoiceAmount'),
            class="hl-string">'PaymentTerms': invoice.get(class="hl-string">'paymentTerms'),
            class="hl-string">'DueDate': invoice.get(class="hl-string">'dueDate'),
            class="hl-string">'PaymentStatus': invoice.get(class="hl-string">'paymentStatus'),
            class="hl-string">'CollectorName': invoice.get(class="hl-string">'collector', {}).get(class="hl-string">'name'),
            class="hl-string">'DisputeReason': None
        }

        class=class="hl-string">"hl-comment"># Invoice Generated
        events.append({**common_attrs, class="hl-string">'ActivityName': class="hl-string">'Invoice Generated', class="hl-string">'EventTime': invoice.get(class="hl-string">'creationDate')})
        
        class=class="hl-string">"hl-comment"># Invoice Sent to Customer (example from correspondence log)
        if invoice.get(class="hl-string">'sentDate'):
            events.append({**common_attrs, class="hl-string">'ActivityName': class="hl-string">'Invoice Sent to Customer', class="hl-string">'EventTime': invoice.get(class="hl-string">'sentDate')})

        class=class="hl-string">"hl-comment"># Payment Due Date Passed (calculated)
        due_date_obj = datetime.strptime(invoice.get(class="hl-string">'dueDate'), class="hl-string">'%Y-%m-%dT%H:%M:%S.%fZ').date()
        if due_date_obj < datetime.today().date() and invoice.get(class="hl-string">'paymentStatus') not in [class="hl-string">'PAID', class="hl-string">'CLOSED']:
            event_time_at_due_date = datetime.combine(due_date_obj, time(23, 59, 59)).isoformat()
            events.append({**common_attrs, class="hl-string">'ActivityName': class="hl-string">'Payment Due Date Passed', class="hl-string">'EventTime': event_time_at_due_date})

        class=class="hl-string">"hl-comment"># Invoice Settled / Written Off
        if invoice.get(class="hl-string">'closeDate'):
            if invoice.get(class="hl-string">'paymentStatus') == class="hl-string">'PAID':
                events.append({**common_attrs, class="hl-string">'ActivityName': class="hl-string">'Invoice Settled', class="hl-string">'EventTime': invoice.get(class="hl-string">'closeDate')})
            elif invoice.get(class="hl-string">'statusReason') == class="hl-string">'WRITTEN_OFF':
                events.append({**common_attrs, class="hl-string">'ActivityName': class="hl-string">'Invoice Written Off', class="hl-string">'EventTime': invoice.get(class="hl-string">'closeDate')})

        class=class="hl-string">"hl-comment"># Process related notes for this invoice
        for note in notes_by_invoice.get(invoice[class="hl-string">'invoiceNumber'], []):
            activity_map = {
                class="hl-string">'REMINDER_SENT': class="hl-string">'Overdue Reminder Sent',
                class="hl-string">'DUNNING_STARTED': class="hl-string">'Dunning Procedure Initiated',
                class="hl-string">'COLLECTION_CALL': class="hl-string">'Collection Call Logged',
                class="hl-string">'PROMISE_TO_PAY': class="hl-string">'Promise to Pay Created'
            }
            activity_name = activity_map.get(note.get(class="hl-string">'noteType'))
            if activity_name:
                events.append({**common_attrs, class="hl-string">'ActivityName': activity_name, class="hl-string">'EventTime': note.get(class="hl-string">'creationDate'), class="hl-string">'CollectorName': note.get(class="hl-string">'createdBy')})

        class=class="hl-string">"hl-comment"># Process related disputes for this invoice
        for dispute in disputes_by_invoice.get(invoice[class="hl-string">'invoiceNumber'], []):
            events.append({**common_attrs, class="hl-string">'ActivityName': class="hl-string">'Dispute Registered', class="hl-string">'EventTime': dispute.get(class="hl-string">'creationDate'), class="hl-string">'DisputeReason': dispute.get(class="hl-string">'reasonCode')})
            if dispute.get(class="hl-string">'resolutionDate'):
                events.append({**common_attrs, class="hl-string">'ActivityName': class="hl-string">'Dispute Resolved', class="hl-string">'EventTime': dispute.get(class="hl-string">'resolutionDate'), class="hl-string">'DisputeReason': dispute.get(class="hl-string">'reasonCode')})
        
        class=class="hl-string">"hl-comment"># Process related payments for this invoice
        for payment in payments_by_invoice.get(invoice[class="hl-string">'invoiceNumber'], []):
            if payment.get(class="hl-string">'paymentReceivedDate'):
                events.append({**common_attrs, class="hl-string">'ActivityName': class="hl-string">'Payment Received', class="hl-string">'EventTime': payment.get(class="hl-string">'paymentReceivedDate')})
            if payment.get(class="hl-string">'applicationDate'):
                events.append({**common_attrs, class="hl-string">'ActivityName': class="hl-string">'Payment Posted', class="hl-string">'EventTime': payment.get(class="hl-string">'applicationDate')})

    class=class="hl-string">"hl-comment"># Process credit requests (linked by customer ID)
    for request in credit_requests:
        class=class="hl-string">"hl-comment"># Note: Linking to a specific invoice is often not possible. Here we create a case-level event.
        class=class="hl-string">"hl-comment"># A more advanced logic could try to link based on customer and time proximity to an invoice.
        credit_attrs = {**common_attrs, class="hl-string">'InvoiceNumber': fclass="hl-string">"CREDIT-{request.get('customerId')}", class="hl-string">'CustomerId': request.get(class="hl-string">'customerId')}
        events.append({**credit_attrs, class="hl-string">'ActivityName': class="hl-string">'Credit Limit Requested', class="hl-string">'EventTime': request.get(class="hl-string">'requestDate')})
        if request.get(class="hl-string">'status') == class="hl-string">'APPROVED' and request.get(class="hl-string">'approvalDate'):
            events.append({**credit_attrs, class="hl-string">'ActivityName': class="hl-string">'Credit Limit Approved', class="hl-string">'EventTime': request.get(class="hl-string">'approvalDate')})

    class=class="hl-string">"hl-comment"># Finalize DataFrame
    if not events:
        print(class="hl-string">"No events found for the specified criteria.")
        return

    df = pd.DataFrame(events)
    df[class="hl-string">'EventTime'] = pd.to_datetime(df[class="hl-string">'EventTime'], errors=class="hl-string">'coerce')
    df.dropna(subset=[class="hl-string">'InvoiceNumber', class="hl-string">'ActivityName', class="hl-string">'EventTime'], inplace=True)
    df.sort_values(by=[class="hl-string">'InvoiceNumber', class="hl-string">'EventTime'], inplace=True)
    
    class=class="hl-string">"hl-comment"># Save to CSV
    output_file = class="hl-string">'highradius_event_log.csv'
    df.to_csv(output_file, index=False, date_format=class="hl-string">'%Y-%m-%d %H:%M:%S')
    print(fclass="hl-string">"Extraction complete. Event log saved to {output_file}")

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

Pronto para começar?

Este Template oferece a base estruturada de dados necessária para revelar insights profundos sobre seu processo de gestão de crédito e cobrança. Comece hoje a otimizar suas operações no HighRadius para acelerar o fluxo de caixa!

Voltar ao guia de melhoria Baixar Template

Comece a otimizar sua gestão de crédito e cobrança

Elimine gargalos, reduza o tempo de ciclo em 30% e aumente a eficiência.

Comece seu teste grátis

Não é necessário cartão de crédito. Comece em poucos minutos.

Seu Template de dados de Gestão de crédito e cobrança

Seu Template de dados de Gestão de crédito e cobrança

Atributos de Gestão de Crédito e Cobrança

Atividades de Gestão de Crédito e Cobrança

Guias de extração

Exportação do módulo de relatórios e análises do HighRadius

Etapas

Configuração

a Consulta de exemplo sql

Extração com script Python por meio das APIs REST do HighRadius

Etapas

Configuração

a Consulta de exemplo python

Pronto para começar?

Comece a otimizar sua gestão de crédito e cobrança

Seu Template de dados de Gestão de crédito e cobrança

Seu Template de dados de Gestão de crédito e cobrança

Atributos de Gestão de Crédito e Cobrança

Atividades de Gestão de Crédito e Cobrança

Guias de extração

Exportação do módulo de relatórios e análises do HighRadius

Etapas

Configuração

a Consulta de exemplo sql

Extração com script Python por meio das APIs REST do HighRadius

Etapas

Configuração

a Consulta de exemplo python

Pronto para começar?

Comece a otimizar sua gestão de crédito e cobrança

Valorizamos sua privacidade