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

Resumo do que será ensinado

Neste documento será apresentado, em linguagem simples, como funciona a integração de um software de automação comercial com o ConnectTEF através de troca de arquivos. Você vai entender o conceito da solução, os diretórios utilizados (REQ e RESP), o papel da Automação Comercial (AAC) e do Gerenciador TEF, as etapas da operação e a estrutura básica dos arquivos IntPos, incluindo os campos mais importantes para pagamento, estorno e reimpressão. 

Segue um Vídeo explicativo do processo

Detalhamento do uso correto

Com este guia, você deve ser capaz de explicar o modelo de integração via arquivos para qualquer novo desenvolvedor ou analista de automação, entender o fluxo entre o sistema de automação comercial e o ConnectTEF, e saber quais arquivos são gerados e lidos em cada etapa da operação de pagamento, estorno e reimpressão. 

.

Segue o detalhamento de como funciona a Integração via Troca de Arquivos – Introdução

1. O que é a Integração via Troca de Arquivos

   • Este manual descreve como integrar um software de automação comercial com a solução ConnectTEF utilizando troca de arquivos em diretórios específicos. 
     Introdução | Conecte seu sistema a múltiplas adquirentes com facilidade
     .
   • As operações suportadas por essa forma de integração incluem: 
     Introdução | Conecte seu sistema a múltiplas adquirentes com facilidade
     .
     
     • Pagamento.
     • Estorno.
     • Reimpressão.

   Ponto importante

   • Esse modelo é especialmente adequado para ECF/SAT/NFC‑e e automações comerciais legadas, que já utilizam o padrão de arquivos IntPos em pastas REQ/RESP para se comunicar com gerenciadores TEF. 
     Introdução | Conecte seu sistema a múltiplas adquirentes com facilidade
     .

2. Diretórios utilizados na comunicação

   A comunicação entre o sistema de automação e o ConnectTEF acontece por meio de arquivos colocados em pastas específicas no disco: 

   Introdução | Conecte seu sistema a múltiplas adquirentes com facilidade
   .

   • Envio de dados (requisições)

     • Diretório: C:\TEF_DIAL\REQ.
     • Aqui a Automação Comercial grava os arquivos de solicitação (por exemplo, IntPos.001).

   • Recebimento de dados (respostas)

     • Diretório: C:\TEF_DIAL\RESP.
     • Aqui o Gerenciador TEF grava os arquivos de resposta (por exemplo, IntPos.001, IntPos.Sts).

   Pontos de atenção

   • A automação deve ter permissão de leitura e escrita nesses diretórios.
   • O Gerenciador TEF também usa esses diretórios para informar se está ativo e para enviar o status das transações. 
     Introdução | Conecte seu sistema a múltiplas adquirentes com facilidade
     .

3. Papéis de cada sistema na integração

   • Aplicativo de Automação Comercial (AAC) é responsável por: 

     Introdução | Conecte seu sistema a múltiplas adquirentes com facilidade
     .
     • Realizar vendas (controle de itens, totalização, impostos).
     • Cumprir as leis de ECF/SAT/NFC‑e (emissão de documentos fiscais).
     • Imprimir cupons e comprovantes TEF quando necessário.

   • Gerenciador TEF (ConnectTEF/TEF Dial) é responsável por: 

     Introdução | Conecte seu sistema a múltiplas adquirentes com facilidade
     .
     • Ler arquivos de solicitação em REQ.
     • Executar a operação TEF (pagamento, estorno, reimpressão).
     • Gravar arquivos de resposta em RESP.
     • Indicar status da sua própria execução por meio de IntPos.Sts.

   Ponto importante

   • A automação não faz o processamento financeiro da transação; ela apenas envia dados via arquivos e interpreta o retorno para refletir o resultado da operação. 
     Introdução | Conecte seu sistema a múltiplas adquirentes com facilidade
     .

