Ir para conteúdo
  • Cadastre-se

Seja bem-vindo
Seja um membro do ACBr Pro e agilize seu software Participe do Discord do ACBr Regras e orientações da nossa comunidade DIA DO ACBR 2026 - O GRANDE ENCONTRO DA COMUNIDADE

SiTEF: Como iniciar a Homologação por Troca de Arquivos - PDVCliSiTef

antonio.carlos
 Compartilhar

Recommended Posts

  • Consultores
antonio.carlos Experienced

antonio.carlos

Postado
  • Consultores
Postado

Olá comunidade image.png.c66a8e350a15080739793c08a9f4af

Gostaria de compartilhar com todos vocês um guia de Como iniciar a Homologação TEF usando o PDVCliSiTef o TEF Troca de Arquivos da Fiserv
 

image.png.c66a8e350a15080739793c08a9f4af Sobre o ACBr

  • O ACBr é Distribuidor dos produtos e serviços da FISERV
  • Temos condições exclusivas para a comunidade do ACBr,
  • Somos autoridade em TEF. 
    Confira o nosso curso completo, sobre TEF e Meios de Pagamentos
  • Tenha acesso ao nosso Suporte, Demos e Cursos, inscrevendo-se na página:
    https://projetoacbr.com.br/tef/

 

image.pngSobre a FISERV

A Fiserv é uma líder global em tecnologia para serviços financeiros e pagamentos, presente em mais de 100 países e com mais de 40 anos de atuação.

O SiTef (Sistema Inteligente de Transferência Eletrônica de Fundos) é uma solução TEF desenvolvida pela Fiserv para integrar pagamentos eletrônicos diretamente aos sistemas de automação comercial (PDV, ERP, e-commerce).
Ele é considerado líder no mercado brasileiro e movimenta bilhões de transações por ano. Sendo o mais aceito, e compatível dos TEFs do mercado Brasileiro

image.png O que é o PDVCliSiTef?
O PDVCliSiTef, é um client desenvolvida pela Fiserv para as plataformas Windows que realizam a captura e transações (TEF) por troca de arquivos.

https://dev.softwareexpress.com.br/docs/manual-interface-clisitef/apresentacao

Instalação do SiTef Demonstração.

Baixe e instale o SitDemo distribuído pela Fiserv

Após a instalação do SitDemo, iremos sobrescrever os arquivos, com a versão já configurada pela equipe do ACBr...

NOTA: Se você deseja saber quais são as configurações que já foram aplicadas pela Equipe do ACBr no ZIP, leia esse artigo

Baixe o SitDemo, já configurado pela equipe do ACBr, no Link abaixo:


Após baixar o arquivo SitDemo_ProjetoACBr.zip, descompacte do arquivo ZIP, a Pasta "SiTef", na raiz do seu disco C:\
image.png

 

Inicializando SiTef Demonstração.
Dentro da pasta SiTef, existiram uma série de pastas do ambiente de homologação, a mais importante será a "APLIC.WIN", pasta que carrega todas as aplicações do SiTef.
image.png
 
Abrindo a pasta "APLIC.WIN" busque pelo arquivo "SitDemo.exe" e execute-o como administrador.
Uma janela como essa será exibida: 
image.png
 
Nota: Várias outras janelas, abrirão em segundo plano... Isso realmente é o comportamento esperado, do Emulador SitDemo
 
Pronto: agora o seu servidor de homologação já está rodando.
 
Curso T.E.F e Meios de Pagamentos -> Módulo PDV CliSiTef
Em nosso curso -> T.E.F e Meios de Pagamentos, já estão disponíveis as aulas sobre o PDVCliSiTef. 
Nesse curso, você poderá acompanhar nossos desenvolvedores, explicando a lógica e realizando alguns testes.

Instalação e Configuração do PDVCliSiTef.
Realize o download do PDVCliSiTef:
O processo de instalação do PDVCliSiTef é bem simples, no momento da instalação o PDVCliSiTef aponta para um diretório padrão:
Você pode mudar este diretório ou manter o que já esta definido pelo PDVCliSiTef, feito isso, clique em "Instalar".
image.png

