Ir para o conteúdo principal

Manual de Implantação: Integração com GSI

Olá! Este guia foi criado para te orientar no processo de implantação da integração com a GS1. O objetivo é permitir que seu sistema se comunique de forma automática com a GS1 para gerar os Códigos EAN (GTIN-13) dos seus produtos, economizando tempo e evitando erros manuais.

 
1. O que você precisa antes de começar (Pré-requisitos)

Para que a integração funcione perfeitamente, garanta que você já tenha:

  • Conta na GS1 Brasil: Você precisa ter um cadastro ativo e acesso ao portal da GS1. É de lá que virão suas credenciais.
  • Produtos Cadastrados no Sistema: Seus produtos devem estar previamente cadastrados no nosso sistema, mesmo que ainda sem o código EAN.
  • Definição da Regra de Envio: Decida qual critério o sistema usará para saber quais produtos devem ser enviados à GS1. Recomendamos usar um Grupo, Tipo ou Categoria específico para isso (ex: um grupo chamado "Enviar para GS1").

 
2. Configurando a Integração no Sistema

Agora, vamos configurar a ponte entre o nosso sistema e a GS1.

Passo 1: Inserindo suas Credenciais da GS1

  1. Primeiro, você precisa pegar suas credenciais no portal da GS1:
    • Acesse o site da GS1 Brasil e faça o login.
    • Navegue até o menu Minha Conta e depois clique em APPs.
    • Copie as suas credenciais (geralmente um token, client ID ou similar).
  2. Agora, no nosso sistema, vá até a tela de configuração da integração GS1.
  3. Cole as credenciais que você copiou nos campos correspondentes e salve.

Passo 2: Definindo os Produtos para Envio Automático

Nesta etapa, vamos dizer ao sistema qual é a "fila" de produtos que devem ser enviados.

  1. Na mesma tela de configuração, você encontrará uma opção para definir a regra de consulta.
  2. Selecione o critério que você definiu no início (por exemplo, Grupo do Produto).
  3. Escolha o item específico (ex: o grupo "Enviar para GS1").
  4. Salve a configuração. A partir de agora, todo produto que for associado a este grupo será automaticamente preparado para o envio.

Passo 3: Ativando o Agendador Automático

A mágica acontece com um agendador que roda de tempos em tempos, buscando os produtos da fila e os enviando para a GS1.

  1. Na tela de configuração, localize a opção para Ativar o Agendador ou Ativar Integração Automática.
  2. Marque a opção para ativá-la. Se houver a opção, você pode configurar a frequência (ex: a cada 1 hora).
  3. Salve as alterações.

3. Como Funciona no Dia a Dia

Com tudo configurado, o processo é muito simples:

  1. Você cadastra um novo produto no sistema.
  2. Ao preencher os campos, você o associa ao grupo, tipo ou categoria que definimos como gatilho (ex: Grupo "Enviar para GS1").
  3. Pronto! No próximo ciclo do agendador, o sistema enviará o produto para a GS1.
  4. Assim que a GS1 retornar o Código EAN, o sistema o salvará automaticamente no campo correspondente dentro do cadastro do produto.

 
4. Lidando com Possíveis Erros

Caso a GS1 encontre alguma inconsistência, ela retornará um erro.

  • Erros Comuns: "Descrição inválida", "Código do país inválido", entre outros.
  • O que fazer?
    1. O ideal é configurar um alerta por e-mail para ser notificado quando um erro ocorrer.
    2. No sistema, acesse a fila de processamento da integração GS1 para ver o log de erros e identificar o motivo da falha.
    3. Corrija os dados do produto diretamente no cadastro.
    4. Após a correção, coloque o produto de volta na fila para que seja enviado novamente no próximo ciclo.

 
Resumo da Implantação
  1. Reúna os Pré-requisitos: Tenha em mãos suas credenciais da GS1 e defina a regra de envio.
  2. Configure no Sistema: Insira as credenciais, defina a regra de consulta e ative o agendador.
  3. Use no Dia a Dia: Simplesmente associe os novos produtos ao grupo/categoria definido para que o processo ocorra automaticamente.
  4. Monitore os Erros: Fique de olho nos logs e alertas para garantir que todos os produtos sejam registrados corretamente.
Nenhum comentário
Voltar ao topo