![Multiplus Card [Docs]](https://docs.multipluscard.com.br/images/logo.png){kind=logo}
Title here
Summary here
Tipos de Campos
A seguir são apresentados os tipos de campo que deverão estar presentes no header ‘CONTEUDO’ nas requisições realizadas no endpoint SetVendaTef pela Automação. As informações variam de acordo com o tipo de operação e possuem a seguinte indicação M quando é mandatório, O quando é opcional e - quando ausente.
Em seguida estarão os campos retornados pelo Gerenciador Padrão no endpoint GetVendasTef.
É importante que o aplicativo de automação esteja preparado para reconhecer e ignorar campos desconhecidos. Essa abordagem garante maior robustez e compatibilidade com versões futuras, permitindo a evolução do sistema sem comprometer integrações já existentes.
Em caso de discrepância entre o valor do campo enviado pela Automação Comercial e o valor processado pelo Gerenciador de Pagamentos, prevalecerá o conteúdo definido pelo Gerenciador de Pagamentos.
Campos do Header ‘Conteudo’ - SetVendaTef
| Campo | Tipo de Informação | ATV | ADM | CRT | CNC | CNF | NCN | REL | CPF |
|---|---|---|---|---|---|---|---|---|---|
| 000-000 | HEADER | M | M | M | M | M | M | M | M |
| 001-000 | IDENTIFICAÇÃO | M | 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 | - | - | - | - | - |
| 010-000 | NOME DA REDE | - | - | - | M | M(1) | M(1) | - | - |
| 012-000 | NÚMERO DA TRANSAÇÃO - NSU | - | - | - | M | M(1) | M(1) | - | - |
| 022-000 | DATA DA TRANSAÇÃO - COMPROVANTE | - | - | - | M | - | - | - | - |
| 023-000 | HORA DA TRANSAÇÃO - COMPROVANTE | - | - | - | M | - | - | - | - |
| 027-000 | FINALIZAÇÃO | - | - | - | - | M(1) | M(1) | - | - |
| 250-000 | KM (VENDA FROTA) | - | - | O | - | - | - | - | - |
| 250-001 | PLACA (VENDA FROTA) | - | - | O | - | - | - | - | - |
| 250-002 | MATRICULA (VENDA FROTA) | - | - | O | - | - | - | - | - |
| 261-000 | QUANTIDADE DE ITENS | - | - | O | - | - | - | - | - |
| 261-XX1 | CÓDIGO DO PRODUTO | - | - | O | - | - | - | - | - |
| 261-XX2 | DESCRIÇÃO DO PRODUTO | - | - | O | - | - | - | - | - |
| 261-XX3 | QUANTIDADE | - | - | O | - | - | - | - | - |
| 261-XX4 | VALOR UNITARIO | - | - | O | - | - | - | - | - |
| 261-XX5 | DESCONTO | - | - | O | - | - | - | - | - |
| 261-XX6 | VALOR TOTAL | - | - | O | - | - | - | - | - |
| 800-001 | TIPO DE TRANSAÇÃO | - | - | O | O | - | - | - | - |
| 800-002 | FORMA DE PAGAMENTO | - | - | O | O | - | - | - | - |
| 800-003 | JUROS DA TRANSAÇÃO | - | - | O | O | - | - | - | - |
| 800-004 | QUANTIDADE DE PARCELAS | - | - | O | O | - | - | - | - |
| 800-005 | CNPJ DO ESTABELECIMENTO | - | - | O | - | - | - | - | - |
| 800-006 | EQUIPAMENTO P/ RECEBIMENTO (PINPAD OU CIELO LIO) | - | - | O | - | - | - | - | - |
| 800-007 | CÓDIGO DE CONTROLE (CANCELAMENTO DE VENDAS) | - | - | O | O | - | - | - | - |
| 800-008 | EXIBE CONSULTA DE CPF | - | - | - | - | - | - | - | M |
| 800-009 | TEXTO LIVRE (LINK DE PAGAMENTO) | - | - | O | - | - | - | - | - |
| 800-010 | QUANTIDADE DE PARCELAS (LINK DE PAGAMENTO) | - | - | O | - | - | - | - | - |
| 800-011 | TELEFONE COM DDD (LINK DE PAGAMENTO) | - | - | O | - | - | - | - | - |
| 800-012 | TEXTO LIVRE (LINK DE PAGAMENTO) | - | - | O | - | - | - | - | - |
| 800-013 | PARAMETROS SPLIT, VALIDO SOMENTE PARA MULTIPLUS PAY | - | - | O | - | - | - | - | - |
| 800-014 | CAMPO LIVRE SPLIT, VALIDO SOMENTE PARA MULTIPLUS PAY | - | - | O | - | - | - | - | - |
| 999-999 | TRAILER - REGISTRO FINAL | M | M | M | M | M | M | M | M |
Legenda:
M= MandatórioO= Opcional-= Ausente
Observações
(1) Somente estarão preenchidos se a informação for fornecida na requisição correspondente.
Campos Retornados - GetVendasTef
| Campo | Tipo de Informação | ATV | ADM | CRT | CNC | CNF | NCN | REL | CPF |
|---|---|---|---|---|---|---|---|---|---|
| 000-000 | HEADER | - | M | M | M | M(3) | M(3) | M | M |
| 001-000 | IDENTIFICAÇÃO | - | M | M | M | M(3) | M(3) | M | - |
| 002-000 | DOCUMENTO FISCAL VINCULADO | - | O | O(2) | O(2) | - | - | - | - |
| 003-000 | VALOR TOTAL | - | O | M | M | - | - | - | - |
| 004-000 | MOEDA | - | O | M(2) | M(2) | - | - | - | - |
| 009-000 | STATUS DA TRANSAÇÃO | - | M | M | M | M(3) | M(3) | M | M |
| 010-0X0 | NOME DA REDE (OPERADORA/CREDENCIADORA) | - | M | M | M | M(3) | M(3) | - | - |
| 010-0X1 | CNPJ DA REDE (OPERADORA/CREDENCIADORA) | - | O | O | O | - | - | - | - |
| 010-0X2 | CÓDIGO SAT DA REDE | - | O | O | O | - | - | - | - |
| 011-00X | TIPO DA TRANSAÇÃO | - | M | M | M | - | - | - | - |
| 012-00X | NÚMERO DA TRANSAÇÃO - NSU | - | O | M(1) | M(1) | M(3) | M(3) | - | - |
| 013-00X | CÓDIGO DE AUTORIZAÇÃO DA TRANSAÇÃO | - | O | O | 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-00X | TIPO PARCELAMENTO | - | - | O | - | - | - | - | - |
| 018-00X | 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 | - | O | - | - | - | - |
| 026-000 | TIMESTAMP DA TRANSAÇÃO CANCELADA | - | O | - | O | - | - | - | - |
| 027-000 | FINALIZAÇÃO | - | O | M(1) | M(1) | M(3) | M(3) | - | - |
| 028-000 | QUANTIDADE TOTAL DE LINHAS DO COMPROVANTE (*) | - | M | M | M | M(3) | M(3) | M | M |
| 028-001 | RETORNA A ÚLTIMA LINHA DO 1º COMPROVANTE | - | O | O | O | - | - | O | - |
| 029-yyy | IMAGEM DE CADA LINHA DO COMPROVANTE | - | O | O | O | - | - | - | - |
| 030-000 | TEXTO ESPECIAL OPERADOR | - | O | O | O | M(3) | M(3) | M | O |
| 031-000 | TEXTO ESPECIAL CLIENTE | - | O | O | O | - | - | - | - |
| 040-00X | NOME DA ADMINISTRADORA (BANDEIRA) | - | O | O | O | - | - | - | - |
| 170-000 | NÚMERO DA TRANSAÇÃO – NSU HOST | - | O | O | O | - | - | - | - |
| 740-00X | NÚMEROS DO CARTÃO UTILIZADO NA TRANSAÇÃO | - | - | M | - | - | - | - | - |
| 741-00X | NOME DO PORTADOR DO CARTÃO | - | - | M | - | - | - | - | - |
| 742-00X | VALIDADE DO CARTÃO DO PORTADOR | - | - | M | - | - | - | - | - |
| 743-000 | RESTANTE À SER PAGO (USO DE MULTI CARTÕES) | - | - | O | - | - | - | - | - |
| 800-000 | VERSÂO DO GERENCIADOR DE PAGAMENTOS | - | - | - | - | M(3) | M(3) | - | - |
| 999-999 | TRAILER - REGISTRO FINAL | - | M | M | M | M(3) | M(3) | M | M |
Legenda:
M= MandatórioO= Opcional-= Ausente(1),(2),(3)= Dependências ou condições específicas (ver a seguir)
Observações
(1) Estes campos somente existem em transações aprovadas.
(2) Somente estarão preenchidos se a informação for fornecida no arquivo de envio correspondente.
(3) Somente estarão disponíveis se estiverem habilitadas as configurações de retorno do CNF e NCN.
(*) 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 Padrão preencherá este campo com zero (0) quando não houver comprovante.
(X) Quando utilizado, o X refere-se à possibilidade de variação de número de 0 a 9, que muda de acordo com a quantidade de cartões na transação.
Anterior
Layout do Header CONTEUDOPróximo
Descrição dos Campos