Ello - Base de Conhecimentos

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).


Implantação para um cliente novo

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 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).


Instalação

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.

Em ambiente de testes/homologação pode ser usado um pacote de simulação fornecido pela Fiserv. Em produção, é obrigatório usar o pacote homologado oficial fornecido pela Fiserv — nunca o pacote de simulação.

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). Não é necessário editar esse arquivo manualmente — o Ello já mantém essas configurações atualizadas sozinho.


Configuração no Ello

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

Parâmetros do Sistema - TEF - CliSiTef


Conexão direta via TLS

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.


O que esse provedor traz de novo

  • 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.


Transações pendentes

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.


Checklist de implantação

  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