Manual Tecnico ItauShopline

Instrues de
Instalao e
Utilizao
Manual Tcnico do Desenvolvedor do Site
Verso para Windows NT 4.0 ou Superior, Unix ou Linux
Verso Itaucripto 04 SP. 04/03/2004
NDICE
1. INFORMAES GERAIS..................................................................................................... 3
1.1.
1.2.
1.3.
Utilizao do Ita Shopline.............................................................................................................3

Configurao do Ita Shopline.......................................................................................................4
Instalao do Ita Shopline............................................................................................................4
2. SERVIOS DO ITA SHOPLINE........................................................................................... 5

2.1.
2.1.1.
2.1.2.
2.2.
2.3.
2.4.
2.5.
2.6.
2.6.1.
2.6.2.
2.6.3.
Mdulo Ita Shopline.....................................................................................................................5

Informaes Cadastrais do Site Lojista.........................................................................................5
Instrues de Instalao do produto..............................................................................................5
Ambiente de Teste do produto:......................................................................................................6
Gerao do Ita Shopline URL Principal de Acesso ao produto................................................6
Reemisso de Boletos...................................................................................................................6
Retorno Online do Tipo de Pagamento.........................................................................................7
Consulta de Operaes realizadas via Ita Shopline....................................................................7
Consulta de Operaes do Mdulo Ita Shopline.........................................................................7
Arquivo Retorno de Cobrana.......................................................................................................8
Consulta Automtica Situao do Pagamento (sonda)............................................................10
3. LAYOUT DOS CAMPOS.................................................................................................... 12

3.1.
Parmetros e Critrios de Consistncias....................................................................................12
4. INFORMAES TCNICAS............................................................................................... 16
4.1.
4.1.1.
4.1.2.
4.2.
4.2.1.
4.2.2.
Usando Itaucripto.dll - Para ambientes Microsoft (Windows NT 4.0 ou superior).......................16

Passo 1: Criptografia....................................................................................................................16
Passo 2: Chamada tela do Ita Shopline.................................................................................16
Para ambientes Unix ou Linux.....................................................................................................17
Passo 1: Criptografia....................................................................................................................17
Passo 2: Chamada tela do Ita Shopline.................................................................................17
5. EXEMPLOS DE CDIGO................................................................................................... 19
5.1.
Usando Itaucripto.dll - Para ambientes Microsoft (Windows NT 4.0 ou superior).......................19
5.1.1. Envio dos Dados Pgina Inicial HTML.....................................................................................19
5.1.2. Criptografia dos dados Cdigo ASP.........................................................................................20
5.1.3. Retorno do Tipo de Pagamento Cdigo ASP...........................................................................21
5.1.4. Consulta Situao do Pagamento Cdigo ASP.....................................................................22
5.1.5. Reemisso do Boleto Cdigo ASP...........................................................................................23
5.2.
Para ambientes Unix ou Linux.....................................................................................................23
5.2.1. Envio dos Dados Pgina Inicial HTML....................................................................................23
5.2.2. Criptografia dos dados Cdigo Java.........................................................................................24
5.2.3. Retorno do Tipo de Pagamento Cdigo Java...........................................................................26
5.2.4. Consulta Situao do Pagamento Cdigo Java....................................................................27
5.2.5. Reemisso do Boleto Cdigo Java...........................................................................................28
5.3
Envio e criptografia dos dados - Cdigo PHP.............................................................................29
6. AUXLIO INSTALAO DO ITA SHOPLINE..................................................................... 31

6.1.
Mensagens de Erro de Sistema...................................................................................................31
ANEXOS DEMONSTRATIVOS.................................................................................................... 32
Pg. 2
1. INFORMAES GERAIS
O Ita Shopline uma plataforma eletrnica de opes de pagamento a ser utilizada como forma de cobrana via
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:
Pagamento vista por transferncia carteira de cobrana 178;

Financiamento por Credirio Automtico Ita carteira de cobrana 178;
Carto Itaucard (Mastercard, Diners e Visa) cdigo de filiao do lojista junto Redecard e Visanet;
Boleto Bancrio carteira de cobrana 176.
As trs primeiras opes so exclusivas para clientes Ita que acessarem este meio de pagamento no site do lojista e o
Boleto atender necessidade de liquidao financeira de todos os compradores do site. Para habilitar a opo de
cobrana por Carto Itaucard necessrio que o site lojista esteja filiado (s) operadora(s) de carto de crdito de seu
interesse e cadastre junto ao banco 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 principal nfase para a liquidao online, agilizando o processo de compra na internet.
1.1. Utilizao do Ita Shopline

