Você está na página 1de 101

Especificao Tcnica Interface com os meios de

pagamento do SiTef
Bibliotecas CliSiTefI e CliSiTef
Verso 152

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


Bibliotecas CliSiTefI e CliSiTef

Verso:
151
Data: 15/04/2015

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
3.16 Informaes do PinPad
3.17 Carga de Tabelas no PinPad

5
6
7
8
10
11
17
20
23
36
38
39
39
40
41
44
46
47
48
51
51
52
52
54

4.

Arquivo de configuraes CliSiTef.ini ou CLSIT


4.1
Configurao do PinPad
4.1.1 Configurao da porta
4.1.2 Definio da mensagem padro
4.2
Configurao de conexo com o servidor SiTef
4.2.1 Configurao de endereos IP adicionais
4.2.2 Configurao da porta do servidor SiTef
4.2.3 Obrigatoriedade de conexo
4.2.4 Mantendo conexo ativa
4.2.5 Configurao do mostrador de comunicao
4.2.6 Alterando parmetros de temporizaes (timeout)

55
55
55
55
57
57
57
57
58
58
59

5.

Restrio ou habilitao das formas de pagamento


5.1
Restrio durante o processo de finalizao de uma venda
5.2
Restrio de forma definitiva

60
60
60

Software Express Ltda., 2015

ii

Especificao Tcnica Interface com os meios de pagamento do SiTef


Bibliotecas CliSiTefI e CliSiTef
5.3
5.4
5.5
5.6
5.7
5.8

Habilitao de transaes adicionais


Desabilitando transaes
Habilitao de transaes de redes especficas
Tabela de cdigos de meios de pagamento, configuraes e menus
Habilitao de configuraes especiais por transao
Transaes crdito/dbito com carto sem BIN

Verso:
151
Data: 15/04/2015
61
62
62
65
74
76

6.

Arquivos de controle

80

7.

Trace
7.1
Configurao do perodo que o trace mantido
7.2
Configurao de diretrio
7.3
Arquivos de trace por terminal

81
81
81
82

8.

Processo de desenvolvimento/homologao
8.1
Arquivo de trace adicional durante a fase de desenvolvimento
8.2
Processo de homologao

83
83
83

9.

Habilitando confirmao do valor no pinpad

84

10.

Traduo de mensagens

84

11.

Tabelas

85

12.

Rotinas descontinuadas

91

Software Express Ltda., 2015

iii

Especificao Tcnica Interface com os meios de pagamento do SiTef


Bibliotecas CliSiTefI e CliSiTef

Verso:
151
Data: 09/04/2015

Bibliotecas CliSiTefI e CliSiTef


1.

Objetivos
Da biblioteca

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


em geral. Principais caractersticas:
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;
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;
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.

Software Express Ltda., 2015

Especificao Tcnica Interface com os meios de pagamento do SiTef


Bibliotecas CliSiTefI e CliSiTef

Verso:
151
Data: 09/04/2015

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 (a menos que haja uma necessidade especfica para mudar parmetros de
empresa, terminal ou IP do servidor SiTef).
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:

Software Express Ltda., 2015

Especificao Tcnica Interface com os meios de pagamento do SiTef


Bibliotecas CliSiTefI e CliSiTef

Verso:
151
Data: 09/04/2015

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

Software Express Ltda., 2015

Especificao Tcnica Interface com os meios de pagamento do SiTef


Bibliotecas CliSiTefI e CliSiTef
2.

Verso:
151
Data: 09/04/2015

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.
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.
Software Express Ltda., 2015

Especificao Tcnica Interface com os meios de pagamento do SiTef


Bibliotecas CliSiTefI e CliSiTef
3.

Verso:
151
Data: 09/04/2015

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.

Software Express Ltda., 2015

Especificao Tcnica Interface com os meios de pagamento do SiTef


Bibliotecas CliSiTefI e CliSiTef

Verso:
151
Data: 09/04/2015

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

Software Express Ltda., 2015

Especificao Tcnica Interface com os meios de pagamento do SiTef


Bibliotecas CliSiTefI e CliSiTef

Verso:
151
Data: 09/04/2015

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

Esta rotina deve ser chamada pelo menos uma vez, de forma a configurar os parmetros de conexo
com o servidor SiTef.
Observao: durante o ciclo de vida da automao, caso no haja mudana nos parmetros de
entrada da funo, ento no h necessidade de cham-la novamente.

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]

Software Express Ltda., 2015

Especificao Tcnica Interface com os meios de pagamento do SiTef


Bibliotecas CliSiTefI e CliSiTef

Verso:
151
Data: 09/04/2015

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

Software Express Ltda., 2015

Especificao Tcnica Interface com os meios de pagamento do SiTef


Bibliotecas CliSiTefI e CliSiTef

Verso:
151
Data: 09/04/2015

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

Software Express Ltda., 2015

Especificao Tcnica Interface com os meios de pagamento do SiTef


Bibliotecas CliSiTefI e CliSiTef

Verso:
151
Data: 09/04/2015

3.2.1 Tabela de cdigos de retorno


No retorno a rotina devolve um dos seguintes valores:
Valor
0
10000
outro valor positivo
-1
-2
-3
-4
-5
-6
-7
-8
-9
-10
-12
-15
-20
-21
-25
-30
-40
-41
-42
-43
-50
-100
outro valor negativo

Descrio
Sucesso na execuo da funo.
Deve ser chamada a rotina de continuidade do processo.
Negada pelo autorizador.
Mdulo no inicializado. O PDV tentou chamar alguma rotina sem antes executar
a funo configura.
Operao cancelada pelo operador.
O parmetro funo / modalidade invlido.
Falta de memria no PDV.
Sem comunicao com o SiTef.
Operao cancelada pelo usurio (no pinpad).
Reservado
A CliSiTef no possui a implementao da funo necessria, provavelmente est
desatualizada (a CliSiTefI mais recente).
A automao chamou a rotina ContinuaFuncaoSiTefInterativo sem antes iniciar
uma funo iterativa.
Algum parmetro obrigatrio no foi passado pela automao comercial.
Erro na execuo da rotina iterativa. Provavelmente o processo iterativo anterior
no foi finalizado at o final (enquanto o retorno for igual a 10000).
Operao cancelada pela automao comercial.
Parmetro invlido passado para a funo.
Utilizada uma palavra proibida, por exemplo SENHA, para coletar dados em
aberto no pinpad. Por exemplo na funo ObtemDadoPinpadDiretoEx.
Erro no Correspondente bancrio: Deve realizar sangria.
Erro de acesso ao arquivo. Certifique-se que o usurio que roda a aplicao tem
direitos de leitura/escrita.
Transao negada pelo SiTef.
Dados invlidos.
Reservado
Problema na execuo de alguma das rotinas no pinpad.
Transao no segura.
Erro interno do mdulo.
Erros detectados internamente pela rotina.

Software Express Ltda., 2015

10

Especificao Tcnica Interface com os meios de pagamento do SiTef


Bibliotecas CliSiTefI e CliSiTef

Verso:
151
Data: 09/04/2015

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 Wappa
10
Benefcio Alimentao Wappa
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

Software Express Ltda., 2015

11

Especificao Tcnica Interface com os meios de pagamento do SiTef


Bibliotecas CliSiTefI e CliSiTef

Verso:
151
Data: 09/04/2015

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

Software Express Ltda., 2015

12

Especificao Tcnica Interface com os meios de pagamento do SiTef


Bibliotecas CliSiTefI e CliSiTef
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

420

Troco Solidrio / Doao solidria

500
501
502

Consulta Detalhada ACSP


Consulta Detalhada Serasa
Consulta Cadastral Infocard

521
522
523

Cancelamento GoldenFarma (PBM)


Consulta Pr Autorizao GoldenFarma (PBM)
Venda GoldenFarma (PBM)

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

Consulta EPharma(PBM)
Venda EPharma (PBM)

Software Express Ltda., 2015

Verso:
151
Data: 09/04/2015

13

Especificao Tcnica Interface com os meios de pagamento do SiTef


Bibliotecas CliSiTefI e CliSiTef
572
573

Cancelamento Parcial EPharma (PBM)


Cancelamento Total EPharma (PBM)

580
581
582
583

Consulta PrevSaude (PBM)


Venda PrevSaude (PBM)
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

Consulta Saldo
Consulta Saldo Carto de Dbito
Consulta Saldo Carto de Crdito

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

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

