manual de integração ctfclient biblioteca de automação comercial v1.03

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

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



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:



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.



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



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 Nome

1.1.1.14 E/S

1.1.1.15 Tipo

1.1.1.16 Tamanho

1.1.1.17 Descrio


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



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 Nome

1.1.1.19 E/S

1.1.1.20 Tipo

1.1.1.21 Tamanho

1.1.1.22 Descrio


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



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.



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.



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.



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



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



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.


5005 Erro de leitura da segunda linha do POSENTRA


5006 Segunda linha do POSENTRA no possui avano de linha (\n).


5007 Tamanho invlido da segunda linha do POSENTRA

O tamanho deve ser igual a 128 posies.


5008 Erro de leitura da terceira linha do POSENTRA


5009 Terceira linha do POSENTRA no possui avano de linha (\n).


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



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



5014 POSENTRA contm DDD - criptograr POSENTRA



5015 POSENTRA contm telefone - criptograr 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 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


5122 Erro para obter o nmero de vias de comprovantes


5123 Erro para obter o tipo do pinpad


5126 Erro para obter a lista de endereos IPs


5127 Erro para obter o nome do teclado

Verificar a existncia e atributos do parmetro no arquivo CONFIG.INI do



38/51

ClientCTF

5128 Erro para obter o flag de transaes digitadas


5129 Erro para obter os valores das teclas especiais

Para os Client's no ficarem disconexos


5130 Erro para obter o nome do display


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

5339 Erro na leitura do nmero do documento da terceira linha


5340 Erro na leitura do valor da transao


5341 Erro na leitura do nmero do carto


5342 Erro na leitura do campo info


5343 Erro na leitura timestamp


5344 Erro na leitura da senha Rever a terceira linha do POSENTRA

5345 Erro na leitura do nmero do parcelas


5346 Erro na leitura do vencimento do carto


5347 Erro na leitura da data de referncia


5348 Erro na leitura do valor de entrada


5349 Erro na leitura NSU CTF


5350 Erro na leitura do valor de parcela


5351 Erro na leitura do bit 62 Rever a terceira linha do POSENTRA

5352 Erro na leitura do cdigo de segurana


5353 Erro na leitura do valor de saque


5354 Erro na leitura da garantia do pr-datado


5355 Erro na leitura do nome da AC


5356 Erro na leitura do valor do desconto


5357 Erro na leitura do valor do acrscimo


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


5360 Erro na leitura da forma de entrada do cdigo de barras do pagamento de contas

Parmetro invlido na forma de entrada


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


5371 DDD ou Telefone invlido


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.


O valor do cancelamento maior que o valor da transao original



O valor maior que o percentual para cancelamento



O valor do cancelamento somado ao valor j cancelado maior que o percentual para 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;


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;


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



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



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:



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.



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.



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.



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

manual de integração ctfclient biblioteca de automação comercial v1.03

Documents