Comunicação Client TEF com AC

Comunicação Client TEF com o Sistema de Automação

A comunicação entre o sistema TEF 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 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 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 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 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 que os processos de inicialização de dia devem ser realizados.

Caso a DLL do sistema TEF 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 que os processos de finalização de dia devem ser realizados.