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

Seu Template de dados para 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 para gestão de crédito e cobrança

Este Template oferece um guia estruturado para coletar os dados necessários à análise do processo de gestão de crédito e cobrança. Ele apresenta os atributos essenciais a serem registrados, as principais atividades a acompanhar e orientações práticas para extrair essas informações do seu sistema HighRadius. Com este Template, você prepara os dados com eficiência para fazer a mineração de processos.

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

Novidade em Event Logs? Saiba como criar um Event Log para 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 analisar o processo de gestão de crédito e cobrança de forma abrangente.

3 Obrigatório 7 Recomendado 11 Opcional

	Nome	Descrição
	Data e hora do evento EventTime	Data e hora que indicam quando a atividade ocorreu.
Descrição A data e hora do evento indicam o momento exato de cada atividade do processo. Esses dados cronológicos são a base da mineração de processos: permitem ordenar os eventos corretamente e calcular o tempo 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. Também permite analisar a performance do processo ao longo do tempo, identificar atividades que causam atrasos e medir o cumprimento dos 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, identificar gargalos e entender a dinâmica do processo. Onde encontrar Todo registro de transação ou registro de eventos no HighRadius deve ter um campo correspondente de data e hora, geralmente chamado de 'Data de criação' ou 'Data e hora'. Exemplos 2023-03-15T10:00:00Z2023-04-01T14:35:10Z2023-05-20T09:12:45Z
	Nome da atividade ActivityName	Nome do evento de negócio específico que ocorreu em determinado momento para uma fatura.
Descrição O nome da atividade descreve uma etapa do processo de crédito e cobrança, como 'Fatura gerada', 'Lembrete de atraso enviado' ou 'Pagamento recebido'. A sequência dessas 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 'Ligação de cobrança registrada' ou 'Contestação registrada' são essenciais para entender a eficiência do processo. Por que isso importa Este atributo define as etapas do processo e permite reconstruir e analisar o fluxo de cada fatura. Onde encontrar Geralmente, esse dado é obtido dos registros de eventos, das mudanças de status ou dos 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	Identificador único de cada fatura, usado como identificador principal do caso no processo do crédito ao recebimento.
Descrição O número da fatura é 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, da geração da fatura às diversas atividades de gestão de crédito e cobrança, até a quitação ou a baixa como perda. Na análise de mineração de processos, esse atributo é essencial para agrupar todos os eventos relacionados em um único caso. Isso permite visualizar os fluxos do processo de ponta a ponta, calcular a duração dos casos, como o prazo médio de recebimento de vendas (DSO), e analisar os diferentes caminhos que uma fatura pode seguir, como a resolução de contestações ou os procedimentos de cobrança. Por que isso importa É o identificador fundamental que conecta todas as etapas do processo e permite analisar a jornada completa da fatura, da criação ao encerramento. Onde encontrar Este é um campo principal do HighRadius, geralmente encontrado nos objetos centrais de dados de faturas ou contas a receber. Exemplos INV-2023-001239876543210SI-55482
	Condições de pagamento PaymentTerms	Condições acordadas que definem quando o cliente deve pagar uma fatura.
Descrição As condições de pagamento especificam os termos, como "30 dias líquidos", "60 dias líquidos" ou "Vencimento no recebimento". Este atributo serve de base para calcular a data de vencimento da fatura. Este é um atributo importante para o dashboard e o KPI Aderência às condições de pagamento. A análise ajuda a identificar se as condições padrão estão sendo aplicadas de forma consistente e quais delas estão associadas a mais atrasos. Esse insight pode orientar a política de crédito e as negociações com clientes. Por que isso importa Ele define o prazo esperado para o pagamento, sendo essencial para calcular as datas de vencimento e medir se os clientes cumprem os acordos de pagamento. Onde encontrar Esse dado costuma estar no cabeçalho da fatura ou nos dados cadastrais do cliente no HighRadius ou no ERP de origem. Exemplos 30 dias líquidos60 dias líquidosVencimento no recebimento
	Data de vencimento DueDate	Data calculada até a qual o pagamento da fatura deve ser feito.