Software Express Ltda., 2015

Verso:
151
Data: 09/04/2015

14

Especificao Tcnica Interface com os meios de pagamento do SiTef


Bibliotecas CliSiTefI e CliSiTef
637
638
639

Boleto de venda NPTC


Venda NPTC
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
658

Saque Crdito Transferncia


Saque Crdito

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

675
676

Pagamento de Fatura IBI


Cancelamento de Pagamento de Fatura IBI

680

Consulta Saldo Pr Pago

700
701
702

Venda Oi Paggo
Cancelamento Oi Paggo
Pagamento de contas

Software Express Ltda., 2015

Verso:
151
Data: 09/04/2015

15

Especificao Tcnica Interface com os meios de pagamento do SiTef


Bibliotecas CliSiTefI e CliSiTef

1
2

703

Cancelamento de Pagamento Carto Benefcio

704

Primeira Compra

705

Pagamento de Fatura

740

Consulta Parcelas Crdito Adm

770
771
772

Carga de tabelas no pinpad1


Carga de tabelas no pinpad forada
Carga de tabelas no pinpad forada com o SiTef

775

Obteno de informaes do pinpad2

999

Fechamento

1000

Voucher Papel

Verso:
151
Data: 09/04/2015

Consulte o item 3.17 - Carga de Tabelas no PinPad para maiores informaes.


Consulte o item 3.16 - Informaes do PinPad para maiores informaes.

Software Express Ltda., 2015

16

Especificao Tcnica Interface com os meios de pagamento do SiTef


Bibliotecas CliSiTefI e CliSiTef

Verso:
151
Data: 09/04/2015

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
No usado Fixo 6 Contm o resultado de resposta chamada da rotina
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

Software Express Ltda., 2015

17

Especificao Tcnica Interface com os meios de pagamento do SiTef


Bibliotecas CliSiTefI e CliSiTef

Verso:
151
Data: 09/04/2015

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:

Software Express Ltda., 2015

18

Especificao Tcnica Interface com os meios de pagamento do SiTef


Bibliotecas CliSiTefI e CliSiTef

Verso:
151
Data: 09/04/2015

Incio

Inicializa Comando, TipoCampo,


TamMinimo, TamMaximo e
Continua com 0

Inicializa TamBuffer com o


tamanho do Buffer

Chama a rotina
ContinuaFuncaoSiTefInterativo

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.

Software Express Ltda., 2015

19

Especificao Tcnica Interface com os meios de pagamento do SiTef


Bibliotecas CliSiTefI e CliSiTef

Verso:
151
Data: 09/04/2015

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
entre TamMinimo e TamMaximo. O campo deve ser devolvido em Buffer.
Software Express Ltda., 2015

20

Especificao Tcnica Interface com os meios de pagamento do SiTef


Bibliotecas CliSiTefI e CliSiTef
30
31

Verso:
151
Data: 09/04/2015

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.
Dentro de cada classe existe a codificao de tipos, e cada par (classe, tipo) indica a

Software Express Ltda., 2015

21

Especificao Tcnica Interface com os meios de pagamento do SiTef


Bibliotecas CliSiTefI e CliSiTef

Verso:
151
Data: 09/04/2015

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
1
2
3
4
5
6

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

Software Express Ltda., 2015

22

Especificao Tcnica Interface com os meios de pagamento do SiTef


Bibliotecas CliSiTefI e CliSiTef

Verso:
151
Data: 09/04/2015

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
1
Dados de confirmao da transao. Para ambientes com mltiplos servidores ser
retornado no seguinte formato:
<Dados_Confirmacao>;<Indice_SiTef>;<Endereco_SiTef>
2
Informa o cdigo da funo SiTef utilizado na mensagem enviada para o servidor.
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

xx
00
01
02
03
05
98
99

Grupo
Cheque
Carto de Dbito
Carto de Crdito
Carto tipo Voucher
Carto Fidelidade
Dinheiro
Outro tipo de carto

nn
00
01
02
03
99

Sub-Grupo
vista
Pr-datado
Parcelado com financiamento pelo estabelecimento
Parcelado com financiamento pela administradora
Outro tipo de pagamento

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
Retorna quando uma transao for cancelada. Contm a modalidade de cancelamento no
formato xxnn, seguindo o mesmo formato xxnn do TipoCampo 100. O sub-grupo nn
todavia, contm o valor default 00 por no ser coletado.
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.
Software Express Ltda., 2015

23

Especificao Tcnica Interface com os meios de pagamento do SiTef


Bibliotecas CliSiTefI e CliSiTef
112
115
120
121

122
123

125
130

131
132
133
134
135
136
137
138
139
140
143
144
145
146

147
150
151
153

Verso:
151
Data: 09/04/2015

Contm o texto descritivo da modalidade de cancelamento que deve ser impresso no


cupom fiscal (p/ex: T.E.F., Cheque, etc...).
Modalidade Ajuste
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 (at 5 dgitos significativos)
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
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

Software Express Ltda., 2015

24

Especificao Tcnica Interface com os meios de pagamento do SiTef


Bibliotecas CliSiTefI e CliSiTef

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
526

Verso:
151
Data: 09/04/2015

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
Quantidade de cheques
Software Express Ltda., 2015

25

Especificao Tcnica Interface com os meios de pagamento do SiTef


Bibliotecas CliSiTefI e CliSiTef
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
587
588
589

Verso:
151
Data: 09/04/2015

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 nome da instituio autorizadora de celular
Cdigo estabelecimento autorizador de celular
Cdigo da Operadora de Celular

Software Express Ltda., 2015

26

Especificao Tcnica Interface com os meios de pagamento do SiTef


Bibliotecas CliSiTefI e CliSiTef
590
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:
151
Data: 09/04/2015

Nome da Operadora de Celular selecionada para a operao


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
Software Express Ltda., 2015

27

Especificao Tcnica Interface com os meios de pagamento do SiTef


Bibliotecas CliSiTefI e CliSiTef
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:
151
Data: 09/04/2015

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

Software Express Ltda., 2015

28

Especificao Tcnica Interface com os meios de pagamento do SiTef


Bibliotecas CliSiTefI e CliSiTef
730
731

732

734
736
737
738
739
750
751
900
901
902
903
910
911
1002

Verso:
151
Data: 09/04/2015

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
Dinheiro
01
Cheque
02
TEF Dbito
03
TEF Crdito
04
Carto Presente (Pr-Pago) Carrefour
05
Carto Bnus Carrefour
06
Carto Carrefour
07
Saque para pagamento
08
Saque
09
DCC Carrefour
50
TEF Carto
77
Campo Reservado
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)
Software Express Ltda., 2015

29

Especificao Tcnica Interface com os meios de pagamento do SiTef


Bibliotecas CliSiTefI e CliSiTef
1003
1010
1011
1012
1013
1014
1015
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

Verso:
151
Data: 09/04/2015

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
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
Nome da me
Nmero do ttulo de eleitor ACSP
Endereo do telefone consultado ACSP
CEP do telefone consultado ACSP
Software Express Ltda., 2015

30

Especificao Tcnica Interface com os meios de pagamento do SiTef


Bibliotecas CliSiTefI e CliSiTef
1056
1057
1058
1100
1101
1102
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

Verso:
151
Data: 09/04/2015

Cidade do telefone consultado ACSP


UF do telefone consultado ACSP
Dados adicionais ACSP
Registro analtico CHECKCHECK
Registro analtico ACSP
Registro analtico SERASA
Imagem tela analtica ACSP
Imagem tela analtica SERASA
Motivo do cancelamento ACSP
Tipo de consulta ACSP
CNPJ Empresa Conveniada
Cdigo da administradora
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
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 (4 ltimos dgitos) do Carto
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

Software Express Ltda., 2015

31

Especificao Tcnica Interface com os meios de pagamento do SiTef


Bibliotecas CliSiTefI e CliSiTef

1202
1203
1204
1205
1206
1207
1208
1209
1321
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

Verso:
151
Data: 09/04/2015

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
caractere decimal.
Vendedor (Usurio) - PBM
Senha PBM
Cdigo de Retorno PBM
Origem PBM
NSU do Host Autorizador da Transao Cancelada
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
Software Express Ltda., 2015

32

Especificao Tcnica Interface com os meios de pagamento do SiTef


