> Melhoria contínua de processos > Gestão de estoque > NetSuite > Template de dados

Seu Template de dados de gestão de estoque

NetSuite

Atributos de gestão de estoque(23) Atividades de gestão de estoque(15) Guias de extração(3)

Seu Template de dados de gestão de estoque

Este Template apresenta um roteiro claro para coletar os dados necessários à análise e à otimização do processo de gestão de estoque. Ele indica os atributos essenciais a coletar, as atividades importantes a acompanhar e como extrair essas informações dos sistemas de origem. Com essas recomendações, você pode criar um Event Log robusto, pronto para uma análise detalhada de Process Mining.

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

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

Baixar Template

Atributos de gestão de estoque

Estes são os campos de dados recomendados para incluir no Event Log e analisar seus processos de gestão de estoque de forma abrangente.

3 Obrigatório 7 Recomendado 13 Opcional

	Nome	Descrição
	Lote ou partida de estoque InventoryBatchLotNumber	Identificador exclusivo de um lote ou partida específico de um item em estoque, usado como ID do caso para acompanhar seu ciclo de vida.
Descrição O número do lote ou da partida do estoque é o principal identificador do caso e agrupa todas as atividades relacionadas a uma quantidade específica de um produto. Com ele, você acompanha o ciclo de vida completo de uma quantidade distinta de estoque, desde o recebimento até as diversas movimentações e a saída ou o consumo. Na análise de processos, cada valor exclusivo de InventoryBatchLotNumber representa uma instância de processo. Analisar os casos com base nesse identificador permite entender em detalhes como diferentes lotes são movimentados e identificar variações, atrasos e exceções no processo de gestão de estoque, do recebimento à expedição. Por que isso importa Este é o identificador essencial para rastrear todo o percurso de uma quantidade específica de estoque, analisar seu ciclo de vida completo e identificar variações no processo. Onde encontrar Esse identificador aparece nas linhas de transação dos itens de estoque controlados por lote ou partida no NetSuite. Ele é gerenciado nos detalhes de estoque do item. Exemplos LOT-202405-001B-FG-10984A2303-4CBATCH-001298
	Hora do evento TransactionDate	Data e hora que indicam quando a atividade de estoque ocorreu.
Descrição Este atributo registra a data e a hora exatas de uma atividade, como o recebimento de mercadorias ou o lançamento de um ajuste. Esse registro de data e hora é essencial para ordenar os eventos corretamente e calcular a duração entre as etapas do processo. Na análise, a Hora do evento é usada para criar o registro cronológico de eventos de cada caso. Ela serve de base para todas as análises temporais, incluindo o cálculo do tempo de ciclo, a identificação de gargalos e o monitoramento da performance ao longo do tempo. Por que isso importa Define a ordem cronológica dos eventos, essencial para calcular tempos de ciclo, analisar a performance do processo e identificar gargalos. Onde encontrar O campo padrão “Date” das transações do NetSuite, como Item Receipt, Inventory Adjustment e Item Fulfillment. Para obter mais precisão, as notas do sistema podem fornecer um registro de data e hora. Exemplos 2023-10-26T09:00:00Z2023-10-26T14:30:15Z2023-10-27T08:22:05Z2023-10-28T11:59:59Z
	Nome da atividade ActivityName	Nome da atividade de negócio que ocorreu em um momento específico do ciclo de vida do estoque.
Descrição Este atributo descreve um evento ou uma etapa específica do processo de gestão de estoque, como “Recebimento de mercadorias registrado” ou “Separação concluída”. Ele é fundamental para criar o mapa do processo e entender a sequência das operações. A análise de ActivityName permite visualizar o fluxo do processo, identificar suas etapas e calcular o tempo de transição entre as atividades. Esse atributo é a base da descoberta de processos e da verificação de conformidade, pois define o que aconteceu com o lote de estoque em determinado momento. Por que isso importa Define as etapas do processo e permite visualizar e analisar o percurso do lote de estoque, além de identificar desvios do fluxo padrão. Onde encontrar Este é um atributo conceitual derivado dos dados do NetSuite. Em geral, ele é mapeado a partir de “Transaction Type” (por exemplo, “Item Receipt”) ou do status de uma transação (por exemplo, “Work Order - Built”). Exemplos Recebimento de mercadorias registradoInspeção de qualidade realizadaArmazenagem concluídaDivergência de estoque ajustadaSaída de mercadorias registrada
	Código do motivo da movimentação MovementReasonCode	Código que explica o motivo de uma movimentação ou ajuste de estoque.
Descrição Este atributo contextualiza determinadas transações de estoque, especialmente os ajustes. Ele esclarece por que os níveis de estoque foram alterados, por exemplo, por “Mercadorias danificadas”, “Ajuste de inventário cíclico” ou “Devolução ao fornecedor”. Esse atributo é essencial para o Dashboard “Frequência e valor dos ajustes de estoque”, pois ajuda a categorizar os ajustes e identificar as causas raiz das divergências. Também é usado na análise de conformidade para garantir que todos os ajustes tenham um motivo válido e documentado. Por que isso importa Explica o motivo dos ajustes de estoque e ajuda a identificar as causas raiz das divergências, como danos, furtos ou erros de entrada de dados. Onde encontrar Em geral, este campo é implementado como um campo personalizado no corpo ou nas linhas da transação no NetSuite, pois não há um campo padrão para essa finalidade em todos os tipos de transação. Exemplos ADJ_CYCLE_COUNTDMG_IN_TRANSITRECLASS_SKUEXPIRED_STOCK
	Hora de término EndTime	Data e hora que indicam quando uma atividade foi concluída.
Descrição Este atributo registra o horário de conclusão de uma atividade. Em muitas transações de estoque, registradas instantaneamente, a Hora de término pode ser igual à Hora de início. Já para atividades com duração mensurável, como uma inspeção de qualidade ou uma tarefa de armazenagem, esse atributo é essencial. Ele é usado principalmente junto com a Hora de início para calcular o Tempo de processamento de cada atividade. Isso permite analisar os gargalos com mais precisão, identificando não apenas os atrasos entre etapas, mas também quais etapas específicas levam mais tempo para serem concluídas. Por que isso importa Permite calcular a duração exata de cada atividade, algo essencial para identificar etapas ineficientes e analisar a performance dos recursos. Onde encontrar Talvez seja necessário derivar este dado. Em alguns registros, ele pode corresponder a “Last Modified Date”. Em outros, pode ser o registro de data e hora de um evento relacionado que ocorreu em seguida. Exemplos 2023-10-26T09:05:10Z2023-10-26T15:00:00Z2023-10-27T08:22:05Z
	Local do armazém Location	Armazém ou local físico onde ocorreu a atividade de estoque.
Descrição Este atributo especifica o armazém, centro de distribuição ou outro local físico associado a um evento de estoque. O campo “Location” do NetSuite é uma opção padrão para segmentar o estoque e as operações. Essa dimensão é essencial para análises comparativas. Dashboards como “Tempo de ciclo da armazenagem por armazém” e “Mapa de calor das atividades do armazém” usam este atributo para comparar a performance entre locais, identificar gargalos regionais e entender padrões geográficos na movimentação do estoque. Por que isso importa Permite comparar a performance e planejar recursos em diferentes locais físicos, ajudando a identificar gargalos específicos de cada unidade e boas práticas. Onde encontrar Este é o campo padrão “Location”, disponível em quase todas as transações do NetSuite relacionadas ao estoque. Exemplos WH-EASTWH-WEST-01Centro de distribuição principalLoja de varejo nº 105
	SKU Item	Identificador exclusivo do produto ou material.
Descrição O SKU (unidade de manutenção de estoque) é o identificador específico de um produto, como um número de peça ou nome de item. É o nível mais detalhado de identificação do produto. Analisar os dados por SKU permite examinar a performance e o manuseio de cada produto em detalhes. A análise pode revelar que determinados itens levam mais tempo para serem armazenados, têm taxas de ajuste mais altas ou sofrem mais danos, gerando insights acionáveis para melhorar processos específicos de cada item. Por que isso importa Oferece o nível mais detalhado de informações sobre os produtos e permite analisar com precisão como cada um passa pelo processo de gestão de estoque. Onde encontrar Este é o campo padrão “Item” de todas as linhas de transação no NetSuite. Ele faz referência a um registro da lista de itens. Exemplos SKU-001-REDPN-987654RAW-STEEL-COILWIDGET-ASSY-A
	Tipo de transação TransactionType	Tipo específico de registro de transação do NetSuite que gerou o evento.
Descrição Este atributo indica o tipo nativo de transação do NetSuite, como “Item Receipt”, “Inventory Adjustment”, “Work Order Close” ou “Item Fulfillment”. Ele permite rastrear diretamente o registro de origem no ERP. Enquanto “Nome da atividade” oferece um rótulo fácil de entender para o negócio, o Tipo de transação é essencial para validar os dados e criar análises detalhadas que exigem o contexto contábil ou operacional específico de um evento. Por exemplo, ele ajuda a diferenciar uma devolução de cliente (“Return Authorization”) de uma devolução a fornecedor. Por que isso importa Vincula diretamente ao tipo de registro de origem no NetSuite, algo essencial para validar os dados, aprofundar a análise e entender o contexto técnico de um evento. Onde encontrar Este é o campo padrão “Type” de qualquer registro de transação no NetSuite. Exemplos Item ReceiptInventory AdjustmentBin Putaway WorksheetItem Fulfillment
	Usuário responsável pela ação User	Funcionário que criou ou modificou pela última vez a transação relacionada à atividade de estoque.
Descrição Este atributo identifica o usuário responsável por executar uma etapa específica do processo. Pode ser o operador do armazém que recebeu as mercadorias, o gerente de estoque que aprovou um ajuste ou o separador que preparou um pedido. Analisar as atividades por usuário ajuda a entender a distribuição da carga de trabalho, identificar necessidades de treinamento e investigar problemas de conformidade. Por exemplo, o Dashboard “Conformidade dos ajustes de estoque” usa este atributo para sinalizar ajustes feitos por pessoas não autorizadas. Por que isso importa Vincula as atividades do processo a pessoas específicas, permitindo analisar a performance, verificar a conformidade e identificar necessidades de treinamento. Onde encontrar Disponível nos campos “Criado por” ou “Last Modified By” das transações padrão do NetSuite. A subguia System Notes também apresenta um histórico detalhado das alterações feitas pelos usuários. Exemplos John SmithJane DoeWarehouse.Operator1Administrador
	Valor do estoque StockValue	Valor financeiro do estoque envolvido em uma transação.
Descrição O Valor do estoque representa o valor monetário da quantidade movimentada, ajustada ou vendida. Em geral, ele é calculado multiplicando a quantidade da transação pelo custo atual do item. Este atributo é essencial para entender o impacto financeiro das atividades do processo. Por exemplo, o Dashboard “Frequência e valor dos ajustes de estoque” usa o Valor do estoque para quantificar o custo das divergências e ajudar a priorizar os problemas com maior impacto financeiro. Por que isso importa Quantifica o impacto financeiro das movimentações e dos ajustes de estoque, permitindo concentrar a análise em transações de alto valor e priorizar oportunidades de redução de custos. Onde encontrar Calculado multiplicando a “Quantity” da transação pelo custo do item. O custo pode vir do registro do item associado, por exemplo, de “Average Cost” ou “Last Purchase Price”. Exemplos 1250.75500.0025.50-150.25
	Categoria do SKU ItemCategory	Classificação ou categoria do item de estoque (SKU).
