SiTef - Interface Simplificada com a aplicação(VRS-120)

Especificação Técnica – Interface com os meios de pagamento do SiTef Bibliotecas CliSiTefI e CliSiTefVersão 120 Este documento possui tecnologia e conhecimento de propriedade da Software Express Informática Não pode ser reproduzido ou utilizado para outros fins que não a interface com algum de nossos produtos. Especificação Técnica – Interface com os meios de pagamento do SiTef Bibliotecas CliSiTefI e CliSiTef Versão: 120 Data: 29/04/2013 Índice 1. Objetivos 1.1 Descrição Resumida 1.2 Fluxo Gráfico Descrição das interfaces com as rotinas disponíveis na CliSiTef 2.1 Interface padrão 2.2 Interface ASCII API - Rotinas disponíveis na CliSiTef 3.1 Configuração da biblioteca 3.1.1 Configurações especiais gerais 3.2 Início da transação de Pagamento ou Gerencial 3.2.1 Tabela de códigos de retorno 3.2.2 Tabela de códigos de funções 3.3 Continuação do processo de coleta interativo 3.3.1 Tabela de códigos de Comando 3.3.2 Tabela de valores para TipoCampo 3.3.3 Tabela de Eventos, retornados também em TipoCampo 3.4 Confirmação ou não do Pagamento 3.5 Teste da presença de PinPad 3.6 Define mensagem permanente para o PinPad 3.7 Leitura da trilha 3 do cartão 3.8 Leitura do cartão - rotinas de captura segura 3.9 Leitura de senha 3.10 Leitura de Confirmação pelo Cliente no PinPad 3.11 Correspondente Bancário (Pagamento de Contas) 3.12 Verificação da integridade de um código em barras 3.13 Verificação da quantidade de transações pendentes de confirmação no terminal 3.14 Obtendo Versão 3.15 Descarregando Mensagens 3.16 Informações do PinPad Arquivo de configurações CliSiTef.ini ou CLSIT 4.1 Configuração do PinPad 4.1.1 Configuração da porta 4.1.2 Definição da mensagem padrão 4.2 Configuração de conexão com o servidor SiTef 4.2.1 Configuração de endereços IP adicionais 4.2.2 Configuração da porta do servidor SiTef 4.2.3 Obrigatoriedade de conexão 4.2.4 Configuração do mostrador de comunicação Restrição ou habilitação das formas de pagamento 5.1 Restrição durante o processo de finalização de uma venda 5.2 Restrição de forma definitiva 5.3 Habilitação de transações adicionais 5.4 Desabilitando transações 5.5 Habilitação de transações de redes específicas 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. Especificação Técnica – Interface com os meios de pagamento do SiTef Bibliotecas CliSiTefI e CliSiTef 5.6 5.7 6. 7. Tabela de códigos de meios de pagamento, configurações e menus Habilitação de configurações especiais por transação Versão: 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 Configuração do período que o trace é mantido 7.2 Configuração de diretório 7.3 Arquivos de trace por terminal Processo de desenvolvimento/homologação 8.1 Arquivo de trace adicional durante a fase de desenvolvimento 8.2 Processo de homologação Habilitando confirmação do valor no pinpad Tradução de mensagens Tabelas Rotinas descontinuadas 8. 9. 10. 11. 12. Software Express Ltda., 2013 iii Especificação Técnica – Interface com os meios de pagamento do SiTef Bibliotecas CliSiTefI e CliSiTef Versão: 120 Data: 29/04/2013 Bibliotecas CliSiTefI e CliSiTef 1. Objetivos Da biblioteca Propiciar um meio rápido e simples de disponibilizar as funcionalidades do SiTef para aplicativos em geral. Principais características: Não intrusiva pois é a própria automação que gerencia suas telas. Não ocorre sobreposição de telas da própria interface que, se existisse, na maioria das vezes não seria compatível com a diagramação visual da aplicação principal do cliente; Permite que a aplicação de automação restrinja as transações disponíveis para determinado pagamento uma vez que, na vida prática, ocorre a negociação com o cliente e uma vez fechado o meio de pagamento, quantidade de parcelas, etc, não devem ser modificados por engano na hora da execução do TEF; Permite total liberdade na inclusão de novos produtos e meios de pagamento, acompanhando a evolução do SiTef, sem que seja necessário fazer nenhuma alteração na automação ou, se ela for imprescindível (por exemplo pela inclusão de novos periféricos de acesso tais como leitor de códigos em barra), que ela seja mínima. Do documento Apresentar a descrição da biblioteca que efetua a interface com os serviços de meio de pagamento disponíveis no SiTef. A biblioteca é implementada através 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 automação comercial a configura, solicita um pagamento, solicita uma função gerencial ou o pagamento de uma conta. Os pontos de entrada estão na CliSiTefI e é essa que deve ser carregada pela aplicação do usuário. A CliSiTef32 é de uso exclusivo da CliSiTefI e não pode ser carregada ou chamada diretamente sob risco de, se isso for feito, desestabilizar o ambiente. Neste documento, qualquer referência a CliSiTef deve ser entendida como o conjunto das duas dll’s ou lib’s. A CliSiTef possui, para cada funcionalidade, dois pontos de entrada (rotinas). A escolha de qual das interfaces será utilizada pela aplicação depende do gosto pessoal do programador e de se o ambiente utilizado por ele para o desenvolvimento impõe algum tipo de restrição na chamada a CliSiTef. Em particular, estamos nos referindo ao tipo de dado manipulado pelo ambiente de programação. Se ele aceitar somente dados em ASCII, necessariamente deve ser utilizada a interface batizada a seguir nesse documento como “A”. Software Express Ltda., 2013 1 O próximo passo é. Por exemplo. ou diferente de 0 e de 10000 indicando que ocorreu alguma interrupção anormal. a automação deve ficar repetindo a chamada a essa função tantas vezes quanto for necessário até que o valor de retorno da função seja 0. 2013 2 . confirmando ou não a transação dependendo. se retornou -2. não é necessário chamá-la a cada nova transação. Se foi 0 o processo ocorreu de forma correta. Se o retorno foi diferente de 10000 e de 0 então a automação simplesmente sai do laço e. a rotina devolve um valor dizendo se o comando foi aceito ou não. deve-se chamar a função ContinuaFuncaoSiTefInterativo. passando os parâmetros descritos para ela. a ela devolve o valor 10000 para continuar a transação ou outro valor para encerrar. com os parâmetros também descritos para ela nós próximos tópicos. No retorno. Esta função deve ser chamada somente quando a CliSiTef é carregada ou seja. teríamos o seguinte: Software Express Ltda. como Endereço IP do SiTef. indicando que ocorreu tudo bem.1 Descrição Resumida Versão: 120 Data: 29/04/2013 Passo inicial Inicialmente a Automação Comercial deve executar o comando ConfiguraIntSiTefInterativo. por opção do programador. a FinalizaFuncaoSiTefInterativo. que segue o seguinte formato: duas letras + 000 + número do Terminal de Vendas. significa que a transação foi cancelada pelo operador. Exemplificando graficamente o fluxo descrito neste tópico. respectivamente. a automação encerra o laço e se houve impressão de cupom TEF a automação deve imprimi-los e chamar uma outra função.. passando as informações necessárias para que o Terminal de Vendas possa se comunicar com o SiTef. chamar a função IniciaFuncaoSiTefInterativo.Especificação Técnica – Interface com os meios de pagamento do SiTef Bibliotecas CliSiTefI e CliSiTef 1. Transação propriamente dita Feito isto. Confirmação (ou não-confirmação) da transação Se o retorno foi 0. se o cupom foi impresso corretamente ou não. Enquanto a CliSiTef retornar na chamada dessa função o valor 10000. Se o retorno for 10000. então. Estes retornos negativos estão descritos neste documento. pode ou não exibir uma mensagem de acordo com o retorno da função chamada. Código da Empresa (no SiTef Demonstração este código é 00000000) e a identificação do terminal. Especificação Técnica – Interface com os meios de pagamento do SiTef Bibliotecas CliSiTefI e CliSiTef 1. O cupom foi impresso corretamente? Encerra a transação N S Chamar a função FinalizaTransacaoSiTefInterativo Com parâmetro Confirma = 0 Chamar a função FinalizaTransacaoSiTefInterativo Com parâmetro Confirma = 1 Software Express Ltda. 2013 3 .2 Fluxo Gráfico Versão: 120 Data: 29/04/2013 ConfiguraIntSiTefInterativo Retorno igual a 0 (zero)? S IniciaFuncaoSiTefInterativo Retorno igual a 10000? S N Encerra a transação N Encerra a transação ContinuaFuncaoSiTefInterativo Retorno igual a 10000? Se Sim então execute o próximo Comando e chame novamente a função S O retorno foi igual a 0? N S Encerra a transação (laço) Houve devolução de Cupom TEF pela CliSiTef? N S Imprime o cupom.. Descrição das interfaces com as rotinas disponíveis na CliSiTef Versão: 120 Data: 29/04/2013 2. O critério para escolha do delimitador deve ser o de que ele não exista como caractere válido no campo em questão. o campo é delimitado pelo caractere escolhido ou o seu complementar no caso dos pares “( )”. Os campos numéricos são passados sempre com tamanho fixo e alinhados a direita. o delimitador que indica o final de uma linha é o caractere 0x0a (\n em linguagem C)..1 Interface padrão Esta interface pode ser utilizada por aplicações escritas nas mais variáveis linguagens de programação que aceitam campos binários. 2. podendo devolver algum resultado nela. “[ ]”. como estes sempre são conhecidos. o campo cujo conteúdo seja um valor negativo. existe um caractere especial que é utilizado nos textos direcionados para uma impressora. “{ }” e “< >”. Em particular. Variáveis que ocupam 4 bytes em memória. respectivamente. Dentre elas citamos: Delphi. |1234|. com e sem sinal. {1234}. . Finalizando.Especificação Técnica – Interface com os meios de pagamento do SiTef Bibliotecas CliSiTefI e CliSiTef 2. Nela todos os parâmetros são passados em ASCII e podem ser de tamanho fixo e variável.234. como qualquer caractere é valido (por exemplo em um comprovante). Nas passagens de dados da aplicação para a CliSiTef. No caso de comprovantes. os parâmetros são empilhados da direita para a esquerda e a rotina chamada é responsável por removê-los da pilha. <1234>. etc. %1234%. Visual C. Indica que a variável do “tipo variável” está sendo passada como endereço.1. tais como o ambiente Forms da Oracle. Visual Basic. $1234$. a CliSiTef irá utilizar a área da aplicação de automação para trabalhar. Exemplos de construções válidas são: (1234). ou seja.56. a regra acima deve ser utilizada na interpretação do resultado devolvido pela CliSiTef uma vez que esta irá escolher o caractere que melhor se adapta a resposta que esta sendo gerada. possui um sinal “-“ na posição mais a esquerda do número (p/ex: -0001 para um campo de 5 posições cujo conteúdo é o valor –1). 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. [1234]. 2013 4 . Variáveis que ocupam 2 bytes em memória. a aplicação pode definir um caractere padrão e sempre utilizá-lo em todas as passagens de dados.2 Interface ASCII Esta interface pode ser utilizada por aplicações escritas em qualquer linguagem de programação. com zeros a esquerda. unsigned long (ulong) void <tipo variável> * (exemplo: short int * ou long *) Descrição Buffer em texto ASCII terminado por zero binário. com e sem sinal. Indica a ausência de parâmetros ou retorno. etc. Já no retorno. Software Express Ltda. Todas as rotinas chamadas pelo aplicativo de automação devem ser do tipo stdcall. inclusive as que não que aceitam campos binários. ou seja. respectivamente. Exemplos NÃO VÁLIDOS são os seguintes: $12$34$.. A convenção dos parâmetros é a seguinte: Tipo char * short int (short) unsigned short int (ushort) long. Os de tamanho variável são construídos de forma que o primeiro caractere indique qual o valor escolhido para ser o delimitador daquele campo ou seja. 2013 5 .Especificação Técnica – Interface com os meios de pagamento do SiTef Bibliotecas CliSiTefI e CliSiTef Versão: 120 Data: 29/04/2013 Software Express Ltda.. API . e a forma / tipo de passagem dos parâmetros. indica qual o tamanho mínimo a ser reservado pela aplicação para receber uma resposta do SiTef. Tipo de parâmetros da função – dividiremos em dois grupos: 1. se for um campo fixo ele contém espaços.Especificação Técnica – Interface com os meios de pagamento do SiTef Bibliotecas CliSiTefI e CliSiTef 3. são apresentadas as duas versões de cada uma das funções disponíveis ou seja. O que diferencia a versão ASCII da versão padrão é o acréscimo do sufixo A no nome das funções. a que trabalha com dados binários e a que trabalha com dados em ASCII. quando esse valor for fornecido. Software Express Ltda. Se for um campo variável ele contém apenas o delimitador de início e final de campo. existe uma terceira e quarta versão da mesma que é de uso exclusivo e obrigatório para aplicações de auto-atendimento uma vez que é exigida por algumas bandeiras a impressão dos bens adquiridos no meio do comprovante de TEF. Quando à passagem: o parâmetro pode ser passado por valor ou por referência. 2. 2013 6 . Para algumas das funções presentes na biblioteca. Quanto ao fluxo de informações: o parâmetro pode ser de entrada ou saída.. Tamanho do campo – no caso de campo de tamanho fixo. Serão adotadas as seguintes convenções: Campo vazio ou não fornecido – na versão padrão é um campo contendo apenas o delimitador (zero binário).Rotinas disponíveis na CliSiTef Versão: 120 Data: 29/04/2013 Na descrição a seguir. Na versão ASCII. IPSiTef. IPSiTef.1 Configuração da biblioteca Versão: 120 Data: 29/04/2013 Através dessa rotina o aplicativo configura a CliSiTef de forma que ela possa interagir com o SiTef e com o próprio aplicativo de automação. long ConfiguraIntSiTefInterativo (IPSiTef.Especificação Técnica – Interface com os meios de pagamento do SiTef Bibliotecas CliSiTefI e CliSiTef 3. 2013 7 . IdTerminal. IdTerminal. por valor Entrada. ParâmetrosAdicionais) Parâmetro Resultado IPSiTef IdLoja Tipo Saída. IdLoja. Se não for fornecido o SiTef identificará a loja baseado no IP origem da conexão char * Fixo 8 Identifica o pdv perante a loja. Reservado. Neste caso possui o formato XXnnnnnn onde XX corresponde a 2 caracteres alfabéticos e nnnnnn 6 dígitos quaisquer desde que o número resultante não sobreponha a faixa 000900 a 000999 que é reservada para uso pelo SiTef short Fixo 6 Deve ser passado com 0 char * Variável Parâmetros adicionais de configuração da CliSiTef no seguinte Formato: [<Nome_Parametro_1>=<Valor_Parametro_1>. IdLoja. Reservado. IdTerminal. Reservado) long ConfiguraIntSiTefInterativoEx (IPSiTef. por valor Interface Interface Descrição padrão ASCII Não usado Fixo 6 Contém o resultado de resposta à chamada da rotina char * Variável Configura o nome ou endereço IP (em notação “. por valor IdTerminal Entrada. IdLoja. por valor Entrada.. Se não for fornecido o SiTef identificará a loja baseado no IP origem da conexão. É obrigatório se pIdLoja for fornecido.<N ome_Parametro_2>=<Valor_Parametro_2>] Software Express Ltda. Reservado) ConfiguraIntSiTefInterativoExA (Resultado. IdLoja. por valor Entrada. ParametrosAdicionais) Interface ASCII ConfiguraIntSiTefInterativoA (Resultado. IdTerminal. por valor Reservado ParametrosAdi cionais Entrada.”) do servidor SiTef char * Fixo 8 Identifica o número da loja perante a rede de estabelecimentos comerciais. Especificação Técnica – 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 Versão: 120 Data: 29/04/2013 Descrição Não ocorreu erro Endereço IP inválido ou não resolvido Código da loja inválido Código de terminal inválido Erro na inicialização do Tcp/Ip Falta de memória Não encontrou a CliSiTef ou ela está com problemas Configuração de servidores SiTef foi excedida.1 Configurações especiais gerais Determinadas configurações gerais (válidas para todas as transações) da CliSiTef podem ser passadas através do parâmetro “ParametrosAdicionais” da rotina ConfiguraIntSiTefInterativoEx.<Funcionalidade >. Ex: Windows: [PortaPinPad=1] Linux: [PortaPinPad=/dev/ttyS0] PortaPinPad=<Porta PinPad> Software Express Ltda.. Caminho DLL inválido (o caminho completo das bibliotecas está muito grande). No caso de transações com mais de um comprovante. 3.] A seguir. como transações de recarga de celular ou pagamentos de contas com cartões de crédito ou débito. Erro de acesso na pasta CliSiTef (possível falta de permissão para escrita) Dados inválidos passados pela automação. Modo seguro não ativo (possível falta de configuração no servidor SiTef do arquivo . Define a porta em que está conectado o pinpad compartilhado. descrevemos as funcionalidades previstas neste campo. 2013 8 . o comprovante da recarga de celular ou do pagamento de conta será entregue separadamente do comprovante do TEF de crédito ou débito...cha).. O formato deste campo é o seguinte: [<Funcionalidade >. Funcionalidade MultiplosCupons=1 Descrição Indica que o PDV está apto para receber mais de um comprovante por transação.1. conforme a tabela “Códigos de Funções” a seguir. Valor. Valor. Valor. CupomFiscal. CupomFiscal. HoraDiscal.Especificação Técnica – Interface com os meios de pagamento do SiTef Bibliotecas CliSiTefI e CliSiTef 3. Operador. Variável Contém o valor a ser pago contendo o separador decimal (“. 20 Identificação do operador de caixa Variável Parâmetros adicionais. DataFiscal. ParamAdic. por valor Interface Interface Descrição padrão ASCII Não usado Fixo 6 Contém o resultado de resposta à chamada da rotina long char * Seleciona a forma de pagamento. Operador. por valor Entrada. 20 Número do Cupom Fiscal correspondente à venda Fixo 8 Fixo 6 Data Fiscal no formato AAAAMMDD Horário Fiscal no formato HHMMSS Fixo 6 CupomFiscal DataFiscal HoraFiscal Operador ParamAdic Entrada.2 Início da transação de Pagamento ou Gerencial Versão: 120 Data: 29/04/2013 long IniciaFuncaoSiTefInterativo (Funcao. Permite que o aplicativo limite o tipo de meio de pagamento. por valor Entrada. É obrigatório pois tais produtos farão parte integrante Produtos Entrada.”). devem ser usadas as rotinas a seguir. Produtos) Interface ASCII IniciaFuncaoAASiTefInterativoA (Resultado. por valor Entrada. HoraFiscal. ParamAdic) CupomFiscal. ParamAdic. Ele é opcional e pode ser passado vazio. 2013 9 . long IniciaFuncaoAASiTefInterativo (Funcao. Caso a operação não tenha um valor definido a priori (p/ex.”). Operador. esse campo deve vir zerado Máx. Funcao. Operador. Vide item 5 para a descrição do formato interno deste campo Variável Contém a lista de produtos que o cliente está adquirindo no terminal de Auto-Atendimento. Funcao. por valor char * char * char * char * char * Máx. recarga de pré-pago). por valor Entrada. Valor. HoraFiscal.Deve sempre ser passado com duas casas decimais após a vírgula (“. HoraFiscal. por valor Entrada.. por valor char * Software Express Ltda. No caso de um terminal de Auto-Atendimento. ParamAdic) Interface ASCII IniciaFuncaoSiTefInterativoA (Resultado. DataFiscal. Produtos) Parâmetro Resultado Funcao Valor Tipo Saída. DataFiscal. por valor Entrada. Quando esse campo for utilizado a CliSiTef irá limitar os menus de navegação apenas aos códigos não presentes na lista. DataFiscal. CupomFiscal. IMPORTANTE: Essa rotina apenas inicia o processo de pagamento.<Código2>.<Código1>. Operação cancelada pelo operador. 2013 10 .2. Módulo não inicializado. Campo Descrição Código Quantidade Valor Formato 1 a 14 caracteres 1 a 08 caracteres 1 a 04 dígitos 999. Falha no pinpad. Se o retorno for 10000 o processo de pagamento deve ser continuado através da rotina ContinuaFuncaoSiTefInterativo ou ContinuaFuncaoSiTefInterativoA até que esta última devolva um resultado final (vide item que descreve esta função).. Operação cancelada pelo usuário.1 Tabela de códigos 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 número negativo Descrição Deve ser chamada a rotina de continuidade do processo. Fornecido um código de função inválido. Transação não segura..999. Software Express Ltda.<Quantidade1>. Erros detectados internamente pela rotina.<Quantidade2>. Falta de memória para rodar a função. 3. Transação negada pelo SiTef. Sem comunicação com o SiTef.Especificação Técnica – Interface com os meios de pagamento do SiTef Bibliotecas CliSiTefI e CliSiTef Versão: 120 Data: 29/04/2013 do comprovante da operação de Tef a ser impresso. Negada pelo autorizador.99 Ele deve ser repetido tantas vezes quanto o número de produtos distintos adquirido pelo cliente. Erro interno do módulo. O formato básico deste campo é: [<Descrição1>..<ValorT otal1>].<ValorT otal2>]. [<Descrição2>.. Função Descrição Pagamento genérico. 2013 11 . A CliSiTef permite que o operador escolha a forma de pagamento 0 através de menus.Especificação Técnica – Interface com os meios de pagamento do SiTef Bibliotecas CliSiTefI e CliSiTef 3.2 Tabela de códigos de funções Versão: 120 Data: 29/04/2013 Os seguintes códigos estão disponíveis para serem usados no parâmetro Funcao descrita acima.2. Cheque 1 Débito 2 Crédito 3 Fininvest 4 Cartão Benefício 5 Crédito Centralizado 6 Cartão Combustível 7 Parcele Mais Redecard 8 Benefício Refeição 10 Benefício Alimentação 11 Cartão Infocard 12 Pay Pass 13 Cartão Nova Plataforma Ticket Car (NPTC) 14 Venda com cartão Gift 15 Débito para pagamento de carnê 16 50 51 52 53 54 55 56 57 100 Venda Boleto Carrefour Venda Autorizacao Carrefour Recebimento Carrefour Inclusão de Boleto Carrefour Inclusão de Venda Carrefour Consulta Recebimento Carrefour Consulta Limite mínimo PromoFlex Carrefour Cancelamento de Recebimento Carefour Telemarketing: Inicia a coleta dos dados da transação no ponto necessário para tratar uma transação de cartão de crédito digitado Abre o menu de transações Gerenciais Teste de comunicação com o SiTef Menu Re-impressão Re-impressão comprovante específico Re-impressão ultimo comprovante Pré-autorização Captura de pré-autorização Consulta Bônus Consulta Saldo Cartão Presente Consulta Saldo Cartão Gift Consultas Cartão SEM 110 111 112 113 114 115 116 150 151 152 160 Software Express Ltda.. sem ser necessário passar antes pelo menu de transações administrativas Cancelamento Telemarketing: Similar a modalidade 200 só que para a função de cancelamento de transação de crédito digitado Cancelamento Pré-autorização Cancelamento da Captura da Pré-autorização Cancelamento de venda com cartão de Crédito Cancelamento de venda com cartão de Débito Cancelamento de venda com cartão Combustível Cancelamento de Venda com Cartão Gift Cancelamento de Consulta Bônus Cancelamento Recarga Cartão Presente Cancelamento Acúmulo de Pontos Cartão Bônus Resgate de Pontos Cartão Bônus Cancelamento de Resgate de Pontos Cartão Bônus Acúmulo de Pontos Cartão Bônus Cancelamento Recarga Cartão Gift Recarga Cartão Bônus Recarga Cartão Presente Recarga Cartão Gift Ativação Pagamento Vinculado Cartão Gift Consulta Cartão Gift Ativação Cartão Gift Sem Pagamento Ativação Cartão Gift Com Pagamento Ativação Desvinculada Cartão 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 Bancário (Pagamento de Contas) Pagamento de Contas com Saque Consulta para Pagamento Desvinculado (Genérico) Pagamento Desvinculado (Genérico) Recarga Pré Pago HSBC com Saque Saque para Pagamento Cancelamento do pagamento desvinculado (genérico) Consulta Limites do Correspondente Bancário 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..Especificação Técnica – Interface com os meios de pagamento do SiTef Bibliotecas CliSiTefI e CliSiTef 161 200 Vendas Cartão EMS Versão: 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 necessário para fazer o cancelamento de uma transação de débito ou crédito. 2013 12 . .Especificação Técnica – 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 Depósito Identificado Transferência entre Contas Pague Fácil Revalidação de Senha INSS Venda Produto (Sem Valor) Cancelamento de Venda Produto (Sem Valor) Vale-Gás Validação Vale-Gás Troco Surpresa Troco Premiado Cancelamento Troco Premiado Troco Solidário / Doação solidária Versão: 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é-autorização PharmaSystem Recuperação de pré-autorização PharmaSystem Venda PharmaSystem Cancelamento PharmaSystem Obtem Autorização 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é-autorização 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 . Especificação Técnica – 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é Autorização TrnCentre (PBM) Venda sem Pré Autorização TrnCentre (PBM) Venda com Pré Autorização TrnCentre (PBM) Cancelamento TrnCentre (PBM) Consulta Saldo Consulta Saldo Cartão de Débito Consulta Saldo Cartão de Crédito Consulta Saldo Cartão Combustível Consulta de Redes Cartão Combustível Consulta Produtos Cartão Combust Consulta Saldo Cartão Combustível Consulta Redes Cartão Combustível Consulta Produtos Cartão Combustível Transações 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) Cartão 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 Opções de transações NPTC Consulta Saldo NPTC Atualização Cartão NPTC Consulta Produtos Host NPTC Consulta Produtos PDV NPTC Cadastra Produtos NPTC Troca de senha NPTC Boleto de venda NPTC Versão: 120 Data: 29/04/2013 Software Express Ltda. 2013 14 .. 2013 15 .Especificação Técnica – 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 Cartão Riachuelo Troca de senha Cartão Riachuelo Venda Riachuelo Venda Private Label Softway/Renner Venda Cartão Bandeira Softway/Renner Pagamento de Fatura Softway Desbloqueio de Cartão Softway/Renner Troca de Senha Cartão Softway/Renner Consulta de Fatura Cartão Softway/Renner Venda Pin de Jogos Venda Pin de Recarga Saque Crédito Transferência Menu Saque IBI Consulta Saque Banco IBI Saque Banco IBI Saque GetNet Cancelamento Saque GetNet Resgate de Pontos Emissão de Pontos Cancelamento da Emissão 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 Cartão Benefício Primeira Compra Pagamento de Fatura Versão: 120 Data: 29/04/2013 Software Express Ltda.. Especificação Técnica – Interface com os meios de pagamento do SiTef Bibliotecas CliSiTefI e CliSiTef Versão: 120 Data: 29/04/2013 740 999 1000 Consulta Parcelas Crédito Adm Fechamento Voucher Papel Software Express Ltda.. 2013 16 . Comando. mantendo os anteriores em memória. por referência Saída. Buffer. TamMinimo. Deve possuir. Os comando válidos estão descritos em Tabela de códigos de Comando Contém o código do tipo de campo que a automação deve tratar.000 bytes. no mínimo. quando possível. conforme descrito nos resultados devolvidos por ela. TamMaximo. Os tipos existentes estão descritos em Tabela de valores para TipoCampo Quando o Comando for uma coleta de dados. por referência Entrada e saída. por valor long * Fixo 12 short * Fixo 6 short * Fixo 6 char * TamBuffer Continua long long Variável Área de transferência de dados entre a aplicação e a CliSiTef. por referência Saída. TamMinimo.3 Continuação do processo de coleta interativo Versão: 120 Data: 29/04/2013 Esta função deve ser chamada de forma contínua até não existam mais informações para serem trocadas entre a aplicação e a CliSiTef. 2013 17 . TamMaximo. O formato de ativação é o seguinte: long ContinuaFuncaoSiTefInterativo (Comando. por valor Entrada. caso existam.Especificação Técnica – Interface com os meios de pagamento do SiTef Bibliotecas CliSiTefI e CliSiTef 3. TipoCampo. Continua) Parâmetro Resultado Comando Tipo Saída. permitindo que tais pagamentos Software Express Ltda. por valor Saída. deve passar esse campo vazio Fixo 6 Tamanho da área reservada pela automação para o campo Buffer Fixo 6 Contem instruções para a CliSiTef a respeito do Comando executado segundo a seguinte codificação: 0 Continua a transação 1 Retorna. Continua) Interface ASCII ContinuaFuncaoSiTefInterativoA (Resultado. a coleta ao campo anterior 2 Cancela o pagamento de conta atual.. 20. TamBuffer. por valor Entrada. TamBuffer. TipoCampo. contém o tamanho Mínimo e Maximo do campo a ser lido TipoCampo TamMinimo TamMaximo Buffer Saída. Buffer. por referência Interface Interface Descrição padrão ASCII Não usado Fixo 6 Contém o resultado de resposta à chamada da rotina long * Fixo 12 Contém no retorno: 0 caso a CliSiTef esteja devolvendo algum dado referente a transação no campo Buffer <> 0  indica o Próximo Comando a ser executado pelo aplicativo. Se automação não estiver enviando dados para a CliSiTef. Adicionalmente a estes valores. já devolver o número previamente combinado sem capturar esse dado do usuário. conforme mostrado a seguir: Software Express Ltda. por isso antes de sua utilização realizar consulta a departamento de Suporte da Software Express que verificará a necessidade de autorização prévia pelas bandeiras. 10000 Continua a transação.) deve ser feita com Comando. TamMaximo e Continua contendo o valor zero (0). podendo a automação sempre capturar os dados da tela. É importante salientar que a chamada que inicia o processo Interativo (aquela que é feita após ter sido recebido o valor 10000 na chamada de uma função de Pagamento. 2013 18 . etc.. Um exemplo típico desta situação ocorre quando a automação já fechou com o cliente uma forma de pagamento parcelado com cartão de crédito.. Retorno válido apenas nas coletas de valores e data de vencimento de um pagamento de contas. vide observação a seguir -1  Encerra a transação Obs. No retorno a rotina devolve os mesmos valores da rotina de Pagamento. O uso desta característica poderá alterar o fluxo de coleta ou qualquer regra definida pelas bandeiras. Notar também que esta forma de uso não é obrigatória. no momento do fechamento da venda. Neste caso a automação pode. TamMinimo. TipoCampo. Gerencial. Notar também que a automação comercial deve ficar em laço chamando a rotina aqui descrita até que ela receba um resultado diferente de 10000 ou que a própria automação desista de continuar o processo.Especificação Técnica – Interface com os meios de pagamento do SiTef Bibliotecas CliSiTefI e CliSiTef Versão: 120 Data: 29/04/2013 sejam enviados para o SiTef e até mesmo permite incluir novos pagamentos.: Como nem sempre o campo solicitado pela rotina precisa ser lido no momento da solicitação a rotina aceita o valor 10000 para indicar que o campo não foi coletado naquele momento mas sim previamente. no momento que a coleta campo for solicitada para ler o número de parcelas. Notar que nessa forma de uso é imprescindível que o dado seja apresentado para o operador que deverá confirmar veracidade dele antes da rotina devolver o mesmo para a CliSiTef. ele foi aprovado pela administradora).. a função devolve o valor 0 (Zero) para indicar que a função solicitada foi concluída com sucesso (p/ex: se for um pagamento. . no retorno. se ela receber algum código em TipoCampo que ela desconheça ou não deseje tratar. na nova chamada. chamar a rotina ContinuaFuncaoSiTefInterativo passando –1 (menos um) no campo Continua. segundo o que está especificado na descrição de cada comando que o aplicativo de automação deve tratar. apresentado no visor ou outro motivo. ela não deve modificar nenhum dos campos preenchidos pela CliSiTef a não ser o Buffer que. Notar ainda que mesmo que o Buffer contenha um campo coletado pela automação. 2013 19 . o seu tamanho deve ser o recomendado por esse documento pois irá conter. TamMaximo e Continua com 0 Inicializa TamBuffer com o tamanho do Buffer Chama a rotina ContinuaFuncaoSiTefInterativo Retornou 10000? Não Sim Executa o Comando solicitado Fim Caso a automação deseje encerrar o processo de coleta ela deve. TipoCampo.Especificação Técnica – Interface com os meios de pagamento do SiTef Bibliotecas CliSiTefI e CliSiTef Versão: 120 Data: 29/04/2013 Início Inicializa Comando. Notar que o campo Buffer pode ter sido preenchido pela rotina com algum dado para ser memorizado. Software Express Ltda. necessariamente. IMPORTANTE: É obrigatório que a automação SEMPRE colete campos não tratáveis por ela ou seja. Caso o processo de coleta deva continuar. deve conter o resultado da coleta (se Comando diferente de 0) ou o dado original se Comando veio com 0. TamMinimo. que a informação seja capturada pela digitação pelo operador da informação solicitada. novos dados fornecidos pela rotina. e aguardar uma tecla do operador.). transações requerem para 16 20 21 22 23 29 O valor a ser coletado refere-se ao campo indicado em TipoCampo. 2013 20 . É utilizada quando se deseja que o operador seja avisado de alguma mensagem apresentada na tela. cujo tamanho está entre TamMinimo e TamMaximo. Este comando indica que a rotina está perguntando para a aplicação se ele deseja interromper o processo de coleta de dados ou não. No retorno o primeiro caráter presente em Buffer deve conter 0 se confirma e 1 se cancela. etc. Um exemplo é a transação de Empréstimo do Correspondente Bancário. ser armazenado pela automação Mensagem para o visor do operador Mensagem para o visor do cliente Mensagem para os dois visores Texto que deverá ser utilizado como título na apresentação 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 título na apresentação do menu (comando 4) Cabeçalho a ser apresentado pela aplicação.. Deve apresentar um menu de opções e permitir que o usuário selecione uma delas. se desejado.. . não precisa que seja digitado/mostrado na tela. ou seja. Esse código ocorre quando a CliSiTef está acessando algum periférico e permite que a automação interrompa esse acesso (por exemplo: aguardando a passagem de um cartão pela leitora ou a digitação de senha pelo cliente) Análogo ao comando 30.3. Refere-se a exibição de informações adicionais que algumas transações necessitam mostrar na tela... Após a seleção feita pelo usuário. Deve remover o cabeçalho apresentado pelo comando 15.. A rotina da aplicação deve apresentar as opções da forma que ela desejar (não sendo necessário incluir os índices 1. Um exemplo são as formas de pagamento que algumas identificar qual o tipo de pagamento que está sendo usado. e obter uma resposta do tipo SIM/NÃO.Especificação Técnica – Interface com os meios de pagamento do SiTef Bibliotecas CliSiTefI e CliSiTef 3. porém deve ser coletado um campo que não requer intervenção do operador de caixa.. Software Express Ltda... Deve apresentar o texto em Buffer. Na chamada o parâmetro Buffer contém as opções no formato 1:texto. retornar em Buffer o índice i escolhido pelo operador (em ASCII) Deve apresentar a mensagem em Buffer.). que em certo ponto precisa que sejam mostradas informações para o cliente detalhando o empréstimo que está sendo contratado (como Valor da parcela.2. vencimento. e sim passado diretamente para a biblioteca pela automação. O campo deve ser devolvido em Buffer..i:Texto.2:texto..1 Tabela de códigos de Comando Versão: 120 Data: 29/04/2013 A seguir apresentamos os valores possíveis para o parâmetro Comando e a ação que a aplicação deve executar ao recebê-lo: Comando 0 1 2 3 4 11 12 13 14 15 Descrição Está devolvendo um valor para. digitação do CMC-7 ou pela digitação da primeira linha do cheque.. O campo lido deve ser devolvido em Buffer. e cada par (classe. Dentro de cada “classe” existe a codificação de “tipos”. retornando como bom um cheque com problemas. C1 (1). Sugerimos que na coleta seja apresentada uma interface que permita ao operador identificar e digitar adequadamente estas informações de forma que a consulta não seja feita com dados errados. retornar em Buffer o índice i escolhido pelo operador (em ASCII). C2 (1).i:Texto:código:tipo. tipo) indica a Software Express Ltda. indicando que a coleta foi cancelada. Cabe ao aplicativo decidir se a coleta será manual ou através de uma leitora. permitindo a efetivação de tais pagamentos. tipo e classe) e após a seleção feita pelo usuário.“1:”(Leitura do CMC-7) ou “2:”(Digitação do CMC-7). porém o fluxo não será interrompido.Especificação Técnica – Interface com os meios de pagamento do SiTef Bibliotecas CliSiTefI e CliSiTef 30 31 Versão: 120 Data: 29/04/2013 Deve ser lido um campo cujo tamanho está entre TamMinimo e TamMaximo. porém o campo deve ser coletado de forma mascarada.. respectivamente. Análogo ao Comando 30. Deve apresentar um menu de opções e permitir que o usuário selecione uma delas. No retorno do Buffer também pode ser passado “2:”. 2013 21 . No retorno deve ser devolvido em Buffer “0:”(digitação da primeira linha do cheque) .2. A coleta pode ser feita via leitura de CMC-7. Deve ser lido o número de um cheque. . Banco (3). O código das opções é a identificação (Tabela de códigos de meios de pagamento. Numero do Cheque (6) e C3 (1). Caso seja coleta manual.. aceita o delimitador de centavos e devolvido no parâmetro Buffer. nem códigos do campo. Notar que estes campos são os que estão na parte superior de um cheque e na ordem apresentada. todos os documentados coletados anteriormente serão mantidos e o fluxo retomado.. Na chamada o parâmetro Buffer contém as opções classe|1:texto:código:tipo.. deixando o aplicativo de automação independente de futuras alterações que possam surgir nos formatos em barras.. logo no caso de pagamentos múltiplos. Deve ser lido um campo monetário ou seja. Quando a primeira linha do cheque for coletada manualmente. Menu identificado. Agencia (4). o formato é o seguinte: Compensação (3). recomenda-se seguir o procedimento descrito na rotina ValidaCampoCodigoEmBarras de forma a tratar um código em barras da forma mais genérica possível. seguido do número coletado manualmente ou pela leitura/digitação do CMC-7. nesta ordem.2:texto:código:tipo.. configurações e menus) do campo da opção. no formato 34 35 41 42 A rotina da aplicação deve apresentar as opções da forma que ela desejar (não sendo necessário incluir os índices 1.. No retorno Buffer deve conter “0:” ou “1:” seguido do código em barras coletado manualmente ou pela leitora. Deve ser lido um código em barras ou o mesmo deve ser coletado manualmente. respectivamente. ContaCorrente (10). ela pode ser utilizada na identificação da opção escolhida. Software Express Ltda. indicando que ainda não houve a necessidade de classificá-los. Esse comando passa a ser utilizado quando o parâmetro adicional ItemMenuIdentificado for utilizado (Habilitação de configurações especiais). Classe 0 1 Descrição Classe não definida Forma de pagamento Tipo 1 2 3 4 5 6 Descrição Dinheiro Cheque Débito Crédito Saque Outra forma Os demais menus não estão identificados. sendo obrigação da aplicação estar preparada para tratar os dois comandos. o comando 21 (coleta de menu) será substituído na maior parte dos casos.Especificação Técnica – Interface com os meios de pagamento do SiTef Bibliotecas CliSiTefI e CliSiTef Versão: 120 Data: 29/04/2013 natureza da opção.. Assim. quando esse parâmetro estiver habilitado. 2013 22 . A ideia é adicionar códigos que identificam as opções do menu para possibilitar que o PDV identifique essas opções sem o auxílio do operador. Nesse caso. uma opção no menu é identificada sempre a partir do par tipo da opção e classe da opção. Os menus não identificados recebem o valor zerado nesses campos. Inicialmente foi implementada apenas a identificação para as formas de pagamento. As classes de opção têm como objetivo definir um contexto para o qual o código que identifica o tipo de opção seja determinado. Descreve por extenso o par xxnn fornecido em 110.F. Para ambientes com múltiplos servidores será retornado no seguinte formato: <Dados_Confirmacao>. Contém dados adicionais relativos ao cartão utilizado na operação de Tef. etc.. 2013 23 .<Endereco_SiTef> 2 Informa o código da função SiTef utilizado na mensagem enviada para o servidor.E. Segue o mesmo formato do TipoCampo 100. O formato Software Express Ltda. Descreve por extenso o par xxnn fornecido em 100 Contém o texto descritivo da modalidade de pagamento que deve ser impresso no cupom fiscal (p/ex: T. Cheque. 100 Contém a modalidade de pagamento no formato xxnn.<Indice_SiTef>. xx 00 01 02 03 98 99 Grupo Cheque Cartão de Débito Cartão de Crédito Cartão tipo Voucher Dinheiro Outro tipo de cartão 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 Contém o texto real da modalidade de pagamento que pode ser memorizado pela aplicação caso exista essa necessidade.) Contém a data e hora da transação no formato AAAAMMDDHHMMSS Contém a modalidade de cancelamento no formato xxnn xx corresponde ao grupo da modalidade e nn ao sub-grupo... e retorna quando uma transação for cancelada.Especificação Técnica – Interface com os meios de pagamento do SiTef Bibliotecas CliSiTefI e CliSiTef 3..3. 10 a 99 Informa qual a opção selecionada no menu de navegação de transações seguindo a e mesma codificação utilizada para definir as restrições no pagamento descritas no item 3000 a 3999 Restrição ou habilitação das formas de pagamento. Contém o texto real da modalidade de cancelamento que pode ser memorizado pela aplicação caso exista essa necessidade.2 Tabela de valores para TipoCampo Versão: 120 Data: 29/04/2013 A seguir apresentamos os valores possíveis para o campo TipoCampo e respectivos significados: TipoCampo Descrição -1 Não existem informações que podem/devem ser tratadas pela automação 0 A rotina está sendo chamada para indicar que acabou de coletar os dados da transação e irá iniciar a interação com o SiTef para obter a autorização 1 Dados de confirmação da transação. xx corresponde ao grupo da modalidade e nn ao sub-grupo. Caso tenha sido um cartão normal. Software Express Ltda. Na devolução de resultado (Comando = 0) contém o valor efetivamente aprovado para o troco Contém um índice que indica qual a instituição que irá processar a transação segundo a tabela presente no final do documento (5 posições) Contém um índice que indica qual o tipo do cartão quando esse tipo for identificável. Caso o aplicativo de automação possua esse valor. Caso ele não possua esse valor. quando possível. 2013 24 .. deve lê-lo. Pode ser um comprovante de venda ou administrativo Indica que os comprovantes que serão entregues na seqüência são 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" Código do Voucher Indica. é reduzida de forma a ocupar poucas linhas na impressora. na coleta. Por enquanto o único código que retorna é a palavra EE para indicar que o cartão utilizado foi um EasyEntry ou EMV para indicar um cartão EMV. segundo uma tabela a ser fornecida (5 posições) Contém o NSU do SiTef (6 posições) Contém o NSU do Host autorizador (15 posições no máximo) Contém o Código de Autorização para as transações de crédito (15 posições no máximo) Contém as 6 primeiras posições do cartão (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 são chamados n vezes onde n = conteúdo do campo 505 Valor gorjeta Valor devolução Valor de pagamento A rotina está sendo chamada para ler o Valor a ser cancelado. Modalidade Ajuste Buffer contém a linha de autenticação do cheque para ser impresso no verso do mesmo Buffer contém a primeira via do comprovante de pagamento (via do cliente) a ser impressa na impressora fiscal. Pode ser um comprovante de venda ou administrativo Buffer contém a segunda via do comprovante de pagamento (via do caixa) a ser impresso na impressora fiscal. que o campo em questão é o valor do troco em dinheiro a ser devolvido para o cliente. Essa via. esse tipo de campo não é retornado para a aplicação. pode apresentá-lo para o operador e permitir que ele confirme o valor antes de passá-lo devolvê-lo para a rotina.Especificação Técnica – Interface com os meios de pagamento do SiTef Bibliotecas CliSiTefI e CliSiTef Versão: 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 seqüência de códigos separados por ponto-e-virgula. A automação. deixando o fluxo da transação seguir normalmente caso seja um supervisor aceitável Tipo do Documento a ser consultado (0 – CPF. 2013 25 . quando disponível. obtida na função LeCartaoInterativo Contem a senha do cliente capturada através da rotina LeSenhaInterativo e que deve ser passada a lib de segurança da Software Express personalizada para o estabelecimento comercial de forma a obter a senha aberta Contém o novo valor de pagamento Tipo cartão Bônus Nome da instituição Código de Estabelecimento Código da Rede Autorizadora – Serviço H Número do cupom original Número Identificador do Cupom do Pagamento Venda Parcelada Estabelecimento Habilitada Número Mínimo de Parcelas – Parcelada Estabelecimento Número Máximo de Parcelas – Parcelada Estabelecimento Valor Mínimo Por Parcela – Parcelada Estabelecimento Venda Parcelada Administradora Habilitada Número Mínimo de Parcelas – Parcelada Administradora Número Máximo de Parcelas – Parcelada Administradora Indica que o campo é numérico (PBM) Indica que o campo é alfanumérico (PBM) Saldo disponível*. saldo do produto específico (escolar. 1 – caso contrário) Intervalo em dias entre parcelas Captura se é mês fechado (0) ou não (1) Captura se é com (0) ou sem (1) garantia no pré-datado com cartão de débito Número de Parcelas CDC Número do Cartão de Crédito Digitado Data de vencimento do Cartão Código de segurança do Cartão Data da transação a ser cancelada (DDMMAAAA) ou a ser re-impressa Número do documento a ser cancelado ou a ser re-impresso A rotina está sendo chamada para ler o Número do cheque segundo o descrito no tipo de comando correspondente ao valor 31 Código do Item Código do Plano de Pagamento NSU do SiTef Original (Cisa) Número do documento de identidade (RG) Software Express Ltda. obtida na função LeCartaoInterativo Contém a Trilha 2. validar os dados coletados.. vale transporte) Saldo Bloqueado Indica que o campo em questão é o código do supervisor. quando disponível. se desejado. 1 – CGC) Numero do documento (CPF ou CGC) Taxa de Serviço Número de Parcelas Data do Pré-datado no formato ddmmaaaa Captura se a primeira parcela é a vista ou não (0 – Primeira a vista. pode.Especificação Técnica – Interface com os meios de pagamento do SiTef Bibliotecas CliSiTefI e CliSiTef 147 150 151 153 Versão: 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 Contém a Trilha 1. . 2013 26 .Especificação Técnica – 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 Versão: 120 Data: 29/04/2013 A rotina está sendo chamada para ler o Número do Telefone A rotina está sendo chamada para ler o DDD de um telefone com até 4 dígitos 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) Autorização do supervisor digitada Autorização 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 transação Registros de retorno da consulta cheque CDL-Poa Código de área da cidade do cheque Endereço Número do endereço Andar do endereço Conjunto do endereço Bloco do endereço CEP do endereço Bairro do endereço CPF para consulta AVS Resultado da consulta AVS Número de dias do pré-datado Número de Ciclos Código da Ocorrência Código de Loja (EMS) Código do PDV (EMS) Dados Retornados (EMS) Ramal do Telefone Órgão Expedidor do RG Estado onde foi emitido o RG Data de expedição do RG Matrícula do Operador Nome do Operador Matrícula do Conferente Nome do Conferente Percentual de Juros Aplicado Matrícula do Autorizador Data do Cupom Fiscal da Transação Original Hora do Cupom Fiscal da Transação Original Dados do Carnê ou código resumido EMS Código de milhas diferenciadas 1 Valor das milhas diferenciadas 1 Código de milhas diferenciadas 2 Valor das milhas diferenciadas 2 Software Express Ltda. 2013 . 2  Tributo Contém os dados do cheque utilizado para efetuar o pagamento das contas no seguinte formato: Compensação (3). Aparece uma vez para cada índice de documento (campo 607). nesta ordem. Notar que a ordem é a mesma presente na linha superior do cheque sem os dígitos verificadores NSU SiTef transação de pagamento NSU SiTef da transação original (transação de cancelamento) NSU Correspondente Bancário da transação original (transação de cancelamento) Valor do Benefício Código impresso no rodapé do comprovante do CB e utilizado para reimpressão/cancelamento Código em barras pago. dos campos 600 a 604 que virão em seguida Modalidade de pagamento utilizada na função de correspondente bancário. O formato é o mesmo utilizado para entrada do campo ou seja. Segue a mesma regra de formatação que o campo de número 100 Valor total dos títulos efetivamente pagos no caso de pagamento em lote Valor total dos títulos não pagos no caso de pagamento em lote NSU Correspondente Bancário Tipo do documento: 0  Arrecadação. 1  Titulo (Ficha de compensação).Especificação Técnica – 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 Versão: 120 Data: 29/04/2013 614 620 621 622 623 624 625 626 627 628 629 630 631 Tipo de código externo EMS Código externo EMS Código da Operadora de Celular Nome da Operadora de Celular selecionada para a operação Valor selecionado para a recarga DDD + Número do celular a ser recarregado Digito(s) verificadores Cep da localidade onde está o terminal no qual a operação está sendo feita Nsu do SiTef correspondente a transação de pagamento da Recarga com cartão Nsu do Host Autorizador correspondente a transação de pagamento da Recarga com cartão Código da Filial que atendeu a solicitação de recarga do celular Mensagem da Operadora de Celular Código da rede autorizadora da recarga de celular Data de vencimento do título/convênio no formato DDMMAAAA Valor Pago* Valor Original Valor Acréscimo Valor do Abatimento Data Contábil do Pagamento Nome do Cedente do Titulo. e Numero do Cheque (6). Banco (3). Conta Corrente (10). Deve ser impresso no cheque quando o pagamento for feito via essa modalidade Índice do documento. 0:numero ou 1:numero Recibo de retirada Número do banco Agência Dígito da agência Conta Dígito da conta Valor em dinheiro 27 Software Express Ltda. Agencia (4).. no caso do pagamento em lote. Especificação Técnica – 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 Versão: 120 Data: 29/04/2013 Valor em cheque Nome do depositante Documento original de Correspondente Bancário Chave do usuário utilizada para comunicação com o Banco Seqüencial único da chave do usuário no Banco Código da Agência de relacionamento da loja do correspondente Número do Cheque CB Número da Fatura Número do Convênio Data Inicial do Extrato (DDMMAAAA) Data Final do Extrato (DDMMAAAA) Período de Apuração Código 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 ValeGás Produto ValeGás Número do ValeGás Número de Referência Código GPS Competência GPS Identificador Contribuinte Valor INSS Valor Outras Entidades Permite Pagamento de Contas Com Dinheiro (0 – Não Permite. 1 – Permite) Permite Pagamento de Contas Com TEF Crédito (0 – Não Permite. 1 – Permite) Formas de Pagamento utilizadas na transação de Pagamento genérico Valor do Saque Numero do Pedido Valor Limite do Depósito CB Valor Limite do Saque CB Valor Limite do Saque para Pagamento CB Valor do produto ValeGás Valor mínimo de pagamento Identificação do Cliente. 2013 28 . 1 – Permite) Permite Pagamento de Contas Com Cheque (0 – Não Permite.. apenas para recebimento Carrefour Venda Crédito Parcelada com Plano Habilitada Venda Crédito com Autorização a Vista Habilitada Software Express Ltda. 1 – Permite) Permite Pagamento de Contas Com TEF Débito (0 – Não Permite. uso futuro) 06 Código da Empresa (Loja) da transação de TEF 07 NSU do Host da transação de TEF 08 Data do Host da transação de TEF (Campo 105 CliSiTef) 09 Código de Origem (Estabelecimento) da transação de TEF 10 Serviço Z da transação de TEF 11 Código de Autorização da transação de TEF 12 Valor do Cheque Limite minimo de venda para promoções flexíveis. onde “n” é o número de formas de pagamento habilitadas: 00 01 02 Dinheiro Cheque TEF Débito 732 Dados a serem enviados para o Tipo de Pagamento (Campo 730) retornado anteriormente. 0 para sem limite Tipo de Pagamento Habilitado. repete “n” vezes. apenas para recebimento Carrefour Motivo (Carrefour) Valor sugerido para o produto selecionado.PBM Índice do medicamento – PBM Código do medicamento – PBM 734 736 737 738 739 750 751 900 901 902 903 910 911 1002 1003 1010 1011 1012 Software Express Ltda.. onde “n” é o número 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 transação de TEF 05 Data do SiTef da transação de TEF (não utilizado. repete “n” vezes. 2013 29 . Cliente Preferencial Valor Pague Fácil CB Valor Tarifa Pague Fácil CB Código Material AURA Código Plano AURA Nome creditado no Cheque AURA Número Dossiê AURA Tipo de Venda Conductor/Renner : 1 = Venda via Fatura 2 = Venda via Boleto Define se após a consulta de fatura. com 12 dígitos sendo os 2 últimos dígitos referentes as casas decimais Saldo devedor atual.Especificação Técnica – Interface com os meios de pagamento do SiTef Bibliotecas CliSiTefI e CliSiTef 726 727 729 730 731 Versão: 120 Data: 29/04/2013 Venda Crédito com Autorização Parcela com Plano Habilitada Venda Boleto Habilitada Valor máximo de pagamento Número Máximo de Formas de Pagamento. deve encadear o pagamento de fatura (Conductor Renner) Data de Validade do Cartão (NPTC) Nome do Portador do Cartão (NPTC) Quantidade de medicamentos . 2013 30 .ACSP Data de nascimento Nome da mãe Número do título de eleitor – ACSP Endereço do telefone consultado – ACSP CEP do telefone consultado – ACSP Cidade do telefone consultado – ACSP UF do telefone consultado – ACSP Dados adicionais – ACSP Registro analítico CHECKCHECK Software Express Ltda.PBM Código de autorização PBM Quantidade estornada – PBM Código de estorno PBM Preço recomendado consumidor a vista – PBM Preço recomendado consumido para desconto em folha – PBM Percentual de reposição da farmácia – PBM Comissão de reposição – PBM Tipo de Autorização – PBM Código do conveniado – PBM Nome do conveniado – PBM Tipo de Medicamento PBM (01–Medicamento. 04-Perfumaria) Descrição do Medicamento – PBM Condição p/venda: Se 0 obrigatório utilizar preço Funcional Card (PF) Se 1 pode vender por preço inferior ao preço PF Preço funcional card Preço praticado – PBM Status do medicamento – PBM Quantidade receitada – PBM Referência – PBM Indicador da venda PBM (0-Produto venda cartão 1-Produto venda a vista) Grupo de Produto (EDMCard: 0 – Medicamento.Especificação Técnica – 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 Versão: 120 Data: 29/04/2013 Quantidade autorizada – PBM Preço máximo ao consumidor – PBM Preço recomendado ao consumidor – PBM Preço de venda na farmácia – PBM Valor de reembolso na farmácia – PBM Valor reposição na farmácia – PBM Valor subsídio do convênio – PBM CNPJ convênio – PBM Código do plano do desconto – PBM Possui receita médica – PBM CRM – PBM UF – PBM Descrição do produto* . 03-Manipulação Especial. 1 – Perfumaria.. 02-Manipulação.) Nome .PBM Código do produto – PBM Quantidade do produto – PBM Valor do produto – PBM Data da receita médica . .Especificação Técnica – 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 Versão: 120 Data: 29/04/2013 Registro analítico ACSP Registro analítico SERASA Imagem tela analítica ACSP Imagem tela analítica SERASA Motivo do cancelamento – ACSP Tipo de consulta – ACSP CNPJ Empresa Conveniada Código da administradora Dados tabela Telecheque . contendo 2 dígitos decimais porém sem o caractere decimal. Valor acumulado das consultas no dia.SPTrans Produto com Valor de Face . contendo 2 dígitos decimais porém sem o caractere decimal. Total de consultas efetuadas no dia.ACSP Matrícula do motorista – Cartão Combustível Placa do veículo – Cartão Combustível Quilometragem – Cartão Combustível Quantidade de litros – Cartão Combustível Combustível principal – Cartão Combustível Produtos de combustível – Cartão Combustível Código Produto Host – Cartão Combustível Horímetro – Cartão Combustível Linha de Crédito – Cartão Combustível Tipo de Mercadoria – Cartão Combustível Ramo – Cartão Combustível Casas decimais de preços unitários – Cartão Combustível Quantidade máxima de produtos à venda Tamanho do código do Produto – Cartão Combustível Código do veículo – Cartão Combustível Nome da Empresa – Cartão Combustível Casas decimais da quantidade – Cartão Combustível Retorna quando um cartão NPTC exigir coleta de dados não-esperados pela automação. Software Express Ltda. 2013 31 . Total de consultas de cheques pré-datados realizados no período. Lista de Perguntas – Cartão Combustível Permite Coleta de Produto – Cartão Combustível Código do Limite Quantidade de Titulares Data de Abertura da Empresa (DDMMAAAA) Nome do Titular Complemento do Endereço Cidade Estado Menu de Valores .Gift Embosso – Gol Offline PAN do cartão AES – Gol Offline Portador do cartão AES – Gol Offline Data de validade do cartão AES – Gol Offline Total de consultas anteriores Valor acumulado das consultas anteriores. ValeGas Demonstrativo de prazos : 0: Não. saldo do passe comum PAN do cartão presente Data primeiro vencimento Valor total Valor financiado Percentual multa Juros de mora TAC (Taxa de administração) Menu (produto) selecionado Visanet Tipo Crédito CDC (1 – CDC Produto. Vendedor (Usuário) .Especificação Técnica – 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 Versão: 120 Data: 29/04/2013 Valor acumulado de cheques pré-datados. Tipo de criptografia Índice MasterKey Chave de criptografia Senha do cartão Código de resposta do autorizador Bin da rede Número serial do CHIP Registro de controle do CHIP Saldo comum. 2013 32 .. 1: Sim Software Express Ltda. para mensagens 0x0400 Dados a serem enviados PARA a leitora SmartNet.PBM Senha – PBM Código de Retorno – PBM Origem – PBM Campo administrativo Campo livre Resultado da leitora SmartNet Dados obtidos da leitora após uma operação de débito do cartão SmartVR ou Sodexho Campo de mensagem do serviço D. 2 – CDC Serviço) 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 Código consulta cheque (Genérica EMS) Nome da filial Mensagem do autorizador a ser exibida junto com o menu de valores (Se o terminal permitir) Valor selecionado através de menu Código do serviço Valor do serviço Menu de Produtos Nosso número Valor total do produto contendo o separador decimal (“.”) e duas casas decimais após a vírgula. Código do Produto . contendo 2 dígitos decimais porém sem o caractere decimal. 1: Total Número de identificação da fatura.CB Indica se permite pagamento com cartão CB Valor da Transferência Identificação da transação Pin Code Data de Entrada do Veículo – Estapar Data de Saída do Veículo – Estapar Hora de Entrada do Veículo – Estapar Hora de Saída do Veículo – Estapar Tipo de Cliente (1: Rotativo.CB Tipo do documento do Portador .Campo usado pelo Ticket Car (Chile) Nome Atividade Giro . 2013 33 .Estapar Vigência Final – Estapar Flag Interna.Campo usado pelo Ticket Car (Chile) Comuna .. Pré-pago) Código Atividade Giro . Tipo do cartão Lido Status da última leitura do cartão Código do atendente RUT .Estapar Software Express Ltda.Estapar Número do Dispositivo .CB Tipo do Extrato – CB Valor limite de Transferência .CB Valor limite para coleta de CPF/CNPJ – CB CPF/CNPJ do Proprietário – CB CPF/CNPJ do Portador – CB Tipo do documento do Proprietário . Pós-pago).CB Sequencia Cartão – CB Via Cartão . 2 (Débito. 2: Mensalista) – Estapar Número da Sucursal – Estapar Número da Apólice – Estapar Número do Item .Campo usado pelo Ticket Car (Chile) Indica se foi transação offline : 1 : Sim Tipo do cartão Combustível : 1 (Crédito.Campo usado pelo Ticket Car (Chile) Senha temporária Código Produto Hopi-Hari Descrição Produto Hopi-Hari Quantidade Máxima de produtos Hopi-Hari Produtos Hopi-Hari Valor da tarifa da Recarga de Celular Número da parcela (2 caracteres) (Hotcard) Seqüencial da transação (6 caracteres) (Hotcard) Rodapé do comprovante da via estabelecimento Código do Depositante – CB Código do Cliente .Especificação Técnica – 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 Versão: 120 Data: 29/04/2013 Cancelamento Total/Parcial : 0: Parcial.Estapar Chassi do Veículo – Estapar Número da SUSEP . dll 8000 a 9999 Campos reservados * Campos utilizados em um ou mais produtos. 1 = CRO) 4034 Dados do Resgate . 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 .. em centavos – PBM Número do lote gerado pela Central – PBM Valor total a receber da loja – PBM Valor total a receber da loja – PBM Soma dos valores da Operação – PBM Nome da operadora – PBM Nome da empresa conveniada – PBM Quantidade de dependentes – PBM Código do dependente – PBM Nome do dependente – PBM Valor a receber do conveniado – PBM Valor do desconto total. Assume os seguintes valores: Conteúdo (em Buffer) A AN LN N Vx S M Mc Descrição Alfabético Alfanumérico (ans) Letras não acentuadas e números Numérico Valor com x casas decimais Sim/Não Menu Menu com confirmação Indica que foi efetuada uma transação de débito para pagamento de carnê Status da Pré-Autorização – PBM CRF – PBM UF do CRF – PBM Tipo de venda – PBM Valor total PBM Valor a vista PBM Valor cartão PBM Nosso número PBM Percentual de desconto concedido pela administradora (2 casas decimais) Preço bruto – PBM Preço líquido – PBM Valor a receber da Loja. em centavos . Normalmente é acompanhado do comando zero (0 – retorno de valor para uso pela automação). em centavos Valor liquido total.Especificação Técnica – Interface com os meios de pagamento do SiTef Bibliotecas CliSiTefI e CliSiTef 2355 Versão: 120 Data: 29/04/2013 Quando retornado.Bônus Campos reservados para uso da IntPos.PBM Código da Operadora Selecionada PBM (deverá ser gravado para posterior envio nas demais transações) 4032 Campo de retorno de dados livres referentes às transações PBM. atua como uma “dica” para o formato do próximo campo que será coletado. 4033 Tipo de documento PBM (0 = CRM. Software Express Ltda. a impressão de qualquer comprovante deve ser feita no momento que eles forem disponibilizados para a automação e a informação de se eles foram impressos corretamente ou não é passada pela função ContinuaFuncaoSiTefInterativo através do valor 0 ou -1. respectivamente. existem campos que somente são retornados se a transação foi aprovada. Notar que a forma correta de ignorar estes campos é executar a função definida em ProximoComando ou simplesmente ignorar o dado retornado para a aplicação quando ProximoComando for 0. O aplicativo de automação deve ignorar aqueles campos que não desejar/não souber tratar uma vez que. Já no caso do Correspondente Bancário ou das Funções Administrativas. Cabe a automação comercial memorizar os comprovantes para impressão na hora apropriada. novos campos poderão ser disponibilizados. 2013 35 .Especificação Técnica – Interface com os meios de pagamento do SiTef Bibliotecas CliSiTefI e CliSiTef Versão: 120 Data: 29/04/2013 Note que nem todos os campos são retornados em todas as transações. Software Express Ltda. colocado em Continua. Além disso. em versões futuras da CliSiTef. segundo a legislação Fiscal vigente.. 3 Tabela de Eventos. Outros eventos Início de uma transação do tipo Correspondente Bancário. a CliSiTef pode informar a ocorrência de determinados eventos. retornados também em TipoCampo Versão: 120 Data: 29/04/2013 Durante a transação. Estes eventos são retornados no parâmetro TipoCampo da rotina ContinuaFuncaoSiTefInterativo ou ContinuaFuncaoSiTefInterativoA. 5501 Software Express Ltda. 2013 36 ..3. 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 Descrição Eventos de coleta Indica que a biblioteca está aguardando a leitura de um cartão Indica que a biblioteca está esperando a digitação da senha pelo usuário Indica que a biblioteca está esperando a digitação dos dados de confirmação positiva pelo usuário Indica que a biblioteca está aguardando a leitura do bilhete único Indica que a biblioteca está aguardando a remoção do bilhete único Indica que a transação foi finalizada Confirma Dados Favorecido SiTef Conectado SiTef Conectando Consulta OK Colher Assinatura Coleta Novo Produto Confirma Operação Confirma Cancelamento Confirma Valor Total Conclusão de Recarga de Bilhete Único Reservado Aguardando leitura de cartão Aguardando digitação da senha no PinPad Aguardando processamento do chip Aguardando remoção do cartão Aguardando confirmação da operação Atualização de tabelas. O conteúdo deste campo varia de acordo com a transação sendo realizada.Especificação Técnica – Interface com os meios de pagamento do SiTef Bibliotecas CliSiTefI e CliSiTef 3. por valor Interface Interface Descrição padrão ASCII Não usado Fixo 6 Contém o resultado de resposta à chamada da rotina short char * char * char * Indica se a transação deve ser confirmada (1) ou estornada (0) Máx. por valor Entrada. por valor Entrada. 20 Número do Cupom Fiscal correspondente à venda Fixo 8 Fixo 6 Data Fiscal no formato AAAAMMDD Horário Fiscal no formato HHMMSS Fixo 1 Software Express Ltda. HoraFiscal).Especificação Técnica – Interface com os meios de pagamento do SiTef Bibliotecas CliSiTefI e CliSiTef 3. DataFiscal. void FinalizaTransacaoSiTefInterativo (Confirma. Parâmetro Resultado Confirma CupomFiscal DataFiscal HoraFiscal Tipo Saída. por valor Entrada. HoraFiscal). CupomFiscal. CupomFiscal.. Confirma. Esta função também deve ser utilizada para desfazer uma transação interrompida por uma queda de energia ou qualquer outro problema no aplicativo. DataFiscal. Essa rotina confirma ou cancela TODOS os meios de pagamento vinculados ao Número do Cupom Fiscal passado como parâmetro. Interface ASCII FinalizaTransacaoSiTefInterativoA (Resultado. por valor Entrada. Recebe também os campos que permitem identificar a transação que está sendo finalizada.4 Confirmação ou não do Pagamento Versão: 120 Data: 29/04/2013 Rotina chamada pelo aplicativo para fechar o ciclo transacional. 2013 37 . Ela deve ser acionada no momento que o comprovante Fiscal for fechado e recebe como parâmetros um indicador de se a transação foi concretizada ou se deve ser estornada. disponibilizada apenas para aplicações de automação que a necessitem. 2013 38 .. Software Express Ltda.Especificação Técnica – Interface com os meios de pagamento do SiTef Bibliotecas CliSiTefI e CliSiTef 3. Recomenda-se que ela possua no máximo 32 caracteres de forma a ser compatível com os PinPad’s existente atualmente em campo Para apagar a mensagem e deixar o visor em branco é só chamar essa função passando o campo Mensagem vazio. -1  biblioteca de acesso ao PinPad não encontrada. por valor Interface Inteface Descrição padrão ASCII Não usado Fixo 6 Contém o resultado de resposta à chamada da rotina char * Variável Mensagem a ser apresentada no visor do PinPad. por valor Entrada. É responsabilidade da aplicação. O formato de ativação da rotina é o seguinte: long EscreveMensagemPermanentePinPad (Mensagem) Interface ASCII EscreveMensagemPermanentePinPadA (Resultado. permite verificar se existe um PinPad conectado na porta serial destinada a ele e se ele está operacional. 0  Não existe um PinPad conectado ao micro. incluir o caractere ‘|’ (Barra em pé) para indicar uma mudança de linha.5 Teste da presença de PinPad Versão: 120 Data: 29/04/2013 Essa função. outro número  erros detectados internamente pela rotina ou pela biblioteca de acesso ao PinPad 3. A forma de chamada desta função é a seguinte: long VerificaPresencaPinPad (void) A rotina não tem parâmetros de entrada e no retorno a rotina devolve um dos seguintes valores: 1  Existe um PinPad operacional conectado ao micro. Mensagem) Parâmetro Resultado Mensagem Tipo Saída.6 Define mensagem permanente para o PinPad Permite que seja definida uma mensagem permanente para ser apresentada no PinPad durante o tempo que ele não está em uso. se desejado. . O formato de ativação é o seguinte: long LeTrilha3 (Mensagem) Parâmetro Resultado Mensagem Tipo Saída. IMPORTANTE: Esta função NÃO pode ser utilizada durante a execução do laço ContinuaFuncaoSiTefInterativo. O aplicativo obtém as trilhas através da chamada a função de continuação do processo interativo. cartão de supervisor).7 Leitura da trilha 3 do cartão Versão: 120 Data: 29/04/2013 Esta função permite que o aplicativo capture uma trilha 3 magnética genérica. Não deve ser utilizada para tratamento das transações de pagamento mas apenas para leitura de cartões internos do estabelecimento comercial (p/ex. por valor Interface Interface Descrição padrão ASCII Não usado Fixo 6 Contém o resultado de resposta à chamada da rotina char * Variável Mensagem a ser apresentada no visor do PinPad No retorno a rotina devolve os mesmos valores que a rotina de pagamento.Especificação Técnica – Interface com os meios de pagamento do SiTef Bibliotecas CliSiTefI e CliSiTef 3. Software Express Ltda. por valor Entrada. 2013 39 . Note que o PinPad deve ter suporte para a leitura da trilha 3. caso exista. TipoCampoTrilha1. a Trilha 1 lida Fixo 12 Indica o tipo de campo que foi retornado na trilha 2.. se ele é mascarado. Trilha1. Fixo 12 Software Express Ltda. Para esse tipo de situação existem as versões que fazem o acesso direto a leitora de cartão descritas a seguir.cha no SiTef. Os campos retornados no processo interativo são os referentes aos campos sensíveis (2021 a 2046). Trilha2. por valor TipoCampoTrilh Saída. criptografado ou em Hash. a2 por valor Interface Interface Descrição padrão ASCII Não usado Fixo 6 Contém o resultado de resposta à chamada da rotina char * char * char * char * Variável Mensagem a ser apresentada no visor do PinPad Indica o tipo de campo que foi retornado na trilha 1. 128 No retorno contém. criptografado ou em Hash. Trilha1. Máx. por valor Mensagem Entrada. 2013 40 . TipoCampoTrilha2.rotinas de captura segura Versão: 120 Data: 29/04/2013 Os rotinas seguintes têm seu funcionamento condicionado a configuração do arquivo com extensão . int LeCartaoDiretoSeguro (Mensagem. caso a configuração não esteja feita. Timeout) Parâmetro Resultado Tipo Saída. TipoCampoTrilha1. essas funções retornam o erro MODO_SEGURO_NAO_ATIVO (12). long LeCartaoSeguro (Mensagem) Interface ASCII LeCartaoSeguroA (Resultado. Trilha2. a1 por valor Trilha1 Saída.Especificação Técnica – Interface com os meios de pagamento do SiTef Bibliotecas CliSiTefI e CliSiTef 3. Mensagem. por valor Entrada. TestaCancelamento) Interface ASCII LeCartaoDiretoSeguroA (Resultado. se ele é mascarado. por valor Interface Interface Descrição padrão ASCII Não usado Fixo 6 Contém o resultado de resposta à chamada da rotina char * Variável Mensagem a ser apresentada no visor do PinPad No retorno a rotina devolve os mesmos valores que a rotina de pagamento. Timeout. TipoCampoTrilha2.8 Leitura do cartão . por valor TipoCampoTrilh Saída. IMPORTANTE: Essas funções NÃO podem ser utilizadas durante a execução do laço ContinuaFuncaoSiTefInterativo. Mensagem) Parâmetro Resultado Mensagem Tipo Saída. O aplicativo obtém as trilhas através da chamada a função de continuação do processo interativo. a Trilha 2 lida Fixo 6 Define o tempo máximo de espera pela passagem do cartão em segundos. os códigos de erro retornados são: Valor 0 1 2 3 4 5 6 7 Descrição Não ocorreu erro Campo de saída insuficiente BIN não aceito CNPJ inválido Chave de acesso vencida Versão inválida Chave de criptografia inválida Dados não criptografados com a chave fornecida como parâmetro: a decriptografia resultou em um número de cartão que não é composto só por dígitos. 203x para o Hash dos campos e 204x para campos criptografados. respeitando o valor estabelecido para os campos sensíveis. com 202x para campos abertos mascarados. Para esta rotina específica. por valor char * short Versão: 120 Data: 29/04/2013 Máx.. TipoCampo 202x Campos abertos. espera até que o cartão seja passado Rotina da aplicação de automação que retorna 0 se é para continuar aguardando pelo cartão e 1 caso deva interromper o processo de aguardar a passagem do cartão TestaCancela mento Rotina Não 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 interrupção.Especificação Técnica – Interface com os meios de pagamento do SiTef Bibliotecas CliSiTefI e CliSiTef Trilha2 Timeout Saída. 64 No retorno contém. mascarados. 203x Hash dos campos 204x Campos criptografados x 1 2 3 4 5 Descrição Campo PAN do cartão Vencimento do cartão Nome do Cliente Trilha 1 Trilha 2 Software Express Ltda. 2013 41 . por valor Entrada. caso exista. Se zero. 8 Dado de entrada inválido Os campos TipoCampoTrilha1 e TipoCampoTrilha2 indicam o tipo de campo retornado. por valor Entrada. ser utilizada para captura de senhas dos cartões tradicionais. a CliSiTef poderá interagir com o SiTef para obter ou validar os dados de segurança necessários para a captura No retorno a rotina devolve os mesmos valores que a rotina de pagamento. O formato de ativação é o seguinte: long LeSenhaInterativo (Parametros) Interface ASCII LeSenhaInterativoA (Resultado. SenhaCliente) Parâmetro Resultado Parametros Tipo Saída. Parametros) Parâmetro Resultado Parametros Tipo Saída. IMPORTANTE: Essas funções NÃO podem ser utilizadas durante a execução do laço ContinuaFuncaoSiTefInterativo. Neste caso.9 Leitura de senha Versão: 120 Data: 29/04/2013 Esta função permite que o aplicativo capture no PinPad uma senha de um cliente de cartão do próprio estabelecimento comercial (cartão proprietário).Especificação Técnica – Interface com os meios de pagamento do SiTef Bibliotecas CliSiTefI e CliSiTef 3. long LeSenhaDireto (Parâmetros. por valor Interface Interface Descrição padrão ASCII ----Fixo 6 Contém o resultado de resposta à chamada da rotina char * Fixo 64 Dados gerados por uma biblioteca de segurança fornecida pela Software Express para habilitar a captura da senha do cliente Senha do cliente.. 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 usuário. por valor Saída. Para esse tipo de situação existem as versões que fazem o acesso direto a leitora de senhas descritas a seguir. Parâmetros. Software Express Ltda. em nenhuma hipótese. 2013 42 . por valor Entrada. SenhaCliente) Interface ASCII LeSenhaDiretoA (Resultado. O aplicativo obtém a senha através da chamada a função de continuação do processo interativo. Não deve. por valor Entrada. em formato criptografado. por valor Interface Interface Descrição padrão ASCII Não usado Fixo 6 Contém o resultado de resposta à chamada da rotina char * Fixo 64 Dados gerados por uma biblioteca de segurança fornecida pela Software Express para habilitar a captura da senha do cliente. Software Express Ltda.. o controle de execução somente volta para a aplicação após o pressionamento da tecla. Mensagem) Parâmetro Resultado Mensagem Tipo Saída. 2013 43 .10 Leitura de Confirmação pelo Cliente no PinPad Versão: 120 Data: 29/04/2013 Estas funções permitem que o aplicativo solicite uma confirmação no PinPad. por valor Entrada. O formato de ativação é o seguinte: long LeSimNaoPinPad (Mensagem) Interface ASCII LeSimNaoPinPadA (Resultado.Especificação Técnica – Interface com os meios de pagamento do SiTef Bibliotecas CliSiTefI e CliSiTef 3. por valor Interface Interface Descrição padrão ASCII Não usado Fixo 6 Contém o resultado de resposta à chamada da rotina char * Variável Mensagem a ser apresentada no visor do PinPad No retorno a rotina devolve 0 se o cliente pressionou a tecla de Cancelamento. Notar que essa função não é interativa ou seja. 1 se ele pressionou a tecla de Confirmação e outro valor em caso de erro no acesso ao PinPad. Especificação Técnica – Interface com os meios de pagamento do SiTef Bibliotecas CliSiTefI e CliSiTef 3.11 Correspondente Bancário (Pagamento de Contas) Versão: 120 Data: 29/04/2013 Esta função permite que o aplicativo de automação aceite o pagamento de contas diversas de acordo com o contrato firmado entre ele e um Banco Correspondente. O formato de ativação desta funcionalidade é o seguinte: long CorrespondenteBancarioSiTefInterativo (CupomFiscal, DataFiscal, Horario, Operador, ParamAdic) Interface ASCII CorrespondenteBancarioSiTefInterativoA (Resultado, CupomFiscal, DataFiscal, Horario, Operador, ParamAdic) Onde os parâmetros possuem a mesma função já descrita para o Pagamento. A lógica de funcionamento desta função é a mesma no pagamento de uma compra feita pelo cliente ou seja, deve-se chamar a função ContinuaFuncaoSiTefInterativo até que o resultado seja diferente de 10000. Essa função, dada a diversidade de produtos ofertados pelos Bancos Correspondentes pode, inclusive, executar uma operação de TEF para concretizar o pagamento de uma conta. Notar que os campos de retorno 600 a 604 retornam diversas vezes, uma para cada título ou convênio pago, no caso de pagamento em lote. O campo 607 indica qual o índice (seqüência) de pagamento ao qual se referem os campos 600 a 604 que virão a seguir. Como já descrito anteriormente, para o Correspondente Bancário os comprovantes devolvidos nos campos tipo 121 e 122 devem ser impressos no momento que forem disponibilizados para a automação e a continuação do processo interativo deve seguir normalmente caso não ocorra erro na impressão ou interrompida com -1 caso contrário. No ParamAdic pode ser passado: {PortaPinPadCB=<porta>}, em que <porta> indica a porta em que está conectado o pinpad especifico para transações de Correspondente Bancário: consulta saldo, saque e recarga celular Bradesco. Software Express Ltda., 2013 44 Especificação Técnica – Interface com os meios de pagamento do SiTef Bibliotecas CliSiTefI e CliSiTef 3.12 Verificação da integridade de um código em barras Versão: 120 Data: 29/04/2013 Permite, na coleta manual dos campos presentes em um código em barras, que o aplicativo faça a validação a medida que os campos estão sendo digitados, de forma a alertar o operador antecipadamente e permitir que ele corrija o erro. O formato de ativação da rotina é o seguinte: long ValidaCampoCodigoEmBarras (Dados, Tipo) Interface ASCII ValidaCampoCodigoEmBarrasA (Resultado, Dados, Tipo) Parâmetro Resultado Dados Tipo Interface Interface Descrição padrão ASCII Saída, Não usado Fixo 6 Contém o resultado de resposta à chamada da rotina por valor conforme descrito a seguir Entrada, char * Variável Dados coletados até o momento. Cada campo deve por valor estar concatenado ao seguinte Saída, short * Fixo 6 Informa o tipo do documento coletado segundo a por seguinte codificação: referência -1  Ainda não foi possível definir o tipo 0  Arrecadação 1  Título Tipo Recomendação: É recomendável que aplicação 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 Compensação/Titulo/Bloqueto ou Ficha de Arrecadação/Tributos. Essa identificação pode ser feita mediante uma pergunta ao operador ou através da rotina aqui descrita. Se o usuário optar pelo reconhecimento automático ele deve abrir um campo como se fosse de Arrecadação e, a cada digito fornecido pelo operador, passar os dígitos já fornecidos para a rotina. Esse procedimento deve ser feito até o momento que a rotina devolver se o documento em questão é um Título ou Arrecadação. Nesse momento a aplicação não precisa mais chamar a rotina a cada dígito fornecido e deve, se necessário, modificar a formatação dos campos para captura. Software Express Ltda., 2013 45 Especificação Técnica – Interface com os meios de pagamento do SiTef Bibliotecas CliSiTefI e CliSiTef Versão: 120 Data: 29/04/2013 Além da identificação do tipo do documento a rotina faz a consistência dos dígitos verificadores, retornando para aplicação se existe um erro e onde ele está localizado. A aplicação pode chamar a rotina passando os campos à medida que eles forem sendo coletados ou no final da coleta, onde será feita uma análise global do conteúdo digitado. Se a chamada for durante a digitação, os pontos corretos são: - Arrecadação: a cada um dos 4 blocos de digitação - Títulos: a cada grupo de dois blocos de digitação No retorno a rotina devolve 0 se tudo estiver correto até o momento, -1 se for um código em barras não reconhecido ou um número de 1 a 4 indicando qual o campo está incorreto ou ainda o valor 5 para indicar que o número como um todo não está correto. Exemplificamos a seguir como a aplicação do terminal deveria proceder, na forma mais genérica possível hoje em dia, para coletar um documento. No exemplo utilizaremos um título e deixaremos a automação 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 automação 2 Após a digitação do primeiro número chama a rotina passando “2” como parâmetro. No retorno a rotina devolveu o resultado 0 e Tipo = 0 (fictício pois nesse momento, para a configuração atual de códigos em barra, ela já teria feito a identificação) 23 Após a digitação do primeiro número chama a rotina passando “23” como parâmetro. No retorno a rotina devolveu o resultado 0 e Tipo = 1 23790 09505 A automação reapresenta os campos já sabendo que é um título. Somente após a digitação do primeiro grupo de números ela chama a rotina passando “2379009505” como parâmetro. 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 automação continua a coletar os dígitos e somente após a digitação do segundo grupo de números ela chama a rotina passando “237900950591211369656” como parâmetro. No retorno a rotina continua a devolver Tipo = 1. Já o resultado poderá ser 0, indicando que os blocos estão corretos ou 1 ou 2 indicando que o primeiro ou o segundo bloco está errado.. Software Express Ltda., 2013 46 Especificação Técnica – Interface com os meios de pagamento do SiTef Bibliotecas CliSiTefI e CliSiTef Versão: 120 Data: 29/04/2013 23790 09505 91211 369656 04025 039209 1 17690000005625 A automação continua a coletar os dígitos 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 situação de erro ou não dos blocos passados como parâmetro. Em particular, se retornar o código 5 é porque existe algum dos blocos (não é possível identificar qual deles) com erro. Finalizando, a automação também pode para efeito de consistência do código em barras optar por conferi-los apenas no final da digitação 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 situação dos blocos internos estarem certos mas o número como um todo possui algum erro. Software Express Ltda., 2013 47 int ObtemVersao (VersaoCliSiTef. VersaoCliSiTefI) Interface ASCII ObtemVersaoA (Resultado. CupomFiscal) Interface ASCII ObtemQuantidadeTransacoesPendentesA (Resultado. int ObtemQuantidadeTransacoesPendentes (DataFiscal. 3. DataFiscal. VersaoCliSiTefI) Parâmetro Resultado VersaoCliSiTef VersaoCliSiTefI Tipo Saída. 64 No retorno contém. caso exista.14 Obtendo Versão Esta função é utilizada pelo terminal para obter as versões da CliSiTef e CliSiTefI. VersaoCliSiTef. por valor Saída.13 Verificação da quantidade de transações pendentes de confirmação no terminal Esta função é utilizada pelo terminal para saber quantas transações foram realizadas em caso de queda de energia. Software Express Ltda. CupomFiscal) Parâmetro Resultado DataFiscal CupomFiscal Tipo Saída.. 2013 48 . por valor Interface Interface Descrição padrão ASCII Não usado Fixo 6 Contém o resultado de resposta à chamada da rotina char * Máx.Especificação Técnica – Interface com os meios de pagamento do SiTef Bibliotecas CliSiTefI e CliSiTef Versão: 120 Data: 29/04/2013 3. por valor Interface Interface Descrição padrão ASCII Não usado Fixo 6 Contém o resultado de resposta à chamada da rotina char * char * Fixo 8 Data Fiscal no formato AAAAMMDD Máx. por valor Entrada. a versão da CliSiTefI No retorno a rotina devolve 0 quando foi executada com sucesso e diferente no caso de erro. 64 No retorno contém a versão da CliSiTef char * Máx. 20 Número do Cupom Fiscal correspondente à venda O retorno da rotina é a quantidade de transações pendentes para o cupom fiscal. por valor Saída. por valor Entrada. basta utilizar a seguinte função: int ObtemInformacoesPinPad (InfoPinPad) Parâmetro InfoPinPad Tipo Saída. por valor Interface Descrição padrão char * No retorno contém as informações do PinPad Em caso de sucesso. dados de confirmação.0605013001. a CliSiTef enviará automaticamente eventuais dados remanescentes (por exemplo.Especificação Técnica – Interface com os meios de pagamento do SiTef Bibliotecas CliSiTefI e CliSiTef 3.15 Descarregando Mensagens Versão: 120 Data: 29/04/2013 Em situações de falha de comunicação com o servidor SiTef. 03 para a Versão do software básico/firmware. Exemplo: 01006GERTEC02010PPC900. a automação pode utilizar a seguinte rotina para forçar a biblioteca a descarregar mensagens de confirmação. pode levar algum tempo até que a próxima transação seja iniciada na estação. Nos momentos em que o PDV está no estado repouso ou “idle”. não confirmação e desfazimento para o SiTef. 04 Versão da especificação compartilhada 05 para a Versão da aplicação básica. 3 caracteres numéricos que indicam o tamanho em caracteres da informação..23 100820060160450805232030714 Software Express Ltda.16 Informações do PinPad Para obter informações básicas sobre o PinPad conectado no PDV. os dados serão retornados no seguinte formato: 2 caracteres numéricos que indicam a informação obtida sendo: 01 para o Nome do fabricante. 3. 2013 49 .3MB030190077_0071_0080_0106040041. 06 para o Número de série. 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. não-confirmação e desfazimento) somente na próxima transação do PDV. 02 para o Modelo / versão do hardware. Porém. N (conforme tamanho acima) caracteres alfanuméricos com a informação. como velocidade (BAUD).ini ou CLSIT A CliSiTef utiliza um arquivo no formato . bits de dados. 2013 50 . paridade e bit de parada não são configuráveis. Por exemplo: /dev/ttyS1 ou /dev/ttyACM0 Observação: outros parâmetros. 4. Arquivo de configurações CliSiTef. deve-se indicar o caminho completo do device. Ao longo deste documento. campo Porta. campo MensagemPadrao.ini. e deve ser colocado na mesma pasta da biblioteca CliSiTef.ini.1.1 Configuração do PinPad 4. Este arquivo se chama CliSiTef. todas as menções para CliSiTef.2 Definição da mensagem padrão É possível inicializar o PinPad com uma mensagem de até 16 caracteres. deve-se usar o formato COMn. Em equipamentos POS. Software Express Ltda. o arquivo de configuração utilizado é CLSIT.Especificação Técnica – Interface com os meios de pagamento do SiTef Bibliotecas CliSiTefI e CliSiTef Nome do fabricante : GERTEC Modelo / versão do hardware : PPC900.06 Versão da aplicação básica : 001. A seguir descreveremos algumas funcionalidades macro presentes neste arquivo. [PinPadCompartilhado] Porta=<PORT> No Windows. 4. onde n é o número da porta serial/usb.1. Esta mensagem é configurada na seção PinPad.3MB Versão do software básico/firmware : 0077_0071_0080_0106 Versão da especificação : 1. Por exemplo: COM12 No Linux..ini devem ser entendidas como CLSIT quando se tratar de POS. já prevendo a possibilidade de serem incluídas novas informações de pinpad. de modo a definir previamente determinadas configurações na estação.1 Configuração da porta A porta serial/usb do PinPad é configurada na seção PinPadCompartilhado. 4.23 100820 Número de série : 0450805232030714 Versão: 120 Data: 29/04/2013 Observação: o Buffer que receberá as informações do PinPad deve possuir tamanho mínimo de 256 caracteres. Especificação Técnica – Interface com os meios de pagamento do SiTef Bibliotecas CliSiTefI e CliSiTef [PinPad] MensagemPadrao=<MENSAGEM> Versão: 120 Data: 29/04/2013 É possível quebrar em duas linhas. 2013 51 .. utilizando o separador ‘|’. Software Express Ltda. [SiTef] PortaSiTef=<porta> 4.168. Em situações de autorizador indisponível. acrescentando ainda uma margem de segurança sobre eventuais tempos gastos na transmissão. São permitidos no máximo dois endereços adicionais. Estes endereços são complementares ao informado na função de configuração. basta incluir o item TempoAdicionalEspera na seção SiTef..0. A CliSiTef leva em consideração estes valores. Por exemplo. Para especificar uma nova porta. podendo ocorrer erros do tipo “Sem conexão com o servidor SiTef”.2 Configuração de conexão com o servidor SiTef Versão: 120 Data: 29/04/2013 4.1:4096.192.0. e dependendo do canal de comunicação entre o servidor SiTef e a CliSiTef. 2013 52 .1 Configuração de endereços IP adicionais No arquivo de configuração é possível adicionar endereços alternativos para o SITEF.2.1:5096 4. alguma restrição de segurança na rede do cliente. Por exemplo: EnderecoIP=127. pode ser necessário alterar a porta de comunicação com o servidor SiTef. deve-se incluir na seção SiTef o campo PortaSiTef.IP2 Também é possível informar a porta do servidor. [SiTef] EnderecoIP=IP1. quando o correto seria “Serviço do autorizador indisponível”. esta margem pode ser insuficiente. Para incluir um tempo adicional em segundos. sem segundos> Software Express Ltda. no formato IP:Porta.2 Configuração da porta do servidor SiTef Em raras situações.3 Tempo adicional para timeout Normalmente a CliSiTef recebe parâmetros de timeout com o servidor SiTef. A porta padrão do servidor SiTef é 4096.2. [SiTef] TempoAdicionalEspera=<tempo adicional para timeout.Especificação Técnica – Interface com os meios de pagamento do SiTef Bibliotecas CliSiTefI e CliSiTef 4.2.0. [SiTef] ConexaoObrigatoria=1 4..2..”.4 Obrigatoriedade de conexão Por padrão.2. basta incluir na seção Geral o campo MostradorComunicacaoHabilitado com valor zero. 2013 53 . mesmo sem a conexão com o SiTef. Neste caso. Para desabilitar o mostrador de comunicação. as transações na CliSiTef tentam avançar ao máximo. não havendo conexão com o SiTef a transação será encerrada com erro -5. em processamento. inclua na seção SiTef o parâmetro ConexaoObrigatoria com valor um (1).5 Configuração do mostrador de comunicação Por padrão. [Geral] MostradorComunicacaoHabilitado=0 Software Express Ltda.. a clisitef envia para a automação o comando 3 com uma mensagem do tipo “Aguarde. e exigir a obrigatoriedade de conexão. Para retirar este comportamento.Especificação Técnica – Interface com os meios de pagamento do SiTef Bibliotecas CliSiTefI e CliSiTef Versão: 120 Data: 29/04/2013 4. O formato desse campo é o seguinte: [<Tipo do meio de pagamento>. 5. Um exemplo disso é um estabelecimento comercial onde todas as vendas somente podem ser feitas à vista. onde cada um dos sub-campos possui a mesma descrição do item anterior. Isso é feito através do parâmetro “ParamAdic” presente nas funções que inicial o processo de pagamento ou Correspondente Bancário (IniciaFuncaoSiTefInterativo e CorrespondenteBancarioSiTefInterativo). caso o lojista opte no futuro a aceitar outras modalidades de pagamento. 2013 54 .28.<Tipo do meio de pagamento>. O formato desse parâmetro é o seguinte: [Geral] TransacoesHabilitadas=<Tipo do meio de pagamento>... Consulte a Tabela de códigos de meios de pagamento.. Restrição ou habilitação das formas de pagamento 5.1 Restrição durante o processo de finalização de uma venda Versão: 120 Data: 29/04/2013 A biblioteca CliSiTef permite que o aplicativo de automação restrinja as modalidades de pagamento disponíveis ao operador de caixa/cliente para uma determinada venda. onde cada um dos sub-campos contém um código numérico que identifica o item de menu que não se aplica à venda em questão.19.17.27.Especificação Técnica – Interface com os meios de pagamento do SiTef Bibliotecas CliSiTefI e CliSiTef 5.<Tipo do meio de pagamento>. sem ser necessário alterar o aplicativo de automação. Utilizando o mesmo exemplo do item anterior. se durante o processo de venda já foi negociado com o cliente que é uma venda para pagamento única e exclusivamente com cartão a vista. configurações e menus para a lista de códigos nesta configuração.2 Restrição de forma definitiva Neste caso o ambiente de vendas do cliente não comporta determinado tipo de modalidade de pagamento por não se aplicar ao seu ramo de negócio..18. a definição será: [Geral] TransacoesHabilitadas=16.. basta alterar a configuração da CliSiTef.]...26 Software Express Ltda.].35. Por exemplo.ini. Para esse tipo de aplicação é possível definir essa configuração no arquivo de parâmetros da CliSiTef de forma que. Essa configuração é feita através do parâmetro TransacoesHabilitadas a ser colocado na seção [Geral] do arquivo CliSiTef. o valor do parâmetro deve ser: [10. para limitar as transações apenas as de pagamento à vista e sem cheque.34. sendo necessário que o cliente informe explicitamente que deseja utilizá-las. O formato desse parâmetro é o seguinte: [Geral] TransacoesAdicionaisHabilitadas=<Tipo do meio de pagamento>. existem algumas formas de pagamento que não estão habilitadas por padrão.ini pelo parâmetro TransacoesAdicionaisHabilitadas a ser incluído na seção [Geral].Especificação Técnica – Interface com os meios de pagamento do SiTef Bibliotecas CliSiTefI e CliSiTef 5. Consulte a Tabela de códigos de meios de pagamento. Onde cada um dos sub-campos possui a mesma descrição dos itens anteriores..... configurações e menus para a lista de códigos nesta configuração. Isso é feito através do arquivo de configuração CliSiTef. Os menus que hoje não estão habilitados por padrão são os seguintes: Cartão Refeição Eletrônico Recarga de celular com cartões de débito ou crédito Pagamento de Benefícios e respectivo estorno Leitora SmartNet para cartões SmartVR e Sodexho com chip Correspondente Bancário Paggo Débito Digitado Extrato CB Consulta Saldo CB Saque e estorno de saque CB Depósito e estorno de depósito CB Recarga de Celular Bradesco Recarga de Celular HSBC Extrato CB Pagamento e Estorno de DARF Pagamento e Estorno de GPS Empréstimo Pré-Aprovado Abertura de Conta Troco Premiado (Surpresa) Vale Gás Opção Administrativa Redecard Software Express Ltda.3 Habilitação de transações adicionais Versão: 120 Data: 29/04/2013 Por questões de compatibilidade com versões anteriores da biblioteca e também pelo fato de algumas funcionalidades da mesma não serem de uso geral. 2013 55 . inclua na seção Geral o campo TransacoesDesabilitadas..ini: [Geral] TransacoesAdicionaisHabilitadas=20 5. é possível desabilitar algumas transações sem a necessidade de especificar todo o intervalo de operações como nas restrições. 5.. Neste caso. Consulte a Tabela de códigos de meios de pagamento. um dos seguintes valores abaixo. para habilitar o menu de pagamento com cartão Refeição Eletrônico deve-se incluir a seguinte configuração em CliSiTef.. deve ser incluída uma linha para cada rede. indicando as transações que serão desabilitadas ao longo do fluxo transacional.ini e que deve conter o nome da variável correspondente a rede a ser habilitada com o valor 1. Note que é possível habilitar tantas redes quanto necessário. por não serem de uso generalizado. existe a seção [Redes] no arquivo de configuração CliSiTef. configurações e menus para a lista de códigos nesta configuração. desde que elas estejam habilitadas no SiTef de forma compatível.5 Habilitação de transações de redes específicas Existem algumas redes que. Rede Accor ACSP Algorix Avista BancoIbi BancoMercantil Software Express Ltda. [Redes] HabilitaRedexxxx=1 Onde xxxx pode ser. [Geral] TransacoesDesabilitadas=<Tipo do meio de pagamento>. não estão automaticamente habilitadas na CliSiTef. 2013 56 .4 Desabilitando transações De forma análoga às transações adicionais habilitadas do item anterior. Para tanto.Especificação Técnica – Interface com os meios de pagamento do SiTef Bibliotecas CliSiTefI e CliSiTef Cartão Combustível Cartão Presente Versão: 120 Data: 29/04/2013 Exemplificando.. para habilitá-las. na presente versão da CliSiTef. Caso o estabelecimento trabalhe com mais de uma rede das descritas a seguir. .Especificação Técnica – 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 Versão: 120 Data: 29/04/2013 57 . . 2013 58 .Especificação Técnica – Interface com os meios de pagamento do SiTef Bibliotecas CliSiTefI e CliSiTef Validata Wappa Tricard TopCard Versão: 120 Data: 29/04/2013 Software Express Ltda. neste caso usar 3014) Voucher Papel Cartão Benefício Cartão SmartVR/Sodexho com leitora SmartNet Cartão de crédito a vista com juros Cartão de crédito (todas as combinações) (Descontinuado.Especificação Técnica – Interface com os meios de pagamento do SiTef Bibliotecas CliSiTefI e CliSiTef 5. Tipo do meio de pagamento Consulta ou garantia de Cheque (todos os tipos) Consulta Cheque Serasa/Associação Comercial Consulta Cheque Tecban Telecheque Garantido Tecban Garantia Cheque Papel Tecban Cartão de débito (todas as combinações) (Descontinuado. configurações e menus Versão: 120 Data: 29/04/2013 A seguir está a tabela que relaciona os tipos de meio de pagamento. 2013 Código 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 . para serem utilizados nos itens anteriores. com os respectivos códigos. não usar) Cartão de débito a vista Cartão de débito pré-datado Cartão de débito parcelado Cartão de débito CDC Cartão Refeição Eletrônico (Exceto Visanet.6 Tabela de códigos de meios de pagamento.. configurações e menus. não usar) Cartão de crédito a vista Cartão de crédito parcelado com financiamento do estabelecimento Cartão de crédito parcelado com financiamento da administradora Cartão de crédito digitado Cartão de crédito magnético Pré-autorização Cartão Fininvest Saque com cartão Fininvest Cartão de Crédito Pró-rata a vista Cartão de Crédito Pró-rata parcelada Consulta parcelas no Cartão de Crédito Crédito Cisa Saldo/Extrato Cisa Cartão Crédito Infocard Cancelamento de transação com cartão de crédito ou débito Consulta AVS Débito Digitado Débito Magnético Crédito 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. .Corresponde Bancário Consulta de Saldo com Digitação dos Dados da Conta .Corresponde Bancário Estorno de Depósito .Corresponde Bancário Estorno de Saque com Recibo de Retirada .Especificação Técnica – Interface com os meios de pagamento do SiTef Bibliotecas CliSiTefI e CliSiTef Re-impressão de pagamento de conta Pagamento de Benefício Estorno do Pagamento de Benefício Tratamento de troco no pagamento de contas com dinheiro Reimpressão Reimpressão do Último Comprovante Reimpressão Específica Recarga de celular com Dinheiro Recarga de celular com Cheque Recarga de celular com cartão de débito a vista Recarga de celular com cartão de crédito a vista Indica o Menu para seleção da operadora de recarga Reimpressão do lojista Reimpressão do portador do cartão Todas as reimpressões Crédito Centralizado Consulta de Saldo .Corresponde Bancário Saque .Corresponde Bancário Estorno de Saque com Cheque .Corresponde Bancário Estorno de Saque de Benefício INSS .Corresponde Bancário Conta Corrente Conta Poupança Conta Benefício Conta Salário Conta Empresa Conta Investimento Conta Funcionário Viajante Consulta de Saldo com Cartão Magnético .Corresponde Bancário Depósito .Corresponde Bancário Estorno de Depósito com Cheque .CB Saque de Benefício INSS .Corresponde Bancário Estorno de Depósito com Dinheiro .Corresponde Bancário Saque com Cartão Magnético . 2013 60 .Corresponde Bancário Saque com Recibo de Retirada .Corresponde Bancário Estorno de Saque .Corresponde Bancário Saque com Cheque .Corresponde Bancário Estorno de Depósito com Dinheiro + Cheque – CB Consulta Cheque SPC Brasil Garantia Cheque SPC Brasil Tipo Conta: FAL Tipo Conta: Pontos SCCard Consulta Saldo Débito Consulta Saldo Crédito Recarga de Celular Bradesco Versão: 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. .Especificação Técnica – Interface com os meios de pagamento do SiTef Bibliotecas CliSiTefI e CliSiTef Reimpressão Específica Redecard Reimpressão Específica Visanet Troco Surpresa (Premiado) Pagamento em dinheiro Pagamento CB em cheque Pagamento com TEF Débito Pagamento com TEF Crédito Pagamento em outra forma Vale refeição e alimentação Visanet ValeGás ValeGás Ultragaz ValeGás GetNet Pagamento de Conta Orbitall Estorno de pagamento de Conta Orbitall Cartão Combustível Cartão Combustível Digitado Cartão Combustível Magnético Cartão Débito Pré-Pago Consulta Saldo Cartão Débito Pré-Pago Cartão Crédito Código em Barras Cartão Presente Opção Administrativa Redecard Cartão Presente Magnético Cartão Presente Digitado Cartão Presente Código em Barras Opção Compra e Saque Redecard Pagamento de Fatura Pagamento de Convênio 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 Magnético Extrato Digitado Recarga HSBC Saque Crédito Estorno de Saque Crédito Consultas de Cartão de Crédito Extrato Cartão de Crédito Saldo Convênio Crédito Consulta Liberação de Cartão Crédito Consulta Última Fatura de Cartão Crédito Versão: 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 . .Especificação Técnica – Interface com os meios de pagamento do SiTef Bibliotecas CliSiTefI e CliSiTef Altera Senha de Cartão Crédito Libera Cartão de Crédito Produtos SPTrans DARF GPS DARF Simples DARF Preto Estorno DARF Estorno GPS Empréstimo Pré-Aprovado Empréstimo Pré-Aprovado Magnético Empréstimo Pré-Aprovado Digitado Abertura de Conta Conta Individual Conta Conjunta E / OU Conta Conjunta E (Solidária) 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 Cartão EMS Estorno de Pagamento de Conta Cartão EMS Código Resumido EMS Versão: 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 . Cheque a Vista Venda EMS ..Debito em folha Venda EMS – Voucher Venda EMS – Cartão Presente Venda EMS – Private Label Venda Rotativo A Vista Fininvest Venda Rotativo Pré-Datado Fininvest Venda Parcelado Fininvest Venda Parcelado Pré-Datado Fininvest Versão: 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.Cheque Pré Venda EMS – Cartão de Débito Venda EMS – Cartão de Crédito Venda EMS – Ticket Venda EMS – Cheque Administrativo Venda EMS – Traveller Check Venda EMS – Desconto em Folha Venda EMS – Vale Venda EMS .Milhas Venda EMS .Dinheiro Venda EMS .Especificação Técnica – Interface com os meios de pagamento do SiTef Bibliotecas CliSiTefI e CliSiTef Código de Barras do Carnê Digitação do Dados do Carnê Menu de Consultas EMS Consulta Rápida EMS Consulta Extrato EMS Consulta Milhas EMS Consulta Mini-Extrato EMS Registro de Ocorrência EMS Registro de Cancelamento de Ocorrência EMS Inclusão de Cliente EMS Alteração de Dados Cadastrais Cliente EMS Consulta Dados Cadastrais Cliente EMS Transação EMS por Cartão Magnético Transação EMS por Digitação do Cartão Transação EMS por Digitação do CPF Extrato EMS Parcial Extrato EMS Total Sexo Masculino Sexo Feminino Menus de Vendas EMS Venda Cartão 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 Forçada EMS Compra EMS Vinculada a Lista de Presentes Compra EMS Outros Vínculos Venda EMS . 2013 63 . .Especificação Técnica – Interface com os meios de pagamento do SiTef Bibliotecas CliSiTefI e CliSiTef Saque Rotativo Fininvest Saque Parcelado Fininvest Consulta Saque Fininvest Saque Fininvest Boleto Bancário Contrato Pagamento de Conta Fininvest Pagamento de Fatura Fininvest Documento Provincial Documento Não Provincial Com Provimillhas Sem Provimilhas Débito 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 Débito Ajuste de Compra Crédito 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 Refeição (Exceto Visanet) Vale Alimentação (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 Comunicação Transações de Correspondente Bancário Transações de Recarga de Celular Transações SPTrans SCCard Provedor Wappa Abertura de Caixa CB Fechamento de Caixa CB Sangria de Caixa CB Versão: 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 . Especificação Técnica – Interface com os meios de pagamento do SiTef Bibliotecas CliSiTefI e CliSiTef Menu cartão Condor Opção crédito parcelado simples Pagamento cartão Condor Estorno pagamento cartão 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 opção NTPC Menu NTPC Pagamento com saque Recarga de celular com saque Troca de Senha Supervisor PinPad Menu Crédito CDC Opção conta pessoa jurídica 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 acúmulo de pontos Oboé Menu cancelamento acúmulo de pontos Oboé Menu venda crédito com autorização à vista Menu pagamento de conta Qualicard Menu estorno de pagamento de conta Qualicard Menu de autorização genérica SEM Menu pagamento de conta rede Avista Menu cartão 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 cartão presente Algorix Menu de cancelamento de carga de cartão presente Algorix Menu venda crédito CompreMax Menu cancelamento CompreMax Menu cancelamento Cartão Combustível 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 cartão Qualidade (ICI Card) Menu opção Saque Crédito Transferência Menu saque GetNet Versão: 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 . Especificação Técnica – 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 devolução Platco Menu pagamento recarga SPTrans (Menu específico) 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 Cartão Gift Recarga de Cartão Gift Cancelamento de Recarga de Cartão Gift Venda com Cartão Gift Cancelamento de Venda com Cartão Gift Menu Cancelamento Gift Tipo de conta FAL Tipo de conta principal Menu Emissão de Pontos Menu Cancelamento de Emissão de Pontos Menu Resgate de Pontos Menu Cancelamento de Resgate de Pontos (não usado ainda) Menu Opcão Cartão Pré Pago Digitado Menu Pagamento TriCard Menu Extrato Por Período (CB) Menu Extrato – Últimos Lançamentos (CB) Menu Extrato – Últimos Dias (CB) Menu Desbloqueio de Cheques (CB) Menu Opção de Pagamento c/ cartão de Débito CB Menu de Transferência de Contas – CB Menu Revalidação de Senha INSS – CB Menu Depósito Identificado – CB Menu Nome do Depositante (Depósito Identificado CB) Menu Código do Depositante (Depósito Identificado CB) Menu Cartão de Pagamento (Depósito Identificado CB) Menu Pagamento de Fatura (Depósito Identificado CB) Menu opção de Pagamento c/ cartão Digitado (CB) Menu opção de Pagamento c/ cartão Magnético (CB) Menu opção Pagamento de Fatura Digitado (CB) Menu opção Pagamento de Fatura Magnético (CB) Menu Pagamento de Fatura genérico Menu opção Pré Autorização Cartão Combustível Menu Ativação Gift Versão: 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 . Contas Banco Ibi Menu Cartao Eletrozema Menu Cancelamento Cartao Eletrozema Menu Consulta Eletrozema Menu Cancelamento de Pagamento de Fatura genérico Menu formas de pagamento para pagamento de cartão Siscred Versão: 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 .Especificação Técnica – Interface com os meios de pagamento do SiTef Bibliotecas CliSiTefI e CliSiTef Menu Pagamento Dinheiro – Ativação Gift Menu Pagamento Cheque – Ativação Gift Menu Pagamento Cartão Débito – Ativação Gift Menu Pagamento Cartão Crédito – Ativação Gift Menu Pagamento ClubCard Menu Estorno Pagamento ClubCard Menu Pagamento Citibank Menu opção Cartão Porto Seguro Auto Magnético Menu opção Cartão Porto Seguro Auto Digitado Menu Saque ClubCard Menu Pagamento CredMais Menu Consulta parcelas crédito Menu Estorno Pagto.. .<Funcionalidaden>.. Os parâmetros A.D são índices das chaves de criptografia Redecard nos POS’s. Se alguma chave não for configurada é preciso passar o parâmetro HabilitaVendaViaCodigoBarras=1 ItemMenuIdentificado=1 {MKRede=A.} A seguir.{TrataPagamentoExtendido=1. é possível incluir novas funcionalidades e características ao fluxo transacional. Configuração válida somente para CliSiTef Reduzida Redecard.B.35. então o valor do parâmetro “ParamAdic” deve ser: [10. presente nas funções que iniciam o processo de pagamento ou Correspondente Bancário (IniciaFuncaoSiTefInterativo e CorrespondenteBancarioSiTefInterativo).C. ao invés de retornar um erro de comunicação.Especificação Técnica – Interface com os meios de pagamento do SiTef Bibliotecas CliSiTefI e CliSiTef 5.7 Habilitação de configurações especiais por transação Versão: 120 Data: 29/04/2013 Em determinadas transações. a confirmar).0.19. Para inibir este comportamento. descrevemos as funcionalidades previstas neste campo.17.. Exemplo: no processo de venda exemplificado no item 5. basta acrescentar um novo campo ao parâmetro “ParamAdic”.D} OBS: Esta configuração deve ser passada entre chaves ({}) separadamente. O formato deste campo é o seguinte: {<Funcionalidade1>. ou seja. Este parâmetro informa a CliSiTef que a opção de venda crédito através de cartões gravados em código em barras deve ser habilitada na transação corrente.18.1. Esses parâmetros irão sobrepor os índices das chaves recebidos no serviço 3.<Funcionalidade2>.].xxx ExecutaAteLeituraCartao=0 Descrição O conteúdo deste campo será acrescentando ao campo administrativo do SITEF e constará em relatórios do SITEFWEB. a CliSiTef se comporta da seguinte maneira: Se a CliSiTef estiver sem comunicação com o Sitef. O aplicativo de automação informa a CliSiTef que ele está preparado para tratar o comando de menu com itens identificados (comando 42). então..104. Os parâmetros C e D serão implementados somente a partir da versão (4. a CliSiTef continua o fluxo da transação até a leitura do cartão.C. Para tanto. Note que neste formato as funcionalidades estão entre chaves (‘{’ e ‘}’).}. permitindo maior flexibilidade de operação sem que estas funcionalidades não estejam vinculadas a um meio de pagamento específico. Lembrando que além dessa configuração a opção de menu (3025) também deve estar habilitada. utilizar a funcionalidade ao lado. Funcionalidade CodigoCliente= xxx. na maior parte dos menus utilizados na navegação.28. e que o aplicativo da automação deseje fazer seu tratamento.CHA estiver presente no servidor Sitef.1. ao passo que as restrições estão entre colchetes (‘[’ e ‘]’).27.. suponha que o valor da venda possa ser alterado durante o fluxo. 2013 68 .34. não deve ser concatenada com nenhuma Software Express Ltda.B. Quando esse parâmetro está habilitado a CliSiTef substitui a utilização do comando 21 pelo comando 42. Se um arquivo . não deve ser concatenada com nenhuma outra configuração separada por ponto-e-vírgula (. O campo “NumCartaoCripto” é recebido com sucesso se o SiTef. o valor que foi acrescentado à venda deve ser repassado pela automação. Software Express Ltda.B. 2013 69 . exceto que as chaves de criptografia serão usadas para criptografar trilhas. TrataPagamentoExtendido=1 Esta função informa que o aplicativo da automação está preparado para tratar informações 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).) somente a chave relativa à criptografia DUKPT 3DES.2} vai configurar ponto-e-vírgula (. com o cartão criptografado> criptografado. responder os serviços Q13 e Q14 com a chaves de criptografia devidamente configuradas. ValorIncluiTaxa=1 Este parâmetro informa que o aplicativo da automação incluiu no valor compra o valor da taxa de embarque ou serviço. desabilita a sua captura. ValidadeCartao=<AAMM ou A entrega do campo adicional “ValidadeCartao”.-1. o menu administrativo oferecerá somente a opção “Consulta Saque com Saque”. OBS: Esta configuração deve ser passada entre chaves ({}) separadamente. Exemplo: {MKRede=-1. Esta função também habilita o recebimento dos campos 137 (Saldo a ser pago) e 138 (Valor efetivamente recebido). este parâmetro permite vincular. desabilita a captura do número do cartão digitado. TrataConsultaSaqueComSaque=1 Inicialmente projetada para transações do Banco Ibi. com o qual a CliSiTef está conectada. em uma única transação. com a data de MMAA> validade do cartão. 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.D} Igual a MKRede (Ver descrição acima).-1. porém a utilização do valor passado através do parâmetro adicional é condicionada à passagem bem sucedida do campo “NumCartaoCripto”. Caso seja passado este parâmetro..) NumCartaoCripto=<Cartão A entrega do campo adicional “NumCartaoCripto”.Especificação Técnica – Interface com os meios de pagamento do SiTef Bibliotecas CliSiTefI e CliSiTef Versão: 120 Data: 29/04/2013 outra configuração separada por com valor -1. a “Consulta a Saque” e “Saque”.C. RedeDestino=nnnn Esta configuração permite forçar que a transação seja realizada por uma rede específica (nnnn = 4 dígitos numéricos). Se durante o fluxo de captura for solicitada a taxa. ou seja. a pasta padrão utilizada é C:\CliSiTef\ChavesCliSiTef.. No Linux.Especificação Técnica – Interface com os meios de pagamento do SiTef Bibliotecas CliSiTefI e CliSiTef 6. No Windows. Arquivos de controle Versão: 120 Data: 29/04/2013 A CliSiTef permite configurar o diretório onde serão gerados os seus arquivos de controle. Essa configuração deve ser feita pelo item DiretorioBase da seção SalvaEstado no arquivo CliSiTef. 2013 70 .ini. [SalvaEstado] DiretorioBase=<DIRETORIO> Exemplo Windows: [SalvaEstado] DiretorioBase=C:\Chaves Exemplo Linux: [SalvaEstado] DiretorioBase =/home/usuario/chaves Software Express Ltda. a pasta padrão é /tmp/ChavesCliSiTef. Por padrão o trace fica habilitado por cinco dias. 2013 71 . Trace Versão: 120 Data: 29/04/2013 A CliSiTef normalmente grava informações em um único arquivo diário.dmp. Ou seja. altere o arquivo CliSiTef. o arquivo é gravado na pasta local. o arquivo é gravado no padrão C:\CliSiTef\CliSiTef. a pasta padrão para gravação dos arquivos de trace é C:\CliSiTef. Em equipamentos POS. No Linux. 7. A CliSiTef permite configurar os diretórios onde serão gerados os seus arquivos de trace. é possível configurar o número de dias durante os quais o trace será mantido. [GERAL] NumeroDeDiasNoLog=n onde é n é o número de dias. No Linux.ini”.<AAAAMMDD>.1 Configuração do período que o trace é mantido No arquivo de configuração “CliSiTef. o arquivo é gravado na pasta local. Zero grava indefinidamente.ini conforme mostrado abaixo: [CliSiTef] DiretorioTrace=<DIRETORIO> Exemplo Windows: [CliSiTef] DiretorioTrace=C:\Trace Exemplo Linux: [CliSiTef] DiretorioTrace=/home/usuario/trace Software Express Ltda. com mecanismo de rotação de logs. no padrão TRACE. Para tanto. 7.dmp. No Windows..2 Configuração de diretório No Windows.<AAAAMMDD>. arquivos mais antigos são removidos automaticamente. no padrão CliSiTef. é usada a pasta corrente.Especificação Técnica – Interface com os meios de pagamento do SiTef Bibliotecas CliSiTefI e CliSiTef 7. 3 Arquivos de trace por terminal Versão: 120 Data: 29/04/2013 Para facilitar algumas análises.. também é possível alterar a geração do arquivos de trace do modo diário para o modo por hora. em que são gerados diversos arquivos de trace fragmentados por hora. basta adicionar o item TracePorTerminal na seção CliSiTef do arquivo “CliSiTef. [CliSiTef] TracePorTerminal=1 Para habilitar a geração de traces por hora deve ser adicionada a seguinte configuração ao arquivo “CliSitef. Para maiores informações sobre o modo multi-terminal.ini”. é possível configurar a CliSiTef para gerar arquivos de trace por terminal (parâmetro IdTerminal da função ConfiguraIntSiTefInterativo). Além da geração de traces por terminal. Caso não esteja configurada no modo multi-terminal e ainda assim queira habilitar a geração de traces por terminal.Especificação Técnica – Interface com os meios de pagamento do SiTef Bibliotecas CliSiTefI e CliSiTef 7. Ao habilitar o modo multi-terminal da CliSiTef. consulte o documento específico “CliSiTef . 2013 72 . a geração de traces é automaticamente alterada para o modo por terminal.ini”: [CliSiTef] TracePorHora=1 Software Express Ltda.Configuração Multi-terminal.doc”. O arquivo fica localizado no diretório corrente ou em C:\CliSiTef. dependendo se o ambiente for Linux ou Windows. Esse parâmetro é o seguinte: [Geral] EmAmbienteDeHomologacao=1 Por introduzir uma mensagem adicional no processo. Para tanto. uma vez habilitado. existe um parâmetro configurável que será utilizado pelos homologadores da Software Express para confirmar que o aplicativo de automação somente concretiza o processo de venda pela impressão de um comprovante ou pela chamada a função FinalizaTransacaoSiTefInterativo após o retorno final da ContinuaFuncaoSiTefInterativo. Software Express Ltda. respectivamente. sendo que a análise de problemas nesse ambiente deverá ser feita pela Software Express pela ativação de traces internos da CliSiTef.1 Arquivo de trace adicional durante a fase de desenvolvimento A CliSiTefI possui um mecanismo de auxilio ao desenvolvedor da aplicação que interage com ela de forma a simplificar a busca por problemas durante a fase de desenvolvimento. automaticamente.AAAAMMDD. faz com que seja gerado um arquivo de trace contendo os parâmetros trocados entre a CliSiTef e a aplicação. o fluxo descrito neste documento deve ser seguido a risca para que não ocorram erros estranhos durante a execução da CliSiTef. Essa opção habilita.Especificação Técnica – Interface com os meios de pagamento do SiTef Bibliotecas CliSiTefI e CliSiTef 8. Em ambiente de produção essa configuração NÃO DEVE EXISTIR. Esse mecanismo.txt.2 Processo de homologação Como descrito anteriormente. ele jamais deverá ser utilizado em ambiente de produção. 2013 73 .ini: [Geral] DataEmAmbienteDeDesenvolvimento=AAAAMMDD Onde AAAAMMDD corresponde ao dia que o teste em laboratório está sendo feito. inclua o seguinte parâmetro no arquivo de configuração CliSiTef. Para habilitar essa característica. 8. O nome do arquivo é CliSiTef. a opção a seguir.. Processo de desenvolvimento/homologação Versão: 120 Data: 29/04/2013 8. através de configurações passadas pelo Suporte. para reduzir as mensagens. Para habilitar esta configuração basta adicionar as seguintes configurações ao arquivo “CliSiTef.ini o item NomeArqTraducao. basta incluir na seção TabTraducao da CliSiTef.. Seg.Especificação Técnica – Interface com os meios de pagamento do SiTef Bibliotecas CliSiTefI e CliSiTef 9. Até o momento ela só é válida para transações de recarga pré-pago e bônus.ini”: [Geral] ConfirmarValorPinPad=1 10. Software Express Ltda. Para habilitar esta característica. Habilitando confirmação do valor no pinpad Versão: 120 Data: 29/04/2013 Esta configuração habilita a confirmação do valor da transação no pinpad no caso de transações sem coleta de senha pelo pinpad. sob a seção TabTraducao. [TabTraducao] NomeArqTraducao=<Nome do arquivo> As mensagens devem ficar em um arquivo no formato INI separado. ou\n0 = inexistente\n1 = ilegivel Como a CliSiTef está em constante inclusão de módulos e mensagens. Tradução de mensagens É possível alterar parte das mensagens enviadas para a automação. Um exemplo deste arquivo seria: [TabTraducao] MsgNovoValor=Forneca o novo valor do pagamento MsgEmbosso=Forneca os 4 digitos finais do cartao MsgCodigoSeguranca=Informe Cod. 2013 74 . para efeitos de tradução ou. a lista completa de itens de tradução encontra-se em um documento a parte. indicando o nome do arquivo de tradução. visto que na coleta de senha já é apresentado o valor. em alguns casos. não definido Visa Mastercard Diners American Express Sollo Sidecard (Redecard) Private Label (Redecard) Redeshop Fininvest (Visanet) JCB Hipercard Aura Losango Sorocred Versão: 120 Data: 29/04/2013 long LeCartaoDireto (Mensagem.Especificação 200001 Redecard Amex Banrisul Ticket combustível GetNet Visanet – Especificação 4. 2013 75 . Trilha2).Especificação Técnica – Interface com os meios de pagamento do SiTef Bibliotecas CliSiTefI e CliSiTef 11. Mensagem. Timeout). // Utilize LeCartaoSeguro LeCartaoInterativoA (Resultado. Timeout. Trilha2. // Utilize LeCartaoDiretoSeguro LeCartaoDiretoExA LeCartaoDiretoSeguroA (Resultado. Mensagem). Trilha1. Trilha1. Tabelas Código das Redes Autorizadoras 00000 00001 00004 00005 00006 00021 00031 00082 00125 Código da Bandeira (Cartão de Crédito) 00000 00001 00002 00003 00004 00005 00006 00007 00008 00010 00011 00012 00013 00014 00015 12. Mensagem. Trilha1. Trilha2). // Utilize LeCartaoDiretoSeguroA long LeCartaoDiretoEx (Mensagem. // Utilize LeCartaoDiretoSeguro LeCartaoDiretoA (Resultado. não definida Tecban Visanet . TestaCancelamento).1 Descrição Outro. // Utilize LeCartaoSeguroA Descrição Outra. // Utilize Software Express Ltda. Trilha1. Trilha2.. Rotinas descontinuadas long LeCartaoInterativo (Mensagem). .Especificação Técnica – Interface com os meios de pagamento do SiTef Bibliotecas CliSiTefI e CliSiTef Versão: 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 Histórico de Alterações Descrição Inclusão da coleta de um campo tipo VALOR Inclusão do tipo de campo “TROCO” para ser tratado pela aplicação Inclusão da rotina FinalizaTransacaoIntSiTefCuponFiscal Inclusão do comando para abortar a execução do módulo pelo aplicativo Inclusão de um novo tipo de dado de retorno para indicar o cancelamento Inclusão de novos tipos de dado de retorno para indicar a instituição que tratou a autorização e outros dados relativos a mesma Separação do NSU Host do Código de Autorização no retorno para a aplicação e alteração no tamanho dos campos de retorno (111 e 112) Alteração nos códigos retornados pela rotina RecebeResultado Inclusão dos comandos necessários para apresentar e remover um título nos menus (04 e 14) Inclusão de rotinas para acesso por linguagens de programação que não possuem a característica de Callback Remoção da rotina FinalizaTransacaoIntSiTef Separação em duas dll´s. valide este campo antes de passá-lo para a DLL Inclusão da função para leitura de um cartão genérico (p/ex: cartão de supervisor) Inclusão da possibilidade da automação comercial definir qual o tipo de transação será executada Alteração na estrutura interna do módulo para permitir múltiplos pagamentos para um mesmo cupom fiscal Melhoria na documentação e inclusão dos campos tratáveis pela automação na chamada a ColetaCampo Trocados os códigos que correspondem ao TipoCampo Trilha 1 e 2 Incluídos novos códigos na coleta de campos de forma que a aplicação possa controlar mais informações durante o processo de coleta de campos Melhoria na documentação Inclusão de mecanismo para a automação informar se o campo foi preenchido de forma automática ou não Inclusão da possibilidade de bloqueio de transações com número de cartão digitado Inclusão das funções de tratamento do Correspondente Bancário (pagamento de contas) Inclusão do comando para captura do código em barras do documento a ser pago Inclusão de codificação para os campos do Correspondente Bancário Inclusão de codificação para o campo Nome do Cedente para ser impresso no cheque de pagamento do Correspondente Bancário Inclusão de função para uso por terminais de auto-atendimento Inclusão de função para uso por telemarketing/televendas Software Express Ltda. se desejado. uma para as linguagens que possuem Callback e outra para as demais linguagens de programação. 2013 76 . Mudança de nomenclatura de Dll Conversacional para Interativa Alteração no nome da rotina de configuração quando em modo interativo Alteração no formato de captura de cheques para suportar a nova transação do Serasa (Comando 31) Alteração no nome das rotinas na interface interativa de forma a evitar confusão e acesso a rotinas erradas por conflito de nomenclatura entre as DLL´s via callback e interativa Alteração de alguns textos para explicar melhor o funcionamento da rotina ou interface Inclusão do tipo de campo Código do Operador para permitir que a automação. 0. Inclusão da interface ASCII para aplicativos que não conseguem tratar campos binários Inclusão da função para captura de senha em PinPad com criptografia por hardware Correção na descrição da passagem de parâmetros da rotina ContinuaFuncaoSiTefInterativo Inclusão do retorno da data e hora da transação Criação do novo ponto de entrada para acesso ao SiTef de forma a centralizar todas as funções de Tef e Gerenciais em uma única rotina (vide item 3) Trocado o nome do campo Modalidade para Funcao Criação da restrição de cancelamento de pré-autorização.. 0. Inclusão da possibilidade da automação passar os campos necessários para executar a reimpressão Visanet através da definição dos tipos de campo 515 e 516 Incluído o tipo de campo 517 para identificar a coleta de um cheque ou seja. Inclusão de novos tipos de campo para que a aplicação trate os dados do cancelamento. o comando em execução é o 31 Incluído o tipo de campo 517 para identificar a coleta de um cheque ou seja. o comando em execução é o 31 Incluída uma função para acesso direto ao PinPad para leitura das trilhas do cartão magnético. função esta normalmente utilizada para captura do cartão do Supervisor Incluída uma função para que o aplicativo de automação possa interromper a função LeCartaoDireto Incluído um novo retorno que indica dados adicionais sobre o cartão utilizado para o pagamento (TipoCampo = 112) Incluído novos códigos de função para acesso direto as rotinas de pré-autorização.76h 07/05/2003 V.80 28/05/2003 V. deixando claro que um retorno igual a Zero indica sucesso na execução da solicitação feita pelo terminal Introduzida a funcionalidade de recarga de pré-pago Incluídas as funções para que o aplicativo de automação possa capturar a trilha de forma direta na interface ASCII e a mesma funcionalidade para captura de senha de clientes de cartão proprietário através das funções LeSenhaDireto e LeSenhaDiretoA Inclusão da configuração que permite habilitar somente as transações desejadas Alteração na definição da configuração que permite habilitar somente as transações desejadas Eliminação da dll CliSITef32IA Inclusão de novos códigos para habilitação ou não de menus da CliSiTef32 Software Express Ltda. Inclusão das modalidades para cancelamento via função EfetuaPagamento e EfetuaPagamentoAutoAtendimento. Corrigido o texto referente ao bloqueio da transação de Pré-autorização Melhorada a documentação da função que continua o processo interativo. 2013 77 . quando ela é usada para efetivar um pagamento cujos dados do cartão foram armazenados previamente) Inclusão de tabela definindo formato do campo ‘produtos’ da função EfetuaPagamento. o descritivo estava escrito como ContinuaFuncaoIntSiTef.Especificação Técnica – Interface com os meios de pagamento do SiTef Bibliotecas CliSiTefI e CliSiTef Versão: 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. 096j 14/10/2003 Redefinição do campo Modalidade para comportar as funções de Cancelamento e Telemarketing Inclusão de tipos de campos que possibilitem ao aplicativo de automação reconhecer que a dll está requisitando dados de uma venda com cartão de crédito digitado (p/ ex.81 10/06/2003 21/07/2003 24/07/2003 29/09/2003 V. 096a 13/10/2003 V. 0. 0. Na função ContinuaFuncaoSiTefInterativo.76e 12/02/2003 V. Remoção de todas as referências ao modo Callback de funcionamento pois ele deixou de ser disponibilizado nessa biblioteca. 097p 13/02/2004 V. 097s 04/05/2004 V. 0. 098s 07/07/2004 ---------23/07/2004 V. 098j 24/06/2004 V. 097m Versão: 120 Data: 29/04/2013 06/02/2004 V.98z8 Alteração na forma de tratamento dos cupons recebidos como retorno das transações Gerenciais e Correspondente Bancário. 097 25/01/2004 V. Inclusão de novo exemplo de fluxo de utilização da CliSiTefI Incluído o campo 607 e a devolução do Nsu do Host para o correspondente bancário Detalhamento na forma com que a automação pode tratar uma coleta do campo 35 – código em barras Criada a função ValidaCampoCodigoEmBarras que consiste os campos digitados isoladamente Incluídos novos campos no retorno das transações de Correspondente Bancario Incluído novo tipo de restrição para a Garantia de Cheque Papel Tecban Incluída a funcionalidade de recarga de celular utilizando cartão de débito ou crédito e como habilitar tal característica Incluída forma para bloquear via restrições os menus do Correspondente Bancário Incluído na documentação a forma da aplicação solicitar um retorno ao campo anterior Incluída função para apresentação de mensagem no visor do PinPad e captura de confirmação ou cancelamento pelo cliente Incluído o menu de pagamento de benefícios do Banco do Brasil Incluído retorno dos campos Valor em dinheiro e troco no caso do correspondente bancário Modificada a nomenclatura do campo Restrições para ParametrosAdicionais uma vez que esta última é mais condizente com a funcionalidade oferecida por ele 02/08/2004 V..99 temporização ou chamada de rotina externa 03/05/2005 Inclusão de um novo código de retorno para a função ConfiguraIntSiTef. 0. 2013 78 . 0.98/nv/4 24/08/2004 Incluída as funções que permitem interromper a leitura de um cartão proprietário por V. Software Express Ltda. 0.98z8 V.Especificação Técnica – Interface com os meios de pagamento do SiTef Bibliotecas CliSiTefI e CliSiTef V. 096k 30/11/2003 V. 94.094.c.a.a. 1. Inclusão dos campos do pagamento de cartão Qualicard.57 Inclusão das configurações especiais EMS.00.71 Inclusão da rede Pharma System 1.01.c.c.20 números de telefone para consulta a cheques 1.00.31 Inclusão da rede Oboé 1.00. Acrescentados códigos de redes autorizadoras à tabela existente. 1.98.00. Starfiche e SEM 1.nv.xx Inclusão do menu venda crédito com autorização à vista 1.5 Campo.01. 1.a.c.63 Inclusão autorização genérica EMS.01. 2013 79 . A gravação de trace passa a ser habilitada por padrão e o período de armazenamento é configurável.01.1 Inclusão de campos para a rede Condor.00. 1.01.c.55 Inclusão somente na versão EMV FULL da possibilidade de adição de IP secundário no CLISITEF.089.c.c.xx Inclusão da rede Avista 1.00.080.98.94.a.3064.01.1 Inclusão do campo tipo 1131 e dos menus 3063.138 Passou a devolver os NSU do SiTef e do Host Autorizador quando uma transação de recarga for paga com cartão Passou a devolver o Código da Filial que autorizou a recarga do celular ???? Inclusão de novos campos para tratamento do cartão combustível (GoodCard e PortalCard).c.01.01.c.5 Inclusão do TipoCampo 518 e 519 na tabelas de valores para Tipo 1.c.c.094.00.01.94. 1. 1.INI.a.14 LeCartaoDiretoExA Acerto na numeração das versões mínimas e no texto descritivo das funções e correção da versão anterior que NÃO era 0.99 1..135 Inclusão da rede CompreMax 1.01.94.094.01.z.a.94.01.137 Inclusão do cancelamento de cartão combustível genérico Software Express Ltda.5 Devolução do código em barras cujo pagamento foi aprovado 1.8 Corrigida a documentação dos parâmetros na função 0. 1.c.01.c.01.4 Modificada a forma de numerar as versões.release] Incluida a geração de trace não criptografado para ser utilizado em ambiente de desenvolvimento Incluida as transações CentralCard e InfoCard 1.c. 1.01.00.082.a.3065.20 Inclusão da possibilidade de gerar trace em aberto para auxiliar o desenvolvimento da interface com a CliSiTef 1.VV[.094.94.1 Descrição de configurações especiais no parâmetro ParamAdic.94.01.105 Inclusão do cartão virtual Formosa.01.a. 1.082.c.94.00.c. Retornou a forma padrão 1.5 Incluído os tipos de campo necessários para tratar a coleta de 1.a.42 1.109 Inclusão do cartão Neus.4 V.129 Inclusão do PBM Fidelize 1.c.113 Inclusão da rede Algorix 1.2 Inclusão do campo tipo 1049.a. 1.01.Especificação Técnica – Interface com os meios de pagamento do SiTef Bibliotecas CliSiTefI e CliSiTef Versão: 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 Histórico de Alterações Descrição Versões mínimas CliSiTefI CliSiTef 0. 104.0.7.r1 4. Inclusão dos campos 3337 até 3352.0.01. Inclusão das funções (modalidades): Venda com Cartão Gift (modalidade 15). Inclusão dos campos 2125 e 2126 (fatura HotCard). Cancelamento de Recarga de Cartão Gift (modalidade 257) e Recarga de Cartão Gift (modalidade 264).r1 Inclusão do campo 537 (código de área da cidade do cheque) Documentação do campo 2054 para o tipo de CDC Crédito. Inclusão da Rede Citibank Revisão geral do documento.94.94. Inclusão da RedeHabilitadaFoxWinCards.195 1.12 r14 4.0. Quantidade Máxima de produtos Hopi-Hari (de 2051 para 2122).c.01.102. Eventos 5011.18 r1 Software Express Ltda.254 1.0. Inclusão das funções 702 (Pagamento de contas) e 703 (Cancelamento de Pagamento Cartão Benefício).6 b6 4.r1 4.94.106.102. Inclusão dos menus de saque/estorno de saque GetNet Inclusão da função Consulta Saque com Saque Banco IBI Alteração da identificação dos campos Código Produto Hopi-Hari (de 2049 para 2120).01.r1 4. 5012 e 5013.6. menus 3335 e 3336.c. Parâmetro HabilitaRedeDotz Inclusão da descrição dos campos 1 e 2. além do detalhamento do campo 100.94.10. Cancel.dll.94.3. Cancelamento de Venda com Cartão Gift (modalidade 213).c. Emissao Pontos (668).0.95. Inclusão das funções(modalidades) Resgate de Pontos (modalidade 665).259 1. 2013 80 . Emissao Pontos (667). Carga de Pré Pago) e 680 (Cons.01.94.12 r1 4.201 1. -50 e -100.01.102. para melhor visualização.0. Criada tabela de Modalidades..102.18 r1 4. Consulta a Saldo Gift (modalidade 152).c.0.0. Inclusão do campo 5501. Corrigido o nome da rede InfoCard nas redes habilitadas.c. 27/05/2011 13/06/2011 4.c.Especificação Técnica – 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.c.94.102.265 Versão: 120 Data: 29/04/2013 21/10/2010 11/11/2010 1. Inclusão do tipo campo 3409. Saldo Pré Pago) Parâmetro HabilitaRedeTricard Inclusão dos campos 3339 a 3345.102.01.0.106.01. Inclusão da Rede ClubCard Alteração na descrição do campo 178 que estava errada.0. Inclusão da rede TopCard e da transação de Pagamento de Fatura Genérico (3379) Inclusão do modo “2:”(Digitação do CMC-7) na captura do cheque Inclusão dos campos 3407 e 3408. Descrição Produto Hopi-Hari (de 2050 para 2121). Inclusão do campo 2301.207 1. inclusão de tipos de parâmetro (entrada/saída e valor/referência).191 1. Produtos Hopi-Hari (de 2052 para 2123).102.13 06/12/2010 28/01/2011 18/02/2011 11/05/2011 - 4. Adicionadas descrições dos códigos de erro -43.c. Incluído campo 3334 (Pagamento SPTrans) e modalidades 700 e 701 (Oi Paggo) Inclusão do pagamento de fatura/estorno FoxWinCards. Inclusão da rede SQCF Inclusão da opção Cartão Gridcard Reservado o Range de 8000 a 9999 para a tabela de Tipo Campos para a IntPos. 669 (Carga de Pré Pago).9. 670 (Cancel.01.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. tornando-os genéricos. Incluído esclarecimentos sobre o processo de Descarregamento de Mensagens.. Software Express Ltda.0.Especificação Técnica – 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.Revisão editorial do item Informações do PinPad.18 r1 4.0.20 r1 - Versão: 120 Data: 29/04/2013 29/04/2013 - Inclusão da modalidade 420. v119 . e do campo 2355. Inclusão do parâmetro ConexaoObrigatoria na seção “SiTef” Inclusão do tipo campo 5050 na tabela de eventos. do tipo campo 2355 e alteração no texto do campo 1122. 2013 81 . v120 – Correção na descrição de campos específicos ACSP que são retornados em outras redes.106.106.