Independente do modelo de negcio de cada site, isto , se o processo de compra ocorre em seqncia 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
Ita Shopline e o banner relativo ao produto. No Anexo Demonstrativo deste manual esto 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 sobre a opo de pagamento escolhida pelo
cliente, em ambiente Ita, atravs do Retorno Online 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.
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, consulte o item 2.6. 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.
Pg. 3
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 Bankline (internet banking do
Ita) e contrato formalizado para utilizar o Ita Shopline.
Para contratar o Ita Shopline, o responsvel pela conta corrente do site formaliza a proposta de contratao do produto
junto ao gerente de sua conta e assim que aprovada, recebe o contrato para assinatura e uma confirmao por e-mail
indicando o acesso s Instrues de Cadastro e Instalao do produto em seu site.
Todas as Informaes Cadastrais do site e as Instrues de Instalao para uso do produto so disponibilizadas ao
responsvel pela conta corrente do site no Mdulo Ita Shopline acessado via Ita Bankline (Empresa ou Empresa
Plus) pela rota: Produtos e Servios, Ita Shopline.
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 bsica do Ita Shopline so: Pagamento Vista por
Transferncia, Financiamento por Credirio Automtico Ita e Boleto Bancrio. A cobrana por Carto Itaucard
(Mastercard, Diners ou Visa) via Ita Shopline opcional e s estar disponvel aos compradores de seu site se houver
a liberao dos cdigos de filiao de seu site junto s bandeiras de seu interesse.
Atravs do Mdulo Ita Shopline possvel configurar:
- os cdigos de filiao junto aos sistemas REDECARD e/ou VISANET;
- alguns parmetros adicionais relativos opo Boleto Bancrio, tais como: prazo padro de vencimento, nome do
cedente (site) no Boleto e mensagens adicionais;
- o endereo principal do servidor seguro de seu site (SSL) para uso da funo Retorno Online / Consulta Automtica;
- as categorias de atuao de seu site para posterior publicao de um link no Portal Ita Shopline.
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.
Para maiores informaes sobre as funcionalidades do produto, acesse o Portal Ita Shopline na seo Para o Lojista
j Cadastrado.
Pg. 4
2. SERVIOS DO ITA SHOPLINE

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.
2.1. Mdulo Ita Shopline

2.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 Bankline (internet banking do Ita) da conta corrente do site do lojista.
Dentro do Ita Bankline, a rota de acesso a esta funo : Produtos e Servios > 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 1(um) dia til aps a alterao.
Para acessar o Ita Bankline, necessrio entrar no site o Ita (http://www.itau.com.br/) e digitar:
- dados de Agncia, Conta Corrente e Senha Eletrnica na barra de acesso ao Ita Bankline Empresa;
- ou dados de Usurio Operador e Senha Eletrnica na barra de acesso ao Ita Bankline Empresa Plus.
Clique aqui para visualizar as principais telas do Mdulo Ita Shopline.
2.2. Instrues de Instalao do produto.

Todas as Instrues de Instalao do produto esto contidas neste manual tcnico. Futuras atualizaes de verso
estaro sempre disponveis para download no Mdulo Ita Shopline.
Dentro do Ita Bankline, a rota de acesso a esta funo : Produtos e Servios > Ita Shopline > Instalao.
A instalao 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.
O componente de criptografia, banners e botes do Ita Shopline e o texto explicativo do produto tambm se encontram
no Portal Ita Shopline, a partir da rota: Para o Lojista j Cadastrado >> Instalao >> Itens para download.
Para resolver dvidas quanto instalao do meio de pagamento Ita Shopline em seu site, entre em contato
com a o atendimento Cese no tel: 0 XX (11 ) 3019 4828
Pg. 5
2.2. Ambiente de Teste do produto:

Este ambiente acessado atravs do envio dos dados criptografados para a URL:
https://shopline.itau.com.br/shopline/emissao_teste.asp
O Ita disponibiliza aos lojistas do Ita Shopline, um ambiente de teste que permite verificar se os parmetros enviados
foram recebidos com sucesso, isto , se foi possvel acessar o ambiente Ita e se os dados de cobrana do pedido
foram identificados corretamente para que o cliente comprador consiga pag-lo.
Neste ambiente de teste, somente ser possvel realizar a emisso de Boletos pois por se tratar de um teste, no
haver registro de dados real na base da cobrana. As demais opes de pagamento da plataforma s funcionaro em
ambiente de produo, pois no possvel testar uma transferncia, um financiamento ou uma transao por carto
sem usar contas de verdade.
Testar a gerao do Ita Shopline, portanto, significa verificar se houve o correto envio e recepo de todos os
parmetros especificados no item 3 deste manual.
Clique aqui para visualizar o Ambiente de Teste do Ita Shopline.
2.3. 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.asp
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.
2.4. Reemisso de Boletos

A Reemisso de Boleto feita automaticamente pela URL de emisso na aplicao Ita Shopline.Se o pedido informado
ja 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 par 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.
Pg. 6
2.5. Retorno Online do Tipo de Pagamento

O Ita disponibiliza aos lojistas do Ita Shopline o Retorno Online, 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 cadastrado 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 Online 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 subseqentes.
Tempo de disponibilizao: online 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 Online 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).
2.6. Consulta de Operaes realizadas via Ita Shopline

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.
2.6.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 Bankline.
Forma de acesso: Ita Bankline da conta corrente do site. A rota para esta consulta no Mdulo Ita Shopline :
Produtos e Servios, Ita Shopline, Consulta de Operaes.
Formato da consulta: a partir da navegao no Ita Bankline pelas rotas indicadas abaixo, o usurio visualiza listagens
de pedidos efetuados em seu site que sero identificadas conforme a opo de pagamento escolhida pelo comprador.
Pg. 7
Para o lojista, as opes possveis so: Pagamento Vista (178) ou 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.
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: online e real time assim que o pedido registrado no banco e associado a alguma das
opes de pagamento da plataforma, esta 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.
2.6.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 Ita. A
forma mais simples de obter o arquivo atravs do Ita Bankline da conta corrente do site.
- Para usurios do Ita Bankline Empresa, a rota para baixar o Arquivo Retorno : Produtos e Servios,
Transferncia de Arquivos, Retorno.
- Para usurios do Ita Bankline Empresa Plus, a rota : Transferncia de Arquivos, Arquivo Retorno.
Formato da consulta: arquivo de texto (extenso .txt) padro CNAB que informa todas as operaes liquidadas,
conforme a carteira de cobrana associada ao n do ttulo. Nas carteiras utilizadas pelo Ita Shopline, o n 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 Bankline e siga a
rota: Produtos e Servios, Download Center, Cobrana Manual de Intercmbio de Arquivos.
Pg. 8
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 Bankline 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.
Outras formas de acompanhar o status do pagamento so: Consulta de Operaes do Mdulo Ita Shopline ou Consulta
automtica a situao do pagamento (sonda).
Clique aqui para visualizar um exemplo do Arquivo Retorno de Cobrana.
Pg. 9
2.6.3.
Consulta Automtica Situao do Pagamento (sonda)
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.asp.
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 decriptografar o resultado da consulta so utilizados: 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
ONLINE 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)
ONLINE E REAL TIME