Descrição A categoria do SKU agrupa produtos em níveis mais amplos, como “Eletrônicos”, “Vestuário” ou “Matérias-primas”. Isso permite analisar em conjunto itens semelhantes. No NetSuite, essa informação pode estar em campos padrão, como “Class”, ou em um campo personalizado do item. Dashboards como “Visão geral do estoque próximo do vencimento e obsoleto” usam esse atributo para analisar tendências e problemas que afetam grupos inteiros de produtos, em vez de apenas SKUs individuais, oferecendo uma visão mais estratégica. Por que isso importa Permite analisar os dados por grupo de produtos e identificar problemas sistêmicos ou tendências que afetam categorias inteiras de itens. Onde encontrar Pode corresponder aos campos padrão “Class” ou “Department” do registro do item no NetSuite, ou a um campo personalizado criado para categorizar os itens. Exemplos Produtos acabadosMatérias-primasEletrônicosVestuário
	Data de validade ExpirationDate	Data em que o lote de estoque vence.
Descrição Este atributo armazena a data de validade de produtos perecíveis ou com prazo de uso limitado. É uma informação importante, gerenciada no nível do número do lote. Esses dados são fundamentais para o Dashboard “Visão geral do estoque próximo do vencimento e obsoleto”. Ao analisar a Data de validade, as empresas podem identificar com antecedência o estoque em risco de vencer, adotar estratégias como FEFO (primeiro que vence, primeiro que sai) e reduzir perdas por deterioração ou obsolescência. Por que isso importa Essencial para gerenciar produtos perecíveis e identificar com antecedência o estoque em risco, reduzindo o desperdício e as perdas financeiras causadas por produtos vencidos. Onde encontrar Disponível nos detalhes do estoque de uma linha de transação para itens controlados por lote, quando o rastreamento da data de validade está habilitado. Exemplos 2024-12-312025-06-302024-08-01
	Endereço de armazenagem BinNumber	Endereço ou área específica do armazém onde o item está localizado.
Descrição O endereço de armazenagem identifica a unidade mais específica de armazenamento dentro de um armazém, como uma prateleira, estante ou posição de palete. Ele é usado em ambientes que exigem o rastreamento preciso da localização do estoque. Analisar os dados por endereço de armazenagem é essencial para entender a logística interna do armazém. Isso permite acompanhar as movimentações entre endereços na “Análise do tempo de atravessamento de transferências internas” e identificar, no “Mapa de calor das atividades do armazém”, quais endereços são mais acessados para armazenagem ou separação. Por que isso importa Mostra a localização do estoque em detalhes, algo essencial para analisar movimentações internas no armazém, otimizar o layout e acompanhar a eficiência da separação. Onde encontrar Disponível no campo “Bin Number” das linhas da transação. Para usar esse campo, é necessário habilitar o recurso “Advanced Bin/Numbered Inventory Management” no NetSuite. Exemplos A-01-01-AB-05-03-CRECEIVING-DOCK-01PICK-FACE-12
	Fornecedor SupplierName	Nome do fornecedor que fornece o item de estoque.
Descrição Este atributo identifica o fornecedor de quem as mercadorias foram compradas. Em geral, essa informação é registrada durante o recebimento das mercadorias e vinculada ao pedido de compra correspondente. Analisar os dados por fornecedor é importante para gerenciar a performance de compras e da cadeia de suprimentos. O Dashboard “Tempo de ciclo do processamento de devoluções” usa este atributo para identificar se as devoluções de determinados fornecedores são processadas mais lentamente, o que pode indicar problemas de qualidade dos produtos ou da documentação fornecida. Por que isso importa Vincula o estoque ao fornecedor de origem e permite analisar a performance dos fornecedores, problemas de qualidade e taxas de devolução. Onde encontrar Campo “Entity” dos pedidos de compra e dos registros Item Receipt, que faz referência a um registro Vendor no NetSuite. Exemplos Global Electronics Inc.Bulk Goods Co.Component Suppliers LLCOffice Mart
	ID da transação TransactionId	Identificador exclusivo do registro da transação de origem no NetSuite.
Descrição Este atributo é o ID exclusivo do sistema ou o número do documento da transação do NetSuite que gerou o evento no registro de Process Mining. Alguns exemplos são o número do Item Receipt ou do documento Inventory Adjustment. O ID da transação é muito útil em operações. Ele permite que os usuários saiam de um caso interessante ou problemático identificado na ferramenta de Process Mining e acessem diretamente o registro correspondente no NetSuite para investigar ou corrigir o problema. Por que isso importa Vincula diretamente à transação correspondente no NetSuite, permitindo investigar anomalias ou auditar etapas do processo no sistema de origem. Onde encontrar Pode ser o “Transaction Number” (ID exibido para o usuário) ou o “Internal ID” (chave primária exclusiva do sistema) de um registro de transação. Exemplos IR-001234ADJ-00056WO-00987IF-004321
	Indicador de conformidade dos ajustes AdjustmentComplianceFlag	Indicador calculado que sinaliza se um ajuste de estoque está em desacordo com as regras.
Descrição Este é um atributo booleano que sinaliza ajustes de estoque que violam regras de negócio definidas. Por exemplo, ele pode receber o valor “true” se a atividade “Inventory Discrepancy Adjusted” for realizada por um usuário não autorizado ou se o “Movement Reason Code” estiver ausente. Este indicador foi criado para o Dashboard “Conformidade dos ajustes de estoque”. Ele simplifica a análise ao criar uma dimensão binária para filtrar e contar eventos em desacordo com as regras, facilitando o acompanhamento e a geração de relatórios sobre desvios do processo e violações de políticas. Por que isso importa Simplifica o monitoramento da conformidade ao sinalizar transações que violam regras de negócio, facilitando a quantificação e a investigação de violações de políticas. Onde encontrar Atributo calculado. Derivado de uma lógica que verifica outros campos, por exemplo, `IF(MovementReasonCode IS NULL) THEN true ELSE false`. Exemplos truefalse
	Quantidade Quantity	Número de unidades do item envolvidas na transação.
Descrição Este atributo representa a quantidade do item em estoque que foi movimentada, recebida, ajustada ou enviada em uma transação. A quantidade pode ser positiva ou negativa, como no caso de uma baixa de estoque. A quantidade é uma métrica fundamental para entender a escala das operações. Ela ajuda a avaliar a importância de determinadas atividades, calcular o volume processado e medir o volume de estoque ajustado ou descartado. Esse dado contextualiza quase todas as análises de estoque. Por que isso importa Indica o volume de cada transação, essencial para entender o volume processado, calcular o valor dos ajustes e priorizar atividades de alto volume. Onde encontrar Este é o campo padrão “Quantity” de todas as linhas de transação no NetSuite. Exemplos 100501000-10
	Sistema de origem SourceSystem	Sistema de onde os dados foram extraídos.
Descrição Este atributo identifica a origem dos dados do evento. Nesta visualização do processo, o valor será sempre “NetSuite”, indicando que todas as atividades de gestão de estoque vêm desse sistema ERP. Embora possa parecer estático, esse atributo é essencial em ambientes que combinam dados de vários sistemas. Ele esclarece a procedência dos dados e ajuda a investigar problemas de extração e integração. Por que isso importa Confirma a origem dos dados, algo essencial para a governança e a validação dos dados, além de cenários em que dados de vários sistemas são combinados. Onde encontrar Este é um valor estático (“NetSuite”), adicionado durante o processo de extração e transformação dos dados. Exemplos NetSuite
	Tempo de atravessamento da separação e embalagem PickingAndPackingLeadTime	Tempo calculado entre o início da separação e a conclusão da embalagem.
Descrição Esta métrica mede a eficiência do processo de atendimento de pedidos de saída. Ela corresponde ao tempo total entre o momento em que um item é encaminhado para separação (“Picking Initiated” ou “Picking Wave Created”) e a conclusão da embalagem, quando ele está pronto para envio (“Packing Completed”). Este é um KPI essencial para o Dashboard “Taxa de conclusão da separação e embalagem”. Ele afeta diretamente a velocidade de atendimento dos pedidos e a satisfação dos clientes. Analisar esse tempo de atravessamento ajuda a identificar gargalos nas etapas de separação ou embalagem do processo de saída. Por que isso importa Mede a velocidade do processo de atendimento de pedidos de saída. Reduzir esse tempo de atravessamento é essencial para agilizar os envios e melhorar a satisfação dos clientes. Onde encontrar Atributo calculado. Corresponde à diferença entre o registro de data e hora da atividade “Packing Completed” e o da atividade “Picking Initiated”. Exemplos 3600540018000
	Tempo de atravessamento de transferências internas InternalTransferLeadTime	Tempo calculado para movimentar o estoque entre dois locais ou endereços internos.
Descrição Esta métrica mede a duração das movimentações internas de estoque. Ela é calculada pelo tempo entre o início e a conclusão de uma transferência, especificamente para eventos “Stock Moved Internally”. Usado no Dashboard “Análise do tempo de atravessamento de transferências internas”, este atributo ajuda a avaliar a eficiência da logística do armazém. Tempos de atravessamento longos podem indicar trajetos ineficientes, falta de recursos ou atrasos sistêmicos na movimentação de mercadorias dentro da mesma unidade. Por que isso importa Evidencia ineficiências na logística interna do armazém. Transferências demoradas podem atrasar o atendimento de pedidos mesmo quando há estoque disponível no local. Onde encontrar Atributo calculado. Corresponde à diferença entre o horário de conclusão e o de início de uma sequência de atividades “Stock Moved Internally”. Exemplos 18003600900
	Tempo de ciclo da armazenagem PutAwayCycleTime	Tempo calculado entre o recebimento das mercadorias e a conclusão do processo de armazenagem.
Descrição Esta métrica mede o tempo total entre o registro oficial do recebimento das mercadorias (“Goods Receipt Recorded”) e o armazenamento dos itens no endereço de destino final (“Put-away Completed”). Ela representa a eficiência do fluxo de trabalho de recebimento e armazenagem. Este é um indicador-chave de performance usado no Dashboard “Tempo de ciclo da armazenagem por armazém”. Analisar esse tempo de ciclo ajuda a identificar atrasos na disponibilização do novo estoque para atendimento de pedidos e a localizar gargalos na doca de recebimento, nas áreas de preparação ou nas próprias tarefas de armazenagem. Por que isso importa Mede diretamente a eficiência da disponibilização do estoque recém-recebido para venda ou uso. Tempos de ciclo longos indicam gargalos que atrasam a disponibilidade do estoque. Onde encontrar Atributo calculado. Corresponde à diferença entre o registro de data e hora da atividade “Put-away Completed” e o da atividade “Goods Receipt Recorded” para o mesmo caso. Exemplos 72001440086400
	Última atualização dos dados LastDataUpdate	Data e hora da atualização mais recente dos dados do sistema de origem.