image.png -> image.png -> image.png -> image.png

image.png

Feito isso, pode clicar em "Fechar".

Agora você precisa abrir o diretório onde foi instalado o PDVCliSiTef:
image.png

Vamos executar o PDVSiTef.exe, veja que o PDVCliSiTef vai ficar em execução na Bandeja do Windows:
image.png

Pronto com o SitDemo e o PDVCliSiTef instalado e em execução na máquina, podemos realizar alguns testes.

Glossário para uso do TEF Troca de Arquivos.
Abaixo estão algumas definições importantes que você deve conhecer antes de iniciar o trabalho com TEF por troca de arquivos.

Diretórios Req e Resp.
C:\Client\Req: Diretório padrão do TEF utilizado para gravação das requisições da automação comercial.
Os arquivos criados nesta pasta são lidos pelo gerenciador TEF para processamento das operações.

C:\Client\Resp: Diretório padrão do TEF utilizado para gravação das respostas do gerenciador TEF.
Os arquivos disponíveis nesta pasta são lidos pela automação comercial para obter o retorno das operações.

Arquivo IntPos.
IntPos.001: Nome padrão do arquivo utilizado no TEF Troca de Arquivos para comunicação entre a automação comercial e o gerenciador TEF.
O arquivo é utilizado tanto no diretório Req, para envio das requisições, quanto no diretório Resp, para retorno das respostas das operações.

Operações TEF Troca de Arquivos.
ADM: Permite o acionamento do gerenciador TEF para execução de funções administrativas.
CRT: Transação via cartão, podendo ser crédito, débito, PIX e Carteiras Digitais.
CNC: Cancelamento de venda efetuada por qualquer meio de pagamento.
CNF: Confirmação da venda.
NCN: Não confirmação da venda.

Testes com o PDVCliSiTef.
Podemos realizar os testes com o PDVCliSiTef de duas formas:
- Enviando os arquivos IntPos.001 diretamente para a pasta de C:\Client\Req e lendo o arquivo IntPos.001 na pasta C:\Client\Resp.
- Utilizando o Componente ACBrTEFAPI.

Enviando arquivo IntPos.001 diretamente para a pasta Req.
Vamos enviar um arquivo ADM (Funções Administrativas) para a pasta C:\Client\Req.
Observação: arquivo em anexo precisa ser renomeado para IntPos.001 antes de ser enviado para a pasta C:\Client\Req.
Arquivo exemplo em anexo -> ADM.001 

000-000 = ADM
001-000 = 00000001
565-008 = 1=12345678901234;2=11111111111111
999-999 = 0

image.png

Segundo teste, podemos enviar um arquivo CRT (Transação via cartão) para a pasta C:\Client\Req.
Observação: arquivo em anexo precisa ser renomeado para IntPos.001 antes de ser enviado para a pasta C:\Client\Req.
Arquivo exemplo em anexo -> VENDA.001 

000-000 = CRT
001-000 = 00000001
003-000 = 10000
004-000 = 0
565-008 = 1=12345678901234;2=11111111111111
999-999 = 0

image.png

Após realizar a operação de venda (CRT) é necessário ler o conteúdo do arquivo IntPos.001 da pasta C:\Client\Resp para coletar as informações da transação e enviar o arquivo CNF (Confirmação da Transação) ou NCN (Não Confirmação da Transação) para a pasta C:\Client\Req.
Veja um exemplo do IntPos.001 da pasta C:\Client\Resp: 