- 00 para pagamento efetuado
- 02 para Boleto Bancrio
ONLINE 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 Itaucard
ONLINE E REAL TIME

De acordo com a tabela acima, 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 titulo 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
Pg. 10
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 final 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: online e real time aps receber o Retorno Online, o site poder preparar seu servidor
para disparar uma Consulta Automtica ao servidor do banco para obter a Situao do Pagamento do pedido retornado.
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 maiores informaes, procure seu Gerente Ita.
O responsvel pelo site escolher a(s) modalidade(s) de consulta mais conveniente(s).
Pg. 11
3. LAYOUT DOS CAMPOS

3.1. Parmetros e Critrios de Consistncias
Os parmetros que sero utilizados na criptografia para a gerao do Ita Shopline devem seguir todos os critrios aqui
especificados para que o ambiente Ita Shopline 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:
Parmetros Obrigatrios
Parmetros
CodEmp
Descrio
Cdigo da Empresa (Cdigo do Site)
Pedido
Nmero do Pedido
Valor
Valor Total do Pagamento
Chave
Chave de Criptografia
Critrios de Consistncia
Alfanumrico com exatas 26 posies.
(enviar o cdigo todo em maisculas)
Numrico com o mximo de 08 posies (99999999)
(*)
Nmeros inteiros de at 8 posies (99999999,99).
Os centavos devero ser enviados com 2 casas
decimais (no obrigatrio), utilizando a vrgula como
separador.
Alfanumrico com exatas 16 posies
(enviar a chave toda em maisculas)
Sugesto para teste inicial de gerao do Ita Shopline:

Executar uma chamada tela do Ita Shopline enviando na linha de criptografia apenas os dados obrigatrios
preenchidos (ver detalhes de envio no item 4 deste manual: Informaes Tcnicas, Passo 2, regra 3).
Assim que a criptografia for aceita pelo banco e o site for identificado na tela inicial do Ita Shopline, executar a
chamada tela do Ita Shopline enviando, alm dos dados obrigatrios, os dados opcionais de seu interesse, seguindo
sempre os tamanhos e formatos dos campos, conforme definies dos critrios de layout aqui citadas.
No Anexo Demonstrativo deste manual esto as telas correspondentes a cada url acessada conforme o servio
desejado e as indicaes do que dever aparecer em cada um dos casos para que o acesso ao ambiente Ita seja
realizado com sucesso.
( * ) A reutilizao da numerao de um pedido s poder ser feita:
- Para os pedidos no finalizados, 60 dias corridos da data do pedido.
Pg. 12
Parmetros Opcionais
Parmetros
Observacao
Descrio
Espao disponvel para enviar uma linha de
mensagem nica por pedido ou um
parmetro indicando qual Mensagem
Adicional (1) se quer apresentar.
NomeSacado
Nome do sacado
Codigoinscricao
Cdigo de inscrio do sacado
NumeroInscricao
Nmero de inscrio do sacado
EnderecoSacado
Endereo do sacado
Numrico com exatamente 02 posies:

- 01 para CPF
- 02 para CNPJ
Numrico com 14 posies
(99999999999999)
Alfanumrico com o mximo de 40 posies
BairroSacado
Bairro do sacado
CepSacado
CEP do sacado
Numrico com exatamente 08 posies (99999999)
CidadeSacado
Cidade do sacado
EstadoSacado
Estado do sacado
dataVencimento
Data de vencimento do ttulo
UrlRetorna
Parte final da URL de Retorno Completa (2)
Alfanumrico com exatamente 02 posies