Descrição A data de vencimento é a data específica em que a fatura deve ser paga para não ser considerada vencida. Ela costuma ser calculada com base na data da fatura e nas condições de pagamento. Este atributo é fundamental para todas as análises de atraso. É o principal dado usado para calcular os dias de atraso, iniciar procedimentos de cobrança e medir o KPI de taxa de aderência às condições de pagamento. Ele também dá suporte direto a dashboards sobre envelhecimento de faturas e eficácia das cobranças. Por que isso importa Essa data determina se uma fatura foi paga em dia ou está vencida, além de acionar as atividades de cobrança e os KPIs subsequentes. Onde encontrar Este é um campo padrão do registro da fatura no HighRadius. Ele pode ser preenchido pelo ERP de origem ou calculado no HighRadius. Exemplos 2023-04-142023-05-312023-06-20
	ID do cliente CustomerId	Identificador exclusivo do cliente associado à fatura.
Descrição O ID do cliente associa uma fatura a um cliente específico. Isso permite agrupar e analisar os dados do processo pela perspectiva de cada cliente. Este atributo é essencial para analisar os comportamentos de pagamento de diferentes clientes ou segmentos. Ele ajuda a responder a perguntas como: quais clientes atrasam os pagamentos com frequência? Quais clientes abrem mais contestações? Também dá suporte a dashboards como Aderência às condições de pagamento e permite segmentar KPIs por cliente. Por que isso importa Ele permite analisar, por cliente, o comportamento de pagamento, a frequência de contestações e a interação geral com o processo, ajudando a adaptar as estratégias de cobrança. Onde encontrar Este é um campo padrão do cabeçalho da fatura ou dos dados da conta do cliente no HighRadius. Exemplos CUST-001ACME-CORPGLOBEX-US
	Motivo da contestação DisputeReason	Código ou descrição do motivo informado pelo cliente ao contestar uma fatura.
Descrição Quando um cliente abre uma contestação, geralmente informa o motivo, como "Preço incorreto", "Mercadoria danificada" ou "Fatura duplicada". Este atributo registra esse motivo. Analisar o motivo da contestação é fundamental para o dashboard Tempo de resolução de contestações de faturas. Isso ajuda a identificar as causas raiz das contestações e permite que a empresa resolva problemas sistêmicos de preços, envio ou faturamento. Reduzir as contestações na origem pode acelerar significativamente o fluxo de caixa. Por que isso importa Ele revela as causas raiz dos atrasos nos pagamentos e permite fazer melhorias direcionadas no processo para evitar novas contestações. Onde encontrar Essas informações são registradas no módulo de gestão de contestações ou de deduções do HighRadius quando uma contestação é aberta. Exemplos Quantidade incorretaDivergência de preçoMercadoria danificadaCobrança duplicada
	Nome do responsável pela cobrança CollectorName	Nome do usuário ou agente responsável por realizar uma atividade de cobrança.
Descrição Este atributo identifica o agente de cobrança, analista de crédito ou outro usuário que executou uma atividade manual, como "Registro de ligação de cobrança" ou "Contestação resolvida". Na análise, ele permite comparar a performance de diferentes agentes 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 das ligações de cobrança por agente, e identificar oportunidades de capacitação. Também é importante para a gestão de recursos e o planejamento de capacidade. Por que isso importa Ele associa 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 encontrar Essas informações costumam ficar nos registros de atividades ou nas ações dos usuários no módulo de cobrança do HighRadius. Exemplos John SmithJane DoeEmily Jones
	Status do pagamento PaymentStatus	Situação financeira atual da fatura, como em aberto, paga, vencida ou contestada.
Descrição O status do pagamento mostra em que etapa do ciclo de vida está a fatura. Ele indica se o pagamento ainda está pendente, se foi feito total ou parcialmente, se a data de vencimento já passou ou se a fatura está sendo analisada devido a uma contestação. Este atributo é central para o dashboard Status e envelhecimento do pagamento de faturas. Ele permite segmentar rapidamente as contas a receber para entender a situação financeira geral e priorizar a cobrança de itens vencidos ou contestados. Por que isso importa Ele agrupa as faturas em categorias que orientam as ações, mostrando de imediato a situação das contas a receber e ajudando a priorizar as atividades de cobrança. Onde encontrar Este é um campo de status essencial do registro da fatura ou das contas a receber no HighRadius. Exemplos Em abertoPagaVencidaContestadaBaixada
	Valor da fatura InvoiceAmount	Valor monetário total da fatura.
Descrição Este atributo representa o valor total devido na fatura. É uma métrica financeira crítica para entender o valor associado a cada caso. Em Process Mining, o valor da fatura ajuda a priorizar as cobranças, por exemplo, concentrando os esforços em faturas vencidas de alto valor. É fundamental para KPIs financeiros como o Prazo médio de recebimento de vendas (DSO) e é usado no dashboard Análise de baixas de faturas 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, a priorização do trabalho e a quantificação de impactos financeiros, como baixas contábeis. Onde encontrar Este é um campo padrão dos dados do cabeçalho da fatura no HighRadius. Exemplos 5000.001250.7525000.50
	Automatizada IsAutomated	Indicador booleano que informa se uma atividade foi realizada automaticamente pelo sistema ou manualmente por um usuário.
