Você está na página 1de 114

Especificao Tcnica Interface com os meios de

pagamento do SiTef

Bibliotecas CliSiTefI e CliSiTef

Verso 183

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


No pode ser reproduzido ou utilizado para outros fins que no a interface com algum de nossos produtos.
Especificao Tcnica Interface com os meios de pagamento do SiTef Verso: 182
Bibliotecas CliSiTefI e CliSiTef Data: 07/11/2016

ndice

1. Objetivos 1
1.1 Descrio Resumida 2
1.2 Fluxo Grfico 3
2. Descrio das interfaces com as rotinas disponveis na CliSiTef 4
2.1 Interface padro 4
2.2 Interface ASCII 4
3. API - Rotinas disponveis na CliSiTef 5
3.1 Configurao da biblioteca 6
3.1.1 Configuraes especiais gerais 7
3.2 Incio da transao de Pagamento ou Gerencial 8
3.2.1 Tabela de cdigos de retorno 10
3.2.2 Tabela de cdigos de funes 11
3.3 Continuao do processo de coleta interativo 17
3.3.1 Tabela de cdigos de Comando 20
3.3.2 Tabela de valores para TipoCampo 23
3.3.3 Tabela de Eventos, retornados tambm em TipoCampo 37
3.4 Confirmao ou no do Pagamento 38
3.4.1 Descrio dos parmetros adicionais da funo FinalizaFuncaoSiTefInterativo 39
3.5 Teste da presena de PinPad 43
3.6 Define mensagem permanente para o PinPad 43
3.7 Leitura da trilha 3 do carto 44
3.8 Leitura do carto - rotinas de captura segura 45
3.9 Leitura de senha 49
3.10 Leitura de Confirmao pelo Cliente no PinPad 50
3.11 Correspondente Bancrio (Pagamento de Contas) 51
3.12 Verificao da integridade de um cdigo em barras 52
3.13 Verificao da quantidade de transaes pendentes de confirmao no terminal 54
3.14 Obtendo Verso 54
3.15 Descarregando Mensagens 55
3.16 Informaes do PinPad 55
3.17 Carga de Tabelas no PinPad 57
3.17.1 Com alterao na Automao 57
3.17.2 Sem alterao na Automao 58
4. Arquivo de configuraes CliSiTef.ini ou CLSIT 59
4.1 Configurao do PinPad 59
4.1.1 Configurao da porta 59
4.1.2 Configurao quando a Automao no utilizar pinpad 60
4.1.3 Configurao de um segundo pinpad 60
4.1.4 Definio da mensagem padro 61
4.2 Configurao de conexo com o servidor SiTef 62
4.2.1 Configurao de endereos IP adicionais 62
4.2.2 Configurao da porta do servidor SiTef 62
4.2.3 Obrigatoriedade de conexo 62
4.2.4 Mantendo conexo ativa 63
4.2.5 Configurao do mostrador de comunicao 63

Software Express Ltda., 2016 ii


Especificao Tcnica Interface com os meios de pagamento do SiTef Verso: 182
Bibliotecas CliSiTefI e CliSiTef Data: 07/11/2016

4.2.6 Alterando parmetros de temporizaes (timeout) 64


4.2.7 Como passar um novo valor da compra da transao na CliSiTef 65
4.2.8 Ponto flutuante 66
5. Restrio ou habilitao das formas de pagamento 68
5.1 Restrio durante o processo de finalizao de uma venda 68
5.2 Restrio de forma definitiva 68
5.3 Habilitao de transaes adicionais 69
5.4 Desabilitando transaes 70
5.5 Habilitao de transaes de redes especficas 70
5.6 Tabela de cdigos de meios de pagamento, configuraes e menus 73
5.7 Habilitao de configuraes especiais por transao 83
5.8 Transaes crdito/dbito com carto sem BIN 85
5.9 Habilitao de crdito parcelado quando em um pagamento vinculado 87
6. Arquivos de controle 88
7. Trace 89
7.1 Configurao do perodo que o trace mantido 89
7.2 Configurao de diretrio 89
7.3 Arquivos de trace por terminal 90
7.4 Trace Rotativo 91
7.4.1 Habilitando o trace rotativo 91
7.4.2 Limitando o tamanho dos arquivos 92
7.4.3 Enviando arquivos de trace para o servidor SiTef 92
8. Processo de desenvolvimento/homologao 93
8.1 Arquivo de trace adicional durante a fase de desenvolvimento 93
8.2 Processo de homologao 93
9. Habilitando confirmao do valor no pinpad 94
10. Traduo de mensagens 94
11. Tabelas 95
12. Rotinas descontinuadas 101
13. Envio de informaes adicionais pela Automao 102
14. Anexo I Plataformas suportadas 103

Software Express Ltda., 2016 iii


Especificao Tcnica Interface com os meios de pagamento do SiTef Verso: 182
Bibliotecas CliSiTefI e CliSiTef Data: 07/11/2016

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., 2016 1


Especificao Tcnica Interface com os meios de pagamento do SiTef Verso: 182
Bibliotecas CliSiTefI e CliSiTef Data: 07/11/2016

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., 2016 2


Especificao Tcnica Interface com os meios de pagamento do SiTef Verso: 182
Bibliotecas CliSiTefI e CliSiTef Data: 07/11/2016

1.2 Fluxo Grfico

Software Express Ltda., 2016 3


Especificao Tcnica Interface com os meios de pagamento do SiTef Verso: 182
Bibliotecas CliSiTefI e CliSiTef Data: 07/11/2016

2. 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 Descrio
char * Buffer em texto ASCII terminado por zero binrio.
short int (short) Variveis que ocupam 2 bytes em memria, com e sem sinal,
unsigned short int (ushort) respectivamente.
int, unsigned int (uint) Variveis que ocupam 4 bytes em memria, com e sem sinal,
respectivamente.
void Indica a ausncia de parmetros ou retorno.
<tipo varivel> * Indica que a varivel do tipo varivel est sendo passada como
(exemplo: short int * ou int *) 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., 2016 4


Especificao Tcnica Interface com os meios de pagamento do SiTef Verso: 182
Bibliotecas CliSiTefI e CliSiTef Data: 07/11/2016

3. 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., 2016 5


Especificao Tcnica Interface com os meios de pagamento do SiTef Verso: 182
Bibliotecas CliSiTefI e CliSiTef Data: 07/11/2016

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.

int ConfiguraIntSiTefInterativo (IPSiTef, IdLoja, IdTerminal, Reservado)

int ConfiguraIntSiTefInterativoEx (IPSiTef, IdLoja, IdTerminal,


Reservado, ParametrosAdicionais)

Interface ASCII
ConfiguraIntSiTefInterativoA (Resultado, IPSiTef, IdLoja, IdTerminal,
Reservado)

ConfiguraIntSiTefInterativoExA (Resultado, IPSiTef, IdLoja, IdTerminal,


Reservado, ParmetrosAdicionais)

Interface Interface
Parmetro Tipo Descrio
padro ASCII
Resultado Sada, No usado Fixo 6 Contm o resultado de resposta chamada da
por valor rotina
IPSiTef Entrada, char * Varivel Configura o nome ou endereo IP (em notao .)
por valor do servidor SiTef
IdLoja Entrada, char * Fixo 8 Identifica o nmero da loja perante a rede de
por valor estabelecimentos comerciais.
IdTerminal Entrada, char * Fixo 8 Identifica o pdv perante a loja. Possui o formato
por valor 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.

Observaes Importantes:

Cada terminal dever ter um cdigo nico e


fixo por loja do SiTef. Desta forma o
estabelecimento comercial deve administrar os
cdigos utilizados de forma que nunca exista
repetio de terminais para uma mesma loja. O
servidor SiTef no permite duas ou mais
conexes simultneas utilizando o mesmo par
loja / terminal, derrubando as conexes
anteriores, mantendo apenas a ltima conexo
efetuada; se porventura a transao que estava
em andamento quando da queda da conexo por
PDV duplicado estivesse j em estado pendente
(uma venda por exemplo), o SiTef coloca-a
imediatamente em estado Canc.PDV (Cancelada
pelo PDV), ou seja, esta estar cancelada; o

Software Express Ltda., 2016 6


Especificao Tcnica Interface com os meios de pagamento do SiTef Verso: 182
Bibliotecas CliSiTefI e CliSiTef Data: 07/11/2016

terminal que for desconectado receber a


mensagem Sem conexao SiTef com o cdigo
de erro -5.

Quando o estabelecimento comercial utilizar


Pinpad para leitura de cartes e digitao de
senha e caso o par loja / terminal seja alterado,
isto implicar em nova carga de tabelas no
pinpad a cada alterao. Este mais um motivo
para que o cdigo de terminal seja fixo.
Reservado Entrada, short Fixo 6 Deve ser passado com 0
por valor
ParametrosAdi Entrada, char * Varivel Parmetros adicionais de configurao da CliSiTef
cionais por valor no seguinte Formato:
[<Nome_Parametro_1>=<Valor_Parametro_1>;<N
ome_Parametro_2>=<Valor_Parametro_2>]

As rotinas devolvem um dos seguintes resultados:


Valor Descrio
0 No ocorreu erro
1 Endereo IP invlido ou no resolvido
2 Cdigo da loja invlido
3 Cdigo de terminal invlido
6 Erro na inicializao do Tcp/Ip
7 Falta de memria
8 No encontrou a CliSiTef ou ela est com problemas
9 Configurao de servidores SiTef foi excedida.
10 Erro de acesso na pasta CliSiTef (possvel falta de permisso para escrita)
11 Dados invlidos passados pela automao.
12 Modo seguro no ativo (possvel falta de configurao no servidor SiTef do arquivo .cha).
13 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 >;...]

Software Express Ltda., 2016 7


Especificao Tcnica Interface com os meios de pagamento do SiTef Verso: 182
Bibliotecas CliSiTefI e CliSiTef Data: 07/11/2016

A seguir, descrevemos as funcionalidades previstas neste campo.


Funcionalidade Descrio
MultiplosCupons=1 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.
PortaPinPad=<Porta PinPad> Define a porta em que est conectado o pinpad compartilhado.
Ex:
Windows: [PortaPinPad=1]
Linux: [PortaPinPad=/dev/ttyS0]

3.2 Incio da transao de Pagamento ou Gerencial

int IniciaFuncaoSiTefInterativo (Funcao, Valor, CupomFiscal, DataFiscal,


HoraFiscal, Operador, ParamAdic)

Interface ASCII
IniciaFuncaoSiTefInterativoA (Resultado, Funcao, Valor, CupomFiscal,
DataFiscal, HoraFiscal, Operador, ParamAdic)

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


int IniciaFuncaoAASiTefInterativo (Funcao, Valor, CupomFiscal,
DataFiscal, HoraFiscal, Operador, ParamAdic, Produtos)

Interface ASCII
IniciaFuncaoAASiTefInterativoA (Resultado, Funcao, Valor, CupomFiscal,
DataFiscal, HoraDiscal, Operador, ParamAdic, Produtos)

Interface Interface
Parmetro Tipo Descrio
padro ASCII
Resultado Sada, No usado Fixo 6 Contm o resultado de resposta chamada da rotina
por valor
Funcao Entrada, int Fixo 6 Seleciona a forma de pagamento, conforme a tabela
por valor Cdigos de Funes a seguir.
Valor Entrada, char * Varivel Contm o valor a ser pago contendo o separador
por valor 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
CupomFiscal Entrada, char * Mx. 20 Nmero do Cupom Fiscal correspondente venda
por valor
DataFiscal Entrada, char * Fixo 8 Data Fiscal no formato AAAAMMDD
por valor

Software Express Ltda., 2016 8


Especificao Tcnica Interface com os meios de pagamento do SiTef Verso: 182
Bibliotecas CliSiTefI e CliSiTef Data: 07/11/2016

HoraFiscal Entrada, char * Fixo 6 Horrio Fiscal no formato HHMMSS


por valor
Operador Entrada, char * Mx. 20 Identificao do operador de caixa
por valor
ParamAdic Entrada, char * Varivel Parmetros adicionais. Permite que o aplicativo
por valor 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
Produtos Entrada, char * Varivel Contm a lista de produtos que o cliente est
por valor adquirindo no terminal de Auto-Atendimento.
obrigatrio pois tais produtos faro parte integrante
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 Formato
Descrio 1 a 14 caracteres
Cdigo 1 a 08 caracteres
Quantidade 1 a 04 dgitos
Valor 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., 2016 9


Especificao Tcnica Interface com os meios de pagamento do SiTef Verso: 182
Bibliotecas CliSiTefI e CliSiTef Data: 07/11/2016

3.2.1 Tabela de cdigos de retorno

No retorno a rotina devolve um dos seguintes valores:


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

Software Express Ltda., 2016 10


Especificao Tcnica Interface com os meios de pagamento do SiTef Verso: 182
Bibliotecas CliSiTefI e CliSiTef Data: 07/11/2016

3.2.2 Tabela de cdigos de funes

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

50 Venda Boleto Carrefour


51 Venda Autorizacao Carrefour
52 Recebimento Carrefour
53 Incluso de Boleto Carrefour
54 Incluso de Venda Carrefour
55 Consulta Recebimento Carrefour
56 Consulta Limite mnimo PromoFlex Carrefour
57 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 Abre o menu de transaes Gerenciais


111 Teste de comunicao com o SiTef
112 Menu Re-impresso
113 Re-impresso comprovante especfico
114 Re-impresso ultimo comprovante
115 Pr-autorizao
116 Captura de pr-autorizao
117 Ajuste de pr-autorizao
118 Consulta de pr-autorizao

150 Consulta Bnus


151 Consulta Saldo Carto Presente
152 Consulta Saldo Carto Gift

Software Express Ltda., 2016 11


Especificao Tcnica Interface com os meios de pagamento do SiTef Verso: 182
Bibliotecas CliSiTefI e CliSiTef Data: 07/11/2016

160 Consultas Carto SEM


161 Vendas Carto EMS

200 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
201 Cancelamento Telemarketing: Similar a modalidade 200 s que para a funo de
cancelamento de transao de crdito digitado
202 Cancelamento Pr-autorizao
203 Cancelamento da Captura da Pr-autorizao
210 Cancelamento de venda com carto de Crdito
211 Cancelamento de venda com carto de Dbito
212 Cancelamento de venda com carto Combustvel
213 Cancelamento de Venda com Carto Gift
250 Cancelamento de Consulta Bnus
251 Cancelamento Recarga Carto Presente
253 Cancelamento Acmulo de Pontos Carto Bnus
254 Resgate de Pontos Carto Bnus
255 Cancelamento de Resgate de Pontos Carto Bnus
256 Acmulo de Pontos Carto Bnus
257 Cancelamento Recarga Carto Gift

260 Recarga Carto Bnus


262 Recarga Carto Presente (Carrefour)
264 Recarga Carto Gift
265 Ativao Pagamento Vinculado Carto Gift
266 Consulta Carto Gift
267 Ativao Carto Gift Sem Pagamento
268 Ativao Carto Gift Com Pagamento
269 Ativao Desvinculada Carto Gift

300 Recarga de pr-pago


301 Recarga de pr-pago desvinculada do pagamento
302 Recarga de pr-pago sem coleta de valor
303 Recarga de pr-pago desvinculada do pagamento e sem coleta de valor

310 Corresponde Bancrio (Pagamento de Contas)


311 Pagamento de Contas com Saque

312 Consulta para Pagamento Desvinculado (Genrico)


313 Pagamento Desvinculado (Genrico)
314 Recarga Pr Pago HSBC com Saque
315 Saque para Pagamento
316 Cancelamento do pagamento desvinculado (genrico)
317 Consulta Limites do Correspondente Bancrio
318 Recarga Pr Pago Bradesco
319 Recarga Pr Pago Bradesco desvinculada do pagamento
320 Recarga Pr Pago HSBC

Software Express Ltda., 2016 12


Especificao Tcnica Interface com os meios de pagamento do SiTef Verso: 182
Bibliotecas CliSiTefI e CliSiTef Data: 07/11/2016

321 Recarga Pr Pago HSBC desvinculada do pagamento

322 Depsito Identificado


323 Transferncia entre Contas
324 Pague Fcil
325 Revalidao de Senha INSS

350 Venda Produto (Sem Valor)


351 Cancelamento de Venda Produto (Sem Valor)

354 Ultragaz Revenda

400 Vale-Gs
401 Validao Vale-Gs
410 Troco Surpresa

411 Troco Premiado


412 Cancelamento Troco Premiado

420 Troco Solidrio / Doao solidria

422 Adeso de Seguro

430 Le Carto Seguro (LeCartaoSeguro)


431 Le Trilha Chip (LeTrilhaChipInterativoEx)

500 Consulta Detalhada ACSP


501 Consulta Detalhada Serasa
502 Consulta Cadastral Infocard

521 Cancelamento GoldenFarma (PBM)


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

530 Consulta Fidelize (PBM)


531 Venda Fidelize (PBM)
532 Cancelamento Parcial Fidelize (PBM)
533 Cancelamento Total Fidelize (PBM)

540 Pr-autorizao PharmaSystem


