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).
Transações Financeiras | Transações de Serviços | Transações Operacionais |
---|---|---|
TransacaoCartaoCredito | TransacaoPreAutorizacaoCartaoCredito | ObtemLogUltimaTransacao |
TransacaoCartaoCreditoCompleta | TransacaoCancelamentoPagamento | InicializaDPOS |
ConfirmaCartaoCredito | TransacaoResumoVendas | FinalizaDPOS |
TransacaoCartaoDebito | TransacaoConsultaParcelas | ConfiguraDPOS |
TransacaoCartaoDebitoCompleta | TransacaoReimpressaoCupom | |
ConfirmaCartaoDebito | ||
TransacaoCartaoVoucher | ||
TransacaoCartaoVoucherCompleta | ||
ConfirmaCartaoVoucher | ||
FinalizaTransacao |
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.
Updated 5 months ago