SiTef - Interface Simplificada Com A Aplicação (VRS-107)

Especificao Tcnica Interface com os meios de
pagamento do SiTef
Bibliotecas CliSiTefI e CliSiTef
Verso 107
Este documento possui tecnologia e conhecimento de propriedade da Software Express Informtica

No pode ser reproduzido ou utilizado para outros fins que no a interface com algum de nossos produtos.
Especificao Tcnica Interface com os meios de pagamento do SiTef

Verso:
107
Data: 21/11/2012
ndice
1.
Objetivos
1.1
Descrio Resumida
1.2
Fluxo Grfico
1
2
3
2.
Descrio das interfaces com as rotinas disponveis na CliSiTef

2.1
Interface padro
2.2
Interface ASCII
4
4
4
3.
API - Rotinas disponveis na CliSiTef

3.1
Configurao da biblioteca
3.1.1 Configuraes especiais gerais
3.2
Incio da transao de Pagamento ou Gerencial
3.2.1 Tabela de cdigos de retorno
3.2.2 Tabela de cdigos de funes
3.3
Continuao do processo de coleta interativo
3.3.1 Tabela de cdigos de Comando
3.3.2 Tabela de valores para TipoCampo
3.3.3 Tabela de Eventos, retornados tambm em TipoCampo
3.4
Confirmao ou no do Pagamento
3.5
Teste da presena de PinPad
3.6
Define mensagem permanente para o PinPad
3.7
Leitura da trilha 3 do carto
3.8
Leitura do carto - rotinas de captura segura
3.9
Leitura de senha
3.10 Leitura de Confirmao pelo Cliente no PinPad
3.11 Correspondente Bancrio (Pagamento de Contas)
3.12 Verificao da integridade de um cdigo em barras
3.13 Verificao da quantidade de transaes pendentes de confirmao no terminal
3.14 Obtendo Verso
3.15 Descarregando Mensagens
6
7
8
9
10
11
17
20
23
35
36
37
37
38
39
41
42
43
44
47
47
48
5.
Arquivo de configuraes CliSiTef.ini ou CLSIT

5.1
Configurao do PinPad
5.1.1 Configurao da porta
5.1.2 Definio da mensagem padro
5.2
Configurao de conexo com o servidor SiTef
5.2.1 Configurao de endereos IP adicionais
5.2.2 Configurao da porta do servidor SiTef
49
49
49
49
50
50
50
6.
Restrio ou habilitao das formas de pagamento

6.1
Restrio durante o processo de finalizao de uma venda
6.2
Restrio de forma definitiva
6.3
Habilitao de transaes adicionais
6.4
Desabilitando transaes
6.5
Habilitao de transaes de redes especficas
6.6
Tabela de cdigos de meios de pagamento, configuraes e menus
6.7
Habilitao de configuraes especiais por transao
51
51
51
52
53
53
56
65
Software Express Ltda., 2012
ii

Verso:
107
Data: 21/11/2012
7.
Arquivos de controle
67
8.
Trace
8.1
Configurao do perodo que o trace mantido
8.2
Configurao de diretrio
8.3
Arquivos de trace por terminal
68
68
68
69
9.
Processo de desenvolvimento/homologao
9.1
Arquivo de trace adicional durante a fase de desenvolvimento
9.2
Processo de homologao
70
70
70
10.
Habilitando confirmao do valor no pinpad
71
11.
Traduo de mensagens
71
12.
Tabelas
72
13.
Rotinas descontinuadas
72
iii

Verso:
107
Data: 21/11/2012

1.
Objetivos
Da biblioteca
Propiciar um meio rpido e simples de disponibilizar as funcionalidades do SiTef para aplicativos

em geral. Principais caractersticas:
a) No intrusiva pois a prpria automao que gerencia suas telas. No ocorre sobreposio de
telas da prpria interface que, se existisse, na maioria das vezes no seria compatvel com a
diagramao visual da aplicao principal do cliente;
b) Permite que a aplicao de automao restrinja as transaes disponveis para determinado
pagamento uma vez que, na vida prtica, ocorre a negociao com o cliente e uma vez fechado
o meio de pagamento, quantidade de parcelas, etc, no devem ser modificados por engano na
hora da execuo do TEF;
c) Permite total liberdade na incluso de novos produtos e meios de pagamento, acompanhando a
evoluo do SiTef, sem que seja necessrio fazer nenhuma alterao na automao ou, se ela for
imprescindvel (por exemplo pela incluso de novos perifricos de acesso tais como leitor de
cdigos em barra), que ela seja mnima.
Do documento
Apresentar a descrio da biblioteca que efetua a interface com os servios de meio de pagamento
disponveis no SiTef.
A biblioteca implementada atravs de duas DLLs para o ambiente Windows 32 bits e duas libs
para o ambiente Linux (CliSiTefI e CliSiTef32). Ela possui pontos de entrada pelos quais a automao
comercial a configura, solicita um pagamento, solicita uma funo gerencial ou o pagamento de uma
conta. Os pontos de entrada esto na CliSiTefI e essa que deve ser carregada pela aplicao do usurio.
A CliSiTef32 de uso exclusivo da CliSiTefI e no pode ser carregada ou chamada diretamente sob risco
de, se isso for feito, desestabilizar o ambiente. Neste documento, qualquer referncia a CliSiTef deve ser
entendida como o conjunto das duas dlls ou libs.
A CliSiTef possui, para cada funcionalidade, dois pontos de entrada (rotinas). A escolha de qual
das interfaces ser utilizada pela aplicao depende do gosto pessoal do programador e de se o ambiente
utilizado por ele para o desenvolvimento impe algum tipo de restrio na chamada a CliSiTef. Em
particular, estamos nos referindo ao tipo de dado manipulado pelo ambiente de programao. Se ele
aceitar somente dados em ASCII, necessariamente deve ser utilizada a interface batizada a seguir nesse
documento como A.

Verso:
107
Data: 21/11/2012
1.1 Descrio Resumida
Passo inicial
Inicialmente a Automao Comercial deve executar o comando ConfiguraIntSiTefInterativo,
passando as informaes necessrias para que o Terminal de Vendas possa se comunicar com o SiTef,
como Endereo IP do SiTef, Cdigo da Empresa (no SiTef Demonstrao este cdigo 00000000) e a
identificao do terminal, que segue o seguinte formato: duas letras + 000 + nmero do Terminal de
Vendas.
Esta funo deve ser chamada somente quando a CliSiTef carregada ou seja, no necessrio
cham-la a cada nova transao.
Transao propriamente dita
Feito isto, a rotina devolve um valor dizendo se o comando foi aceito ou no. Se foi 0 o processo
ocorreu de forma correta.
O prximo passo , ento, chamar a funo IniciaFuncaoSiTefInterativo, passando os parmetros
descritos para ela.
No retorno, a ela devolve o valor 10000 para continuar a transao ou outro valor para encerrar.
Se o retorno for 10000, deve-se chamar a funo ContinuaFuncaoSiTefInterativo, com os
parmetros tambm descritos para ela ns prximos tpicos.
Enquanto a CliSiTef retornar na chamada dessa funo o valor 10000, a automao deve ficar
repetindo a chamada a essa funo tantas vezes quanto for necessrio at que o valor de retorno da funo
seja 0, indicando que ocorreu tudo bem, ou diferente de 0 e de 10000 indicando que ocorreu alguma
interrupo anormal.
Confirmao (ou no-confirmao) da transao
Se o retorno foi 0, a automao encerra o lao e se houve impresso de cupom TEF a automao
deve imprimi-los e chamar uma outra funo, a FinalizaFuncaoSiTefInterativo, confirmando ou no a
transao dependendo, respectivamente, se o cupom foi impresso corretamente ou no.
Se o retorno foi diferente de 10000 e de 0 ento a automao simplesmente sai do lao e, por opo
do programador, pode ou no exibir uma mensagem de acordo com o retorno da funo chamada. Por
exemplo, se retornou -2, significa que a transao foi cancelada pelo operador. Estes retornos negativos
esto descritos neste documento.
Exemplificando graficamente o fluxo descrito neste tpico, teramos o seguinte:

Verso:
107
Data: 21/11/2012
1.2 Fluxo Grfico
ConfiguraIntSiTefInterativo
Retorno igual a 0 (zero)?
Encerra a transao
IniciaFuncaoSiTefInterativo
Retorno igual a 10000?
Encerra a transao
ContinuaFuncaoSiTefInterativo
Retorno igual a 10000? Se Sim ento execute o
prximo Comando e chame novamente a funo
(lao)
S
O retorno foi igual a 0?
N
S
Encerra a transao
Houve devoluo de Cupom TEF pela CliSiTef?
N
S
Encerra a transao
Imprime o cupom;
O cupom foi impresso corretamente?
N
S
Chamar a funo FinalizaTransacaoSiTefInterativo

Com parmetro Confirma = 0
Chamar a funo FinalizaTransacaoSiTefInterativo

Com parmetro Confirma = 1

2.
Verso:
107
Data: 21/11/2012
Descrio das interfaces com as rotinas disponveis na CliSiTef
2.1 Interface padro
Esta interface pode ser utilizada por aplicaes escritas nas mais variveis linguagens de
programao que aceitam campos binrios. Dentre elas citamos: Delphi, Visual Basic, Visual C.
No caso de comprovantes, o delimitador que indica o final de uma linha o caractere 0x0a (\n em
linguagem C).
Todas as rotinas chamadas pelo aplicativo de automao devem ser do tipo stdcall, ou seja, os
parmetros so empilhados da direita para a esquerda e a rotina chamada responsvel por remov-los da
pilha. A conveno dos parmetros a seguinte:
Tipo
char *
short int (short)
unsigned short int (ushort)
long, unsigned long (ulong)
void
<tipo varivel> *
(exemplo: short int * ou long *)
Descrio
Buffer em texto ASCII terminado por zero binrio.
Variveis que ocupam 2 bytes em memria, com e sem sinal,
respectivamente.
Variveis que ocupam 4 bytes em memria, com e sem sinal,
respectivamente.
Indica a ausncia de parmetros ou retorno.
Indica que a varivel do tipo varivel est sendo passada como
endereo, ou seja, a CliSiTef ir utilizar a rea da aplicao de
automao para trabalhar, podendo devolver algum resultado nela.
2.2 Interface ASCII
Esta interface pode ser utilizada por aplicaes escritas em qualquer linguagem de programao,
inclusive as que no que aceitam campos binrios, tais como o ambiente Forms da Oracle.
Nela todos os parmetros so passados em ASCII e podem ser de tamanho fixo e varivel.
Os campos numricos so passados sempre com tamanho fixo e alinhados a direita, com zeros a
esquerda. Em particular, o campo cujo contedo seja um valor negativo, possui um sinal - na posio
mais a esquerda do nmero (p/ex: -0001 para um campo de 5 posies cujo contedo o valor 1).
Os de tamanho varivel so construdos de forma que o primeiro caractere indique qual o valor
escolhido para ser o delimitador daquele campo ou seja, o campo delimitado pelo caractere escolhido ou
o seu complementar no caso dos pares ( ), [ ], { } e < >. Exemplos de construes vlidas so:
(1234), [1234], {1234}, <1234>, $1234$, %1234%, |1234|, etc. Exemplos NO VLIDOS so os
seguintes: $12$34$, .1.234,56., etc.
O critrio para escolha do delimitador deve ser o de que ele no exista como caractere vlido no
campo em questo. Nas passagens de dados da aplicao para a CliSiTef, como estes sempre so
conhecidos, a aplicao pode definir um caractere padro e sempre utiliz-lo em todas as passagens de
dados. J no retorno, como qualquer caractere valido (por exemplo em um comprovante), a regra acima
deve ser utilizada na interpretao do resultado devolvido pela CliSiTef uma vez que esta ir escolher o
caractere que melhor se adapta a resposta que esta sendo gerada.

Verso:
107
Data: 21/11/2012
Finalizando, existe um caractere especial que utilizado nos textos direcionados para uma
impressora. O \ (barra reversa) indica o final de uma linha e deve ser utilizado pelo aplicativo instruir a
impressora para fechar a linha corrente e se posicionar na seguinte.

3.
Verso:
107
Data: 21/11/2012
API - Rotinas disponveis na CliSiTef
Na descrio a seguir, so apresentadas as duas verses de cada uma das funes disponveis ou
seja, a que trabalha com dados binrios e a que trabalha com dados em ASCII.
O que diferencia a verso ASCII da verso padro o acrscimo do sufixo A no nome das funes,
e a forma / tipo de passagem dos parmetros.
Para algumas das funes presentes na biblioteca, existe uma terceira e quarta verso da mesma que
de uso exclusivo e obrigatrio para aplicaes de auto-atendimento uma vez que exigida por algumas
bandeiras a impresso dos bens adquiridos no meio do comprovante de TEF.
Sero adotadas as seguintes convenes:
Campo vazio ou no fornecido na verso padro um campo contendo apenas o delimitador
(zero binrio). Na verso ASCII, se for um campo fixo ele contm espaos. Se for um campo varivel ele
contm apenas o delimitador de incio e final de campo.
Tamanho do campo no caso de campo de tamanho fixo, quando esse valor for fornecido, indica
qual o tamanho mnimo a ser reservado pela aplicao para receber uma resposta do SiTef.
Tipo de parmetros da funo dividiremos em dois grupos:
1. Quanto ao fluxo de informaes: o parmetro pode ser de entrada ou sada.
2. Quando passagem: o parmetro pode ser passado por valor ou por referncia.

Verso:
107
Data: 21/11/2012
3.1 Configurao da biblioteca
Atravs dessa rotina o aplicativo configura a CliSiTef de forma que ela possa interagir com o SiTef
e com o prprio aplicativo de automao.
long ConfiguraIntSiTefInterativo (IPSiTef, IdLoja, IdTerminal, Reservado)
long ConfiguraIntSiTefInterativoEx (IPSiTef, IdLoja, IdTerminal,
Reservado, ParametrosAdicionais)
Interface ASCII
ConfiguraIntSiTefInterativoA (Resultado, IPSiTef, IdLoja, IdTerminal,
Reservado)
ConfiguraIntSiTefInterativoExA (Resultado, IPSiTef, IdLoja, IdTerminal,
Reservado, ParmetrosAdicionais)
Parmetro
Resultado
IPSiTef
IdLoja
Tipo
Sada,
por valor
Entrada,
por valor
Entrada,
por valor
IdTerminal
Entrada,
por valor
Reservado
Entrada,
por valor
Entrada,
por valor
ParametrosAdi
cionais
Interface Interface
Descrio
padro
ASCII
No usado Fixo 6 Contm o resultado de resposta chamada da
rotina
char *
Varivel Configura o nome ou endereo IP (em notao .)
do servidor SiTef
char *
Fixo 8 Identifica o nmero da loja perante a rede de
estabelecimentos comerciais. Se no for fornecido
o SiTef identificar a loja baseado no IP origem da
conexo
char *
Fixo 8 Identifica o pdv perante a loja. Se no for fornecido
o SiTef identificar a loja baseado no IP origem da
conexo. obrigatrio se pIdLoja for fornecido.
Neste caso possui o formato XXnnnnnn onde XX
corresponde a 2 caracteres alfabticos e nnnnnn 6
dgitos quaisquer desde que o nmero resultante
no sobreponha a faixa 000900 a 000999 que
reservada para uso pelo SiTef
short
Fixo 6 Deve ser passado com 0
char *
Varivel Parmetros adicionais de configurao da CliSiTef

no
seguinte
Formato:
[<Nome_Parametro_1>=<Valor_Parametro_1>;<N
ome_Parametro_2>=<Valor_Parametro_2>]

Verso:
107
Data: 21/11/2012
As rotinas devolvem um dos seguintes resultados:

Valor
0
1
2
3
6
7
8
9
10
11
12
13
Descrio
No ocorreu erro
Endereo IP invlido ou no resolvido
Cdigo da loja invlido
Cdigo de terminal invlido
Erro na inicializao do Tcp/Ip
Falta de memria
No encontrou a CliSiTef ou ela est com problemas
Configurao de servidores SiTef foi excedida.
Erro de acesso na pasta CliSiTef (possvel falta de permisso para escrita)
Dados invlidos passados pela automao.
Modo seguro no ativo (possvel falta de configurao no servidor SiTef do arquivo .cha).
Caminho DLL invlido (o caminho completo das bibliotecas est muito grande).
3.1.1 Configuraes especiais gerais

Determinadas configuraes gerais (vlidas para todas as transaes) da CliSiTef podem ser
passadas atravs do parmetro ParametrosAdicionais da rotina ConfiguraIntSiTefInterativoEx. O
formato deste campo o seguinte:
[<Funcionalidade >;<Funcionalidade >;...]
A seguir, descrevemos as funcionalidades previstas neste campo.

Funcionalidade
MultiplosCupons=1
PortaPinPad=<Porta PinPad>
Descrio
Indica que o PDV est apto para receber mais de um comprovante por
transao. No caso de transaes com mais de um comprovante, como
transaes de recarga de celular ou pagamentos de contas com cartes
de crdito ou dbito, o comprovante da recarga de celular ou do
pagamento de conta ser entregue separadamente do comprovante do
TEF de crdito ou dbito.
Define a porta em que est conectado o pinpad compartilhado.
Ex:
Windows: [PortaPinPad=1]
Linux: [PortaPinPad=/dev/ttyS0]

Verso:
107
Data: 21/11/2012
3.2 Incio da transao de Pagamento ou Gerencial

long IniciaFuncaoSiTefInterativo (Funcao, Valor, CupomFiscal, DataFiscal,
HoraFiscal, Operador, ParamAdic)
Interface ASCII
IniciaFuncaoSiTefInterativoA (Resultado, Funcao, Valor,
DataFiscal, HoraFiscal, Operador, ParamAdic)
CupomFiscal,
No caso de um terminal de Auto-Atendimento, devem ser usadas as rotinas a seguir.

long IniciaFuncaoAASiTefInterativo (Funcao, Valor, CupomFiscal,
DataFiscal, HoraFiscal, Operador, ParamAdic, Produtos)
Interface ASCII
IniciaFuncaoAASiTefInterativoA (Resultado, Funcao, Valor, CupomFiscal,
DataFiscal, HoraDiscal, Operador, ParamAdic, Produtos)
Parmetro
Resultado
Funcao
Valor
CupomFiscal
DataFiscal
HoraFiscal
Operador
ParamAdic
Produtos
Tipo
Sada,
por valor
Entrada,
por valor
Entrada,
por valor
Interface Interface
Descrio
padro
ASCII
No usado Fixo 6 Contm o resultado de resposta chamada da rotina
long
char *
Entrada,
por valor
Entrada,
por valor
Entrada,
por valor
Entrada,
por valor
Entrada,
por valor
char *
Entrada,
por valor
char *
Fixo 6
Seleciona a forma de pagamento, conforme a tabela

