Manual Tecnico ItauShopline

Ita Shopline
Guia de Identidade Visual

Manual Tcnico do Desenvolvedor
2
Introduo
Voc contratou o Ita Shopline e agora sua loja virtual conta com uma plataforma completa de meio
de recebimento on-line que atende clientes e no clientes Ita.
Confira os principais benefcios para sua empresa:
Praticidade, segurana e controle: contratao e instalao pela internet, com gesto completa
dos pagamentos pelo Ita Empresas na internet;
Sua empresa fica disponvel 24 horas por dia, 7 dias por semana;
Aumenta sua relao de clientes potenciais: atende clientes Ita, no correntistas e at quem no possui
conta bancria;
Mais possibilidades para seus clientes pagamento atravs de qualquer carto de crdito: MasterCard, Visa,
Hipercard e Diners, dbito em conta, boleto bancrio ou financiamento.
Neste Manual Tcnico do Desenvolvedor Ita Shopline voc encontra as diretrizes para aplicar e implementar o produto.
Nele tambm consta um guia de identidade visual com todos os elementos grficos do Shopline.
Avanar Voltar Home
Guia de Identidade Visual
Avanar Voltar ndice Home
Identidade visual Ita Shopline
Ita Shopline | Dbito em conta e financiamento
Ita Shopline | Boleto bancrio
Ita Shopline | Carto de crdito
Ita Shopline | Aplicao em diferentes formas
Ita Shopline | Usos incorretos - cenrios de/para
Avanar Voltar Home
ndice
4
Manual Ita Empresas dezembro 2012
2
0
1
0
I
t
a
U
n
i
b
a
n
c
o
H
o
l
d
i
n
g
S
.A
.
DimaiDesign
O Ita Shopline uma
plataforma de meios de
pagamentos que oferece
as opes de dbito em
conta, financiamento, boleto
bancrio e carto de crdito
aos compradores do site da
sua empresa.
Atente para o uso correto
dos cones novos para
Ita Shopline. E sempre
utilize os arquivos fornecidos
pelo Ita Unibanco.
Identidade visual Ita Shopline
Nomenclatura Arquivo a ser usado Definio
Mdia
dbito em conta
financiamento
boleto bancrio
cartes de crdito
formas de pagamento Ita
O dbito em conta uma opo para
correntistas do Ita e deve ser sempre
representado pela marca Ita sobre o
fundo laranja.
O financiamento uma opo para correntistas
do Ita e deve ser sempre representado pela
marca Ita sobre o fundo laranja.
O boleto bancrio uma opo para clientes
e no clientes do banco Ita e pode ser
representado pelo cone ao lado, que tem a
imagem de um cdigo de barras.
A opo de carto de crdito vale para clientes
e no clientes Ita e deve apresentar as marcas
das bandeiras que podero ser utilizadas para
o pagamento.
O boto formas de pagamento Ita um
GIF animado que mostra todas as opes
de pagamento possveis para o consumidor.
Ele direciona o usurio para uma pgina Ita
onde deve ser confirmada a forma de pagamento.
5
2
0
1
0
I
t
a
U
n
i
b
a
n
c
o
H
o
l
d
i
n
g
S
.A
.
DimaiDesign
O cone da marca Ita ser
usado para representar dois
meios de pagamento, dbito
em conta e financiamento.
A regra para este cone o uso
da marca Ita sobre o fundo
laranja, preferencialmente na
forma quadrada: 130x130 px
(para uso em outras formas,
verificar pg. 4).
Sempre use o arquivo
fornecido pelo Ita Unibanco.
Ita Shopline | Dbito em conta e financiamento
A relao indicada acima define a
rea de reserva da marca Ita para
seu uso neste cone. Esta reserva
indica o mnimo de distncia que se
deve ter da marca para preservarmos
sua leitura.
x
x/2
x
/
2
R 238 G 114 B 3
R 0 G 51 B 153
R 255 G 204 B 0
No desrespeitar a rea
mnima de proteo.
No utilizar nenhuma das verses
da marca Shopline no checkout.
No usar a marca fora
do fundo laranja.
No usar o nome fora
da forma original.
No cortar a marca.
No inclinar ou
distorcer a marca.
No aplicar
efeitos marca.
No trocar a cor de
fundo da marca.
Importante:
6
2
0
1
0
I
t
a
U
n
i
b
a
n
c
o
H
o
l
d
i
n
g
S
.A
.
DimaiDesign
Para identificar o pagamento por boleto
bancrio, sempre use o cone acima
respeitando sua proporo e no fazendo
uso indevido de sua aplicao.
R 147 G 149 B 152
O cone de boleto ser usado
para representar o pagamento
feito atravs do boleto bancrio.
Sua largura em formato
preferencial de 140 px.
E sua cor cinza conforme
especificado pelo cdigo ao lado.
Sempre use o arquivo
fornecido pelo Ita Unibanco.
No exagere no tamanho
do cone.
No troque a
cor do cone.
No aplique efeitos no cone.
No distora o cone.
Ita Shopline | Boleto bancrio
Importante:
7
2
0
1
0
I
t
a
U
n
i
b
a
n
c
o
H
o
l
d
i
n
g
S
.A
.
DimaiDesign
Para cartes de crdito, apresentar as
bandeiras respeitando reas de proteo
e convivncia. Sempre que possvel,
utilize o formato preferencial da marca
Hipercard como base de referncia.
Para a identificao de
pagamento atravs de
cartes de crdito, a regra
identificar quais cartes
so aceitos atravs de suas
respectivas marcas.
As marcas dos cartes esto
disponveis no Ita Empresas
na internet.
Como referncia, a marca
do Hipercard deve ser usada
em formato preferencial de
220x130px.
Ita Shopline | Carto de crdito
Importante:
No use formatos desproporcionais entre as
marcas destacando ou priorizando alguma delas.
No altere os arquivos de marca recebidos.
No aplique efeitos nos cones.
8
2
0
1
0
I
t
a
U
n
i
b
a
n
c
o
H
o
l
d
i
n
g
S
.A
.
DimaiDesign
O formato em que as marcas
so aplicadas pode ser
adaptado, respeitando a
proteo mnima de cada
uma delas, dependendo da
diagramao do site.
As marcas devem ser
padronizadas, sempre que
possvel, respeitando suas
regras de convivncia.
Ao lado, exemplos de modos
corretos de adaptao nos
formatos da marca Ita.
Para mais detalhes, consulte
o ltimo Guia da Marca.
Em alguns sites, a diagramao
indica uma aplicao que difere
da preferencial quadrada. Nesses
casos, respeite a rea de proteo
da marca Ita.
Ex.: aplicao em forma quadrada Ex.: aplicao em forma retangular Ex.: aplicao em forma redonda
FORMAS DE PAGAMENTO FORMAS DE PAGAMENTO FORMAS DE PAGAMENTO
Boleto bancrio Boleto bancrio Boleto bancrio
Carto de crdito Carto de crdito Carto de crdito
Dbito em conta
Financiamento
Dbito em conta Dbito em conta
Financiamento
Financiamento
Ita Shopline | Aplicao em diferentes formas
9
2
0
1
0
I
t
a
U
n
i
b
a
n
c
o
H
o
l
d
i
n
g
S
.A
.
DimaiDesign
No descreva as formas de pagamento
fora do padro de nomenclatura e use
os cones relacionados a cada uma delas.
Utilize somente os arquivos fornecidos
pelo Ita Unibanco.
No use cones genricos no fornecidos
pelo Ita Unibanco.
Ita Shopline | Usos incorretos - cenrios de/para
No use outro boto de forma de
pagamento que no seja o entregue pelo
Ita Unibanco.
Nunca utilize Ita Shopline, use a
nomenclatura correta para cada servio,
conforme descrito neste manual.
De:
Para:
10
2
0
1
0
I
t
a
U
n
i
b
a
n
c
o
H
o
l
d
i
n
g
S
.A
.
DimaiDesign
O GIF animado tem formato
preferencial de 200x93 px.
Ele composto por
elementos que no podem
ser alterados, mantendo as
mesmas caractersticas em
todos os sites em que for
encontrado. O GIF e seus
elementos no podem
ser redesenhados.
Para isso, existem algumas
regras que devem
ser seguidas.
GIF animado
O formato do GIF foi retirado da curva do
shape Ita. Use o GIF sempre em laranja
com fundo animado.
No distora o GIF.
No mude a cor
do fundo.
No altere os
elementos.
Importante:
11
2
0
1
0
I
t
a
U
n
i
b
a
n
c
o
H
o
l
d
i
n
g
S
.A
.
DimaiDesign
O GIF animado deve
mostrar todas as opes de
pagamento possveis para
o consumidor.
Para isso, ele dividido
em fases que direcionam
o cliente para o tipo de
pagamento escolhido.
Ao clicar no GIF animado,
o usurio direcionado
para uma pgina onde ele
deve confirmar a forma de
pagamento. Essa pgina
organizada seguindo as
orientaes do Guia da Marca
Ita, com a aplicao dos
novos cones.
GIF animado
Fase 1 Fase 4
Fase 2 Fase 5
Fase 3 Fase 6
12
Manual Tcnico do Desenvolvedor
14
ndice
1. Informaes Gerais
1.1 Utilizao do Ita Shopline
1.2 Configurao do Ita Shopline
1.3 Instalao do Ita Shopline

2. Servios do Ita Shopline
2.1 Mdulo Ita Shopline
2.1.1 Informaes Cadastrais do Site Lojista
2.1.2 Instrues de Implantao do Produto
2.2 Gerao do Ita Shopline
URL Principal de Acesso ao Produto
2.3 Reemisso de Boletos
2.4 Retorno On-line do Tipo de Pagamento
2.5 Consulta de Operaes Realizadas via Ita Shopline
2.5.1 Consulta de Operaes do Mdulo Ita Shopline
2.5.2 Arquivo Retorno de Cobrana
2.5.3 Consulta Automtica Situao do Pagamento (sonda)
2.6 Ita Shopline Multibandeira

3. Layout dos Campos
3.1 Parmetros e Critrios de Consistncias