541 Recuperao de pr-autorizao PharmaSystem
542 Venda PharmaSystem
543 Cancelamento PharmaSystem

550 Obtem Autorizao PBM


552 Venda PBM
553 Cancelamento Parcial PBM
554 Cancelamento Total PBM

Software Express Ltda., 2016 13


Especificao Tcnica Interface com os meios de pagamento do SiTef Verso: 182
Bibliotecas CliSiTefI e CliSiTef Data: 07/11/2016

560 Consulta Telenet/Funcional Card (PBM)


561 Venda Telenet/Funcional Card (PBM)
562 Cancelamento Telenet/Funcional Card (PBM)
563 Pr-autorizao Telenet/Funcional Card (PBM)
564 Consulta cliente Telenet/Funcional Card (PBM)

570 Consulta EPharma(PBM)


571 Venda EPharma (PBM)
572 Cancelamento Parcial EPharma (PBM)
573 Cancelamento Total EPharma (PBM)

580 Consulta PrevSaude (PBM)


581 Venda PrevSaude (PBM)
582 Cancelamento Parcial PrevSaude (PBM)
583 Cancelamento Total PrevSaude (PBM)

590 Consulta Operadoras TrnCentre (PBM)


591 Consulta Pr Autorizao TrnCentre (PBM)
592 Venda sem Pr Autorizao TrnCentre (PBM)
593 Venda com Pr Autorizao TrnCentre (PBM)
594 Cancelamento TrnCentre (PBM)

600 Consulta Saldo


601 Consulta Saldo Carto de Dbito
602 Consulta Saldo Carto de Crdito

605 Consulta Saldo Carto Combustvel


606 Consulta Redes Carto Combustvel
607 Consulta Produtos Carto Combustvel

610 Transaes SPTrans (Bilhete nico)


611 Consulta Saldo SPTrans (Bilhete nico)
612 Recarga SPTrans (Bilhete nico)
614 Pagamento de Recarga SPTrans (Bilhete nico)
615 Consulta de Produtos SPTrans (Bilhete nico)
616 Recarga SPTrans desvinculada de pagamento (Bilhete nico)

613 Carto Marisa (Orbital)

618 Venda Hopi Hari com Consulta de Produtos


619 Consulta de Produtos Hopi Hari
620 Venda Hopi Hari sem Consulta de Produtos
621 Cancelamento Hopi Hari

625 Venda Voucher com Consulta Forncedores/Produtos


626 Consulta Forncedores/Produtos Voucher
627 Venda Voucher sem Consulta Forncedores/Produtos

Software Express Ltda., 2016 14


Especificao Tcnica Interface com os meios de pagamento do SiTef Verso: 182
Bibliotecas CliSiTefI e CliSiTef Data: 07/11/2016

628 Cancelamento venda Voucher

630 Opes de transaes NPTC


631 Consulta Saldo NPTC
632 Atualizao Carto NPTC
633 Consulta Produtos Host NPTC
634 Consulta Produtos PDV NPTC
635 Cadastra Produtos NPTC
636 Troca de senha NPTC
637 Boleto de venda NPTC
638 Venda NPTC
639 Cancelamento de venda NPTC

640 Desbloqueio Carto Riachuelo


641 Troca de senha Carto Riachuelo
642 Venda Riachuelo

649 Venda Private Label Softway/Renner


650 Venda Carto Bandeira Softway/Renner
651 Pagamento de Fatura Softway
652 Desbloqueio de Carto Softway/Renner
653 Troca de Senha Carto Softway/Renner
654 Consulta de Fatura Carto Softway/Renner

655 Venda Pin de Jogos


656 Venda Pin de Recarga

657 Saque Crdito Transferncia


658 Saque Crdito

660 Menu Saque IBI


661 Consulta Saque Banco IBI
662 Saque Banco IBI

663 Saque GetNet


664 Cancelamento Saque GetNet

665 Resgate de Pontos


667 Emisso de Pontos
668 Cancelamento da Emisso de Pontos
669 Carga de Pr Pago
670 Cancelamento de Carga de Pr Pago

671 Consulta Saque com Saque Banco IBI


672 Cancelamento Saque Banco IBI

673 Venda DrogaRaia


674 Cancelamento Venda DrogaRaia

Software Express Ltda., 2016 15


Especificao Tcnica Interface com os meios de pagamento do SiTef Verso: 182
Bibliotecas CliSiTefI e CliSiTef Data: 07/11/2016

675 Pagamento de Fatura IBI


676 Cancelamento de Pagamento de Fatura IBI

680 Consulta Saldo Pr Pago

700 Venda Oi Paggo


701 Cancelamento Oi Paggo
702 Pagamento de contas
703 Cancelamento de Pagamento Carto Benefcio

704 Primeira Compra

705 Pagamento de Fatura

740 Consulta Parcelas Crdito Adm

770 Carga de tabelas no pinpad1


771 Carga forada de tabelas no pinpad (Local)
772 Carga forada de tabelas no pinpad (SiTef)

775 Obteno de informaes do pinpad2

884 Prospeco de Portador WayUp


885 Acumulo de pontos WayUp
886 Resgate de Pontos WayUp
887 Cancelamento de Acumulo de Pontos WayUp
888 Cancelamento de Resgate de Pontos WayUp
889 Consulta de Saque WayUp

899 Recarga de carto de crdito


900 Cancelamento de recarga de carto de crdito

908 Alterao de Senha Dbito

999 Fechamento

1000 Voucher Papel

1
Consulte o item 3.17 - Carga de Tabelas no PinPad para maiores informaes.
2
Consulte o item 3.16 - Informaes do PinPad para maiores informaes.

Software Express Ltda., 2016 16


Especificao Tcnica Interface com os meios de pagamento do SiTef Verso: 182
Bibliotecas CliSiTefI e CliSiTef Data: 07/11/2016

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:

int ContinuaFuncaoSiTefInterativo (Comando, TipoCampo, TamMinimo,


TamMaximo, Buffer, TamBuffer, Continua)

Interface ASCII
ContinuaFuncaoSiTefInterativoA (Resultado, Comando, TipoCampo, TamMinimo,
TamMaximo, Buffer, TamBuffer, Continua)

Interface Interface
Parmetro Tipo Descrio
padro ASCII
Resultado Sada, No usado Fixo 6 Contm o resultado de resposta chamada da rotina
por valor
Comando Sada, int * Fixo 12 Contm no retorno:
por 0 caso a CliSiTef esteja devolvendo algum
referncia 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
TipoCampo Sada, long * Fixo 12 Contm o cdigo do tipo de campo que a automao
por deve tratar. Os tipos existentes esto descritos em
referncia Tabela de valores para TipoCampo
TamMinimo Sada, short * Fixo 6 Quando o Comando for uma coleta de dados,
por contm o tamanho Mnimo e Maximo do campo a
referncia ser lido
TamMaximo Sada, short * Fixo 6
por
referncia
Buffer Entrada e char * Varivel rea de transferncia de dados entre a aplicao e a
sada, CliSiTef. Deve possuir, no mnimo, 20.000 bytes. Se
por valor automao no estiver enviando dados para a
CliSiTef, deve passar esse campo vazio
TamBuffer Entrada, int Fixo 6 Tamanho da rea reservada pela automao para o
por valor campo Buffer
Continua Entrada, int Fixo 6 Contem instrues para a CliSiTef a respeito do
por valor 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., 2016 17


Especificao Tcnica Interface com os meios de pagamento do SiTef Verso: 182
Bibliotecas CliSiTefI e CliSiTef Data: 07/11/2016

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., 2016 18


Especificao Tcnica Interface com os meios de pagamento do SiTef Verso: 182
Bibliotecas CliSiTefI e CliSiTef Data: 07/11/2016

Incio

Inicializa Comando, TipoCampo,


TamMinimo, TamMaximo e
Continua com 0

Inicializa TamBuffer com o


tamanho do Buffer

Chama a rotina
ContinuaFuncaoSiTefInterativo

Retornou Sim Executa o Comando


10000? 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., 2016 19


Especificao Tcnica Interface com os meios de pagamento do SiTef Verso: 182
Bibliotecas CliSiTefI e CliSiTef Data: 07/11/2016

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 Descrio
0 Est devolvendo um valor para, se desejado, ser armazenado pela automao
1 Mensagem para o visor do operador
2 Mensagem para o visor do cliente
3 Mensagem para os dois visores
4 Texto que dever ser utilizado como ttulo na apresentao do menu ( vide comando 21)
11 Deve remover a mensagem apresentada no visor do operador (comando 1)
12 Deve remover a mensagem apresentada no visor do cliente (comando 2)
13 Deve remover mensagem apresentada no visor do operador e do cliente (comando 3)
14 Deve limpar o texto utilizado como ttulo na apresentao do menu (comando 4)
15 Cabealho a ser apresentado pela aplicao. Refere-se a exibio de informaes
adicionais que algumas transaes necessitam mostrar na tela.

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..).
16 Deve remover o cabealho apresentado pelo comando 15.
20 Deve apresentar o texto em Buffer, e obter uma resposta do tipo SIM/NO.

No retorno o primeiro carter presente em Buffer deve conter 0 se confirma e 1 se cancela.


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

Aps a seleo feita pelo usurio, retornar em Buffer o ndice i escolhido pelo operador
(em ASCII)
22 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.
23 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)

Observao: importante que a Aplicao da Automao Comercial no coloque


delays ao tratar este comando. Neste ponto, algum dispositivo (pinpad, leitora de
cdigo de barras...) est efetuando algum processamento (lendo carto/cdigo de barras,
coletando senha) e um delay causa atrasos no acesso aos dados do dispositivo, que
pode no estar mais disponvel acarretando perda de dados e erro de comunicao.

Software Express Ltda., 2016 20


Especificao Tcnica Interface com os meios de pagamento do SiTef Verso: 182
Bibliotecas CliSiTefI e CliSiTef Data: 07/11/2016

29 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 transaes requerem para


identificar qual o tipo de pagamento que est sendo usado.

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.
30 Deve ser lido um campo cujo tamanho est entre TamMinimo e TamMaximo. O campo lido
deve ser devolvido em Buffer.
31 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.

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.
34 Deve ser lido um campo monetrio ou seja, aceita o delimitador de centavos e devolvido
no parmetro Buffer.
35 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.

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.
41 Anlogo ao Comando 30, porm o campo deve ser coletado de forma mascarada.
42 Menu identificado. Deve apresentar um menu de opes e permitir que o usurio selecione
uma delas.

Na chamada o parmetro Buffer contm as opes no formato


classe|1:texto:cdigo:tipo;2:texto:cdigo:tipo;...i:Texto:cdigo:tipo;.

Software Express Ltda., 2016 21


Especificao Tcnica Interface com os meios de pagamento do SiTef Verso: 182
Bibliotecas CliSiTefI e CliSiTef Data: 07/11/2016

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
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 Descrio
0 Classe no definida
1 Forma de pagamento

Tipo Descrio
1 Dinheiro
2 Cheque
3 Dbito
4 Crdito
5 Saque
6 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., 2016 22


Especificao Tcnica Interface com os meios de pagamento do SiTef Verso: 182
Bibliotecas CliSiTefI e CliSiTef Data: 07/11/2016

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.

xx Grupo
00 Cheque
01 Carto de Dbito
02 Carto de Crdito
03 Carto tipo Voucher
05 Carto Fidelidade
98 Dinheiro
99 Outro tipo de carto

nn Sub-Grupo
00 vista
01 Pr-datado
02 Parcelado com financiamento pelo estabelecimento
03 Parcelado com financiamento pela administradora
99 Outro tipo de pagamento

101 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
102 Contm o texto descritivo da modalidade de pagamento que deve ser impresso no cupom
fiscal (p/ex: T.E.F., Cheque, etc...)
105 Contm a data e hora da transao no formato AAAAMMDDHHMMSS
110 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.
111 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., 2016 23


Especificao Tcnica Interface com os meios de pagamento do SiTef Verso: 182
Bibliotecas CliSiTefI e CliSiTef Data: 07/11/2016

112 Contm o texto descritivo da modalidade de cancelamento que deve ser impresso no
cupom fiscal (p/ex: T.E.F., Cheque, etc...).
115 Modalidade Ajuste
120 Buffer contm a linha de autenticao do cheque para ser impresso no verso do mesmo
121 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
122 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
123 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"
125 Cdigo do Voucher
130 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
131 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)
132 Contm um ndice que indica qual o tipo do carto quando esse tipo for identificvel,
segundo uma tabela a ser fornecida (5 posies)
133 Contm o NSU do SiTef (6 posies)
134 Contm o NSU do Host autorizador (20 posies no mximo)
135 Contm o Cdigo de Autorizao para as transaes de crdito (15 posies no mximo)
136 Contm as 6 primeiras posies do carto (bin)
137 Saldo a pagar
138 Valor Total Recebido
139 Valor da Entrada
140 Data da primeira parcela no formato ddmmaaaa
143 Valor gorjeta
144 Valor devoluo
145 Valor de pagamento
146 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.
147 Valor a ser cancelado
150 Contm a Trilha 1, quando disponvel, obtida na funo LeCartaoInterativo
151 Contm a Trilha 2, quando disponvel, obtida na funo LeCartaoInterativo
153 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., 2016 24


Especificao Tcnica Interface com os meios de pagamento do SiTef Verso: 182
Bibliotecas CliSiTefI e CliSiTef Data: 07/11/2016

comercial de forma a obter a senha aberta


154 Contm o novo valor de pagamento
155 Tipo carto Bnus
156 Nome da instituio
157 Cdigo de Estabelecimento
158 Cdigo da Rede Autorizadora Servio H
160 Nmero do cupom original
161 Nmero Identificador do Cupom do Pagamento
170 Venda Parcelada Estabelecimento Habilitada
171 Nmero Mnimo de Parcelas Parcelada Estabelecimento
172 Nmero Mximo de Parcelas Parcelada Estabelecimento
173 Valor Mnimo Por Parcela Parcelada Estabelecimento
174 Venda Parcelada Administradora Habilitada
175 Nmero Mnimo de Parcelas Parcelada Administradora
176 Nmero Mximo de Parcelas Parcelada Administradora
177 Indica que o campo numrico (PBM)
178 Indica que o campo alfanumrico (PBM)
200 Saldo disponvel*, saldo do produto especfico (escolar, vale transporte)
201 Saldo Bloqueado
500 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
501 Tipo do Documento a ser consultado (0 CPF, 1 CGC)
502 Numero do documento (CPF ou CGC)
504 Taxa de Servio
505 Nmero de Parcelas
506 Data do Pr-datado no formato ddmmaaaa
507 Captura se a primeira parcela a vista ou no (0 Primeira a vista, 1 caso contrrio)
508 Intervalo em dias entre parcelas
509 Captura se ms fechado (0) ou no (1)
510 Captura se com (0) ou sem
(1) garantia no pr-datado com carto de dbito
511 Nmero de Parcelas CDC
512 Nmero do Carto de Crdito Digitado
513 Data de vencimento do Carto
514 Cdigo de segurana do Carto
515 Data da transao a ser cancelada (DDMMAAAA) ou a ser re-impressa
516 Nmero do documento a ser cancelado ou a ser re-impresso
517 A rotina est sendo chamada para ler o Nmero do cheque segundo o descrito no tipo de
comando correspondente ao valor 31
518 Cdigo do Item
519 Cdigo do Plano de Pagamento
520 NSU do SiTef Original (Cisa)
521 Nmero do documento de identidade (RG)
522 A rotina est sendo chamada para ler o Nmero do Telefone
523 A rotina est sendo chamada para ler o DDD de um telefone com at 4 dgitos
524 Valor da primeira parcela
525 Valor das demais parcelas
526 Quantidade de cheques

Software Express Ltda., 2016 25


Especificao Tcnica Interface com os meios de pagamento do SiTef Verso: 182
Bibliotecas CliSiTefI e CliSiTef Data: 07/11/2016

527 Data de vencimento do cheque


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

Software Express Ltda., 2016 26


Especificao Tcnica Interface com os meios de pagamento do SiTef Verso: 182
Bibliotecas CliSiTefI e CliSiTef Data: 07/11/2016

590 Nome da Operadora de Celular selecionada para a operao