Descrição Este atributo indica a data e a hora em que os dados foram extraídos pela última vez do NetSuite e atualizados na ferramenta de Process Mining. Ele informa o quão recentes são a análise e os dados exibidos. Esse metadado é essencial para qualquer Dashboard ou análise, pois mostra quando os insights foram gerados. Assim, você entende se está consultando informações em tempo real ou um retrato dos dados em um momento específico. Por que isso importa Informa quando os dados foram atualizados, para que os usuários entendam o período analisado e tomem decisões com base em informações atuais. Onde encontrar Este registro de data e hora é gerado pelo processo de ETL (extração, transformação e carregamento) durante a ingestão dos dados. Exemplos 2024-05-21T02:00:00Z2024-05-20T02:00:00Z2024-05-19T02:00:00Z
	Unidade de medida Units	Unidade de medida da quantidade da transação, como unidade, kg ou caixa.
Descrição A unidade de medida (UoM) contextualiza o atributo “Quantity”. Ela especifica se a quantidade está expressa em unidades individuais, caixas, quilogramas, litros ou outra medida. Este atributo é essencial para interpretar corretamente as métricas baseadas em quantidade, especialmente em ambientes com diferentes tipos de produtos. Ele evita interpretações equivocadas, como comparar 10 paletes com 10 itens individuais, e é fundamental para calcular valores com precisão. Por que isso importa Contextualiza o campo “Quantity” e garante a precisão das análises e comparações quando os itens são controlados em unidades diferentes, como peças, caixas ou quilogramas. Onde encontrar Disponível como campo “Units” nas linhas de transação, se o recurso “Multiple Units of Measure” estiver habilitado no NetSuite. Exemplos UnidadeCaixa (24)kgL

Obrigatório Recomendado Opcional

Atividades de gestão de estoque

Estas são as principais etapas e marcos do processo a registrar no Event Log para descobrir e analisar os fluxos de estoque com precisão.

6 Recomendado 9 Opcional

	Atividade	Descrição
	Armazenagem concluída	Confirma que o lote de estoque foi colocado no endereço de armazenagem designado. Esse evento é registrado quando uma Bin Transfer ou Bin Putaway Worksheet é marcada como concluída, atualizando a localização do item.
Por que isso importa Este marco é essencial para acompanhar a disponibilidade do estoque para o atendimento de pedidos e calcular o tempo total do ciclo de armazenagem. Atrasos nessa etapa afetam diretamente a capacidade de processar pedidos. Onde encontrar Identificado pela data de conclusão ou da transação de um registro Bin Transfer ou de uma Bin Putaway Worksheet concluída. Essa ação atualiza o endereço de armazenagem do número do lote. Coleta O evento é registrado quando uma transação Bin Transfer ou Bin Putaway Worksheet é concluída. Tipo de evento explicit
	Divergência de estoque ajustada	Ocorre quando uma diferença entre o estoque físico e o registrado no sistema é corrigida. Essa correção é registrada explicitamente no NetSuite por meio de uma transação Inventory Adjustment, que aumenta ou diminui a quantidade disponível.
Por que isso importa Este é um evento essencial para analisar a precisão do estoque, identificar as causas raiz das divergências e garantir a conformidade financeira. Onde encontrar Identificado pela criação de um registro da transação Inventory Adjustment. A transação inclui detalhes como a conta de ajuste, o motivo e a alteração de quantidade. Coleta O evento é registrado quando uma transação Inventory Adjustment é criada. Tipo de evento explicit
	Estoque descartado	Representa a retirada definitiva de um lote do estoque por dano, vencimento ou obsolescência. Esse evento é registrado por meio de uma transação Inventory Adjustment com quantidade negativa e um código de motivo específico.
Por que isso importa Este evento de término alternativo é essencial para analisar as baixas de estoque, entender o impacto financeiro do estoque obsoleto e melhorar a gestão do ciclo de vida do estoque. Onde encontrar Identificado por uma transação Inventory Adjustment cuja conta de ajuste é destinada a descarte ou sucata, ou por um campo personalizado que indica o motivo. Coleta O evento é registrado por meio de uma transação Inventory Adjustment com uma conta ou um código de motivo específico para descarte. Tipo de evento explicit
	Recebimento de mercadorias registrado	Marca a chegada oficial de um lote de estoque ao armazém. Esse evento é registrado quando uma transação Item Receipt é criada no NetSuite, geralmente vinculada a um pedido de compra.
Por que isso importa Este é o principal evento de início do ciclo de vida do estoque. Ele é essencial para medir os prazos dos fornecedores e o tempo total de processamento de entrada. Onde encontrar Identificado pela data de criação do registro da transação Item Receipt. A transação registra o usuário, a data, os itens e as quantidades recebidas. Coleta O evento é registrado quando uma transação Item Receipt é criada. Tipo de evento explicit
	Saída de mercadorias registrada	Marca a etapa final, quando um lote de estoque é enviado ao cliente e deixa oficialmente o armazém. Esse evento é registrado quando o status de uma transação Item Fulfillment é definido como 'Enviado' no NetSuite.
Por que isso importa Como principal evento de término bem-sucedido, é essencial para analisar o ciclo de vida do estoque de ponta a ponta, do recebimento à expedição, e medir o tempo total de atendimento dos pedidos. Onde encontrar Identificado pela data da mudança de status, quando um registro Item Fulfillment é atualizado para 'Enviado'. Essa ação reduz o estoque disponível. Coleta O evento é registrado quando o status da transação Item Fulfillment passa a ser 'Enviado'. Tipo de evento explicit
	Separação concluída	Representa a conclusão da separação física de um lote de estoque do endereço de armazenagem para atender a um pedido. Em geral, esse evento é inferido a partir de uma mudança de status no registro Item Fulfillment, de 'Separação' para 'Embalado' ou para um status semelhante.
Por que isso importa Este é um marco importante para medir a eficiência da equipe de separação e o tempo total de separação e embalagem, um componente essencial da velocidade de atendimento dos pedidos. Onde encontrar Inferido a partir de uma mudança de status no registro Item Fulfillment, por exemplo, para 'Separado', ou da conclusão de todas as tarefas de separação associadas ao atendimento. Coleta Inferido a partir da mudança de status da transação Item Fulfillment para 'Separado'. Tipo de evento inferred
	Armazenagem iniciada	Indica o início do processo de movimentação de um lote recebido da doca de recebimento até seu endereço de armazenagem definitivo. Esse evento pode ser inferido a partir da criação de uma Bin Putaway Worksheet ou de um registro de tarefa semelhante no módulo WMS do NetSuite.
Por que isso importa Esta atividade marca o início da medição do tempo de ciclo de armazenagem, uma métrica importante para a eficiência do armazém, e ajuda a analisar quanto tempo o estoque permanece nas áreas de espera. Onde encontrar Inferido a partir da data de criação de uma Bin Putaway Worksheet ou da atribuição de uma tarefa em uma extensão WMS. É mais relevante para ambientes que usam o NetSuite WMS. Coleta Derivado da criação de um registro Bin Putaway Worksheet para o recebimento do item específico. Tipo de evento inferred
	Autorização de devolução criada	Representa o início oficial do processo de devolução, quando a solicitação de devolução de mercadorias é aprovada e documentada. Esse evento é registrado pela criação de uma transação Return Authorization (RMA) no NetSuite.
Por que isso importa Esta atividade inicia o fluxo de logística reversa e permite analisar os motivos e a frequência das devoluções, além do tempo de processamento das etapas seguintes. Onde encontrar Identificado pela data de criação do registro da transação Return Authorization. Esse registro é criado antes da devolução física das mercadorias. Coleta O evento é registrado quando uma transação Return Authorization é criada. Tipo de evento explicit
	Contagem de estoque aprovada	Representa a aprovação oficial dos resultados de uma contagem física de estoque, antes de qualquer ajuste. Esse evento é inferido quando o status do registro Inventory Count muda para 'Aprovado'.
Por que isso importa Esta etapa de aprovação pode se tornar um gargalo no processo de conciliação do estoque. Analisar sua duração ajuda a agilizar as operações e aumentar a precisão dos dados. Onde encontrar Inferido a partir das notas do sistema ou da trilha de auditoria, quando um usuário autorizado atualiza o status do registro Inventory Count para 'Aprovado'. Coleta Inferido a partir da mudança do campo de status do registro Inventory Count para 'Aprovado'. Tipo de evento inferred
	Contagem de estoque iniciada	Marca o início da contagem física do estoque de um lote ou local específico. Essa atividade é registrada quando um registro Inventory Count é criado no NetSuite para programar a contagem.
Por que isso importa Este evento inicia a medição do tempo de ciclo para resolver divergências e mostra quanto tempo leva para contar o estoque e corrigir os níveis registrados. Onde encontrar Identificado pela data de criação do registro da transação Inventory Count, que define os itens e locais a serem contados. Coleta O evento é registrado quando um registro Inventory Count é criado. Tipo de evento explicit
	Embalagem concluída	Indica que os itens separados para um pedido foram embalados e estão prontos para expedição. Em geral, esse evento é inferido a partir da mudança de status do registro Item Fulfillment de 'Separado' para 'Embalado'.
Por que isso importa Esta atividade marca o fim do processamento interno do pedido no armazém e é a última etapa antes do início da expedição. Onde encontrar Inferido a partir da mudança de status do registro Item Fulfillment para 'Embalado'. A data e a hora dessa mudança são obtidas nas notas do sistema. Coleta Inferido a partir da mudança de status da transação Item Fulfillment para 'Embalado'. Tipo de evento inferred
	Estoque movimentado internamente	Representa a movimentação de um lote de estoque entre dois endereços ou locais diferentes dentro do mesmo armazém. Essa movimentação é registrada explicitamente por uma transação Inventory Transfer ou Bin Transfer no NetSuite.
Por que isso importa Acompanhar as movimentações internas ajuda a analisar a eficiência do layout do armazém, identificar manuseios excessivos e otimizar as estratégias de posicionamento do estoque. Onde encontrar Identificado pela data da transação de um registro Inventory Transfer, entre locais, ou Bin Transfer, dentro de um mesmo local. Coleta O evento é registrado quando uma transação Inventory Transfer ou Bin Transfer é criada. Tipo de evento explicit
	Inspeção de qualidade realizada	Indica a conclusão da inspeção de qualidade de um lote recebido. Em geral, esse evento é inferido a partir de uma mudança de status no registro do lote de estoque ou em um registro personalizado relacionado, pois o NetSuite padrão pode não ter um evento específico para isso.
Por que isso importa Analisar o tempo entre o recebimento e a inspeção ajuda a identificar gargalos no processo de controle de qualidade que atrasam a disponibilidade do estoque. Onde encontrar Provavelmente, é inferido a partir da data e hora de um campo personalizado, de uma mudança de status no registro do lote ou da partida, ou de um registro personalizado de qualidade relacionado. É necessário analisar a configuração específica do NetSuite. Coleta Inferido a partir de uma mudança de status, por exemplo, de 'Aguardando inspeção' para 'Disponível', no registro do estoque. Tipo de evento inferred
	Mercadorias devolvidas recebidas	Confirma o recebimento físico das mercadorias devolvidas no armazém. Esse evento é registrado pela criação de uma transação Item Receipt vinculada a uma Return Authorization.
Por que isso importa Acompanhar esse evento é essencial para medir o tempo total do ciclo de processamento de devoluções e garantir que o estoque devolvido seja contabilizado e destinado corretamente sem demora. Onde encontrar Identificado pela data de criação de uma transação Item Receipt cujo campo 'Created From' aponta para uma Return Authorization. Coleta O evento é registrado quando uma transação Item Receipt é criada com base em uma Return Authorization. Tipo de evento explicit
	Onda de separação criada	Inicia o processo de saída agrupando vários pedidos em uma única tarefa ou onda de separação. Em geral, esse evento é registrado pela criação de um registro de onda no NetSuite WMS ou em um módulo relacionado ao atendimento de pedidos.
