You are on page 1of 84

Especificao Tcnica Interface com os meios de pagamento do SiTef Bibliotecas CliSiTefI e CliSiTef

Verso 120

Este documento possui tecnologia e conhecimento de propriedade da Software Express Informtica No pode ser reproduzido ou utilizado para outros fins que no a interface com algum de nossos produtos.

Especificao Tcnica Interface com os meios de pagamento do SiTef Bibliotecas CliSiTefI e CliSiTef

Verso: 120 Data: 29/04/2013

ndice
1. Objetivos 1.1 Descrio Resumida 1.2 Fluxo Grfico Descrio das interfaces com as rotinas disponveis na CliSiTef 2.1 Interface padro 2.2 Interface ASCII API - Rotinas disponveis na CliSiTef 3.1 Configurao da biblioteca 3.1.1 Configuraes especiais gerais 3.2 Incio da transao de Pagamento ou Gerencial 3.2.1 Tabela de cdigos de retorno 3.2.2 Tabela de cdigos de funes 3.3 Continuao do processo de coleta interativo 3.3.1 Tabela de cdigos de Comando 3.3.2 Tabela de valores para TipoCampo 3.3.3 Tabela de Eventos, retornados tambm em TipoCampo 3.4 Confirmao ou no do Pagamento 3.5 Teste da presena de PinPad 3.6 Define mensagem permanente para o PinPad 3.7 Leitura da trilha 3 do carto 3.8 Leitura do carto - rotinas de captura segura 3.9 Leitura de senha 3.10 Leitura de Confirmao pelo Cliente no PinPad 3.11 Correspondente Bancrio (Pagamento de Contas) 3.12 Verificao da integridade de um cdigo em barras 3.13 Verificao da quantidade de transaes pendentes de confirmao no terminal 3.14 Obtendo Verso 3.15 Descarregando Mensagens 3.16 Informaes do PinPad Arquivo de configuraes CliSiTef.ini ou CLSIT 4.1 Configurao do PinPad 4.1.1 Configurao da porta 4.1.2 Definio da mensagem padro 4.2 Configurao de conexo com o servidor SiTef 4.2.1 Configurao de endereos IP adicionais 4.2.2 Configurao da porta do servidor SiTef 4.2.3 Obrigatoriedade de conexo 4.2.4 Configurao do mostrador de comunicao Restrio ou habilitao das formas de pagamento 5.1 Restrio durante o processo de finalizao de uma venda 5.2 Restrio de forma definitiva 5.3 Habilitao de transaes adicionais 5.4 Desabilitando transaes 5.5 Habilitao de transaes de redes especficas Software Express Ltda., 2013 1 2 3 4 4 4 6 7 8 9 10 11 17 20 23 36 37 38 38 39 40 42 43 44 45 48 48 49 49 50 50 50 50 52 52 52 53 53 54 54 54 55 56 56 ii

2.

3.

4.

5.

Especificao Tcnica Interface com os meios de pagamento do SiTef Bibliotecas CliSiTefI e CliSiTef 5.6 5.7 6. 7. Tabela de cdigos de meios de pagamento, configuraes e menus Habilitao de configuraes especiais por transao

Verso: 120 Data: 29/04/2013 59 68 70 71 71 71 72 73 73 73 74 74 75 75

Arquivos de controle Trace 7.1 Configurao do perodo que o trace mantido 7.2 Configurao de diretrio 7.3 Arquivos de trace por terminal Processo de desenvolvimento/homologao 8.1 Arquivo de trace adicional durante a fase de desenvolvimento 8.2 Processo de homologao Habilitando confirmao do valor no pinpad Traduo de mensagens Tabelas Rotinas descontinuadas

8.

9. 10. 11. 12.

Software Express Ltda., 2013

iii

Especificao Tcnica Interface com os meios de pagamento do SiTef Bibliotecas CliSiTefI e CliSiTef

Verso: 120 Data: 29/04/2013

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

Especificao Tcnica Interface com os meios de pagamento do SiTef Bibliotecas CliSiTefI e CliSiTef
1.1 Descrio Resumida

Verso: 120 Data: 29/04/2013

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

Software Express Ltda., 2013

Especificao Tcnica Interface com os meios de pagamento do SiTef Bibliotecas CliSiTefI e CliSiTef
1.2 Fluxo Grfico

Verso: 120 Data: 29/04/2013

ConfiguraIntSiTefInterativo Retorno igual a 0 (zero)? S IniciaFuncaoSiTefInterativo Retorno igual a 10000? S N Encerra a transao N Encerra a transao

ContinuaFuncaoSiTefInterativo
Retorno igual a 10000? Se Sim ento execute o prximo Comando e chame novamente a funo S O retorno foi igual a 0? N S Encerra a transao (lao)

Houve devoluo de Cupom TEF pela CliSiTef?

N
S Imprime o cupom; O cupom foi impresso corretamente?

Encerra a transao

N
S

Chamar a funo FinalizaTransacaoSiTefInterativo Com parmetro Confirma = 0

Chamar a funo FinalizaTransacaoSiTefInterativo Com parmetro Confirma = 1

Software Express Ltda., 2013

Especificao Tcnica Interface com os meios de pagamento do SiTef Bibliotecas CliSiTefI e CliSiTef 2. Descrio das interfaces com as rotinas disponveis na CliSiTef

Verso: 120 Data: 29/04/2013

2.1 Interface padro

Esta interface pode ser utilizada por aplicaes escritas nas mais variveis linguagens de programao que aceitam campos binrios. Dentre elas citamos: Delphi, Visual Basic, Visual C. No caso de comprovantes, o delimitador que indica o final de uma linha o caractere 0x0a (\n em linguagem C). Todas as rotinas chamadas pelo aplicativo de automao devem ser do tipo stdcall, ou seja, os parmetros so empilhados da direita para a esquerda e a rotina chamada responsvel por remov-los da pilha. A conveno dos parmetros a seguinte: Tipo char * short int (short) unsigned short int (ushort) long, unsigned long (ulong) void <tipo varivel> * (exemplo: short int * ou long *) Descrio Buffer em texto ASCII terminado por zero binrio. Variveis que ocupam 2 bytes em memria, com e sem sinal, respectivamente. Variveis que ocupam 4 bytes em memria, com e sem sinal, respectivamente. Indica a ausncia de parmetros ou retorno. Indica que a varivel do tipo varivel est sendo passada como endereo, ou seja, a CliSiTef ir utilizar a rea da aplicao de automao para trabalhar, podendo devolver algum resultado nela.

2.2 Interface ASCII

Esta interface pode ser utilizada por aplicaes escritas em qualquer linguagem de programao, inclusive as que no que aceitam campos binrios, tais como o ambiente Forms da Oracle. Nela todos os parmetros so passados em ASCII e podem ser de tamanho fixo e varivel. Os campos numricos so passados sempre com tamanho fixo e alinhados a direita, com zeros a esquerda. Em particular, o campo cujo contedo seja um valor negativo, possui um sinal - na posio mais a esquerda do nmero (p/ex: -0001 para um campo de 5 posies cujo contedo o valor 1). Os de tamanho varivel so construdos de forma que o primeiro caractere indique qual o valor escolhido para ser o delimitador daquele campo ou seja, o campo delimitado pelo caractere escolhido ou o seu complementar no caso dos pares ( ), [ ], { } e < >. Exemplos de construes vlidas so: (1234), [1234], {1234}, <1234>, $1234$, %1234%, |1234|, etc. Exemplos NO VLIDOS so os seguintes: $12$34$, .1.234,56., etc. O critrio para escolha do delimitador deve ser o de que ele no exista como caractere vlido no campo em questo. Nas passagens de dados da aplicao para a CliSiTef, como estes sempre so conhecidos, a aplicao pode definir um caractere padro e sempre utiliz-lo em todas as passagens de dados. J no retorno, como qualquer caractere valido (por exemplo em um comprovante), a regra acima deve ser utilizada na interpretao do resultado devolvido pela CliSiTef uma vez que esta ir escolher o caractere que melhor se adapta a resposta que esta sendo gerada. Finalizando, existe um caractere especial que utilizado nos textos direcionados para uma impressora. O \ (barra reversa) indica o final de uma linha e deve ser utilizado pelo aplicativo instruir a impressora para fechar a linha corrente e se posicionar na seguinte. Software Express Ltda., 2013 4

Especificao Tcnica Interface com os meios de pagamento do SiTef Bibliotecas CliSiTefI e CliSiTef

Verso: 120 Data: 29/04/2013

Software Express Ltda., 2013

Especificao Tcnica Interface com os meios de pagamento do SiTef Bibliotecas CliSiTefI e CliSiTef 3. API - Rotinas disponveis na CliSiTef

Verso: 120 Data: 29/04/2013

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

Especificao Tcnica Interface com os meios de pagamento do SiTef Bibliotecas CliSiTefI e CliSiTef
3.1 Configurao da biblioteca

Verso: 120 Data: 29/04/2013

Atravs dessa rotina o aplicativo configura a CliSiTef de forma que ela possa interagir com o SiTef e com o prprio aplicativo de automao.
long ConfiguraIntSiTefInterativo (IPSiTef, IdLoja, IdTerminal, Reservado) long ConfiguraIntSiTefInterativoEx (IPSiTef, IdLoja, IdTerminal, Reservado, ParametrosAdicionais)

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

Parmetro Resultado IPSiTef IdLoja

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

IdTerminal

Entrada, por valor

Reservado ParametrosAdi cionais

Entrada, por valor Entrada, por valor

Interface Interface Descrio padro ASCII No usado Fixo 6 Contm o resultado de resposta chamada da rotina char * Varivel Configura o nome ou endereo IP (em notao .) do servidor SiTef char * Fixo 8 Identifica o nmero da loja perante a rede de estabelecimentos comerciais. Se no for fornecido o SiTef identificar a loja baseado no IP origem da conexo char * Fixo 8 Identifica o pdv perante a loja. Se no for fornecido o SiTef identificar a loja baseado no IP origem da conexo. obrigatrio se pIdLoja for fornecido. Neste caso possui o formato XXnnnnnn onde XX corresponde a 2 caracteres alfabticos e nnnnnn 6 dgitos quaisquer desde que o nmero resultante no sobreponha a faixa 000900 a 000999 que reservada para uso pelo SiTef short Fixo 6 Deve ser passado com 0 char * Varivel Parmetros adicionais de configurao da CliSiTef no seguinte Formato: [<Nome_Parametro_1>=<Valor_Parametro_1>;<N ome_Parametro_2>=<Valor_Parametro_2>]

Software Express Ltda., 2013

Especificao Tcnica Interface com os meios de pagamento do SiTef Bibliotecas CliSiTefI e CliSiTef As rotinas devolvem um dos seguintes resultados: Valor 0 1 2 3 6 7 8 9 10 11 12 13

Verso: 120 Data: 29/04/2013

Descrio No ocorreu erro Endereo IP invlido ou no resolvido Cdigo da loja invlido Cdigo de terminal invlido Erro na inicializao do Tcp/Ip Falta de memria No encontrou a CliSiTef ou ela est com problemas Configurao de servidores SiTef foi excedida. Erro de acesso na pasta CliSiTef (possvel falta de permisso para escrita) Dados invlidos passados pela automao. Modo seguro no ativo (possvel falta de configurao no servidor SiTef do arquivo .cha). Caminho DLL invlido (o caminho completo das bibliotecas est muito grande).

3.1.1 Configuraes especiais gerais Determinadas configuraes gerais (vlidas para todas as transaes) da CliSiTef podem ser passadas atravs do parmetro ParametrosAdicionais da rotina ConfiguraIntSiTefInterativoEx. O formato deste campo o seguinte:
[<Funcionalidade >;<Funcionalidade >;...]

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

PortaPinPad=<Porta PinPad>

Software Express Ltda., 2013

Especificao Tcnica Interface com os meios de pagamento do SiTef Bibliotecas CliSiTefI e CliSiTef
3.2 Incio da transao de Pagamento ou Gerencial

Verso: 120 Data: 29/04/2013

long IniciaFuncaoSiTefInterativo (Funcao, Valor, CupomFiscal, DataFiscal, HoraFiscal, Operador, ParamAdic)

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

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


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

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

Parmetro Resultado Funcao Valor

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