591 Valor selecionado para a recarga
592 DDD + Nmero do celular a ser recarregado
593 Digito(s) verificadores
594 Cep da localidade onde est o terminal no qual a operao est sendo feita
595 Obsoleto. Nsu do SiTef correspondente a transao de pagamento da Recarga com carto
596 Obsoleto. Nsu do Host Autorizador correspondente a transao de pagamento da Recarga
com carto
597 Cdigo da Filial que atendeu a solicitao de recarga do celular
598 Mensagem da Operadora de Celular
599 Cdigo da rede autorizadora da recarga de celular
600 Data de vencimento do ttulo/convnio no formato DDMMAAAA
601 Valor Pago*
602 Valor Original
603 Valor Acrscimo
604 Valor do Abatimento
605 Data Contbil do Pagamento
606 Nome do Cedente do Titulo. Deve ser impresso no cheque quando o pagamento for feito
via essa modalidade
607 ndice do documento, no caso do pagamento em lote, dos campos 600 a 604 que viro em
seguida
608 Modalidade de pagamento utilizada na funo de correspondente bancrio. Segue a
mesma regra de formatao que o campo de nmero 100
609 Valor total dos ttulos efetivamente pagos no caso de pagamento em lote
610 Valor total dos ttulos no pagos no caso de pagamento em lote
611 NSU Correspondente Bancrio
612 Tipo do documento: 0 Arrecadao, 1 Titulo (Ficha de compensao), 2 Tributo
613 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
614 NSU SiTef transao de pagamento
620 NSU SiTef da transao original (transao de cancelamento)
621 NSU Correspondente Bancrio da transao original (transao de cancelamento)
622 Valor do Benefcio
623 Cdigo impresso no rodap do comprovante do CB e utilizado para re-
impresso/cancelamento
624 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
625 Recibo de retirada
626 Nmero do banco
627 Agncia
628 Dgito da agncia
629 Conta
630 Dgito da conta
631 Valor em dinheiro
632 Valor em cheque
633 Nome do depositante
634 Documento original de Correspondente Bancrio

Software Express Ltda., 2016 27


Especificao Tcnica Interface com os meios de pagamento do SiTef Verso: 182
Bibliotecas CliSiTefI e CliSiTef Data: 07/11/2016

635 Chave do usurio utilizada para comunicao com o Banco


636 Seqencial nico da chave do usurio no Banco
637 Cdigo da Agncia de relacionamento da loja do correspondente
638 Nmero do Cheque CB
639 Nmero da Fatura
640 Nmero do Convnio
641 Data Inicial do Extrato (DDMMAAAA)
642 Data Final do Extrato (DDMMAAAA)
643 Perodo de Apurao
644 Cdigo da Receita Federal
645 Valor da Receita Bruta
646 Percentual Aplicado
647 Valor Principal
648 Valor Multa
649 Valor Juros
650 (interno) Abertura de pinpad remoto
651 (interno) Fechamento de pinpad remoto
652 (interno) Comando de aborta do pinpad remoto
653 (interno) Escrita de pinpad remoto
654 (interno) Leitura de pinpad remoto
670 Dado do PinPad
700 Operadora de ValeGs
701 Produto ValeGs
702 Nmero do ValeGs
703 Nmero de Referncia
704 Cdigo GPS
705 Competncia GPS
706 Identificador Contribuinte
707 Valor INSS
708 Valor Outras Entidades
709 Permite Pagamento de Contas Com Dinheiro (0 No Permite; 1 Permite)
710 Permite Pagamento de Contas Com Cheque (0 No Permite; 1 Permite)
711 Permite Pagamento de Contas Com TEF Dbito (0 No Permite; 1 Permite)
712 Permite Pagamento de Contas Com TEF Crdito (0 No Permite; 1 Permite)
713 Formas de Pagamento utilizadas na transao de Pagamento genrico
714 Valor do Saque
715 Numero do Pedido
716 Valor Limite do Depsito CB
717 Valor Limite do Saque CB
718 Valor Limite do Saque para Pagamento CB
719 Valor do produto ValeGs
722 Valor mnimo de pagamento
723 Identificao do Cliente, apenas para recebimento Carrefour
724 Venda Crdito Parcelada com Plano Habilitada
725 Venda Crdito com Autorizao a Vista Habilitada
726 Venda Crdito com Autorizao Parcela com Plano Habilitada
727 Venda Boleto Habilitada
729 Valor mximo de pagamento

Software Express Ltda., 2016 28


Especificao Tcnica Interface com os meios de pagamento do SiTef Verso: 182
Bibliotecas CliSiTefI e CliSiTef Data: 07/11/2016

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


731 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
732 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
734 Limite minimo de venda para promoes flexveis, com 12 dgitos sendo os 2 ltimos
dgitos referentes as casas decimais
736 Saldo devedor atual, apenas para recebimento Carrefour
737 Motivo (Carrefour)
738 Valor sugerido para o produto selecionado.
739 Cliente Preferencial
750 Valor Pague Fcil CB
751 Valor Tarifa Pague Fcil CB
900 Cdigo Material AURA
901 Cdigo Plano AURA
902 Nome creditado no Cheque AURA
903 Nmero Dossi AURA
910 Tipo de Venda Conductor/Renner : 1 = Venda via Fatura
2 = Venda via Boleto
911 Define se aps a consulta de fatura, deve encadear o pagamento de fatura (Conductor -
Renner)
952 Nmero de autorizao NFCE

Software Express Ltda., 2016 29


Especificao Tcnica Interface com os meios de pagamento do SiTef Verso: 182
Bibliotecas CliSiTefI e CliSiTef Data: 07/11/2016

1002 Data de Validade do Carto (NPTC)


1003 Nome do Portador do Carto (NPTC)
1010 Quantidade de medicamentos - PBM
1011 ndice do medicamento PBM
1012 Cdigo do medicamento PBM
1013 Quantidade autorizada PBM
1014 Preo mximo ao consumidor PBM
1015 Preo recomendado ao consumidor PBM
1016 Preo de venda na farmcia PBM
1017 Valor de reembolso na farmcia PBM
1018 Valor reposio na farmcia PBM
1019 Valor subsdio do convnio PBM
1020 CNPJ convnio PBM
1021 Cdigo do plano do desconto PBM
1022 Possui receita mdica PBM
1023 CRM PBM
1024 UF PBM
1025 Descrio do produto* - PBM
1026 Cdigo do produto PBM
1027 Quantidade do produto PBM
1028 Valor do produto PBM
1029 Data da receita mdica - PBM
1030 Cdigo de autorizao PBM
1031 Quantidade estornada PBM
1032 Cdigo de estorno PBM
1033 Preo recomendado consumidor a vista PBM
1034 Preo recomendado consumido para desconto em folha PBM
1035 Percentual de reposio da farmcia PBM
1036 Comisso de reposio PBM
1037 Tipo de Autorizao PBM
1038 Cdigo do conveniado PBM
1039 Nome do conveniado PBM
1040 Tipo de Medicamento PBM (01Medicamento, 02-Manipulao, 03-Manipulao
Especial, 04-Perfumaria)
1041 Descrio do Medicamento PBM
1042 Condio p/venda: Se 0 obrigatrio utilizar preo Funcional Card (PF)
Se 1 pode vender por preo inferior ao preo PF
1043 Preo funcional card
1044 Preo praticado PBM
1045 Status do medicamento PBM
1046 Quantidade receitada PBM
1047 Referncia PBM
1048 Indicador da venda PBM (0-Produto venda carto 1-Produto venda a vista)
1049 Grupo de Produto (EDMCard: 0 Medicamento; 1 Perfumaria.)
1050 Nome - ACSP
1051 Data de nascimento
1052 Nome da me
1053 Nmero do ttulo de eleitor ACSP
1054 Endereo do telefone consultado ACSP

Software Express Ltda., 2016 30


Especificao Tcnica Interface com os meios de pagamento do SiTef Verso: 182
Bibliotecas CliSiTefI e CliSiTef Data: 07/11/2016

1055 CEP do telefone consultado ACSP


1056 Cidade do telefone consultado ACSP
1057 UF do telefone consultado ACSP
1058 Dados adicionais ACSP
1100 Registro analtico CHECKCHECK
1101 Registro analtico ACSP
1102 Registro analtico SERASA
1103 Imagem tela analtica ACSP
1104 Imagem tela analtica SERASA
1105 Motivo do cancelamento ACSP
1106 Tipo de consulta ACSP
1107 CNPJ Empresa Conveniada
1108 Cdigo da administradora
1109 Dados tabela Telecheque - ACSP
1110 Matrcula do motorista Carto Combustvel
1111 Placa do veculo Carto Combustvel
1112 Quilometragem Carto Combustvel
1113 Quantidade de litros Carto Combustvel
1114 Combustvel principal Carto Combustvel
1115 Produtos de combustvel Carto Combustvel
1116 Cdigo Produto Host Carto Combustvel
1117 Hormetro Carto Combustvel
1118 Linha de Crdito Carto Combustvel
1119 Tipo de Mercadoria Carto Combustvel
1120 Ramo Carto Combustvel
1121 Casas decimais de preos unitrios Carto Combustvel
1122 Quantidade mxima de produtos venda
1123 Tamanho do cdigo do Produto Carto Combustvel
1124 Cdigo do veculo Carto Combustvel
1125 Nome da Empresa Carto Combustvel
1126 Casas decimais da quantidade Carto Combustvel
1127 Retorna quando um carto NPTC exigir coleta de dados no-esperados pela automao.
1128 Lista de Perguntas Carto Combustvel
1129 Permite Coleta de Produto Carto Combustvel
1131 Cdigo do Limite
1132 Quantidade de Titulares
1133 Data de Abertura da Empresa (DDMMAAAA)
1134 Nome do Titular
1135 Complemento do Endereo
1136 Cidade
1137 Estado
1152 Menu de Valores - SPTrans
1160 Produto com Valor de Face - Gift
1190 Embosso (4 ltimos dgitos) do Carto
1191 PAN do carto AES Gol Offline
1192 Portador do carto AES Gol Offline
1193 Data de validade do carto AES Gol Offline
1200 Total de consultas anteriores

Software Express Ltda., 2016 31


Especificao Tcnica Interface com os meios de pagamento do SiTef Verso: 182
Bibliotecas CliSiTefI e CliSiTef Data: 07/11/2016

1201 Valor acumulado das consultas anteriores, contendo 2 dgitos decimais porm sem o
caractere decimal.
1202 Total de consultas efetuadas no dia.
1203 Valor acumulado das consultas no dia, contendo 2 dgitos decimais porm sem o
caractere decimal.
1204 Total de consultas de cheques pr-datados realizados no perodo.
1205 Valor acumulado de cheques pr-datados, contendo 2 dgitos decimais porm sem o
caractere decimal.
1206 Vendedor (Usurio) - PBM
1207 Senha PBM
1208 Cdigo de Retorno PBM
1209 Origem PBM
1321 NSU do Host Autorizador da Transao Cancelada
2000 Campo administrativo
2001 Campo livre
2002 Resultado da leitora SmartNet
2003 Dados obtidos da leitora aps uma operao de dbito do carto SmartVR ou Sodexho
2004 Campo de mensagem do servio D, para mensagens 0x0400
2005 Dados a serem enviados PARA a leitora SmartNet.
2006 Tipo de criptografia
2007 ndice MasterKey
2008 Chave de criptografia
2009 Senha do carto
2010 Cdigo de resposta do autorizador
2011 Bin da rede
2012 Nmero serial do CHIP
2013 Registro de controle do CHIP
2014 Saldo comum, saldo do passe comum
2015 PAN do carto presente
2017 Data primeiro vencimento
2018 Valor total
2019 Valor financiado
2020 Percentual multa
2047 Juros de mora
2048 TAC (Taxa de administrao)
2053 Menu (produto) selecionado Visanet
2054 Tipo Crdito CDC (1 CDC Produto; 2 CDC Servio)
2055 Data/Hora Sitef (Local)
2056 Dia da semana Sitef (Local)
2057 Data/Hora Sitef (GMT)
2058 Dia da Semana Sitef (GMT)
2059 Dados da Forma de Pagamento - SPTrans
2064 Valor pagamento em dinheiro
2065 Cdigo consulta cheque (Genrica EMS)
2066 Nome da filial
2067 Mensagem do autorizador a ser exibida junto com o menu de valores (Se o terminal
permitir)
2068 Valor selecionado atravs de menu
2078 Cdigo do servio

Software Express Ltda., 2016 32


Especificao Tcnica Interface com os meios de pagamento do SiTef Verso: 182
Bibliotecas CliSiTefI e CliSiTef Data: 07/11/2016

2079 Valor do servio


2081 Menu de Produtos
2082 Nosso nmero
2083 Valor total do produto contendo o separador decimal (,) e duas casas decimais aps a
vrgula.
2086 Cdigo do Produto - ValeGas
2087 Demonstrativo de prazos : 0: No; 1: Sim
2088 Cancelamento Total/Parcial : 0: Parcial; 1: Total
2089 Nmero de identificao da fatura.
2090 Tipo do carto Lido:

00 - Magntico
01 - Moedeiro VISA Cash sobre TIBC v1
02 - Moedeiro VISA Cash sobre TIBC v3
03 - EMV com contato
04 - Easy-Entry sobre TIBC v1
05 - Chip sem contato simulando tarja
06 - EMV sem contato
99 - Digitado
2091 Status da ltima leitura do carto

0 - Sucesso.
1 - Erro passvel de fallback.
2 - Aplicao requerida no suportada.
2093 Cdigo do atendente
2101 RUT - Campo usado pelo Ticket Car (Chile)
2102 Comuna - Campo usado pelo Ticket Car (Chile)
2103 Indica se foi transao offline : 1 : Sim
2104 Tipo do carto Combustvel : 1 (Crdito, Ps-pago), 2 (Dbito, Pr-pago)
2107 Cdigo Atividade Giro - Campo usado pelo Ticket Car (Chile)
2108 Nome Atividade Giro - Campo usado pelo Ticket Car (Chile)
2109 Senha temporria
2120 Cdigo Produto Hopi-Hari
2121 Descrio Produto Hopi-Hari
2122 Quantidade Mxima de produtos Hopi-Hari
2123 Produtos Hopi-Hari
2124 Valor da tarifa da Recarga de Celular
2125 Nmero da parcela (2 caracteres) (Hotcard)
2126 Seqencial da transao (6 caracteres) (Hotcard)
2301 Rodap do comprovante da via estabelecimento
2320 Cdigo do Depositante CB
2321 Cdigo do Cliente - CB
2322 Sequencia Carto CB
2323 Via Carto - CB
2324 Tipo do Extrato CB
2325 Valor limite de Transferncia - CB
2326 Valor limite para coleta de CPF/CNPJ CB
2327 CPF/CNPJ do Proprietrio CB
2328 CPF/CNPJ do Portador CB

Software Express Ltda., 2016 33


Especificao Tcnica Interface com os meios de pagamento do SiTef Verso: 182
Bibliotecas CliSiTefI e CliSiTef Data: 07/11/2016

2329 Tipo do documento do Proprietrio - CB


2330 Tipo do documento do Portador - CB
2331 Indica se permite pagamento com carto CB
2332 Valor da Transferncia
2333 Identificao da transao
2334 Pin Code
2340 Data de Entrada do Veculo Estapar
2341 Data de Sada do Veculo Estapar
2342 Hora de Entrada do Veculo Estapar
2343 Hora de Sada do Veculo Estapar
2344 Tipo de Cliente (1: Rotativo; 2: Mensalista) Estapar
2345 Nmero da Sucursal Estapar
2346 Nmero da Aplice Estapar
2347 Nmero do Item - Estapar
2348 Chassi do Veculo Estapar
2349 Nmero da SUSEP - Estapar
2350 Nmero do Dispositivo - Estapar
2351 Vigncia Final Estapar
2352 Flag Interna- Estapar
2355 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) Descrio


A Alfabtico
AN Alfanumrico (ans)
LN Letras no acentuadas e nmeros
N Numrico
Vx Valor com x casas decimais
S Sim/No
M Menu
Mc Menu com confirmao

2361 Indica que foi efetuada uma transao de dbito para pagamento de carn
2362 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.
2369 Pontos a resgatar (numrico sem casa decimal).
2421 Informa se est habilitada a funo de coleta de dados adicionais do cliente (0 ou 1)
2467 Data no Formato DDMMAA Confirmao Positiva
2468 Data no Formato DDMM Confirmao Positiva
2469 Data no Formato MMAA Confirmao Positiva
2470 Campo com Ponto Flutuante
2601 Mensagem para pinpad
2602 Semente Hash
2603 Modalidade para leitura de carto atravs da funo 431.
4000 Status da Pr-Autorizao PBM

Software Express Ltda., 2016 34


Especificao Tcnica Interface com os meios de pagamento do SiTef Verso: 182
Bibliotecas CliSiTefI e CliSiTef Data: 07/11/2016

4001 CRF PBM


4002 UF do CRF PBM
4003 Tipo de venda PBM
4004 Valor total PBM
4005 Valor a vista PBM
4006 Valor carto PBM
4007 Nosso nmero PBM
4008 Percentual de desconto concedido pela administradora (2 casas decimais)
4016 Preo bruto PBM
4017 Preo lquido PBM
4018 Valor a receber da Loja, em centavos PBM
4019 Nmero do lote gerado pela Central PBM
4020 Valor total a receber da loja PBM
4021 Valor total a receber da loja PBM
4022 Soma dos valores da Operao PBM
4023 Nome da operadora PBM
4024 Nome da empresa conveniada PBM
4025 Quantidade de dependentes PBM
4026 Cdigo do dependente PBM
4027 Nome do dependente PBM
4028 Valor a receber do conveniado PBM
4029 Valor do desconto total, em centavos
4030 Valor liquido total, em centavos - PBM
4031 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
4076 Identificao da Loja
Campos reservados para uso da IntPos.dll
8000 a 9999 Campos reservados
* Campos utilizados em um ou mais produtos.

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.

Software Express Ltda., 2016 35


