sitef - interface simplificada com a aplicação(vrs-157)

7/24/2019 SiTef - Interface Simplificada Com a Aplicao(VRS-157)

1/104

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

Especificao Tcnica Interface com os meios depagamento do SiTef

Bibliotecas CliSiTefI e CliSiTef

Verso 157


2/104

Especificao TcnicaInterface com os meios de pagamento do SiTef Verso: 157Bibliotecas CliSiTefI e CliSiTef Data: 01/10/2015

Software Express Ltda., 2015 ii

ndice

1. Objetivos 1

1.1 Descrio Resumida 21.2 Fluxo Grfico 3

2. Descrio das interfaces com as rotinas disponveis na CliSiTef 4

2.1 Interface padro 42.2 Interface ASCII 4

3. API - Rotinas disponveis na CliSiTef 5

3.1 Configurao da biblioteca 63.1.1 Configuraes especiais gerais 7

3.2 Incio da transao de Pagamento ou Gerencial 8

3.2.1 Tabela de cdigos de retorno 103.2.2 Tabela de cdigos de funes 113.3 Continuao do processo de coleta interativo 17

3.3.1 Tabela de cdigos de Comando 203.3.2 Tabela de valores para TipoCampo 233.3.3 Tabela de Eventos, retornados tambm em TipoCampo 36

3.4 Confirmao ou no do Pagamento 383.5 Teste da presena de PinPad 393.6 Define mensagem permanente para o PinPad 393.7 Leitura da trilha 3 do carto 403.8 Leitura do carto - rotinas de captura segura 41

3.9 Leitura de senha 443.10 Leitura de Confirmao pelo Cliente no PinPad 463.11 Correspondente Bancrio (Pagamento de Contas) 463.12 Verificao da integridade de um cdigo em barras 483.13 Verificao da quantidade de transaes pendentes de confirmao no terminal 513.14 Obtendo Verso 513.15 Descarregando Mensagens 523.16 Informaes do PinPad 523.17 Carga de Tabelas no PinPad com alterao na Automao 543.18 Carga de Tabelas no PinPad sem alterao na Automao 55

4. Arquivo de configuraes CliSiTef.ini ou CLSIT 564.1 Configurao do PinPad 56

4.1.1 Configurao da porta 564.1.2 Configurao quando a Automao no utilizar pinpad 574.1.3 Configurao de um segundo pinpad 574.1.4 Definio da mensagem padro 58

4.2 Configurao de conexo com o servidor SiTef 594.2.1 Configurao de endereos IP adicionais 594.2.2 Configurao da porta do servidor SiTef 594.2.3 Obrigatoriedade de conexo 594.2.4 Mantendo conexo ativa 60

4.2.5 Configurao do mostrador de comunicao 604.2.6 Alterando parmetros de temporizaes (timeout) 614.2.7 Como passar um novo valor da compra da transao na CliSiTef 62


3/104


Software Express Ltda., 2015 iii

5. Restrio ou habilitao das formas de pagamento 63

5.1 Restrio durante o processo de finalizao de uma venda 635.2 Restrio de forma definitiva 635.3 Habilitao de transaes adicionais 64

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

6. Arquivos de controle 83

7. Trace 84

7.1 Configurao do perodo que o trace mantido 847.2 Configurao de diretrio 847.3 Arquivos de trace por terminal 85

8. Processo de desenvolvimento/homologao 86

8.1 Arquivo de trace adicional durante a fase de desenvolvimento 868.2 Processo de homologao 86

9. Habilitando confirmao do valor no pinpad 87

10. Traduo de mensagens 87

11. Tabelas 88

12. Rotinas descontinuadas 94


4/104


Software Express Ltda., 2015 1

Bibliotecas CliSiTefI e CliSiTef1. Objetivos

Da bibliotecaPropiciar 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 telasda prpria interface que, se existisse, na maioria das vezes no seria compatvel com a diagramao visualda aplicao principal do cliente;

Permite que a aplicao de automao restrinja as transaes disponveis para determinadopagamento uma vez que, na vida prtica, ocorre a negociao com o cliente e uma vez fechado o meio depagamento, quantidade de parcelas, etc, no devem ser modificados por engano na hora da execuo doTEF;

Permite total liberdade na incluso de novos produtos e meios de pagamento, acompanhando aevoluo do SiTef, sem que seja necessrio fazer nenhuma alterao na automao ou, se ela forimprescindvel (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 pagamentodisponveis no SiTef.

A biblioteca implementada atravs de duas DLLs para o ambiente Windows 32 bits e duas libspara o ambiente Linux (CliSiTefI e CliSiTef32). Ela possui pontos de entrada pelos quais a automaocomercial a configura, solicita um pagamento, solicita uma funo gerencial ou o pagamento de umaconta. 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 riscode, se isso for feito, desestabilizar o ambiente. Neste documento, qualquer referncia a CliSiTefdeve serentendida como o conjunto das duas dlls ou libs.

A CliSiTefpossui, para cada funcionalidade, dois pontos de entrada (rotinas). A escolha de qualdas interfaces ser utilizada pela aplicao depende do gosto pessoal do programador e de se o ambienteutilizado 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 eleaceitar somente dados em ASCII, necessariamente deve ser utilizada a interface batizada a seguir nessedocumento como A.


5/104



1.1 Descrio Resumida

Passo inicial

Inicialmente a Automao Comercial deve executar o comando ConfiguraIntSiTefInterativo,passando as informaes necessrias para que o Terminal de Vendas possa se comunicar com o SiTef,como Endereo IP do SiTef, Cdigo da Empresa (no SiTef Demonstraoeste cdigo 00000000) e aidentificao do terminal, que segue o seguinte formato: duas letras + 000 + nmero do Terminal deVendas.

Esta funo deve ser chamada somente quando a CliSiTef carregada ou seja, no necessriocham-la a cada nova transao (a menos que haja uma necessidade especfica para mudar parmetros deempresa, terminal ou IP do servidor SiTef).

Transao propriamente dita

Feito isto, a rotina devolve um valor dizendo se o comando foi aceito ou no. Se foi 0 o processoocorreu de forma correta.

O prximo passo , ento, chamar a funo IniciaFuncaoSiTefInterativo, passando os parmetrosdescritos 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 osparmetros 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 funoseja 0, indicando que ocorreu tudo bem, ou diferente de 0 e de 10000 indicando que ocorreu algumainterrupo 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 automaodeve imprimi-los e chamar uma outra funo, a FinalizaFuncaoSiTefInterativo, confirmando ou no atransao 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. Porexemplo, se retornou -2, significa que a transao foi cancelada pelo operador. Estes retornos negativosesto descritos neste documento.

Exemplificando graficamente o fluxo descrito neste tpico, teramos o seguinte:


6/104



1.2 Fluxo Grfico

ConfiguraIntSiTefInterativo

IniciaFuncaoSiTefInterativo

ContinuaFuncaoSiTefInterativo

O retorno foi igual a 0?

Houve devoluo de Cupom TEF pela CliSiTef?

Imprime o cupom;

O cupom foi impresso corretamente?

Chamar a funo FinalizaTransacaoSiTefInterativo

Com parmetro Confirma = 1

Retorno igual a 0 (zero)?Encerra a transao

S

S

S

S

S

Retorno igual a 10000?Encerra a transao

Encerra a transao

Encerra a transao

Chamar a funo FinalizaTransacaoSiTefInterativo

Com parmetro Confirma = 0

N

N

N

N

N

Retorno igual a 10000? Se Sim ento execute o

prximo Comando e chame novamente a funo

S

(lao)


7/104



2. Descrio das interfaces com as rotinas disponveis na CliSiTef

2.1 Interface padro

Esta interface pode ser utilizada por aplicaes escritas nas mais variveis linguagens deprogramao 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 emlinguagem C).

Todas as rotinas chamadas pelo aplicativo de automao devem ser do tipo stdcall, ou seja, osparmetros so empilhados da direita para a esquerda e a rotina chamada responsvel por remov-los dapilha. A conveno dos parmetros a seguinte:

Tipo Descriochar * Buffer em texto ASCII terminado por zero binrio.short int (short)unsigned short int (ushort)

Variveis que ocupam 2 bytes em memria, com e sem sinal,respectivamente.

long, unsigned long (ulong) Variveis que ocupam 4 bytes em memria, com e sem sinal,respectivamente.

void Indica a ausncia de parmetros ou retorno. *(exemplo: short int * ou long *)

Indica que a varivel do tipo var ivel est sendo passada comoendereo, ou seja, a CliSiTefir utilizar a rea da aplicao deautomao 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 aesquerda. Em particular, o campo cujo contedo seja um valor negativo, possui um sinal - na posiomais a esquerda do nmero (p/ex: -0001 para um campo de 5 posies cujo contedo o valor1).

Os de tamanho varivel so construdos de forma que o primeiro caractere indique qual o valorescolhido para ser o delimitador daquele campo ou seja, o campo delimitado pelo caractere escolhido ouo seu complementar no caso dos pares ( ), [ ], { } e < >. Exemplos de construes vlidasso:(1234), [1234], {1234}, , $1234$, %1234%, |1234|, etc. Exemplos NO VLIDOS so osseguintes: $12$34$, .1.234,56., etc.