Interface Interface Descrio padro ASCII No usado Fixo 6 Contm o resultado de resposta chamada da rotina long char * Seleciona a forma de pagamento, conforme a tabela Cdigos de Funes a seguir. Varivel Contm o valor a ser pago contendo o separador decimal (,).Deve sempre ser passado com duas casas decimais aps a vrgula (,). Caso a operao no tenha um valor definido a priori (p/ex. recarga de pr-pago), esse campo deve vir zerado Mx. 20 Nmero do Cupom Fiscal correspondente venda Fixo 8 Fixo 6 Data Fiscal no formato AAAAMMDD Horrio Fiscal no formato HHMMSS Fixo 6

CupomFiscal DataFiscal HoraFiscal Operador ParamAdic

Entrada, por valor Entrada, por valor Entrada, por valor Entrada, por valor Entrada, por valor

char * char * char * char * char *

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

Produtos

Entrada, por valor

char *

Software Express Ltda., 2013

Especificao Tcnica Interface com os meios de pagamento do SiTef Bibliotecas CliSiTefI e CliSiTef

Verso: 120 Data: 29/04/2013

do comprovante da operao de Tef a ser impresso. O formato bsico deste campo : [<Descrio1>;<Cdigo1>;<Quantidade1>;<ValorT otal1>]; [<Descrio2>;<Cdigo2>;<Quantidade2>;<ValorT otal2>];... Campo Descrio Cdigo Quantidade Valor Formato 1 a 14 caracteres 1 a 08 caracteres 1 a 04 dgitos 999.999,99

Ele deve ser repetido tantas vezes quanto o nmero de produtos distintos adquirido pelo cliente.

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

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

Software Express Ltda., 2013

10

Especificao Tcnica Interface com os meios de pagamento do SiTef Bibliotecas CliSiTefI e CliSiTef 3.2.2 Tabela de cdigos de funes

Verso: 120 Data: 29/04/2013

Os seguintes cdigos esto disponveis para serem usados no parmetro Funcao descrita acima. Funo Descrio Pagamento genrico. A CliSiTef permite que o operador escolha a forma de pagamento 0 atravs de menus. Cheque 1 Dbito 2 Crdito 3 Fininvest 4 Carto Benefcio 5 Crdito Centralizado 6 Carto Combustvel 7 Parcele Mais Redecard 8 Benefcio Refeio 10 Benefcio Alimentao 11 Carto Infocard 12 Pay Pass 13 Carto Nova Plataforma Ticket Car (NPTC) 14 Venda com carto Gift 15 Dbito para pagamento de carn 16 50 51 52 53 54 55 56 57 100 Venda Boleto Carrefour Venda Autorizacao Carrefour Recebimento Carrefour Incluso de Boleto Carrefour Incluso de Venda Carrefour Consulta Recebimento Carrefour Consulta Limite mnimo PromoFlex Carrefour Cancelamento de Recebimento Carefour Telemarketing: Inicia a coleta dos dados da transao no ponto necessrio para tratar uma transao de carto de crdito digitado Abre o menu de transaes Gerenciais Teste de comunicao com o SiTef Menu Re-impresso Re-impresso comprovante especfico Re-impresso ultimo comprovante Pr-autorizao Captura de pr-autorizao Consulta Bnus Consulta Saldo Carto Presente Consulta Saldo Carto Gift Consultas Carto SEM

110 111 112 113 114 115 116 150 151 152 160

Software Express Ltda., 2013

11

Especificao Tcnica Interface com os meios de pagamento do SiTef Bibliotecas CliSiTefI e CliSiTef 161 200 Vendas Carto EMS

Verso: 120 Data: 29/04/2013

201 202 203 210 211 212 213 250 251 253 254 255 256 257 260 262 264 265 266 267 268 269 300 301 302 303 310 311 312 313 314 315 316 317 318 319 320 321

Cancelamento Normal: Inicia a coleta dos dados no ponto necessrio para fazer o cancelamento de uma transao de dbito ou crdito, sem ser necessrio passar antes pelo menu de transaes administrativas Cancelamento Telemarketing: Similar a modalidade 200 s que para a funo de cancelamento de transao de crdito digitado Cancelamento Pr-autorizao Cancelamento da Captura da Pr-autorizao Cancelamento de venda com carto de Crdito Cancelamento de venda com carto de Dbito Cancelamento de venda com carto Combustvel Cancelamento de Venda com Carto Gift Cancelamento de Consulta Bnus Cancelamento Recarga Carto Presente Cancelamento Acmulo de Pontos Carto Bnus Resgate de Pontos Carto Bnus Cancelamento de Resgate de Pontos Carto Bnus Acmulo de Pontos Carto Bnus Cancelamento Recarga Carto Gift Recarga Carto Bnus Recarga Carto Presente Recarga Carto Gift Ativao Pagamento Vinculado Carto Gift Consulta Carto Gift Ativao Carto Gift Sem Pagamento Ativao Carto Gift Com Pagamento Ativao Desvinculada Carto Gift Recarga de pr-pago Recarga de pr-pago desvinculada do pagamento Recarga de pr-pago sem coleta de valor Recarga de pr-pago desvinculada do pagamento e sem coleta de valor Corresponde Bancrio (Pagamento de Contas) Pagamento de Contas com Saque Consulta para Pagamento Desvinculado (Genrico) Pagamento Desvinculado (Genrico) Recarga Pr Pago HSBC com Saque Saque para Pagamento Cancelamento do pagamento desvinculado (genrico) Consulta Limites do Correspondente Bancrio Recarga Pr Pago Bradesco Recarga Pr Pago Bradesco desvinculada do pagamento Recarga Pr Pago HSBC Recarga Pr Pago HSBC desvinculada do pagamento

Software Express Ltda., 2013

12

Especificao Tcnica Interface com os meios de pagamento do SiTef Bibliotecas CliSiTefI e CliSiTef 322 323 324 325 350 351 400 401 410 411 412 420 500 501 502 530 531 532 533 540 541 542 543 550 552 553 554 560 561 562 563 564 570 571 572 573 580 Depsito Identificado Transferncia entre Contas Pague Fcil Revalidao de Senha INSS Venda Produto (Sem Valor) Cancelamento de Venda Produto (Sem Valor) Vale-Gs Validao Vale-Gs Troco Surpresa Troco Premiado Cancelamento Troco Premiado
Troco Solidrio / Doao solidria

Verso: 120 Data: 29/04/2013

Consulta Detalhada ACSP Consulta Detalhada Serasa Consulta Cadastral Infocard Consulta Fidelize (PBM) Venda Fidelize (PBM) Cancelamento Parcial Fidelize (PBM) Cancelamento Total Fidelize (PBM) Pr-autorizao PharmaSystem Recuperao de pr-autorizao PharmaSystem Venda PharmaSystem Cancelamento PharmaSystem Obtem Autorizao PBM Venda PBM Cancelamento Parcial PBM Cancelamento Total PBM Consulta Telenet/Funcional Card (PBM) Venda Telenet/Funcional Card (PBM) Cancelamento Telenet/Funcional Card (PBM) Pr-autorizao Telenet/Funcional Card (PBM) Consulta cliente Telenet/Funcional Card (PBM) Consulta EPharma(PBM) Venda EPharma (PBM) Cancelamento Parcial EPharma (PBM) Cancelamento Total EPharma (PBM) Consulta PrevSaude (PBM)

Software Express Ltda., 2013

13

Especificao Tcnica Interface com os meios de pagamento do SiTef Bibliotecas CliSiTefI e CliSiTef 581 582 583 590 591 592 593 594 600 601 602 605 606 607 605 606 607 610 611 612 614 615 616 613 618 619 620 621 625 626 627 628 630 631 632 633 634 635 636 637 Venda PrevSaude (PBM) Cancelamento Parcial PrevSaude (PBM) Cancelamento Total PrevSaude (PBM) Consulta Operadoras TrnCentre (PBM) Consulta Pr Autorizao TrnCentre (PBM) Venda sem Pr Autorizao TrnCentre (PBM) Venda com Pr Autorizao TrnCentre (PBM) Cancelamento TrnCentre (PBM) Consulta Saldo Consulta Saldo Carto de Dbito Consulta Saldo Carto de Crdito Consulta Saldo Carto Combustvel Consulta de Redes Carto Combustvel Consulta Produtos Carto Combust Consulta Saldo Carto Combustvel Consulta Redes Carto Combustvel Consulta Produtos Carto Combustvel Transaes SPTrans (Bilhete nico) Consulta Saldo SPTrans (Bilhete nico) Recarga SPTrans (Bilhete nico) Pagamento de Recarga SPTrans (Bilhete nico) Consulta de Produtos SPTrans (Bilhete nico) Recarga SPTrans desvinculada de pagamento (Bilhete nico) Carto Marisa (Orbital) Venda Hopi Hari com Consulta de Produtos Consulta de Produtos Hopi Hari Venda Hopi Hari sem Consulta de Produtos Cancelamento Hopi Hari Venda Voucher com Consulta Forncedores/Produtos Consulta Forncedores/Produtos Voucher Venda Voucher sem Consulta Forncedores/Produtos Cancelamento venda Voucher Opes de transaes NPTC Consulta Saldo NPTC Atualizao Carto NPTC Consulta Produtos Host NPTC Consulta Produtos PDV NPTC Cadastra Produtos NPTC Troca de senha NPTC Boleto de venda NPTC

Verso: 120 Data: 29/04/2013

Software Express Ltda., 2013

14

Especificao Tcnica Interface com os meios de pagamento do SiTef Bibliotecas CliSiTefI e CliSiTef 638 639 640 641 642 649 650 651 652 653 654 655 656 657 660 661 662 663 664 665 667 668 669 670 671 672 673 674 680 700 701 702 703 704 705 Venda NPTC Cancelamento de venda NPTC Desbloqueio Carto Riachuelo Troca de senha Carto Riachuelo Venda Riachuelo Venda Private Label Softway/Renner Venda Carto Bandeira Softway/Renner Pagamento de Fatura Softway Desbloqueio de Carto Softway/Renner Troca de Senha Carto Softway/Renner Consulta de Fatura Carto Softway/Renner Venda Pin de Jogos Venda Pin de Recarga Saque Crdito Transferncia Menu Saque IBI Consulta Saque Banco IBI Saque Banco IBI Saque GetNet Cancelamento Saque GetNet Resgate de Pontos Emisso de Pontos Cancelamento da Emisso de Pontos Carga de Pr Pago Cancelamento de Carga de Pr Pago Consulta Saque com Saque Banco IBI Cancelamento Saque Banco IBI Venda DrogaRaia Cancelamento Venda DrogaRaia Consulta Saldo Pr Pago Venda Oi Paggo Cancelamento Oi Paggo Pagamento de contas Cancelamento de Pagamento Carto Benefcio Primeira Compra Pagamento de Fatura

Verso: 120 Data: 29/04/2013

Software Express Ltda., 2013

15

Especificao Tcnica Interface com os meios de pagamento do SiTef Bibliotecas CliSiTefI e CliSiTef

Verso: 120 Data: 29/04/2013

740 999 1000

Consulta Parcelas Crdito Adm Fechamento Voucher Papel

Software Express Ltda., 2013

16

Especificao Tcnica Interface com os meios de pagamento do SiTef Bibliotecas CliSiTefI e CliSiTef
3.3 Continuao do processo de coleta interativo

Verso: 120 Data: 29/04/2013

Esta funo deve ser chamada de forma contnua at no existam mais informaes para serem trocadas entre a aplicao e a CliSiTef, conforme descrito nos resultados devolvidos por ela. O formato de ativao o seguinte:
long ContinuaFuncaoSiTefInterativo (Comando, TipoCampo, TamMinimo, TamMaximo, Buffer, TamBuffer, Continua)

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

Parmetro Resultado Comando

Tipo Sada, por valor Sada, por referncia

Interface Interface Descrio padro ASCII No usado Fixo 6 Contm o resultado de resposta chamada da rotina long * Fixo 12 Contm no retorno: 0 caso a CliSiTef esteja devolvendo algum dado referente a transao no campo Buffer <> 0 indica o Prximo Comando a ser executado pelo aplicativo. Os comando vlidos esto descritos em Tabela de cdigos de Comando Contm o cdigo do tipo de campo que a automao deve tratar. Os tipos existentes esto descritos em Tabela de valores para TipoCampo Quando o Comando for uma coleta de dados, contm o tamanho Mnimo e Maximo do campo a ser lido