Descrição Este atributo calculado diferencia eventos gerados pelo sistema, como "Lembrete de vencimento enviado" por uma execução automatizada de cobrança, de ações realizadas por pessoas, como "Registro de ligação de cobrança". Este indicador é fundamental para calcular o KPI de taxa de atividades automatizadas de cobrança. Ele ajuda a medir o nível de automação do processo de cobrança, identificar oportunidades para automatizar outras atividades e comparar a eficácia das ações automatizadas e manuais. Por que isso importa Ele ajuda a medir o nível de automação do processo e permite analisar a eficiência e a eficácia dos sistemas automatizados em comparação com o trabalho manual. Onde encontrar Este dado é derivado durante a transformação dos dados. Para isso, é necessário criar um mapeamento que identifique quais nomes de atividades são automatizados, com base no conhecimento do negócio. Exemplos truefalse
	Data prometida para pagamento PromiseToPayDate	Data em que o cliente prometeu pagar uma fatura vencida.
Descrição Ao entrar em contato com um cliente, o responsável pela cobrança pode obter uma promessa de pagamento, ou seja, o compromisso de pagar até uma data específica. Este atributo registra a data prometida. A análise desses dados é importante para avaliar a confiabilidade das promessas dos clientes e a eficácia dos responsáveis pela cobrança em obter compromissos firmes. Ela pode ser usada 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 ajuda a medir a eficácia dos acompanhamentos e a confiabilidade dos compromissos assumidos pelos clientes. Onde encontrar Essa data é registrada quando uma atividade de promessa de pagamento é lançada no módulo de cobrança do HighRadius. Exemplos 2023-06-152023-07-012023-06-25
	Dias em atraso DaysOverdue	Número de dias que a fatura está vencida. O valor é zero se ela ainda não venceu ou foi paga em dia.
Descrição Dias em atraso é uma métrica calculada que mede a diferença entre a data atual, para faturas em aberto, ou a data do pagamento, para faturas pagas, e a data de vencimento da fatura. É um indicador importante de atraso no pagamento. Este atributo é a base do dashboard Status e envelhecimento do pagamento de faturas, que o usa para agrupar as contas a receber por faixas de atraso, como de 1 a 30 dias e de 31 a 60 dias. Ele também compõe o cálculo do Prazo médio de recebimento de vendas (DSO) e ajuda a priorizar a cobrança das contas com mais dias de atraso. Por que isso importa Essa métrica quantifica diretamente os atrasos nos pagamentos e é essencial para analisar o envelhecimento das faturas, priorizar cobranças e calcular o DSO. Onde encontrar Este dado não é armazenado em um campo. Ele é calculado durante a transformação dos dados, usando a data de vencimento e a data do pagamento ou a data atual. Exemplos 1545092
	Hora de término EndTime	Data e hora que indicam quando uma atividade foi concluída.
Descrição A Hora de término marca a conclusão de uma atividade. Muitas atividades de cobrança são eventos instantâneos, em que a Hora de início e a Hora de término são iguais. Outras, como "Resolução de contestação", podem ter uma duração específica. Quando disponível, esse atributo é usado com a Hora de início para calcular o Tempo de processamento de cada atividade. Assim, você identifica quais etapas específicas, e não apenas os intervalos entre elas, consomem mais tempo e recursos. Por que isso importa Ele permite medir com precisão a duração de cada atividade e mostra com mais detalhes onde o tempo é gasto no processo. Onde encontrar Consulte a documentação do HighRadius. Esse dado pode estar disponível para algumas atividades registradas que tenham um estado inicial e um final. Exemplos 2023-03-15T10:45:00Z2023-04-01T15:00:10Z2023-05-20T11:15:00Z
	Moeda Currency	Código da moeda do valor da fatura.