O critrio para escolha do delimitador deve ser o de que ele no exista como caractere vlido nocampo em questo. Nas passagens de dados da aplicao para a CliSiTef, como estes sempre soconhecidos, a aplicao pode definir um caractere padro e sempre utiliz-lo em todas as passagens dedados. J no retorno, como qualquer caractere valido (por exemplo em um comprovante), a regra acimadeve ser utilizada na interpretao do resultado devolvido pela CliSiTefuma vez que esta ir escolher ocaractere que melhor se adapta a resposta que esta sendo gerada.

Finalizando, existe um caractere especial que utilizado nos textos direcionados para umaimpressora. O \ (barra reversa) indica o final de uma linha e deve ser utilizado pelo aplica tivo instruir aimpressora para fechar a linha corrente e se posicionar na seguinte.


8/104



3. API - Rotinas disponveis na CliSiTef

Na descrio a seguir, so apresentadas as duas verses de cada uma das funes disponveis ouseja, 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 Ano 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 elecontm apenas o delimitador de incio e final de campo.

Tamanho do campono caso de campo de tamanho fixo, quando esse valor for fornecido, indicaqual o tamanho mnimo a ser reservado pela aplicao para receber uma resposta do SiTef.

Tipo de parmetros da funodividiremos em dois grupos:1. Quanto ao fluxo de informaes: o parmetro pode ser de entradaou sada.2. Quando passagem: o parmetro pode ser passado por valorou por referncia.


9/104



3.1 Configurao da biblioteca

Atravs dessa rotina o aplicativo configura a CliSiTefde 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 TipoInterfacepadro

InterfaceASCII

Descrio

Resultado Sada,por valor

No usado Fixo 6 Contm o resultado de resposta chamada darotina

IPSiTef Entrada,por valor

char * Varivel Configura o nome ou endereo IP (em notao .)do servidor SiTef

IdLoja Entrada,por valor

char * Fixo 8 Identifica o nmero da loja perante a rede deestabelecimentos comerciais. Se no for fornecidoo SiTef identificar a loja baseado no IP origem daconexo

IdTerminal Entrada,por valor

char * Fixo 8 Identifica o pdv perante a loja. Se no for fornecidoo SiTef identificar a loja baseado no IP origem daconexo. obrigatrio se pIdLoja for fornecido.

Neste caso possui o formato XXnnnnnn onde XXcorresponde a 2 caracteres alfabticos e nnnnnn 6dgitos quaisquer desde que o nmero resultanteno sobreponha a faixa 000900 a 000999 que

reservada para uso pelo SiTefReservado Entrada,por valor

short Fixo 6 Deve ser passado com 0

ParametrosAdicionais

Entrada,por valor

char * Varivel Parmetros adicionais de configurao da CliSiTefno seguinte Formato:[=;=]


10/104



As rotinas devolvem um dos seguintes resultados:

Valor Descrio0 No ocorreu erro1 Endereo IP invlido ou no resolvido2 Cdigo da loja invlido3 Cdigo de terminal invlido6 Erro na inicializao do Tcp/Ip7 Falta de memria8 No encontrou a CliSiTefou ela est com problemas9 Configurao de servidores SiTef foi excedida.

10 Erro de acesso na pasta CliSiTef(possvel falta de permisso para escrita)11 Dados invlidos passados pela automao.12 Modo seguro no ativo (possvel falta de configurao no servidor SiTef do arquivo .cha).13 Caminho DLL invlido (o caminho completo das bibliotecas est muito grande).

Esta rotina deve ser chamada pelo menos uma vez, de forma a configurar os parmetros de conexocom o servidor SiTef.

Observao: durante o ciclo de vida da automao, caso no haja mudana nos parmetros deentrada da funo, ento no h necessidade de cham-la novamente.

3.1.1 Configuraes especiais gerais

Determinadas configuraes gerais (vlidas para todas as transaes) da CliSiTef podem serpassadas atravs do parmetro ParametrosAdicionais da rotina ConfiguraIntSiTefInterativoEx. Oformato deste campo o seguinte:

[;;...]

A seguir, descrevemos as funcionalidades previstas neste campo.

Funcionalidade DescrioMultiplosCupons=1 Indica que o PDV est apto para receber mais de um comprovante por

transao. No caso de transaes com mais de um comprovante, comotransaes de recarga de celular ou pagamentos de contas com cartesde crdito ou dbito, o comprovante da recarga de celular ou do

pagamento de conta ser entregue separadamente do comprovante doTEF de crdito ou dbito.

PortaPinPad= Define a porta em que est conectado o pinpad compartilhado.Ex:Windows: [PortaPinPad=1]Linux: [PortaPinPad=/dev/ttyS0]


11/104



3.2 Incio da transao de Pagamento ou Gerencial

long IniciaFuncaoSiTefInterativo (Funcao, Valor, CupomFiscal, DataFiscal,

HoraFiscal, Operador, ParamAdic)

Interface ASCII

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

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

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

Interface ASCII

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


InterfaceASCII

Descrio


No usado Fixo 6 Contm o resultado de resposta chamada da rotina

Funcao Entrada,

por valor

long Fixo 6 Seleciona a forma de pagamento, conforme a tabela

Cdigos de Funes a seguir.Valor Entrada,

por valorchar * Varivel Contm o valor a ser pago contendo o separador

decimal (,).Deve sempre ser passado com duascasas decimais aps a vrgula (,). Caso a operaono tenha um valor definido a priori (p/ex. recargade pr-pago), esse campo deve vir zerado

CupomFiscal Entrada,por valor

char * Mx. 20 Nmero do Cupom Fiscal correspondente venda

DataFiscal Entrada,por valor

char * Fixo 8 Data Fiscal no formato AAAAMMDD

HoraFiscal Entrada,por valor

char * Fixo 6 Horrio Fiscal no formato HHMMSS

Operador Entrada,por valor

char * Mx. 20 Identificao do operador de caixa

ParamAdic Entrada,por valor

char * Varivel Parmetros adicionais. Permite que o aplicativolimite o tipo de meio de pagamento. Ele opcional e

pode ser passado vazio. Quando esse campo forutilizado a CliSiTef ir limitar os menus denavegao apenas aos cdigos no presentes na lista.Vide item 5 para a descrio do formato internodeste campo

Produtos Entrada,por valor char * Varivel Contm a lista de produtos que o cliente estadquirindo no terminal de Auto-Atendimento. obrigatrio pois tais produtos faro parte integrante


12/104



do comprovante da operao de Tef a ser impresso.O formato bsico deste campo :

[;;;];[;;;];...

Campo FormatoDescrio 1 a 14 caracteresCdigo 1 a 08 caracteresQuantidade 1 a 04 dgitosValor 999.999,99

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

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


13/104



3.2.1 Tabela de cdigos de retorno

No retorno a rotina devolve um dos seguintes valores:

Valor Descrio0 Sucesso na execuo da funo.

10000 Deve ser chamada a rotina de continuidade do processo.outro valor positivo Negada pelo autorizador.

-1 Mdulo no inicializado. O PDV tentou chamar alguma rotina sem antes executara funo configura.

-2 Operao cancelada pelo operador.-3 O parmetro funo / modalidade invlido.-4 Falta de memria no PDV.-5 Sem comunicao com o SiTef.

-6 Operao cancelada pelo usurio (no pinpad).-7 Reservado-8 A CliSiTef no possui a implementao da funo necessria, provavelmente est

desatualizada (a CliSiTefI mais recente).-9 A automao chamou a rotina ContinuaFuncaoSiTefInterativo sem antes iniciar

uma funo iterativa.-10 Algum parmetro obrigatrio no foi passado pela automao comercial.-12 Erro na execuo da rotina iterativa. Provavelmente o processo iterativo anterior

no foi finalizado at o final (enquanto o retorno for igual a 10000).-15 Operao cancelada pela automao comercial.-20 Parmetro invlido passado para a funo.

-21 Utilizada uma palavra proibida, por exemplo SENHA, para coletar dados emaberto no pinpad. Por exemplo na funo ObtemDadoPinpadDiretoEx.

-25 Erro no Correspondente bancrio: Deve realizar sangria.-30 Erro de acesso ao arquivo. Certifique-se que o usurio que roda a aplicao tem

direitos de leitura/escrita.-40 Transao negada pelo SiTef.-41 Dados invlidos.-42 Reservado-43 Problema na execuo de alguma das rotinas no pinpad.-50 Transao no segura.

-100 Erro interno do mdulo.outro valor negativo Erros detectados internamente pela rotina.


14/104



3.2.2 Tabela de cdigos de funes

Os seguintes cdigos esto disponveis para serem usados no parmetroFuncaodescrita acima.

Funo Descrio0 Pagamento genrico. A CliSiTef permite que o operador escolha a forma de pagamento

atravs de menus.1 Cheque2 Dbito3 Crdito4 Fininvest5 Carto Benefcio6 Crdito Centralizado7 Carto Combustvel

8 Parcele Mais Redecard10 Benefcio Refeio Wappa11 Benefcio Alimentao Wappa12 Carto Infocard13 Pay Pass14 Carto Nova Plataforma Ticket Car (NPTC)15 Venda com carto Gift16 Dbito para pagamento de carn

50 Venda Boleto Carrefour