Especificao Tcnica Interface com os meios de pagamento do SiTef Verso: 182
Bibliotecas CliSiTefI e CliSiTef Data: 07/11/2016

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., 2016 36


Especificao Tcnica Interface com os meios de pagamento do SiTef Verso: 182
Bibliotecas CliSiTefI e CliSiTef Data: 07/11/2016

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 Descrio
Eventos de coleta
5000 Indica que a biblioteca est aguardando a leitura de um carto
5001 Indica que a biblioteca est esperando a digitao da senha pelo usurio
5002 Indica que a biblioteca est esperando a digitao dos dados de confirmao positiva pelo
usurio
5003 Indica que a biblioteca est aguardando a leitura do bilhete nico
5004 Indica que a biblioteca est aguardando a remoo do bilhete nico
5005 Indica que a transao foi finalizada
5006 Confirma Dados Favorecido
5007 SiTef Conectado
5008 SiTef Conectando
5009 Consulta OK
5010 Colher Assinatura
5011 Coleta Novo Produto
5012 Confirma Operao
5013 Confirma Cancelamento
5014 Confirma Valor Total
5015 Concluso de Recarga de Bilhete nico
5016 Reservado
5017 Aguardando leitura de carto
5018 Aguardando digitao da senha no PinPad
5019 Aguardando processamento do chip
5020 Aguardando remoo do carto
5021 Aguardando confirmao da operao

5027 Cancelamento da leitura do carto


5028 Cancelamento da digitao da senha no PinPad
5029 Cancelamento do processamento do carto com CHIP
5030 Cancelamento da remoo do carto
5031 Cancelamento da confirmao da operao

5036 Antes da leitura do carto magntico


5037 Antes da leitura do carto com CHIP
5038 Antes da remoo do carto com CHIP
5039 Antes da coleta da senha no pinpad
5040 Antes de abrir a comunicao com o PinPad
5041 Antes de fechar a comunicao com o PinPad
5042 Deve bloquear recursos para o PinPad
5043 Deve liberar recursos para o PinPad
5044 Depois de abrir a comunicao com o PinPad

Software Express Ltda., 2016 37


Especificao Tcnica Interface com os meios de pagamento do SiTef Verso: 182
Bibliotecas CliSiTefI e CliSiTef Data: 07/11/2016

5050 Atualizao de tabelas.


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

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 mesmo Nmero do
Cupom Fiscal e mesma Data Fiscal passados como parmetro.

void FinalizaFuncaoSiTefInterativo (Confirma, CupomFiscal, DataFiscal,


HoraFiscal, ParamAdic);

Interface Interface
Parmetro Tipo Descrio
padro ASCII
Resultado Sada, No usado Fixo 6 Contm o resultado de resposta chamada da rotina
por valor
Confirma Entrada, short Fixo 1 Indica se a transao deve ser confirmada (1) ou
por valor estornada (0)
CupomFiscal Entrada, char * Mx. 20 Nmero do Cupom Fiscal correspondente venda
por valor
DataFiscal Entrada, char * Fixo 8 Data Fiscal no formato AAAAMMDD
por valor
HoraFiscal Entrada, char * Fixo 6 Horrio Fiscal no formato HHMMSS
por valor
ParamAdic Entrada, char * Variavel Parametros adicionais, descritos abaixo. Se no
por valor usado, automao deve passar NULL.

Exemplo: Uma venda realizada pela funo IniciaFuncaoSiTefInterativo, passando como


parmetros Funcao 0, Valor 10,00, Cupom Fiscal 12345, Data Fiscal 20150101, Hora Fiscal
121500. Na confirmao da transao, a funo FinalizaFuncaoSiTefInterativo deve ser chamada
utilizando os seguintes parmetros: Confirma 1, Cupom Fiscal 12345, Data Fiscal 20150101, Hora
Fiscal 121500, ParamAdic como NULL, j que no h dados adicionais.

Software Express Ltda., 2016 38


Especificao Tcnica Interface com os meios de pagamento do SiTef Verso: 182
Bibliotecas CliSiTefI e CliSiTef Data: 07/11/2016

3.4.1 Descrio dos parmetros adicionais da funo FinalizaFuncaoSiTefInterativo

Esse campo deve ser usado nas seguintes situaes:

Finalizao de pagamentos individuais em um mesmo cupom fiscal

Para fazer a (no) confirmao de um determinado pagamento, deve-se inicialmente capturar o


campo 161 (Nmero do pagamento no cupom) retornado no fluxo do pagamento, e repass-lo
rotina FinalizaFuncaoSiTefInterativo como um parmetro adicional:

{NumeroPagamentoCupom=XXX}

onde XXX o nmero do pagamento capturado anteriormente.

Finalizao de pagamentos de uma determinada rede em um mesmo cupom fiscal

Para fazer a (no) confirmao de pagamentos referentes a uma determinada rede, deve-se passar na
rotina FinalizaFuncaoSiTefInterativo() o seguinte parmetro adicional:

{RedeConfirmacao=XXX}

onde XXX o nmero da rede.

Anexar dados referentes s formas de pagamento de uma transao (NFPAG)

Para anexar dados referentes s formas de pagamento de uma transao, devem-se capturar os
campos: 161 (Nmero do pagamento no cupom), 730 (Nmero mximo de formas de pagamento),
731 (Tipos de pagamento habilitados) e 732 (Dados a serem coletados para o tipo de pagamento),
retornados no fluxo da transao, e repass-lo rotina FinalizaFuncaoSiTefInterativo atravs dos
parmetros adicionais NumeroPagamentoNFPAG e NFPAG.

{NumeroPagamentoNFPAG=X}{NFPAG=Y}

Onde:
X = Nmero do pagamento no cupom (Campo 161)
Y = Dados referentes s formas de pagamento (Ver descrio abaixo)

Observao: Neste caso, todos os pagamentos em um mesmo cupom fiscal sero todos confirmados
ou no confirmados.

Software Express Ltda., 2016 39


Especificao Tcnica Interface com os meios de pagamento do SiTef Verso: 182
Bibliotecas CliSiTefI e CliSiTef Data: 07/11/2016

Descrio do parmetro NFPAG:

{NFPAG=FPAG1;FPAG2; FPAG3;...;FPAGn;}

Onde FPAGn tem o seguinte contedo:

Se houver dados a serem coletados

TipoN:ValorN:IDColetaN1:DadoColetaN1-IDColetaN2:DadoColetaN2-...-
IDColetaNn:DadoColetaNn

Se no houver dados a serem coletados

TipoN:ValorN

=> TipoN: indica a forma de pagamento utilizada (Campo 731, conforme tabela abaixo)

=> ValorN: indica o valor utilizado com esta forma de pagamento, com duas casas decimais, sem a
vrgula

=> IDColetaNn: indica o ID do campo que foi coletado pelo PDV (Campo 732, conforme tabela
abaixo)

=> DadoColetaNn: indica o contedo coletado pelo PDV para este campo

Observao: A consistncia dos valores (soma das vrias formas de pagamento utilizadas,
totalizando o valor da transao realizada) deve ser feita pelo PDV.

Exemplo:

Ao final de uma transao no valor de R$ 50,00, retornando o campo 730 igual a 2 e os


campos 731 e 732 indicando que aceita as seguintes formas de pagamento: Dinheiro (sem dados a
serem coletados); TEF Dbito (precisa enviar a Rede Destino, o NSU do Host, a Data do Host e o
Cdigo de Origem da transao de TEF) e TEF Crdito (precisa enviar o Servio Z da transao de
TEF). O campo 730 igual a 2, indica que no parmetro NFPAG podem ser enviados no mximo 2
formas de pagamento.

O PDV, por sua vez, na confirmao da transao, enviar as formas de pagamento que
foram efetivamente utilizadas: R$ 30,00 foram pagos em dinheiro e R$ 20,00 foram pagos com
carto de dbito da Redecard (Rede Destino = 5; NSU do Host = 123456789; Data do Host =
15/12/2008; Cdigo de Origem = 000000000000001).

{NFPAG=00:3000;02:2000:03:5-07:123456789-08:15122008-09:000000000000001;}

Observao: Todas as formas de pagamento devem ser separadas por ; (ponto-e-vrgula), inclusive
o ltimo deve ser finalizado por ;

Software Express Ltda., 2016 40


Especificao Tcnica Interface com os meios de pagamento do SiTef Verso: 182
Bibliotecas CliSiTefI e CliSiTef Data: 07/11/2016

730 Nmero mximo de formas de pagamento a ser enviado atravs do parmetro


NFPAG. 0 para sem limite.
731 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
99 Outras Formas
732 Dados a serem enviados para o Tipo de Pagamento (Campo 731) 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 0: leitura de CMC-7
1: digitao da primeira linha
do cheque
2: digitao do CMC-7
02 Dados do Cheque - CMC-7 lido ou digitado, ou
- digitao da primeira linha do
cheque, com o seguinte
formato: Compensao (3),
Banco (3), Agncia (4), C1 (1),
Conta Corrente (10), C2 (1),
Nmero do Cheque (6) e C3
(1), nesta ordem.
03 Rede Destino (Campo 131) Identificao do autorizador da
transao de TEF.
04 NSU do SiTef da transao de TEF (Campo Identificao da transao de
133) TEF no SiTef.
05 Data do SiTef da transao de TEF No utilizado (Uso futuro).
06 Cdigo da Empresa da transao de TEF Cdigo do SiTef para a
Empresa utilizada na transao
de TEF.
07 NSU do Host da transao de TEF (Campo Identificao da transao de
134) TEF no Host.
08 Data do Host da transao de TEF (Campo Data da transao de TEF no
105) Host, no formato

Software Express Ltda., 2016 41


Especificao Tcnica Interface com os meios de pagamento do SiTef Verso: 182
Bibliotecas CliSiTefI e CliSiTef Data: 07/11/2016

DDMMAAAA.
09 Cdigo de Origem da transao de TEF Cdigo de Estabelecimento da
(Campo 157) transao de TEF.
10 Servio Z da transao de TEF (Campo 1. Valor do servio Z devolvido
Passar apenas o dados de confirmao, pelo mdulo Sit responsvel
retirando os dados do ndice do SiTef e pela transao de TEF.
endereo do SiTef caso existam, segue o
formato desse campo:

DadosConfirmao;IndiceSiTef;EnderecoSiTef

Outra opo seria utilizar a seguinte configurao


no arquivo CliSiTef.ini:

[Geral]
DevolveConfirmacaoExtendida=0

Usando esta configurao, mesmo no caso de


mltiplos SiTef ser retornado apenas o Servio Z
no campo 1 da CliSiTef, dessa maneira tambm
no necessrio alterar o valor do campo na hora
de colocar no prefixo NFPAG.
)
11 Cdigo de Autorizao da transao de TEF Cdigo de Autorizao do Host
(Campo 135) para a transao de TEF.
12 Valor do Cheque Valor Total do Cheque. Um
mesmo cheque pode ser usado
para pagar mais de uma conta.
13 Rede Destino Complemento Complemento do ID 03 (veja
descrio abaixo)

O campo de ID 13, diferente dos demais, no indica um campo que deve ser coletado, ele funciona
apenas como um complemento para o campo de ID 03, enviando a lista de Redes Destino permitidas,
no seguinte formato:

IDColetaNn(Rede1,Rede2,...,RedeN)

Ou seja, caso apenas o campo de ID 03 esteja presente, deve ser coletada a Rede Destino, sem
nenhuma restrio quanto as Redes que podem pagar a Recarga. No entanto, caso estejam presentes
os campos de ID 03 e 13, o primeiro indica que deve ser coletada a Rede Destino, enquanto o
segundo indica quais as Redes Destino que so permitidas para o pagamento da Recarga.

Alm disso, como a coleta foi indicada pelo ID 03, o PDV deve enviar a Rede Destino ao Sit tambm
por meio deste ID (e no pelo ID 13).

Software Express Ltda., 2016 42


Especificao Tcnica Interface com os meios de pagamento do SiTef Verso: 182
Bibliotecas CliSiTefI e CliSiTef Data: 07/11/2016

3.5 Teste da presena de PinPad


Existem duas funes para verificar a presena de pinpad, 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 funo original tem o seguinte formato:

int VerificaPresencaPinPad (void)

A partir da verso 4.0.114.4, foi criada uma segunda funo, onde so enviados menos comandos
para o pinpad, e sem que o visor do pinpad ligue/desligue.
int KeepAlivePinPad (void)

Ambas rotinas no possuem parmetros de entrada, e podem retornar os 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:

int EscreveMensagemPermanentePinPad (Mensagem)

Interface ASCII
EscreveMensagemPermanentePinPadA (Resultado, Mensagem)

Interface Inteface
Parmetro Tipo Descrio
padro ASCII
Resultado Sada, No usado Fixo 6 Contm o resultado de resposta chamada da rotina
por valor
Mensagem Entrada, char * Varivel Mensagem a ser apresentada no visor do PinPad.
por valor 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., 2016 43


Especificao Tcnica Interface com os meios de pagamento do SiTef Verso: 182
Bibliotecas CliSiTefI e CliSiTef Data: 07/11/2016

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:

int LeTrilha3 (Mensagem)

Interface Interface
Parmetro Tipo Descrio
padro ASCII
Resultado Sada, No usado Fixo 6 Contm o resultado de resposta chamada da rotina
por valor
Mensagem Entrada, char * Varivel Mensagem a ser apresentada no visor do PinPad
por valor

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., 2016 44


Especificao Tcnica Interface com os meios de pagamento do SiTef Verso: 182
Bibliotecas CliSiTefI e CliSiTef Data: 07/11/2016

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.

int LeCartaoSeguro (Mensagem)

Interface ASCII
LeCartaoSeguroA (Resultado, Mensagem)

Interface Interface
Parmetro Tipo Descrio
padro ASCII
Resultado Sada, No usado Fixo 6 Contm o resultado de resposta chamada da rotina
por valor
Mensagem Entrada, char * Varivel Mensagem a ser apresentada no visor do PinPad
por valor

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

Observao:
Estas funes, LeCartaoSeguro e LeCartaoSeguroA no so exportadas para ambiente Mobile.
Devido a dificuldades de utilizao de entrypoints de funes, neste ambiente, e visando facilitar a sua
implementao, foi disponibilizada a Funo 430 que uma alternativa para utilizar a funo
LeCartaoSeguro.
Esta Funo segue o fluxo de uma transao Gerencial e acessada atravs de
IniciaFuncaoSiTefInterativo(Ver item 3.2 Incio da transao de Pagamento ou Gerencial).
Para utilizao da Funo 430, o parmetro Mensagem a ser exibida no display do pinpad, ser
solicitada Automao Comercial no fluxo da transao atravs do comando 29 (Ver item 3.3.1
Tabela de cdigos de Comando). Caso no seja fornecida pela Automao, ser exibida a
mensagem default PASSE O CARTAO.

Para leitura do carto atravs da funo 430, foi includo o parmetro adicional SementeHash(no
utilizada quando a funo LeCartaoSeguro chamada diretamente) que opcional e ser solicitado
no fluxo da transao. Se parmetro SementeHash for utilizado, opcionalmente poder ser
fornecida atravs do parmetro ParamAdic na chamada da funo IniciaFuncaoSiTefInterativo,
neste caso, no ser solicitado no fluxo da transao.

Se solicitado no fluxo da transao atravs do comando 29 e o parmetro no utilizado, retornar o

Software Express Ltda., 2016 45


Especificao Tcnica Interface com os meios de pagamento do SiTef Verso: 182
Bibliotecas CliSiTefI e CliSiTef Data: 07/11/2016

campo vazio.

Caso este parmetro seja utilizado, os dados retornados para a Automao Comercial sero hash
geradas a partir da semente informada (Campo tipo 203x. Ver tabela Campos que podem ser
retornados abaixo).

Formato do parmetro em ParamAdic:


{SementeHash=XX...XX}
Onde: XX...XX: Mximo 64 caracteres.

int LeCartaoDiretoSeguro (Mensagem, TipoCampoTrilha1, Trilha1,


TipoCampoTrilha2, Trilha2, Timeout, TestaCancelamento)

Interface ASCII
LeCartaoDiretoSeguroA (Resultado, Mensagem, TipoCampoTrilha1, Trilha1,
TipoCampoTrilha2, Trilha2, Timeout)

Interface Interface
Parmetro Tipo Descrio
padro ASCII
Resultado Sada, No usado Fixo 6 Contm o resultado de resposta chamada da rotina
por valor
Mensagem Entrada, char * Varivel Mensagem a ser apresentada no visor do PinPad
por valor
TipoCampoTrilh Sada, char * Fixo 12 Indica o tipo de campo que foi retornado na trilha 1,
a1 por valor se ele mascarado, criptografado ou em Hash.
Trilha1 Sada, char * Mx. 128 No retorno contm, caso exista, a Trilha 1 lida
por valor
TipoCampoTrilh Sada, char * Fixo 12 Indica o tipo de campo que foi retornado na trilha 2,
a2 por valor se ele mascarado, criptografado ou em Hash.
Trilha2 Sada, char * Mx. 64 No retorno contm, caso exista, a Trilha 2 lida
por valor
Timeout Entrada, short Fixo 6 Define o tempo mximo de espera pela passagem do
por valor carto em segundos. Se zero, espera at que o carto
seja passado
TestaCancela Entrada, Rotina No Rotina da aplicao de automao que retorna 0 se
mento por valor Usado 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 Descrio
0 No ocorreu erro
1 Campo de sada insuficiente

