Integração Leo Madeiras v2.0
Descrição
A integração entre o Construshow e a Rede Leo tem como objetivo disponibilizar, de forma ágil e eficiente, informações essenciais sobre as vendas realizadas pelos parceiros da Rede Leo. Essa integração abrange dados como vendas, clientes, estoque e movimentações, garantindo o envio contínuo e automatizado dessas informações para a API da Leo. Dessa forma, as informações ficam sempre atualizadas e prontamente acessíveis, proporcionando maior controle e transparência no processo.
Atualmente as integrações existentes na versão v2.0 são:
Envio de Notas
Envio de Clientes
Envio de Movimento de Saldo
Envio de Saldo Consolidado
Dados referente aos EndPoints da API podem ser consultados no link: https://leo-madeiras.gitbook.io/leo-viasoft/integracao-construshow-viasoft/detalhamento-api-prd
Índice
Pré-Requisitos
Servidor ViasoftServerConstruShowJob estar rodando
Configurações - Parâmetros
O primeiro passo para realizar as configurações necessárias para o envio é definir os parâmetros da integração, isso pode ser acessado através do menu Processos>>Integração/Exportação>>Integração Leo.
Nesta tela você terá duas abas a “Sincronização - Notas” e a “Parâmetros”. Vamos inicialmente focar na aba de “Parâmetros”, nela você terá algumas informações importantes para definir, assim a integração funcionará corretamente.
Ao abrir a aba será apresentado as seguintes opções:
Abaixo uma descrição detalhada de cada opção da tela:
Usa Integra Leo: → Configuração para definir se a empresa utiliza a integração com a Leo Gestão
URL: → Aqui é o endereço utilizado para conexão com a API, abaixo a URL de Produção:
Usuário → Usuário que deve ser utilizado para autenticação na API, utilizar o usuário padrão:
viasoft
Senha → viasoft2024@;
Tipo de Saldo → Tipo de Saldo do estoque para considerar no saldo a ser enviado do produto;
Tipo de Saldo Empenhado → Tipo de saldo do estoque que é considerado empenhado, ou seja, esse saldo será descontado do saldo enviado pois já é considerado como “Reservado”, caso não queria considerar o saldo empenhado é só deixar em branco o campo;
Conf. Documento → Lista de configurações de documento definidos que devem integrar com a API, aqui além de informar a configuração de documento, é importante ressaltar que só é enviado documentos cuja configuração “Considera Média de Vendas” esteja como “Sim”, está última é definida dentro da configuração de documento;
Conf. Documento Boni → Configuração de documento considerado como bonificação, este documento irá da mesma forma na integração, a única diferença é que no campo “TipoNotaFiscal” na integração irá com a descrição de “Resgate”;
Configuração Estabelecimentos → Esse grid serve para o usuário informar quais estabelecimentos fazem parte da integração onde:
Estabelecimento → Código do estabelecimento
Sincroniza → Campo para definir se o estabelecimento sincroniza ou não, para sincronizar deve estar marcado
Estab Depara → Campo para depara de estabelecimento, usado em situações em que a venda é feita por um estabelecimento mas deseja que o código saia por outro para a integração. Caso não seja usado informar o mesmo código do próprio estabelecimento
Matriz → Campo para definir qual é o estabelecimento considerado como matriz
Ao preencher as informações as configurações básicas para a integração já estarão prontas, basta salvar o cadastro e seguir para a agenda da tarefa.
Configurações - Agendamento
A integração funciona através de agendamento, ou seja, deve ser parametrizado a periodicidade de envio de cada informação, isso pode ser feito através do menu Cadastros>>Agendador de Tarefas:
Dentro do menu na opção “Status” pode ser analisado todos os serviços já cadastrados e agendados, basta clicar no botão atualizar:
Para realizar novos agendamentos basta ir na opção “Agendamento” que terá a listagem de todos os serviços disponíveis:
As integrações com a Leo novas são as com fina V2 ou seja, temos disponíveis a:
NotaLeoV2
ClienteLeoV2
EstoqueLeoV2
MovimentacoesLeoV2
Para parametrizar a periodicidade basta dar um duplo clique na tarefa desejada e parametrizar a periodicidade de intervalo. Também é importante deixar o campo “Inativo” desmarcado:
Após parametrizar as informações de periodicidade basta salvar o cadastro do agendamento. É importante respeitar a periodicidade padrão definida em conjunto com a rede, sendo:
Envio de Notas (NotaLeoV2) - Enviar em intervalos de 15 minutos
Envio de Clientes (ClienteLeoV2) - Enviar em intervalos de 120 minutos (lembrando que ao enviar as vendas antes é enviado os clientes das vendas pendentes para garantir seu cadastro
Envio de Saldos (EstoqueLeoV2) - Enviar uma vez ao dia às 21:30
Envio de Movimentações (MovimentacoesLeoV2) - Enviar uma vez ao dia às 21:30
Acompanhamento - Notas
Foi criado também no menu da integração uma aba para o acompanhamento do status de envio de cada nota na integração. A tela está no menu Processos>>Integração/Exportação>>Integração Leo, na aba “Sincronização - Notas”.
Nessa tela o usuário pode fazer a filtragem por estabelecimento e período e avaliar no grid quais notas integraram ou não.
Atualmente contamos com 3 situações
Enviado → Significa que a nota foi entregue ao destino na integração
Pendente → Significa que a nota está pendente de integração
Erro no Envio → Significa que a nota foi enviada porém houve algum erro na integração, na coluna “Retorno Leo” pode ser verificado o motivo da recusa. Quando estiver em branco pode ser alguma questão de TimeOut
A notas que estão como Pendentes serão enviadas de maneira automática pelo serviço agendado, já as notas com erro, devem ser verificadas e reenviadas para que fiquem pendentes e na fila de envio novamente
Para isso basta selecionar o checkbox do grid e selecionar o botão “Reenviar”, a mesma mudará o status para pendente:
Dicionário de Dados
Dicionário do Banco de Dados
Caso tenha interesse em saber os campos do banco de dados que se relacionam a cada campo do sistema, sugerimos a leitura do artigo a seguir: https://nimitz.atlassian.net/l/c/NDGXWDD6
Erros Comuns
Situação está como “Erro no Envio” mas não tem retorno, pode ser falha na conexão ou timeout da requisição. Marcar a nota e reenviar
Versão
Versão do Sistema | Versão do Banco de Dados | Versão da Documentação | Autor/Revisor |
---|---|---|---|
2403 | 2403 | 1.0 | Cleber Vargas |
|
|
|
|