# Configuração do CTFClient Portable e Auttar no PDV

Esta seção descreve o processo técnico para preparar o ambiente e configurar a integração de TEF (Transferência Eletrônica de Fundos) utilizando a biblioteca Auttar no sistema PDV.

##### 1. Preparação dos Arquivos no Windows

<span data-path-to-node="6,1"><span class="citation-56">O primeiro passo é garantir que os arquivos estejam no local correto para que o sistema consiga encontrá-los.</span></span>

- <span data-path-to-node="6,1"><span class="citation-56">Baixe o pacote obrigatório: `ctfclient-4.32.2-0-windows-portable-x64.zip`.</span></span>
- Descompacte o conteúdo e mova as pastas para a raiz do seu **Disco Local (C:)**.
- Certifique-se de que a estrutura de pastas ficou exatamente assim:
    
    
    - `C:\CTFClient\bin`
    - `C:\CTFClient\lib`
    - `C:\CTFClient\JRE`
    - `C:\CTFClient\include`

[![image.png](https://kb.illimitar.pro/uploads/images/gallery/2026-04/scaled-1680-/paZimage.png)](https://kb.illimitar.pro/uploads/images/gallery/2026-04/paZimage.png)

---

##### 2. Ajuste dos Parâmetros de Integração

<span data-path-to-node="9,1"><span class="citation-55">Agora, vamos "ensinar" o comunicador como ele deve trabalhar.</span></span>

- Acesse a pasta `C:\CTFClient\bin`.
- Localize e abra o arquivo **configCTFClient** (ele é um arquivo do tipo XML).
- Dentro do arquivo, localize e ajuste as seguintes linhas para que fiquem exatamente assim:
    
    
    - `<Parameter name="tipointegracao">dll</Parameter>`: Verifique se o valor entre as tags é **dll**.

[![image 24.png](https://kb.illimitar.pro/uploads/images/gallery/2026-04/scaled-1680-/image-24.png)](https://kb.illimitar.pro/uploads/images/gallery/2026-04/image-24.png)

- - `<Parameter name="suporteHttps">false</Parameter>`: Se estiver como *false*, apague e escreva **true**.

[![image 25.png](https://kb.illimitar.pro/uploads/images/gallery/2026-04/scaled-1680-/vkeimage-25.png)](https://kb.illimitar.pro/uploads/images/gallery/2026-04/vkeimage-25.png)

---

##### 3. Configuração das Variáveis de Ambiente

<span data-path-to-node="12,1"><span class="citation-54">Para que o Windows reconheça o CTFClient em qualquer lugar, precisamos cadastrá-lo nas variáveis do sistema.</span></span>

- No menu Iniciar do Windows, pesquise por **Editar as variáveis de ambiente do sistema**.

[![image.png](https://kb.illimitar.pro/uploads/images/gallery/2026-04/scaled-1680-/L0Fimage.png)](https://kb.illimitar.pro/uploads/images/gallery/2026-04/L0Fimage.png)

- Na tela que abrir, clique no botão **Variáveis de Ambiente**.

[![image 26.png](https://kb.illimitar.pro/uploads/images/gallery/2026-04/scaled-1680-/image-26.png)](https://kb.illimitar.pro/uploads/images/gallery/2026-04/image-26.png)

- A variável de ambiente CTFCLIENT\_HOME deverá ser definida pela AC, indicando onde o CTFClient foi instalado.
- No quadro **Variáveis do Sistema**, clique em **Novo** e adicione:
    
    
    - **Nome da variável:** `CTFCLIENT_HOME` | **Valor da variável:** `C:\CTFClient`, clique em **OK**.

[![image.png](https://kb.illimitar.pro/uploads/images/gallery/2026-04/scaled-1680-/s9Cimage.png)](https://kb.illimitar.pro/uploads/images/gallery/2026-04/s9Cimage.png)

- A execução do CTFClient depende da configuração de uma JRE na máquina, e para isso deve ser criada a variável de ambiente JAVA\_HOME, e que seu valor seja igual abaixo.
- Clique em **Novo** novamente e adicione:
    
    
    - **Nome da variável:** `JAVA_HOME` | **Valor da variável:** `C:\CTFClient`, clique em **OK**.

[![image.png](https://kb.illimitar.pro/uploads/images/gallery/2026-04/scaled-1680-/owbimage.png)](https://kb.illimitar.pro/uploads/images/gallery/2026-04/owbimage.png)

- Clique em **OK** em todas as janelas para salvar.

---

##### 4. Configuração Final no PDV

<span data-path-to-node="15,1"><span class="citation-53 interactive-span-hovered">Com o ambiente pronto, vamos ativar o módulo dentro do sistema de vendas.</span></span>

- Abra o seu **Navegador PDV** e<span data-path-to-node="16,1,0,1"><span class="citation-52"> vá em </span>**<span class="citation-52">Configurações</span>**<span class="citation-52">.</span></span>

[![image.png](https://kb.illimitar.pro/uploads/images/gallery/2026-04/scaled-1680-/RIXimage.png)](https://kb.illimitar.pro/uploads/images/gallery/2026-04/RIXimage.png)

- No menu lateral, clique em **Geral**, desça até a opção **TEF** e selecione **Auttar**.

[![image.png](https://kb.illimitar.pro/uploads/images/gallery/2026-04/scaled-1680-/HVKimage.png)](https://kb.illimitar.pro/uploads/images/gallery/2026-04/HVKimage.png)

- No menu lateral vá em **Avançado** e desça até encontrar a opção "**Configuração Avançada do Auttar**" e selecione a dll que esta dentro da pasta bin.

[![image.png](https://kb.illimitar.pro/uploads/images/gallery/2026-04/scaled-1680-/GXlimage.png)](https://kb.illimitar.pro/uploads/images/gallery/2026-04/GXlimage.png)

- Clique em **Salvar** e reinicie o PDV para aplicar as mudanças.

---

#### 1. Instalação no Linux

A instalação do CTFClient no Linux pode ser realizada através do pacote ctfclient--linux-portable-x86\_64.tar.

Descompactar o pacote de instalação do CTFClient e garantir que seja instalado em uma pasta no mesmo nível da pasta da aplicação da AC.  
Exemplo:  
• `/opt/PDV`  
•`/opt/CTFClient`

##### 2. O pacote de instalação do CTFClient instala as seguintes pastas:

•`/opt/CTFClient/bin`  
• `/opt/CTFClient/lib`  
• `/opt/CTFClient/JRE`  
• `/opt/CTFClient/include`

#####   
3. Após descompactação dar permissão na pasta através do comando:  


```bash
chow -Rf user:user /opt/CTFClient/
```

#####   


##### 4. Para iniciar o CTFClient na integração do tipo dll:

- Carregar a biblioteca libctfclient.so a partir da pasta onde o CTFClient foi instalado, isto é, da pasta /CTFClient/lib.

##### 5. Configuração do tipo de integração

A configuração do tipo de integração do CTFClient é feita através do parâmetro tipo integracao do arquivo configCTFClient.xml.

##### Por padrão, a instalação do CTFClient é pré-configurada para o tipo de integração dll:

[![image.png](https://kb.illimitar.pro/uploads/images/gallery/2026-04/scaled-1680-/aLlimage.png)](https://kb.illimitar.pro/uploads/images/gallery/2026-04/aLlimage.png)

##### Para habilitar a comunicação do tipo https:

[![image.png](https://kb.illimitar.pro/uploads/images/gallery/2026-04/scaled-1680-/Z1Mimage.png)](https://kb.illimitar.pro/uploads/images/gallery/2026-04/Z1Mimage.png)

##### Após realizar estas configurações é obrigatório instalar o navegador pdv(5.3.5ou superior)

##### Após instalação realizar a configuração do modulo TEF no pdv.(Registrar Terminal).