TipoCampo

TamMinimo

TamMaximo

Buffer

Sada, por referncia Sada, por referncia Sada, por referncia Entrada e sada, por valor Entrada, por valor Entrada, por valor

long *

Fixo 12

short *

Fixo 6

short *

Fixo 6

char *

TamBuffer Continua

long long

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

Software Express Ltda., 2013

17

Especificao Tcnica Interface com os meios de pagamento do SiTef Bibliotecas CliSiTefI e CliSiTef

Verso: 120 Data: 29/04/2013

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

18

Especificao Tcnica Interface com os meios de pagamento do SiTef Bibliotecas CliSiTefI e CliSiTef

Verso: 120 Data: 29/04/2013

Incio

Inicializa Comando, TipoCampo, TamMinimo, TamMaximo e Continua com 0

Inicializa TamBuffer com o tamanho do Buffer

Chama a rotina ContinuaFuncaoSiTefInterativo

Retornou 10000? No

Sim

Executa o Comando solicitado

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

19

Especificao Tcnica Interface com os meios de pagamento do SiTef Bibliotecas CliSiTefI e CliSiTef 3.3.1 Tabela de cdigos de Comando

Verso: 120 Data: 29/04/2013

A seguir apresentamos os valores possveis para o parmetro Comando e a ao que a aplicao deve executar ao receb-lo: Comando 0 1 2 3 4 11 12 13 14 15 Descrio Est devolvendo um valor para, se desejado, ser armazenado pela automao Mensagem para o visor do operador Mensagem para o visor do cliente Mensagem para os dois visores Texto que dever ser utilizado como ttulo na apresentao do menu ( vide comando 21) Deve remover a mensagem apresentada no visor do operador (comando 1) Deve remover a mensagem apresentada no visor do cliente (comando 2) Deve remover mensagem apresentada no visor do operador e do cliente (comando 3) Deve limpar o texto utilizado como ttulo na apresentao do menu (comando 4) Cabealho a ser apresentado pela aplicao. Refere-se a exibio de informaes adicionais que algumas transaes necessitam mostrar na tela. Um exemplo a transao de Emprstimo do Correspondente Bancrio, que em certo ponto precisa que sejam mostradas informaes para o cliente detalhando o emprstimo que est sendo contratado (como Valor da parcela, vencimento, etc..). Deve remover o cabealho apresentado pelo comando 15. Deve apresentar o texto em Buffer, e obter uma resposta do tipo SIM/NO. No retorno o primeiro carter presente em Buffer deve conter 0 se confirma e 1 se cancela. Deve apresentar um menu de opes e permitir que o usurio selecione uma delas. Na chamada o parmetro Buffer contm as opes no formato 1:texto;2:texto;...i:Texto;... A rotina da aplicao deve apresentar as opes da forma que ela desejar (no sendo necessrio incluir os ndices 1,2, ...). Aps a seleo feita pelo usurio, retornar em Buffer o ndice i escolhido pelo operador (em ASCII) Deve apresentar a mensagem em Buffer, e aguardar uma tecla do operador. utilizada quando se deseja que o operador seja avisado de alguma mensagem apresentada na tela. Este comando indica que a rotina est perguntando para a aplicao se ele deseja interromper o processo de coleta de dados ou no. Esse cdigo ocorre quando a CliSiTef est acessando algum perifrico e permite que a automao interrompa esse acesso (por exemplo: aguardando a passagem de um carto pela leitora ou a digitao de senha pelo cliente) Anlogo ao comando 30, porm deve ser coletado um campo que no requer interveno do operador de caixa, ou seja, no precisa que seja digitado/mostrado na tela, e sim passado diretamente para a biblioteca pela automao. Um exemplo so as formas de pagamento que algumas identificar qual o tipo de pagamento que est sendo usado. transaes requerem para

16 20

21

22 23

29

O valor a ser coletado refere-se ao campo indicado em TipoCampo, cujo tamanho est entre TamMinimo e TamMaximo. O campo deve ser devolvido em Buffer. Software Express Ltda., 2013 20

Especificao Tcnica Interface com os meios de pagamento do SiTef Bibliotecas CliSiTefI e CliSiTef 30 31

Verso: 120 Data: 29/04/2013

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

34 35

41 42

A rotina da aplicao deve apresentar as opes da forma que ela desejar (no sendo necessrio incluir os ndices 1,2, ..., nem cdigos do campo, tipo e classe) e aps a seleo feita pelo usurio, retornar em Buffer o ndice i escolhido pelo operador (em ASCII). O cdigo das opes a identificao (Tabela de cdigos de meios de pagamento, configuraes e menus) do campo da opo, ela pode ser utilizada na identificao da opo escolhida. Dentro de cada classe existe a codificao de tipos, e cada par (classe, tipo) indica a

Software Express Ltda., 2013

21

Especificao Tcnica Interface com os meios de pagamento do SiTef Bibliotecas CliSiTefI e CliSiTef

Verso: 120 Data: 29/04/2013

natureza da opo. Inicialmente foi implementada apenas a identificao para as formas de pagamento. A ideia adicionar cdigos que identificam as opes do menu para possibilitar que o PDV identifique essas opes sem o auxlio do operador. Classe 0 1 Descrio Classe no definida Forma de pagamento Tipo 1 2 3 4 5 6 Descrio Dinheiro Cheque Dbito Crdito Saque Outra forma

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

Software Express Ltda., 2013

22

Especificao Tcnica Interface com os meios de pagamento do SiTef Bibliotecas CliSiTefI e CliSiTef 3.3.2 Tabela de valores para TipoCampo

Verso: 120 Data: 29/04/2013

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 00 01 02 03 98 99 Grupo Cheque Carto de Dbito Carto de Crdito Carto tipo Voucher Dinheiro Outro tipo de carto

nn 00 01 02 03 99

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

101

102 105 110

111

112

Contm o texto real da modalidade de pagamento que pode ser memorizado pela aplicao caso exista essa necessidade. Descreve por extenso o par xxnn fornecido em 100 Contm o texto descritivo da modalidade de pagamento que deve ser impresso no cupom fiscal (p/ex: T.E.F., Cheque, etc...) Contm a data e hora da transao no formato AAAAMMDDHHMMSS Contm a modalidade de cancelamento no formato xxnn xx corresponde ao grupo da modalidade e nn ao sub-grupo. Segue o mesmo formato do TipoCampo 100, e retorna quando uma transao for cancelada. Contm o texto real da modalidade de cancelamento que pode ser memorizado pela aplicao caso exista essa necessidade. Descreve por extenso o par xxnn fornecido em 110. Contm dados adicionais relativos ao carto utilizado na operao de Tef. O formato

Software Express Ltda., 2013

23

Especificao Tcnica Interface com os meios de pagamento do SiTef Bibliotecas CliSiTefI e CliSiTef

Verso: 120 Data: 29/04/2013

115 120 121

122 123

125 130

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

deste campo uma seqncia de cdigos separados por ponto-e-virgula. Por enquanto o nico cdigo que retorna a palavra EE para indicar que o carto utilizado foi um EasyEntry ou EMV para indicar um carto EMV. Caso tenha sido um carto normal, esse tipo de campo no retornado para a aplicao. Modalidade Ajuste Buffer contm a linha de autenticao do cheque para ser impresso no verso do mesmo Buffer contm a primeira via do comprovante de pagamento (via do cliente) a ser impressa na impressora fiscal. Essa via, quando possvel, reduzida de forma a ocupar poucas linhas na impressora. Pode ser um comprovante de venda ou administrativo Buffer contm a segunda via do comprovante de pagamento (via do caixa) a ser impresso na impressora fiscal. Pode ser um comprovante de venda ou administrativo Indica que os comprovantes que sero entregues na seqncia so de determinado tipo: COMPROVANTE_COMPRAS = "00" COMPROVANTE_VOUCHER = "01" COMPROVANTE_CHEQUE = "02" COMPROVANTE_PAGAMENTO = "03" COMPROVANTE_GERENCIAL = "04" COMPROVANTE_CB = "05" COMPROVANTE_RECARGA_CELULAR = "06" COMPROVANTE_RECARGA_BONUS = "07" COMPROVANTE_RECARGA_PRESENTE = "08" COMPROVANTE_RECARGA_SP_TRANS = "09" COMPROVANTE_MEDICAMENTOS = "10" Cdigo do Voucher Indica, na coleta, que o campo em questo o valor do troco em dinheiro a ser devolvido para o cliente. Na devoluo de resultado (Comando = 0) contm o valor efetivamente aprovado para o troco Contm um ndice que indica qual a instituio que ir processar a transao segundo a tabela presente no final do documento (5 posies) Contm um ndice que indica qual o tipo do carto quando esse tipo for identificvel, segundo uma tabela a ser fornecida (5 posies) Contm o NSU do SiTef (6 posies) Contm o NSU do Host autorizador (15 posies no mximo) Contm o Cdigo de Autorizao para as transaes de crdito (15 posies no mximo) Contm as 6 primeiras posies do carto (bin) Saldo a pagar Valor Total Recebido Valor da Entrada Data da primeira parcela no formato ddmmaaaa Data da parcela no formato ddmmaaaa (reservado) Valor da parcela (reservado) Os campos 141 e 142 so chamados n vezes onde n = contedo do campo 505 Valor gorjeta Valor devoluo Valor de pagamento A rotina est sendo chamada para ler o Valor a ser cancelado. Caso o aplicativo de automao possua esse valor, pode apresent-lo para o operador e permitir que ele confirme o valor antes de pass-lo devolv-lo para a rotina. Caso ele no possua esse valor, deve l-lo.

Software Express Ltda., 2013

24

Especificao Tcnica Interface com os meios de pagamento do SiTef Bibliotecas CliSiTefI e CliSiTef 147 150 151 153

Verso: 120 Data: 29/04/2013

154 155 156 157 158 160 161 170 171 172 173 174 175 176 177 178 200 201 500

501 502 504 505 506 507 508 509 510 511 512 513 514 515 516 517 518 519 520 521

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

Especificao Tcnica Interface com os meios de pagamento do SiTef Bibliotecas CliSiTefI e CliSiTef 522 523 524 525 526 527 529 530 531 532 533 534 535 536 537 550 551 552 553 554 555 556 557 558 559 560 561 562 563 564 565 566 567 568 569 570 571 572 573 574 575 576 577 578 579 580 581

Verso: 120 Data: 29/04/2013

A rotina est sendo chamada para ler o Nmero do Telefone A rotina est sendo chamada para ler o DDD de um telefone com at 4 dgitos Valor da primeira parcela Valor das demais parcelas Quantidade de cheques Data de vencimento do cheque A rotina est sendo chamada para ler a Data de Abertura de Conta no formato (MMAAAA) Autorizao do supervisor digitada Autorizao do supervisor especial A rotina est sendo chamada para ler a quantidade de parcelas ou cheques Dados adicionais da venda Emitente do cheque O documento pago pela transao Registros de retorno da consulta cheque CDL-Poa Cdigo de rea da cidade do cheque Endereo Nmero do endereo Andar do endereo Conjunto do endereo Bloco do endereo CEP do endereo Bairro do endereo CPF para consulta AVS Resultado da consulta AVS Nmero de dias do pr-datado Nmero de Ciclos Cdigo da Ocorrncia Cdigo de Loja (EMS) Cdigo do PDV (EMS) Dados Retornados (EMS) Ramal do Telefone rgo Expedidor do RG Estado onde foi emitido o RG Data de expedio do RG Matrcula do Operador Nome do Operador Matrcula do Conferente Nome do Conferente Percentual de Juros Aplicado Matrcula do Autorizador Data do Cupom Fiscal da Transao Original Hora do Cupom Fiscal da Transao Original Dados do Carn ou cdigo resumido EMS Cdigo de milhas diferenciadas 1 Valor das milhas diferenciadas 1 Cdigo de milhas diferenciadas 2 Valor das milhas diferenciadas 2

Software Express Ltda., 2013

26