Cdigos de Funes a seguir.
Varivel Contm o valor a ser pago contendo o separador
decimal (,).Deve sempre ser passado com duas
casas decimais aps a vrgula (,). Caso a operao
no tenha um valor definido a priori (p/ex. recarga
de pr-pago), esse campo deve vir zerado
Mx. 20 Nmero do Cupom Fiscal correspondente venda
char *
Fixo 8
Data Fiscal no formato AAAAMMDD
char *
Fixo 6
Horrio Fiscal no formato HHMMSS
char *
Mx. 20 Identificao do operador de caixa
char *
Varivel Parmetros adicionais. Permite que o aplicativo

limite o tipo de meio de pagamento. Ele opcional e
pode ser passado vazio. Quando esse campo for
utilizado a CliSiTef ir limitar os menus de
navegao apenas aos cdigos no presentes na lista.
Vide item 5 para a descrio do formato interno
deste campo
Varivel Contm a lista de produtos que o cliente est
adquirindo no terminal de Auto-Atendimento.
obrigatrio pois tais produtos faro parte integrante

Verso:
107
Data: 21/11/2012
do comprovante da operao de Tef a ser impresso.

O formato bsico deste campo :
[<Descrio1>;<Cdigo1>;<Quantidade1>;<ValorT
otal1>];
[<Descrio2>;<Cdigo2>;<Quantidade2>;<ValorT
otal2>];...
Campo
Descrio
Cdigo
Quantidade
Valor
Formato
1 a 14 caracteres
1 a 08 caracteres
1 a 04 dgitos
999.999,99
Ele deve ser repetido tantas vezes quanto o nmero

de produtos distintos adquirido pelo cliente.
IMPORTANTE: Essa rotina apenas inicia o processo de pagamento. Se o retorno for 10000 o
processo de pagamento deve ser continuado atravs da rotina ContinuaFuncaoSiTefInterativo ou
ContinuaFuncaoSiTefInterativoA at que esta ltima devolva um resultado final (vide item que
descreve esta funo).
3.2.1 Tabela de cdigos de retorno

No retorno a rotina devolve um dos seguintes valores:
Valor
10000
> 0
-1
-2
-3
-4
-5
-6
-40
-43
-50
-100
outro nmero negativo
Descrio
Deve ser chamada a rotina de continuidade do processo.
Negada pelo autorizador.
Mdulo no inicializado.
Operao cancelada pelo operador.
Fornecido um cdigo de funo invlido.
Falta de memria para rodar a funo.
Sem comunicao com o SiTef.
Operao cancelada pelo usurio.
Transao negada pelo SiTef.
Falha no pinpad.
Transao no segura.
Erro interno do mdulo.
Erros detectados internamente pela rotina.
10

Verso:
107
Data: 21/11/2012
3.2.2 Tabela de cdigos de funes

Os seguintes cdigos esto disponveis para serem usados no parmetro Funcao descrita acima.
Funo
Descrio
Pagamento genrico. A CliSiTef permite que o operador escolha a forma de pagamento
0
atravs de menus.
Cheque
1
Dbito
2
Crdito
3
Fininvest
4
Carto Benefcio
5
Crdito Centralizado
6
Carto Combustvel
7
Parcele Mais Redecard
8
Benefcio Refeio
10
Benefcio Alimentao
11
Carto Infocard
12
Pay Pass
13
Carto Nova Plataforma Ticket Car (NPTC)
14
Venda com carto Gift
15
Dbito para pagamento de carn
16
50
51
52
53
54
55
56
57
Venda Boleto Carrefour

Venda Autorizacao Carrefour
Recebimento Carrefour
Incluso de Boleto Carrefour
Incluso de Venda Carrefour
Consulta Recebimento Carrefour
Consulta Limite mnimo PromoFlex Carrefour
Cancelamento de Recebimento Carefour
100
Telemarketing: Inicia a coleta dos dados da transao no ponto necessrio para tratar uma
transao de carto de crdito digitado
110
111
112
113
114
115
116
Abre o menu de transaes Gerenciais

Teste de comunicao com o SiTef
Menu Re-impresso
Re-impresso comprovante especfico
Re-impresso ultimo comprovante
Pr-autorizao
Captura de pr-autorizao
150
151
152
Consulta Bnus
Consulta Saldo Carto Presente
Consulta Saldo Carto Gift
160
Consultas Carto SEM

11

Verso:
107
Data: 21/11/2012
161
Vendas Carto EMS
200
202
203
210
211
212
213
250
251
253
254
255
256
257
Cancelamento Normal: Inicia a coleta dos dados no ponto necessrio para fazer o
cancelamento de uma transao de dbito ou crdito, sem ser necessrio passar antes pelo
menu de transaes administrativas
Cancelamento Telemarketing: Similar a modalidade 200 s que para a funo de
cancelamento de transao de crdito digitado
Cancelamento Pr-autorizao
Cancelamento da Captura da Pr-autorizao
Cancelamento de venda com carto de Crdito
Cancelamento de venda com carto de Dbito
Cancelamento de venda com carto Combustvel
Cancelamento de Venda com Carto Gift
Cancelamento de Consulta Bnus
Cancelamento Recarga Carto Presente
Cancelamento Acmulo de Pontos Carto Bnus
Resgate de Pontos Carto Bnus
Cancelamento de Resgate de Pontos Carto Bnus
Acmulo de Pontos Carto Bnus
Cancelamento Recarga Carto Gift
260
262
264
265
266
267
268
269
Recarga Carto Bnus

Recarga Carto Presente
Recarga Carto Gift
Ativao Pagamento Vinculado Carto Gift
Consulta Carto Gift
Ativao Carto Gift Sem Pagamento
Ativao Carto Gift Com Pagamento
Ativao Desvinculada Carto Gift
300
301
302
303
Recarga de pr-pago
Recarga de pr-pago desvinculada do pagamento
Recarga de pr-pago sem coleta de valor
Recarga de pr-pago desvinculada do pagamento e sem coleta de valor
310
311
Corresponde Bancrio (Pagamento de Contas)

Pagamento de Contas com Saque
312
313
314
315
316
317
318
319
320
321
Consulta para Pagamento Desvinculado (Genrico)

Pagamento Desvinculado (Genrico)
Recarga Pr Pago HSBC com Saque
Saque para Pagamento
Cancelamento do pagamento desvinculado (genrico)
Consulta Limites do Correspondente Bancrio
Recarga Pr Pago Bradesco
Recarga Pr Pago Bradesco desvinculada do pagamento
Recarga Pr Pago HSBC
Recarga Pr Pago HSBC desvinculada do pagamento
201
12

322
323
324
325
Depsito Identificado
Transferncia entre Contas
Pague Fcil
Revalidao de Senha INSS
350
351
Venda Produto (Sem Valor)

Cancelamento de Venda Produto (Sem Valor)
400
401
410
Vale-Gs
Validao Vale-Gs
Troco Surpresa
411
412
Troco Premiado
Cancelamento Troco Premiado
500
501
502
Consulta Detalhada ACSP

Consulta Detalhada Serasa
Consulta Cadastral Infocard
530
531
532
533
Consulta Fidelize (PBM)

Venda Fidelize (PBM)
Cancelamento Parcial Fidelize (PBM)
Cancelamento Total Fidelize (PBM)
540
541
542
543
Pr-autorizao PharmaSystem
Recuperao de pr-autorizao PharmaSystem
Venda PharmaSystem
Cancelamento PharmaSystem
550
552
553
554
Obtem Autorizao PBM

Venda PBM
Cancelamento Parcial PBM
Cancelamento Total PBM
560
561
562
563
564
Consulta Telenet/Funcional Card (PBM)

Venda Telenet/Funcional Card (PBM)
Cancelamento Telenet/Funcional Card (PBM)
Pr-autorizao Telenet/Funcional Card (PBM)
Consulta cliente Telenet/Funcional Card (PBM)
570
571
572
573
Consulta EPharma(PBM)
Venda EPharma (PBM)
Cancelamento Parcial EPharma (PBM)
Cancelamento Total EPharma (PBM)
580
581
Consulta PrevSaude (PBM)

Venda PrevSaude (PBM)
Verso:
107
Data: 21/11/2012
13

582
583
Cancelamento Parcial PrevSaude (PBM)

Cancelamento Total PrevSaude (PBM)
590
591
592
593
594
Consulta Operadoras TrnCentre (PBM)

Consulta Pr Autorizao TrnCentre (PBM)
Venda sem Pr Autorizao TrnCentre (PBM)
Venda com Pr Autorizao TrnCentre (PBM)
Cancelamento TrnCentre (PBM)
600
601
602
605
606
607
Consulta Saldo
Consulta Saldo Carto de Dbito
Consulta Saldo Carto de Crdito
Consulta Saldo Carto Combustvel
Consulta de Redes Carto Combustvel
Consulta Produtos Carto Combust
605
606
607
Consulta Saldo Carto Combustvel

Consulta Redes Carto Combustvel
Consulta Produtos Carto Combustvel
610
611
612
614
615
616
Transaes SPTrans (Bilhete nico)

Consulta Saldo SPTrans (Bilhete nico)
Recarga SPTrans (Bilhete nico)
Pagamento de Recarga SPTrans (Bilhete nico)
Consulta de Produtos SPTrans (Bilhete nico)
Recarga SPTrans desvinculada de pagamento (Bilhete nico)
613
Carto Marisa (Orbital)
618
619
620
621
Venda Hopi Hari com Consulta de Produtos

Consulta de Produtos Hopi Hari
Venda Hopi Hari sem Consulta de Produtos
Cancelamento Hopi Hari
625
626
627
628
Venda Voucher com Consulta Forncedores/Produtos

Consulta Forncedores/Produtos Voucher
Venda Voucher sem Consulta Forncedores/Produtos
Cancelamento venda Voucher
630
631
632
633
634
635
636
637
638
Opes de transaes NPTC

Consulta Saldo NPTC
Atualizao Carto NPTC
Consulta Produtos Host NPTC
Consulta Produtos PDV NPTC
Cadastra Produtos NPTC
Troca de senha NPTC
Boleto de venda NPTC
Venda NPTC
Verso:
107
Data: 21/11/2012
14

639
Cancelamento de venda NPTC
640
641
642
Desbloqueio Carto Riachuelo

Troca de senha Carto Riachuelo
Venda Riachuelo
649
650
651
652
653
654
Venda Private Label Softway/Renner

Venda Carto Bandeira Softway/Renner
Pagamento de Fatura Softway
Desbloqueio de Carto Softway/Renner
Troca de Senha Carto Softway/Renner
Consulta de Fatura Carto Softway/Renner
655
656
Venda Pin de Jogos

Venda Pin de Recarga
657
Saque Crdito Transferncia
660
661
662
Menu Saque IBI

Consulta Saque Banco IBI
Saque Banco IBI
663
664
Saque GetNet
Cancelamento Saque GetNet
665
667
668
669
670
Resgate de Pontos
Emisso de Pontos
Cancelamento da Emisso de Pontos
Carga de Pr Pago
Cancelamento de Carga de Pr Pago
671
672
Consulta Saque com Saque Banco IBI

Cancelamento Saque Banco IBI
673
674
Venda DrogaRaia
Cancelamento Venda DrogaRaia
680
Consulta Saldo Pr Pago
700
701
702
703
Venda Oi Paggo
Cancelamento Oi Paggo
Pagamento de contas
Cancelamento de Pagamento Carto Benefcio
704
Primeira Compra
705
Pagamento de Fatura
Verso:
107
Data: 21/11/2012
15

740
Consulta Parcelas Crdito Adm
999
Fechamento
1000
Voucher Papel
Verso:
107
Data: 21/11/2012
16

Verso:
107
Data: 21/11/2012
3.3 Continuao do processo de coleta interativo
Esta funo deve ser chamada de forma contnua at no existam mais informaes para serem
trocadas entre a aplicao e a CliSiTef, conforme descrito nos resultados devolvidos por ela. O formato
de ativao o seguinte:
long ContinuaFuncaoSiTefInterativo (Comando, TipoCampo, TamMinimo,
TamMaximo, Buffer, TamBuffer, Continua)
Interface ASCII
ContinuaFuncaoSiTefInterativoA (Resultado, Comando, TipoCampo, TamMinimo,
TamMaximo, Buffer, TamBuffer, Continua)
Parmetro
Resultado
Comando
TipoCampo
TamMinimo
TamMaximo
Buffer
TamBuffer
Continua
Tipo
Sada,
por valor
Sada,
por
referncia
Sada,
por
referncia
Sada,
por
referncia
Sada,
por
referncia
Entrada e
sada,
por valor
Entrada,
por valor
Entrada,
por valor
Interface Interface
Descrio
padro
ASCII
long *
Fixo 12
long *
Fixo 12
short *
Fixo 6
short *
Fixo 6
char *
long
long
Contm no retorno:
0
caso a CliSiTef esteja devolvendo algum
dado referente a transao no campo
Buffer
<> 0 indica o Prximo Comando a ser executado
pelo aplicativo. Os comando vlidos esto
descritos em Tabela de cdigos de
Comando
Contm o cdigo do tipo de campo que a automao
deve tratar. Os tipos existentes esto descritos em
Tabela de valores para TipoCampo
Quando o Comando for uma coleta de dados,
contm o tamanho Mnimo e Maximo do campo a
ser lido
Varivel rea de transferncia de dados entre a aplicao e a

CliSiTef. Deve possuir, no mnimo, 20.000 bytes. Se
automao no estiver enviando dados para a
CliSiTef, deve passar esse campo vazio
Fixo 6 Tamanho da rea reservada pela automao para o
campo Buffer
Fixo 6 Contem instrues para a CliSiTef a respeito do
Comando executado segundo a seguinte codificao:
0
Continua a transao
1
Retorna, quando possvel, a coleta ao
campo anterior
2
Cancela o pagamento de conta atual,
mantendo os anteriores em memria, caso
existam, permitindo que tais pagamentos
17

Verso:
107
Data: 21/11/2012
sejam enviados para o SiTef e at mesmo

permite incluir novos pagamentos. Retorno
vlido apenas nas coletas de valores e data
de vencimento de um pagamento de
contas.
10000 Continua a transao, vide observao a
seguir
-1
Encerra a transao
Obs.: Como nem sempre o campo solicitado pela rotina precisa ser lido no momento da solicitao
a rotina aceita o valor 10000 para indicar que o campo no foi coletado naquele momento mas sim
previamente, no momento do fechamento da venda.
Um exemplo tpico desta situao ocorre quando a automao j fechou com o cliente uma forma
de pagamento parcelado com carto de crdito. Neste caso a automao pode, no momento que a coleta
campo for solicitada para ler o nmero de parcelas, j devolver o nmero previamente combinado sem
capturar esse dado do usurio.
Notar que nessa forma de uso imprescindvel que o dado seja apresentado para o operador que
dever confirmar veracidade dele antes da rotina devolver o mesmo para a CliSiTef.
Notar tambm que esta forma de uso no obrigatria, podendo a automao sempre capturar os
dados da tela. O uso desta caracterstica poder alterar o fluxo de coleta ou qualquer regra definida pelas
bandeiras, por isso antes de sua utilizao realizar consulta a departamento de Suporte da Software
Express que verificar a necessidade de autorizao prvia pelas bandeiras.
No retorno a rotina devolve os mesmos valores da rotina de Pagamento. Adicionalmente a estes
valores, a funo devolve o valor 0 (Zero) para indicar que a funo solicitada foi concluda com sucesso
(p/ex: se for um pagamento, ele foi aprovado pela administradora).
importante salientar que a chamada que inicia o processo Interativo (aquela que feita aps ter
sido recebido o valor 10000 na chamada de uma funo de Pagamento, Gerencial, etc...) deve ser feita
com Comando, TipoCampo, TamMinimo, TamMaximo e Continua contendo o valor zero (0).
Notar tambm que a automao comercial deve ficar em lao chamando a rotina aqui descrita at
que ela receba um resultado diferente de 10000 ou que a prpria automao desista de continuar o
processo, conforme mostrado a seguir:
18

Verso:
107
Data: 21/11/2012
Incio
Inicializa Comando, TipoCampo,

TamMinimo, TamMaximo e
Continua com 0
Inicializa TamBuffer com o

tamanho do Buffer
Chama a rotina
Retornou
10000?
Sim
Executa o Comando
solicitado
No
Fim
Caso a automao deseje encerrar o processo de coleta ela deve, necessariamente, chamar a rotina
ContinuaFuncaoSiTefInterativo passando 1 (menos um) no campo Continua. Caso o processo de coleta
deva continuar, ela no deve modificar nenhum dos campos preenchidos pela CliSiTef a no ser o Buffer
que, na nova chamada, deve conter o resultado da coleta (se Comando diferente de 0) ou o dado original
se Comando veio com 0. Notar ainda que mesmo que o Buffer contenha um campo coletado pela
automao, o seu tamanho deve ser o recomendado por esse documento pois ir conter, no retorno, novos
dados fornecidos pela rotina.
Notar que o campo Buffer pode ter sido preenchido pela rotina com algum dado para ser
memorizado, apresentado no visor ou outro motivo, segundo o que est especificado na descrio de cada
comando que o aplicativo de automao deve tratar.
IMPORTANTE: obrigatrio que a automao SEMPRE colete campos no tratveis por ela ou
seja, se ela receber algum cdigo em TipoCampo que ela desconhea ou no deseje tratar, que a
informao seja capturada pela digitao pelo operador da informao solicitada.
19

Verso:
107
Data: 21/11/2012
3.3.1 Tabela de cdigos de Comando

A seguir apresentamos os valores possveis para o parmetro Comando e a ao que a aplicao
deve executar ao receb-lo:
Comando
0
1
2
3
4
11
12
13
14
15
Descrio
Est devolvendo um valor para, se desejado, ser armazenado pela automao
Mensagem para o visor do operador
Mensagem para o visor do cliente
Mensagem para os dois visores
Texto que dever ser utilizado como ttulo na apresentao do menu ( vide comando 21)
Deve remover a mensagem apresentada no visor do operador (comando 1)
Deve remover a mensagem apresentada no visor do cliente (comando 2)
Deve remover mensagem apresentada no visor do operador e do cliente (comando 3)
Deve limpar o texto utilizado como ttulo na apresentao do menu (comando 4)
Cabealho a ser apresentado pela aplicao. Refere-se a exibio de informaes
adicionais que algumas transaes necessitam mostrar na tela.
16
20
Um exemplo a transao de Emprstimo do Correspondente Bancrio, que em certo

