Guia rápido e passo a passo para instalar, configurar, ativar e realizar a primeira venda com o Simple TEF, além do manual completo de integração por CLI.

Resumo do Processo

1. Instalar o pacote do Simple TEF.
2. Abrir o PDV CliSiTef em C:\PDVCliSiTef.
3. Configurar o servidor SiTef e o operador.
4. Ativar o terminal pelo Simple TEF com o número de série do PIN pad.
5. Conferir as pastas na tela Configurações.
6. Realizar uma venda de teste.
7. Integrar seu sistema chamando PdvCliSitef.exe. Caso o arquivo .exe não esteja aparecendo dessa forma: verifique se o tipo do arquivo está como Aplicativo nas propriedades do arquivo.

1. Instale o Simple TEF

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

2. Abra o PDV CliSiTef

Abra a pasta abaixo e execute o arquivo PDVSiTef.exe:

C:\PDVCliSiTef\PDVSiTef.exe

3. Configure o servidor SiTef

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

4. Configure o operador

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

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

5. Ative o terminal no Simple TEF

1. Abra o Simple TEF pelo atalho criado na instalação.
2. Entre na tela Ativação.
3. No campo Número de série do PIN pad, informe o número de série completo.
4. Cole no campo Código de ativação o token enviado pela nossa equipe.

6. Confira as pastas

No Simple TEF, abra Configurações. Em uma instalação padrão no disco C:, os caminhos devem ser:

7. Faça uma venda de teste

1. Confirme que o PIN pad está conectado.
2. Confirme que o PDV CliSiTef está executando em segundo plano.
3. Abra o Simple TEF e entre na tela Venda.
4. Informe um valor pequeno e siga as mensagens do PIN pad.
5. Confira se a venda foi aprovada e se o comprovante foi apresentado.

Checklist antes de liberar o computador

• PDV CliSiTef aberto em segundo plano.
• Terminal ativado.
• Pastas conferidas.
• Venda de teste concluída.

8. Integração por CLI

Para integrar seu PDV, ERP ou outro sistema, execute PdvCliSitef.exe na pasta em que o Simple TEF foi instalado. A cada operação, envie um comando e leia o JSON devolvido.

8.1 Caminhos

8.2 Formato da chamada

PdvCliSitef.exe <comando> [parâmetros]

Valores: O parâmetro --valor sempre recebe centavos inteiros. Exemplo: 1500 representa R$ 15,00.

"TOKEN_RECEBIDO" | PdvCliSitef.exe ativacao --serial-number 7500032412001566 --activation-code-stdin

8.3 Comandos disponíveis

8.4 Exemplos de requisição

Venda no débito de R$ 15,00

PdvCliSitef.exe venda --valor 1500 --tipo debito

Venda no crédito em 3 parcelas de R$ 300,00

PdvCliSitef.exe venda --valor 30000 --tipo credito --parcelas 3

PIX de R$ 50,00

PdvCliSitef.exe pix --valor 5000

Cancelar venda de cartão

PdvCliSitef.exe cancelamento --valor 1500 --nsu-sitef 123456789

Desativar e desvincular a instalação atual

PdvCliSitef.exe desativacao

Verificar o terminal

PdvCliSitef.exe health

8.5 Resposta da CLI

A resposta final é escrita em JSON no stdout. Mensagens de acompanhamento são escritas no stderr. O sistema integrador deve usar o JSON e o código de saída para decidir o resultado.

{
  "status": "aprovada",
  "codigoSaida": 0,
  "valorCentavos": 1500,
  "mensagemOperador": "TRANSAÇÃO APROVADA",
  "nsuSitef": "123456789",
  "nsuHost": "987654321",
  "linhasCupom": ["VIA ESTABELECIMENTO"],
  "codigoQrCode": null,
  "caminhoPdfComprovante": null,
  "erro": null
}

Campos mais usados da resposta

Códigos de saída

Gravar a resposta em arquivo

Use --output quando quiser que a CLI também grave o JSON em um arquivo:

PdvCliSitef.exe venda --valor 1500 --output C:\PDV\resultado.json

9. Suporte rápido