Conceitos e definições

Apresenta os padrões de representação de dados, constantes e mensagens utilizadas pela biblioteca Client Conecta, servindo como base para o entendimento das operações e dos dados trafegados.

Formatos de dados

Os dados utilizados nas operações seguem um padrão de formatação, representado pela estrutura:

[Caractere de formato][..][Tamanho]

Elementos do formato

Caractere de formato: letra maiúscula que define o tipo do dado;
[..]: opcional, indica tamanho variável, podendo ter de zero a [Tamanho] bytes;
Tamanho: de um a quatro dígitos numéricos representando a quantidade de bytes utilizada pelo dado ou “var” para tamanho indefinido;

Exemplos

Código "N..99" → dado numérico com tamanho variável de até 99 bytes, codificada de acordo com o formato “N”;
Código "A..var" → dado alfanumérico com tamanho variável, codificada de acordo com o formato “A”.

Formatos suportados

Formato	Descrição
A	Alfanumérico codificado segundo tabela ASCII, podendo conter bytes de 20h (espaço) a 7Eh (~). Quando a informação for menor do que o campo definido, ela deverá ser alinhada à esquerda com espaços (20h) à direita. Exemplo: se um campo de formato “A6” contém a informação “TEXTO”, ele é codificado como: 54h 45h 58h 54h 4Fh 20h.
N	Numérico decimal codificado segundo a tabela ASCII, podendo conter somente bytes de 30h (“0”) a 39h (“9”). Quando a informação for menor do que o campo definido, ela deverá ser alinhada à direita com zeros (30h) à esquerda. Exemplo: se um campo de formato “N8” contém a informação numérica 1234, ele é codificado como: 30h 30h 30h 30h 31h 32h 33h 34h.

Formato

Descrição

Alfanumérico codificado segundo tabela ASCII, podendo conter bytes de 20h (espaço) a 7Eh (~). Quando a informação for menor do que o campo definido, ela deverá ser alinhada à esquerda com espaços (20h) à direita.

Exemplo: se um campo de formato “A6” contém a informação “TEXTO”, ele é codificado como: 54h 45h 58h 54h 4Fh 20h.

Numérico decimal codificado segundo a tabela ASCII, podendo conter somente bytes de 30h (“0”) a 39h (“9”). Quando a informação for menor do que o campo definido, ela deverá ser alinhada à direita com zeros (30h) à esquerda.

Exemplo: se um campo de formato “N8” contém a informação numérica 1234, ele é codificado como: 30h 30h 30h 30h 31h 32h 33h 34h.

Constantes de operações

Define as constantes utilizadas para identificar as operações disponíveis na biblioteca.

Constante	Valor	Descrição
CFL_OPER_INITIALIZE	"1"	Inicialização da biblioteca.
CFL_OPER_MERCHANT	"2"	Cadastro de estabelecimento.
CFL_OPER_UNINSTALL	"3"	Desinstalação do terminal previamente cadastrado e inicializado pelo estabelecimento.
CFL_OPER_STATUS	"4"	Consulta de status.
CFL_OPER_TRANSACTION	"4"	Execução de transação.
CFL_OPER_TRANSREPRINT	"6"	Reimpressão de transações.
CFL_OPER_CONFIRMATION	"7"	Confirmação ou desfazimento de uma transação pendente realizada e aprovada anteriormente.
CFL_OPER_TRANSQUERY	"8"	Consulta de transações.