ponto precisa que sejam mostradas informaes para o cliente detalhando o emprstimo
que est sendo contratado (como Valor da parcela, vencimento, etc..).
Deve remover o cabealho apresentado pelo comando 15.
Deve apresentar o texto em Buffer, e obter uma resposta do tipo SIM/NO.
21
No retorno o primeiro carter presente em Buffer deve conter 0 se confirma e 1 se cancela.

Deve apresentar um menu de opes e permitir que o usurio selecione uma delas.
Na chamada o parmetro Buffer contm as opes no formato 1:texto;2:texto;...i:Texto;...
A rotina da aplicao deve apresentar as opes da forma que ela desejar (no sendo
necessrio incluir os ndices 1,2, ...).
22
23
29
Aps a seleo feita pelo usurio, retornar em Buffer o ndice i escolhido pelo operador
(em ASCII)
Deve apresentar a mensagem em Buffer, e aguardar uma tecla do operador. utilizada
quando se deseja que o operador seja avisado de alguma mensagem apresentada na tela.
Este comando indica que a rotina est perguntando para a aplicao se ele deseja
interromper o processo de coleta de dados ou no. Esse cdigo ocorre quando a CliSiTef
est acessando algum perifrico e permite que a automao interrompa esse acesso (por
exemplo: aguardando a passagem de um carto pela leitora ou a digitao de senha pelo
cliente)
Anlogo ao comando 30, porm deve ser coletado um campo que no requer interveno
do operador de caixa, ou seja, no precisa que seja digitado/mostrado na tela, e sim
passado diretamente para a biblioteca pela automao.
Um exemplo so as formas de pagamento que algumas
identificar qual o tipo de pagamento que est sendo usado.
transaes requerem para
O valor a ser coletado refere-se ao campo indicado em TipoCampo, cujo tamanho est
20

30
31
Verso:
107
Data: 21/11/2012
entre TamMinimo e TamMaximo. O campo deve ser devolvido em Buffer.

Deve ser lido um campo cujo tamanho est entre TamMinimo e TamMaximo. O campo lido
deve ser devolvido em Buffer.
Deve ser lido o nmero de um cheque. A coleta pode ser feita via leitura de CMC-7,
digitao do CMC-7 ou pela digitao da primeira linha do cheque.
No retorno deve ser devolvido em Buffer 0:(digitao da primeira linha do cheque)
,1:(Leitura do CMC-7) ou 2:(Digitao do CMC-7), seguido do nmero coletado
manualmente ou pela leitura/digitao do CMC-7, respectivamente.
Quando a primeira linha do cheque for coletada manualmente, o formato o seguinte:
Compensao (3), Banco (3), Agencia (4), C1 (1), ContaCorrente (10), C2 (1), Numero do
Cheque (6) e C3 (1), nesta ordem. Notar que estes campos so os que esto na parte
superior de um cheque e na ordem apresentada.
34
35
Sugerimos que na coleta seja apresentada uma interface que permita ao operador
identificar e digitar adequadamente estas informaes de forma que a consulta no seja
feita com dados errados, retornando como bom um cheque com problemas.
Deve ser lido um campo monetrio ou seja, aceita o delimitador de centavos e devolvido
no parmetro Buffer.
Deve ser lido um cdigo em barras ou o mesmo deve ser coletado manualmente.
No retorno Buffer deve conter 0: ou 1: seguido do cdigo em barras coletado
manualmente ou pela leitora, respectivamente.
Cabe ao aplicativo decidir se a coleta ser manual ou atravs de uma leitora. Caso seja
coleta manual, recomenda-se seguir o procedimento descrito na rotina
ValidaCampoCodigoEmBarras de forma a tratar um cdigo em barras da forma mais
genrica possvel, deixando o aplicativo de automao independente de futuras alteraes
que possam surgir nos formatos em barras.
41
42
No retorno do Buffer tambm pode ser passado 2:, indicando que a coleta foi cancelada,
porm o fluxo no ser interrompido, logo no caso de pagamentos mltiplos, todos os
documentados coletados anteriormente sero mantidos e o fluxo retomado, permitindo a
efetivao de tais pagamentos.
Anlogo ao Comando 30, porm o campo deve ser coletado de forma mascarada.
Menu identificado. Deve apresentar um menu de opes e permitir que o usurio selecione
uma delas.
Na
chamada
o
parmetro
Buffer
contm
as
opes
classe|1:texto:cdigo:tipo;2:texto:cdigo:tipo;...i:Texto:cdigo:tipo;.
no
formato
A rotina da aplicao deve apresentar as opes da forma que ela desejar (no sendo
necessrio incluir os ndices 1,2, ..., nem cdigos do campo, tipo e classe) e aps a seleo
feita pelo usurio, retornar em Buffer o ndice i escolhido pelo operador (em ASCII).
O cdigo das opes a identificao (Tabela de cdigos de meios de pagamento,
configuraes e menus) do campo da opo, ela pode ser utilizada na identificao da
opo escolhida.
21

Verso:
107
Data: 21/11/2012
Dentro de cada classe existe a codificao de tipos, e cada par (classe, tipo) indica a
natureza da opo. Inicialmente foi implementada apenas a identificao para as formas de
pagamento. A ideia adicionar cdigos que identificam as opes do menu para
possibilitar que o PDV identifique essas opes sem o auxlio do operador.
Classe
0
1
Descrio
Classe no definida
Forma de pagamento
Tipo
Descrio
1
Dinheiro
2
Cheque
Dbito
Crdito
Saque
Outra forma
Os demais menus no esto identificados. Os menus no identificados recebem o valor

zerado nesses campos, indicando que ainda no houve a necessidade de classific-los.
As classes de opo tm como objetivo definir um contexto para o qual o cdigo que
identifica o tipo de opo seja determinado. Assim, uma opo no menu identificada
sempre a partir do par tipo da opo e classe da opo.
Esse comando passa a ser utilizado quando o parmetro adicional ItemMenuIdentificado
for utilizado (Habilitao de configuraes especiais). Nesse caso, o comando 21 (coleta
de menu) ser substitudo na maior parte dos casos, sendo obrigao da aplicao estar
preparada para tratar os dois comandos, quando esse parmetro estiver habilitado.
22

Verso:
107
Data: 21/11/2012
3.3.2 Tabela de valores para TipoCampo

A seguir apresentamos os valores possveis para o campo TipoCampo e respectivos significados:
TipoCampo
Descrio
-1
No existem informaes que podem/devem ser tratadas pela automao
0
A rotina est sendo chamada para indicar que acabou de coletar os dados da transao e
ir iniciar a interao com o SiTef para obter a autorizao
10 a 99
Informa qual a opo selecionada no menu de navegao de transaes seguindo a
e
mesma codificao utilizada para definir as restries no pagamento descritas no item
3000 a 3999 Restrio ou habilitao das formas de pagamento.
100
Contm a modalidade de pagamento no formato xxnn.
xx corresponde ao grupo da modalidade e nn ao sub-grupo.
101
102
105
110
111
112
115
xx
00
01
02
03
98
99
Cheque
Carto de Dbito
Carto de Crdito
Carto tipo Voucher
Dinheiro
Outro tipo de carto
Grupo
nn
00
01
02
03
Sub-Grupo
vista
Pr-datado
Parcelado com financiamento pelo estabelecimento
Parcelado com financiamento pela administradora
Contm o texto real da modalidade de pagamento que pode ser memorizado pela
aplicao caso exista essa necessidade. Descreve por extenso o par xxnn fornecido em
100
Contm o texto descritivo da modalidade de pagamento que deve ser impresso no cupom
fiscal (p/ex: T.E.F., Cheque, etc...)
Contm a data e hora da transao no formato AAAAMMDDHHMMSS
Contm a modalidade de cancelamento no formato xxnn xx corresponde ao grupo da
modalidade e nn ao sub-grupo. Segue o mesmo formato do TipoCampo 100, e retorna
quando uma transao for cancelada.
Contm o texto real da modalidade de cancelamento que pode ser memorizado pela
aplicao caso exista essa necessidade. Descreve por extenso o par xxnn fornecido em
110.
Contm dados adicionais relativos ao carto utilizado na operao de Tef. O formato
deste campo uma seqncia de cdigos separados por ponto-e-virgula. Por enquanto o
nico cdigo que retorna a palavra EE para indicar que o carto utilizado foi um
EasyEntry ou EMV para indicar um carto EMV. Caso tenha sido um carto normal, esse
tipo de campo no retornado para a aplicao.
Modalidade Ajuste
23

120
121
122
123
125
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
150
151
153
Verso:
107
Data: 21/11/2012
Buffer contm a linha de autenticao do cheque para ser impresso no verso do mesmo
Buffer contm a primeira via do comprovante de pagamento (via do cliente) a ser
impressa na impressora fiscal. Essa via, quando possvel, reduzida de forma a ocupar
poucas linhas na impressora. Pode ser um comprovante de venda ou administrativo
Buffer contm a segunda via do comprovante de pagamento (via do caixa) a ser impresso
na impressora fiscal. Pode ser um comprovante de venda ou administrativo
Indica que os comprovantes que sero entregues na seqncia so de determinado tipo:
COMPROVANTE_COMPRAS = "00"
COMPROVANTE_VOUCHER = "01"
COMPROVANTE_CHEQUE = "02"
COMPROVANTE_PAGAMENTO = "03"
COMPROVANTE_GERENCIAL = "04"
COMPROVANTE_CB = "05"
COMPROVANTE_RECARGA_CELULAR = "06"
COMPROVANTE_RECARGA_BONUS = "07"
COMPROVANTE_RECARGA_PRESENTE = "08"
COMPROVANTE_RECARGA_SP_TRANS = "09"
COMPROVANTE_MEDICAMENTOS = "10"
Cdigo do Voucher
Indica, na coleta, que o campo em questo o valor do troco em dinheiro a ser devolvido
para o cliente. Na devoluo de resultado (Comando = 0) contm o valor efetivamente
aprovado para o troco
Contm um ndice que indica qual a instituio que ir processar a transao segundo a
tabela presente no final do documento (5 posies)
Contm um ndice que indica qual o tipo do carto quando esse tipo for identificvel,
segundo uma tabela a ser fornecida (5 posies)
Contm o NSU do SiTef (6 posies)
Contm o NSU do Host autorizador (15 posies no mximo)
Contm o Cdigo de Autorizao para as transaes de crdito (15 posies no mximo)
Contm as 6 primeiras posies do carto (bin)
Saldo a pagar
Valor Total Recebido
Valor da Entrada
Data da primeira parcela no formato ddmmaaaa
Data da parcela no formato ddmmaaaa (reservado)
Valor da parcela (reservado)
Os campos 141 e 142 so chamados n vezes onde n = contedo do campo 505
Valor gorjeta
Valor devoluo
Valor de pagamento
A rotina est sendo chamada para ler o Valor a ser cancelado. Caso o aplicativo de
automao possua esse valor, pode apresent-lo para o operador e permitir que ele
confirme o valor antes de pass-lo devolv-lo para a rotina. Caso ele no possua esse
valor, deve l-lo.
Valor a ser cancelado
Contm a Trilha 1, quando disponvel, obtida na funo LeCartaoInterativo
Contm a Trilha 2, quando disponvel, obtida na funo LeCartaoInterativo
Contem a senha do cliente capturada atravs da rotina LeSenhaInterativo e que deve ser
passada a lib de segurana da Software Express personalizada para o estabelecimento
24

154
155
156
157
158
160
161
170
171
172
173
174
175
176
177
178
200
201
500
501
502
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
Verso:
107
Data: 21/11/2012
comercial de forma a obter a senha aberta

Contm o novo valor de pagamento
Tipo carto Bnus
Nome da instituio
Cdigo de Estabelecimento
Cdigo da Rede Autorizadora Servio H
Nmero do cupom original
Nmero Identificador do Cupom do Pagamento
Venda Parcelada Estabelecimento Habilitada
Nmero Mnimo de Parcelas Parcelada Estabelecimento
Nmero Mximo de Parcelas Parcelada Estabelecimento
Valor Mnimo Por Parcela Parcelada Estabelecimento
Venda Parcelada Administradora Habilitada
Nmero Mnimo de Parcelas Parcelada Administradora
Nmero Mximo de Parcelas Parcelada Administradora
Indica que o campo numrico (PBM)
Indica que o campo alfanumrico (PBM)
Saldo disponvel*, saldo do produto especfico (escolar, vale transporte)
Saldo Bloqueado
Indica que o campo em questo o cdigo do supervisor. A automao, pode, se
desejado, validar os dados coletados, deixando o fluxo da transao seguir normalmente
caso seja um supervisor aceitvel
Tipo do Documento a ser consultado (0 CPF, 1 CGC)
Numero do documento (CPF ou CGC)
Taxa de Servio
Nmero de Parcelas
Data do Pr-datado no formato ddmmaaaa
Captura se a primeira parcela a vista ou no (0 Primeira a vista, 1 caso contrrio)
Intervalo em dias entre parcelas
Captura se ms fechado (0) ou no (1)
Captura se com (0) ou sem
(1) garantia no pr-datado com carto de dbito
Nmero de Parcelas CDC
Nmero do Carto de Crdito Digitado
Data de vencimento do Carto
Cdigo de segurana do Carto
Data da transao a ser cancelada (DDMMAAAA) ou a ser re-impressa
Nmero do documento a ser cancelado ou a ser re-impresso
A rotina est sendo chamada para ler o Nmero do cheque segundo o descrito no tipo de
comando correspondente ao valor 31
Cdigo do Item
Cdigo do Plano de Pagamento
NSU do SiTef Original (Cisa)
Nmero do documento de identidade (RG)
A rotina est sendo chamada para ler o Nmero do Telefone
A rotina est sendo chamada para ler o DDD de um telefone com at 4 dgitos
Valor da primeira parcela
Valor das demais parcelas
25

526
527
529
530
531
532
533
534
535
536
537
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
589
590
Verso:
107
Data: 21/11/2012
Quantidade de cheques
Data de vencimento do cheque
A rotina est sendo chamada para ler a Data de Abertura de Conta no formato
(MMAAAA)
Autorizao do supervisor digitada
Autorizao do supervisor especial
A rotina est sendo chamada para ler a quantidade de parcelas ou cheques
Dados adicionais da venda
Emitente do cheque
O documento pago pela transao
Registros de retorno da consulta cheque CDL-Poa
Cdigo de rea da cidade do cheque
Endereo
Nmero do endereo
Andar do endereo
Conjunto do endereo
Bloco do endereo
CEP do endereo
Bairro do endereo
CPF para consulta AVS
Resultado da consulta AVS
Nmero de dias do pr-datado
Nmero de Ciclos
Cdigo da Ocorrncia
Cdigo de Loja (EMS)
Cdigo do PDV (EMS)
Dados Retornados (EMS)
Ramal do Telefone
rgo Expedidor do RG
Estado onde foi emitido o RG
Data de expedio do RG
Matrcula do Operador
Nome do Operador
Matrcula do Conferente
Nome do Conferente
Percentual de Juros Aplicado
Matrcula do Autorizador
Data do Cupom Fiscal da Transao Original
Hora do Cupom Fiscal da Transao Original
Dados do Carn ou cdigo resumido EMS
Cdigo de milhas diferenciadas 1
Valor das milhas diferenciadas 1
Cdigo de milhas diferenciadas 2
Valor das milhas diferenciadas 2
Tipo de cdigo externo EMS
Cdigo externo EMS
Cdigo da Operadora de Celular
Nome da Operadora de Celular selecionada para a operao
26

591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
Verso:
107
Data: 21/11/2012
Valor selecionado para a recarga

DDD + Nmero do celular a ser recarregado
Digito(s) verificadores
Cep da localidade onde est o terminal no qual a operao est sendo feita
Nsu do SiTef correspondente a transao de pagamento da Recarga com carto
Nsu do Host Autorizador correspondente a transao de pagamento da Recarga com
carto
Cdigo da Filial que atendeu a solicitao de recarga do celular
Mensagem da Operadora de Celular
Cdigo da rede autorizadora da recarga de celular
Data de vencimento do ttulo/convnio no formato DDMMAAAA
Valor Pago*
Valor Original
Valor Acrscimo
Valor do Abatimento
Data Contbil do Pagamento
Nome do Cedente do Titulo. Deve ser impresso no cheque quando o pagamento for feito
via essa modalidade
ndice do documento, no caso do pagamento em lote, dos campos 600 a 604 que viro em
seguida
Modalidade de pagamento utilizada na funo de correspondente bancrio. Segue a
mesma regra de formatao que o campo de nmero 100
Valor total dos ttulos efetivamente pagos no caso de pagamento em lote
Valor total dos ttulos no pagos no caso de pagamento em lote
NSU Correspondente Bancrio
Tipo do documento: 0 Arrecadao, 1 Titulo (Ficha de compensao), 2 Tributo
Contm os dados do cheque utilizado para efetuar o pagamento das contas no seguinte
formato: Compensao (3), Banco (3), Agencia (4), Conta Corrente (10), e Numero do
Cheque (6), nesta ordem. Notar que a ordem a mesma presente na linha superior do
cheque sem os dgitos verificadores
NSU SiTef transao de pagamento
NSU SiTef da transao original (transao de cancelamento)
NSU Correspondente Bancrio da transao original (transao de cancelamento)
Valor do Benefcio
Cdigo impresso no rodap do comprovante do CB e utilizado para reimpresso/cancelamento
Cdigo em barras pago. Aparece uma vez para cada ndice de documento (campo 607). O
formato o mesmo utilizado para entrada do campo ou seja, 0:numero ou 1:numero
Recibo de retirada
Nmero do banco
Agncia
Dgito da agncia
Conta
Dgito da conta
Valor em dinheiro
Valor em cheque
Nome do depositante
Documento original de Correspondente Bancrio
27

635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
670
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
722
723
724
725
726
727
729
Verso:
107
Data: 21/11/2012
Chave do usurio utilizada para comunicao com o Banco

Seqencial nico da chave do usurio no Banco
Cdigo da Agncia de relacionamento da loja do correspondente
Nmero do Cheque CB
Nmero da Fatura
Nmero do Convnio
Data Inicial do Extrato (DDMMAAAA)
Data Final do Extrato (DDMMAAAA)
Perodo de Apurao
Cdigo da Receita Federal
Valor da Receita Bruta
Percentual Aplicado
Valor Principal
Valor Multa
Valor Juros
(interno) Abertura de pinpad remoto
(interno) Fechamento de pinpad remoto
(interno) Comando de aborta do pinpad remoto
(interno) Escrita de pinpad remoto
(interno) Leitura de pinpad remoto
Dado do PinPad
Operadora de ValeGs
Produto ValeGs
Nmero do ValeGs
Nmero de Referncia
Cdigo GPS
Competncia GPS
Identificador Contribuinte
Valor INSS
Valor Outras Entidades
Permite Pagamento de Contas Com Dinheiro (0 No Permite; 1 Permite)
Permite Pagamento de Contas Com Cheque (0 No Permite; 1 Permite)
Permite Pagamento de Contas Com TEF Dbito (0 No Permite; 1 Permite)
Permite Pagamento de Contas Com TEF Crdito (0 No Permite; 1 Permite)
Formas de Pagamento utilizadas na transao de Pagamento genrico
Valor do Saque
Numero do Pedido
Valor Limite do Depsito CB
Valor Limite do Saque CB
Valor Limite do Saque para Pagamento CB
Valor do produto ValeGs
Valor mnimo de pagamento
Identificao do Cliente, apenas para recebimento Carrefour
Venda Crdito Parcelada com Plano Habilitada
Venda Crdito com Autorizao a Vista Habilitada
Venda Crdito com Autorizao Parcela com Plano Habilitada
Venda Boleto Habilitada
Valor mximo de pagamento
28