Bibliotecas CliSiTefI e CliSiTef
2081
2082
2083
2086
2087
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
2333
2334
2340
2341
2342
2343
2344
2345
2346

Verso:
151
Data: 09/04/2015

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
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
Identificao da transao
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

Software Express Ltda., 2015

33

Especificao Tcnica Interface com os meios de pagamento do SiTef


Bibliotecas CliSiTefI e CliSiTef
2347
2348
2349
2350
2351
2352
2355

Nmero do Item - Estapar


Chassi do Veculo Estapar
Nmero da SUSEP - Estapar
Nmero do Dispositivo - Estapar
Vigncia Final Estapar
Flag Interna- Estapar
Quando retornado, atua como uma dica para o formato do prximo campo que ser
coletado. Normalmente acompanhado do comando zero (0 retorno de valor para uso
pela automao).
Assume os seguintes valores:
Contedo (em Buffer)
A
AN
LN
N
Vx
S
M
Mc

2361
2362

2369
2421
4000
4001
4002
4003
4004
4005
4006
4007
4008
4016
4017
4018
4019
4020
4021
4022
4023
4024
4025
4026
4027

Verso:
151
Data: 09/04/2015

Descrio
Alfabtico
Alfanumrico (ans)
Letras no acentuadas e nmeros
Numrico
Valor com x casas decimais
Sim/No
Menu
Menu com confirmao

Indica que foi efetuada uma transao de dbito para pagamento de carn
Retornado logo aps a transao de consulta de bins. O valor 1 indica que o autorizador
capaz de tratar de forma diferenciada transao de dbito convencional de dbito para
pagamento de contas.
Pontos a resgatar (numrico sem casa decimal).
Informa se est habilitada a funo de coleta de dados adicionais do cliente (0 ou 1)
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
Software Express Ltda., 2015

34

Especificao Tcnica Interface com os meios de pagamento do SiTef


Bibliotecas CliSiTefI e CliSiTef

Verso:
151
Data: 09/04/2015

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
4039
Cdigo Resposta PBM (0 = Ok, <>0 = erro)
4040
Produto Fracionado PBM (0 = no, 1 = sim)
4041
Paciente ID PBM (-1 = outros, 00 = titular, 01 = dependente)
4043
Receita ID PBM (receita cadastrada pela empresa)
4044
Receita item ID PBM (item da receita cadastrada pela empresa)
4045
Receita uso contnuo (0 = no, 1 = sim)
4046
Produto Manipulado PBM (princpios ativos)
4047
Produto Manipulado PBM Valor Original
Campos reservados para uso da IntPos.dll
8000 a 9999 Campos reservados
* Campos utilizados em um ou mais produtos.
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.

Software Express Ltda., 2015

35

Especificao Tcnica Interface com os meios de pagamento do SiTef


Bibliotecas CliSiTefI e CliSiTef

Verso:
151
Data: 09/04/2015

3.3.3 Tabela de Eventos, retornados tambm em TipoCampo


Durante a transao, a CliSiTef pode informar a ocorrncia de determinados eventos.
Estes eventos so retornados no parmetro TipoCampo da rotina ContinuaFuncaoSiTefInterativo
ou ContinuaFuncaoSiTefInterativoA, conforme a tabela abaixo.
TipoCampo

5003
5004
5005
5006
5007
5008
5009
5010
5011
5012
5013
5014
5015
5016
5017
5018
5019
5020
5021

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
Concluso de Recarga de Bilhete nico
Reservado
Aguardando leitura de carto
Aguardando digitao da senha no PinPad
Aguardando processamento do chip
Aguardando remoo do carto
Aguardando confirmao da operao

5027
5028
5029
5030
5031

Cancelamento da leitura do carto


Cancelamento da digitao da senha no PinPad
Cancelamento do processamento do carto com CHIP
Cancelamento da remoo do carto
Cancelamento da confirmao da operao

5036
5037
5038
5039
5040
5041
5042
5043
5044

Antes da leitura do carto magntico


Antes da leitura do carto com CHIP
Antes da remoo do carto com CHIP
Antes da coleta da senha no pinpad
Antes de abrir a comunicao com o PinPad
Antes de fechar a comunicao com o PinPad
Deve bloquear recursos para o PinPad
Deve liberar recursos para o PinPad
Depois de abrir a comunicao com o PinPad

5000
5001
5002

Software Express Ltda., 2015

36

Especificao Tcnica Interface com os meios de pagamento do SiTef


Bibliotecas CliSiTefI e CliSiTef

5050

5501

Verso:
151
Data: 09/04/2015

Atualizao de tabelas.
O contedo deste campo varia de acordo com a transao sendo realizada.
Outros eventos
Incio de uma transao do tipo Correspondente Bancrio.

Software Express Ltda., 2015

37

Especificao Tcnica Interface com os meios de pagamento do SiTef


Bibliotecas CliSiTefI e CliSiTef

Verso:
151
Data: 09/04/2015

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
No usado Fixo 6 Contm o resultado de resposta chamada da rotina
short
char *

Fixo 1

Indica se a transao deve ser confirmada (1) ou


estornada (0)
Mx. 20 Nmero do Cupom Fiscal correspondente venda

char *

Fixo 8

Data Fiscal no formato AAAAMMDD

char *

Fixo 6

Horrio Fiscal no formato HHMMSS

Software Express Ltda., 2015

38

Especificao Tcnica Interface com os meios de pagamento do SiTef


Bibliotecas CliSiTefI e CliSiTef

Verso:
151
Data: 09/04/2015

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
No usado Fixo 6 Contm o resultado de resposta chamada da rotina
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.

Software Express Ltda., 2015

39

Especificao Tcnica Interface com os meios de pagamento do SiTef


Bibliotecas CliSiTefI e CliSiTef

Verso:
151
Data: 09/04/2015

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
No usado Fixo 6 Contm o resultado de resposta chamada da rotina
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.

Software Express Ltda., 2015

40

Especificao Tcnica Interface com os meios de pagamento do SiTef


Bibliotecas CliSiTefI e CliSiTef

Verso:
151
Data: 09/04/2015

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

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.
long LeCartaoSeguro (Mensagem)

Interface ASCII
LeCartaoSeguroA (Resultado, Mensagem)

Parmetro
Resultado
Mensagem

Tipo
Sada,
por valor
Entrada,
por valor

Interface Interface
Descrio
padro
ASCII
No usado Fixo 6 Contm o resultado de resposta chamada da rotina
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.
Os campos retornados no processo interativo so os referentes aos campos sensveis (2021 a 2046).
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
No usado Fixo 6 Contm o resultado de resposta chamada da rotina
char *

Varivel Mensagem a ser apresentada no visor do PinPad

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.

Software Express Ltda., 2015

41

Especificao Tcnica Interface com os meios de pagamento do SiTef


Bibliotecas CliSiTefI e CliSiTef
Trilha2
Timeout

TestaCancela
mento

Sada,
por valor
Entrada,
por valor

char *
short

Fixo 6

Entrada,
por valor

Rotina

No
Usado

Verso:
151
Data: 09/04/2015

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.
Para esta rotina especfica, os cdigos de erro retornados so:
Valor
0
1
2
3
4
5
6
7

Descrio

No ocorreu erro
Campo de sada insuficiente
BIN no aceito
CNPJ invlido
Chave de acesso vencida
Verso invlida
Chave de criptografia invlida
Dados no criptografados com a chave fornecida como parmetro: a decriptografia resultou em
um nmero de carto que no composto s por dgitos.
8 Dado de entrada invlido

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, 204x para campos criptografados e 205x.
TipoCampo
202x
203x
204x
205x

Descrio
Campos abertos, mascarados.
Hash dinmico dos campos
Campos criptografados
Hash fixo dos campos *
x
1
2
3
4
5

Campo
PAN do carto
Vencimento do carto
Nome do Cliente
Trilha 1
Trilha 2

* As novas implementaes devem utilizar o campo 203x, pois o campo 205x devolve um hash criptografado utilizando
a chave de criptografia inserida pelo cliente no arquivo .cha. Essa forma de uso (205x) existe apenas por
compatibilidade, pois o ideal utilizar o Hash com Salt (Semente - 203x) uma vez que a informao utilizada para gerar

Software Express Ltda., 2015

42

Especificao Tcnica Interface com os meios de pagamento do SiTef


Bibliotecas CliSiTefI e CliSiTef

Verso:
151
Data: 09/04/2015

