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.