Multiplus Card [Docs] Multiplus Card [Docs]

Descrição dos Campos

CampoConteúdo / Descrição
000-000HEADER

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 Padrão está ativo
ADM - Administrativa
REL - Relatório
CRT - Cartão
CPF - Solicita o CPF na tela do pinpad
CEL - Recarga de Celular
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.
001-000IDENTIFICAÇÃ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-000DOCUMENTO FISCAL VINCULADO

Finalidade:
Número do documento fiscal vinculado à forma de pagamento ou finalização.

Formato:
Numérico de até 12 bytes.
003-000VALOR TOTAL

Finalidade:
Valor total desta forma de pagamento.

Formato:
Numérico de até 12 bytes, sendo duas casas decimais sem a virgula separadora
004-000MOEDA

Finalidade:
Indica a moeda utilizada na operação

Formato:
Numérico de 1 byte

Conteúdos Válidos:
0 – para Real
1 – para Dólar
009-000STATUS 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-0X0NOME DA REDE (OPERADORA/CREDENCIADORA)

Finalidade:
Nome da rede que tratou a transação

Formato:
Alfanumérico de até 16 bytes

Conteúdos Válidos:
CIELO
REDE
GETNET
BIN
STONE
etc.
010-0X1CNPJ DA REDE (OPERADORA/CREDENCIADORA)

Finalidade:
Informar o CNPJ da rede que tratou a transação

Formato:
Alfanumérico de até 14 bytes
010-0X2CÓDIGO SAT DA REDE

Finalidade:
Informar o código SAT da rede que tratou a transação

Formato:
Alfanumérico de até 3 bytes
011-00XTIPO 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
02- Transação Pix
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
26- Cartão de Débito Pré-Pago
27- Cartão de Crédito Pré-Pago
30- Outros Cartões
40- CDC
41- Consulta CDC
50- Convênio
60- Voucher
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.

Exemplo-1: 000-000 = ADM
011-000 = 00 (Administrativas: Reimpressão, Iniciação de Terminal etc.)

Exemplo-2: 000-000 = ADM
011-000 = 01 (Administrativa: Fechamento/Transmissão de Lote)

Exemplo-3: 000-000 = ADM
011-000 = 03 (Cancelamento Genérico (Crédito, Débito, Private Label, qualquer que tenha sido a modalidade: à Vista, Parcelado pelo Estabelecimento ou pela Administradora))

Exemplo-4: 000-000 = ADM
011-000 = 10 (Cancelamento de Cartão de Crédito, qualquer que tenha sido a modalidade: à Vista, Parcelado pelo Estabelecimento ou pela Administradora)

Exemplo-5: 000-000 = ADM
011-000 = 20 (Cancelamento de Cartão de Débito, qualquer que tenha sido a modalidade: à Vista, Pré-Datado, Parcelado etc.)
012-00XNÚMERO DA TRANSAÇÃO - NSU

Finalidade:
Indica o número de sequê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).

Quando este campo é enviado do Gerenciador Padrão para o Aplicativo de Automação Comercial, ele representa o NSU do Host estabelecido para a transação.

Quando este campo é enviado do Aplicativo de Automação Comercial para o Gerenciador Padrão, ele representa o NSU da transação a ser tratada (cancelada, confirmada etc.)

Formato:
Alfanumérico de até 12 bytes.
013-00XCÓ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.

Formato:
Alfanumérico de até 6 bytes.
014-000NÚMERO DO LOTE DA TRANSAÇÃO

Finalidade:
Indica o número de lote da transação

Formato:
Alfanumérico de até 10 bytes.
015-000TIMESTAMP DA TRANSAÇÃO HOST

Finalidade:
Indica a data e hora da transação no Host

Formato:
Numérico – DDMMHHMMSS
016-000TIMESTAMP DA TRANSAÇÃO LOCAL

Finalidade:
Indica a data e hora da transação no ponto de venda.

Formato:
Numérico – DDMMHHMMSS
017-00XTIPO PARCELAMENTO

Finalidade:
Indica o tipo de parcelamento aplicado à operação

Formato:
Numérico de 1 byte

Conteúdos Válidos:
0 – Parcelado estabelecimento
1 – Parcelado administradora
018-00XQUANTIDADE 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-yyyDATA 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-yyyVALOR 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-yyyNÚ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-000DATA DA TRANSAÇÃO - COMPROVANTE

Finalidade:
Indica a data da transação

Formato:
Numérico – DDMMAAAA
023-000HORA DA TRANSAÇÃO (LOCAL) - COMPROVANTE

Finalidade:
Indica a hora da transação

Formato:
Numérico – HHMMSS
024-000DATA PRÉ-DATADO

Finalidade:
Contém data de agendamento para pré-datado.

Formato:
Numérico – DDMMAAAA
025-000NÚ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-000TIMESTAMP DA TRANSAÇÃO CANCELADA - Host

Finalidade:
Contém a data e hora da transação cancelada no Host.

Formato:
Numérico – DDMMHHMMSS
027-000FINALIZAÇÃO

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

Formato:
Alfanumérico de até 32 bytes
028-000QUANTIDADE 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
028-001QUANTIDADE DE LINHAS DO 1º COMPROVANTE

Finalidade:
Indica a quantidade de linhas do 1º comprovante (Caso possuir 2 vias, o corte será realizado após o número indicado nesse campo). Para retornar esse campo, precisa alterar o Layout de Integração para “TEF_DIAL (c/ linha 028-001)” nas configurações do Client TEF, na aba “Parâmetros”.

