SopagueDocs
v3

Este guia detalha o processo de instalação e configuração do Simple TEF no computador do estabelecimento.

Antes de começar

Tenha em mãos:

  • O instalador do Simple TEF (SimpleTEF-Setup).
  • O Código da empresa/loja enviado pela nossa equipe.
  • O Token/Código de ativação enviado pela nossa equipe.
  • O PIN pad conectado ao computador via USB.

1. Instalar o pacote do Simple TEF

  1. Dê dois cliques no arquivo SimpleTEF-Setup recebido.
  2. Autorize a instalação quando o Windows solicitar permissões de administrador.
  3. Mantenha marcada a opção de iniciar o PDV CliSiTef com o Windows.
  4. Conclua a instalação.

O instalador prepara automaticamente o Simple TEF, a CLI de integração (PdvCliSitef.exe), a pasta C:\PDVCliSiTef e as pastas de trabalho (C:\Client\Req, C:\Client\Resp e C:\Client\Comprovantes).

Para ambiente de homologação, utilize o instalador SimpleTEF-HMG; ele instala em C:\Program Files (x86)\SimpleTEF-HMG e utiliza a pasta C:\ProgramData\SimpleTEF-HMG.

2. Abrir o PDV CliSiTef

Após a instalação, abra a pasta C:\PDVCliSiTef e execute o arquivo PDVSiTef.exe:

C:\PDVCliSiTef\PDVSiTef.exe

Importante

O PDV CliSiTef (PDVSiTef.exe) deve permanecer executando em segundo plano durante todo o tempo de operação. O PdvCliSitef.exe é a CLI de integração chamada pelo sistema integrador a cada comando.

3. Configurar o servidor SiTef

Na tela de configuração do sistema PDV CliSiTef, preencha os seguintes campos e confirme:

CampoValor a informar
Endereço do SiTeftls-prod.fiservapp.com
Código de Empresa SiTefCódigo da empresa/loja enviado pela nossa equipe
Código de Terminal SiTefOs 6 últimos dígitos do número de série do PIN pad
Porta Serial/USB - PinpadAUTO_USB
Mensagem PadrãoMensagem que aparecerá no PIN pad enquanto estiver aguardando (ex: BOM DIA)

Atenção

O Código de Empresa é enviado pela nossa equipe. O Código de Terminal é composto obrigatoriamente pelos 6 últimos dígitos do número de série do PIN pad.

4. Configurar o operador

Abra a configuração de usuário do PDV CliSiTef e cadastre o operador utilizado no estabelecimento:

  1. Escolha a operação Inclusão.
  2. Informe o nome do operador (ex: SUPERVISOR).
  3. Defina a senha do operador.
  4. Escolha o nível adequado (ex: Supervisor) e confirme.

Configuração salva

Depois de configurar o sistema e o operador, não é necessário preencher esses dados novamente. Use a opção 9 - Encerra para fechar a janela de configuração e mantenha o PDV CliSiTef executando em segundo plano.

5. Ativar o terminal no Simple TEF

  1. Abra a aplicação Simple TEF pelo atalho criado no desktop ou menu Iniciar.
  2. Acesse a tela Ativação.
  3. No campo Número de série do PIN pad, informe o número de série completo gravado no verso do PIN pad.
  4. Cole no campo Código de ativação o token enviado pela nossa equipe.
  5. Clique em ATIVAR TERMINAL e aguarde a mensagem de confirmação.

O token ativado é salvo automaticamente no sistema. Não será necessário informá-lo novamente neste computador.

6. Confira as pastas de trabalho

No Simple TEF, acesse a aba Configurações e verifique os caminhos configurados. Em uma instalação padrão no disco C:, os caminhos devem corresponder a:

UsoCaminho padrão
RequisiçõesC:\Client\Req
RespostasC:\Client\Resp
ComprovantesC:\Client\Comprovantes
PDV CliSiTefC:\PDVCliSiTef

7. Realizar venda de teste

Para garantir que a instalação foi concluída com sucesso:

  1. Certifique-se de que o PIN pad está fisicamente conectado via USB.
  2. Confirme que o PDV CliSiTef está rodando em segundo plano.
  3. Abra o Simple TEF e navegue até a tela Venda.
  4. Insira um valor simbólico (ex: R$ 1,00) e siga as instruções exibidas no visor do PIN pad.
  5. Verifique se a transação foi aprovada e se o comprovante de teste foi exibido.

Se a venda não iniciar: feche o Simple TEF, reabra C:\PDVCliSiTef\PDVSiTef.exe, verifique a conexão USB do PIN pad e execute o comando health via CLI para diagnosticar.

Checklist final do computador

Antes de liberar o computador para o operador de caixa, certifique-se dos seguintes itens:

  • PDV CliSiTef aberto e rodando em segundo plano (PDVSiTef.exe).
  • Terminal devidamente ativado no Simple TEF.
  • Caminhos de pastas conferidos em Configurações.
  • Venda de teste realizada e aprovada com sucesso.