Layout de Mensagens de Comunicação
Introdução
As descrições aqui apresentadas exibem o formato que devem ter as mensagens geradas pela Automação Comercial e o formato da mensagem de retorno gerada pelo modelo de integração troca de arquivos, com a confirmação ou não da transação.
As mensagens serão transferidas por meio de arquivo tipo texto onde cada linha contém um tipo de informação. As linhas possuem formato padrão e tamanho variável, utilizando conceito de palavra chave. O formato genérico é:
AAA-BBBC=CDDDDDDD......DDDDDEF
Onde:
A - Identificação do tipo de informação ou campo
B - Nº de seqüência complementar ao tipo de informação ou campo
C - Posição contendo espaço ou branco
D - Informação (sempre alinhada a esquerda, sem preenchimento de zeros ou espaços)
E - Carriage Return (CR) =13 (segundo a tabela ASCII)
F - Line Feed (LF) = 10 (segundo a tabela ASCII)
Os tipos de operações possíveis são:
| Tipo de operação | Descrição |
|---|---|
| ATV | Verifica se a aplicação de gerenciamento da troca de arquivos está ativa |
| ADM | Permite o acionamento da Troca de arquivos para execução das funções administrativas |
| CRT | Pedido de autorização para transação por meio de cartão |
| CNC | Cancelamento de venda efetuada por qualquer meio de pagamento |
| CNF | Confirmação da venda e impressão de cupom |
| NCN | Não confirmação da venda e/ou da impressão. |
| CDP | Pedido de coleta de dados. |
Verificação pela Automação Comercial se o Gerenciador está ativo deve ser feita através:
-
Função ATV:
A Automação Comercial envia as mensagens ao Gerenciador conforme item 4.1.
Se a Automação Comercial receber em até 7 segundos o arquivo C:\TEF_DIAL\RESP\IntPos.Sts conforme item 4.2 significa que o Gerenciador está ativo e a integração via troca de arquivos está disponivel.
-
Toda vez que o Gerenciador Padrão entrar no ar irá informar para a Automação Comercial que está ativo através do arquivo Ativo.001 que será gravado no diretório \Tef_dial\resp , com os campos:
‘000-000 = TEF’
‘016-000 = DDMMHHMMSS’ (Timestamp)
‘999-999 = 0’
Se não existir este arquivo no diretório significa que o Gerenciador não está ativo e não será possível integrar via troca de arquivos.
O cancelamento de venda pode ser feito de duas formas:
⦁ Pela operação ADM, onde o Gerenciador abre uma tela para a captura dos dados
da transação a ser cancelada.
⦁ Pela operação CNC, onde o Aplicativo de Automação Comercial captura os dados da
transação a ser cancelada e as transfere para o Gerenciador.
A seguir apresentamos os tipos de informações (ou campos) que deverão estar presentes nos arquivos enviados e recebidos pela Automação Comercial. As informações (ou campos) variam de acordo com o tipo de operação e estão assinalados com ‘M’ quando mandatórios, ‘O’ quando opcionais e ‘-‘ quando ausentes.
Notar que o aplicativo de automação deve estar preparado para receber e ignorar os tipos de registros que ele desconheça. Essa característica é importante para manter compatibilidade com versões futuras.
Quando houver discrepância entre o conteúdo do campo enviado pelo Aplicativo de Automação Comercial e o recebido pelo Gerenciador valerá o do Troca de Arquivos.
Legenda para as seguintes tabelas:
M = Mandatório
O = Opcional
E = Eco da Solicitação
A = Para transação aprovada
- = Ausente/Não
Campos presentes nas mensagens geradas pelo Aplicativo de Automação Comercial - Solicitações (C:\TEF_DIAL\REQ\IntPos.001)
| Código do Campo | Tipo de Informação | ATV | ADM | CRT | CNC | CNF | NCN | CDP |
|---|---|---|---|---|---|---|---|---|
| 000-000 | HEADER | M | M | M | M | M | M | M |
| 001-000 | IDENTIFICAÇÃO | M | M | M | M | M | M | - |
| 002-000 | DOCUMENTO FISCAL VINCULADO | - | - | O | O | O | O | - |
| 003-000 | VALOR TOTAL | - | - | M | M | - | - | - |
| 004-000 | MOEDA | - | - | O | - | - | - | - |
| 006-000 | TIPO DE PESSOA | - | - | - | - | - | - | O(5) |
| 010-000 | NOME DA REDE | - | - | - | M | M | M | - |
| 012-000 | NÚMERO DA TRANSAÇÃO - NSU TEF | - | O(4) | - | M | M | M | - |
| 017-000 | TIPO PARCELAMENTO | - | - | O | - | - | - | - |
| 022-000 | DATA DA TRANSAÇÃO - COMPROVANTE | - | O(4) | - | M | - | - | - |
| 023-000 | HORA DA TRANSAÇÃO - COMPROVANTE | - | - | - | M | - | - | - |
| 027-000 | NÚMERO DA TRANSAÇÃO - NSU HOST | - | - | - | - | M | M | - |
| 727-000 | TAXA DE SERVIÇO | - | - | O(3) | - | - | - | - |
| 728-000 | TAXA DE EMBARQUE | - | - | O(3) | - | - | - | - |
| 730-000 | OPERAÇÃO | - | O | - | - | - | - | - |
| 731-000 | TIPO DE CARTÃO | - | O | O | - | - | - | - |
| 732-000 | TAXA DE EMBARQUE | - | O | O | - | - | - | - |
| 749-000 | FORMA DE PAGAMENTO | - | O | - | - | - | - | - |
| 800-000 | Indicador da operação | - | OE | - | O(1) | - | - | - |
| 802-000 | TIPO DE VENDA | - | OE | O(2) | O(1) | - | - | - |
| 804-000 | TIPO DE COLETA | - | - | - | - | - | - | M |
| 806-yyy | ITENS SPLIT | - | - | O(6) | - | - | - | - |
| 807-yyy | RECEBEDORES SPLIT | - | - | M(6) | - | - | - | - |
| 809-000 | JSON DE ENTRADA - CONSULTA QRLINX (*) | - | - | M(10) | - | - | - | - |
| 810-000 | JSON DE ENTRADA - PARÂMETROS TRANSAÇÃO QRCODE (*) | - | - | O | - | - | - | - |
| 999-999 | TRAILER - REGISTRO FINAL | M | M | M | M | M | M | M |
Observações:
(1) Somente existem para cancelamento de operação com cheques.
(2) Caso não seja especificado, será assumido um valor padrão. Ver no detalhamento do campo.
(3) Se não fornecido, será assumido o valor 0.
(4) Usado somente para a operação de reimpressão de cupom.
(5) Somente será considerado o valor enviado caso o campo 804 não estiver preenchido
(6) Usados somente para operações de crédito ou débito split
(10) Usado somente em consultas à rede QRLinx (função administrativa com campo 800-000 possuindo o valor 66)
(*) Campos utilizados somente na rede QRLinx. Estes campos são referentes a features que não estão liberadas 100% em produção, portanto não utilize-os sem a expressa recomendação.
Campos presentes nas mensagens geradas pelo Gerenciador - Status (C:\TEF_DIAL\RESP \IntPos.Sts)
| Código do Campo | Tipo de Informação | ATV | ADM | CRT | CNC | CNF | NCN | CDP |
|---|---|---|---|---|---|---|---|---|
| 000-000 | HEADER | M | M | M | M | M | M | M |
| 001-000 | IDENTIFICAÇÃO | M | M | M | M | M | M | - |
| 999-999 | TRAILER – REGISTRO FINAL | M | M | M | M | M | M | M |
Campos presentes nas mensagens geradas pelo Gerenciador - Respostas (C:\TEF_DIAL\RESP \IntPos.001)
| Código do Campo | Tipo de Informação | ATV | ADM | CRT | CNC | CDP |
|---|---|---|---|---|---|---|
| 000-000 | HEADER | - | M | M | M | M |
| 001-000 | IDENTIFICAÇÃO | - | M | M | M | - |
| 002-000 | DOCUMENTO FISCAL VINCULADO | - | O | O(3) | O(3) | - |
| 003-000 | VALOR TOTAL | - | O | M | M | - |
| 004-000 | MOEDA | - | O | M(3) | M(3) | - |
| 006-000 | TIPO DE PESSOA | - | - | - | - | O |
| 007-000 | DOCUMENTO DA PESSOA | - | - | - | - | O |
| 009-000 | STATUS DA TRANSAÇÃO | - | M | M | M | - |
| 010-000 | NOME DA REDE | - | M | M | M | - |
| 011-000 | TIPO DA TRANSAÇÃO | - | M | M | M | - |
| 012-000 | NÚMERO DA TRANSAÇÃO - NSU TEF | - | O | M(1) | M(1) | - |
| 013-000 | CÓDIGO DE AUTORIZAÇÃO DA TRANSAÇÃO | - | O | O | O | - |
| 013-001 | CÓDIGO DE AUTORIZAÇÃO DA TRANSAÇÃO (QR CODE) | - | - | O | - | - |
| 014-000 | NÚMERO DO LOTE DA TRANSAÇÃO | - | O | O | O | - |
| 015-000 | TIMESTAMP DA TRANSAÇÃO - HOST | - | O | M(1) | M(1) | - |
| 016-000 | TIMESTAMP DA TRANSAÇÃO - LOCAL | - | O | O | O | - |
| 017-000 | TIPO PARCELAMENTO | - | - | O | - | - |
| 018-000 | QUANTIDADE DE PARCELAS | - | - | O | - | - |
| 019-yyy | DATA VENCIMENTO DA PARCELA | - | - | O | - | - |
| 020-yyy | VALOR DA PARCELA | - | - | O | - | - |
| 021-yyy | NÚMERO DA TRANSAÇÃO – NSU DA PARCELA | - | - | O | - | - |
| 022-000 | DATA DA TRANSAÇÃO - COMPROVANTE | - | O | M(1) | M(1) | - |
| 023-000 | HORA DA TRANSAÇÃO - COMPROVANTE | - | O | M(1) | M(1) | - |
| 024-000 | DATA PRÉ-DATADO | - | - | O | - | - |
| 025-000 | NÚMERO DA TRANSAÇÃO CANCELADA - NSU | - | O | - | M | - |
| 026-000 | TIMESTAMP DA TRANSAÇÃO CANCELADA | - | O | - | M | - |
| 027-000 | NÚMERO DA TRANSAÇÃO - NSU HOST | - | O | M(1) | M(1) | - |
| 027-001 | NÚMERO DA TRANSAÇÃO - NSU HOST (QRCODE) | - | O | M(1) | M(1) | - |
| 028-000 | QUANTIDADE DE LINHAS DO COMPROVANTE (*) | - | M | M | M | - |
| 029-yyy | IMAGEM DE CADA LINHA DO COMPROVANTE | - | O | O | O | - |
| 030-000 | TEXTO ESPECIAL OPERADOR | - | O | O | O | - |
| 031-000 | TEXTO ESPECIAL CLIENTE | - | O | O | O | - |
| 040-000 | NOME DA ADMINISTRADORA | - | O | O | O | - |
| 707-000 | VALOR ORIGINAL | - | - | M(1) | - | - |
| 709-000 | VALOR DE DESCONTO (DEVE SER RESGISTRADO COMO “DESCONTO” NA ECF) | - | - | - | - | - |
| 718-000 | NÚMERO LÓGICO DO TERMINAL | - | - | M(1) | - | - |
| 719-000 | CÓDIGO DO ESTABELECIMENTO | - | - | M(1) | - | - |
| 729-000 | STATUS DA CONFIRMAÇÃO | - | - | M(1) | - | - |
| 731-000 | TIPO DE CARTÃO | - | - | M(1) | - | - |
| 732-000 | TIPO DE FINANCIAMENTO | - | - | M(1) | - | - |
| 737-000 | VIAS DE COMPROVANTES | - | - | M(1) | - | - |
| 739-000 | ÍNDICE DA REDE ADQUIRENTE | - | - | M(1) | - | - |
| 801-000 | LOG DA TRANSAÇÃO APROVADA | - | - | - | - | - |
| 803-000 | LOG ESTENDIDO DA TRANSAÇÃO APROVADA | - | - | - | - | - |
| 804-000 | TIPO DE COLETA | - | - | - | - | M |
| 805-000 | VALOR DA COLETA | - | - | - | - | M |
| 809-000 | JSON DE SAÍDA - CONSULTA QRLINX | - | - | M(5) | - | - |
| 811-000 | LOG JSON DA TRANSACAO (Ver layout) | - | - | - | - | - |
| 999-999 | TRAILER - REGISTRO FINAL | - | M | M | M | M |
Observações:
(1) Somente existem se a transação foi aprovada.
(2) Devolve, opcionalmente, qual cheque foi cancelado, desde que o Módulo TEF permita cancelamentos.
(3) Somente estarão preenchidos se a informação for preenchida no arquivo de envio correspondente.
(4) Somente estarão preenchidos quando o campo CMC7 é ausente.
(5) Usado somente em consultas à rede QRLinx (função administrativa com campo 800-000 possuindo o valor 66)
(*) O campo 028-000 QUANTIDADE DE LINHAS DO COMPROVANTE está como obrigatório para todas as operações
por uma medida de segurança para o Aplicativo de Automação Comercial. O Gerenciador preencherá este
campo com zero “0” quando não houver comprovante.
Descrição dos campos
| Campo | Conteúdo / Descrição |
|---|---|
| 000-000 | HEADER Finalidade: Indica o início do arquivo e o tipo de operação relacionada ao arquivo. Formato: Alfanumérico de 3 bytes. Conteúdos válidos: ATV – Verifica se o Gerenciador está ativo ADM – Administrativa CRT – Cartão CNC – Cancelamento CNF – Confirmação de finalização da venda e impressão do cupom NCN – Não confirmação de finalização da venda por desistência do cliente ou erro na impressão do cupom. CDP – Pedido de coleta de dados |
| 001-000 | IDENTIFICAÇÃO Finalidade: Indica o número de controle da solicitação que está sendo feita. Este número é gerado pelo aplicativo de automação comercial, o qual deverá colocar um conteúdo diferente a cada nova solicitação. Este mesmo conteúdo é devolvido nos arquivos de resposta. Formato: Numérico de até 10 bytes. |
| 002-000 | DOCUMENTO FISCAL VINCULADO Finalidade: Número do documento fiscal vinculado à forma de pagamento ou finalização. Nota relativa a legislação ECF “…A emissão do comprovante de pagamento de operação ou prestação, efetuado com cartão de crédito ou débito automático em conta corrente somente poderá ser feita por meio de ECF, devendo o comprovante estar vinculado ao documento fiscal emitido na operação ou prestação respectiva, conforme disposto em legislação pertinente.”.Formato: Numérico de até 12 bytes. |
| 003-000 | VALOR TOTAL Finalidade: Valor total desta forma de pagamento. Formato: Numérico de até 12 bytes, sendo duas casas decimais sem a virgula separadora. |
| 004-000 | MOEDA Finalidade: Indica a moeda utilizada na operação Formato: Numérico de 1 byte Conteúdos Válidos: 0 – para Real |
| 006-000 | TIPO DE PESSOA Finalidade: Indica a coleta de um código de 4 a 12 dígitos, CPF ou CNPJ. Formato: Alfanumérico de 1 byte Conteúdos Válidos: F – para pessoa física – CPF J – para pessoa jurídica - CNPJ X – para coleta de código |
| 007-000 | DOCUMENTO DA PESSOA Finalidade: Valor coletado, sendo possível um CNPJ, CPF ou um código de 4 a 12 dígitos. Formato: Numérico 16 bytes. |
| 009-000 | STATUS DA TRANSAÇÃO Finalidade: Indica se a transação foi aprovada ou recusada e qual o motivo da recusa. Formato: Alfanumérico de até 3 bytes. Conteúdos Válidos: 0 – para transação aprovada Outro valor – transação negada |
| 010-000 | NOME DA REDE Finalidade: Nome da rede que tratou a transação Formato: Alfanumérico de até 8 bytes Conteúdos Válidos: AMEX REDECARD CIELO |
| 011-000 | TIPO DA TRANSAÇÃO Finalidade: Código identificando o tipo da transação executada Formato: Numérico de até 2 bytes. Conteúdos Válidos: 00 - Administrativas – Outras (Reimpressão, Iniciação de Terminal etc.) 01 - Administrativa – Fechamento/Transmissão de Lote 10- Cartão de Crédito à Vista 11- Cartão de Crédito Parcelado pelo Estabelecimento 12- Cartão de Crédito Parcelado pela Administradora 13- Pré-Autorização com Cartão de Crédito 20- Cartão de Débito à Vista 21- Cartão de Débito Pré-Datado 22- Cartão de Débito Parcelada 23- Cartão de Débito à Vista Forçada 24- Cartão de Débito Pré-Datado Forçada 25- Cartão de Débito Pré-Datado sem Garantia 30- Outros Cartões 40- CDC 41- Consulta CDC 50- Convênio 60- Voucher 70- Consulta Cheque 71- Garantia de Cheque 99-Outras Obs.: No cancelamento de venda feito através da operação ADM (Administrativa) este campo conterá o tipo da transação de venda que foi cancelada. Exemplos de HEADER como "ADM": Exemplo 01: 011-000 = 00(Administrativas: Reimpressão, Iniciação de Terminal etc.) Exemplo 02: 011-000 = 01(Administrativa: Fechamento/Transmissão de Lote) Exemplo 03: 011-000 = 10(Cancelamento de Cartão de Crédito, qualquer que tenha sido a modalidade: à Vista, Parcelado pelo Estabelecimento ou pela Administradora) Exemplo 04: 011-000 = 20(Cancelamento de Cartão de Débito, qualquer que tenha sido a modalidade: à Vista, Pré-Datado, Parcelado etc.) Exemplo 05: 011-000 = 71(Cancelamento de Garantia de Cheque) |
| 012-000 | NÚMERO DA TRANSAÇÃO - NSU TEF Finalidade: Indica o número de seqüência (NSU – Número Sequencial Único) da transação atribuído pelo TEF. Quando este campo é enviado do Gerenciador para o Aplicativo de Automação Comercial, ele representa o NSU do TEF estabelecido para a transação. Quando este campo é enviado do Aplicativo de Automação Comercial para o Gerenciador, ele representa o NSU da transação a ser tratada (cancelada, confirmada etc.) Formato: Numérico de até 12 bytes. |
| 013-000 | CÓDIGO DE AUTORIZAÇÃO DA TRANSAÇÃO Finalidade: Indica o número de autorização da transação atribuída pelo Host. Cada transação TEF possui um número de autorização. Este campo não é utilizado em transações de QR Code. Formato: Numérico de até 6 bytes. |
| 013-001 | CÓDIGO DE AUTORIZAÇÃO DA TRANSAÇÃO (QR CODE) Finalidade: Mesma finalidade do campo 013-000, mas se aplica especificamente a transações de QR Code. Isto foi feito porque, na transação de QR Code, o código da autorização da rede é maior que os 6 bytes reservados no campo 013-000. Referência na documentação da DLL Formato: Alfanumérico de até 80 bytes. |
| 014-000 | NÚMERO DO LOTE DA TRANSAÇÃO Finalidade: Indica o número de lote da transação Formato: Numérico de até 10 bytes. |
| 015-000 | TIMESTAMP DA TRANSAÇÃO HOST Finalidade: Indica a data e hora da transação no Host. Formato: Numérico – DDMMHHMMSS |
| 016-000 | TIMESTAMP DA TRANSAÇÃO LOCAL Finalidade: Indica a data e hora da transação no ponto de venda. Formato: Numérico – DDMMHHMMSS |
| 017-000 | TIPO PARCELAMENTO Finalidade: Indica o tipo de parcelamento aplicado à operação Formato: Numérico de 1 byte Conteúdos Válidos: 0 – À vista 1 – Financiamento Lojista 2 – Financiamento Administradora 3 - Pré-datada 4 - Parcelado com entrada 5 - Parcelado sem entrada |
| 018-000 | QUANTIDADE DE PARCELAS Finalidade: Indica o número de parcelas no caso de transações Parceladas (Crédito ou Débito). Formato: Numérico de até 2 bytes. |
| 019-yyy | DATA VENCIMENTO DA PARCELA Finalidade: Indica a data em que foi agendada a parcela (yyy). A parcela é indicada pelos três caracteres (yyy) do campo correspondente, onde yyy será igual a 001, 002, … respectivamente para cada uma das parcelas definidas no campo QUANTIDADE DE PARCELAS. Formato: Numérico - DDMMAAAA |
| 020-yyy | VALOR DA PARCELA Finalidade: Indica o valor da parcela (yyy). A parcela é indicada pelos três caracteres (yyy) do campo correspondente, onde yyy será igual a 001, 002, … respectivamente para cada uma das parcelas definidas no campo QUANTIDADE DE PARCELAS. Formato: Numérico de até 12 bytes, sendo duas casas decimais sem a vírgula separadora. |
| 021-yyy | NÚMERO DA TRANSAÇÃO – NSU DA PARCELA Finalidade: Indica o NSU da parcela (yyy). A parcela é indicada pelos três caracteres (yyy) do campo correspondente, onde yyy será igual a 001, 002, … respectivamente para cada uma das parcelas definidas no campo QUANTIDADE DE PARCELAS. Formato: Numérico de até 12 bytes. |
| 022-000 | DATA DA TRANSAÇÃO - COMPROVANTE Finalidade: Indica a data da transação Formato: Numérico – DDMMAAAA |
| 023-000 | HORA DA TRANSAÇÃO - COMPROVANTE Finalidade: Indica a hora da transação Formato: Numérico – HHMMSS |
| 024-000 | DATA PRÉ-DATADO Finalidade: Contém data de agendamento para pré-datado. Formato: Numérico – DDMMAAAA |
| 025-000 | NÚMERO DA TRANSAÇÃO CANCELADA - NSU Finalidade: Número de sequência (NSU) da transação cancelada. Formato: Numérico de até 12 bytes. |
| 026-000 | TIMESTAMP DA TRANSAÇÃO CANCELADA - HOST Finalidade: Contém a data e hora da transação cancelada no Host. Formato: Numérico - DDMMHHMMSS |
| 027-000 | NÚMERO DA TRANSAÇÃO - NSU HOST Finalidade: Dados recebidos do Módulo TEF que executou a transação e que devem ser devolvidos no comando de finalização de uma venda. Indica o número de seqüência (NSU – Número Sequencial Único) da transação atribuído pelo Host (Sistema das Redes de Cartão que recebe e trata as solicitações das transações TEF). Formato: Alfanumérico de até 30 bytes. |
| 027-001 | NÚMERO DA TRANSAÇÃO - NSU HOST (QR CODE) Finalidade: Mesma finalidade do campo 027-000, mas se aplica especificamente a transações de QR Code. Isto foi feito porque, na transação de QR Code, o NSU do Host é maior que os 30 bytes reservados no campo 027-000. Formato: Alfanumérico de até 80 bytes. |
| 028-000 | QUANTIDADE DE LINHAS DO COMPROVANTE Finalidade: Indica a quantidade de linhas do comprovante. Quando não há comprovante o campo deve conter zero. Formato: Numérico de até 3 bytes |
| 029-yyy | IMAGEM DE CADA LINHA DO COMPROVANTE Finalidade: Apresenta a imagem a ser impressa de cada uma das linhas do comprovante. A linha de impressão é indicada pelos três caracteres (yyy) do campo correspondente, onde yyy será igual a 001, 002, ... respectivamente para cada uma das linhas definidas no campo QUANTIDADE DE LINHAS DO COMPROVANTE. Formato: Alfanumérico de até 40 bytes. |
| 030-000 | TEXTO ESPECIAL OPERADOR Finalidade: Texto que, quando presente, deve ser apresentado pelo aplicativo de Automação Comercial ao operador. Formato: Alfanumérico de até 40 bytes. |
| 031-000 | TEXTO ESPECIAL CLIENTE Finalidade: Texto que, quando presente, deve ser apresentado pelo aplicativo de Automação Comercial ao cliente. Formato: Alfanumérico de até 40 bytes. |
| 040-000 | NOME DA ADMINISTRADORA Finalidade: Identifica a Administradora do Cartão utilizado. Formato: Alfanumérico de até 12 bytes. Conteúdos Válidos: CIELO AMEX MASTERCARD etc. |
| 707-000 | Valor original da transação informado pela Automação Comercial no campo 003-000 do arquivo de solicitação, em centavos da moeda identificada no campo 004-000. Valor total (003-000) = Valor original (707-000) – Valor do desconto (709-000) |
| 709-000 | Valor de desconto concedido pela rede administradora que deve registrado na ECF como “desconto” no cupom fiscal |
| 718-000 | Identificação do terminal. |
| 719-000 | Identificação do estabelecimento. |
| 727-000 | Valor correspondente à taxa de serviço cobrada adicionalmente aos produtos adquiridos, geralmente encontrada em estabelecimentos de alimentação (gorjeta), expressa-se em centavos da moeda especificada no campo 004-000. Essa quantia é somada ao total indicado no campo 003-000. |
| 728-000 | O montante referente às tarifas impostas por aeroportos, portos, estações rodoviárias, e assim por diante, acrescido ao preço do bilhete adquirido, expresso em centavos da moeda especificada no campo 004-000. Esta taxa é somada ao total informado no campo 003-000. |
| 729-000 | Indica o status da confirmação da transação, para transações bem-sucedidas (campo 009-000 = 0): 1: transação não requer confirmação, ou já confirmada 2: transação requer confirmação |
| 730-000 | Operação: 1: venda (necessita dos campos 731 e 749) 2: pré-autorização 3: consulta saldo do cartão 6: saque 13: compra de créditos / recarga de celular pré-pago (com cartão) 51: cancelamento de venda / reembolso 52: cancelamento de pré-autorização |
| 731-000 | Modalidade da transação com cartão: 0: qualquer / não definido (padrão) 1: crédito 2: débito 3: voucher |
| 732-000 | Modalidade de financiamento da transação: 1: à vista 2: parcelado pelo Emissor 3: parcelado pelo Estabelecimento |
| 737-000 | Indica quais vias devem ser impressas: 0: não há comprovante 1: imprimir somente a via do Cliente 2: imprimir somente a via do Estabelecimento 3: imprimir ambas as vias do comprovante |
| 739-000 | Índice da Rede Adquirente para a Linx. Novas Redes Adquirentes são acrescentadas periodicamente no sistema, por isso a Automação Comercial não deve restringir valores deste campo. |
| 749-000 | Forma de pagamento. Modalidade de pagamento: 1: cartão 8: carteira digital |
| 800-000 | Identifica qual operação ADM deve ser realizada ⦁ 001-Cancelamento ⦁ 002-Reimpressão ⦁ 003-Consulta Saldo ⦁ 004-Consulta Parcelas ⦁ 005-Serasa [REDECARD] ⦁ 006-Pré-Autorização ⦁ 007-Pagamentos [VISANET] ⦁ 008-Teste Rede Ativa ⦁ 009-Recarga Celular ⦁ 010-Resumo Vendas [REDECARD] ⦁ 011-Pagamento Fatura Private Label ⦁ 012-Cadastro Programa ⦁ 013-Acúmulo De Pontos ⦁ 014-Resgate De Pontos ⦁ 015-Estorno De Pontos ⦁ 016-Correspondente Bancário (Menu) ⦁ 024-Saque Identifica qual operação CRT deve ser realizada ⦁ 036-Transação de Crédito ⦁ 037-Transação de Débito ⦁ 038-Transação Voucher ⦁ 039-Transação Cartão Private Label ⦁ 045-Transação Cartão Frota ⦁ 046-Transação Cartão Crediário ⦁ 061-Transação ValeGás ⦁ 062-Transação Débito Qualidade ⦁ 063-Transação Débito MettaCard ⦁ 064-Transação Especial ⦁ 065-Transação QR Code ⦁ 066-Consulta à rede QR Linx |
| 801-000 | Dados da transação de acordo com a operação realizada. Algumas transações não possuem log, nestes casos, este campo não será retornado. Normalmente este campo será gerado para as transações que realizam movimentação financeira. O layout dos dados estão descritos no capítulo “Log das Transações” deste manual. Já o layout das operações CB encontram-se no manual “IntegraçãoCB.doc”. |
| 802-000 | ⦁ 0-Normal ⦁ 1-Promocional ⦁ Valor Padrão-0 |
| 803-000 | Dados estendidos da transação, de acordo com o item “2.3.17 – Registro de Log Estendido” deste documento. |
| 804-000 | Tipo de coleta solicitada. Clique aqui para consultar os tipos |
| 805-000 | Dados coletados pelo pinpad. |
| 806-yyy | ITENS SPLIT Finalidade: Identifica os itens em uma transação de crédito ou débito split, de acordo com o formato documentado nas páginas das funções. Ou seja, cada item é identificado em seu campo (yyy) correspondente, onde yyy deve será igual a 001, 002, etc. Formato: Alfanumérico de 50 bytes, pois este é o tamanho da estrutura que representa o item. Exemplo: "000000000100DESCRICAODOITEMSPLIT000051234567890123" |
| 807-yyy | RECEBEDORES SPLIT Finalidade: Identifica os recebedores em uma transação de crédito ou débito split, de acordo com o formato documentado nas páginas das funções. Ou seja, cada item é identificado em seu campo (yyy) correspondente, onde yyy deve será igual a 001, 002, etc. Formato: Numérico de 27 bytes, pois este é o tamanho da estrutura que representa o item. Exemplo: "000000000100259374170001070" |
| 809-000 | JSON DE ENTRADA/SAÍDA - CONSULTA QRLINX Finalidade: Na mensagem de solicitação, este campo contém o json que será enviado para o TEF e depois repassado à rede QRLinx para que seja realizada nela a consulta correspondente. Na mensagem de resposta, este campo contém o json retornado pela consulta. Formato: Texto em formato json, todo em uma única linha. O json de entrada deve seguir o formato documentado neste link: Transação Generica QRCode |
| 810-000 | JSON DE ENTRADA - PARÂMETROS TRANSAÇÃO QRCODE Finalidade: Json com parâmetros opcionais a serem utilizados em uma transação de QR Code Formato: Texto em formato json, todo em uma única linha. O json de entrada deve seguir o formato documentado neste link: Transação QRCode TransactionParamsData |
| 811-000 | JSON COM O LOG DA TRANSAÇÃO Finalidade: Json com informações referentes a transação executada Formato: Texto em formato json, todo em uma única linha. O json de saída seguirá o formato documentado neste link: Log Transação Json - Layout |
| 999-999 | TRAILER Finalidade: Indica fim do arquivo. Formato: Numérico de 1 byte – Constante zero |
Exemplo de uma venda com cartão de crédito
Arquivo de solicitação da compra (C:\TEF_DIAL\REQ\IntPos.001)
| Imagem do arquivo | Comentários |
|---|---|
| 000-000 = CRT | Header p/venda p/cartão |
| 001-000 = 1 | Identificação da solicitação |
| 002-000 = 123456 | Número do documento fiscal vinculado |
| 003-000 = 150000 | Valor total da transação (R$1.500,00) |
| 999-999 = 0 | Registro final do arquivo |
Arquivo de informação que a função está sendo executada (C:\TEF_DIAL\RESP \IntPos.Sts)
| Imagem do arquivo | Comentários |
|---|---|
| 000-000 = CRT | Header p/venda p/cartão |
| 001-000 = 1 | Identificação da solicitação |
| 999-999 = 0 | Registro final do arquivo |
Arquivo de resposta (C:\TEF_DIAL\RESP \IntPos.001)
| Imagem do arquivo | Comentários |
|---|---|
| 000-000 = CRT | Header p/venda p/cartão |
| 001-000 = 1 | Identificação da solicitação |
| 002-000 = 123456 | Número do documento fiscal vinculado |
| 003-000 = 150000 | Valor total da transação (R$1.500,00) |
| 004-000 = 1 | Moeda = real |
| 009-000 = 0 | Status da transação = OK |
| 010-000 = Nome da Rede | Nome da Rede |
| 011-000 = 10 | Tipo da Transação = Cartão de Crédito à Vista |
| 012-000 = 123456789000 | Número da transação - NSU TEF |
| 013-000 = 123456 | Código de Autorização da Transação |
| 014-000 = 1234567890 | Número do Lote da Transação |
| 015-000 = DDMMHHMMSS | Data e a Hora da Transação (Host) |
| 016-000 = DDMMHHMMSS | Data e Hora da Transação local (ponto de venda) |
| 018-000 = 00 | Número de parcelas - A vista |
| 022-000 = DDMMAAAA | Data da Transação - Comprovante |
| 023-000 = HHMMSS | Hora da Transação - Comprovante |
| 027-000 = 123XXYTZAAABC | NSU do Host |
| 028-000 = 20 | Quant. de linhas do comprovante = 20 |
| 029-001 = “ Rede X” | Imagem do comprovante – linha 01 |
| 029-002 = “ Loja X” | Imagem do comprovante – linha 02 |
| 029-003 = “ Rua X” | Imagem do comprovante – linha 03 |
| 029-004 = “TERM.666666” | Imagem do comprovante – linha 04 |
| 029-005 = “ADM. X” | Imagem do comprovante – linha 05 |
| . | Imagem do comprovante – linha .. |
| . | Imagem do comprovante – linha .. |
| . | Imagem do comprovante – linha .. |
| 029-017 = "" | Imagem do comprovante – linha 17 |
| 029-018 = "" | Imagem do comprovante – linha 18 |
| 029-019 = “ASSINATURA” | Imagem do comprovante – linha 19 |
| 029-020 = “CLIENTE X” | Imagem do comprovante – linha 20 |
| 040-000 = “ADM. X” | Administradora do Cartão |
| 718-000 = 001 | Número lógico do terminal |
| 719-000 = 0001 | Código do estabelecimento |
| 729-000 = 2 | Requer confirmação |
| 731-000 = 1 | Cartão de crédito |
| 732-000 = 1 | À vista |
| 737-000 = 3 | Imprimir ambas as vias do comprovante |
| 739-000 = 001 | Índice da rede adquirente |
| 999-999 = 0 | Registro final do arquivo |
Nota: Somente será disponibilizada uma cópia do comprovante,
ficando a cargo da Aplicação de Automação Comercial a emissão
da quantidade de vias necessárias, em função do tipo de impressora
disponível. Deverão haver ao menos duas "vias", uma para o cliente
e outra para o estabelecimento.
Arquivo de confirmação (C:\TEF_DIAL\REQ\IntPos.001)
| Imagem do arquivo | Comentários |
|---|---|
| 000-000 = CNF | Header p/ confirmação de finalização da venda e impressão do cupom |
| 001-000 = 1 | Identificação da solicitação |
| 002-000 = 123456 | Número do documento fiscal vinculado |
| 010-000 = Rede X | Rede responsável pela autorização |
| 012-000 = 123456789000 | Número da Transação - NSU TEF |
| 027-000 = 123XXYTZAAABC | NSU do Host |
| 999-999 = 0 | Registro final do arquivo |
Este conteúdo foi útil para você?