Descrição Este atributo especifica a moeda da fatura, como USD, EUR ou JPY. Ele fornece o contexto necessário para interpretar valores monetários, como o valor da fatura. Em empresas multinacionais, esse campo é indispensável para uma análise financeira precisa. Ele garante que os valores sejam interpretados corretamente e permite converter moedas ao consolidar dados para relatórios globais. Por que isso importa Ele é essencial para interpretar corretamente todos os valores monetários e evitar cálculos e relatórios financeiros imprecisos em ambientes com várias moedas. Onde encontrar Este é um campo padrão do registro da fatura, geralmente localizado ao lado do valor da fatura. Exemplos USDEURGBP
	Motivo da baixa WriteOffReason	Código ou 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. Este atributo registra o motivo da baixa, como "Falência do cliente", "Contestação não resolvida" ou "Baixa de saldo pequeno". Este é um atributo essencial para o dashboard Análise de baixas de faturas. Ele ajuda a analisar as causas raiz das perdas financeiras e fornece insights que podem orientar o aprimoramento das políticas de crédito, da gestão de contestações ou das estratégias de cobrança para reduzir futuras baixas. Por que isso importa Ele explica os motivos das perdas de receita e fornece feedback importante para aprimorar a avaliação do risco de crédito e as políticas de cobrança. Onde encontrar Essa informação é registrada quando a atividade "Fatura baixada" é processada, geralmente no módulo financeiro ou de cobrança do HighRadius. Exemplos FalênciaPrazo prescricional expiradoCusto da cobrança superior à dívida
	Nível de cobrança DunningLevel	Etapa ou nível alcançado no processo automatizado de cobrança de uma fatura vencida.
Descrição O nível de cobrança indica a intensidade dos esforços de cobrança e costuma corresponder a uma sequência de lembretes ou avisos automáticos enviados ao cliente. Por exemplo, o nível 1 pode ser um lembrete cordial, enquanto o nível 3 pode ser um aviso final. Este atributo é essencial para o dashboard Eficácia da estratégia de cobrança. Ao analisar quais níveis de cobrança levam mais frequentemente ao pagamento, as empresas podem otimizar seus fluxos de trabalho de cobrança para 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 e permite analisar quais estratégias são mais eficazes para estimular o pagamento. Onde encontrar Este campo de status é gerenciado pelo mecanismo automatizado de cobrança do HighRadius. Exemplos 123 - Aviso finalCobrança judicial
	País Country	País do cliente associado à fatura.
Descrição Este atributo informa o país onde o cliente está localizado. Ele permite segmentar geograficamente o processo de crédito e cobrança. A análise dos 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 contestação. Essas informações são importantes para adaptar políticas regionais e gerar relatórios gerenciais em organizações globais. Por que isso importa Ele permite fazer análises geográficas, identificar tendências regionais no comportamento de pagamento e adaptar as estratégias de cobrança. Onde encontrar Essa informação faz parte dos dados cadastrais do cliente e costuma estar disponível no HighRadius ou sincronizada com um ERP de origem. Exemplos USAAlemanhaBrasil
	Sistema de origem SourceSystem	Sistema de onde os dados se originam.
Descrição Este atributo identifica o sistema de origem em que os dados do evento foram gerados. Nesta visão do processo, o valor geralmente será 'HighRadius'. Em ambientes com vários sistemas, esse campo é essencial para entender a linhagem dos dados e rastrear as informações até a origem. Ele ajuda a diferenciar processos que podem passar por diferentes plataformas, como um ERP e uma ferramenta especializada em cobrança. 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 ambiente tecnológico do processo. Onde encontrar Geralmente, este é um valor estático adicionado durante a extração e transformação dos dados para identificar o conjunto de dados. Exemplos HighRadiusHighRadius-CobrançaHighRadius-AplicaçãoDeRecebimentos
	Última atualização dos dados LastDataUpdate	Data e hora em que os dados deste registro foram atualizados pela última vez a partir do sistema de origem.
Descrição Este atributo indica o quão recentes são os dados. Ele registra a data e a hora da última extração ou atualização de dados do HighRadius. Na análise, esse campo informa o nível de atualização dos insights. É essencial que os dashboards e relatórios mostrem o quão atuais são as informações, para que as decisões de negócio se baseiem em dados atualizados. Por que isso importa Ele dá transparência sobre a atualidade dos dados, o que é fundamental para gerar confiança na análise e tomar decisões fundamentadas. Onde encontrar Essa data e hora são geradas e adicionadas a cada registro pelo pipeline de ingestão de dados durante a extração. Exemplos 2023-06-10T02:00:00Z2023-06-11T02:00:00Z2023-06-12T02:00:00Z
	Unidade de negócio BusinessUnit	Unidade de negócio ou divisão interna responsável pela venda ou pela fatura.