000-000 = CRT
001-000 = 00000001
003-000 = 100,00
004-000 = 0
009-000 = 0
010-000 = MASTERCARD      
010-001 = 05
010-003 = 00002
010-004 = 523284
010-005 = 0657
011-000 = 56
012-000 = 999180014
013-000 = 180014
015-000 = 1805165549
022-000 = 18052026
023-000 = 165549
027-000 = 180526165448
028-000 = 37
028-001 = 19
029-001 = " .....S.O.F.T.W.A.R.E.E.X.P.R.E.S.S...."
029-002 = " SI                              Rede 5"
029-003 = " MU               Codigo transacao: 200"
029-004 = " LA               Codigo operacao: 3000"
029-005 = " DO                       Valor: 100,00"
029-006 = " .....S...I...M...U...L...A...D...O...."
029-007 = " SI                   NSU SiTef: 180014"
029-008 = " MU                      18/05/26 16:55"
029-009 = " LA                    ID PDV: SW000000"
029-010 = " DO             Estab.: 000000000000005"
029-011 = " .....S...I...M...U...L...A...D...O...."
029-012 = " SI                     Host: 999180014"
029-013 = " MU         Transacao Simulada Aprovada"
029-014 = " LA        TAG AID 0x84: A0000000041010"
029-015 = " DO      TAG AID 0x9F06: A0000000041010"
029-016 = " .....S...I...M...U...L...A...D...O...."
029-017 = " SI                 SALDO DISP.    0,02"
029-018 = "           SiTef from Fiserv"
029-019 = " "
029-020 = " .....S.O.F.T.W.A.R.E.E.X.P.R.E.S.S...."
029-021 = " SI                              Rede 5"
029-022 = " MU               Codigo transacao: 200"
029-023 = " LA               Codigo operacao: 3000"
029-024 = " DO                       Valor: 100,00"
029-025 = " .....S...I...M...U...L...A...D...O...."
029-026 = " SI                   NSU SiTef: 180014"
029-027 = " MU                      18/05/26 16:55"
029-028 = " LA                    ID PDV: SW000000"
029-029 = " DO             Estab.: 000000000000005"
029-030 = " .....S...I...M...U...L...A...D...O...."
029-031 = " SI                     Host: 999180014"
029-032 = " MU         Transacao Simulada Aprovada"
029-033 = " LA        TAG AID 0x84: A0000000041010"
029-034 = " DO      TAG AID 0x9F06: A0000000041010"
029-035 = " .....S...I...M...U...L...A...D...O...."
029-036 = "           SiTef from Fiserv"
029-037 = " "
030-000 = Transacao Aprov.
041-000 = 19
043-000 = 180014
150-000 = 00000000
150-004 = 000000000000005
150-005 = SW000000
300-001 = 3005
300-002 = ANTONIO CARLOS
601-000 = 02
602-000 = 180014
701-006 = 4
772-021 = 546214******0527
772-022 = 3005
772-023 = ANTONIO CARLOS
888-001 = 051818001405
889-001 = 05006000100;023049F3303E0F0C89F0607A00000000410108407A0000000041010500A4D6173746572636172649F2608F972427DBDBA5B909F2701409F10120310650003020000000000000000000000FF9F37048A5416B69F36020276950504000080009A032605189C01009F02060000000100005F2A020986820239009F1A0200769F03060000000000009F34034103025F3401009F6E0700760000303000;
999-999 = 0


Agora podemos enviar o arquivo CNF (Confirmação da Transação) para a pasta C:\Client\Req.
Observação: arquivo em anexo precisa ser renomeado para IntPos.001 antes de ser enviado para a pasta C:\Client\Req.
Arquivo exemplo em anexo -> CNF.001 

000-000 = CNF
001-000 = 00000001
002-000 = 999180014
010-000 = MASTERCARD
012-000 = 999180014
027-000 = 180526165448
565-008 = 1=12345678901234;2=11111111111111
999-999 = 0


Veja também um exemplo de NCN (Não Confirmação da Transação) que podemos enviar para a pasta C:\Client\Req.
Observação: arquivo em anexo precisa ser renomeado para IntPos.001 antes de ser enviado para a pasta C:\Client\Req.
Arquivo exemplo em anexo -> NCN.001 

000-000 = NCN
001-000 = 00000001
010-000 = MASTERCARD
012-000 = 999180014
027-000 = 180526165448
999-999 = 0


