/
Integração Leo Madeiras v2.0

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.

 

image-20241202-110412.png

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:

 

image-20241202-110613.png

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

Versão do Sistema

Versão do Banco de Dados

Versão da Documentação

Autor/Revisor

2403

2403

1.0

Cleber Vargas

 

 

 

 

 

Related content

Integração Leo Madeiras - Leo Gestão
Integração Leo Madeiras - Leo Gestão
More like this
Integrações Leo Madeiras
Integrações Leo Madeiras
More like this
Integração Leo Madeiras - Notas Fiscais
Integração Leo Madeiras - Notas Fiscais
Read with this
Vendas Web: Funcionalidades
Vendas Web: Funcionalidades
More like this
Programa de Pontos/CashBack ConstruShow
Programa de Pontos/CashBack ConstruShow
Read with this
Integração Leo Madeiras - Estoque
Integração Leo Madeiras - Estoque
More like this