4. Etapas da Integração (visão passo a passo)

   A documentação descreve um fluxo padrão de etapas que ocorrem durante uma operação TEF via arquivos: 

   Introdução | Conecte seu sistema a múltiplas adquirentes com facilidade
   .

   1. Automação gera arquivo de solicitação

      • A Automação Comercial gera o arquivo IntPos.001 (solicitação da operação) no diretório REQ. 
        Introdução | Conecte seu sistema a múltiplas adquirentes com facilidade
        .

   2. Gerenciador indica que está ativo

      • O Gerenciador TEF cria o arquivo IntPos.Sts em RESP, informando que está ativo e pronto para receber transações. 
        Introdução | Conecte seu sistema a múltiplas adquirentes com facilidade
        .
      • Alerta:
      • Se não houver resposta em até 7 segundos, é possível que o Gerenciador não esteja em execução. 
        Introdução | Conecte seu sistema a múltiplas adquirentes com facilidade
        .

   3. Gerenciador exibe tela de seleção de rede/bandeira

      • O Gerenciador lê a solicitação, exibe a tela para seleção da bandeira/rede desejada (Visa, MasterCard etc.) e segue com a operação. 
        Introdução | Conecte seu sistema a múltiplas adquirentes com facilidade
        .

   4. Processamento da transação e resposta inicial

      • O Gerenciador processa a transação e grava a resposta em RESP\IntPos.001 (arquivo com os dados da operação). 
        Introdução | Conecte seu sistema a múltiplas adquirentes com facilidade
        .

   5. Impressão de comprovante (se houver)

      • Se existir comprovante TEF, ele é impresso e o status correspondente é retornado para REQ\IntPos.001 (para que a automação possa acompanhar). 
        Introdução | Conecte seu sistema a múltiplas adquirentes com facilidade
        .

   6. Confirmação de status pelo Gerenciador

      • O Gerenciador confirma o status gerando novamente o arquivo RESP\IntPos.Sts, indicando o fim da operação. 
        Introdução | Conecte seu sistema a múltiplas adquirentes com facilidade
        .

   Pontos de atenção

   • Transações sem comprovante: finalizam na etapa 4 (não seguem até a impressão). 
     Introdução | Conecte seu sistema a múltiplas adquirentes com facilidade
     .
   • Transações com comprovante: seguem até a etapa 6 (impressão e confirmação de status). 
     Introdução | Conecte seu sistema a múltiplas adquirentes com facilidade
     .
   • A transação especial "ATV" (ativação) termina na etapa 2. 
     Introdução | Conecte seu sistema a múltiplas adquirentes com facilidade
     .

5. Tratamento de queda de energia e transação NCN

   • Em caso de queda de energia após o envio do IntPos.001 (etapa 1), a documentação orienta que a Automação deve enviar automaticamente uma transação com o código NCN. 
     Introdução | Conecte seu sistema a múltiplas adquirentes com facilidade
     .
   • Objetivo da transação NCN:
     • Permitir que o Gerenciador TEF verifique o estado da transação interrompida e faça os acertos necessários (evitar duplicidade, perda de dados etc.). 
       Introdução | Conecte seu sistema a múltiplas adquirentes com facilidade
       .

   Ponto importante

   • Essa rotina é essencial para garantir consistência financeira em ambientes sujeitos a interrupções de energia ou reset inesperado do PDV. 
     Introdução | Conecte seu sistema a múltiplas adquirentes com facilidade
     .

6. Mensagem do campo 030‑000 (Texto Especial Operador)

   • A integração define que a mensagem presente no campo 030-000 – TEXTO ESPECIAL OPERADOR deve ser sempre exibida pela Automação Comercial quando não estiver vazia. 
     Introdução | Conecte seu sistema a múltiplas adquirentes com facilidade
     .
   • Existem duas situações: 
     Introdução | Conecte seu sistema a múltiplas adquirentes com facilidade
     .

   1. Quando há linhas de comprovante para impressão

      • A mensagem deve ser exibida simultaneamente à impressão.
      • Deve permanecer visível por pelo menos 5 segundos ou durante toda a impressão.
      • Não deve aguardar confirmação do usuário para prosseguir. 
        Introdução | Conecte seu sistema a múltiplas adquirentes com facilidade
        .

   2. Quando não há linhas para impressão

      • A automação deve aguardar confirmação do usuário (OK) para seguir com o fluxo. 
        Introdução | Conecte seu sistema a múltiplas adquirentes com facilidade
        .

   Ponto importante

   • Esse campo é muito importante para transmitir mensagens críticas ao operador (ex.: motivo de recusa, alerta de comunicação, instruções da adquirente). 
     Introdução | Conecte seu sistema a múltiplas adquirentes com facilidade
     .