4. Informaes Tcnicas
4.1 Usando Itaucripto.dll - Para Ambientes Microsoft
4.1.1 Passo 1: Criptografia
4.1.2 Passo 2: Chamada Tela do Ita Shopline
4.2 Para Ambientes Unix ou Linux
5. Exemplo de Cdigos
5.1 Usando Itaucripto.dll Para Ambientes Microsoft
5.1.1 Envio dos Dados Pgina Inicial HTML
5.1.2 Criptografia dos Dados Cdigo ASPX
5.1.3 Retorno do Tipo de Pagamento Cdigo ASPX
5.1.4 Consulta Situao do Pagamento Cdigo ASPX
5.1.5 Reemisso do Boleto Cdigo ASPX
5.2.2 Criptografia dos Dados Cdigo Java
5.2.3 Retorno do Tipo de Pagamento Cdigo Java
5.2.4 Consulta Situao do Pagamento Cdigo Java
5.3 Envio e Criptografia dos Dados Cdigo PHP
6. Auxlio Instalao do Ita Shopline
6.1 Mensagem de Erro de Sistema
Anexos Demonstrativos
Avanar Voltar Home
15
1. Informaes Gerais
O Ita Shopline uma plataforma completa de meio de recebimento on-line
para clientes Ita Empresas que querem vender pela internet.
E para os consumidores uma forma rpida e segura para comprar pela internet.
Ao vender produtos ou servios pela internet e disponibilizar o Ita Shopline
como meio de pagamento, seu site ir proporcionar a seus clientes uma maneira
simples, prtica e segura de efetuar pagamentos, tendo a oportunidade de escolher,
entre as opes oferecidas pelo Ita, a mais conveniente.
As opes de pagamento que atualmente compem a plataforma Ita Shopline so:
Dbito em conta - carteira de cobrana 178;
Financiamento - carteira de cobrana 178;
Cartes de crdito (MasterCard, Visa, Hipercard e Diners) - Filiado
Redecard;
Boleto bancrio - carteira de cobrana 176.

