Pesquisar artigos na Base de Dados de Conhecimento

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

Resumo do que será ensinado

Neste documento você vai aprender, passo a passo, como realizar uma operação de pagamento via troca de arquivos com o ConnectTEF, usando o padrão IntPos e os diretórios REQ e RESP. Serão detalhados os arquivos envolvidos, os campos principais, o fluxo completo da operação e como tratar situações de sucesso, erro e problemas de impressão.

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 pagamento com cartão via ConnectTEF, entendendo exatamente quais arquivos devem ser gerados e lidos, quais campos precisam ser preenchidos e como tratar o retorno para finalizar corretamente a venda e o comprovante no sistema.

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

Visão geral da operação de Pagamento via arquivos
- A operação de Pagamento via troca de arquivos segue o modelo clássico de integração TEF:
  - A Automação Comercial cria um arquivo de requisição no diretório REQ.
  - O Gerenciador TEF (ConnectTEF) lê esse arquivo, executa a operação de pagamento com a adquirente e grava um arquivo de resposta no diretório RESP.
    Pagamento | Conecte seu sistema a múltiplas adquirentes com facilidade
    .
- Todo o diálogo entre automação e TEF é feito por arquivos IntPos.xxx, com campos numerados (000-000, 001-000, 003-000 etc.).
  Pagamento | Conecte seu sistema a múltiplas adquirentes com facilidade
  .
Ponto importante
- A automação não faz a transação financeira diretamente; ela apenas envia dados via arquivo e interpreta o retorno para saber se o pagamento foi aprovado ou cancelado.
  Pagamento | Conecte seu sistema a múltiplas adquirentes com facilidade
  .
Passo 1 – Automação gera o arquivo de solicitação de pagamento
- A automação comercial deve criar o arquivo:
  - C:\TEF_DIAL\REQ\IntPos.001.
    Pagamento | Conecte seu sistema a múltiplas adquirentes com facilidade
    .
- Exemplo mínimo de conteúdo para iniciar um pagamento:
  Pagamento | Conecte seu sistema a múltiplas adquirentes com facilidade
```
 000-000 = CRT
 001-000 = 0
 003-000 = 200
 999-999 = 0
```
- Significado dos campos principais nesse exemplo:
  Pagamento | Conecte seu sistema a múltiplas adquirentes com facilidade
  - 000-000 = CRT
  - Indica o tipo de mensagem (CRT = “Cartão”, requisição de transação).
  - 001-000 = 0
  - Identificador inicial da transação (pode ser substituído por um número de controle da automação).
  - 003-000 = 200
  - Valor da transação em centavos (ex.: 200 = R$ 2,00).
  - 999-999 = 0
  - Registro final, marca o fim do arquivo.
Forma de pagamento (campo 011-000)
- A documentação indica que você pode enviar o campo 011-000 com a forma de pagamento desejada:
  Pagamento | Conecte seu sistema a múltiplas adquirentes com facilidade
  - Exemplo:
  - 011-000 = 20 → Débito à vista.
  - 011-000 = 10 → Crédito à vista.
  - 011-000 = 30 → PIX/Carteira digital.
  - Consulte a tabela de tipos de transação da integração (a mesma usada em outras documentações ConnectTEF).
Ponto de atenção
- O valor (003-000) e a forma de pagamento (011-000) devem ser definidos conforme a venda em andamento no PDV.
Passo 2 – Gerenciador TEF indica que está ativo (IntPos.Sts)
- Após receber o arquivo de requisição em REQ, o Gerenciador TEF criará o arquivo:
  
  Pagamento | Conecte seu sistema a múltiplas adquirentes com facilidade
  - C:\TEF_DIAL\RESP\IntPos.Sts
- Conteúdo típico:
  
  Pagamento | Conecte seu sistema a múltiplas adquirentes com facilidade
```
 000-000 = CRT
 001-000 = 0
 999-999 = 0
```
- Função desse arquivo:
  Pagamento | Conecte seu sistema a múltiplas adquirentes com facilidade
  - Indicar para a automação que o Gerenciador TEF está ativo e pronto para processar a transação.
Ponto de atenção
- Se não houver resposta em até 7 segundos, a documentação informa que o Gerenciador não está ativo.
  Pagamento | Conecte seu sistema a múltiplas adquirentes com facilidade
- Nessa situação, seu sistema deve alertar o operador e/ou tentar reiniciar o TEF.
Passo 3 – Seleção da rede no Gerenciador
- Com o Gerenciador ativo, ele exibirá, no POS ou na interface TEF, uma tela de seleção da rede desejada (adquirente/bandeira).
  Pagamento | Conecte seu sistema a múltiplas adquirentes com facilidade
