CONNECTTEF – INTEGRAÇÃO ELGIN (TEF ATIVO VIA DLL).

Resumo do que será ensinado

Neste documento você vai aprender, passo a passo, como integrar o ConnectTEF ao seu PDV que já utiliza o TEF Elgin via DLL (TEF ativo). Serão explicados os pré‑requisitos, o download da InterfaceConnectTEF.dll, a cópia da DLL para o Windows, o acesso ao diretório do ConnectTEF e a criação do arquivo elgin_config.txt com o nome do processo do seu PDV, finalizando com o ambiente pronto para uso.

Segue um Vídeo explicativo do processo

Detalhamento do uso correto

Com este guia, você deve ser capaz de preparar o ambiente Windows e o PDV que já usa Elgin via DLL, adicionando a interface de integração do ConnectTEF e configurando o arquivo elgin_config.txt para que o ConnectTEF reconheça o processo do PDV. Ao final, o seu sistema estará compatível com o ConnectTEF utilizando a integração via Elgin, sem necessidade de mudanças profundas no código do PDV. 

.

Segue o detalhamento de como realizar a Integração Elgin (TEF Ativo via DLL)

1. Entender o contexto e pré‑requisitos

   • Esta integração é destinada a PDVs que já utilizam o Elgin via DLL (TEF ativo). 
     TEF Ativo (DLL) | Conecte seu sistema a múltiplas adquirentes com facilidade
     .
   • O objetivo é permitir que esse PDV passe a operar com o ConnectTEF, mantendo o modelo atual de TEF ativo, apenas adicionando a interface de integração e fazendo uma pequena configuração.
   • Pré‑requisito importante:
     • O gerenciador padrão do Elgin deve estar instalado e configurado previamente.
     • Se o gerenciador ainda não estiver instalado e configurado, a configuração descrita aqui não será possível; é necessário primeiro seguir a documentação oficial de instalação do gerenciador Elgin. 
       TEF Ativo (DLL) | Conecte seu sistema a múltiplas adquirentes com facilidade
       .

   Ponto de atenção.

   • Antes de começar, confirme com a equipe técnica ou com o cliente que o TEF Elgin está funcionando normalmente (por exemplo, realizando uma transação de teste).

2. Passo 1 – Baixar a interface de integração (InterfaceConnectTEF.dll)

   • Acesse a documentação do ConnectTEF na seção Elgin – TEF Ativo (DLL).
   • Localize a tabela de downloads da InterfaceConnectTEF.dll. 
     TEF Ativo (DLL) | Conecte seu sistema a múltiplas adquirentes com facilidade
     .
   • Escolha a versão adequada para o sistema operacional/arquitetura do PDV:
     
     • InterfaceConnectTEF.dll (X64) – para sistemas 64 bits.
     • InterfaceConnectTEF.dll (X86) – para sistemas 32 bits (x86).
     • InterfaceConnectTEF.dll (Win32) – para ambientes específicos Win32 conforme indicado na doc. 
       TEF Ativo (DLL) | Conecte seu sistema a múltiplas adquirentes com facilidade
       .
   • Faça o download do arquivo correspondente e salve em uma pasta temporária (por exemplo, C:\Temp ou Downloads).

   Pontos de atenção.

   • Utilize sempre a versão da DLL adequada à arquitetura do Windows onde o PDV está instalado.
   • Se não tiver certeza da arquitetura, consulte as propriedades do sistema ou peça apoio ao time de infraestrutura.

3. Passo 2 – Copiar a DLL para o diretório do Windows

   • Após fazer o download da InterfaceConnectTEF.dll, você precisa copiá‑la para o diretório padrão do Windows: 
     TEF Ativo (DLL) | Conecte seu sistema a múltiplas adquirentes com facilidade
     .
   • Caminho de destino:
     
     • C:\Windows
   • Procedimento sugerido:
   1. Abra o Explorador de Arquivos.
   2. Navegue até a pasta onde a DLL foi baixada (por exemplo, C:\Temp).
   3. Clique com o botão direito em InterfaceConnectTEF.dll e selecione Copiar.
   4. Navegue até C:\Windows.
   5. Clique com o botão direito em uma área vazia da pasta e selecione Colar.

   Pontos de atenção.

   • Pode ser necessário executar como administrador para copiar arquivos para C:\Windows (dependendo das permissões da máquina).
   • Certifique‑se de não renomear o arquivo; ele precisa permanecer como InterfaceConnectTEF.dll.

