Unidades de medida

A integração de Unidades de Medida entre o V5 Traceability e o sistema ERP de um cliente permite que as unidades de medida usadas por um sistema ERP/terceiro sejam enviadas para o V5 Traceability. Essas unidades podem ser então aplicadas ao armazenamento e formulação/produção dentro do sistema V5 Traceability.

A flexibilidade do sistema V5 Traceability permite uma configuração de unidades totalmente personalizada, com a capacidade de definir conversões de unidades personalizadas para grandes quantidades, como caixas e tambores, além de poder definir taxas de conversão específicas para commodities. Taxas de conversão específicas são especialmente úteis para itens com densidade específica, como veremos no exemplo abaixo.

Somente importações estão disponíveis para as classes 'WeightUnit' e 'UnitCommodity' que veremos aqui; exportações não estão disponíveis por meio das metodologias JSON ou CSV.

Para mais informações sobre como as unidades de medida funcionam no V5 Traceability, consulte nosso guia de módulos aqui.

1. Layout do centro de controle
2. Links da API
3. Modelo de Integração
4. Guia de campo de unidades
   1. Chaves Primárias
   2. Os campos obrigatórios
   3. Campos preferidos
   4. Campos adicionais
5. Metodologia
6. Unidade de peso
   1. JSON – Importar
   2. JSON – Exportar
   3. CSV - Importar
   4. CSV - Exportar
7. UnidadeCommodity
   1. JSON – Importar
   2. JSON – Exportar
   3. CSV - Importar
   4. CSV - Exportar

Em termos de como podemos relacionar unidades e taxas de conversão específicas de commodities com o que vemos no Centro de Controle, podemos ver que o painel superior aqui é para inserir nossas unidades de medida, com o painel inferior sendo para taxas de conversão específicas de commodities para a unidade selecionada no painel superior.

Se uma entrada no painel inferior não estiver presente para uma determinada mercadoria, o sistema reverterá para a taxa de conversão definida no painel superior quando uma mercadoria for usada com essa unidade. Uma vez que uma mercadoria é adicionada no painel inferior e uma taxa de conversão adicionada a ela (a 'UnitCommodity'), isso substitui a taxa de conversão no painel superior.

 

Usando o V5 Gateway podemos preencher facilmente ambos os painéis.

Para saber mais sobre as definições das 2 classes de banco de dados que usaremos para adicionar nossas unidades, consulte os seguintes links:

Unidade de peso

UnidadeCommodity

O modelo de integração para WeightUnit (unidades de medida) pode ser baixado aqui.

O modelo de integração para UnitCommodity (taxas de conversão específicas de commodities) pode ser baixado aqui.

As chaves primárias são o identificador exclusivo de cada tabela na API V5.

Para a Unidade de peso, isso é:

código – O código exclusivo para a unidade de medida (ou seja, g, kg, lb, oz etc.)

Para a UnidadeCommodity, as chaves primárias são:

unidade.código – o código único para a unidade de medida, conforme acima.

e

Código de mercadoria – O código exclusivo da mercadoria à qual será aplicada a taxa de conversão específica.

Outros campos exigidos pelo SG para preencher uma entrada válida no Control Center são:

Para a Unidade de peso:

taxa de conversão - A taxa de conversão para esta unidade, em relação à unidade com ID 1 no banco de dados.

Para a UnidadeCommodity:

taxa de conversão – a taxa de conversão específica para a mercadoria específica.

Os campos preferenciais servem para adicionar mais informações à unidade de medida (Unidade de peso) e, embora não sejam obrigatórios, são úteis quando se trata de funcionalidade dentro do V5 Traceability.

descrição - descrição da unidade (quilos, libras etc.)

Campos adicionais também podem ser incluídos para Unidade de peso, Tais como:

notas – quaisquer notas adicionais para a unidade

Dada a natureza relativamente simples desta classe, podemos usar a integração JSON ou CSV para importar unidades para o V5. Analisaremos isso do ponto de vista de fazer uma importação inicial para trazer quaisquer unidades ausentes para o sistema (weightUnit), após o que atribuiremos conversões específicas de commodities usando as unidades no sistema (UnitCommodity). Observe novamente que nenhuma exportação está disponível para endpoint/classe.

