Académique Documents
Professionnel Documents
Culture Documents
Contedo
1. 2. 3. 4. INTRODUO ..................................................................................................................................................... 2 RECOMENDAES ........................................................................................................................................... 2 PARTICULARIDADES DA VERSO .............................................................................................................. 2 PR REQUISITOS DE INSTALAO............................................................................................................. 3 4.1 4.2 5. 6. 7. 8. INTERFACE PDV (CLIENT MODULAR OU CLISITEF) COM AS VERSES MNIMAS: ............................ 3 SITEF ........................................................................................................................................................ 3
CLIENTES QUE UTILIZAM SITEFWEB E/OU CONCILIAO .............................................................. 4 CARACTERSTICAS DA VERSO.................................................................................................................. 4 ARQUIVOS ATUALIZADOS NESTA VERSO ............................................................................................. 7 INSTALAO GRADATIVA OU INTEGRAL ............................................................................................... 7 8.1 8.2 8.3 8.4 ATUALIZAO SOMENTE DO SERVIDOR SITEF. .................................................................................... 7 ATUALIZAO DO SERVIDOR E INTERFACE CLIENTE.......................................................................... 7 ATUALIZAO SOMENTE DO PINPAD..................................................................................................... 7 ATUALIZAO DO SERVIDOR, INTERFACE CLIENTE E PINPAD (1.07). ............................................... 8
9.
10. RETORNO DA VERSO = ROLLBACK ......................................................................................................... 9 11. CONFIGURAO CARTO COMBUSTVEL ............................................................................................ 10 12. CONFIGURADOR MULTIBANDEIRA ......................................................................................................... 12 13. CONFIGURAO DO MDULO REDECARD CONFIGURAO PRIORITRIA NO SITEF ...... 13 14. CARGA DE TABELAS ...................................................................................................................................... 18 15. VISUALIZADOR DA TABELA L0500............................................................................................................ 19 16. CONFIGURAO DO PONTO DE VENDA (PDV) ..................................................................................... 19 16.1 INTERFACE CLISITEF ............................................................................................................................ 19 16.2 INTERFACE CLIENT MODULAR ............................................................................................................ 21 17. TABELA DE ERROS DO AUTORIZADOR .................................................................................................. 22
1. Introduo
Esse documento tem como objetivo orientar o processo de migrao do mdulo Redecard segundo a especificao L0500. Essa especificao tem como principal foco a incluso da criptografia DUKPT 3DES, transao de combustvel e processamento dos cartes da Hipercard (tarja e chip). O processo completo de migrao impacta todas as partes do sistema, desde a automao (Interface), Pinpad e servidor SiTef. Contudo, este processo pode ser executado por partes, de acordo com cada necessidade da automao. Como partes adicionais desta especificao, para utiliz-la todas as funcionalidades, devem-se atualizar os PinPads com a especificao 1.07 da biblioteca compartilhada.
2. Recomendaes
2.1 2.2 No realizar atualizao de qualquer tipo de Sexta, Sbado, Domingo e feriados. Recomendamos que a atualizao seja sempre realizada por um profissional experiente e com conhecimento no ambiente TEF. 2.3 2.4 Seguir todos os passos do procedimento de atualizao. Sempre realizar backup de servidores e clients que sero atualizados, antes de iniciar a atualizao e guardar por no mnimo 15 dias. 2.5 2.6 2.7 Sempre verificar as verses mnimas e particularidades exigidas nos procedimentos. O procedimento deve ser realizado em horrios de baixo ou nenhum movimento de transaes. Efetue a manuteno de pendncia de todas as transaes pendentes antes de realizar o procedimento de atualizao, certificando que todas as transaes estejam tratadas. 2.8 Caso tenha dois servidores, um de produo e um de backup atualizar o de produo e depois de uma semana atualizar o servidor de backup.
3. Particularidades da verso
3.1 Os Pinpads atuais esto preparados e iro funcionar corretamente aps a atualizao do SiTef. Para garantir que no haver problemas no momento da atualizao, disponibilizamos em nosso site o link https://www.softwareexpress.com.br/distri/aplicativos/testepin.zip, onde est disponvel um programa que permitir identificar se o Pinpad em uso pelo estabelecimento precisar ser trocado para suportar essa nova verso. Recomendamos o teste antes da atualizao para conferir se ele compatvel ou no. Se a verso do SiTef for atualizada e o pinpad no for compatvel, a mensagem apresentada no momento de uma transao utilizando um carto com tarja e senha e que seja direcionada para a Redecard ser Cartao exige cripto e a transao no ser concretizada. imprescindvel que seja feita uma validao atravs do programa disponibilizado e somente quando o programa acusar que o pinpad no compatvel que dever ser solicitada a sua troca.
Email: suporte@softwareexpress.com.br Pgina 2 de 24 Tel: (11) 3170-5353 Verso 1.8 Site: www.softwareexpress.com.br Data: 22/02/2012
3.2
Para clientes que utilizam cartes Private Label roteados pela Redecard necessria a configurao dos BINS no Configurador Prioritrio Redecard. Seguir instrues obtida no item Configurao do Mdulo Redecard Configurao Prioritria no SiTef Para estabelecimentos que utilizam a comunicao atravs do Gateway Roteador ISO 8583 necessria atualizao para ultima verso do Gateway que contempla o novo layout da especificao Redecard L0500, entre em contato com nosso suporte@softwareexpress.com.br para obter maiores informaes.
3.3
3.4
Para que os Clientes/estabelecimentos possam rotear Hipercard atravs da Redecard, devem previamente contatar o Departamento Comercial da Redecard e solicitar o credenciamento de PVs (cdigo de estabelecimento), caso o cadastro no tenha sido realizado, as transaes sero negadas com cdigo 03.
4. Pr Requisitos de Instalao
4.1 Interface PDV (Client Modular ou CliSiTef) com as verses mnimas: 4.1.1 Client Sitef Modular Verses inferior e igual a V4.0.2.10 e superior a V1.2.0.3. Apenas verses igual ou superior a V4.0.2.10 operam com a criptografia Dukpt. Caso o Client Modular esteja com a verso inferior a "V 1.2.0.3" a transao ser negada com a mensagem Carto Exige Cripto.
4.1.2 CliSiTef Verses inferior e igual a 4.0.104.6 e superior a 1.01 c 093. Apenas verses igual ou superior a 4.0.104.6 operam com a criptografia Dukpt. O SitRedecardL0500 no aceita transaes da clisitef com verso inferior a Cc093,
Quando uma interface PDV no possuir a verso mnima da especificao, a mensagem "Interface Incompatvel" ser enviada automao e a transao no poder ser finalizada.
4.2
SiTef Para uso desta verso da Redecard L0500 necessrio que o SiTef j esteja configurado com os mdulos Redecard L0205 ou superior e verso mnima do SiTef igual ou superior 3.0.20.17, caso sua verso seja inferior entre em contato com nosso suporte para a atualizao.
4.3
Conciliao Verso mnima do ConcSiTef v1.00 R23d (20110517), com a alterao da Hipercard processado pela Redecard.
6. Caractersticas da verso
6.1 6.2 6.3 Permite a coleta do CVV via tarja magntica ou digitada. Configurao consta na tabela Issuer. Permite coleta CVV ilegvel ou inexistente. Configurao consta na tabela Issuer. Poder coletar o embosso (4 ltimos dgitos do carto) e o CVV. So dados que constam na tabela Issuer. Verses anteriores eram solicitadas um dos dois dados (se solicita CVV no solicita o embosso). 6.4 Transao de cancelamento dbito pode solicitar senha, depende do que est configurado na tabela de issuer. No deve solicitar a captura CVV ou os 4 ltimos dgitos 6.5 Transao de credito poder solicitar o numero do voucher (numero da reserva de passagem ou hotel, etc). Esse dado configurado no Configurador Prioritrio da Redecard.
Email: suporte@softwareexpress.com.br Pgina 4 de 24 Tel: (11) 3170-5353 Verso 1.8 Site: www.softwareexpress.com.br Data: 22/02/2012
6.6
Transao digitada deve passar o tipo de aplicao que est efetuando, televenda, internet ou PDV. Esse dado pode ser configurado pelo configurador local da Redecard, caso um estabelecimento tenha sempre a mesma caracterstica, isto , uma empresa sempre internet, ou ura, ou frente de caixa. Caso contraria esse dado deve vir na mensagem de solicitao da venda.
6.7 6.8
Excludo Parcele Mais e o envio da reimpresso online. O pinpad deve exibir SENHA CRED: ou SENHA DEB:, na solicitao da senha. Antes era exibido somente SENHA:.
6.9
Novo formato da tabela, o formato da tabela no compatvel com as verses anteriores. A tabela fica em: \\sitef\config\redecard\<empresa>\redecard0500.ini. Onde <empresa> o cdigo da empresa cadastrada no SiTef.
6.10 Incluso da tabela de criptografia 6.11 Alterao na tabela de Issuer O tamanho do nome do emissor aumentou para 20 caracteres. Coleta dos 4 ltimos dgitos para transao digitada Indicao se o carto Frota.
6.12 Alterao no Private Label 6.13 Se habilitado na tabela, solicitar a senha na transao de venda e consulta. Se habilitado na tabela, solicitar a captura CVV e ltimos 4 dgitos.
Incluso de transaes de frota (combustvel) Permite a venda de apenas um produto por venda. O cdigo do combustvel da Redecard deve ser cadastrado composto pelo Tipo de servio + cdigo do Produto. As perguntas variam de acordo com o tipo de produto consumido, por exemplo, se for lavagem no ser solicitada Kilometragem, por exemplo. Utilizar o configurador de combustvel (\\sitef\aplic.win\CfCombustivel.exe) para gerar configurao de x para dos cdigos de produto, vide item 11. Configurao Carto Combustvel.
6.14 Tamanho da mensagem entre o SiTef e o Autorizador foi alterado Para estabelecimentos que utilizam gateway (roteador SiTef), ter que incluir uma nova entrada , conforme item Configurao do Gateway Roteador ISO 8583, abaixo. 6.15 Incluso da transao de Injetor de chaves Dukpt Esta transao utilizada uma nica vez para incluso da chave DUPKT no pinpad, quando verso igual ou superior a 1.07 caso no exista chave, sendo realizada de duas formas: Forma automtica: A Clisitef/Modular solicita essa transao na inicializao de uma venda, na seguinte condio: Se a criptografia DUKPT estiver habilitada na tabela, e a verso do Pinpad for igual ou superior 1.07 a e no possuir a chave. Forma manual: Nas transaes administrativas est definida a transao de injeo de chaves Dukpt. Se o Pinpad j tiver a chave Dukpt essa transao retornar a informao de que a chave j existe.
[Redecard] Versao=L0500 **OBS: No precisa acrescentar o parmetro acima, na instalao esta alterao j realizada.**
Pr-requisitos para o funcionamento da Redecard L0500: SiTef.exe verso mnima 3.0.17.7 SiTefServices.exe verso mnima 3.0.20.21 Drvcom.exe verso mnima 4.0.0.17 SitRedecardL0500.exe verso mnima 4.0.2.13 VisRedecardL0500.bpl verso mnima 1.0.2.1 Gerpdv.exe verso mnima 4.0.0.16
8.2
Atualizao do Servidor e Interface Cliente Poder ocorrer sem a alterao de PinPad 1.07, quando PinPad com verso compartilhada acima de 1.05g. O sistema opera com todas as caractersticas da verso L0500 citadas acima, s no contempla a chave de criptografia do tipo DUKPT comunicao segura.
8.3
Atualizao somente do Pinpad. Poder ocorrer sem atualizao do servidor ou a Interface Cliente, quando a interface j esta usando o PinPad compartilhado (verso do PinPad acima da 1.07), que contempla a chave de criptografia do tipo DUKPT, utilizada em conjunto com DES. Com a migrao apenas do PinPad 1.07, o sistema opera da mesma maneira existente hoje, nenhum
Email: suporte@softwareexpress.com.br Pgina 7 de 24 Tel: (11) 3170-5353 Verso 1.8 Site: www.softwareexpress.com.br Data: 22/02/2012
8.4
Atualizao do Servidor, Interface Cliente e PinPad (1.07). Com a migrao de todos, o sistema reflete em todas as funcionalidades da especificao L0500 nas transaes e processos com chip. Sendo este o ideal, contemplando a chave de criptografia DUPKT comunicao segura.
Backup parcial.
a) Efetuar o backup dos arquivos \\sitef\config\empresas\<empresas>\redecard.emv. b) Anotar o que est configurado em \\sitef\config\sitefcfg.ini: [Redecard] Versao=xxxxxxx
a)
Backup completo.
Efetuar uma cpia de backup das pastas \SiTef\CONFIG\*.* e \SiTef\APLIC.WIN\*.* renomeando para Config_MMDDAA e Aplic_MMDDAA
ATENO: Para estabelecimentos que utilizam Gateway (Roteador ISO8583) se faz necessria atualizao para ltima verso do Gateway que contempla o novo layout da especificao Redecard L0500, entre em contato com nosso suporte@softwareexpress.com.br para obter maiores informaes.
Instalao do SiTef:
a) Descompactar o arquivo .zip em uma pasta temporria, por exemplo C:\Instalacao\ b) Finalizar o servio do SiTef - Soluo Inteligente atravs dos servios do Windows
c) Acessar o diretrio temporrio criado (C:\Instalacao), executar o programa Instala.exe e seguir os passos Next Finish d) Caso o cliente utilize vendas digitadas e/ou coleta de voucher, efetuar configurao conforme a guia Extra no configurador prioritrio Redecard. e) Caso o cliente utilize carto Private Label roteado pela Redecard, efetuar a configurao conforme a guia Bins-PrivateLabel no Configurao do Mdulo Redecard Configurao Prioritria no SiTef f) Caso o cliente deseja rotear as vendas Hipercard para Redecard, efetuar a configurao multibandeira conforme item Configurador Multibandeira.
Email: suporte@softwareexpress.com.br Pgina 8 de 24 Tel: (11) 3170-5353 Verso 1.8 Site: www.softwareexpress.com.br Data: 22/02/2012
g) Em seguida ativar o servio do SiTef - Soluo Inteligente atravs dos servios do Windows.
c) Editar em \sitef\config\sitefcfg.ini e colocar a verso que estava configurado no item b) do Backup Parcial acima, exemplo abaixo: [Redecard] Versao=L0401 d) Copiar o os arquivos \\sitef\config\empresas\<empresas>\redecard.emv de todas as empresas substituindo os j existente. e) Caso o cliente tenha roteado a bandeira Hipercard para o autorizador Redecard, voltar configurao: Acesse o configurador multibandeira, selecione a bandeira Hipercard e altere para autorizador Default em seguida, acesse o configurador Hipercard e inclua os Bins que estavam cadastrados. f) Aps ativar o servio do SiTef - Soluo Inteligente atravs dos servios do Windows.
Os programas executveis atualizados nessa instalao L0500 so compatveis com as verses anteriores.
Clicar em Empresa, selecionar a empresa que ir transacionar com o Carto Combustvel e marcar ) os produtos que sero comercializados.
Em seguida Encerrar.
Selecione a Bandeira Hipercard e mude o campo Autorizador para Redecard, conforme exemplo abaixo.
Em seguida pressione o boto Salvar Grava Configurao, aps pressione o boto Sim para que de fato a configurao seja gravada.
No havendo o cadastro na Redecard corretamente, as transaes sero negadas com cdigo 03 Aps liberao comercial do cadastro na Redecard, eliminar a configurao dos Bins no mdulo Hipercard, conforme procedimento abaixo:
Em seguida, selecione o cursor em cada BIN cadastrado e pressione o boto Exclui, para que os BINs sejam excludos do mdulo Hipercard.
Estas configuraes somente sero validadas pelo SiTef aps restart do Servio do SiTef. No caso de roll-backup parcial, necessrio voltar configurao dos BINs, cadastrando-os.
Caso o Sitef esteja configurado para multiempresa, solicitar o cdigo da empresa e senha, caso esteja configurado como monoempresa apenas digitar a senha de acesso (mesma senha utilizada no Configurador Sitef).
A configurao pode ser efetuada para uma empresa especifica ou uma configurao padro para todas empresas.
Padro: Esta configurao ser valida para todas as empresas Empresa (eeeeeeee): Esta configurao ser valida somente para a empresa em que estiver setada a configurao.
Na guia Extra, configurar : Coleta Cdigo Voucher CTAH = Somente para estabelecimento Hoteleiro.
Tipo de Terminal Digitado = somente configurar quando utilizar transao digitada, onde deve passar o tipo de aplicao que est efetuando, televenda, internet ou PDV. Caso um estabelecimento tenha sempre a mesma caracterstica, isto , uma empresa sempre internet, ou ura, ou frente de caixa. Caso contrrio esse dado deve vir na mensagem de solicitao da venda.
A configurao da guia Transaes Habilitadas (Configurador Prioritrio Redecard), s dever ser realizada com orientao do Suporte Tecnico Software Express
(suporte@softwareexpress.com.br) , caso seja realizada incorretamnente impactar nas aceitaes das transaes.
Habilita Configurao local : Esta configurao deve ser habilitada, somente no caso em que h necessidade de desabilitar ou alterar valores limites. Essa configurao ser prioritaria em relao a Tabela da Redecard.
Observao: Se Habilitar a Configurao Local e no habilitar nenhuma transao credito ou debito, ser considerado como no habilitado, ou seja, deixar de transacionar dbito e crdito da Redecard.
Para desabilitar a configurao local das transaes habilitadas: Basta dar o reset no flag Habilita Configurao local na aba Geral de Transaes Habilitadas..
Range = Informar o numero do BIN do carto Private Label (6 a 8 primeiros nmeros do carto) roteado pela Redecard, em seguida pressione a seta ao lado para incluir o BIN.
Efetuar a configurao para todos os BINS carto Private Label que o estabelecimento rotea pela Redecard.
NO SE FAZ necessrio habilitar configurao local na guia Transaes Habilitada, somente cadastro dos Bins na guia Bins-Private Label. Aps configurao, selecione o boto Salvar Grava Configurao.
Obs= Cada alterao de cadastro neste configurador, se faz necessrio restart no SiTef.
Clicar na Empresa SiTef que deseja efetuar a carga de tabelas e clicar no Boto Enviar
Backup da CliSiTef Realizar uma copia de segurana dos arquivos da CliSiTef (figura abaixo)
Atualizao da CliSiTef Finalizar a aplicao de PDV Descompactar o arquivo clisitef v_4.0.104.6.zip e colar as dll na mesma pasta onde se encontram as .dll *substituindo-as* Ativar a aplicao de PDV
Injeo de chaves Dukpt Forma manual: Nas transaes administrativas est definida a transao de injeo de chaves Dukpt. Para habilitar essa funo necessrio configurar no arquivo CliTef.ini o parmetro: [Geral] TransacoesAdicionaisHabilitadas=3027
Compra Combustvel Solicitar especificao tcnica da Clisitef Combustvel Cartao Combustivel - Clisitef.doc Para habilitar transaes com carto combustvel, necessrio incluir no arquivo CliSiTef.ini, na seo Geral, a opo 3020 no item TransacoesAdicionaisHabilitadas ou TransacoesHabilitadas.
[Geral] TransacoesAdicionaisHabilitadas=3020
Em uma venda com carto combustvel, solicitado ao PDV o campo 1115, onde deve ser informada a lista de produtos que totalizam o valor da venda. A lista de produtos deve estar no formato:
item1;item2;...;itemn; onde cada item da forma: <CodProd>,<DescProd>,<Qtd>,<ValorTotal>;
Onde <CodProd> o cdigo do produto de acordo com a rede autorizadora; <DescProd> a descrio do produto; <Qtd> a quantidade; <ValorTotal> o valor total a ser pago por este produto (Sem formatao, sendo que os dois ltimos dgitos se referem aos centavos). obrigatrio que seja descrito pelo menos um item de venda. recomendvel que a lista de produtos (Campo 1115) seja montada internamente pelo PDV sem a interveno do operador do PDV. Para facilitar a captura dos dados dos produtos pelo operador do PDV, esses campos podem ser capturados separadamente um a um. Para isso, preciso incluir a seguinte configurao no arquivo clisitef.ini:
[CartaoCombustivel] ColetaDadosProdutoSeparadamente=1 Para efetuar uma transao de Compra Combustvel, o operador poder efetuar da seguinte forma:
No menu principal (quando a aplicao envia a chamada IniciaFuncaoSiTefInterativo, funo =0) selecionar a opo Carto Combustvel seguindo o fluxo de venda.
Ou
A aplicao dever ter um boto *Carto Combustvel* onde a aplicao enviar para a CliSiTef a funo 7 na chamada IniciafuncaoSiTefInterativo, seguindo o fluxo de venda.
Transao IATA Para habilitar transaes IATA, necessrio incluir no arquivo CliSiTef.ini, na seo Geral, os parmetros abaixo:
Atualizao da CliSiTef Finalizar a aplicao de PDV Descompactar o arquivo clientsitef.zip e executar o arquivo Instala.exe Ativar a aplicao de PDV
Injeo de chaves Dukpt Forma manual: Entrar nas funes administrativas (ADM), selecionar a opo escolher a opo . e
[BOTOES_HABILITADOS] btRedecardAdm=1
Compra Combustvel Solicitar especificao tcnica do Client Modular Combustvel Especificacao do ClientSitef Carto Combustvel.pdf Incluir no arquivo ClienteTrn.ini: [BOTOES_HABILITADOS] btCombustivel=1
Ser necessrio enviar o campo 507-001=1 no arquivo Intpos.001 para habilitar o boto combustvel, alm dos outros campos mandatrios para Carto Combustvel, conforme especificao.
Transao IATA Para habilitar transaes IATA, necessrio configurar no arquivo Cliente.ini o parmetro:
[ClientSiTef] IATA=1
DESCRIO
AO
Aprovada Cancelada Cancelada Cancelada Cancelada Cancelada Cancelada Cancelada Cancelada Cancelada Cancelada Site: www.softwareexpress.com.br Data: 22/02/2012
Banco no Pertence Rede Excedido n de Tentativas da Senha Carto Extraviado Carto Roubado Saldo Insuficiente Conta Corrente no Cadastrada Carto Vencido Senha Incorreta Carto sem Registro Transao no Permitida a Esse Cliente Genrico: 1. TRANSAO NO AUTORIZADA Nas seguintes transaes significado especfico, descrito a seguir. Pagamento de Conta: 1. ERRO CD. BARRAS OU CONTA Pr Autorizao: 1. EXCEDE NR DE PR (permite apenas 3 pr-autorizaes pendentes sem confirmao) 2. PR INEXISTENTE(confirmao estorno de pr-autorizao que existe) ou no possui conforme
Cancelada Cancelada Cancelada Cancelada Cancelada Cancelada Cancelada Cancelada Cancelada Cancelada Cancelada
Ligar para Autorizao Excedido Limite de Saque Allowable number of pin tries exceeds Invalid to account specified