Software Express Ltda., 2016 46


Especificao Tcnica Interface com os meios de pagamento do SiTef Verso: 182
Bibliotecas CliSiTefI e CliSiTef Data: 07/11/2016

2 BIN no aceito
3 CNPJ invlido
4 Chave de acesso vencida
5 Verso invlida
6 Chave de criptografia invlida
7 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.

Campos que podem ser retornados:


TipoCampo Descrio
202x Campos abertos, mascarados.
203x Hash dinmico dos campos
204x Campos criptografados
205x Hash fixo dos campos *

x Campo
1 PAN do carto
2 Vencimento do carto (AAMM)
3 Nome do Cliente
4 Trilha 1
5 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
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)

Software Express Ltda., 2016 47


Especificao Tcnica Interface com os meios de pagamento do SiTef Verso: 182
Bibliotecas CliSiTefI e CliSiTef Data: 07/11/2016

Interface Interface
Parmetro Tipo Descrio
padro ASCII
Resultado Sada, No usado Fixo 6 Contm o resultado de resposta chamada da rotina.
por valor
Mensagem Entrada, char * Varivel Mensagem a ser apresentada no visor do PinPad.
por valor
DadosOut Sada, char * Varivel Retorna os mesmos dados da rotina
por valor 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).
TamDadosOut Entrada, Int Fixo 6 Tamanho do buffer de DadosOut.
por valor
Timeout Entrada, short Fixo 6 Define o tempo mximo de espera pela passagem do
por valor carto em segundos. Se zero, espera at que o carto
seja passado.
TestaCancela Entrada, Rotina No Rotina da aplicao de automao que retorna 0 se
mento por valor Usado para continuar aguardando pelo carto e 1 caso deva
interromper o processo de aguardar a passagem do
carto.

int LeTrilhaChipInterativo (Modalidade)


LeTrilhaChipInterativoEx (Modalidade, ParamAdic)

Interface ASCII
LeTrilhaChipInterativoA (Resultado, Modalidade)

Interface Interface
Parmetro Tipo Descrio
padro ASCII
Resultado Sada, No usado Fixo 6 Contm o resultado de resposta chamada da
por valor rotina
Modalidade Entrada, Int Fixo Seleciona o tipo do pagamento:
por valor 2 : Dbito
3 : Crdito
ParamAdic Entrada, char * Varivel Parmetros adicionais, como o
por valor 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.

Observao:

Software Express Ltda., 2016 48


Especificao Tcnica Interface com os meios de pagamento do SiTef Verso: 182
Bibliotecas CliSiTefI e CliSiTef Data: 07/11/2016

Estas funes, LeTrilhaChipInterativo, LeTrilhaChipInterativoEx e LeTrilhaChipInterativoA


no so exportadas para ambiente Mobile. Devido a dificuldades de utilizao de entrypoints de funes,
neste ambiente, e visando facilitar a sua implementao, foi disponibilizada a Funo 431 para acesso
funo LeTrilhaChipInterativoEx. Esta Funo segue o fluxo de uma transao Gerencial e
acessada atravs de IniciaFuncaoSiTefInterativo(Ver item 3.2 Incio da transao de Pagamento ou
Gerencial).
Para utilizao da Funo 431, o parmetro Modalidade(Tipo do pagamento) e
ParamAdic(SementeHash), sero solicitados Automao Comercial no fluxo da transao
atravs do comando 29 (Ver item 3.3.1 Tabela de cdigos de Comando).

Se parmetro SementeHash for utilizado, opcionalmente poder ser fornecida atravs do


parmetro ParamAdic na chamada da funo IniciaFuncaoSiTefInterativo, neste caso, no ser
solicitado no fluxo da transao. Se solicitado no fluxo da transao atravs do comando 29 e o
parmetro no utilizado, retornar o campo vazio.

Caso este parmetro seja utilizado, os dados retornados para a Automao Comercial sero hash
geradas a partir da semente informada (Campo tipo 203x. Ver tabela Campos que podem ser
retornados acima).

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.

int LeSenhaInterativo (ChaveSeguranca)

Interface ASCII
LeSenhaInterativoA (Resultado, ChaveSeguranca)

Interface Interface
Parmetro Tipo Descrio
padro ASCII
Resultado Sada, No usado Fixo 6 Contm o resultado de resposta chamada da rotina
por valor
ChaveSeguran Entrada, char * Fixo 64 Dados gerados por uma biblioteca de segurana
ca por valor 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., 2016 49


Especificao Tcnica Interface com os meios de pagamento do SiTef Verso: 182
Bibliotecas CliSiTefI e CliSiTef Data: 07/11/2016

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.

int LeSenhaDireto (ChaveSeguranca, SenhaCliente)

Interface ASCII
LeSenhaDiretoA (Resultado, ChaveSeguranca, SenhaCliente)

Interface Interface
Parmetro Tipo Descrio
padro ASCII
Resultado Sada, ----- Fixo 6 Contm o resultado de resposta chamada da rotina
por valor
ChaveSeguran Entrada, char * Fixo 64 Dados gerados por uma biblioteca de segurana
ca por valor fornecida pela Software Express para habilitar a
captura da senha do cliente
Senha Sada, char * Fixo 20 Senha do cliente, em formato criptografado, e que
por valor 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.

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:
int LeSimNaoPinPad (Mensagem)

Interface ASCII
LeSimNaoPinPadA (Resultado, Mensagem)

Interface Interface
Parmetro Tipo Descrio
padro ASCII
Resultado Sada, No usado Fixo 6 Contm o resultado de resposta chamada da rotina
por valor
Mensagem Entrada, char * Varivel Mensagem a ser apresentada no visor do PinPad
por valor

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., 2016 50


Especificao Tcnica Interface com os meios de pagamento do SiTef Verso: 182
Bibliotecas CliSiTefI e CliSiTef Data: 07/11/2016

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:

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

Vale lembrar que o pinpad configurado {PortaPinPadCB=<porta>} atende somente ao


Correspondente Bancrio, no serve para TEFs..

Software Express Ltda., 2016 51


Especificao Tcnica Interface com os meios de pagamento do SiTef Verso: 182
Bibliotecas CliSiTefI e CliSiTef Data: 07/11/2016

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:

int ValidaCampoCodigoEmBarras (Dados, Tipo)

Interface ASCII
ValidaCampoCodigoEmBarrasA (Resultado, Dados, Tipo)

Interface Interface
Parmetro Tipo Descrio
padro ASCII
Resultado Sada, No usado Fixo 6 Contm o resultado de resposta chamada da rotina
por valor conforme descrito a seguir
Dados Entrada, char * Varivel Dados coletados at o momento. Cada campo deve
por valor estar concatenado ao seguinte
Tipo 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

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

Software Express Ltda., 2016 52


Especificao Tcnica Interface com os meios de pagamento do SiTef Verso: 182
Bibliotecas CliSiTefI e CliSiTef Data: 07/11/2016

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

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., 2016 53


Especificao Tcnica Interface com os meios de pagamento do SiTef Verso: 182
Bibliotecas CliSiTefI e CliSiTef Data: 07/11/2016

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)

Interface Interface
Parmetro Tipo Descrio
padro ASCII
Resultado Sada, No usado Fixo 6 Contm o resultado de resposta chamada da rotina
por valor
DataFiscal Entrada, char * Fixo 8 Data Fiscal no formato AAAAMMDD
por valor
CupomFiscal Entrada, char * Mx. 20 Nmero do Cupom Fiscal correspondente venda
por valor

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)

Interface Interface
Parmetro Tipo Descrio
padro ASCII
Resultado Sada, No usado Fixo 6 Contm o resultado de resposta chamada da
por valor rotina
VersaoCliSiTef Sada, char * Mx. 64 No retorno contm a verso da CliSiTef
por valor
VersaoCliSiTefI Sada, char * Mx. 64 No retorno contm, caso exista, a verso da
por valor CliSiTefI

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

Software Express Ltda., 2016 54


Especificao Tcnica Interface com os meios de pagamento do SiTef Verso: 182
Bibliotecas CliSiTefI e CliSiTef Data: 07/11/2016

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.
ObtemInformacoesPinPad funo direta.
Atravs de cdigo de funo passada IniciaFuncaoSiTefInterativo, e consequente processo
interativo.

A primeira forma utilizando a funo abaixo.

int ObtemInformacoesPinPad (InfoPinPad)

Interface
Parmetro Tipo Descrio
padro
InfoPinPad Sada, char * No retorno contm as informaes do PinPad
por valor

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,

Software Express Ltda., 2016 55


Especificao Tcnica Interface com os meios de pagamento do SiTef Verso: 182
Bibliotecas CliSiTefI e CliSiTef Data: 07/11/2016

06 para o Nmero de srie.


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 Descrio
2450 Nome do fabricante
2451 Modelo / verso do hardware
2452 Verso do software bsico/firmware
2453 Verso da especificao
2454 Verso da aplicao bsica
2455 Nmero de srie do PinPad

Software Express Ltda., 2016 56


Especificao Tcnica Interface com os meios de pagamento do SiTef Verso: 182
Bibliotecas CliSiTefI e CliSiTef Data: 07/11/2016

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.