Descrição O atributo Unidade de negócio associa a fatura a uma parte específica da organização, como "Varejo", "Atacado" ou "Serviços". Isso permite analisar a performance por segmento de negócio. A gestão pode comparar KPIs como DSO, taxas de contestação e baixas entre unidades de negócio para identificar áreas com bons resultados ou que precisam melhorar. Também ajuda a responsabilizar cada área pela performance das contas a receber. Por que isso importa Ele permite comparar a performance entre diferentes áreas da organização e identificar quais divisões têm os processos de crédito ao recebimento mais eficazes. Onde encontrar Esses são dados organizacionais, geralmente encontrados na fatura ou derivados do pedido de venda ou da conta do cliente associada no HighRadius ou no ERP. Exemplos Unidade de negócio - 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 os marcos do processo que você deve registrar no Event Log para descobrir e analisar o processo de gestão de crédito e cobrança com precisão.

7 Recomendado 8 Opcional

	Atividade	Descrição
	Contestação registrada	Esta atividade marca o momento em que o cliente contesta uma fatura ou solicita uma dedução, que é então registrada formalmente no HighRadius. O processo padrão de cobrança do valor contestado fica suspenso.
Por que isso importa Este é o evento de início para medir o tempo médio de resolução de contestações. Identificar quando e por que elas são abertas é essencial para tratar causas raiz, como erros de faturamento ou problemas de envio. Onde encontrar Este evento é registrado quando um usuário cria um caso de contestação vinculado a uma fatura no Deductions Cloud do HighRadius. A ação cria um registro da contestação com data e hora. Coleta Registrado a partir da data e hora de criação 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 solução foi definida. 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 encontrar Este evento é registrado quando o status do caso de contestação muda para 'Resolvido', 'Fechado' ou outro status final equivalente. A data e hora dessa mudança são usadas para a atividade. Coleta Inferido a partir da data e hora em que o status do caso de contestação é atualizado para o estado final 'Resolvido'. Tipo de evento inferred
	Data de vencimento do pagamento ultrapassada	Evento calculado quando a data atual ultrapassa a data de vencimento da fatura. Esta atividade não representa uma ação de usuário ou do sistema, mas uma mudança de estado importante que aciona o processo de cobrança.
Por que isso importa Esta atividade é o principal gatilho para as etapas seguintes de cobrança. Ela separa as faturas pagas em dia das vencidas e permite analisar a eficácia da estratégia de cobrança. Onde encontrar Este evento não é armazenado diretamente. Ele é calculado comparando a data de vencimento da fatura com a data e hora de outros eventos. O evento é derivado durante a transformação dos dados para a mineração de processos. Coleta Calculado comparando o campo due_date da fatura com a data atual ou a data e hora do evento (data e hora > data de vencimento). Tipo de evento calculated
	Fatura baixada como perda	Representa um desfecho alternativo do ciclo de vida da fatura: a dívida é considerada incobrável e baixada como perda. Esse resultado é indesejado.
Por que isso importa Acompanhar as baixas é essencial para calcular a taxa de baixa de faturas e analisar as causas raiz das perdas financeiras. Isso ajuda a identificar falhas na avaliação de crédito ou nos esforços de cobrança. Onde encontrar Este evento é registrado quando uma transação específica para baixar o saldo da fatura é lançada ou quando o status da fatura muda para 'Baixada como perda'. Coleta Inferido a partir da mudança de status para 'Baixada como perda' ou do lançamento de um tipo específico de transação de baixa na fatura. Tipo de evento inferred
	Fatura gerada	Este é o ponto de partida do ciclo de vida da fatura no processo de cobrança. 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 é o principal evento de início da análise do processo da fatura ao recebimento. Métricas de ciclo, como o prazo médio de recebimento de vendas (DSO), geralmente são calculadas a partir deste ponto. Onde encontrar Este é um evento explícito, registrado a partir da data de criação da fatura no HighRadius, geralmente sincronizada com o sistema ERP de origem, como SAP ou Oracle. Coleta Registrado a partir da data e hora de criação da fatura nos dados de contas a receber. Tipo de evento explicit
	Fatura quitada	Esta atividade indica o fim bem-sucedido do ciclo de vida da fatura, quando ela está totalmente paga e encerrada. Esse é o estado final desejado para o processo.