Formato:
Numérico de até 3 bytes
029-yyyIMAGEM 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-000TEXTO 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-000TEXTO 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-00XNOME DA ADMINISTRADORA (BANDEIRA)

Finalidade:
Identifica a Administradora do Cartão utilizado.

Formato:
Alfanumérico de até 12 bytes.

Conteúdos Válidos:
ELECTRON
MAESTRO
MASTERCARD
VISA
ELO
GOODCARD
VALECARD
etc.
740-00XNÚMEROS DO CARTÃO

Finalidade:
Exibe o número do cartão que realizou a transação.

Formato:
Numérico de 16 bytes.

Conteúdos Válidos:
0000000000000000 a 9999990000009999
741-00XNOME DO PORTADOR DO CARTÃO

Finalidade:
Exibe o nome do portador do cartão que realizou a transação

Formato:
Alfanumérico de até 20 bytes.
742-00XVALIDADE DO CARTÃO DO PORTADOR

Finalidade:
Exibe o número de validade do cartão que realizou a transação

Formato:
Numérico de 4 bytes.
743-00XVALOR RESTANTE

Finalidade:
Exibe o valor restante à ser pago quando utilizada a função de múltiplos cartões.

Formato:
Numérico de até 12 bytes, sendo duas casas decimais sem a virgula separadora.
999-999TRAILER - REGISTRO FINAL

Finalidade:
Indica fim do arquivo.

Formato:
Numérico de 1 byte – Constante zero

Campos Opcionais - Integração de forma direta – Requisição com definições da transação

CampoConteúdo / Descrição
250-000Conteúdos Válidos:
KM (Venda Frota)
250-001Conteúdos Válidos:
Placa (Venda Frota)
250-002Conteúdos Válidos:
Matrícula (Venda Frota)
261-000Conteúdos Válidos:
Quantidade de Itens
261-011Conteúdos Válidos (ITEM 01):
Código do Produto
261-012Conteúdos Válidos (ITEM 01):
Descrição do Produto
261-013Conteúdos Válidos (ITEM 01):
Quantidade (3 Casas decimais)
261-014Conteúdos Válidos (ITEM 01):
Valor Unitário (3 Casas decimais)
261-015Conteúdos Válidos (ITEM 01):
Desconto (2 Casas decimais) (Venda Frota)
261-016Conteúdos Válidos (ITEM 01):
Valor Total (2 Casas decimais)
261-021Conteúdos Válidos (ITEM 02):
Código do Produto
261-022Conteúdos Válidos (ITEM 02):
Descrição do Produto
261-023Conteúdos Válidos (ITEM 02):
Quantidade (3 Casas decimais)
261-024Conteúdos Válidos (ITEM 02):
Valor Unitário (3 Casas decimais)
261-025Conteúdos Válidos (ITEM 02):
Desconto (2 Casas decimais) (Venda Frota)
261-026Conteúdos Válidos (ITEM 02):
Valor Total (2 Casas decimais)
261-XX1Conteúdos Válidos (ITEM XX – Alterar o ‘XX’ pelo número do item de 01 até 99):
Código do Produto
261-XX2Conteúdos Válidos (ITEM XX – Alterar o ‘XX’ pelo número do item de 01 até 99):
Descrição do Produto
261-XX3Conteúdos Válidos (ITEM XX – Alterar o ‘XX’ pelo número do item de 01 até 99):
Quantidade (3 Casas decimais)
261-XX4Conteúdos Válidos (ITEM XX – Alterar o ‘XX’ pelo número do item de 01 até 99):
Valor Unitário (3 Casas decimais)
261-XX5Conteúdos Válidos (ITEM XX – Alterar o ‘XX’ pelo número do item de 01 até 99):
Desconto (2 Casas decimais) (Venda Frota)
261-XX6Conteúdos Válidos (ITEM XX – Alterar o ‘XX’ pelo número do item de 01 até 99):
Valor Total (2 Casas decimais)
800-001Conteúdos Válidos:
0 = Crédito
1 = Débito
2 = Private Label
3 = Débito CDC
4 = Link de Pagamento
5 = Pix
6 = Lista de Link de Pagamento
7 = Parcele Mais
800-002Conteúdos Válidos:
0 = A vista
1 = Parcelado
800-003Conteúdos Válidos:
0 = Parcelado ADM (Juros da transação cobrado do dono do cartão)
1 = Parcelado Loja (Juros da transação cobrado da loja)
800-004Conteúdos Válidos:
(Qtde. de parcelas)
800-005Conteúdos Válidos:
(CNPJ da empresa)
800-006Conteúdos Válidos:
1 = PINPAD (Finalização de vendas através do equipamento pinpad)
2 = CIELO LIO (Finalização de vendas através do equipamento Cielo Lio)
3 = PINPDV (Finalização de vendas através do aplicativo PINPDV no SmartPOS)
800-007Conteúdos Válidos:
(Código de controle de transação)
800-008Conteúdos Válidos:
(0-Exibe tela para consultar CPF / 1-Solicita CPF somente no pinpad)
800-009Conteúdos Válidos:
Texto Livre (Link de Pagamento)
800-010Conteúdos Válidos:
Quantidade das parcelas (Link de Pagamento)
800-011Conteúdos Válidos:
Telefone com DDD (Link de Pagamento)
800-012Conteúdos Válidos:
Texto Livre (Link de Pagamento)
800-013Conteúdos Válidos:
Parâmetros Split, válido somente para Multiplus Pay
800-014Conteúdos Válidos:
Campo Livre Split, válido somente para Multiplus Pay
Anterior
Tipos de Campos
Próximo
Exemplo de Utilização

© 2025 Multiplus Card. Todos os direitos reservados.