730
731
Nmero Mximo de Formas de Pagamento, 0 para sem limite

Tipo de Pagamento Habilitado, repete n vezes, onde n o nmero de formas de
pagamento habilitadas:
00
01
02
732
734
736
737
738
739
750
751
900
901
902
903
910
911
1002
1003
1010
1011
1012
1013
1014
1015
Verso:
107
Data: 21/11/2012
Dinheiro
Cheque
TEF Dbito
Dados a serem enviados para o Tipo de Pagamento (Campo 730) retornado

anteriormente, repete n vezes, onde n o nmero de dados a serem enviados para o
respectivo Tipo de Pagamento:
00
Campo Reservado
01
Tipo de Entrada do Cheque
02
Dados do Cheque
03
Rede Destino
04
NSU do SiTef da transao de TEF
05
Data do SiTef da transao de TEF (no utilizado, uso futuro)
06
Cdigo da Empresa (Loja) da transao de TEF
07
NSU do Host da transao de TEF
08
Data do Host da transao de TEF (Campo 105 CliSiTef)
09
Cdigo de Origem (Estabelecimento) da transao de TEF
10
Servio Z da transao de TEF
11
Cdigo de Autorizao da transao de TEF
12
Valor do Cheque
Limite minimo de venda para promoes flexveis, com 12 dgitos sendo os 2 ltimos
dgitos referentes as casas decimais
Saldo devedor atual, apenas para recebimento Carrefour
Motivo (Carrefour)
Valor sugerido para o produto selecionado.
Cliente Preferencial
Valor Pague Fcil CB
Valor Tarifa Pague Fcil CB
Cdigo Material AURA
Cdigo Plano AURA
Nome creditado no Cheque AURA
Nmero Dossi AURA
Tipo de Venda Conductor/Renner : 1 = Venda via Fatura
2 = Venda via Boleto
Define se aps a consulta de fatura, deve encadear o pagamento de fatura (Conductor Renner)
Data de Validade do Carto (NPTC)
Nome do Portador do Carto (NPTC)
Quantidade de medicamentos - PBM
ndice do medicamento PBM
Cdigo do medicamento PBM
Quantidade autorizada PBM
Preo mximo ao consumidor PBM
Preo recomendado ao consumidor PBM
29

1016
1017
1018
1019
1020
1021
1022
1023
1024
1025
1026
1027
1028
1029
1030
1031
1032
1033
1034
1035
1036
1037
1038
1039
1040
1041
1042
1043
1044
1045
1046
1047
1048
1049
1050
1051
1052
1053
1054
1055
1056
1057
1058
1100
1101
1102
Verso:
107
Data: 21/11/2012
Preo de venda na farmcia PBM

Valor de reembolso na farmcia PBM
Valor reposio na farmcia PBM
Valor subsdio do convnio PBM
CNPJ convnio PBM
Cdigo do plano do desconto PBM
Possui receita mdica PBM
CRM PBM
UF PBM
Descrio do produto* - PBM
Cdigo do produto PBM
Quantidade do produto PBM
Valor do produto PBM
Data da receita mdica - PBM
Cdigo de autorizao PBM
Quantidade estornada PBM
Cdigo de estorno PBM
Preo recomendado consumidor a vista PBM
Preo recomendado consumido para desconto em folha PBM
Percentual de reposio da farmcia PBM
Comisso de reposio PBM
Tipo de Autorizao PBM
Cdigo do conveniado PBM
Nome do conveniado PBM
Tipo de Medicamento PBM (01Medicamento, 02-Manipulao, 03-Manipulao
Especial, 04-Perfumaria)
Descrio do Medicamento PBM
Condio p/venda: Se 0 obrigatrio utilizar preo Funcional Card (PF)
Se 1 pode vender por preo inferior ao preo PF
Preo funcional card
Preo praticado PBM
Status do medicamento PBM
Quantidade receitada PBM
Referncia PBM
Indicador da venda PBM (0-Produto venda carto 1-Produto venda a vista)
Grupo de Produto (EDMCard: 0 Medicamento; 1 Perfumaria.)
Nome - ACSP
Data de nascimento ACSP
Nome da me ACSP
Nmero do ttulo de eleitor ACSP
Endereo do telefone consultado ACSP
CEP do telefone consultado ACSP
Cidade do telefone consultado ACSP
UF do telefone consultado ACSP
Dados adicionais ACSP
Registro analtico CHECKCHECK
Registro analtico ACSP
Registro analtico SERASA
30

1103
1104
1105
1106
1107
1108
1109
1110
1111
1112
1113
1114
1115
1116
1117
1118
1119
1120
1121
1122
1123
1124
1125
1126
1127
1128
1129
1131
1132
1133
1134
1135
1136
1137
1152
1160
1190
1191
1192
1193
1200
1201
1202
1203
1204
1205
Verso:
107
Data: 21/11/2012
Imagem tela analtica ACSP

Imagem tela analtica SERASA
Motivo do cancelamento ACSP
Tipo de consulta ACSP
CNPJ Empresa Conveniada ACSP
Cdigo da administradora ACSP
Dados tabela Telecheque - ACSP
Matrcula do motorista Carto Combustvel
Placa do veculo Carto Combustvel
Quilometragem Carto Combustvel
Quantidade de litros Carto Combustvel
Combustvel principal Carto Combustvel
Produtos de combustvel Carto Combustvel
Cdigo Produto Host Carto Combustvel
Hormetro Carto Combustvel
Linha de Crdito Carto Combustvel
Tipo de Mercadoria Carto Combustvel
Ramo Carto Combustvel
Casas decimais de preos unitrios Carto Combustvel
Quantidade mxima de produtos venda Carto Combustvel
Tamanho do cdigo do Produto Carto Combustvel
Cdigo do veculo Carto Combustvel
Nome da Empresa Carto Combustvel
Casas decimais da quantidade Carto Combustvel
Retorna quando um carto NPTC exigir coleta de dados no-esperados pela automao.
Lista de Perguntas Carto Combustvel
Permite Coleta de Produto Carto Combustvel
Cdigo do Limite
Quantidade de Titulares
Data de Abertura da Empresa (DDMMAAAA)
Nome do Titular
Complemento do Endereo
Cidade
Estado
Menu de Valores - SPTrans
Produto com Valor de Face - Gift
Embosso Gol Offline
PAN do carto AES Gol Offline
Portador do carto AES Gol Offline
Data de validade do carto AES Gol Offline
Total de consultas anteriores
Valor acumulado das consultas anteriores, contendo 2 dgitos decimais porm sem o
caractere decimal.
Total de consultas efetuadas no dia.
Valor acumulado das consultas no dia, contendo 2 dgitos decimais porm sem o
caractere decimal.
Total de consultas de cheques pr-datados realizados no perodo.
Valor acumulado de cheques pr-datados, contendo 2 dgitos decimais porm sem o
31

1206
1207
1208
1209
2000
2001
2002
2003
2004
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2017
2018
2019
2020
2047
2048
2053
2054
2055
2056
2057
2058
2059
2064
2065
2066
2067
2068
2078
2079
2081
2082
2083
2086
2087
Verso:
107
Data: 21/11/2012
caractere decimal.
Vendedor (Usurio) - PBM
Senha PBM
Cdigo de Retorno PBM
Origem PBM
Campo administrativo
Campo livre
Resultado da leitora SmartNet
Dados obtidos da leitora aps uma operao de dbito do carto SmartVR ou Sodexho
Campo de mensagem do servio D, para mensagens 0x0400
Dados a serem enviados PARA a leitora SmartNet.
Tipo de criptografia
ndice MasterKey
Chave de criptografia
Senha do carto
Cdigo de resposta do autorizador
Bin da rede
Nmero serial do CHIP
Registro de controle do CHIP
Saldo comum, saldo do passe comum
PAN do carto presente
Data primeiro vencimento
Valor total
Valor financiado
Percentual multa
Juros de mora
TAC (Taxa de administrao)
Menu (produto) selecionado Visanet
Tipo Crdito CDC (1 CDC Produto; 2 CDC Servio)
Data/Hora Sitef (Local)
Dia da semana Sitef (Local)
Data/Hora Sitef (GMT)
Dia da Semana Sitef (GMT)
Dados da Forma de Pagamento - SPTrans
Valor pagamento em dinheiro
Cdigo consulta cheque (Genrica EMS)
Nome da filial
Mensagem do autorizador a ser exibida junto com o menu de valores (Se o terminal
permitir)
Valor selecionado atravs de menu
Cdigo do servio
Valor do servio
Menu de Produtos
Nosso nmero
Valor total do produto contendo o separador decimal (,) e duas casas decimais aps a
vrgula.
Cdigo do Produto - ValeGas
Demonstrativo de prazos : 0: No; 1: Sim
32

2088
2089
2090
2091
2093
2101
2102
2103
2104
2107
2108
2109
2120
2121
2122
2123
2124
2125
2126
2301
2320
2321
2322
2323
2324
2325
2326
2327
2328
2329
2330
2331
2332
2334
2340
2341
2342
2343
2344
2345
2346
2347
2348
2349
2350
2351
2352
2361
Verso:
107
Data: 21/11/2012
Cancelamento Total/Parcial : 0: Parcial; 1: Total

Nmero de identificao da fatura.
Tipo do carto Lido
Status da ltima leitura do carto
Cdigo do atendente
RUT - Campo usado pelo Ticket Car (Chile)
Comuna - Campo usado pelo Ticket Car (Chile)
Indica se foi transao offline : 1 : Sim
Tipo do carto Combustvel : 1 (Crdito, Ps-pago), 2 (Dbito, Pr-pago)
Cdigo Atividade Giro - Campo usado pelo Ticket Car (Chile)
Nome Atividade Giro - Campo usado pelo Ticket Car (Chile)
Senha temporria
Cdigo Produto Hopi-Hari
Descrio Produto Hopi-Hari
Quantidade Mxima de produtos Hopi-Hari
Produtos Hopi-Hari
Valor da tarifa da Recarga de Celular
Nmero da parcela (2 caracteres) (Hotcard)
Seqencial da transao (6 caracteres) (Hotcard)
Rodap do comprovante da via estabelecimento
Cdigo do Depositante CB
Cdigo do Cliente - CB
Sequencia Carto CB
Via Carto - CB
Tipo do Extrato CB
Valor limite de Transferncia - CB
Valor limite para coleta de CPF/CNPJ CB
CPF/CNPJ do Proprietrio CB
CPF/CNPJ do Portador CB
Tipo do documento do Proprietrio - CB
Tipo do documento do Portador - CB
Indica se permite pagamento com carto CB
Valor da Transferncia
Pin Code
Data de Entrada do Veculo Estapar
Data de Sada do Veculo Estapar
Hora de Entrada do Veculo Estapar
Hora de Sada do Veculo Estapar
Tipo de Cliente (1: Rotativo; 2: Mensalista) Estapar
Nmero da Sucursal Estapar
Nmero da Aplice Estapar
Nmero do Item - Estapar
Chassi do Veculo Estapar
Nmero da SUSEP - Estapar
Nmero do Dispositivo - Estapar
Vigncia Final Estapar
Flag Interna- Estapar
Indica que foi efetuada uma transao de dbito para pagamento de carn
33

Verso:
107
Data: 21/11/2012
Status da Pr-Autorizao PBM

CRF PBM
UF do CRF PBM
Tipo de venda PBM
Valor total PBM
Valor a vista PBM
Valor carto PBM
Nosso nmero PBM
Percentual de desconto concedido pela administradora (2 casas decimais)
Preo bruto PBM
Preo lquido PBM
Valor a receber da Loja, em centavos PBM
Nmero do lote gerado pela Central PBM
Valor total a receber da loja PBM
Valor total a receber da loja PBM
Soma dos valores da Operao PBM
Nome da operadora PBM
Nome da empresa conveniada PBM
Quantidade de dependentes PBM
Cdigo do dependente PBM
Nome do dependente PBM
Valor a receber do conveniado PBM
Valor do desconto total, em centavos
Valor liquido total, em centavos - PBM
Cdigo da Operadora Selecionada PBM (dever ser gravado para posterior envio nas
demais transaes)
4032
Campo de retorno de dados livres referentes s transaes PBM.
4033
Tipo de documento PBM (0 = CRM, 1 = CRO)
4034
Dados do Resgate - Bnus
Campos reservados para uso da IntPos.dll
8000 a 9999 Campos reservados
* Campos utilizados em um ou mais produtos.
4000
4001
4002
4003
4004
4005
4006
4007
4008
4016
4017
4018
4019
4020
4021
4022
4023
4024
4025
4026
4027
4028
4029
4030
4031
Note que nem todos os campos so retornados em todas as transaes. Alm disso, existem campos
que somente so retornados se a transao foi aprovada.
O aplicativo de automao deve ignorar aqueles campos que no desejar/no souber tratar uma vez
que, em verses futuras da CliSiTef, novos campos podero ser disponibilizados. Notar que a forma
correta de ignorar estes campos executar a funo definida em ProximoComando ou simplesmente
ignorar o dado retornado para a aplicao quando ProximoComando for 0.
Cabe a automao comercial memorizar os comprovantes para impresso na hora apropriada,

segundo a legislao Fiscal vigente.
J no caso do Correspondente Bancrio ou das Funes Administrativas, a impresso de
qualquer comprovante deve ser feita no momento que eles forem disponibilizados para a automao e a
informao de se eles foram impressos corretamente ou no passada pela funo
ContinuaFuncaoSiTefInterativo atravs do valor 0 ou -1, respectivamente, colocado em Continua.
34

Verso:
107
Data: 21/11/2012
3.3.3 Tabela de Eventos, retornados tambm em TipoCampo

TipoCampo
5000
5001
5002
5003
5004
5005
5006
5007
5008
5009
5010
5011
5012
5013
5014
5501
Descrio
Eventos de coleta
Indica que a biblioteca est aguardando a leitura de um carto
Indica que a biblioteca est esperando a digitao da senha pelo usurio
Indica que a biblioteca est esperando a digitao dos dados de confirmao positiva pelo
usurio
Indica que a biblioteca est aguardando a leitura do bilhete nico
Indica que a biblioteca est aguardando a remoo do bilhete nico
Indica que a transao foi finalizada
Confirma Dados Favorecido
SiTef Conectado
SiTef Conectando
Consulta OK
Colher Assinatura
Coleta Novo Produto
Confirma Operao
Confirma Cancelamento
Confirma Valor Total
Outros eventos
Incio de uma transao do tipo Correspondente Bancrio.
35

Verso:
107
Data: 21/11/2012
3.4 Confirmao ou no do Pagamento
Rotina chamada pelo aplicativo para fechar o ciclo transacional. Ela deve ser acionada no momento
que o comprovante Fiscal for fechado e recebe como parmetros um indicador de se a transao foi
concretizada ou se deve ser estornada. Recebe tambm os campos que permitem identificar a transao
que est sendo finalizada.
Esta funo tambm deve ser utilizada para desfazer uma transao interrompida por uma queda de
energia ou qualquer outro problema no aplicativo.
Essa rotina confirma ou cancela TODOS os meios de pagamento vinculados ao Nmero do Cupom
Fiscal passado como parmetro.
void FinalizaTransacaoSiTefInterativo (Confirma, CupomFiscal, DataFiscal,
HoraFiscal);
Interface ASCII
FinalizaTransacaoSiTefInterativoA (Resultado, Confirma, CupomFiscal,
DataFiscal, HoraFiscal);
Parmetro
Resultado
Confirma
CupomFiscal
DataFiscal
HoraFiscal
Tipo
Sada,
por valor
Entrada,
por valor
Entrada,
por valor
Entrada,
por valor
Entrada,
por valor
Interface Interface
Descrio
padro
ASCII
short
char *
Fixo 1
Indica se a transao deve ser confirmada (1) ou

estornada (0)
char *
Fixo 8
char *
Fixo 6
Horrio Fiscal no formato HHMMSS
36

Verso:
107
Data: 21/11/2012
3.5 Teste da presena de PinPad
Essa funo, disponibilizada apenas para aplicaes de automao que a necessitem, permite
verificar se existe um PinPad conectado na porta serial destinada a ele e se ele est operacional. A forma
de chamada desta funo a seguinte:
long VerificaPresencaPinPad (void)
A rotina no tem parmetros de entrada e no retorno a rotina devolve um dos seguintes valores:
1 Existe um PinPad operacional conectado ao micro;
0 No existe um PinPad conectado ao micro;
-1 biblioteca de acesso ao PinPad no encontrada;
outro nmero erros detectados internamente pela rotina ou pela biblioteca de acesso ao PinPad
3.6 Define mensagem permanente para o PinPad
Permite que seja definida uma mensagem permanente para ser apresentada no PinPad durante o
tempo que ele no est em uso. O formato de ativao da rotina o seguinte:
long EscreveMensagemPermanentePinPad (Mensagem)
Interface ASCII
EscreveMensagemPermanentePinPadA (Resultado, Mensagem)
Parmetro
Resultado
Mensagem
Tipo
Sada,
por valor
Entrada,
por valor
Interface Inteface
Descrio
padro
ASCII
char *
Varivel Mensagem a ser apresentada no visor do PinPad.

Recomenda-se que ela possua no mximo 32
caracteres de forma a ser compatvel com os
PinPads existente atualmente em campo
Para apagar a mensagem e deixar o visor em branco s chamar essa funo passando o campo
Mensagem vazio.
responsabilidade da aplicao, se desejado, incluir o caractere | (Barra em p) para indicar uma
mudana de linha.
37