Especificao Tcnica Interface com os meios de pagamento do SiTef Bibliotecas CliSiTefI e CliSiTef 582 583 589 590 591 592 593 594 595 596 597 598 599 600 601 602 603 604 605 606 607 608 609 610 611 612 613

Verso: 120 Data: 29/04/2013

614 620 621 622 623 624 625 626 627 628 629 630 631

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

Software Express Ltda., 2013

Especificao Tcnica Interface com os meios de pagamento do SiTef Bibliotecas CliSiTefI e CliSiTef 632 633 634 635 636 637 638 639 640 641 642 643 644 645 646 647 648 649 650 651 652 653 654 670 700 701 702 703 704 705 706 707 708 709 710 711 712 713 714 715 716 717 718 719 722 723 724 725

Verso: 120 Data: 29/04/2013

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

Software Express Ltda., 2013

28

Especificao Tcnica Interface com os meios de pagamento do SiTef Bibliotecas CliSiTefI e CliSiTef 726 727 729 730 731

Verso: 120 Data: 29/04/2013

Venda Crdito com Autorizao Parcela com Plano Habilitada Venda Boleto Habilitada Valor mximo de pagamento Nmero Mximo de Formas de Pagamento, 0 para sem limite Tipo de Pagamento Habilitado, repete n vezes, onde n o nmero de formas de pagamento habilitadas: 00 01 02 Dinheiro Cheque TEF Dbito

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 Limite minimo de venda para promoes flexveis, com 12 dgitos sendo os 2 ltimos dgitos referentes as casas decimais Saldo devedor atual, apenas para recebimento Carrefour Motivo (Carrefour) Valor sugerido para o produto selecionado. Cliente Preferencial Valor Pague Fcil CB Valor Tarifa Pague Fcil CB Cdigo Material AURA Cdigo Plano AURA Nome creditado no Cheque AURA Nmero Dossi AURA Tipo de Venda Conductor/Renner : 1 = Venda via Fatura 2 = Venda via Boleto Define se aps a consulta de fatura, deve encadear o pagamento de fatura (Conductor Renner) Data de Validade do Carto (NPTC) Nome do Portador do Carto (NPTC) Quantidade de medicamentos - PBM ndice do medicamento PBM Cdigo do medicamento PBM

734 736 737 738 739 750 751 900 901 902 903 910 911 1002 1003 1010 1011 1012

Software Express Ltda., 2013

29

Especificao Tcnica Interface com os meios de pagamento do SiTef Bibliotecas CliSiTefI e CliSiTef 1013 1014 1015 1016 1017 1018 1019 1020 1021 1022 1023 1024 1025 1026 1027 1028 1029 1030 1031 1032 1033 1034 1035 1036 1037 1038 1039 1040 1041 1042 1043 1044 1045 1046 1047 1048 1049 1050 1051 1052 1053 1054 1055 1056 1057 1058 1100

Verso: 120 Data: 29/04/2013

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

Especificao Tcnica Interface com os meios de pagamento do SiTef Bibliotecas CliSiTefI e CliSiTef 1101 1102 1103 1104 1105 1106 1107 1108 1109 1110 1111 1112 1113 1114 1115 1116 1117 1118 1119 1120 1121 1122 1123 1124 1125 1126 1127 1128 1129 1131 1132 1133 1134 1135 1136 1137 1152 1160 1190 1191 1192 1193 1200 1201 1202 1203 1204

Verso: 120 Data: 29/04/2013

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

Especificao Tcnica Interface com os meios de pagamento do SiTef Bibliotecas CliSiTefI e CliSiTef 1205 1206 1207 1208 1209 2000 2001 2002 2003 2004 2005 2006 2007 2008 2009 2010 2011 2012 2013 2014 2015 2017 2018 2019 2020 2047 2048 2053 2054 2055 2056 2057 2058 2059 2064 2065 2066 2067 2068 2078 2079 2081 2082 2083 2086 2087

Verso: 120 Data: 29/04/2013

Valor acumulado de cheques pr-datados, contendo 2 dgitos decimais porm sem o caractere decimal. Vendedor (Usurio) - PBM Senha PBM Cdigo de Retorno PBM Origem PBM Campo administrativo Campo livre Resultado da leitora SmartNet Dados obtidos da leitora aps uma operao de dbito do carto SmartVR ou Sodexho Campo de mensagem do servio D, para mensagens 0x0400 Dados a serem enviados PARA a leitora SmartNet. Tipo de criptografia ndice MasterKey Chave de criptografia Senha do carto Cdigo de resposta do autorizador Bin da rede Nmero serial do CHIP Registro de controle do CHIP Saldo comum, saldo do passe comum PAN do carto presente Data primeiro vencimento Valor total Valor financiado Percentual multa Juros de mora TAC (Taxa de administrao) Menu (produto) selecionado Visanet Tipo Crdito CDC (1 CDC Produto; 2 CDC Servio) Data/Hora Sitef (Local) Dia da semana Sitef (Local) Data/Hora Sitef (GMT) Dia da Semana Sitef (GMT) Dados da Forma de Pagamento - SPTrans Valor pagamento em dinheiro Cdigo consulta cheque (Genrica EMS) Nome da filial Mensagem do autorizador a ser exibida junto com o menu de valores (Se o terminal permitir) Valor selecionado atravs de menu Cdigo do servio Valor do servio Menu de Produtos Nosso nmero Valor total do produto contendo o separador decimal (,) e duas casas decimais aps a vrgula. Cdigo do Produto - ValeGas Demonstrativo de prazos : 0: No; 1: Sim Software Express Ltda., 2013 32

Especificao Tcnica Interface com os meios de pagamento do SiTef Bibliotecas CliSiTefI e CliSiTef 2088 2089 2090 2091 2093 2101 2102 2103 2104 2107 2108 2109 2120 2121 2122 2123 2124 2125 2126 2301 2320 2321 2322 2323 2324 2325 2326 2327 2328 2329 2330 2331 2332 2333 2334 2340 2341 2342 2343 2344 2345 2346 2347 2348 2349 2350 2351 2352

Verso: 120 Data: 29/04/2013

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

Software Express Ltda., 2013

33

Especificao Tcnica Interface com os meios de pagamento do SiTef Bibliotecas CliSiTefI e CliSiTef 2355

Verso: 120 Data: 29/04/2013

Quando retornado, atua como uma dica para o formato do prximo campo que ser coletado. Normalmente acompanhado do comando zero (0 retorno de valor para uso pela automao). Assume os seguintes valores: Contedo (em Buffer) A AN LN N Vx S M Mc Descrio Alfabtico Alfanumrico (ans) Letras no acentuadas e nmeros Numrico Valor com x casas decimais Sim/No Menu Menu com confirmao

Indica que foi efetuada uma transao de dbito para pagamento de carn Status da Pr-Autorizao PBM CRF PBM UF do CRF PBM Tipo de venda PBM Valor total PBM Valor a vista PBM Valor carto PBM Nosso nmero PBM Percentual de desconto concedido pela administradora (2 casas decimais) Preo bruto PBM Preo lquido PBM Valor a receber da Loja, em centavos PBM Nmero do lote gerado pela Central PBM Valor total a receber da loja PBM Valor total a receber da loja PBM Soma dos valores da Operao PBM Nome da operadora PBM Nome da empresa conveniada PBM Quantidade de dependentes PBM Cdigo do dependente PBM Nome do dependente PBM Valor a receber do conveniado PBM Valor do desconto total, em centavos Valor liquido total, em centavos - PBM Cdigo da Operadora Selecionada PBM (dever ser gravado para posterior envio nas demais transaes) 4032 Campo de retorno de dados livres referentes s transaes PBM. 4033 Tipo de documento PBM (0 = CRM, 1 = CRO) 4034 Dados do Resgate - Bnus Campos reservados para uso da IntPos.dll 8000 a 9999 Campos reservados * Campos utilizados em um ou mais produtos. Software Express Ltda., 2013 34

2361 4000 4001 4002 4003 4004 4005 4006 4007 4008 4016 4017 4018 4019 4020 4021 4022 4023 4024 4025 4026 4027 4028 4029 4030 4031

Especificao Tcnica Interface com os meios de pagamento do SiTef Bibliotecas CliSiTefI e CliSiTef

Verso: 120 Data: 29/04/2013

Note que nem todos os campos so retornados em todas as transaes. Alm disso, existem campos que somente so retornados se a transao foi aprovada. O aplicativo de automao deve ignorar aqueles campos que no desejar/no souber tratar uma vez que, em verses futuras da CliSiTef, novos campos podero ser disponibilizados. Notar que a forma correta de ignorar estes campos executar a funo definida em ProximoComando ou simplesmente ignorar o dado retornado para a aplicao quando ProximoComando for 0.

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

Software Express Ltda., 2013

35

Especificao Tcnica Interface com os meios de pagamento do SiTef Bibliotecas CliSiTefI e CliSiTef 3.3.3 Tabela de Eventos, retornados tambm em TipoCampo

Verso: 120 Data: 29/04/2013

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

5501

Software Express Ltda., 2013

36

Especificao Tcnica Interface com os meios de pagamento do SiTef Bibliotecas CliSiTefI e CliSiTef
3.4 Confirmao ou no do Pagamento

Verso: 120 Data: 29/04/2013

Rotina chamada pelo aplicativo para fechar o ciclo transacional. Ela deve ser acionada no momento que o comprovante Fiscal for fechado e recebe como parmetros um indicador de se a transao foi concretizada ou se deve ser estornada. Recebe tambm os campos que permitem identificar a transao que est sendo finalizada. Esta funo tambm deve ser utilizada para desfazer uma transao interrompida por uma queda de energia ou qualquer outro problema no aplicativo. Essa rotina confirma ou cancela TODOS os meios de pagamento vinculados ao Nmero do Cupom Fiscal passado como parmetro.
void FinalizaTransacaoSiTefInterativo (Confirma, CupomFiscal, DataFiscal, HoraFiscal);

Interface ASCII
FinalizaTransacaoSiTefInterativoA (Resultado, Confirma, CupomFiscal, DataFiscal, HoraFiscal);

Parmetro Resultado Confirma CupomFiscal DataFiscal HoraFiscal

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

Interface Interface Descrio padro ASCII No usado Fixo 6 Contm o resultado de resposta chamada da rotina short char * char * char * Indica se a transao deve ser confirmada (1) ou estornada (0) Mx. 20 Nmero do Cupom Fiscal correspondente venda Fixo 8 Fixo 6 Data Fiscal no formato AAAAMMDD Horrio Fiscal no formato HHMMSS Fixo 1

Software Express Ltda., 2013

37

Especificao Tcnica Interface com os meios de pagamento do SiTef Bibliotecas CliSiTefI e CliSiTef
3.5 Teste da presena de PinPad

Verso: 120 Data: 29/04/2013

Essa funo, disponibilizada apenas para aplicaes de automao que a necessitem, permite verificar se existe um PinPad conectado na porta serial destinada a ele e se ele est operacional. A forma de chamada desta funo a seguinte:
long VerificaPresencaPinPad (void)

A rotina no tem parmetros de entrada e no retorno a rotina devolve um dos seguintes valores: 1 Existe um PinPad operacional conectado ao micro; 0 No existe um PinPad conectado ao micro; -1 biblioteca de acesso ao PinPad no encontrada; outro nmero erros detectados internamente pela rotina ou pela biblioteca de acesso ao PinPad
3.6 Define mensagem permanente para o PinPad

Permite que seja definida uma mensagem permanente para ser apresentada no PinPad durante o tempo que ele no est em uso. O formato de ativao da rotina o seguinte:
long EscreveMensagemPermanentePinPad (Mensagem)

Interface ASCII
EscreveMensagemPermanentePinPadA (Resultado, Mensagem)

Parmetro Resultado Mensagem

Tipo Sada, por valor Entrada, por valor

Interface Inteface Descrio padro ASCII No usado Fixo 6 Contm o resultado de resposta chamada da rotina char * Varivel Mensagem a ser apresentada no visor do PinPad. Recomenda-se que ela possua no mximo 32 caracteres de forma a ser compatvel com os PinPads existente atualmente em campo

Para apagar a mensagem e deixar o visor em branco s chamar essa funo passando o campo Mensagem vazio. responsabilidade da aplicao, se desejado, incluir o caractere | (Barra em p) para indicar uma mudana de linha.

