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

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

NetSuite

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

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

Este Template oferece um guia completo para coletar os dados certos e analisar seu processo de gestão de crédito e cobrança. Ele apresenta os atributos e atividades essenciais, além de orientações práticas de extração para ajudar você a começar rapidamente. Seguindo essas recomendações, você garante que seus dados estejam preparados para uma análise de processos mais relevante e para melhorias contínuas.

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

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 detalhada do seu processo de gestão de crédito e cobrança.

3 Obrigatório 5 Recomendado 13 Opcional

	Nome	Descrição
	Hora do evento EventTime	O timestamp que indica quando a atividade ocorreu.
Descrição Esse atributo registra a data e a hora exatas de cada atividade do processo. Ele é fundamental para todas as análises baseadas em tempo, incluindo o cálculo de tempos de ciclo, durações e tempos de espera entre etapas. No NetSuite, esse timestamp geralmente corresponde à data de criação ou à data da última alteração do registro ou da nota do sistema relevante. Por que isso importa Ele permite calcular todas as métricas de performance relacionadas ao tempo, como tempos de ciclo e gargalos, que são essenciais para a análise de eficiência. Onde obter É obtido de campos de data em vários registros. Por exemplo, a 'Date Created' de um registro Invoice para 'Invoice Generated' ou o timestamp de uma System Note para alterações de status. Exemplos 2023-01-15T10:00:00Z2023-02-01T14:30:00Z2023-02-15T09:05:00Z
	Nome da atividade ActivityName	O nome da atividade de negócio que ocorreu em um momento específico.
Descrição Esse atributo descreve uma etapa ou um evento específico do processo de crédito e cobrança, como 'Invoice Generated', 'Payment Received' ou 'Dispute Registered'. Analisar a sequência e a frequência dessas atividades é o núcleo do Process Mining, revelando o fluxo real do processo, os desvios e os gargalos. Por que isso importa Esse atributo é a base do mapa do processo, permitindo visualizar e analisar o fluxo do processo. Onde obter Esse campo normalmente é derivado das alterações de status dos registros de transação, como Invoice e Customer Payment, ou de registros relacionados, como notas do sistema, registros personalizados de atividades de cobrança ou tarefas de CRM. Exemplos Fatura geradaLembrete de atraso enviadoPagamento recebidoFatura baixada
	Número da fatura InvoiceNumber	O identificador exclusivo de cada fatura do cliente.
Descrição O número da fatura funciona como o principal identificador do caso, vinculando exclusivamente todas as atividades relacionadas a um recebível específico. Isso permite uma análise completa de todo o ciclo de vida, desde a criação da fatura e as ações subsequentes de gestão de crédito até o pagamento ou a resolução por meio dos esforços de cobrança. No NetSuite, normalmente corresponde ao Transaction ID quando o tipo de transação é 'Invoice'. Por que isso importa É a chave essencial para rastrear a jornada da fatura, da geração à liquidação, permitindo a análise completa do processo. Onde obter Normalmente, esse é o campo 'Transaction ID' (ID interno: tranid) no registro Invoice do NetSuite. Exemplos INV0012345INV0054321INV0098765
	Data de vencimento DueDate	A data até a qual o pagamento da fatura deve ser realizado.
Descrição A Due Date é a data de pagamento acordada contratualmente. Ela é a referência para determinar se um pagamento está no prazo ou atrasado. Esse atributo é essencial para calcular KPIs como 'On-Time Payment Rate' e para acionar atividades de cobrança quando a data é ultrapassada. Por que isso importa Funciona como a principal referência para medir a pontualidade dos pagamentos e é essencial para calcular os dias em atraso e monitorar a conformidade com os prazos de pagamento. Onde obter Esse é o campo 'Due Date' (ID interno: duedate) no registro da transação Invoice. Exemplos 2023-02-142023-03-312023-04-15
	ID do cliente CustomerId	O identificador exclusivo do cliente associado à fatura.
Descrição Esse atributo vincula uma fatura a uma entidade de cliente específica no NetSuite. Ele é essencial para segmentar os dados e analisar a performance do processo entre diferentes clientes ou grupos de clientes. Por exemplo, permite analisar comportamentos de pagamento ou taxas de disputa de contas estratégicas em comparação com pequenas empresas. Por que isso importa Permite uma análise centrada no cliente, ajudando a identificar quais clientes atrasam pagamentos com frequência, abrem disputas ou seguem processos fora do padrão. Onde obter Esse é o campo 'Customer' (ID interno: entity) no registro da transação Invoice. Exemplos CUST001CUST002CUST003
	Segmento do cliente CustomerSegment	A classificação do cliente, por exemplo, por porte, setor ou região.
Descrição Customer Segment categoriza os clientes em grupos relevantes, como 'Enterprise', 'SMB' e 'Public Sector'. Esse atributo é essencial para o Dashboard 'Collection Strategy Performance by Segment', pois permite comparar a eficácia de diferentes abordagens de cobrança entre esses segmentos. Ele ajuda a adaptar as estratégias aos comportamentos específicos de cada grupo. Por que isso importa Permite uma análise direcionada para determinar se determinados problemas do processo ou comportamentos de pagamento estão concentrados em grupos específicos de clientes. Onde obter Geralmente, esse é um campo personalizado no registro Customer do NetSuite. Os dados precisam ser associados do registro Customer à transação Invoice. Exemplos Empresa de grande porteMercado intermediárioSMB
	Status da fatura InvoiceStatus	O status atual da fatura em seu ciclo de vida.
Descrição Indica o estado atual da fatura, como 'Open', 'Paid In Full' ou 'Overdue'. É útil para filtrar e analisar apenas as faturas que estão ativas ou apresentam problemas. O Dashboard 'Overdue Invoices Aging and Status' usa esse atributo para fornecer uma visão dos recebíveis em aberto. Por que isso importa Permite filtrar e concentrar a análise em etapas específicas do ciclo de vida da fatura, como faturas abertas, vencidas ou contestadas. Onde obter Corresponde ao campo 'Status' (ID interno: status) no registro da transação Invoice. Exemplos Em abertoPago integralmenteEm atraso
	Valor da fatura InvoiceAmount	O valor monetário total da fatura.
Descrição Representa o valor total devido na fatura. Esse é um atributo financeiro essencial, usado em praticamente todas as análises, como na identificação do impacto financeiro de pagamentos atrasados ou na análise de baixas de faturas de alto valor. Ele fornece um contexto importante para priorizar os esforços de cobrança. Por que isso importa Fornece contexto financeiro ao processo, permitindo análises com base no valor monetário, como a priorização da cobrança de faturas vencidas de alto valor. Onde obter Esse é o campo 'Amount (Total)' (ID interno: total) no registro da transação Invoice. Exemplos 1500.00250.5012500.75
	Atraso no registro do pagamento PaymentPostingLag	O tempo entre o recebimento de um pagamento e seu registro no sistema.
Descrição Esta duração calculada mede o atraso entre a atividade 'Pagamento recebido' (quando os recursos são recebidos) e a atividade 'Pagamento registrado' (quando o pagamento é aplicado à fatura no NetSuite). Essa é uma métrica importante para o Dashboard 'Análise do atraso no registro de pagamentos', destacando ineficiências internas na aplicação dos recebimentos que podem distorcer a visibilidade do caixa. Por que isso importa Revela atrasos internos no processamento da aplicação de recebimentos, que podem afetar a precisão dos relatórios financeiros e o status das contas dos clientes. Onde obter Isso é calculado na ferramenta de Process Mining: Timestamp('Pagamento registrado') - Timestamp('Pagamento recebido'). Exemplos 1 dia4 horas3 dias
	Condições de pagamento PaymentTerms	As condições de pagamento acordadas com o cliente para a fatura.
Descrição Esse atributo especifica as condições em que o cliente deve pagar uma fatura, como 'Net 30' ou 'Net 60'. Ele é a base para calcular a Due Date da fatura e é fundamental para o Dashboard 'Payment Terms Compliance and Deviations', que analisa se os clientes estão cumprindo as condições acordadas. Por que isso importa Fornece a base contratual para os cronogramas de pagamento e é essencial para analisar a conformidade e identificar desvios que afetam o fluxo de caixa. Onde obter Esse é o campo 'Terms' (ID interno: terms) no registro da transação Invoice. Exemplos Líquido 30 diasLíquido 60 diasVencimento no recebimento
	Dias em atraso DaysOverdue	O número de dias que uma fatura está além da data de vencimento.
