Obter Informações

Função para obtenção de informações de transação corrente:

A função ObtemInformacaoTransacaoCorrente deve ser utilizada para a obtenção de informações da transação corrente.

int DIRETIVA_CALLBACK ObtemInformacaoTransacaoCorrente(int iCodigoInformacao, 
    char *pValorInformacao)

Os campos das funções estão abaixo caracterizados.

Função para obter o caminho do diretório de cupons TEF

A função ObtemPathCupons deve ser utilizada para obter o path onde o TEF salvará os cupons ao final de cada transação.

int DIRETIVA_CALLBACK ObtemPathCupons(char *pPathCupons, int iPathLength)

Os campos estão abaixo caracterizados.

Função para obter a Empresa, Loja, PDV, IP e Porta do servidor TEF configurados no client.

A função ObtemDadosConfigurados deve ser chamada sempre que a automação comercial necessitar recuperar os dados configurados no client. O método retornará os dados de Empresa, Loja, CNPJ, IP e Porta do servidor TEF.

int DIRETIVA_CALLBACK ObtemDadosConfigurados(char *pEmpresa, char *pLoja, char *pPDV, char *pCNPJ, char *pIPServidor,
                                             int iIpLength, char *pPorta)

Os campos estão abaixo caracterizados.

Função para obter a Empresa e Loja retornados do TEF.

A função ObtemDadosEmpresaLojaTEF deve ser chamada sempre que a automação comercial necessitar coletar os dados de Empresa e Loja do TEF. O método retornará os dados de Empresa e Loja a partir do CNPJ informado.

int DIRETIVA_CALLBACK ObtemDadosEmpresaLojaTEF(char *pCNPJ, char *pCodigoEmpresa, char *pCodigoLoja)

Os campos estão abaixo caracterizados.

Função para obter a Empresa e Loja retornados do TEF.

A função ConsultaTransacao deve ser utilizada pela automação para consultar o status das transações.

int DIRETIVA_CALLBACK ConsultaTransacao(char *pNumeroEmpresa, char *pNumeroLoja, 
    char *pNumeroPDV, char *pSolicitacao, char *pResposta, char *pMensagemErro)

Os parâmetros da função estão abaixo caracterizados.

Função para consultar status das transações pela automação

A função ConsultaTransacao deve ser utilizada pela automação para consultar o status das transações.

int DIRETIVA_CALLBACK ConsultaTransacao(char *pNumeroEmpresa, char *pNumeroLoja, 
    char *pNumeroPDV, char *pSolicitacao, char *pResposta, char *pMensagemErro)

Os parâmetros da função estão abaixo caracterizados.

Transação Consulta Cadastro CPF Completa

Quando a automação comercial necessitar de verificação dos destinatários de um emissor deve ser usada a solicitação de transação de consulta de cadastro CPF completa, através da chamada à função TransacaoConsultaCadastroCPFCompleta. Os parâmetros destas funções são os seguintes:

ValorTransacao
NumeroCupom
NumeroControle
TipoOperacao
DocEmissor
PermiteAlteracao
Reservado (_)

int DIRETIVA_CALLBACK TransacaoConsultaCadastroCPFCompleta(char *pValorTransacao, char *pNumeroCupom,
                                                           char *pNumeroControle, char *pTipoOperacao,
                                                           char *pDocEmissor, char *pPermiteAlteracao,
                                                           char *pReservado)

O preenchimento dos parâmetros indicados com (_) é opcional. Caso o sistema de automação não possua estas informações, devem ser preenchidos com zeros ou espaços, conforme o tipo do campo.

Na resposta da chamada à função será preenchido o campo NumeroControle, o DocEmissor e será devolvido o status, indicando o resultado da transação.

[ 00 ] indica que não existiram restrições para a efetivação da transação.

[ 11 ] indica que existiram restrições para a efetivação da transação. O sistema de automação deve retornar à rotina de recebimento de valores, pois a transação solicitada não foi autorizada, não sendo válida como forma de pagamento.

O NumeroControle, incluído na resposta, deverá ser armazenado pelo sistema de automação, pois na função de confirmação este número será, obrigatoriamente, utilizado.

Caso a transação seja autorizada, será disponibilizado no diretório parametrizado para os cupons um arquivo contendo o comprovante da operação a ser impresso pela automação. O nome desse arquivo tem o formato NNNNNN.PPP, onde NNNNNN é o NumeroControle e PPP é o número do terminal configurado.

Os campos estão abaixo caracterizados.

Obter Identificação do PinPad

A função LeIdentificacaoPinpad deve ser chamada quando o automação comercial deseja obter as informações do pinpad, tais como: fabricante, modelo, versão, etc. Estes dados serão retornados no parâmetro pDados com o layout especificado abaixo:

int DIRETIVA_CALLBACK LeIdentificacaoPinPad(char *pDados)