7. Fluxograma da Operação

   • A documentação inclui um fluxograma da operação TEF do ponto de vista da Automação Comercial, mostrando: 
     Introdução | Conecte seu sistema a múltiplas adquirentes com facilidade
     .
     
     • Geração de arquivos de solicitação.
     • Respostas do Gerenciador.
     • Impressão de comprovantes.
     • Tratamento de mensagens e status.

   Ponto importante

   • Esse fluxograma deve ser usado por equipes técnicas e de suporte para entender rapidamente em qual etapa uma transação pode estar falhando (por exemplo, sem IntPos.Sts, sem resposta em RESP, etc.).

8. Estrutura genérica dos arquivos IntPos (campos principais)

   Cada operação TEF (pagamento, estorno, reimpressão) trabalha com um arquivo de solicitação e um arquivo de resposta, ambos seguindo uma estrutura padronizada. 

   Introdução | Conecte seu sistema a múltiplas adquirentes com facilidade
   .
   Alguns campos importantes são:

   • 000-000 HEADER

     • Início do arquivo e tipo de operação.
     • Formato: alfanumérico, 3 bytes.
     • Valores possíveis: CRT, CNC, CNF, NCN, ADM, ATV, CDP, SRV etc. 
       Introdução | Conecte seu sistema a múltiplas adquirentes com facilidade
       .

   • 001-000 IDENTIFICAÇÃO

     • Número único da transação, repetido em todas as etapas.
     • Formato: numérico (até 10 bytes). 
       Introdução | Conecte seu sistema a múltiplas adquirentes com facilidade
       .

   • 003-000 VALOR TOTAL

     • Valor da operação em centavos (ex.: R$ 10,00 → 1000).
     • Formato: numérico (até 10 bytes). 
       Introdução | Conecte seu sistema a múltiplas adquirentes com facilidade
       .

   • 006-000 TIPO DE PESSOA

     • Tipo de pessoa envolvida na transação.
     • Valores: F (Pessoa Física/CPF) ou J (Pessoa Jurídica/CNPJ). 
       Introdução | Conecte seu sistema a múltiplas adquirentes com facilidade
       .

   • 007-000 DOCUMENTO DA PESSOA

     • CPF ou CNPJ da pessoa.
     • Formato: numérico, 16 bytes. 
       Introdução | Conecte seu sistema a múltiplas adquirentes com facilidade
       .

   • 009-000 STATUS DA TRANSAÇÃO

     • Indica se a transação foi aprovada.
     • Formato: alfanumérico, até 3 bytes.
     • Valores:
     • 0 → Aprovada.
     • Diferente de 0 → Erro. 
       Introdução | Conecte seu sistema a múltiplas adquirentes com facilidade
       .

   • 010-000 NOME DA REDE

     • Nome da rede processadora (adquirente).
     • Ex.: PAGSEGURO, STONE.
     • Formato: alfanumérico, até 12 bytes. 
       Introdução | Conecte seu sistema a múltiplas adquirentes com facilidade
       .

   • 011-000 TIPO DA TRANSAÇÃO

     • Define o tipo de transação: crédito, débito, PIX, voucher etc.
     • Ex.:
     • 10 – Cartão de Crédito à Vista.
     • 11 – Crédito Parcelado pela Loja.
     • 12 – Crédito Parcelado pelo Cliente.
     • 20 – Cartão de Débito à Vista.
     • 30 – PIX/Carteira Digital.
     • 60 – Voucher/PAT.
     • 70 – Consulta Cheque.
     • 99 – Outras. 
       Introdução | Conecte seu sistema a múltiplas adquirentes com facilidade
       .

   • 012-000 NÚMERO DA TRANSAÇÃO

     • NSU gerado no Host (identificador da transação na adquirente).
     • Formato: numérico, até 14 bytes. 
       Introdução | Conecte seu sistema a múltiplas adquirentes com facilidade
       .

   • 013-000 CÓDIGO DE AUTORIZAÇÃO

     • Código de autorização da transação.
     • Formato: numérico, até 6 bytes. 
       Introdução | Conecte seu sistema a múltiplas adquirentes com facilidade
       .

   • 022-000 DATA DA TRANSAÇÃO COMPROVANTE

     • Data da transação (no comprovante).
     • Formato: DDMMAAAA. 
       Introdução | Conecte seu sistema a múltiplas adquirentes com facilidade
       .

   • 023-000 HORA DA TRANSAÇÃO COMPROVANTE

     • Hora da transação (no comprovante).
     • Formato: HHMMSS. 
       Introdução | Conecte seu sistema a múltiplas adquirentes com facilidade
       .

   • 025-000 NSU DA TRANSAÇÃO CANCELADA

     • NSU da transação que será cancelada (usado em estornos). 
       Introdução | Conecte seu sistema a múltiplas adquirentes com facilidade
       .

   • 027-000 FINALIZAÇÃO

     • Dados agrupados da operação, usados para conciliação.
     • Formato: alfanumérico, até 30 bytes. 
       Introdução | Conecte seu sistema a múltiplas adquirentes com facilidade
       .

   • 028-000 QUANTIDADE DE LINHAS DO COMPROVANTE

     • Número de linhas do comprovante (0 = sem comprovante). 
       Introdução | Conecte seu sistema a múltiplas adquirentes com facilidade
       .

   • 029-YYY IMAGEM DE LINHA DO COMPROVANTE

     • Conteúdo de cada linha do comprovante, onde YYY indica o número da linha (001, 002, …). 
       Introdução | Conecte seu sistema a múltiplas adquirentes com facilidade
       .

   • 030-000 TEXTO ESPECIAL OPERADOR e 031-000 TEXTO ESPECIAL CLIENTE

     • Textos exibidos respectivamente ao operador e ao cliente.
     • Devem ser mostrados quando não estiverem vazios. 
       Introdução | Conecte seu sistema a múltiplas adquirentes com facilidade
       .

   • 400-002 BANDEIRA DO CARTÃO

     • Bandeira do cartão (por exemplo, VISA, MASTERCARD). 
       Introdução | Conecte seu sistema a múltiplas adquirentes com facilidade
       .

   • 999-999 REGISTRO FINAL

     • Marca o fim do arquivo.
     • Valor fixo: 0. 
       Introdução | Conecte seu sistema a múltiplas adquirentes com facilidade
       .

   Ponto importante

   • Essa estrutura é comum a múltiplas operações (pagamento, estorno, reimpressão) e deve ser respeitada pela Automação ao criar e interpretar os arquivos IntPos. 
     Introdução | Conecte seu sistema a múltiplas adquirentes com facilidade
     .

