SiTEF: Configuração CliSiTef.ini para homologação

[Vinicius Brandstatter]

Olá comunidade 

Gostaria de compartilhar com vocês um guia prático de configuração do arquivo CliSiTef.ini, voltado especificamente para ambiente de homologação.

A configuração desse arquivo é essencial para o correto funcionamento da Biblioteca CliSiTef, e para que ela colete os Logs que serão utilizados, na analise da homologação

[Geral]
TransacoesAdicionaisHabilitadas=7;8;58;3299;4439
DataEmAmbienteDeDesenvolvimento=AAAAMMDD

[PinPadCompartilhado]
Porta=AUTO_USB 

[CliSiTef]
HabilitaTrace= 1

[CliSiTefI]
HabilitaTrace= 1

 

Abaixo descrevo os principais blocos e parâmetros, explicando o que cada um faz e quando utilizar.

 

---

Estrutura do arquivo CliSiTef.ini

O arquivo é dividido em seções, cada uma responsável por um aspecto do funcionamento do sistema. As principais para homologação são:

---

Seção [Geral]

[Geral] 
TransacoesAdicionaisHabilitadas=7;8
DataEmAmbienteDeDesenvolvimento=AAAAMMDD

 

• TransacoesAdicionaisHabilitadas=7;8

Este parâmetro habilita menus adicionais de transação, sendo:

• 7 → Menu de transações PIX

• 8 → Menu de cancelamento PIX

Sem essa configuração, os menus relacionados ao PIX não ficam disponíveis, mesmo que o restante da integração esteja correto.

 

•  DataEmAmbienteDeDesenvolvimento=AAAAMMDD

Definir a Data do Inicio da Homologação, no formto AAAAMMDD, exemplo, para a data 10/02/2026 usar: 20260210

Faz com que seja gerado um arquivo de trace contendo os parâmetros trocados entre a CliSiTef e a aplicação.
O arquivo ficará localizado no diretório corrente ou em C:\CliSiTef, dependendo se o ambiente for Linux ou Windows, respectivamente.
O nome do arquivo é CliSiTef.AAAAMMDD.txt.

 

---

Seção [PinPadCompartilhado]

[PinPadCompartilhado] 
Porta=AUTO_USB

•  Porta=AUTO_USB

Esse parâmetro faz com que o CliSiTef procure automaticamente o pinpad conectado via USB, facilitando a configuração em ambientes onde a porta pode variar.

Caso necessário, também é possível fixar manualmente a porta, por exemplo:

Porta=COM2

Definir a Porta, pode ser útil, quando o ambiente possui múltiplos dispositivos ou quando o AUTO_USB não identifica corretamente o pinpad.

 

 

---

Seção [CliSiTef]

[CliSiTef]
HabilitaTrace=1

• HabilitaTrace=1

Ativa a geração de arquivos de trace (.dmp), que registram informações detalhadas de execução do sistema.

Extremamente recomendado em homologação, pois:

• Facilita a identificação de falhas

• Ajuda na análise de erros de comunicação

• É essencial para suporte técnico e diagnóstico

 

 

---

Seção [CliSiTefI]

[CliSiTefI]
HabilitaTrace=1

• HabilitaTrace=1

Assim como na seção anterior, habilita a geração de logs detalhados para o módulo CliSiTefI.

Importante:
Mesmo parecendo redundante, essa configuração deve ser feita separadamente, pois cada módulo gera seus próprios arquivos de trace.

 

---

Onde o arquivo precisa ser copiado ?

O Arquivo CliSiTef.ini deve ser copiado, na mesma pasta onde se encontra a Biblioteca CliSiTef32l.dll

 

Em anexo, temos um arquivo completo, já com as configurações

 

 

 

CliSiTef.ini

[Daniel Simoes]

Olha só que bacana, quando você configura a CliSiTef.ini, com 

DataEmAmbienteDeDesenvolvimento=AAAAMMDD

Observe que além de gerar o arquivo CliSiTef.20260213.dmp, a biblioteca CliSiTef32I.dll,  também gerou o arquivo 

CliSiTef.20260213.txt (aberto, o que permite observar a comunicação da aplicação com DLL)

 

No Teste acima, a minha CliSiTef.ini, está configurada da seguinte forma:

[Geral]
TransacoesAdicionaisHabilitadas=7;8;58;3299;4439
DataEmAmbienteDeDesenvolvimento=20260213
EmAmbienteDeHomologacao=1

[PinPadCompartilhado]
Porta=COM3

[CliSiTef]
HabilitaTrace=1
DiretorioTrace=C:\CliSiTef

[CliSiTefI]
HabilitaTrace=1