Por que isso importa Este evento marca o início do ciclo de atendimento e permite analisar o tempo entre a alocação do pedido e o começo da separação física. Onde encontrar Identificado pela data de criação de uma onda de separação ou de um registro consolidado de atendimento no NetSuite WMS. Esse registro pode não existir em implementações sem WMS. Coleta O evento é registrado quando um registro de onda de atendimento é criado. Tipo de evento explicit

Recomendado Opcional

Guias de extração

Como obter seus dados do NetSuite

Etapas

Pré-requisitos: Acesse sua conta do NetSuite com uma função que tenha permissão para criar e executar pesquisas salvas do tipo 'Transaction' e visualizar todos os registros de estoque relevantes.
Acesse a criação de pesquisas salvas: Vá para Reports > Saved Searches > All Saved Searches > New. Na lista de tipos de pesquisa disponíveis, selecione 'Transaction'. Esse será o registro base de todas as pesquisas.
Crie uma pesquisa para 'Goods Receipt': Comece pela primeira atividade. Na página de configuração da pesquisa salva, defina os critérios. Filtre 'Type' por 'Item Receipt' e 'Main Line' por 'false' para obter detalhes por item. Adicione um filtro de 'Date' para o período de análise desejado, por exemplo, os últimos 3 meses.
Defina as colunas dos resultados: Clique na aba 'Results'. Adicione os campos necessários. Use fórmulas para criar uma coluna padronizada ActivityName. Nesta pesquisa, adicione uma coluna 'Formula (Text)' e defina a fórmula como 'Goods Receipt Recorded'. Adicione 'Inventory Detail Fields...Lot/Serial Number' para o ID do caso, 'Date' para registrar data e hora, 'Created By' para o usuário e os demais atributos necessários. Use 'Custom Label' para renomear as colunas de acordo com o esquema do Event Log, por exemplo, InventoryBatchLotNumber.
Repita para todas as atividades: Salve a primeira pesquisa. Em seguida, crie pesquisas salvas separadas para cada uma das 15 atividades necessárias, ajustando o filtro 'Type' e a 'Formula (Text)' de ActivityName conforme o caso. Por exemplo, para 'Goods Issue Recorded', filtre por 'Type' igual a 'Item Fulfillment' e 'Status' igual a 'Shipped'. Para algumas atividades, como 'Quality Inspection Performed', talvez seja necessário filtrar por um campo personalizado ou status específico do fluxo de trabalho da sua organização.
Salve e execute cada pesquisa: Salve cada pesquisa configurada com um nome claro, como 'ProcessMind - Goods Receipts'. Execute cada pesquisa na página da lista de pesquisas salvas. Os resultados serão exibidos na tela.
Exporte os resultados para CSV: Na página de resultados de cada pesquisa, clique no ícone 'Export - CSV'. Isso fará o download de um arquivo CSV separado para cada uma das 15 atividades.
Combine os arquivos CSV: Abra os arquivos CSV baixados em um programa de planilhas, como o Microsoft Excel, ou use uma ferramenta de script. Copie os dados de cada arquivo e cole-os, um após o outro, em um único arquivo principal. Antes de combinar os arquivos, confirme que os cabeçalhos das colunas são idênticos.
Finalize o Event Log: Revise o arquivo CSV principal combinado. Confira se os cabeçalhos das colunas estão corretos (InventoryBatchLotNumber, ActivityName, TransactionDate etc.). Verifique se o formato das datas é consistente e remova as linhas de cabeçalho duplicadas que possam ter sido incluídas ao copiar e colar. O arquivo está pronto para ser carregado.

Configuração

Pré-requisitos: A função do usuário precisa ter permissão para criar e executar pesquisas salvas no tipo de registro 'Transaction'. Também é necessário ter acesso para visualizar Item Receipts, Item Fulfillments, Inventory Adjustments e outros registros de estoque relevantes.
Tipo de pesquisa: Use sempre o tipo de pesquisa 'Transaction' como base para extrair eventos de estoque.
Período: Recomendamos filtrar as pesquisas pelo campo 'Date' para um período específico, como os últimos 3 a 6 meses, para manter o conjunto de dados em um tamanho gerenciável. Se o volume for muito alto, considere executar as pesquisas em lotes mensais ou semanais.
Principais filtros de critérios: Os filtros principais serão 'Type', para isolar transações específicas, como Item Receipt, e 'Main Line' definido como 'No', para obter as linhas de cada item. Talvez seja necessário adicionar filtros de 'Status', 'Location' ou campos personalizados para distinguir atividades diferentes dentro do mesmo tipo de transação.
Colunas de resultados e fórmulas: A aba 'Results' é essencial. Use a opção 'Inventory Detail Fields...' para acessar Lot/Serial Number. Use 'Formula (Text)' para definir manualmente o valor de ActivityName em cada pesquisa, por exemplo, 'Goods Receipt Recorded'. Use 'Custom Label' em cada coluna para definir o cabeçalho final do arquivo CSV.
Como lidar com números de lote: Inclua a coluna 'Inventory Detail Fields...Lot/Serial Number' nos resultados. Transações que não usam números de lote não aparecerão se você filtrar esse campo para exibir apenas valores não vazios.

Consulta de exemplo config

The following represents the configuration for 15 separate NetSuite Saved Searches. The results of these searches must be exported to CSV and combined into a single file.

**Search 1: Goods Receipt Recorded**
*   **Search Type**: Transaction
*   **Criteria**: Type is 'Item Receipt'; Main Line is false; Date is within [Start Date] and [End Date]; Inventory Detail.Lot/Serial Number is not empty
*   **Results**: Inventory Detail.Lot/Serial Number (Custom Label: InventoryBatchLotNumber), Formula (Text): 'Goods Receipt Recorded' (Custom Label: ActivityName), Date (Custom Label: TransactionDate), Created From.Date (Custom Label: EndTime), Created By (Custom Label: User), Location (Custom Label: Location), Memo (Custom Label: MovementReasonCode), Amount (Custom Label: StockValue), Type (Custom Label: TransactionType), Item (Custom Label: Item)

**Search 2: Quality Inspection Performed**
*   **Search Type**: Transaction
*   **Criteria**: Type is 'Item Receipt'; Main Line is false; [Your Custom Inspection Status Field] is '[Completed Status]'; Date is within [Start Date] and [End Date]; Inventory Detail.Lot/Serial Number is not empty
*   **Results**: Inventory Detail.Lot/Serial Number (Custom Label: InventoryBatchLotNumber), Formula (Text): 'Quality Inspection Performed' (Custom Label: ActivityName), Last Modified Date (Custom Label: TransactionDate), null (Custom Label: EndTime), Last Modified By (Custom Label: User), Location (Custom Label: Location), null (Custom Label: MovementReasonCode), Amount (Custom Label: StockValue), Type (Custom Label: TransactionType), Item (Custom Label: Item)

**Search 3: Put-away Initiated**
*   **Search Type**: Transaction
*   **Criteria**: Type is '[Your Bin Putaway Worksheet Type]'; Main Line is false; Status is '[Initiated Status]'; Date Created is within [Start Date] and [End Date]; Inventory Detail.Lot/Serial Number is not empty
*   **Results**: Inventory Detail.Lot/Serial Number (Custom Label: InventoryBatchLotNumber), Formula (Text): 'Put-away Initiated' (Custom Label: ActivityName), Date Created (Custom Label: TransactionDate), null (Custom Label: EndTime), Created By (Custom Label: User), Location (Custom Label: Location), null (Custom Label: MovementReasonCode), null (Custom Label: StockValue), Type (Custom Label: TransactionType), Item (Custom Label: Item)

**Search 4: Put-away Completed**
*   **Search Type**: Transaction
*   **Criteria**: Type is 'Bin Transfer' or '[Your Bin Putaway Worksheet Type]'; Main Line is false; Status is '[Completed Status]'; Date is within [Start Date] and [End Date]; Inventory Detail.Lot/Serial Number is not empty
*   **Results**: Inventory Detail.Lot/Serial Number (Custom Label: InventoryBatchLotNumber), Formula (Text): 'Put-away Completed' (Custom Label: ActivityName), Date (Custom Label: TransactionDate), Date (Custom Label: EndTime), Last Modified By (Custom Label: User), Location (Custom Label: Location), Memo (Custom Label: MovementReasonCode), null (Custom Label: StockValue), Type (Custom Label: TransactionType), Item (Custom Label: Item)

**Search 5: Stock Moved Internally**
*   **Search Type**: Transaction
*   **Criteria**: Type is 'Inventory Transfer' or 'Bin Transfer'; Main Line is false; Date is within [Start Date] and [End Date]; Inventory Detail.Lot/Serial Number is not empty
*   **Results**: Inventory Detail.Lot/Serial Number (Custom Label: InventoryBatchLotNumber), Formula (Text): 'Stock Moved Internally' (Custom Label: ActivityName), Date (Custom Label: TransactionDate), Date (Custom Label: EndTime), Created By (Custom Label: User), Location (Custom Label: Location), Memo (Custom Label: MovementReasonCode), null (Custom Label: StockValue), Type (Custom Label: TransactionType), Item (Custom Label: Item)

**Search 6: Inventory Count Initiated**
*   **Search Type**: Transaction
*   **Criteria**: Type is 'Inventory Count'; Main Line is false; Date is within [Start Date] and [End Date]; Inventory Detail.Lot/Serial Number is not empty
*   **Results**: Inventory Detail.Lot/Serial Number (Custom Label: InventoryBatchLotNumber), Formula (Text): 'Inventory Count Initiated' (Custom Label: ActivityName), Date (Custom Label: TransactionDate), null (Custom Label: EndTime), Created By (Custom Label: User), Location (Custom Label: Location), Memo (Custom Label: MovementReasonCode), null (Custom Label: StockValue), Type (Custom Label: TransactionType), Item (Custom Label: Item)

**Search 7: Inventory Count Approved**
*   **Search Type**: Transaction
*   **Criteria**: Type is 'Inventory Count'; Main Line is false; Status is 'Approved'; Last Modified Date is within [Start Date] and [End Date]; Inventory Detail.Lot/Serial Number is not empty
*   **Results**: Inventory Detail.Lot/Serial Number (Custom Label: InventoryBatchLotNumber), Formula (Text): 'Inventory Count Approved' (Custom Label: ActivityName), Last Modified Date (Custom Label: TransactionDate), Last Modified Date (Custom Label: EndTime), Last Modified By (Custom Label: User), Location (Custom Label: Location), Memo (Custom Label: MovementReasonCode), null (Custom Label: StockValue), Type (Custom Label: TransactionType), Item (Custom Label: Item)

**Search 8: Inventory Discrepancy Adjusted**
*   **Search Type**: Transaction
*   **Criteria**: Type is 'Inventory Adjustment'; Main Line is false; Date is within [Start Date] and [End Date]; Inventory Detail.Lot/Serial Number is not empty
*   **Results**: Inventory Detail.Lot/Serial Number (Custom Label: InventoryBatchLotNumber), Formula (Text): 'Inventory Discrepancy Adjusted' (Custom Label: ActivityName), Date (Custom Label: TransactionDate), Date (Custom Label: EndTime), Created By (Custom Label: User), Location (Custom Label: Location), Memo (Custom Label: MovementReasonCode), Est. Extended Cost (Custom Label: StockValue), Type (Custom Label: TransactionType), Item (Custom Label: Item)

