CliSiTef

CliSiTef é a solução de TEF (Transferência Eletrônica de Fundos) da Fiserv para computadores, continuação da SiTef da Software Express. É usada quando o TEF roda na Retaguarda ou no PDV com um pinpad conectado ao computador (diferente do mSitef, que roda direto na maquininha).

Siga esta ordem para colocar o CliSiTef funcionando em um cliente que ainda não usa esse provedor:

1. Cadastro do estabelecimento na Fiserv: entre em contato com Nildo (Edenildo Bonifácio), responsável pelo cadastro de novos estabelecimentos na plataforma da Fiserv. Ele vai pedir os dados do estabelecimento e, depois de cadastrar, vai fornecer o Código da Loja e o Token de Registro usados na configuração do Ello.
2. Download das DLLs: com o estabelecimento já cadastrado, o atendente de suporte deve baixar o pacote de DLLs do CliSiTef (aqui ou no portal do cliente Software Express/Fiserv) e colocar os arquivos na pasta C:\Ello\DLLs\Clisitef, na estação de trabalho que vai operar o TEF:
3. Configuração no Ello: com as DLLs instaladas, configure o provedor dentro do Ello (veja a seção Configuração no Ello abaixo).

Antes de configurar o CliSiTef no Ello, é necessário instalar o pacote de DLLs da Fiserv para Windows (versão 32 bits, completa) na estação de trabalho que vai operar o TEF, na pasta:

C:\Ello\DLLs\Clisitef

Se esse pacote não estiver instalado corretamente nessa pasta, o TEF via CliSiTef não funciona.

O sistema cria e mantém automaticamente, dentro dessa mesma pasta, um arquivo de configuração do CliSiTef usado internamente pelo próprio pacote da Fiserv (habilita Pix/carteira digital, trace e a porta do pinpad). Normalmente não é necessário editar esse arquivo. A exceção é limitar as opções do menu de forma de pagamento (veja Limitar as opções do menu de forma de pagamento).

Dentro do Ello, acesse Parâmetros do Sistema → TEF, selecione o provedor CliSiTef e informe:

• Servidor SiTef
• Código da loja (fornecido pelo Nildo no cadastro do estabelecimento)
• Número do terminal
• Porta do pinpad

Além do modo tradicional (SiTef local), o CliSiTef também suporta uma conexão direta e segura (TLS) com a Fiserv, sem precisar de um servidor SiTef local. Para usar esse modo, na mesma tela de parâmetros:

• Marque a opção “Habilita Comunicação TLS Fiserv”;
• Informe no campo “Token Registro” o token fornecido pelo Nildo junto com o Código da Loja;
• A configuração de um servidor proxy é opcional.

Ao usar o modo TLS, é preciso garantir que a estação de trabalho tenha acesso liberado à internet para o endereço da Fiserv usado nesse tipo de conexão. Se a rede do cliente bloquear esse acesso (por firewall ou proxy restritivo), a comunicação com o TEF falha.

• Pagamento e cancelamento de vendas por Pix e carteira digital diretamente pelo TEF.
• Quando uma venda é paga usando mais de um cartão, o sistema agora usa um único comprovante fiscal para todos os pagamentos dessa venda, em vez de gerar comprovantes separados.
• Novo menu de funções administrativas do TEF, reunindo as opções de gerenciamento em um único lugar.
• A senha de supervisor deixou de aparecer visível na tela durante sua digitação.
• Correções no fluxo de cancelamento de pagamentos, garantindo que o valor e a confirmação do cancelamento estejam sempre corretos.
• Os parâmetros de TEF continuam disponíveis para configuração mesmo que o pacote do CliSiTef ainda não tenha sido instalado na estação — permitindo preparar a configuração antes de finalizar a instalação.

Quando a finalizadora de TEF não define se o pagamento é débito ou crédito, o CliSiTef mostra a tela “Selecione a forma de pagamento” com todas as opções liberadas pela Fiserv (Cheque, Private Label, Pré-autorização etc.). O menu administrativo do TEF também traz várias consultas que o cliente normalmente não usa. Para mostrar ao operador só o que o cliente usa:

1. Feche o Ello / PDV na estação.
2. Abra o arquivo CliSiTef.ini na pasta C:\Ello\DLLs\Clisitef.
3. Na seção [Geral], ajuste as linhas abaixo, usando os códigos da tabela de códigos separados por ponto e vírgula:
   • TransacoesHabilitadas: o que pode aparecer.
   • TransacoesDesabilitadas: o que deve ser escondido.
4. Salve, abra o Ello / PDV e confira os dois menus: o de forma de pagamento (numa venda com a finalizadora de TEF) e o administrativo.

Exemplo validado: forma de pagamento só com Débito, Crédito (à vista e parcelado) e Carteira Digital; menu administrativo só com Teste de comunicação, Reimpressão de comprovante, Cancelamento de transação e Carga forçada de tabelas no pinpad:

[Geral]
TransacoesAdicionaisHabilitadas=7;8;4178
TransacoesHabilitadas=16;26;27;28;3203;56;40;3626
TransacoesDesabilitadas=10;11;12;13;14;17;18;19;22;31;32;33;36;45;47;3003;3004;3166;3167;3480;4158

Códigos mais usados, conforme o manual da Fiserv “SiTef - Interface Simplificada com a aplicação” (versão 248, item 6.6). Para outro item que não esteja aqui, consulte o manual ou peça o código à Fiserv.

Forma de pagamento

Menu administrativo

Caso uma transação de uma venda anterior fique pendente (por exemplo, após uma queda de conexão ou fechamento inesperado), o sistema agora identifica essa pendência sozinho na venda seguinte e decide automaticamente se deve confirmar ou desfazer essa transação, avisando o operador sobre o que foi feito. Não é mais necessário que o operador ou o suporte resolvam isso manualmente.

1. [ ] Contatar o Nildo (Edenildo Bonifácio) para cadastrar o estabelecimento na Fiserv e obter Código da Loja e Token de Registro
2. [ ] Baixar o pacote completo de DLLs do CliSiTef (32 bits) no portal do cliente e instalar na estação
3. [ ] Confirmar que o pacote instalado é o homologado pela Fiserv (não a versão de simulação) antes de ir para produção
4. [ ] Configurar loja, terminal, pinpad e servidor (ou conexão TLS com o token) nos parâmetros de TEF do Ello
5. [ ] Validar uma venda e um cancelamento em débito e em crédito
6. [ ] Validar uma venda com Pix, seu cancelamento e uma venda paga com múltiplos cartões
7. [ ] Validar o registro do terminal e, se aplicável, a conexão TLS

• Fiserv
• mSitef
• Página principal de TEF
• Modelos de leitores de cartão (pinpad)
• Portal do cliente Software Express/Fiserv
• Vídeo explicando como configurar