4. Passo 3 – (Mantido pela documentação) Verificar se há outros passos prévios

   • Na página de integração Elgin, a sequência de passos é numerada; alguns passos podem ser específicos do gerenciador Elgin e já devem ter sido executados antes (instalação, configuração básica etc.). 
     TEF Ativo (DLL) | Conecte seu sistema a múltiplas adquirentes com facilidade
     .
   • Para este guia, consideramos que tudo relacionado ao gerenciador Elgin em si já foi feito e focamos apenas na parte ConnectTEF + elgin_config.txt.

   Ponto importante.

   • Caso a documentação oficial cite outros passos entre o download da DLL e o acesso ao diretório do ConnectTEF, siga‑os conforme indicado, antes de prosseguir.

5. Passo 4 – Acessar o diretório de instalação do ConnectTEF

   • Com a DLL já copiada em C:\Windows, o próximo passo é acessar o diretório onde o ConnectTEF está instalado. 
     TEF Ativo (DLL) | Conecte seu sistema a múltiplas adquirentes com facilidade
     .
   • Procedimento indicado na documentação:
   1. Vá até a Área de Trabalho do Windows.
   2. Localize o atalho do ConnectTEF (normalmente um ícone com o nome “Connect TEF”).
   3. Clique com o botão direito em cima do atalho.
   4. Selecione a opção “Abrir local do arquivo”. 
      TEF Ativo (DLL) | Conecte seu sistema a múltiplas adquirentes com facilidade
      .
   • Uma janela do Explorador será aberta, mostrando a pasta onde o ConnectTEF está instalado.

   Ponto de atenção.

   • Certifique‑se de que você está realmente no diretório de instalação do ConnectTEF e não apenas em uma pasta de atalhos. A opção “Abrir local do arquivo” leva diretamente à pasta correta.

6. Passo 5 – Criar o arquivo elgin_config.txt

   • Dentro do diretório de instalação do ConnectTEF (aberto no passo anterior), você precisa criar o arquivo de configuração específico para Elgin: 
     TEF Ativo (DLL) | Conecte seu sistema a múltiplas adquirentes com facilidade
     .
   • Nome do arquivo:
     
     • elgin_config.txt (exatamente com essa grafia).

   Procedimento para criar o arquivo.

   1. No diretório do ConnectTEF, clique com o botão direito em uma área vazia.
   2. Selecione Novo → Documento de Texto.
   3. Digite o nome do arquivo como elgin_config.txt (removendo o .txt padrão, se o Windows mostrar a extensão) e confirme.

   • Em seguida, edite o conteúdo desse arquivo: 

     TEF Ativo (DLL) | Conecte seu sistema a múltiplas adquirentes com facilidade
     .
     • Abra o arquivo elgin_config.txt com o Bloco de Notas (Notepad).
     • Adicione a seguinte linha:

     PROCESS_NAME=<nome-do-processo-do-pdv>

     • Substitua <nome-do-processo-do-pdv> pelo nome real do executável do seu PDV que já usa o Elgin.
     • Exemplo hipotético:
       
       • Se o executável do PDV é MeuPDV.exe, o conteúdo deve ficar:
         PROCESS_NAME=MeuPDV.exe.

   Pontos de atenção.

   • Use exatamente a chave PROCESS_NAME em letras maiúsculas, como indicado.
   • O valor após o sinal de igual deve ser o nome do processo do PDV (normalmente o nome do arquivo .exe), sem caminhos adicionais.
   • Salve o arquivo após editar (menu Arquivo → Salvar no Bloco de Notas).