As duas primeiras opes so exclusivas para clientes Ita que acessarem este meio
de pagamento no site do lojista, o carto de crdito (MasterCard, Visa, Hipercard
e Diners) e o boleto atendero necessidade de liquidao financeira de todos
os compradores do site. Para habilitar a opo de cobrana por carto de crdito
necessrio que o site lojista esteja filiado Redecard, cadastrado no Komerci Web
Service e ter cadastro junto ao banco Ita com seu cdigo de filiao.
O Ita Shopline a nica forma de cobrana do banco Ita que integra diversas
opes de pagamento numa s plataforma e procura dar nfase para a liquidao
on-line, agilizando o processo de compra pela internet.
16
1.1 Utilizao do Ita Shopline
Independentemente do modelo de negcio de cada site, isto , se o processo
de compra ocorre em sequncia at chegar ao resumo da compra ou se o site envia
a seus clientes uma fatura por e-mail, haver um determinado momento em que
o Ita Shopline ser selecionado pelo comprador como forma de pagamento
e, a partir desse momento, a plataforma de cobrana do Ita ser apresentada
ao usurio final do site, que realizar a liquidao financeira do pagamento
em ambiente seguro Ita.
O modelo de negcio do site lojista (cedente) no invalida o funcionamento
da soluo de cobrana oferecida pelo Ita Shopline, pois o nico pr-requisito
necessrio haver um momento em que o servidor do site envie ao servidor
do banco os parmetros de cobrana a serem usados para concretizar a liquidao
financeira solicitada.
Para identificar corretamente a forma de pagamento Ita Shopline oferecida
em seu site, utilize sempre a nomenclatura Formas de Pagamento Ita e,
caso precise, disponibilizaremos um banner para divulgao da plataforma.
Neste material constam todas as orientaes sobre a correta utilizao da marca
Ita no site da loja virtual.
Ao acessar o Ita Shopline, o cliente navega pelas telas das opes e efetua
seu pagamento, selecionando uma das opes disponveis. O lojista avisado
sobre a finalizao da compra e a opo de pagamento escolhida pelo cliente,
em ambiente Ita, atravs do Retorno On-line do Tipo de Pagamento.
Por segurana, deve vir at o ambiente Ita para confirmar a situao de pagamento
do pedido em questo. Para mais detalhes, vide item 2.5. deste manual.
1. Informaes Gerais
A consulta de informaes referentes aos pagamentos efetuados via Ita Shopline
disponibilizada pelo banco Ita de trs maneiras distintas: Consulta de Operaes
do Mdulo Ita Shopline, Arquivo Retorno de Cobrana e Consulta Automtica
da Situao do Pagamento (Sonda).
A empresa escolhe a consulta que mais lhe convm. Para mais detalhes sobre essas
consultas, veja o item 2.5. deste manual.
Em cada uma das consultas disponveis, o banco informar a opo de pagamento
escolhida para o pedido e confirmar sua situao de pagamento em funo
da ao de pagamento do comprador, do prazo de floating de crdito negociado
para as carteiras de cobrana e do prazo de compensao da forma de liquidao
do pedido, determinando, assim, diferentes status para acompanhamento.
17
1.2 Configurao do Ita Shopline
Para configurar o Ita Shopline, necessrio que o site esteja vinculado a uma
conta-corrente pessoa jurdica no banco Ita com: cadastro nas carteiras 176
e 178 da Cobrana Eletrnica Ita, acesso ao Ita Empresas na internet e contrato
formalizado para utilizar o Ita Shopline.
Para contratar* o Ita Shopline, o cliente deve acessar: Ita Empresas na internet
> Recebimentos > Ita Shopline > Contratar, ou atravs do responsvel pela
conta-corrente do site, formalizando a proposta de contratao do produto
junto ao Ita Empresas na internet. Assim que a proposta aprovada,
encaminhada uma confirmao por e-mail indicando o acesso s instrues
de cadastro e instrues de implantao do produto em seu site.
*Na contratao, o nome do site no pode conter caracteres especiais.
Ex: @, #, $, &, , etc.
Todas as Informaes Cadastrais do site e as Instrues de Implantao
para uso do produto so disponibilizadas ao responsvel pela conta-corrente
do site no Mdulo Ita Shopline acessado via Ita Empresas na internet dentro
da opo Instalao Manuais/Banners/Botes e Componentes.
no Mdulo Ita Shopline que o responsvel pelo site cadastra e consulta
seus Cdigos de Habilitao para uso do Ita Shopline (Cdigo do Site e Chave
de Criptografia) e configura os demais campos necessrios gerao do produto.
As opes de pagamento que compem a configurao do Ita Shopline so:
dbito em conta, financiamento, carto de crdito (MasterCard, Visa, Hipercard
e Diners) e boleto bancrio.
1. Informaes Gerais
A cobrana por carto de crdito (MasterCard, Visa, Hipercard e Diners) via Ita
Shopline s estar disponvel aos compradores de seu site se houver a incluso
do cdigo de filiao da Redecard Komerci Web Service na opo Informaes
Cadastrais do Ita Shopline no Ita Empresas na internet, filiado ao banco Ita,
e a Redecard estiver com o IP do Ita Shopline no seu cadastro (favor informar
Redecard que cliente Ita Shopline para que eles faam essa incluso de IP).
Atravs do Mdulo Ita Shopline possvel configurar:
O cdigo de filiao Redecard Komerci;
Alguns parmetros adicionais relativos opo boleto bancrio, tais como:
prazo padro de vencimento, nome do cedente (site) no boleto
e mensagens adicionais;
Endereo principal do servidor seguro de seu site (SSL) para uso da funo
Retorno On-line/Consulta Automtica.
18
1.3 Instalao do Ita Shopline
Para instalar o Ita Shopline, deve-se inicialmente registrar o componente
Itaucripto.dll no equipamento que executar a aplicao do site.
Aps este procedimento, deve-se desenvolver uma pgina dinmica que execute
a chamada ao mtodo geraDados para efetuar a criptografia dos dados necessrios
gerao do Ita Shopline. Esses dados devem ser armazenados na varivel DC
e enviados para a URL Principal de Acesso ao Ita Shopline.
Desta forma, quando o Ita Shopline selecionado no ambiente do lojista como
meio de pagamento para finalizao da compra, os dados do pedido devem ser
criptografados e enviados pelo site lojista para a URL Principal do Ita Shopline,
conforme os critrios determinados neste manual (itens 2, 3 e 4). Uma nova
instncia de browser aberta, sem fechar a janela do site da loja virtual e o cliente
comprador transferido para o site do Ita Shopline, j em ambiente seguro Ita,
onde navegar conforme suas escolhas.
1. Informaes Gerais
19
O Ita Shopline disponibiliza aos lojistas j cadastrados diversas facilidades para
utilizao e configurao do produto, teste, instalao e consulta de informaes
sobre o pagamento dos pedidos. Veja a seguir.
20
2.1.1 Informaes Cadastrais do Site Lojista
Todas as informaes cadastrais do site lojista esto disponveis para consulta
e atualizao no Mdulo Ita Shopline acessado via Ita Empresas na internet
na conta-corrente do site do lojista. Dentro do Ita Empresas na internet, a rota
de acesso a esta funo : Ita Empresas na internet > Recebimentos >
Ita Shopline > Informaes Cadastrais
Nesta funo encontram-se os Cdigos de Habilitao do site para uso do produto
que so: Cdigo do Site e Chave de Criptografia.
A Chave de Criptografia um cdigo alfanumrico criado pelo site
com exatamente 16 posies para dar segurana transmisso dos dados
que iro trafegar entre o servidor do site e o servidor do banco no momento
da gerao do Ita Shopline.
O Cdigo do Site um cdigo criado pelo banco que identifica a conta-
corrente onde sero creditados os pagamentos efetuados em ambiente
seguro Ita Shopline.
Os Cdigos de Habilitao devero ser informados ao responsvel pela instalao
do Ita Shopline no site.
Ateno: qualquer informao alterada neste ambiente estar disponvel
para utilizao on-line aps a alterao. Para acessar o Ita Empresas na internet,
necessrio entrar no site do Ita (http://www.itau.com.br/empresas) e digitar:
Dados de Usurio Operador e Senha Eletrnica na barra de acesso
ao Ita Empresas na internet.
21
2.1.2 Instrues de Implantao do Produto
Todas as Instrues de Implantao do Produto esto contidas neste manual
tcnico. Futuras atualizaes da verso estaro sempre disponveis para download
no Mdulo Ita Shopline.
Dentro do Ita Empresas na internet, a rota de acesso a esta funo :
Cobrana ou Recebimentos > Ita Shopline > Instalao.
A implantao do Ita Shopline est detalhada nos itens 2, 3 e 4 deste manual
e para tal ser necessrio obter os Cdigos de Habilitao do site, o Componente
de Criptografia e os Banners de Identificao do Produto e providenciar
a programao dos parmetros necessrios gerao do Ita Shopline.
Para resolver dvidas quanto instalao do meio de pagamento
Ita Shopline em seu site, entre em contato com o atendimento
Ita Empresas no telefone 0300 100 7575.
22
2.2 Gerao do Ita Shopline URL Principal de Acesso ao Produto
Ambiente de produo:
O ambiente da plataforma de cobrana Ita Shopline acessado atravs do envio
dos dados criptografados para a seguinte URL:
https://shopline.itau.com.br/shopline/shopline.aspx
Esta a URL oficial que dever ser acionada pelo comprador no site do lojista
para que haja a gerao do Ita Shopline. Neste ambiente, o comprador
encontrar todas as opes de pagamento do produto que estiverem habilitadas
para o site do lojista e ir navegar conforme seus interesses e disponibilidades.
Clique aqui para visualizar a Tela Inicial do Ita Shopline
23
2.3 Reemisso de Boletos
A reemisso de boleto feita automaticamente pela URL de emisso na aplicao
Ita Shopline. Se o pedido informado j existir em nossas bases com o mesmo
valor e ainda no estiver sido pago, considerado uma reemisso. Sendo assim,
deve-se chamar sempre a URL de emisso, ou seja a mesma URL utilizada para
fazer a chamada do site.
Portanto, se houve gerao de boleto e este ainda no foi liquidado e nem perdeu
sua validade, ser possvel reemiti-lo a qualquer momento, at seu vencimento.
Clique aqui para visualizar o Boleto Bancrio do Ita Shopline.
24
2.4 Retorno On-line do Tipo de Pagamento
O Ita disponibiliza aos lojistas do Ita Shopline o Retorno On-line, isto , a opo
de receber um retorno, pedido a pedido, indicando o tipo de pagamento
escolhido pelo comprador em ambiente Ita Shopline. Para isso, necessrio que
o lojista informe um endereo seguro (URL) para receber a informao que dever
ser cadastrada em campo especfico da tela de Informaes Cadastrais do Mdulo
Ita Shopline (vide item 2.1.1 deste manual).
Ateno: essa chamada ser feita somente em aplicaes com SSL.
Forma de acesso: comunicao criptografada estabelecida entre o servidor
do banco e o servidor do site.
Formato da consulta: o Retorno On-line ser sempre disponibilizado no formato
XML para que seja decriptografado e interpretado pelo site conforme os cdigos
possveis. Mais detalhes sobre a integrao dessa modalidade de consulta de
operaes sero apresentados nos itens subsequentes.
Tempo de disponibilizao: on-line e real time assim que o pedido registrado
no banco e associado a alguma das opes de pagamento da plataforma,
a informao do Tipo de Pagamento escolhido em ambiente Ita Shopline
retornada ao servidor do site que dever seguir os procedimentos indicados
no item 2.5 deste manual para interpret-la.
Aps a emisso do comprovante de pagamento ou da pgina do boleto na tela
do comprador, o Ita far a chamada aplicao do lojista conforme o endereo
resultante da concatenao da URL de Retorno j cadastrada no Ita Shopline
e a URL informada no campo urlRetorna da criptografia do pedido.
Ateno: se o site no passar o campo urlRetorna nos dados criptografados
do pedido, ficar subentendido que no quer receber o Retorno do Tipo de
Pagamento escolhido.
O Retorno On-line informa apenas o tipo de pagamento da plataforma que foi
escolhido pelo cliente comprador do site. A confirmao do pagamento
do pedido garantida exclusivamente pelo banco e dever ser sempre obtida
em ambiente Ita, o que significa que o site que deve consultar o banco e no
esperar esta confirmao num retorno.
Sendo assim, as modalidades de Consulta de Operaes oficiais do banco so:
Consulta de Operaes do Mdulo Ita Shopline, Arquivo Retorno de Cobrana
ou Consulta Automtica Situao do Pagamento (sonda).
25
Todos os pedidos que acessam a plataforma de cobrana Ita Shopline
so registrados no banco, sendo sempre possvel saber a opo de pagamento
escolhida pelo comprador em ambiente Ita Shopline e se o pedido foi pago
ou no. Para o site lojista, a identificao da opo de pagamento escolhida
se d pela carteira de cobrana (vide item 1 deste manual).
Existem diversas maneiras de consultar as operaes realizadas via Ita Shopline.
Elas diferem entre si pela forma como so acessadas, pelo formato em que so
disponibilizadas e pelo tempo em que disponibilizam a informao referente
aos pedidos consultados.
Veja a seguir mais detalhes sobre as consultas disponveis.
26
2.5.1 Consulta de Operaes do Mdulo Ita Shopline
O Mdulo Ita Shopline oferece uma consulta exclusiva das operaes realizadas
via Ita Shopline, relacionando os pedidos s carteiras que identificam o Ita Shopline
(176 e 178), sendo um filtro das informaes oferecidas nas funes da rota
Carteiras e Ttulos do Ita Empresas na internet.
Forma de acesso: Ita Empresas na internet da conta-corrente do site. A rota para
esta consulta no Mdulo Ita Shopline :
Ita Empresas na internet > Recebimentos > Ita Shopline >
Consulta de Operaes
Formato da consulta: a partir da navegao no Ita Empresas na internet,
o usurio visualiza a relao de pedidos efetuados em seu site que ser
identificada conforme a opo de pagamento escolhida pelo comprador.
Para o lojista, as opes possveis so: dbito em conta (178), financiamento,
carto de crdito (MasterCard, Visa, Hipercard e Diners) e boleto bancrio
(176) e estaro separadas nas listagens conforme os seguintes status:
Operaes em Aberto pedidos que emitiram boletos e que ainda no
foram pagos.
Operaes a Creditar pedidos que j foram pagos pelos compradores
e que ainda no foram creditados para o lojista devido ao floating da cobrana
negociado com o gerente da conta-corrente do site. Se for a listagem
de pagamento vista, o pedido j seguro de crdito para o lojista
nesse momento, mas se for boleto bancrio, ser necessrio esperar pela
compensao da cobrana do ttulo para ter a garantia do crdito.
Operaes Creditadas pedidos que j foram pagos pelos compradores
e que j foram creditados para o lojista.
Histrico de operaes realizadas pedidos pagos via carto de crdito.
Nessa listagem haver um indicador da compensao da cobrana do ttulo
que dado pela literal C citada no demonstrativo. Se houver a literal ao lado
dos valores creditados, indica que estes valores esto A COMPENSAR, se no
houver literal, significar COMPENSADO. Isto ocorre quando h pagamento
de ttulos com cheque, pois o valor no fica disponvel de imediato, e, sim,
somente aps a compensao do cheque.
Tempo de disponibilizao: on-line e real time assim que o pedido registrado
no banco e associado a alguma das opes de pagamento da plataforma,
essa informao disponibilizada no Mdulo Ita Shopline conforme
o status ocorrido.
A reutilizao da numerao de um pedido s poder ser feita:
Para os pedidos pagos, aps 60 dias corridos da data de pagamento;
Para os pedidos no pagos, aps 60 dias corridos da data de vencimento;
Para os pedidos no finalizados, 60 dias corridos da data do pedido.
A informao fica armazenada por 5 anos. Outras formas de acompanhar
o status do pagamento so: Arquivo Retorno de Cobrana ou Consulta
Automtica a Situao do Pagamento (sonda).
Clique aqui para visualizar um exemplo da Consulta de Operaes do Mdulo
Ita Shopline.
27
2.5.2 Arquivo Retorno de Cobrana
O Arquivo Retorno de Cobrana oferece a consulta de todos os ttulos liquidados
conforme as carteiras de cobrana contratadas e utilizadas pela conta-corrente
do cliente cedente (site lojista).
Forma de acesso: conforme a modalidade de intercmbio de arquivos definida
pelo lojista junto a seu Gerente de Relacionamento Ita Empresas. A forma mais
simples de obter o arquivo atravs do Ita Empresas na internet na conta-corrente
do site.
Para usurios do Ita Empresas na internet, a rota :
Transmisso de Arquivo > Transmisso (Ambiente Produo) > Retorno >
Recepcionar.
Formato da consulta: arquivo de texto (extenso .txt) padro CNAB que informa
todas as operaes liquidadas, conforme a carteira de cobrana associada ao n
o
do
ttulo. Nas carteiras utilizadas pelo Ita Shopline, o n
o
do pedido enviado ao banco
ser transformado em SEU NMERO e ir compor tambm o campo NOSSO NMERO.
Para programar a leitura desse arquivo e integr-lo ao sistema de conciliao bancria
de sua empresa, necessrio obter junto ao gerente de sua conta o Manual
de Intercmbio de Arquivos que especifica todos os campos que sero informados
no Arquivo Retorno de Cobrana. Para conhecer o layout da Cobrana Ita acesse
o Ita Empresas na internet e siga a rota: Outros Servios > Download Center >
Cobrana Manual de Intercmbio de Arquivos.
Tempo de disponibilizao: um dia til aps a liquidao do ttulo (D+1) assim
que o pedido pago, a informao compilada pela cobrana sob a forma de
Arquivo Retorno e apresentada ao lojista um dia til aps a liquidao.
No Ita Empresas na internet ficam disponveis os arquivos das ltimas 5
movimentaes dirias, sendo que a gerao de arquivos feita de tera a sbado,
contemplando sempre a movimentao do dia anterior.
A informao fica armazenada por 5 anos. Outras formas de acompanhar o status
do pagamento so: Consulta de Operaes do Mdulo Ita Shopline ou Consulta
Automtica Situao do Pagamento (sonda).
Clique aqui para visualizar um exemplo do Arquivo Retorno de Cobrana.
28
O Ita oferece aos lojistas do Ita Shopline a possibilidade de realizar uma Consulta
Automtica (sonda) ao servidor do banco para obter a situao de pagamento
de um pedido.
A URL utilizada para executar esta consulta :
https://shopline.itau.com.br/shopline/consulta.aspx.
Os dados devem ser criptografados utilizando o mtodo geraConsulta.
Para a consulta devem ser utilizados, obrigatoriamente, os seguintes dados:
Chave, Cdigo da Empresa, Nmero do Pedido e Formato. Para descriptografar
o resultado da consulta utilizado: Cdigo da Empresa, Nmero do Pedido, Valor,
Tipo de Pagamento, Situao do Pagamento e Data de Pagamento.
Segue o exemplo de utilizao dos dados criptografados:
dados = cripto.geraConsulta(codEmp, pedido, formato, chave).
Nesta consulta exibida a efetivao do pagamento do pedido em funo do tipo
de pagamento utilizado pelo comprador em ambiente Ita Shopline, sendo
que o tempo de disponibilizao desta informao varia conforme a opo de
pagamento escolhida.
As combinaes de consulta possveis so:
TIPPAG SITPAG
00 para
pagamento ainda
no escolhido
On-line e real time
01 para situao de pagamento no finalizada (tente novamente)
02 para erro no processamento da consulta (tente novamente)
03 para pagamento no localizado (consulta fora de prazo
ou pedido no registrado no banco)
01 para
pagamento vista
(TEF e CDC)
On-line e real time
00 para pagamento efetuado
02 para
boleto bancrio
On-line e real time
04 para boleto emitido com sucesso
A partir de um dia til da emisso do boleto
05 para pagamento efetuado, aguardando compensao
06 para pagamento no compensado
03 para
carto de crdito
On-line e real time
29
De acordo com a tabela anterior, as opes de pagamento 01 e 03 podero ser confirmadas
em tempo real, mas a opo de pagamento 02 (boleto bancrio) s ser confirmada
aps a compensao do ttulo na Cobrana Ita. Em tempo real, apenas informado
que o comprador gerou um boleto em sua tela, com sucesso, permitindo ao lojista
a integrao da funcionalidade de reemisso de ttulos, por exemplo.
J que o Ita Shopline uma forma de cobrana via internet que se utiliza
das carteiras 176 e 178 para identificar os pedidos enviados pelo site ao banco,
vale ressaltar que pagamento efetuado significa ttulo liquidado e que importante
considerar tambm o prazo para crdito da cobrana (floating negociado para
a conta-corrente do site) e a forma de liquidao do ttulo (dinheiro, cheque,
compensao bancria) que pode ser compensada ou no ao fim do processo.
Forma de acesso: comunicao criptografada estabelecida entre o servidor
do site e o servidor do banco.
Formato da consulta: a Consulta Automtica (sonda) poder ser obtida
no formato XML ou HTML. Mais detalhes sobre a integrao dessa modalidade
de consulta de operaes sero apresentados nos itens subsequentes.
Tempo de disponibilizao: on-line e real time aps receber o Retorno On-line,
o site poder preparar seu servidor para disparar uma Consulta Automtica
ao servidor do banco para obter a Situao do Pagamento do pedido retornado.
A informao fica armazenada por 5 anos. Outras formas de acompanhar
o status do pagamento so: Consulta de Operaes do Mdulo Ita Shopline
ou Arquivo Retorno de Cobrana.
Clique aqui para visualizar a Consulta Automtica Situao
de Pagamento (sonda).
Alm das trs modalidades de Consulta de Operaes aqui detalhadas, existem
outras maneiras de consultar as operaes realizadas via Ita Shopline que trazem
as confirmaes de todas as carteiras de cobrana utilizadas pelo lojista como,
por exemplo, o relatrio 2154. Para mais informaes, procure seu Gerente
de Relacionamento Ita Empresas.
O responsvel pelo site escolher a(s) modalidade(s) de consulta mais conveniente(s).
30
1) Loja entra em contato com Redecard
Telefone 4004 3298 (capitais) e 0800 7263298 (demais localidades).
Lojista se identificar como cliente Ita Shopline confirmando que usar
o Ita Shopline como plataforma de captura de cartes de crditos.
2) Credenciamento Redecard
Processo de credenciamento padro Redecard Komerci Web Service.
H a possibilidade do estabelecimento no ser credenciado por no passar
em anlise interna (riscos, fraudes, jurdico...).
3) Credenciamento PV Komerci WS
Processo de credenciamento padro Redecard.
4) Cadastro dos IPs Ita Shopline
Redecard dever cadastrar IP do Ita.
Operao credencia os IPs fornecidos pelo Ita.
O limite mximo so 10 endereos IP por PV: caso o estabelecimento j tenha
cadastrados, ele dever informar quais sero retirados para a insero dos IPs
Ita (caso necessrio).
O prazo para a loja estar OK com sistema e passar a capturar cartes
via Ita Shopline/Komerci pode variar:
Loja virtual que j possui Komerci WS (no criar um novo PV):
cerca de 2 horas aps o cadastro dos IPs.
Loja virtual que no possui Komerci WS: priorizao para atendimento
em 5 dias teis aps a criao da solicitao do credenciamento
(desde que todos os documentos/infos estejam ok).

