Professional Documents
Culture Documents
Informaes Gerais
imprescindvel a leitura deste material para o correto procedimento de instalao e configurao deste
produto.
Reviso
1.0
1.1
1.2
Data
10/03/2008
19/03/2008
02/07/2008
Responsvel
Equipe Desenv. Scope
Fabio Barbosa dos Santos
Fabio Barbosa dos Santos
1.3
1.4
1.5
28/09/2009
1.6
Histrico
Verso Inicial.
Reviso das Imagens e Formatao.
Ajustes no Layout de acordo com novo padro
Scope Cliente conectar com vrios servidores
Scope.
Scope Server utilizando banco de configurao
e transao
Acrscimo da configurao do recurso de
contadores.
Scope.ini - RedeCardPrivateLabel
ndice
________________________________________________________________________________________________
Prefcio............................................................................................................................... 5
A Quem se Destina ........................................................................................................................................ 5
Descrio do Produto ..................................................................................................................................... 5
Objetivo ....................................................................................................................................................... 5
Definio ..................................................................................................................................................... 5
Benefcios .................................................................................................................................................... 6
Instalao ......................................................................................................................... 14
Instalao Server/Client ............................................................................................................................... 14
Server / Client............................................................................................................................................ 14
Client ......................................................................................................................................................... 25
Instalao do ScopeWeb ............................................................................................................................. 30
Instalao padro ...................................................................................................................................... 30
Instalando o Java ...................................................................................................................................... 35
Instalando o Tomcat .................................................................................................................................. 39
Configurao.................................................................................................................... 45
Configurando o Scope .................................................................................................................................. 45
ScopeCNF ................................................................................................................................................. 45
Gateway de Contingncia ......................................................................................................................... 74
Arquivo de Configurao (Scope.ini) ........................................................................................................ 78
Configurando o ScopeWeb .......................................................................................................................... 82
Prefcio
_____________________________________________________________________________________________________
A Quem se Destina
O Manual do integrador destina-se aos profissionais que tomaro contato direto com os
procedimentos de instalao, configurao e administrao dos mdulos que compem o
produto Scope.
Descrio do Produto
Objetivo
O mercado de cartes no Brasil vem alcanando um crescimento expressivo nos ltimos
anos. De acordo com levantamentos realizados pela Associao Brasileira das Empresas
de Cartes de Crdito e Servios (Abecs), os dados consolidados de 2007 indicam um total
de 436 milhes de cartes gerando 5,1 bilhes de transaes, totalizando 310,6 bilhes de
reais.
Definio
A Itautec, utilizando seu know-how em soluo de Transferncia Eletrnica de Fundos
(TEF), oferece ao mercado o Scope: uma Soluo Completa para Pagamento
Eletrnico, projetada para atender aos mais variados tipos de negcio.
Gerenciando todas as etapas das operaes comerciais de TEF, o Scope garante aos
usurios a segurana e a eficincia da transao eletrnica, alm de colaborar para a
reduo do nvel de inadimplncia nos pagamentos.
O Scope j est aderente ao padro EMV de cartes com chip, certificado no Brasil pela
Visanet e Redecard. Tambm est homologado para trabalhar com vrias outras redes,
como Amex, TecBan, Serasa, ACSP, Teledata, etc.
Alm de crdito e dbito, o Scope tambm disponibiliza vrios outros servios, como: CDC
(Crdito Direto ao Consumidor), Voucher (Vale Refeio/Alimentao Eletrnico), Consulta
de Cheques, Recarga de Celular Pr-Pago, Correspondente Bancrio, PBM (Pharmacy
Benefit Manager), etc.
Tambm possvel implementar transaes para cartes proprietrios, conhecidos como
Private Label.
Arquitetura Scope
Desse modo, o estabelecimento passa a contar com uma soluo totalmente integrada
sua aplicao de venda e s redes autorizadoras do mercado, executando a autorizao
das transaes de forma on-line e oferecendo aos seus clientes a comodidade do
pagamento eletrnico.
Benefcios
Alm dos benefcios inerentes s solues de pagamento eletrnico, o Scope oferece aos
lojistas e empresas prestadoras de servio, diversos recursos para gerenciamento,
configurao e manuteno do ambiente relacionado com as transaes eletrnicas.
Gesto Centralizada
Todas as informaes relacionadas com as transaes de pagamento eletrnico, alm da
configurao de servios e parmetros do sistema, esto armazenadas em banco de
dados, e ficam disponveis para serem acessadas de forma consolidada atravs dos
mdulos administrativos. O Scope oferece diversos tipos de consultas e relatrios
estatsticos, operacionais e financeiros.
Flexibilidade de Configurao
A soluo Scope possui alto nvel de parametrizao, tornando bastante flexvel o processo
de configurao e manuteno da soluo. A qualquer momento, pode-se alterar a
configurao do ambiente, incluindo novos servios, novas bandeiras, alterando o perfil de
cada empresa, filial ou PDV.
Pode-se definir um ou mais perfis de servios para determinar quais produtos sero
aceitos ( vista, parcelado, pr-datado). Estes perfis podem ser atrelados a toda empresa, a
um grupo de filiais ou at mesmo ser especfico por PDV.
Facilidade de Evoluo
A soluo Scope foi projetada para permitir agilidade e flexibilidade na evoluo. possvel
incluir novas redes e/ou bandeiras e/ou servios sem a necessidade de alterao no cdigo
do produto, dispensando o processo de instalao e homologao de uma nova verso de
software.
Mecanismos para contingncia automtica
O Scope permite a configurao de vrios mecanismos de contingncia. Podem-se
configurar rotas alternativas de link X.25 ou TCP/IP com troca automtica em caso de
queda da conexo principal. Caso a arquitetura possua mais de um gateway, pode-se
estabelecer uma relao de prioridade entre eles para que em caso de problema com o
gateway prioritrio a comunicao seja restabelecida por outro gateway. Caso o carto
permita roteamento por mais de uma rede autorizadora, pode-se estabelecer uma relao
de prioridade entre elas, de forma que o lojista pode informar como mais prioritria a rede
que oferece melhor condio comercial. Neste caso, quando a rede autorizadora mais
prioritria no estiver disponvel, a transao direcionada para a segunda, evitando a
perda da venda e a necessidade de solicitao de outro meio de pagamento ao cliente.
Conciliao Eletrnica
Atravs do recurso de Conciliao Eletrnica o Scope auxilia na gesto contbil da
empresa. Ao creditar os valores referentes s transaes realizadas, a rede autorizadora
poder fornecer um arquivo com a relao das transaes que esto sendo pagas. O
mdulo de Conciliao Eletrnica do Scope poder importar este arquivo e comparar com
as transaes armazenadas em seu banco de dados. Desta forma, o Scope poder
informar eventuais divergncias, permitindo um balano contbil mais gil e eficiente, alm
de evitar perdas que poderiam passar despercebidas em um processo manual.
Principais Mdulos
_____________________________________________________________________________________________________
ScopeGateway: Mdulo servidor, responsvel pelo envio e recepo das transaes para
as autorizadoras. ele quem estabelece e controla a conexo X.25 ou TCP/IP e gerencia a
entrada e sada de pacotes, trabalhando como um roteador de mensagens.
ScopeCnf: Mdulo administrativo responsvel por toda a configurao do sistema, para sua
correta operao. Permite o cadastramento das empresas, filiais, PDVs, cdigos dos
contratos estabelecidos com as redes autorizadoras, quais produtos sero aceitos, quais
perifricos sero usados, regras de prioridades e de contingncia, etc.
ScopeAPI: Interface cliente, responsvel pela interao com o aplicativo PDV e pela
comunicao TCP com o Scope Server
Servidor 3
Servidor 2
X.25
CONFIG
ADM
GATEWAY
PEND
TCP/IP
Servidor 1
SERVER
Servidor BD
Banco
de
Dados
TCP/IP
CLIENT
Os mdulos servidores possuem dependncias entre eles. O primeiro mdulo a ser carregado
deve ser o ScopeGateway, responsvel pelo roteamento de mensagens para as redes
autorizadoras. Em seguida deve-se carregar o ScopeServer, que receber conexes dos
clientes Scope e efetuar conexo com o ScopeGateway. Os mdulos administrativos
dependem apenas do banco de dados.
Matriz
Administrao
Gateway
Pendncias
X25
ISO 8583
Server
Lista Negra
Configurao
Conciliao
Banco de Dados
de Produo
Recarga
Celulares
Filial 1
Correspondente
Bancrio
Banco de Dados
de Conciliao
W AN
(TCP/IP)
Filial n
...
Outros
Servios
CLIEN
CLIEN
X25
ISO 8583
Loja 1
Loja n
Adm
Gateway
Pend
Server
Config
Banco de Dados
de Produo
Config
Con
Banco de Dados
de Conciliao
WAN (TCP/IP)
Pend
Server
L.Negra
Matriz
Adm
Gateway
Recarga
Celulares
L.Negra
Matriz
Banco de Dados
de Produo
Correspondente
Correspondente
Bancrio
Bancrio
Filial 1
Con
Banco de Dados
de Conciliao
WAN (TCP/IP)
Filial n
CLIEN
CLIEN
10
Conceitos Bsicos
TEF - Transferncia Eletrnica de Fundos
Transferncia de fundos por meio eletrnico eliminando a necessidade de pagamento em dinheiro
ou cheque.
Uma TEF geralmente formada por trs pernas: solicitao, reposta (que pode ser positiva ou
negativa) e confirmao. Caso a resposta seja positiva (aprovando a transao) emitido o
comprovante e enviada a perna de confirmao. Caso a rede autorizadora no receba esta
confirmao, diz-se que a mensagem ficou pendente de confirmao, ou simplesmente
pendente.
Bandeira
Entidade detentora de marcas e logotipos utilizados em cartes de crdito, dbito e outros meios de
pagamentos. Exemplos:
Visa
Mastercard
American Express
Visa Electron
Maestro
Cheque Eletrnico
Rede Autorizadora
Empresa que concentra o recebimento de transaes TEF de diversos estabelecimentos, e as
autoriza atravs de um sistema Autorizador. Exemplos:
Visanet
Redecard
TecBan
Servio
O termo servio no contexto do Scope define o objetivo de uma transao. Exemplos:
Consulta cheque
Estorno crdito
Estorno dbito
11
Grupo de Servios
Um servio no Scope pertence sempre a um grupo, que pode definir a forma de pagamento, ou
ainda, a tecla finalizadora do PDV. Exemplos:
Carto de Crdito
Carto de Dbito
Consulta Cheque
Recarga de Celular
Estorno
Produto
No Scope, um produto um Servio de uma Bandeira para uma Rede Autorizadora, Exemplos:
Compra com carto de crdito vista da bandeira Visa pela rede Visanet
Compra com carto de dbito vista da bandeira Maestro pela rede Redecard
Compra com carto de dbito voucher da bandeira Ticket pela rede Redecard
Produtos de Controle
Existem produtos no Scope que so utilizados apenas pelo Scope Server para controle. Estes
produtos no esto disponveis para seleo no perfil de servios do Scope Configurador. Exemplos:
Logon
O servio Logon utilizado para verificar a disponibilidade da rede autorizadora e, em alguns casos, para
obter informaes necessrias para as TEFs. Esta transao enviada pelo Scope Server logo aps a
efetivao da conexo (quando o Scope Server entra em operao ou aps uma queda e restabelecimento da
conexo). Nem todas as redes disponibilizam esta transao.
Carga On-Line
O servio Carga On-Line, tambm chamado de Inicializao de Tabelas On-Line, utilizado por algumas
redes para enviar dados de configurao ao Scope Server. Atravs deste recurso, estas redes autorizadoras
podem alterar dados, por exemplo, novos ranges de cartes, novos emissores, etc, sem interveno do
estabelecimento comercial e/ou software de TEF.
Sonda
A Sonda uma transao enviada pela rede autorizadora para o Scope Server para checar o
desfecho de uma transao que tenha ficado pendente. Uma transao fica pendente quando a
rede autorizadora no recebeu a confirmao de uma transao anteriormente aprovada.
A transao pode estar pendente apenas no contexto da rede autorizara (a terceira perna chegou
at o Scope Server mas no chegou rede autorizadora). Neste caso o status no banco de dados
do Scope est finalizado e a Sonda respondida confirmando ou desfazendo a transao. Ao
receber a resposta da Sonda, a rede autorizadora atualiza sua base com o status final da transao
fornecido pelo Scope.
12
Quando a confirmao no chegou nem mesmo no Scope Server (por exemplo, houve uma queda
de energia no PDV), o status no banco de dados estar como pendente. Neste caso a Sonda
respondida com o status de pendente e a rede autorizada continuar a sondar esta transao de
tempos em tempos. Ao final do prazo de sondagem (este prazo varia de rede para rede) a
autorizadora dar o desfecho padro (confirmar ou desfazer, dependendo da rede).
Para evitar que uma transao no fique pendente aps o prazo de sondagem, recomendado
verificar o Scope Pendncia uma vez ao dia. O procedimento de resoluo manual de pendncias
ser explicado posteriormente neste documento, dentro do captulo de administrao.
Estorno
Uma transao anteriormente aprovada e confirmada pode eventualmente ser estornada
(cancelada). A transao de estorno faz referncia outra transao j realizada e finalizada com
sucesso. Nem toda transao permite estorno. Depende se a transao original estornvel e se
a rede autorizadora disponibiliza este servio. A rede autorizadora pode estabelecer regras quanto
ao perodo permitido para estorno e quanto ao valor. Geralmente s possvel estornar o valor total
da compra. Verifique estas regras junto s redes autorizadoras.
Desfazimento
O conceito de desfazimento permitir que uma transao aprovada, porm no concretizada com
sucesso, seja desfeita. Neste caso a transao no chegou a ser confirmada. A desfazimento
realizado em duas pernas (solicitao e resposta). O Scope envia o desfazimento, quando
disponvel para este produto, nos casos em que, embora a rede tenha aprovado, no foi possvel
finalizar a transao com sucesso. A solicitao de desfazimento substitui a confirmao. Por
segurana, o Scope envia desfazimento tambm quando ocorrer timeout, ou seja,
solicitou
13
Instalao
_____________________________________________________________________________________________________
Instalao Server/Client
IMPORTANTE:
Toda instalao deve ser feita utilizando-se um usurio com direitos de administrador da
mquina.
Sugerimos a leitura do processo completo antes de iniciar a instalao, verificando se as
necessidades podero ser atendidas.
Server / Client
Aps certificar-se que tanto o Windows quanto o Gerenciador de Banco de Dados (SQL
Server ou Oracle) estejam instalados e atualizados, inserir o CD do Scope na unidade e
acessar a pasta \Instaladores\ScopeX.XX.XX.XX\Disk1 (onde XX.XX a verso e build
mais atual) e clicar em setup.exe. O programa de instalao ser iniciado. O instalador
verificar se nesta mquina j existe o Scope instalado. Caso seja uma atualizao de
verso, o instalador mostrar a tela abaixo.
14
Clicando em
15
Caso o tipo de instalao selecionado seja Custom, o instalador exibir a lista de mdulos
disponveis para a instalao.
Neste tipo de instalao, dependendo do mdulo, pode-se utilizar o boto Change para
alterar os componentes a serem instalados de um determinado mdulo.
16
Este
mdulo
utilizado
apenas
em
ambiente
de
desenvolvimento,
Neste momento, pode-se optar pela utilizao do SQL Server, Oracle ou DB2. Como as
opes possuem o mesmo fluxo de instalao, tomaremos como referncia o SQL Server.
IMPORTANTE: Para executar o Scope utilizando o banco de dados IBM DB2 8 ou superior,
observe os tpicos a seguir:
Configurar o banco de dados para trabalhar com o Isolation Level Read Uncommitted
.
17
Caso seja a primeira instalao, ser efetuada a coleta de endereo IP e porta TCP
designados aos mdulos servidores.
O primeiro mdulo o Scope Gateway. A seguinte informao ser solicitada:
Informe o endereo IP (ou nome) da mquina onde o Gateway ser instalado e pressione
.
Manual de Instalao e Configurao
Scope Soluo Completa para Pagamento Eletrnico 1.0 Verso 1 Reviso 1.6
18
Em seguida, informe o endereo IP (ou nome) da mquina onde ser instalado o mdulo
Scope Server.
Em seguida pressione
19
Em seguida, informe o nome do banco de dados a ser criado pelo instalador e utilizado pelo
Scope.
Pressione
20
.
.
Aps esse passo o instalador iniciar a cpia dos arquivos e configurao do sistema.
21
Aps o trmino da cpia dos arquivos, ser dado incio o processo de criao/atualizao
do banco de dados. Para isso, deve ser informado o nome do servidor de banco de dados,
o nome de logon e senha de um usurio com direito de administrador do banco de dados
para que a base do Scope seja criada, como mostra a figura abaixo.
22
O passo seguinte informar o nome de logon e senha do usurio que ser utilizado pelo
Scope. Se este usurio no for o SA padro do SQLServer, ento um usurio deve ser
criado, com permisso de escrita/leitura no banco de dados do Scope.
23
Aps colocar os mdulos como servio, podemos optar por criar os atalhos na rea de
trabalho do Windows, respondendo SIM na questo ilustrada abaixo.
24
Client
ScopeCon
Este mdulo compatvel com Windows 2000, Windows XP ou Windows 2003
25
26
Na tela abaixo, determine o diretrio para a instalao, alm dos usurios que tero acesso
ao Scope Conciliao e pressione
Aguarde a instalao.
27
Na tela abaixo, entre com os dados de conexo com o banco de dados de conciliao. O
campo Nome da Conexo apenas informativo e o campo Catlogo refere-se ao nome do
banco de dados.
A tela abaixo exibida para sinalizar que a instalao foi finalizada com sucesso.
28
IMPORTANTE:
Os mdulos Scope Configurador (ScopeCNF) e Scope Pendncias (ScopePND) acessa
somente o servidor de produo.
O mdulo Scope Conciliao Eletrnica (ScopeCON) acessa somente o servidor de
conciliao.
O mdulo Scope Administrador (ScopeADM) acessa ambos os servidores.
29
Instalao do ScopeWeb
Instalao padro
Passo 1: Execute o arquivo S cope Web .e xe para iniciar o processo de instalao:
Passo 3: A tela de confirmao, Instalar ScopeWeb ser exibida, clique no boto Sim:
30
Passo 4: Ser exibida a tela inicial do instalador, clique no boto Prximo para continuar a
instalao:
31
32
Base / SI D deve ser preenchido com o nome da base de dados, no caso de SQL Server e
DB2 ou com o S ys tem I D no caso do Oracle.
Os campos: Us u rio e Se nha devem ser preenchidos com o usurio e senha de acesso
ao banco de dados. Aps preencher todos os campos, clique em Prximo.
Passo 7: Ser exibida a tela para configurar dados do usurio administrador das conexes
do ScopeWeb:
admi ni str ad or do S cop eWeb a senha desse usurio. Aps preencher todos os campos,
clique em Prximo.
Passo 8: Ser exibida a tela, Iniciar Cpia de Arquivos, ento clique em Prximo:
33
34
Instalando o Java
Passo 1: Caso o instalador no detecte a instalao do JDK 6 ser exibida uma mensagem
solicitando a instalao do mesmo:
Passo 2: Aguarde alguns instantes at a primeira tela de instalao do Java ser exibida:
35
E aps mais alguns instantes, ser exibida a tela com a Licena do Java:
Clique no boto Accept para concordar com a licena e aguarde a prxima tela.
36
As seguintes modificaes devem ser feitas: Clique em Java DB marque a opo Thi s
feat ure w ill not be a va ilab le . Clique na seta () de cada um dos itens: De mos a nd
Sam ple s , So urce C ode e P ubl i c JRE e marque a opo Don' t i nstal l t hi s feat ure
no w para cada um deles.
A figura, abaixo exemplifica melhor como a deve ficar aps a configurao descrita:
37
38
Instalando o Tomcat
Passo 1: Caso o instalador no detecte a instalao do Tomcat 5.5 ser exibida uma
mensagem solicitando a instalao do mesmo:
39
40
Passo 6: Ser exibida a tela Configuration Options. Os dados no devem ser alterados,
clique em Next para prosseguir:
Passo 7: Na tela para seleo da Java Virtual Machine clique no boto (...) para alterar o
caminho:
41
Altere o caminho para a pasta JRE que estar dentro do diretrio de instalao do JDK 6 e
clique em Ok:
42
Passo 9: Desmarque as caixas de seleo Run Apa che Tom cat e S how Rea dme e
clique no boto Finish:
43
44
Configurao
_____________________________________________________________________________________________________
Configurando o Scope
ScopeCNF
O Scope Configurador o mdulo responsvel pelo cadastro e manuteno dos dados de
parametrizao do Scope. Exemplos:
Usurios: Gerenciamento de usurios com controle de acesso e direitos.
Topologia da Rede: Para definir localizao (endereos IP) e portas de comunicao dos
mdulos servidores e roteador.
Estrutura da Empresa: Definio das empresas, filiais e PDVs.
Perfil de Servio: Para definir quais produtos sero aceitos e relao de prioridade entre
eles.
Contratos: Cadastramento dos cdigos de estabelecimento fornecidos pelas redes
autorizadoras.
Dados cadastrais : Ter em mos os dados cadastrais sobre a empresa, tais como
Filiais : Ter em mos os dados cadastrais sobre as filiais que sero atendidas pelo
Scope.
mquinas e Path Router (roteador) a serem utilizados (para configurao dos mdulos).
Perfil de Servios: Estabelecer os servios que estaro disponveis nos PDVs das
Iniciando o ScopeCNF
Manual de Instalao e Configurao
Scope Soluo Completa para Pagamento Eletrnico 1.0 Verso 1 Reviso 1.6
45
O ScopeCNF pode ser iniciado pela rea de trabalho do Windows, atravs do acionamento
do cone a seguir:
. A tela
apresentada ser:
46
Informe os dados da conexo, como: Nome do DSN, servidor, provedor (para SQL use o
SQLOLEDB), Catlogo (nome no banco de dados) e dados de usurio (forma de
autenticao, usurio e senha). Para finalizar, pressione
e ento
Aps a identificao do usurio, a tela principal do mdulo ser exibida com as opes a
seguir.
Arquivos
O menu arquivo apresenta as seguintes opes:
Menu Arquivos > Parmetros: Exibe as verses correntes de Script, trabalho e banco
de dados.
Verso de Trabalho: indica a verso de trabalho atual na base. Esta verso permite
que diversos parmetros sejam cadastrados/alterados sem afetar a verso de produo
at que seja finalmente aplicada em um momento apropriado.
Verso Corrente do Banco: indica a ltima verso aplicada no banco de produo.
Verso do Script:
47
Menu Arquivos > Importa Script: Esta opo importa um script SQL sobre a verso de
trabalho presente no banco.
Desfazer Verso de Trabalho: Esta opo desfaz as alteraes antes da verso ser
aplicada e retorna ao estado anterior.
Configurao de Impressora: Permite configurar o tipo de impressora a ser utilizada para
impresso de relatrios.
Cadastros
Esta opo do menu a mais importante e responsvel por todo o cadastramento do
sistema. Nela podemos definir a topologia da rede, elaborar perfis de servios referentes
bandeiras e produtos utilizados, cadastrar empresas e filiais, perfil do hardware utilizado,
cdigos de contrato com as diferentes redes, etc.
48
Banco de Dados: Esta opo permite o cadastramento das informaes sobre a base de
dados a ser utilizada pelo Scope, e tambm, informaes pertinentes a configurao do
banco de dados de transao. As informaes referente a base de dados utilizada pelo
scope so solicitadas na instalao do sistema e inseridas automaticamente nesta opo,
no necessitando de manuteno, contudo as informaes de configurao do banco de
dados de transao devem ser fornecidas na medida da necessidade.
49
50
Uma vez cadastrado o roteador, necessrio relacionar as redes autorizadoras que faro
parte do sistema, como a Tecban, Visanet, entre outras. Este relacionamento pode ser feito
acessando a opo de Cadastros > Topologia da Rede > Roteamento > Redes
Autorizadoras, ou atravs do boto
no cadastro de roteadores.
Neste cadastro, devemos relacionar qual porta do roteador ser utilizada pela rede.
Tambm devemos informar qual link X25 deve ser utilizado pela rede e qual o endereo
RENPAC da rede.
51
O Gateway cadastrado deve ser associado ao Roteador do sistema. Esta associao deve
ser feita atravs de Cadastros > Topologia da Rede > Gateway > Roteador do
Gateway,ou via boto
Server: Necessrio para o cadastramento do(s) Server(s) do sistema. Deve ser informado o
endereo IP do Server,a porta TCP utilizada pelo mdulo, a IBD associada a ele e um nome
descritivo para o mesmo.
52
53
Perfil de Servio
Como citado anteriormente, o Perfil de Servios controla o agrupamento, a prioridade e a
parametrizao dos produtos disponveis.
ser cadastradas caso tratar-se de perfil que ter associado a ele, algum servio de carto
de crdito ou dbito. Alm disto, deve-se observar as restries impostas pelas redes, tais
como, envio destas informaes via carga on-line ou suporte ou no estas informaes por
parte da rede.
54
Aps a incluso do perfil de servio, devemos acrescentar os produtos que comporo este
perfil, clicando no boto
55
IMPORTANTE: Normalmente, existem dois servios de crdito parcelado: pela loja (sem
Nesta tela, a relao de prioridade estabelecida pela posio dos produtos. Mais acima
indica mais prioritrio.
Para este exemplo, o servio Dbito Vista est configurado da seguinte forma: a
bandeira Cheque Eletrnico via rede TECBAN-2.0 como prioritrio sobre a bandeira
Maestro via rede REDECARD-L0205. Neste caso, se o carto dbito possui as referidas
bandeiras, a transao ser roteada prioritariamente para a rede TECBAN-2.0 e em caso
de falha na conexo, pela rede REDECARD-L0205.
Manual de Instalao e Configurao
Scope Soluo Completa para Pagamento Eletrnico 1.0 Verso 1 Reviso 1.6
56
Note que esta relao de prioridade pode ser estabelecida de forma a refletir acordos
contratuais firmados. No exemplo acima, a TECBAN foi escolhida como mais prioritria por
apresentar uma taxa mais vantajosa para o estabelecimento comercial.
Para os servios Credito Vista e Crdito Parc. Loja sob a bandeira AMEX, a transao
ser roteada prioritariamente para a rede AMEX, e em caso de falha na conexo pela rede
57
VISANET-4.1. Observe que o servio Crdito Parc. Adm est disponvel somente para o
conjunto bandeira AMEX, rede AMEX.
A tela de controle de perfil de produtos, ilustrada abaixo, ser apresentada nos casos de
manuteno de perfil de servios j aplicado a filiais e/ou PDVs, sob escopo de contratos. A
funo desta tela a de avaliar e/ou apresentar incoerncias relativas incluso/excluso
de produtos em perfis, cujas bandeiras no estejam vinculadas ao contrato (vide tpico
Cadastros > Contrato). Nestes casos, cabe ao responsvel pela manuteno do referido
perfil, a tomada de deciso: O sistema dever ou no incluir/excluir as respectivas
bandeiras, nos contratos onde a incoerncia foi detectada.
IMPORTANTE: Para as redes Visanet 20001, Visanet 4.1, Redecard L0205 e Amex,
podem existir parmetros semelhantes enviados atravs da carga on-line de tabelas. Neste
Manual de Instalao e Configurao
Scope Soluo Completa para Pagamento Eletrnico 1.0 Verso 1 Reviso 1.6
58
caso, o Scope Server respeita o que foi definido pelas redes autorizadoras. No caso de
habilitao ou no de produtos, se existir esta configurao nas tabelas on-line, o Scope
Server efetua um and entre a configurao do perfil de servios e da tabela on-line. Por
exemplo, para que a transao de Dbito Voucher esteja habilitada, este produto deve estar
habilitado no perfil de servios e na tabela on-line da rede em questo.
59
acessado atravs do menu Perfil > Servios > Parmetros, cujo servio seja Consulta de
Cheques Pr-datados, e selecionando-se a aba Detalhe. O exemplo abaixo demonstra
esta opo para a rede SERASA. Observe que os critrios so sempre separados entre
clientes no cadastrados em qualquer lista (Positiva ou Negativa), e clientes cadastrados na
lista positiva. Vide tela abaixo.
Define-se qual o valor de limite de risco para os dois tipos de clientes. At os valores
estipulados, aplicam-se os critrios de freqncia percentual de consulta na rede SERASA,
que podem ser aleatrios ou um percentual pr-definido. Acima dos valores, ser sempre
realizada a consulta rede.
Perfil de Hardware
60
Para cadastrar o tipo de hardware a ser controlado pelo Scope, acione o boto
e iniciar
A opo Uso Exclusivo do Scope deve ser marcada quando o aplicativo PDV no faz
acesso direto ao PinPad.
Quando esta opo est marcada, o Scope Client efetua a operao de Open e Close no
perifrico. Quando no est marcada, indica que o aplicativo PDV compartilha acesso ao
PinPad e neste caso, as operaes Open e Close so de responsabilidade do aplicativo
PDV.
61
IMPORTANTE: Para utilizar as redes Visanet 4.1 e Redecard L0205, necessrio que os
PinPads dos PDVs sejam do tipo compartilhado, nomenclatura adotada pelas redes
autorizadoras para indicar que o PinPad compartilhado entre Visanet, Redecard e Amex e
est preparado para cartes com chip padro EMV.
empresa, onde informaremos dados mais especficos, alm de atribuir um perfil de servios,
como mostra a figura a seguir.
62
localizado na barra de
Ao cadastrar um PDV, pode-se definir perfis de hardware e servio diferentes para cada
PDV, proporcionando maior flexibilidade nas configuraes do terminal.
63
64
No campo Hora Inicializao pode ser configurado o melhor horrio para que o Scope
Server faa a carga on-line de tabelas caso uma atualizao no imediata seja solicitada
pela rede autorizadora.
Algumas redes podem fornecer, alm do cdigo de estabelecimento principal, outros
cdigos de estabelecimentos, um para cada bandeira a ser aceita. Esta configurao feita
atravs do campo Estabelecimento 2, na lista de bandeiras. Vide exemplo abaixo:
IMPORTANTE:
coluna
Estabelecimento
2,
preenchida
na
tela
principal
de
65
desenvolvimento do Scope Client explica a funo a ser utilizada pelo aplicativo PDV para
fornecer estes dados.
IMPORTANTE: Note que este recurso precisa ser implementado pelo aplicativo PDV.
Consulte a empresa responsvel pelo desenvolvimento de seu aplicativo PDV para
consultar disponibilidade e maiores detalhes antes de efetuar o cadastramento.
Consultas
Atravs deste menu, diversas consultas esto disponveis, entre elas: Carga de tabelas das
redes Autorizadoras, Configuraes das redes, Cadastro de Bins, etc.
66
Esta opo mostra os BINs cadastrados no Scope, filtrados por Bandeira Rede ou Grupo
de Servio. Vide a seguir um exemplo de consulta BIN por bandeira e rede.
67
68
Ferramentas
Atravs desta opo possvel efetuar o cadastro de usurios, incluir temporariamente um
BIN e analisar possveis erros na configurao. A opo Baixa Tcnica por Filial exibe os
PinPads que tiveram substituio cadastrada no ScopeCNF. Esta troca dispara uma
transao para a rede autorizadora. Estas transaes podem ser consultadas atravs desta
opo.
69
70
Aps incluir o nome do perfil, podemos selecionar os itens disponveis atravs do boto
Uma lista de itens disponveis ser exibida e a seleo deve ser feita de maneira anloga
ao perfil de servios.
71
no cadastro
72
Ao clicar em
ser exibido o cadastro inicial da baixa tcnica PDV. Ao incluir uma nova
baixa, as informaes ilustradas abaixo sero solicitadas. Estas informaes podem ser
fornecidas pelo tcnico que efetuou a instalao do mdulo SAM.
Aps o cadastramento, clicar em Confirmar e aguarde que a baixa imediata seja realizada.
Isso acontecer caso a opo Gravar sem enviar no esteja marcada. Caso contrrio, a
baixa poder ser efetivada atravs da opo Baixa Tcnica por Filial, acessada atravs do
menu Ferramentas. Se acionado por esta opo, o aplicativo exibir o seguinte formulrio:
Para enviar uma baixa tcnica PDV para a VISANET 20001 basta selecionar o PDV
desejado e clicar em Enviar. A baixa ser realizada instantaneamente, similar ao processo
destacado na figura anterior.
73
Atravs desta ferramenta possvel cadastrar um BIN de forma temporria, apenas para
suprir eventuais necessidades. No use esta opo sem orientao do suporte, geralmente
ela no necessria, j que o Scope possui internamente as tabelas de BINs.
Gateway de Contingncia
A configurao de rotas de contingncia pode ser utilizada para garantir maior
disponibilidade do sistema de TEF em casos de problemas de link entre Scope Gateway e
as redes autorizadoras. Caso haja uma rota de produo e outra de contingncia
(geralmente por outro provedor X.25), em caso de falha no link principal, o Scope Gateway
ser capaz de restabelecer a conexo atravs da rota alternativa.
Ao perceber uma queda no link principal, o Scope Gateway tenta restabelecer a conexo,
ainda atravs do link principal e caso no obtenha sucesso, tenta atravs da rota de
contingncia. A operao deste recurso est detalhada no captulo sobre Scope Gateway.
74
75
Aps clicar em
autorizadoras. Neste ponto, necessrio informar que a rede a ser cadastrada trabalha em
regime de contingncia, atravs da opo de Contingncia/Produo disponibilizada no
cadastro das redes. A opo Funo s estar disponvel se o cadastro em questo for de
contingncia de uma mesma rede j cadastrada no roteador de produo. A figura a seguir
ilustra o cadastro das redes. Ele o mesmo utilizado no cadastramento tradicional,
realizado na etapa inicial de configurao do Scope.
76
para confirmar.
77
A conexo com a rede poder retornar ao roteador principal aps um Reset Manual
atravs do boto Reset Rede do Scope Gateway. Em seguida, o Scope solicitar a
confirmao de reset da rede exibindo a opo de retorno de contingncia habilitada.
Atuando no Servidor
Atuando no servidor Scope este arquivo permite a ativao de LOGs de ocorrncias.
Atravs destes LOGs possvel rastrear eventuais problemas.
Parametrizao de LOG
As chaves que tratam do LOG permitem configurar o diretrio de gravao, tamanho de
cada arquivo, quantidade de arquivos, nveis de trace e os contadores de autorizadora. A
ativao destes LOGs aconselhada para monitoramento de problemas na execuo, uma
vez que toda gravao de LOG representa um consumo de recurso extra. A seguir, temos a
estrutura do arquivo Scope.ini localizado no servidor.
78
[SCOPELOGSRV]
TraceLevel=8
LogPath=C:\WinNT\Scope
LogFiles=2
LogSize=3072000
[SCOPELOGGW]
TraceLevel=8
LogPath=C:\WinNT\Scope
LogFiles=2
LogSize=3072000
LogDiasSalvos=15
Parmetros de LOG
O nome do arquivo de LOG segue o formato: ScopeLogSRV.log, onde a sigla SRV pode
variar, dependendo do mdulo (SRV: Scope Server e GW: Scope Gateway).
Informativo
Informativo detalhado
Conexes
5
6
Queries com BD
Informaes de trace
79
onde
NomeDaRede
rede
autorizadora
correspondente;
AAAAMMDD corresponde a data no formato ano, ms e dia.
Exemplo: REDECARD20080310.Log
Parmetros de configurao
Name: Determina o endereo IP do Scope Server na rede. No exemplo acima
128.70.2.2.
Port: Determina a porta TCP onde o mdulo Scope Server encontra-se ativo.
Normalmente o Scope Server trabalha na porta 2046, mas esta configurao deve
80
[GLOBAL]
AtivarCMS=1
NumScopeServer=3
SCPSRV01=Scope01
PORTSRV01=2046
SCPSRV02=10.50.9.131
PORTSRV01=2046
SCPSRV03=10.50.9.133
PORTSRV03=2046
SCPBINCACHE=1
SCPBINCACHENAM=C:\CMSBINCache.tmp
AtivarCMS: Indica se ativa soluo Scope Cliente com conexo a vrios servidores Scope.
Valores: 1 (Ativado) ou 0 (Desativado) , sendo o default 0
NumScopeServer: Nmero de servidores Scope que o Scope Cliente pesquisar buscando
qual tratar sua requisio. Valores: 1 a 10.
SCPSRV01: Nome ou endereo IP do primeiro servidor Scope a ser pesquisado pelo Scope
Cliente.
PORTSRV01: Porta TCP do primeiro servidor Scope a ser pesquisado pelo Scope Cliente.
SCPSRV02: Nome ou endereo IP do segundo servidor Scope a ser pesquisado pelo
Scope Cliente.
PORTSRV02: Porta TCP do segundo servidor Scope a ser pesquisado pelo Scope Cliente.
Manual de Instalao e Configurao
Scope Soluo Completa para Pagamento Eletrnico 1.0 Verso 1 Reviso 1.6
81
SCPSRV03: Nome ou endereo IP do terceiro servidor Scope a ser pesquisado pelo Scope
Cliente.
PORTSRV03: Porta TCP do terceiro servidor Scope a ser pesquisado pelo Scope Cliente.
Obs.: Podem ser configurados at 10 endereos IP e portas TCP a ser pesquisado pelo Scope Cliente.
[RangeRedecardPRIVATE]
QtdRange=N
MinRange1=BBBBBB
MaxRange1= BBBBBB
MinRange2= BBBBBB
MaxRange2= BBBBBB
.
.
.
MinRangeN= BBBBBB
MaxRangeN= BBBBBB
Note que:
Configurando o ScopeWeb
Aps a instalao do ScopeWeb, necessria uma pequena configurao no Tomcat. O
usurio deve utilizar os seguintes passos:
Passo 1: Clicar em Menu Iniciar, depois em Programas, depois localizar o item Apache
Tomcat 5.5 e ento clique em Configure Tomcat:
82
83
84
Apndice A - Glossrio
_____________________________________________________________________________________________________
clientes.
Adquirente: a entidade ou associao de entidades
financeiras (ServiRed, Euro6000, Sistema 4B) que
BIN
dgitos do carto.
estabelece o
devido
(bank
identification
number):
nmero
de
Amex).
da empresa.
Embosso: .
o Banco emissor.
(card holder).
G
Grupo de servio: um servio no Scope pertence
85
tambm PoS.
Linkedio: .
PDV.
Masterkey:.
Rede
autorizadora:
recebimento
Megabyte: Unidade correspondente a 1048576 bytes.
de
empresa
transaes
que
TEF
concentra
de
diversos
86
eletrnicos
o mdulo
conectados em rede.
e software.
T
TSR: abreviao do termo em ingls Terminate and
W
Web: Abreviatura para designar o World Wide Web.
87
88
2007
Esse documento propriedade da Itautec S.A. Grupo Itautec.
Tem carter tcnico/informativo. Todos os direitos so reservados.
No pode, no todo ou em parte, ser copiado, fotocopiado, reproduzido, traduzido ou reduzido a qualquer meio eletrnico
ou forma legvel por mquina, sem a autorizao escrita da I t a u t e c S . A . - G r u p o I t a u t e c .
Esta se reserva, por outro lado, o direito de alterar seu contedo e forma, sem qualquer aviso prvio.
Produzido no Brasil.
Manual do usurio
Scope Soluo Completa para Pagamento Eletrnico V1.0 Verso 1 Reviso 1.2
89