Desenvolvimento Millen-19006 - API Produtos - Permitir Informações sobre Tipo de Barra
Release 62.46.2
Versão 5
Autor André Mota
Processo: Produtos
Nome do Processo: Cadastro de Produtos com Código de Barras
Motivação
Este novo recurso permite a inclusão de diferentes tipos de barras para um mesmo SKU. A novidade atende a empresas que trabalham com vários tipos de barras por produtos. Estas barras também podem variar de acordo com a filial. Para isso, foi alterada a API de atualização de produtos, a MILLENIUM_ECO.PRODUTOS.Atualiza, disponibilizando, no método MILLENIUM_ECO.PRODUTOS.SKU_ALTERA, registro BARRA_SKU, os parâmetros: BARRA, FORNECEDOR, TIPO_BARRA e FILIAL.
Entradas
Cadastro do produto
Para exemplificarmos o novo recurso, veremos, abaixo, um produto cadastrado com dois SKUs e cada um deles com duas barras diferentes (os dados cadastrais abaixo foram usados apenas como exemplo).
SKU 1
Código: 7777
Cor: 32
Estampa: 000
Tamanho: U
Barra SKU: 777732000U
Para o SKU acima, teremos duas barras:
BARRA 1 - SKU 1
Barra: 777732000U00100005
Fornecedor: 00005 - TELECOMUNICACOES S.A
Tipo Barra: 95615378 - BARRA CLIENTE
Filial: 001 - FILIAL PADRÃO
BARRA 2 - SKU 1
Barra: 777732000U00200006
Fornecedor: 00006 - FORNECEDOR INTERMEDIARIO
Tipo Barra: 95615379 - TIPO DE BARRA TESTE
Filial: 002 - FILIAL SECUNDARIA
Na imagem, abaixo, vemos, no JSON, as informações do cadastro do produto, do SKU e dos tipos de barras:
SKU 2
Código: 7777
Cor: 48
Estampa: 000
Tamanho: U
Barra SKU: 777748000U
Para o SKU acima, teremos duas barras:
BARRA 1 - SKU 2
Barra: 777748000U00100005
Fornecedor: 00005 - TELECOMUNICACOES S.A
Tipo Barra: 95615378 - BARRA CLIENTE
Filial: 001 - FILIAL PADRÃO
BARRA 2 - SKU 2
Barra: 777748000U00200006
Fornecedor: 00006 - FORNECEDOR INTERMEDIARIO
Tipo Barra: 95615379 - TIPO DE BARRA TESTE
Filial: 002 - FILIAL SECUNDARIA
Chamada do método
Para verificarmos a criação das barras do produto, realizaremos a chamada do método MILLENIUM_ECO.PRODUTOS.ATUALIZA a partir do JSON apresentado no item anterior. 
Validações e Saídas
Validando as barras inseridas
Barra no nível do SKU já existente: 
Barras para as duas cores ligadas ao fornecedor 00005 - TELECOMUNICACOES S.A, à filial 001 - FILIAL PADRÃO e ao tipo de barra 95615378 - BARRA CLIENTE: 
Barras para as duas cores ligadas ao fornecedor 00006 - FORNECEDOR INTERMEDIARIO, à filial 002 - FILIAL SECUNDARIA e ao tipo de barra 95615379 - TIPO DE BARRA TESTE: 
Observação: ao cadastrar uma barra com filial e fornecedor, por exemplo, e, depois, realizar nova chamada com a mesma barra, mas retirando ou trocando a filial e/ou fornecedor, o sistema não atualiza esses campos na tabela Código de Barras, pois entende que a barra é a mesma e o SKU não mudou. Portanto, o método MILLENIUM_ECO.PRODUTOS.ATUALIZA só reconhece que houve mudanças, caso haja alteração na barra ou no SKU.
Importante:
1. Os campos referentes a fornecedores, filiais e tipos de barras não são obrigatórios. No entanto, se informados, precisam existir na base de dados. Isso vale tanto para os ID internos quanto para os ID externos ou descrição do tipo da barra. Caso estes dados não sejam localizados no banco de dados, serão aplicadas travas pelo sistema. Veja o exemplo abaixo para filial ou código de filial inexistente:
2. A prioridade de busca dos parâmetros será sempre o ID interno (FORNECEDOR, FILIAL e TIPO_BARRA). Caso esses campos não sejam informados, a busca será realizada pelos IDs externos e descrição do tipo de barra.
Se o cliente informar o FORNECEDOR e o COD_FORNECEDOR na mesma chamada, para o mesmo registro, o sistema irá considerar o campo FORNECEDOR, independente dele existir ou não no banco de dados. Se não existir, o sistema retornará a mensagem.