Duas razes para este fluxo:
Loja virtual pode estar usando o Komerci WS e apontando os IPs para outros
servidores e uma alterao automtica pode afetar essa operao.
Toda alterao cadastral s pode ser efetuada mediante solicitao
de acordo com a loja virtual.
Para a verso Web Service para o Ita Shopline:
Ligue na Central de Atendimento e solicite o cadastramento Komerci Web Service:
4001 4433 (capitais e regies metropolitanas)
0800 784 433 (demais localidades)
Lembrando!
Para este processo, voc deve estar credenciado na REDECARD (via Ita)
e domiciliado no Ita, e informar ser cliente Ita Shopline na Redecard.
1
Cliente entra
em contato
J cliente
Redecard?
sim sim
no no
2
Credenciamento
Redecard
J cliente
Komerci com WS
habilitado?
3
Credenciamento
PV Komerci WS
4
Cadastro dos IPs
Ita Shopline
31
Sobre o certificado digital no site:
No dia 1
o
de janeiro de 2012, a verso V2 do Certificado Digital ICP-Brasil
(Infraestrutura de Chaves Pblicas Brasileira) entrou em operao.
Nessa verso, as chaves criptogrficas que compem o algoritmo de criptografia
assimtrica (RSA) utilizado pelas Autoridades Certificadoras passaram a ter o
tamanho de 4096 bits. Para os Certificados Digitais de pessoas fsicas e jurdicas,
as chaves so de 2048 bits, em substituio s de 1024 bits. Houve mudana
tambm no algoritmo de resumo criptogrfico (SHA), que passou de SHA-1
(160 bits) para no mnimo SHA-256 (256 bits).
Essa migrao oficializada pela Resoluo n
o
65, de 9 de julho de 2009,
que trata da necessidade de atualizao dos padres e algoritmos criptogrficos
da ICP-Brasil (DOC-ICP-01.01).
Devem cumprir esse conjunto de diretrizes as Autoridades Certificadoras,
Autoridades de Registro, Prestadores de Servio de Suporte, Empresas
de Auditoria Independente, Laboratrios de Ensaios e Auditoria e outras
entidades credenciadas ou cadastradas na ICP-Brasil, bem como titulares finais
e desenvolvedores de aplicativos que utilizam Certificados Digitais ICP-Brasil.
Clique aqui para visualizar as principais telas do Mdulo Ita Shopline.
32
Parmetros Obrigatrios
Parmetros Descrio Critrios de Consistncia
CodEmp Cdigo da Empresa (Cdigo do Site) Alfanumrico com exatas 26 posies (enviar o cdigo todo em maisculas)
Pedido Nmero do Pedido Numrico com o mximo de 08 posies (99999999) ( * )
Valor Valor Total do Pagamento
Nmeros inteiros de at 8 posies (99999999,99). Os centavos devero ser enviados com 2 casas decimais
(no obrigatrio), utilizando a vrgula como separador
Chave Chave de Criptografia Alfanumrico com exatas 16 posies (enviar a chave toda em maisculas)
NomeSacado Nome do Sacado Alfanumrico com o mximo de 30 posies
Codigoinscricao Cdigo de inscrio do sacado
Numrico com exatamente 02 posies:
01 para CPF
02 para CNPJ
NumeroInscricao Nmero de inscrio do sacado
Numrico com 14 posies
99999999999999
EnderecoSacado Endereo do sacado Alfanumrico com o mximo de 40 posies
BairroSacado Bairro do sacado Alfanumrico com o mximo de 15 posies
CepSacado CEP do sacado Numrico com exatamente 08 posies (99999999)
CidadeSacado Cidade do sacado Alfanumrico com o mximo de 15 posies
EstadoSacado Estado do sacado Alfanumrico com exatamente 02 posies. Somente sero aceitos Estados brasileiros
33
Parmetros Opcionais
DataVencimento Data de vencimento do ttulo
Numrico com exatamente 08 posies
Utilizar o formato ddmmaaaa
UrlRetorna Parte final da URL de Retorno Completa
(2)
Alfanumrico com o mximo de 60 posies
ObsAdicional1
Espao disponvel para enviar uma linha de mensagem nica por pedido,
que s ser exibida se o campo Observao contiver o texto 3
ObsAdicional2
ObsAdicional3
Observacao
Espao disponvel para enviar uma linha de mensagem nica por pedido
ou um parmetro indicando qual Mensagem Adicional
(1)
se quer apresentar
Enviar:
uma linha de mensagem ou
1 para apresentar a Mensagem Adicional 1 ou
2 para apresentar a Mensagem Adicional 2 ou
3 para apresentar as 3 linhas de Mensagem Adicional
enviadas nos campos ObsAdicional1, ObsAdicional2 e ObsAdicional3
34
Os parmetros que sero utilizados na criptografia para a gerao do Ita Shopline
devem seguir todos os critrios aqui especificados para que o ambiente seja acessado
com sucesso.
Existem dois tipos de parmetros:
Obrigatrios: permitem a gerao de qualquer opo de pagamento
da plataforma de cobrana Ita Shopline.
Opcionais: referem-se especificamente opo de pagamento boleto bancrio.
No entanto, todos os parmetros devero ser enviados na criptografia apesar de
no estarem preenchidos.
Veja a seguir as caractersticas especficas de cada parmetro:
1. Mensagem Adicional: conforme os critrios do parmetro Observacao
(vide tabela anterior), a mensagem adicional exibida no corpo do boleto ser:
Mensagem de 1 linha de 40 posies Mensagem nica por pedido que
ser exibida emisso, na reemisso do boleto (se houver) e tambm estar
disponvel no Arquivo Retorno de Cobrana.
ou
Mensagem Adicional 1 (parmetro 1) Mensagem padro pr-cadastrada
que ser exibida na emisso e na reemisso do boleto (se houver) e dever
ser registrado na tela de Informaes Cadastrais do Mdulo Ita Shopline
no item Mensagem Adicional 1.
ou
Mensagem Adicional 2 (parmetro 2) Mensagem padro pr-cadastrada
ser registrado na tela de Informaes Cadastrais do Mdulo Ita Shopline
no item Mensagem Adicional 2.
ou
Mensagem Adicional 3 (parmetro 3) Mensagem nica por pedido
ser enviada nos campos ObsAdicional1, ObsAdicional2 e ObsAdicional3.
2. URL de Retorno Completa: o endereo SSL para o qual ser enviado o
Retorno On-line do Tipo de Pagamento escolhido pelo comprador nas telas do Ita
Shopline.
Para mais detalhes sobre como execut-lo, vide item 5.1 deste manual.
A URL de Retorno Completa dever ter no mximo 100 posies, sendo composta
pela concatenao dos parmetros URL de Retorno e urlRetorna.
URL de Retorno: endereo principal do servidor seguro de aplicao do site
(SSL) que dever estar registrado em Informaes Cadastrais do Mdulo Ita
Shopline no item URL de Retorno;
urlRetorna: parmetro enviado na gerao do Ita Shopline (vide tabela anterior)
que indica que o site deseja receber o Retorno On-line do Tipo do Pagamento;
Os campos obs1, obs2, obs3 so campos opcionais para envio de observao
complementar usado na gerao do boleto.
Para mais detalhes sobre o acesso funo Informaes Cadastrais do Mdulo Ita
Shopline, vide item 2.1. deste manual.
Os dados que sero utilizados para interpretar o Retorno On-line do Tipo
de Pagamento oferecido pelo banco e realizar a Consulta Automtica Situao
do Pagamento (sonda) do pedido efetuado em ambiente Ita Shopline deve
obedecer todos os critrios especificados a seguir:
35
Parmetros para Retorno On-line do Tipo de Pagamento
TipPag Tipo de pagamento escolhido pelo comprador
Numrico com 02 posies:
00 para pagamento ainda no escolhido*
01 para pagamento vista (TEF e CDC)
02 para boleto
03 para carto de crdito
* Este tipo de pagamento somente ser exibido na consulta
36
Parmetros para Consulta Situao de Pagamento
Formato Formato do retorno da consulta
Numrico com 01 posio:
0 para formato de pgina HTML para consulta visual
1 para formato XML
TipPag Tipo de pagamento escolhido pelo comprador
00 para pagamento ainda no escolhido*
01 para pagamento vista (TEF e CDC)
02 para boleto
*Este tipo de pagamento somente ser exibido na consulta
SitPag Situao de pagamento do pedido
03 para pagamento no localizado (consulta fora de prazo ou pedido
no registrado no banco)
04 para boleto emitido com sucesso
05 para pagamento efetuado, aguardando compensao
06 para pagamento no compensado
DtPag Data do pagamento Numrico com 8 posies no formato ddmmaaaa
CodAut
Nmero de autorizao preenchido somente quando pagamento efetuado com
carto de crdito
Alfanumrico com 6 posies
NumId
NSU da transao preenchido somente quando pagamento efetuado com carto
de crdito
CompVend
Nmero do comprovante de venda preenchido somente quando pagamento
efetuado com carto de crdito, bandeira MasterCard/Diners
TipCart Tipo de carto de crdito escolhido pelo comprador Em branco
37
Para que seja feita a implantao do Ita Shopline, necessrio que exista
um Servidor Web. Depois de instalado, devem ser executados os passos
descritos a seguir.
38
4.1 Usando Itaucripto.dll Para Ambientes Microsoft (Windows NT 4.0 ou superior)
Neste item usamos ASPX (VBScript) com linguagem, porm nada impede
que utilize outra linguagem web.
39
A rota de acesso a este componente no:
Ita Empresas na internet > Recebimentos > Ita Shopline > Instalao
Aps este procedimento, deve-se registrar o componente no equipamento que for
executar a aplicao e chamar o mtodo geraDados.
Os procedimentos para registrar o componente de criptografia so:
1. Menu Iniciar (Start) do WindowsNT
2. Menu Executar (Run)
3. Digitar na caixa Abrir (Open) o comando: regsvr32 c:\....\Itaucripto.dll
40
A pgina ASP que criptografa os dados para envi-los ao Ita Shopline deve observar
as seguintes regras:
( 1 ) Para chamar a tela de pagamentos, a criptografia dos dados deve seguir exatamente
a ordem abaixo:
dados = cripto.geraDados(codEmp, pedido, valor, observacao, chave, nomeSacado,
codigoInscricao, numeroInscricao, enderecoSacado, bairroSacado, cepSacado,
cidadeSacado, estadoSacado, dataVencimento, urlRetorna, obsAdicional1, obsAdicional2,
obsAdicional3).
( 2 ) Todos os campos so criptografados e enviados pelo lojista, exceto o campo Chave.
( 3 ) Todos os contratos preenchidos pelo Ita Empresas na internet devero enviar todos
os campos obrigatoriamente. Os contratos preenchidos pela digital somente sero
obrigatrios Cdigo da Empresa, Chave, Nmero do pedido e Valor.
Segue o exemplo de utilizao para o caso onde se deseja enviar apenas os campos
obrigatrios:
dados = cripto.geraDados(codEmp, pedido, valor, , chave, , , , , , , , , , , , ,)
( 4 ) A pgina que contiver a URL do Ita dever apresentar as seguintes caractersticas:
Formulrio (FORM) com as propriedades:
method=post
action=https://shopline.itau.com.br/shopline/shopline.aspx
Campo (INPUT) para os dados criptografados, com as propriedades:
name=DC
type=hidden
value=Dados Criptografados
Obs.: o nome do Input tem que ser DC pois os dados so recebidos a partir de um request
com este nome.
EXEMPLO:
<FORM action=https://shopline.itau.com.br/shopline/shopline.aspx method=post
name=form1 onsubmit=carregabrw() target=SHOPLINE>
<INPUT type=hidden name=DC value=<%= dados %>>
<BR>
<INPUT type=submit name=Shopline value=Ita Shopline>
</form>
( 5 ) Para o correto funcionamento do Ita Shopline nos browsers: AOL, Netscape e Internet
Explorer (verses 4.X ou superior) a instncia do browser a ser aberto deve possuir
o JavaScript abaixo, com as seguintes caractersticas:
TOOLBAR = YES
MENUBAR=YES
RESIZABLE = YES
STATUS = NO
SCROLLBARS = YES
WIDTH = 815 (sugesto)
HEIGHT = 575 (sugesto)
EXEMPLO:
<script language=JavaScript>