Software Express Ltda., 2013

38

Especificao Tcnica Interface com os meios de pagamento do SiTef Bibliotecas CliSiTefI e CliSiTef
3.7 Leitura da trilha 3 do carto

Verso: 120 Data: 29/04/2013

Esta funo permite que o aplicativo capture uma trilha 3 magntica genrica. Note que o PinPad deve ter suporte para a leitura da trilha 3. No deve ser utilizada para tratamento das transaes de pagamento mas apenas para leitura de cartes internos do estabelecimento comercial (p/ex. carto de supervisor). O formato de ativao o seguinte:
long LeTrilha3 (Mensagem)

Parmetro Resultado Mensagem

Tipo Sada, por valor Entrada, por valor

Interface Interface Descrio padro ASCII No usado Fixo 6 Contm o resultado de resposta chamada da rotina char * Varivel Mensagem a ser apresentada no visor do PinPad

No retorno a rotina devolve os mesmos valores que a rotina de pagamento. O aplicativo obtm as trilhas atravs da chamada a funo de continuao do processo interativo. IMPORTANTE: Esta funo NO pode ser utilizada durante a execuo do lao ContinuaFuncaoSiTefInterativo.

Software Express Ltda., 2013

39

Especificao Tcnica Interface com os meios de pagamento do SiTef Bibliotecas CliSiTefI e CliSiTef
3.8 Leitura do carto - rotinas de captura segura

Verso: 120 Data: 29/04/2013

Os rotinas seguintes tm seu funcionamento condicionado a configurao do arquivo com extenso .cha no SiTef, caso a configurao no esteja feita, essas funes retornam o erro MODO_SEGURO_NAO_ATIVO (12).
long LeCartaoSeguro (Mensagem)

Interface ASCII
LeCartaoSeguroA (Resultado, Mensagem)

Parmetro Resultado Mensagem

Tipo Sada, por valor Entrada, por valor

Interface Interface Descrio padro ASCII No usado Fixo 6 Contm o resultado de resposta chamada da rotina char * Varivel Mensagem a ser apresentada no visor do PinPad

No retorno a rotina devolve os mesmos valores que a rotina de pagamento. O aplicativo obtm as trilhas atravs da chamada a funo de continuao do processo interativo. Os campos retornados no processo interativo so os referentes aos campos sensveis (2021 a 2046). IMPORTANTE: Essas funes NO podem ser utilizadas durante a execuo do lao ContinuaFuncaoSiTefInterativo. Para esse tipo de situao existem as verses que fazem o acesso direto a leitora de carto descritas a seguir.
int LeCartaoDiretoSeguro (Mensagem, TipoCampoTrilha1, Trilha1, TipoCampoTrilha2, Trilha2, Timeout, TestaCancelamento)

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

Parmetro Resultado

Tipo

Sada, por valor Mensagem Entrada, por valor TipoCampoTrilh Sada, a1 por valor Trilha1 Sada, por valor TipoCampoTrilh Sada, a2 por valor

Interface Interface Descrio padro ASCII No usado Fixo 6 Contm o resultado de resposta chamada da rotina char * char * char * char * Varivel Mensagem a ser apresentada no visor do PinPad Indica o tipo de campo que foi retornado na trilha 1, se ele mascarado, criptografado ou em Hash. Mx. 128 No retorno contm, caso exista, a Trilha 1 lida Fixo 12 Indica o tipo de campo que foi retornado na trilha 2, se ele mascarado, criptografado ou em Hash. Fixo 12

Software Express Ltda., 2013

40

Especificao Tcnica Interface com os meios de pagamento do SiTef Bibliotecas CliSiTefI e CliSiTef Trilha2 Timeout Sada, por valor Entrada, por valor Entrada, por valor char * short

Verso: 120 Data: 29/04/2013

Mx. 64 No retorno contm, caso exista, a Trilha 2 lida Fixo 6 Define o tempo mximo de espera pela passagem do carto em segundos. Se zero, espera at que o carto seja passado Rotina da aplicao de automao que retorna 0 se para continuar aguardando pelo carto e 1 caso deva interromper o processo de aguardar a passagem do carto

TestaCancela mento

Rotina

No Usado

No retorno a rotina devolve o valor 0 (zero) caso tenha sido executada corretamente e um valor diferente de zero em caso de erro ou interrupo. Para esta rotina especfica, os cdigos de erro retornados so: Valor 0 1 2 3 4 5 6 7 Descrio No ocorreu erro Campo de sada insuficiente BIN no aceito CNPJ invlido Chave de acesso vencida Verso invlida Chave de criptografia invlida Dados no criptografados com a chave fornecida como parmetro: a decriptografia resultou em um nmero de carto que no composto s por dgitos. 8 Dado de entrada invlido

Os campos TipoCampoTrilha1 e TipoCampoTrilha2 indicam o tipo de campo retornado, respeitando o valor estabelecido para os campos sensveis, com 202x para campos abertos mascarados, 203x para o Hash dos campos e 204x para campos criptografados. TipoCampo 202x Campos abertos, mascarados. 203x Hash dos campos 204x Campos criptografados x 1 2 3 4 5 Descrio

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

Software Express Ltda., 2013

41

Especificao Tcnica Interface com os meios de pagamento do SiTef Bibliotecas CliSiTefI e CliSiTef
3.9 Leitura de senha

Verso: 120 Data: 29/04/2013

Esta funo permite que o aplicativo capture no PinPad uma senha de um cliente de carto do prprio estabelecimento comercial (carto proprietrio). No deve, em nenhuma hiptese, ser utilizada para captura de senhas dos cartes tradicionais. O formato de ativao o seguinte:
long LeSenhaInterativo (Parametros)

Interface ASCII
LeSenhaInterativoA (Resultado, Parametros)

Parmetro Resultado Parametros

Tipo Sada, por valor Entrada, por valor

Interface Interface Descrio padro ASCII No usado Fixo 6 Contm o resultado de resposta chamada da rotina char * Fixo 64 Dados gerados por uma biblioteca de segurana fornecida pela Software Express para habilitar a captura da senha do cliente. Neste caso, a CliSiTef poder interagir com o SiTef para obter ou validar os dados de segurana necessrios para a captura

No retorno a rotina devolve os mesmos valores que a rotina de pagamento. O aplicativo obtm a senha atravs da chamada a funo de continuao do processo interativo. IMPORTANTE: Essas funes NO podem ser utilizadas durante a execuo do lao ContinuaFuncaoSiTefInterativo. Para esse tipo de situao existem as verses que fazem o acesso direto a leitora de senhas descritas a seguir.
long LeSenhaDireto (Parmetros, SenhaCliente)

Interface ASCII
LeSenhaDiretoA (Resultado, Parmetros, SenhaCliente)

Parmetro Resultado Parametros

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

Interface Interface Descrio padro ASCII ----Fixo 6 Contm o resultado de resposta chamada da rotina char * Fixo 64 Dados gerados por uma biblioteca de segurana fornecida pela Software Express para habilitar a captura da senha do cliente Senha do cliente, em formato criptografado, e que deve ser passada para uma rotina personalizada por cliente para sua descriptografia

Senha

char *

Fixo 20

No retorno a rotina devolve o valor 0 (zero) caso tenha sido executada corretamente e um valor diferente de zero em caso de erro ou cancelamento pelo usurio.

Software Express Ltda., 2013

42

Especificao Tcnica Interface com os meios de pagamento do SiTef Bibliotecas CliSiTefI e CliSiTef
3.10 Leitura de Confirmao pelo Cliente no PinPad

Verso: 120 Data: 29/04/2013

Estas funes permitem que o aplicativo solicite uma confirmao no PinPad. O formato de ativao o seguinte:
long LeSimNaoPinPad (Mensagem)

Interface ASCII
LeSimNaoPinPadA (Resultado, Mensagem)

Parmetro Resultado Mensagem

Tipo Sada, por valor Entrada, por valor

Interface Interface Descrio padro ASCII No usado Fixo 6 Contm o resultado de resposta chamada da rotina char * Varivel Mensagem a ser apresentada no visor do PinPad

No retorno a rotina devolve 0 se o cliente pressionou a tecla de Cancelamento, 1 se ele pressionou a tecla de Confirmao e outro valor em caso de erro no acesso ao PinPad. Notar que essa funo no interativa ou seja, o controle de execuo somente volta para a aplicao aps o pressionamento da tecla.

Software Express Ltda., 2013

43

Especificao Tcnica Interface com os meios de pagamento do SiTef Bibliotecas CliSiTefI e CliSiTef
3.11 Correspondente Bancrio (Pagamento de Contas)

Verso: 120 Data: 29/04/2013

Esta funo permite que o aplicativo de automao aceite o pagamento de contas diversas de acordo com o contrato firmado entre ele e um Banco Correspondente. O formato de ativao desta funcionalidade o seguinte:
long CorrespondenteBancarioSiTefInterativo (CupomFiscal, DataFiscal, Horario, Operador, ParamAdic)

Interface ASCII
CorrespondenteBancarioSiTefInterativoA (Resultado, CupomFiscal, DataFiscal, Horario, Operador, ParamAdic)

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

Software Express Ltda., 2013

44

Especificao Tcnica Interface com os meios de pagamento do SiTef Bibliotecas CliSiTefI e CliSiTef
3.12 Verificao da integridade de um cdigo em barras

Verso: 120 Data: 29/04/2013

Permite, na coleta manual dos campos presentes em um cdigo em barras, que o aplicativo faa a validao a medida que os campos esto sendo digitados, de forma a alertar o operador antecipadamente e permitir que ele corrija o erro. O formato de ativao da rotina o seguinte:
long ValidaCampoCodigoEmBarras (Dados, Tipo)

Interface ASCII
ValidaCampoCodigoEmBarrasA (Resultado, Dados, Tipo)

Parmetro Resultado Dados Tipo

Interface Interface Descrio padro ASCII Sada, No usado Fixo 6 Contm o resultado de resposta chamada da rotina por valor conforme descrito a seguir Entrada, char * Varivel Dados coletados at o momento. Cada campo deve por valor estar concatenado ao seguinte Sada, short * Fixo 6 Informa o tipo do documento coletado segundo a por seguinte codificao: referncia -1 Ainda no foi possvel definir o tipo 0 Arrecadao 1 Ttulo Tipo

Recomendao: recomendvel que aplicao do terminal, uma vez identificado que o documento ser digitado, abra campos de coleta simulares aos presentes nos documentos a serem pagos. Para isso ela precisar identificar se uma Ficha de Compensao/Titulo/Bloqueto ou Ficha de Arrecadao/Tributos. Essa identificao pode ser feita mediante uma pergunta ao operador ou atravs da rotina aqui descrita. Se o usurio optar pelo reconhecimento automtico ele deve abrir um campo como se fosse de Arrecadao e, a cada digito fornecido pelo operador, passar os dgitos j fornecidos para a rotina. Esse procedimento deve ser feito at o momento que a rotina devolver se o documento em questo um Ttulo ou Arrecadao. Nesse momento a aplicao no precisa mais chamar a rotina a cada dgito fornecido e deve, se necessrio, modificar a formatao dos campos para captura.

Software Express Ltda., 2013

45

Especificao Tcnica Interface com os meios de pagamento do SiTef Bibliotecas CliSiTefI e CliSiTef

Verso: 120 Data: 29/04/2013

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

Software Express Ltda., 2013

46

Especificao Tcnica Interface com os meios de pagamento do SiTef Bibliotecas CliSiTefI e CliSiTef

Verso: 120 Data: 29/04/2013

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

47

Especificao Tcnica Interface com os meios de pagamento do SiTef Bibliotecas CliSiTefI e CliSiTef

Verso: 120 Data: 29/04/2013

3.13 Verificao da quantidade de transaes pendentes de confirmao no terminal

Esta funo utilizada pelo terminal para saber quantas transaes foram realizadas em caso de queda de energia.
int ObtemQuantidadeTransacoesPendentes (DataFiscal, CupomFiscal)

Interface ASCII
ObtemQuantidadeTransacoesPendentesA (Resultado, DataFiscal, CupomFiscal)

Parmetro Resultado DataFiscal CupomFiscal

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