Somente sero aceitos estados brasileiros.
Numrico com exatamente 08 posies
Utilizar o formato ddmmaaaa
Alfanumrico com o mximo de 60 posies.
ObsAdicional1
ObsAdicional2
ObsAdicional3
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.
URL de Retorno Completa = URL de Retorno + urlRetorna
Espao disponvel para enviar uma linha de Alfanumrico com o mximo de 60 posies.
mensagem nica por pedido, que s ser
exibida se o campo Observao contiver o
texto 3.
texto 3.
texto 3.
(1)
Mensagem Adicional: Conforme os critrios do parmetro Observacao (vide tabela acima) 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
Pg. 13
- Mensagem Adicional 1(parmetro 1)
Mensagem padro pr-cadastrada que ser exibida na emisso e na reeemisso 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 que ser exibida na emisso e na reeemisso do

Boleto (se houver) e dever 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 que ser exibida na emisso e na reeemisso do Boleto (se
houver) e dever ser enviada nos campos ObsAdicional1, ObsAdicional2 e ObsAdicional3.
(2)
URL de Retorno Completa: o endereo SSL para o qual ser enviado o Retorno Online do Tipo de Pagamento escolhido pelo
comprador nas telas do Ita Shopline. Para mais detalhes sobre como execut-lo, vide item 5.3. deste manual.
A URL de Retorno Completa dever ter no mximo 60 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 acima) que indica que o site deseja receber o Retorno
Online 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.
Pg. 14
Os dados que sero utilizados para interpretar o Retorno Online do Tipo de Pagamento oferecido pelo banco e
realizar a Consulta Automtica Situao do Pagamento (sonda) do pedido efetuado em ambiente Ita Shopline
devem seguir todos os critrios especificados seguir:
Parmetros para Retorno Online do Tipo de Pagamento

Parmetros
TipPag
Descrio
Tipo de pagamento
comprador
escolhido
pelo Numrico com 02 posies:
- 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.
Parmetros para Consulta Situao de Pagamento

Parmetros
Formato
Descrio
Formato do retorno da consulta
TipPag
Tipo de pagamento
comprador
SitPag
Situao de pagamento do pedido
Numrico com 02 posies:

- 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)
- 04 para Boleto emitido com sucesso
- 05 para pagamento efetuado, aguardando compensao
- 06 para pagamento no compensado
DtPag
Data do pagamento
Numrico com 08 posies no formato ddmmaaaa
CodAut
Nmero de autorizao - preenchido

somente quando pagamento efetuado com
carto Itaucard
NSU da transao preenchido somente
quando pagamento efetuado com carto
Itaucard
Nmero do comprovante de venda
preenchido somente quando pagamento
efetuado com carto Itaucard, bandeira
Mastercard/Diners.
Tipo de carto Itaucard escolhido pelo
comprador.
Alfanumrico com 06 posies
escolhido
Critrios
Numrico com 01 posio:
- 0 para formato de pgina HTML para consulta visual
- 1 para formato XML
pelo Numrico com 02 posies:
- 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.
NumId
CompVend
TipCart
Alfanumrico com 1 posio:

- M para cartes REDECARD (bandeira Mastercard ou
Diners)
- V para cartes VISANET (bandeira Visa)
Pg. 15
4. INFORMAES TCNICAS
Para que seja feita a instalao do Ita Shopline, necessrio que exista um Servidor Web. Aps instaldo, devem ser
executados os passos descritos a seguir.
4.1. Usando Itaucripto.dll - Para ambientes Microsoft (Windows NT 4.0 ou superior)

Neste item usamos ASP (VBScript) com linguagem, porm nada impede que utilize outra linguagem web.
4.1. Passo 1: Criptografia

A rota de acesso a este componente no Ita Bankline :
Produtos e Servios >> 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
4.2. Passo 2: Chamada tela do Ita Shopline