</script>
A configurao aqui sugerida permite a ideal visualizao da tela do Ita Shopline a ser
gerada sobre a tela do site lojista no computador do cliente comprador do site.
41
Neste item usamos Java (Servlet) como linguagem web.
42
A rota de acesso a este componente :
Ita Empresas na internet > Recebimentos > Ita Shopline > Instalao
No diretrio onde o Java ser compilado, crie um subdiretrio Ita e copie a classe
Itaucripto para este novo subdiretrio.
43
Servlet que criptografa os dados para envi-los ao Ita Shopline deve observar
as seguintes regras:
( 1 ) Inserir no incio do cdigo a linha import Itau.Itaucripto; para que seja importada
a classe Itaucripto.
( 2 ) Inserir o cdigo da empresa e a chave de criptografia, em letra maiscula, nos locais
indicados.
( 3 ) Para chamar a tela de pagamentos, a criptografia dos dados deve seguir exatamente
a ordem abaixo:
dados = cripto.geraDados(codEmp, pedido, valor, observacao, chave, nomeSacado,
codigoInscricao, numeroInscricao, enderecoSacado, bairroSacado, cepSacado,
cidadeSacado, estadoSacado, dataVencimento, urlRetorna, obsAdicional1, obsAdicional2,
obsAdicional3)
( 4 ) Todos os campos so criptografados e enviados pelo lojista, exceto o campo Chave.
( 5 ) Os campos Cdigo da Empresa, Chave, Nmero do pedido e Valor so
obrigatrios, os demais so opcionais, entretanto, todos os parmetros devem ser enviados
na criptografia apesar de no estarem preenchidos.
Segue o exemplo de utilizao para o caso onde se deseja enviar apenas os campos
obrigatrios:
dados = cripto.geraDados(codEmp, pedido, valor, , chave, , , , , , , , , , , , , )
( 6 ) A pgina que contiver a URL do Ita dever apresentar as seguintes caractersticas:
Formulrio (FORM) com as propriedades:
method=post
action=https://shopline.itau.com.br/shopline/shopline.aspx
Campo (INPUT) para os dados criptografados, com as propriedades:
name=DC
type=hidden
value=Dados Criptografados
Obs.: o nome do Input tem que ser DC pois os dados so recebidos a partir de um request
com este nome.
EXEMPLO:

out.println(<FORM METHOD=\POST\ ACTION=\https://shopline.itau.com.br/shopline/
shopline.aspx\ name=\form\ onsubmit=carregabrw() target=\SHOPLINE\>);
out.println(<INPUT TYPE=\hidden\ NAME=\DC\VALUE=\ + dados + \>);
out.println(<INPUT TYPE=\submit\ name=\Shopline\ value=\Ita Shopline\>);
out.println(</FORM>);
( 7 ) Para o correto funcionamento do Ita Shopline nos browsers: AOL, Netscape e Internet
Explorer (verses 4.X ou superior) a instncia do browser a ser aberto deve possuir o
JavaScript abaixo, com as seguintes caractersticas:
TOOLBAR = YES
MENUBAR=YES
RESIZABLE = YES
STATUS = NO
44
SCROLLBARS = YES
WIDTH = 815 (sugesto para melhor visualizao)
HEIGHT = 575 (sugesto para melhor visualizao)
EXEMPLO:
out.println(<script language=\JavaScript\>);
out.println();
out.println(</script>);
A configurao aqui sugerida permite a ideal visualizao da tela do Ita Shopline a ser
gerada sobre a tela do site lojista no computador do cliente comprador do site.
( 8 ) Aps a edio, salvar com extenso Java, compil-lo (javac <nome do arquivo>.java)
e coloc-lo no diretrio definido como repositrio de servlets.
45
Neste item, usamos ASPX (VBScript) como linguagem, porm nada impede
que utilize outra linguagem web.
46
<HTML>
<HEAD>
<TITLE>Exemplo de cdigo HTML</TITLE>
</HEAD>
<BODY>
<FORM ACTION=Nome da Pgina de Criptografa METHOD=Post NAME=form1>
<CENTER>Entre com os Dados
<TABLE width=100% border=1 align=center>
<TR>
<TD width=25% align=center><B>Pedido (99999999):</B></TD>
<TD><INPUT type=text maxlength=8 size=8 name=pedido value=></TD>
</TR>
<TR>
<TD width=25% align=center><B>Valor (99999999,99):</B></TD>
<TD><INPUT type=text maxlength=10 size=10 name=valor value=></TD>
</TR>
<TR>
<TD width=25% align=right><B>Observao:</B></TD>
<TD><INPUT type=text maxlength=40 size=40 name=observacao value=></TD>
</TR>
<TR>
<TD width=25% align=right><B>Nome do Sacado:</B></TD>
<TD><INPUT type=text maxlength=30 size=30 name=nomeSacado value=></TD>
</TR>
<TR>
<TD width=25% align=right><B>Cdigo de Inscrio (01 CPF, 02 CNPJ):</B></TD>
<TD><INPUT type=text maxlength=2 size=2 name=codigoInscricao value=></TD>
</TR>
<TR>
<TD width=25% align=right><B>Nmero de Inscrio (CPF, CNPJ):</B></TD>
<TD><INPUT type=text maxlength=14 size=14 name=numeroInscricao value=></TD>
</TR>
<TR>
<TD width=25% align=right><B>Endereo do Sacado:</B></TD>
<TD><INPUT type=text maxlength=40 size=40 name=enderecoSacado value=></TD>
</TR>
<TR>
<TD width=25% align=right><B>Bairro:</B></TD>
<TD><INPUT type=text maxlength=15 size=15 name=bairroSacado value=></TD>
</TR>
5.1.1 Envio dos Dados Pgina inicial HTML
<TR>
<TD width=25% align=right><B>CEP (99999999):</B></TD>
<TD><INPUT type=text maxlength=8 size=8 name=cepSacado value=></TD>
</TR>
<TR>
<TD width=25% align=right><B>Cidade:</B></TD>
<TD><INPUT type=text maxlength=15 size=15 name=cidadeSacado value=></TD>
</TR>
<TR>
<TD width=25% align=right><B>Estado:</B></TD>
<TD><INPUT type=text maxlength=2 size=2 name=estadoSacado value=></TD>
</TR>
<TR>
<TD width=25% align=right><B>Data de Vencimento (ddmmaaaa):</B></TD>
<TD><INPUT type=text maxlength=8 size=8 name=dataVencimento value=></TD>
</TR>
<TR>
<TD width=25% align=right><B>URL retorna:</B></TD>
<TD><INPUT type=text maxlength=60 size=60 name=urlRetorna value=></TD>
</TR>
<TR>
<TD width=25% align=right><B>ObsAdicional1:</B></TD>
<TD><INPUT type=text maxlength=60 size=60 name=ObsAdicional1 value=></TD>
</TR>
<TR>
</TR>
<TR>
</TR>
</TABLE>
</CENTER>
<BR><BR>
<INPUT TYPE=submit value=Pagar name=Pagar>
</FORM>
</BODY>
</HTML>
47
<HTML>
<BODY>
<CENTER>Nome da Pgina de Criptografia</CENTER>
<%
dim codEmp, chave, pedido, valor, observacao, nomeSacado, codigoInscricao, enderecoSacado
dim bairroSacado, cepSacado, cidadeSacado, estadoSacado, dataVencimento, urlRetorna, cripto
codEmp = J0123456789012345678901234 Coloque aqui o cdigo da empresa
chave = ABCD123456ABCD12 Coloque aqui a chave de criptografia em maiscula
pedido = Request.Form(pedido) obtm o valor do campo pedido
valor = Request.Form(valor) obtm o valor do campo valor
observacao = Request.Form(observacao) obtm o valor do campo observacao
nomeSacado = Request.Form(nomeSacado) obtm o valor do campo nomeSacado
codigoInscricao = Request.Form(codigoInscricao) obtm o valor do campo codigoInscricao
numeroInscricao = Request.Form(numeroInscricao) obtm o valor do campo numeroInscricao
enderecoSacado = Request.Form(enderecoSacado) obtm o valor do campo enderecoSacado
bairroSacado = Request.Form(bairroSacado) obtm o valor do campo bairroSacado
cepSacado = Request.Form(cepSacado) obtm o valor do campo cepSacado
cidadeSacado = Request.Form(cidadeSacado) obtm o valor do campo cidadeSacado
estadoSacado = Request.Form(estadoSacado) obtm o valor do campo estadoSacado
dataVencimento = Request.Form(dataVencimento) obtm o valor do campo dataVencimento
urlRetorna = Request.Form(urlRetorna) obtm o valor do campo urlRetorna
obsAdicional1 = Request.Form(obsAdicional1) obtm o valor do campo obsAdicional1
5.1.2 Criptografia dos Dados Cdigo ASPX
Set cripto = server.createobject(Itaucripto.cripto)
dados = cripto.geraDados(codEmp, pedido, valor, observacao, chave, nomeSacado, codigoInscricao,
numeroInscricao, enderecoSacado, bairroSacado, cepSacado, cidadeSacado, estadoSacado,
dataVencimento, urlRetorna, obsAdicional1, obsAdicional2, obsAdicional3)
Set cripto = nothing
%>
<FORM ACTION=https://shopline.itau.com.br/shopline/shopline.aspx method=post
name=form1 onsubmit=carregabrw() target=SHOPLINE>
<INPUT type=hidden name=DC value=<%= dados %>>
<BR>
</form>

