![Multiplus Card [Docs]](https://docs.multipluscard.com.br/images/logo.png){kind=logo}
Title here
Summary here
Descrição dos Campos
Aqui é apresentada uma descrição detalhada de todos os campos possível de serm utilizados na troca de mensagens entre a Automação e o Gerenciador de Pagamentos.
| 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 Padrão está ativo - ADM - Administrativa - CRT - Cartão - CEL - Recarga de Celular - REL - Relatório de Transações - CNC - Solicita o CPF na tela do Pinpad - 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. |
| 000-001 | HEADER Finalidade: Indica o início do arquivo e o tipo de operação relacionada ao arquivo. Formato: Alfanumérico de 11 bytes. Conteúdos válidos: - REIMPRESSAO Obs.: Quando chamar essa função, tem que passar os parâmetros como mandatório: - 012-000 = NSU - 022-000 = Data da Transação. |
| 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. 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 vírgula separadora. |
| 004-000 | MOEDA Finalidade: Indica a moeda utilizada na operação. Formato: Numérico de 1 byte. Conteúdos Válidos: - 0 – Real - 1 – Dolar. |
| 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 – Transação aprovada - Outro valor – Transação negada. |
| 010-0X0 | NOME 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-0X1 | CNPJ DA REDE (OPERADORA/CREDENCIADORA) Finalidade: Informar o CNPJ da rede que tratou a transação. Formato: Alfanumérico de até 14 bytes. |
| 010-0X2 | CÓ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-00X | 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 - 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. |
| 012-00X | NÚ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. Formato: Alfanumérico de até 12 bytes. |
| 013-00X | CÓDIGO DE AUTORIZAÇÃO DA TRANSAÇÃO Finalidade: Indica o número de autorização da transação atribuída pelo Host. Formato: Alfanumérico de até 6 bytes. |
| 014-000 | NÚMERO DO LOTE DA TRANSAÇÃO Finalidade: Indica o número de lote da transação. Formato: Alfanumé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-00X | TIPO 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-00X | 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). Formato: Numérico – DDMMAAAA. |
| 020-yyy | VALOR DA PARCELA Finalidade: Indica o valor da parcela (yyy). 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). 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 | FINALIZAÇÃ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-000 | QUANTIDADE DE LINHAS TOTAL DO 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. |
| 028-001 | QUANTIDADE DE LINHAS DO 1º COMPROVANTE Finalidade: Indica a quantidade de linhas do 1º comprovante. 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. 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-00X | NOME DA ADMINISTRADORA (BANDEIRA) Finalidade: Identifica a Administradora do Cartão utilizado. Formato: Alfanumérico de até 20 bytes. Conteúdos Válidos: - ELECTRON - ELO - GOODCARD - HIPERCARD - MAESTRO - MASTERCARD - SODEXO - VISA - VALECARD - etc. |
| 170-000 | NÚMERO DA TRANSAÇÃO – NSU HOST Finalidade: Indica o número de sequência (NSU – Número Sequencial Único) da transação atribuído pelo Host. Formato: Numérico de até 12 bytes. |
| 740-00X | NÚ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-00X | NOME 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-00X | VALIDADE 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-00X | VALOR 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 vírgula separadora. |
| 999-999 | TRAILER - REGISTRO FINAL Finalidade: Indica fim do arquivo. Formato: Numérico de 1 byte – Constante zero. |
| 250-000 | Conteúdos Válidos: - KM (Venda Frota). |
| 250-001 | Conteúdos Válidos: - Placa (Venda Frota). |
| 250-002 | Conteúdos Válidos: - Matrícula (Venda Frota). |
| 261-000 | Conteúdos Válidos: - Quantidade de Itens. |
| 261-011 | Conteúdos Válidos (ITEM 01): - Código do Produto. |
| 261-012 | Conteúdos Válidos (ITEM 01): - Descrição do Produto. |
| 261-013 | Conteúdos Válidos (ITEM 01): - Quantidade (3 Casas decimais). |
| 261-014 | Conteúdos Válidos (ITEM 01): - Valor Unitário (3 Casas decimais). |
| 261-015 | Conteúdos Válidos (ITEM 01): - Desconto (2 Casas decimais) (Venda Frota). |
| 261-016 | Conteúdos Válidos (ITEM 01): - Valor Total (2 Casas decimais). |
| 261-XX1 | Conteúdos Válidos (ITEM XX – Alterar o ‘XX’ pelo número do item de 01 até 99): - Código do Produto. |
| 261-XX2 | Conteúdos Válidos (ITEM XX – Alterar o ‘XX’ pelo número do item de 01 até 99): - Descrição do Produto. |
| 261-XX3 | Conteúdos Válidos (ITEM XX – Alterar o ‘XX’ pelo número do item de 01 até 99): - Quantidade (3 Casas decimais). |
| 261-XX4 | Conteúdos Válidos (ITEM XX – Alterar o ‘XX’ pelo número do item de 01 até 99): - Valor Unitário (3 Casas decimais). |
| 261-XX5 | Conteúdos Válidos (ITEM XX – Alterar o ‘XX’ pelo número do item de 01 até 99): - Desconto (2 Casas decimais) (Venda Frota). |
| 261-XX6 | Conteúdos Válidos (ITEM XX – Alterar o ‘XX’ pelo número do item de 01 até 99): - Valor Total (2 Casas decimais). |
| 800-001 | Conteúdos Válidos: - 0 = Crédito - 1 = Débito - 2 = Private Label - 3 = Débito CDC - 4 = Link de Pagamento - 5 = Pix - 6 = Impressão do Link de Pagamento Pago - 7 = Parcele Mais. Para Cartões Voucher e Débito Parcelado, verifique as configurações adicionais necessárias em Configurações Especiais |
| 800-002 | Conteúdos Válidos: - 0 = A vista - 1 = Parcelado. |
| 800-003 | Conteú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-004 | Conteúdos Válidos: - (Qtde de parcelas). |
| 800-005 | Conteúdos Válidos: - (CNPJ da empresa). |
| 800-006 | Conteú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-007 | Conteúdos Válidos: - (Código de controle de transação). |
| 800-008 | Conteúdos Válidos: - 0 - Exibe tela para consultar CPF - 1 - Solicita CPF somente no pinpad. |
| 800-009 | Conteúdos Válidos: - Nome da operadora a selecionar via Multiway. |
| 800-010 | Conteúdos Válidos: - Quantidade das parcelas (Link de Pagamento). |
| 800-011 | Conteúdos Válidos: - Telefone com DDD (Link de Pagamento). |
| 800-012 | Conteúdos Válidos: - Texto Livre (Link de Pagamento). |
| 800-013 | Conteúdos Válidos: - Parâmetros Split, válido somente para Multiplus Pay. |
| 800-014 | Conteúdos Válidos: - Campo Livre Split, válido somente para Multiplus Pay. |
Configurações Especiais
Cartões Voucher
Para habilitar transações com cartões do tipo voucher, ative a opção “Voucher” nas configurações, aba “Private Label”.
Na requisição da transação, defina o campo 800-001 com o valor 2, indicando que o tipo de transação é “Private Label”.
000-000 = CRT
001-000 = 123456
003-000 = 500
800-001 = 2
999-999 = 0
Cartões Banri
Os cartões Banri (cartão específico da adquirente Vero) são parcelados pela opção débito
800-001 = 1, para permitir o parcelamento desse cartão pela opção débito, precisa alterar dentro
das funções administrativas do TEF na aba “Parâmetros 2”, o parâmetro “Débito somente a vista:”
para “Não” conforme a imagem a seguir.
Anterior
Layout das MensagensPróximo
Exemplo de Comunicação