51 Venda Autorizacao Carrefour52 Recebimento Carrefour53 Incluso de Boleto Carrefour54 Incluso de Venda Carrefour55 Consulta Recebimento Carrefour56 Consulta Limite mnimo PromoFlex Carrefour57 Cancelamento de Recebimento Carefour

100 Telemarketing: Inicia a coleta dos dados da transao no ponto necessrio para tratar umatransao de carto de crdito digitado

110 Abre o menu de transaes Gerenciais111 Teste de comunicao com o SiTef112 Menu Re-impresso113 Re-impresso comprovante especfico114 Re-impresso ultimo comprovante115 Pr-autorizao116 Captura de pr-autorizao

150 Consulta Bnus151 Consulta Saldo Carto Presente

152 Consulta Saldo Carto Gift

160 Consultas Carto SEM


15/104



161 Vendas Carto EMS

200 Cancelamento Normal: Inicia a coleta dos dados no ponto necessrio para fazer ocancelamento de uma transao de dbito ou crdito, sem ser necessrio passar antes pelo

menu de transaes administrativas201 Cancelamento Telemarketing: Similar a modalidade 200 s que para a funo de

cancelamento de transao de crdito digitado202 Cancelamento Pr-autorizao203 Cancelamento da Captura da Pr-autorizao210 Cancelamento de venda com carto de Crdito211 Cancelamento de venda com carto de Dbito212 Cancelamento de venda com carto Combustvel213 Cancelamento de Venda com Carto Gift250 Cancelamento de Consulta Bnus

251 Cancelamento Recarga Carto Presente253 Cancelamento Acmulo de Pontos Carto Bnus254 Resgate de Pontos Carto Bnus255 Cancelamento de Resgate de Pontos Carto Bnus256 Acmulo de Pontos Carto Bnus257 Cancelamento Recarga Carto Gift

260 Recarga Carto Bnus262 Recarga Carto Presente264 Recarga Carto Gift265 Ativao Pagamento Vinculado Carto Gift

266 Consulta Carto Gift267 Ativao Carto Gift Sem Pagamento268 Ativao Carto Gift Com Pagamento269 Ativao Desvinculada Carto Gift

300 Recarga de pr-pago301 Recarga de pr-pago desvinculada do pagamento302 Recarga de pr-pago sem coleta de valor303 Recarga de pr-pago desvinculada do pagamento e sem coleta de valor

310 Corresponde Bancrio (Pagamento de Contas)311 Pagamento de Contas com Saque

312 Consulta para Pagamento Desvinculado (Genrico)313 Pagamento Desvinculado (Genrico)314 Recarga Pr Pago HSBC com Saque315 Saque para Pagamento316 Cancelamento do pagamento desvinculado (genrico)317 Consulta Limites do Correspondente Bancrio318 Recarga Pr Pago Bradesco319 Recarga Pr Pago Bradesco desvinculada do pagamento320 Recarga Pr Pago HSBC321 Recarga Pr Pago HSBC desvinculada do pagamento


16/104



322 Depsito Identificado323 Transferncia entre Contas324 Pague Fcil325 Revalidao de Senha INSS

350 Venda Produto (Sem Valor)351 Cancelamento de Venda Produto (Sem Valor)

400 Vale-Gs401 Validao Vale-Gs410 Troco Surpresa

411 Troco Premiado412 Cancelamento Troco Premiado

420 Troco Solidrio / Doao solidria

500 Consulta Detalhada ACSP501 Consulta Detalhada Serasa502 Consulta Cadastral Infocard

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

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

540 Pr-autorizao PharmaSystem541 Recuperao de pr-autorizao PharmaSystem542 Venda PharmaSystem543 Cancelamento PharmaSystem

550 Obtem Autorizao PBM552 Venda PBM553 Cancelamento Parcial PBM554 Cancelamento Total PBM

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

570 Consulta EPharma(PBM)571 Venda EPharma (PBM)


17/104



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

580 Consulta PrevSaude (PBM)

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

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

600 Consulta Saldo601 Consulta Saldo Carto de Dbito602 Consulta Saldo Carto de Crdito

605 Consulta Saldo Carto Combustvel606 Consulta Redes Carto Combustvel607 Consulta Produtos Carto Combustvel

610 Transaes SPTrans (Bilhete nico)611 Consulta Saldo SPTrans (Bilhete nico)612 Recarga SPTrans (Bilhete nico)

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

613 Carto Marisa (Orbital)

618 Venda Hopi Hari com Consulta de Produtos619 Consulta de Produtos Hopi Hari620 Venda Hopi Hari sem Consulta de Produtos621 Cancelamento Hopi Hari

625 Venda Voucher com Consulta Forncedores/Produtos626 Consulta Forncedores/Produtos Voucher627 Venda Voucher sem Consulta Forncedores/Produtos628 Cancelamento venda Voucher

630 Opes de transaes NPTC631 Consulta Saldo NPTC632 Atualizao Carto NPTC633 Consulta Produtos Host NPTC634 Consulta Produtos PDV NPTC635 Cadastra Produtos NPTC636 Troca de senha NPTC


18/104



637 Boleto de venda NPTC638 Venda NPTC639 Cancelamento de venda NPTC

640 Desbloqueio Carto Riachuelo641 Troca de senha Carto Riachuelo642 Venda Riachuelo

649 Venda Private Label Softway/Renner650 Venda Carto Bandeira Softway/Renner651 Pagamento de Fatura Softway652 Desbloqueio de Carto Softway/Renner653 Troca de Senha Carto Softway/Renner654 Consulta de Fatura Carto Softway/Renner

655 Venda Pin de Jogos656 Venda Pin de Recarga

657 Saque Crdito Transferncia658 Saque Crdito

660 Menu Saque IBI661 Consulta Saque Banco IBI662 Saque Banco IBI

663 Saque GetNet664 Cancelamento Saque GetNet

665 Resgate de Pontos667 Emisso de Pontos668 Cancelamento da Emisso de Pontos669 Carga de Pr Pago670 Cancelamento de Carga de Pr Pago

671 Consulta Saque com Saque Banco IBI

672 Cancelamento Saque Banco IBI

673 Venda DrogaRaia674 Cancelamento Venda DrogaRaia

675 Pagamento de Fatura IBI676 Cancelamento de Pagamento de Fatura IBI

680 Consulta Saldo Pr Pago

700 Venda Oi Paggo701 Cancelamento Oi Paggo702 Pagamento de contas


19/104



703 Cancelamento de Pagamento Carto Benefcio

704 Primeira Compra

705 Pagamento de Fatura

740 Consulta Parcelas Crdito Adm

770 Carga de tabelas no pinpad771 Carga forada de tabelas no pinpad (Local)772 Carga forada de tabelas no pinpad (SiTef)

775 Obteno de informaes do pinpad

999 Fechamento

1000 Voucher Papel

1Consulte o item3.17 -Carga de Tabelas no PinPadpara maiores informaes.2Consulte o item3.16 -Informaes do PinPadpara maiores informaes.


20/104



3.3 Continuao do processo de coleta interativo

Esta funo deve ser chamada de forma contnua at no existam mais informaes para seremtrocadas entre a aplicao e a CliSiTef, conforme descrito nos resultados devolvidos por ela. O formatode ativao o seguinte:

long ContinuaFuncaoSiTefInterativo (Comando, TipoCampo, TamMinimo,TamMaximo, Buffer, TamBuffer, Continua)

Interface ASCII

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

Parmetro Tipo Interfacepadro InterfaceASCII Descrio



Comando Sada,porreferncia

long * Fixo 12 Contm no retorno:0 caso a CliSiTef esteja devolvendo algum

dado referente a transao no campoBuffer

0 indica o Prximo Comando a ser executadopelo aplicativo. Os comando vlidos estodescritos em Tabela de cdigos de

ComandoTipoCampo Sada,

porreferncia

long * Fixo 12 Contm o cdigo do tipo de campo que a automaodeve tratar. Os tipos existentes esto descritos emTabela de valores para TipoCampo

TamMinimo Sada,porreferncia

short * Fixo 6 Quando o Comando for uma coleta de dados,contm o tamanho Mnimo e Maximo do campo aser lido

TamMaximo Sada,porreferncia

short * Fixo 6

Buffer Entrada esada,

por valor

char * Varivel rea de transferncia de dados entre a aplicao e aCliSiTef. Deve possuir, no mnimo, 20.000 bytes. Seautomao no estiver enviando dados para aCliSiTef, deve passar esse campo vazio

TamBuffer Entrada,por valor

long Fixo 6 Tamanho da rea reservada pela automao para ocampo Buffer

Continua Entrada,por valor

long Fixo 6 Contem instrues para a CliSiTef a respeito doComando executado segundo a seguinte codificao:0 Continua a transao1 Retorna, quando possvel, a coleta ao

campo anterior

2

Cancela o pagamento de conta atual,mantendo os anteriores em memria, casoexistam, permitindo que tais pagamentos


21/104



sejam enviados para o SiTef e at mesmopermite incluir novos pagamentos. Retornovlido apenas nas coletas de valores e datade vencimento de um pagamento de

contas.10000Continua a transao, vide observao aseguir

-1 Encerra a transao

Obs.: Como nem sempre o campo solicitado pela rotina precisa ser lido no momento da solicitaoa 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 formade 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 semcapturar esse dado do usurio.