Interface Interface Descrio padro ASCII No usado Fixo 6 Contm o resultado de resposta chamada da rotina char * char * Fixo 8 Data Fiscal no formato AAAAMMDD

Mx. 20 Nmero do Cupom Fiscal correspondente venda

O retorno da rotina a quantidade de transaes pendentes para o cupom fiscal.


3.14 Obtendo Verso

Esta funo utilizada pelo terminal para obter as verses da CliSiTef e CliSiTefI.
int ObtemVersao (VersaoCliSiTef, VersaoCliSiTefI)

Interface ASCII
ObtemVersaoA (Resultado, VersaoCliSiTef, VersaoCliSiTefI)

Parmetro Resultado VersaoCliSiTef VersaoCliSiTefI

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

Interface Interface Descrio padro ASCII No usado Fixo 6 Contm o resultado de resposta chamada da rotina char * Mx. 64 No retorno contm a verso da CliSiTef char * Mx. 64 No retorno contm, caso exista, a verso da CliSiTefI

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

Software Express Ltda., 2013

48

Especificao Tcnica Interface com os meios de pagamento do SiTef Bibliotecas CliSiTefI e CliSiTef
3.15 Descarregando Mensagens

Verso: 120 Data: 29/04/2013

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

Para obter informaes bsicas sobre o PinPad conectado no PDV, basta utilizar a seguinte funo:
int ObtemInformacoesPinPad (InfoPinPad)

Parmetro InfoPinPad

Tipo Sada, por valor

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

Em caso de sucesso, os dados sero retornados no seguinte formato: 2 caracteres numricos que indicam a informao obtida sendo: 01 para o Nome do fabricante, 02 para o Modelo / verso do hardware, 03 para a Verso do software bsico/firmware, 04 Verso da especificao compartilhada 05 para a Verso da aplicao bsica, 06 para o Nmero de srie. 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

Software Express Ltda., 2013

49

Especificao Tcnica Interface com os meios de pagamento do SiTef Bibliotecas CliSiTefI e CliSiTef 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

Verso: 120 Data: 29/04/2013

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.

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, o arquivo de configurao utilizado CLSIT. Ao longo deste documento, todas as menes para CliSiTef.ini devem ser entendidas como CLSIT quando se tratar de POS. A seguir descreveremos algumas funcionalidades macro presentes neste arquivo.
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. 4.1.2 Definio da mensagem padro possvel inicializar o PinPad com uma mensagem de at 16 caracteres. Esta mensagem configurada na seo PinPad, campo MensagemPadrao.

Software Express Ltda., 2013

50

Especificao Tcnica Interface com os meios de pagamento do SiTef Bibliotecas CliSiTefI e CliSiTef
[PinPad] MensagemPadrao=<MENSAGEM>

Verso: 120 Data: 29/04/2013

possvel quebrar em duas linhas, utilizando o separador |.

Software Express Ltda., 2013

51

Especificao Tcnica Interface com os meios de pagamento do SiTef Bibliotecas CliSiTefI e CliSiTef
4.2 Configurao de conexo com o servidor SiTef

Verso: 120 Data: 29/04/2013

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 Tempo adicional para timeout 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, sem segundos>

Software Express Ltda., 2013

52

Especificao Tcnica Interface com os meios de pagamento do SiTef Bibliotecas CliSiTefI e CliSiTef

Verso: 120 Data: 29/04/2013

4.2.4 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

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

Software Express Ltda., 2013

53

Especificao Tcnica Interface com os meios de pagamento do SiTef Bibliotecas CliSiTefI e CliSiTef 5. Restrio ou habilitao das formas de pagamento
5.1 Restrio durante o processo de finalizao de uma venda

Verso: 120 Data: 29/04/2013

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

54

Especificao Tcnica Interface com os meios de pagamento do SiTef Bibliotecas CliSiTefI e CliSiTef
5.3 Habilitao de transaes adicionais

Verso: 120 Data: 29/04/2013

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

55

Especificao Tcnica Interface com os meios de pagamento do SiTef Bibliotecas CliSiTefI e CliSiTef Carto Combustvel Carto Presente

Verso: 120 Data: 29/04/2013

Exemplificando, para habilitar o menu de pagamento com carto Refeio Eletrnico deve-se incluir a seguinte configurao em CliSiTef.ini: [Geral] TransacoesAdicionaisHabilitadas=20
5.4 Desabilitando transaes

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

Consulte a Tabela de cdigos de meios de pagamento, configuraes e menus para a lista de cdigos nesta configurao.
5.5 Habilitao de transaes de redes especficas

Existem algumas redes que, por no serem de uso generalizado, no esto automaticamente habilitadas na CliSiTef. Neste caso, para habilit-las, existe a seo [Redes] no arquivo de configurao CliSiTef.ini e que deve conter o nome da varivel correspondente a rede a ser habilitada com o valor 1. Caso o estabelecimento trabalhe com mais de uma rede das descritas a seguir, deve ser includa uma linha para cada rede.
[Redes] HabilitaRedexxxx=1

Onde xxxx pode ser, na presente verso da CliSiTef, um dos seguintes valores abaixo. Note que possvel habilitar tantas redes quanto necessrio, desde que elas estejam habilitadas no SiTef de forma compatvel. Rede Accor ACSP Algorix Avista BancoIbi BancoMercantil

Software Express Ltda., 2013

56

Especificao Tcnica Interface com os meios de pagamento do SiTef Bibliotecas CliSiTefI e CliSiTef BancoPanamericano BancoProvincial BOD CdlPoa CdlRio CentralCard CheckCheck Citibank ClubCard Cisa CompreMax Condor ConsorcioVenezuela ConsultaValePapel CooperCred Dotz Ediguay Eletrozema EMS Fidelize Formosa FoxWinCards ICards InfoCard MAR Neus Oboe Omnion Orbitall Parati Platco PortalCard Qualicard SasNT SigaCred SisCred Softway SpcBrasil SQCF Starfiche Sysdata Telecheque Teledata Total UpSight UseCred Software Express Ltda., 2013

Verso: 120 Data: 29/04/2013

57

Especificao Tcnica Interface com os meios de pagamento do SiTef Bibliotecas CliSiTefI e CliSiTef Validata Wappa Tricard TopCard

Verso: 120 Data: 29/04/2013

Software Express Ltda., 2013

58

Especificao Tcnica Interface com os meios de pagamento do SiTef Bibliotecas CliSiTefI e CliSiTef
5.6 Tabela de cdigos de meios de pagamento, configuraes e menus

Verso: 120 Data: 29/04/2013

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

Especificao Tcnica Interface com os meios de pagamento do SiTef Bibliotecas CliSiTefI e CliSiTef Re-impresso de pagamento de conta Pagamento de Benefcio Estorno do Pagamento de Benefcio Tratamento de troco no pagamento de contas com dinheiro Reimpresso Reimpresso do ltimo Comprovante Reimpresso Especfica Recarga de celular com Dinheiro Recarga de celular com Cheque Recarga de celular com carto de dbito a vista Recarga de celular com carto de crdito a vista Indica o Menu para seleo da operadora de recarga Reimpresso do lojista Reimpresso do portador do carto Todas as reimpresses Crdito Centralizado Consulta de Saldo - Corresponde Bancrio Saque - Corresponde Bancrio Estorno de Saque - Corresponde Bancrio Depsito - Corresponde Bancrio Estorno de Depsito - Corresponde Bancrio Conta Corrente Conta Poupana Conta Benefcio Conta Salrio Conta Empresa Conta Investimento Conta Funcionrio Viajante Consulta de Saldo com Carto Magntico - Corresponde Bancrio Consulta de Saldo com Digitao dos Dados da Conta - CB Saque de Benefcio INSS - Corresponde Bancrio Saque com Carto Magntico - Corresponde Bancrio Saque com Cheque - Corresponde Bancrio Saque com Recibo de Retirada - Corresponde Bancrio Estorno de Saque de Benefcio INSS - Corresponde Bancrio Estorno de Saque com Cheque - Corresponde Bancrio Estorno de Saque com Recibo de Retirada - Corresponde Bancrio Estorno de Depsito com Dinheiro - Corresponde Bancrio Estorno de Depsito com Cheque - Corresponde Bancrio Estorno de Depsito com Dinheiro + Cheque CB Consulta Cheque SPC Brasil Garantia Cheque SPC Brasil Tipo Conta: FAL Tipo Conta: Pontos SCCard Consulta Saldo Dbito Consulta Saldo Crdito Recarga de Celular Bradesco

Verso: 120 Data: 29/04/2013 52 53 54 55 56 57 58 60 61 62 63 64 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 3000 3001 3002 3003 3004 3005

Software Express Ltda., 2013

60

Especificao Tcnica Interface com os meios de pagamento do SiTef Bibliotecas CliSiTefI e CliSiTef Reimpresso Especfica Redecard Reimpresso Especfica Visanet Troco Surpresa (Premiado) Pagamento em dinheiro Pagamento CB em cheque Pagamento com TEF Dbito Pagamento com TEF Crdito Pagamento em outra forma Vale refeio e alimentao Visanet ValeGs ValeGs Ultragaz ValeGs GetNet Pagamento de Conta Orbitall Estorno de pagamento de Conta Orbitall Carto Combustvel Carto Combustvel Digitado Carto Combustvel Magntico Carto Dbito Pr-Pago Consulta Saldo Carto Dbito Pr-Pago Carto Crdito Cdigo em Barras Carto Presente Opo Administrativa Redecard Carto Presente Magntico Carto Presente Digitado Carto Presente Cdigo em Barras Opo Compra e Saque Redecard Pagamento de Fatura Pagamento de Convnio Saque Banco IBI Estorno de Saque Banco IBI Pagamento de Fatura Banco IBI Estorno de Pagamento de Fatura Banco IBI Saldo SPTrans Recarga SPTrans Garantia Cheque Infocard Estorno Garantia Cheque Infocard Garantia Cheque CDL-Poa Extrato Extrato Magntico Extrato Digitado Recarga HSBC Saque Crdito Estorno de Saque Crdito Consultas de Carto de Crdito Extrato Carto de Crdito Saldo Convnio Crdito Consulta Liberao de Carto Crdito Consulta ltima Fatura de Carto Crdito

Verso: 120 Data: 29/04/2013 3006 3007 3008 3009 3010 3011 3012 3013 3014 3015 3016 3017 3018 3019 3020 3021 3022 3023 3024 3025 3026 3027 3028 3029 3030 3031 3032 3033 3034 3035 3036 3037 3038 3039 3040 3041 3042 3043 3044 3045 3046 3047 3048 3049 3050 3051 3052 3053

Software Express Ltda., 2013

61

Especificao Tcnica Interface com os meios de pagamento do SiTef Bibliotecas CliSiTefI e CliSiTef Altera Senha de Carto Crdito Libera Carto de Crdito Produtos SPTrans DARF GPS DARF Simples DARF Preto Estorno DARF Estorno GPS Emprstimo Pr-Aprovado Emprstimo Pr-Aprovado Magntico Emprstimo Pr-Aprovado Digitado Abertura de Conta Conta Individual Conta Conjunta E / OU Conta Conjunta E (Solidria) Pagamento de Conta Infocard Estorno de Pagamento de Conta Infocard Pagamento de Conta Banrisul Pagamento de Conta Central Card Pagamento de Conta Portal Card Pagamento de Conta Softway Pagamento de Conta Parati Pagamento de Conta Ediguay Pagamento de Conta CooperCred Pagamento de Conta Validata Pagamento de Conta Panamericano Pagamento de Conta SigaCred Pagamento de Conta UseCred Pagamento de Conta SisCred Pagamento de Conta Fininvest (Menu principal) Estorno de Pagamento de Conta Banrisul Estorno de Pagamento de Conta Fininvest Estorno de Pagamento de Conta Central Card Estorno de Pagamento de Conta Portal Card Estorno de Pagamento de Conta Softway Estorno de Pagamento de Conta Ediguay Estorno de Pagamento de Conta CooperCred Estorno de Pagamento de Conta Panamericano Estorno de Pagamento de Conta SigaCred Estorno de Pagamento de Conta UseCred Estorno de Pagamento de Conta SisCred Repasse CB Administrativo CB Administrativo CB Banrisul Pagamento de Conta Carto EMS Estorno de Pagamento de Conta Carto EMS Cdigo Resumido EMS