**Search 9: Picking Wave Created**
*   **Search Type**: Transaction
*   **Criteria**: Type is '[Your Wave Transaction Type]'; Main Line is false; Date Created is within [Start Date] and [End Date]
*   **Results**: Formula (Text): 'Extract Lot Number from Memo or Custom Field' (Custom Label: InventoryBatchLotNumber), Formula (Text): 'Picking Wave Created' (Custom Label: ActivityName), Date Created (Custom Label: TransactionDate), null (Custom Label: EndTime), Created By (Custom Label: User), Location (Custom Label: Location), null (Custom Label: MovementReasonCode), null (Custom Label: StockValue), Type (Custom Label: TransactionType), null (Custom Label: Item)

**Search 10: Picking Completed**
*   **Search Type**: Transaction
*   **Criteria**: Type is 'Item Fulfillment'; Main Line is false; Status is 'Picked' or 'Packed'; Last Modified Date is within [Start Date] and [End Date]; Inventory Detail.Lot/Serial Number is not empty
*   **Results**: Inventory Detail.Lot/Serial Number (Custom Label: InventoryBatchLotNumber), Formula (Text): 'Picking Completed' (Custom Label: ActivityName), Last Modified Date (Custom Label: TransactionDate), Last Modified Date (Custom Label: EndTime), Last Modified By (Custom Label: User), Location (Custom Label: Location), null (Custom Label: MovementReasonCode), Amount (Custom Label: StockValue), Type (Custom Label: TransactionType), Item (Custom Label: Item)

**Search 11: Packing Completed**
*   **Search Type**: Transaction
*   **Criteria**: Type is 'Item Fulfillment'; Main Line is false; Status is 'Packed' or 'Shipped'; Last Modified Date is within [Start Date] and [End Date]; Inventory Detail.Lot/Serial Number is not empty
*   **Results**: Inventory Detail.Lot/Serial Number (Custom Label: InventoryBatchLotNumber), Formula (Text): 'Packing Completed' (Custom Label: ActivityName), Last Modified Date (Custom Label: TransactionDate), Last Modified Date (Custom Label: EndTime), Last Modified By (Custom Label: User), Location (Custom Label: Location), null (Custom Label: MovementReasonCode), Amount (Custom Label: StockValue), Type (Custom Label: TransactionType), Item (Custom Label: Item)

**Search 12: Goods Issue Recorded**
*   **Search Type**: Transaction
*   **Criteria**: Type is 'Item Fulfillment'; Main Line is false; Status is 'Shipped'; Date is within [Start Date] and [End Date]; Inventory Detail.Lot/Serial Number is not empty
*   **Results**: Inventory Detail.Lot/Serial Number (Custom Label: InventoryBatchLotNumber), Formula (Text): 'Goods Issue Recorded' (Custom Label: ActivityName), Actual Ship/Receipt Date (Custom Label: TransactionDate), Actual Ship/Receipt Date (Custom Label: EndTime), Last Modified By (Custom Label: User), Location (Custom Label: Location), Memo (Custom Label: MovementReasonCode), Amount (Custom Label: StockValue), Type (Custom Label: TransactionType), Item (Custom Label: Item)
	
**Search 13: Return Authorization Created**
*   **Search Type**: Transaction
*   **Criteria**: Type is 'Return Authorization'; Main Line is false; Date is within [Start Date] and [End Date]; Inventory Detail.Lot/Serial Number is not empty
*   **Results**: Inventory Detail.Lot/Serial Number (Custom Label: InventoryBatchLotNumber), Formula (Text): 'Return Authorization Created' (Custom Label: ActivityName), Date (Custom Label: TransactionDate), null (Custom Label: EndTime), Created By (Custom Label: User), Location (Custom Label: Location), Memo (Custom Label: MovementReasonCode), Amount (Custom Label: StockValue), Type (Custom Label: TransactionType), Item (Custom Label: Item)

**Search 14: Return Goods Received**
*   **Search Type**: Transaction
*   **Criteria**: Type is 'Item Receipt'; Main Line is false; Created From.Type is 'Return Authorization'; Date is within [Start Date] and [End Date]; Inventory Detail.Lot/Serial Number is not empty
*   **Results**: Inventory Detail.Lot/Serial Number (Custom Label: InventoryBatchLotNumber), Formula (Text): 'Return Goods Received' (Custom Label: ActivityName), Date (Custom Label: TransactionDate), Date (Custom Label: EndTime), Created By (Custom Label: User), Location (Custom Label: Location), Memo (Custom Label: MovementReasonCode), Amount (Custom Label: StockValue), Type (Custom Label: TransactionType), Item (Custom Label: Item)

**Search 15: Stock Scrapped/Disposed**
*   **Search Type**: Transaction
*   **Criteria**: Type is 'Inventory Adjustment'; Main Line is false; Quantity is negative; [Your Reason Code Field] is '[Scrap Reason]'; Date is within [Start Date] and [End Date]; Inventory Detail.Lot/Serial Number is not empty
*   **Results**: Inventory Detail.Lot/Serial Number (Custom Label: InventoryBatchLotNumber), Formula (Text): 'Stock Scrapped/Disposed' (Custom Label: ActivityName), Date (Custom Label: TransactionDate), Date (Custom Label: EndTime), Created By (Custom Label: User), Location (Custom Label: Location), Memo (Custom Label: MovementReasonCode), Est. Extended Cost (Custom Label: StockValue), Type (Custom Label: TransactionType), Item (Custom Label: Item)

Etapas

Pré-requisitos: Confirme se o módulo adicional SuiteAnalytics Connect está habilitado na sua conta do NetSuite. Você também precisará de uma função de usuário do NetSuite com permissões suficientes para acessar as tabelas de dados necessárias, como Transaction, TransactionLine e InventoryNumber.
Obtenha os dados de conexão: No NetSuite, acesse o portlet Settings no Dashboard inicial e clique em Set Up SuiteAnalytics Connect. Anote o Account ID, o Role ID e o Service Host correto da sua conta.
Instale o driver: Baixe e instale o driver adequado para seu sistema operacional e cliente SQL. O NetSuite oferece drivers ODBC, JDBC e ADO.NET.
Configure seu cliente SQL: Crie uma nova conexão ou DSN usando os dados da etapa 2. Use seu nome de usuário e senha do NetSuite para autenticação. No campo de nome do banco de dados, use NetSuite.com ou NetSuite2.com, dependendo da fonte de dados da sua conta.
Conecte-se ao NetSuite: Abra o cliente SQL de sua preferência, como DBeaver, Microsoft Excel ou Tableau, e conecte-se ao data warehouse do NetSuite usando as configurações definidas.
Prepare a consulta: Abra um novo editor de consultas no cliente SQL e copie o script SQL completo fornecido na seção Query deste documento.
Personalize os marcadores de posição: Na consulta, localize a cláusula WHERE na Common Table Expression (CTE) inicial. Altere os marcadores de data, como 'YYYY-MM-DD', para definir o período desejado para a extração. Se necessário, adicione outros filtros específicos da empresa, por exemplo, para uma subsidiária específica.
Execute a consulta de extração: Execute a consulta SQL completa. O tempo de execução varia conforme o período selecionado e o volume de dados da sua conta do NetSuite.
Revise os dados: Quando a consulta terminar, confira rapidamente os resultados para confirmar que há linhas retornadas e que colunas como InventoryBatchLotNumber, ActivityName e TransactionDate estão preenchidas como esperado.
Exporte para CSV: Exporte todo o conjunto de resultados para um arquivo CSV. Salve o arquivo com codificação UTF-8 para evitar problemas com caracteres.
Formatação final: Abra o arquivo CSV e confira se os cabeçalhos das colunas correspondem aos nomes exigidos para a importação no ProcessMind (CaseId, Atividade, EventTime). Se necessário, ajuste o formato da data para atender ao padrão exigido, por exemplo, YYYY-MM-DD HH:MI:SS.

Configuração

Acesso ao SuiteAnalytics Connect: É necessária uma licença válida do módulo SuiteAnalytics Connect. Sem ela, não é possível estabelecer uma conexão direta com o banco de dados.
Permissões do usuário: A função do NetSuite usada na conexão precisa ter permissão para visualizar os registros e campos consultados. Isso inclui transações, itens, locais, funcionários e números de estoque.
Filtro por período: É essencial aplicar um filtro de data ao campo Transaction.trandate para limitar o volume de dados. Recomendamos começar com um período recente de 3 a 6 meses para manter o desempenho da consulta em níveis adequados.
Atualização dos dados: A fonte de dados do SuiteAnalytics Connect é uma réplica do banco de dados de produção. Considere que pode haver um atraso na replicação, portanto, os dados talvez não estejam atualizados em tempo real. Esse atraso costuma variar de uma a três horas.
Personalizações: A consulta fornecida pressupõe uma configuração padrão do NetSuite. Se sua organização usa campos personalizados para acompanhar eventos importantes, como 'Quality Inspection Performed' ou 'Stock Scrapped', você precisa modificar a consulta para incluir a lógica desses campos ou registros personalizados.
Módulo WMS: Algumas atividades, como 'Picking Wave Created', são específicas do módulo NetSuite Warehouse Management System (WMS). Se você não usa o NetSuite WMS, essas partes da consulta não retornarão dados.

Consulta de exemplo sql

WITH EventData AS (
  SELECT
    T.tranid AS TransactionId,
    T.trandate AS TransactionDate,
    T.id AS TransactionInternalId,
    T.lastmodifieddate AS LastModifiedDate,
    BUILTIN.DF(T.type) AS TransactionType,
    BUILTIN.DF(T.status) AS TransactionStatus,
    T.memo AS TransactionMemo,
    TL.id AS TransactionLineId,
    IA.inventorynumber AS InventoryNumberId,
    INUMB.inventorynumber AS InventoryBatchLotNumber,
    I.itemid AS Sku,
    E.entityid AS UserName,
    L.fullname AS LocationName,
    TL.quantity AS Quantity,
    TL.rate AS Rate,
    T.createdfrom AS CreatedFromId,
    INUMB.custitemnumber_quality_status AS QualityStatus -- Placeholder for a custom quality status field
  FROM
    Transaction AS T
    JOIN TransactionLine AS TL ON T.id = TL.transaction
    JOIN InventoryAssignment AS IA ON TL.id = IA.transactionline
    JOIN InventoryNumber AS INUMB ON IA.inventorynumber = INUMB.id
    LEFT JOIN Item AS I ON TL.item = I.id
    LEFT JOIN Employee AS E ON T.lastmodifiedby = E.id
    LEFT JOIN Location AS L ON TL.location = L.id
  WHERE
    T.trandate >= '2023-01-01' AND T.trandate < '2024-01-01' -- Define your date range here
    AND T.type IN ('ItemRcpt', 'InvTrnfr', 'BinTrnfr', 'InvCount', 'InvAdjst', 'ItemShip', 'RtnAuth')
    AND IA.inventorynumber IS NOT NULL
)
SELECT
  InventoryBatchLotNumber,
  'Goods Receipt Recorded' AS ActivityName,
  TransactionDate,
  TransactionDate as EndTime,
  UserName AS User,
  LocationName AS Location,
  TransactionMemo AS MovementReasonCode,
  (Quantity * Rate) AS StockValue,
  TransactionType,
  Sku AS Item