3.17.1 Com alterao na Automao

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 Descrio
Funo
770 Carga de tabelas no pinpad
771 Carga forada de tabelas no pinpad (Local)
772 Carga forada de tabelas no pinpad (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., 2016 57


Especificao Tcnica Interface com os meios de pagamento do SiTef Verso: 182
Bibliotecas CliSiTefI e CliSiTef Data: 07/11/2016

3.17.2 Sem alterao na Automao

Para que a automao se beneficie da carga de tabelas sem ter que programar as chamadas da
IniciaFuncaoSiTefInterativo com os trs cdigos de funo 770, 771 e 772, foram includas no menu
Administrativo da CliSiTef, trs transaes equivalentes.

Na imagem do Menu Administrativo acima:

a transao da opo 11 equivale Funcao 770;


a transao da opo 12 equivale Funcao 771;
a transao da opo 13 equivale Funcao 772.

Para habilitar a transao de Carga de tabelas no pinpad, necessrio incluir na seo [Geral] a
chave TransacoesAdicionaisHabilitadas o valor 3624.

Para habilitar a transao de Carga forcada de tabelas no pinpad (Local), necessrio incluir na
seo [Geral] a chave TransacoesAdicionaisHabilitadas o valor 3625.

A transao de Carga forcada de tabelas no pinpad (SiTef) est habilitada de forma padro, com o
valor 3626.

[Geral]
TransacoesAdicionaisHabilitadas=3624;3625

Software Express Ltda., 2016 58


Especificao Tcnica Interface com os meios de pagamento do SiTef Verso: 182
Bibliotecas CliSiTefI e CliSiTef Data: 07/11/2016

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

Software Express Ltda., 2016 59


Especificao Tcnica Interface com os meios de pagamento do SiTef Verso: 182
Bibliotecas CliSiTefI e CliSiTef Data: 07/11/2016

4.1.2 Configurao quando a Automao no utilizar pinpad

Existem automaes que transacionam somente por digitao.

A CliSiTef por padro, assume que a automao possui um PinPad, e tenta at 3 vezes abrir a
porta (na qual ele estaria conectado #Configurao da porta).

Quando a Automao no utilizar pinpad, configure a chave Porta da seo


[PinPadCompartilhado] com a string NENHUM, conforme abaixo:

[PinPadCompartilhado]
Porta=NENHUM

4.1.3 Configurao de um segundo pinpad

Como foi dito em Correspondente Bancrio (Pagamento de Contas) transaes de Pagamento de


Contas requerem pinpad especifico Bradesco. Geralmente, existe um setor do estabelecimento
comercial somente para este tipo de atendimento.

Se a Automao precisar atender s transaes de TEF no mesmo check-out que atende as


transaes de Pagamento de Contas, possvel configurar um segundo pinpad especifico Bradesco, de
forma que, o pinpad principal (#Configurao da porta) ser usado exclusivamente nas transaes de
TEF.

Software Express Ltda., 2016 60


Especificao Tcnica Interface com os meios de pagamento do SiTef Verso: 182
Bibliotecas CliSiTefI e CliSiTef Data: 07/11/2016

4.1.4 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., 2016 61


Especificao Tcnica Interface com os meios de pagamento do SiTef Verso: 182
Bibliotecas CliSiTefI e CliSiTef Data: 07/11/2016

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., 2016 62


Especificao Tcnica Interface com os meios de pagamento do SiTef Verso: 182
Bibliotecas CliSiTefI e CliSiTef Data: 07/11/2016

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., 2016 63


Especificao Tcnica Interface com os meios de pagamento do SiTef Verso: 182
Bibliotecas CliSiTefI e CliSiTef Data: 07/11/2016

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., 2016 64


Especificao Tcnica Interface com os meios de pagamento do SiTef Verso: 182
Bibliotecas CliSiTefI e CliSiTef Data: 07/11/2016

4.2.7 Como passar um novo valor da compra da transao na CliSiTef

Na seo [Geral] acrescente a chave PermiteAlterarValorPagamento=1, conforme abaixo:

[Geral]
PermiteAlterarValorPagamento=1

Durante o fluxo da transao, a CliSiTef solicitar "Forneca o novo valor do pagamento", atravs
do campo 154.

Software Express Ltda., 2016 65


Especificao Tcnica Interface com os meios de pagamento do SiTef Verso: 182
Bibliotecas CliSiTefI e CliSiTef Data: 07/11/2016

4.2.8 Ponto flutuante

Como a automao informa CliSiTef que sabe tratar campos com ponto flutuante
O tratamento de campos com Ponto Flutuante requer um procedimento executado em conjunto com
a automao.
Para que a Clisitef efetue este procedimento que ser descrito adiante, necessrio que a automao
informe Clisitef que est apta a trat-lo. Para isso, a automao deve passar a string abaixo no
parmetro ParametrosAdicionais na execuo da funo ConfiguraIntSiTefInterativoEx.

[TrataPontoFlutuante=1]

Se este parmetro for omitido e o SiTef solicitar a coleta de campo com Ponto Flutuante, a CliSiTef
solicitar automao, a exibio da mensagem: "Ponto Flutuante nao Suportado pelo PDV".

Procedimento em operao casada com a automao

Se foi informado na Configurao, suportar o recurso de Ponto Flutuante, conforme descrito acima,
a CliSiTef atravs do Comando 0 em conjunto com o TipoCampo 2470, informa Automao a
quantidade de casas decimais no parmetro Buffer, para que esta possa formatar suas telas antes de exibi-
las ao operador (Vide Exemplos de Telas na prxima pgina). Somente aps este pacto com a
Automao, a CliSiTef enviar o comando de coleta do campo com ponto flutuante (atravs dos
comandos 34 ou 30) conforme exemplos abaixo.
Parmetros
ContinuaFuncaoSiTefInterativo:
CliSiTef =========== PDV

Comando TipoCampo
0 2470
Exemplos de quantidade de casas decimais Buffer

Peso do Almoo em gramas com 2 casas 2

Total da Bomba de Combustvel em reais com 3 3


casas

No exemplo onde a quantidade de casas decimais informada foi 2, logo aps, a CliSitef
solicitar o comando 30 (vide exemplo na prxima pgina);
No exemplo onde a quantidade de casas decimais informada foi 3, logo aps, a CliSitef
solicitar o comando 34 (vide exemplo na prxima pgina);

Software Express Ltda., 2016 66


Especificao Tcnica Interface com os meios de pagamento do SiTef Verso: 182
Bibliotecas CliSiTefI e CliSiTef Data: 07/11/2016

Exemplos de Telas

Software Express Ltda., 2016 67


Especificao Tcnica Interface com os meios de pagamento do SiTef Verso: 182
Bibliotecas CliSiTefI e CliSiTef Data: 07/11/2016

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., 2016 68


Especificao Tcnica Interface com os meios de pagamento do SiTef Verso: 182
Bibliotecas CliSiTefI e CliSiTef Data: 07/11/2016

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., 2016 69


Especificao Tcnica Interface com os meios de pagamento do SiTef Verso: 182
Bibliotecas CliSiTefI e CliSiTef Data: 07/11/2016

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.

Software Express Ltda., 2016 70


Especificao Tcnica Interface com os meios de pagamento do SiTef Verso: 182
Bibliotecas CliSiTefI e CliSiTef Data: 07/11/2016

Rede
Accor
ACSP
Algorix
Avista
BancoIbi
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

Software Express Ltda., 2016 71


Especificao Tcnica Interface com os meios de pagamento do SiTef Verso: 182
Bibliotecas CliSiTefI e CliSiTef Data: 07/11/2016

Oboe
Omnion
Orbitall
Parati
Platco
PortalCard
Qualicard
Repom
SasNT
SigaCred
SisCred
Softway
SpcBrasil
SQCF
Starfiche
Sysdata
Telecheque
Teledata
TopCard
Total
Tricard
UpSight
UseCred
Validata
Wappa

Software Express Ltda., 2016 72


Especificao Tcnica Interface com os meios de pagamento do SiTef Verso: 182
Bibliotecas CliSiTefI e CliSiTef Data: 07/11/2016

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 Cdigo


Consulta ou garantia de Cheque (todos os tipos) 10
Consulta Cheque Serasa/Associao Comercial 11
Consulta Cheque Tecban 12
Telecheque Garantido Tecban 13
Garantia Cheque Papel Tecban 14
Carto de dbito (todas as combinaes) (Descontinuado, no usar) 15
Carto de dbito a vista 16
Carto de dbito pr-datado 17
Carto de dbito parcelado 18
Carto de dbito CDC 19
Carto Refeio Eletrnico (Exceto Visanet, neste caso usar 3014) 20
Voucher Papel 21
Carto Benefcio 22
Carto SmartVR/Sodexho com leitora SmartNet 23
Carto de crdito a vista com juros 24
Carto de crdito (todas as combinaes) (Descontinuado, no usar) 25
Carto de crdito a vista 26
Carto de crdito parcelado com financiamento do estabelecimento 27
Carto de crdito parcelado com financiamento da administradora 28
Carto de crdito digitado 29
Carto de crdito magntico 30
Pr-autorizao 31
Carto Fininvest 32
Saque com carto Fininvest 33
Carto de Crdito Pr-rata a vista 34
Carto de Crdito Pr-rata parcelada 35
Consulta parcelas no Carto de Crdito 36
Crdito Cisa 37
Saldo/Extrato Cisa 38
Carto Crdito Infocard 39
Cancelamento de transao com carto de crdito ou dbito 40
Consulta AVS 41
Dbito Digitado 42
Dbito Magntico 43
Crdito Parcelado 44
Private Label Pr-Datado 45
Pagamento Dinheiro 46
Pagamento Private Label com Cheque 47
Paggo 48
Garantia Cheque CDL Rio 49
Pagamento de Conta 50
Estorno de pagamento de conta 51

Software Express Ltda., 2016 73


Especificao Tcnica Interface com os meios de pagamento do SiTef Verso: 182
Bibliotecas CliSiTefI e CliSiTef Data: 07/11/2016

Re-impresso de pagamento de conta 52


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

Software Express Ltda., 2016 74


Especificao Tcnica Interface com os meios de pagamento do SiTef Verso: 182
Bibliotecas CliSiTefI e CliSiTef Data: 07/11/2016

Reimpresso Especfica Redecard 3006


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

Software Express Ltda., 2016 75


Especificao Tcnica Interface com os meios de pagamento do SiTef Verso: 182
Bibliotecas CliSiTefI e CliSiTef Data: 07/11/2016

Altera Senha de Carto Crdito 3054


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

Software Express Ltda., 2016 76


Especificao Tcnica Interface com os meios de pagamento do SiTef Verso: 182
Bibliotecas CliSiTefI e CliSiTef Data: 07/11/2016

Cdigo de Barras do Carn 3102


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

Software Express Ltda., 2016 77


Especificao Tcnica Interface com os meios de pagamento do SiTef Verso: 182
Bibliotecas CliSiTefI e CliSiTef Data: 07/11/2016

Saque Rotativo Fininvest 3164


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

Software Express Ltda., 2016 78


Especificao Tcnica Interface com os meios de pagamento do SiTef Verso: 182
Bibliotecas CliSiTefI e CliSiTef Data: 07/11/2016

Menu carto Condor 3212


Opo crdito parcelado simples 3213
Pagamento carto Condor 3214
Estorno pagamento carto Condor 3215
Consulta extrato Condor 3216
Cancelamento Parcele mais 3217
Menu Starfiche 3218
Menu saque CB Banrisul 3219
Pagamento de conta UP SIGHT 3220
Estorno de Pagamento de conta UP SIGHT 3221
Menu opo NTPC 3222
Menu NTPC 3223
Pagamento com saque 3224
Recarga de celular com saque 3225
Troca de Senha Supervisor PinPad 3226
Menu Crdito CDC 3227
Opo conta pessoa jurdica 3228
Pagamento de conta rede MAR 3229
Estorno pagamento de conta rede MAR 3230
Pagamento de conta rede iCards 3231
Estorno de pagamento de conta rede iCards 3232
Menu opo crdito a vista Resgate Pontos 3261
Menu pagamento de conta Obo 3262
Menu acmulo de pontos Obo 3263
Menu cancelamento acmulo de pontos Obo 3264
Menu venda crdito com autorizao vista 3267
Menu opo carto magntico (PBM) 3270
Menu opo carto digitado (PBM) 3271
Menu opo cdigo de autorizao (PBM) 3272
Menu pagamento de conta Qualicard 3276
Menu estorno de pagamento de conta Qualicard 3277
Menu de autorizao genrica SEM 3278
Menu pagamento de conta rede Avista 3279
Menu carto virtual Formosa 3280
Menu pagamento de contas Neus 3281
Menu estorno de pagamento de contas Neus 3282
Menu pagamento de contas Algorix 3283
Menu estorno de pagamento de contas Algorix 3284
Menu carga de carto presente Algorix 3285
Menu de cancelamento de carga de carto presente Algorix 3286
Menu venda crdito CompreMax 3287
Menu cancelamento CompreMax 3288
Menu cancelamento Carto Combustvel 3289
Menu pagamento de contas SysData 3296
Menu estorno de pagamento de contas SysData 3297
Menu consulta de pagamento Validata 3298
Menu pagamento recarga SPTrans (Menu gerencial) 3299
Menu pagamento de conta SQCF 3303

Software Express Ltda., 2016 79


Especificao Tcnica Interface com os meios de pagamento do SiTef Verso: 182
Bibliotecas CliSiTefI e CliSiTef Data: 07/11/2016

Menu cancelamento de pagamento de conta SQCF 3304


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

Software Express Ltda., 2016 80


Especificao Tcnica Interface com os meios de pagamento do SiTef Verso: 182
Bibliotecas CliSiTefI e CliSiTef Data: 07/11/2016

Menu opo de Pagamento c/ carto Magntico (CB) 3376


Menu opo Pagamento de Fatura Digitado (CB) 3377
Menu opo Pagamento de Fatura Magntico (CB) 3378
Menu Pagamento de Fatura genrico 3379
Menu opo Pr Autorizao Carto Combustvel 3389
Menu Ativao Gift 3390
Menu Pagamento Dinheiro Ativao Gift 3391
Menu Pagamento Cheque Ativao Gift 3392
Menu Pagamento Carto Dbito Ativao Gift 3393
Menu Pagamento Carto Crdito Ativao Gift 3394
Menu Pagamento ClubCard 3407
Menu Estorno Pagamento ClubCard 3408
Menu Pagamento Citibank 3409
Menu opo Carto Porto Seguro Auto Magntico 3410
Menu opo Carto Porto Seguro Auto Digitado 3411
Menu Saque ClubCard 3412
Menu Pagamento CredMais 3466
Menu Consulta parcelas crdito 3480
Menu Estorno Pagto. Contas Banco Ibi 3500
Menu Cartao Eletrozema 3510
Menu Cancelamento Cartao Eletrozema 3511
Menu Consulta Eletrozema 3512
Menu Cancelamento de Pagamento de Fatura genrico 3515
Carto EGift (Hug) 3517
Menu formas de pagamento para pagamento de carto Siscred 3530
Saque Gift 3553
Cancelamento de saque Gift 3554
Cancelamento de ativao Gift 3556
Carga de tabelas no pinpad 3624
Carga forcada de tabelas no pinpad (Local) 3625
Carga forada de tabelas no pinpad (SiTef) 3626
Consulta Saldo Alelo (Cielo) 3653
Atualiza Chip -Alelo (Cielo) 3654
Debito Alelo Auto (Cielo) 3655
Reimpresso Especifica Outros 3675
Menu Administrativo WayUp 3700
Acmulo de Pontos WayUp 3701
Resgate de Pontos WayUp 3702
Consulta Saque WayUp 3703
Prospeco de Portador WayUp 3704
Menu de Cancelamentos WayUp 3705
Cancelamento de Acmulo WayUp 3706
Cancelamento de Resgate WayUp 3707
Menu Cdigo de Barras (Tipo de documento Dbito\Crdito para pagamento de carn) 3720
Menu CPF (Tipo de documento Dbito\Crdito para pagamento de carn) 3721
Menu Nmero do Carto (Tipo de documento Dbito\Crdito para pagamento de carn) 3722
Menu Outros (Tipo de documento Dbito\Crdito para pagamento de carn) 3723
Menu Adeso de Seguro Tricard 3742

Software Express Ltda., 2016 81


Especificao Tcnica Interface com os meios de pagamento do SiTef Verso: 182
Bibliotecas CliSiTefI e CliSiTef Data: 07/11/2016

Menu Recarga de carto de crdito 3744


Menu Cancelamento de recarga de carto de crdito 3745
Menu Consulta Saldo Tricard 3746
Pagamento em Dinheiro Ultragz Revenda 3900
Pagamento com TEF Crdito Ultragz Revenda 3901
Pagamento com TEF Dbito Ultragz Revenda 3902

Software Express Ltda., 2016 82


Especificao Tcnica Interface com os meios de pagamento do SiTef Verso: 182
Bibliotecas CliSiTefI e CliSiTef Data: 07/11/2016

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 Descrio
CodigoCliente=xxxxxx Cdigo de cliente de uma determinada loja, limitado a 31 caracteres,
a ser vinculado nos relatrios do SiTef Web.
ExecutaAteLeituraCartao=0 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.
HabilitaVendaViaCodigoBarras=1 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.
ItemMenuIdentificado=1 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.
{MKRede=A,B,C,D} Configurao vlida somente para CliSiTef Reduzida Redecard. Os
parmetros A,B,C,D so ndices das chaves de criptografia
OBS: Esta configurao deve ser Redecard nos POSs. Esses parmetros iro sobrepor os ndices das
passada entre chaves ({}) chaves recebidos no servio 3. Os parmetros C e D sero
separadamente, ou seja, no deve implementados somente a partir da verso (4.0.104.1, a confirmar).
ser concatenada com nenhuma Se alguma chave no for configurada preciso passar o parmetro

Software Express Ltda., 2016 83


Especificao Tcnica Interface com os meios de pagamento do SiTef Verso: 182
Bibliotecas CliSiTefI e CliSiTef Data: 07/11/2016

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 0
- 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., 2016 84


Especificao Tcnica Interface com os meios de pagamento do SiTef Verso: 182
Bibliotecas CliSiTefI e CliSiTef Data: 07/11/2016

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

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, CartaoCombustivel ou Gift 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

[CartaoGift]
Texto1=Condor
Rede1=174

TextoN=MinhaRede
RedeN=nnnn

Software Express Ltda., 2016 85


Especificao Tcnica Interface com os meios de pagamento do SiTef Verso: 182
Bibliotecas CliSiTefI e CliSiTef Data: 07/11/2016

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


crdito, 5 redes de combustvel e 5 redes de gift. Feito isso, quando a automao realizar uma transao
com uma das modalidades descritas acima, a CliSiTef apresentar um menu com todas as redes definidas
e com a opo de dbito, crdito, combustvel ou gift , em que realizada a consulta de bins.
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,, HabilitaCodBarn, HabilitaCodUnitarioGiftn, e
HabilitaEgiftDigitadoGiftn sendo n o ndice da rede.
Para as transaes Gift efetuar as seguintes configuraes para habilitar os seguintes modos de
entrada:
- HabilitaDigitadon: Habilitar o modo de entrada EAN 13.
- HabilitaCodUnitarioGiftn: Habilitar o modo de entrada EAN 128.
- HabilitaEgiftDigitadoGiftn: Essa coleta utilizada quando o autorizador emitir um nmero virtual
que pode ser um nmero enviado por email. Esse nmero ser utilizado com o carto, ser solicitado a
entrada do nmero do Egift.

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

[CartaoGift]

Software Express Ltda., 2016 86


Especificao Tcnica Interface com os meios de pagamento do SiTef Verso: 182
Bibliotecas CliSiTefI e CliSiTef Data: 07/11/2016

Texto1=Condor
Rede1=174
HabilitaDigitado1=0
HabilitaMagnetico1=1
HabilitaCodBar1=0
HabilitaCodUnitarioGift1=0
HabilitaEgiftDigitadoGift1=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-e-
vrgula.
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 Nome da Rede


97 Cartesys
172 SomarCard
178 StarFiche
196 Libercard
205 GoldenFarma
263 FitCard

5.9 Habilitao de crdito parcelado quando em um pagamento vinculado

Por padro da CliSiTef, uma transao de pagamento de contas/recarga/ativao de carto Gift que
tenha um pagamento vinculado no habilitar a opo de parcelamento por padro.
No entanto, existe um parmetro que, em conjunto com a habilitao no SiTef dessas transaes,
pode habilitar essa forma de pagamento na biblioteca. O parmetro o seguinte:
[Geral]
ModalidadesPermitePagVinculadoCredParcAdm=XXX;
ModalidadesPermitePagVinculadoCredParcLoja=XXX;

Onde XXX o cdigo da funo/modalidade que ir executar a transao. Ento, se o desejado for
habilitar o parcelamento na transao de ativao Gift, por exemplo, o cdigo a ser usado seria o 265.

Lembrando que somente possvel habilitar o parcelamento para transaes de crdito.

IMPORTANTE: Como o parcelamento de transaes geralmente tem taxas importante


estudar se para essas transaes vantagem ou no permitir o parcelamento.

Software Express Ltda., 2016 87


Especificao Tcnica Interface com os meios de pagamento do SiTef Verso: 182
Bibliotecas CliSiTefI e CliSiTef Data: 07/11/2016

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

Observao: importante que seja indicada uma pasta local, e no um mapeamento de rede.

Importante: a pasta tmp foi escolhida inicialmente no Linux pelo fato de, geralmente, no haver
problemas de permisso no uso da pasta. Entretanto, um reboot na mquina Linux pode fazer com que os
arquivos sejam apagados.
Desta forma, recomendvel que a automao configure para que a clisitef acesse uma pasta com a
permisso de leitura e escrita. Isto , no usurio de sistema que rodar a automao.

Software Express Ltda., 2016 88


Especificao Tcnica Interface com os meios de pagamento do SiTef Verso: 182
Bibliotecas CliSiTefI e CliSiTef Data: 07/11/2016

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

Observao: esta configurao no aplicada caso o modo Trace Rotativo esteja habilitado.

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., 2016 89


Especificao Tcnica Interface com os meios de pagamento do SiTef Verso: 182
Bibliotecas CliSiTefI e CliSiTef Data: 07/11/2016

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., 2016 90


Especificao Tcnica Interface com os meios de pagamento do SiTef Verso: 182
Bibliotecas CliSiTefI e CliSiTef Data: 07/11/2016

7.4 Trace Rotativo

A partir da verso 4.0.112.45 da CliSiTef, possvel separar cada transao efetuada pela
automao em um arquivo de trace prprio.
Entenda-se transao, ao conjunto de trocas de mensagens sob o mesmo cupom fiscal. Ou seja,
cupom fiscal e data fiscal, passados como parmetro na funo IniciaFuncaoSiTefInterativo (hora fiscal
no considerada).
Por exemplo: uma transao de recarga de celular seguida de um TEF, no mesmo cupom fiscal,
ficam armazenados no mesmo arquivo de trace.
Neste cenrio, os arquivos so gravados na forma:
Transao Windows, Linux e plataformas mobile Plataformas POS
(e outras plataformas no-POS)
1 (mais recente) CliSiTef.dmp TRACE
2 CliSiTef.dmp.1 TRACE.1
3 CliSiTef.dmp.2 TRACE.2
... ...
n (mais antiga) CliSiTef.dmp.n-1 TRACE.n-1

A cada nova transao, os arquivos so rotacionados (renomeados), e os arquivos mais antigos so


removidos, mantendo a quantidade de arquivos desejada.
Esta opo permite tambm o envio destes arquivos para o servidor SiTef, desde que este esteja
configurado com o mdulo NServices.

7.4.1 Habilitando o trace rotativo

Para habilitar a gerao de traces rotativos, deve-se indicar a quantidade de arquivos mxima a
serem armazenados na seo CliSiTef, item TraceRotativo.
[CliSiTef]
TraceRotativo=n

Exemplo: armazenar at 10 transaes


[CliSiTef]
TraceRotativo=10

Observao: ao habilitar a opo de trace rotativo, a configurao NumeroDeDiasNoLog ser


desprezada.

Software Express Ltda., 2016 91


Especificao Tcnica Interface com os meios de pagamento do SiTef Verso: 182
Bibliotecas CliSiTefI e CliSiTef Data: 07/11/2016

7.4.2 Limitando o tamanho dos arquivos

Em situaes onde h restries de espao em disco (POS, por exemplo), pode-se ainda limitar o
tamanho do arquivo de trace. Neste caso, uma mesma transao pode ficar armazenada em um ou mais
arquivos separados.
Para tanto, indique o tamanho (em bytes) do limite do arquivo na seo CliSiTef, item
TamanhoTraceRotativo.
Por exemplo, para limitar o tamanho de cada arquivo em cerca de 32Kb:
[CliSiTef]
TraceRotativo=10
TamanhoTraceRotativo=32768

Observao: a limitao de tamanho s aplicada quando a opo TraceRotativo est habilitada.

7.4.3 Enviando arquivos de trace para o servidor SiTef

possvel submeter os arquivos de trace de uma estao PDV ou terminal POS para o servidor
SiTef. Esta situao pode ser especialmente til para anlise de eventuais problemas em produo.
Ao habilitar a configurao de trace rotativo, automaticamente ser disponibilizada no menu
administrativo da clisitef (funo 110) a opo Envio de trace para o servidor SiTef.
Caso a automao deseje desabilitar esta opo, restrinja o menu 3627. Para maiores informaes,
consulte Restrio ou habilitao das formas de pagamento.
Tambm possvel comandar esta transao atravs da funo 121, que deve ser passada na
IniciaFuncaoSiTefInterativo.

Cdigo da Funo Descrio


121 Envio de arquivos de trace para o servidor SiTef

Em caso de queda na comunicao, a automao pode executar novamente a funo 121 aps o
reestabelecimento do canal. Nesta situao, a clisitef confirmar se deseja continuar o envio anterior.
Ao submeter os arquivos de trace para o servidor SiTef, certifique-se que o mesmo tenha o mdulo
NServices devidamente configurado.

Software Express Ltda., 2016 92


Especificao Tcnica Interface com os meios de pagamento do SiTef Verso: 182
Bibliotecas CliSiTefI e CliSiTef Data: 07/11/2016

8. 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 FinalizaFuncaoSiTefInterativo 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., 2016 93


Especificao Tcnica Interface com os meios de pagamento do SiTef Verso: 182
Bibliotecas CliSiTefI e CliSiTef Data: 07/11/2016

9. 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., 2016 94


Especificao Tcnica Interface com os meios de pagamento do SiTef Verso: 182
Bibliotecas CliSiTefI e CliSiTef Data: 07/11/2016

11. Tabelas

Cdigo das Redes Autorizadoras Descrio


00000 Outra, no definida
00001 Tecban
00002 ITA
00003 BRADESCO
00004 Visanet - Especificao 200001
00005 Redecard
00006 Amex
00007 SOLLO
00008 E CAPTURE
00009 Serasa
00010 SPC Brasil
00011 SERASA DETALHADO
00012 TELEDATA
00013 ACSP
00014 ACSP DETALHADO
00015 TECBIZ
00016 CDL DF
00017 Repom
00018 STANDBY
00019 EDMCARD
00020 CREDICESTA
00021 Banrisul
00022 ACC CARD
00023 Clubcard
00024 ACPR
00025 Vidalink
00026 CCC_WEB
00027 Ediguay
00028 Carrefour
00029 Softway
00030 Multicheque
00031 Ticket combustvel
00032 YAMADA
00033 Citibank
00034 Infocard
00035 BESC
00036 EMS
00037 CHEQUE CASH
00038 Central Card
00039 Drogaraia
00040 OUTRO SERVIO
00041 Accor
00042 EPAY GIFT
00043 Parati
00044 TOKORO

Software Express Ltda., 2016 95


Especificao Tcnica Interface com os meios de pagamento do SiTef Verso: 182
Bibliotecas CliSiTefI e CliSiTef Data: 07/11/2016

00045 Coopercred
00046 SERVCEL
00047 Sorocred
00048 Vital
00049 SAX FINANCEIRA
00050 Formosa
00051 Hipercard
00052 Tricard
00053 CHECK OK
00054 Policard
00055 Cetelem Carrefour
00056 LEADER
00057 Consrcio Credicard Venezuela
00058 GAZINCRED
00059 Telenet
00060 Cheque Pr
00061 Brasil Card
00062 Epharma
00063 Total
00064 Consrcio Amex Venezuela
00065 GAX
00066 Peralta
00067 SERVIDOR PAGAMENTO
00068 BANESE
00069 RESOMAQ
00070 Sysdata
00071 CDL POA
00072 BIGCARD
00073 DTRANSFER
00074 VIAVAREJO
00075 CHECK EXPRESS
00076 Givex
00077 Valecard
00078 Portal Card
00079 Banpara
00080 SOFTNEX
00081 SUPERCARD
00082 GetNet
00083 Prevsaude
00084 BANCO POTTENCIAL
00085 SOPHUS
00086 MARISA 2
00087 MAXICRED
00088 BLACKHAWK
00089 EXPANSIVA
00090 SAS NT
00091 LEADER 2
00092 SOMAR

Software Express Ltda., 2016 96


Especificao Tcnica Interface com os meios de pagamento do SiTef Verso: 182
Bibliotecas CliSiTefI e CliSiTef Data: 07/11/2016

00093 CETELEM AURA


00094 CABAL
00095 CREDSYSTEM
00096 Banco Provincial
00097 CARTESYS
00098 CISA
00099 TRNCENTRE
00100 ACPR D
00101 CARDCO
00102 CHECK CHECK
00103 CADASA
00104 PRIVATE BRADESCO
00105 CREDMAIS
00106 GWCEL
00107 CHECK EXPRESS 2
00108 GETNET PBM
00109 USECRED
00110 SERV VOUCHER
00111 TREDENEXX
00112 Bonus Presente Carrefour
00113 CREDISHOP
00114 ESTAPAR
00115 Banco Ibi
00116 WORKERCARD
00117 Telecheque
00118 OBOE
00119 PROTEGE
00120 SERASA CARDS
00121 Hotcard
00122 Banco Panamericano
00123 Banco Mercantil
00124 Sigacred
00125 Visanet Especificao 4.1
00126 SPTRANS
00127 PRESENTE MARISA
00128 COOPLIFE
00129 BOD
00130 G CARD
00131 TCREDIT
00132 SISCRED
00133 FOXWINCARDS
00134 CONVCARD
00135 Voucher
00136 EXPAND CARDS
00137 Ultragaz
00138 Qualicard
00139 HSBC UK
00140 Wappa

Software Express Ltda., 2016 97


Especificao Tcnica Interface com os meios de pagamento do SiTef Verso: 182
Bibliotecas CliSiTefI e CliSiTef Data: 07/11/2016

00141 SQCF
00142 INTELLISYS
00143 BOD DBITO
00144 ACCREDITO
00145 COMPROCARD
00146 ORGCARD
00147 MINASCRED
00148 Farmcia Popular
00149 Fidelidade Mais
00150 ITA SHOPLINE
00151 CDL RIO
00152 FORTCARD
00153 PAGGO
00154 SMARTNET
00155 INTERFARMACIA
00156 VALECON
00157 CARTO EVANGLICO
00158 VEGASCARD
00159 SCCARD
00160 ORBITALL
00161 ICARDS
00162 FACILCARD
00163 FIDELIZE
00164 FINAMAX
00165 BANCO GE
00166 UNIK
00167 TIVIT
00168 VALIDATA
00169 BANESCARD
00170 CSU CARREFOUR
00171 VALESHOP
00172 SOMAR CARD
00173 OMNION
00174 CONDOR
00175 STANDBYDUP
00176 BPAG BOLDCRON
00177 MARISA SAX SYSIN
00178 STARFICHE
00179 ACE SEGUROS
00180 TOP CARD
00181 GETNET LAC
00182 UP SIGHT
00183 MAR
00184 FUNCIONAL CARD
00185 PHARMA SYSTEM
00186 NEUS
00187 SICREDI
00188 ESCALENA

Software Express Ltda., 2016 98


Especificao Tcnica Interface com os meios de pagamento do SiTef Verso: 182
Bibliotecas CliSiTefI e CliSiTef Data: 07/11/2016

00189 N SERVIOS
00190 CSF CARREFOUR
00191 ATP
00192 AVST
00193 ALGORIX
00194 AMEX EMV
00195 COMPREMAX
00196 LIBERCARD
00197 SEICON
00198 SERASA AUTORIZ CRDITO
00199 SMARTN
00200 PLATCO
00201 SMARTNET EMV
00202 PROSA MXICO
00203 PEELA
00204 NUTRIK
00205 GOLDENFARMA PBM
00206 GLOBAL PAYMENTS
00207 ELAVON
00208 CTF
00209 BANESTIK
00210 VISA ARG
00211 AMEX ARG
00212 POSNET ARG
00213 AMEX MXICO
00214 ELETROZEMA
00215 BARIGUI
00216 SIMEC
00217 SGF
00218 HUG
00219 CARTO CONSIGNUM CARTO METTACARD
00220 DDTOTAL
00221 CARTO QUALIDADE
00222 REDECONV
00223 NUTRICARD
00224 DOTZ
00225 PREMIAES RAIZEN
00226 TROCO SOLIDRIO
00227 AMBEV SCIO TORCEDOR
00228 SEMPRE
00229 FIRST DATA
00230 COCIPA
00231 IBI MXICO
00232 SIANET
00233 SGCARDS
00234 CIAGROUP
00235 FILLIP
00236 CONDUCTOR

Software Express Ltda., 2016 99


Especificao Tcnica Interface com os meios de pagamento do SiTef Verso: 182
Bibliotecas CliSiTefI e CliSiTef Data: 07/11/2016

00237 LTM RAIZEN


00238 INCOMM
00239 VISA PASS FIRST
00240 CENCOSUD
00241 HIPERLIFE
00242 SITPOS
00243 AGT
00244 MIRA
00245 AMBEV 2 SCIO TORCEDOR
00246 JGV
00247 CREDSAT
00248 BRAZILIAN CARD
00249 RIACHUELO
00250 ITS RAIZEN
00251 SIMCRED
00252 BANCRED CARD
00253 CONEKTA
00254 SOFTCARD
00255 ECOPAG
00256 C&A AUTOMAO IBI
00257 C&A PARCERIAS BRADESCARD
00258 OGLOBA
00259 BANESE VOUCHER
00260 RAPP
00261 Monitora POS
00262 SOLLUS
00263 FITCARD
00264 ADIANTI
00265 STONE
00266 DMCARD
00267 ICATU 2
00268 FARMASEG
00269 BIZ
00270 SEMPARAR RAIZEN
00272 PBM GLOBAL
00273 PAYSMART
00275 ONEBOX
00276 CARTO
00277 WAYUP
00301 CTF Frota

Cdigo da Bandeira Descrio


(Carto de Crdito)
00000 Outro, no definido
00001 Visa
00002 Mastercard
00003 Diners
00004 American Express

Software Express Ltda., 2016 100


Especificao Tcnica Interface com os meios de pagamento do SiTef Verso: 182
Bibliotecas CliSiTefI e CliSiTef Data: 07/11/2016

00005 Sollo
00006 Sidecard (Redecard)
00007 Private Label (Redecard)
00008 Redeshop
00009 Po de Acar
00010 Fininvest (Visanet)
00011 JCB
00012 Hipercard
00013 Aura
00014 Losango
00015 Sorocred
10014 Discovery

12. Rotinas descontinuadas

Rotina Antiga Rotina Nova


LeCartaoInterativo LeCartaoSeguro
LeCartaoInterativoA LeCartaoSeguroA
LeCartaoDireto LeCartaoDiretoSeguro
LeCartaoDiretoA LeCartaoDiretoSeguroA
LeCartaoDiretoEx LeCartaoDiretoSeguro
LeCartaoDiretoExA LeCartaoDiretoSeguroA
FinalizaTransacaoSiTefInterativo FinalizaFuncaoSiTefInterativo

Observaes:

1 A funo FinalizaFuncaoSiTefInterativo recebe um parmetro a mais que sua antecessora, a


FinalizaTransacaoSiTefInterativo (ver item 3.4). Caso a automao no necessite usar esse parmetro
adicional, o mesmo deve ser passado como NULL.

Software Express Ltda., 2016 101


Especificao Tcnica Interface com os meios de pagamento do SiTef Verso: 182
Bibliotecas CliSiTefI e CliSiTef Data: 07/11/2016

13. Envio de informaes adicionais pela Automao

A configurao ParmsClient permite que a automao comercial possa incluir informaes


especficas nas transaes trocadas com o servidor SiTef.
Esta configurao deve ser passada nos parmetros adicionais, na chamada da funo
ConfiguraIntSiTefInterativoEx.

int ConfiguraIntSiTefInterativoEx (char *EnderecoIP,


char *CodigoLoja,
char *NumeroTerminal,
short Reservado,
char *ParametrosAdicionais);

O parmetro adicional passado atravs do parmetro ParametrosAdicionais da funo acima no


seguinte
formato entre [ ] colchetes:

[ParmsClient=Id1=Valor1;Id2=Valor2;Id3=Valor3;...;IdN=ValorN], onde:

<ParmsClient=> = Prefixo identificador dos dados.


<IdN> = Identificador do campo, conforme definida a tabela abaixo.
<ValorN> = Valor do campo.

Tag (Identificado do Formato Campo


campo)
1 Numrico CNPJ do
estabelecimento/loja.
2 Numrico CNPJ da empresa que
desenvolveu a automao
comercial
Tabela de Tags (Id) de informaes disponveis.

Abaixo segue o exemplo de como enviar dos dados para a CliSiTef:

[ParmsClient=1=31406434895;2=12523654185985]

Onde:
- 1 (CNPJ do Estabelecimento) com o valor 31406434895111.
- 2 (CNPJ da empresa de automao comercial) com o valor 12523654185985.

Software Express Ltda., 2016 102


Especificao Tcnica Interface com os meios de pagamento do SiTef Verso: 182
Bibliotecas CliSiTefI e CliSiTef Data: 07/11/2016

14. Anexo I Plataformas suportadas

As bibliotecas CliSiTefI e CliSiTef esto disponveis atualmente para as seguintes plataformas:

Sistema Ambientes Arquiteturas


Operacional
Windows Desktop / Intel x86 / x64
Embarcado
Windows CE Embarcado / Mobile Intel x86,
ARM 32
Windows Phone Mobile ARM 32
Mac OS Desktop Intel x64
Linux Desktop / Intel x86 / x64,
Embarcado ARM 32 (v4, v5tej e v6-Raspberry)
Android Mobile Intel x86 / x64,
Mips, Mips64,
ARMEABI / ARMEABI-v7a
ARM 32 (v7a),
ARM 64 (v8a)
IOS Mobile Intel x86 / x64,
ARM 32 (v7/v7s),
ARM 64 (v8a)

Software Express Ltda., 2016 103


Especificao Tcnica Interface com os meios de pagamento do SiTef Verso: 182
Bibliotecas CliSiTefI e CliSiTef Data: 07/11/2016

Histrico de Alteraes
Data Descrio
07/05/2001 Incluso da coleta de um campo tipo VALOR
07/05/2001 Incluso do tipo de campo TROCO para ser tratado pela aplicao
07/05/2001 Incluso da rotina FinalizaTransacaoIntSiTefCuponFiscal
09/05/2001 Incluso do comando para abortar a execuo do mdulo pelo aplicativo
13/05/2001 Incluso de um novo tipo de dado de retorno para indicar o cancelamento
22/05/2001 Incluso de novos tipos de dado de retorno para indicar a instituio que tratou a
autorizao e outros dados relativos a mesma
27/05/2001 Separao do NSU Host do Cdigo de Autorizao no retorno para a aplicao e
alterao no tamanho dos campos de retorno (111 e 112)
04/06/2001 Alterao nos cdigos retornados pela rotina RecebeResultado
21/08/2001 Incluso dos comandos necessrios para apresentar e remover um ttulo nos menus (04 e
14)
07/10/2001 Incluso de rotinas para acesso por linguagens de programao que no possuem a
caracterstica de Callback
21/10/2001 Remoo da rotina FinalizaTransacaoIntSiTef
21/10/2001 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
22/10/2001 Alterao no nome da rotina de configurao quando em modo interativo
08/11/2001 Alterao no formato de captura de cheques para suportar a nova transao do Serasa
(Comando 31)
02/01/2002 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
03/03/2002 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)
14/03/2002 Incluso da possibilidade da automao comercial definir qual o tipo de transao ser
executada
14/03/2002 Alterao na estrutura interna do mdulo para permitir mltiplos pagamentos para um
mesmo cupom fiscal
16/03/2002 Melhoria na documentao e incluso dos campos tratveis pela automao na chamada
a ColetaCampo
16/03/2002 Trocados os cdigos que correspondem ao TipoCampo Trilha 1 e 2
19/03/2002 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
19/03/2002 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
03/04/2002 Incluso de codificao para os campos do Correspondente Bancrio
15/04/2002 Incluso de codificao para o campo Nome do Cedente para ser impresso no cheque de
pagamento do Correspondente Bancrio
03/09/2002 Incluso de funo para uso por terminais de auto-atendimento

Software Express Ltda., 2016 104


Especificao Tcnica Interface com os meios de pagamento do SiTef Verso: 182
Bibliotecas CliSiTefI e CliSiTef Data: 07/11/2016

Incluso de funo para uso por telemarketing/televendas


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)
05/09/2002 Incluso de tabela definindo formato do campo produtos da funo EfetuaPagamento.
09/09/2002 Na funo ContinuaFuncaoSiTefInterativo, o descritivo estava escrito como
ContinuaFuncaoIntSiTef.
19/09/2002 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.
30/09/2002 Remoo de todas as referncias ao modo Callback de funcionamento pois ele deixou de
ser disponibilizado nessa biblioteca.
02/10/2002 Incluso da interface ASCII para aplicativos que no conseguem tratar campos binrios
02/10/2002 Incluso da funo para captura de senha em PinPad com criptografia por hardware
28/10/2002 Correo na descrio da passagem de parmetros da rotina
ContinuaFuncaoSiTefInterativo
12/11/2002 Incluso do retorno da data e hora da transao
27/11/2002 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
10/12/2002 Criao da restrio de cancelamento de pr-autorizao.
27/12/2002 Incluso da possibilidade da automao passar os campos necessrios para executar a re-
impresso Visanet atravs da definio dos tipos de campo 515 e 516
03/01/2003 Includo o tipo de campo 517 para identificar a coleta de um cheque ou seja, o comando
em execuo o 31
13/01/2003 Includo o tipo de campo 517 para identificar a coleta de um cheque ou seja, o comando
em execuo o 31
03/02/2003 Includa uma funo para acesso direto ao PinPad para leitura das trilhas do carto
V. 0.76e magntico, funo esta normalmente utilizada para captura do carto do Supervisor
12/02/2003 Includa uma funo para que o aplicativo de automao possa interromper a funo
V. 0.76h LeCartaoDireto
07/05/2003 Includo um novo retorno que indica dados adicionais sobre o carto utilizado para o
V. 0.80 pagamento (TipoCampo = 112)
28/05/2003 Includo novos cdigos de funo para acesso direto as rotinas de pr-autorizao.
V. 0.81 Corrigido o texto referente ao bloqueio da transao de Pr-autorizao
10/06/2003 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
21/07/2003 Introduzida a funcionalidade de recarga de pr-pago
24/07/2003 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
29/09/2003 Incluso da configurao que permite habilitar somente as transaes desejadas
V. 096a
13/10/2003 Alterao na definio da configurao que permite habilitar somente as transaes
V. 096j desejadas
Eliminao da dll CliSITef32IA

Software Express Ltda., 2016 105


Especificao Tcnica Interface com os meios de pagamento do SiTef Verso: 182
Bibliotecas CliSiTefI e CliSiTef Data: 07/11/2016

14/10/2003 Incluso de novos cdigos para habilitao ou no de menus da CliSiTef32


V. 096k
30/11/2003 Alterao na forma de tratamento dos cupons recebidos como retorno das transaes
V. 097 Gerenciais e Correspondente Bancrio. Incluso de novo exemplo de fluxo de utilizao
da CliSiTefI
25/01/2004 Includo o campo 607 e a devoluo do Nsu do Host para o correspondente bancrio
V. 097m 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
06/02/2004 Includos novos campos no retorno das transaes de Correspondente Bancario
V. 097p
13/02/2004 Includo novo tipo de restrio para a Garantia de Cheque Papel Tecban
V. 097s
04/05/2004 Includa a funcionalidade de recarga de celular utilizando carto de dbito ou crdito e
V. 098j como habilitar tal caracterstica
24/06/2004 Includa forma para bloquear via restries os menus do Correspondente Bancrio
V. 098s
07/07/2004 Includo na documentao a forma da aplicao solicitar um retorno ao campo anterior
----------
23/07/2004 Includa funo para apresentao de mensagem no visor do PinPad e captura de
V. 0.98z8 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
02/08/2004 Modificada a nomenclatura do campo Restries para ParametrosAdicionais uma vez
V. 0.98z8 que esta ltima mais condizente com a funcionalidade oferecida por ele
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., 2016 106


Especificao Tcnica Interface com os meios de pagamento do SiTef Verso: 182
Bibliotecas CliSiTefI e CliSiTef Data: 07/11/2016

Histrico de Alteraes
Data Verses mnimas Descrio
CliSiTefI
CliSiTef
26/08/2004 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
09/09/2004 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
09/09/2004 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
19/11/2004 1.00.a.5 Devoluo do cdigo em barras cujo pagamento foi aprovado
1.00.a.42
28/12/2005 1.00.a.5 Incluso do TipoCampo 518 e 519 na tabelas de valores para Tipo
1.00.a.5 Campo.
04/04/2006 1.00.a.20 Incluso da possibilidade de gerar trace em aberto para auxiliar o
desenvolvimento da interface com a CliSiTef
17/08/2006 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
08/11/2006 ???? Incluso de novos campos para tratamento do carto combustvel
(GoodCard e PortalCard).
15/01/2006 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.
17/08/2007 Acrescentados cdigos de redes autorizadoras tabela existente.
06/02/2008 1.01.c.080.1 Incluso do campo tipo 1131 e dos menus 3063,3064,3065.
18/03/2008 1.01.c.082.1 Descrio de configuraes especiais no parmetro ParamAdic.
28/03/2008 1.01.c.082.2 Incluso do campo tipo 1049.
17/07/2008 1.01.c.089.1 Incluso de campos para a rede Condor, Starfiche e SEM
01/06/2009 1.01.c.094.57 Incluso das configuraes especiais EMS.
Incluso dos campos do pagamento de carto Qualicard.
08/06/2009 1.01.c.094.63 Incluso autorizao genrica EMS.
01/07/2009 1.01.c.094.71 Incluso da rede Pharma System
23/07/2009 1.01.c.094.31 Incluso da rede Obo
23/07/2009 1.01.c.94.xx Incluso da rede Avista
11/08/2009 1.01.c.94.xx Incluso do menu venda crdito com autorizao vista
12/08/2009 1.01.c.94.105 Incluso do carto virtual Formosa.
20/08/2009 1.01.c.94.109 Incluso do carto Neus.
27/08/2009 1.01.c.94.113 Incluso da rede Algorix
14/09/2009 1.01.c.94.129 Incluso do PBM Fidelize
30/09/2009 1.01.c.94.135 Incluso da rede CompreMax
07/10/2009 1.01.c.94.137 Incluso do cancelamento de carto combustvel genrico

Software Express Ltda., 2016 107


Especificao Tcnica Interface com os meios de pagamento do SiTef Verso: 182
Bibliotecas CliSiTefI e CliSiTef Data: 07/11/2016

12/01/2010 1.01.c.94.191 Incluso do campo 537 (cdigo de rea da cidade do cheque)


27/01/2010 1.01.c.94.195 Documentao do campo 2054 para o tipo de CDC Crdito.
28/01/2010 1.01.c.94.201 Incluso da rede SQCF
11/02/2010 1.01.c.94.207 Incluso da opo Carto Gridcard
14/06/2010 - Reservado o Range de 8000 a 9999 para a tabela de Tipo Campos
para a IntPos.dll.
06/07/2010 1.01.c.94.254 Incluso dos menus de saque/estorno de saque GetNet
06/08/2010 1.01.c.94.259 Incluso da funo Consulta Saque com Saque Banco IBI
21/09/2010 1.01.c.94.265 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).
21/10/2010 Includo campo 3334 (Pagamento SPTrans) e modalidades 700 e 701
(Oi Paggo)
11/11/2010 1.01.c.95.13 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).
06/12/2010 - Adicionadas descries dos cdigos de erro -43, -50 e -100. Eventos
5011, 5012 e 5013.
28/01/2011 - Incluso do campo 2301.
Criada tabela de Modalidades, para melhor visualizao.
18/02/2011 Incluso dos campos 2125 e 2126 (fatura HotCard).
11/05/2011 4.0.102.3.r1 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)