Informações Importantes

• A integração via troca de arquivos suporta as operações de Pagamento, Estorno e Reimpressão, usando arquivos em C:\TEF_DIAL\REQ e C:\TEF_DIAL\RESP. 
  Introdução | Conecte seu sistema a múltiplas adquirentes com facilidade
  .
• O Aplicativo de Automação Comercial é responsável por:
  • Gerar arquivos de solicitação (IntPos.001).
  • Interpretar arquivos de resposta (IntPos.001, IntPos.Sts).
  • Imprimir cupons fiscais e comprovantes TEF. 
    Introdução | Conecte seu sistema a múltiplas adquirentes com facilidade
    .
• O Gerenciador TEF:
  • Indica que está ativo via IntPos.Sts.
  • Processa as transações.
  • Devolve status, comprovantes e mensagens via arquivos em RESP. 
    Introdução | Conecte seu sistema a múltiplas adquirentes com facilidade
    .
• Em caso de queda de energia, a Automação deve enviar uma transação NCN para que o Gerenciador avalie a situação da transação interrompida. 
  Introdução | Conecte seu sistema a múltiplas adquirentes com facilidade
  .
• A mensagem do campo 030-000 – TEXTO ESPECIAL OPERADOR deve ser sempre exibida quando não vazia, com regras específicas conforme haja ou não impressão. 
  Introdução | Conecte seu sistema a múltiplas adquirentes com facilidade
  .
• Seguir corretamente a estrutura dos campos (HEADER, IDENTIFICAÇÃO, VALOR TOTAL, STATUS, NSU, AUTORIZAÇÃO, FINALIZAÇÃO, COMPROVANTE) garante:
  • Conciliação financeira precisa.
  • Rastreabilidade das transações.
  • Compatibilidade com o Gerenciador TEF ConnectTEF. 
    Introdução | Conecte seu sistema a múltiplas adquirentes com facilidade
    .

Este texto está pronto para ser copiado em um documento Word da sua base de conhecimento. Aplique o padrão visual solicitado: título com fonte 34, demais cabeçalhos (Resumo, Vídeo, Detalhamento, Informações Importantes) com fonte 18, e o corpo em fonte menor, mantendo os pontos essenciais em negrito para facilitar a leitura por usuários iniciantes.