A pgina ASP que criptografa os dados para envi-los ao Ita Shopline deve seguir 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 ) 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, , , , , , , , , , , , ,)
( 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.asp
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.
Pg. 16
EXEMPLO:
<FORM action="https://shopline.itau.com.br/shopline/shopline.asp" 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 = 675 (sugesto)
HEIGHT = 485 (sugesto)
EXEMPLO:
<script language="JavaScript">
<!-function carregabrw()
{
window.open('', 'SHOPLINE', 'toolbar=yes,menubar=yes,resizable=yes,status=no,scrollbars=yes,width=675,height=485');
}
//-->
</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.
4.2. Para ambientes Unix ou Linux

Neste item usamos Java (Servlet) como linguagem web.
4.2.1.
Passo 1: Criptografia
A rota de acesso a este componente no Ita Bankline :

Produtos e Servios >> Ita Shopline >> Instalao
No diretrio onde o Java ser compiliado, crie um subdiretrio Itau e copie a classe Itaucripto para este novo subdiretrio.
4.2.2.
Passo 2: Chamada tela do Ita Shopline
O Servlet que criptografa os dados para envi-los ao Ita Shopline deve seguir 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:
Pg. 17

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.asp
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.asp\"
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
SCROLLBARS = YES
WIDTH = 675 (sugesto)
HEIGHT = 485 (sugesto)
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.
Pg. 18
5. EXEMPLOS DE CDIGO
5.1. Usando Itaucripto.dll - Para ambientes Microsoft (Windows NT 4.0 ou superior)
Neste item usamos ASP (VBScript) como linguagem, porm nada impede que utilize outra linguagem web.
5.1. Envio dos Dados Pgina Inicial HTML

<HTML>
<HEAD>
<TITLE>Exemplo de cdigo HTML</TITLE>
</HEAD>
<BODY>
<FORM ACTION="Nome da Pgina de Criptografia" 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>
<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>
Pg. 19
<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>
5.2. Criptografia dos dados Cdigo ASP

<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"
chave = "ABCD123456ABCD12"
pedido = Request.Form("pedido")
valor = Request.Form("valor")
observacao = Request.Form("observacao")
nomeSacado = Request.Form("nomeSacado")
codigoInscricao = Request.Form("codigoInscricao")
numeroInscricao = Request.Form("numeroInscricao")
enderecoSacado = Request.Form("enderecoSacado")
bairroSacado = Request.Form("bairroSacado")
cepSacado = Request.Form("cepSacado")
cidadeSacado = Request.Form("cidadeSacado")
estadoSacado = Request.Form("estadoSacado")
dataVencimento = Request.Form("dataVencimento")
urlRetorna = Request.Form("urlRetorna")
obsAdicional1 = Request.Form("obsAdicional1")
'Coloque aqui o cdigo da empresa

'Coloque aqui a chave de criptografia em maiscula
'obtm o valor do campo "pedido"
'obtm o valor do campo "valor"
'obtm o valor do campo "observacao"
'obtm o valor do campo "nomeSacado"
'obtm o valor do campo "codigoInscricao"
'obtm o valor do campo "numeroInscricao"
'obtm o valor do campo "enderecoSacado"
'obtm o valor do campo "bairroSacado"
'obtm o valor do campo "cepSacado"
'obtm o valor do campo "cidadeSacado"
'obtm o valor do campo "estadoSacado"
'obtm o valor do campo "dataVencimento"
'obtm o valor do campo "urlRetorna"
'obtm o valor do campo "obsAdicional1"
Set cripto = server.createobject("Itaucripto.cripto")

enderecoSacado, bairroSacado, cepSacado, cidadeSacado, estadoSacado, dataVencimento, urlRetorna, obsAdicional1, obsAdicional2,
obsAdicional3)
Set cripto = nothing
%>
<FORM ACTION="https://shopline.itau.com.br/shopline/shopline.asp" method="post" name="form1" onsubmit=carregabrw()
target="SHOPLINE">
<INPUT type="hidden" name="DC" value="<%= dados %>">
<BR>
</form>
Pg. 20
<!-function carregabrw()
{
window.open('', 'SHOPLINE', 'toolbar=yes,menubar=yes,resizable=yes,status=no,scrollbars=yes,width=675,height=485');
}
//-->
</script>
</BODY>
</HTML>
5.3. Retorno do Tipo de Pagamento Cdigo ASP

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.asp
Dados de retorno criptografados=?DC=A345B456F456W456T56J3K678
Exemplo da chamada URL final: https://www.minhaloja.com.br/final/retorno.asp?
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
Pedido
TipPag
Cdigo da Empresa ou Cdigo do Site

Numero do Pedido
Tipo de pagamento escolhido pelo comprador
Alfanumrico de 26 posies
-
01 para Pagamento Vista (TEF ou CDC)

02 para Boleto
03 para Carto Itaucard
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>
Pg. 21
5.4. Consulta Situao do Pagamento Cdigo ASP

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.asp" id=form1 name=form1>
<INPUT TYPE="hidden" NAME="DC" VALUE="<%= dados %>">
<INPUT TYPE="submit" NAME="Shopline" BORDER="0" VALUE="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="CodEmp" VALUE=""/>
<PARAM ID="Pedido" VALUE=""/>
<PARAM ID="Valor" VALUE=""/>
<PARAM ID="tipPag" VALUE=""/>
<PARAM ID="sitPag" VALUE=""/>
<PARAM ID="dtPag" VALUE=""/>
<PARAM ID="codAut" VALUE=""/>
<PARAM ID="numId" VALUE=""/>
<PARAM ID="compVend" VALUE=""/>
<PARAM ID="tipCart" VALUE=""/>
</PARAMETER>
</consulta>
Pg. 22
5.5. Reemisso do Boleto Cdigo ASP.

Para ambientes Unix ou Linux
Neste item usamos Java (Servlet) como linguagem web.
5.2.1.
Envio dos Dados Pgina Inicial HTML

<HTML>
<HEAD>
<TITLE>Exemplo de cdigo HTML</TITLE>
</HEAD>
<BODY>
<FORM ACTION="ServletCriptoShopline" 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>
<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>
Pg. 23
<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>
5.2.2.
Criptografia dos dados Cdigo Java

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
// ObsAdicional2
// ObsAdicional3
public void destroy()
{
}
public void doGet(HttpServletRequest request, HttpServletResponse response)
throws ServletException, IOException
{
service(request, response);
Pg. 24
}
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 "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 = request.getParameter("obsAdicional2"); // obtm o valor do campo "obsAdicional2
obsAdicional3 = request.getParameter("obsAdicional3"); // obtm o valor do campo "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");
Pg. 25
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.asp\" 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>");
}
}
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.asp
Dados de retorno criptografados=?DC=A345B456F456W456T56J3K678
Exemplo da chamada URL final:
https://www.minhaloja.com.br/final/retorno.asp?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
Pedido
TipPag
Cdigo da Empresa ou Cdigo do Site