Componente ACBrTEFAPI.
Programa exemplo esta disponível em:
https://svn.code.sf.net/p/acbr/code/trunk2/Exemplos/ACBrTEFD/TEFAPI/

Disponibilizamos também um executável para que possa realizar o download para testes iniciais.

Quando executar o programa exemplo, veja que não tem nenhum gerenciador TEF selecionado:
image.png

Para conseguir utilizar o PDVCliSiTef, é necessário:
- Mudar o Gerenciado TEF -> para tefTXT e na Aba TEF TXT, selecionar teftxtSiTEF:
image.png

Recomendo também configurar o Log do Componente no campo ArqLog.

Próximo passo é clicar em "Salvar Parâmetros" e "Testar TEF"
image.png

Feito isso, podemos clicar em "Operações"

Tela Venda:                                                                                                                                                                                                         Tela Menu Administrativo:
image.png                      image.png

Menu Administrativo:
-> Clicando em Menu Administrativo no programa exemplo, componente ACBrTEFAPI vai disparar um arquivo IntPos.001 com as chamadas ADM no PDVCliSiTef

image.png

Veja o log a estrutura do arquivo criado pelo componente ACBrTEFAPI e enviado para a pasta Req: 

GravarRequisicao: C:\Client\Req\IntPos.001
  Gravando Temporario: C:\Client\Req\IntPos.tmp
  Renomeando: C:\Client\Req\IntPos.tmp para C:\Client\Req\IntPos.001 
C:\Client\Req\IntPos.001
000-000 = ADM
001-000 = 57511
999-999 = 0


Realizando um teste de Venda:
Com o programa exemplo, podemos disparar um CRT, ou seja, um arquivo para operação de venda no PDVCliSiTef.
Realizando um teste simples -> Transação de R$1,00 no cartão de débito.
Observação: Primeira transação pode ocorrer carga de tabelas

image.png

image.png            image.png

Veja como ficou os logs:
Componente criou o CRT e enviou para a pasta Req 

GravarRequisicao: C:\Client\Req\IntPos.001
  Gravando Temporario: C:\Client\Req\IntPos.tmp
  Renomeando: C:\Client\Req\IntPos.tmp para C:\Client\Req\IntPos.001 
C:\Client\Req\IntPos.001
000-000 = CRT
001-000 = 57522
999-999 = 0
002-000 = 5
003-000 = 100

Após finalizar operação CRT, veja que na pasta Resp vamos ter o retorno da operação: 

