Link de perigo

O ponto de extremidade de importação 'HazardLink' pode ser usado para atribuir rapidamente commodities a perigo grupos dentro da Rastreabilidade V5.

Este guia se concentrará em como usar esse endpoint, tanto por meio da importação de CSV quanto usando JSON por meio da API V5.

1. Grupos de risco padrão
2. Links da API
3. Guia de campo HazardLink
   1. Chaves Primárias
   2. Campos adicionais
4. Conjunto de dados de exemplo
5. Metodologia
   1. 1. JSON – Importar
      2. CSV - Importar

O banco de dados V5 padrão apresenta vários dos grupos de risco mais comuns, mas este endpoint pode ser usado para criar grupos adicionais, se necessário. Os grupos de risco padrão que estão incluídos podem ser vistos na captura de tela abaixo:

Este ponto final não se destina a ser usado para criação de commodities, isso deve sempre ser feito por meio do 'Mercadoria' ponto final.

Para saber mais sobre as definições deste 'HazardLink' e classes de banco de dados relacionadas, consulte o seguinte link:

Link de perigo 

Perigo

Para ambas as metodologias de importação, as chaves primárias são:

Perigo_Perigo – o nome do Grupo de Risco (ou seja, óculos de segurança, protetores auriculares etc.).

Código_da_mercadoria – O código único da mercadoria a ser atribuído ao Grupo de Risco.

Outras opções aqui que podemos adicionar da classe de banco de dados 'Hazard' são:

Texto de aviso de perigo – O texto a ser exibido para um operador de Terminal ou WMS quando a mercadoria associada a um risco for manuseada. Necessário somente se estiver criando novos grupos de risco.

Cor do texto de perigo – Permite uma entrada de número RGB para atribuir uma cor ao Grupo de Risco. Observe que isso deve ser o mesmo para todas as mercadorias dentro do mesmo Grupo de Risco. Observe também aqui que ao importar cores usando este método, os números RGB não precisam ser separados por vírgulas (por exemplo, 219 125 33 em vez de 219, 125, 33).

Observe que essa opção não está disponível para a metodologia JSON, a menos que seja criado um novo grupo de risco por meio deste ponto de extremidade. Se for necessária a modificação das cores do grupo existente, é recomendável usar o ponto de extremidade CSV.

Neste artigo, veremos um conjunto de dados de exemplo simples com 2 ingredientes que podem ser usados ​​durante a produção:

• Álcool benzílico – Máscara de segurança (laranja) e luvas de segurança (vermelhas)
• Propilenoglicol – Óculos de segurança (Azul) e Luvas de segurança (Vermelho)

Importação de ponto final/URI de 'HazardLink' –

http://host:port/V5-API/api/integrate/import/hazard_link

Descrição do terminal

amostras:

Usando o endpoint 'HazardLink', podemos estruturar um arquivo de importação para as adições acima assim:

Este arquivo JSON de amostra pode ser baixado aqui..

E depois de publicarmos isso no sistema, podemos ver que todos os nossos produtos foram atribuídos ao grupo de risco correto. Nesse caso, podemos ver ambos os produtos adicionados ao grupo de risco "Luvas de segurança".

Para importações de CSV, primeiro precisamos construir um arquivo de cabeçalho para nossas importações.

Nome do arquivo de definição de cabeçalho/coluna: “Link de risco.csvh”

Os arquivos de cabeçalho completos devem ser colocados em: “ \SG Control Center\gateway\import\column_defs”

Nome do arquivo CSV de importação: “perigoLink-datahora.csv”

Os CSVs para importação devem ser colocados em: “ \SG Control Center\gateway\importar”

amostras:

Arquivo de cabeçalho:

Um exemplo de arquivo de cabeçalho pode ser visto abaixo. Aqui atribuiremos nossas commodities aos grupos de risco definidos e também adicionaremos uma cor aos grupos:

Para mais informações sobre como estruturamos esses arquivos, consulte o página principal de integração. Este arquivo de cabeçalho de amostra pode ser baixado aqui..

Arquivo de importação CSV:

Podemos então usar a ordem definida de pontos de dados no cabeçalho para estruturar nosso arquivo de importação. Observe que essa primeira linha pode ser ignorada pelo Control Center e, portanto, pode ser mantida no arquivo ao enviar para importação. Um exemplo de importação com base em nossos requisitos acima ficaria assim:

Observe novamente que não precisamos das vírgulas que normalmente separam os valores RGB. Este arquivo de importação de amostra pode ser baixado aqui..

Podemos então soltar esse arquivo em nossa pasta de importação, conforme definido acima, e quando a importação estiver concluída, poderemos ver que as cores do texto do grupo de risco foram atualizadas e, como acima, os 2 ingredientes agora foram adicionados ao grupo "Luvas de segurança":