Descrição Essa métrica calculada mede o número de dias entre a data de vencimento da fatura e a data atual, para faturas em aberto, ou a data do pagamento. É um KPI fundamental para cobrança, usado no Dashboard 'Overdue Invoices Aging and Status' para categorizar e priorizar os esforços de recebimento. Um valor igual ou menor que zero indica que a fatura não está vencida. Por que isso importa Mede diretamente a gravidade dos atrasos de pagamento e é uma métrica essencial para relatórios de aging e para priorizar as atividades de cobrança. Onde obter Isso é calculado durante a transformação dos dados: (Data atual ou data do pagamento) - data de vencimento. Exemplos 1532090
	É automatizado IsAutomated	Um indicador que mostra se uma atividade foi realizada automaticamente por um sistema.
Descrição Esse atributo booleano especifica se uma atividade foi executada por um Workflow automatizado ou por um usuário. Por exemplo, a atividade 'Overdue Reminder Sent' pode ser automatizada, enquanto 'Collection Call Made' é manual. Ele é essencial para o Dashboard 'Manual Activity Frequency and Impact', pois permite quantificar os níveis de automação e identificar oportunidades para automatizar ainda mais o processo. Por que isso importa Ajuda a quantificar o nível de automação do processo, apoiando iniciativas para reduzir o esforço manual e melhorar a eficiência. Onde obter É um atributo derivado com base no tipo de atividade ou no usuário que a realizou. Por exemplo, se o usuário for um usuário 'SYSTEM' designado, a atividade será marcada como automatizada. Exemplos truefalse
	ID do usuário UserId	O identificador do usuário que realizou a atividade.
Descrição Identifica o funcionário ou usuário do sistema responsável por uma atividade específica, como contabilizar um pagamento ou fazer uma ligação de cobrança. Isso permite analisar a distribuição da carga de trabalho, a performance da equipe e as necessidades de treinamento. Em atividades automatizadas, pode ser o ID de um usuário do sistema. Por que isso importa Permite analisar a performance por usuário ou equipe, além de ajudar a entender a distribuição da carga de trabalho e identificar onde ocorrem intervenções manuais. Onde obter Obtido de campos como 'Created By', 'Modified By' ou um campo específico de 'Owner' em transações ou registros relacionados, como o registro Phone Call de ligações de cobrança. Exemplos j.doea.smithSYSTEM
	Motivo da disputa DisputeReason	O motivo informado para a disputa do cliente sobre uma fatura.
Descrição Quando um cliente contesta uma fatura, esse atributo registra o motivo, como 'Incorrect Pricing', 'Damaged Goods' ou 'Duplicate Billing'. Ele é essencial para os Dashboards 'Invoice Dispute Resolution Time' e 'Invoice Write-Off Root Cause Analysis', pois ajuda a entender por que as disputas ocorrem e a identificar padrões que podem ser tratados para evitar problemas futuros. Por que isso importa Ajuda a identificar as causas-raiz das disputas dos clientes, fornecendo os insights necessários para melhorar processos anteriores, como o atendimento do pedido ou a precisão do faturamento. Onde obter Provavelmente, esse é um campo personalizado no registro Invoice ou um registro personalizado relacionado, usado para acompanhar casos de disputa. Não é um campo padrão do NetSuite. Exemplos Quantidade incorretaDivergência de preçoMercadoria danificada
	Nome do cobrador CollectorName	O nome do agente de cobrança responsável pela fatura.
Descrição Identifica o agente ou recurso específico de cobrança responsável por gerenciar uma fatura vencida. Isso permite analisar a performance da equipe de cobrança, entender a distribuição da carga de trabalho e avaliar a eficácia de cada cobrador. Também dá suporte a KPIs como 'Collections Contact Success Rate'. Por que isso importa Permite medir a performance e equilibrar a carga de trabalho da equipe de cobrança, vinculando as atividades de cobrança a pessoas específicas. Onde obter Geralmente, esse é um campo personalizado no registro Customer ou Invoice. Alguns bundles de cobrança do NetSuite adicionam essa funcionalidade. Exemplos Alice JohnsonRobert WilliamsNão atribuído
	Pagamento realizado no prazo IsOnTimePayment	Um indicador que mostra se o pagamento foi recebido até a data de vencimento.
Descrição Este atributo booleano calculado verifica se a atividade 'Pagamento recebido' ocorreu até a 'Data de vencimento' da fatura. Ele simplifica o cálculo do KPI 'Taxa de pagamentos no prazo' e permite filtrar e analisar facilmente pagamentos realizados no prazo ou em atraso. O resultado é claro e binário para avaliar a performance dos pagamentos. Por que isso importa Fornece uma métrica simples e binária para avaliar a conformidade com as condições de pagamento, facilitando o cálculo e a comparação da Taxa de pagamentos no prazo. Onde obter Isso é calculado durante a transformação dos dados: TRUE se (Data do pagamento <= Data de vencimento); caso contrário, FALSE. Exemplos truefalse
	País Country	O país do endereço de cobrança do cliente.
Descrição Esse atributo indica o país associado ao endereço de cobrança do cliente na fatura. Ele é usado para analisar variações geográficas no comportamento de pagamento, na eficácia da cobrança e nas taxas de disputa. Isso pode ajudar a adaptar as estratégias de cobrança a regiões específicas e entender o impacto das condições econômicas locais. Por que isso importa Permite segmentar o processo geograficamente, destacando diferenças regionais no comportamento de pagamento ou na eficiência do processo. Onde obter É obtido dos dados de 'Billing Address' na transação Invoice, normalmente herdados do registro Customer. Exemplos USAAlemanhaJapão
	Sistema de origem SourceSystem	O sistema do qual os dados foram extraídos.
Descrição Identifica o sistema de origem dos dados do evento. Nesta visão do processo, o valor será sempre 'NetSuite', mas esse é um atributo obrigatório para a governança de dados e para diferenciar fontes de dados em um ambiente com vários sistemas. Por que isso importa Garante a linhagem e a rastreabilidade dos dados, importantes para a validação e a governança, especialmente em ambientes com vários sistemas integrados. Onde obter É um valor estático ('NetSuite') adicionado durante o processo de transformação dos dados. Exemplos NetSuite
	Tempo do ciclo da fatura ao recebimento InvoiceToCashCycleTime	O tempo total entre a geração da fatura e a liquidação final.
Descrição Esta métrica calculada mede a duração total entre a atividade 'Fatura gerada' e a atividade 'Fatura liquidada'. Ela representa a performance de ponta a ponta de todo o processo de crédito e cobrança. A análise desse KPI ajuda a identificar atrasos sistêmicos e fornece uma visão geral da velocidade do fluxo de caixa. Por que isso importa Este é um KPI crítico e estratégico que mede a eficiência geral de todo o processo da fatura ao recebimento. Onde obter Este é um cálculo no nível do caso realizado na ferramenta de Process Mining: Timestamp('Fatura liquidada') - Timestamp('Fatura gerada'). Exemplos 32 dias45 dias91 dias
	Última atualização dos dados LastDataUpdate	O timestamp da última atualização dos dados do sistema de origem.
Descrição Esse atributo indica quando os dados desse processo foram extraídos e atualizados pela última vez na ferramenta de Process Mining. Ele ajuda os usuários a entender a atualidade dos dados analisados e garante que as decisões sejam tomadas com base em informações atuais. Por que isso importa Oferece transparência sobre a atualidade dos dados, permitindo saber o quanto a análise do processo está atualizada. Onde obter Esse valor é gerado e registrado no conjunto de dados no momento da extração. Exemplos 2023-10-27T02:00:00Z
	Unidade de negócio BusinessUnit	A unidade de negócio ou subsidiária associada à transação.
Descrição Representa a unidade de negócio, o departamento ou a subsidiária específica que emitiu a fatura. Nas contas NetSuite OneWorld, normalmente corresponde ao campo 'Subsidiary'. Ele permite segmentar a análise do processo por diferentes partes da organização, comparar a performance e identificar problemas específicos de cada divisão. Por que isso importa Permite comparar a performance do processo entre diferentes unidades organizacionais, revelando variações que podem exigir abordagens de gestão distintas. Onde obter No NetSuite OneWorld, esse é o campo 'Subsidiary'. Em outras contas, pode ser 'Department' ou 'Class', dependendo da configuração. Exemplos Oeste dos EUAServiços EMEAProdutos APAC

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 precisa e uma otimização do seu Workflow de cobrança.

5 Recomendado 8 Opcional

	Atividade	Descrição
	Data de vencimento do pagamento ultrapassada	Um evento calculado que ocorre quando a data atual ultrapassa a data de vencimento da fatura sem que ela tenha sido totalmente paga. Ele representa a transição da fatura do status 'current' para 'overdue'.
