-
Este documento contm aspectos confidenciais e estratgicos da empresa Auttar, os quais foram entregues em carter restrito, no podendo ser distribudo, copiado ou divulgado a
terceiros sem autorizao prvia da mesma
MANUAL DE INTEGRAO CTFCLIENT BIBLIOTECA AUTOMAO COMERCIAL
ESPECIFICAO TCNICA
PRODUTO
VERSO 01.03
13/06/2011
-
BC-AUTTAR-320000050-102-PRD-INT-ET-Manual de Integrao CTFClient
Biblioteca - Cpia.docx
2/51
Controle de Verso
Verso Data Autor Descrio
01.00 01/06/2010 Auttar Criao do Documento
01.01 03/03/2011 Eduardo Santos Definio da Operao CTFClient: 012 Reimpresso do ltimo Comprovante (Anexo V).
01.02 13/06/2011 Cludio
Montenegro
Reviso do documento
01.03 09/08/2012 Eduardo Santos Reviso do tamanho e formato dos campos do tipo
data (7010, 7094, 7022, 7097)
Aprovao do Documento
Nome Cargo Data Assinatura
Cludio Montenegro Gerente de Sistemas 12/06/2011
-
BC-AUTTAR-320000050-102-PRD-INT-ET-Manual de Integrao CTFClient
Biblioteca - Cpia.docx
3/51
ndice
1. INTRODUO .................................................................................................................................... 4
2. USANDO A BIBLIOTECA DE AUTOMAO COMERCIAL ............................................................ 5
2.1.MODALIDADES DE INTEGRAO ................................................................................................. 6
3. INTERFACE DA BIBLIOTECA DE AUTOMAO COMERCIAL .................................................... 7
3.1 INICIACLIENTCTF............................................................................................................................. 8
3.2.INICIATRANSACAOCTF ................................................................................................................ 11
3.3.CONTINUATRANSACAOCTF ........................................................................................................ 13
3.4.FINALIZATRANSACAOCTF ........................................................................................................... 16
ANEXO I CDIGOS DE RETORNO .................................................................................................. 18
ANEXO II COMANDOS ...................................................................................................................... 20
ANEXO III SUBCAMPOS ................................................................................................................... 24
ANEXO IV - CDIGO DE ERRO (SUBCAMPO 7300) ...................................................................... 35
ANEXO V OPERAES CTFCLIENT ............................................................................................... 44
ANEXO VI PARMETROS ................................................................................................................ 45
1.2 DISPOSITIVOS SUPORTADOS PELO CTFCLIENT ...................................................................................... 47
-
BC-AUTTAR-320000050-102-PRD-INT-ET-Manual de Integrao CTFClient
Biblioteca - Cpia.docx
4/51
1. Introduo
A Biblioteca de Automao Comercial um mdulo construdo com o objetivo de facilitar a integrao da Automao Comercial com o CTF, atravs do CTFClient.
Neste documento apresentada a API disponibilizada pela Biblioteca de Automao Comercial. O objetivo deste documento servir como guia para a AC que deseja se integrar com esta biblioteca.
-
BC-AUTTAR-320000050-102-PRD-INT-ET-Manual de Integrao CTFClient
Biblioteca - Cpia.docx
5/51
2. Usando a Biblioteca de Automao Comercial
A imagem abaixo detalha o fluxo de uso desta biblioteca por uma Automao Comercial:
Esta biblioteca fornece quatro rotinas bsicas para a Automao Comercial, ilustradas no diagrama acima: iniciaClientCTF, iniciaTransacaoCTF, continuaTransacaoCTF e finalizaTransacaoCTF.
iniciaClientCTF
iniciaTransacaoCTF
continuaTransacaoCTF
finalizaTransacaoCTF
A receber > 0?
Imprime os comprovantes
de TEF
Recebimento da Venda
Abertura do terminal
Retorno = 99?
sim
no
sim
no
-
BC-AUTTAR-320000050-102-PRD-INT-ET-Manual de Integrao CTFClient
Biblioteca - Cpia.docx
6/51
A rotina iniciaClientCTF s precisa ser chamada uma nica vez, para inicializao da biblioteca.
Para iniciar uma transao, a AC utiliza a rotina iniciaTransacaoCTF, informando os parmetros bsicos da transao (tipo de operao, valor, nmero de documento, data...). Esta rotina retorna 00 para indicar que a transao foi iniciada com sucesso. A AC deve, ento, chamar a rotina continuaTransacaoCTF para que a transao seja efetivamente processada.
A rotina continuaTransacaoCTF normalmente deve ser chamada vrias vezes durante o processamento de uma transao. Sempre que retornar 99, esta rotina est instruindo a AC a realizar um comando (normalmente uma exibio de texto em display ou a captura de uma informao atravs do teclado) e depois retornar o resultado da execuo deste comando atravs de nova chamada continuaTransacaoCTF. Este lao de execuo de comandos deve continuar enquanto o cdigo de retorno for 99.
Finalmente, aps a rotina continuaTransacaoCTF indicar que o processamento da transao foi concludo (atravs do cdigo de retorno 00), a AC deve imprimir o comprovante de TEF e chamar a rotina finalizaTransacaoCTF. Esta rotina responsvel pela confirmao ou, dependendo do caso, desfazimento de uma transao realizada atravs do uso desta biblioteca.
2.1. Modalidades de Integrao
Existem dois modos de realizar a integrao entre a AC e o CTFClient, atravs da Biblioteca de Automao Comercial: o modo interativo e o modo no-interativo.
No modo interativo, durante o lao de chamadas rotina continuaTransacaoCTF, a AC pode receber comandos de captura de dados e exibio de textos em display, entre outros. Estes comandos so utilizados pelo CTFClient para capturar demais dados pertinentes transao necessrios para o seu processamento. Desta forma, a AC est sempre no controle da interface de usurio, e pode manter sua identidade visual ao longo da transao.
No modo no-interativo, a AC no recebe comandos relacionados captura de dados ou exibio de displays, pois o CTFClient se torna responsvel pela captura destes dados. Trata-se de uma forma mais simples de realizar a integrao da AC com o CTFClient, mas nesta modalidade a interface visual do CTFClient usada, e a AC no mantm sua identidade visual durante a captura dos dados da transao.
-
BC-AUTTAR-320000050-102-PRD-INT-ET-Manual de Integrao CTFClient
Biblioteca - Cpia.docx
7/51
3. Interface da Biblioteca de Automao Comercial
As funes desta biblioteca esto listadas na tabela abaixo, e so detalhadas nas pginas seguintes:
1.1.1.1 Nome 1.1.1.2 Descrio
iniciaClientCTF Inicializa esta biblioteca.
iniciaTransacaoCTF Inicia uma transao.
continuaTransacaoCTF Continua uma transao interativamente.
finalizaTransacaoCTF Finaliza uma transao, confirmando ou desfazendo-a.
Todos os parmetros de todas as rotinas so do tipo char*, e sempre devem apontar para strings previamente alocados (ou seja, alocados pela AC) com um tamanho determinado pelo parmetro em si. Por exemplo, o parmetro resultado da rotina iniciaClientCTF possui um tamanho de 4 caracteres; mesmo se tratando de um parmetro de retorno, ao ser chamada a rotina iniciaClientCTF este parmetro deve apontar para um string com 4 caracteres j existente.
Por exemplo, o trecho de cdigo abaixo ilustra como chamar a rotina iniciaClientCTF corretamente:
char resultado[] = 00;
iniciaClientCTF(resultado, ...);
J o trecho de cdigo abaixo no vlido; repare como o parmetro resultado no aponta para um string pr-alocado:
char* resultado;
iniciaClientCTF(resultado, ...);
O tipo de um parmetro pode ser A (alfa-numrico) ou N (numrico). Como regra geral, quando os campos possurem um tamanho fixo eles devem se menores ser completados at atingir o tamanho indicado. Campos do tipo A devem ser completados com espaos direita, enquanto campos do tipo N devem ser completados com zeros esquerda.
-
BC-AUTTAR-320000050-102-PRD-INT-ET-Manual de Integrao CTFClient
Biblioteca - Cpia.docx
8/51
3.1. iniciaClientCTF
Descrio:
Esta rotina inicializa a biblioteca.
Sintaxe:
void __stdcall iniciaClientCTF(
char* resultado,
char* terminal,
char* versao_ac,
char* nome_ac,
char* num_sites,
char* lista_ips,
char* criptografia,
char* log,
char* interativo,
char* parametros
);
Parmetros:
1.1.1.3 Nome
1.1.1.4 E/S
1.1.1.5 Tipo
1.1.1.6 Tamanho
1.1.1.7 Descrio
resultado S N 2 Receber o resultado da execuo da rotina. Ao chamar a rotina, informar o valor 00.
terminal E N 12 Cdigo que identifica o terminal CTFClient no formato EEEEELLLLPPP, onde:
- EEEEE o cdigo do estabelecimento, numrico
-
BC-AUTTAR-320000050-102-PRD-INT-ET-Manual de Integrao CTFClient
Biblioteca - Cpia.docx
9/51
com 5 posies;
- LLLL o cdigo da loja, numrico com 4 posies;
- PPP o cdigo do PDV, numrico com 3 posies.
versao_ac E A 10 Verso da aplicao da AC.
nome_ac E A 20 Nome da aplicao da AC.
num_sites E N 2 Quantidade de itens na lista_ips, numrico de 2 posies.
lista_ips E A varivel Lista de endereos de conexo do CTFClient com o CTF Server, no formato , onde: o endereo IP para a conexo, com 15 posies, preenchido com espaos direita; a porta de conexo a ser usada, numrico de 5 caracteres, preenchido com zeros esquerda. o protocolo a ser usado na comunicao, com 4 posies, alinhado esquerda e preenchido com espaos direita. Possveis valores para este campo so TCP e UDP.
criptografia
E N 1 Indica se deve ser ativada a criptografia das mensagens enviadas para o CTFClient: 0 criptografia desativada 1 criptografia ativada
log E N 1 Indica se a biblioteca de automao comercial deve gerar logs:
-
BC-AUTTAR-320000050-102-PRD-INT-ET-Manual de Integrao CTFClient
Biblioteca - Cpia.docx
10/51
0 logs desativados 1 logs ativados
interativo E N 1 Indica se a biblioteca deve seguir o modelo interativo na integrao com o CTFClient: 0 modelo no interativo 1 modelo interativo
parametros
E A varivel Parmetros adicionais do CTFClient, no formato [=;=]. Ver Anexo VI Parmetros
Observaes:
Esta rotina inicializa a biblioteca e armazena os valores recebidos por parmetro em variveis globais, para uso nas outras rotinas desta biblioteca.
Se for ativado o uso de criptografia, esta rotina far a carga das bibliotecas necessrias (csicrypto.dll e csisecurity.dll devem estar na mesma pasta que esta biblioteca). Erros durante a carga destas bibliotecas sero indicados com um cdigo de retorno especfico.
Outros erros possveis so referentes a parmetros invlidos e falhas de alocao de memria, que tambm retornam cdigos de erro especficos.
Se esta rotina no tiver sido chamada, as outras rotinas desta biblioteca iro retornar um cdigo de erro indicando que a biblioteca no foi inicializada.
-
BC-AUTTAR-320000050-102-PRD-INT-ET-Manual de Integrao CTFClient
Biblioteca - Cpia.docx
11/51
3.2. iniciaTransacaoCTF
Descrio:
Inicia uma transao.
Sintaxe:
void __stdcall iniciaTransacaoCTF(
char* resultado,
char* operacao,
char* valor,
char* num_doc,
char* data_cli,
char* num_trans
);
Parmetros:
1.1.1.8 Nome
1.1.1.9 E/S
1.1.1.10 Tipo
1.1.1.11 Tamanho
1.1.1.12 Descrio
resultado S N 2 Receber o resultado da execuo da rotina.
operacao E N 3 Cdigo da operao que identifica a transao que ser executada pelo CTFClient. As operaes definidas seguem o padro definido na integrao da AC com o CTFClient via POSENTRA[1]. Ver Anexo V
valor E N 12 Valor da transao
-
BC-AUTTAR-320000050-102-PRD-INT-ET-Manual de Integrao CTFClient
Biblioteca - Cpia.docx
12/51
em centavos.
num_doc E A 20 Nmero do documento fiscal, para ser impresso do cupom de TEF.
data_cli E N 8 Data de abertura fiscal do PDV no formato AAAAMMDD.
num_trans E N 2 Nmero da transao.
Observaes:
Quando esta rotina retorna 00, indicando sucesso, o processamento da transao deve ser continuado atravs da rotina continuaTransacaoCTF.
-
BC-AUTTAR-320000050-102-PRD-INT-ET-Manual de Integrao CTFClient
Biblioteca - Cpia.docx
13/51
3.3. continuaTransacaoCTF
Descrio:
Continua uma transao interativamente.
Sintaxe:
void __stdcall continuaTransacaoCTF(
char* resultado,
char* comando,
char* num_sc,
char* p_sc,
char* tam_sc,
char* aux
);
Parmetros:
1.1.1.13 Nome
1.1.1.14 E/S
1.1.1.15 Tipo
1.1.1.16 Tamanho
1.1.1.17 Descrio
resultado S N 2 Receber o resultado da execuo da rotina.
comando E/S N 2 Operao retornada pelo CTFClient para ser executada pela AC. A AC pode solicitar o cancelamento da operao atravs deste campo.
num_sc E/S N 4 Nmero do subcampo tratado neste comando.
p_sc E/S A 20000 Buffer para
-
BC-AUTTAR-320000050-102-PRD-INT-ET-Manual de Integrao CTFClient
Biblioteca - Cpia.docx
14/51
transferncia de um subcampo. O formato do subcampo est associado a sua definio. Quando a rotina est solicitando a captura de um subcampo (comando X), este parmetro contm o seu tamanho mximo.
tam_sc E/S N 5 Tamanho do subcampo capturado/enviado (tamanho dos dados contidos no parmetro p_sc).
aux S N 1 Nos comandos que afetam display, este parmetro indica qual display deve ser afetado pelo comando: - 1 = display do operador; - 2 = display do cliente; - 3 = ambos os displays. Nos comandos que solicitam a captura de um dado, este parmetro usado para indicar se a captura aceita zeros
-
BC-AUTTAR-320000050-102-PRD-INT-ET-Manual de Integrao CTFClient
Biblioteca - Cpia.docx
15/51
esquerda: - 0 = no aceita zeros esquerda; - 1 = aceita zeros esquerda.
Observaes:
Sempre que esta rotina retornar 99, a Automao Comercial deve consultar o comando retornado no parmetro de sada comando e execut-lo. A descrio dos comandos que podem ser retornados, bem como os parmetros de sada adicionais que devem ser consultados em cada caso, pode ser encontrada no Anexo II Comandos.
Aps executar um comando, a AC deve novamente chamar esta rotina, preenchendo os parmetros de entrada conforme instrues contidas na prpria descrio de cada comando.
Alguns comandos podem ser cancelados, o que provoca o cancelamento da transao como um todo. A descrio de quais comandos podem ser cancelados, bem como instrues de como fazer este cancelamento, encontram-se na descrio do comando 08, no Anexo II Comandos.
Mesmo que a integrao seja feita no modo no-interativo, ainda assim esta rotina vai retornar comandos para a AC. No mnimo, comandos 00 (AC deve recuperar o subcampo retornado) so usados aps a concluso da transao, para informar os dados daquela transao para a AC. Como exemplo, lembramos que os comprovantes so retornados desta forma. Alm do comando 00, o comando 08 tambm pode ser retornado no modo no-interativo, para verificar se a AC deseja cancelar operaes longas.
Uma listagem dos subcampos informados/recebidos por esta rotina pode ser encontrada no Anexo III Subcampos.
O trmino do processamento de uma transao indicado pelo cdigo de retorno 00. Entretanto, a transao se encontra num estado pendente, e sua confirmao ou desfazimento, em caso de falha na impresso do comprovante deve ser realizada atravs da rotina finalizaTransacaoCTF.
-
BC-AUTTAR-320000050-102-PRD-INT-ET-Manual de Integrao CTFClient
Biblioteca - Cpia.docx
16/51
3.4. finalizaTransacaoCTF
Descrio:
Confirma ou desfaz uma transao.
Sintaxe:
void __stdcall finalizaTransacaoCTF(
char* resultado,
char* confirmar,
char* num_trans,
char* data_cli
);
Parmetros:
1.1.1.18 Nome
1.1.1.19 E/S
1.1.1.20 Tipo
1.1.1.21 Tamanho
1.1.1.22 Descrio
resultado S N 2 Receber o resultado da execuo da rotina.
confirmar E N 1 1 transao ser confirmada. 0 transao ser desfeita.
num_trans E N 2 Nmero da transao.
data_cli E A 8 Data de abertura fiscal do PDV no formato AAAAMMDD.
Observaes:
Esta operao estabelece uma conexo com o CTFClient, executa a confirmao ou desfazimento da transao referenciada pelos parmetros
-
BC-AUTTAR-320000050-102-PRD-INT-ET-Manual de Integrao CTFClient
Biblioteca - Cpia.docx
17/51
data_cli e num_trans, recebe a resposta do CTFClient e encerra a conexo.
Entre os possveis cdigos de resposta, deve-se notar que o cdigo 13 pode ser retornado indicando sucesso. Nestes casos, este cdigo de retorno especfico retornado para indicar que ainda existem outras transaes pendentes de confirmao.
-
BC-AUTTAR-320000050-102-PRD-INT-ET-Manual de Integrao CTFClient
Biblioteca - Cpia.docx
18/51
Anexo I Cdigos de Retorno
A listagem abaixo contempla os possveis valores retornados pelas rotinas desta biblioteca:
1.1.1.23 Retorno 1.1.1.24 Descrio
00 Execuo bem sucedida.
01 Time out da transao.
02 Apitef no inicializada.
04 Erro nos parmetros/erro de integrao.
05 Transao no autorizada.
06 Transao cancelada pelo operador/cliente.
09 Autorizadora offline.
10 Erro de comunicao da Apitef.
11 Erro no CTF.
12 Erro na camada de Intertef da Apitef
13 Transao confirmada, mas ainda existem outras transaes a confirmar.
15 Erro de formatao comprovante
18 Transao desfeita.
19 Documento inexistente para cancelar.
20 Dados invlidos da integrao.
21 No h transaes para consolidar.
22 No h comprovantes para imprimir.
25 Erro interno do CTFClient
26 Erro retornado pelo pinpad
27 Erro de integrao.
50 Biblioteca de Automao Comercial no foi inicializada
51 Erro de alocao de memria
53 Erro carregando bibliotecas de criptografia
54 Erro ao estabelecer conexo.
55 Erro ao enviar dados pela conexo.
56 Erro ao ler dados da conexo.
57 Mensagem com formato invlido recebida do CTFClient.
58 Chamada de rotina invlida.
59 Varivel de ambiente CTFCLIENT_HOME no est configurada.
60 Erro lendo a porta de conexo com o CTFClient do arquivo %CTFLIENT_HOME%/Bin/configCTFClient.xml.
61 Erro configurando CTFClient atravs da operao 005 no foi possvel inicializar a biblioteca.
98 Erro interno desconhecido.
-
BC-AUTTAR-320000050-102-PRD-INT-ET-Manual de Integrao CTFClient
Biblioteca - Cpia.docx
19/51
99 O comando devolvido deve ser executado pela AC, e o resultado deve ser enviado em nova chamada da rotina continuaTransacaoCTF.
-
BC-AUTTAR-320000050-102-PRD-INT-ET-Manual de Integrao CTFClient
Biblioteca - Cpia.docx
20/51
Anexo II Comandos
A listagem abaixo contm os comandos que podem ser retornados para a Automao Comercial durante as chamadas da rotina continuaTransacaoCTF:
1.1.1.25 Comando 1.1.1.26 Descrio
00 AC deve recuperar o subcampo retornado. Este comando normalmente ocorre algumas vezes aps a finalizao de uma transao, para devolver para a AC as informaes daquela transao. Quando a rotina continuaTransacaoCTF informar este comando, os seus parmetros de sada sero preenchidos da seguinte forma: - num_sc: vir preenchido com o cdigo do subcampo sendo informado para a AC (conforme Anexo IV Subcampos). - p_sc: vir preenchido com os dados do subcampo sendo informado para a AC. - tam_sc: vir preenchido com o tamanho dos dados contidos em p_sc. Aps recuperar o subcampo, a AC deve indicar que o comando foi executado chamando a rotina continuaTransacaoCTF informando o parmetro comando = 00.
01 AC deve exibir mensagem de display. Quando a rotina continuaTransacaoCTF informar este comando, os seus parmetros de sada sero preenchidos da seguinte forma: - p_sc: vir preenchido com a mensagem a ser exibida no display. O caractere \ indica uma quebra de linha. - tam_sc: vir preenchido com o tamanho da mensagem contida em p_sc, incluindo os caracteres de quebra de linha. - aux: vir preenchido com 1 se a mensagem se destinar ao display do operador, com 2 se a mensagem se destinar ao display do cliente e com 3 se a mensagem se destinar a ambos os displays. Aps exibir a mensagem, a AC deve indicar que o
-
BC-AUTTAR-320000050-102-PRD-INT-ET-Manual de Integrao CTFClient
Biblioteca - Cpia.docx
21/51
comando foi executado chamando a rotina continuaTransacaoCTF informando o parmetro comando = 01.
02 AC deve exibir o ttulo do menu/texto. Este comando prepara a AC para exibir um menu de opes/texto para confirmao. Quando a rotina continuaTransacaoCTF informar este comando, os seus parmetros de sada sero preenchidos da seguinte forma: - p_sc: vir preenchido com o ttulo de menu/texto. O caractere \ indica uma quebra de linha. - tam_sc: vir preenchido com o tamanho do ttulo contido em p_sc, incluindo os caracteres de quebra de linha. - aux: vir preenchido com 1 se o ttulo se destinar ao display do operador, com 2 se o ttulo se destinar ao display do cliente e com 3 se o ttulo se destinar a ambos os displays. Aps exibir o ttulo, a AC deve indicar que o comando foi executado chamando a rotina continuaTransacaoCTF informando o parmetro comando = 02.
03 AC deve limpar o display. Quando a rotina continuaTransacaoCTF informar este comando, o seu parmetro de sada aux ser usada para indicar qual display deve ser afetado pelo comando: - 1 = display do operador; - 2 = display do cliente; - 3 = ambos os displays. A AC deve indicar que o comando foi executado chamando a rotina continuaTransacaoCTF informando o parmetro comando = 03.
04 AC deve obter uma confirmao (estilo SIM/NO) da operao junto ao usurio. Este comando normalmente precedido da exibio de um texto comunicando o usurio sobre a natureza da deciso que est tomando. Para confirmar a operao, a AC chama a rotina continuaTransacaoCTF informando os parmetros: comando = 04, p_sc = 1 e tam_sc = 00001.
-
BC-AUTTAR-320000050-102-PRD-INT-ET-Manual de Integrao CTFClient
Biblioteca - Cpia.docx
22/51
Para no confirmar a operao, a AC chama a rotina continuaTransacaoCTF informando os parmetros: comando = 04, p_sc = 2 e tam_sc = 00001.
05 AC deve exibir opes de menu ao usurio. Quando a rotina continuaTransacaoCTF informar este comando, os seus parmetros de sada sero preenchidos da seguinte forma: - p_sc: vir preenchido com o menu a ser exibido ao usurio, no formato 1:texto;2:texto;...i:texto;. Quebras de linha podem ocorrer nos itens do menu, e so indicadas pelo caractere \. - tam_sc: vir preenchido com o tamanho do menu contido em p_sc, incluindo os caracteres de quebra de linha. A AC deve apresentar o menu ao usurio e retornar uma resposta como segue: - comando: 05; - p_sc: ndice do item de menu escolhido pelo usurio; - tam_sc: tamanho em bytes dos dados informados no parmetro p_sc.
06 AC deve aguardar at que uma tecla seja pressionada pelo usurio. A AC deve indicar que o comando foi executado chamando a rotina continuaTransacaoCTF informando o parmetro comando = 06.
07 AC deve capturar um dado no teclado. Quando a rotina continuaTransacaoCTF informar este comando, os seus parmetros de sada sero preenchidos da seguinte forma: - num_sc: vir preenchido com o cdigo do subcampo que deve ser capturado (veja Anexo IV Subcampos). - p_sc: vir preenchido com o tamanho mximo do subcampo que deve ser capturado. - tam_sc: vir preenchido com a quantidade de bytes do campo p_sc usadas para representar o tamanho mximo do subcampo a ser capturado. - aux: vir preenchido com 1 para indicar que o subcampo pode ser capturado com zeros esquerda, e com 0 em caso contrrio.
-
BC-AUTTAR-320000050-102-PRD-INT-ET-Manual de Integrao CTFClient
Biblioteca - Cpia.docx
23/51
A AC deve executar o comando e chamar a rotina continuaTransacaoCTF com os seguintes parmetros: - comando: 07; - p_sc: dados capturados; - tam_sc: tamanho em bytes dos dados informados no parmetro p_sc.
08 AC est sendo consultada para verificar se deseja cancelar a transao atual (por exemplo, a AC deve verificar se a tecla VOLTA foi digitada pelo usurio). Normalmente este comando informado durante operaes longas que no possuem interao com usurio (por exemplo, durante as fases da captura/leitura de um carto com chip). Se desejar cancelar a transao atual, a AC deve chamar a rotina continuaTransacaoCTF informando o parmetro comando = 08. Caso contrrio, deve informar o parmetro comando = 00. A transao tambm poder ser cancelada pela AC durante o tratamento dos comando 05, 06 e 07; para isto, basta a AC chamar a rotina continuaTransacaoCTF informando o parmetro comando = 08 ao receber os comandos em questo.
-
BC-AUTTAR-320000050-102-PRD-INT-ET-Manual de Integrao CTFClient
Biblioteca - Cpia.docx
24/51
Anexo III Subcampos
A listagem abaixo identifica todos os subcampos retornados por esta biblioteca.
Observao: todos os campos de valor monetrio possuem o separador decimal implcito, ou seja, so expressos em centavos. Por exemplo, o campo 000000101022 corresponde ao valor 1.010,22.
E/S Nmero Tamanho Tipo Descrio
S 7000 2 N Cdigo de retorno.
S 7001 2 A Cdigo da transao CTF executada
E/S 7005 12 N Valor da transao
E/S 7006 19 A Nmero do carto digitado. Obs.: O nmero do carto ecoado no formato (999999*********9999)
E 7008 2 N Nmero de parcelas
E 7010 4 N Data de vencimento do carto digitado, no formato MMAA.
S 7011 2 A Cdigo da autorizadora do CTF.
E 7012 6 N NSU CTF do cancelamento
S 7015 3 A Cdigo de resposta
E 7020 ..20 A Nmero do documento fiscal do ECF
E 7021 12 N Nmero do cheque
E 7022 6 N Data do cheque, no formato DDMMAA
E 7023 4 N Nmero do banco
E 7024 4 N Nmero da agncia
E 7025 1 N Tipo do documento
E 7026 17 N Documento do cliente (CNPJ ou CPF)
E 7028 N Nmero da praa
S 7029* Varivel A Dados retornados na Consulta AVS
S 7029* Varivel A Dados retornados na Pagamento Eletrnico
S 7029* Varivel A Dados retornados na Consulta Analtica SPC
S 7029* Varivel A Dados retornados no Pagamento Eletrnico Estendido
S 7029* Varivel A Dados retornados na Compra de Vale Gs
S 7029* Varivel A Dados retornados na Consulta de configurao
S 7031 6 N NSU do CTF
E 7034 12 N Taxa de servio
E 7035 12 N Valor da entrada
E 7037 1 N Tipo de garantia de pr-datado (1 com garantia e 2 sem garantia).
E 7038 12 N Valor de saque
E 7039 5 A Cdigo de Segurana
E 7047 12 N Taxa de Embarque
E 7075 131 A Baixa Ordem de Servio
S 7081 9 A NSU da autorizadora
E 7094 6 N Data de agendamento do pr-datado, no formato DDMMAA.
S 7095 6 A Cdigo de aprovao da autorizadora
E 7097 6 N Data de agendamento da primeira parcela do dbito
-
BC-AUTTAR-320000050-102-PRD-INT-ET-Manual de Integrao CTFClient
Biblioteca - Cpia.docx
25/51
parcelado e do CDC, no formato DDMMAA.
E 7108 8 N Vencimento do documento de Corban, DDMMAA
E 7109 12 N Valor de descontos
E/S 7110 12 N Valor de acrscimos
S 7112 12 N Valor devido do documento (Corban)
E/S 7150 12 N Valor da parcela do plano escolhido
E 7161 6 N Data da transao original (cancelamento, reimpresso), no formato DDMMAA
E 7179 12 N Valor do cancelamento
S 7187 10 A Cdigo de erro da autorizadora
E/S 7188 VAR A Produto Convnio Farmcia
E/S 7189 VAR A Forma de Pagamento Farmcia
E 7190 2 N Nmero de ciclos
E 7191 4 N Data de emisso do carto, no formato MMAA.
S 7195 4 A MAC
E 7204 2 N Cdigo da Tabela (Parcele Mais)
E 7217 A Matrcula do funcionrio
E 7227 Varivel A Dados do servio CDC Eletrnico
E 7228 2 N Nmero do plano
E 7229 11 N Nmero do item
E 7235 12 A RG
E 7236 11 N Telefone fixo no formato DDDTTTTTTTT
E 7237 11 N Telefone mvel no formato DDDTTTTTTTT
E 7238 14 N CNPJ
E 7240 A Nmero do Pedido
S 7300 4 A Cdigo de erro Obs.: Esse campo detalha o motivo da rejeio da transao, onde seus valores esto associados aos possveis valores para o subcampo 7000 (Ver Anexo IV).
S 7301 20 A Descrio da transao
S 7302 Varivel A 1 via do cupom de TEF
S 7303 Varivel A 2 via do cupom de TEF
S 7304 Varivel A 1 via de reimpresso do cupom de TEF
S 7305 Varivel A 2 via de reimpresso do cupom de TEF
S 7306 12 A Nome da autorizadora do CTF
S 7307 2 N Cdigo da Van do CTF
S 7308 12 A Nome da Van do CTF
S 7309 4 N Cdigo da Instituio do CTF
S 7310 12 A Nome da Instituio do CTF
S 7311 8 N Data da transao no CTF no formato DDMMAAAA
S 7312 6 N Hora da transao no formato HHMMSS
S 7313 VAR A Logomarca
S 7314 12 N Valor do saldo
S 7315 12 N Valor total da transao
S 7316 5 N Taxa de juros do plano escolhido
E 7317 40 A Endereo
E 7318 6 A Nmero do endereo
E 7319 5 A Complemento do endereo
E 7320 2 A Bloco do endereo
E 7321 8 A CEP do endereo
E 7322 20 A Bairro do endereo
-
BC-AUTTAR-320000050-102-PRD-INT-ET-Manual de Integrao CTFClient
Biblioteca - Cpia.docx
26/51
E 7323 35 A CMC7:
1 Tipo de leitura: 0 Digitado 1 Leitor de documento / Scanner
34 CMC7
E 7324 4 N 4 ltimos dgitos
E 7325 20 A Cdigo da carga
E 7326 8 A Cdigo de ocorrncia
E 7327 10 N Data da baixa tcnica no formato DDMMAAHHmm
E 7328 20 A Endereo do estabelecimento
E 7329 20 A ESP credenciada
E 7330 5 A Identificao do tcnico
E 7331 20 A Nome do estabelecimento
E 7332 8 A Nmero da OS
E 7333 10 N DDTTTTTTTT
E 7334 8 N Nmero da conta-corrente
E 7335 11 N CPF
E 7336 3 N DDD do telefone
E 7337 8 N Nmero do telefone
E 7338 Varivel A Informaes adicionais
E 7339 8 N Valor da 1 parcela
E 7340 4 N Data de abertura da conta no formato MMAA
E 7341 1 N Questionamento sobre uso do saldo restante do Voucher
E 7342 1 N Deciso da operao Compra & Saque (Questionamento realizado quando a compra aprovada e o saque negado)
E 7343 6 A Cdigo de Autorizao
E 7344 49 N Captura do cdigo de barras:
1 Tipo de leitura: 0 Digitado; 1 Leitor de documento / Scanner
48 Cdigo de barras
Obs.: Quando o Tipo de Leitura for informado com valor igual 0, apenas o 1 Bloco do cdigo de barras dever ser informado, onde os demais blocos sero capturados e validados separadamente.
E 7346 11 N Cdigo de barras do titulo (1 bloco)
E 7347 11 N Cdigo de barras do titulo (2 bloco)
E 7348 11 N Cdigo de barras do titulo (3 bloco)
E 7349 1 N Cdigo de barras do titulo (4 bloco)
E 7350 14 N Cdigo de barras do titulo (5 bloco)
E 7351 12 N Cdigo de barras do convnio (1 bloco)
E 7352 12 N Cdigo de barras do convnio (2 bloco)
E 7353 12 N Cdigo de barras do convnio (3 bloco)
E 7354 12 N Cdigo de barras do convnio (4 bloco)
E 7358 1 N Questionamento de transao pendente
E 7359 1 N Valor da recarga de telefone
S 7384 Varivel A Cupom reduzido
S 7385 Varivel A Mensagem de display da transao, cada linha separada com #
-
BC-AUTTAR-320000050-102-PRD-INT-ET-Manual de Integrao CTFClient
Biblioteca - Cpia.docx
27/51
* O detalhamento dos campos 0029 Bit 62 de sada segue a definio da integrao via arquivo [1].
Subcampo 0029 para Consulta AVS
Campo Tamanho Posio Tipo Descrio
Descritor do tipo de informao
1 1 A Descritor do tipo de informao. Constante igual a A.
Cdigo de Resposta
1 2 A Cdigo de resposta da consulta AVS retornado pelo emissor do carto
Mensagem VAR 3 A Descrio do Cdigo de resposta da consulta AVS
Subcampo 0029 para Pagamento Eletrnico
Campo Tamanho Posio Tipo Descrio
Nome do cedente 40 1 A Nome do cedente/convenente.
Data Contbil 6 41 N Data do movimento (dia til em que se efetivar o pagamento).
Formas de pagamentos
8 47 N Formas de pagamentos permitidas (til nas transaes rejeitadas).
Nmero da Concessionria
17 55 A Nmero da Concessionria (brancos para Ttulo).
Filler 29 72 A Preenchido com zeros.
Autenticao 16 101 A Autenticao do documento (informativo).
Valor 12 117 N Valor do pagamento (incluindo juros/descontos) (eco).
Valor devido calculado (se fornecido pela Autorizadora).
Descontos 12 129 N Valor dos descontos (eco).
Acrscimos 12 141 N Valor dos acrscimos (eco).
Data Vencimento 8 153 N Data de vencimento informada (eco).
Modo de Entrada 1 161 N Modo de entrada do cdigo de barras (1
-
BC-AUTTAR-320000050-102-PRD-INT-ET-Manual de Integrao CTFClient
Biblioteca - Cpia.docx
28/51
se digitado, 3 se lido) (eco).
Cdigo de Barras 48 162 N Cdigo de Barras do Ttulo ou Arrecadao (alinhado direita com zeros esquerda). Se o ltimo bloco do Ttulo digitado estiver incompleto (menos de 14 posies), este deve ser alinhado direita com zeros esquerda, totalizando 47 posies (eco).
Modalidade de Pagamento
2 210 N Modalidade de Pagamento (eco).
CMC7 34 212 A CMC7 para a modalidade pagamento cheque (eco).
Subcampo 0029 para Consulta Analtica SPC
Campo Tamanho Posio Tipo Descrio
Cdigo do Cliente 15 1 N Cdigo do cliente
Nmero do Documento 17 16 N Nmero do documento (CNPJ/CPF)
Nome do cliente 40 33 A Nome do cliente
Status da Consulta 1 73 N Status da consulta:
0, se consulta e atualizao realizados com sucesso;
1, se dados SPC atualizados sem consulta;
2, se erro consulta no realizada repetir processo.
ltima resposta do SPC 2 74 N Resposta da ltima Consulta SPC:
Se = 00, nada consta;
Se = 01, constam registros.
Data da ltima consulta ao SPC
6 76 N Data da ltima consulta realizada ao SPC.
Subcampo 0029 para Consulta de Valores para Compra de Crdito Digital
-
BC-AUTTAR-320000050-102-PRD-INT-ET-Manual de Integrao CTFClient
Biblioteca - Cpia.docx
29/51
Campo Tamanho Posio Tipo Descrio
Cdigo da Operadora 02 1 N Cdigo da operadora associada a consulta
Telefone (DDD+nmero) 11 3 N Telefone capturado pelo Client na consulta
Valor Varivel Mnimo 10 14 N Normalmente 0: no permite valor varivel
Valor Varivel Mximo 10 24 N Normalmente 0: no permite valor varivel
Qtd de valores de Compra de Crdito Digital
02 34 N Qtde de valores preenchidos (limite = 10)
Valor 1 10 36 N Valores fixos de Compra de Crdito Digital
Valor 2 10 46 N
Valor 3 10 56 N
Valor 4 10 66 N
Valor 5 10 76 N
Valor 6 10 86 N
Valor 7 10 96 N
Valor 8 10 106 N
Valor 9 10 116 N
Valor 10 10 126 N
Qtd de valores de bnus 02 136 N Qtde de valores de bnus preenchidos
Bnus 1 10 138 N Bnus para Compra de Crdito Digital respectiva (valor 1)
Bnus 2 10 148 N
Bnus 3 10 158 N
Bnus 4 10 168 N
Bnus 5 10 178 N
-
BC-AUTTAR-320000050-102-PRD-INT-ET-Manual de Integrao CTFClient
Biblioteca - Cpia.docx
30/51
Bnus 6 10 188 N
Bnus 7 10 198 N
Bnus 8 10 208 N
Bnus 9 10 218 N
Bnus 10 10 228 N
Subcampo 0029 para Pagamento Eletrnico Estendido
Retornado nas operaes:
182 Consulta de Pagamento de Carto Private Label;
183 Pagamento de Carto Private Label.
Campo Tamanho Posio Tipo Descrio
Nome do Cedente
40 1 A Nome do Cedente (para ser impresso no cheque nominal)
Data Contbil 6 41 N Data contbil para efetivao do pagamento, no formato AAMMDD.
Formas de Pagamento
8 47 N Formas de pagamento permitidas, til nas consultas e transaes de pagamento rejeitadas. Cada byte pode assumir o valor 0 ou 1, indicando se a forma de pagamento esta desabilitada ou habilitada:
Primeira posio: dinheiro;
Segunda posio: cheque;
Terceira posio: cheque do banco;
Quarta posio: carto de dbito;
Quinta posio: carto de crdito;
Sexta posio: carto prprio;
Stima posio: reservado para uso futuro;
Oitava posio: reservado para uso
-
BC-AUTTAR-320000050-102-PRD-INT-ET-Manual de Integrao CTFClient
Biblioteca - Cpia.docx
31/51
futuro.
Exemplo de pagamento em dinheiro e cheque: 11000000.
Nmero do Convnio
17 55 N Nmero do Convnio
Valor Devido 12 72 N Valor devido
Valor Original 12 84 N Valor original do documento
Filler 5 96 N Bytes no utilizados
Autenticao 16 101 A Autenticao do documento
Acrscimos 12 117 N Valor de acrscimos
Descontos 12 129 N Valor de descontos
Pagamento Mnimo
12 141 N Valor de pagamento mnimo
Data de Vencimento
6 153 N Data de vencimento da fatura atual
Nmero do documento
16 159 N Nmero do documento
Modo de Entrada 1 175 N Modo de entrada do cdigo de barras (1 se digitado, 3 se lido) (eco).
Cdigo de Barras 48 176 N Cdigo de Barras do Ttulo ou Arrecadao (alinhado direita com zeros esquerda). Se o ltimo bloco do Ttulo digitado estiver incompleto (menos de 14 posies), este deve ser alinhado direita com zeros esquerda, totalizando 47 posies (eco).
Modalidade de Pagamento
2 224 N Modalidade de Pagamento (eco).
-
BC-AUTTAR-320000050-102-PRD-INT-ET-Manual de Integrao CTFClient
Biblioteca - Cpia.docx
32/51
Subcampo 0029 para 235 - Compra de Vale gs
Campo Tamanho Posio Tipo Descrio
Cdigo do produto 7 1 N Cdigo do produto Vale gs
Descrio do produto 15 8 A Descrio do produto Vale gs
Subcampo 0029 para 228 Consulta de configurao
Campo Tamanho Posio Tipo Descrio
Verso AC 10 1 A
Host e porta CTFClient
LLVAR 11 A..99 Nome de rede (ou endereo IP) e porta de servio de rede do CTFClient, no formato: LLVARNNNNN. Onde: LLVAR o IP/nome do host e NNNNN a porta (justificada a direita com zeros esquerda). Exemplo: 14ctf.auttar.com.br01669.
Lista de hosts e portas do CTF Server
LLLVAR (...) A..999 Lista contendo os nomes de rede (ou endereos IP), portas de servio e protocolos de comunicao do CTF Server. Este parmetro, por ser uma lista, composto de vrias entradas em seqncia. O LLL indica o tamanho total da seqncia em VAR. Cada entrada da lista deve estar no formato: LLVARNNNNNPPPP. Onde:
LLVAR IP/nome do host
NNNNN Porta (justificada a direita com zeros esquerda)
PPPP Protocolo (justificado a esquerda com espao a direita)
A ltima entrada da lista deve conter apenas o 00 do tamanho do nome/IP. Exemplo: supondo que a lista de host:portas:protocolo dos servidores CTF possuam as seguintes entradas: ctf1.auttar.com.br:1996:TCP ctf2.auttar.com.br:1998:UDP este parmetro no POSENTRA teria o
-
BC-AUTTAR-320000050-102-PRD-INT-ET-Manual de Integrao CTFClient
Biblioteca - Cpia.docx
33/51
contedo: 06018ctf1.auttar.com.br01996TCP
Tipo teclado 40 A Identificador do tipo de teclado que dever ser utilizado pelo CTFClient para entrada de dados (vide Anexo D)
Parmetros teclado LLLVAR A..999 Parmetros especficos para o tipo escolhido de teclado. O valor de cada parmetro deve ser separado por , (vrgula) (vide Anexo D)
Tipo display operador 40 A Identificador do tipo de display que dever ser utilizado pelo CTFClient para efetuar captura de dados e exibio de informaes para o operador da AC. O valor de cada parmetro deve ser separado por , (vrgula) (vide Anexo D)
Parmetros display operador
LLLVAR A..999 Parmetros especficos para o tipo escolhido de display para o operador. O valor de cada parmetro deve ser separado por , (vrgula) (vide Anexo D)
Tipo display cliente 40
A Identificador do tipo de display que dever ser utilizado pelo CTFClient para efetuar exibio de informaes para o cliente da AC, tal como menu com opes de produtos visanet, menu de tipos de finaciamento, etc (vide Anexo D)
Parmetros display cliente
LLLVAR A..999 Parmetros especficos para o tipo escolhido de display para o cliente. O valor de cada parmetro deve ser separado por , (vrgula) (vide Anexo D)
Tipo leitor de cartes
40 A Identificador do tipo de leitor de cartes que dever ser utilizado pelo CTFClient para a leitura de cartes (vide Anexo D)
Parmetros leitor de cartes
LLLVAR A..999 Parmetros especficos para o tipo escolhido de leitor de cartes. O valor de cada parmetro deve ser separado por , (vrgula) (vide Anexo D)
Tipo de PIN-Pad
40 A Identificador do tipo de PIN-Pad que dever ser utilizado pelo CTFClient para a captura de senhas (vide Anexo
-
BC-AUTTAR-320000050-102-PRD-INT-ET-Manual de Integrao CTFClient
Biblioteca - Cpia.docx
34/51
D)
Parmetros PIN-Pad LLLVAR A..999 Parmetros especficos para o tipo escolhido de PIN-Pad. O valor de cada parmetro deve ser separado por , (vrgula) (vide Anexo D)
Tipo de leitor de cdigos de barras
40 A Identificador do tipo de leitor que dever ser utilizado pelo CTFClient para a leitura de cdigos de barras (vide Anexo D)
Parmetros leitor cdigos de barras
LLLVAR A..999 Parmetros especficos para o tipo escolhido de leitor de cdigos de barras. O valor de cada parmetro deve ser separado por , (vrgula) (vide Anexo D)
Tipo de leitor de documentos
40 A Identificador do tipo de leitor que dever ser utilizado pelo CTFClient para a leitura de documentos (vide Anexo D)
Parmetros leitor de documentos
LLLVAR A..999 Parmetros especficos para o tipo escolhido de leitor de documentos. O valor de cada parmetro deve ser separado por , (vrgula) (vide Anexo D)
Integrao criptografada
1 N Indica a criptografia do POSENTRA
0 No criptografado
1 Criptografado
Leitura do CMC-7 1 N Indica a leitura do CMC-7 do cheque
0 No ler
1 Efetuar a leitura
Crdito com celular habilitado
1 N Indica se o fluxo de crdito poder ser direcionado para ser pago com celular
0 No habilitado
1 Habilitado
-
BC-AUTTAR-320000050-102-PRD-INT-ET-Manual de Integrao CTFClient
Biblioteca - Cpia.docx
35/51
Anexo IV - Cdigo de Erro (Subcampo 7300)
A listagem abaixo identifica o Cdigo de Erro (subcampo - 7300) e relaciona seu uso com o valor do Cdigo de Retorno fornecido pelo CTFClient no subcampo 7000.
Erros de integrao com CTFClient, associados aos retornos 04 e 20:
Erro Descrio Motivos Aes
4999 Arquivo POSENTRA no existe
CTFClient foi executado e no encontrou o arquivo POSENTRA no diretrio onde est instalado
Verificar se o arquivo POSENTRA encontra-se no diretrio onde est instalado o CTFClient.
5000 Cdigo do terminal do POSENTRA difere do terminal do CTFClient
O cdigo do terminal do POSENTRA deve ser igual ao cadastrado no CTFClient. Opcionalmente pode conter brancos.
Ajustar a identificao do terminal no POSENTRA ou na janela Preferncias.
5001 Erro de abertura do arquivo POSENTRA
Arquivo existe mas no pode ser aberto
Verificar permisses e atributos do arquivo.
5002 Erro de leitura da primeira linha do POSENTRA
Primeira linha no pode ser lida
Verificar problemas no Sistema Operacional e atributos do arquivo.
5003 Primeira linha do POSENTRA no possui avano de linha (\n).
Verificar layout do arquivo
5004 Tamanho invlido da primeira linha
O tamanho deve ser igual a 35 ou 74 posies.
Verificar layout do arquivo
5005 Erro de leitura da segunda linha do POSENTRA
Verificar problemas no Sistema Operacional e atributos do arquivo.
5006 Segunda linha do POSENTRA no possui avano de linha (\n).
Verificar layout do arquivo
5007 Tamanho invlido da segunda linha do POSENTRA
O tamanho deve ser igual a 128 posies.
Verificar layout do arquivo
5008 Erro de leitura da terceira linha do POSENTRA
Verificar problemas no Sistema Operacional e atributos do arquivo.
5009 Terceira linha do POSENTRA no possui avano de linha (\n).
Verificar layout do arquivo
5010 Tamanho invlido da terceira linha do POSENTRA
O tamanho deve ser igual soma dos tamanhos dos campos informados na segunda linha do POSENTRA.
5011 POSENTRA contm nmero do carto -
Arquivo POSENTRA no pode conter dados de
Criptografar o POSENTRA conforme seo 4.3
-
BC-AUTTAR-320000050-102-PRD-INT-ET-Manual de Integrao CTFClient
Biblioteca - Cpia.docx
36/51
criptograr POSENTRA seguranas abertos Criptografia do arquivo POSENTRA
5012 POSENTRA contm vencimento do carto - criptograr POSENTRA
Arquivo POSENTRA no pode conter dados de seguranas abertos
Criptografar o POSENTRA conforme seo 4.3 Criptografia do arquivo POSENTRA
5013 POSENTRA contm cdigo de segurana - criptograr POSENTRA
Arquivo POSENTRA no pode conter dados de seguranas abertos
Criptografar o POSENTRA conforme seo 4.3 Criptografia do arquivo POSENTRA
5014 POSENTRA contm DDD - criptograr POSENTRA
Arquivo POSENTRA no pode conter dados de seguranas abertos
Criptografar o POSENTRA conforme seo 4.3 Criptografia do arquivo POSENTRA
5015 POSENTRA contm telefone - criptograr POSENTRA
Arquivo POSENTRA no pode conter dados de seguranas abertos
Criptografar o POSENTRA conforme seo 4.3 Criptografia do arquivo POSENTRA
5100 Arquivo de configurao do CTFClient (confClientCTF.xml) no foi encontrado
Provavelmente o arquivo de configurao do CTFClient no existe ou est em um diretrio diferente do CTFClient
Disponibilizar o arquivo de configurao no diretrio correto
5101 Erro na abertura do arquivo de configurao do CTFClient (confClientCTF.xml)
5102 Erro lendo arquivo de configurao do CTFClient (confClientCTF.xml)
5103 Campo portClient no encontrado na configurao do CTFClient (confClientCTF.xml)
Rever arquivo de configurao e incluir o campo portaClientCTF com o nmero da porta de servio TCP/IP do CTFClient
5104 Erro conectando-se com CTFClient
Erro ao abrir conexo de rede com o servio CTFClient
O CTFClient pode no estar em execuo no momento. Nesse caso, colocar o CTFClient em execuo. Verificar se o campo portaClientCTF est com o valor correto no arquivo de configurao (confClientCTF.xml). Configurar o valor correto para o parmetro e reiniciar o CTFClient. Verificar se a rede e protocolo TCP/IP esto configurados de forma correta no computador em questo.
5105 Erro comunicando-se com o CTFClient
Possivelmente, ocorreu um erro fatal durante a
-
BC-AUTTAR-320000050-102-PRD-INT-ET-Manual de Integrao CTFClient
Biblioteca - Cpia.docx
37/51
comunicao com o CTFClient. Verificar se o servio ainda est em execuo e se a rede est funcionando a contento.
5106 Erro no contedo do arquivo de configurao CONFIG.INI do CLIENTCTF.EXE
Deve-se observar no arquivo config.ini a existncia e o contedo dos campos obrigatrios : diretorioWrapper, operacoesClientWindows, diretorioClientWindows , executavelClientWindows e porta
5107 Diretrios indicados no arquivo de configurao config.ini no encontrados
Criar ou assegurar os diretrios onde residiro o client Windows e o wrapper.
5108 Executvel do client Windows no encontrado.
Verificar o nome do client Windows indicado no config.ini.
5109 Erro na converso de formatos entre as verses antiga e nova do POSENTRA e o POSSAIDA
Verificar a existncia e atributos dos arquivos POSENTRA e POSSAIDA, bem como de seus diretrios.
5110 Erro para obter o cdigo da operao no arquivo POSENTRA
Verificar a existncia e atributos do arquivo POSENTRA, bem como os 3 primeiros bytes que representam a operao.
5120 Erro para obter o delay de resposta da rede
Verificar a existncia e atributos do parmetro no arquivo CONFIG.INI do ClientCTF
5121 Erro para obter o time out padro de resposta da transao
Verificar a existncia e atributos do parmetro no arquivo CONFIG.INI do ClientCTF
5122 Erro para obter o nmero de vias de comprovantes
Verificar a existncia e atributos do parmetro no arquivo CONFIG.INI do ClientCTF
5123 Erro para obter o tipo do pinpad
Verificar a existncia e atributos do parmetro no arquivo CONFIG.INI do ClientCTF
5126 Erro para obter a lista de endereos IPs
Verificar a existncia e atributos do parmetro no arquivo CONFIG.INI do ClientCTF
5127 Erro para obter o nome do teclado
Verificar a existncia e atributos do parmetro no arquivo CONFIG.INI do
-
BC-AUTTAR-320000050-102-PRD-INT-ET-Manual de Integrao CTFClient
Biblioteca - Cpia.docx
38/51
ClientCTF
5128 Erro para obter o flag de transaes digitadas
Verificar a existncia e atributos do parmetro no arquivo CONFIG.INI do ClientCTF
5129 Erro para obter os valores das teclas especiais
Para os Client's no ficarem disconexos
Verificar a existncia e atributos do parmetro no arquivo CONFIG.INI do ClientCTF
5130 Erro para obter o nome do display
Verificar a existncia e atributos do parmetro no arquivo CONFIG.INI do ClientCTF
5131 Leitura de carto desabilitada
Verificar a configurao do tipo do pinpad e a habilitao de transaes digitadas do ClientCTF
5132 Erro no parmetro flag stand alone
O parmetro flag stand alone possui valor invlido
Rever o parmetro flag stand alone do arquivo de configurao (valor default = 0: integrao via arquivo)
5133 Erro no parmetro flag criptografia do POSENTRA
O parmetro flag criptografia do POSENTRA possui valor invlido
Rever o parmetro flag criptografia do POSENTRA do arquivo de configurao (valor default = 0: no criptografado)
5200 Erro de timeout. Erro de conexo socket com a AC.
5220 Erro no tratado pela camada de integrao com o CTFClient
5300 Valor no informado
5301 Carto invlido
5302 Carto vencido
5303 Data de vencimento invlida
5304 Cdigo de segurana invlido
5305 Taxa de servio excede limite
5306 Operao no permitida
5307 Dados invlidos
5308 Valor mnimo da parcela
5309 Nmero de parcelas invlido
5310 Nmero de parcelas excede limite
5311 Valor da entrada maior ou igual ao valor da transao
5312 Valor da parcela invlido
-
BC-AUTTAR-320000050-102-PRD-INT-ET-Manual de Integrao CTFClient
Biblioteca - Cpia.docx
39/51
5313 Data invlida
5314 Prazo excede limite
5315 Transao invlida para o tipo de garantia
5316 NSU invlido
5317 Operao cancelada pelo usurio
5318 Documento invlido (CPF ou CNPJ)
5319 Valor do documento invlido
5320 Nmero do plano invlido
5321 Nmero do ciclo invlido
5322 Nmero do item invlido
5323 Nmero da transao invlido
5324 Data AC no informada
5325 Verso AC no informada
5326 Verso AC difere da verso configurada
5327 PIN-Pad desconectado
5328 Erro na captura de dados do PIN-Pad
5329 Erro na captura de dados do CHIP
5330 Fluxo no encontrado
5331 Erro de processamento do CTFClient
CTFClient no conseguiu recuperar os parmetros do arquivos de configurao. Rever a configurao do CTFClient. Erro interno de processamento da transao. Reinstalar o CTFClient.
5332 Captura do valor da entrada no habilitada
5333 Captura do valor da parcela no habilitada
5334 Data menor que o mnimo
5335 Captura da data da 1 parcela no habilitada
5336 Captura do valor do saque no habilitada
5337 Byte do POSENTRA no tratado na integrao
Rever o mapa de bytes e a terceira linha do POSENTRA
5338 Erro na leitura do cdigo da operao da
Rever a terceira linha do POSENTRA
-
BC-AUTTAR-320000050-102-PRD-INT-ET-Manual de Integrao CTFClient
Biblioteca - Cpia.docx
40/51
terceira linha
5339 Erro na leitura do nmero do documento da terceira linha
Rever a terceira linha do POSENTRA
5340 Erro na leitura do valor da transao
Rever a terceira linha do POSENTRA
5341 Erro na leitura do nmero do carto
Rever a terceira linha do POSENTRA
5342 Erro na leitura do campo info
Rever a terceira linha do POSENTRA
5343 Erro na leitura timestamp
Rever a terceira linha do POSENTRA
5344 Erro na leitura da senha Rever a terceira linha do POSENTRA
5345 Erro na leitura do nmero do parcelas
Rever a terceira linha do POSENTRA
5346 Erro na leitura do vencimento do carto
Rever a terceira linha do POSENTRA
5347 Erro na leitura da data de referncia
Rever a terceira linha do POSENTRA
5348 Erro na leitura do valor de entrada
Rever a terceira linha do POSENTRA
5349 Erro na leitura NSU CTF
Rever a terceira linha do POSENTRA
5350 Erro na leitura do valor de parcela
Rever a terceira linha do POSENTRA
5351 Erro na leitura do bit 62 Rever a terceira linha do POSENTRA
5352 Erro na leitura do cdigo de segurana
Rever a terceira linha do POSENTRA
5353 Erro na leitura do valor de saque
Rever a terceira linha do POSENTRA
5354 Erro na leitura da garantia do pr-datado
Rever a terceira linha do POSENTRA
5355 Erro na leitura do nome da AC
Rever a terceira linha do POSENTRA
5356 Erro na leitura do valor do desconto
Rever a terceira linha do POSENTRA
5357 Erro na leitura do valor do acrscimo
Rever a terceira linha do POSENTRA
5358 Pinpad sem api compartilhada
O pinpad instalado no possui Api compartilhada. O pinpad deve ser atualizado ou trocado.
5359 Erro na leitura da forma de pagamento do pagamento de contas
Parmetro invlido na forma de pagamento
Rever a terceira linha do POSENTRA
5360 Erro na leitura da forma de entrada do cdigo de barras do pagamento de contas
Parmetro invlido na forma de entrada
Rever a terceira linha do POSENTRA
5361 Erro na leitura no tipo do documento
Parmetro invlido Rever a terceira linha do POSENTRA
-
BC-AUTTAR-320000050-102-PRD-INT-ET-Manual de Integrao CTFClient
Biblioteca - Cpia.docx
41/51
5362 Captura do nmero de ciclos no habilitada
5363 Captura do cdigo de pr-autorizao no habilitada
5364 Data de emisso do carto invlida
5365 Timestamp do POSENTRA no coincide com o timestamp do CTFClient
Rever a integrao com o envio de timestamp.
5366 O tipo de financiamento informado no coerente com o nmero de parcelas
Verifique o tipo de financiamento informado, que no condiz com a quantidade de parcelas
5367 NSU Invlido NSU invlido ou transao liberada por timeout
Refazer a transao e-Commerce
5368 No existe terminal disponvel
Estouro do nmero de terminais configurados para e-Commerce
Refazer a transao e-Commerce. Aumentar o nmero de terminais configurados para e-Commerce.
5369 Cdigo identificador da multitransao invlido
Identificador da multitransao com formato invlido
Corrigir o subcampo 75 Cdigo multitransao no POSENTRA
5370 Operadora de telefonia invlida
Rever a terceira linha do POSENTRA
5371 DDD ou Telefone invlido
Rever a terceira linha do POSENTRA
5372 A transao no est no log
Foi tentado cancelar uma transao que no est no Log do concentrador TEF, portanto ela no poder ser cancelada.
5373 Valor de cancelamento invlido
O valor maior que o valor permitido para cancelamento
Corrigir o valor do cancelamento.
5374 Valor de cancelamento invlido
O valor do cancelamento maior que o valor da transao original
Corrigir o valor do cancelamento.
5375 Valor de cancelamento invlido
O valor maior que o percentual para cancelamento
Corrigir o valor do cancelamento.
5376 Valor de cancelamento invlido
O valor do cancelamento somado ao valor j cancelado maior que o percentual para cancelamento
Corrigir o valor do cancelamento.
5377 Pagamento com saldo do voucher no autorizado
O valor do venda com carto de Voucher no teve saldo suficiente para pagamento total e o saldo do carto no foi autorizado para pagamento parcial.
Utilizar outra forma de pagamento.
5378 Nmero da transao A seqncia do nmero da Corrigir o nmero da
-
BC-AUTTAR-320000050-102-PRD-INT-ET-Manual de Integrao CTFClient
Biblioteca - Cpia.docx
42/51
invlido transao invlida transao informado no subcampo 33 do POSENTRA.
5379 Nenhuma modalidade de pagamento habilitada
Nenhuma modalidade de pagamento habilitada
Verificar configurao no CTF
Erros Intertef da APITEF, associados ao retorno 12:
Erro Descrio Motivos/Aes
2001 Erro de abertura do arquivo de cupom. Erro de criao do arquivo CUPOMCTF.*. Verificar as permisses do usurio para criao de arquivos e a disponibilidade do Sistema Operacional (disco cheio, etc).
2011 Erro de abertura do arquivo C_M_O_S.TEF. Verificar se os arquivos do diretrio, onde est o ClientCTF, foram apagados ou se no esto acessveis.
2012 Erro de leitura do arquivo C_M_O_S.TEF.
2021 Erro de abertura do arquivo TRANSAC.TEF.
2022 Erro de busca do arquivo TRANSAC.TEF.
2023 Erro de leitura do arquivo TRANSAC.TEF.
2031 Erro de abertura do arquivo C_M_O_S.TEF.
2032 Erro de gravao do arquivo C_M_O_S.TEF.
2041 Erro de abertura do arquivo TRANSAC.TEF.
2042 Erro de busca do arquivo TRANSAC.TEF.
2043 Erro de gravao do arquivo TRANSAC.TEF.
2040 Tamanho do buffer recebido do CTF maior que o esperado.
Verificar se a mensagem recebida do CTF possui mais que 4000 bytes.
Erros de Comunicao da Apitef, associados ao retorno 10:
Erro Descrio Motivos/Aes
1004 Erro na inicializao da Camada de comunicao.
Verificar permisses de acesso aos recursos do Sistema Operacional (erro de acesso arquivo INTERNET.TEF).
1005 Camada de rede no inicializada. Camada de rede no inicializada, ao enviar a mensagem para o CTF:
verificar ser a transao est sendo executada do mesmo diretrio;
se foi executado o comando 02 Incio TEF;
Verificar permisses de acesso aos recursos do Sistema Operacional (erro de acesso arquivo INTERNET.TEF).
1006 Camada de rede no inicializada. Camada de rede no inicializada, ao tratar
-
BC-AUTTAR-320000050-102-PRD-INT-ET-Manual de Integrao CTFClient
Biblioteca - Cpia.docx
43/51
a mensagem de resposta do CTF:
Verificar se foi executado o comando 02 Incio TEF;
Verificar permisses de acesso aos recursos do Sistema Operacional (erro de acesso arquivo INTERNET.TEF).
1007 Camada de rede no inicializada. Camada de rede no inicializada, ao enviar a confirmao ao CTF:
Verificar se foi executado o comando 02 Incio TEF;
Verificar permisses de acesso aos recursos do Sistema Operacional (erro de acesso arquivo INTERNET.TEF).
1002 Erro de acesso ao arquivo INTERNET.TEF verificar ser a transao est sendo executada do mesmo diretrio;
se foi executado o comando 02 Incio TEF;
Verificar permisses de acesso aos recursos do Sistema Operacional (erro de acesso arquivo INTERNET.TEF).
1003 Erro de acesso ao arquivo INTERNET.TEF
0200 Parmetros invlidos.
0201 No conseguiu abrir o canal de comunicao.
0202 No conseguiu resolver o endereo do CTF.
Verificar a configurao do arquivo Hosts ou do DNS.
0203 Erro no envio da mensagem.
0204 Mensagem enviada de tamanho diferente do esperado.
0205 Endereo IP j est em uso.
0206 Erro ao receber a mensagem.
0001 Timeout.
0208 Erro receber a mensagem.
0209 Erro receber a mensagem.
-
BC-AUTTAR-320000050-102-PRD-INT-ET-Manual de Integrao CTFClient
Biblioteca - Cpia.docx
44/51
Anexo V Operaes CTFClient
Operao Descrio
012 Reimpresso do ltimo Comprovante
101 Dbito
103 Dbito Pr-datado
104 Dbito Parcelado
105 Dbito Parcelado com parcela Vista
106 Dbito Voucher
108 Dbito CDC c/ Parcela Vista
109 Dbito CDC s/ Parcela Vista
110 Consulta CDC c/ Parcela Vista
111 Consulta CDC s/ Parcela Vista
112 Crdito
113 Crdito Parcelado Sem Juros
114 Crdito Parcelado Com Juros
115 Crdito IATA
116 Crdito IATA Sem Juros
117 Crdito IATA Com Juros
118 Consulta Crdito
119 Pr-autorizao Crdito
120 Crdito Digitado
121 Crdito Digitado Parcelado Sem Juros
122 Crdito Digitado Parcelado Com Juros
123 Crdito Digitado IATA
124 Crdito Digitado IATA Sem Juros
125 Crdito Digitado IATA Com Juros
126 Consulta Crdito Digitado
127 Pr-autorizao Crdito Digitado
128 Cancelamento Genrico
129 Consulta Cheque
132 Confirmao Pr-Autorizao
133 Confirmao Pr-Autorizao Digitada
134 Cancelamento de Pr-Autorizao
137 Garantia de Cheque
139 Consulta AVS
140 Cash Private Label Rotativo ou Parcelado
141 Consulta de Cash Private Label
142 Crdito Private Label
143 Crdito Private Label Digitado
144 Consulta Private Label
145 Consulta Private Label Digitado
146 Autorizao IATA
147 Autorizao IATA sem Juros
149 Autorizao IATA Digitado
150 Autorizao IATA Digitado sem Juros
152 Pagamento de Ttulo com Consulta
153 Pagamento de Ttulo
154 Pagamento de Arrecadao com Consulta
155 Pagamento de Arrecadao
-
BC-AUTTAR-320000050-102-PRD-INT-ET-Manual de Integrao CTFClient
Biblioteca - Cpia.docx
45/51
156 Estorno de Pagamento
158 Cancelamento de Crdito
159 Cancelamento de Dbito
167 Confirmao Pr-Autorizao Sem Juros
168 Confirmao Pr-Autorizao Com Juros
169 Confirmao Pr-Autorizao Digitada Sem Juros
170 Confirmao Pr-Autorizao Digitada Com Juros
172 Consulta Analtica SPC
173 Consulta de Valores de Crdito Digital
174 Compra de Crdito Digital
177 Cancelamento de Pagamento de Credirio
180 Consulta de Ttulo
181 Consulta de Arrecadao
220 Baixa Tcnica Manual
222 Transao Genrica
225 Incio Dia
226 Consulta Carto
227 By pass
228 Consulta de configurao
229 Reimpresso de Outro Comprovante
230 Pagamento de Ttulo com Carto de Dbito
231 Pagamento de Arrecadao com Carto de Dbito
232 Compra Crdito a Vista com Celular
233 Compra Crdito Parcelada Lojista com Celular
234 Compra Crdito Parcelada Administradora com Celular
235 Compra de Vale gs
236 Troco Surpresa
238 Parcele Mais
239 Estatstica Manual
Anexo VI Parmetros
A listagem abaixo identifica os parmetros adicionais para funo iniciaClientCTF. Nome Descrio Tipo Tamanho Detalhe
host-ctfclient Host e porta CTFClient
LLVAR A .. 99 Nome de rede (ou endereo IP) e porta de servio de rede do CTFClient, no formato: LLVARNNNNN. Onde: LLVAR o IP/nome do host e NNNNN a porta (justificada a direita com zeros esquerda). Exemplo: 14ctf.auttar.com.br01669.
tipo-teclado Tipo teclado 40 A Identificador do tipo de teclado que dever ser utilizado pelo CTFClient para entrada de dados (vide tpico Dispositivos suportado pelo CTFClient)
parans-teclado Parmetros do teclado
LLLVAR A .. 999 Parmetros especficos para o tipo escolhido de teclado. O valor de cada parmetro deve ser separado por , (vrgula) (vide tpico Dispositivos
-
BC-AUTTAR-320000050-102-PRD-INT-ET-Manual de Integrao CTFClient
Biblioteca - Cpia.docx
46/51
suportado pelo CTFClient)
display-operador Tipo display operador
40 A Identificador do tipo de display que dever ser utilizado pelo CTFClient para efetuar captura de dados e exibio de informaes para o operador da AC. O valor de cada parmetro deve ser separado por , (vrgula) (vide tpico Dispositivos suportado pelo CTFClient)
parans-display-operador
Parmetros do display operador
LLLVAR A .. 999 Parmetros especficos para o tipo escolhido de display para o operador. O valor de cada parmetro deve ser separado por , (vrgula) (vide tpico Dispositivos suportado pelo CTFClient)
display-cliente Tipo display cliente
40 A Identificador do tipo de display que dever ser utilizado pelo CTFClient para efetuar exibio de informaes para o cliente da AC, tal como menu com opes de produtos visanet, menu de tipos de finaciamento, etc (vide tpico Dispositivos suportado pelo CTFClient)
parans-display-cliente
Parmetros display cliente
LLLVAR A .. 999 Parmetros especficos para o tipo escolhido de display para o cliente. O valor de cada parmetro deve ser separado por , (vrgula) (vide tpico Dispositivos suportado pelo CTFClient)
parans-leitor-cartao Parmetros do leitor de cartes
LLLVAR A .. 999 Parmetros especficos para o tipo escolhido de leitor de cartes. O valor de cada parmetro deve ser separado por , (vrgula) (vide tpico Dispositivos suportado pelo CTFClient)
parans-pinpad Parmetros do PIN-Pad
LLLVAR A .. 999 Parmetros especficos para o tipo escolhido de PIN-Pad. O valor de cada parmetro deve ser separado por , (vrgula) (vide tpico Dispositivos suportado pelo CTFClient)
tipo-scanner Tipo de leitor de cdigos de barras
40 A Identificador do tipo de leitor que dever ser utilizado pelo CTFClient para a leitura de cdigos de barras (vide tpico Dispositivos suportado pelo CTFClient)
parans-scanner Parmetros do leitor cdigos de barras
LLLVAR A .. 999 Parmetros especficos para o tipo escolhido de leitor de cdigos de barras. O valor de cada parmetro deve ser separado por , (vrgula) (vide tpico Dispositivos suportado pelo CTFClient)
tipo-leitor-documento
Tipo de leitor de documentos
40 A Identificador do tipo de leitor que dever ser utilizado pelo CTFClient para a leitura de documentos (vide tpico Dispositivos suportado pelo CTFClient)
parans-leitor- Parmetros LLLVAR A .. 999 Parmetros especficos para o tipo
-
BC-AUTTAR-320000050-102-PRD-INT-ET-Manual de Integrao CTFClient
Biblioteca - Cpia.docx
47/51
documento do leitor de documentos
escolhido de leitor de documentos. O valor de cada parmetro deve ser separado por , (vrgula) (vide tpico Dispositivos suportado pelo CTFClient)
captura-cmc7 Leitura do CMC-7
1 N Indica a leitura do CMC-7 do cheque 0 No ler 1 Efetuar a leitura
codigo-tabela Cdigo da Tabela
2 N Cdigo da tabela utilizado na transao de Parcele Mais
habilita-saldo-voucher
Pagamento com saldo do voucher
1 N Indica se o Pagamento pode ser realizado de forma parcial, utilizando o saldo restante do Voucher e outra forma de pagamento. 0 No habilitado 1 - Habilitado
habilita-credito-celular
Crdito com celular habilitado
1 N Indica se o fluxo de crdito poder ser direcionado para ser pago com celular 0 No habilitado 1 - Habilitado
1.2 Dispositivos Suportados pelo CTFClient
O CTFClient utiliza-se de dispositivos de entrada e sada (perifricos) para captura e exibio de informaes, quando configurado no modo no interativo. Os tipos de dispositivos utilizados pelo CTFClient so:
Teclado: para entrada de dados;
Display: para exibio de informaes para o operador e/ou cliente;
PIN-Pad: para a captura de senhas;
Leitor de Cartes: para a leitura de cartes magnticos ou chipados;
Scanner: para a leitura de cdigos de barras de contas;
Leitor de Documentos: para a leitura de cdigos de barras de contas; comum que a captura de senhas e a leitura de cartes seja realizada a partir de um nico dispositivo fsico, comumente chamando de PIN-Pad, o qual possui ambas as funes. Caso a AC no especifique um teclado ou um display para o CTFClient, este utilizar os dispositivos que estiverem definidos em sua configurao padro. O CTFClient oferece suporte a modelos especficos de dispositivos para cada um dos tipos citados. Cada dispositivo possui uma identificao nica e requer um conjunto de parmetros de configurao especfico. A tabela abaixo apresenta os dispositivos suportados pelo CTFClient:
-
BC-AUTTAR-320000050-102-PRD-INT-ET-Manual de Integrao CTFClient
Biblioteca - Cpia.docx
48/51
Identificao do dispositivo para o CTFClient
Tipo Descrio
DISPLAY_JAVAPOS Display Display de POS com driver JavaPOS (IBM, NCR, etc)
DISPLAY_AUTTAR Display Display em teclado conectado porta padro de teclado do PC (Gertec, Keytec, etc)
DISPLAY_CTFCLIENT Display Display em frame a ser exibido na janela do CTFClient.
TECLADO_JAVAPOS Teclado Teclado de POS com driver JavaPOS (IBM, NCR, etc)
TECLADO_PC Teclado Teclado padro IBM PC conectado em porta de teclado (qualquer marca/modelo)
LEITOR_DOCUMENTO_CHRONOS Leitor de documentos
Leitor de documentos Chronus conectado em porta serial
LEITOR_DOCUMENTO_IBM85 Leitor de documentos
Leitor de documentos em impressora fiscal IBM 3BM com driver JavaPOS
LEITOR_DOCUMENTO_PROCOMP Leitor de documentos
Leitor de documentos Procomp conectado em porta serial
LEITOR_DOCUMENTO_LOGGER2 Leitor de documentos
Leitor de documentos em impressora fiscal com base Logger2 (Urano, Itautec, ZPM, etc)
LEITOR_DOCUMENTO_TECPOINTTL8
40 Leitor de documentos
Leitor de documentos Tecpoint modelo TL840 conectado porta de teclado PC
SCANNER_SERIAL Scanner Scanner conectado em porta serial (qualquer marca/modelo)
SCANNER_JAVAPOS Scanner Scanner de POS com driver JavaPOS (IBM, NCR, etc)
LEITOR_CARTOES_BIB_COMPARTIL
HADA Leitor de cartes
Leitor de cartes compatvel com biblioteca compartilhada VISA/REDECARD/AMEX.
PINPAD_BIB_COMPARTILHADA PIN-Pad PIN-Pad compatvel com biblioteca compartilhada VISA/REDECARD/AMEX.
A seguir so apresentados os parmetros de configurao que cada dispositivo requer para seu correto funcionamento:
Identificao do dispositivo Formato da linha de parmetros e descrio dos parmetros
DISPLAY_JAVAPOS Formato: nome nome o nome lgico JavaPOS do display. Exemplo: defaultDisplay
DISPLAY_AUTTAR Formato: nome,tipo,charInicio,charFim nome o nome do dispositivo de driver ou a identificao da DLL a serem utilizados. Caso o nome represente uma DLL, deve ser precedido pela string LIBRARY: e a extenso do arquivo da DLL no deve constar no parmetro.
-
BC-AUTTAR-320000050-102-PRD-INT-ET-Manual de Integrao CTFClient
Biblioteca - Cpia.docx
49/51
Exemplo 1) Linux com device driver: /dev/disp_csi Exemplo 2) Windows com DLL: LIBRARY:DisplayCSIWindows tipo o tipo do display. Pode ser um dos seguintes: 0 para display em teclado Keytec / Sweda 1 para display em teclado Gertec charInicio e charFim so os cdigos de controle que habilitam a exibio de dados nos displays e variam de acordo com o tipo do display, conforme abaixo: Para display tipo 0, charIni = 0 e charFim = 1 Para display tipo 1, charIni = 251 e charFim = 252 Exemplo: LIBRARY:DisplayCSIWindows,1,251,252
DISPLAY_CTFCLIENT Este dispositivo no necessita de parmetros. TECLADO_JAVAPOS Formato: nome
nome o nome lgico JavaPOS do teclado Exemplo: defaultKeyboard
TECLADO_PC Este dispositivo no necessita de parmetros. LEITOR_DOCUMENTO_CHRONOS Formato: porta,velocidade,bitsDados,paridade,bitsParada
porta o nome da porta serial qual o leitor est conectado. velocidade a velocidade de comunicao serial em BAUD. O valor mais comumente utilizado para este parmetro 2400. bitsDados a quantidade de bits de dados a ser utilizada na comunicao serial. Pode ter valores entre 5 e 8. O valor mais comum para este parmetro 7. paridade a paridade a ser utilizada na comunicao serial. Poder ter um dos seguintes valores: E para paridade par O para paridade mpar N para nenhuma paridade O valor mais comum para este parmetro N. bitsParada a quantidade de bits de parada a ser utilizada na comunicao serial. Pode ter valores entre 0 e 2. O valor mais comum para este parmetro 1. Exemplo Windows: COM1,9600,8,N,1 Exemplo Linux: /dev/ttyS0,9600,8,N,1
LEITOR_DOCUMENTO_IBM85 Este dispositivo no necessita de parmetros. LEITOR_DOCUMENTO_PROCOMP Formato: porta,velocidade,bitsDados,paridade,bitsParada
porta o nome da porta serial qual o leitor est conectado.
-
BC-AUTTAR-320000050-102-PRD-INT-ET-Manual de Integrao CTFClient
Biblioteca - Cpia.docx
50/51
velocidade a velocidade de comunicao serial em BAUD. O valor mais comumente utilizado para este parmetro 9600. bitsDados a quantidade de bits de dados a ser utilizada na comunicao serial. Pode ter valores entre 5 e 8. O valor mais comum para este parmetro 7. paridade a paridade a ser utilizada na comunicao serial. Poder ter um dos seguintes valores: E para paridade par O para paridade mpar N para nenhuma paridade O valor mais comum para este parmetro O. bitsParada a quantidade de bits de parada a ser utilizada na comunicao serial. Pode ter valores entre 0 e 2. O valor mais comum para este parmetro 1. Exemplo Windows: COM1,2400,7,O,1 Exemplo Linux: /dev/ttyS0,2400,7,O,1
LEITOR_DOCUMENTO_LOGGER2 Formato: porta,velocidade,bitsDados,paridade,bitsParada porta o nome da porta serial qual o leitor est conectado. velocidade a velocidade de comunicao serial em BAUD. O valor mais comumente utilizado para este parmetro 115200. bitsDados a quantidade de bits de dados a ser utilizada na comunicao serial. Pode ter valores entre 5 e 8. O valor mais comum para este parmetro 8. paridade a paridade a ser utilizada na comunicao serial. Poder ter um dos seguintes valores: E para paridade par O para paridade mpar N para nenhuma paridade O valor mais comum para este parmetro E. bitsParada a quantidade de bits de parada a ser utilizada na comunicao serial. Pode ter valores entre 0 e 2. O valor mais comum para este parmetro 1. Exemplo Windows: COM1,115200,8,E,1 Exemplo Linux: /dev/ttyS0,115200,8,E,1
LEITOR_DOCUMENTO_TECPOINTTL84
0 Este dispositivo no necessita de parmetros.
SCANNER_SERIAL Formato: porta,velocidade,bitsDados,paridade,bitsParada porta o nome da porta serial qual o scanner est conectado.
-
BC-AUTTAR-320000050-102-PRD-INT-ET-Manual de Integrao CTFClient
Biblioteca - Cpia.docx
51/51
velocidade a velocidade de comunicao serial em BAUD. bitsDados a quantidade de bits de dados a ser utilizada na comunicao serial. Pode ter valores entre 5 e 8. paridade a paridade a ser utilizada na comunicao serial. Poder ter um dos seguintes valores: E para paridade par O para paridade mpar N para nenhuma paridade bitsParada a quantidade de bits de parada a ser utilizada na comunicao serial. Pode ter valores entre 0 e 2. Exemplo Windows: COM1,9600,8,N,1 Exemplo Linux: /dev/ttyS0,9600,8,N,1
SCANNER_JAVAPOS Formato: nome nome o nome lgico JavaPOS do scanner. Exemplo: defaultScanner
LEITOR_CARTAO_BIB_COMPARTILHA
DA Formato: porta,mensagem1,mensagem2 porta o nome da porta serial qual o leitor est conectado. mensagem1 a mensagem que deve ser exibida no display do leitor quando for solicitada a passagem do carto. mensagem2 a mensagem que deve ser exibida no display do leitor quando o mesmo estiver fora de uso. Exemplo Windows: COM1,PASSE O CARTAO, Auttar Exemplo Linux: /dev/ttyS0,PASSE O CARTAO, Auttar
PINPAD_BIB_COMPARTILHADA Formato: porta,mensagem1,mensagem2,mensagem3 porta o nome da porta serial qual o PIN-Pad est conectado. Mensagem1 a mensagem que deve ser exibida no display do leitor quando o mesmo estiver fora de uso. Mensagem2 a mensagem que deve ser exibida no display do leitor quando for solicitada uma senha. Mensagem3 a mensagem que deve ser exibida no display do leitor para avisar que o cliente deve aguardar o processamento. Exemplo Windows: COM1, Auttar, DIGITE A SENHA, PROCESSANDO... Exemplo Linux: /dev/ttyS0, Auttar, DIGITE A SENHA, PROCESSANDO...