CONNECTTEF – INTEGRAÇÃO VIA TROCA DE ARQUIVOS (ESTORNO).

Resumo do que será ensinado

Neste documento você vai aprender, passo a passo, como realizar uma operação de estorno (cancelamento) via troca de arquivos com o ConnectTEF, usando o padrão IntPos e os diretórios REQ e RESP. Serão explicados os arquivos envolvidos, o conteúdo mínimo para solicitar o estorno, os exemplos de respostas de sucesso e falha e como tratar essas informações na automação comercial. 

Segue um Vídeo explicativo do processo

Detalhamento do uso correto

Com este guia, qualquer analista ou desenvolvedor de automação comercial conseguirá configurar o fluxo de estorno de transações via ConnectTEF, entendendo quais arquivos devem ser gerados, quais campos precisam ser preenchidos, como interpretar o retorno e como registrar corretamente o cancelamento da transação no sistema (ECF/SAT/NFC‑e, PDV, ERP).

Segue o detalhamento de como realizar Estorno via Troca de Arquivos no ConnectTEF

1. Visão geral da operação de Estorno via arquivos

   • O estorno via troca de arquivos segue o mesmo modelo de comunicação do pagamento: 
     Estorno | Conecte seu sistema a múltiplas adquirentes com facilidade
     
     
     • A Automação Comercial gera um arquivo de requisição de estorno em C:\TEF_DIAL\REQ.
     • O Gerenciador TEF (ConnectTEF) lê esse arquivo, executa o estorno com a adquirente e grava um arquivo de resposta em C:\TEF_DIAL\RESP.
   • A diferença está no tipo de mensagem (campo 000-000) e nos campos que identificam a transação original a ser cancelada. 
     Estorno | Conecte seu sistema a múltiplas adquirentes com facilidade

   Ponto importante

   • O estorno só deve ser solicitado para transações já autorizadas e exige que a automação possua dados da operação original (NSU, data, hora etc.).

2. Passo 1 – Automação gera o arquivo de solicitação de estorno

   • A automação comercial deve criar o arquivo: 
     Estorno | Conecte seu sistema a múltiplas adquirentes com facilidade
     
     
     • C:\TEF_DIAL\REQ\IntPos.001
   • Exemplo de conteúdo para iniciar um estorno: 
     Estorno | Conecte seu sistema a múltiplas adquirentes com facilidade

    000-000 = CNC
    001-000 = 141337877
    003-000 = 200
    004-000 = 0
    010-000 = STONE
    012-000 = 39241081811116
    022-000 = 18102024
    023-000 = 1522
    999-999 = 0
   

   • Significado dos campos principais: 
     Estorno | Conecte seu sistema a múltiplas adquirentes com facilidade
     
     
     • 000-000 = CNC
     • Indica o tipo de mensagem: CNC = Cancelamento (estorno).
     • 001-000 = 141337877
     • Identificador da transação na automação (pode ser número de controle interno).
     • 003-000 = 200
     • Valor da transação a ser estornada, em centavos (ex.: 200 = R$ 2,00).
     • 004-000 = 0
     • Campo de reserva, pode ser mantido em 0 conforme exemplo.
     • 010-000 = STONE
     • Nome da rede/adquirente envolvida na transação original.
     • 012-000 = 39241081811116
     • NSU da transação original (número da transação no host/adquirente).
     • 022-000 = 18102024
     • Data da transação original no comprovante, formato DDMMAAAA.
     • 023-000 = 1522
     • Hora simplificada da transação original, formato HHMM.
     • 999-999 = 0
     • Registro final, marca o fim do arquivo.

   Pontos de atenção

   • Os campos 012-000, 022-000 e 023-000 devem corresponder exatamente à transação que se deseja estornar. 
     Estorno | Conecte seu sistema a múltiplas adquirentes com facilidade
   • O valor (003-000) deve ser igual ao valor da transação original, salvo regras específicas da adquirente.

3. Passo 2 – Gerenciador TEF indica que está ativo (IntPos.Sts)

   • Após receber o arquivo de requisição de estorno em REQ, o Gerenciador TEF cria o arquivo: 
     Estorno | Conecte seu sistema a múltiplas adquirentes com facilidade
     
     
     • C:\TEF_DIAL\RESP\IntPos.Sts
   • Exemplo de conteúdo: 
     Estorno | Conecte seu sistema a múltiplas adquirentes com facilidade

    000-000 = CNC
    001-000 = 141337877
    027-000 = 753|811116
    999-999 = 0
   

   • Significado dos campos: 
     Estorno | Conecte seu sistema a múltiplas adquirentes com facilidade
     
     
     • 000-000 = CNC
     • Confirma que o Gerenciador está tratando uma operação de cancelamento (estorno).
     • 001-000 = 141337877
     • Repete o identificador da transação enviado pela automação (para vincular os arquivos).
     • 027-000 = 753|811116
     • Campo de finalização, trazendo informações agrupadas de conciliação.
     • 999-999 = 0
     • Registro final.

   Alerta de disponibilidade

   • Se não houver resposta em até 7 segundos, o Gerenciador não está ativo e a automação deve tratar essa situação como erro de comunicação (por exemplo, exibindo mensagem ao operador). 
     Estorno | Conecte seu sistema a múltiplas adquirentes com facilidade

4. Passo 3 – Interface de processamento no Gerenciador TEF

   • Enquanto o estorno é processado, o Gerenciador TEF: 
     Estorno | Conecte seu sistema a múltiplas adquirentes com facilidade
     
     
     • Exibe uma interface de processamento no sistema/terminal.
     • Realiza a comunicação com a adquirente para confirmar se o cancelamento será autorizado.

   Ponto importante

   • Essa etapa é totalmente gerenciada pelo ConnectTEF; a automação apenas aguarda o arquivo de resposta em RESP.