o hash fica escondida apenas dentro das aplicaes que o utilizam, tornando o processo de reverso do hash at obter o
dado original praticamente impossvel de ser executado pela fora bruta.

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 LeCartaoDiretoSeguroEx (Mensagem, DadosOut, TamDadosOut, Timeout,
TestaCancelamento)

Interface ASCII
LeCartaoDiretoSeguroExA (Resultado, Mensagem, DadosOut, TamDadosOut,
Timeout)

Parmetro
Resultado
Mensagem
DadosOut

Tipo
Sada,
por valor
Entrada,
por valor
Sada,
por valor

TamDadosOut Entrada,
por valor
Timeout
Entrada,
por valor
TestaCancela
mento

Entrada,
por valor

Interface Interface
Descrio
padro
ASCII
No usado Fixo 6 Contm o resultado de resposta chamada da rotina.
char *

Varivel Mensagem a ser apresentada no visor do PinPad.

char *

Varivel Retorna os mesmos dados da rotina


LeCartaoDiretoSeguro, concatenados no formato
TLV, onde T corresponde ao tipo do campo
(tamanho 5), L o tamanho do campo (tamanho 3) e
V o campo (tamanho do campo).
Fixo 6 Tamanho do buffer de DadosOut.

Int
short

Fixo 6

Rotina

No
Usado

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.

Software Express Ltda., 2015

43

Especificao Tcnica Interface com os meios de pagamento do SiTef


Bibliotecas CliSiTefI e CliSiTef

Verso:
151
Data: 09/04/2015

int LeTrilhaChipInterativo (Modalidade)

Interface ASCII
LeTrilhaChipInterativoA (Resultado, Modalidade)
LeTrilhaChipInterativoEx (Modalidade, ParamAdic)
Parmetro
Resultado
Modalidade

ParamAdic

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
Int
Fixo
Seleciona o tipo do pagamento:
2 : Dbito
3 : Crdito
char *
Varivel Parmetros
adicionais,
como
o
Mx. 64 {SementeHash=XXX..}. opcional e pode ser
vazio

Essas funes funcionam da mesma maneira das LeCartaoSeguro/LeCartaoSeguroA, com a


diferena que estas aceitam cartes com chip.
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. Para maiores detalhes, consulte o documento Acesso a
Senha do Cliente para Carto Proprietrio CliSiTef.doc.
long LeSenhaInterativo (ChaveSeguranca)

Interface ASCII
LeSenhaInterativoA (Resultado, ChaveSeguranca)

Parmetro
Resultado

Tipo

Sada,
por valor
ChaveSeguran Entrada,
ca
por valor

Interface Interface
Descrio
padro
ASCII
No usado Fixo 6 Contm o resultado de resposta chamada da rotina
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.

Software Express Ltda., 2015

44

Especificao Tcnica Interface com os meios de pagamento do SiTef


Bibliotecas CliSiTefI e CliSiTef

Verso:
151
Data: 09/04/2015

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 (ChaveSeguranca, SenhaCliente)

Interface ASCII
LeSenhaDiretoA (Resultado, ChaveSeguranca, SenhaCliente)

Parmetro

Tipo

Resultado

Sada,
por valor
ChaveSeguran Entrada,
ca
por valor
Senha

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.

Software Express Ltda., 2015

45

Especificao Tcnica Interface com os meios de pagamento do SiTef


Bibliotecas CliSiTefI e CliSiTef

Verso:
151
Data: 09/04/2015

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
No usado Fixo 6 Contm o resultado de resposta chamada da rotina
char *

Varivel Mensagem a ser apresentada no visor do PinPad

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.

Software Express Ltda., 2015

46

Especificao Tcnica Interface com os meios de pagamento do SiTef


Bibliotecas CliSiTefI e CliSiTef

Verso:
151
Data: 09/04/2015

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.

Software Express Ltda., 2015

47

Especificao Tcnica Interface com os meios de pagamento do SiTef


Bibliotecas CliSiTefI e CliSiTef

Verso:
151
Data: 09/04/2015

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,
No usado Fixo 6 Contm o resultado de resposta chamada da rotina
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.

Software Express Ltda., 2015

48

Especificao Tcnica Interface com os meios de pagamento do SiTef


Bibliotecas CliSiTefI e CliSiTef

Verso:
151
Data: 09/04/2015

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

Software Express Ltda., 2015

49

Especificao Tcnica Interface com os meios de pagamento do SiTef


Bibliotecas CliSiTefI e CliSiTef

Verso:
151
Data: 09/04/2015

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.

Software Express Ltda., 2015

50

Especificao Tcnica Interface com os meios de pagamento do SiTef


Bibliotecas CliSiTefI e CliSiTef

Verso:
151
Data: 09/04/2015

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
No usado Fixo 6 Contm o resultado de resposta chamada da rotina
char *

Fixo 8

char *

Data Fiscal no formato AAAAMMDD

Mx. 20 Nmero do Cupom Fiscal correspondente venda

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.

Software Express Ltda., 2015

51

Especificao Tcnica Interface com os meios de pagamento do SiTef


Bibliotecas CliSiTefI e CliSiTef

Verso:
151
Data: 09/04/2015

3.15 Descarregando Mensagens

Em situaes de falha de comunicao com o servidor SiTef, a CliSiTef enviar automaticamente


eventuais dados remanescentes (por exemplo, dados de confirmao, no-confirmao e desfazimento)
somente na prxima transao do PDV.
Porm, pode levar algum tempo at que a prxima transao seja iniciada na estao.
Nos momentos em que o PDV est no estado repouso ou idle, a automao pode utilizar a
seguinte rotina para forar a biblioteca a descarregar mensagens de confirmao, no confirmao e
desfazimento para o SiTef.
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.
3.16 Informaes do PinPad

Existem duas formas de se obter informaes bsicas do PinPad conectado no PDV, tais como
nmero de srie, modelo, etc.
1) ObtemInformacoesPinPad funo direta.
2) Atravs de cdigo de funo passada IniciaFuncaoSiTefInterativo, e consequente processo
interativo.

A primeira forma utilizando a funo abaixo.


int ObtemInformacoesPinPad (InfoPinPad)

Parmetro
InfoPinPad

Tipo
Sada,
por valor

Interface
Descrio
padro
char *
No retorno contm as informaes do PinPad

Em caso de sucesso, os dados sero retornados no seguinte formato:


2 caracteres numricos que indicam a informao obtida sendo:
01 para o Nome do fabricante,
02 para o Modelo / verso do hardware,
03 para a Verso do software bsico/firmware,
04 Verso da especificao compartilhada
05 para a Verso da aplicao bsica,
06 para o Nmero de srie.

Software Express Ltda., 2015

52

Especificao Tcnica Interface com os meios de pagamento do SiTef


Bibliotecas CliSiTefI e CliSiTef

Verso:
151
Data: 09/04/2015

3 caracteres numricos que indicam o tamanho em caracteres da informao.


N (conforme tamanho acima) caracteres alfanumricos com a informao.
Exemplo:
01006GERTEC02010PPC900;3MB030190077_0071_0080_0106040041.0605013001.23
100820060160450805232030714

Nome do fabricante : GERTEC


Modelo / verso do hardware : PPC900;3MB
Verso do software bsico/firmware : 0077_0071_0080_0106
Verso da especificao : 1.06
Verso da aplicao bsica : 001.23 100820
Nmero de srie : 0450805232030714

Observao: o Buffer que receber as informaes do PinPad deve possuir tamanho mnimo de 256
caracteres, j prevendo a possibilidade de serem includas novas informaes de pinpad.

J na segunda forma, a automao deve passar o cdigo de funo 775 para a


IniciaFuncaoSiTefInterativo, e prosseguir no fluxo de coleta como se fosse uma transao.
Durante o fluxo de coleta, os seguintes campos sero retornados para a automao, normalmente
pelo comando 0 (zero).
Campo
2450
2451
2452
2453
2454
2455

Descrio
Nome do fabricante
Modelo / verso do hardware
Verso do software bsico/firmware
Verso da especificao
Verso da aplicao bsica
Nmero de srie do PinPad

Software Express Ltda., 2015

53

Especificao Tcnica Interface com os meios de pagamento do SiTef


Bibliotecas CliSiTefI e CliSiTef

Verso:
151
Data: 09/04/2015

3.17 Carga de Tabelas no PinPad

Chamamos de carga de tabelas no pinpad o processo onde feito a carga de parmetros de