Por que isso importa Esse evento é um gatilho essencial para todas as atividades de cobrança. Analisar o período após esse evento é fundamental para entender a eficiência da cobrança e a eficácia das ações de cobrança. Onde obter Esse é um evento calculado. Ele é obtido comparando a data atual com o campo 'Due Date' do registro da transação Invoice. O timestamp do evento é a própria Due Date. Captura O timestamp é o valor do campo 'Due Date' da fatura. Tipo de evento calculated
	Fatura baixada	Um encerramento malsucedido do ciclo de vida da fatura, em que a dívida é considerada incobrável e removida das contas a receber. Esse evento é capturado quando um lançamento contábil de perda de crédito é aplicado à fatura.
Por que isso importa Esse é um ponto final crítico de falha. Analisar os caminhos que levam às baixas ajuda a identificar fragilidades na política de crédito e na estratégia de cobrança, reduzindo, em última análise, as perdas com créditos incobráveis. Onde obter Inferido a partir da aplicação de um 'Journal Entry' à fatura, quando o lançamento é especificamente referente à baixa de uma dívida incobrável. Também pode ser usado um status personalizado. Captura Use a data do Journal Entry de baixa aplicado à fatura. Tipo de evento inferred
	Fatura gerada	Marca a criação oficial do registro da fatura no sistema. Esse evento é capturado a partir da data de criação da transação Invoice no NetSuite e serve como ponto de partida do ciclo de vida da fatura.
Por que isso importa Esse é o principal evento inicial do processo Invoice-to-Cash. Ele é essencial para calcular métricas importantes, como Days Sales Outstanding (DSO) e o tempo total de ciclo do processo Invoice-to-Cash. Onde obter Esse é um evento explícito, capturado a partir da data de criação do registro da transação Invoice no NetSuite, na tabela Transaction, quando Type é 'Invoice'. Captura Use o timestamp de criação do registro da transação Invoice. Tipo de evento explicit
	Fatura liquidada	A conclusão bem-sucedida do ciclo de vida da fatura, quando o saldo devido é reduzido a zero por meio de pagamentos e créditos aplicados. Esse evento é inferido quando o status da fatura muda para 'Paid In Full'.
Por que isso importa Esse é o principal evento final bem-sucedido do processo. Ele é o ponto de dados final para calcular o tempo de ciclo completo do processo Invoice-to-Cash. Onde obter Inferido a partir da alteração do campo 'Status' da transação Invoice para 'Paid In Full'. O timestamp pode ser obtido a partir da data do pagamento final ou da nota de crédito que encerrou a fatura. Captura Timestamp da última aplicação de pagamento que define o status como 'Paid In Full'. Tipo de evento inferred
	Pagamento recebido	Esse evento marca o momento em que o pagamento do cliente é criado e aplicado a uma fatura. É um marco essencial, capturado diretamente do registro da transação Customer Payment no NetSuite.
Por que isso importa Essa atividade é essencial para calcular o DSO e a taxa de pagamentos no prazo. Ela representa o recebimento do dinheiro e é uma medida importante do sucesso da cobrança. Onde obter Capturado a partir da data de criação do registro da transação 'Customer Payment'. A sublista 'Apply' desse registro vincula o pagamento a uma ou mais faturas. Captura Use a data da transação do registro Customer Payment. Tipo de evento explicit
	Disputa registrada	Indica que um cliente contestou formalmente a fatura, interrompendo o processo padrão de cobrança. Normalmente, esse evento é inferido a partir da alteração do campo de status da fatura para o estado 'Disputed'.
Por que isso importa Esse evento é o ponto de partida para medir o tempo de resolução de disputas. Identificar disputas frequentes pode revelar problemas subjacentes nos processos de faturamento ou vendas. Onde obter Inferido a partir de um log do sistema ou de uma alteração com timestamp no campo personalizado 'Invoice Status' para um valor como 'Disputed' ou 'In Dispute'. Captura Timestamp em que um campo de status é atualizado para indicar uma disputa. Tipo de evento inferred
	Disputa resolvida	Marca a resolução da disputa do cliente, permitindo que o processo de cobrança seja retomado ou que a fatura seja liquidada. Esse evento é inferido quando o status da fatura muda de 'Disputed' para um estado ativo.
Por que isso importa Esse é o ponto final para medir o tempo de ciclo da resolução de disputas. Resolver disputas com eficiência é essencial para manter a satisfação do cliente e acelerar o fluxo de caixa. Onde obter Inferido a partir de um log do sistema ou de uma alteração com timestamp no campo personalizado 'Invoice Status', de 'Disputed' para um valor como 'Open' ou 'Resolved'. Captura Timestamp em que um campo de status é atualizado para indicar a resolução. Tipo de evento inferred
	Fatura enviada ao cliente	Representa o momento em que a fatura foi comunicada ao cliente, normalmente por e-mail. Esse evento costuma ser inferido a partir dos logs do sistema que registram as comunicações enviadas relacionadas à transação Invoice.
Por que isso importa Acompanhar essa atividade ajuda a identificar atrasos entre a criação da fatura e a notificação do cliente, o que pode afetar os prazos de pagamento. Ela fornece um insight sobre a eficiência do processo de comunicação de cobrança. Onde obter Inferido a partir da data de um e-mail enviado pelo registro da fatura, disponível na subtaba Communication > Messages da transação Invoice. Captura Use o timestamp do registro 'Message' vinculado à fatura. Tipo de evento inferred
	Lembrete de atraso enviado	Um lembrete inicial, geralmente automatizado, é enviado ao cliente sobre uma fatura vencida. Essa atividade costuma ser capturada a partir da criação de uma carta de cobrança ou de um evento de comunicação registrado no módulo de cobrança do NetSuite.
Por que isso importa Essa atividade é o primeiro passo do processo de cobrança. Analisar sua frequência e seu impacto nos pagamentos ajuda a avaliar a eficácia dos esforços iniciais de recebimento. Onde obter Capturado a partir da data de criação de um registro 'Dunning Letter' associado à fatura e gerado pelo NetSuite Dunning SuiteApp. Captura Use o timestamp de criação do registro Dunning Letter. Tipo de evento explicit
	Ligação de cobrança realizada	Uma atividade manual de cobrança em que um agente entra em contato com o cliente por telefone. Esse evento é capturado a partir de registros de atividade Phone Call criados por usuários no módulo de CRM do NetSuite.
Por que isso importa Essa atividade ajuda a quantificar o esforço manual no processo de cobrança. Analisar sua frequência e sua taxa de sucesso é importante para otimizar a alocação de recursos e a automação. Onde obter Capturado a partir da data de criação de um registro de atividade 'Phone Call' em que o registro relacionado é o cliente e o número da fatura é mencionado na mensagem. Captura Use o timestamp do registro de atividade Phone Call do CRM. Tipo de evento explicit
	Nota de crédito emitida	Representa a criação de uma nota de crédito aplicada à fatura, geralmente para corrigir um erro ou como parte da resolução de uma disputa. Essa é uma transação explícita no NetSuite.
Por que isso importa Notas de crédito frequentes podem indicar problemas sistêmicos, como erros de preço ou problemas de envio. Analisar sua ocorrência ajuda a identificar as causas-raiz de perdas de receita. Onde obter Esse é um evento explícito, capturado a partir da data de criação do registro da transação Credit Memo vinculado à fatura original. Captura Use o timestamp de criação da transação Credit Memo. Tipo de evento explicit
	Pagamento contabilizado	Representa a data em que o impacto financeiro do pagamento é oficialmente registrado no General Ledger. Esse evento é capturado a partir da data de contabilização da transação Customer Payment.
Por que isso importa O tempo entre 'Payment Received' e 'Payment Posted' revela atrasos administrativos. Analisar essa diferença é importante para garantir relatórios financeiros precisos e pontuais. Onde obter Capturado a partir do 'Posting Period' ou da data da transação no impacto no General Ledger da transação 'Customer Payment'. Captura Use a data de contabilização no GL da transação Customer Payment. Tipo de evento explicit
	Procedimento de cobrança iniciado	Representa o início de um processo formal de cobrança para uma fatura vencida, que pode envolver várias etapas. Esse evento é capturado quando um nível específico de cobrança é atribuído à fatura.
Por que isso importa Acompanhar o início da cobrança formal ajuda a medir a aderência e a eficácia do processo. Esse é um marco importante para analisar como diferentes estratégias de cobrança influenciam o comportamento de pagamento. Onde obter Inferido a partir da data em que o 'Dunning Level' no registro da fatura ou do cliente é definido pela primeira vez como um estado de cobrança inicial ou diferente de zero. Captura Identifique o timestamp em que o campo Dunning Level é alterado. Tipo de evento inferred

