Integração Leo Madeiras - Leo Gestão
- Josimar Mattos Da Silva
INTEGRAÇÃO LÉO GESTÃO/CONSTRUSHOW
As filiais do Grupo Léo (Bonforte, Ipê Madeiras, Loja do Marceneiro, dentre outras) possuem diversas integrações com a Léo Gestão, que basicamente cuida do gerenciamento de todas as filiais do grupo Léo, incluindo filiais que não utilizam o Construshow e que não são clientes da Viasoft, e sim filiais que usam o sistema SAP. Alguns dados (como por exemplo, Produtos que são vendidos ao consumidor final das filiais do grupo) são totalmente gerenciados pela Léo Gestão através do sistema SAP, que envia as informações destes produtos através de um arquivo de email, o qual nosso integrador (LeoInteg) faz a leitura e sincroniza estes cadastros em nosso banco de dados Oracle.
O objetivo deste manual é documentar gradativamente as diversas integrações que hoje existem da maneira mais detalhada possível, para que o suporte possa conduzir o atendimento, entender o processo e se necessário, acionar a equipe de análise em situações pontuais. Será destacado em vermelho situações de erro ou inconsistência que podem ocorrer, ou mesmo de erros que já foram completamente corrigidos numa filial específica, que utiliza um processo mais específico, e que podem ser úteis caso ocorram no futuro em outra filial.
1 - Executável LeoIntegra ou LeoInteg
Objetivo:
Esse tópico tem por objetivo auxiliar o suporte do Construshow a efetuar a sincronização de Produtos e documentar soluções de ocorrências e erros nas filiais que tem relação com esta integração. Todos os dias o SAP envia os arquivos com PRODUTOS e FORNECEDORES novos e alterados para uma conta de e-mail.
Ícone Executável LeoIntegra
Este executável faz a leitura dos e-mails, recebe os arquivos e importam para as tabelas LEO_ITEM e LEO_FORN. Estas tabelas possuem triggers que gravam os dados nas nossas tabelas.
Geralmente as lojas importam somente os produtos. Os fornecedores eles não importam, pois tem muitos fornecedores que são cadastrados no SAP e não fazem sentido nenhum para eles.
Caso precise verificar alguma configuração existe um arquivo INI que é usado para fazer a configuração do caminho do banco de dados e outros parâmetros, a sincronização é efetuada automaticamente pelo Agendador de Tarefas do Windows.
Abaixo, temos uma consulta SQL que demonstra quais tabelas estão relacionadas ao código de referência, caso seja necessário alguma consulta avançada.
SELECT ITEM.IDITEM, LEO_ITEM.IDITEMVIA, ITEMEMP.IDITEM, ITEMEMP.CODREF, LEO_ITEM.IDITEMLEO
FROM ITEM
INNER JOIN ITEMEMP
ON ITEMEMP.IDITEM = ITEM.IDITEM
INNER JOIN LEO_ITEM
ON LEO_ITEM.IDITEMVIA = ITEMEMP.IDITEM
WHERE ITEMEMP.CODREF is null
AND LEO_ITEM.IDITEMLEO = ;
Passo a passo caso não sincronize os produtos (Verificação Inicial)
1º Acessando o Servidor:
Solicitar acesso ao Supervisor ou ao T.I da empresa.
Fica localizado na área de trabalho (desktop) ou na unidade local onde está localizada a instalação geralmente fica em C:\Viasoft\LeoInteg.exe
Executável LeoInteg.exe - todas as lojas usam:
Filtrando arquivos
Dentro do diretório do integrador existe uma pasta chamada nproc (Arquivos não processados), filtrar os arquivos TXT com a palavra FORNECEDOR e mover para uma outra pasta mantendo somente os arquivos MATERIAL.TXT
3º Executando o integrador (sincronizador)
Ao executar o integrador (sincronizador) irá selecionar SOMENTE a opção Material e sincronizar tudo:
Caso retorne com a mensagem “Importação do Arquivo xxxxx-Material. TXT finalizada” a importação teve sucesso:
A seguir, será demonstrado mensagens de erro que podem aparecer ao realizar a sincronização e como tratar estes erros específicos
Erro: List index out of bounds (imagem abaixo)
Verificar o arquivo em que ocorreu o erro (quadro da esquerda) e verificar a linha em que ocorreu o erro (quadro da direita):
Para correção desse erro terá que localizar o arquivo dentro da pasta nproc de acordo com o nome listado onde apresentou o erro como exemplo abaixo:
OBS: caso o arquivo não esteja dentro da pasta nproc, terá que verificar na pasta proc, possivelmente o arquivo foi movido devido a leitura e processamento do mesmo, exemplo abaixo:
após localizar o arquivo, clicar com o botão direito em cima e abrir com o bloco de notas (NOTEPAD++), o erro é devido a quebra de linha onde terá que localizar a linha e corrigir apagando o intervalo:
para verificar se os itens sincronizaram dá pra usar o MIX de produtos ou o select abaixo digitando os códigos de referência do produto:
SELECT * FROM ITEMEMP WHERE CODREF= ‘XXXX ’
Erro na trigger: VIASOFTMCP.LEO_ITEM_ITEG
Cenário: Em algumas filiais do grupo Léo existe a necessidade de alterar/trocar a trigger retornada no erro, pois basicamente o erro tem relação com a forma como o sistema trata valores inteiros de alguns códigos de referência em específico que são integrados dentro do banco do Construshow.
Observe que no exemplo do print acima, ele inclusive mostra a linha (line) o qual o banco tratou o erro (104). Abaixo, print de como estava antes a consulta e como ficou depois da troca, no cliente da filial 2400 - Bonforte, no ticket 205797
Tratativa: Neste caso, basta substituir a consulta LEO_ITEM_INTEG. Pode ser usado como base a consulta já existente na filial 7212 - Ipê Madeiras.