aplicaes de chip, certificados e outros dados no pinpad.
Normalmente a CliSiTef faz esta operao sob demanda, ao perceber que necessria uma nova
carga de parmetros. Existem vrios motivos para isso, por exemplo a troca de pinpad no PDV, ou ento
uma alterao de parmetros do estabelecimento no lado do autorizador.
A automao pode comandar uma nova carga de tabelas no pinpad. Por exemplo, para reduzir a
chance de uma carga na primeira venda do dia, a automao pode iniciar uma carga quando estiver em
estado de repouso (idle) e, desta forma, diminuir o tempo no primeiro atendimento.
Note contudo que, se houver uma alterao de parmetros por parte do autorizador, esta mudana
refletir uma nova carga de tabelas durante o dia.
Para que a automao comande a carga de tabelas no pinpad, so oferecidos trs cdigos de funo
que devem ser usadas na IniciaFuncaoSiTefInterativo.
Cdigo da
Funo
770
771
772

Descrio
Carga de tabelas no pinpad
Carga de tabelas no pinpad forada
Carga de tabelas no pinpad forada com o SiTef

A funo 770 realiza a carga de tabelas no pinpad caso seja necessrio. Isto , se os dados do
servidor SiTef j estiverem carregados no pinpad, nenhuma carga ser feita.
A funo 771 fora a carga de tabelas no pinpad de acordo com as tabelas baixadas previamente do
servidor SiTef e que esto armazenadas localmente no PDV.
J a funo 772 faz com que a clisitef apague os dados locais do PDV, baixando do SiTef uma nova
fotografia destes parmetros, e a seguir faz a carga de tabelas no pinpad.

Software Express Ltda., 2015

54

Especificao Tcnica Interface com os meios de pagamento do SiTef


Bibliotecas CliSiTefI e CliSiTef
4.

Verso:
151
Data: 09/04/2015

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 e plataformas mobile (Android e IOS), o arquivo de configurao utilizado
CLSIT. Ao longo deste documento, todas as menes para CliSiTef.ini devem ser entendidas como
CLSIT quando se tratar destes ambientes.
A seguir descreveremos algumas funcionalidades macro presentes neste arquivo.
4.1 Configurao do PinPad

4.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.
A partir da CliSiTef verso 4.0.111.3 para Windows e 4.0.111.18 para Linux, possvel usar o
valor AUTO_USB para identificar automaticamente a porta de um pinpad USB.
[PinPadCompartilhado]
Porta=AUTO_USB

Nota: a configurao acima vlida somente para a plataforma Windows 32 e Linux 32 (a partir do
kernel 2.6), nas verses mencionadas acima.

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

Software Express Ltda., 2015

55

Especificao Tcnica Interface com os meios de pagamento do SiTef


Bibliotecas CliSiTefI e CliSiTef

Software Express Ltda., 2015

Verso:
151
Data: 09/04/2015

56

Especificao Tcnica Interface com os meios de pagamento do SiTef


Bibliotecas CliSiTefI e CliSiTef

Verso:
151
Data: 09/04/2015

4.2 Configurao de conexo com o servidor SiTef

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

4.2.3 Obrigatoriedade de conexo


Por padro, as transaes na CliSiTef tentam avanar ao mximo, mesmo sem a conexo com o
SiTef.
Para retirar este comportamento, e exigir a obrigatoriedade de conexo, inclua na seo SiTef o
parmetro ConexaoObrigatoria com valor um (1). Neste caso, no havendo conexo com o SiTef a
transao ser encerrada com erro -5.
[SiTef]
ConexaoObrigatoria=1

Software Express Ltda., 2015

57

Especificao Tcnica Interface com os meios de pagamento do SiTef


Bibliotecas CliSiTefI e CliSiTef

Verso:
151
Data: 09/04/2015

4.2.4 Mantendo conexo ativa


Por padro, a caracterstica da CliSiTef ao fazer uma transao com o servidor SiTef : realizar a
conexo, efetuar a troca de mensagens e desconectar ao final da transao.
Caso haja necessidade de manter a conexo com o SiTef sempre ativa, deve-se incluir na seo
SiTef o parmetro MantemConexaoAtiva com valor um (1).
[SiTef]
MantemConexaoAtiva=1

4.2.5 Configurao do mostrador de comunicao


Por padro, a clisitef envia para a automao o comando 3 com uma mensagem do tipo Aguarde,
em processamento....
Para desabilitar o mostrador de comunicao, basta incluir na seo Geral o campo
MostradorComunicacaoHabilitado com valor zero.
[Geral]
MostradorComunicacaoHabilitado=0

Ateno: ao contrrio dos itens anteriores, deve-se usar a seo Geral.

Software Express Ltda., 2015

58

Especificao Tcnica Interface com os meios de pagamento do SiTef


Bibliotecas CliSiTefI e CliSiTef

Verso:
151
Data: 09/04/2015

4.2.6 Alterando parmetros de temporizaes (timeout)


Tempo para timeout de conexo com o servidor SiTef
O tempo padro de espera para que a CliSiTef consiga se conectar com o servidor SiTef de 6
segundos. Para aumentar ou diminuir este tempo de espera, configure na seo SiTef o campo
TempoEsperaConexao com o novo valor, em segundos.
[SiTef]
TempoEsperaConexao=<tempo para timeout, em segundos>

Tempo adicional para timeout da transao


Normalmente a CliSiTef recebe parmetros de timeout com o servidor SiTef. A CliSiTef leva em
considerao estes valores, acrescentando ainda uma margem de segurana sobre eventuais tempos gastos
na transmisso.
Em situaes de autorizador indisponvel, e dependendo do canal de comunicao entre o servidor
SiTef e a CliSiTef, esta margem pode ser insuficiente, podendo ocorrer erros do tipo Sem conexo com
o servidor SiTef, quando o correto seria Servio do autorizador indisponvel.
Para incluir um tempo adicional em segundos, basta incluir o item TempoAdicionalEspera na
seo SiTef.
[SiTef]
TempoAdicionalEspera=<tempo adicional para timeout, em segundos>

Tempo para espera de desfazimento


O tempo padro de espera (timeout) para que a CliSiTef consiga receber a resposta uma
mensagem de desfazimento enviada ao servidor SiTef de 6 segundos. Para alterar este valor, configure
na seo SiTef o campo TempoEsperaDesfazimento o novo valor, em segundos.
[SiTef]
TempoEsperaDesfazimento=<tempo para timeout, em segundos>

Tempo para espera de confirmao


O tempo padro de espera (timeout) para que a CliSiTef consiga receber a resposta uma
mensagem de confirmao/no-confirmao enviada ao servidor SiTef de 6 segundos. Para alterar este
valor, configure na seo SiTef o campo TempoEsperaConfirmacao o novo valor, em segundos.
[SiTef]
TempoEsperaConfirmacao=<tempo para timeout, em segundos>

Software Express Ltda., 2015

59

Especificao Tcnica Interface com os meios de pagamento do SiTef


Bibliotecas CliSiTefI e CliSiTef

Verso:
151
Data: 09/04/2015

5. Restrio ou habilitao das formas de pagamento


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

Software Express Ltda., 2015

60

Especificao Tcnica Interface com os meios de pagamento do SiTef


Bibliotecas CliSiTefI e CliSiTef

Verso:
151
Data: 09/04/2015

5.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.
Consulte a Tabela de cdigos de meios de pagamento, configuraes e menus para a lista de
cdigos nesta configurao.
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

Software Express Ltda., 2015

61

Especificao Tcnica Interface com os meios de pagamento do SiTef


Bibliotecas CliSiTefI e CliSiTef

Verso:
151
Data: 09/04/2015

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

Consulte a Tabela de cdigos de meios de pagamento, configuraes e menus para a lista de


cdigos nesta configurao.
5.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

Software Express Ltda., 2015

62

Especificao Tcnica Interface com os meios de pagamento do SiTef


Bibliotecas CliSiTefI e CliSiTef

Verso:
151
Data: 09/04/2015