Recomendado Opcional

Guias de extração

Como obter seus dados do NetSuite

Etapas

Faça login no NetSuite: acesse sua conta do NetSuite com uma função que tenha permissão para criar e executar Saved Searches, além de visualizar os registros de transações e atividades necessários, como Fatura, Pagamento de cliente e Chamada telefônica.
Acesse as Saved Searches: vá para Reports > Saved Searches > All Saved Searches > New. Você repetirá esse processo para criar várias pesquisas distintas, uma para cada tipo de evento.
Crie a pesquisa básica de Faturas: comece criando uma pesquisa para o evento "Fatura gerada". Selecione "Transação" como tipo de pesquisa. Essa pesquisa capturará a criação da fatura.
Defina os critérios da pesquisa: na subaba "Criteria", configure os seguintes filtros:
- Tipo é Fatura.
- Main Line é true. Isso garante que você obtenha um registro por fatura, e não um registro por item de linha.
- Date Created está dentro do período de análise desejado, por exemplo, os últimos 6 meses.
Defina os resultados da pesquisa: na subaba "Results", adicione as colunas necessárias para o Event Log. Use rótulos personalizados para corresponder aos nomes de atributos exigidos, como InvoiceNumber. Use fórmulas para definir o campo ActivityName. Os mapeamentos detalhados dos campos estão disponíveis na seção de consulta.
Crie pesquisas para outros eventos: seguindo as configurações da seção de consulta, crie pesquisas salvas separadas para outras atividades, como Pagamentos, Notas de crédito, Chamadas de cobrança e alterações de status. Elas podem usar tipos de registro diferentes, como "Phone Call", ou exigir uma pesquisa em "System Notes".
Execute e exporte as pesquisas: execute cada pesquisa salva individualmente. Na página de resultados, clique no ícone "Export - CSV" para baixar os dados. Dê nomes descritivos aos arquivos, como invoice_generated.csv e payment_received.csv.
Gere os eventos "Data de vencimento do pagamento ultrapassada": esse evento não é exportado diretamente. Ele deve ser calculado depois da exportação dos dados. Na ferramenta de manipulação de dados de sua preferência, como Python, Power Query ou uma ferramenta de ETL, crie uma linha para cada fatura que ainda não foi totalmente paga, com ActivityName igual a "Data de vencimento do pagamento ultrapassada" e EventTime igual a DueDate mais um dia.
Combine os arquivos exportados: use uma ferramenta externa para empilhar todos os arquivos CSV exportados em um único arquivo mestre. Verifique se os cabeçalhos das colunas são idênticos em todos os arquivos antes de combiná-los.
Formate os dados finais: revise o arquivo CSV combinado. Confirme se EventTime está em um formato de timestamp consistente, como YYYY-MM-DD HH:MI:SS, e se todas as colunas obrigatórias, InvoiceNumber, ActivityName e EventTime, estão presentes em todas as linhas.
Carregue os dados no ProcessMind: o arquivo CSV final e combinado está pronto para ser carregado como seu Event Log.

Configuração

Pré-requisitos: é necessária uma função de usuário com permissões para criar, editar e exportar Saved Searches. É necessário ter acesso aos seguintes tipos de registro: Transação (para Faturas, pagamentos e notas de crédito), Phone Call (ou outros registros de atividade de CRM) e System Notes.
Tipos de registro: os principais tipos de registro usados nessas pesquisas são Transação e Phone Call. O registro System Note também é usado para capturar mudanças de status e eventos de comunicação quando não há registros de transação diretos disponíveis.
Filtragem por período: para garantir a performance e gerenciar o volume de dados, aplique de forma consistente um filtro de data, como Date Created ou Last Modified Date, em todas as pesquisas salvas. Recomenda-se usar um período de 3 a 6 meses de dados para a análise inicial.
Filtro de linha principal: ao pesquisar registros de transação, use o critério Main Line is true para isolar as informações no nível do cabeçalho. Isso evita duplicar eventos para cada item de linha de uma fatura ou pagamento.
Uso de fórmulas: as fórmulas do NetSuite são essenciais para criar a coluna padronizada ActivityName. Os campos Formula (Text) permitem inserir diretamente o nome da atividade em cada pesquisa, e Formula (Date/Time) pode ser usado para padronizar os campos de timestamp, se necessário.
Limites de exportação: considere que a exportação de CSV pela interface do NetSuite normalmente é limitada a 100.000 linhas por pesquisa. Para conjuntos de dados maiores, talvez seja necessário executar as pesquisas em intervalos menores de datas ou usar pesquisas agendadas que enviem os resultados para o File Cabinet.

a Consulta de exemplo sql

/*
This configuration outlines the setup for multiple NetSuite Saved Searches. 
Each search is designed to extract a specific activity for the event log.
Create one Saved Search in the NetSuite UI for each block defined below.
*/

// Saved Search 1: Invoice Generated
{
  "SavedSearchName": "ProcessMind - Invoice Generated",
  "RecordType": "Transaction",
  "Criteria": [
    {"Field": "Type", "Operator": "is", "Value": "Invoice"},
    {"Field": "Main Line", "Operator": "is", "Value": "true"},
    {"Field": "Date Created", "Operator": "within", "Value": "[Your Date Range]"}
  ],
  "Results": [
    {"Column": "ActivityName", "Field": "Formula (Text)", "Formula": "'Invoice Generated'"},
    {"Column": "EventTime", "Field": "Date Created"},
    {"Column": "InvoiceNumber", "Field": "Document Number"},
    {"Column": "CustomerId", "Field": "Customer : Internal ID"},
    {"Column": "CustomerSegment", "Field": "Customer : Category"},
    {"Column": "InvoiceAmount", "Field": "Amount (Gross)"},
    {"Column": "DueDate", "Field": "Due Date"},
    {"Column": "InvoiceStatus", "Field": "Status"}
  ]
}

// Saved Search 2: Invoice Sent to Customer
{
  "SavedSearchName": "ProcessMind - Invoice Sent",
  "RecordType": "Transaction",
  "Criteria": [
    {"Field": "Type", "Operator": "is", "Value": "Invoice"},
    {"Field": "Main Line", "Operator": "is", "Value": "true"},
    {"Field": "System Notes : Field", "Operator": "is", "Value": "E-mailed"},
    {"Field": "System Notes : Date", "Operator": "within", "Value": "[Your Date Range]"}
  ],
  "Results": [
    {"Column": "ActivityName", "Field": "Formula (Text)", "Formula": "'Invoice Sent to Customer'"},
    {"Column": "EventTime", "Field": "System Notes : Date"},
    {"Column": "InvoiceNumber", "Field": "Document Number"},
    {"Column": "CustomerId", "Field": "Customer : Internal ID"},
    {"Column": "CustomerSegment", "Field": "Customer : Category"},
    {"Column": "InvoiceAmount", "Field": "Amount (Gross)"},
    {"Column": "DueDate", "Field": "Due Date"},
    {"Column": "InvoiceStatus", "Field": "Status"}
  ]
}

// Note: 'Payment Due Date Passed' is a calculated event, generated post-export.

// Saved Search 3: Overdue Reminder Sent & Dunning Procedure Initiated
{
  "SavedSearchName": "ProcessMind - Dunning Events",
  "RecordType": "Transaction",
  "Criteria": [
    {"Field": "Type", "Operator": "is", "Value": "Invoice"},
    {"Field": "Main Line", "Operator": "is", "Value": "true"},
    {"Field": "System Notes : Field", "Operator": "is", "Value": "[Your Dunning Status Field]"},
    {"Field": "System Notes : Date", "Operator": "within", "Value": "[Your Date Range]"}
  ],
  "Results": [
    {"Column": "ActivityName", "Field": "Formula (Text)", "Formula": "CASE WHEN {systemnotes.newvalue} = '[Your First Dunning Level]' THEN 'Dunning Procedure Initiated' ELSE 'Overdue Reminder Sent' END"},
    {"Column": "EventTime", "Field": "System Notes : Date"},
    {"Column": "InvoiceNumber", "Field": "Document Number"},
    {"Column": "CustomerId", "Field": "Customer : Internal ID"},
    {"Column": "CustomerSegment", "Field": "Customer : Category"},
    {"Column": "InvoiceAmount", "Field": "Amount (Gross)"},
    {"Column": "DueDate", "Field": "Due Date"},
    {"Column": "InvoiceStatus", "Field": "Status"}
  ]
}