Verso:
107
Data: 21/11/2012
3.7 Leitura da trilha 3 do carto
Esta funo permite que o aplicativo capture uma trilha 3 magntica genrica.
Note que o PinPad deve ter suporte para a leitura da trilha 3.
No deve ser utilizada para tratamento das transaes de pagamento mas apenas para leitura de
cartes internos do estabelecimento comercial (p/ex. carto de supervisor). O formato de ativao o
seguinte:
long LeTrilha3 (Mensagem)
Parmetro
Resultado
Mensagem
Tipo
Sada,
por valor
Entrada,
por valor
Interface Interface
Descrio
padro
ASCII
char *
Varivel Mensagem a ser apresentada no visor do PinPad
No retorno a rotina devolve os mesmos valores que a rotina de pagamento. O aplicativo obtm as
trilhas atravs da chamada a funo de continuao do processo interativo.
IMPORTANTE:
Esta funo NO pode ser utilizada durante a execuo do lao
ContinuaFuncaoSiTefInterativo.
38

Verso:
107
Data: 21/11/2012
3.8 Leitura do carto - rotinas de captura segura
Os rotinas seguintes tm seu funcionamento condicionado a configurao do arquivo com extenso

.cha no SiTef, caso a configurao no esteja feita, essas funes retornam o erro
MODO_SEGURO_NAO_ATIVO (12).
long LeCartaoSeguro (Mensagem)
Interface ASCII
LeCartaoSeguroA (Resultado, Mensagem)
Parmetro
Resultado
Mensagem
Tipo
Sada,
por valor
Entrada,
por valor
Interface Interface
Descrio
padro
ASCII
char *
No retorno a rotina devolve os mesmos valores que a rotina de pagamento. O aplicativo obtm as
trilhas atravs da chamada a funo de continuao do processo interativo.
Os campos retornados no processo interativo so os referentes aos campos sensveis (2021 a 2046).
IMPORTANTE: Essas funes NO podem ser utilizadas durante a execuo do lao
ContinuaFuncaoSiTefInterativo. Para esse tipo de situao existem as verses que fazem o acesso direto a
leitora de carto descritas a seguir.
int LeCartaoDiretoSeguro (Mensagem, TipoCampoTrilha1, Trilha1,
TipoCampoTrilha2, Trilha2, Timeout, TestaCancelamento)
Interface ASCII
LeCartaoDiretoSeguroA (Resultado, Mensagem, TipoCampoTrilha1, Trilha1,
TipoCampoTrilha2, Trilha2, Timeout)
Parmetro
Resultado
Tipo
Sada,
por valor
Mensagem
Entrada,
por valor
TipoCampoTrilh Sada,
a1
por valor
Trilha1
Sada,
por valor
TipoCampoTrilh Sada,
a2
por valor
Interface Interface
Descrio
padro
ASCII
char *
char *
Fixo 12
char *
char *
Indica o tipo de campo que foi retornado na trilha 1,

se ele mascarado, criptografado ou em Hash.
Mx. 128 No retorno contm, caso exista, a Trilha 1 lida
Fixo 12
Indica o tipo de campo que foi retornado na trilha 2,

se ele mascarado, criptografado ou em Hash.
39

Trilha2
Timeout
TestaCancela
mento
Sada,
por valor
Entrada,
por valor
char *
short
Fixo 6
Entrada,
por valor
Rotina
No
Usado
Verso:
107
Data: 21/11/2012
Mx. 64 No retorno contm, caso exista, a Trilha 2 lida

Define o tempo mximo de espera pela passagem do
carto em segundos. Se zero, espera at que o carto
seja passado
Rotina da aplicao de automao que retorna 0 se
para continuar aguardando pelo carto e 1 caso deva
interromper o processo de aguardar a passagem do
carto
No retorno a rotina devolve o valor 0 (zero) caso tenha sido executada corretamente e um valor
diferente de zero em caso de erro ou interrupo.
Os campos TipoCampoTrilha1 e TipoCampoTrilha2 indicam o tipo de campo retornado,
respeitando o valor estabelecido para os campos sensveis, com 202x para campos abertos mascarados,
203x para o Hash dos campos e 204x para campos criptografados.
TipoCampo
202x
Campos abertos, mascarados.
203x
Hash dos campos
204x
Campos criptografados
x
1
2
3
4
5
Descrio
Campo
PAN do carto
Vencimento do carto
Nome do Cliente
Trilha 1
Trilha 2
40

Verso:
107
Data: 21/11/2012
3.9 Leitura de senha
Esta funo permite que o aplicativo capture no PinPad uma senha de um cliente de carto do
prprio estabelecimento comercial (carto proprietrio). No deve, em nenhuma hiptese, ser utilizada
para captura de senhas dos cartes tradicionais. O formato de ativao o seguinte:
long LeSenhaInterativo (Parametros)
Interface ASCII
LeSenhaInterativoA (Resultado, Parametros)
Parmetro
Resultado
Parametros
Tipo
Sada,
por valor
Entrada,
por valor
Interface Interface
Descrio
padro
ASCII
char *
Fixo 64
Dados gerados por uma biblioteca de segurana

fornecida pela Software Express para habilitar a
captura da senha do cliente. Neste caso, a CliSiTef
poder interagir com o SiTef para obter ou validar
os dados de segurana necessrios para a captura
No retorno a rotina devolve os mesmos valores que a rotina de pagamento. O aplicativo obtm a
senha atravs da chamada a funo de continuao do processo interativo.
IMPORTANTE: Essas funes NO podem ser utilizadas durante a execuo do lao
ContinuaFuncaoSiTefInterativo. Para esse tipo de situao existem as verses que fazem o acesso direto a
leitora de senhas descritas a seguir.
long LeSenhaDireto (Parmetros, SenhaCliente)
Interface ASCII
LeSenhaDiretoA (Resultado, Parmetros, SenhaCliente)
Parmetro
Resultado
Parametros
Senha
Tipo
Sada,
por valor
Entrada,
por valor
Sada,
por valor
Interface Interface
Descrio
padro
ASCII
----Fixo 6 Contm o resultado de resposta chamada da rotina
char *
Fixo 64
char *
Fixo 20
Dados gerados por uma biblioteca de segurana

fornecida pela Software Express para habilitar a
captura da senha do cliente
Senha do cliente, em formato criptografado, e que
deve ser passada para uma rotina personalizada por
cliente para sua descriptografia
No retorno a rotina devolve o valor 0 (zero) caso tenha sido executada corretamente e um valor
diferente de zero em caso de erro ou cancelamento pelo usurio.
41

Verso:
107
Data: 21/11/2012
3.10 Leitura de Confirmao pelo Cliente no PinPad
Estas funes permitem que o aplicativo solicite uma confirmao no PinPad. O formato de
ativao o seguinte:
long LeSimNaoPinPad (Mensagem)
Interface ASCII
LeSimNaoPinPadA (Resultado, Mensagem)
Parmetro
Resultado
Mensagem
Tipo
Sada,
por valor
Entrada,
por valor
Interface Interface
Descrio
padro
ASCII
char *
No retorno a rotina devolve 0 se o cliente pressionou a tecla de Cancelamento, 1 se ele pressionou a

tecla de Confirmao e outro valor em caso de erro no acesso ao PinPad. Notar que essa funo no
interativa ou seja, o controle de execuo somente volta para a aplicao aps o pressionamento da tecla.
42

Verso:
107
Data: 21/11/2012
3.11 Correspondente Bancrio (Pagamento de Contas)
Esta funo permite que o aplicativo de automao aceite o pagamento de contas diversas de acordo
com o contrato firmado entre ele e um Banco Correspondente. O formato de ativao desta
funcionalidade o seguinte:
long CorrespondenteBancarioSiTefInterativo (CupomFiscal, DataFiscal,
Horario, Operador, ParamAdic)
Interface ASCII
CorrespondenteBancarioSiTefInterativoA (Resultado, CupomFiscal,
DataFiscal, Horario, Operador, ParamAdic)
Onde os parmetros possuem a mesma funo j descrita para o Pagamento.

A lgica de funcionamento desta funo a mesma no pagamento de uma compra feita pelo cliente
ou seja, deve-se chamar a funo ContinuaFuncaoSiTefInterativo at que o resultado seja diferente de
10000.
Essa funo, dada a diversidade de produtos ofertados pelos Bancos Correspondentes pode,
inclusive, executar uma operao de TEF para concretizar o pagamento de uma conta.
Notar que os campos de retorno 600 a 604 retornam diversas vezes, uma para cada ttulo ou
convnio pago, no caso de pagamento em lote. O campo 607 indica qual o ndice (seqncia) de
pagamento ao qual se referem os campos 600 a 604 que viro a seguir.
Como j descrito anteriormente, para o Correspondente Bancrio os comprovantes devolvidos nos
campos tipo 121 e 122 devem ser impressos no momento que forem disponibilizados para a automao e
a continuao do processo interativo deve seguir normalmente caso no ocorra erro na impresso ou
interrompida com -1 caso contrrio.
No ParamAdic pode ser passado: {PortaPinPadCB=<porta>}, em que <porta> indica a porta em
que est conectado o pinpad especifico para transaes de Correspondente Bancrio: consulta saldo,
saque e recarga celular Bradesco.
43

Verso:
107
Data: 21/11/2012
3.12 Verificao da integridade de um cdigo em barras
Permite, na coleta manual dos campos presentes em um cdigo em barras, que o aplicativo faa a
validao a medida que os campos esto sendo digitados, de forma a alertar o operador antecipadamente e
permitir que ele corrija o erro. O formato de ativao da rotina o seguinte:
long ValidaCampoCodigoEmBarras (Dados, Tipo)
Interface ASCII
ValidaCampoCodigoEmBarrasA (Resultado, Dados, Tipo)
Parmetro
Resultado
Dados
Tipo
Interface Interface
Descrio
padro
ASCII
Sada,
por valor
conforme descrito a seguir
Entrada,
char *
Varivel Dados coletados at o momento. Cada campo deve
por valor
estar concatenado ao seguinte
Sada,
short *
Fixo 6 Informa o tipo do documento coletado segundo a
por
seguinte codificao:
referncia
-1 Ainda no foi possvel definir o tipo
0 Arrecadao
1 Ttulo
Tipo
Recomendao:
recomendvel que aplicao do terminal, uma vez identificado que o documento ser digitado,
abra campos de coleta simulares aos presentes nos documentos a serem pagos. Para isso ela precisar
identificar se uma Ficha de Compensao/Titulo/Bloqueto ou Ficha de Arrecadao/Tributos. Essa
identificao pode ser feita mediante uma pergunta ao operador ou atravs da rotina aqui descrita.
Se o usurio optar pelo reconhecimento automtico ele deve abrir um campo como se fosse de
Arrecadao e, a cada digito fornecido pelo operador, passar os dgitos j fornecidos para a rotina. Esse
procedimento deve ser feito at o momento que a rotina devolver se o documento em questo um Ttulo
ou Arrecadao. Nesse momento a aplicao no precisa mais chamar a rotina a cada dgito fornecido e
deve, se necessrio, modificar a formatao dos campos para captura.
44

Verso:
107
Data: 21/11/2012
Alm da identificao do tipo do documento a rotina faz a consistncia dos dgitos verificadores,
retornando para aplicao se existe um erro e onde ele est localizado. A aplicao pode chamar a rotina
passando os campos medida que eles forem sendo coletados ou no final da coleta, onde ser feita uma
anlise global do contedo digitado. Se a chamada for durante a digitao, os pontos corretos so:
- Arrecadao: a cada um dos 4 blocos de digitao
- Ttulos: a cada grupo de dois blocos de digitao
No retorno a rotina devolve 0 se tudo estiver correto at o momento, -1 se for um cdigo em barras
no reconhecido ou um nmero de 1 a 4 indicando qual o campo est incorreto ou ainda o valor 5 para
indicar que o nmero como um todo no est correto.
Exemplificamos a seguir como a aplicao do terminal deveria proceder, na forma mais genrica
possvel hoje em dia, para coletar um documento. No exemplo utilizaremos um ttulo e deixaremos a
automao ser informada que esse tipo de documento. O documento que ser utilizado o seguinte:
23790.09505.91211.369656.04025.039209.1.17690000005625
Campo aberto pela automao
2
Aps a digitao do primeiro nmero chama a rotina passando 2 como parmetro. No retorno a
rotina devolveu o resultado 0 e Tipo = 0 (fictcio pois nesse momento, para a configurao atual de
cdigos em barra, ela j teria feito a identificao)
23
Aps a digitao do primeiro nmero chama a rotina passando 23 como parmetro. No retorno a
rotina devolveu o resultado 0 e Tipo = 1
23790
09505
A automao reapresenta os campos j sabendo que um ttulo. Somente aps a digitao do
primeiro grupo de nmeros ela chama a rotina passando 2379009505 como parmetro. No retorno a
rotina continua a devolver Tipo = 1. J o resultado poder ser 0, indicando que o bloco est correto ou 1
indicando que ele est errado.
23790
09505
91211
369656
A automao continua a coletar os dgitos e somente aps a digitao do segundo grupo de nmeros
ela chama a rotina passando 237900950591211369656 como parmetro. No retorno a rotina continua a
devolver Tipo = 1. J o resultado poder ser 0, indicando que os blocos esto corretos ou 1 ou 2 indicando
que o primeiro ou o segundo bloco est errado..
45

Verso:
107
Data: 21/11/2012
23790
09505
91211
369656
04025
039209
1 17690000005625
A automao continua a coletar os dgitos chamando a rotina no final do terceiro bloco com os
dados 237900950591211369656 e no final do quarto bloco com todos os dados digitados. No retorno a
rotina continua a devolver Tipo = 1 e o resultado refletir a situao de erro ou no dos blocos passados
como parmetro. Em particular, se retornar o cdigo 5 porque existe algum dos blocos (no possvel
identificar qual deles) com erro.
Finalizando, a automao tambm pode para efeito de consistncia do cdigo em barras optar por
conferi-los apenas no final da digitao de todos os campos. Nesse caso, a rotina devolver 1, 2, 3 ou 4
nessa ordem de prioridade caso encontre um ou mais blocos com erro e 5 na situao dos blocos internos
estarem certos mas o nmero como um todo possui algum erro.
46

Verso:
107
Data: 21/11/2012
3.13 Verificao da quantidade de transaes pendentes de confirmao no terminal
Esta funo utilizada pelo terminal para saber quantas transaes foram realizadas em caso de
queda de energia.
int ObtemQuantidadeTransacoesPendentes (DataFiscal, CupomFiscal)
Interface ASCII
ObtemQuantidadeTransacoesPendentesA (Resultado, DataFiscal, CupomFiscal)
Parmetro
Resultado
DataFiscal
CupomFiscal
Tipo
Sada,
por valor
Entrada,
por valor
Entrada,
por valor
Interface Interface
Descrio
padro
ASCII
char *
char *
Fixo 8
O retorno da rotina a quantidade de transaes pendentes para o cupom fiscal.

3.14 Obtendo Verso
Esta funo utilizada pelo terminal para obter as verses da CliSiTef e CliSiTefI.
int ObtemVersao (VersaoCliSiTef, VersaoCliSiTefI)
Interface ASCII
ObtemVersaoA (Resultado, VersaoCliSiTef, VersaoCliSiTefI)
Parmetro
Resultado
VersaoCliSiTef
VersaoCliSiTefI
Tipo
Sada,
por valor
Sada,
por valor
Sada,
por valor
Interface Interface
Descrio
padro
ASCII
No usado Fixo 6 Contm o resultado de resposta chamada da
rotina
char *
Mx. 64 No retorno contm a verso da CliSiTef
char *
Mx. 64 No retorno contm, caso exista, a verso da

CliSiTefI
No retorno a rotina devolve 0 quando foi executada com sucesso e diferente no caso de erro.
47

Verso:
107
Data: 21/11/2012
3.15 Descarregando Mensagens
Esta funo utilizada pelo terminal para forar a biblioteca a descarregar mensagens de
confirmao, no confirmao e desfazimento.
int DescarregaMensagens (void)
No retorno a rotina devolve 0 se conseguiu descarregar todas as mensagens e diferente de zero caso
ocorra algum erro impossibilitando o envio das mesmas.
48

Verso:
107
Data: 21/11/2012
5. Arquivo de configuraes CliSiTef.ini ou CLSIT

A CliSiTef utiliza um arquivo no formato .ini, de modo a definir previamente determinadas
configuraes na estao.
Este arquivo se chama CliSiTef.ini, e deve ser colocado na mesma pasta da biblioteca CliSiTef.
Em equipamentos POS, o arquivo de configurao utilizado CLSIT. Ao longo deste documento,
todas as menes para CliSiTef.ini devem ser entendidas como CLSIT quando se tratar de POS.
A seguir descreveremos algumas funcionalidades macro presentes neste arquivo.
5.1 Configurao do PinPad
5.1.1 Configurao da porta

A porta serial/usb do PinPad configurada na seo PinPadCompartilhado, campo Porta.
[PinPadCompartilhado]
Porta=<PORT>
No Windows, deve-se usar o formato COMn, onde n o nmero da porta serial/usb. Por exemplo:
COM12
No Linux, deve-se indicar o caminho completo do device. Por exemplo: /dev/ttyS1 ou
/dev/ttyACM0
Observao: outros parmetros, como velocidade (BAUD), bits de dados, paridade e bit de parada
no so configurveis.
5.1.2 Definio da mensagem padro
possvel inicializar o PinPad com uma mensagem de at 16 caracteres.
Esta mensagem configurada na seo PinPad, campo MensagemPadrao.
[PinPad]
MensagemPadrao=<MENSAGEM>
possvel quebrar em duas linhas, utilizando o separador |.
49

Verso:
107
Data: 21/11/2012
5.2 Configurao de conexo com o servidor SiTef
5.2.1 Configurao de endereos IP adicionais

No arquivo de configurao possvel adicionar endereos alternativos para o SITEF. Estes
endereos so complementares ao informado na funo de configurao. So permitidos no mximo dois
endereos adicionais.
[SiTef]
EnderecoIP=IP1;IP2
Tambm possvel informar a porta do servidor, no formato IP:Porta.

Por exemplo:
EnderecoIP=127.0.0.1:4096;192.168.0.1:5096
5.2.2 Configurao da porta do servidor SiTef
Em raras situaes, pode ser necessrio alterar a porta de comunicao com o servidor SiTef. Por
exemplo, alguma restrio de segurana na rede do cliente.
A porta padro do servidor SiTef 4096. Para especificar uma nova porta, deve-se incluir na seo
SiTef o campo PortaSiTef.
[SiTef]
PortaSiTef=<porta>
50

Verso:
107
Data: 21/11/2012
6. Restrio ou habilitao das formas de pagamento

6.1 Restrio durante o processo de finalizao de uma venda
A biblioteca CliSiTef permite que o aplicativo de automao restrinja as modalidades de pagamento

