Comunicação Client TEF com AC
Comunicação Client TEF com o Sistema de Automação
A comunicação entre o sistema TEF Linx e o sistema de automação é feita através de chamadas a funções da DLL (DPOSDRV.DLL), com a passagem de parâmetros e posterior retorno de status.
As solicitações de transações com as instituições financeiras são realizadas através de transações financeiras (TF) ou transações de serviços (TS) e as solicitações de procedimentos operacionais são realizadas através de transações operacionais (TO).
Transações Financeiras
TransacaoCartaoCredito
TransacaoCartaoCreditoCompleta
ConfirmaCartaoCredito
TransacaoCartaoDebito
TransacaoCartaoDebitoCompleta
ConfirmaCartaoDebito
TransacaoCartaoVoucher
TransacaoCartaoVoucherCompleta
ConfirmaCartaoVoucher
FinalizaTransacao
TransacaoCartaoFidelidade
ConfirmaCartaoFidelidade
TransacaoCheque
TransacaoChequeCompleta
TransacaoCartaoCrediario
TransacaoCartaoCrediarioCompleta
Transações de Serviços
TransacaoPreAutorizacaoCartaoCredito
TransacaoCancelamentoPagamento
TransacaoResumoVendas
TransacaoConsultaParcelas
TransacaoReimpressaoCupom
TransacaoEstatistica
TransacaoTrocoSurpresa
TransacaoInjecaoChaves
Transações Operacionais
ObtemLogUltimaTransacao
InicializaDPOS
FinalizaDPOS
ConfiguraDPOS
Resposta das Funções
As funções TransacaoCartaoCredito, TransacaoCartaoDebito, TransacaoCartaoVoucher, TransacaoCartaoCrediario e TransacaoCheque são utilizadas pelo sistema de automação para solicitar ao sistema TEF Linx a realização de transação de pagamento com cartão de crédito, pagamento com cartão de débito, pagamento com cartão Voucher, pagamento em crediário e consulta de cheque, respectivamente.
As funções TransacaoCartaoCreditoCompleta, TransacaoCartaoDebitoCompleta, TransacaoCartaoVoucherCompleta, TransacaoChequeCompleta, TransacaoCartaoCrediarioCompleta possuem a mesma funcionalidade das funções correspondentes não completas, mas oferecem parâmetros adicionais para maior controle das operações e informações de retorno mais detalhadas.
As funções ConfirmaCartaoCredito, ConfirmaCartaoDebito e ConfirmaCartãoVoucher são utilizadas pelo sistema de automação para indicar ao sistema TEF Linx quais transações financeiras foram efetivadas na operação de venda ou de recebimento. Estas funções devem ser executadas após a impressão do comprovante de TEF disponibilizado no retorno da solicitação da transação. O sistema TEF Linx devolverá ao sistema de automação o resultado da transação de confirmação.
A função FinalizaTransacao, executada após as funções de confirmação, é utilizada pelo sistema de automação para indicar ao sistema TEF Linx o término da transação de venda ou recebimento.
A função TransacaoReimpressaoCupom não necessita de confirmação. As funções TransacaoCheque, TransacaoChequeCompleta não necessitam de confirmação quando não houver cupom para impressão.
A função ObtemLogUltimaTransacao retorna o registro de log referente à última transação efetuada com sucesso. Nesta função, caso seja necessário, poderá ser passado como parâmetro o valor “LOGESTENDIDO” ou "LOGADICIONAL" e serão retornadas informações complementares da transação. Deve-se analisar a estrutura dos respectivos registros para verificar os campos que são retornados em cada um deles. O formato do registro é o LOG ESTENDIDO ou LOG ADICIONAL.
A função InicializaDPOS deve ser executada em cada abertura de dia de movimento (dia fiscal), servindo para indicar à DLL do sistema TEF Linx que os processos de inicialização de dia devem ser realizados.
Caso a DLL do sistema TEF Linx venha a ser REINICIADA, por qualquer motivo, serão executados processos internos de recuperação de falhas.
A função FinalizaDPOS deve ser executada em cada fechamento de dia de movimento (dia fiscal), servindo para indicar à DLL do sistema TEF Linx que os processos de finalização de dia devem ser realizados.