</script>
</BODY>
</HTML>
48
5.1.3 Retorno do Tipo de Pagamento Cdigo ASPX
O endereo para Retorno do Tipo de Pagamento ser composto da seguinte maneira:
HTTPS:// + URL de Retorno Cadastrada + URLRetorna do Pedido + parmetros
de retorno criptografados.
EXEMPLO:
URL de Retorno cadastrada no Mdulo Ita Shopline = www.minhaloja.com.br
URLretorna passada pelo lojista no pedido em questo = /final/retorno.aspx
Dados de retorno criptografados=?DC=A345B456F456W456T56J3K678
Exemplo da chamada URL final: https://www.minhaloja.com.br/final/retorno.aspx?
DC=A345B456F456W456T56J3K678
A pgina de retorno do pagamento deve receber os dados criptografados e chamar
o mtodo decripto e, para acessar o contedo de cada campo, necessrio usar
os mtodos que retornam seus contedos:
retornaCodEmp(), retornaPedido(), retornaTipPag()
CodEmp
Cdigo da empresa
ou cdigo do site
Alfanumrico de 26 posies
Pedido Nmero do pedido Numrico com 8 posies
TipPag
Tipo de pagamento escolhido
pelo comprador
01 para pagamento vista (TEF ou CDC)
02 para boleto
EXEMPLO:
<%
Inicializa as variveis
dim dados, codEmp, chave, pedido, tipPag, cripto
chave = ABCD123456ABCD12 Coloque aqui a chave de criptografia em maiscula

Recebe valores da pgina anterior
dados = Request.Form(DC)
Set cripto = Server.CreateObject(Itaucripto.cripto)
Decriptografa os dados chamando o mtodo decripto da classe Itaucripto e recebe
os dados
dados = cripto.decripto(dados, chave)
codEmp = cripto.retornaCodEmp()
pedido = cripto.retornaPedido()
tipPag = cripto.retornaTipPag()
%>
<html>
<head>
<title> Retorno Online </title>
</head>
<body>
<h1>Dados recebidos</h1>
Cdigo da empresa: <%= codEmp %><br>
Pedido: <%= pedido %><br>
Tipo de pagamento: <%= tipPag %>
<br>
</body>
</html>
49
5.1.4 Consulta Situao do Pagamento Cdigo ASPX
EXEMPLO:
<%
Inicializa as variveis
dim dados
dim codEmp
dim chave
dim pedido
dim formato
dim cripto
chave = ABCD123456ABCD12
Coloque aqui sua chave de criptografia em maiscula

Inicializa valores
codEmp = J1234567890123456789012345
Coloque aqui seu cdigo de empresa
formato = 1
Coloque aqui o tipo de retorno desejado: 0 para HTML ou 1 para XML
Recebe o pedido
pedido = Request.Form(pedido)
Set cripto = Server.CreateObject(Itaucripto.cripto)
Realiza a criptografia dos dados
dados = cripto.geraConsulta(codEmp, pedido, formato, chave)
set cripto = nothing
%>
<FORM METHOD=POST ACTION=https://shopline.itau.com.br/shopline/consulta.aspx
id=form1 name=form1>
<INPUT TYPE=hidden NAME=DCVALUE=<%= dados %>>
<INPUT TYPE=submit NAME=Shopline BORDER=0VALUE=Consulta ao
Pagamento>
</FORM>
RESULTADO DA CONSULTA EM FORMATO XML
<?xml version=1.0 encoding=ISO-8859-1?>
<!DOCTYPE consulta [
<!ELEMENT consulta (PARAMETER)>
<!ELEMENT PARAMETER (PARAM)+>
<!ELEMENT PARAM EMPTY>
<!ATTLIST PARAM ID CDATA #REQUIRED>
VALUE CDATA #REQUIRED>
]>
<consulta>
<PARAMETER>
<PARAM ID=CodEmpVALUE=/>
<PARAM ID=PedidoVALUE=/>
<PARAM ID=ValorVALUE=/>
<PARAM ID=tipPagVALUE=/>
<PARAM ID=sitPagVALUE=/>
<PARAM ID=dtPagVALUE=/>
<PARAM ID=codAutVALUE=/>
<PARAM ID=numIdVALUE=/>
<PARAM ID=compVendVALUE=/>
<PARAM ID=tipCartVALUE=/>
</PARAMETER>
</consulta>
50
5.1.5 Reemisso do Boleto Cdigo ASPX
valor e ainda no tiver sido pago, considerado uma reemisso.
Sendo assim, deve-se chamar sempre a URL de emisso, ou seja a mesma URL
utilizada para fazer a chamada do site.
51
Neste item usamos Java (Servlet) como linguagem web.
52
<HTML>
<HEAD>
<TITLE>Exemplo de cdigo HTML</TITLE>
</HEAD>
<BODY>
<FORM ACTION=ServletCriptoShopline METHOD=Post NAME=form1>
<CENTER>Entre com os Dados
<TR>
<TD width=25% align=center><B>Pedido (99999999):</B></TD>
<TD><INPUT type=text maxlength=8 size=8 name=pedido value=></TD>
</TR>
<TR>
<TD width=25% align=center><B>Valor (99999999,99):</B></TD>
<TD><INPUT type=text maxlength=10 size=10 name=valor value=></TD>
</TR>
<TR>
<TD width=25% align=right><B>Observao:</B></TD>
<TD><INPUT type=text maxlength=40 size=40 name=observacao value=></TD>
</TR>
<TR>
<TD width=25% align=right><B>Nome do Sacado:</B></TD>
<TD><INPUT type=text maxlength=30 size=30 name=nomeSacado value=></TD>
</TR>
<TR>
<TD width=25% align=right><B>Cdigo de Inscrio (01 CPF, 02 CNPJ):</B></TD>
<TD><INPUT type=text maxlength=2 size=2 name=codigoInscricao value=></TD>
</TR>
<TR>
<TD width=25% align=right><B>Nmero de Inscrio (CPF, CNPJ):</B></TD>
<TD><INPUT type=text maxlength=14 size=14 name=numeroInscricao value=></TD>
</TR>
<TR>
<TD width=25% align=right><B>Endereo do Sacado:</B></TD>
<TD><INPUT type=text maxlength=40 size=40 name=enderecoSacado value=></TD>
</TR>
<TR>
<TD width=25% align=right><B>Bairro:</B></TD>
<TD><INPUT type=text maxlength=15 size=15 name=bairroSacado value=></TD>
</TR>
<TR>
<TD width=25% align=right><B>CEP (99999999):</B></TD>
<TD><INPUT type=text maxlength=8 size=8 name=cepSacado value=></TD>
</TR>
<TR>
<TD width=25% align=right><B>Cidade:</B></TD>
<TD><INPUT type=text maxlength=15 size=15 name=cidadeSacado value=></TD>
</TR>
<TR>
<TD width=25% align=right><B>Estado:</B></TD>
<TD><INPUT type=text maxlength=2 size=2 name=estadoSacado value=></TD>
</TR>
<TR>
<TD width=25% align=right><B>Data de Vencimento (ddmmaaaa):</B></TD>
<TD><INPUT type=text maxlength=8 size=8 name=dataVencimento value=></TD>
</TR>
<TR>
<TD width=25% align=right><B>URL retorna:</B></TD>
<TD><INPUT type=text maxlength=60 size=60 name=urlRetorna value=></TD>
<TR>
<TD><INPUT type=text maxlength=60 size=60 name=obsAdicional1 value=></TD>
</TR>
<TR>
</TR>
<TR>
</TR>
</TABLE>
</CENTER>
<BR><BR>
<INPUT TYPE=submit value=Pagar name=Pagar>
</FORM>
</BODY>
</HTML>
53
import java.io.*;
import java.text.*;
import java.util.*;
import javax.servlet.*;
import javax.servlet.http.*;
import Itau.Itaucripto;
public class ServletCriptoShopline extends HttpServlet
{
private String codigoEmpresa; // Cdigo de identificao da empresa
private String chave; // Chave de criptografia da empresa
private String pedido; // Identificao do pedido
private String valor; // Valor do pedido
private String observacao; // Observaes
private String nomeSacado; // Nome do sacado
private String codigoInscricao; // Cdigo de Inscrio: 01->CPF, 02->CNPJ
private String numeroInscricao; // Nmero de Inscrio: CPF ou CNPJ
private String enderecoSacado; // Endereco do Sacado
private String bairroSacado; // Bairro do Sacado
private String cepSacado; // Cep do Sacado
private String cidadeSacado; // Cidade do sacado
private String estadoSacado; // Estado do Sacado
private String dataVencimento; // Vencimento do ttulo
private String urlRetorna; // URL do retorno
private String obsAdicional1; // ObsAdicional1
public void destroy()
{
}
public void doGet(HttpServletRequest request, HttpServletResponse response)
throws ServletException, IOException
{
service(request, response);
}
public void doPost(HttpServletRequest request, HttpServletResponse response)
{
service(request, response);
}

public void init()
{
}
public void service(HttpServletRequest request, HttpServletResponse response)
{
PrintWriter out = response.getWriter();
String dados; //Armazena os dados criptografados

//Inicializa as variveis
codigoEmpresa = J1234567890123456789012345; // <- Coloque aqui seu Cdigo de Empresa (26
posies)
chave = ABCD123456ABCD12; // <- Coloque aqui sua chave de criptografia (16 posies)

// Recebe valores da pgina anterior
pedido = request.getParameter(pedido); // obtm o valor do campo pedido
valor = request.getParameter(valor); // obtm o valor do campo valor
observacao = request.getParameter(observacao); // obtm o valor do campo observacao
nomeSacado = request.getParameter(nomeSacado); // obtm o valor do campo
nomeSacado
codigoInscricao = request.getParameter(codigoInscricao); // obtm o valor do campo
codigoInscricao
numeroInscricao = request.getParameter(numeroInscricao);// obtm o valor do campo
numeroInscricao
enderecoSacado = request.getParameter(enderecoSacado); // obtm o valor do campo
enderecoSacado
bairroSacado = request.getParameter(bairroSacado); // obtm o valor do campo
bairroSacado
cepSacado = request.getParameter(cepSacado); // obtm o valor do campo cepSacado
cidadeSacado = request.getParameter(cidadeSacado); // obtm o valor do campo
cidadeSacado
estadoSacado = request.getParameter(estadoSacado); // obtm o valor do campo
54
estadoSacado
dataVencimento = request.getParameter(dataVencimento); // obtm o valor do campo
dataVencimento
urlRetorna = request.getParameter(urlRetorna); // obtm o valor do campo urlRetorna
obsAdicional1 = request.getParameter(obsAdicional1); // obtm o valor do campo
obsAdicional1
obsAdicional2
obsAdicional3
//Inicializa a classe de criptografia do Shopline
Itaucripto cripto = new Itaucripto();
//Criptografa os dados chamando o mtodo geraDados da classe Itaucripto
dados = cripto.geraDados(codigoEmpresa,
pedido,
valor,
observacao,
chave,
nomeSacado,
codigoInscricao,
numeroInscricao,
enderecoSacado,
bairroSacado,
cepSacado,
cidadeSacado,
estadoSacado,
dataVencimento,
urlRetorna,
obsAdicional1,
obsAdicional2,
obsAdicional3
);

//Inicia a construo da pgina de resposta
response.setContentType(text/html);

out.println(<html>);
out.println(<body bgcolor=\white\>);
out.println(<head>);
out.println(<title> Teste Ita Shopline </title>);
out.println(</head>);
out.println(<body>);
out.println(<h1>Modelo Ita</h1>);

// Constri o formulrio para pagamento com shopline
out.println(<FORM METHOD=\POST\ ACTION=\https://shopline.itau.com.br/shopline/
shopline.aspx\ name=\form\ onsubmit=carregabrw() target=\SHOPLINE\>);
out.println(<INPUT TYPE=\hidden\ NAME=\DC\VALUE=\ + dados + \>);
out.println(<INPUT TYPE=\submit\ name=\Shopline\ value=\Ita Shopline\>);
out.println(</FORM>);
out.println(<script language=\JavaScript\>);
out.println();
out.println(</script>);
out.println(</body>);
out.println(</html>);
}
}
55
5.2.3 Retorno do Tipo de Pagamento Cdigo Java
O endereo para Retorno do Tipo de Pagamento ser composto da seguinte maneira:
HTTPS:// + URL de Retorno Cadastrada + URLRetorna do Pedido + parmetros
de retorno criptografados.
EXEMPLO:
URL de Retorno cadastrada no Mdulo Ita Shopline = www.minhaloja.com.br
URLretorna passada pelo lojista no pedido em questo = /final/retorno.aspx
Dados de retorno criptografados=?DC=A345B456F456W456T56J3K678
Exemplo da chamada URL final:
https://www.minhaloja.com.br/final/retorno.aspx?DC=A345B456F456W456T56J3K678
A pgina de retorno do pagamento deve receber os dados criptografados e chamar o
mtodo decripto e, para acessar o contedo de cada campo, necessrio usar os mtodos
que retornam seus contedos:
retornaCodEmp(), retornaPedido(), retornaTipPag()
EXEMPLO:

CodEmp
Cdigo da empresa
ou cdigo do site
Alfanumrico de 26 posies
Pedido Nmero do pedido Numrico com 8 posies
TipPag
Tipo de pagamento escolhido
pelo comprador
01 para pagamento vista (TEF ou CDC)
02 para boleto
throws ServletException, IOException {
String dados, chave;
String codEmp;
String pedido;
String tipPag;
chave = ABCD123456ABCD12; // <- Coloque aqui sua chave de criptografia (16
posies)
//Recebe valores da pgina anterior
dados = request.getParameter(DC);
//Decriptografa os dados chamando o mtodo decripto da classe Itaucripto e recebe os
dados
dados = cripto.decripto(dados, chave);
codEmp = cripto.retornaCodEmp();
pedido = cripto.retornaPedido();
tipPag = cripto.retornaTipPag();
// inicia a construo da pagina de resposta

response.setContentType(text/html);
out.println(<html>);
out.println(<head>);
out.println(<title>Retorno Online</title>);
out.println(</head>);
out.println(<body bgcolor=\white\>);
out.println(<h1>Retorno Ita</h1>);
out.println(dados + <br>);
out.println(codEmp + <br>);
out.println(pedido + <br>);
out.println(tipPag + <br>);
out.println(</body>);
out.println(</html>);
}
56
EXEMPLO:
throws ServletException, IOException {
String codEmp, pedido, formato, chave;
String dados;
chave = ABCD123456ABCD12; // <- Coloque aqui sua chave de criptografia (16
posies)

