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

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

NetSuite

Atributos de gestão de crédito e cobranças(21) Atividades de gestão de crédito e cobranças(13) Guias de extração(2)

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

Este Template oferece um guia completo para coletar os dados certos e analisar seu processo de gestão de crédito e cobranças. Ele apresenta os atributos e as atividades essenciais, além de orientações práticas para extração, para ajudar você a começar rapidamente. Seguindo estas recomendações, você prepara os dados para uma análise de processo mais esclarecedora e para identificar oportunidades de melhoria.

Atributos recomendados para coleta
Principais atividades a acompanhar
Orientações para extrair dados do NetSuite

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

Baixar Template

Atributos de gestão de crédito e cobranças

Estes são os campos de dados recomendados para incluir no Event Log e analisar a fundo o processo de gestão de crédito e cobranças.

3 Obrigatório 5 Recomendado 13 Opcional

	Nome	Descrição
	Horário do evento EventTime	Registro de data e hora que indica quando a atividade ocorreu.
Descrição Este atributo registra a data e a hora exatas de cada atividade do processo. É 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 registro de data e hora geralmente corresponde à data de criação ou da última alteração do registro ou da nota do sistema relevante. Por que isso importa Permite calcular todas as métricas de performance relacionadas ao tempo, como tempos de ciclo e gargalos, essenciais para a análise de eficiência. Onde encontrar Os dados vêm de campos de data de vários registros. Por exemplo, a 'Date Created' de um registro Invoice para 'Fatura gerada' ou o registro de data e hora 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	Nome da atividade de negócio realizada em um momento específico.
Descrição Este atributo descreve uma etapa ou um evento específico do processo de crédito e cobrança, como 'Fatura gerada', 'Pagamento recebido' ou 'Disputa registrada'. Analisar a sequência e a frequência dessas atividades é a base da mineração de processos: revela o fluxo real do processo, seus desvios e gargalos. Por que isso importa Este atributo é a base do mapa de processos e permite visualizar e analisar o fluxo do processo. Onde encontrar Este campo geralmente é derivado das alterações de status dos registros de transação (por exemplo, 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	Identificador exclusivo de cada fatura de cliente.
Descrição O número da fatura é o principal identificador do caso e vincula de forma exclusiva todas as atividades relacionadas a um recebível específico. Isso permite analisar todo o ciclo de vida, desde a criação da fatura e as ações de gestão de crédito até o pagamento ou a resolução por meio das atividades de cobrança. No NetSuite, geralmente corresponde ao Transaction ID quando o tipo de transação é 'Invoice'. Por que isso importa É a chave essencial para acompanhar a trajetória da fatura, da emissão à quitação, e permite analisar o processo de ponta a ponta. Onde encontrar Geralmente, corresponde ao campo 'Transaction ID' (ID interno: tranid) do registro Invoice no NetSuite. Exemplos INV0012345INV0054321INV0098765
	Data de vencimento DueDate	Data-limite para o pagamento da fatura.
Descrição A data de vencimento é a data acordada em contrato para o pagamento. Ela serve de referência para determinar se um pagamento está em dia ou atrasado. Esse atributo é essencial para calcular KPIs como o 'Índice de pagamentos em dia' e iniciar atividades de cobrança após o vencimento. Por que isso importa É a principal referência para medir a pontualidade dos pagamentos e é essencial para calcular os dias de atraso e monitorar a conformidade com as condições de pagamento. Onde encontrar Este é o campo 'Due Date' (ID interno: duedate) do registro da transação Invoice. Exemplos 2023-02-142023-03-312023-04-15
	ID do cliente CustomerId	Identificador exclusivo do cliente associado à fatura.
Descrição Este atributo vincula uma fatura a um cliente específico no NetSuite. É essencial para segmentar os dados e analisar a performance do processo entre diferentes clientes ou grupos. Por exemplo, permite comparar o comportamento de pagamento ou os índices de disputa de contas estratégicas com os de pequenas empresas. Por que isso importa Permite uma análise centrada no cliente e ajuda a identificar quais clientes costumam atrasar pagamentos, contestar faturas ou seguir processos fora do padrão. Onde encontrar Este é o campo 'Customer' (ID interno: entity) do registro da transação Invoice. Exemplos CUST001CUST002CUST003
	Segmento do cliente CustomerSegment	Classificação do cliente por porte, setor ou região, por exemplo.
Descrição O segmento do cliente agrupa clientes em categorias relevantes (por exemplo, 'Enterprise', 'Pequenas e médias empresas' e 'Setor público'). Esse atributo é essencial para o Dashboard 'Performance da estratégia de cobrança por segmento', pois permite comparar a eficácia de diferentes abordagens de cobrança entre os segmentos. Também ajuda a adaptar as estratégias ao comportamento de cada grupo. Por que isso importa Permite uma análise direcionada para determinar se certos problemas de processo ou comportamentos de pagamento se concentram em grupos específicos de clientes. Onde encontrar Geralmente, é um campo personalizado do registro Customer no NetSuite. Os dados precisam ser associados do registro Customer à transação Invoice. Exemplos EnterpriseMercado intermediárioSMB
	Status da fatura InvoiceStatus	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 ativas ou com problemas. O Dashboard 'Idade e status das faturas vencidas' usa esse atributo para mostrar 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 em aberto, vencidas ou contestadas. Onde encontrar Corresponde ao campo 'Status' (ID interno: status) do registro da transação Invoice. Exemplos Em abertoTotalmente pagaEm atraso
	Valor da fatura InvoiceAmount	Valor monetário total da fatura.
Descrição Representa o valor total devido na fatura. Este é um atributo financeiro essencial para quase todas as análises, como identificar o impacto financeiro de pagamentos atrasados ou analisar baixas de faturas de alto valor. Também fornece contexto importante para priorizar as ações de cobrança. Por que isso importa Fornece contexto financeiro ao processo e permite análises por valor monetário, como priorizar a cobrança de faturas vencidas de alto valor. Onde encontrar Este é o campo 'Amount (Total)' (ID interno: total) do registro da transação Invoice. Exemplos 1500.00250.5012500.75
	Atraso no lançamento do pagamento PaymentPostingLag	Tempo entre o recebimento do pagamento e seu lançamento no sistema.
Descrição Esta duração calculada mede o intervalo entre a atividade 'Pagamento recebido' (quando os recursos são recebidos) e a atividade 'Pagamento lançado' (quando o pagamento é aplicado à fatura no NetSuite). É uma métrica importante para o Dashboard 'Análise do atraso no lançamento de pagamentos', pois destaca ineficiências internas na aplicação de recebimentos que podem distorcer a visibilidade do caixa. Por que isso importa Revela atrasos internos na aplicação de recebimentos, que podem afetar a precisão dos relatórios financeiros e a situação das contas dos clientes. Onde encontrar É calculado na ferramenta de Process Mining: Timestamp('Pagamento lançado') - Timestamp('Pagamento recebido'). Exemplos 1 dia4 horas3 dias
	Condições de pagamento PaymentTerms	Condições de pagamento acordadas com o cliente para a fatura.
Descrição Este atributo especifica as condições de pagamento esperadas para uma fatura, como '30 dias' ou '60 dias'. Ele serve de base para calcular a data de vencimento da fatura e é fundamental para o Dashboard 'Conformidade e desvios das condições de pagamento', que analisa se os clientes cumprem as condições acordadas. Por que isso importa Fornece a base contratual para os prazos de pagamento e é essencial para analisar a conformidade e identificar desvios que afetam o fluxo de caixa. Onde encontrar Este é o campo 'Terms' (ID interno: terms) do registro da transação Invoice. Exemplos 30 dias60 diasVencimento no recebimento
	Dias em atraso DaysOverdue	Número de dias desde o vencimento da fatura.
Descrição Esta métrica calculada mede o número de dias entre a data de vencimento da fatura e a data atual, no caso de faturas em aberto, ou a data do pagamento. É um KPI fundamental para cobranças, usado no Dashboard 'Antiguidade e status das faturas em atraso' para categorizar e priorizar as ações de cobrança. Um valor igual ou inferior a zero indica que a fatura não está em atraso. Por que isso importa Mede diretamente a gravidade dos atrasos nos pagamentos e é uma métrica importante para relatórios de antiguidade e priorização das ações de cobrança. Onde encontrar É calculado durante a transformação dos dados: (data atual ou data do pagamento) - data de vencimento. Exemplos 1532090
	É automatizada IsAutomated	Indica se uma atividade foi realizada automaticamente por um sistema.
Descrição Este atributo booleano indica se uma atividade foi executada por um fluxo de trabalho automatizado ou por uma pessoa. Por exemplo, a atividade 'Lembrete de atraso enviado' pode ser automatizada, enquanto 'Ligação de cobrança realizada' é manual. Essa informação é essencial para o Dashboard 'Frequência e impacto das atividades manuais', que quantifica os níveis de automação e identifica oportunidades para automatizar outras atividades. Por que isso importa Ajuda a quantificar o nível de automação do processo, apoiando iniciativas para reduzir o trabalho manual e aumentar a eficiência. Onde encontrar Este atributo derivado se baseia no tipo de atividade ou no usuário que a realizou. Por exemplo, se a atividade foi realizada por um usuário designado como 'SYSTEM', ela é identificada como automatizada. Exemplos truefalse
	ID do usuário UserId	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 e a performance da equipe, além de identificar 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, entender a distribuição da carga de trabalho e identificar onde ocorrem intervenções manuais. Onde encontrar Obtido de campos como 'Created By', 'Modified By' ou de um campo específico 'Owner' em transações ou registros relacionados (por exemplo, o registro Phone Call para ligações de cobrança). Exemplos j.doea.smithSYSTEM
	Motivo da disputa DisputeReason	Motivo informado pelo cliente ao contestar uma fatura.
Descrição Quando um cliente contesta uma fatura, este atributo registra o motivo, como 'Preço incorreto', 'Mercadoria danificada' ou 'Cobrança duplicada'. Ele é essencial para os Dashboards 'Tempo de resolução de disputas de faturas' e 'Análise de causa raiz das baixas de faturas', 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 e fornece insights para melhorar processos anteriores, como o atendimento de pedidos ou a precisão do faturamento. Onde encontrar Provavelmente, é um campo personalizado do registro Invoice ou de 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 agente de cobrança CollectorName	Nome do agente de cobrança responsável pela fatura.
Descrição Identifica o agente ou recurso específico 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 agente. Também dá suporte a KPIs como o 'Índice de sucesso dos contatos de cobrança'. Por que isso importa Permite medir a performance e equilibrar a carga de trabalho da equipe de cobrança, vinculando as atividades a pessoas específicas. Onde encontrar Geralmente, é um campo personalizado do registro Customer ou Invoice. Alguns pacotes do NetSuite para cobrança incluem essa funcionalidade. Exemplos Alice JohnsonRobert WilliamsNão atribuído
	Pagamento em dia IsOnTimePayment	Indica 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 em dia' e facilita a filtragem e a análise de pagamentos feitos no prazo ou em atraso. O resultado é claro e binário, facilitando a avaliação da performance dos pagamentos. Por que isso importa Oferece uma métrica simples e binária para avaliar a conformidade com os prazos de pagamento, facilitando o cálculo e a comparação da taxa de pagamentos em dia. Onde encontrar É calculado durante a transformação dos dados: VERDADEIRO se (data do pagamento <= data de vencimento); caso contrário, FALSO. Exemplos truefalse
	País Country	O país do endereço de cobrança do cliente.
Descrição Este 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 nos índices de contestação. Essa análise ajuda a adaptar as estratégias de cobrança a cada região e a entender o impacto das condições econômicas locais. Por que isso importa Permite segmentar o processo por região, destacando diferenças regionais no comportamento de pagamento ou na eficiência do processo. Onde encontrar O dado vem dos detalhes de 'Endereço de cobrança' da transação Fatura, que geralmente herda essas informações do registro do cliente. Exemplos USAAlemanhaJapão
	Sistema de origem SourceSystem	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 atributo é obrigatório para a governança de dados e para distinguir as fontes em ambientes 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 encontrar Este é um valor estático ('NetSuite'), adicionado durante a transformação dos dados. Exemplos NetSuite
	Tempo de ciclo da fatura ao recebimento InvoiceToCashCycleTime	Tempo total entre a emissão da fatura e a quitação final.
Descrição Esta métrica calculada mede o tempo total entre as atividades 'Fatura emitida' e 'Fatura quitada'. 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 oferece uma visão geral da velocidade do fluxo de caixa. Por que isso importa Este KPI estratégico e de alto nível mede a eficiência geral de todo o processo da emissão da fatura ao recebimento. Onde encontrar Este cálculo é feito por caso na ferramenta de Process Mining: Timestamp('Fatura quitada') - Timestamp('Fatura emitida'). Exemplos 32 dias45 dias91 dias
	Última atualização dos dados LastDataUpdate	Registro de data e hora da última atualização dos dados do sistema de origem.
Descrição Este atributo indica quando os dados deste processo foram extraídos e atualizados pela última vez na ferramenta de mineração de processos. Ele ajuda você a entender o quanto os dados analisados são recentes e a tomar decisões com base em informações atualizadas. Por que isso importa Mostra a atualidade dos dados e permite saber até que ponto a análise do processo está atualizada. Onde encontrar Este valor é gerado e registrado no conjunto de dados durante a 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, geralmente corresponde ao campo 'Subsidiária'. Esse atributo permite segmentar a análise do processo por diferentes áreas 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 encontrar No NetSuite OneWorld, corresponde ao campo 'Subsidiária'. Em outras contas, pode ser 'Departamento' ou 'Classe', dependendo da configuração. Exemplos Oeste dos USServiços EMEAProdutos APAC

Obrigatório Recomendado Opcional

Atividades de gestão de crédito e cobranças

Estas são as principais etapas e os marcos do processo que você deve registrar no Event Log para descobrir e otimizar com precisão seu fluxo de trabalho de cobranças.

5 Recomendado 8 Opcional

	Atividade	Descrição
	Data de vencimento do pagamento ultrapassada	Evento calculado que ocorre quando a data atual ultrapassa a data de vencimento da fatura, sem que ela tenha sido totalmente paga. Indica a mudança do status da fatura de 'em dia' para 'em atraso'.
Por que isso importa Este 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 das cobranças e dos procedimentos de cobrança. Onde encontrar Este é um evento calculado, obtido pela comparação entre a data atual e o campo 'Due Date' do registro da transação Invoice. O registro de data e hora do evento corresponde à própria data de vencimento. Coleta O registro de data e hora corresponde ao valor do campo 'Due Date' da fatura. Tipo de evento calculated
	Fatura baixada	Término malsucedido do ciclo de vida da fatura, quando a dívida é considerada incobrável e removida das contas a receber. O evento é capturado quando um lançamento contábil de dívida incobrável é aplicado à fatura.
Por que isso importa Este é 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 instância, as dívidas incobráveis. Onde encontrar Inferido a partir da aplicação de um 'Journal Entry' à fatura, quando o lançamento contábil se refere especificamente à baixa de uma dívida incobrável. Também pode ser usado um status personalizado. Coleta Use a data do lançamento contábil 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 de fatura no NetSuite e serve como ponto de partida do ciclo de vida da fatura.
Por que isso importa Este é o principal evento de início do processo de faturamento ao recebimento. Ele é essencial para calcular métricas importantes, como o prazo médio de recebimento de vendas (DSO) e o tempo de ciclo total do processo de faturamento ao recebimento. Onde encontrar Este é um evento explícito, capturado a partir da data de criação do registro da transação de fatura no NetSuite (tabela Transaction, em que Type é 'Invoice'). Coleta Use o registro de data e hora de criação da transação da fatura. Tipo de evento explicit
	Fatura quitada	Conclusão bem-sucedida do ciclo de vida da fatura, quando o saldo devido chega a zero por meio de pagamentos e créditos aplicados. O evento é inferido quando o status da fatura muda para 'Paid In Full'.
Por que isso importa Este é o principal evento de término bem-sucedido do processo. É o dado final usado para calcular o tempo de ciclo total do processo de faturamento ao recebimento. Onde encontrar Inferido a partir da alteração do campo 'Status' da transação Invoice para 'Paid In Full'. O registro de data e hora pode ser obtido da data do pagamento final ou da nota de crédito que quitou a fatura. Coleta Registro de data e hora da última aplicação de pagamento que define o status como 'Paid In Full'. Tipo de evento inferred
	Pagamento recebido	Este evento marca a criação do pagamento do cliente e sua aplicação a uma fatura. É um marco essencial, capturado diretamente do registro da transação Customer Payment no NetSuite.
Por que isso importa Esta atividade é essencial para calcular o DSO e o índice de pagamentos em dia. Ela indica o recebimento do valor e é uma medida importante do sucesso das cobranças. Onde encontrar 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. Coleta Use a data da transação do registro Customer Payment. Tipo de evento explicit
	Disputa registrada	Indica que o cliente contestou formalmente a fatura, interrompendo o processo padrão de cobrança. Em geral, esse evento é inferido quando o campo de status da fatura muda para 'Disputed'.
Por que isso importa Este evento marca o início da medição do tempo de resolução de disputas. Identificar disputas frequentes pode revelar problemas subjacentes no processo de faturamento ou vendas. Onde encontrar Inferido a partir de um registro do sistema ou de uma alteração com registro de data e hora no campo personalizado 'Invoice Status' para um valor como 'Disputed' ou 'In Dispute'. Coleta Registro de data e hora 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 retomar o processo de cobrança ou quitar a fatura. O evento é inferido quando o status da fatura muda de 'Disputed' para um status ativo.
Por que isso importa Este é 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 dos clientes e acelerar o fluxo de caixa. Onde encontrar Inferido a partir de um registro do sistema ou de uma alteração com registro de data e hora no campo personalizado 'Invoice Status', de 'Disputed' para um valor como 'Open' ou 'Resolved'. Coleta Registro de data e hora 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 é enviada ao cliente, geralmente por e-mail. Esse evento costuma ser inferido a partir dos registros do sistema que acompanham as comunicações enviadas sobre a transação da fatura.
Por que isso importa Acompanhar essa atividade ajuda a identificar atrasos entre a criação da fatura e a notificação do cliente, que podem afetar o prazo de pagamento. Também revela a eficiência do processo de comunicação de cobrança. Onde encontrar Inferido a partir da data de um e-mail enviado pelo registro da fatura, disponível na subaba Communication > Messages da transação Invoice. Coleta Use o registro de data e hora do registro 'Message' vinculado à fatura. Tipo de evento inferred
	Lembrete de atraso enviado	Um lembrete inicial, muitas vezes 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 é a primeira etapa do processo de cobrança. Analisar sua frequência e seu impacto nos pagamentos ajuda a avaliar a eficácia das primeiras ações de cobrança. Onde encontrar Capturado a partir da data de criação de um registro 'Dunning Letter' associado à fatura, gerado pelo NetSuite Dunning SuiteApp. Coleta Use o registro de data e hora de criação do registro Dunning Letter. Tipo de evento explicit
	Ligação de cobrança realizada	Atividade manual de cobrança em que um agente entra em contato com o cliente por telefone. Esse evento é capturado a partir dos 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 seu índice de sucesso é importante para otimizar a alocação de recursos e a automação. Onde encontrar Capturado a partir da data de criação de um registro de atividade 'Phone Call' cujo registro relacionado é o cliente e cuja mensagem menciona o número da fatura. Coleta Use o registro de data e hora 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, muitas vezes para corrigir um erro ou como parte da resolução de uma disputa. No NetSuite, essa é uma transação explícita.
Por que isso importa A emissão frequente de notas de crédito pode indicar problemas sistêmicos, como erros de preço ou problemas de envio. Analisar sua ocorrência ajuda a identificar as causas raiz das perdas de receita. Onde encontrar Este é um evento explícito, capturado a partir da data de criação do registro da transação Credit Memo vinculado à fatura original. Coleta Use o registro de data e hora de criação da transação Credit Memo. Tipo de evento explicit
	Pagamento contabilizado	Representa a data em que o impacto financeiro do pagamento é registrado oficialmente no razão geral. Esse evento é capturado a partir da data de contabilização da transação Customer Payment.
Por que isso importa O intervalo entre 'Payment Received' e 'Payment Posted' revela atrasos administrativos. Analisar esse intervalo é importante para garantir relatórios financeiros precisos e pontuais. Onde encontrar Capturado a partir do campo 'Posting Period' ou da data da transação no impacto da transação 'Customer Payment' no razão geral. Coleta Use a data de contabilização no razão geral 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 de uma fatura vencida, que pode envolver várias etapas. O 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 adesão e a eficácia dos procedimentos de cobrança. Esse é um marco importante para analisar como diferentes estratégias de cobrança influenciam o comportamento de pagamento. Onde encontrar Inferido a partir da data em que o campo 'Dunning Level' do registro da fatura ou do cliente é definido pela primeira vez como um valor diferente de zero ou como o nível inicial de cobrança. Coleta Identifique o registro de data e hora em que o campo Dunning Level é alterado. Tipo de evento inferred

Recomendado Opcional

Guias de extração

Como obter seus dados do NetSuite

Etapas

Acesse o NetSuite: Entre na sua conta do NetSuite com uma função que tenha permissão para criar e executar pesquisas salvas e visualizar os registros necessários de transações e atividades (por exemplo, Fatura, Pagamento de cliente e Ligação telefônica).
Acesse as pesquisas salvas: Vá para Reports > Saved Searches > All Saved Searches > New. Repita 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 emitida'. Selecione 'Transação' como tipo de pesquisa. Essa pesquisa registrará a criação da fatura.
Defina os critérios da pesquisa: Na subaba 'Criteria', configure os seguintes filtros:
- Tipo é Fatura.
- Main Line é true. Assim, você obtém um registro por fatura, e não um 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 que correspondam aos nomes de atributos exigidos (por exemplo, InvoiceNumber). Use fórmulas para definir o campo ActivityName. O mapeamento detalhado dos campos está na seção de consultas.
Crie pesquisas para outros eventos: Com base nas configurações da seção de consultas, crie pesquisas salvas separadas para outras atividades, como pagamentos, notas de crédito, ligações de cobrança e mudanças de status. Elas podem usar outros tipos de registro, 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ê um nome descritivo a cada arquivo (por exemplo, invoice_generated.csv, payment_received.csv).
Gere eventos de vencimento do pagamento: Esse evento específico não é exportado diretamente. Você precisa calculá-lo depois de exportar os 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 definido como 'Prazo de pagamento vencido' e EventTime como DueDate mais um dia.
Combine os arquivos exportados: Use uma ferramenta externa para reunir todos os arquivos CSV exportados em um único arquivo principal. Antes de combiná-los, verifique se os cabeçalhos das colunas são idênticos.
Formate os dados finais: Revise o arquivo CSV combinado. Confira se EventTime usa um formato de data e hora consistente (por exemplo, YYYY-MM-DD HH:MI:SS) e se todas as colunas necessárias (InvoiceNumber, ActivityName, EventTime) estão presentes em cada linha.
Carregue os dados no ProcessMind: O arquivo CSV combinado está pronto para ser carregado como Event Log.

Configuração

Pré-requisitos: É necessário ter uma função de usuário com permissão para criar, editar e exportar pesquisas salvas. Você também precisa acessar os seguintes tipos de registro: Transação (para faturas, pagamentos e notas de crédito), Ligação telefônica (ou outros registros de atividade de CRM) e Notas do sistema.
Tipos de registro: Os principais tipos de registro usados nessas pesquisas são Transação e Ligação telefônica. O registro Nota do sistema também é usado para capturar alterações de status e eventos de comunicação quando não há registros de transação disponíveis.
Filtro por período: Para manter a performance e controlar o volume de dados, aplique sempre um filtro de data a todas as pesquisas salvas (por exemplo, Data de criação ou Data da última modificação). Para uma análise inicial, recomendamos usar dados de um período de 3 a 6 meses.
Filtro de linha principal: Ao pesquisar registros de transação, use o critério Main Line is true para isolar as informações do cabeçalho. Assim, você evita duplicar eventos para cada item de linha de uma fatura ou de um pagamento.
Uso de fórmulas: As fórmulas do NetSuite são essenciais para criar a coluna padronizada ActivityName. Os campos Formula (Text) permitem definir o nome da atividade para cada pesquisa, e Formula (Date/Time) pode ser usado para padronizar campos de data e hora, se necessário.
Limites de exportação: A exportação de CSV pela interface do NetSuite geralmente é limitada a 100.000 linhas por pesquisa. Para conjuntos de dados maiores, talvez seja necessário executar as pesquisas em períodos menores ou usar pesquisas agendadas que enviem os resultados ao File Cabinet.

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: Confira se o Python 3.6 ou superior está instalado no seu sistema. Você também precisará das credenciais do NetSuite SuiteTalk para usar a autenticação baseada em token (TBA), incluindo Account ID, Consumer Key, Consumer Secret, Token ID e Token Secret. A função do NetSuite associada precisa ter permissão para acessar todos os registros necessários, incluindo transações (faturas, pagamentos e notas de crédito), atividades de CRM (ligações telefônicas) 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 e requests e requests_oauthlib para fazer chamadas de API. Você também pode usar uma biblioteca específica para 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 seu Account ID, Consumer Key, Consumer Secret, Token ID e Token Secret nas variáveis indicadas. 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 de extração dos dados. Você também pode ajustar o filtro subsidiary_id para limitar a extração a uma subsidiária específica do NetSuite.
Entenda a lógica do script: O script consulta 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 lida automaticamente com a paginação da API para recuperar todos os registros de cada consulta.
Execute o script Python: Execute o script no terminal com o comando python your_netsuite_extraction_script.py. O script se conectará ao NetSuite, executará as 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 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 o arquivo e confira se os dados estão completos e corretos.
Prepare os dados para carregamento: Confira se o arquivo CSV final tem os cabeçalhos de coluna obrigatórios: InvoiceNumber, ActivityName e EventTime, além de quaisquer atributos recomendados. O arquivo estará pronto para ser carregado no ProcessMind.

Configuração

Autenticação: O script usa a autenticação baseada em token (TBA) do NetSuite. Você precisa informar Account ID, Consumer Key, Consumer Secret, Token ID e Token Secret. A função associada ao token precisa ter acesso de leitura aos registros de Transação, Cliente, Ligação telefônica e Mensagem.
Período: As variáveis start_date e end_date do script definem o período de extração. Para uma análise inicial, recomendamos um período de 3 a 6 meses, equilibrando o volume de dados e a performance.
Filtro de subsidiária: A variável subsidiary_id permite filtrar os dados de uma unidade de negócio específica. Se você trabalha em um ambiente com uma única subsidiária, pode omitir esse filtro.
Endpoint da API: O script usa o endpoint da API REST SuiteQL do NetSuite. Confira se ele está ativado na sua conta (/services/rest/query/v1/suiteql).
Paginação: O script inclui uma função para processar 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 'Contestação registrada' e 'Contestação resolvida' pressupõe o uso dos campos personalizados (custbody_dispute_date, custbody_dispute_resolved_date). Atualize o script com os IDs de campo usados na sua instância do NetSuite.

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 dados e obter insights valiosos sobre seu processo de gestão de crédito e cobranças. Comece hoje a melhorar seu fluxo de caixa.

Voltar ao guia de melhoria

Baixar Template

Comece hoje a otimizar crédito e cobranças!

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

Começar o teste grátis

Não é necessário informar cartão de crédito. A configuração leva poucos minutos.

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

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

Atributos de gestão de crédito e cobranças

Atividades de gestão de crédito e cobranças

Guias de extração

Exportação de dados de pesquisas salvas e relatórios do NetSuite

Etapas

Configuração

Consulta de exemplo sql

Extração com Python pelos serviços Web NetSuite SuiteTalk

Etapas

Configuração

Consulta de exemplo python

Pronto para começar?

Comece hoje a otimizar crédito e cobranças!