FROM EventData
WHERE TransactionType = 'Item Receipt'
UNION ALL
SELECT
  InventoryBatchLotNumber,
  'Quality Inspection Performed' AS ActivityName,
  LastModifiedDate AS TransactionDate, -- Using last modified as a proxy for this custom event
  LastModifiedDate as EndTime,
  UserName AS User,
  LocationName AS Location,
  'Quality Status set to ' || QualityStatus AS MovementReasonCode,
  (Quantity * Rate) AS StockValue,
  TransactionType,
  Sku AS Item
FROM EventData
WHERE QualityStatus = 'Approved' -- This condition requires customization based on your quality process
UNION ALL
-- NetSuite WMS activities often use separate tables. The following are placeholders if not using EventData.
-- If not using WMS, these activities might be inferred from status changes on other transactions.
SELECT
  NULL AS InventoryBatchLotNumber, -- This information needs to be joined from your WMS implementation
  'Put-away Initiated' AS ActivityName,
  trandate AS TransactionDate,
  trandate as EndTime,
  BUILTIN.DF(lastmodifiedby) AS User,
  BUILTIN.DF(location) AS Location,
  memo AS MovementReasonCode,
  NULL AS StockValue,
  'Bin Putaway Worksheet' AS TransactionType,
  NULL AS Item
FROM Transaction
WHERE type = 'BinWksht' AND status = 'A' -- Status for 'Pending'
UNION ALL
SELECT
  NULL AS InventoryBatchLotNumber, -- This information needs to be joined from your WMS implementation
  'Put-away Completed' AS ActivityName,
  lastmodifieddate AS TransactionDate,
  lastmodifieddate as EndTime,
  BUILTIN.DF(lastmodifiedby) AS User,
  BUILTIN.DF(location) AS Location,
  memo AS MovementReasonCode,
  NULL AS StockValue,
  'Bin Transfer' AS TransactionType,
  NULL AS Item
FROM Transaction
WHERE type = 'BinTrnfr' AND BUILTIN.DF(status) = 'Completed'
UNION ALL
SELECT
  InventoryBatchLotNumber,
  'Stock Moved Internally' AS ActivityName,
  TransactionDate,
  TransactionDate as EndTime,
  UserName AS User,
  LocationName AS Location,
  TransactionMemo AS MovementReasonCode,
  (Quantity * Rate) AS StockValue,
  TransactionType,
  Sku AS Item
FROM EventData
WHERE TransactionType IN ('Inventory Transfer', 'Bin Transfer')
UNION ALL
SELECT
  InventoryBatchLotNumber,
  'Inventory Count Initiated' AS ActivityName,
  TransactionDate,
  TransactionDate as EndTime,
  UserName AS User,
  LocationName AS Location,
  TransactionMemo AS MovementReasonCode,
  NULL AS StockValue,
  TransactionType,
  Sku AS Item
FROM EventData
WHERE TransactionType = 'Inventory Count'
UNION ALL
SELECT
  InventoryBatchLotNumber,
  'Inventory Count Approved' AS ActivityName,
  LastModifiedDate AS TransactionDate,
  LastModifiedDate as EndTime,
  UserName AS User,
  LocationName AS Location,
  TransactionMemo AS MovementReasonCode,
  NULL AS StockValue,
  TransactionType,
  Sku AS Item
FROM EventData
WHERE TransactionType = 'Inventory Count' AND TransactionStatus LIKE '%Approved%'
UNION ALL
SELECT
  InventoryBatchLotNumber,
  'Inventory Discrepancy Adjusted' AS ActivityName,
  TransactionDate,
  TransactionDate as EndTime,
  UserName AS User,
  LocationName AS Location,
  TransactionMemo AS MovementReasonCode,
  (Quantity * Rate) AS StockValue,
  TransactionType,
  Sku AS Item
FROM EventData
WHERE TransactionType = 'Inventory Adjustment'
UNION ALL
-- Picking Wave is a WMS-specific record. This query assumes a 'Wave' table exists.
SELECT
  NULL AS InventoryBatchLotNumber, -- Requires joining WaveTransaction and other tables to get lot numbers
  'Picking Wave Created' AS ActivityName,
  W.trandate AS TransactionDate,
  W.trandate AS EndTime,
  BUILTIN.DF(W.lastmodifiedby) AS User,
  BUILTIN.DF(WT.location) AS Location,
  W.memo AS MovementReasonCode,
  NULL AS StockValue,
  'Wave' AS TransactionType,
  NULL AS Item
FROM Wave AS W
JOIN WaveTransaction AS WT ON W.id = WT.wave
WHERE W.trandate >= '2023-01-01' AND W.trandate < '2024-01-01' -- Define your date range here
UNION ALL
SELECT
  InventoryBatchLotNumber,
  'Picking Completed' AS ActivityName,
  LastModifiedDate AS TransactionDate,
  LastModifiedDate as EndTime,
  UserName AS User,
  LocationName AS Location,
  TransactionMemo AS MovementReasonCode,
  (Quantity * Rate) AS StockValue,
  TransactionType,
  Sku AS Item
FROM EventData
WHERE TransactionType = 'Item Fulfillment' AND TransactionStatus LIKE '%Picked%'
UNION ALL
SELECT
  InventoryBatchLotNumber,
  'Packing Completed' AS ActivityName,
  LastModifiedDate AS TransactionDate,
  LastModifiedDate as EndTime,
  UserName AS User,
  LocationName AS Location,
  TransactionMemo AS MovementReasonCode,
  (Quantity * Rate) AS StockValue,
  TransactionType,
  Sku AS Item
FROM EventData
WHERE TransactionType = 'Item Fulfillment' AND TransactionStatus LIKE '%Packed%'
UNION ALL
SELECT
  InventoryBatchLotNumber,
  'Goods Issue Recorded' AS ActivityName,
  TransactionDate,
  TransactionDate as EndTime,
  UserName AS User,
  LocationName AS Location,
  TransactionMemo AS MovementReasonCode,
  (Quantity * Rate) AS StockValue,
  TransactionType,
  Sku AS Item
FROM EventData
WHERE TransactionType = 'Item Fulfillment' AND TransactionStatus LIKE '%Shipped%'
UNION ALL
SELECT
  InventoryBatchLotNumber,
  'Return Authorization Created' AS ActivityName,
  TransactionDate,
  TransactionDate as EndTime,
  UserName AS User,
  LocationName AS Location,
  TransactionMemo AS MovementReasonCode,
  (Quantity * Rate) AS StockValue,
  TransactionType,
  Sku AS Item
FROM EventData
WHERE TransactionType = 'Return Authorization'
UNION ALL
SELECT
  ED.InventoryBatchLotNumber,
  'Return Goods Received' AS ActivityName,
  ED.TransactionDate,
  ED.TransactionDate as EndTime,
  ED.UserName AS User,
  ED.LocationName AS Location,
  ED.TransactionMemo AS MovementReasonCode,
  (ED.Quantity * ED.Rate) AS StockValue,
  ED.TransactionType,
  ED.Sku AS Item
FROM EventData ED
JOIN Transaction T_RMA ON ED.CreatedFromId = T_RMA.id
WHERE ED.TransactionType = 'Item Receipt' AND T_RMA.type = 'RtnAuth'
UNION ALL
SELECT
  InventoryBatchLotNumber,
  'Stock Scrapped/Disposed' AS ActivityName,
  TransactionDate,
  TransactionDate as EndTime,
  UserName AS User,
  LocationName AS Location,
  TransactionMemo AS MovementReasonCode,
  (Quantity * Rate) AS StockValue,
  TransactionType,
  Sku AS Item
FROM EventData
WHERE TransactionType = 'Inventory Adjustment' AND Quantity < 0 AND (LOWER(TransactionMemo) LIKE '%scrap%' OR LOWER(TransactionMemo) LIKE '%dispose%');

Etapas

Pré-requisitos e configuração do ambiente: Confirme se você tem o Python 3.6 ou versão mais recente instalado. Instale as bibliotecas Python necessárias executando pip install requests requests-oauthlib pandas no terminal da linha de comando. Verifique se sua função do NetSuite tem permissões de 'REST Web Services' e acesso aos registros de transação necessários, como Item Receipt, Item Fulfillment e Inventory Adjustment.
Configure a autenticação do NetSuite: Entre no NetSuite e acesse Setup > Integration > Manage Integrations. Crie uma nova integração, habilite Token-Based Authentication e salve o Consumer Key e o Consumer Secret. Em seguida, acesse Setup > Users/Roles > Access Tokens > New. Selecione a integração, o usuário e a função configurados e salve o Token ID e o Token Secret. Anote também o Account ID, disponível em Setup > Integration > Web Services Preferences.
Prepare o script Python: Copie o script Python completo fornecido na seção 'query' deste documento para um novo arquivo, por exemplo, extract_netsuite_inventory.py.
Informe as credenciais e os parâmetros: Abra o script e substitua os valores de exemplo de ns_account_id, ns_consumer_key, ns_consumer_secret, ns_token_id e ns_token_secret pelas credenciais obtidas na etapa 2. Ajuste as variáveis start_date e end_date para definir o período desejado para a extração.
Personalize a consulta SuiteQL: Revise a consulta SuiteQL no script. Confira com atenção os marcadores de posição, como [Your Custom Field for QA Status] ou [Your Scrap Account ID]. Altere essas partes para corresponder à configuração específica do seu NetSuite e aos campos personalizados.
Execute o script de extração: Execute o script na linha de comando com o comando python extract_netsuite_inventory.py. O script se conectará à API do NetSuite, executará a consulta e cuidará automaticamente da paginação.
Acompanhe a execução do script: O script exibirá atualizações de progresso no console, indicando qual página de dados está sendo carregada. Erros de autenticação ou permissão também serão exibidos. O tempo de execução varia conforme o período e o volume de dados.
Revise os dados de saída: Quando o script for concluído, ele criará o arquivo netsuite_inventory_event_log.csv no mesmo diretório. Abra o arquivo CSV em um programa de planilhas para revisar os dados extraídos.
Prepare os dados para o ProcessMind: Antes de carregar o arquivo, confira se os cabeçalhos das colunas correspondem aos atributos exigidos pelo seu projeto no ProcessMind. Renomeie as colunas, se necessário. Por exemplo, InventoryBatchLotNumber deve corresponder ao ID do caso, ActivityName à atividade e TransactionDate ao campo de data e hora.

Configuração