5. Passo 4 – Gerenciador envia resposta da operação de estorno (IntPos.001)

   • Após concluir ou não o estorno, o Gerenciador TEF grava o arquivo: 
     Estorno | Conecte seu sistema a múltiplas adquirentes com facilidade
     
     
     • C:\TEF_DIAL\RESP\IntPos.001
   • A automação deve ler esse arquivo para saber se a operação foi bem-sucedida ou mal-sucedida.

   Exemplo: operação de estorno bem-sucedida 

   Estorno | Conecte seu sistema a múltiplas adquirentes com facilidade

   000-000 = CNC
   001-000 = 141337877
   003-000 = 200
   009-000 = 0
   010-000 = STONE
   011-000 = 20
   012-000 = 39241081811116
   015-000 = 1810152244
   022-000 = 18102024
   023-000 = 152244
   025-000 = 39241081811116
   026-000 = 1810152244
   027-000 = 753|811116
   028-000 = 000
   400-001 = 89.324.856/0001-26
   400-002 = VISA
   999-999 = 0

• Campos principais: 

  Estorno | Conecte seu sistema a múltiplas adquirentes com facilidade
  • 000-000 = CNC
    
    • Confirma que a resposta é de cancelamento (estorno).
  • 001-000 = 141337877
    
    • Identificador da transação, igual à requisição.
  • 003-000 = 200
    
    • Valor estornado, em centavos.
  • 009-000 = 0
    
    • Status da operação: 0 indica sucesso no estorno.
  • 010-000 = STONE
    
    • Rede/adquirente responsável pela transação.
  • 011-000 = 20
    
    • Tipo da transação (por exemplo, 20 = Débito à vista).
  • 012-000 = 39241081811116
    
    • NSU da transação estornada.
  • 015-000 = 1810152244
    
    • Número de controle complementar (pode representar referência interna).
  • 022-000 = 18102024 / 023-000 = 152244
    
    • Data e hora completas da transação (formato ampliado).
  • 025-000 = 39241081811116
    
    • NSU da transação que foi cancelada.
  • 026-000 = 1810152244
    
    • Referência à operação original (por exemplo, número de transação anterior).
  • 027-000 = 753|811116
    
    • Campo de finalização (dados agregados).
  • 028-000 = 000
    
    • Quantidade de linhas de comprovante (000 → sem comprovante).
  • 400-001 = 89.324.856/0001-26
    
    • CNPJ da empresa na adquirente.
  • 400-002 = VISA
    
    • Bandeira do cartão.
  • 999-999 = 0
    
    • Registro final.

  Exemplo: operação de estorno mal-sucedida 

  Estorno | Conecte seu sistema a múltiplas adquirentes com facilidade

   000-000 = CNC
   001-000 = 141337877
   003-000 = 200
   009-000 = 1
   010-000 = STONE
   011-000 = 20
   025-000 = 39241081811116
   026-000 = 1810152244
   028-000 = 000
   030-000 = OPERACAO CANCELADA
   400-001 = 89.324.856/0001-26
   400-002 = VISA
   999-999 = 0

• Campos principais: 

  Estorno | Conecte seu sistema a múltiplas adquirentes com facilidade
  • 009-000 = 1
    
    • Indica falha na operação de estorno (não aprovado).
  • 030-000 = OPERACAO CANCELADA
    
    • Texto especial para o operador, descrevendo o motivo/estado da operação.
  • Demais campos (025-000, 026-000, 400-001, 400-002) ajudam na identificação da transação original e contexto da falha.

  Pontos de atenção

• Para saber se o estorno foi aprovado, a automação deve verificar:

  • 009-000 == 0 → sucesso.
  • 009-000 != 0 → falha, usar 030-000 para mensagem ao operador. 
    Estorno | Conecte seu sistema a múltiplas adquirentes com facilidade

1. Fluxo completo resumido para implementação

   1. Identificar a transação original no PDV

      • Localizar NSU, data, hora, rede e valor da transação que precisa ser estornada.

   2. Gerar arquivo de requisição de estorno em REQ\IntPos.001

      • Preencher campos obrigatórios: 000-000 = CNC, 001-000, 003-000, 010-000, 012-000, 022-000, 023-000, 999-999.

   3. Verificar IntPos.Sts em RESP

      • Confirmar que o Gerenciador TEF está ativo (resposta em até 7 segundos).

   4. Aguardar arquivo de resposta em RESP\IntPos.001

      • Ler campos 009-000, 012-000, 025-000, 026-000, 030-000, 400-XXX.

   5. Atualizar o sistema interno

      • Se 009-000 = 0:
      • Marcar a venda original como estornada.
      • Registrar NSU, códigos, data/hora e bandeira para conciliação.
      • Se 009-000 ≠ 0:
      • Exibir 030-000 para o operador.
      • Registrar a tentativa de estorno como não concluída.

   6. Tratar impressão (se houver comprovante)

      • Caso 028-000 indique linhas de comprovante, seguir a mesma lógica de CNF/NCN usada em Pagamento para confirmar ou sinalizar falha na impressão.

Informações Importantes

• Diretórios utilizados:
  • Requisição de estorno: C:\TEF_DIAL\REQ\IntPos.001.
  • Respostas: C:\TEF_DIAL\RESP\IntPos.Sts e C:\TEF_DIAL\RESP\IntPos.001. 
    Estorno | Conecte seu sistema a múltiplas adquirentes com facilidade
• Campos decisivos:
  • 000-000 = CNC → operação de cancelamento/estorno.
  • 009-000 → status da operação (0 = sucesso, `≠