27/05/2011 4.0.102.6.r1 Parmetro HabilitaRedeTricard


13/06/2011 4.0.102.7.r1 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).
08/07/2011 4.0.102.9.r1 Incluso do campo 5501.
12/07/2011 - Corrigido o nome da rede InfoCard nas redes habilitadas.
01/08/2011 4.0.102.10.r1 Incluso da rede TopCard e da transao de Pagamento de Fatura
Genrico (3379)
22/09/2011 4.0.102.12 r1 Incluso do modo 2:(Digitao do CMC-7) na captura do cheque
25/10/2011 4.0.102.12 r14 Incluso dos campos 3407 e 3408; Incluso da Rede ClubCard
15/12/2011 - Alterao na descrio do campo 178 que estava errada.
09/05/2012 4.0.104.6 b6 Incluso do tipo campo 3409; Incluso da Rede Citibank
14/11/2012 - Reviso geral do documento; incluso de tipos de parmetro
(entrada/sada e valor/referncia).
21/12/2012 4.0.106.18 r1 Parmetro HabilitaRedeDotz
02/01/2013 4.0.106.18 r1 Incluso da descrio dos campos 1 e 2, alm do detalhamento do
campo 100.

Software Express Ltda., 2016 108


Especificao Tcnica Interface com os meios de pagamento do SiTef Verso: 182
Bibliotecas CliSiTefI e CliSiTef Data: 07/11/2016

