~~NOTOC~~
====== 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 [[tef:fiserv:msitef|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:

  - **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.
  - **Download das DLLs:** com o estabelecimento já cadastrado, o atendente de suporte deve baixar o pacote de DLLs do CliSiTef no [[https://portaldocliente.softwareexpress.com.br/Login|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:
  - **Configuração no Ello:** com as DLLs instaladas, configure o provedor dentro do Ello (veja a seção [[#configuração_no_ello|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:

<code>
C:\Ello\DLLs\Clisitef
</code>

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

<note important>
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.
</note>

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

{{:tef:fiserv:clisitef_parametros.png?600|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 =====

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

\\
===== Links =====

  * [[tef:fiserv|Fiserv]]
  * [[tef:fiserv:msitef|mSitef]]
  * [[ello_erp:modulos:tef|Página principal de TEF]]
  * [[tef:pinpad|Modelos de leitores de cartão (pinpad)]]
  * [[https://portaldocliente.softwareexpress.com.br/Login|Portal do cliente Software Express/Fiserv]]