Permissões da função no NetSuite: A função do NetSuite associada ao token de acesso precisa ter permissões para 'REST Web Services' e 'SuiteAnalytics Connect'. Também é necessário ter acesso de nível 'View' a todos os tipos de transação consultados, incluindo Item Receipt, Item Fulfillment, Inventory Adjustment, Inventory Transfer e quaisquer registros personalizados relevantes.
Autenticação baseada em token (TBA): Este script usa exclusivamente TBA para segurança. Confirme se a TBA está habilitada na sua conta do NetSuite (Setup > Company > Enable Features > SuiteCloud) e se você gerou as chaves de consumidor e os tokens de acesso necessários.
Período: O script exige start_date e end_date no formato 'YYYY-MM-DD'. Para os testes iniciais, use um período curto, como uma semana. Para uma análise completa, recomendamos normalmente um período de 3 a 6 meses, suficiente para capturar variações do processo sem gerar um volume excessivo de dados.
Filtro por subsidiária: Em contas NetSuite OneWorld, é essencial adicionar um filtro para a subsidiária específica e evitar a extração de dados de todas as entidades. Para isso, inclua AND Transaction.subsidiary = [Your Subsidiary ID] na cláusula WHERE de cada instrução SELECT da consulta.
Campos personalizados: A consulta contém marcadores de posição para atividades que costumam depender de campos ou registros personalizados, como 'Quality Inspection Performed'. Identifique os nomes corretos dos campos personalizados no seu sistema e atualize a consulta para extrair essas atividades.
Limites de uso da API: O NetSuite impõe limites de uso da API para simultaneidade e tempo total de execução. Em conjuntos de dados muito grandes, o script pode exceder o tempo limite. Recomendamos executar a extração fora dos horários de pico e dividir períodos muito longos em execuções menores e sequenciais.

Consulta de exemplo python

import requests
from requests_oauthlib import OAuth1
import json
import pandas as pd
import sys

class=class="hl-string">"hl-comment"># --- Configuration: Replace with your NetSuite Credentials and Parameters ---
ns_account_id = class="hl-string">"[Your NetSuite Account ID]"  class=class="hl-string">"hl-comment"># e.g., class="hl-string">"1234567_SB1"
ns_consumer_key = class="hl-string">"[Your Consumer Key]"
ns_consumer_secret = class="hl-string">"[Your Consumer Secret]"
ns_token_id = class="hl-string">"[Your Token ID]"
ns_token_secret = class="hl-string">"[Your Token Secret]"

class=class="hl-string">"hl-comment"># --- Date Range for Extraction ---
start_date = class="hl-string">"2023-01-01"
end_date = class="hl-string">"2023-06-30"

class=class="hl-string">"hl-comment"># --- SuiteQL Query ---
class=class="hl-string">"hl-comment"># This query unions data from multiple transaction types to build a comprehensive event log.
class=class="hl-string">"hl-comment"># Each SELECT block corresponds to a specific inventory activity.
suiteql_query = fclass="hl-string">"""
SELECT
    InventoryNumber.inventoryNumber AS InventoryBatchLotNumber,
    'Goods Receipt Recorded' AS ActivityName,
    Transaction.trandate AS TransactionDate,
    Transaction.lastModifiedDate AS EndTime,
    BUILTIN.DF(Transaction.lastModifiedBy) AS User,
    BUILTIN.DF(TransactionLine.location) AS Location,
    NULL AS MovementReasonCode,
    (TransactionLine.quantity * TransactionLine.rate) AS StockValue,
    BUILTIN.DF(Transaction.type) AS TransactionType,
    BUILTIN.DF(TransactionLine.item) AS Item
FROM
    Transaction
    INNER JOIN TransactionLine ON Transaction.id = TransactionLine.transaction
    INNER JOIN InventoryAssignment ON Transaction.id = InventoryAssignment.transaction AND TransactionLine.id = InventoryAssignment.transactionline
    INNER JOIN InventoryNumber ON InventoryAssignment.inventorynumber = InventoryNumber.id
WHERE
    Transaction.type = 'ItemRcpt' AND Transaction.trandate BETWEEN TO_DATE('{start_date}', 'YYYY-MM-DD') AND TO_DATE('{end_date}', 'YYYY-MM-DD')

UNION ALL

-- Note: Quality Inspection is often a custom process. This is a placeholder.
-- You may need to join to a custom record or check a custom field on the InventoryNumber record.
SELECT
    InventoryNumber.inventoryNumber AS InventoryBatchLotNumber,
    'Quality Inspection Performed' AS ActivityName,
    InventoryNumber.lastModifiedDate AS TransactionDate, -- Using last modified date as event time
    InventoryNumber.lastModifiedDate AS EndTime,
    (SELECT employee.entityId FROM employee WHERE employee.id = InventoryNumber.lastModifiedBy) AS User,
    BUILTIN.DF(InventoryNumber.location) AS Location,
    'QA Completed' AS MovementReasonCode,
    NULL AS StockValue,
    'Custom QA Process' AS TransactionType,
    BUILTIN.DF(InventoryNumber.item) AS Item
FROM
    InventoryNumber
WHERE
    InventoryNumber.custitemnumber_qa_status = 'Approved' -- Placeholder: [Configure based on your system]
    AND InventoryNumber.lastModifiedDate BETWEEN TO_DATE('{start_date}', 'YYYY-MM-DD') AND TO_DATE('{end_date}', 'YYYY-MM-DD')

UNION ALL

SELECT
    InventoryNumber.inventoryNumber AS InventoryBatchLotNumber,
    'Put-away Completed' AS ActivityName,
    Transaction.trandate AS TransactionDate,
    Transaction.lastModifiedDate AS EndTime,
    BUILTIN.DF(Transaction.lastModifiedBy) AS User,
    BUILTIN.DF(TransactionLine.location) AS Location,
    'Put-away' AS MovementReasonCode,
    NULL AS StockValue,
    BUILTIN.DF(Transaction.type) AS TransactionType,
    BUILTIN.DF(TransactionLine.item) AS Item
FROM
    Transaction
    INNER JOIN TransactionLine ON Transaction.id = TransactionLine.transaction
    INNER JOIN InventoryAssignment ON Transaction.id = InventoryAssignment.transaction AND TransactionLine.id = InventoryAssignment.transactionline
    INNER JOIN InventoryNumber ON InventoryAssignment.inventorynumber = InventoryNumber.id
WHERE
    Transaction.type = 'BinTrnfr' AND TransactionLine.quantity > 0 AND Transaction.trandate BETWEEN TO_DATE('{start_date}', 'YYYY-MM-DD') AND TO_DATE('{end_date}', 'YYYY-MM-DD')

UNION ALL

SELECT
    InventoryNumber.inventoryNumber AS InventoryBatchLotNumber,
    'Stock Moved Internally' AS ActivityName,
    Transaction.trandate AS TransactionDate,
    Transaction.lastModifiedDate AS EndTime,
    BUILTIN.DF(Transaction.lastModifiedBy) AS User,
    BUILTIN.DF(TransactionLine.location) AS Location,
    Transaction.memo AS MovementReasonCode,
    NULL AS StockValue,
    BUILTIN.DF(Transaction.type) AS TransactionType,
    BUILTIN.DF(TransactionLine.item) AS Item
FROM
    Transaction
    INNER JOIN TransactionLine ON Transaction.id = TransactionLine.transaction
    INNER JOIN InventoryAssignment ON Transaction.id = InventoryAssignment.transaction AND TransactionLine.id = InventoryAssignment.transactionline
    INNER JOIN InventoryNumber ON InventoryAssignment.inventorynumber = InventoryNumber.id
WHERE
    Transaction.type IN ('InvTrnfr', 'BinTrnfr') AND Transaction.trandate BETWEEN TO_DATE('{start_date}', 'YYYY-MM-DD') AND TO_DATE('{end_date}', 'YYYY-MM-DD')

UNION ALL

-- Note: Capturing multiple events from InventoryCount record (creation, approval)
SELECT
    InventoryDetail.inventoryNumber AS InventoryBatchLotNumber,
    'Inventory Count Initiated' AS ActivityName,
    InventoryCount.tranDate AS TransactionDate,
    NULL AS EndTime,
    BUILTIN.DF(InventoryCount.createdBy) as User,
    BUILTIN.DF(InventoryCount.location) as Location,
    'Count Creation' as MovementReasonCode,
    NULL as StockValue,
    'InvCount' as TransactionType,
    BUILTIN.DF(InventoryDetail.item) as Item
FROM
    InventoryCount
    INNER JOIN TransactionLine InventoryDetail ON InventoryCount.id = InventoryDetail.transaction
WHERE
    InventoryCount.tranDate BETWEEN TO_DATE('{start_date}', 'YYYY-MM-DD') AND TO_DATE('{end_date}', 'YYYY-MM-DD')

UNION ALL

SELECT
    InventoryDetail.inventoryNumber AS InventoryBatchLotNumber,
    'Inventory Count Approved' AS ActivityName,
    NoteSystem.noteDate AS TransactionDate, -- Using system note date for accuracy
    NoteSystem.noteDate AS EndTime,
    NoteSystem.author AS User,
    BUILTIN.DF(InventoryCount.location) as Location,
    'Count Approval' as MovementReasonCode,
    NULL as StockValue,
    'InvCount' as TransactionType,
    BUILTIN.DF(InventoryDetail.item) as Item
FROM
    InventoryCount
    INNER JOIN TransactionLine InventoryDetail ON InventoryCount.id = InventoryDetail.transaction
    INNER JOIN SystemNote NoteSystem on InventoryCount.id = NoteSystem.recordId
WHERE
    NoteSystem.field = 'TRANSTATUS' AND NoteSystem.newvalue = 'Approved'
    AND NoteSystem.noteDate BETWEEN TO_DATE('{start_date}', 'YYYY-MM-DD') AND TO_DATE('{end_date}', 'YYYY-MM-DD')

UNION ALL

SELECT
    InventoryNumber.inventoryNumber AS InventoryBatchLotNumber,
    'Inventory Discrepancy Adjusted' AS ActivityName,
    Transaction.trandate AS TransactionDate,
    Transaction.lastModifiedDate AS EndTime,
    BUILTIN.DF(Transaction.lastModifiedBy) AS User,
    BUILTIN.DF(TransactionLine.location) AS Location,
    Transaction.memo AS MovementReasonCode,
    (TransactionLine.quantity * TransactionLine.rate) AS StockValue,
    BUILTIN.DF(Transaction.type) AS TransactionType,
    BUILTIN.DF(TransactionLine.item) AS Item
FROM
    Transaction
    INNER JOIN TransactionLine ON Transaction.id = TransactionLine.transaction
    INNER JOIN InventoryAssignment ON Transaction.id = InventoryAssignment.transaction AND TransactionLine.id = InventoryAssignment.transactionline
    INNER JOIN InventoryNumber ON InventoryAssignment.inventorynumber = InventoryNumber.id
WHERE
    Transaction.type = 'InvAdjst' AND Transaction.trandate BETWEEN TO_DATE('{start_date}', 'YYYY-MM-DD') AND TO_DATE('{end_date}', 'YYYY-MM-DD')

UNION ALL

SELECT
    InventoryNumber.inventoryNumber AS InventoryBatchLotNumber,
    'Goods Issue Recorded' AS ActivityName,
    Transaction.trandate AS TransactionDate,
    Transaction.actualShipDate AS EndTime,
    BUILTIN.DF(Transaction.lastModifiedBy) AS User,
    BUILTIN.DF(TransactionLine.location) AS Location,
    'Shipment' AS MovementReasonCode,
    (TransactionLine.quantity * TransactionLine.rate) AS StockValue,
    BUILTIN.DF(Transaction.type) AS TransactionType,
    BUILTIN.DF(TransactionLine.item) AS Item
FROM
    Transaction
    INNER JOIN TransactionLine ON Transaction.id = TransactionLine.transaction
    INNER JOIN InventoryAssignment ON Transaction.id = InventoryAssignment.transaction AND TransactionLine.id = InventoryAssignment.transactionline
    INNER JOIN InventoryNumber ON InventoryAssignment.inventorynumber = InventoryNumber.id
WHERE
    Transaction.type = 'ItemShip' AND Transaction.status = 'ItemShip:G' -- G = Shipped
    AND Transaction.trandate BETWEEN TO_DATE('{start_date}', 'YYYY-MM-DD') AND TO_DATE('{end_date}', 'YYYY-MM-DD')

UNION ALL

SELECT
    NULL AS InventoryBatchLotNumber, -- Batch not known at time of authorization
    'Return Authorization Created' AS ActivityName,
    Transaction.trandate AS TransactionDate,
    Transaction.lastModifiedDate AS EndTime,
    BUILTIN.DF(Transaction.createdby) AS User,
    BUILTIN.DF(TransactionLine.location) AS Location,
    Transaction.memo AS MovementReasonCode,
    (TransactionLine.quantity * TransactionLine.rate) AS StockValue,
    BUILTIN.DF(Transaction.type) AS TransactionType,
    BUILTIN.DF(TransactionLine.item) AS Item
FROM
    Transaction
    INNER JOIN TransactionLine ON Transaction.id = TransactionLine.transaction
WHERE
    Transaction.type = 'RtnAuth' AND Transaction.trandate BETWEEN TO_DATE('{start_date}', 'YYYY-MM-DD') AND TO_DATE('{end_date}', 'YYYY-MM-DD')

UNION ALL

SELECT
    InventoryNumber.inventoryNumber AS InventoryBatchLotNumber,
    'Return Goods Received' AS ActivityName,
    Transaction.trandate AS TransactionDate,
    Transaction.lastModifiedDate AS EndTime,
    BUILTIN.DF(Transaction.lastModifiedBy) AS User,
    BUILTIN.DF(TransactionLine.location) AS Location,
    'Return' AS MovementReasonCode,
    (TransactionLine.quantity * TransactionLine.rate) AS StockValue,
    BUILTIN.DF(Transaction.type) AS TransactionType,
    BUILTIN.DF(TransactionLine.item) AS Item
FROM
    Transaction
    INNER JOIN TransactionLine ON Transaction.id = TransactionLine.transaction
    INNER JOIN InventoryAssignment ON Transaction.id = InventoryAssignment.transaction AND TransactionLine.id = InventoryAssignment.transactionline
    INNER JOIN InventoryNumber ON InventoryAssignment.inventorynumber = InventoryNumber.id
WHERE
    Transaction.type = 'ItemRcpt' AND Transaction.createdFrom IS NOT NULL AND BUILTIN.DF(Transaction.createdFrom.type) = 'Return Authorization'
    AND Transaction.trandate BETWEEN TO_DATE('{start_date}', 'YYYY-MM-DD') AND TO_DATE('{end_date}', 'YYYY-MM-DD')

UNION ALL

SELECT
    InventoryNumber.inventoryNumber AS InventoryBatchLotNumber,
    'Stock Scrapped/Disposed' AS ActivityName,
    Transaction.trandate AS TransactionDate,
    Transaction.lastModifiedDate AS EndTime,
    BUILTIN.DF(Transaction.lastModifiedBy) AS User,
    BUILTIN.DF(TransactionLine.location) AS Location,
    'Scrap/Disposal' AS MovementReasonCode,
    (TransactionLine.quantity * TransactionLine.rate) AS StockValue,
    BUILTIN.DF(Transaction.type) AS TransactionType,
    BUILTIN.DF(TransactionLine.item) AS Item
FROM
    Transaction
    INNER JOIN TransactionLine ON Transaction.id = TransactionLine.transaction
    INNER JOIN InventoryAssignment ON Transaction.id = InventoryAssignment.transaction AND TransactionLine.id = InventoryAssignment.transactionline
    INNER JOIN InventoryNumber ON InventoryAssignment.inventorynumber = InventoryNumber.id
WHERE
    Transaction.type = 'InvAdjst' AND TransactionLine.quantity < 0 AND Transaction.account = [Your Scrap Account ID] -- Placeholder: [Configure based on your system]
    AND Transaction.trandate BETWEEN TO_DATE('{start_date}', 'YYYY-MM-DD') AND TO_DATE('{end_date}', 'YYYY-MM-DD')

-- Note: Activities like Picking/Packing/Wave Creation often require the WMS module.
-- The following are common representations but may need adjustment for your specific configuration.

UNION ALL

SELECT
    NULL AS InventoryBatchLotNumber, -- Batch is assigned during picking, not wave creation
    'Picking Wave Created' as ActivityName,
    Wave.creationDate as TransactionDate,
    Wave.lastModifiedDate as EndTime,
    BUILTIN.DF(Wave.createdBy) as User,
    BUILTIN.DF(Wave.location) as Location,
    NULL as MovementReasonCode,
    NULL as StockValue,
    'Wave' as TransactionType,
    NULL as Item
FROM Wave
WHERE Wave.creationDate BETWEEN TO_DATE('{start_date}', 'YYYY-MM-DD') AND TO_DATE('{end_date}', 'YYYY-MM-DD')

UNION ALL

-- Picking/Packing are often status changes on the Item Fulfillment
SELECT
    InventoryNumber.inventoryNumber AS InventoryBatchLotNumber,
    'Picking Completed' as ActivityName,
    NoteSystem.noteDate as TransactionDate, -- Use system note date for status change time
    NoteSystem.noteDate as EndTime,
    NoteSystem.author AS User,
    BUILTIN.DF(TransactionLine.location) AS Location,
    'Picking for Shipment' as MovementReasonCode,
    NULL AS StockValue,
    BUILTIN.DF(Transaction.type) AS TransactionType,
    BUILTIN.DF(TransactionLine.item) AS Item
FROM
    Transaction
    INNER JOIN TransactionLine ON Transaction.id = TransactionLine.transaction
    INNER JOIN InventoryAssignment ON Transaction.id = InventoryAssignment.transaction AND TransactionLine.id = InventoryAssignment.transactionline
    INNER JOIN InventoryNumber ON InventoryAssignment.inventorynumber = InventoryNumber.id
    INNER JOIN SystemNote NoteSystem on Transaction.id = NoteSystem.recordId
WHERE
    Transaction.type = 'ItemShip' AND NoteSystem.field = 'TRANSTATUS' AND NoteSystem.newvalue = 'Packed'
    AND NoteSystem.noteDate BETWEEN TO_DATE('{start_date}', 'YYYY-MM-DD') AND TO_DATE('{end_date}', 'YYYY-MM-DD')

UNION ALL

SELECT
    InventoryNumber.inventoryNumber AS InventoryBatchLotNumber,
    'Packing Completed' as ActivityName,
    NoteSystem.noteDate as TransactionDate, -- Use system note date for status change time
    NoteSystem.noteDate as EndTime,
    NoteSystem.author AS User,
    BUILTIN.DF(TransactionLine.location) AS Location,
    'Packing for Shipment' as MovementReasonCode,
    NULL AS StockValue,
    BUILTIN.DF(Transaction.type) AS TransactionType,
    BUILTIN.DF(TransactionLine.item) AS Item
FROM
    Transaction
    INNER JOIN TransactionLine ON Transaction.id = TransactionLine.transaction
    INNER JOIN InventoryAssignment ON Transaction.id = InventoryAssignment.transaction AND TransactionLine.id = InventoryAssignment.transactionline
    INNER JOIN InventoryNumber ON InventoryAssignment.inventorynumber = InventoryNumber.id
    INNER JOIN SystemNote NoteSystem on Transaction.id = NoteSystem.recordId
WHERE
    Transaction.type = 'ItemShip' AND NoteSystem.field = 'TRANSTATUS' AND NoteSystem.newvalue = 'Packed'
    AND NoteSystem.noteDate BETWEEN TO_DATE('{start_date}', 'YYYY-MM-DD') AND TO_DATE('{end_date}', 'YYYY-MM-DD')

-- Put-away Initiated is not included as Bin Putaway Worksheet is not available in standard SuiteQL at this time.

"""