// Saved Search 4: Collection Call Made
{
  "SavedSearchName": "ProcessMind - Collection Calls",
  "RecordType": "Phone Call",
  "Criteria": [
    {"Field": "Transaction : Type", "Operator": "is", "Value": "Invoice"},
    {"Field": "Date", "Operator": "within", "Value": "[Your Date Range]"}
  ],
  "Results": [
    {"Column": "ActivityName", "Field": "Formula (Text)", "Formula": "'Collection Call Made'"},
    {"Column": "EventTime", "Field": "Completed Date"},
    {"Column": "InvoiceNumber", "Field": "Transaction : Document Number"},
    {"Column": "CustomerId", "Field": "Company : Internal ID"},
    {"Column": "CustomerSegment", "Field": "Company : Category"},
    {"Column": "InvoiceAmount", "Field": "Transaction : Amount (Gross)"},
    {"Column": "DueDate", "Field": "Transaction : Due Date"},
    {"Column": "InvoiceStatus", "Field": "Transaction : Status"}
  ]
}

// Saved Search 5: Dispute Registered & Resolved
{
  "SavedSearchName": "ProcessMind - Dispute Status",
  "RecordType": "Transaction",
  "Criteria": [
    {"Field": "Type", "Operator": "is", "Value": "Invoice"},
    {"Field": "Main Line", "Operator": "is", "Value": "true"},
    {"Field": "System Notes : Field", "Operator": "is", "Value": "Status"},
    {"Field": "System Notes : Date", "Operator": "within", "Value": "[Your Date Range]"}
  ],
  "Results": [
    {"Column": "ActivityName", "Field": "Formula (Text)", "Formula": "CASE WHEN {systemnotes.newvalue} LIKE '%Disputed%' THEN 'Dispute Registered' WHEN {systemnotes.oldvalue} LIKE '%Disputed%' THEN 'Dispute Resolved' ELSE NULL END"},
    {"Column": "EventTime", "Field": "System Notes : Date"},
    {"Column": "InvoiceNumber", "Field": "Document Number"},
    {"Column": "CustomerId", "Field": "Customer : Internal ID"},
    {"Column": "CustomerSegment", "Field": "Customer : Category"},
    {"Column": "InvoiceAmount", "Field": "Amount (Gross)"},
    {"Column": "DueDate", "Field": "Due Date"},
    {"Column": "InvoiceStatus", "Field": "Status"}
  ]
}

// Saved Search 6: Credit Memo Issued
{
  "SavedSearchName": "ProcessMind - Credit Memos",
  "RecordType": "Transaction",
  "Criteria": [
    {"Field": "Type", "Operator": "is", "Value": "Credit Memo"},
    {"Field": "Main Line", "Operator": "is", "Value": "true"},
    {"Field": "Applied To Transaction : Type", "Operator": "is", "Value": "Invoice"},
    {"Field": "Date Created", "Operator": "within", "Value": "[Your Date Range]"}
  ],
  "Results": [
    {"Column": "ActivityName", "Field": "Formula (Text)", "Formula": "'Credit Memo Issued'"},
    {"Column": "EventTime", "Field": "Date Created"},
    {"Column": "InvoiceNumber", "Field": "Applied To Transaction : Document Number"},
    {"Column": "CustomerId", "Field": "Customer : Internal ID"},
    {"Column": "CustomerSegment", "Field": "Customer : Category"},
    {"Column": "InvoiceAmount", "Field": "Applied To Transaction : Amount (Gross)"},
    {"Column": "DueDate", "Field": "Applied To Transaction : Due Date"},
    {"Column": "InvoiceStatus", "Field": "Applied To Transaction : Status"}
  ]
}

// Saved Search 7: Payment Received & Posted
{
  "SavedSearchName": "ProcessMind - Payments",
  "RecordType": "Transaction",
  "Criteria": [
    {"Field": "Type", "Operator": "is", "Value": "Customer Payment"},
    {"Field": "Main Line", "Operator": "is", "Value": "true"},
    {"Field": "Date Created", "Operator": "within", "Value": "[Your Date Range]"}
  ],
  "Results": [
    // For 'Payment Received'
    {"Column": "ActivityName", "Field": "Formula (Text)", "Formula": "'Payment Received'"},
    {"Column": "EventTime", "Field": "Date Created"},
    // For 'Payment Posted'
    // {"Column": "ActivityName", "Field": "Formula (Text)", "Formula": "'Payment Posted'"},
    // {"Column": "EventTime", "Field": "[Your GL Posting Date Field]"},
    {"Column": "InvoiceNumber", "Field": "Applied To Transaction : Document Number"},
    {"Column": "CustomerId", "Field": "Customer : Internal ID"},
    {"Column": "CustomerSegment", "Field": "Customer : Category"},
    {"Column": "InvoiceAmount", "Field": "Applied To Transaction : Amount (Gross)"},
    {"Column": "DueDate", "Field": "Applied To Transaction : Due Date"},
    {"Column": "InvoiceStatus", "Field": "Applied To Transaction : Status"}
  ]
}

// Saved Search 8: Invoice Settled
{
  "SavedSearchName": "ProcessMind - Invoice Settled",
  "RecordType": "Transaction",
  "Criteria": [
    {"Field": "Type", "Operator": "is", "Value": "Invoice"},
    {"Field": "Main Line", "Operator": "is", "Value": "true"},
    {"Field": "Status", "Operator": "anyof", "Value": "Paid In Full"},
    {"Field": "Date Closed", "Operator": "within", "Value": "[Your Date Range]"}
  ],
  "Results": [
    {"Column": "ActivityName", "Field": "Formula (Text)", "Formula": "'Invoice Settled'"},
    {"Column": "EventTime", "Field": "Date Closed"},
    {"Column": "InvoiceNumber", "Field": "Document Number"},
    {"Column": "CustomerId", "Field": "Customer : Internal ID"},
    {"Column": "CustomerSegment", "Field": "Customer : Category"},
    {"Column": "InvoiceAmount", "Field": "Amount (Gross)"},
    {"Column": "DueDate", "Field": "Due Date"},
    {"Column": "InvoiceStatus", "Field": "Status"}
  ]
}

// Saved Search 9: Invoice Written Off
{
  "SavedSearchName": "ProcessMind - Invoice Written Off",
  "RecordType": "Transaction",
  "Criteria": [
    {"Field": "Type", "Operator": "is", "Value": "Journal Entry"},
    {"Field": "Main Line", "Operator": "is", "Value": "false"},
    {"Field": "Account", "Operator": "is", "Value": "[Your Bad Debt Expense Account]"},
    {"Field": "Date Created", "Operator": "within", "Value": "[Your Date Range]"}
  ],
  "Results": [
    {"Column": "ActivityName", "Field": "Formula (Text)", "Formula": "'Invoice Written Off'"},
    {"Column": "EventTime", "Field": "Date Created"},
    {"Column": "InvoiceNumber", "Field": "Created From : Document Number"},
    {"Column": "CustomerId", "Field": "Created From : Customer : Internal ID"},
    {"Column": "CustomerSegment", "Field": "Created From : Customer : Category"},
    {"Column": "InvoiceAmount", "Field": "Created From : Amount (Gross)"},
    {"Column": "DueDate", "Field": "Created From : Due Date"},
    {"Column": "InvoiceStatus", "Field": "Created From : Status"}
  ]
}

Etapas

