Resumo do que será ensinado
Este guia explica todos os requisitos de ambiente e configuração necessários para que o ConnectTEF funcione de forma estável no cliente. Você aprenderá a usar sempre o instalador atualizado, ajustar compatibilidade no Windows antigo, impedir que o Windows mate o processo em notebooks, ativar e configurar o ConnectTEF, vincular o PDV à maquininha via QR Code, configurar MAC Address, garantir que PC e POS estejam na mesma rede Wi‑Fi, evitar alternância entre Wi‑Fi e dados móveis, e tratar possíveis impactos de rede, roteadores e antivírus.
Segue um Vídeo explicativo do processo
Detalhamento do uso correto
Com este guia, você deve ser capaz de implantar e manter o ConnectTEF em funcionamento estável, minimizando problemas de comunicação entre PDV, maquininha e servidores TEF. Use este material como base para novas instalações e para revisar ambientes que já apresentam instabilidades.
Segue o detalhamento de como garantir todos os requisitos para o ConnectTEF funcionar
-
Sempre baixar o instalador atualizado no portal de documentação.
- O que fazer:
- Acesse o portal/guia oficial de documentação do fornecedor do ConnectTEF.
- Baixe o instalador mais recente diretamente desse portal.
- Por que é importante:
- Muitos técnicos guardam um instalador antigo em pendrive e o reutilizam por meses, instalando versões depreciadas.
- O portal sempre mantém a versão estável mais atual, já testada e liberada após período de validação interna.
- O que fazer:
-
Instalar o ConnectTEF no Windows.
- Passos gerais:
- Execute o instalador baixado.
- Caso o Windows exiba aviso de segurança, confirme a execução.
- Avance nas telas até concluir a instalação.
- Ponto de atenção:
- Não há “segredo” na instalação em versões atuais do Windows; siga o assistente até o fim.
- Passos gerais:
-
Ajustar compatibilidade em Windows antigos (7, XP, 32 bits).
- Quando necessário:
- Se o cliente usa Windows 7, XP ou 32 bits, pode haver falhas de compatibilidade.
- O que fazer:
- Vá até o diretório de instalação do ConnectTEF.
- Abra as propriedades do executável.
- Na aba de compatibilidade, selecione o sistema correto (ex.: marcar Windows 7).
- Motivo:
- Algumas bibliotecas internas só funcionam corretamente quando o executável está marcado com o sistema operacional adequado.
- Quando necessário:
-
Impedir que o Windows mate o processo em notebooks (Agendador de Tarefas).
- Situação:
- Em notebooks, o Windows possui políticas de economia de energia que podem encerrar processos quando está usando bateria.
- O que fazer:
- Abra o Agendador de Tarefas do Windows.
- Localize a tarefa do ConnectTEF.
- Edite as condições da tarefa:
- Desmarque “Interromper se o computador estiver usando bateria”.
- Desmarque “Iniciar a tarefa somente se o computador estiver ligado na energia elétrica”.
- Resultado:
- O Windows não interromperá o processo do ConnectTEF por causa de uso de bateria, garantindo continuidade da comunicação.
- Situação:
-
Ativar o ConnectTEF com CNPJ e código de ativação.
- O que fazer:
- Execute o ConnectTEF.
- Informe o CNPJ do cliente.
- Digite o código de ativação (modelo conhecido: baseado no 6º e 1º dígito, conforme regra fornecida pelo fornecedor).
- Ative a opção de troca de arquivos se o PDV opera via integração por arquivo.
- Ponto de atenção:
- Essa ativação é a base para que o PDV e o TEF se reconheçam.
- O que fazer:
-
Vincular o PDV à maquininha (POS) via QR Code.
- No ConnectTEF (PC):
- Gere o QR Code de vinculação na tela do ConnectTEF (opção “Vincular PDV”).
- Na maquininha:
- Acesse o menu de vinculação de PDV na própria maquininha.
- Utilize a câmera da maquininha para ler o QR Code exibido no PC.
- Resultado:
- A maquininha será vinculada ao PDV.
- Na tela do ConnectTEF, a maquininha aparecerá como uma rede/terminal ativo.
- Ponto de atenção:
- Ative o terminal (fica desativado por padrão) e, nas configurações de TEF da maquininha, desmarque “enfileirar pagamento”, se esta opção estiver marcada.
- No ConnectTEF (PC):
-
Configurar o MAC Address da maquininha no ConnectTEF.
- Por que isso é crítico:
- Sem o MAC configurado, o ConnectTEF pode não localizar corretamente o IP da maquininha, gerando perda de comunicação.
- Como obter o MAC da maquininha:
- Opção 1 – diretamente no POS:
- Acesse as configurações de Wi‑Fi na maquininha.
- Localize o campo de MAC Address (frequentemente exibido como “MAC” ou “McAddress”).
- Opção 2 – pela tabela ARP do Windows:
- No PC, abra o Prompt de Comando (CMD).
- Faça um ping para o IP atual da maquininha (ex.:
ping 192.168.x.y). - Em seguida, rode o comando de tabela ARP (ex.:
arp -a). - Identifique na lista o IP da maquininha e anote o MAC correspondente.
- Configuração no ConnectTEF:
- Na tela de conexão do terminal dentro do ConnectTEF, informe o MAC Address obtido.
- Confirme.
- Resultado:
- Com o MAC configurado, o ConnectTEF consegue varrer a rede e localizar o IP atual da maquininha, mesmo que ele mude, mantendo a comunicação estável.
- Por que isso é crítico:
-
Garantir que PC e maquininha estejam na mesma rede Wi‑Fi.
- Entendimento importante:
- Estar no mesmo roteador não garante que estejam na mesma rede lógica/frequência (2.4 GHz, 5 GHz, redes separadas).
- O que fazer no ambiente do cliente:
- Verificar quantas redes Wi‑Fi existem (SSID diferentes).
- Certificar que PC (PDV) e maquininha estejam conectados à mesma rede (mesmo SSID e mesma faixa de IP).
- No Windows, esquecer redes Wi‑Fi extras e manter apenas uma conexão estável.
- Na maquininha, também esquecer redes salvas que não serão usadas, evitando que o POS troque de rede automaticamente.
- Exemplo prático:
- Se o PC estiver na rede “Loja_2G” e a maquininha na “Loja_5G” e o roteador não permitir comunicação entre frequências, o ping falhará e o ConnectTEF não conseguirá se comunicar.
- Resultado desejado:
- Ping estável entre PC e maquininha, possibilitando que o ConnectTEF rastreie o POS independentemente de mudanças de IP.
- Entendimento importante:
-
Travamento de IP da maquininha (DHCP estático) – contingência.
- Quando usar:
- Em ambientes onde a maquininha muda frequentemente de IP, mesmo na mesma rede, causando instabilidade.
- O que fazer no POS (quando disponível):
- Acessar as configurações de rede da maquininha.
- Ativar DHCP estático ou opção equivalente.
- Informar manualmente um IP fixo (ex.:
192.168.0.27) compatível com a rede.
- Resultado:
- O IP da maquininha não muda, simplificando a configuração e a comunicação com o ConnectTEF.
- Quando usar:
-
Desativar dados móveis da maquininha (chip 3G/4G) para evitar troca de rede.
- Situação de risco:
- Algumas maquininhas vêm com chip de dados embutido.
- Se o sinal 4G está forte, o POS pode decidir usar apenas dados móveis, cortando o tráfego Wi‑Fi e quebrando a comunicação local com o ConnectTEF.
- Recomendação:
- No ambiente do cliente, desative os dados móveis da maquininha.
- Deixe apenas o Wi‑Fi ativado para comunicação local com o PDV.
- Contingência:
- Se o Wi‑Fi cair totalmente (roteador queimou, link caiu), é possível então ativar temporariamente os dados móveis, para que o terminal continue transacionando de forma online com os servidores, enquanto o PDV permanece operando offline.
- Benefício:
- Evita que a maquininha fique alternando entre Wi‑Fi e 4G, provocando quedas momentâneas de comunicação com o ConnectTEF.
- Situação de risco:
-
Entender que a operação padrão é offline/local, com internet como contingência.
- Conceito:
- O ConnectTEF e a maquininha trabalham prioritariamente em comunicação local (offline) entre PDV e POS.
- A conexão com internet (via Wi‑Fi ou chip) é usada para autorizar transações com bandeiras/adquirentes, sendo uma camada acima.
- Impacto:
- Mesmo com perdas de pacote na internet, se a comunicação local estiver correta (MAC, rede, Wi‑Fi estável), a operação tende a ser altamente disponível.
- Conceito:
-
Verificar possíveis bloqueios por antivírus/firewall ou rede corporativa.
- Situação:
- Alguns clientes usam antivírus corporativos, firewalls, redes complexas (Mikrotik, múltiplos roteadores) que podem bloquear portas ou tráfego necessário ao ConnectTEF.
- O que fazer:
- Perguntar ao cliente qual antivírus e qual infraestrutura de rede estão em uso.
- Solicitar que o time de TI do cliente libere portas/protocolos necessários ao ConnectTEF e às conexões entre PC e POS.
- Em ambientes com diversas redes e roteadores, trabalhar junto com TI para garantir que PC e POS estejam na mesma rede lógica e que o tráfego seja permitido.
- Situação:
-
Realizar testes de transação (por exemplo, PIX) após toda a configuração.
- O que fazer:
- Com ConnectTEF ativado, MAC configurado, rede estável e maquininha vinculada:
- Realizar uma simulação de venda, por exemplo, via PIX.
- Confirmar que o terminal recebe a solicitação, gera QR Code ou fluxo de pagamento, e autoriza normalmente.
- Resultado esperado:
- Transação concluída com sucesso.
- Comunicação estável, sem travamentos ou quedas no meio do processo.
- O que fazer:
-
Considerar soluções de rede auxiliares em clientes com internet muito ruim.
- Exemplo citado:
- Clientes que usam modem USB com chip de dados para distribuir Wi‑Fi para maquininhas, mesmo com alta perda de pacotes, mas operação contínua.
- Possível abordagem:
- Recomendar ao cliente equipamentos simples e de baixo custo que funcionem como ponto de acesso dedicado para as maquininhas, se a rede atual for muito instável.
- Avaliar o modelo de equipamento e se será necessário contratar plano de dados específico (chip) para esse dispositivo.
- Exemplo citado:
Informações Importantes
-
Instalador sempre atualizado: Nunca reutilize instalador antigo guardado em pendrive; baixa sempre do guia oficial.
-
Compatibilidade em Windows antigo: Ajustar o modo de compatibilidade evita falhas invisíveis em bibliotecas internas.
-
Notebook e energia: Configurar a tarefa do ConnectTEF para não ser interrompida em uso de bateria evita mortes de processo.
-
MAC e rede única: MAC configurado + PC e POS na mesma rede garantem que o ConnectTEF encontre e mantenha o terminal.
-
Wi‑Fi prioritário, dados móveis desativados: Reduz drasticamente problemas de perda de comunicação por troca de rede.
-
Rede e TI do cliente: Em redes robustas ou corporativas, é essencial envolver o time de TI para liberar tráfego e ajustar topologia.
-
Benefícios de seguir corretamente o procedimento:
- Estabilidade alta na comunicação entre PDV e maquininha.
- Redução significativa de chamados de suporte por “TEF não comunica”.
- Previsibilidade na implantação: mesmo clientes com rede ruim passam a operar de forma aceitável.
- Facilidade de diagnóstico: com ambiente padronizado, fica mais simples identificar quando o problema é de rede, equipamento ou configuração específica.