Layout de Mensagens de Comunicação
Nesta seção serão apresentados os formatos que devem ter as mensagens geradas pelo Terminal solicitador de TEF e os formatos das mensagens de retorno geradas pelo Cliente SiTef com a confirmação ou não de cada transação.
As mensagens serão transferidas por meio de arquivo tipo texto com várias linhas, onde cada linha contém um tipo de informação. As linhas possuem formato padrão e tamanho variável. O formato genérico é:
AAA-BBBC=CDDDDDDD......DDDDDEF
Onde:#
| Formato | Descrição |
|---|---|
| A | Identificação do tipo de informação ou campo. |
| B | Número 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:#
| Header | Descrição das Operações |
|---|---|
| ADM | Permite o acionamento do Cliente para execução das funções administrativas. |
| CRT | Pedido de autorização para transação por meio de cartão (crédito ou débito) |
| CHQ | Pedido de autorização para transação por meio de cheque |
| 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. |
| PRE | Pré-autorização de cartão de crédito |
| PGV | Pagamento de contas VisaNet |
| PGB | Pagamento de encargos Banrisul. |
| PCB | Pagamento de contas via correspondente bancário. |
| EPH | Transações para Farmácia E-Pharma. |
| INF | Transações para Farmácia InfoCard. |
| VIL | Transações para Farmácia VidaLink |
| EMS | Transações EMS. |
| PPB | Cartão Pré-Pago e Cartão Bônus |
| CEL | Recarga de celular. |
| SHL | Transações Shell Card |
| TCN | Transações TrnCentre |
| PVS | Transações PrevSaúde |
| ACSP | Transações ACSP |
| CSR10 | Transações CSR10 |
| TRCP (Obsoleto) Utilizar a função PROPRIET | Transação para Leitura da Trilha de Cartão Proprietário |
| JGV | Transações JGV |
| CONSCRED | Transação de Consulta Crédito Pré Aprovado(DMCARD) |
| CONSPGEN | Consulta Pagamento de Fatura |
| CRTFIEDL | Transações Fidelidade |
| FTC | Transações Fidelidade da Rede FTC |
| PROPRIET | Transação para Validação e Captura de Dados de Cartão Proprietário, podendo também azer a captura de senha para o cartão proprietário. |
| WAYUP | Transações WAYUP |
| PICPAY | Transações da rede Picpay |
| GETNETLA | Transações da rede GetNetLAC |
Cabe dizer aqui que cancelamento de venda pode ser feito de duas formas: através de uma operação ADM, ou então através de uma operação CNC, ficando a cargo do Terminal solicitador de TEF a forma como o cancelamento será acessado.
Nas próximas seções serão apresentados os tipos de informações (ou campos) que poderão estar presentes nos arquivos enviados e recebidos pelo Terminal solicitador de TEF. As informações (ou campos) variam de acordo com o tipo de operação, e todos os campos presentes no arquivo são opcionais, pois o Cliente SiTef está apto a coletar todos os dados necessários às transações que ele realiza. Porém, os campos presentes no arquivo recebido pelo Cliente SiTef serão preservados no arquivo de retorno e o Cliente SiTef irá apenas incluir neste arquivo os campos pertinentes à resposta da operação realizada e não os dados coletados pelo programa para a realização da transação.
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 Terminal solicitador de TEF e o recebido pelo Cliente SiTef valerá o do Cliente SiTef.