class=class="hl-string">"hl-comment"># --- Main Script Logic ---
def main():
    class=class="hl-string">"hl-comment"># Construct the URL for the SuiteQL endpoint
    base_url = fclass="hl-string">"https://{ns_account_id.lower().replace('_', '-')}.suitetalk.api.netsuite.com"
    suiteql_url = fclass="hl-string">"{base_url}/services/rest/query/v1/suiteql"

    class=class="hl-string">"hl-comment"># Set up OAuth1 authentication
    auth = 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_id
    )

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

    offset = 0
    limit = 1000  class=class="hl-string">"hl-comment"># NetSuite's max limit per page
    all_data = []

    print(class="hl-string">"Starting NetSuite data extraction...")

    while True:
        payload = json.dumps({
            class="hl-string">'q': suiteql_query,
            class="hl-string">'offset': offset,
            class="hl-string">'limit': limit
        })

        try:
            print(fclass="hl-string">"Fetching data page with offset: {offset}")
            response = requests.post(suiteql_url, headers=headers, data=payload, auth=auth)
            response.raise_for_status()  class=class="hl-string">"hl-comment"># Raises an HTTPError for bad responses (4xx or 5xx)

            result = response.json()
            
            if class="hl-string">'items' in result and result[class="hl-string">'items']:
                all_data.extend(result[class="hl-string">'items'])
            
            has_more = result.get(class="hl-string">'hasMore', False)
            if not has_more:
                print(class="hl-string">"All pages have been fetched.")
                break
            
            offset += limit

        except requests.exceptions.HTTPError as e:
            print(fclass="hl-string">"HTTP Error: {e}")
            print(fclass="hl-string">"Response body: {response.text}")
            sys.exit(1)
        except Exception as e:
            print(fclass="hl-string">"An unexpected error occurred: {e}")
            sys.exit(1)

    if not all_data:
        print(class="hl-string">"No data found for the specified criteria.")
        return

    class=class="hl-string">"hl-comment"># Convert the list of dictionaries to a pandas DataFrame
    df = pd.DataFrame(all_data)

    class=class="hl-string">"hl-comment"># Save the DataFrame to a CSV file
    output_file = class="hl-string">'netsuite_inventory_event_log.csv'
    df.to_csv(output_file, index=False)
    print(fclass="hl-string">"Extraction complete. Data saved to {output_file}")

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

Pronto para começar?

Use este Template para preparar seus dados do NetSuite com eficiência e começar hoje mesmo a encontrar insights valiosos sobre seu processo de gestão de estoque. Otimize suas operações com confiança e precisão.

Voltar ao guia de melhoria

Baixar Template

Transforme agora a gestão de estoque no NetSuite!

Identifique ineficiências, aumente o atendimento dos pedidos e reduza o tempo de ciclo em 30%.

Começar o teste grátis

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

Seu Template de dados de gestão de estoque

Seu Template de dados de gestão de estoque

Atributos de gestão de estoque

Atividades de gestão de estoque

Guias de extração

Pesquisa salva e exportação CSV do NetSuite para estoque

Etapas

Configuração

Consulta de exemplo config

Consulta direta ao banco de dados via SuiteAnalytics Connect

Etapas

Configuração

Consulta de exemplo sql

Script Python usando SuiteQL pela API REST do NetSuite

Etapas

Configuração

Consulta de exemplo python

Pronto para começar?

Transforme agora a gestão de estoque no NetSuite!