Pré-requisitos: Verifique se o Python 3.6 ou superior está instalado no seu sistema. Você também precisará das credenciais do NetSuite SuiteTalk, especificamente para Token Based Authentication (TBA), incluindo Account ID, Consumer Key, Consumer Secret, Token ID e Token Secret. A função associada no NetSuite deve ter permissão para acessar todos os registros necessários, incluindo Transactions, como Invoices, Payments e Credit Memos; CRM Activities, como Phone Calls; e registros de clientes.
Instale as bibliotecas do Python: Abra a linha de comando ou o terminal e instale as bibliotecas Python necessárias. As principais são pandas para manipulação de dados, requests e requests_oauthlib para fazer chamadas de API, ou uma biblioteca dedicada do NetSuite. pip install pandas requests requests_oauthlib
Configure a autenticação: No script Python fornecido, localize a seção de credenciais. Insira com segurança o Account ID, Consumer Key, Consumer Secret, Token ID e Token Secret do NetSuite nas variáveis placeholder correspondentes. Recomendamos usar variáveis de ambiente ou um cofre seguro para gerenciar essas credenciais, em vez de inseri-las diretamente no código.
Configure os parâmetros de extração: No script, defina as variáveis start_date e end_date para especificar o período da extração. Você também pode ajustar o filtro subsidiary_id se precisar limitar a extração a uma subsidiária específica do NetSuite.
Entenda a lógica do script: O script está estruturado para consultar separadamente cada uma das 13 atividades necessárias. Cada consulta é uma instrução SuiteQL distinta enviada ao endpoint da API REST do NetSuite. O script gerencia automaticamente a paginação da API para recuperar todos os registros de cada consulta.
Execute o script Python: Execute o script no terminal usando o comando: python your_netsuite_extraction_script.py. O script se conectará ao NetSuite, executará a sequência de consultas e exibirá atualizações de status no console enquanto busca os dados de cada atividade.
Combine e transforme os dados: Depois de buscar os dados brutos de cada atividade, o script usa a biblioteca pandas para concatenar todos os resultados individuais em um único DataFrame. Esse DataFrame representa o Event Log.
Revise e salve o Event Log: O script salvará o DataFrame final em um arquivo CSV chamado netsuite_collections_event_log.csv. Abra esse arquivo para revisar a integridade e a precisão dos dados.
Prepare o upload: Verifique se o arquivo CSV final contém os cabeçalhos obrigatórios InvoiceNumber, ActivityName e EventTime, além dos atributos recomendados. O arquivo estará pronto para ser carregado no ProcessMind.

Configuração

Autenticação: o script usa a autenticação baseada em tokens (TBA) do NetSuite. Você precisa fornecer o Account ID, o Consumer Key, o Consumer Secret, o Token ID e o Token Secret. A função associada ao token precisa ter acesso de leitura aos registros de Transaction, Customer, Phone Call e Message.
Intervalo de datas: as variáveis start_date e end_date no script controlam a janela de extração. Para uma análise inicial, recomenda-se um período de 3 a 6 meses, equilibrando o volume de dados e a performance.
Filtro de subsidiária: uma variável subsidiary_id é incluída para filtrar os dados de uma unidade de negócio específica. Se você opera em um ambiente com uma única subsidiária, esse filtro pode ser omitido.
Endpoint da API: o script usa o endpoint da API REST SuiteQL do NetSuite. Verifique se ele está habilitado para sua conta (/services/rest/query/v1/suiteql).
Tratamento da paginação: o script inclui uma função para tratar automaticamente as respostas paginadas da API. O page_size está definido como 1000, o máximo permitido pela API, para reduzir o número de chamadas necessárias.
Campos personalizados: a extração de 'Dispute Registered' e 'Dispute Resolved' pressupõe o uso de campos personalizados (custbody_dispute_date, custbody_dispute_resolved_date). Você precisa atualizar o script com os IDs reais dos campos usados na sua instância do NetSuite.

a Consulta de exemplo python

import pandas as pd
import requests
from requests_oauthlib import OAuth1
import json
import os
from datetime import datetime

class=class="hl-string">"hl-comment"># --- Configuration Settings ---
class=class="hl-string">"hl-comment"># Best practice: Use environment variables instead of hardcoding credentials.
NS_ACCOUNT = os.getenv(class="hl-string">'NS_ACCOUNT', class="hl-string">'[Your NetSuite Account ID]')
NS_CONSUMER_KEY = os.getenv(class="hl-string">'NS_CONSUMER_KEY', class="hl-string">'[Your Consumer Key]')
NS_CONSUMER_SECRET = os.getenv(class="hl-string">'NS_CONSUMER_SECRET', class="hl-string">'[Your Consumer Secret]')
NS_TOKEN_ID = os.getenv(class="hl-string">'NS_TOKEN_ID', class="hl-string">'[Your Token ID]')
NS_TOKEN_SECRET = os.getenv(class="hl-string">'NS_TOKEN_SECRET', class="hl-string">'[Your Token Secret]')

class=class="hl-string">"hl-comment"># The base URL for the SuiteQL API endpoint
BASE_URL = fclass="hl-string">"https://{NS_ACCOUNT.replace('_', '-')}.suitetalk.api.netsuite.com/services/rest/query/v1/suiteql"

class=class="hl-string">"hl-comment"># --- Extraction Parameters ---
START_DATE = class="hl-string">'2023-01-01'
END_DATE = class="hl-string">'2023-12-31'
SUBSIDIARY_ID = class="hl-string">'[Your Subsidiary ID]' class=class="hl-string">"hl-comment"># Optional: filter by subsidiary

def execute_suiteql(query):
    class="hl-string">"""Executes a SuiteQL query and handles pagination."""
    all_results = []
    offset = 0
    limit = 1000

    oauth = OAuth1(
        client_key=NS_CONSUMER_KEY,
        client_secret=NS_CONSUMER_SECRET,
        resource_owner_key=NS_TOKEN_ID,
        resource_owner_secret=NS_TOKEN_SECRET,
        realm=NS_ACCOUNT,
        signature_method=class="hl-string">'HMAC-SHA256'
    )

    headers = {
        class="hl-string">'Content-Type': class="hl-string">'application/json',
        class="hl-string">'Prefer': class="hl-string">'transient'
    }

    while True:
        paginated_query = fclass="hl-string">"{query} LIMIT {limit} OFFSET {offset}"
        payload = json.dumps({class="hl-string">'q': paginated_query})
        
        try:
            response = requests.post(BASE_URL, headers=headers, data=payload, auth=oauth)
            response.raise_for_status() class=class="hl-string">"hl-comment"># Raise an exception for bad status codes
            data = response.json()
            
            if not data.get(class="hl-string">'items'):
                break

            all_results.extend(data[class="hl-string">'items'])
            
            if not data.get(class="hl-string">'hasMore', False):
                break
            
            offset += limit

        except requests.exceptions.RequestException as e:
            print(fclass="hl-string">"API Request Error: {e}")
            print(fclass="hl-string">"Response body: {response.text if 'response' in locals() else 'No response'}")
            return None

    return all_results