disponveis ao operador de caixa/cliente para uma determinada venda. Isso feito atravs do
parmetro ParamAdic presente nas funes que inicial o processo de pagamento ou
Correspondente Bancrio (IniciaFuncaoSiTefInterativo e CorrespondenteBancarioSiTefInterativo).
O formato desse campo o seguinte:
[<Tipo do meio de pagamento>;<Tipo do meio de pagamento>;...];
onde cada um dos sub-campos contm um cdigo numrico que identifica o item de menu que no
se aplica venda em questo. Por exemplo, se durante o processo de venda j foi negociado com o
cliente que uma venda para pagamento nica e exclusivamente com carto a vista, o valor do
parmetro deve ser:
[10;17;18;19;27;28;34;35;];
Consulte a Tabela de cdigos de meios de pagamento, configuraes e menus para a lista de

cdigos nesta configurao.
6.2 Restrio de forma definitiva
Neste caso o ambiente de vendas do cliente no comporta determinado tipo de modalidade de

pagamento por no se aplicar ao seu ramo de negcio. Um exemplo disso um estabelecimento
comercial onde todas as vendas somente podem ser feitas vista. Para esse tipo de aplicao
possvel definir essa configurao no arquivo de parmetros da CliSiTef de forma que, caso o lojista
opte no futuro a aceitar outras modalidades de pagamento, basta alterar a configurao da CliSiTef,
sem ser necessrio alterar o aplicativo de automao. Essa configurao feita atravs do parmetro
TransacoesHabilitadas a ser colocado na seo [Geral] do arquivo CliSiTef.ini. O formato desse
parmetro o seguinte:
[Geral]
TransacoesHabilitadas=<Tipo do meio de pagamento>;<Tipo do meio de
pagamento>;...
onde cada um dos sub-campos possui a mesma descrio do item anterior.

Utilizando o mesmo exemplo do item anterior, para limitar as transaes apenas as de pagamento
vista e sem cheque, a definio ser:
[Geral]
TransacoesHabilitadas=16;26
51

Verso:
107
Data: 21/11/2012
6.3 Habilitao de transaes adicionais
Por questes de compatibilidade com verses anteriores da biblioteca e tambm pelo fato de
algumas funcionalidades da mesma no serem de uso geral, existem algumas formas de pagamento que
no esto habilitadas por padro, sendo necessrio que o cliente informe explicitamente que deseja
utiliz-las. Isso feito atravs do arquivo de configurao CliSiTef.ini pelo parmetro
TransacoesAdicionaisHabilitadas a ser includo na seo [Geral]. O formato desse parmetro o
seguinte:
[Geral]
TransacoesAdicionaisHabilitadas=<Tipo do meio de pagamento>;...
Onde cada um dos sub-campos possui a mesma descrio dos itens anteriores.
Os menus que hoje no esto habilitados por padro so os seguintes:
Carto Refeio Eletrnico
Recarga de celular com cartes de dbito ou crdito
Pagamento de Benefcios e respectivo estorno
Leitora SmartNet para cartes SmartVR e Sodexho com chip
Correspondente Bancrio
Paggo
Dbito Digitado
Extrato CB
Consulta Saldo CB
Saque e estorno de saque CB
Depsito e estorno de depsito CB
Recarga de Celular Bradesco
Recarga de Celular HSBC
Extrato CB
Pagamento e Estorno de DARF
Pagamento e Estorno de GPS
Emprstimo Pr-Aprovado
Abertura de Conta
Troco Premiado (Surpresa)
Vale Gs
Opo Administrativa Redecard
52

Verso:
107
Data: 21/11/2012
Carto Combustvel
Carto Presente
Exemplificando, para habilitar o menu de pagamento com carto Refeio Eletrnico deve-se
incluir a seguinte configurao em CliSiTef.ini:
[Geral]
TransacoesAdicionaisHabilitadas=20
6.4 Desabilitando transaes
De forma anloga s transaes adicionais habilitadas do item anterior, possvel desabilitar

algumas transaes sem a necessidade de especificar todo o intervalo de operaes como nas restries.
Para tanto, inclua na seo Geral o campo TransacoesDesabilitadas, indicando as transaes que
sero desabilitadas ao longo do fluxo transacional.
[Geral]
TransacoesDesabilitadas=<Tipo do meio de pagamento>;...

6.5 Habilitao de transaes de redes especficas
Existem algumas redes que, por no serem de uso generalizado, no esto automaticamente
habilitadas na CliSiTef. Neste caso, para habilit-las, existe a seo [Redes] no arquivo de configurao
CliSiTef.ini e que deve conter o nome da varivel correspondente a rede a ser habilitada com o valor 1.
Caso o estabelecimento trabalhe com mais de uma rede das descritas a seguir, deve ser includa uma linha
para cada rede.
[Redes]
HabilitaRedexxxx=1
Onde xxxx pode ser, na presente verso da CliSiTef, um dos seguintes valores abaixo.
Note que possvel habilitar tantas redes quanto necessrio, desde que elas estejam habilitadas no
SiTef de forma compatvel.
Rede
Accor
ACSP
Algorix
Avista
BancoIbi
BancoMercantil
53

Verso:
107
Data: 21/11/2012
BancoPanamericano
BancoProvincial
BOD
CdlPoa
CdlRio
CentralCard
CheckCheck
Citibank
ClubCard
Cisa
CompreMax
Condor
ConsorcioVenezuela
ConsultaValePapel
CooperCred
Ediguay
Eletrozema
EMS
Fidelize
Formosa
FoxWinCards
ICards
InfoCard
MAR
Neus
Oboe
Omnion
Orbitall
Parati
Platco
PortalCard
Qualicard
SasNT
SigaCred
SisCred
Softway
SpcBrasil
SQCF
Starfiche
Sysdata
Telecheque
Teledata
Total
UpSight
UseCred
54

Verso:
107
Data: 21/11/2012
Validata
Wappa
Tricard
TopCard
55

Verso:
107
Data: 21/11/2012
6.6 Tabela de cdigos de meios de pagamento, configuraes e menus
A seguir est a tabela que relaciona os tipos de meio de pagamento, configuraes e menus, com os
respectivos cdigos, para serem utilizados nos itens anteriores.
Tipo do meio de pagamento
Consulta ou garantia de Cheque (todos os tipos)
Consulta Cheque Serasa/Associao Comercial
Consulta Cheque Tecban
Telecheque Garantido Tecban
Garantia Cheque Papel Tecban
Carto de dbito (todas as combinaes) (Descontinuado, no usar)
Carto de dbito a vista
Carto de dbito pr-datado
Carto de dbito parcelado
Carto de dbito CDC
Carto Refeio Eletrnico (Exceto Visanet, neste caso usar 3014)
Voucher Papel
Carto Benefcio
Carto SmartVR/Sodexho com leitora SmartNet
Carto de crdito a vista com juros
Carto de crdito (todas as combinaes) (Descontinuado, no usar)
Carto de crdito a vista
Carto de crdito parcelado com financiamento do estabelecimento
Carto de crdito parcelado com financiamento da administradora
Carto de crdito digitado
Carto de crdito magntico
Pr-autorizao
Carto Fininvest
Saque com carto Fininvest
Carto de Crdito Pr-rata a vista
Carto de Crdito Pr-rata parcelada
Consulta parcelas no Carto de Crdito
Crdito Cisa
Saldo/Extrato Cisa
Carto Crdito Infocard
Cancelamento de transao com carto de crdito ou dbito
Consulta AVS
Dbito Digitado
Dbito Magntico
Crdito Parcelado
Private Label Pr-Datado
Pagamento Dinheiro
Pagamento Private Label com Cheque
Paggo
Garantia Cheque CDL Rio
Pagamento de Conta
Cdigo
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
56

Estorno de pagamento de conta
Re-impresso de pagamento de conta
Pagamento de Benefcio
Estorno do Pagamento de Benefcio
Tratamento de troco no pagamento de contas com dinheiro
Reimpresso
Reimpresso do ltimo Comprovante
Reimpresso Especfica
Recarga de celular com Dinheiro
Recarga de celular com Cheque
Recarga de celular com carto de dbito a vista
Recarga de celular com carto de crdito a vista
Indica o Menu para seleo da operadora de recarga
Reimpresso do lojista
Reimpresso do portador do carto
Todas as reimpresses
Crdito Centralizado
Consulta de Saldo - Corresponde Bancrio
Saque - Corresponde Bancrio
Estorno de Saque - Corresponde Bancrio
Depsito - Corresponde Bancrio
Estorno de Depsito - Corresponde Bancrio
Conta Corrente
Conta Poupana
Conta Benefcio
Conta Salrio
Conta Empresa
Conta Investimento
Conta Funcionrio Viajante
Consulta de Saldo com Carto Magntico - Corresponde Bancrio
Consulta de Saldo com Digitao dos Dados da Conta - CB
Saque de Benefcio INSS - Corresponde Bancrio
Saque com Carto Magntico - Corresponde Bancrio
Saque com Cheque - Corresponde Bancrio
Saque com Recibo de Retirada - Corresponde Bancrio
Estorno de Saque de Benefcio INSS - Corresponde Bancrio
Estorno de Saque com Cheque - Corresponde Bancrio
Estorno de Saque com Recibo de Retirada - Corresponde Bancrio
Estorno de Depsito com Dinheiro - Corresponde Bancrio
Estorno de Depsito com Cheque - Corresponde Bancrio
Estorno de Depsito com Dinheiro + Cheque CB
Consulta Cheque SPC Brasil
Garantia Cheque SPC Brasil
Tipo Conta: FAL
Tipo Conta: Pontos
SCCard
Consulta Saldo Dbito
Consulta Saldo Crdito
Verso:
107
Data: 21/11/2012
51
52
53
54
55
56
57
58
60
61
62
63
64
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
3000
3001
3002
3003
3004
57

Recarga de Celular Bradesco
Reimpresso Especfica Redecard
Reimpresso Especfica Visanet
Troco Surpresa (Premiado)
Pagamento em dinheiro
Pagamento CB em cheque
Pagamento com TEF Dbito
Pagamento com TEF Crdito
Pagamento em outra forma
Vale refeio e alimentao Visanet
ValeGs
ValeGs Ultragaz
ValeGs GetNet
Pagamento de Conta Orbitall
Estorno de pagamento de Conta Orbitall
Carto Combustvel
Carto Combustvel Digitado
Carto Combustvel Magntico
Carto Dbito Pr-Pago
Consulta Saldo Carto Dbito Pr-Pago
Carto Crdito Cdigo em Barras
Carto Presente
Opo Administrativa Redecard
Carto Presente Magntico
Carto Presente Digitado
Carto Presente Cdigo em Barras
Opo Compra e Saque Redecard
Pagamento de Fatura
Pagamento de Convnio
Saque Banco IBI
Estorno de Saque Banco IBI
Pagamento de Fatura Banco IBI
Estorno de Pagamento de Fatura Banco IBI
Saldo SPTrans
Recarga SPTrans
Garantia Cheque Infocard
Estorno Garantia Cheque Infocard
Garantia Cheque CDL-Poa
Extrato
Extrato Magntico
Extrato Digitado
Recarga HSBC
Saque Crdito
Estorno de Saque Crdito
Consultas de Carto de Crdito
Extrato Carto de Crdito
Saldo Convnio Crdito
Consulta Liberao de Carto Crdito
Verso:
107
Data: 21/11/2012
3005
3006
3007
3008
3009
3010
3011
3012
3013
3014
3015
3016
3017
3018
3019
3020
3021
3022
3023
3024
3025
3026
3027
3028
3029
3030
3031
3032
3033
3034
3035
3036
3037
3038
3039
3040
3041
3042
3043
3044
3045
3046
3047
3048
3049
3050
3051
3052
58

Consulta ltima Fatura de Carto Crdito
Altera Senha de Carto Crdito
Libera Carto de Crdito
Produtos SPTrans
DARF
GPS
DARF Simples
DARF Preto
Estorno DARF
Estorno GPS
Emprstimo Pr-Aprovado
Emprstimo Pr-Aprovado Magntico
Emprstimo Pr-Aprovado Digitado
Abertura de Conta
Conta Individual
Conta Conjunta E / OU
Conta Conjunta E (Solidria)
Pagamento de Conta Infocard
Estorno de Pagamento de Conta Infocard
Pagamento de Conta Banrisul
Pagamento de Conta Central Card
Pagamento de Conta Portal Card
Pagamento de Conta Softway
Pagamento de Conta Parati
Pagamento de Conta Ediguay
Pagamento de Conta CooperCred
Pagamento de Conta Validata
Pagamento de Conta Panamericano
Pagamento de Conta SigaCred
Pagamento de Conta UseCred
Pagamento de Conta SisCred
Pagamento de Conta Fininvest (Menu principal)
Estorno de Pagamento de Conta Banrisul
Estorno de Pagamento de Conta Fininvest
Estorno de Pagamento de Conta Central Card
Estorno de Pagamento de Conta Portal Card
Estorno de Pagamento de Conta Softway
Estorno de Pagamento de Conta Ediguay
Estorno de Pagamento de Conta CooperCred
Estorno de Pagamento de Conta Panamericano
Estorno de Pagamento de Conta SigaCred
Estorno de Pagamento de Conta UseCred
Estorno de Pagamento de Conta SisCred
Repasse CB
Administrativo CB
Administrativo CB Banrisul
Pagamento de Conta Carto EMS
Estorno de Pagamento de Conta Carto EMS
Verso:
107
Data: 21/11/2012
3053
3054
3055
3056
3057
3058
3059
3060
3061
3062
3063
3064
3065
3066
3067
3068
3069
3070
3071
3072
3073
3074
3075
3076
3077
3078
3079
3080
3081
3082
3083
3084
3085
3086
3087
3088
3089
3090
3091
3092
3093
3094
3095
3096
3097
3098
3099
3100
59

Cdigo Resumido EMS
Cdigo de Barras do Carn
Digitao do Dados do Carn
Menu de Consultas EMS
Consulta Rpida EMS
Consulta Extrato EMS
Consulta Milhas EMS
Consulta Mini-Extrato EMS
Registro de Ocorrncia EMS
Registro de Cancelamento de Ocorrncia EMS
Incluso de Cliente EMS
Alterao de Dados Cadastrais Cliente EMS
Consulta Dados Cadastrais Cliente EMS
Transao EMS por Carto Magntico
Transao EMS por Digitao do Carto
Transao EMS por Digitao do CPF
Extrato EMS Parcial
Extrato EMS Total
Sexo Masculino
Sexo Feminino
Menus de Vendas EMS
Venda Carto EMS
Venda EMS Outros Meio de Pagamento
Venda EMS A Vista
Venda EMS Parcelada Sem Juros
Venda EMS Parcelada Com Juros
Venda Normal EMS
Venda Forada EMS
Compra EMS Vinculada a Lista de Presentes
Compra EMS Outros Vnculos
Venda EMS - Dinheiro
Venda EMS - Cheque a Vista
Venda EMS - Cheque Pr
Venda EMS Carto de Dbito
Venda EMS Carto de Crdito
Venda EMS Ticket
Venda EMS Cheque Administrativo
Venda EMS Traveller Check
Venda EMS Desconto em Folha
Venda EMS Vale
Venda EMS - Milhas
Venda EMS - Debito em folha
Venda EMS Voucher
Venda EMS Carto Presente
Venda EMS Private Label
Venda Rotativo A Vista Fininvest
Venda Rotativo Pr-Datado Fininvest
Venda Parcelado Fininvest
Verso:
107
Data: 21/11/2012
3101
3102
3103
3104
3105
3106
3107
3108
3109
3110
3111
3112
3113
3114
3115
3116
3117
3118
3119
3120
3121
3122
3123
3124
3125
3126
3127
3128
3129
3130
3131
3132
3133
3134
3135
3136
3137
3138
3139
3140
3141
3142
3143
3144
3145
3160
3161
3162
60

Venda Parcelado Pr-Datado Fininvest
Saque Rotativo Fininvest
Saque Parcelado Fininvest
Consulta Saque Fininvest
Saque Fininvest
Boleto Bancrio
Contrato
Pagamento de Conta Fininvest
Pagamento de Fatura Fininvest
Documento Provincial
Documento No Provincial
Com Provimillhas
Sem Provimilhas
Dbito Parcelas Iguais
Consulta Cheque Banco Provincial
Consulta Cheque BOD
Garantia Cheque Banco Mercantil
Consulta Cheque Consorcio Venezuela
Fechamento do Lote Atual Banco Mercantil
Fechamento de Lote Especifico Banco Mercantil
Ajuste de Compra
Ajuste de Compra Dbito
Ajuste de Compra Crdito
Consulta Totais de Compra Banco Provincial
Consulta Totais A Pagar Banco Provincial
Consulta Estado Lote Banco Provincial
Fechamento de Lote Banco Provincial
Fechamento de Lote BOD
Fechamento de Lote Banco Mercantil
Vale Refeio (Exceto Visanet)
Vale Alimentao (Exceto Visanet)
Venda Milhagem CooperCred
Cancelamento de Venda Milhagem CooperCred
Consulta de Saldo Cisa
Consulta de Extrato Cisa
Consulta de Saldo Softway
Saque Softway
Cancelamento de Saque Softway
Carga de Pr-Pago
Cancelamento de Carga de Pr-Cargo
Executa Teste de Comunicao
Transaes de Correspondente Bancrio
Transaes de Recarga de Celular
Transaes SPTrans
SCCard
Provedor Wappa
Abertura de Caixa CB
Fechamento de Caixa CB
Verso:
107
Data: 21/11/2012
3163
3164
3165
3166
3167
3168
3169
3170
3171
3172
3173
3174
3175
3176
3177
3178
3179
3180
3181
3182
3183
3184
3185
3186
3187
3188
3189
3190
3191
3192
3193
3194
3195
3196
3197
3198
3199
3200
3201
3202
3203
3204
3205
3206
3207
3208
3209
3210
61