Por que isso importa Este é o principal evento final do caminho ideal do processo. Analisar os caminhos que levam a esse resultado ajuda a identificar boas práticas e estratégias de cobrança eficazes. Onde encontrar Geralmente, este não é um evento explícito, mas é inferido quando o status da fatura muda para 'Fechado' ou 'Compensado' e o saldo chega a zero. A data e hora do registro do pagamento final costumam ser usadas como horário do evento. Coleta Inferido a partir da mudança do status da fatura para 'Fechado' ou quando o 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. Indica que os recursos foram recebidos, mas ainda não foram vinculados à fatura específica.
Por que isso importa Este é um marco importante que costuma interromper a contagem do prazo de cobrança. Também é o ponto de partida para medir o KPI do intervalo entre o recebimento e o registro do pagamento, que destaca atrasos na aplicação de recebimentos. Onde encontrar Este evento é registrado a partir dos dados de pagamento no Cash Application Cloud do HighRadius. Cada lote ou transação de pagamento proveniente de um arquivo bancário tem uma data de recebimento. Coleta Registrado a partir da data e hora do registro de pagamento, quando ele é importado ou inserido no módulo de aplicação de recebimentos. Tipo de evento explicit
	Fatura enviada ao cliente	Esta atividade marca o momento em que a fatura é entregue ao cliente, geralmente 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 essa atividade ajuda a garantir que os clientes recebam as faturas sem demora. Atrasos entre a geração e o envio da fatura podem afetar diretamente o prazo de pagamento e o DSO. Onde encontrar Esse evento costuma ser registrado explicitamente no histórico de correspondências ou atividades associado à fatura no módulo Collections Cloud. Também pode ser inferido a partir do status de uma tarefa automatizada de comunicação. Coleta Registrado no histórico de comunicação da fatura quando um e-mail ou uma entrega 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 e registra a comunicação.
Por que isso importa Esta atividade é fundamental para medir a taxa de eficácia da cobrança. Ela permite analisar quantos lembretes são necessários até o recebimento do pagamento. Onde encontrar Este é um evento explícito, registrado no histórico de atividades ou correspondências da fatura no Collections Cloud do HighRadius. Cada lembrete enviado tem um registro correspondente com data e hora. Coleta Registrado a partir do histórico de comunicação com data e hora associado à fatura. Tipo de evento explicit
	Ligação de cobrança registrada	Representa uma ligação manual feita por um agente de cobrança 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 as ações automáticas das manuais. Onde encontrar Este é um evento explícito, criado quando um agente usa a função 'Registrar ligação' ou 'Adicionar atividade' na fatura ou na conta do cliente pela interface do HighRadius. O registro inclui a data e a hora. Coleta Registrado a partir da tabela de histórico de atividades, onde os agentes de cobrança registram ações manuais. Tipo de evento explicit
	Limite de crédito aprovado	Representa a conclusão bem-sucedida da análise de crédito, quando um limite é concedido oficialmente ao cliente. O evento é registrado quando um gerente de crédito aprova a solicitação na plataforma HighRadius.
Por que isso importa Este é 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 encontrar Este evento geralmente é registrado quando o status da solicitação de limite de crédito muda para 'Aprovado'. Ele também pode aparecer como um evento explícito no registro de auditoria do sistema. Coleta Inferido a partir da mudança de status da solicitação de crédito para 'Aprovado' ou do campo 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. Geralmente, ela ocorre antes da finalização de um pedido de venda e é registrada quando uma solicitação de limite de crédito novo ou atualizado é 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 no ciclo de vendas. Esse é um ponto de partida importante para medir a eficiência da equipe de gestão de crédito. Onde encontrar Este 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 uma solicitação de limite de crédito no módulo de Gestão de Crédito do HighRadius. Coleta Inferido a partir da data e hora de criação de uma solicitação de limite de crédito ou da mudança de status para 'Pendente de aprovação'. Tipo de evento inferred
	Pagamento registrado	Representa a conclusão do processo de aplicação de recebimentos, quando um pagamento recebido é conciliado e vinculado com sucesso a uma fatura específica, zerando o saldo em aberto.
Por que isso importa Esta atividade conclui o ciclo de processamento do pagamento. O tempo entre 'Pagamento recebido' e 'Pagamento registrado' revela a eficiência do processo de aplicação de recebimentos. Onde encontrar Este evento é registrado a partir do campo de data de lançamento ou de compensação no registro da fatura. A data e hora são registradas quando a aplicação do recebimento é concluída. Coleta Registrado a partir da data e hora do campo 'data de lançamento' ou 'data de compensação' no item de linha 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 uma etapa específica desse processo para uma fatura vencida. É uma ação mais sistemática do que o envio de 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 etapas de cobrança para incentivar o pagamento. Onde encontrar Este evento geralmente é inferido a partir de uma mudança no campo 'Nível de cobrança' ou 'Estratégia de cobrança' associado ao registro da fatura no HighRadius. Coleta Inferido a partir de uma mudança no atributo de nível de cobrança da fatura, registrada em logs de alterações ou no histórico com data e hora. Tipo de evento inferred
	Promessa de pagamento registrada	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. É um resultado intermediário positivo.