def main():
    class="hl-string">"""Main function to orchestrate the data extraction."""
    all_events = []
    
    class=class="hl-string">"hl-comment"># Common WHERE clause for filtering by date and subsidiary
    common_filter = fclass="hl-string">"WHERE T.trandate BETWEEN TO_DATE('{START_DATE}', 'YYYY-MM-DD') AND TO_DATE('{END_DATE}', 'YYYY-MM-DD') AND T.subsidiary = {SUBSIDIARY_ID}"

    class=class="hl-string">"hl-comment"># --- Define SuiteQL Queries for Each Activity ---
    queries = {
        class="hl-string">'Invoice Generated': fclass="hl-string">"""
            SELECT
                T.tranid AS InvoiceNumber,
                'Invoice Generated' AS ActivityName,
                TO_CHAR(T.createdDate, 'YYYY-MM-DD"T"HH24:MI:SS"Z"') AS EventTime,
                T.entity AS CustomerId,
                BUILTIN.DF(C.category) AS CustomerSegment,
                T.foreignTotal AS InvoiceAmount,
                TO_CHAR(T.dueDate, 'YYYY-MM-DD') AS DueDate,
                BUILTIN.DF(T.status) AS InvoiceStatus
            FROM
                Transaction AS T
                INNER JOIN Customer AS C ON T.entity = C.id
            WHERE
                T.type = 'CustInvc' AND T.voided = 'F' AND T.subsidiary = {SUBSIDIARY_ID}
                AND T.createdDate BETWEEN TO_TIMESTAMP('{START_DATE} 00:00:00', 'YYYY-MM-DD HH24:MI:SS') AND TO_TIMESTAMP('{END_DATE} 23:59:59', 'YYYY-MM-DD HH24:MI:SS')
        """,
        class="hl-string">'Invoice Sent to Customer': fclass="hl-string">"""
            SELECT
                T.tranid AS InvoiceNumber,
                'Invoice Sent to Customer' AS ActivityName,
                TO_CHAR(M.messageDate, 'YYYY-MM-DD"T"HH24:MI:SS"Z"') AS EventTime,
                T.entity AS CustomerId,
                BUILTIN.DF(C.category) AS CustomerSegment,
                T.foreignTotal AS InvoiceAmount,
                TO_CHAR(T.dueDate, 'YYYY-MM-DD') AS DueDate,
                BUILTIN.DF(T.status) AS InvoiceStatus
            FROM
                Transaction AS T
                INNER JOIN Message AS M ON T.id = M.transaction
                INNER JOIN Customer AS C ON T.entity = C.id
            WHERE
                T.type = 'CustInvc' AND T.voided = 'F' AND T.subsidiary = {SUBSIDIARY_ID}
                AND M.emailed = 'T' AND M.messageDate IS NOT NULL
                AND M.messageDate BETWEEN TO_TIMESTAMP('{START_DATE} 00:00:00', 'YYYY-MM-DD HH24:MI:SS') AND TO_TIMESTAMP('{END_DATE} 23:59:59', 'YYYY-MM-DD HH24:MI:SS')
        """,
        class="hl-string">'Payment Due Date Passed': fclass="hl-string">"""
            SELECT
                T.tranid AS InvoiceNumber,
                'Payment Due Date Passed' AS ActivityName,
                TO_CHAR(T.dueDate, 'YYYY-MM-DD"T"23:59:59"Z"') AS EventTime,
                T.entity AS CustomerId,
                BUILTIN.DF(C.category) AS CustomerSegment,
                T.foreignTotal AS InvoiceAmount,
                TO_CHAR(T.dueDate, 'YYYY-MM-DD') AS DueDate,
                BUILTIN.DF(T.status) AS InvoiceStatus
            FROM
                Transaction AS T
                INNER JOIN Customer AS C ON T.entity = C.id
            WHERE
                T.type = 'CustInvc' AND T.voided = 'F' AND T.subsidiary = {SUBSIDIARY_ID}
                AND T.status NOT IN ('CustInvc:B', 'CustInvc:A') -- Not Paid In Full or Pending Approval
                AND T.dueDate < CURRENT_DATE
                AND T.dueDate BETWEEN TO_DATE('{START_DATE}', 'YYYY-MM-DD') AND TO_DATE('{END_DATE}', 'YYYY-MM-DD')
        """,
        class="hl-string">'Overdue Reminder Sent': fclass="hl-string">"""
            SELECT
                T.tranid AS InvoiceNumber,
                'Overdue Reminder Sent' AS ActivityName,
                TO_CHAR(M.messageDate, 'YYYY-MM-DD"T"HH24:MI:SS"Z"') AS EventTime,
                T.entity AS CustomerId,
                BUILTIN.DF(C.category) AS CustomerSegment,
                T.foreignTotal AS InvoiceAmount,
                TO_CHAR(T.dueDate, 'YYYY-MM-DD') AS DueDate,
                BUILTIN.DF(T.status) AS InvoiceStatus
            FROM
                Transaction AS T
                INNER JOIN Message AS M ON T.id = M.transaction
                INNER JOIN Customer AS C ON T.entity = C.id
            WHERE
                T.type = 'CustInvc' AND T.voided = 'F' AND T.subsidiary = {SUBSIDIARY_ID}
                AND (M.subject LIKE '%Overdue%' OR M.subject LIKE '%Reminder%')
                AND M.messageDate BETWEEN TO_TIMESTAMP('{START_DATE} 00:00:00', 'YYYY-MM-DD HH24:MI:SS') AND TO_TIMESTAMP('{END_DATE} 23:59:59', 'YYYY-MM-DD HH24:MI:SS')
        """,
        class="hl-string">'Dunning Procedure Initiated': fclass="hl-string">"""
            SELECT
                T.tranid AS InvoiceNumber,
                'Dunning Procedure Initiated' AS ActivityName,
                TO_CHAR(SL.systemNoteDate, 'YYYY-MM-DD"T"HH24:MI:SS"Z"') AS EventTime,
                T.entity AS CustomerId,
                BUILTIN.DF(C.category) AS CustomerSegment,
                T.foreignTotal AS InvoiceAmount,
                TO_CHAR(T.dueDate, 'YYYY-MM-DD') AS DueDate,
                BUILTIN.DF(T.status) AS InvoiceStatus
            FROM
                Transaction AS T
                INNER JOIN Customer AS C ON T.entity = C.id
                INNER JOIN SystemNote AS SL ON T.id = SL.recordId
            WHERE
                T.type = 'CustInvc' AND T.voided = 'F' AND T.subsidiary = {SUBSIDIARY_ID}
                AND SL.field = 'custbody_dunning_level' AND SL.oldValue IS NULL -- Assumes a custom dunning level field
                AND SL.systemNoteDate BETWEEN TO_TIMESTAMP('{START_DATE} 00:00:00', 'YYYY-MM-DD HH24:MI:SS') AND TO_TIMESTAMP('{END_DATE} 23:59:59', 'YYYY-MM-DD HH24:MI:SS')
        """,
        class="hl-string">'Collection Call Made': fclass="hl-string">"""
            SELECT
                T.tranid AS InvoiceNumber,
                'Collection Call Made' AS ActivityName,
                TO_CHAR(PC.completedDate, 'YYYY-MM-DD"T"HH24:MI:SS"Z"') AS EventTime,
                T.entity AS CustomerId,
                BUILTIN.DF(C.category) AS CustomerSegment,
                T.foreignTotal AS InvoiceAmount,
                TO_CHAR(T.dueDate, 'YYYY-MM-DD') AS DueDate,
                BUILTIN.DF(T.status) AS InvoiceStatus
            FROM
                PhoneCall AS PC
                INNER JOIN Transaction AS T ON PC.transaction = T.id
                INNER JOIN Customer AS C ON T.entity = C.id
            WHERE
                T.type = 'CustInvc' AND T.voided = 'F' AND T.subsidiary = {SUBSIDIARY_ID}
                AND PC.title LIKE '%Collection%'
                AND PC.completedDate BETWEEN TO_TIMESTAMP('{START_DATE} 00:00:00', 'YYYY-MM-DD HH24:MI:SS') AND TO_TIMESTAMP('{END_DATE} 23:59:59', 'YYYY-MM-DD HH24:MI:SS')
        """,
        class="hl-string">'Dispute Registered': fclass="hl-string">"""
            SELECT
                T.tranid AS InvoiceNumber,
                'Dispute Registered' AS ActivityName,
                TO_CHAR(T.custbody_dispute_date, 'YYYY-MM-DD"T"HH24:MI:SS"Z"') AS EventTime,
                T.entity AS CustomerId,
                BUILTIN.DF(C.category) AS CustomerSegment,
                T.foreignTotal AS InvoiceAmount,
                TO_CHAR(T.dueDate, 'YYYY-MM-DD') AS DueDate,
                BUILTIN.DF(T.status) AS InvoiceStatus
            FROM
                Transaction AS T
                INNER JOIN Customer AS C ON T.entity = C.id
            WHERE
                T.type = 'CustInvc' AND T.voided = 'F' AND T.subsidiary = {SUBSIDIARY_ID}
                AND T.custbody_dispute_date IS NOT NULL -- Assumes a custom dispute date field
                AND T.custbody_dispute_date BETWEEN TO_DATE('{START_DATE}', 'YYYY-MM-DD') AND TO_DATE('{END_DATE}', 'YYYY-MM-DD')
        """,
        class="hl-string">'Dispute Resolved': fclass="hl-string">"""
            SELECT
                T.tranid AS InvoiceNumber,
                'Dispute Resolved' AS ActivityName,
                TO_CHAR(T.custbody_dispute_resolved_date, 'YYYY-MM-DD"T"HH24:MI:SS"Z"') AS EventTime,
                T.entity AS CustomerId,
                BUILTIN.DF(C.category) AS CustomerSegment,
                T.foreignTotal AS InvoiceAmount,
                TO_CHAR(T.dueDate, 'YYYY-MM-DD') AS DueDate,
                BUILTIN.DF(T.status) AS InvoiceStatus
            FROM
                Transaction AS T
                INNER JOIN Customer AS C ON T.entity = C.id
            WHERE
                T.type = 'CustInvc' AND T.voided = 'F' AND T.subsidiary = {SUBSIDIARY_ID}
                AND T.custbody_dispute_resolved_date IS NOT NULL -- Assumes a custom dispute resolved date field
                AND T.custbody_dispute_resolved_date BETWEEN TO_DATE('{START_DATE}', 'YYYY-MM-DD') AND TO_DATE('{END_DATE}', 'YYYY-MM-DD')
        """,
        class="hl-string">'Credit Memo Issued': fclass="hl-string">"""
            SELECT
                AppliedTo.tranid AS InvoiceNumber,
                'Credit Memo Issued' AS ActivityName,
                TO_CHAR(CM.trandate, 'YYYY-MM-DD"T"HH24:MI:SS"Z"') AS EventTime,
                CM.entity AS CustomerId,
                BUILTIN.DF(C.category) AS CustomerSegment,
                AppliedTo.foreignTotal AS InvoiceAmount,
                TO_CHAR(AppliedTo.dueDate, 'YYYY-MM-DD') AS DueDate,
                BUILTIN.DF(AppliedTo.status) AS InvoiceStatus
            FROM
                Transaction AS CM
                INNER JOIN TransactionLine AS CML ON CM.id = CML.transaction
                INNER JOIN Transaction AS AppliedTo ON CML.appliedToTransaction = AppliedTo.id
                INNER JOIN Customer AS C ON CM.entity = C.id
            WHERE
                CM.type = 'CustCred' AND CM.voided = 'F' AND CM.subsidiary = {SUBSIDIARY_ID}
                AND AppliedTo.type = 'CustInvc'
                AND CM.trandate BETWEEN TO_DATE('{START_DATE}', 'YYYY-MM-DD') AND TO_DATE('{END_DATE}', 'YYYY-MM-DD')
        """,
        class="hl-string">'Payment Received': fclass="hl-string">"""
            SELECT
                AppliedTo.tranid AS InvoiceNumber,
                'Payment Received' AS ActivityName,
                TO_CHAR(P.trandate, 'YYYY-MM-DD"T"HH24:MI:SS"Z"') AS EventTime,
                P.entity AS CustomerId,
                BUILTIN.DF(C.category) AS CustomerSegment,
                AppliedTo.foreignTotal AS InvoiceAmount,
                TO_CHAR(AppliedTo.dueDate, 'YYYY-MM-DD') AS DueDate,
                BUILTIN.DF(AppliedTo.status) AS InvoiceStatus
            FROM
                Transaction AS P
                INNER JOIN TransactionLine AS PL ON P.id = PL.transaction
                INNER JOIN Transaction AS AppliedTo ON PL.appliedToTransaction = AppliedTo.id
                INNER JOIN Customer AS C ON P.entity = C.id
            WHERE
                P.type = 'CustPymt' AND P.voided = 'F' AND P.subsidiary = {SUBSIDIARY_ID}
                AND AppliedTo.type = 'CustInvc'
                AND P.trandate BETWEEN TO_DATE('{START_DATE}', 'YYYY-MM-DD') AND TO_DATE('{END_DATE}', 'YYYY-MM-DD')
        """,
        class="hl-string">'Payment Posted': fclass="hl-string">"""
            SELECT
                AppliedTo.tranid AS InvoiceNumber,
                'Payment Posted' AS ActivityName,
                TO_CHAR(P.postingdate, 'YYYY-MM-DD"T"HH24:MI:SS"Z"') AS EventTime,
                P.entity AS CustomerId,
                BUILTIN.DF(C.category) AS CustomerSegment,
                AppliedTo.foreignTotal AS InvoiceAmount,
                TO_CHAR(AppliedTo.dueDate, 'YYYY-MM-DD') AS DueDate,
                BUILTIN.DF(AppliedTo.status) AS InvoiceStatus
            FROM
                Transaction AS P
                INNER JOIN TransactionLine AS PL ON P.id = PL.transaction
                INNER JOIN Transaction AS AppliedTo ON PL.appliedToTransaction = AppliedTo.id
                INNER JOIN Customer AS C ON P.entity = C.id
            WHERE
                P.type = 'CustPymt' AND P.voided = 'F' AND P.subsidiary = {SUBSIDIARY_ID}
                AND AppliedTo.type = 'CustInvc' AND P.posting = 'T'
                AND P.postingdate BETWEEN TO_DATE('{START_DATE}', 'YYYY-MM-DD') AND TO_DATE('{END_DATE}', 'YYYY-MM-DD')
        """,
        class="hl-string">'Invoice Settled': fclass="hl-string">"""
            SELECT
                T.tranid AS InvoiceNumber,
                'Invoice Settled' AS ActivityName,
                TO_CHAR(T.lastModifiedDate, 'YYYY-MM-DD"T"HH24:MI:SS"Z"') AS EventTime,
                T.entity AS CustomerId,
                BUILTIN.DF(C.category) AS CustomerSegment,
                T.foreignTotal AS InvoiceAmount,
                TO_CHAR(T.dueDate, 'YYYY-MM-DD') AS DueDate,
                BUILTIN.DF(T.status) AS InvoiceStatus
            FROM
                Transaction AS T
                INNER JOIN Customer AS C ON T.entity = C.id
            WHERE
                T.type = 'CustInvc' AND T.voided = 'F' AND T.subsidiary = {SUBSIDIARY_ID}
                AND T.status = 'CustInvc:B' -- Paid In Full
                AND T.lastModifiedDate BETWEEN TO_TIMESTAMP('{START_DATE} 00:00:00', 'YYYY-MM-DD HH24:MI:SS') AND TO_TIMESTAMP('{END_DATE} 23:59:59', 'YYYY-MM-DD HH24:MI:SS')
        """,
        class="hl-string">'Invoice Written Off': fclass="hl-string">"""
            SELECT
                AppliedTo.tranid AS InvoiceNumber,
                'Invoice Written Off' AS ActivityName,
                TO_CHAR(JE.trandate, 'YYYY-MM-DD"T"HH24:MI:SS"Z"') AS EventTime,
                JE.entity AS CustomerId,
                BUILTIN.DF(C.category) AS CustomerSegment,
                AppliedTo.foreignTotal AS InvoiceAmount,
                TO_CHAR(AppliedTo.dueDate, 'YYYY-MM-DD') AS DueDate,
                BUILTIN.DF(AppliedTo.status) AS InvoiceStatus
            FROM
                Transaction AS JE
                INNER JOIN TransactionLine AS JEL ON JE.id = JEL.transaction
                INNER JOIN Transaction AS AppliedTo ON JEL.entity = AppliedTo.entity -- A best-effort link via customer
                INNER JOIN Customer AS C ON JE.entity = C.id
            WHERE
                JE.type = 'Journal' AND JE.voided = 'F' AND JE.subsidiary = {SUBSIDIARY_ID}
                AND JEL.account = [Your Bad Debt Expense Account ID] -- Must configure your specific bad debt account
                AND AppliedTo.type = 'CustInvc'
                AND JE.trandate BETWEEN TO_DATE('{START_DATE}', 'YYYY-MM-DD') AND TO_DATE('{END_DATE}', 'YYYY-MM-DD')
                AND (JEL.memo LIKE '%' || AppliedTo.tranid || '%' OR JE.memo LIKE '%' || AppliedTo.tranid || '%') -- Best-effort link by checking memo field for invoice number
        """
    }

    for activity, query in queries.items():
        print(fclass="hl-string">"Fetching data for: {activity}...")
        results = execute_suiteql(query)
        if results:
            all_events.extend(results)
            print(fclass="hl-string">"  ...found {len(results)} events.")
        else:
            print(fclass="hl-string">"  ...no events found or an error occurred.")

    if not all_events:
        print(class="hl-string">"No data extracted. Exiting.")
        return

    class=class="hl-string">"hl-comment"># Convert to pandas DataFrame
    df = pd.DataFrame(all_events)
    
    class=class="hl-string">"hl-comment"># Data Cleaning and Formatting
    df[class="hl-string">'EventTime'] = pd.to_datetime(df[class="hl-string">'EventTime'])
    df = df.sort_values(by=[class="hl-string">'InvoiceNumber', class="hl-string">'EventTime'])
    df.rename(columns=lambda c: class="hl-string">''.join(c.split()).capitalize(), inplace=True)
    
    class=class="hl-string">"hl-comment"># Save to CSV
    output_file = class="hl-string">'netsuite_collections_event_log.csv'
    df.to_csv(output_file, index=False)
    print(fclass="hl-string">"\nEvent log successfully saved to {output_file}")

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

Pronto para começar?

Use este Template para simplificar a preparação dos seus dados e obter insights relevantes sobre seu processo de gestão de crédito e cobrança. Comece hoje sua jornada rumo a um fluxo de caixa mais saudável.

Voltar ao guia de melhoria Baixar Template

Comece a otimizar Crédito e Cobrança hoje!

Descubra ineficiências, reduza o tempo de ciclo em 30% e melhore seu fluxo de caixa rapidamente.

Começar o teste grátis

Não é necessário cartão de crédito. Configure tudo 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 de dados de Saved Searches e relatórios do NetSuite

Etapas

Configuração

a Consulta de exemplo sql

Extração em Python usando os Web Services do NetSuite SuiteTalk

Etapas

Configuração

a Consulta de exemplo python

Pronto para começar?

Comece a otimizar Crédito e Cobrança hoje!

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 de dados de Saved Searches e relatórios do NetSuite

Etapas

Configuração

a Consulta de exemplo sql

Extração em Python usando os Web Services do NetSuite SuiteTalk

Etapas

Configuração

a Consulta de exemplo python

Pronto para começar?

Comece a otimizar Crédito e Cobrança hoje!

Valorizamos sua privacidade