Numero do Pedido
Tipo de pagamento escolhido pelo comprador
Alfanumrico de 26 posies
-
01 para Pagamento Vista (TEF ou CDC)

02 para Boleto
03 para Carto Itaucard
EXEMPLO:
throws ServletException, IOException {
String dados, chave;
String codEmp;
String pedido;
String tipPag;
chave
//Recebe valores da pgina anterior

Pg. 26
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>");
}
5.2.4.
Consulta Situao do Pagamento Cdigo Java

EXEMPLO:
throws ServletException, IOException {
String codEmp, pedido, formato, chave;
String dados;
chave
//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.asp\" 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>");
Pg. 27
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="CodEmp" VALUE=""/>
<PARAM ID="Pedido" VALUE=""/>
<PARAM ID="Valor" VALUE=""/>
<PARAM ID="tipPag" VALUE=""/>
<PARAM ID="sitPag" VALUE=""/>
<PARAM ID="dtPag" VALUE=""/>
<PARAM ID="codAut" VALUE=""/>
<PARAM ID="numId" VALUE=""/>
<PARAM ID="compVend" VALUE=""/>
<PARAM ID="tipCart" VALUE=""/>
</PARAMETER>
</consulta>
5.2.5.
Reemisso do Boleto Cdigo Java
5.3 Envio e Criptografia dos dados Cdigo PHP.
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 esta 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.asp" method="post" name="form" onsubmit=carregabrw() target="SHOPLINE">
<CENTER> Dados</CENTER>
<TABLE width="100%" border=1 align=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>
Pg. 28
<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>
</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 ="J0046245690001890000001418";
$pedido ="98988812";
$valor ="0,01";
$observacao ="";
$chave="A3G8E4C19N6W7BPS";
$nomeSacado ="";
$codigoInscricao ="";
Pg. 29
$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,$nomeSacado,$codigoInscricao,$numeroInscricao,
$enderecoSacado,$bairroSacado,$cepSacado,$cidadeSacado,$estadoSacado,$dataVencimento,$urlRetorna,$obsAd1,$obsAd2,$obsAd3);
// echo "<br><br>".$dados;
?>
<CENTER>
<BR><BR>
<INPUT type="hidden" name="DC" value="<? echo $dados; ?>">
<BR>
</FORM>
function carregabrw()
{
window.open('','SHOPLINE',"toolbar=yes,menubar=yes,resizable=yes,status=no,scrollbars=yes,width=675,height=485");
}
</script>
<BODY>
</HTML>
6.0 Auxlio Instalao do Ita Shopline

6.1. Mensagens de Erro de Sistema
Veja a seguir as possveis mensagens de erro de sistema e as providncias a serem tomadas.
MENSAGEM
Cep invlido.
Cdigo de inscrio invlido.
Cdigo do sacado invlido.
Data de vencimento invlida.
Erro 9 contate o Atendimento Cese
PROVIDNCIAS
Verificar o campo de entrada cepSacado na chamada do mdulo Ita
Shopline. Este deve ser numrico com 8 posies (99999999).
Verificar o campo de entrada CodigoInscricao na chamada do mdulo
Ita Shopline. Este deve ser 01 para CPF e 02 para CNPJ
Idem ao erro Cdigo de inscrio invlido..
Verificar o campo de entrada dataVencimento na chamada do mdulo
Ita Shopline. Este deve ser numrico de 8 posies no formato
DDMMAAAA.
Contate o atendimento Cese no tel : 0 XX (11) 3019 4828
Informando seu CNPJ e Nome de Site e solicite a validao de seu
contrato.
Pg. 30
MENSAGEM
PROVIDNCIAS
Erro na decriptografia dos dados

Formato invlido.
Nmero de inscrio invlido.
Erro na decriptografia, tente novamente.

Idem ao erro Numero do pedido no numrico..
Verificar o campo de entrada NumeroInscrucao na chamada do mdulo
Ita Shopline. Este deve ser numrico com 14 posies
(99999999999999).
Verificar a consistncia do campo de entrada pedido na chamada do
mdulo Ita Shopline. Este deve ser numrico com 8 posies
(99999999)
Verificar a consistncia do campo de entrada pedido na chamada do
mdulo Ita Shopline. Este deve ser numrico com 8 posies
(99999999)
Verificar o campo de entrada Chave na chamada do mdulo Ita
Shopline
Verificar o campo de entrada CodEmp na chamada do mdulo Ita
Shopline
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)
vrgula (99999999,99)
vrgula (99999999,99)
vrgula (99999999,99)
vrgula (99999999,99)
Nmero do pedido invlido.
Numero do pedido no numrico.
Tamanho da chave diferente de 16 posies.

Tamanho do codigo da empresa diferente de 26
posies.
Valor da compra deve possuir no mximo 8
posies antes da virgula.
Valor da compra invlido.
Valor da compra no numrico.
Valor decimal da compra deve possuir 2

