Configuração da Biblioteca

Esta deve ser a primeira chamada para a biblioteca CliSiTef. Ela tem por objetivo configurar os parâmetros de conexão com o servidor SiTef, e com a própria Automação Comercial.

int ConfiguraIntSiTefInterativo (IPSiTef, IdLoja, IdTerminal, Reservado)
int ConfiguraIntSiTefInterativoEx (IPSiTef, IdLoja, IdTerminal, Reservado, ParametrosAdicionais)

Interface ASCII

ConfiguraIntSiTefInterativoA (Resultado, IPSiTef, IdLoja, IdTerminal, Reservado)
ConfiguraIntSiTefInterativoExA (Resultado, IPSiTef, IdLoja, IdTerminal, Reservado, ParâmetrosAdicionais)

Parâmetro	Tipo	Interface Padrão	Interface ASCII	Descrição
Resultado	Saída, por valor	Não usado	Fixo 6	Contém o resultado de resposta à chamada da rotina.
IPSiTef	Entrada, por valor	char *	Variável	Configura o nome ou endereço IP (em notação ".") do servidor SiTef.
IdLoja	Entrada, por valor	char *	Fixo 8	Identifica o número da loja perante a rede de estabelecimentos comerciais.
IdTerminal	Entrada, por valor	char *	Fixo 8	Identifica o pdv perante a loja. Possui o formato XXnnnnnn onde XX corresponde a 2 caracteres alfabéticos e nnnnnn 6 dígitos quaisquer desde que o número resultante não sobreponha a faixa 000900 a 000999 que é reservada para uso pelo SiTef.
Reservado	Entrada, por valor	char *	Fixo 6	Deve ser passado com 0
ParametrosAdicionais	Entrada, por valor	char *	Variável	Parâmetros adicionais de configuração da CliSiTef no seguinte Formato: [<Nome_Parametro_1>=<Valor_Parametro_1>;<Nome_Parametro_2>=<Valor_Parametro_2>]

Importante!

Cada terminal deve ter um código único e fixo por loja do SiTef. Desta forma o estabelecimento comercial deve administrar os códigos utilizados de forma que nunca exista repetição de terminais para uma mesma loja.

O servidor SiTef não permite duas ou mais conexões simultâneas utilizando o mesmo par (loja, terminal), derrubando as conexões anteriores, mantendo apenas a última conexão efetuada; se porventura a transação que estava em andamento quando da queda da conexão por PDV duplicado estivesse já em estado pendente (uma venda por exemplo), o SiTef coloca-a imediatamente em estado Canc.PDV (Cancelada pelo PDV), ou seja, esta estará cancelada; o terminal que for desconectado receberá a mensagem "Sem conexao SiTef" com o código de erro -5.

Quando o estabelecimento comercial utilizar Pinpad para leitura de cartões e digitação de senha e caso o par (loja, terminal) seja alterado, isto implicará em nova carga de tabelas no pinpad a cada alteração. Este é mais um motivo para que o código de terminal seja fixo.

As rotinas de configuração retornam um dos seguintes valores:

Tabela 2 - Códigos de retorno das funções de configuração

Valor	Descrição
0	Não ocorreu erro
1	Endereço IP inválido ou não resolvido
2	Código da loja inválido
3	Código de terminal inválido
6	Erro na inicialização do Tcp/Ip
7	Falta de memória
8	Não encontrou a CliSiTef ou ela está com problemas
9	Configuração de servidores SiTef foi excedida.
10	Erro de acesso na pasta CliSiTef (possível falta de permissão para escrita)
11	Dados inválidos passados pela automação.
12	Modo seguro não ativo (possível falta de configuração no servidor SiTef do arquivo .cha).
13	Caminho DLL inválido (o caminho completo das bibliotecas está muito grande).

Observação: durante o ciclo de vida da automação, caso não haja mudança nos parâmetros de entrada da função, então não há necessidade de chamá-la novamente.