Por que isso importa Acompanhar as promessas de pagamento ajuda a prever o fluxo de caixa e avaliar a eficácia dos agentes de cobrança. Também permite analisar promessas não cumpridas, quando o pagamento não é recebido até a data prometida. Onde encontrar Este é um evento explícito, registrado no HighRadius quando um agente cria um registro de 'Promessa de pagamento' vinculado a uma fatura. O registro tem sua própria data e hora de criação. Coleta Registrado a partir da data e hora de criação do objeto 'Promessa de pagamento' 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. Acesse a seção de relatórios e análises pelo Dashboard principal ou pelo menu do aplicativo.
Crie um novo relatório personalizado: Inicie a criação de um relatório. Selecione um objeto base que sirva como referência principal para os dados, como o objeto Faturas ou Open A/R. Dê um nome descritivo ao relatório, por exemplo, ProcessMind_Credit_Collections_Log.
Defina os principais atributos das faturas: Adicione ao layout do relatório os campos principais das faturas: InvoiceNumber, CustomerId, InvoiceAmount, PaymentTerms, DueDate e PaymentStatus. Eles serão as colunas básicas de cada evento.
Adicione dados de objetos relacionados (eventos): Esta é a etapa mais importante. Você precisará combinar dados de vários objetos do HighRadius para registrar as 15 atividades necessárias. Use os recursos do criador de relatórios para adicionar fontes de dados relacionadas. Para cada atividade, crie um conjunto de colunas com os detalhes do evento.
Estruture o relatório no formato de Event Log: Configure o relatório para gerar uma linha por evento. Em geral, isso exige unir diferentes blocos de dados, em vez de combiná-los em colunas. Em cada bloco unido, mapeie o campo de data correspondente para uma coluna comum EventTime e defina o valor correspondente de ActivityName.
Configure o evento 'Payment Due Date Passed': Este evento depende de uma condição. Crie um bloco de dados específico para 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 sobre cobrança e disputas: Inclua dados dos módulos de cobrança e disputas. Combine objetos como CollectorNotes ou ActivityHistory para obter CollectorName. Combine o objeto Disputas para recuperar DisputeReason, quando aplicável.
Defina os filtros do relatório: Aplique filtros para delimitar a extração. Defina um período específico para EventTime, como os últimos 6 meses, para manter o conjunto de dados em um tamanho administrável. Dependendo da estrutura da sua organização, talvez também seja necessário filtrar por códigos de empresa ou unidades de negócio.
Execute e confira o relatório: Execute o relatório para visualizar os dados. Verifique se a estrutura corresponde ao formato necessário de Event Log, com uma linha por atividade e colunas para InvoiceNumber, ActivityName, EventTime e outros atributos.
Exporte os dados do relatório: Quando estiver satisfeito com a visualização, exporte o relatório completo. Selecione CSV como formato de exportação, pois ele é facilmente importado por ferramentas de Process Mining. Use a codificação UTF-8 para evitar problemas com caracteres especiais.
Faça uma revisão final dos dados: Abra o arquivo CSV exportado em um aplicativo de planilhas. Antes de carregar os dados no ProcessMind, confira se as 15 atividades estão presentes, se os timestamps estão formatados corretamente e se os principais atributos foram preenchidos como esperado.

Configuração

