Verifique a versão mais recente na página: Novidades - Integração Linx ERP e conciliador de cartões Equals

Baixe os arquivos conforme abaixo:

arq zip

  1. Instalação do pacote

Para a instalação, os serviços abaixo não devem estar instalados: Linx.ERP.Equals.Services e Linx.Erp.Receptor.Api

Caso existam, então devem ser desinstalados.

Acesse o painel de controle → Desinstalar um programa:

painel de controle - serviços


2.  Instalador do Windows Service da API Receptor


  • Acessar os arquivos do pacote baixado.
  • Descompacte o arquivo: Receptor
  • Com o instalador em mãos, abra o artefato, e instale o arquivo de extensão: .Install:
    installmsi
  • Nesta página, click em Avançar:


  • Há um local padrão de instalação, mas você pode alterar ou manter o local sugerido.

É interessante marcar a opção todos, devidos mais usuários administradores poderem subir o serviço.

  • Click em Avançar.
  • Confirme a instalação clicando em Avançar.



  • A janela a seguir será aberta:


   



  • Nesta etapa, informe os campos abaixo para a configuração da API Receptor:
    • Servidor: O servidor de banco de dados
    • Usuário: Usuário de Banco de dados
    • Senha: Senha do User de banco de dados
    • Banco: Nome do banco a ser utilizado
    • TimeOut (ms): Timeout em microssegundos. Temos um valor sugerido, mas o cliente pode alterar.
    • Provider: Só aceitam os valores PRD ou DEV.
    • Token Equals: Inserir o token completo fornecido pelo time Equals.
    • Url da Api: Endereço da api de cadastro de lote a ser inserido no ERP. Temos um valor sugerido, mas o cliente pode alterar conforme sua rede.


  • OBS: Se marcarmos o CheckBox: Trusted_Connection, a conexão com o banco será dada com o user do servidor, bloqueando os campos usuário e senha.
  • OBS: Se marcarmos o CheckBox: Trusted_Instalar com o usuário de serviço, ao salvar a instalação, uma tela pedindo usuário e senha de serviço será exibida e os dados serão solicitados.




  • Botões de ação:
    • Testar conexão: Testa a conexão configurada antes de salvar.
    • Salvar: Salva e finaliza a instalação.


  • Certifique que a API está em execução:


  • Será apresentado no menu iniciar a instalação, é possível alterar o formulário executando o aplicativo abaixo:


1.2      Instalador do Windows Service do Equals Services


  • Acesso os arquivos do pacote que foi baixado.
  • Descompacte o arquivo:
  • Com o instalador em mãos, abra o artefato, e instale o arquivo de extensão: .Install:

  • Nesta página, click em Avançar:


  • Há um local padrão de instalação, mas você pode alterar ou manter o local sugerido.
  • É interessante marcar a opção todos, devidos mais usuários administradores poderem subir o serviço.
  • Click em Avançar.


  • Confirme a instalação clicando em Avançar.

  • A janela a seguir será aberta:

 


  • Nesta etapa, informe os campos abaixo para a configuração da API Services:
    • Servidor: O servidor de banco de dados
    • Usuário: Usuário de Banco de dados
    • Senha: Senha do User de banco de dados
    • Banco: Nome do banco a ser utilizado
    • TimeOut (ms): Timeout em microssegundos. Temos um valor sugerido, mas o cliente pode alterar.
    • Provider: Só aceitam os valores PRD ou DEV.
    • Token Equals: Inserir o token completo fornecido pelo time Equals.
    • Pasta Json’s: Local para salvar os arquivos json’s com as vendas extraídas da base. Temos um local indicado, mas o cliente pode alterar.
    • Pasta Expurgo: Local para salvar o histórico após os dias totais extraídos. Temos um local indicado, mas o cliente pode alterar. Neste diretório, uma vez movida o histórico de extração ele é mantido por mais 60 dias até sua exclusão completa.
    • Dias totais: Total de dias incluindo histórico para envio à Equals, deixamos padrão 1 ano (365 dias) mas o cliente pode alterar.
    • Intervalo de tempo para envio das transações para a API Equals( Milissegundos): Este parâmetro define o intervalo de tempo entre o envio das transações de venda via API. Ele é configurado em milissegundos e tem como objetivo evitar sobrecarga no sistema e garantir que as requisições sejam processadas de maneira eficiente. Ajustar este intervalo pode ajudar a otimizar o desempenho e a estabilidade da integração.
    • Total de Tentativas para Busca de Relatório na Equals: Este parâmetro especifica a quantidade de tentativas para busca do relatório com as transações Equals. Caso a primeira tentativa falhe, o sistema continuará tentando até atingir o número total de tentativas configurado. Isso garante que o relatório seja enviado com sucesso, mesmo em situações de instabilidade temporária na comunicação.
      Serão enviados, apenas cabeçalhos com ID_GERACAO da Equals para evitar envio de sujeira, e bloqueio de usuário. 


  • OBS: Se marcarmos o CheckBox: Trusted_Connection, a conexão com o banco será dada com o user do servidor, bloqueando os campos usuário e senha.
  • OBS: Se marcarmos o CheckBox: Trusted_Instalar com o usuário de serviço, ao salvar a instalação, uma tela pedindo usuário e senha de serviço será exibida e os dados serão solicitados


  • Botões de ação:
    • Testar conexão: Testa a conexão configurada antes de salvar.
    • Salvar: Salva e finaliza a instalação.


  • Certifique que a API está em execução:



  • Será apresentado no menu iniciar a instalação, é possível alterar o formulário executando o aplicativo abaixo:


  • Sem rótulos