Importação de ''WeightUnit' Endpoint/URI –

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

Descrição do terminal

amostras:

Para esta importação de exemplo, usaremos o endpoint 'WeighUnit' para adicionar libras e onças à tabela Control Center Units mostrada acima na introdução. O arquivo JSON para fazer isso ficaria assim:

Observe que as taxas de conversão sempre serão calculadas a partir da unidade padrão (ou seja, a primeira unidade na tabela de unidades), então aqui estamos calculando isso em quilogramas (kg).

Este arquivo JSON de amostra pode ser baixado aqui.

Usando o arquivo acima, podemos ver que nossas novas unidades foram criadas no Centro de Controle.

Nenhuma exportação JSON está disponível para a classe 'WeightUnit'.

Nome do arquivo de definição de cabeçalho/coluna: “PesoUnit.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: “pesoUnit-datetime.csv”

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

amostras:

Arquivo de cabeçalho:

Os arquivos de cabeçalho geralmente são compilados pela SG Systems antes das integrações CSV ocorrerem, mas podemos ver um exemplo básico de um que podemos usar para unidades abaixo:

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. A SG Systems pode fornecer um arquivo de modelo para isso, listando o ponto de dados para cada coluna para tornar as coisas mais claras ao preencher a lista. Observe que esta primeira linha pode ser ignorada pelo Centro de Controle e, portanto, pode ser mantida no arquivo ao enviar para importação.

Aqui podemos ver que estamos criando as mesmas novas unidades que fizemos no exemplo JSON acima, embora usando letras minúsculas para o código das unidades, a fim de exibi-las mais claramente no Centro de Controle.

Este arquivo de importação de amostra pode ser baixado aqui.

Com a importação concluída, podemos ver que mais uma vez essas novas unidades foram criadas.

Assim como nas exportações JSON, nenhuma exportação CSV está disponível para a classe 'WeightUnit'.

Importação de Endpoint/URI de 'UnitCommodity' –

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

Descrição do terminal

amostras:

Para esta importação de exemplo, usaremos o endpoint 'UnitCommodity' para adicionar uma conversão de unidade específica para litros de leite. Vimos no Control Center acima que litros normalmente seriam convertidos como uma proporção de 1:1 de litros para kg, ou seja, 1 litro de água pesa 1 kg. Um litro de leite, no entanto, pesaria um pouco mais do que isso (1.035 kg), então veremos como podemos configurar isso para uma importação JSON abaixo.

Então, o que estamos dizendo ao sistema aqui é que, quando o leite for usado, a conversão usada será 1.035, substituindo a taxa de conversão padrão para a unidade ltr.

Este arquivo JSON de amostra pode ser baixado aqui.

Usando o arquivo acima, podemos ver que nossa taxa de conversão específica para leite foi adicionada ao painel inferior de 'litro'.

Nenhuma exportação JSON está disponível para a classe 'UnitCommodity'.

Nome do arquivo de definição de cabeçalho/coluna: “unidadeCommodity.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: “unidadeCommodity-datahora.csv”

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

amostras:

Arquivo de cabeçalho:

Os arquivos de cabeçalho geralmente são compilados pela SG Systems antes das integrações CSV ocorrerem, mas podemos ver um exemplo de um que podemos usar para conversão de unidades específicas de commodities abaixo:

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. A SG Systems pode fornecer um arquivo de modelo para isso, listando o ponto de dados para cada coluna para tornar as coisas mais claras ao preencher a lista. Observe que esta primeira linha pode ser ignorada pelo Centro de Controle e, portanto, pode ser mantida no arquivo ao enviar para importação.

Aqui podemos ver que estamos criando a mesma conversão de unidade específica de mercadoria que fizemos no exemplo JSON acima.

Este arquivo de importação de amostra pode ser baixado aqui.

Com a importação concluída, podemos ver que mais uma vez essa nova conversão de unidade específica de mercadoria foi criada.

Assim como nas exportações JSON, nenhuma exportação CSV está disponível para a classe 'UnitCommodity'.