LerArquivoResposta: C:\Client\Resp\IntPos.001
C:\Client\Resp\IntPos.001
000-000 = CRT
001-000 = 57522
002-000 = 5
003-000 = 1,00
009-000 = 0
010-000 = MASTERCARD DEBIT
010-001 = 05
010-003 = 20001
010-004 = 523284
010-005 = 0657
011-000 = 32
012-000 = 999180013
013-000 = 180013
015-000 = 1805162100
022-000 = 18052026
023-000 = 162100
027-000 = 180526162003
028-000 = 37
028-001 = 19
029-001 = " .....S.O.F.T.W.A.R.E.E.X.P.R.E.S.S...."
029-002 = " SI                              Rede 5"
029-003 = " MU               Codigo transacao: 200"
029-004 = " LA               Codigo operacao: 2000"
029-005 = " DO                         Valor: 1,00"
029-006 = " .....S...I...M...U...L...A...D...O...."
029-007 = " SI                   NSU SiTef: 180013"
029-008 = " MU                      18/05/26 16:21"
029-009 = " LA                    ID PDV: SW000000"
029-010 = " DO             Estab.: 000000000000005"
029-011 = " .....S...I...M...U...L...A...D...O...."
029-012 = " SI                     Host: 999180013"
029-013 = " MU         Transacao Simulada Aprovada"
029-014 = " LA        TAG AID 0x84: A0000000043060"
029-015 = " DO      TAG AID 0x9F06: A0000000043060"
029-016 = " .....S...I...M...U...L...A...D...O...."
029-017 = " SI                 SALDO DISP.    0,02"
029-018 = "           SiTef from Fiserv"
029-019 = " "
029-020 = " .....S.O.F.T.W.A.R.E.E.X.P.R.E.S.S...."
029-021 = " SI                              Rede 5"
029-022 = " MU               Codigo transacao: 200"
029-023 = " LA               Codigo operacao: 2000"
029-024 = " DO                         Valor: 1,00"
029-025 = " .....S...I...M...U...L...A...D...O...."
029-026 = " SI                   NSU SiTef: 180013"
029-027 = " MU                      18/05/26 16:21"
029-028 = " LA                    ID PDV: SW000000"
029-029 = " DO             Estab.: 000000000000005"
029-030 = " .....S...I...M...U...L...A...D...O...."
029-031 = " SI                     Host: 999180013"
029-032 = " MU         Transacao Simulada Aprovada"
029-033 = " LA        TAG AID 0x84: A0000000043060"
029-034 = " DO      TAG AID 0x9F06: A0000000043060"
029-035 = " .....S...I...M...U...L...A...D...O...."
029-036 = "           SiTef from Fiserv"
029-037 = " "
030-000 = Transacao Aprov.
041-000 = 19
043-000 = 180013
150-000 = 00000000
150-004 = 000000000000005
150-005 = SW000000
300-001 = 3005
300-002 = ANTONIO CARLOS
601-000 = 02
602-000 = 180013
701-006 = 1
772-021 = 546214******0527
772-022 = 3005
772-023 = ANTONIO CARLOS
888-001 = 051818001305
889-001 = 05006000000;022989F3303E0D0C89F0607A00000000430608407A000000004306050074D61657374726F9F260804136DE22C0F99F29F2701409F10120310600003220000000000000000000000FF9F37049CF8C77D9F360200D9950504000480009A032605189C01009F02060000000001005F2A020986820239009F1A0200769F03060000000000009F34034203005F3401009F6E0700760000303000;
999-999 = 0

  VerificarRespostaValida
    OK
  SetStatus: tefstLivre
  FinalizarTransacao( tefstsSucessoAutomatico )
    FinalizarTransacao( 0657, 999180013, 180526162003, tefstsSucessoAutomatico )

Assim que o CRT for realizado com sucesso é necessário fazer o envio do CNF. 

PrepararRequisicao( CNF )
LimparRequisicao
LimparResposta
  ApagarArquivosDeComunicacao
    AVISO: Arquivo C:\Client\Req\IntPos.tmp já existe
    Apagando: C:\Client\Resp\IntPos.001
EnviarRequisicao
  SetStatus: tefstEnviandoRequisicao
GravarRequisicao: C:\Client\Req\IntPos.001
  Gravando Temporario: C:\Client\Req\IntPos.tmp
  Renomeando: C:\Client\Req\IntPos.tmp para C:\Client\Req\IntPos.001 
C:\Client\Req\IntPos.001
000-000 = CNF
001-000 = 57523
999-999 = 0
010-000 = 0657
012-000 = 999180013
027-000 = 180526162003

Utilizando o componente ACBrTEFAPI, vamos manter as propriedades Confirmar Transação Automaticamente = True.

Envio de Arquivos Pré-Homologação SiTef

Durante os os testes do roteiro, você deverá coletar os Logs e comprovantes de transação...

O Artigo abaixo, explica passo a passo esse processo, e também detalha para onde e como os Logs devem ser enviados para analise...
 


Suporte da Equipe do ACBr

Se você tem contrato de Parceria com o ACBr, para a Distribuição de TEF, você pode contar com a ajuda e Suporte de nossos técnicos e desenvolvedores

CNF.001

  • antonio.carlos changed the title to SiTEF: Como iniciar a Homologação por Troca de Arquivos - PDVCliSiTef
 Compartilhar
Ir para a lista de tópicos
×
×
  • Criar Novo...

Informação Importante

Colocamos cookies em seu dispositivo para ajudar a tornar este site melhor. Você pode ajustar suas configurações de cookies, caso contrário, assumiremos que você está bem para continuar.

The popup will be closed in 10 segundos...