posies aps a virgula.
Valor decimal no numrico.
Pg. 31
ANEXOS DEMONSTRATIVOS
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 Produtos e Servios
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.
Pg. 32
Na seqncia, 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
Pg. 33
Tela de Regra da Chave
Tela da Mensagem Ps Validao das Informaes Cadastrais
Clique aqui para voltar ao item 2.1. deste manual tcnico.
Pg. 34
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 houver 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 hove sucesso no envio dos dados.
Pg. 35
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.asp, 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 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 Bankline.
A tela inicial do Ita Shopline apresenta todas as opes de pagamento habilitadas para o site dispostas da seguinte
maneira: primeiro as opes que sero acessadas em ambiente seguro Ita Bankline, 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 e, em segundo lugar, a opo de pagamento disponvel a todos os clientes do site que o Boleto Bancrio.
Se o comprador do site quiser acessar as opes disponveis para Clientes com Acesso ao Ita Bankline dever
digitar seus dados de acesso ao Ita Bankline e ver, entre as opes habilitadas pelo site, todas as que forem
possveis para sua conta. Isso significa, por exemplo, que se um comprador no tem Crdito Pr-aprovado junto ao
banco, esta opo no aparecer para ele na segunda tela, mesmo que o site aceite esta forma de pagamento.
Veja a seguir a Segunda Tela do Ita Shopline (completa) acessada aps a confirmao da agncia, conta e senha:
Pg. 36
2 Tela do Ita Shopline - Tela Ps Logon no Bankline
Nesta tela o comprador ver novamente a identificao do NOME DO SITE onde fez sua compra e ver tambm o
resumo de sua compra para que confira as informaes do pedido que pretende pagar em ambiente Ita Shopline.
A partir daqui, o comprador navegar por telas especficas de cada uma das opes de pagamento possveis para sua
conta at chegar ao comprovante de pagamento de sua transao que apresentado para as opes: Pagamento
vista por transferncia, Financiamento por Credirio Automtico Ita e Carto Itaucard. Se escolher a opo Boleto
Bancrio, ir visualiz-lo em sua tela e poder imprim-lo e pag-lo 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 Bankline 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 do
Pedido j citados, todos os campos adicionais enviados pelo site (conforme instrues do item 4.1 deste manual).
Para visualizar toda a seqncia de telas que compem a Plataforma de Cobrana Ita Shopline, acesse o TEST
DRIVE do produto disponvel no Portal Ita Shopline.
Pg. 37
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 Bankline ou pelo caminho de Clientes sem Conta no Ita, exatamente igual tela do
Boleto reemitido.
Pg. 38
E. Telas de Exemplo da Consulta de Operaes do Mdulo Ita Shopline:

Para conhecer o Mdulo Ita Shopline, acesse o Ita Bankline da conta corrente do site e siga a rota: Produtos e
Servios, Ita Shopline, Consulta de Operaes:
Clique aqui para voltar ao item 2.6.1. deste manual tcnico.
Pg. 39
F. Telas de Exemplo do Arquivo Retorno de Cobrana:
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 o Ita Bankline da conta
corrente do site e siga a rota: Produtos e Servios, Download Center, Cobrana Manual de Intercmbio de Arquivos.
Pg. 40
G. Tela de Exemplo da Consulta Automtica Situao do Pagamento (sonda):

Retorno da Consulta em em XML:
Retorno da Consulta em HTML :
Pg. 41
H. Regras de Utilizao da marca Ita Shopline no Site da Loja Virtual

De acordo com Anexo III do contrato do produto Ita Shopline, necessrio identificar em seu site a forma de
pagamento com a nomenclatura: Ita Bankline.
Se quiser informar mais detalhes sobre o meio de pagamento Ita Shopline, utilize o texto explicativo oficial do produto.
Para detalhar as opes que compem o Ita Shopline, utilize os termos apresentados em um dos exemplos a seguir:
(1)
-
Ita Bankline:
Pagamento Vista por Transferncia
Financiamento por Credirio Automtico Ita
Carto Itaucard
Boleto Bancrio
ou
( 2 ) Ita Bankline:
- Pgto. vista
- Financiado
- Itaucard
- Boleto
Para oferecer mais detalhes sobre as opes de pagamento que compem a plataforma de cobrana Ita Shopline,
utilize-se das nomenclaturas e definies contidas no texto explicativo disponvel no Portal Ita Shopline
(www.itaushopline.com.br), a rota de acesso : Para o lojista j cadastrado / Instalao / itens para download / Texto
Explicativo sobre o Ita Shopline.
Abaixo, segue os Banners para Pagamento para incluso no site da sua Loja, visando comunicar seu cliente que o site
disponibiliza os meios de pagamento Ita. Estes banners devem ser obtidos atravs do Ita Bankline pela Rota:
Produtos e Servios / Ita Shopline / Instalao Manuais / Banners / Botes e Componentes.
Shopline 234 x 60.gif
Shopline 140 x 50.gif
Pg. 42
I.
Procedimentos para divulgao de site no Portal Ita Shopline
O Portal Ita Shopline um site que tem por objetivo divulgar o produto Ita Shopline, o meio de pagamento do Ita
na internet, e ser um guia de lojas para compradores na internet, listando as lojas virtuais que j oferecem o Ita
Shopline em seu site como meio de pagamento. A idia principal do Portal Ita Shopline oferecer um caminho a
mais para que os clientes Ita encontrem sites de comrcio eletrnico que oferecem o Ita Shopline como meio de
pagamento. Alm disso, o portal disponibiliza para compradores, informaes de como utilizar o Ita Shopline para
pagar suas compras na internet e, para vendedores, informaes sobre vantagens e funcionalidades do produto, bem
como procedimentos de contratao.
Neste portal, cada lojista que tiver o Ita Shopline em seu site ter um espao reservado para seu banner institucional e
a possibilidade de se cadastrar em at trs categorias da barra de busca. Em cada categoria, o lojista ser apresentado
conforme o nome cadastrado no sistema do produto e o consumidor encontrar um link para o site listado. Os banners
aparecero aleatoriamente conforme atualizaes feitas nas pginas do portal e funcionaro tambm como um link para
o site do lojista.
Todos os lojistas cadastrados tero a oportunidade de colocar suas lojas virtuais em evidncia! A princpio, a divulgao
de seu site no portal totalmente gratuita. Veja abaixo o que fazer e como proceder para participar.
Condies de cadastramento para divulgao no Portal Ita Shopline:
Ter assinado o Contrato de Cobrana Eletrnica Shopline (modelo 21831-3), principalmente o Anexo V.
Estar com a ltima verso do Ita Shopline devidamente instalada e identificada em seu site: componente itaucripto.
a correta identificao do Ita Shopline para a verso itaucripto est apresentada no item H deste anexo.
Cadastrar a Categoria relativa atividade de seu site no Mdulo Ita Shopline, Informaes Cadastrais 1 (at 3 opes).
Se tiver interesse em participar do Portal Ita Shopline, queira, por gentileza, realizar os procedimentos necessrios citados acima,
para que possamos incluir o link de seu site em nosso portal.
Em caso de dvida, entre em contato conosco atravs da CESE (Central de Suporte a Empresas) ou acesse o Portal Ita Shopline
para mais informaes sobre o produto e suas funcionalidades.
Equipe Ita Shopline