Sangria de Caixa CB
Menu carto Condor
Opo crdito parcelado simples
Pagamento carto Condor
Estorno pagamento carto Condor
Consulta extrato Condor
Cancelamento Parcele mais
Menu Starfiche
Menu saque CB Banrisul
Pagamento de conta UP SIGHT
Estorno de Pagamento de conta UP SIGHT
Menu opo NTPC
Menu NTPC
Pagamento com saque
Recarga de celular com saque
Troca de Senha Supervisor PinPad
Menu Crdito CDC
Opo conta pessoa jurdica
Pagamento de conta rede MAR
Estorno pagamento de conta rede MAR
Pagamento de conta rede iCards
Estorno de pagamento de conta rede iCards
Menu pagamento de conta Obo
Menu acmulo de pontos Obo
Menu cancelamento acmulo de pontos Obo
Menu venda crdito com autorizao vista
Menu pagamento de conta Qualicard
Menu estorno de pagamento de conta Qualicard
Menu de autorizao genrica SEM
Menu pagamento de conta rede Avista
Menu carto virtual Formosa
Menu pagamento de contas Neus
Menu estorno de pagamento de contas Neus
Menu pagamento de contas Algorix
Menu estorno de pagamento de contas Algorix
Menu carga de carto presente Algorix
Menu de cancelamento de carga de carto presente Algorix
Menu venda crdito CompreMax
Menu cancelamento CompreMax
Menu cancelamento Carto Combustvel
Menu pagamento de contas SysData
Menu estorno de pagamento de contas SysData
Menu consulta de pagamento Validata
Menu pagamento recarga SPTrans (Menu gerencial)
Menu pagamento de conta SQCF
Menu cancelamento de pagamento de conta SQCF
Menu carto Qualidade (ICI Card)
Menu opo Saque Crdito Transferncia
Verso:
107
Data: 21/11/2012
3211
3212
3213
3214
3215
3216
3217
3218
3219
3220
3221
3222
3223
3224
3225
3226
3227
3228
3229
3230
3231
3232
3262
3263
3264
3267
3276
3277
3278
3279
3280
3281
3282
3283
3284
3285
3286
3287
3288
3289
3296
3297
3298
3299
3303
3304
3305
3306
62

Menu saque GetNet
Menu estorno de saque GetNet
Menu conta especial
Menu conta fidelidade
Menu outra conta
Menu fechamento de lote Platco
Menu registro de gorjeta
Menu consulta ltima venda
Menu garantia de cheque Platco
Menu devoluo Platco
Menu pagamento recarga SPTrans (Menu especfico)
Menu Pagamento Conta FoxWin Cards
Menu estorno de Pagamento Conta FoxWin Cards
Menu Pagamento Conta HotCard
Menu estorno de Pagamento Conta HotCard
Menu Adm Gift
Consulta Saldo de Carto Gift
Recarga de Carto Gift
Cancelamento de Recarga de Carto Gift
Venda com Carto Gift
Cancelamento de Venda com Carto Gift
Menu Cancelamento Gift
Tipo de conta FAL
Tipo de conta principal
Menu Emisso de Pontos
Menu Cancelamento de Emisso de Pontos
Menu Resgate de Pontos
Menu Cancelamento de Resgate de Pontos (no usado ainda)
Menu Opco Carto Pr Pago Digitado
Menu Pagamento TriCard
Menu Extrato Por Perodo (CB)
Menu Extrato ltimos Lanamentos (CB)
Menu Extrato ltimos Dias (CB)
Menu Desbloqueio de Cheques (CB)
Menu Opo de Pagamento c/ carto de Dbito CB
Menu de Transferncia de Contas CB
Menu Revalidao de Senha INSS CB
Menu Depsito Identificado CB
Menu Nome do Depositante (Depsito Identificado CB)
Menu Cdigo do Depositante (Depsito Identificado CB)
Menu Carto de Pagamento (Depsito Identificado CB)
Menu Pagamento de Fatura (Depsito Identificado CB)
Menu opo de Pagamento c/ carto Digitado (CB)
Menu opo de Pagamento c/ carto Magntico (CB)
Menu opo Pagamento de Fatura Digitado (CB)
Menu opo Pagamento de Fatura Magntico (CB)
Menu Pagamento de Fatura genrico
Menu opo Pr Autorizao Carto Combustvel
Verso:
107
Data: 21/11/2012
3319
3320
3324
3325
3326
3327
3328
3329
3330
3331
3334
3335
3336
3337
3338
3339
3340
3341
3342
3343
3344
3345
3346
3347
3348
3349
3350
3351
3352
3353
3363
3364
3365
3366
3367
3368
3369
3370
3371
3372
3373
3374
3375
3376
3377
3378
3379
3389
63

Menu Ativao Gift
Menu Pagamento Dinheiro Ativao Gift
Menu Pagamento Cheque Ativao Gift
Menu Pagamento Carto Dbito Ativao Gift
Menu Pagamento Carto Crdito Ativao Gift
Menu Pagamento ClubCard
Menu Estorno Pagamento ClubCard
Menu Pagamento Citibank
Menu opo Carto Porto Seguro Auto Magntico
Menu opo Carto Porto Seguro Auto Digitado
Menu Saque ClubCard
Menu Pagamento CredMais
Menu Consulta parcelas crdito
Menu Estorno Pagto. Contas Banco Ibi
Menu Cartao Eletrozema
Menu Cancelamento Cartao Eletrozema
Menu Consulta Eletrozema
Menu Cancelamento de Pagamento de Fatura genrico
Menu formas de pagamento para pagamento de carto Siscred
Verso:
107
Data: 21/11/2012
3390
3391
3392
3393
3394
3407
3408
3409
3410
3411
3412
3466
3480
3500
3510
3511
3512
3515
3530
64

Verso:
107
Data: 21/11/2012
6.7 Habilitao de configuraes especiais por transao
Em determinadas transaes, possvel incluir novas funcionalidades e caractersticas ao fluxo

transacional, permitindo maior flexibilidade de operao sem que estas funcionalidades no estejam
vinculadas a um meio de pagamento especfico.
Para tanto, basta acrescentar um novo campo ao parmetro ParamAdic, presente nas funes que
iniciam o processo de pagamento ou Correspondente Bancrio (IniciaFuncaoSiTefInterativo e
CorrespondenteBancarioSiTefInterativo). O formato deste campo o seguinte:
{<Funcionalidade1>;<Funcionalidade2>;...;<Funcionalidaden>;};
Note que neste formato as funcionalidades esto entre chaves ({ e }), ao passo que as restries
esto entre colchetes ([ e ]).
Exemplo: no processo de venda exemplificado no item 5.1, suponha que o valor da venda possa ser
alterado durante o fluxo, e que o aplicativo da automao deseje fazer seu tratamento, ento o valor do
parmetro ParamAdic deve ser:
[10;17;18;19;27;28;34;35;];{TrataPagamentoExtendido=1;}
A seguir, descrevemos as funcionalidades previstas neste campo.

Funcionalidade
CodigoCliente= xxx.xxx
ExecutaAteLeituraCartao=0
HabilitaVendaViaCodigoBarras=1
ItemMenuIdentificado=1
{MKRede=A,B,C,D}
OBS: Esta configurao deve ser
passada entre chaves ({})
separadamente, ou seja, no deve
Descrio
O contedo deste campo ser acrescentando ao campo
administrativo do SITEF e constar em relatrios do SITEFWEB.
Se um arquivo .CHA estiver presente no servidor Sitef, ento, a
CliSiTef se comporta da seguinte maneira: Se a CliSiTef estiver
sem comunicao com o Sitef, ao invs de retornar um erro de
comunicao, a CliSiTef continua o fluxo da transao at a leitura
do carto. Para inibir este comportamento, utilizar a funcionalidade
ao lado.
Este parmetro informa a CliSiTef que a opo de venda crdito
atravs de cartes gravados em cdigo em barras deve ser habilitada
na transao corrente. Lembrando que alm dessa configurao a
opo de menu (3025) tambm deve estar habilitada.
O aplicativo de automao informa a CliSiTef que ele est
preparado para tratar o comando de menu com itens identificados
(comando 42).
Quando esse parmetro est habilitado a CliSiTef substitui a
utilizao do comando 21 pelo comando 42, na maior parte dos
menus utilizados na navegao.
Configurao vlida somente para CliSiTef Reduzida Redecard. Os
parmetros A,B,C,D so ndices das chaves de criptografia
Redecard nos POSs. Esses parmetros iro sobrepor os ndices das
chaves recebidos no servio 3. Os parmetros C e D sero
implementados somente a partir da verso (4.0.104.1, a confirmar).
65

Verso:
107
Data: 21/11/2012
ser concatenada com nenhuma Se alguma chave no for configurada preciso passar o parmetro
outra configurao separada por com valor -1. Exemplo: {MKRede=-1,-1,-1,2} vai configurar
ponto-e-vrgula (;)
somente a chave relativa criptografia DUKPT 3DES.
A = ndice da master key DES
B = ndice da master key 3DES
C = ndice do registro de tratamento DUKPT DES
D = ndice do registro de tratamento DUKPT 3DES
{MKRedeDados=A,B,C,D}
Igual a MKRede (Ver descrio acima), exceto que as chaves de
criptografia sero usadas para criptografar trilhas.
OBS: Esta configurao deve ser
passada entre chaves ({})
separadamente, ou seja, no deve
ser concatenada com nenhuma
outra configurao separada por
ponto-e-vrgula (;)
NumCartaoCripto=<Carto
A entrega do campo adicional NumCartaoCripto, com o carto
criptografado>
criptografado, desabilita a captura do nmero do carto digitado. O
campo NumCartaoCripto recebido com sucesso se o SiTef, com
o qual a CliSiTef est conectada, responder os servios Q13 e Q14
com a chaves de criptografia devidamente configuradas.
RedeDestino=nnnn
Esta configurao permite forar que a transao seja realizada por
uma rede especfica (nnnn = 4 dgitos numricos).
TrataConsultaSaqueComSaque=1 Inicialmente projetada para transaes do Banco Ibi, este parmetro
permite vincular, em uma nica transao, a Consulta a Saque e
Saque.
Caso seja passado este parmetro, o menu administrativo oferecer
somente a opo Consulta Saque com Saque.
TrataPagamentoExtendido=1
Esta funo informa que o aplicativo da automao est preparado
para tratar informaes de recebimento a menor (falta saldo a ser
recebido com outra forma de pagamento) ou a maior (deve ser
devolvido um troco para o cliente).
Esta funo tambm habilita o recebimento dos campos 137 (Saldo
a ser pago) e 138 (Valor efetivamente recebido).
ValidadeCartao=<AAMM ou
A entrega do campo adicional ValidadeCartao, com a data de
MMAA>
validade do carto, desabilita a sua captura, porm a utilizao do
valor passado atravs do parmetro adicional condicionada
passagem bem sucedida do campo NumCartaoCripto.
ValorIncluiTaxa=1
Este parmetro informa que o aplicativo da automao incluiu no
valor compra o valor da taxa de embarque ou servio.
Se durante o fluxo de captura for solicitada a taxa, o valor que foi
acrescentado venda deve ser repassado pela automao.
66

7.
Verso:
107
Data: 21/11/2012
Arquivos de controle
A CliSiTef permite configurar o diretrio onde sero gerados os seus arquivos de controle. Essa
configurao deve ser feita pelo item DiretorioBase da seo SalvaEstado no arquivo CliSiTef.ini.
No Windows, a pasta padro utilizada C:\CliSiTef\ChavesCliSiTef.
No Linux, a pasta padro /tmp/ChavesCliSiTef.
[SalvaEstado]
DiretorioBase=<DIRETORIO>
Exemplo Windows:
[SalvaEstado]
DiretorioBase=C:\Chaves
Exemplo Linux:
[SalvaEstado]
DiretorioBase =/home/usuario/chaves
67

8.
Verso:
107
Data: 21/11/2012
Trace
A CliSiTef normalmente grava informaes em um nico arquivo dirio, com mecanismo de

rotao de logs. Ou seja, arquivos mais antigos so removidos automaticamente.
No Windows, o arquivo gravado no padro C:\CliSiTef\CliSiTef.<AAAAMMDD>.dmp.
No Linux, o arquivo gravado na pasta local, no padro CliSiTef.<AAAAMMDD>.dmp.
Em equipamentos POS, o arquivo gravado na pasta local, no padro TRACE.
8.1 Configurao do perodo que o trace mantido
No arquivo de configurao CliSiTef.ini, possvel configurar o nmero de dias durante os quais

o trace ser mantido. Por padro o trace fica habilitado por cinco dias.
[GERAL]
NumeroDeDiasNoLog=n
onde n o nmero de dias. Zero grava indefinidamente.

8.2 Configurao de diretrio
No Windows, a pasta padro para gravao dos arquivos de trace C:\CliSiTef.

No Linux, usada a pasta corrente.
A CliSiTef permite configurar os diretrios onde sero gerados os seus arquivos de trace. Para
tanto, altere o arquivo CliSiTef.ini conforme mostrado abaixo:
[CliSiTef]
DiretorioTrace=<DIRETORIO>
Exemplo Windows:
[CliSiTef]
DiretorioTrace=C:\Trace
Exemplo Linux:
[CliSiTef]
DiretorioTrace=/home/usuario/trace
68

Verso:
107
Data: 21/11/2012
8.3 Arquivos de trace por terminal
Para facilitar algumas anlises, possvel configurar a CliSiTef para gerar arquivos de trace por
terminal (parmetro IdTerminal da funo ConfiguraIntSiTefInterativo).
Alm da gerao de traces por terminal, tambm possvel alterar a gerao do arquivos de trace do
modo dirio para o modo por hora, em que so gerados diversos arquivos de trace fragmentados por hora.
Ao habilitar o modo multi-terminal da CliSiTef, a gerao de traces automaticamente alterada
para o modo por terminal. Para maiores informaes sobre o modo multi-terminal, consulte o documento
especfico CliSiTef - Configurao Multi-terminal.doc.
Caso no esteja configurada no modo multi-terminal e ainda assim queira habilitar a gerao de
traces por terminal, basta adicionar o item TracePorTerminal na seo CliSiTef do arquivo CliSiTef.ini.
[CliSiTef]
TracePorTerminal=1
Para habilitar a gerao de traces por hora deve ser adicionada a seguinte configurao ao arquivo
CliSitef.ini:
[CliSiTef]
TracePorHora=1
69

9.
Verso:
107
Data: 21/11/2012
Processo de desenvolvimento/homologao
9.1 Arquivo de trace adicional durante a fase de desenvolvimento
A CliSiTefI possui um mecanismo de auxilio ao desenvolvedor da aplicao que interage com ela
de forma a simplificar a busca por problemas durante a fase de desenvolvimento. Esse mecanismo, uma
vez habilitado, faz com que seja gerado um arquivo de trace contendo os parmetros trocados entre a
CliSiTef e a aplicao. O arquivo fica localizado no diretrio corrente ou em C:\CliSiTef, dependendo se
o ambiente for Linux ou Windows, respectivamente. O nome do arquivo CliSiTef.AAAAMMDD.txt.
Para habilitar essa caracterstica, inclua o seguinte parmetro no arquivo de configurao
CliSiTef.ini:
[Geral]
DataEmAmbienteDeDesenvolvimento=AAAAMMDD
Onde AAAAMMDD corresponde ao dia que o teste em laboratrio est sendo feito.
Em ambiente de produo essa configurao NO DEVE EXISTIR, sendo que a anlise de

problemas nesse ambiente dever ser feita pela Software Express pela ativao de traces internos da
CliSiTef, atravs de configuraes passadas pelo Suporte. Essa opo habilita, automaticamente, a opo
a seguir.
9.2 Processo de homologao
Como descrito anteriormente, o fluxo descrito neste documento deve ser seguido a risca para que
no ocorram erros estranhos durante a execuo da CliSiTef. Para tanto, existe um parmetro
configurvel que ser utilizado pelos homologadores da Software Express para confirmar que o aplicativo
de automao somente concretiza o processo de venda pela impresso de um comprovante ou pela
chamada
a
funo
FinalizaTransacaoSiTefInterativo
aps
o
retorno
final
da
ContinuaFuncaoSiTefInterativo. Esse parmetro o seguinte:
[Geral]
EmAmbienteDeHomologacao=1
Por introduzir uma mensagem adicional no processo, ele jamais dever ser utilizado em ambiente
de produo.
70

Verso:
107
Data: 21/11/2012
10. Habilitando confirmao do valor no pinpad

Esta configurao habilita a confirmao do valor da transao no pinpad no caso de transaes sem
coleta de senha pelo pinpad, visto que na coleta de senha j apresentado o valor. At o momento ela s
vlida para transaes de recarga pr-pago e bnus.
Para habilitar esta configurao basta adicionar as seguintes configuraes ao arquivo
CliSiTef.ini:
[Geral]
ConfirmarValorPinPad=1
11. Traduo de mensagens

possvel alterar parte das mensagens enviadas para a automao, para efeitos de traduo ou, em
alguns casos, para reduzir as mensagens.
Para habilitar esta caracterstica, basta incluir na seo TabTraducao da CliSiTef.ini o item
NomeArqTraducao, indicando o nome do arquivo de traduo.
[TabTraducao]
NomeArqTraducao=<Nome do arquivo>
As mensagens devem ficar em um arquivo no formato INI separado, sob a seo TabTraducao.
Um exemplo deste arquivo seria:
[TabTraducao]
MsgNovoValor=Forneca o novo valor do pagamento
MsgEmbosso=Forneca os 4 digitos finais do cartao
MsgCodigoSeguranca=Informe Cod. Seg, ou\n0 = inexistente\n1 = ilegivel
Como a CliSiTef est em constante incluso de mdulos e mensagens, a lista completa de itens de
traduo encontra-se em um documento a parte.
71

Verso:
107
Data: 21/11/2012
12. Tabelas
Cdigo das Redes Autorizadoras
00000
00001
00004
00005
00006
00021
00031
00082
00125
Cdigo da Bandeira
(Carto de Crdito)
00000
00001
00002
00003
00004
00005
00006
00007
00008
00010
00011
00012
00013
00014
00015
Descrio
Outra, no definida
Tecban
Visanet - Especificao 200001
Redecard
Amex
Banrisul
Ticket combustvel
GetNet
Visanet Especificao 4.1
Descrio
Outro, no definido
Visa
Mastercard
Diners
American Express
Sollo
Sidecard (Redecard)
Private Label (Redecard)
Redeshop
Fininvest (Visanet)
JCB
Hipercard
Aura
Losango
Sorocred
13. Rotinas descontinuadas

long LeCartaoInterativo (Mensagem); // Utilize LeCartaoSeguro
LeCartaoInterativoA (Resultado, Mensagem); // Utilize LeCartaoSeguroA
long LeCartaoDireto (Mensagem, Trilha1, Trilha2); // Utilize LeCartaoDiretoSeguro
LeCartaoDiretoA (Resultado, Mensagem, Trilha1, Trilha2); // Utilize LeCartaoDiretoSeguroA
long LeCartaoDiretoEx (Mensagem, Trilha1, Trilha2, Timeout, TestaCancelamento);
// Utilize LeCartaoDiretoSeguro
LeCartaoDiretoExA
LeCartaoDiretoSeguroA
(Resultado,
Mensagem,
Trilha1,
Trilha2,
Timeout);
//
Utilize
72

