Estoque/localização de estoque
Seu guia para a integração V5!
A integração do Inventário/Localização de Estoque entre a Rastreabilidade V5 e o sistema ERP do cliente permite mercadoria detalhes de estoque, como números de lote, quantidades disponíveis e locais a serem enviados para Rastreabilidade V5. Esses detalhes permitirão que tais mercadorias sejam usadas para produção/pedido, etc.
Dependendo da configuração do nosso ERP, existem algumas maneiras diferentes de lidar com o estoque/estoque:
- ERP como mestre de estoque: Aqui o ERP alimentaria dados de inventário no V5, e então o V5 retornaria ajustes/consumo/produção/etc. (mais comum) (entrar em estoque, sair). Isso pode ser feito de duas maneiras; O valor atualizado do estoque do registro (o lote 2 agora tem 123LB); Ou você pode consultar o valor de ajuste no log (Lote50 -123LBS). A primeira opção mantém as coisas mais sincronizadas, mas tem mais potencial para perder uma transação.
- V5 como mestre de estoque: V5 alimenta dados de inventário para o ERP. O ERP então retroalimenta os níveis de estoque atualizados em intervalos regulares. (estoque fora, estoque dentro)
- ERP como mestre de estoque: O ERP alimenta o estoque do V5, depois o V5 retorna os níveis de estoque regularmente e o ERP atualiza sua contagem. Isso é benéfico porque o ERP e o V5 sempre estarão sincronizados. No entanto, isso pode ser problemático devido ao tempo e à frequência da sincronização, especialmente se o estoque puder ser deduzido no próprio ERP, esses níveis ajustados poderão ser substituídos na próxima sincronização V5. Este método pode ser útil se o ERP/MRP não ajusta diretamente o estoque, mas apenas o mantém para dados financeiros. (entrar em estoque, sair de estoque)
Se você não tiver certeza sobre o melhor caminho a seguir para a configuração específica do seu ERP, a SG Systems pode organizar uma sessão de consulta para avaliar melhor a metodologia ideal para o seu sistema.
Conteúdo
1. Layout do Centro de Controle
Em termos de como podemos relacionar os detalhes do inventário/localização do estoque com o que vemos no Control Center, usaremos esse endpoint principalmente para preencher o painel inferior esquerdo para importar e exportar nossos níveis/locais de estoque para mercadorias existentes.
Usando o Gateway V5, podemos preencher facilmente os dados aqui usando dois terminais, ‘Stock’ e ‘StockLocation’.
2. Links API
Para saber mais sobre as definições dessas classes de banco de dados, consulte os seguintes links:
3. Modelo de Integração
O modelo de integração para Stock Location pode ser baixado clique aqui.
4. Guia de campo StockLocation
4.1. Chaves primárias
Chaves primárias são o identificador exclusivo para cada tabela na API V5. Para StockLocation, estes são:
location.code – O código de identificação único para o localização de estoque.
stock.commodity.code – O código de identificação único para o mercadoria
stock.lotNo – O número do lote do estoque.
Para Stock, as chaves primárias são:
lotNo – O número do lote do estoque.
commodity.code – O código de identificação exclusivo da mercadoria.
Observe que os números de lote podem ser gerados automaticamente pelo sistema ou inseridos manualmente. Os números de lote do fornecedor podem ser inseridos usando o campo descrito abaixo. Os números de lote podem ser gerados globalmente (nenhum número de lote pode ser igual) ou por mercadoria.
4.2. Os campos obrigatórios
Outros campos exigidos pelo SG para preencher uma linha de mercadoria válida no V5 Control Center são:
stock.expiry – A data de validade do lote específico.
qty – A quantidade da mercadoria naquele lote.
4.3. Campos preferidos
Os campos preferenciais servem para adicionar mais informações sobre a mercadoria em questão e, embora não sejam obrigatórios, são úteis quando se trata de funcionalidade adicional no Rastreabilidade V5.
stock.supplier.code - O código do fornecedor que forneceu o lote da mercadoria.
stock.cost - O custo (por UM) da mercadoria.
stock.dateReceived - A data em que o lote foi registrado no estoque.
stock.supplierLotNo - O número do lote atribuído pelo fornecedor.
4.4. Campos Adicionais
Campos adicionais também podem ser incluídos, como:
stock.commodity.description - A descrição da mercadoria.
stock.commodity.units.code - A UM padrão da mercadoria.
stock.commodity.recordStock – Se o uso desta mercadoria será rastreado com Rastreabilidade V5.
Observe que esses campos adicionais podem ser usados para criar entradas de mercadorias na Rastreabilidade V5, bem como atribuir locais de estoque e quantidades a elas. Ao usar o Método CSV da troca de dados, devemos garantir que 'Criar Entidades Filhos' esteja selecionado no 'Gateway' do Centro de Controle. No entanto, as mercadorias existentes não podem ser atualizadas no V5-API usando este endpoint, em vez disso, devemos abordá-los diretamente usando o 'Mercadoria' ponto final em vez disso.
5. Metodologia
Dependendo do propósito da nossa integração API, podemos fazer uso do ‘StockLocation’ or ‘Stock’ endpoint para importações e exportações JSON e CSV. Agora podemos ver isso abaixo.
5.1. JSON – Importar
StockLocation:
Podemos fazer uso do ‘StockLocation’ endpoint para inserir registros de estoque de mercadorias (existentes ou não) no Rastreabilidade V5 que contém informações relativas a datas de recebimento/validade, números de lote/lote do fornecedor e, claro, localização do estoque.
‘StockLocation’ importar Endpoint/URI –
http://host:port/V5-API/api/integrate/import/stock_location
Para esta importação de amostra usando o ‘StockLocation’ endpoint, podemos estruturar um arquivo de importação básico para um único lote conforme abaixo:
Este arquivo JSON de amostra pode ser baixado aqui..
Usando o manual da API podemos ver aqui que estamos usando apenas o ‘qty’ valor do ‘StockLocation’ classe, com todos os outros valores aninhados sob o ‘stock’ or ‘location’ aula. Também podemos ver que ‘code’ e ‘units’ pontos de dados são aninhados ainda mais sob o ‘commodity’ classe.
Podemos ver um resumo desse processo de fluxo de dados abaixo:
Se executarmos o arquivo JSON acima, veremos que nosso lote de commodities ‘I015’ (Jalepenos) agora esse lote foi importado para o Control Center.
Contudo, o que não podemos fazer com o ‘StockLocation’ o ponto final é a alteração de valores, como o número do lote do fornecedor e a data de vencimento do estoque existente. Para fazer isso precisaríamos usar o ‘Stock’ ponto final.
Stock:
Como mencionado acima, o ‘StockLocation’ endpoint pode ser usado para inserir registros de estoque e seus locais associados. No entanto, se quisermos atualizar os detalhes desses lotes que se enquadram no ‘Stock’ cabeçalho, devemos usar o ‘Stock’ ponto final. Isso inclui detalhes como número de lote do fornecedor, data de validade e peso recebido.
‘Stock’ importar Endpoint/URI –
http://host:port/V5-API/api/integrate/import/stock
Para um bem básico ‘Stock’ arquivo de importação que atualizará a data de validade e o número do lote do fornecedor do lote que criamos acima, podemos usar o seguinte:
Resultando na atualização das informações do lote na V5:
5.2. JSON – Exportar
Em termos de recebimento de arquivos relacionados a locais de estoque da API V5, se verificarmos os resumos do método sob o IntegrationExport classe, podemos pensar que ‘StockLocations’ (export/locations/stock) seria o que procuramos. No entanto, este não é o caso, pois este endpoint exportará uma lista de locais de estoque (vs. locais de produção) que existem no sistema.
Para receber informações de localização e níveis de estoque de nossas commodities, podemos usar:
Estoque individual de mercadorias + lote:
Exportar endpoint/URI –
http://host:port/V5-API/api/integrate/export/stock/{commodityCode}/{lotNumber}
Este endpoint exportará um arquivo JSON com todas as informações relacionadas ao lote especificado de uma mercadoria singular. Se executarmos esta solicitação usando as informações do lote que acabamos de importar, obteremos um arquivo parecido com este:
Um exemplo de arquivo JSON deste tipo pode ser baixado aqui..
Todo o estoque:
Exportar endpoint/URI –
http://host:port/V5-API/api/integrate/export/stock/{all}
Este endpoint exportará um arquivo JSON que inclui uma lista de todas as informações relacionadas para todos os lotes de cada mercadoria no sistema, dependendo do valor do campo {all}. Se isso é ‘true’ então retiraremos todos os lotes de estoque, enquanto se ‘false’ então obteremos apenas um retorno para novos itens de estoque (ou seja, lotes de mercadorias que não estão marcadas como já exportadas).
Se executarmos esta solicitação como ‘true’ (tão http://host:port/V5-API/api/integrate/export/stock/true) , obteremos um arquivo semelhante a este:
Um exemplo de arquivo JSON deste tipo pode ser baixado aqui..
Os pontos finais acima fornecerão apenas os níveis de estoque atuais. Mas e se quisermos acompanhar os nossos níveis de stock à medida que a produção ocorre? Aqui temos algumas opções diferentes dependendo de como estamos usando a API e integrando com um sistema ERP.
Também podemos utilizar uma variedade de endpoints transacionais e de log para recuperar informações mais relevantes sobre alterações no nível de estoque.
Para Registro do sistema pontos finais, estes são:
Logs de sistema consumidos/produzidos
Registros do sistema de ajuste
Para Transacional/Genérico pontos finais, estes são:
5.3. CSV - Importar
Nome do arquivo de definição de cabeçalho/coluna: “stockLocation.csvh”
Os arquivos de cabeçalho completos devem ser colocados em: “<installdir>\SG Control Center\gateway\import\column_defs”
Nome do arquivo CSV de importação: “stockLocation-datetime.csv”
Os CSVs para importação devem ser colocados em: “<installdir>\SG Control Center\gateway\import”
Arquivo de cabeçalho:
Os arquivos de cabeçalho geralmente serão compilados pela SG Systems antes da realização das integrações CSV, mas podemos ver um exemplo básico de um que podemos usar para inventário/estoque, usando o definido anteriormente definições de classe, 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.
Um exemplo de arquivo de importação csv poderia ser parecido com isto:
Aqui podemos ver que estamos importando 3 novos lotes de 2 fornecedores diferentes. Este arquivo de importação de amostra pode ser baixado aqui..
Com a importação concluída, podemos ver que esses lotes adicionais de Jalapeno foram adicionados ao Control Center. Observe a diferença aqui entre ‘Qty’ (na mão) e ‘Stock_WeightReceived’ em nosso csv de importação.
5.4. CSV - Exportar
Tal como acontece com as exportações JSON, temos algumas opções diferentes aqui:
StockLocation:
Ao exportar commodities usando este método, podemos usar o mesmo ponto final e definições de classe como fizemos para as importações.
Nome do arquivo de definição de cabeçalho/coluna: “stockLocation.csvh”
Os arquivos de cabeçalho completos devem ser colocados em: “<installdir>\SG Control Center\gateway\export\order”
Exportar nome do arquivo CSV: “StockLocation-datetime.csv”
Os CSVs para exportações serão gerados em: “<installdir>\SG Control Center\gateway\export”
Esta exportação também precisaria ser habilitada na seção Gateway do Control Center. Podemos escolher aqui exportar ‘Stock’ .
Arquivo de cabeçalho:
A partir daqui, seria um caso simples de estruturar nosso arquivo de cabeçalho de exportação para atender às informações que queremos receber de volta do sistema.
Poderíamos estruturá-lo de maneira muito semelhante à forma como estruturamos o cabeçalho de importação:
Este arquivo de cabeçalho de amostra pode ser baixado aqui..
Arquivo de exportação CSV:
Isso daria um retorno csv para nossas importações recentes que seria semelhante ao exemplo abaixo. Podemos ver aqui que recuperamos todas as linhas de estoque não exportadas anteriormente, incluindo a adição de alguns produtos que foram fabricados no início do dia.
Este arquivo de exportação de amostra pode ser baixado aqui..
No entanto, como acontece com as exportações JSON acima, isso não retornaria nenhum dado transacional, então novamente podemos fazer uso do ‘SystemLog’ endpoint, em vez disso, para recuperar dados mais relevantes em termos de transações e ajustes de estoque.
SystemLog:
Este endpoint pode ser usado para extrair uma ampla variedade de dados, percorrendo os pontos de dados disponíveis vinculados a partir daqui. Podemos ver as definições que podemos usar aqui..
Nome do arquivo de definição de cabeçalho/coluna: “SystemLog.csvh”
Os arquivos de cabeçalho completos devem ser colocados em: “<installdir>\SG Control Center\gateway\export\order”
Exportar nome do arquivo CSV: “SystemLog-datetime.csv”
Os CSVs para exportações serão gerados em: “<installdir>\SG Control Center\gateway\export”
Como acima, isso precisaria ser habilitado na seção Gateway do Control Center:
Arquivo de cabeçalho:
A partir daqui podemos estruturar nosso cabeçalho dependendo de quais dados transacionais queremos receber de volta ao ERP. Para nossos propósitos aqui, isso poderia ser assim:
Este arquivo de cabeçalho de amostra pode ser baixado aqui..
Arquivo de exportação CSV:
Portanto, podemos ver aqui que receberemos dados especificamente adaptados às nossas necessidades, incluindo dados como a mercadoria, seu número de lote, quantidade original, quaisquer ajustes e o usuário que executou a ação, juntamente com quaisquer motivos e tarefas relevantes. /informações do lote.
Se executarmos o log do sistema com o cabeçalho acima, obteremos uma exportação semelhante a esta:
Este arquivo de exportação de amostra pode ser baixado aqui..
