Você pode importar Eventos da cadeia de suprimentos em massa no OriginsNext usando um arquivo CSV estruturado. Isso permite registrar muitos Eventos de uma só vez, em vez de criá-los um a um. Há um modelo de exemplo para download, com uma linha de exemplo por tipo de Evento, que também serve como exemplo prático.
Baixar o CSV de exemplo
A maneira mais rápida de montar o seu arquivo é começar pelo CSV de Eventos de exemplo. Ele tem os cabeçalhos de coluna exatos que o upload espera e uma linha de exemplo para cada tipo de Evento suportado, então também funciona como exemplo prático. Mantenha a linha de cabeçalho, substitua as linhas de exemplo pelos seus próprios Eventos e salve o arquivo como .csv.
Noções básicas de arquivo e formato
O seu upload deve atender a estas regras de formato antes de a plataforma aceitá-lo.
O arquivo deve ser um arquivo .csv e ter menos de 20 MB.
Os identificadores, em todos os lugares, usam o formato Type.Value, por exemplo GLN.WAREHOUSE-A. Para colocar mais de um identificador em uma única célula, separe-os com o caractere de barra vertical ( | ).
O arquivo tem um conjunto amplo de colunas que abrange todos os tipos de Evento. Quais colunas importam depende do Type do Evento. As colunas são agrupadas conforme mostrado na próxima seção.
Grupos de colunas
Todos os tipos de Evento compartilham as mesmas colunas. Você preenche apenas as colunas relevantes para o Type que está registrando.
Grupo de colunas | O que abrange |
Nível do Evento | Id, Type, Organisation, Name, Location, Time, Permission, Data Qualifier e Accurate Timestamp. |
Lado de entrada | Os Produtos ou unidades que entram no Evento, incluindo o seu proprietário, a logística e os Locais de origem ou destino, a quantidade, a contagem e quaisquer IDs de dispositivos IoT de entrada. |
Lado de saída | Os Produtos produzidos ou movidos para fora do Evento, incluindo o SKU e o lote de saída, a Organização proprietária e de logística, a quantidade e a contagem, os IDs transferíveis atribuídos a eles e se a geração do produto deve ser incrementada. |
Vínculos de pedido | Vínculos com um Pedido de Compra, Pedido de Venda ou consignação. |
Valor e custo | Campos de valor ou custo (valor do produto, custo adicional e custo de logística), cada um associado a uma moeda. |
Metadados | Colunas de formato livre chamadas Metadata.<key> para os seus próprios campos extras. |
Observação: A coluna Permission define a visibilidade de cada Evento. Informe Private para Privado, ou MyProductPartners para My Product Partners. Isso controla quem pode ver o Evento. Para entender a diferença, consulte Por que não consigo ver todos os Eventos na jornada de um Produto?
Tipos de Evento suportados
A coluna Type deve ser um dos tipos de Evento suportados abaixo. Qualquer outro valor é rejeitado. Para saber o que cada um significa e ver um exemplo, consulte Quais são os Tipos de Evento suportados?
Tipo de Evento | Tipo de Evento |
Commission | Decommission |
Object | Transformation |
Ownership Change | Aggregation |
Disaggregation | Received |
Dispatched | Transportation Started |
Transportation Ended | Storage Started |
Storage Ended | Bulk Receival |
Bulk Outturn |
|
Regras principais
Siga estas regras ao preencher o arquivo, porque o upload é validado em relação a todas elas antes de qualquer coisa ser criada.
Id e Type são sempre obrigatórios em todas as linhas.
As linhas que compartilham o mesmo Id são mescladas em um único Evento. É assim que um único Evento pode listar várias entradas: você adiciona uma linha por entrada, todas usando o mesmo Id. Por exemplo, um Evento Received com três Produtos de entrada usa três linhas que compartilham um Id.
Os carimbos de data/hora devem estar no formato ISO completo com fuso horário, no formato YYYY-MM-DDTHH:MM:SS.ZZZ TZ (por exemplo 2026-01-01T08:00:00.000Z, onde Z significa UTC).
As quantidades devem ser numéricas, as contagens devem ser números inteiros, e qualquer campo de valor deve estar associado a uma moeda.
Cada tipo de Evento tem os seus próprios campos obrigatórios. Por exemplo, um Evento Commission precisa de um SKU de saída e de identificadores de Produto de saída.
Como fazer o upload do seu arquivo
Para fazer o upload do seu CSV de Eventos concluído:
Acesse Product Traceability > Events no menu lateral para abrir a Events List.
Clique em + Add Events no canto superior direito.
No formulário de upload, arraste e solte o seu arquivo CSV concluído na área sombreada, ou clique na área sombreada para procurar e selecionar o seu arquivo.
Clique em Upload para iniciar o processamento.
O que acontece após o upload
O arquivo inteiro é validado de antemão antes de qualquer coisa ser criada, e os Eventos bem-sucedidos são então processados em segundo plano, em vez de instantaneamente.
Importante: Os uploads são do tipo tudo ou nada. Se qualquer linha ou Evento falhar na validação, o upload inteiro é rejeitado com uma lista combinada dos erros, e nada é criado. Corrija todos os erros listados e faça o upload do arquivo novamente.
Quando o arquivo passa na validação, os Eventos são enfileirados e processados em segundo plano. Eles não são criados instantaneamente e não são salvos como rascunhos. Você pode acompanhar o progresso de cada Evento na página de detalhes do upload, onde ele passa pelos estados abaixo.
Status | O que significa |
Pending | O Evento está na fila, aguardando processamento. |
In Progress | O Evento está sendo processado agora. |
Completed | O Evento foi criado com sucesso. |
Failed | O Evento não pôde ser criado. |
Após o processamento, os Eventos enviados aparecem na Events List e na visualização Journey de cada Produto relevante.