Notar que nessa forma de uso imprescindvel que o dado seja apresentado para o operador quedever 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 osdados 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 SoftwareExpress que verificar a necessidade de autorizao prvia pelas bandeiras.

No retorno a rotina devolve os mesmos valores da rotina de Pagamento. Adicionalmente a estesvalores, 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 feitacom Comando, TipoCampo, TamMinimo, TamMaximoe Continuacontendo o valor zero (0).

Notar tambm que a automao comercial deve ficar em lao chamando a rotina aqui descrita atque ela receba um resultado diferente de 10000 ou que a prpria automao desista de continuar o

processo, conforme mostrado a seguir:


22/104



Caso a automao deseje encerrar o processo de coleta ela deve, necessariamente, chamar a rotinaContinuaFuncaoSiTefInterativopassando1 (menos um) no campo Continua. Caso o processo de coletadeva continuar, ela no deve modificar nenhum dos campos preenchidos pela CliSiTefa no ser oBufferque, na nova chamada, deve conter o resultado da coleta (se Comandodiferente de 0) ou o dado originalse Comando veio com 0. Notar ainda que mesmo que o Buffer contenha um campo coletado pelaautomao, 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 cadacomando que o aplicativo de automao deve tratar.

IMPORTANTE: obrigatrio que a automao SEMPRE colete campos no tratveis por ela ouseja, se ela receber algum cdigo em TipoCampo que ela desconhea ou no deseje tratar, que ainformao seja capturada pela digitao pelo operador da informao solicitada.

Inicializa Comando, TipoCampo,

TamMinimo, TamMaximo e

Continua com 0

Inicializa TamBuffer com o

tamanho do Buffer

Chama a rotina

ContinuaFuncaoSiTefInterativo

Retornou

10000?

Executa o Comando

solicitado

Fim

Sim

No

Incio


23/104



3.3.1 Tabela de cdigos de Comando

A seguir apresentamos os valores possveis para o parmetro Comando e a ao que a aplicao

deve executar ao receb-lo:Comando Descrio

0 Est devolvendo um valor para, se desejado, ser armazenado pela automao1 Mensagem para o visor do operador2 Mensagem para o visor do cliente3 Mensagem para os dois visores4 Texto que dever ser utilizado como ttulo na apresentao do menu ( vide comando 21)

11 Deve remover a mensagem apresentada no visor do operador (comando 1)12 Deve remover a mensagem apresentada no visor do cliente (comando 2)13 Deve remover mensagem apresentada no visor do operador e do cliente (comando 3)

14 Deve limpar o texto utilizado como ttulo na apresentao do menu (comando 4)15 Cabealho a ser apresentado pela aplicao. Refere-se a exibio de informaesadicionais que algumas transaes necessitam mostrar na tela.

Um exemplo a transao de Emprstimo do Correspondente Bancrio, que em certoponto precisa que sejam mostradas informaes para o cliente detalhando o emprstimoque est sendo contratado (como Valor da parcela, vencimento, etc..).

16 Deve remover o cabealho apresentado pelo comando 15.20 Deve apresentar o texto emBuffer, e obter uma resposta do tipo SIM/NO.

No retorno o primeiro carter presente emBufferdeve conter 0 se confirma e 1 se cancela.

21 Deve apresentar um menu de opes e permitir que o usurio selecione uma delas.

Na chamada o parmetroBuffercontm as opes no formato 1:texto;2:texto;...i:Texto;...

A rotina da aplicao deve apresentar as opes da forma que ela desejar (no sendonecessrio incluir os ndices 1,2, ...).

Aps a seleo feita pelo usurio, retornar em Buffero ndice iescolhido pelo operador(em ASCII)

22 Deve apresentar a mensagem em Buffer, e aguardar uma tecla do operador. utilizadaquando se deseja que o operador seja avisado de alguma mensagem apresentada na tela.

23 Este comando indica que a rotina est perguntando para a aplicao se ele desejainterromper o processo de coleta de dados ou no. Esse cdigo ocorre quando a CliSiTefest acessando algum perifrico e permite que a automao interrompa esse acesso (porexemplo: aguardando a passagem de um carto pela leitora ou a digitao de senha pelocliente)

29 Anlogo ao comando 30, porm deve ser coletado um campo que no requer intervenodo operador de caixa, ou seja, no precisa que seja digitado/mostrado na tela, e sim

passado diretamente para a biblioteca pela automao.

Um exemplo so as formas de pagamento que algumas transaes requerem paraidentificar qual o tipo de pagamento que est sendo usado.

O valor a ser coletado refere-se ao campo indicado em TipoCampo, cujo tamanho estentre TamMinimoe TamMaximo. O campo deve ser devolvido emBuffer.


24/104



30 Deve ser lido um campo cujo tamanho est entre TamMinimoe TamMaximo. O campo lidodeve ser devolvido emBuffer.

31 Deve ser lido o nmero de um cheque. A coleta pode ser feita via leitura de CMC-7,digitao do CMC-7 ou pela digitao da primeira linha do cheque.

No retorno deve ser devolvido em Buffer 0:(digitao da primeira linha do cheque),1:(Leitura do CMC-7) ou 2:(Digitao do CMC-7), seguido do nmero coletadomanualmente 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 doCheque (6) e C3 (1), nesta ordem. Notar que estes campos so os que esto na partesuperior 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 sejafeita com dados errados, retornando como bom um cheque com problemas.

34 Deve ser lido um campo monetrio ou seja, aceita o delimitador de centavos e devolvidono parmetroBuffer.

35 Deve ser lido um cdigo em barras ou o mesmo deve ser coletado manualmente.

No retorno Buffer deve conter 0: ou 1: seguido do cdigo em barras coletadomanualmente ou pela leitora, respectivamente.

Cabe ao aplicativo decidir se a coleta ser manual ou atravs de uma leitora. Caso sejacoleta manual, recomenda-se seguir o procedimento descrito na rotinaValidaCampoCodigoEmBarras de forma a tratar um cdigo em barras da forma maisgenrica possvel, deixando o aplicativo de automao independente de futuras alteraesque possam surgir nos formatos em barras.

No retorno doBuffertambm pode ser passado 2:, indicando que a coleta foi cancelada,porm o fluxo no ser interrompido, logo no caso de pagamentos mltiplos, todos osdocumentados coletados anteriormente sero mantidos e o fluxo retomado, permitindo aefetivao de tais pagamentos.

41 Anlogo ao Comando30, porm o campo deve ser coletado de forma mascarada.42 Menu identificado. Deve apresentar um menu de opes e permitir que o usurio selecione

uma delas.

Na chamada o parmetro Buffer contm as opes no formatoclasse|1:texto:cdigo:tipo;2:texto:cdigo:tipo;...i:Texto:cdigo:tipo;.

A rotina da aplicao deve apresentar as opes da forma que ela desejar (no sendonecessrio incluir os ndices 1,2, ..., nem cdigos do campo, tipo e classe) e aps a seleofeita pelo usurio, retornar emBuffero 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


25/104



natureza da opo. Inicialmente foi implementada apenas a identificao para as formas depagamento. A ideia adicionar cdigos que identificam as opes do menu parapossibilitar que o PDV identifique essas opes sem o auxlio do operador.

Classe Descrio0 Classe no definida

1 Forma de pagamento

Tipo Descrio1 Dinheiro2 Cheque3 Dbito4 Crdito5 Saque

6 Outra forma

Os demais menus no esto identificados. Os menus no identificados recebem o valorzerado 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 queidentifica o tipo de opo seja determinado. Assim, uma opo no menu identificadasempre a partir do par tipo da opo e classe da opo.

Esse comando passa a ser utilizado quando o parmetro adicional ItemMenuIdentificadofor utilizado (Habilitao de configuraes especiais). Nesse caso, o comando 21 (coletade menu) ser substitudo na maior parte dos casos, sendo obrigao da aplicao estar

preparada para tratar os dois comandos, quando esse parmetro estiver habilitado.


26/104



3.3.2 Tabela de valores para TipoCampo

A seguir apresentamos os valores possveis para o campo TipoCampo e respectivos significados:

TipoCampo Descrio-1 No existem informaes que podem/devem ser tratadas pela automao0 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 autorizao1 Dados de confirmao da transao. Para ambientes com mltiplos servidores ser

retornado no seguinte formato:

;;2 Informa o cdigo da funo SiTef utilizado na mensagem enviada para o servidor.

10 a 99

e3000 a 3999

Informa qual a opo selecionada no menu de navegao de transaes seguindo a

mesma codificao utilizada para definir as restries no pagamento descritas no itemRestrio 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 Grupo00 Cheque01 Carto de Dbito02 Carto de Crdito03 Carto tipo Voucher05 Carto Fidelidade

98 Dinheiro99 Outro tipo de carto

nn Sub-Grupo00 vista01 Pr-datado02 Parcelado com financiamento pelo estabelecimento03 Parcelado com financiamento pela administradora99 Outro tipo de pagamento

101 Contm o texto real da modalidade de pagamento que pode ser memorizado pelaaplicao caso exista essa necessidade. Descreve por extenso o par xxnn fornecido em100

102 Contm o texto descritivo da modalidade de pagamento que deve ser impresso no cupomfiscal (p/ex: T.E.F., Cheque, etc...)