BancoMercantil
BancoPanamericano
BancoProvincial
BOD
BODDebito
BrazilianCard
CdlPoa
CdlRio
CentralCard
CheckCheck
Cisa
Citibank
ClubCard
CompreMax
Condor
Consignum
ConsorcioVenezuela
ConsultaValePapel
CooperCred
CredMais
CTF
DDTotal
Dotz
Ediguay
Eletrozema
EMS
Fidelize
Formosa
FoxWinCards
Givex
Hiperlife
HotCard
ICards
InfoCard
InComm
JGV
MAR
Mettacard (antigo Consignum)
Neus
Oboe
Omnion
Orbitall
Parati
Platco
PortalCard
Qualicard
Software Express Ltda., 2015

63

Especificao Tcnica Interface com os meios de pagamento do SiTef


Bibliotecas CliSiTefI e CliSiTef

Verso:
151
Data: 09/04/2015

Repom
SasNT
SigaCred
SisCred
Softway
SpcBrasil
SQCF
Starfiche
Sysdata
Telecheque
Teledata
TopCard
Total
Tricard
UpSight
UseCred
Validata
Wappa

Software Express Ltda., 2015

64

Especificao Tcnica Interface com os meios de pagamento do SiTef


Bibliotecas CliSiTefI e CliSiTef

Verso:
151
Data: 09/04/2015

5.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
Estorno de 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
51

Software Express Ltda., 2015

65

Especificao Tcnica Interface com os meios de pagamento do SiTef


Bibliotecas CliSiTefI e CliSiTef
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
Recarga de Celular Bradesco

Software Express Ltda., 2015

Verso:
151
Data: 09/04/2015
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
3005

66

Especificao Tcnica Interface com os meios de pagamento do SiTef


Bibliotecas CliSiTefI e CliSiTef
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
Produtos de Vales da Cielo
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
Consulta ltima Fatura de Carto Crdito

Software Express Ltda., 2015

Verso:
151
Data: 09/04/2015
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
3053

67

Especificao Tcnica Interface com os meios de pagamento do SiTef


Bibliotecas CliSiTefI e CliSiTef
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
Cdigo Resumido EMS

Software Express Ltda., 2015

Verso:
151
Data: 09/04/2015
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
3101

68

Especificao Tcnica Interface com os meios de pagamento do SiTef


Bibliotecas CliSiTefI e CliSiTef
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
Venda Parcelado Pr-Datado Fininvest

Software Express Ltda., 2015

Verso:
151
Data: 09/04/2015
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
3163

69

Especificao Tcnica Interface com os meios de pagamento do SiTef


Bibliotecas CliSiTefI e CliSiTef
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
Sangria de Caixa CB

Software Express Ltda., 2015

Verso:
151
Data: 09/04/2015
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
3211

70

Especificao Tcnica Interface com os meios de pagamento do SiTef


Bibliotecas CliSiTefI e CliSiTef
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 opo carto magntico (PBM)
Menu opo carto digitado (PBM)
Menu opo cdigo de autorizao (PBM)
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

Software Express Ltda., 2015

Verso:
151
Data: 09/04/2015
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
3270
3271
3272
3276
3277
3278
3279
3280
3281
3282
3283
3284
3285
3286
3287
3288
3289
3296
3297
3298
3299
3303
3304

71

Especificao Tcnica Interface com os meios de pagamento do SiTef


Bibliotecas CliSiTefI e CliSiTef
Menu carto Qualidade (ICI Card)
Menu opo Saque Crdito Transferncia
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)

Software Express Ltda., 2015

Verso:
151
Data: 09/04/2015
3305
3306
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

72

Especificao Tcnica Interface com os meios de pagamento do SiTef


Bibliotecas CliSiTefI e CliSiTef
Menu Pagamento de Fatura genrico
Menu opo Pr Autorizao Carto Combustvel
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
Carto EGift (Hug)
Menu formas de pagamento para pagamento de carto Siscred
Saque Gift
Cancelamento de saque Gift
Cancelamento de ativao Gift
Reimpresso Especifica Outros

Software Express Ltda., 2015

Verso:
151
Data: 09/04/2015
3379
3389
3390
3391
3392
3393
3394
3407
3408
3409
3410
3411
3412
3466
3480
3500
3510
3511
3512
3515
3517
3530
3553
3554
3556
3675

73

Especificao Tcnica Interface com os meios de pagamento do SiTef


Bibliotecas CliSiTefI e CliSiTef

Verso:
151
Data: 09/04/2015

5.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
ser concatenada com nenhuma

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).
Se alguma chave no for configurada preciso passar o parmetro
Software Express Ltda., 2015

74

Especificao Tcnica Interface com os meios de pagamento do SiTef


Bibliotecas CliSiTefI e CliSiTef

Verso:
151
Data: 09/04/2015

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). Consulte o item
5.8 - Transaes crdito/dbito com carto sem BIN.
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.

Software Express Ltda., 2015

75

Especificao Tcnica Interface com os meios de pagamento do SiTef


Bibliotecas CliSiTefI e CliSiTef

Verso:
151
Data: 09/04/2015

5.8 Transaes crdito/dbito com carto sem BIN

Em determinadas transaes, em que o aplicativo da automao deseje utilizar um carto especial


(sem BIN definido), necessrio passar algumas restries, e para isso existem duas formas:
1) Indicando a configurao RedeDestino no parmetro ParamAdic, presente nas funes que
iniciam o processo de pagamento (IniciaFuncaoSiTefInterativo) ou Correspondente Bancrio
(CorrespondenteBancarioSiTefInterativo), conforme exemplo a seguir:
{RedeDestino=nnnn}

Onde nnnn o cdigo da rede a qual pertence o carto especial (vide tabela abaixo).
2) Indicando esta rede especial, a qual pertence o carto especial, no arquivo de configurao da
CliSiTef (CliSiTef.ini).
Para tanto, indique nas sees Debito, Credito ou CartaoCombustivel os pares (Texto, Rede)
correspondentes ao texto que ser exibido e o cdigo de rede.
[Debito]
Texto1=SomarCard
Rede1=172
Texto2= StarFiche
Rede2=178
TextoN=MinhaRede
RedeN=nnnn
[Credito]
Texto1=SomarCard
Rede1=172
Texto2= StarFiche
Rede2=178
Texton=MinhaRede
Reden=nnnn
[CartaoCombustivel]
Texto1=FitCard
Rede1=263
TextoN=MinhaRede
RedeN=nnnn

Atravs do arquivo de configurao permitido definir at 5 redes de dbito e 5 redes de crdito.


Feito isso, quando a automao realizar uma transao de dbito ou crdito, a CliSiTef apresentar um
menu com todas as redes definidas e com a opo de dbito ou crdito padro, em que realizada a
consulta de bins.

Software Express Ltda., 2015

76

Especificao Tcnica Interface com os meios de pagamento do SiTef


Bibliotecas CliSiTefI e CliSiTef

Verso:
151
Data: 09/04/2015

Alm disso, possvel definir se a rede em questo permite a captura de carto atravs do leitor
magntico ou atravs de digitao. Os parmetros que determinam essas caractersticas so
HabilitaMagneticon, HabilitaDigitadon e HabilitaCodBarn, sendo n o ndice da rede.

Software Express Ltda., 2015

77

Especificao Tcnica Interface com os meios de pagamento do SiTef


Bibliotecas CliSiTefI e CliSiTef

Verso:
151
Data: 09/04/2015

Exemplo:
[Debito]
Texto1=SomarCard
Rede1=172
Texto2= StarFiche
Rede2=178
Texto3=Libercard
Rede3=196
HabilitaDigitado3=1
HabilitaMagnetico3=0
[Credito]
Texto1=SomarCard
Rede1=172
Texto2= StarFiche
Rede2=178
Texto3=Libercard
Rede3=196
HabilitaDigitado3=1
HabilitaMagnetico3=0
[CartaoCombustivel]
Texto1=FitCard
Rede1=263
HabilitaDigitado1=0
HabilitaMagnetico1=1
HabilitaCodBar1=0

Tambm possvel definir as transaes adicionais que sero capturadas pela rede em questo. O
parmetro que determina essa caracterstica o TransacoesAdicionaisn, sendo n o ndice da rede. Os
valores indicados so as funes do item 3.2.2 - Tabela de cdigos de funes, separados por ponto-evrgula.
No momento, somente a transao 602 (Consulta Saldo Carto de Crdito) foi implementada.
Exemplo:
[Credito]
Rede1=205
Texto1=GoldenFarma
TransacoesAdicionais1=602;

A seguir, listamos o cdigo das redes que possuem cartes nesta situao.
Cdigo da Rede
97
172
178
196

