Integração API Desktop (Recomendado)

Client TEF com a Automação Comercial (Integração mais recomendada)

A comunicação entre o 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).

Resposta das Funções

As funções TransacaoCartaoCredito, TransacaoCartaoDebito, TransacaoCartaoVoucher, são utilizados 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, respectivamente.

As funções TransacaoCartaoCreditoCompleta, TransacaoCartaoDebitoCompleta, TransacaoCartaoVoucherCompleta, 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 devolverá então a automação o resultado de transação confirmada.

A função FinalizaTransacao, executada após as funções de confirmação, é utilizada pelo sistema de automação para indicar ao TEF o término da transação de venda ou recebimento.

A função TransacaoReimpressaoCupom não necessita de confirmaçã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 TEF que os processos de finalização de dia devem ser realizados.