Tipo de relatório: Um relatório personalizado que combina dados de vários módulos. Dependendo da versão 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 principal de timestamp do evento. Recomenda-se extrair dados de um período de 3 a 6 meses para equilibrar o nível de detalhe e a performance. Por exemplo, EventTime nos últimos 180 dias.
Filtros de status: Considere excluir status de fatura irrelevantes, como 'Cancelled' ou 'Draft', a menos que façam parte do processo que você deseja analisar.
Permissões: A conta de usuário que executar o relatório precisa ter acesso de leitura a todos os módulos relevantes, incluindo crédito, cobrança, disputas e aplicação de pagamentos, para garantir a extração completa do conjunto de dados.

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 você tem o Python 3.6 ou superior instalado, além das bibliotecas pandas e requests. Você pode instalá-las com o pip: pip install pandas requests. Também precisará obter as credenciais da API (Client ID e Client Secret) com o administrador do HighRadius. O usuário deve ter acesso de leitura aos objetos de dados necessários, como faturas, cobranças, disputas e pagamentos.
Inicialize o 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 exemplo para a URL base da API do HighRadius, as credenciais do cliente e o período desejado para a extração.
Implemente a autenticação: Escreva uma função para gerenciar a autenticação. Ela receberá o Client ID e o Client Secret, fará uma solicitação POST ao endpoint de autenticação do HighRadius (por exemplo, /auth/v1/token) e obterá um token bearer. Esse token será usado no cabeçalho de todas as solicitações de dados seguintes.
Obtenha os dados principais das faturas: Crie uma função para consultar o endpoint principal de faturas (por exemplo, /invoices/v1/search). A função deve lidar com a paginação para recuperar todos os registros do período especificado. Ela deve chamar a API repetidamente e reunir os dados das faturas até não haver mais páginas. Armazene esses dados principais em uma lista de dicionários.
Obtenha dados de objetos relacionados: Crie funções separadas para recuperar os dados de cada entidade principal, como Disputas, notas de cobrança e pagamentos. Essas funções consultarão os respectivos endpoints (por exemplo, /disputes/v1/search, /collections/v1/notes, /cashapp/v1/payments) e devem buscar com eficiência todos os dados relevantes do período especificado. Em geral, é melhor obter esses conjuntos de dados em lote, em vez de consultar uma fatura por vez.
Estruture o Event Log: Inicialize uma lista vazia para armazenar todas as linhas do Event Log. O script percorrerá os dados obtidos e transformará cada ação relevante ou mudança de status em um dicionário padronizado que representa uma linha de evento. Cada dicionário deve conter as chaves InvoiceNumber, ActivityName, EventTime e todos os outros atributos necessários.
Gere eventos do ciclo de vida das faturas: Percorra a lista principal de faturas. Para cada uma, 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-os como dicionários de eventos.
Calcule o evento 'Payment Due Date Passed': No mesmo loop das faturas, inclua a lógica para criar um evento 'Payment Due Date Passed'. Esse evento é calculado. A lógica deve verificar se a data de vencimento da fatura já passou, se ela ainda não foi paga e se o evento 'Payment Due Date Passed' ainda não foi gerado para essa fatura. O valor de 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ça e disputas. Para cada nota, promessa de pagamento, ação de cobrança ou registro de disputa, crie as linhas correspondentes no Event Log ('Overdue Reminder Sent', 'Collection Call Logged', 'Promise to Pay Created', 'Dispute Registered', 'Dispute Resolved'). Associe os detalhes relevantes, como CollectorName e DisputeReason, ao 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 na data do extrato bancário e eventos 'Payment Posted' com base na data em que o pagamento foi aplicado à 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 eventos em um DataFrame do pandas. Assim, fica mais fácil ordenar os dados e converter os tipos finais. Verifique se a coluna EventTime usa um formato de timestamp consistente (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. Escolha um nome claro, como highradius_event_log.csv. Defina o parâmetro index=False para não gravar o índice do DataFrame como uma coluna. O arquivo estará pronto para ser carregado no ProcessMind.

Configuração

Credenciais da API: É necessária uma conta de API dedicada com Client ID e Client Secret. O usuário deve ter permissões de leitura em todos os endpoints relevantes, incluindo os de faturas, clientes, atividades de cobrança, disputas e aplicação de pagamentos.
Período: O script Python inclui as variáveis START_DATE e END_DATE. É essencial definir um período específico e razoável, como 3 a 6 meses, para limitar o volume de dados e evitar que o script demore demais. Use como filtro 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 exemplos. Confirme as URLs corretas na documentação da API do HighRadius da sua organização.
Parâmetros de paginação: O script deve lidar corretamente com o mecanismo de paginação da API. Em geral, isso envolve usar os 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: Execute o script em um ambiente estável, com memória suficiente para processar os DataFrames, especialmente em extrações grandes. Para extrações em escala de produção, prefira um servidor a uma máquina local.
Campos personalizados: Se o processo depender de campos personalizados no HighRadius, será necessário modificar o script para consultá-los e incluí-los nos dados de saída.

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 detalhados sobre seu processo de gestão de crédito e cobrança. Comece hoje a otimizar as operações no HighRadius e acelerar o fluxo de caixa.

Voltar ao guia de melhoria

Baixar Template

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

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

Comece o teste grátis

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

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

Seu Template de dados para 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

Consulta de exemplo sql

Extração por script Python usando as APIs REST do HighRadius

Etapas

Configuração

Consulta de exemplo python

Pronto para começar?

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