- O operador escolhe, por exemplo, STONE, CIELO, REDE, etc. conforme as opções disponíveis.
Ponto importante
- Essa interação é feita pela interface do Gerenciador TEF; a automação não controla essa tela, apenas aguarda a resposta via arquivo.
Passo 4 – Gerenciador envia resposta da operação (IntPos.001 em RESP)
- Após a conclusão da operação de pagamento, o Gerenciador grava o arquivo de resposta:
  
  Pagamento | Conecte seu sistema a múltiplas adquirentes com facilidade
  - C:\TEF_DIAL\RESP\IntPos.001
- Exemplo de operação bem-sucedida:
  
  Pagamento | Conecte seu sistema a múltiplas adquirentes com facilidade
```
 000-000 = CRT
 001-000 = 1369582303
 003-000 = 200
 009-000 = 0
 010-000 = STONE
 011-000 = 20
 012-000 = 39241081811116
 013-000 = 811116
 015-000 = 1810152244
 018-000 = 1
 022-000 = 18102024
 023-000 = 152244
 027-000 = 753|811116
 028-000 = 15
 029-001 = " INTEGRACAO PARTNER PROGRAM "
 029-002 = " 89.324.856/0001-26 "
 029-003 = "-----------------------------------------"
 029-004 = " VIA CLIENTE "
 029-005 = "-----------------------------------------"
 029-006 = "REDE STONE"
 029-007 = "VALOR 2,00"
 029-008 = "FORMA PAGAMENTO DÉBITO À VISTA"
 029-009 = "CARTAO 498408****5491"
 029-010 = "ADMINISTRADORA PAYWAVE/VISA"
 029-011 = "NSU 39241081811116"
 029-012 = "AUT 811116"
 029-013 = "-----------------------------------------"
 029-014 = " PDVPOS - TEF "
 029-015 = " 18/10/2024 15:22:44 "
 040-000 = PAYWAVE/VISA
 400-001 = 89.324.856/0001-26
 400-002 = VISA
 999-999 = 0
```
- Interpretação dos campos principais:
  Pagamento | Conecte seu sistema a múltiplas adquirentes com facilidade
  - 009-000 = 0 → Status da operação: 0 significa sucesso.
  - 010-000 = STONE → Rede/adquirente utilizada.
  - 011-000 = 20 → Tipo da transação (ex.: Débito à vista).
  - 012-000 = 39241081811116 → NSU (Número Sequencial Único da transação).
  - 013-000 = 811116 → Código de autorização.
  - 022-000 / 023-000 → Data e hora da transação no comprovante.
  - 027-000 = 753|811116 → Campo de finalização, agrupando dados importantes (ex.: código interno + autorização).
  - 028-000 = 15 → Quantidade de linhas de comprovante.
  - 029-XXX → Conteúdo de cada linha do comprovante (texto já formatado para impressão).
  - 040-000, 400-001, 400-002 → Dados adicionais como administradora, CNPJ, bandeira do cartão.
Ponto de atenção
- A automação deve:
  - Interpretar 009-000 para saber se deu certo.
  - Usar os campos de comprovante (029-XXX) para imprimir o comprovante TEF na impressora do PDV.
  - Armazenar NSU, código de autorização e dados relevantes para conciliação.
Exemplo de operação mal-sucedida (cancelamento / erro)
- Exemplo de resposta indicando operação mal-sucedida:
  Pagamento | Conecte seu sistema a múltiplas adquirentes com facilidade
```
 000-000 = CRT
 001-000 = 1369582303
 003-000 = 200
 009-000 = 1
 010-000 = STONE
 028-000 = 0
 030-000 = OPERAÇÃO CANCELADA
 999-999 = 0
```
- Interpretação:
  Pagamento | Conecte seu sistema a múltiplas adquirentes com facilidade
  - 009-000 = 1 → Operação com falha ou cancelada.
  - 028-000 = 0 → Sem comprovante a imprimir.
  - 030-000 = OPERAÇÃO CANCELADA → Mensagem que deve ser exibida ao operador.
Ponto importante
- Em caso de falha ou cancelamento:
  - Não registrar a venda como paga.
  - Exibir a mensagem de 030-000 para o operador.
  - Permitir nova tentativa ou outro meio de pagamento.
Tratamento do status de impressão (CNF e NCN)

A documentação traz duas situações específicas após a operação de pagamento:

Pagamento | Conecte seu sistema a múltiplas adquirentes com facilidade
- Quando não há comprovante ou a impressão foi bem-sucedida
  - A automação deve enviar um arquivo de confirmação (CNF) para C:\TEF_DIAL\REQ\IntPos.001:
    Pagamento | Conecte seu sistema a múltiplas adquirentes com facilidade
```
   000-000 = CNF
   001-000 = 1369582303
   010-000 = STONE
   012-000 = 39241081811116
   027-000 = 753|811116
   999-999 = 0
```
- Função: informar ao Gerenciador TEF que a impressão ocorreu corretamente ou não é necessária, concluindo o ciclo.
  - Quando há comprovante e ocorre falha na impressão
- A automação deve enviar um arquivo NCN (não confirmado) para C:\TEF_DIAL\REQ\IntPos.001:
  
  Pagamento | Conecte seu sistema a múltiplas adquirentes com facilidade
```
   000-000 = NCN
   001-000 = 1369582303
   999-999 = 0
```
- Função: sinalizar ao Gerenciador que houve problema na impressão, permitindo que o TEF tome ações adequadas (por exemplo, reimpressão).
Ponto de atenção
- Sempre use o mesmo identificador (001-000) e NSU (012-000) para relacionar CNF/NCN com a operação original.
Fluxo completo resumido para implementação
1. Venda no PDV
  - A automação calcula o valor da venda.
2. Gerar arquivo de requisição em REQ (IntPos.001)
  - Preencher 000-000 = CRT, 003-000 (valor) e, opcionalmente, 011-000 (tipo de pagamento).
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 como 009-000 (status), 012-000 (NSU), 013-000 (autorização), 029-XXX (comprovante).
5. Imprimir comprovante, conforme 028-000 e 029-XXX
6. Retornar CNF ou NCN para REQ\IntPos.001
  - CNF: impressão ok ou sem comprovante.
  - NCN: falha na impressão.
7. Atualizar venda e registros internos
  - Sucesso (009-000 = 0): marcar venda como paga e armazenar NSU/autorização.
  - Falha: registrar motivo e manter venda como não paga.

Informações Importantes

Diretórios padrão:
- Requisição: C:\TEF_DIAL\REQ\IntPos.001.
- Resposta: C:\TEF_DIAL\RESP\IntPos.001 e IntPos.Sts.
  Pagamento | Conecte seu sistema a múltiplas adquirentes com facilidade
Status da operação:
- 009-000 = 0 → pagamento aprovado.
- 009-000 ≠ 0 → pagamento cancelado ou com falha.
  Pagamento | Conecte seu sistema a múltiplas adquirentes com facilidade
Comprovante:
- 028-000 → quantidade de linhas do comprovante.
- 029-XXX → cada linha de texto a ser impressa.
Confirmação de impressão:
- CNF → impressão ok ou inexistente.
- NCN → falha na impressão.
  Pagamento | Conecte seu sistema a múltiplas adquirentes com facilidade
Benefícios de seguir corretamente o procedimento:
- Integração totalmente compatível com o Gerenciador TEF ConnectTEF.
- Pagamentos com rastreabilidade completa (NSU, autorização, comprovante).
- Tratamento robusto de erros e falhas de impressão, evitando perdas de controle fiscal/financeiro.

Este texto está pronto para ser copiado em um documento Word da sua base de conhecimento. Aplique o padrão visual definido: 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 iniciantes.

Você achou esse artigo útil?

Problema de Comunicação Constante no Conect TEF

Problema de Comunicação Constante no Conect TEF Descrição do Problema O sistema ...
Conect TEF fechando sozinho

Conect TEF fechando sozinho. Descrição do Problema Alguns clientes que utilizam o Co...
Como acessar e cadastrar gerenciador (NOME DO SISTEMA).

Resumo do que será ensinado Neste documento será apresentado, de forma detalhada e passo a...
CONNECTEF – MODELO DE IMPLANTAÇÃO AUTÔNOMO (SELF‑SERVICE).

Resumo do que será ensinado Neste documento você vai entender, de forma estruturada e simp...
CONNECTTEF – INTRODUÇÃO À PLATAFORMA.

Resumo do que será ensinado Neste documento você vai entender, de forma clara e estruturad...

Pesquisar artigos na Base de Dados de Conhecimento

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

Você achou esse artigo útil?

Artigos relacionados

Problema de Comunicação Constante no Conect TEF

Conect TEF fechando sozinho

Como acessar e cadastrar gerenciador (NOME DO SISTEMA).

CONNECTEF – MODELO DE IMPLANTAÇÃO AUTÔNOMO (SELF‑SERVICE).

CONNECTTEF – INTRODUÇÃO À PLATAFORMA.