Nesta página estará disposto os métodos os quais são possiveis utilizar para que a automação faça a configuração do Kit TEF de forma fluída. A obrigatoriedade de implementação desses métodos irá variar de acordo com o modelo de integração escolhido pela sua automação.
Configura CNPJ do Estabelecimento
Para configurar o CNPJ da empresa de forma programática execute a funcionalidade abaixo:
int ConfiguraCNPJEstabelecimento(char *pCNPJEstabelecimento);
| Campo | Tamanho | Descrição |
|---|---|---|
| pCNPJEstabelecimento | 14N | Ponteiro que contém o número do CNPJ para ser utilizado na configuração |
Configura Empresa, Loja e PDV
Para configurar o PDV, com número da empresa, loja e número de PDV a integrar com o método abaixo:
int ConfiguraEmpresaLojaPDV(char *pNumeroEmpresa, char *pNumeroLoja, char *pNumeroPDV);
| Campo | Tamanho | Descrição |
|---|---|---|
| pNumeroEmpresa | 4N | Ponteiro que contém o número da Empresa para ser utilizado na configuração |
| pNumeroLoja | 4N | Ponteiro que contém o número da Loja para ser utilizado na configuração |
| pNumeroPDV | 4N | Ponteiro que contém o número do PDV para ser utilizado na configuração |
Configura comunicação TEF
Para realizar a configuração de comunicação com TEF Stone deve-se integrar com a seguinte funcionalidade:
int ConfiguraComunicacaoDTEF(char *pConfiguracaoIpPortaSsl);
O parâmetro pConfiguracaoIpPortaSsl recebe as informações no formato:
IP1:Porta1:SSL1;IP2:Porta2:SSL2;...;IPn:Portan:SSLn`
Devendo o ; separador para caso seja passado mais de um servidor, SSL indica se é utilizada uma comunicação via TLS, opções possiveis: 1 para habilitar a comunicação via TLS e 0 para desabilitar.
Exemplo da formatação dos dados informando mais de um servidor TEF:
linxTEF.com.br:9999:1;linxTEF.com.br:9998:1;linxTEF.com.br:9997:0;linxTEF.com.br:9996:0
Busca Certificado
Esta transação permite realizar o download do certificado de comunicação com o TEF Stone. Os parâmetros estão abaixo caracterizados para a função BuscaCertificado. Esta chamada deverá ser feita após ter sido configurado os dados de CNPJ, empresa, loja e PDV, caso contrário haverá uma sinalização de erro no retorno.
int BuscaCertificado(char *pURL, char *pPathCertificado);
| Campo | Tamanho | Descrição |
|---|---|---|
| pURL | A | Url de onde será feito o download do certificado, caso o ponteiro informado seja nulo será utilizado o valor default. |
| pPathCertificado | A | Path absoluto indicando onde deverá armazenado o certificado |
| 02 I | Retorno: • [00] Operação executada com sucesso • [11] Erro ao processar a solicitação |
Diretivas de callback
Transações: Todos os campos numéricos informados devem ser completados com zeros à esquerda e, quando não informados, preenchidos com zeros. Os campos alfanuméricos devem ser completados com espaços à direita e, quando não informados, preenchidos com espaços.
Definição da DIRETIVA_CALLBACK
A macro DIRETIVA_CALLBACK é uma diretiva de pré-processamento usada para definir a convenção de chamada de função em diferentes ambientes de compilação. Ela nos permite adaptar nosso código para funcionar corretamente em diferentes sistemas operacionais e compiladores. A convenção de chamada de função define como os parâmetros são passados para a função e como os valores de retorno são retornados para o chamador.
#if(_MSC_VER)
#define DIRETIVA_CALLBACK __stdcall
#else
#define DIRETIVA_CALLBACK
#endif
Parâmetros opcionais: 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.