//Inicializa valores
codEmp = J1234567890123456789012345; // <- Coloque aqui seu cdigo de empresa
(26 posies)
formato = 0 // <-
Coloque aqui o tipo de retorno - 0 ou 1 dependendo do retorno
//Recebe o pedido
pedido = request.getParameter(pedido);
//Realiza a criptografia dos dados
dados = cripto.geraConsulta(codigoEmpresa, pedido, formato, chave);
// Monta o form para o envio dos dados a consulta
out.println(<form method=\post\ action=\https://shopline.itau.com.br/shopline/
consulta.aspx\ name=\form\ onsubmit=carregabrw() target=\shopline\>);
out.println(<input type=\hidden\ name=\DC\ value=\ + dados + \>);
out.println(<input type=\submit\ name=\Shopline\ value=\Consulta ao
Pagamento\>);
out.println(</form>);
RESULTADO DA CONSULTA EM FORMATO XML
<?xml version=1.0 encoding=ISO-8859-1?>
<!DOCTYPE consulta [
<!ELEMENT consulta (PARAMETER)>
<!ELEMENT PARAMETER (PARAM)+>
<!ELEMENT PARAM EMPTY>
<!ATTLIST PARAM ID CDATA #REQUIRED>
VALUE CDATA #REQUIRED>
]>
<consulta>
<PARAMETER>
<PARAM ID=CodEmpVALUE=/>
<PARAM ID=PedidoVALUE=/>
<PARAM ID=ValorVALUE=/>
<PARAM ID=tipPagVALUE=/>
<PARAM ID=sitPagVALUE=/>
<PARAM ID=dtPagVALUE=/>
<PARAM ID=codAutVALUE=/>
<PARAM ID=numIdVALUE=/>
<PARAM ID=compVendVALUE=/>
<PARAM ID=tipCartVALUE=/>
</PARAMETER>
</consulta>
57
valor e ainda no tiver sido pago, considerado uma reemisso. Sendo assim,
deve-se chamar sempre a URL de emisso, ou seja a mesma URL utilizada para
fazer a chamada do site.
58
A linguagem PHP geralmente utilizada em ambiente UNIX ou LINUX, mas ela
tambm pode ser utilizada em ambiente Windows. Para que a chamada da classe
Itaucripto.class ocorra com sucesso no PHP, necessrio que o servidor tenha
o ambiente Java instalado e que a verso PHP que est instalada no servidor
tenha suporte a Java. Abaixo segue um exemplo de envio e criptografia dos dados
utilizando a linguagem PHP para chamada da URL do Ita Shopline utilizando
a classe ItauCripto.class.
<HTML>
<HEAD>
<TITLE>Exemplo Ita Shopline</TITLE>
</HEAD>
<BODY>
<FORM action=https://shopline.itau.com.br/shopline/shopline.aspx method=post
name=form onsubmit=carregabrw() target=SHOPLINE>
<CENTER> Dados</CENTER>
<TR>
<TD WIDTH=25% ALIGN=center><B>Seu Pedido:<B/></TD>
<TD><?php echo $row[pedido]; ?></TD>
</TR>
<TR>
<TD WIDTH=25% ALIGN=center><B>Total a Pagar:<B/></TD>
<TD><?php echo $row[valor]; ?></TD>
</TR>
<TR>
<TD WIDTH=25% ALIGN=center><B>Observao:<B/></TD>
<TD><?php echo $row[observacao]; ?></TD>
</TR>
<TR>
<TD WIDTH=25% ALIGN=center><B>Nome do Sacado:<B/></TD>
<TD><?php echo $row[nomeSacado]; ?></TD>
</TR>
<TR>
<TD WIDTH=25% ALIGN=center><B>Cdigo de Inscrio:<B/></TD>
<TD><?php echo $row[codigoInscricao]; ?></TD>
</TR>
<TR>
<TD WIDTH=25% ALIGN=center><B>Nmero de Inscrio(CPF/CNPJ):<B/></TD>
<TD><?php echo $row[numeroInscricao]; ?></TD>
</TR>
<TR>
<TD WIDTH=25% ALIGN=center><B>Endereo do Sacado:<B/></TD>
<TD><?php echo $row[enderecoSacado]; ?></TD>
</TR>
<TR>
<TD WIDTH=25% ALIGN=center><B>Bairro:<B/></TD>
<TD><?php echo $row[bairroSacado]; ?></TD>
</TR>
<TR>
<TD WIDTH=25% ALIGN=center><B>CEP:<B/></TD>
<TD><?php echo $row[cepSacado]; ?></TD>
</TR>
<TR>
<TD WIDTH=25% ALIGN=center><B>Cidade:<B/></TD>
<TD><?php echo $row[cidadeSacado]; ?></TD>
</TR>
<TR>
<TD WIDTH=25% ALIGN=center><B>Estado:<B/></TD>
<TD><?php echo $row[estadoSacado]; ?></TD>
</TR>
<TR>
<TD WIDTH=25% ALIGN=center><B>Data de Vencimento(ddmmaaaa):<B/></TD>
<TD><?php echo $row[dataVencimento]; ?></TD>
</TR>
<TR>
<TD WIDTH=25% ALIGN=center><B>URL de Retorno:<B/></TD>
<TD><?php echo $row[urlRetorna]; ?></TD>
59
</TR>
<TR>
<TD WIDTH=25% ALIGN=center><B>Observao Adicional1:<B/></TD>
<TD><?php echo $row[obsAd1]; ?></TD>
</TR>
<TR>
</TR>
<TR>
</TR>
</TABLE>
<?php
$codEmp =J0012345678901234567890123;
$pedido =98988812;
$valor =0,01;
$observacao =;
$chave=A3G8E4C19N6W7BPS;
$nomeSacado =;
$codigoInscricao =;
$numeroInscricao =;
$enderecoSacado =;
$bairroSacado =;
$cepSacado =;
$cidadeSacado =;
$estadoSacado =;
$dataVencimento =;
$urlRetorna =;
$obsAd1 =;
$obsAd2 =;
$obsAd3 =;
function CreateObject()
{
$COM = new Java(Itau.Itaucripto);
return $COM;
}
$cripto = CreateObject();
$dados=$cripto->geraDados($codEmp,$pedido,$valor,$observacao,$chave,$n
omeSacado,$codigoInscricao,$numeroInscricao,$enderecoSacado,$bairroSacado,$cepSac
ado,$cidadeSacado,$estadoSacado,$dataVencimento,$urlRetorna,$obsAd1,$obsAd2,$obs
Ad3);
// echo <br><br>.$dados;
? >
<CENTER>
<BR><BR>
<INPUT type=hidden name=DC value=<? echo $dados; ?>>
<BR>
</FORM>
{

window.open(,SHOPLINE,toolbar=yes,menubar=yes,resizable=yes,status=no,scrollbars=y
es,width=815,height=575);
}
</script>
<BODY>
</HTML>
60
6. Auxlio Instalao do Ita Shopline
6.1 Mensagem de Erro de Sistema
Veja a seguir as possveis mensagens de erro de sistema e as providncias a serem tomadas.
Mensagem Providncias
Cep invlido. Verificar o campo de entrada cepSacado na chamada do mdulo Ita Shopline. Este deve ser numrico com 8 posies (99999999).
Cdigo de inscrio invlido. Verificar o campo de entrada CodigoInscricao na chamada do mdulo Ita Shopline. Este deve ser 01 para CPF e 02 para CNPJ.
Cdigo do sacado invlido. Idem ao erro Cdigo de inscrio invlido.
Data de vencimento invlida. Verificar o campo de entrada dataVencimento na chamada do mdulo Ita Shopline. Este deve ser numrico de 8 posies no formato DDMMAAAA.
Erro 9 - contate o Atendimento Cese. Contate o atendimento Cese no tel: 0 XX (11) 3019 4828, informando seu CNPJ, o nome de site e solicite a validao de seu contrato.
Erro na decriptografia dos dados. Erro na decriptografia tente novamente.
Formato invlido. Idem ao erro Nmero do pedido no numrico.
Nmero de inscrio invlido. Verificar o campo de entrada NumeroInscricao na chamada do mdulo Ita Shopline. Este deve ser numrico com 14 posies (99999999999999).
Nmero do pedido invlido. Verificar a consistncia do campo de entrada pedido na chamada do mdulo Ita Shopline. Este deve ser numrico com 8 posies (99999999).
Nmero do pedido no numrico. Verificar a consistncia do campo de entrada pedido na chamada do mdulo Ita Shopline. Este deve ser numrico com 8 posies (99999999).
Tamanho da chave diferente
de 16 posies.
Verificar o campo de entrada Chave na chamada do mdulo Ita Shopline.
Tamanho do cdigo da empresa diferente
de 26 posies.
Verificar o campo de entrada CodEmp na chamada do mdulo Ita Shopline.
Valor da compra deve possuir no mximo 8
posies antes da vrgula.
Verificar a consistncia do campo de entrada valor na chamada do mdulo Ita Shopline. Este deve ser numrico com 10 posies,
sendo 8 casas inteiras e 2 casas decimais, separadas obrigatoriamente por vrgula (99999999,99)
Valor da compra invlido.
Valor da compra no numrico.
Valor decimal da compra deve possuir
2 posies aps a vrgula.
Valor decimal no numrico.
61
A. Telas referentes ao Mdulo Ita Shopline
Veja a seguir o passo a passo da configurao da conta-corrente de seu site
para uso do Ita Shopline:
Tela do Menu Cobrana Tela de Criao da Chave
62
Tela de Criao da Chave
Ao acessar a funo pela primeira vez, ser necessrio configurar um dos cdigos
de habilitao de seu site, criando sua Chave de Criptografia conforme a regra
de formao disponvel na tela.
Na sequncia, consulte e/ou atualize as informaes cadastrais de seu site e copie a Chave
de Criptografia recm-criada e o Cdigo de Site fornecido pelo banco para posteriormente
inform-los ao responsvel pela instalao do Ita Shopline em seu site.
Tela de Informaes Cadastrais
63
Tela de Regra da Chave Tela da Mensagem Ps-Validao das Informaes Cadastrais
Clique aqui para voltar ao item 2.1. deste manual tcnico.
64
B. Tela do Ambiente de Teste do Ita Shopline:
Tela de Emisso do Boleto em Ambiente de Teste:
65
B. Tela do Ambiente de Teste do Ita Shopline:
Tela de Emisso do Boleto em Ambiente de Teste:
Esta a tela de emisso do boleto aps o acesso URL https://shopline.itau.com.
br/shopline/emissao_teste.asp, acionada pelo prprio desenvolvedor do site no
momento da instalao do Ita Shopline.
Se a tela de emisso do boleto acima foi exibida, os parmetros foram enviados
corretamente pela loja virtual.
No campo cedente deve aparecer o nome do site em questo, assim como
os demais dados enviados devero aparecer nos outros campos. Caso haja
algum problema com emisso de parmetros ou algum outro problema,
uma mensagem de inconsistncia vai ser exibida na tela de emisso.
Ateno: o endereo do Ambiente de Teste do produto no dever ser apresentado
aos compradores do site como forma de acesso ao meio de pagamento
Ita Shopline, pois nele no possvel efetuar operao alguma.
Esta URL apenas para verificar se houve sucesso no envio dos dados.
66
C. Telas principais da Plataforma Ita Shopline:
Tela Inicial do Ita Shopline:
Esta tela gerada aps o correto acesso URL https://shopline.itau.com.
br/shopline/shopline.aspx, acionada pelo comprador no ambiente do site.
Neste momento o banco recebeu corretamente os parmetros necessrios
criptografados pelo site.
No campo onde est escrito LOJA VIRTUAL SIMULADA aparecer o NOME DO
SITE cadastrado no sistema do produto poca da contratao. Para conferir seu
cadastro, basta acessar a funo Informaes Cadastrais do Mdulo Ita Shopline
acessado via Ita Empresas na internet.
A tela inicial do Ita Shopline apresenta todas as opes de pagamento
habilitadas para o site e dispostas da seguinte maneira: primeiro as opes
que sero acessadas em ambiente seguro Ita 30 horas, portanto, para acess-
las o comprador do site dever possuir seus dados de agncia, conta-corrente,
senha eletrnica e senha de carto junto ao banco. Em segundo lugar, a opo de
pagamento disponvel a todos os clientes do site que so carto de crdito
e boleto bancrio.
Se o comprador do site quiser acessar as opes disponveis para Clientes com
Acesso ao Ita 30 horas dever digitar seus dados de acesso ao Ita 30 horas
aps a escolha de vista ou Parcelado. Se o cliente escolher a opo Parcelado
e o login do comprador no tiver crdito pr-aprovado junto ao banco, esta opo
no aparecer para ele na segunda tela, mesmo que o site aceite esta forma
de pagamento, ser exibida a forma de pagamento vista.

A partir daqui, o comprador navegar por telas especficas de cada uma das opes
de pagamento possveis at chegar ao comprovante de pagamento de sua
transao que apresentado para as opes: pagamento vista por transferncia,
parcelado por Credirio Automtico Ita e carto de crdito. Se escolher a opo
boleto bancrio, ir visualiz-lo em sua tela e poder imprimi-lo ou pag-lo pelo
Ita 30 horas ou como preferir (internet banking, caixa eletrnico ou agncia)
respeitando as regras.
Se o comprador do site quiser acessar a opo disponvel para Clientes sem
Acesso ao Ita 30 horas imediatamente visualizar, na tela de seu computador,
o boleto bancrio do Ita Shopline, gerado pelo banco sob o registro na carteira
de cobrana 176. Este boleto j estar totalmente preenchido e apresentar,
alm do valor da compra e do n
o
do pedido j citados, todos os campos adicionais
enviados pelo site (conforme instrues do item 4.1 deste manual).
67
D. Tela do boleto bancrio do Ita Shopline:
A tela do boleto bancrio emitido pela primeira vez na Plataforma de Cobrana Ita
Shopline, seja pelo caminho de Clientes com Acesso ao Ita 30 horas ou pelo caminho
de Clientes sem Conta no Ita, exatamente igual tela do boleto reemitido.
68
E. Telas de exemplo da consulta de operaes do Mdulo Ita Shopline:
Para conhecer o Mdulo Ita Shopline, acesse o Ita Empresas na internet
na conta-corrente do site e siga a rota: Cobrana > Ita Shopline >
Consulta de Operaes:
Ita Empresas na internet: Recebimentos > Ita Shopline:
Clique aqui para voltar ao item 2.5.1. deste manual tcnico.
69
Lembramos que para programar a leitura do Arquivo Retorno e integr-lo
ao sistema de conciliao bancria de sua empresa, necessrio obter o Manual
de Intercmbio de Arquivos que especifica todos os campos que sero informados
no Arquivo Retorno de Cobrana. Para conhecer o layout da Cobrana Ita, acesse
a conta-corrente pelo Ita Empresas na internet e siga a rota: Produtos e Servios >
Download Center > Cobrana Manual de Intercmbio de Arquivos.
F. Telas de exemplo do Arquivo Retorno de Cobrana:
70
Voltar ndice Home
G. Tela de exemplo da Consulta Automtica Situao do Pagamento (sonda):
Retorno da Consulta em em XML:
Retorno da Consulta em HTML:

Manual Tecnico ItauShopline

Enviado por

Dados do documento

Direitos autorais

Formatos disponíveis

Compartilhar este documento

Compartilhar ou incorporar documento

Opções de compartilhamento

Você considera este documento útil?

Este conteúdo é inapropriado?

Direitos autorais:

Formatos disponíveis

Manual Tecnico ItauShopline

Enviado por

Direitos autorais:

Formatos disponíveis

Ita Shopline

Guia de Identidade Visual

Interesses relacionados

Você também pode gostar