18/01/2013 4.0.106.18 r1 Incluso da modalidade 420, do tipo campo 2355 e alterao no texto
do campo 1122.
26/02/2013 4.0.106.20 r1 Incluso do parmetro ConexaoObrigatoria na seo SiTef
06/03/2013 - Incluso do tipo campo 5050 na tabela de eventos.
13/03/2013 - v119 - Reviso editorial do item Informaes do PinPad, e do campo
2355.
Includo esclarecimentos sobre o processo de Descarregamento de
Mensagens.
29/04/2013 - v120 Correo na descrio de campos especficos ACSP que so
retornados em outras redes, tornando-os genricos.
14/06/2013 - v121 Incluso do tipo campo 2362 e retificao do tipo campo 131
da Tabela de valores
17/09/2013 - v122 Correo na descrio do TipoCampo 112.
(Gift) Includos os campos 3553, 3554 e 3557 na tabela de opes de
menu (5.7)
02/10/2013 - v123 - Retificao do campo para Cancelamento de ativao Gift.
18/10/2013 - v124 Reviso do item LeCartaoDireto.
02/01/2014 - v125 Incluso referncia para documento de Tabela de Traduo.
13/01/2014 - 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)
29/01/2014 4.0.111.3 r1 v128 Includa a configurao de porta de pinpad AUTO_USB
para plataforma Windows.
11/02/2014 4.0.111.4 r1 Incluso da rede Consignum
27/02/2014 - Atualizada descrio do campo 3014.
02/04/2014 Atualizados cdigos de erro retornados pelas rotinas.
03/04/2014 Incluso do campo 2369 (Brazilian Card).
09/04/2014 Incluso da descrio para o campo 205x e diferenciao deste com o
campo 203x, pois ambos se tratam de campos referentes a Hash.
14/05/2014 Alterao na descrio do Tipo Campo 1190 de Embosso Gol Off-
Line para Embosso (4 ltimos dgitos) do carto.
10/06/2014 Alterao na descrio do Tipo Campo 110.
17/06/2014 Atualizao da Tabela de Cdigo das Redes Autorizadoras.
23/06/2014 4.0.111.16 r1 Mudana na configurao de HabilitaRedeConsignum para
HabilitaRedeMettacard, pois o autorizador Consignum passa a se
chamar Mettacard.
22/07/2014 Includas funes LeTrilhaChipInterativo e derivaes ASCII
18/08/2014 4.0.111.18 r1 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.
21/08/2014 Incluso do Tipo Campo 1321.
28/08/2014 - 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., 2016 109


Especificao Tcnica Interface com os meios de pagamento do SiTef Verso: 182
Bibliotecas CliSiTefI e CliSiTef Data: 07/11/2016

3.2.1.
05/09/2014 Incluso dos Tipo Campos 3270, 3271 e 3272 que so opes de
menu para TrnCentre PBM.
11/09/2014 Atualizao da lista de redes habilitadas.
23/09/2014 Detalhamento das funes/modalidades 10 e 11 incluindo a
informao que so especifica para rede Wappa.
16/10/2014 Removidos campos legados 141 e 142.
29/10/2014 Includas as modalidades/funes 675 e 676.
31/10/2014 Incluso das rotinas LeCartaoDiretoSeguroEx e
LeCartaoDiretoSeguroExA.
28/11/2014 Atualizada descrio do campo 731.
24/02/2015 Incluso do menu reimpresso especifico outros 3675.
26/03/2015 4.0.112.26 r1 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.
09/04/2015 Incluso dos campos 587 e 588, sero retornados nas transaes de
recarga.
15/04/2015 Incluso da modalidade de pagamento Carto Fidelidade ao
TipoCanpo 100.
27/05/2015 Incluso dos cdigos de menus 3624, 3625 e 3626.
Incluso do item 3.18 Carga de Tabelas no PinPad sem alterao na
Automao;
Incluso do item 4.1.2 Configurao quando a Automao no
utilizar pinpad;
Incluso do item 4.2.7 Como passar um novo valor da compra da
transao na CliSiTef
29/05/2015 Incluso do item 4.1.3 Configurao de um segundo pinpad
27/08/2015 Esclarecimento para o item 3.4, Confirmao ou No do Pagamento.
A confirmao da transao deve possuir mesmo nmero de cupom
fiscal e mesma data da transao realizada para ser confirmada com
sucesso.
14/09/2015 4.0.112.42 r1 - Incluso de configurao para realizar transaes com carto Gift
forando a rede (por exemplo Condor).
01/10/2015 - Incluso dos campos 2467, 2468 e 2469.
19/10/2015 - Incluso tpico Prefixo Especifico Enviado pela Automao
10/11/2015 4.0.112.45 r1 Observaes adicionais para definio da pasta de armazenamento de
arquivos de controle.
Incluso das configuraes para trace rotativo.
11/11/2015 - Incluso tpico Plataformas Suportadas.
02/12/2015 Alterao da descrio dos campos 3720, 3721, 3722, 3723
10/12/2015 Atualizado transao Carto Presente - Modalidade 262 , uso
exclusivo do Carrefour.
14/12/2015 Alterao no tamanho mximo para o campo 134 de 15 para 20.
14/01/2016 Incluso do tipocampo 2470 e do item 4.2.8 Ponto flutuante
21/01/2016 Incluso do formato da data de vencimento do cato (AAMM)
retornado pela rotina LeCartaoDiretoSeguro.
03/02/2016 Retificao no item Como a automao informa CliSiTef que sabe
tratar campos com ponto flutuante.

Software Express Ltda., 2016 110


Especificao Tcnica Interface com os meios de pagamento do SiTef Verso: 182
Bibliotecas CliSiTefI e CliSiTef Data: 07/11/2016

05/02/2016 Alterao no item Como a automao informa CliSiTef que sabe


tratar campos com ponto flutuante
24/02/2016 Includo Observao no tratamento do comando 23 (item 3.3.1)
09/03/2016 Incluso de: Menu Cancelamento Saque Crdito Transferncia (3307)
, Menu opo crdito a vista Resgate Pontos (3261) e campo Nmero
Autorizao NFCE (952).
22/03/2016 Incluso da funo FinalizaFuncaoSiTefInterativo em detrimento
FinalizaTransacaoSiTefInterativo; adicionada explicao sobre os
parmetros adicionais da primeira.
24/03/2016 Alterao na descrio do campo IdTerminal da funo
ConfiguraIntSiTefInterativo incluindo observaes importantes.
05/04/2016 Tornados obsoletos os TipoCampo 596 e 596.
15/0/2016 4.0.113.12.r2 Incluso das modalidades 117 Ajuste de pr autorizao e 118 -
Consulta de pr autorizao.
14/06/2016 Atualizao item 5.6. Incluido transaes Cielo(3323, 3653, 3654 e
3655)
19/08/2016 Atualizao 5.7, melhorando a descrio da configurao
CodigoCliente.
31/09/2016 Alteraes ref. implementao das modalidades abaixo:
- Modalidades:
430 Le Carto Seguro (LeCartaoSeguro)
431 Le Trilha Chip Seguro (LeTrilhaChipEx)
- Adicionado Obervao no item:
3.8 Leitura do carto - rotinas de captura segura
- Incluso de campos:
CAMPO_MENSAGEM_PINPAD 2601
CAMPO_SEMENTE_HASH 2602
CAMPO_MODALIDADE_LECARTAO_SEGURO 2603
02/09/2016 Incluso da modalidade 354 Ultragaz Revenda, Menus 3900, 3901,
3902. Tipo Campo 4076 (Identificao Loja).
27/09/2016 5.0.114.6 r1 . Incluso da Modalidade para Adeso de Seguro - 422.
. Incluso dos Tipo Campos 3742 (Menu Adeso de Seguro Tricard)
e 3746 (Menu Consulta de Saldo Tricard).
10/10/2016 Incluso dos parmetros que habilitam o pagamento parcelado em
transaes que tem pagamento vinculado
07/11/2016 . Incluso da modalidade 908 (alterao de senha dbito
combustvel).
11/11/2016 5.0.114.13 r1 Incluso dos menus 3744 (Recarga de carto de crdito) e 3745
6.1.114.13 r1 (Cancelamento de recarga de carto de crdito).
Incluso das funes 899 (Recarga de carto de crdito) e 900
(Cancelamento de recarga de carto de crdito).

Software Express Ltda., 2016 111