Nome da Rede
Cartesys
SomarCard
StarFiche
Libercard
Software Express Ltda., 2015

78

Especificao Tcnica Interface com os meios de pagamento do SiTef


Bibliotecas CliSiTefI e CliSiTef

Verso:
151
Data: 09/04/2015

205 GoldenFarma
263 FitCard

Software Express Ltda., 2015

79

Especificao Tcnica Interface com os meios de pagamento do SiTef


Bibliotecas CliSiTefI e CliSiTef
6.

Verso:
151
Data: 09/04/2015

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

Software Express Ltda., 2015

80

Especificao Tcnica Interface com os meios de pagamento do SiTef


Bibliotecas CliSiTefI e CliSiTef
7.

Verso:
151
Data: 09/04/2015

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


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

Software Express Ltda., 2015

81

Especificao Tcnica Interface com os meios de pagamento do SiTef


Bibliotecas CliSiTefI e CliSiTef

Verso:
151
Data: 09/04/2015

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

Software Express Ltda., 2015

82

Especificao Tcnica Interface com os meios de pagamento do SiTef


Bibliotecas CliSiTefI e CliSiTef
8.

Verso:
151
Data: 09/04/2015

Processo de desenvolvimento/homologao

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

Software Express Ltda., 2015

83

Especificao Tcnica Interface com os meios de pagamento do SiTef


Bibliotecas CliSiTefI e CliSiTef
9.

Verso:
151
Data: 09/04/2015

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

10. 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 no documento SiTef - Interface Simplificada com a aplicao - Tabela de
Mensagens.

Software Express Ltda., 2015

84

Especificao Tcnica Interface com os meios de pagamento do SiTef


Bibliotecas CliSiTefI e CliSiTef

Verso:
151
Data: 09/04/2015

11. Tabelas
Cdigo das Redes Autorizadoras
00000
00001
00002
00003
00004
00005
00006
00007
00008
00009
00010
00011
00012
00013
00014
00015
00016
00017
00018
00019
00020
00021
00022
00023
00024
00025
00026
00027
00028
00029
00030
00031
00032
00033
00034
00035
00036
00037
00038
00039
00040
00041
00042
00043
00044

Descrio
Outra, no definida
Tecban
ITA
BRADESCO
Visanet - Especificao 200001
Redecard
Amex
SOLLO
E CAPTURE
Serasa
SPC Brasil
SERASA DETALHADO
TELEDATA
ACSP
ACSP DETALHADO
TECBIZ
CDL DF
Repom
STANDBY
EDMCARD
CREDICESTA
Banrisul
ACC CARD
Clubcard
ACPR
Vidalink
CCC_WEB
Ediguay
Carrefour
Softway
Multicheque
Ticket combustvel
YAMADA
Citibank
Infocard
BESC
EMS
CHEQUE CASH
Central Card
Drogaraia
OUTRO SERVIO
Accor
EPAY GIFT
Parati
TOKORO

Software Express Ltda., 2015

85

Especificao Tcnica Interface com os meios de pagamento do SiTef


Bibliotecas CliSiTefI e CliSiTef
00045
00046
00047
00048
00049
00050
00051
00052
00053
00054
00055
00056
00057
00058
00059
00060
00061
00062
00063
00064
00065
00066
00067
00068
00069
00070
00071
00072
00073
00074
00075
00076
00077
00078
00079
00080
00081
00082
00083
00084
00085
00086
00087
00088
00089
00090
00091
00092

Verso:
151
Data: 09/04/2015

Coopercred
SERVCEL
Sorocred
Vital
SAX FINANCEIRA
Formosa
Hipercard
Tricard
CHECK OK
Policard
Cetelem Carrefour
LEADER
Consrcio Credicard Venezuela
GAZINCRED
Telenet
Cheque Pr
Brasil Card
Epharma
Total
Consrcio Amex Venezuela
GAX
Peralta
SERVIDOR PAGAMENTO
BANESE
RESOMAQ
Sysdata
CDL POA
BIGCARD
DTRANSFER
VIAVAREJO
CHECK EXPRESS
Givex
Valecard
Portal Card
Banpara
SOFTNEX
SUPERCARD
GetNet
Prevsaude
BANCO POTTENCIAL
SOPHUS
MARISA 2
MAXICRED
BLACKHAWK
EXPANSIVA
SAS NT
LEADER 2
SOMAR

Software Express Ltda., 2015

86

Especificao Tcnica Interface com os meios de pagamento do SiTef


Bibliotecas CliSiTefI e CliSiTef
00093
00094
00095
00096
00097
00098
00099
00100
00101
00102
00103
00104
00105
00106
00107
00108
00109
00110
00111
00112
00113
00114
00115
00116
00117
00118
00119
00120
00121
00122
00123
00124
00125
00126
00127
00128
00129
00130
00131
00132
00133
00134
00135
00136
00137
00138
00139
00140

Verso:
151
Data: 09/04/2015

CETELEM AURA
CABAL
CREDSYSTEM
Banco Provincial
CARTESYS
CISA
TRNCENTRE
ACPR D
CARDCO
CHECK CHECK
CADASA
PRIVATE BRADESCO
CREDMAIS
GWCEL
CHECK EXPRESS 2
GETNET PBM
USECRED
SERV VOUCHER
TREDENEXX
Bonus Presente Carrefour
CREDISHOP
ESTAPAR
Banco Ibi
WORKERCARD
Telecheque
OBOE
PROTEGE
SERASA CARDS
Hotcard
Banco Panamericano
Banco Mercantil
Sigacred
Visanet Especificao 4.1
SPTRANS
PRESENTE MARISA
COOPLIFE
BOD
G CARD
TCREDIT
SISCRED
FOXWINCARDS
CONVCARD
Voucher
EXPAND CARDS
Ultragaz
Qualicard
HSBC UK
Wappa

Software Express Ltda., 2015

87

Especificao Tcnica Interface com os meios de pagamento do SiTef


Bibliotecas CliSiTefI e CliSiTef
00141
00142
00143
00144
00145
00146
00147
00148
00149
00150
00151
00152
00153
00154
00155
00156
00157
00158
00159
00160
00161
00162
00163
00164
00165
00166
00167
00168
00169
00170
00171
00172
00173
00174
00175
00176
00177
00178
00179
00180
00181
00182
00183
00184
00185
00186
00187
00188

Verso:
151
Data: 09/04/2015

SQCF
INTELLISYS
BOD DBITO
ACCREDITO
COMPROCARD
ORGCARD
MINASCRED
Farmcia Popular
Fidelidade Mais
ITA SHOPLINE
CDL RIO
FORTCARD
PAGGO
SMARTNET
INTERFARMACIA
VALECON
CARTO EVANGLICO
VEGASCARD
SCCARD
ORBITALL
ICARDS
FACILCARD
FIDELIZE
FINAMAX
BANCO GE
UNIK
TIVIT
VALIDATA
BANESCARD
CSU CARREFOUR
VALESHOP
SOMAR CARD
OMNION
CONDOR
STANDBYDUP
BPAG BOLDCRON
MARISA SAX SYSIN
STARFICHE
ACE SEGUROS
TOP CARD
GETNET LAC
UP SIGHT
MAR
FUNCIONAL CARD
PHARMA SYSTEM
NEUS
SICREDI
ESCALENA

Software Express Ltda., 2015

88

Especificao Tcnica Interface com os meios de pagamento do SiTef


Bibliotecas CliSiTefI e CliSiTef
00189
00190
00191
00192
00193
00194
00195
00196
00197
00198
00199
00200
00201
00202
00203
00204
00205
00206
00207
00208
00209
00210
00211
00212
00213
00214
00215
00216
00217
00218
00219
00220
00221
00222
00223
00224
00225
00226
00227
00228
00229
00230
00231
00232
00233
00234
00235
00236

Verso:
151
Data: 09/04/2015

N SERVIOS
CSF CARREFOUR
ATP
AVST
ALGORIX
AMEX EMV
COMPREMAX
LIBERCARD
SEICON
SERASA AUTORIZ CRDITO
SMARTN
PLATCO
SMARTNET EMV
PROSA MXICO
PEELA
NUTRIK
GOLDENFARMA PBM
GLOBAL PAYMENTS
ELAVON
CTF
BANESTIK
VISA ARG
AMEX ARG
POSNET ARG
AMEX MXICO
ELETROZEMA
BARIGUI
SIMEC
SGF
HUG
CARTO CONSIGNUM CARTO METTACARD
DDTOTAL
CARTO QUALIDADE
REDECONV
NUTRICARD
DOTZ
PREMIAES RAIZEN
TROCO SOLIDRIO
AMBEV SCIO TORCEDOR
SEMPRE
FIRST DATA
COCIPA
IBI MXICO
SIANET
SGCARDS
CIAGROUP
FILLIP
CONDUCTOR