7. Passo 6 – Entender o papel do elgin_config.txt

   • O arquivo elgin_config.txt funciona como um mapeamento entre o processo do PDV e o ConnectTEF. 
     TEF Ativo (DLL) | Conecte seu sistema a múltiplas adquirentes com facilidade
     .
   • Quando o PDV executa operações TEF via Elgin (DLL), o ConnectTEF utiliza essa configuração para reconhecer qual processo está realizando as transações e assim integrar corretamente.
   • Sem esse arquivo:
     
     • O ConnectTEF pode não reconhecer o PDV, impedindo o funcionamento adequado da integração via Elgin.

   Ponto importante.

   • Garantir que o PROCESS_NAME está correto é essencial. Se você informar um nome diferente do executável real, o ConnectTEF não conseguirá vincular o PDV.

8. Passo 7 – Validação básica da integração

   Após concluir a cópia da DLL e a criação do elgin_config.txt, faça um teste simples para validar que o PDV está compatível com o ConnectTEF via Elgin:

   • Reinicie o PDV.
   • Realize uma transação de teste (por exemplo, uma venda de baixo valor) utilizando a forma de pagamento TEF.
   • Verifique:
     
     • Se a transação é autorizada com sucesso.
     • Se não aparecem mensagens de erro relacionadas à integração ou DLL.
     • Se os dados de NSU/autorização são retornados normalmente (conforme o fluxo padrão do Elgin).

   Se algo sair errado.

   • Confirme:
     
     • Se a InterfaceConnectTEF.dll correta está em C:\Windows.
     • Se o arquivo elgin_config.txt existe no diretório do ConnectTEF.
     • Se o conteúdo de elgin_config.txt está com PROCESS_NAME correto (exatamente o nome do executável do PDV).

Informações Importantes

• Pré‑requisito:

  • O gerenciador padrão Elgin TEF ativo via DLL precisa estar instalado e configurado antes da integração com o ConnectTEF. 
    TEF Ativo (DLL) | Conecte seu sistema a múltiplas adquirentes com facilidade
    .

• Arquivos essenciais:

  • InterfaceConnectTEF.dll (versões X64, X86, Win32 – escolha conforme o ambiente). 
    TEF Ativo (DLL) | Conecte seu sistema a múltiplas adquirentes com facilidade
    .
  • elgin_config.txt (arquivo de texto no diretório do ConnectTEF com a linha PROCESS_NAME=<nome-do-processo-do-pdv>). 
    TEF Ativo (DLL) | Conecte seu sistema a múltiplas adquirentes com facilidade
    .

• Diretórios críticos:

  • Cópia da DLL:
  • C:\Windows.
  • Diretório do ConnectTEF:
  • Acessado pelo atalho na área de trabalho → “Abrir local do arquivo”. 
    TEF Ativo (DLL) | Conecte seu sistema a múltiplas adquirentes com facilidade
    .

• Função do elgin_config.txt:

  • Fazer o vínculo lógico entre o processo do PDV e o ConnectTEF, permitindo que o PDV já integrado com Elgin passe a operar com o ConnectTEF sem reescrever a aplicação. 
    TEF Ativo (DLL) | Conecte seu sistema a múltiplas adquirentes com facilidade
    .

• Resultado esperado:

  • Após seguir estes passos, o PDV já está compatível com o ConnectTEF utilizando a integração via Elgin, mantendo o fluxo de TEF ativo, mas com os benefícios de centralização e escalabilidade oferecidos pelo ConnectTEF. 
    TEF Ativo (DLL) | Conecte seu sistema a múltiplas adquirentes com facilidade
    .

• Benefícios de seguir corretamente o procedimento:

  • Aproveitar o TEF Elgin já existente, adicionando o ConnectTEF como camada de integração.
  • Evitar modificações profundas no código do PDV.
  • Garantir uma migração controlada, mantendo a experiência do operador praticamente inalterada.

Este texto está pronto para ser copiado em um documento Word da sua base de conhecimento. Aplique o padrão visual solicitado: título com fonte 34, cabeçalhos (Resumo, Vídeo, Detalhamento, Informações Importantes) com fonte 18, e o corpo em fonte menor, mantendo os pontos importantes em negrito para facilitar a leitura por usuários iniciantes.