TOTVS Distribuição e Varejo - linha Winthor

Páginas filhas
  • 24219673 - DDVENDAS-54540 - DT - Ajuste na formatação de EAN GTIN-13 com Zeros à Esquerda.


01. DADOS GERAIS

Produto:

TOTVS Distribuição e Varejo

Linha de Produto:

Linha Winthor

Segmento:

Distribuição

Módulo:801 - Processamentos
Função:Atualização de Serviços Web
País:Brasil
Ticket:24219673 
Requisito/Story/Issue:DDVENDAS-54540


02. SITUAÇÃO/REQUISITO

Ocorria um erro no envio de dados de estoque e descontos para o fornecedor através da API NC. O problema se dava quando um produto utilizava o código EAN no formato GTIN-13, mas seu código auxiliar (CODAUXILIAR) era armazenado no banco de dados como tipo NUMBER. Ao armazenar, o zero à esquerda era suprimido, resultando em um código EAN com menos de 13 dígitos (ex: 12 dígitos), o que era rejeitado pela API NC por ser um código inválido.

03. SOLUÇÃO

Foi implementada uma melhoria no serviço winthor-logistic-operator para tratar o campo CODAUXILIAR antes do envio dos dados à API NC. A lógica agora identifica se o produto está configurado para utilizar o GTIN-13 (campo GTINCODAUXILIAR = 13 na Rotina 203) e, caso o código auxiliar tenha menos de 13 dígitos, ele é automaticamente preenchido com zeros à esquerda, garantindo o formato correto (13 dígitos) para que a API NC possa processar a informação.



  • Rotinas e Dependências:

    • Rotina 801 (Atualização de Serviços) para atualização do serviço.

    • Objeto winthor-logistic-operator - Versão 1.37.3.6


O procedimento a seguir valida a aplicação da correção e a funcionalidade do preenchimento do EAN:

  1. Acessar a Rotina 203 - Cadastrar Produto.


  2. Selecionar um produto que utilize o EAN GTIN-13 e garantir que o campo GTINCODAUXILIAR esteja configurado como 13.


  3. Consultar o endpoint de estoque da API NC, conforme o procedimento de teste:


    http://ip:porta/winthor/logistic-operator/v1/logistic-operation-stocks?systemCode=NC-EME&productCode=[CÓDIGO_PRODUTO].


  4. Verificar na resposta (JSON) que o campo referente ao EAN do produto está preenchido com 13 dígitos, incluindo o(s) zero(s) à esquerda.


  5. O sistema deve realizar o envio de dados de estoque/desconto à API NC com o EAN correto (13 dígitos), finalizando a operação com sucesso.


04. DEMAIS INFORMAÇÕES

Para que a correção seja aplicada, é necessário atualizar o serviço winthor-logistic-operator através da Rotina 801

05. ASSUNTOS RELACIONADOS

  • NA