Software Express Ltda., 2015

89

Especificao Tcnica Interface com os meios de pagamento do SiTef


Bibliotecas CliSiTefI e CliSiTef
00237
00238
00239
00240
00241
00242
00243
00244
00245
00246
00247
00248
00249
00250
00251
00252
00253
00254
00255
00256
00257
00258
00259
00260
00261
00262
00263
00264
00265
00266
00267

Cdigo da Bandeira
(Carto de Crdito)
00000
00001
00002
00003
00004
00005
00006
00007
00008
00009
00010
00011
00012
00013

Verso:
151
Data: 09/04/2015

LTM RAIZEN
INCOMM
VISA PASS FIRST
CENCOSUD
HIPERLIFE
SITPOS
AGT
MIRA
AMBEV 2 SCIO TORCEDOR
JGV
CREDSAT
BRAZILIAN CARD
RIACHUELO
ITS RAIZEN
SIMCRED
BANCRED CARD
CONEKTA
SOFTCARD
ECOPAG
C&A AUTOMAO IBI
C&A PARCERIAS BRADESCARD
OGLOBA
BANESE VOUCHER
RAPP
Monitora POS
SOLLUS
FITCARD
ADIANTI
STONE
DMCARD
ICATU 2

Descrio
Outro, no definido
Visa
Mastercard
Diners
American Express
Sollo
Sidecard (Redecard)
Private Label (Redecard)
Redeshop
Po de Acar
Fininvest (Visanet)
JCB
Hipercard
Aura
Software Express Ltda., 2015

90

Especificao Tcnica Interface com os meios de pagamento do SiTef


Bibliotecas CliSiTefI e CliSiTef
00014
00015
10014

Verso:
151
Data: 09/04/2015

Losango
Sorocred
Discovery

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

Software Express Ltda., 2015

Trilha2,

Timeout);

//

Utilize

91

Especificao Tcnica Interface com os meios de pagamento do SiTef


Bibliotecas CliSiTefI e CliSiTef

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:
151
Data: 09/04/2015

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

Software Express Ltda., 2015

92

Especificao Tcnica Interface com os meios de pagamento do SiTef


Bibliotecas CliSiTefI e CliSiTef

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:
151
Data: 09/04/2015

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

Software Express Ltda., 2015

93

Especificao Tcnica Interface com os meios de pagamento do SiTef


Bibliotecas CliSiTefI e CliSiTef
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:
151
Data: 09/04/2015

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.

Software Express Ltda., 2015

94

Especificao Tcnica Interface com os meios de pagamento do SiTef


Bibliotecas CliSiTefI e CliSiTef

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:
151
Data: 09/04/2015

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

Software Express Ltda., 2015

95

Especificao Tcnica Interface com os meios de pagamento do SiTef


Bibliotecas CliSiTefI e CliSiTef
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
-

21/12/2012
02/01/2013

4.0.106.18 r1
4.0.106.18 r1

Verso:
151
Data: 09/04/2015

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).
Parmetro HabilitaRedeDotz
Incluso da descrio dos campos 1 e 2, alm do detalhamento do
campo 100.

Software Express Ltda., 2015

96

Especificao Tcnica Interface com os meios de pagamento do SiTef


Bibliotecas CliSiTefI e CliSiTef
18/01/2013

4.0.106.18 r1

26/02/2013
06/03/2013
13/03/2013

4.0.106.20 r1
-

29/04/2013

14/06/2013

17/09/2013

02/10/2013
18/10/2013
02/01/2014
13/01/2014

29/01/2014

4.0.111.3 r1

11/02/2014
27/02/2014
02/04/2014
03/04/2014
09/04/2014

4.0.111.4 r1
-

14/05/2014
10/06/2014
17/06/2014
23/06/2014

4.0.111.16 r1

22/07/2014
18/08/2014

4.0.111.18 r1

21/08/2014
28/08/2014

Verso:
151
Data: 09/04/2015

Incluso da modalidade 420, do tipo campo 2355 e alterao no texto


do campo 1122.
Incluso do parmetro ConexaoObrigatoria na seo SiTef
Incluso do tipo campo 5050 na tabela de eventos.
v119 - Reviso editorial do item Informaes do PinPad, e do campo
2355.
Includo esclarecimentos sobre o processo de Descarregamento de
Mensagens.
v120 Correo na descrio de campos especficos ACSP que so
retornados em outras redes, tornando-os genricos.
v121 Incluso do tipo campo 2362 e retificao do tipo campo 131
da Tabela de valores
v122 Correo na descrio do TipoCampo 112.
(Gift) Includos os campos 3553, 3554 e 3557 na tabela de opes de
menu (5.7)
v123 - Retificao do campo para Cancelamento de ativao Gift.
v124 Reviso do item LeCartaoDireto.
v125 Incluso referncia para documento de Tabela de Traduo.
v127 Movida configuraes entre clisitef e sitef do documento
Configuraes Especiais, agora extinto.
Observao sobre a necessidade de chamar a rotina
ConfiguraIntSiTefInterativo(Ex).
Includas funes 770, 771 e 772 para carga de tabelas de pinpad.
Includa funo 775 (informaes do pinpad)
v128 Includa a configurao de porta de pinpad AUTO_USB
para plataforma Windows.
Incluso da rede Consignum
Atualizada descrio do campo 3014.
Atualizados cdigos de erro retornados pelas rotinas.
Incluso do campo 2369 (Brazilian Card).
Incluso da descrio para o campo 205x e diferenciao deste com o
campo 203x, pois ambos se tratam de campos referentes a Hash.
Alterao na descrio do Tipo Campo 1190 de Embosso Gol OffLine para Embosso (4 ltimos dgitos) do carto.
Alterao na descrio do Tipo Campo 110.
Atualizao da Tabela de Cdigo das Redes Autorizadoras.
Mudana na configurao de HabilitaRedeConsignum para
HabilitaRedeMettacard, pois o autorizador Consignum passa a se
chamar Mettacard.
Includas funes LeTrilhaChipInterativo e derivaes ASCII
Alterao na descrio do item 4.1.1 para configurao do pinpad
para reconhecimento automtico de porta USB. Antes da verso
4.0.111.18 r1, era habilitada apenas para Windows. A partir desta
verso permite tambm a configurao para Linux 32, a partir do
kernel 2.6.
Incluso do Tipo Campo 1321.
- Incluso de configurao para realizar transaes com carto
combustvel forando a rede (por exemplo FitCard).
- Incluso do retorno -21 para possveis cdigos de retorno. Item

Software Express Ltda., 2015

97

Especificao Tcnica Interface com os meios de pagamento do SiTef


Bibliotecas CliSiTefI e CliSiTef

05/09/2014
11/09/2014
23/09/2014
16/10/2014
29/10/2014
31/10/2014
28/11/2014
24/02/2015
26/03/2015

09/04/2015
15/04/2015

4.0.112.26 r1

Verso:
151
Data: 09/04/2015

3.2.1.
Incluso dos Tipo Campos 3270, 3271 e 3272 que so opes de
menu para TrnCentre PBM.
Atualizao da lista de redes habilitadas.
Detalhamento das funes/modalidades 10 e 11 incluindo a
informao que so especifica para rede Wappa.
Removidos campos legados 141 e 142.
Includas as modalidades/funes 675 e 676.
Incluso das rotinas LeCartaoDiretoSeguroEx e
LeCartaoDiretoSeguroExA.
Atualizada descrio do campo 731.
Incluso do menu reimpresso especifico outros 3675.
Incluso da modalidade 658 para poder efetuar a transao de Saque
Crdito de forma direta.
Incluso na tabela de eventos os campos 5027, 5028, 5029, 5030,
5031, 5036, 5037, 5038, 5039, 5040, 5041, 5042, 5043, 5044.
Incluso dos campos 587 e 588, sero retornados nas transaes de
recarga.
Incluso da modalidade de pagamento Carto Fidelidade ao
TipoCanpo 100.

Software Express Ltda., 2015

98