~~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 ([[https://dl.ellotecnologia.com/DLLs/01-%20DLL%20CliSitef/clisitef-7.0.117.112.r12-Producao-Win32.7z|aqui]] ou 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). Normalmente não é necessário editar esse arquivo. A exceção é limitar as opções do menu de forma de pagamento (veja [[#limitar_as_opcoes_do_menu_de_forma_de_pagamento|Limitar as opções do menu de forma de pagamento]]).

\\
===== 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.

\\
===== Limitar as opções do menu de forma de pagamento =====

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:

  - Feche o Ello / PDV na estação.
  - Abra o arquivo ''CliSiTef.ini'' na pasta ''C:\Ello\DLLs\Clisitef''.
  - Na seção ''[Geral]'', ajuste as linhas abaixo, usando os códigos da [[#codigos|tabela de códigos]] separados por ponto e vírgula:
    * ''TransacoesHabilitadas'': o que **pode** aparecer.
    * ''TransacoesDesabilitadas'': o que deve ser **escondido**.
  - 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**:

<code>
[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
</code>

<note important>
  * **Use as duas linhas juntas.** Só a lista de desabilitadas não limpa o menu.
  * Para vender **parcelado**, os códigos **27** e **28** precisam estar na lista de habilitadas.
  * A linha ''TransacoesAdicionaisHabilitadas=7;8'' é gravada pelo próprio Ello e é ela que mantém a **Carteira Digital** (Pix pelo TEF) no menu. Não remova.
  * O parâmetro **"Permite recebimento parcelado no crédito"** (Parâmetros do Sistema → TEF) precisa estar **marcado**. Desmarcado, o CliSiTef ignora essas linhas. No PDV, envie a carga depois de alterar o parâmetro.
  * Em versões anteriores à correção do chamado 4322, o Ello apagava a linha de desabilitadas ao abrir o TEF e a configuração se perdia.
</note>

==== Códigos ====

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.

<note warning>
A página de documentação online da Fiserv com essa tabela está com os códigos deslocados em 1 a partir do código 19 (por exemplo, mostra crédito à vista como 25, mas o correto é 26). Use os códigos desta página ou do manual.
</note>

**Forma de pagamento**

^ Código ^ Opção ^
| 7 / 8 | Carteira Digital (venda / cancelamento) |
| 10 | Cheque (todos os tipos); 11 a 14 são variações de consulta de cheque |
| 16 | Débito à vista |
| 17 | Débito pré-datado |
| 18 | Débito parcelado |
| 19 | Débito CDC (também esconde a consulta de parcelas CDC) |
| 22 | Cartão Benefício |
| 24 | Crédito à vista com juros |
| 26 | Crédito à vista |
| 27 | Crédito parcelado pela loja |
| 28 | Crédito parcelado pela administradora |
| 31 | Pré-autorização |
| 32 | Cartão Fininvest |
| 45 | Private Label pré-datado |
| 47 | Private Label com cheque |

**Menu administrativo**

^ Código ^ Opção ^
| 3203 | Teste de comunicação |
| 56 | Reimpressão de comprovante |
| 40 | Cancelamento de transação |
| 3626 | Carga forçada de tabelas no pinpad (Servidor) |
| 3625 | Carga forçada de tabelas no pinpad (Local) |
| 33 / 3166 / 3167 | Consulta saque e saque Fininvest |
| 36 / 3480 | Consulta parcelas no crédito |
| 3003 | Consulta saldo débito |
| 3004 | Consulta saldo crédito |
| 4158 | Outros Cielo |

\\
===== 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]]
  * [[https://www.youtube.com/watch?v=c331rAyEWoo|Vídeo explicando como configurar]]