Verso: 120 Data: 29/04/2013 3054 3055 3056 3057 3058 3059 3060 3061 3062 3063 3064 3065 3066 3067 3068 3069 3070 3071 3072 3073 3074 3075 3076 3077 3078 3079 3080 3081 3082 3083 3084 3085 3086 3087 3088 3089 3090 3091 3092 3093 3094 3095 3096 3097 3098 3099 3100 3101

Software Express Ltda., 2013

62

Especificao Tcnica Interface com os meios de pagamento do SiTef Bibliotecas CliSiTefI e CliSiTef Cdigo de Barras do Carn Digitao do Dados do Carn Menu de Consultas EMS Consulta Rpida EMS Consulta Extrato EMS Consulta Milhas EMS Consulta Mini-Extrato EMS Registro de Ocorrncia EMS Registro de Cancelamento de Ocorrncia EMS Incluso de Cliente EMS Alterao de Dados Cadastrais Cliente EMS Consulta Dados Cadastrais Cliente EMS Transao EMS por Carto Magntico Transao EMS por Digitao do Carto Transao EMS por Digitao do CPF Extrato EMS Parcial Extrato EMS Total Sexo Masculino Sexo Feminino Menus de Vendas EMS Venda Carto EMS Venda EMS Outros Meio de Pagamento Venda EMS A Vista Venda EMS Parcelada Sem Juros Venda EMS Parcelada Com Juros Venda Normal EMS Venda Forada EMS Compra EMS Vinculada a Lista de Presentes Compra EMS Outros Vnculos Venda EMS - Dinheiro Venda EMS - Cheque a Vista Venda EMS - Cheque Pr Venda EMS Carto de Dbito Venda EMS Carto de Crdito Venda EMS Ticket Venda EMS Cheque Administrativo Venda EMS Traveller Check Venda EMS Desconto em Folha Venda EMS Vale Venda EMS - Milhas Venda EMS - Debito em folha Venda EMS Voucher Venda EMS Carto Presente Venda EMS Private Label Venda Rotativo A Vista Fininvest Venda Rotativo Pr-Datado Fininvest Venda Parcelado Fininvest Venda Parcelado Pr-Datado Fininvest

Verso: 120 Data: 29/04/2013 3102 3103 3104 3105 3106 3107 3108 3109 3110 3111 3112 3113 3114 3115 3116 3117 3118 3119 3120 3121 3122 3123 3124 3125 3126 3127 3128 3129 3130 3131 3132 3133 3134 3135 3136 3137 3138 3139 3140 3141 3142 3143 3144 3145 3160 3161 3162 3163

Software Express Ltda., 2013

63

Especificao Tcnica Interface com os meios de pagamento do SiTef Bibliotecas CliSiTefI e CliSiTef Saque Rotativo Fininvest Saque Parcelado Fininvest Consulta Saque Fininvest Saque Fininvest Boleto Bancrio Contrato Pagamento de Conta Fininvest Pagamento de Fatura Fininvest Documento Provincial Documento No Provincial Com Provimillhas Sem Provimilhas Dbito Parcelas Iguais Consulta Cheque Banco Provincial Consulta Cheque BOD Garantia Cheque Banco Mercantil Consulta Cheque Consorcio Venezuela Fechamento do Lote Atual Banco Mercantil Fechamento de Lote Especifico Banco Mercantil Ajuste de Compra Ajuste de Compra Dbito Ajuste de Compra Crdito Consulta Totais de Compra Banco Provincial Consulta Totais A Pagar Banco Provincial Consulta Estado Lote Banco Provincial Fechamento de Lote Banco Provincial Fechamento de Lote BOD Fechamento de Lote Banco Mercantil Vale Refeio (Exceto Visanet) Vale Alimentao (Exceto Visanet) Venda Milhagem CooperCred Cancelamento de Venda Milhagem CooperCred Consulta de Saldo Cisa Consulta de Extrato Cisa Consulta de Saldo Softway Saque Softway Cancelamento de Saque Softway Carga de Pr-Pago Cancelamento de Carga de Pr-Cargo Executa Teste de Comunicao Transaes de Correspondente Bancrio Transaes de Recarga de Celular Transaes SPTrans SCCard Provedor Wappa Abertura de Caixa CB Fechamento de Caixa CB Sangria de Caixa CB

Verso: 120 Data: 29/04/2013 3164 3165 3166 3167 3168 3169 3170 3171 3172 3173 3174 3175 3176 3177 3178 3179 3180 3181 3182 3183 3184 3185 3186 3187 3188 3189 3190 3191 3192 3193 3194 3195 3196 3197 3198 3199 3200 3201 3202 3203 3204 3205 3206 3207 3208 3209 3210 3211

Software Express Ltda., 2013

64

Especificao Tcnica Interface com os meios de pagamento do SiTef Bibliotecas CliSiTefI e CliSiTef Menu carto Condor Opo crdito parcelado simples Pagamento carto Condor Estorno pagamento carto Condor Consulta extrato Condor Cancelamento Parcele mais Menu Starfiche Menu saque CB Banrisul Pagamento de conta UP SIGHT Estorno de Pagamento de conta UP SIGHT Menu opo NTPC Menu NTPC Pagamento com saque Recarga de celular com saque Troca de Senha Supervisor PinPad Menu Crdito CDC Opo conta pessoa jurdica Pagamento de conta rede MAR Estorno pagamento de conta rede MAR Pagamento de conta rede iCards Estorno de pagamento de conta rede iCards Menu pagamento de conta Obo Menu acmulo de pontos Obo Menu cancelamento acmulo de pontos Obo Menu venda crdito com autorizao vista Menu pagamento de conta Qualicard Menu estorno de pagamento de conta Qualicard Menu de autorizao genrica SEM Menu pagamento de conta rede Avista Menu carto virtual Formosa Menu pagamento de contas Neus Menu estorno de pagamento de contas Neus Menu pagamento de contas Algorix Menu estorno de pagamento de contas Algorix Menu carga de carto presente Algorix Menu de cancelamento de carga de carto presente Algorix Menu venda crdito CompreMax Menu cancelamento CompreMax Menu cancelamento Carto Combustvel Menu pagamento de contas SysData Menu estorno de pagamento de contas SysData Menu consulta de pagamento Validata Menu pagamento recarga SPTrans (Menu gerencial) Menu pagamento de conta SQCF Menu cancelamento de pagamento de conta SQCF Menu carto Qualidade (ICI Card) Menu opo Saque Crdito Transferncia Menu saque GetNet

Verso: 120 Data: 29/04/2013 3212 3213 3214 3215 3216 3217 3218 3219 3220 3221 3222 3223 3224 3225 3226 3227 3228 3229 3230 3231 3232 3262 3263 3264 3267 3276 3277 3278 3279 3280 3281 3282 3283 3284 3285 3286 3287 3288 3289 3296 3297 3298 3299 3303 3304 3305 3306 3319

Software Express Ltda., 2013

65

Especificao Tcnica Interface com os meios de pagamento do SiTef Bibliotecas CliSiTefI e CliSiTef Menu estorno de saque GetNet Menu conta especial Menu conta fidelidade Menu outra conta Menu fechamento de lote Platco Menu registro de gorjeta Menu consulta ltima venda Menu garantia de cheque Platco Menu devoluo Platco Menu pagamento recarga SPTrans (Menu especfico) Menu Pagamento Conta FoxWin Cards Menu estorno de Pagamento Conta FoxWin Cards Menu Pagamento Conta HotCard Menu estorno de Pagamento Conta HotCard Menu Adm Gift Consulta Saldo de Carto Gift Recarga de Carto Gift Cancelamento de Recarga de Carto Gift Venda com Carto Gift Cancelamento de Venda com Carto Gift Menu Cancelamento Gift Tipo de conta FAL Tipo de conta principal Menu Emisso de Pontos Menu Cancelamento de Emisso de Pontos Menu Resgate de Pontos Menu Cancelamento de Resgate de Pontos (no usado ainda) Menu Opco Carto Pr Pago Digitado Menu Pagamento TriCard Menu Extrato Por Perodo (CB) Menu Extrato ltimos Lanamentos (CB) Menu Extrato ltimos Dias (CB) Menu Desbloqueio de Cheques (CB) Menu Opo de Pagamento c/ carto de Dbito CB Menu de Transferncia de Contas CB Menu Revalidao de Senha INSS CB Menu Depsito Identificado CB Menu Nome do Depositante (Depsito Identificado CB) Menu Cdigo do Depositante (Depsito Identificado CB) Menu Carto de Pagamento (Depsito Identificado CB) Menu Pagamento de Fatura (Depsito Identificado CB) Menu opo de Pagamento c/ carto Digitado (CB) Menu opo de Pagamento c/ carto Magntico (CB) Menu opo Pagamento de Fatura Digitado (CB) Menu opo Pagamento de Fatura Magntico (CB) Menu Pagamento de Fatura genrico Menu opo Pr Autorizao Carto Combustvel Menu Ativao Gift

Verso: 120 Data: 29/04/2013 3320 3324 3325 3326 3327 3328 3329 3330 3331 3334 3335 3336 3337 3338 3339 3340 3341 3342 3343 3344 3345 3346 3347 3348 3349 3350 3351 3352 3353 3363 3364 3365 3366 3367 3368 3369 3370 3371 3372 3373 3374 3375 3376 3377 3378 3379 3389 3390

Software Express Ltda., 2013

66

Especificao Tcnica Interface com os meios de pagamento do SiTef Bibliotecas CliSiTefI e CliSiTef Menu Pagamento Dinheiro Ativao Gift Menu Pagamento Cheque Ativao Gift Menu Pagamento Carto Dbito Ativao Gift Menu Pagamento Carto Crdito Ativao Gift Menu Pagamento ClubCard Menu Estorno Pagamento ClubCard Menu Pagamento Citibank Menu opo Carto Porto Seguro Auto Magntico Menu opo Carto Porto Seguro Auto Digitado Menu Saque ClubCard Menu Pagamento CredMais Menu Consulta parcelas crdito Menu Estorno Pagto. Contas Banco Ibi Menu Cartao Eletrozema Menu Cancelamento Cartao Eletrozema Menu Consulta Eletrozema Menu Cancelamento de Pagamento de Fatura genrico Menu formas de pagamento para pagamento de carto Siscred

Verso: 120 Data: 29/04/2013 3391 3392 3393 3394 3407 3408 3409 3410 3411 3412 3466 3480 3500 3510 3511 3512 3515 3530

Software Express Ltda., 2013

67

Especificao Tcnica Interface com os meios de pagamento do SiTef Bibliotecas CliSiTefI e CliSiTef
5.7 Habilitao de configuraes especiais por transao

Verso: 120 Data: 29/04/2013

Em determinadas transaes, possvel incluir novas funcionalidades e caractersticas ao fluxo transacional, permitindo maior flexibilidade de operao sem que estas funcionalidades no estejam vinculadas a um meio de pagamento especfico. Para tanto, basta acrescentar um novo campo ao parmetro ParamAdic, presente nas funes que iniciam o processo de pagamento ou Correspondente Bancrio (IniciaFuncaoSiTefInterativo e CorrespondenteBancarioSiTefInterativo). O formato deste campo o seguinte:
{<Funcionalidade1>;<Funcionalidade2>;...;<Funcionalidaden>;};

Note que neste formato as funcionalidades esto entre chaves ({ e }), ao passo que as restries esto entre colchetes ([ e ]). Exemplo: no processo de venda exemplificado no item 5.1, suponha que o valor da venda possa ser alterado durante o fluxo, e que o aplicativo da automao deseje fazer seu tratamento, ento o valor do parmetro ParamAdic deve ser:
[10;17;18;19;27;28;34;35;];{TrataPagamentoExtendido=1;}

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

HabilitaVendaViaCodigoBarras=1

ItemMenuIdentificado=1

{MKRede=A,B,C,D} OBS: Esta configurao deve ser passada entre chaves ({}) separadamente, ou seja, no deve ser concatenada com nenhuma

Software Express Ltda., 2013

68

Especificao Tcnica Interface com os meios de pagamento do SiTef Bibliotecas CliSiTefI e CliSiTef

Verso: 120 Data: 29/04/2013

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

Software Express Ltda., 2013

69

