GSI

Visão Geral da Integração: illimitar e GSI

1. O que é a GS1 e o Código EAN?

A GS1 é a única empresa autorizada no Brasil a gerar os códigos EAN (ou GTIN), aquela sequência de 13 dígitos que fica abaixo do código de barras e serve como uma identidade única para cada produto no mercado.

Normalmente, quem precisa cadastrar um produto são os fabricantes. Se a sua empresa fabrica os próprios produtos, ela precisará registrá-los na GS1 para comercializá-los.

2. Como funciona a Integração Automática?

Para facilitar sua vida, nosso sistema pode se comunicar diretamente com a GS1. Desenvolvemos uma solução que automatiza o envio das informações dos seus produtos. Veja como funciona:

2.1. Obtendo suas Credenciais

Antes de tudo, você precisa ter um usuário e senha para acessar o portal da GS1.

  1. Acesse o portal GS1 Brasil.
  2. Faça o login com seu usuário e senha.
  3. No menu, vá para Minha Conta e depois em APPs.
  4. Nesta seção, você encontrará as credenciais necessárias para a integração.

2.2. O Fluxo da Automação

Nossa integração funciona como um agendador de tarefas que roda de tempos em tempos (por exemplo, de uma em uma hora) para verificar se há novos produtos a serem enviados.

O processo segue os seguintes passos:

  1. Início: O agendador de tarefas inicia o processo.
  2. Consulta de Produtos: O sistema busca por produtos que precisam de um código EAN. Essa busca pode ser configurada para selecionar produtos por tipo, categoria ou grupo.
  3. Envio para a GS1: Se encontrar produtos, o sistema os envia para a GS1 através da nossa API de integração.
  4. Recebimento do Código EAN: A GS1 processa as informações e retorna o Código EAN para cada produto.
  5. Atualização no Sistema: Nosso sistema salva automaticamente o código EAN recebido no cadastro do produto.
  6. Fim: O processo é finalizado.

3. Como Cadastrar um Produto Manualmente na GS1

Caso prefira, você também pode cadastrar seus produtos diretamente no site da GS1.

4. Lidando com Erros no Envio

Às vezes, a GS1 pode retornar erros caso alguma informação do produto esteja incorreta. Os erros mais comuns são:

Quando um erro ocorre, nosso sistema registra o motivo da falha. É importante que a sua equipe fique de olho nesses retornos para corrigir o cadastro do produto e enviá-lo novamente para a fila de processamento.

Nota: Recomendamos configurar o envio de um e-mail de alerta para a equipe responsável sempre que um erro for detectado. Assim, eles podem acessar o nosso sistema, verificar a fila de processos, identificar o erro e tomar a ação necessária.

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:

 
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.

 
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.