Manual Integração CTFClient Biblioteca

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

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

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.

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
Recebiment
o da Venda
Abertura do
terminal
Retorno =
99?
sim
no
sim
no

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.

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.

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 No
me
1.1.1.4 E
/
S
1.1.1.5 Ti
p
o
1.1.1.6 Tama
nho
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

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
<endereo><porta><proto
colo>, onde:

<endereo> o endereo
IP para a conexo, com 15
posies, preenchido com
espaos direita;

<porta> a porta de
conexo a ser usada,
numrico de 5 caracteres,
preenchido com zeros
esquerda.

<protocolo> 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.
criptografi
a
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:

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
parametro
s
E A varivel Parmetros adicionais do
CTFClient, no formato
[<nome do
parmetro>=<valor do
parmetro>;<nome do
parmetro>=<valor do
parmetro>]. 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.

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 No
me
1.1.1.9 E
/
S
1.1.1.10 T
ipo
1.1.1.11 Tam
anho
1.1.1.12 Desc
rio
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

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.

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 N
ome
1.1.1.14 E
/S
1.1.1.15 T
ipo
1.1.1.16 Ta
manho
1.1.1.17 De
scrio
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

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/enviad
o (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

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.

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 N
ome
1.1.1.19 E
/S
1.1.1.20 T
ipo
1.1.1.21 Ta
manho
1.1.1.22 De
scrio
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

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.

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.

19/51

99 O comando devolvido deve ser executado pela AC, e o
resultado deve ser enviado em nova chamada da rotina
continuaTransacaoCTF.

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.

- 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

21/51

comando foi executado chamando a rotina
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.

- 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
comando = 02.
03 AC deve limpar o display.

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.

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.

- 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.

- 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.

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
comando = 08 ao receber os comandos em questo.

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

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

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 7351 12 N Cdigo de barras do convnio (1 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 #

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
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

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
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

29/51

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

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.
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

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).

32/51

Subcampo 0029 para 235 - Compra de Vale gs
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
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

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
para efetuar captura de dados e
exibio de informaes para o
operador da AC. O valor de cada
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
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
escolhido de display para o cliente. O
valor de cada parmetro deve ser
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
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
para a captura de senhas (vide Anexo

34/51

D)
Parmetros PIN-Pad LLLVAR A..999 Parmetros especficos para o tipo
escolhido de PIN-Pad. O valor de cada
Tipo de leitor de
cdigos de barras

40 A Identificador do tipo de leitor que
para a leitura de cdigos de barras
(vide Anexo D)
Parmetros leitor
cdigos de barras
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

para a leitura de documentos (vide
Anexo D)
Parmetros leitor de
documentos
escolhido de leitor de documentos. O
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

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
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.
segunda linha do
POSENTRA
5006 Segunda linha do
POSENTRA no possui
segunda linha do
POSENTRA
O tamanho deve ser igual a
128 posies.
terceira linha do
POSENTRA
5009 Terceira linha do
POSENTRA no possui
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

36/51

criptograr POSENTRA seguranas abertos Criptografia do arquivo
POSENTRA
5012 POSENTRA contm
vencimento do carto -
criptograr POSENTRA
Arquivo POSENTRA no
seguranas abertos
conforme seo 4.3
Criptografia do arquivo
POSENTRA
5013 POSENTRA contm
cdigo de segurana -
criptograr POSENTRA
Arquivo POSENTRA no
seguranas abertos
conforme seo 4.3
POSENTRA
5014 POSENTRA contm
DDD - criptograr
POSENTRA
Arquivo POSENTRA no
seguranas abertos
conforme seo 4.3
POSENTRA
5015 POSENTRA contm
telefone - criptograr
POSENTRA
Arquivo POSENTRA no
seguranas abertos
conforme seo 4.3
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

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
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
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
atributos do arquivo
POSENTRA, bem como os 3
primeiros bytes que
representam a operao.
5120 Erro para obter o delay
de resposta da rede
atributos do parmetro no
arquivo CONFIG.INI do
ClientCTF
5121 Erro para obter o time
out padro de resposta
da transao
ClientCTF
5122 Erro para obter o
nmero de vias de
comprovantes
ClientCTF
5123 Erro para obter o tipo
do pinpad
ClientCTF
5126 Erro para obter a lista
de endereos IPs
ClientCTF
5127 Erro para obter o nome
do teclado

38/51

ClientCTF
5128 Erro para obter o flag
de transaes digitadas
ClientCTF
5129 Erro para obter os
valores das teclas
especiais
Para os Client's no ficarem
disconexos
ClientCTF
5130 Erro para obter o nome
do display
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

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

40/51

terceira linha
nmero do documento
da terceira linha
POSENTRA
5340 Erro na leitura do valor
da transao
POSENTRA
nmero do carto
POSENTRA
campo info
POSENTRA
5343 Erro na leitura
timestamp
POSENTRA
5344 Erro na leitura da senha Rever a terceira linha do
POSENTRA
nmero do parcelas
POSENTRA
vencimento do carto
POSENTRA
5347 Erro na leitura da data
de referncia
POSENTRA
de entrada
POSENTRA
5349 Erro na leitura NSU
CTF
POSENTRA
de parcela
POSENTRA
5351 Erro na leitura do bit 62 Rever a terceira linha do
POSENTRA
cdigo de segurana
POSENTRA
de saque
POSENTRA
5354 Erro na leitura da
garantia do pr-datado
POSENTRA
5355 Erro na leitura do nome
da AC
POSENTRA
do desconto
POSENTRA
do acrscimo
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
POSENTRA
5360 Erro na leitura da forma
de entrada do cdigo
de barras do
pagamento de contas
Parmetro invlido na forma
de entrada
POSENTRA
5361 Erro na leitura no tipo
do documento
Parmetro invlido Rever a terceira linha do
POSENTRA

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
POSENTRA
5371 DDD ou Telefone
invlido
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.
invlido
O valor do cancelamento
maior que o valor da
transao original
Corrigir o valor do
cancelamento.
invlido
O valor maior que o
percentual para
cancelamento
Corrigir o valor do
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

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;
recursos do Sistema Operacional (erro
de acesso arquivo INTERNET.TEF).
1006 Camada de rede no inicializada. Camada de rede no inicializada, ao tratar

43/51

a mensagem de resposta do CTF:
Verificar se foi executado o comando
02 Incio 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;
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;
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.

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

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
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
(vrgula) (vide tpico Dispositivos

46/51

suportado pelo CTFClient)
display-operador Tipo display
operador
40 A Identificador do tipo de display que
para efetuar captura de dados e
exibio de informaes para o
operador da AC. O valor de cada
parans-display-
operador
Parmetros
do display
operador
escolhido de display para o operador.
O valor de cada parmetro deve ser
separado por , (vrgula) (vide tpico
display-cliente Tipo display
cliente
40 A Identificador do tipo de display que
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
escolhido de display para o cliente. O
parans-leitor-cartao Parmetros
do leitor de
cartes
escolhido de leitor de cartes. O valor
de cada parmetro deve ser separado
por , (vrgula) (vide tpico
parans-pinpad Parmetros
do PIN-Pad
escolhido de PIN-Pad. O valor de cada
tipo-scanner Tipo de
leitor de
cdigos de
barras

para a leitura de cdigos de barras
pelo CTFClient)
parans-scanner Parmetros
do leitor
cdigos de
barras
escolhido de leitor de cdigos de
barras. O valor de cada parmetro
deve ser separado por , (vrgula)
pelo CTFClient)
tipo-leitor-
documento
Tipo de
leitor de
documentos

para a leitura de documentos (vide
tpico Dispositivos suportado pelo
CTFClient)
parans-leitor- Parmetros LLLVAR A .. 999 Parmetros especficos para o tipo

47/51

documento do leitor de
documentos
escolhido de leitor de documentos. O
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:

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
documento
s
Leitor de documentos Chronus conectado em porta
serial
LEITOR_DOCUMENTO_IBM85
Leitor de
documento
s
Leitor de documentos em impressora fiscal IBM
3BM com driver JavaPOS
LEITOR_DOCUMENTO_PROCOMP
Leitor de
documento
s
Leitor de documentos Procomp conectado em porta
serial
LEITOR_DOCUMENTO_LOGGER2
Leitor de
documento
s
Leitor de documentos em impressora fiscal com
base Logger2 (Urano, Itautec, ZPM, etc)
LEITOR_DOCUMENTO_TECPOINTTL8
40
Leitor de
documento
s
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.

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
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

Exemplo Windows: COM1,9600,8,N,1
Exemplo Linux: /dev/ttyS0,9600,8,N,1
LEITOR_DOCUMENTO_IBM85
LEITOR_DOCUMENTO_PROCOMP


50/51




E para paridade par

O valor mais comum para este parmetro O.


Exemplo Windows: COM1,2400,7,O,1
Exemplo Linux: /dev/ttyS0,2400,7,O,1
LEITOR_DOCUMENTO_LOGGER2





E para paridade par

O valor mais comum para este parmetro E.


Exemplo Windows: COM1,115200,8,E,1
Exemplo Linux: /dev/ttyS0,115200,8,E,1
LEITOR_DOCUMENTO_TECPOINTTL84
0
SCANNER_SERIAL

porta o nome da porta serial qual o scanner est conectado.

51/51

velocidade a velocidade de comunicao serial em BAUD.

comunicao serial. Pode ter valores entre 5 e 8.

E para paridade par

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


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.

leitor quando for solicitada uma senha.

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...

Manual Integração CTFClient Biblioteca

Загружено:

Сведения о документе

Оригинальное название

Авторское право

Доступные форматы

Поделиться этим документом

Поделиться или встроить документ

Параметры публикации

Этот документ был вам полезен?

Это неприемлемый материал?

Авторское право:

Доступные форматы

Manual Integração CTFClient Biblioteca

Загружено:

Авторское право:

Доступные форматы

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

Вам также может понравиться