BANCO ITA Ass de Produtos PJ
Atendimento CESE: 0 XX (11) 3019 4828
WEB ITA: www.itau.com.br
Portal Ita Shopline: www.itaushopline.com.br
------------------------------------------------------------------------------------Ita Shopline, o jeito seguro de pagar pela internet!
-------------------------------------------------------------------------------------
Informaes Cadastrais: todos os dados do site esto disponveis no Mdulo Ita Shopline acessado pela conta corrente do site via Ita Bankline, menu Produtos e Servios.
Pg. 43

Manual Tecnico ItauShopline

Enviado por

Dados do documento

Título original

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

Instrues de

Verso Itaucripto 04 SP. 04/03/2004

Utilizao do Ita Shopline.............................................................................................................3

2. SERVIOS DO ITA SHOPLINE........................................................................................... 5

Mdulo Ita Shopline.....................................................................................................................5

3. LAYOUT DOS CAMPOS.................................................................................................... 12

Parmetros e Critrios de Consistncias....................................................................................12

Usando Itaucripto.dll - Para ambientes Microsoft (Windows NT 4.0 ou superior).......................16

6. AUXLIO INSTALAO DO ITA SHOPLINE..................................................................... 31

Mensagens de Erro de Sistema...................................................................................................31

Pagamento vista por transferncia carteira de cobrana 178;

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

Informaes Cadastrais do Site Lojista

2.2. Instrues de Instalao do produto.

2.2. Ambiente de Teste do produto:

2.3. Gerao do Ita Shopline URL Principal de Acesso ao produto

2.4. Reemisso de Boletos

2.5. Retorno Online do Tipo de Pagamento

2.6. Consulta de Operaes realizadas via Ita Shopline

Consulta de Operaes do Mdulo Ita Shopline

Arquivo Retorno de Cobrana

Consulta Automtica Situao do Pagamento (sonda)

- 00 para pagamento ainda no escolhido

ONLINE E REAL TIME

- 01 para Pagamento Vista (TEF e CDC)

ONLINE E REAL TIME

- 02 para Boleto Bancrio

ONLINE E REAL TIME

- 03 para Carto Itaucard

ONLINE E REAL TIME

funcionalidade de reemisso de ttulos, por exemplo.

3. LAYOUT DOS CAMPOS

Veja a seguir as caractersticas especficas de cada parmetro:

Valor Total do Pagamento

Sugesto para teste inicial de gerao do Ita Shopline:

Cdigo de inscrio do sacado

Nmero de inscrio do sacado

Numrico com exatamente 02 posies:

Alfanumrico com o mximo de 15 posies

Numrico com exatamente 08 posies (99999999)

Alfanumrico com o mximo de 15 posies

Data de vencimento do ttulo

Parte final da URL de Retorno Completa (2)

Alfanumrico com exatamente 02 posies

URL de Retorno Completa = URL de Retorno + urlRetorna

- Mensagem Adicional 1(parmetro 1)

Mensagem padro pr-cadastrada que ser exibida na emisso e na reeemisso do

- Mensagem Adicional 2(parmetro 2)

Mensagem padro pr-cadastrada que ser exibida na emisso e na reeemisso do

Parmetros para Retorno Online do Tipo de Pagamento

Parmetros para Consulta Situao de Pagamento

Situao de pagamento do pedido

Numrico com 02 posies:

Numrico com 08 posies no formato ddmmaaaa

Nmero de autorizao - preenchido

Alfanumrico com 06 posies

Alfanumrico com 40 posies

Alfanumrico com 09 posies

Alfanumrico com 1 posio: