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.
2 - Integração das Notas Fiscais
O que é a integração de notas? Atualmente a rede Leo possui um processo de integração entre todas as filiais e a matriz (Leo Gestão). Neste processo, atualmente temos a sincronização de produtos da matriz para todas as filiais e a sincronização das notas das filiais para a matriz.
O ponto a ser tratado neste tópico é o segundo item, os envios das notas das filiais para a matriz.
O processo de integração das notas, consiste no envio de notas emitidas nas filiais utilizando configurações de documentos específicas, para a API disponibilizada para matriz. A parametrização das configurações de documento são feitas em uma tabela personalizada no Viasoft gerente.
O responsável pela integração é um JOB executado no servidor XE, que faz a consulta das notas emitidas que estejam marcadas como “Não sincronizadas” e faz o envio (via JSON) para a API de recebimento de notas, assim que a nota é enviada o JOB marca esta nota sincronizada.
É usado pela Leo para alimentar o BI, fazer o acompanhamento e pagamento das campanhas e a cobrança dos royalties.
Quem envia planilha atualizada das notas que precisam ser reenviadas ?
Atualmente é o Cristiano (tel. 11-9 8362 1081) e/ou o Gerson do TI, e também pode ser confirmado quem será o responsável pelo envio da planilha o Gerson (Tel 11-97623.7477)
O que deve ser feito caso seja necessário reenviar alguma nota à Léo Gestão?
Realizar conexão remota em cada filial do grupo Léo e ajuste em banco utilizando o script abaixo (script gerado por Giovani).
--select * from NOTAMCP M --Primeiro SEMPRE consultar o Resultado, comparar a quantidade de registros com a planilha e estando ok, realizar o UPDATE
--update notamcp M set M.NOTASINC = 'N'
where exists (select 0 from NOTA N
where M.ESTAB = N.ESTAB
AND M.IDNOTA = N.IDNOTA
and n. estab = 0000 --aqui você informa o número do estab o qual será feito o ajuste
and n.numdoc in ( --aqui você informa o número das notas enviadas na planilha, considerando na planilha a coluna "Nota Fiscal" 7729,7729,124629,136086));
Importante: Até o presente momento, em algumas filiais (ou mesmo em todas a depender de quando este documento estiver sendo lido) não será necessário o procedimento acima, pois está para ser desenvolvido sob a tarefa MCP-3052 uma integração com a API da Léo de modo que o reprocessamento ocorra automaticamente de forma periódica. Caso seja necessário analisar as especificações técnicas desta integração basta acessar a tarefa MCP-3052 para mais detalhes.
3 - Pentaho - Rebate
Esse processo é executado uma única vez no mês, no final do dia 10 e todas as lojas usam. Faz a apuração das COMPRAS que a loja realizou. Com base nessas informações, a Leo repassa o valor de Rebate para os lojistas.
A consulta usada para buscar as informações está na transformação do Pentaho e o envio é feito para o e-mail do José Maria.
Este processo é executado pelo Agendador de Tarefas do Windows, de modo que caso algum cliente informe algo no sentido de que não foi apurado o Rebate, verificar o log de execução deste processo dentro do Agendador de Tarefas.
4 - Pentaho - Pricefy
Esse processo faz o envio dos preços alterados na loja para o sistema Pricefy (sistema de terceiros utilizado pela Léo Gestão), que é responsável por gerar as etiquetas para os lojistas.
A consulta está na transformação do Pentaho, e o arquivo é enviado para um FTP que a Pricefy usa para consumir os arquivos.
A execução automática deste processo está configurada no Agendador de Tarefas do Windows.
5 - Pentaho - Equals
Esse processo faz o envio do movimento realizado com cartões de crédito e débito para a Equals (sistema de terceiros utilizado pela Léo Gestão), que faz a conciliação do movimento. Apenas algumas lojas utilizam esta integração.
A consulta usada para montar as informações está na transformação do Pentaho, e os arquivos são enviados para um FTP que a Equals usa para consumir os arquivos gerados.
A execução automática deste processo está configurada no Agendador de Tarefas do Windows.
6 - Pentaho - Estoque
Esse processo é executado uma vez ao dia e é responsável por enviar os dados de posição de estoque, movimento de estoque, pedidos de compra e recebimentos (que são as Notas de Entrada). Diferencia-se da Integração do LeoIntegra que trata da sincronização de Produtos, e esta integração trata de movimentações.
Todas as consultas usadas estão nas transformações do Pentaho para ter mais detalhes do que é enviado. Com base nessas consultas são montados os arquivos JSON´s que são enviados para o Barramento da Leo. A execução automática deste processo está configurada no Agendador de Tarefas do Windows.
7 - Pentaho - CorteCloud
Esse processo envia o estoque e preço dos produtos para a plataforma CorteCloud, sistema focado em gestão de marcenaria. A consulta usada para montar as informações está no Pentaho. Diferente das demais lojas que usam o Corte Cloud, para as lojas da Leo nós enviamos o código de referência ao invés do código interno. O Pentaho gera as informações e envia para a API do CorteCloud. A execução automática deste processo está configurada no Agendador de Tarefas do Windows.
8 - Pentaho - Deps
Envia os dados referente ao FINANCEIRO do cliente para fazer a avaliação do crédito do mesmo e até onde temos informação apenas a filial de Campinas está utilizando. Este processo não foi acompanhado até o final pelo Rafael Ascari na época da implantação, o Angelo pode fornecer mais informações, mas possivelmente ele gera um arquivo e envia para um FTP do Deps.