Guarani B2B
Este documento tem como objetivo, descrever todo o processo de preparação e configurações necessárias para a implantação do produto Guarani B2B.
1. Configurações Integrador
1.1 Instalação do Integrador
Abra o setup de instalação do integrador e clique sobre “instalar”, depois irá para tela de carregamento da instalação e quando chegar a 100% será demonstrado a tela de instalação concluída, basta clicar em “concluir”.
Para acessar o integrador clique duas vezes sobre o ícone nomeado como “Integrador B2UB” localizado em sua área de trabalho.
1.2 Configurações
Acesse no menu superior “Configurações” (Imagem 1):
1.2.1 Configuração Geral
Nessa aba, tem-se as configurações descritas abaixo (Imagem 2):
Sincronização (Min): Valor em minutos que o sincronizador vai executar a rotina;
Envio e-mail (Min): Valor em minutos que o sincronizador enviará o e-mail de erro;
E-mail apenas erros: Informar se será ou não enviado e-mail de erro;
Banco Imagens: Banco de imagens utilizado no ERP;
Banco XML: Banco XML utilizado no ERP;
Hist. Integração: As opções são: “Completo com registros” e “Não gerar”, essas opções vão influenciar nos scripts de exportação e importação;
Web Service: URL Integração: Url do site que o integrador vai monitorar;
Token: Token gerado no “Magento” para permitir a troca de dados.
E-mail para alertas: Servidor SMTP: Servidor de transferência de correio;
Porta: Porta que será utilizada na comunicação;
Usa TLS: Este campo deve ser preenchido caso tenha algum protocolo de segurança do SMTP;
Autenticação: Caso seja utilizado o protocolo de segurança, especifique qual é neste campo;
E-mail: E-mail cadastrado para utilizar como remetente;
Usuário: Usuário do servidor de e-mail;
Senha: Senha do servidor de e-mail;
Enviar para: (separar e-mails por ;).
1.2.2 Bancos
Configure na aba “Bancos” o caminho do banco de dados que será utilizado para exportar os dados, a configuração deve ser feita nas três opções, cada uma com seu apontamento: “Banco principal”, “Banco XML” e “Banco Imagem” (Imagem 3).
Após clicar sobre alterar e em configurar, preencha as seguintes informações na aba “Definition” (Imagem 4):
Driver ID: Qual o banco que será utilizado, nesta opção clique no FB “Firebird” e será habilitado alguns campos a serem preenchidos;
Database: Deverá preenchido com o caminho para o banco do ERP;
Username: Preencha com o usuário credenciado do banco de dados;
Password: Senha utilizada para conexão com o banco de dados;
Protocol: Local para quando o integrador é instalado no servidor (mesma máquina que contém o banco de dados) ou “TCPIP” para quando o integrador é instalado fora do servidor. Será preciso habilitar a opção “TCPIP”, é necessário que os campos abaixo também sejam preenchidos:
Server: Com o IP do servidor;
Port: Com a porta utilizada para a transferência de dados caso tenha.
Realizadas as configurações, clique sobre o botão “Test”, para validá-las. Caso alguma configuração esteja incorreta, a informação será exibida conforme na imagem abaixo (Imagem 5):
Todavia, se tudo estiver correto, será conforme exemplificado na imagem abaixo. Salve para concluir essa etapa das configurações (Imagem 6).
1.3 Scripts de Exportação
No menu superior na home do integrador, na opção “Exportações”, temos os scripts de exportação de dados do ERP para o B2B.
Selecione no menu lateral o script que deseja visualizar. Altere o script se necessário, teste e caso queira desfazer as alterações, utilize o botão “Query padrão” (Imagem 7):
1.3.1 Fonte de dados
Para visualizar e alterar o script.
1.3.2 Saída de dados
Para demonstrar as informações que o botão “Testar” retornou.
1.3.3 Hist. Integração
Apresenta quando foi realizada a sincronização utilizando o script selecionado.
1.4 Scripts de Importação
No menu superior da home do integrador, na opção “Importações”, temos os scripts de importação de dados do B2B para o ERP (Imagem 8).
Assim como no processo de exportação, confira nas abas:
Fonte de dados: O script selecionado;
Saída de dados: As informações que o botão “Testar” retornou.
1.5 Agendamento de Carga
Acesse no menu superior da home a opção “Agendamento de Carga” para configurar as cargas de exportação (Imagem 9).
Scripts: Script que será executado;
Data Hora para busca da próxima integração: utilizada para especificar a data inicial para envio na carga.
Para agendar a carga, basta selecionar um ou mais scripts que deseja e depois clicar sobre o botão de “Agendar Carga”, entre com as informações solicitadas e confirme (Imagem 10):
Para realizar uma carga completa, ao invés de uma fração dela, basta clicar sobre o botão de “Carga Completa” e será aplicado uma data retroativa para que seja enviado tudo do ERP ao B2B.
1.6 Logs de Eventos
No menu superior na home, em “Log de Eventos” são exibidos os erros e informações capturadas no momento da sincronização. Após corrigir o erro, selecione o título que corrigiu e clique sobre o botão “Resolver” para retirar o erro da lista. Caso queira consultar erros já resolvidos utilize os filtros disponíveis (Imagem 11).
1.7 Status do Serviço
Esse indicador na home, sinaliza se o integrador está funcionando corretamente ou não. O “Status do Serviço” nada mais é, do que a sincronização automática. Os status possíveis são:
Executando: A sincronização automática vai rodar os scripts de exportação e importação.
Parado: A sincronização automática está parada. O serviço no Windows não esta operando.
1.8 Botão Azul (On/Off)
Continuar integração: A integração está parada, pois o botão foi ativado para parar o serviço;
Em Execução: A rotina da sincronização automática será executada conforme as configurações realizadas.
Para os clientes que possuem ERP Guarani, todas as vezes que for executar alguma manutenção no sistema pelo Agent deverá antes, clicar sobre o status do serviço e colocá-lo como parado.
1.9 Fechar
O botão “Fechar” encerra a tela do integrador, mas não a integração. A integração é um serviço que continua funcionando na barra de tarefas.
Se desejar encerrar o serviço, clique em “Status do serviço” e depois selecione a opção “Parar”.
1.10 Conclusão
Encerramos aqui as configurações necessárias no integrador para o correto funcionamento da loja B2B. Continue com as demais configurações no ERP e no Magento.