105 Contm a data e hora da transao no formato AAAAMMDDHHMMSS110 Retorna quando uma transao for cancelada. Contm a modalidade de cancelamento no

formato xxnn, seguindo o mesmo formato xxnn do TipoCampo 100. O sub-grupo nntodavia, contm o valor default 00 por no ser coletado.

111 Contm o texto real da modalidade de cancelamento que pode ser memorizado pelaaplicao caso exista essa necessidade. Descreve por extenso o par xxnn fornecido em110.


27/104



112 Contm o texto descritivo da modalidade de cancelamento que deve ser impresso nocupom fiscal (p/ex: T.E.F., Cheque, etc...).

115 Modalidade Ajuste120 Buffer contm a linha de autenticao do cheque para ser impresso no verso do mesmo

121 Buffer contm a primeira via do comprovante de pagamento (via do cliente) a serimpressa na impressora fiscal. Essa via, quando possvel, reduzida de forma a ocupar

poucas linhas na impressora. Pode ser um comprovante de venda ou administrativo122 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 administrativo123 Indica que os comprovantes que sero entregues na seqncia so de determinado tipo:

COMPROVANTE_COMPRAS = "00"COMPROVANTE_VOUCHER = "01"COMPROVANTE_CHEQUE = "02"COMPROVANTE_PAGAMENTO = "03"COMPROVANTE_GERENCIAL = "04"COMPROVANTE_CB = "05"COMPROVANTE_RECARGA_CELULAR = "06"COMPROVANTE_RECARGA_BONUS = "07"COMPROVANTE_RECARGA_PRESENTE = "08"COMPROVANTE_RECARGA_SP_TRANS = "09"COMPROVANTE_MEDICAMENTOS = "10"

125 Cdigo do Voucher130 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 efetivamenteaprovado para o troco

131 Contm um ndice que indica qual a instituio que ir processar a transao segundo atabela presente no final do documento (at 5 dgitos significativos)132 Contm um ndice que indica qual o tipo do carto quando esse tipo for identificvel,

segundo uma tabela a ser fornecida (5 posies)133 Contm o NSU do SiTef (6 posies)134 Contm o NSU do Host autorizador (15 posies no mximo)135 Contm o Cdigo de Autorizao para as transaes de crdito (15 posies no mximo)136 Contm as 6 primeiras posies do carto (bin)137 Saldo a pagar138 Valor Total Recebido139 Valor da Entrada

140 Data da primeira parcela no formato ddmmaaaa143 Valor gorjeta144 Valor devoluo145 Valor de pagamento146 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 eleconfirme o valor antes de pass-lo devolv-lo para a rotina. Caso ele no possua essevalor, deve l-lo.

147 Valor a ser cancelado150 Contm a Trilha 1, quando disponvel, obtida na funo LeCartaoInterativo

151 Contm a Trilha 2, quando disponvel, obtida na funo LeCartaoInterativo153 Contem a senha do cliente capturada atravs da rotina LeSenhaInterativo e que deve serpassada a lib de segurana da Software Express personalizada para o estabelecimento


28/104



comercial de forma a obter a senha aberta154 Contm o novo valor de pagamento155 Tipo carto Bnus156 Nome da instituio

157 Cdigo de Estabelecimento158 Cdigo da Rede AutorizadoraServio H160 Nmero do cupom original161 Nmero Identificador do Cupom do Pagamento170 Venda Parcelada Estabelecimento Habilitada171 Nmero Mnimo de ParcelasParcelada Estabelecimento172 Nmero Mximo de ParcelasParcelada Estabelecimento173 Valor Mnimo Por ParcelaParcelada Estabelecimento174 Venda Parcelada Administradora Habilitada175 Nmero Mnimo de ParcelasParcelada Administradora

176 Nmero Mximo de ParcelasParcelada Administradora177 Indica que o campo numrico (PBM)178 Indica que o campo alfanumrico (PBM)200 Saldo disponvel*, saldo do produto especfico (escolar, vale transporte)201 Saldo Bloqueado500 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 normalmentecaso seja um supervisor aceitvel

501 Tipo do Documento a ser consultado (0CPF, 1CGC)502 Numero do documento (CPF ou CGC)504 Taxa de Servio

505 Nmero de Parcelas506 Data do Pr-datado no formato ddmmaaaa507 Captura se a primeira parcela a vista ou no (0Primeira a vista, 1caso contrrio)508 Intervalo em dias entre parcelas509 Captura se ms fechado (0) ou no (1)510 Captura se com (0) ou sem

(1) garantia no pr-datado com carto de dbito511 Nmero de Parcelas CDC512 Nmero do Carto de Crdito Digitado513 Data de vencimento do Carto

514 Cdigo de segurana do Carto515 Data da transao a ser cancelada (DDMMAAAA) ou a ser re-impressa516 Nmero do documento a ser cancelado ou a ser re-impresso517 A rotina est sendo chamada para ler o Nmero do cheque segundo o descrito no tipo de

comando correspondente ao valor 31518 Cdigo do Item519 Cdigo do Plano de Pagamento520 NSU do SiTef Original (Cisa)521 Nmero do documento de identidade (RG)522 A rotina est sendo chamada para ler o Nmero do Telefone523 A rotina est sendo chamada para ler o DDD de um telefone com at 4 dgitos524 Valor da primeira parcela525 Valor das demais parcelas526 Quantidade de cheques


29/104



527 Data de vencimento do cheque529 A rotina est sendo chamada para ler a Data de Abertura de Conta no formato

(MMAAAA)530 Autorizao do supervisor digitada

531 Autorizao do supervisor especial532 A rotina est sendo chamada para ler a quantidade de parcelas ou cheques533 Dados adicionais da venda534 Emitente do cheque535 O documento pago pela transao536 Registros de retorno da consulta cheque CDL-Poa537 Cdigo de rea da cidade do cheque550 Endereo551 Nmero do endereo552 Andar do endereo

553 Conjunto do endereo554 Bloco do endereo555 CEP do endereo556 Bairro do endereo557 CPF para consulta AVS558 Resultado da consulta AVS559 Nmero de dias do pr-datado560 Nmero de Ciclos561 Cdigo da Ocorrncia562 Cdigo de Loja (EMS)563 Cdigo do PDV (EMS)

564 Dados Retornados (EMS)565 Ramal do Telefone566 rgo Expedidor do RG567 Estado onde foi emitido o RG568 Data de expedio do RG569 Matrcula do Operador570 Nome do Operador571 Matrcula do Conferente572 Nome do Conferente573 Percentual de Juros Aplicado

574 Matrcula do Autorizador575 Data do Cupom Fiscal da Transao Original576 Hora do Cupom Fiscal da Transao Original577 Dados do Carn ou cdigo resumido EMS578 Cdigo de milhas diferenciadas 1579 Valor das milhas diferenciadas 1580 Cdigo de milhas diferenciadas 2581 Valor das milhas diferenciadas 2582 Tipo de cdigo externo EMS583 Cdigo externo EMS587 Cdigo nome da instituio autorizadora de celular588 Cdigo estabelecimento autorizador de celular589 Cdigo da Operadora de Celular


30/104



590 Nome da Operadora de Celular selecionada para a operao591 Valor selecionado para a recarga592 DDD + Nmero do celular a ser recarregado593 Digito(s) verificadores

594 Cep da localidade onde est o terminal no qual a operao est sendo feita595 Nsu do SiTef correspondente a transao de pagamento da Recarga com carto596 Nsu do Host Autorizador correspondente a transao de pagamento da Recarga com

carto597 Cdigo da Filial que atendeu a solicitao de recarga do celular598 Mensagem da Operadora de Celular599 Cdigo da rede autorizadora da recarga de celular600 Data de vencimento do ttulo/convnio no formato DDMMAAAA601 Valor Pago*602 Valor Original

603 Valor Acrscimo604 Valor do Abatimento605 Data Contbil do Pagamento606 Nome do Cedente do Titulo. Deve ser impresso no cheque quando o pagamento for feito

via essa modalidade607 ndice do documento, no caso do pagamento em lote, dos campos 600 a 604 que viro em

seguida608 Modalidade de pagamento utilizada na funo de correspondente bancrio. Segue a

mesma regra de formatao que o campo de nmero 100609 Valor total dos ttulos efetivamente pagos no caso de pagamento em lote610 Valor total dos ttulos no pagos no caso de pagamento em lote

611 NSU Correspondente Bancrio612 Tipo do documento: 0Arrecadao, 1Titulo (Ficha de compensao), 2Tributo613 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 doCheque (6), nesta ordem. Notar que a ordem a mesma presente na linha superior docheque sem os dgitos verificadores

614 NSU SiTef transao de pagamento620 NSU SiTef da transao original (transao de cancelamento)621 NSU Correspondente Bancrio da transao original (transao de cancelamento)622 Valor do Benefcio

623 Cdigo impresso no rodap do comprovante do CB e utilizado para re-impresso/cancelamento624 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:numero625 Recibo de retirada626 Nmero do banco627 Agncia628 Dgito da agncia629 Conta630 Dgito da conta631 Valor em dinheiro

632 Valor em cheque633 Nome do depositante634 Documento original de Correspondente Bancrio


31/104



635 Chave do usurio utilizada para comunicao com o Banco636 Seqencial nico da chave do usurio no Banco637 Cdigo da Agncia de relacionamento da loja do correspondente638 Nmero do Cheque CB

639 Nmero da Fatura640 Nmero do Convnio641 Data Inicial do Extrato (DDMMAAAA)642 Data Final do Extrato (DDMMAAAA)643 Perodo de Apurao644 Cdigo da Receita Federal645 Valor da Receita Bruta646 Percentual Aplicado647 Valor Principal648 Valor Multa

649 Valor Juros650 (interno) Abertura de pinpad remoto651 (interno) Fechamento de pinpad remoto652 (interno) Comando de aborta do pinpad remoto653 (interno) Escrita de pinpad remoto654 (interno) Leitura de pinpad remoto670 Dado do PinPad700 Operadora de ValeGs701 Produto ValeGs702 Nmero do ValeGs703 Nmero de Referncia

704 Cdigo GPS705 Competncia GPS706 Identificador Contribuinte707 Valor INSS708 Valor Outras Entidades709 Permite Pagamento de Contas Com Dinheiro (0No Permite; 1Permite)710 Permite Pagamento de Contas Com Cheque (0No Permite; 1Permite)711 Permite Pagamento de Contas Com TEF Dbito (0No Permite; 1Permite)712 Permite Pagamento de Contas Com TEF Crdito (0No Permite; 1Permite)713 Formas de Pagamento utilizadas na transao de Pagamento genrico

714 Valor do Saque715 Numero do Pedido716 Valor Limite do Depsito CB717 Valor Limite do Saque CB718 Valor Limite do Saque para Pagamento CB719 Valor do produto ValeGs722 Valor mnimo de pagamento723 Identificao do Cliente, apenas para recebimento Carrefour724 Venda Crdito Parcelada com Plano Habilitada725 Venda Crdito com Autorizao a Vista Habilitada726 Venda Crdito com Autorizao Parcela com Plano Habilitada727 Venda Boleto Habilitada729 Valor mximo de pagamento


32/104



730 Nmero Mximo de Formas de Pagamento, 0 para sem limite731 Tipo de Pagamento Habilitado, repete n vezes, onde n o nmero de formas de

pagamento habilitadas:

00 Dinheiro01 Cheque02 TEF Dbito03 TEF Crdito04 Carto Presente (Pr-Pago) Carrefour05 Carto Bnus Carrefour06 Carto Carrefour07 Saque para pagamento08 Saque09 DCC Carrefour50 TEF Carto

77 Campo Reservado732 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 orespectivo Tipo de Pagamento:

00 Campo Reservado01 Tipo de Entrada do Cheque02 Dados do Cheque03 Rede Destino04 NSU do SiTef da transao de TEF05 Data do SiTef da transao de TEF (no utilizado, uso futuro)06 Cdigo da Empresa (Loja) da transao de TEF07 NSU do Host da transao de TEF08 Data do Host da transao de TEF (Campo 105 CliSiTef)09 Cdigo de Origem (Estabelecimento) da transao de TEF10 Servio Z da transao de TEF11 Cdigo de Autorizao da transao de TEF12 Valor do Cheque

734 Limite minimo de venda para promoes flexveis, com 12 dgitos sendo os 2 ltimosdgitos referentes as casas decimais

736 Saldo devedor atual, apenas para recebimento Carrefour

737 Motivo (Carrefour)738 Valor sugerido para o produto selecionado.739 Cliente Preferencial750 Valor Pague Fcil CB751 Valor Tarifa Pague Fcil CB900 Cdigo Material AURA901 Cdigo Plano AURA902 Nome creditado no Cheque AURA903 Nmero Dossi AURA910 Tipo de Venda Conductor/Renner : 1 = Venda via Fatura

2 = Venda via Boleto911 Define se aps a consulta de fatura, deve encadear o pagamento de fatura (Conductor -

Renner)1002 Data de Validade do Carto (NPTC)


33/104



1003 Nome do Portador do Carto (NPTC)1010 Quantidade de medicamentos - PBM1011 ndice do medicamentoPBM1012 Cdigo do medicamentoPBM

1013 Quantidade autorizadaPBM1014 Preo mximo ao consumidorPBM1015 Preo recomendado ao consumidorPBM1016 Preo de venda na farmciaPBM1017 Valor de reembolso na farmciaPBM1018 Valor reposio na farmciaPBM1019 Valor subsdio do convnioPBM1020 CNPJ convnioPBM1021 Cdigo do plano do descontoPBM1022 Possui receita mdicaPBM

1023 CRMPBM1024 UFPBM1025 Descrio do produto* - PBM1026 Cdigo do produtoPBM1027 Quantidade do produtoPBM1028 Valor do produtoPBM1029 Data da receita mdica - PBM1030 Cdigo de autorizao PBM1031 Quantidade estornadaPBM1032 Cdigo de estorno PBM1033 Preo recomendado consumidor a vistaPBM

1034 Preo recomendado consumido para desconto em folhaPBM1035 Percentual de reposio da farmciaPBM1036 Comisso de reposioPBM1037 Tipo de AutorizaoPBM1038 Cdigo do conveniadoPBM1039 Nome do conveniadoPBM1040 Tipo de Medicamento PBM (01Medicamento, 02-Manipulao, 03-Manipulao

Especial, 04-Perfumaria)1041 Descrio do MedicamentoPBM1042 Condio p/venda: Se 0 obrigatrio utilizar preo Funcional Card (PF)

Se 1 pode vender por preo inferior ao preo PF1043 Preo funcional card1044 Preo praticadoPBM1045 Status do medicamentoPBM1046 Quantidade receitadaPBM1047 RefernciaPBM1048 Indicador da venda PBM (0-Produto venda carto 1-Produto venda a vista)1049 Grupo de Produto (EDMCard: 0Medicamento; 1Perfumaria.)1050 Nome - ACSP1051 Data de nascimento1052 Nome da me1053 Nmero do ttulo de eleitorACSP1054 Endereo do telefone consultadoACSP1055 CEP do telefone consultadoACSP


34/104



1056 Cidade do telefone consultadoACSP1057 UF do telefone consultadoACSP1058 Dados adicionaisACSP1100 Registro analtico CHECKCHECK

1101 Registro analtico ACSP1102 Registro analtico SERASA1103 Imagem tela analtica ACSP1104 Imagem tela analtica SERASA1105 Motivo do cancelamentoACSP1106 Tipo de consultaACSP1107 CNPJ Empresa Conveniada1108 Cdigo da administradora1109 Dados tabela Telecheque - ACSP1110 Matrcula do motoristaCarto Combustvel

1111 Placa do veculoCarto Combustvel1112 QuilometragemCarto Combustvel1113 Quantidade de litrosCarto Combustvel1114 Combustvel principalCarto Combustvel1115 Produtos de combustvelCarto Combustvel1116 Cdigo Produto HostCarto Combustvel1117 HormetroCarto Combustvel1118 Linha de CrditoCarto Combustvel1119 Tipo de MercadoriaCarto Combustvel1120 RamoCarto Combustvel1121 Casas decimais de preos unitriosCarto Combustvel

1122 Quantidade mxima de produtos venda1123 Tamanho do cdigo do ProdutoCarto Combustvel1124 Cdigo do veculoCarto Combustvel1125 Nome da EmpresaCarto Combustvel1126 Casas decimais da quantidadeCarto Combustvel1127 Retorna quando um carto NPTC exigir coleta de dados no-esperados pela automao.1128 Lista de PerguntasCarto Combustvel1129 Permite Coleta de ProdutoCarto Combustvel1131 Cdigo do Limite1132 Quantidade de Titulares

1133 Data de Abertura da Empresa (DDMMAAAA)1134 Nome do Titular1135 Complemento do Endereo1136 Cidade1137 Estado1152 Menu de Valores - SPTrans1160 Produto com Valor de Face - Gift1190 Embosso (4 ltimos dgitos) do Carto1191 PAN do carto AESGol Offline1192 Portador do carto AESGol Offline1193 Data de validade do carto AESGol Offline1200 Total de consultas anteriores1201 Valor acumulado das consultas anteriores, contendo 2 dgitos decimais porm sem o


35/104



caractere decimal.1202 Total de consultas efetuadas no dia.1203 Valor acumulado das consultas no dia, contendo 2 dgitos decimais porm sem o

caractere decimal.

1204 Total de consultas de cheques pr-datados realizados no perodo.1205 Valor acumulado de cheques pr-datados, contendo 2 dgitos decimais porm sem o

caractere decimal.1206 Vendedor (Usurio) - PBM1207 SenhaPBM1208 Cdigo de RetornoPBM1209 OrigemPBM1321 NSU do Host Autorizador da Transao Cancelada2000 Campo administrativo2001 Campo livre

2002 Resultado da leitora SmartNet2003 Dados obtidos da leitora aps uma operao de dbito do carto SmartVR ou Sodexho2004 Campo de mensagem do servio D, para mensagens 0x04002005 Dados a serem enviados PARA a leitora SmartNet.2006 Tipo de criptografia2007 ndice MasterKey2008 Chave de criptografia2009 Senha do carto2010 Cdigo de resposta do autorizador2011 Bin da rede2012 Nmero serial do CHIP

2013 Registro de controle do CHIP2014 Saldo comum, saldo do passe comum2015 PAN do carto presente2017 Data primeiro vencimento2018 Valor total2019 Valor financiado2020 Percentual multa2047 Juros de mora2048 TAC (Taxa de administrao)2053 Menu (produto) selecionado Visanet

2054 Tipo Crdito CDC (1CDC Produto; 2CDC Servio)2055 Data/Hora Sitef (Local)2056 Dia da semana Sitef (Local)2057 Data/Hora Sitef (GMT)2058 Dia da Semana Sitef (GMT)2059 Dados da Forma de Pagamento - SPTrans2064 Valor pagamento em dinheiro2065 Cdigo consulta cheque (Genrica EMS)2066 Nome da filial2067 Mensagem do autorizador a ser exibida junto com o menu de valores (Se o terminal

permitir)2068 Valor selecionado atravs de menu2078 Cdigo do servio2079 Valor do servio


36/104



2081 Menu de Produtos2082 Nosso nmero2083 Valor total do produto contendo o separador decimal (,) e duas casas decimais aps a

vrgula.

2086 Cdigo do Produto - ValeGas2087 Demonstrativo de prazos : 0: No; 1: Sim2088 Cancelamento Total/Parcial : 0: Parcial; 1: Total2089 Nmero de identificao da fatura.2090 Tipo do carto Lido2091 Status da ltima leitura do carto2093 Cdigo do atendente2101 RUT - Campo usado pelo Ticket Car (Chile)2102 Comuna - Campo usado pelo Ticket Car (Chile)2103 Indica se foi transao offline : 1 : Sim

2104 Tipo do carto Combustvel : 1 (Crdito, Ps-pago), 2 (Dbito, Pr-pago)2107 Cdigo Atividade Giro - Campo usado pelo Ticket Car (Chile)2108 Nome Atividade Giro - Campo usado pelo Ticket Car (Chile)2109 Senha temporria2120 Cdigo Produto Hopi-Hari2121 Descrio Produto Hopi-Hari2122 Quantidade Mxima de produtos Hopi-Hari2123 Produtos Hopi-Hari2124 Valor da tarifa da Recarga de Celular2125 Nmero da parcela (2 caracteres) (Hotcard)2126 Seqencial da transao (6 caracteres) (Hotcard)

2301 Rodap do comprovante da via estabelecimento2320 Cdigo do DepositanteCB2321 Cdigo do Cliente - CB2322 Sequencia CartoCB2323 Via Carto - CB2324 Tipo do ExtratoCB2325 Valor limite de Transferncia - CB2326 Valor limite para coleta de CPF/CNPJCB2327 CPF/CNPJ do ProprietrioCB2328 CPF/CNPJ do PortadorCB

2329 Tipo do documento do Proprietrio - CB2330 Tipo do documento do Portador - CB2331 Indica se permite pagamento com carto CB2332 Valor da Transferncia2333 Identificao da transao2334 Pin Code2340 Data de Entrada do VeculoEstapar2341 Data de Sada do VeculoEstapar2342 Hora de Entrada do VeculoEstapar2343 Hora de Sada do VeculoEstapar2344 Tipo de Cliente (1: Rotativo; 2: Mensalista)Estapar2345 Nmero da SucursalEstapar2346 Nmero da ApliceEstapar


37/104



2347 Nmero do Item - Estapar2348 Chassi do VeculoEstapar2349 Nmero da SUSEP - Estapar2350 Nmero do Dispositivo - Estapar

2351 Vigncia FinalEstapar2352 Flag Interna- Estapar2355 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 usopela automao).Assume os seguintes valores:

Contedo (em Buffer) DescrioA Alfabtico

AN Alfanumrico (ans)LN Letras no acentuadas e nmerosN NumricoVx Valor comxcasas decimaisS Sim/NoM MenuMc Menu com confirmao

2361 Indica que foi efetuada uma transao de dbito para pagamento de carn2362 Retornado logo aps a transao de consulta de bins. O valor 1 indica que o autorizador

capaz de tratar de forma diferenciada transao de dbito convencional de dbito para

pagamento de contas.2369 Pontos a resgatar (numrico sem casa decimal).2421 Informa se est habilitada a funo de coleta de dados adicionais do cliente (0 ou 1)2467 Data no Formato DDMMAA Confirmao Positiva2468 Data no Formato DDMM Confirmao Positiva2469 Data no Formato MMAA Confirmao Positiva4000 Status da Pr-AutorizaoPBM4001 CRFPBM4002 UF do CRFPBM4003 Tipo de vendaPBM

4004 Valor total PBM4005 Valor a vista PBM4006 Valor carto PBM4007 Nosso nmero PBM4008 Percentual de desconto concedido pela administradora (2 casas decimais)4016 Preo brutoPBM4017 Preo lquidoPBM4018 Valor a receber da Loja, em centavosPBM4019 Nmero do lote gerado pela CentralPBM4020 Valor total a receber da lojaPBM4021 Valor total a receber da lojaPBM

4022 Soma dos valores da OperaoPBM4023 Nome da operadoraPBM4024 Nome da empresa conveniadaPBM


38/104



4025 Quantidade de dependentesPBM4026 Cdigo do dependentePBM4027 Nome do dependentePBM4028 Valor a receber do conveniadoPBM

4029 Valor do desconto total, em centavos4030 Valor liquido total, em centavos - PBM4031 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 - Bnus4039 Cdigo Resposta PBM (0 = Ok, 0 = erro)4040 Produto Fracionado PBM (0 = no, 1 = sim)4041 Paciente ID PBM (-1 = outros, 00 = titular, 01 = dependente)

4043 Receita ID PBM (receita cadastrada pela empresa)4044 Receita item ID PBM (item da receita cadastrada pela empresa)4045 Receita uso contnuo (0 = no, 1 = sim)4046 Produto Manipulado PBM (princpios ativos)4047 Produto Manipulado PBM Valor Original

Campos reservados para uso da IntPos.dll8000 a 9999 Campos reservados

* Campos utilizados em um ou mais produtos.

Note que nem todos os campos so retornados em todas as transaes. Alm disso, existem camposque somente so retornados se a transao foi aprovada.

O aplicativo de automao deve ignorar aqueles campos que no desejar/no souber tratar uma vezque, em verses futuras da CliSiTef, novos campos podero ser disponibilizados. Notar que a formacorreta de ignorar estes campos executar a funo definida em ProximoComando ou simplesmenteignorar o dado retornado para a aplicao quandoProximoComandofor 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 dequalquer comprovante deve ser feita no momento que eles forem disponibilizados para a automao e ainformao de se eles foram impressos corretamente ou no passada pela funoContinuaFuncaoSiTefInterativoatravs do valor 0 ou -1, respectivamente, colocado em Continua.


39/104



3.3.3 Tabela de Eventos, retornados tambm em TipoCampo

Durante a transao, a CliSiTef pode informar a ocorrncia de determinados eventos.

Estes eventos so retornados no parmetro TipoCampo da rotina ContinuaFuncaoSiTefInterativoou ContinuaFuncaoSiTefInterativoA, conforme a tabela abaixo.

TipoCampo DescrioEventos de coleta

5000 Indica que a biblioteca est aguardando a leitura de um carto5001 Indica que a biblioteca est esperando a digitao da senha pelo usurio5002 Indica que a biblioteca est esperando a digitao dos dados de confirmao positiva pelo

usurio5003 Indica que a biblioteca est aguardando a leitura do bilhete nico

5004 Indica que a biblioteca est aguardando a remoo do bilhete nico5005 Indica que a transao foi finalizada5006 Confirma Dados Favorecido5007 SiTef Conectado5008 SiTef Conectando5009 Consulta OK5010 Colher Assinatura5011 Coleta Novo Produto5012 Confirma Operao5013 Confirma Cancelamento5014 Confirma Valor Total5015 Concluso de Recarga de Bilhete nico5016 Reservado5017 Aguardando leitura de carto5018 Aguardando digitao da senha no PinPad5019 Aguardando processamento do chip5020 Aguardando remoo do carto5021 Aguardando confirmao da operao

5027 Cancelamento da leitura do carto5028 Cancelamento da digitao da senha no PinPad

5029 Cancelamento do processamento do carto com CHIP5030 Cancelamento da remoo do carto5031 Cancelamento da confirmao da operao

5036 Antes da leitura do carto magntico5037 Antes da leitura do carto com CHIP5038 Antes da remoo do carto com CHIP5039 Antes da coleta da senha no pinpad5040 Antes de abrir a comunicao com o PinPad5041 Antes de fechar a comunicao com o PinPad

5042 Deve bloquear recursos para o PinPad5043 Deve liberar recursos para o PinPad5044 Depois de abrir a comunicao com o PinPad


40/104



5050 Atualizao de tabelas.O contedo deste campo varia de acordo com a transao sendo realizada.

Outros eventos

5501 Incio de uma transao do tipo Correspondente Bancrio.


41/104



3.4 Confirmao ou no do Pagamento

Rotina chamada pelo aplicativo para fechar o ciclo transacional. Ela deve ser acionada no momento

que o comprovante Fiscal for fechado e recebe como parmetros um indicador de se a transao foiconcretizada ou se deve ser estornada. Recebe tambm os campos que permitem identificar a transaoque est sendo finalizada.

Esta funo tambm deve ser utilizada para desfazer uma transao interrompida por uma queda deenergia ou qualquer outro problema no aplicativo.

Essa rotina confirma ou cancela TODOS os meios de pagamento vinculados ao mesmo Nmero doCupom Fiscal e mesma Data Fiscal passados como parmetro.

void FinalizaTransacaoSiTefInterativo (Confirma, CupomFiscal, DataFiscal,HoraFiscal);

Interface ASCII

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


InterfaceASCII

Descrio



Confirma Entrada,

por valor

short Fixo 1 Indica se a transao deve ser confirmada (1) ou

estornada (0)CupomFiscal Entrada,

por valorchar * Mx. 20 Nmero do Cupom Fiscal correspondente venda

DataFiscal Entrada,por valor

char * Fixo 8 Data Fiscal no formato AAAAMMDD

HoraFiscal Entrada,por valor

char * Fixo 6 Horrio Fiscal no formato HHMMSS

Exemplo: Uma venda realizada pela funo IniciaFuncaoSiTefInterativo, passando comoparmetros Funcao 0, Valor 10,00, Cupom Fiscal 12345, Data Fiscal 20150101, Hora Fiscal

121500. Na confirmao da transao, a funo FinalizaTransacaoSiTefInterativo deve serchamada utilizando os seguintes parmetros: Confirma 1, Cupom Fiscal 12345, Data Fiscal20150101, Hora Fiscal 121500.


42/104



3.5 Teste da presena de PinPad

Essa funo, disponibilizada apenas para aplicaes de automao que a necessitem, permiteverificar se existe um PinPad conectado na porta serial destinada a ele e se ele est operacional. A formade 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:

1Existe um PinPad operacional conectado ao micro;

0No existe um PinPad conectado ao micro;

-1biblioteca de acesso ao PinPad no encontrada;outro nmeroerros 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 otempo que ele no est em uso. O formato de ativao da rotina o seguinte:

long EscreveMensagemPermanentePinPad (Mensagem)

Interface ASCII

EscreveMensagemPermanentePinPadA (Resultado, Mensagem)


IntefaceASCII

Descrio



Mensagem Entrada,por valor

char * Varivel Mensagem a ser apresentada no visor do PinPad.Recomenda-se que ela possua no mximo 32caracteres de forma a ser compatvel com osPinPads existente atualmente em campo

Para apagar a mensagem e deixar o visor em branco s chamar essa funo passando o campoMensagem vazio.

responsabilidade da aplicao, se desejado, incluir o caractere | (Barra em p) para indicar umamudana de linha.


43/104



3.7 Leitura da trilha 3 do carto

Esta funo permite que o aplicativo capture uma trilha 3 magntica genrica.

Note que o PinPad deve ter suporte para a leitura da trilha 3.No deve ser utilizada para tratamento das transaes de pagamento mas apenas para leitura de

cartes internos do estabelecimento comercial (p/ex. carto de supervisor). O formato de ativao oseguinte:

long LeTrilha3 (Mensagem)


InterfaceASCII

Descrio




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 astrilhas atravs da chamada a funo de continuao do processo interativo.

IMPORTANTE: Esta funo NO pode ser utilizada durante a execuo do laoContinuaFuncaoSiTefInterativo.


44/104



3.8 Leitura do carto - rotinas de captura segura

Os rotinas seguintes tm seu funcionamento condicionado a configurao do arquivo com extenso.cha no SiTef, caso a configurao no esteja feita, essas funes retornam o erro

MODO_SEGURO_NAO_ATIVO (12).

IMPORTANTE: Essas funes NO podem ser utilizadas durante a execuo do laoContinuaFuncaoSiTefInterativo. Para esse tipo de situao existem as verses que fazem o acesso direto aleitora de carto descritas a seguir.

long LeCartaoSeguro (Mensagem)

Interface ASCII

LeCartaoSeguroA (Resultado, Mensagem)


InterfaceASCII

Descrio





No retorno a rotina devolve os mesmos valores que a rotina de pagamento. O aplicativo obtm as

trilhas atravs da chamada a funo de continuao do processo interativo.Os campos retornados no processo interativo so os referentes aos campos sensveis (2021 a 2046).

int LeCartaoDiretoSeguro (Mensagem, TipoCampoTrilha1, Trilha1,TipoCampoTrilha2, Trilha2, Timeout, TestaCancelamento)

Interface ASCII

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


InterfaceASCII

Descrio





TipoCampoTrilha1

Sada,por valor

char * Fixo 12 Indica o tipo de campo que foi retornado na trilha 1,se ele mascarado, criptografado ou em Hash.

Trilha1 Sada,

por valor

char * Mx. 128 No retorno contm, caso exista, a Trilha 1 lida

TipoCampoTrilha2

Sada,por valor

char * Fixo 12 Indica o tipo de campo que foi retornado na trilha 2,se ele mascarado, criptografado ou em Hash.


45/104



Trilha2 Sada,por valor

char * Mx. 64 No retorno contm, caso exista, a Trilha 2 lida

Timeout Entrada,por valor

short Fixo 6 Define o tempo mximo de espera pela passagem docarto em segundos. Se zero, espera at que o carto

seja passadoTestaCancelamento

Entrada,por valor

Rotina NoUsado

Rotina da aplicao de automao que retorna 0 se para continuar aguardando pelo carto e 1 caso devainterromper o processo de aguardar a passagem docarto

No retorno a rotina devolve o valor 0 (zero) caso tenha sido executada corretamente e um valordiferente de zero em caso de erro ou interrupo.

Para esta rotina especfica, os cdigos de erro retornados so:

Valor Descrio0 No ocorreu erro1 Campo de sada insuficiente2 BIN no aceito3 CNPJ invlido4 Chave de acesso vencida5 Verso invlida6 Chave de criptografia invlida7 Dados no criptografados com a chave fornecida como parmetro: a decriptografia resultou em

um nmero de carto que no composto s por dgitos.8 Dado de entrada invlido

Os campos TipoCampoTrilha1 e TipoCampoTrilha2 indicam o tipo de campo retornado,respeitando o valor estabelecido para os campos sensveis, com 202x para campos abertos mascarados,203x para o Hash dos campos, 204x para campos criptografados e 205x.

TipoCampo Descrio202x Campos abertos, mascarados.203x Hash dinmico dos campos204x Campos criptografados

205x Hash fixo dos campos *

x Campo1 PAN do carto2 Vencimento do carto3 Nome do Cliente4 Trilha 15 Trilha 2

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


46/104



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

IMPORTANTE: Essas funes NO podem ser utilizadas durante a execuo do laoContinuaFuncaoSiTefInterativo. Para esse tipo de situao existem as verses que fazem o acesso direto aleitora de carto descritas a seguir.

int LeCartaoDiretoSeguroEx (Mensagem, DadosOut, TamDadosOut, Timeout,TestaCancelamento)

Interface ASCII

LeCartaoDiretoSeguroExA (Resultado, Mensagem, DadosOut, TamDadosOut,

Timeout)


InterfaceASCII

Descrio


No usado Fixo 6 Contm o resultado de resposta chamada da rotina.


char * Varivel Mensagem a ser apresentada no visor do PinPad.

DadosOut Sada,por valor

char * Varivel Retorna os mesmos dados da rotinaLeCartaoDiretoSeguro, concatenados no formatoTLV, onde T corresponde ao tipo do campo(tamanho 5), L o tamanho do campo (tamanho 3) eV o campo (tamanho do campo).

TamDadosOut Entrada,por valor

Int Fixo 6 Tamanho do buffer de DadosOut.

Timeout Entrada,por valor

short Fixo 6 Define o tempo mximo de espera pela passagem docarto em segundos. Se zero, espera at que o cartoseja passado.

TestaCancela

mento

Entrada,

por valor

Rotina No

Usado

Rotina da aplicao de automao que retorna 0 se

para continuar aguardando pelo carto e 1 caso devainterromper o processo de aguardar a passagem docarto.


47/104



int LeTrilhaChipInterativo (Modalidade)

Interface ASCIILeTrilhaChipInterativoA (Resultado, Modalidade)LeTrilhaChipInterativoEx (Modalidade, ParamAdic)


InterfaceASCII

Descrio


No usado Fixo 6 Contm o resultado de resposta chamada darotina

Modalidade Entrada,por valor

Int Fixo Seleciona o tipo do pagamento:2 : Dbito

3 : CrditoParamAdic Entrada,por valor

char * VarivelMx. 64

Parmetros adicionais, como o{SementeHash=XXX..}. opcional e pode servazio

Essas funes funcionam da mesma maneira das LeCartaoSeguro/LeCartaoSeguroA, com adiferena que estas aceitam cartes com chip.

3.9 Leitura de senha

Esta funo permite que o aplicativo capture no PinPad uma senha de um cliente de carto do

prprio estabelecimento comercial (carto proprietrio). No deve, em nenhuma hiptese, ser utilizadapara captura de senhas dos cartes tradicionais. Para maiores detalhes, consulte o documento Acesso aSenha do Cliente para Carto Proprietrio CliSiTef.doc.

long LeSenhaInterativo (ChaveSeguranca)

Interface ASCII

L

sitef - interface simplificada com a aplicação(vrs-157)

Documents