Data
07/05/2001
07/05/2001
07/05/2001
09/05/2001
13/05/2001
22/05/2001
27/05/2001
04/06/2001
21/08/2001
07/10/2001
21/10/2001
21/10/2001
22/10/2001
08/11/2001
02/01/2002
03/03/2002
14/03/2002
14/03/2002
16/03/2002
16/03/2002
19/03/2002
19/03/2002
03/04/2002
15/04/2002
03/09/2002
Verso:
107
Data: 21/11/2012
Histrico de Alteraes
Descrio
Incluso da coleta de um campo tipo VALOR
Incluso do tipo de campo TROCO para ser tratado pela aplicao
Incluso da rotina FinalizaTransacaoIntSiTefCuponFiscal
Incluso do comando para abortar a execuo do mdulo pelo aplicativo
Incluso de um novo tipo de dado de retorno para indicar o cancelamento
Incluso de novos tipos de dado de retorno para indicar a instituio que tratou a
autorizao e outros dados relativos a mesma
Separao do NSU Host do Cdigo de Autorizao no retorno para a aplicao e
alterao no tamanho dos campos de retorno (111 e 112)
Alterao nos cdigos retornados pela rotina RecebeResultado
Incluso dos comandos necessrios para apresentar e remover um ttulo nos menus (04 e
14)
Incluso de rotinas para acesso por linguagens de programao que no possuem a
caracterstica de Callback
Remoo da rotina FinalizaTransacaoIntSiTef
Separao em duas dlls, uma para as linguagens que possuem Callback e outra para as
demais linguagens de programao.
Mudana de nomenclatura de Dll Conversacional para Interativa
Alterao no nome da rotina de configurao quando em modo interativo
Alterao no formato de captura de cheques para suportar a nova transao do Serasa
(Comando 31)
Alterao no nome das rotinas na interface interativa de forma a evitar confuso e acesso
a rotinas erradas por conflito de nomenclatura entre as DLLs via callback e interativa
Alterao de alguns textos para explicar melhor o funcionamento da rotina ou interface
Incluso do tipo de campo Cdigo do Operador para permitir que a automao, se
desejado, valide este campo antes de pass-lo para a DLL
Incluso da funo para leitura de um carto genrico (p/ex: carto de supervisor)
Incluso da possibilidade da automao comercial definir qual o tipo de transao ser
executada
Alterao na estrutura interna do mdulo para permitir mltiplos pagamentos para um
mesmo cupom fiscal
Melhoria na documentao e incluso dos campos tratveis pela automao na chamada
a ColetaCampo
Trocados os cdigos que correspondem ao TipoCampo Trilha 1 e 2
Includos novos cdigos na coleta de campos de forma que a aplicao possa controlar
mais informaes durante o processo de coleta de campos
Melhoria na documentao
Incluso de mecanismo para a automao informar se o campo foi preenchido de forma
automtica ou no
Incluso da possibilidade de bloqueio de transaes com nmero de carto digitado
Incluso das funes de tratamento do Correspondente Bancrio (pagamento de contas)
Incluso do comando para captura do cdigo em barras do documento a ser pago
Incluso de codificao para os campos do Correspondente Bancrio
Incluso de codificao para o campo Nome do Cedente para ser impresso no cheque de
pagamento do Correspondente Bancrio
Incluso de funo para uso por terminais de auto-atendimento
Incluso de funo para uso por telemarketing/televendas
73

05/09/2002
09/09/2002
19/09/2002
30/09/2002
02/10/2002
02/10/2002
28/10/2002
12/11/2002
27/11/2002
10/12/2002
27/12/2002
03/01/2003
13/01/2003
03/02/2003
V. 0.76e
12/02/2003
V. 0.76h
07/05/2003
V. 0.80
28/05/2003
V. 0.81
10/06/2003
21/07/2003
24/07/2003
29/09/2003
V. 096a
13/10/2003
V. 096j
14/10/2003
Verso:
107
Data: 21/11/2012
Redefinio do campo Modalidade para comportar as funes de Cancelamento e

Telemarketing
Incluso de tipos de campos que possibilitem ao aplicativo de automao reconhecer que
a dll est requisitando dados de uma venda com carto de crdito digitado (p/ ex. quando
ela usada para efetivar um pagamento cujos dados do carto foram armazenados
previamente)
Incluso de tabela definindo formato do campo produtos da funo EfetuaPagamento.
Na funo ContinuaFuncaoSiTefInterativo, o descritivo estava escrito como
ContinuaFuncaoIntSiTef.
Incluso das modalidades para cancelamento via funo EfetuaPagamento e
EfetuaPagamentoAutoAtendimento. Incluso de novos tipos de campo para que a
aplicao trate os dados do cancelamento.
Remoo de todas as referncias ao modo Callback de funcionamento pois ele deixou de
ser disponibilizado nessa biblioteca.
Incluso da interface ASCII para aplicativos que no conseguem tratar campos binrios
Incluso da funo para captura de senha em PinPad com criptografia por hardware
Correo
na
descrio
da
passagem
de
parmetros
da
rotina
Incluso do retorno da data e hora da transao
Criao do novo ponto de entrada para acesso ao SiTef de forma a centralizar todas as
funes de Tef e Gerenciais em uma nica rotina (vide item 3)
Trocado o nome do campo Modalidade para Funcao
Criao da restrio de cancelamento de pr-autorizao.
Incluso da possibilidade da automao passar os campos necessrios para executar a reimpresso Visanet atravs da definio dos tipos de campo 515 e 516
Includo o tipo de campo 517 para identificar a coleta de um cheque ou seja, o comando
em execuo o 31
Includo o tipo de campo 517 para identificar a coleta de um cheque ou seja, o comando
em execuo o 31
Includa uma funo para acesso direto ao PinPad para leitura das trilhas do carto
magntico, funo esta normalmente utilizada para captura do carto do Supervisor
Includa uma funo para que o aplicativo de automao possa interromper a funo
LeCartaoDireto
Includo um novo retorno que indica dados adicionais sobre o carto utilizado para o
pagamento (TipoCampo = 112)
Includo novos cdigos de funo para acesso direto as rotinas de pr-autorizao.
Corrigido o texto referente ao bloqueio da transao de Pr-autorizao
Melhorada a documentao da funo que continua o processo interativo, deixando claro
que um retorno igual a Zero indica sucesso na execuo da solicitao feita pelo terminal
Introduzida a funcionalidade de recarga de pr-pago
Includas as funes para que o aplicativo de automao possa capturar a trilha de forma
direta na interface ASCII e a mesma funcionalidade para captura de senha de clientes de
carto proprietrio atravs das funes LeSenhaDireto e LeSenhaDiretoA
Incluso da configurao que permite habilitar somente as transaes desejadas
Alterao na definio da configurao que permite habilitar somente as transaes
desejadas
Eliminao da dll CliSITef32IA
Incluso de novos cdigos para habilitao ou no de menus da CliSiTef32
74

V. 096k
30/11/2003
V. 097
25/01/2004
V. 097m
06/02/2004
V. 097p
13/02/2004
V. 097s
04/05/2004
V. 098j
24/06/2004
V. 098s
07/07/2004
---------23/07/2004
V. 0.98z8
Verso:
107
Data: 21/11/2012
Alterao na forma de tratamento dos cupons recebidos como retorno das transaes
Gerenciais e Correspondente Bancrio. Incluso de novo exemplo de fluxo de utilizao
da CliSiTefI
Includo o campo 607 e a devoluo do Nsu do Host para o correspondente bancrio
Detalhamento na forma com que a automao pode tratar uma coleta do campo 35
cdigo em barras
Criada a funo ValidaCampoCodigoEmBarras que consiste os campos digitados
isoladamente
Includos novos campos no retorno das transaes de Correspondente Bancario
Includo novo tipo de restrio para a Garantia de Cheque Papel Tecban
Includa a funcionalidade de recarga de celular utilizando carto de dbito ou crdito e
como habilitar tal caracterstica
Includa forma para bloquear via restries os menus do Correspondente Bancrio
Includo na documentao a forma da aplicao solicitar um retorno ao campo anterior
Includa funo para apresentao de mensagem no visor do PinPad e captura de
confirmao ou cancelamento pelo cliente
Includo o menu de pagamento de benefcios do Banco do Brasil
Includo retorno dos campos Valor em dinheiro e troco no caso do correspondente
bancrio
Modificada a nomenclatura do campo Restries para ParametrosAdicionais uma vez
que esta ltima mais condizente com a funcionalidade oferecida por ele
02/08/2004
V. 0.98z8
V. 0.98/nv/4
24/08/2004 Includa as funes que permitem interromper a leitura de um carto proprietrio por
V. 0.99
temporizao ou chamada de rotina externa
03/05/2005 Incluso de um novo cdigo de retorno para a funo ConfiguraIntSiTef.
75

Data
26/08/2004
09/09/2004
09/09/2004
19/11/2004
28/12/2005
04/04/2006
17/08/2006
08/11/2006
15/01/2006
17/08/2007
06/02/2008
18/03/2008
28/03/2008
17/07/2008
01/06/2009
08/06/2009
01/07/2009
23/07/2009
23/07/2009
11/08/2009
12/08/2009
20/08/2009
27/08/2009
14/09/2009
30/09/2009
07/10/2009
Verso:
107
Data: 21/11/2012
Histrico de Alteraes
Descrio
Verses mnimas
CliSiTefI
CliSiTef
0.98.z.8
Corrigida a documentao dos parmetros na funo
0.98.nv.14
LeCartaoDiretoExA
Acerto na numerao das verses mnimas e no texto descritivo das
funes e correo da verso anterior que NO era 0.99
1.00.a.4
Modificada a forma de numerar as verses. Retornou a forma padro
1.00.a.4
V.VV[.release]
Incluida a gerao de trace no criptografado para ser utilizado em
ambiente de desenvolvimento
Incluida as transaes CentralCard e InfoCard
1.00.a.5
Includo os tipos de campo necessrios para tratar a coleta de
1.00.a.20
nmeros de telefone para consulta a cheques
1.00.a.5
Devoluo do cdigo em barras cujo pagamento foi aprovado
1.00.a.42
1.00.a.5
Incluso do TipoCampo 518 e 519 na tabelas de valores para Tipo
1.00.a.5
Campo.
1.00.a.20
Incluso da possibilidade de gerar trace em aberto para auxiliar o
desenvolvimento da interface com a CliSiTef
1.01.a.138
Passou a devolver os NSU do SiTef e do Host Autorizador quando
uma transao de recarga for paga com carto
Passou a devolver o Cdigo da Filial que autorizou a recarga do
celular
????
Incluso de novos campos para tratamento do carto combustvel
(GoodCard e PortalCard).
1.01.c.55
Incluso somente na verso EMV FULL da possibilidade de adio
de IP secundrio no CLISITEF.INI.
A gravao de trace passa a ser habilitada por padro e o perodo de
armazenamento configurvel.
Acrescentados cdigos de redes autorizadoras tabela existente.
1.01.c.080.1
Incluso do campo tipo 1131 e dos menus 3063,3064,3065.
1.01.c.082.1
Descrio de configuraes especiais no parmetro ParamAdic.
1.01.c.082.2
Incluso do campo tipo 1049.
1.01.c.089.1
Incluso de campos para a rede Condor, Starfiche e SEM
1.01.c.094.57
Incluso das configuraes especiais EMS.
Incluso dos campos do pagamento de carto Qualicard.
1.01.c.094.63
Incluso autorizao genrica EMS.
1.01.c.094.71
Incluso da rede Pharma System
1.01.c.094.31
Incluso da rede Obo
1.01.c.94.xx
Incluso da rede Avista
1.01.c.94.xx
Incluso do menu venda crdito com autorizao vista
1.01.c.94.105
Incluso do carto virtual Formosa.
1.01.c.94.109
Incluso do carto Neus.
1.01.c.94.113
Incluso da rede Algorix
1.01.c.94.129
Incluso do PBM Fidelize
1.01.c.94.135
Incluso da rede CompreMax
1.01.c.94.137
Incluso do cancelamento de carto combustvel genrico
76

12/01/2010
27/01/2010
28/01/2010
11/02/2010
14/06/2010
1.01.c.94.191
1.01.c.94.195
1.01.c.94.201
1.01.c.94.207
-
06/07/2010
06/08/2010
21/09/2010
1.01.c.94.254
1.01.c.94.259
1.01.c.94.265
21/10/2010
11/11/2010
1.01.c.95.13
06/12/2010
28/01/2011
18/02/2011
11/05/2011
4.0.102.3.r1
27/05/2011
13/06/2011
4.0.102.6.r1
4.0.102.7.r1
08/07/2011
12/07/2011
01/08/2011
4.0.102.9.r1
4.0.102.10.r1
22/09/2011
25/10/2011
15/12/2011
09/05/2012
14/11/2012
4.0.102.12 r1
4.0.102.12 r14
4.0.104.6 b6
-
Verso:
107
Data: 21/11/2012
Incluso do campo 537 (cdigo de rea da cidade do cheque)

Documentao do campo 2054 para o tipo de CDC Crdito.
Incluso da rede SQCF
Incluso da opo Carto Gridcard
Reservado o Range de 8000 a 9999 para a tabela de Tipo Campos
para a IntPos.dll.
Incluso dos menus de saque/estorno de saque GetNet
Incluso da funo Consulta Saque com Saque Banco IBI
Alterao da identificao dos campos Cdigo Produto Hopi-Hari (de
2049 para 2120), Descrio Produto Hopi-Hari (de 2050 para 2121),
Quantidade Mxima de produtos Hopi-Hari (de 2051 para 2122),
Produtos Hopi-Hari (de 2052 para 2123).
Includo campo 3334 (Pagamento SPTrans) e modalidades 700 e 701
(Oi Paggo)
Incluso do pagamento de fatura/estorno FoxWinCards, menus 3335
e 3336; Incluso da RedeHabilitadaFoxWinCards.
Incluso das funes 702 (Pagamento de contas) e 703
(Cancelamento de Pagamento Carto Benefcio).
Adicionadas descries dos cdigos de erro -43, -50 e -100. Eventos
5011, 5012 e 5013.
Incluso do campo 2301.
Criada tabela de Modalidades, para melhor visualizao.
Incluso dos campos 2125 e 2126 (fatura HotCard).
Incluso dos campos 3337 at 3352.
Incluso das funes(modalidades) Resgate de Pontos (modalidade
665), Emissao Pontos (667), Cancel. Emissao Pontos (668), 669
(Carga de Pr Pago), 670 (Cancel. Carga de Pr Pago) e 680 (Cons.
Saldo Pr Pago)
Parmetro HabilitaRedeTricard
Incluso dos campos 3339 a 3345.
Incluso das funes (modalidades): Venda com Carto Gift
(modalidade 15), Consulta a Saldo Gift (modalidade 152),
Cancelamento de Venda com Carto Gift (modalidade 213),
Cancelamento de Recarga de Carto Gift (modalidade 257) e Recarga
de Carto Gift (modalidade 264).
Incluso do campo 5501.
Corrigido o nome da rede InfoCard nas redes habilitadas.
Incluso da rede TopCard e da transao de Pagamento de Fatura
Genrico (3379)
Incluso do modo 2:(Digitao do CMC-7) na captura do cheque
Incluso dos campos 3407 e 3408; Incluso da Rede ClubCard
Alterao na descrio do campo 178 que estava errada.
Incluso do tipo campo 3409; Incluso da Rede Citibank
Reviso geral do documento; incluso de tipos de parmetro
(entrada/sada e valor/referncia).
77

SiTef - Interface Simplificada Com A Aplicação (VRS-107)

Uploaded by

Document Information

Original Title

Copyright

Available Formats

Share this document

Share or Embed Document

Sharing Options

Did you find this document useful?

Is this content inappropriate?

Copyright:

Available Formats

SiTef - Interface Simplificada Com A Aplicação (VRS-107)

Uploaded by

Copyright:

Available Formats

Especificao Tcnica Interface com os meios de

Este documento possui tecnologia e conhecimento de propriedade da Software Express Informtica

Especificao Tcnica Interface com os meios de pagamento do SiTef

Descrio das interfaces com as rotinas disponveis na CliSiTef

API - Rotinas disponveis na CliSiTef

Arquivo de configuraes CliSiTef.ini ou CLSIT

Restrio ou habilitao das formas de pagamento

Software Express Ltda., 2012

Especificao Tcnica Interface com os meios de pagamento do SiTef

Habilitando confirmao do valor no pinpad

Software Express Ltda., 2012

Especificao Tcnica Interface com os meios de pagamento do SiTef

Bibliotecas CliSiTefI e CliSiTef

Propiciar um meio rpido e simples de disponibilizar as funcionalidades do SiTef para aplicativos

Software Express Ltda., 2012

Especificao Tcnica Interface com os meios de pagamento do SiTef

1.1 Descrio Resumida

Software Express Ltda., 2012

Especificao Tcnica Interface com os meios de pagamento do SiTef

1.2 Fluxo Grfico

Houve devoluo de Cupom TEF pela CliSiTef?

Chamar a funo FinalizaTransacaoSiTefInterativo

Chamar a funo FinalizaTransacaoSiTefInterativo

Software Express Ltda., 2012

Especificao Tcnica Interface com os meios de pagamento do SiTef

Descrio das interfaces com as rotinas disponveis na CliSiTef

2.1 Interface padro

2.2 Interface ASCII

Software Express Ltda., 2012

Especificao Tcnica Interface com os meios de pagamento do SiTef

Software Express Ltda., 2012

Especificao Tcnica Interface com os meios de pagamento do SiTef

API - Rotinas disponveis na CliSiTef

Software Express Ltda., 2012

Especificao Tcnica Interface com os meios de pagamento do SiTef

3.1 Configurao da biblioteca

Varivel Parmetros adicionais de configurao da CliSiTef

Software Express Ltda., 2012

Especificao Tcnica Interface com os meios de pagamento do SiTef

As rotinas devolvem um dos seguintes resultados:

3.1.1 Configuraes especiais gerais

A seguir, descrevemos as funcionalidades previstas neste campo.

Software Express Ltda., 2012

Especificao Tcnica Interface com os meios de pagamento do SiTef

3.2 Incio da transao de Pagamento ou Gerencial

No caso de um terminal de Auto-Atendimento, devem ser usadas as rotinas a seguir.

Seleciona a forma de pagamento, conforme a tabela

Data Fiscal no formato AAAAMMDD

Horrio Fiscal no formato HHMMSS

Mx. 20 Identificao do operador de caixa

Varivel Parmetros adicionais. Permite que o aplicativo

Especificao Tcnica Interface com os meios de pagamento do SiTef

do comprovante da operao de Tef a ser impresso.

Ele deve ser repetido tantas vezes quanto o nmero

3.2.1 Tabela de cdigos de retorno

Software Express Ltda., 2012

Especificao Tcnica Interface com os meios de pagamento do SiTef

3.2.2 Tabela de cdigos de funes

Venda Boleto Carrefour

Abre o menu de transaes Gerenciais

Consultas Carto SEM

Especificao Tcnica Interface com os meios de pagamento do SiTef

Vendas Carto EMS