Especificao Tcnica Interface com os meios de pagamento do SiTef Bibliotecas CliSiTefI e CliSiTef 6. Arquivos de controle

Verso: 120 Data: 29/04/2013

A CliSiTef permite configurar o diretrio onde sero gerados os seus arquivos de controle. Essa configurao deve ser feita pelo item DiretorioBase da seo SalvaEstado no arquivo CliSiTef.ini. No Windows, a pasta padro utilizada C:\CliSiTef\ChavesCliSiTef. No Linux, a pasta padro /tmp/ChavesCliSiTef.
[SalvaEstado] DiretorioBase=<DIRETORIO>

Exemplo Windows:
[SalvaEstado] DiretorioBase=C:\Chaves

Exemplo Linux:
[SalvaEstado] DiretorioBase =/home/usuario/chaves

Software Express Ltda., 2013

70

Especificao Tcnica Interface com os meios de pagamento do SiTef Bibliotecas CliSiTefI e CliSiTef 7. Trace

Verso: 120 Data: 29/04/2013

A CliSiTef normalmente grava informaes em um nico arquivo dirio, com mecanismo de rotao de logs. Ou seja, arquivos mais antigos so removidos automaticamente. No Windows, o arquivo gravado no padro C:\CliSiTef\CliSiTef.<AAAAMMDD>.dmp. No Linux, o arquivo gravado na pasta local, no padro CliSiTef.<AAAAMMDD>.dmp. Em equipamentos POS, o arquivo gravado na pasta local, no padro TRACE.
7.1 Configurao do perodo que o trace mantido

No arquivo de configurao CliSiTef.ini, possvel configurar o nmero de dias durante os quais o trace ser mantido. Por padro o trace fica habilitado por cinco dias.
[GERAL] NumeroDeDiasNoLog=n

onde n o nmero de dias. Zero grava indefinidamente.


7.2 Configurao de diretrio

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

Exemplo Windows:
[CliSiTef] DiretorioTrace=C:\Trace

Exemplo Linux:
[CliSiTef] DiretorioTrace=/home/usuario/trace

Software Express Ltda., 2013

71

Especificao Tcnica Interface com os meios de pagamento do SiTef Bibliotecas CliSiTefI e CliSiTef
7.3 Arquivos de trace por terminal

Verso: 120 Data: 29/04/2013

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

72

Especificao Tcnica Interface com os meios de pagamento do SiTef Bibliotecas CliSiTefI e CliSiTef 8. Processo de desenvolvimento/homologao

Verso: 120 Data: 29/04/2013

8.1 Arquivo de trace adicional durante a fase de desenvolvimento

A CliSiTefI possui um mecanismo de auxilio ao desenvolvedor da aplicao que interage com ela de forma a simplificar a busca por problemas durante a fase de desenvolvimento. Esse mecanismo, uma vez habilitado, faz com que seja gerado um arquivo de trace contendo os parmetros trocados entre a CliSiTef e a aplicao. O arquivo fica localizado no diretrio corrente ou em C:\CliSiTef, dependendo se o ambiente for Linux ou Windows, respectivamente. O nome do arquivo CliSiTef.AAAAMMDD.txt. Para habilitar essa caracterstica, inclua o seguinte parmetro no arquivo de configurao CliSiTef.ini:
[Geral] DataEmAmbienteDeDesenvolvimento=AAAAMMDD

Onde AAAAMMDD corresponde ao dia que o teste em laboratrio est sendo feito.

Em ambiente de produo essa configurao NO DEVE EXISTIR, sendo que a anlise de problemas nesse ambiente dever ser feita pela Software Express pela ativao de traces internos da CliSiTef, atravs de configuraes passadas pelo Suporte. Essa opo habilita, automaticamente, a opo a seguir.
8.2 Processo de homologao

Como descrito anteriormente, o fluxo descrito neste documento deve ser seguido a risca para que no ocorram erros estranhos durante a execuo da CliSiTef. Para tanto, existe um parmetro configurvel que ser utilizado pelos homologadores da Software Express para confirmar que o aplicativo de automao somente concretiza o processo de venda pela impresso de um comprovante ou pela chamada a funo FinalizaTransacaoSiTefInterativo aps o retorno final da ContinuaFuncaoSiTefInterativo. Esse parmetro o seguinte:
[Geral] EmAmbienteDeHomologacao=1

Por introduzir uma mensagem adicional no processo, ele jamais dever ser utilizado em ambiente de produo.

Software Express Ltda., 2013

73

Especificao Tcnica Interface com os meios de pagamento do SiTef Bibliotecas CliSiTefI e CliSiTef 9. Habilitando confirmao do valor no pinpad

Verso: 120 Data: 29/04/2013

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 em um documento a parte.

Software Express Ltda., 2013

74

Especificao Tcnica Interface com os meios de pagamento do SiTef Bibliotecas CliSiTefI e CliSiTef 11. Tabelas Cdigo das Redes Autorizadoras 00000 00001 00004 00005 00006 00021 00031 00082 00125 Cdigo da Bandeira (Carto de Crdito) 00000 00001 00002 00003 00004 00005 00006 00007 00008 00010 00011 00012 00013 00014 00015 12. Rotinas descontinuadas long LeCartaoInterativo (Mensagem); // Utilize LeCartaoSeguro LeCartaoInterativoA (Resultado, Mensagem); // Utilize LeCartaoSeguroA Descrio Outra, no definida Tecban Visanet - Especificao 200001 Redecard Amex Banrisul Ticket combustvel GetNet Visanet Especificao 4.1 Descrio Outro, no definido Visa Mastercard Diners American Express Sollo Sidecard (Redecard) Private Label (Redecard) Redeshop Fininvest (Visanet) JCB Hipercard Aura Losango Sorocred

Verso: 120 Data: 29/04/2013

long LeCartaoDireto (Mensagem, Trilha1, Trilha2); // Utilize LeCartaoDiretoSeguro LeCartaoDiretoA (Resultado, Mensagem, Trilha1, Trilha2); // Utilize LeCartaoDiretoSeguroA long LeCartaoDiretoEx (Mensagem, Trilha1, Trilha2, Timeout, TestaCancelamento); // Utilize LeCartaoDiretoSeguro LeCartaoDiretoExA LeCartaoDiretoSeguroA (Resultado, Mensagem, Trilha1, Trilha2, Timeout); // Utilize

Software Express Ltda., 2013

75

Especificao Tcnica Interface com os meios de pagamento do SiTef Bibliotecas CliSiTefI e CliSiTef

Verso: 120 Data: 29/04/2013

Data

07/05/2001 07/05/2001 07/05/2001 09/05/2001 13/05/2001 22/05/2001 27/05/2001 04/06/2001 21/08/2001 07/10/2001 21/10/2001 21/10/2001

22/10/2001 08/11/2001 02/01/2002 03/03/2002

14/03/2002 14/03/2002 16/03/2002 16/03/2002 19/03/2002

19/03/2002 03/04/2002 15/04/2002 03/09/2002

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

Software Express Ltda., 2013

76

Especificao Tcnica Interface com os meios de pagamento do SiTef Bibliotecas CliSiTefI e CliSiTef

Verso: 120 Data: 29/04/2013

05/09/2002 09/09/2002 19/09/2002

30/09/2002 02/10/2002 02/10/2002 28/10/2002 12/11/2002 27/11/2002

10/12/2002 27/12/2002 03/01/2003 13/01/2003 03/02/2003 V. 0.76e 12/02/2003 V. 0.76h 07/05/2003 V. 0.80 28/05/2003 V. 0.81 10/06/2003 21/07/2003 24/07/2003

29/09/2003 V. 096a 13/10/2003 V. 096j 14/10/2003

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

Software Express Ltda., 2013

77

Especificao Tcnica Interface com os meios de pagamento do SiTef Bibliotecas CliSiTefI e CliSiTef V. 096k 30/11/2003 V. 097 25/01/2004 V. 097m

Verso: 120 Data: 29/04/2013

06/02/2004 V. 097p 13/02/2004 V. 097s 04/05/2004 V. 098j 24/06/2004 V. 098s 07/07/2004 ---------23/07/2004 V. 0.98z8

Alterao na forma de tratamento dos cupons recebidos como retorno das transaes Gerenciais e Correspondente Bancrio. Incluso de novo exemplo de fluxo de utilizao da CliSiTefI Includo o campo 607 e a devoluo do Nsu do Host para o correspondente bancrio Detalhamento na forma com que a automao pode tratar uma coleta do campo 35 cdigo em barras Criada a funo ValidaCampoCodigoEmBarras que consiste os campos digitados isoladamente Includos novos campos no retorno das transaes de Correspondente Bancario Includo novo tipo de restrio para a Garantia de Cheque Papel Tecban Includa a funcionalidade de recarga de celular utilizando carto de dbito ou crdito e como habilitar tal caracterstica Includa forma para bloquear via restries os menus do Correspondente Bancrio Includo na documentao a forma da aplicao solicitar um retorno ao campo anterior Includa funo para apresentao de mensagem no visor do PinPad e captura de confirmao ou cancelamento pelo cliente Includo o menu de pagamento de benefcios do Banco do Brasil Includo retorno dos campos Valor em dinheiro e troco no caso do correspondente bancrio Modificada a nomenclatura do campo Restries para ParametrosAdicionais uma vez que esta ltima mais condizente com a funcionalidade oferecida por ele

02/08/2004 V. 0.98z8 V. 0.98/nv/4 24/08/2004 Includa as funes que permitem interromper a leitura de um carto proprietrio por V. 0.99 temporizao ou chamada de rotina externa 03/05/2005 Incluso de um novo cdigo de retorno para a funo ConfiguraIntSiTef.

Software Express Ltda., 2013

78

Especificao Tcnica Interface com os meios de pagamento do SiTef Bibliotecas CliSiTefI e CliSiTef

Verso: 120 Data: 29/04/2013

Data

26/08/2004

09/09/2004

09/09/2004 19/11/2004 28/12/2005 04/04/2006 17/08/2006

08/11/2006 15/01/2006

17/08/2007 06/02/2008 18/03/2008 28/03/2008 17/07/2008 01/06/2009 08/06/2009 01/07/2009 23/07/2009 23/07/2009 11/08/2009 12/08/2009 20/08/2009 27/08/2009 14/09/2009 30/09/2009 07/10/2009

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

Software Express Ltda., 2013

79

Especificao Tcnica Interface com os meios de pagamento do SiTef Bibliotecas CliSiTefI e CliSiTef 12/01/2010 27/01/2010 28/01/2010 11/02/2010 14/06/2010 06/07/2010 06/08/2010 21/09/2010 1.01.c.94.191 1.01.c.94.195 1.01.c.94.201 1.01.c.94.207 1.01.c.94.254 1.01.c.94.259 1.01.c.94.265

Verso: 120 Data: 29/04/2013

21/10/2010 11/11/2010 1.01.c.95.13

06/12/2010 28/01/2011 18/02/2011 11/05/2011

4.0.102.3.r1

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

27/05/2011 13/06/2011

4.0.102.6.r1 4.0.102.7.r1

08/07/2011 12/07/2011 01/08/2011 22/09/2011 25/10/2011 15/12/2011 09/05/2012 14/11/2012 21/12/2012 02/01/2013

4.0.102.9.r1 4.0.102.10.r1 4.0.102.12 r1 4.0.102.12 r14 4.0.104.6 b6 4.0.106.18 r1 4.0.106.18 r1

Software Express Ltda., 2013

80

Especificao Tcnica Interface com os meios de pagamento do SiTef Bibliotecas CliSiTefI e CliSiTef 18/01/2013 26/02/2013 06/03/2013 13/03/2013 4.0.106.18 r1 4.0.106.20 r1 -

Verso: 120 Data: 29/04/2013

29/04/2013

Incluso da modalidade 420, do tipo campo 2355 e alterao no texto do campo 1122. Incluso do parmetro ConexaoObrigatoria na seo SiTef Incluso do tipo campo 5050 na tabela de eventos. v119 - Reviso editorial do item Informaes do PinPad, e do campo 2355. Includo esclarecimentos sobre o processo de Descarregamento de Mensagens. v120 Correo na descrio de campos especficos ACSP que so retornados em outras redes, tornando-os genricos.

Software Express Ltda., 2013

81