Você está na página 1de 54

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. Utilizao do Ita Shopline...................................................................3 1.2. Configurao do Ita Shopline.............................................................4 1.3. Instalao do Ita Shopline..................................................................4
DO

2.SERVIOS

2.1. Mdulo Ita Shopline............................................................................6 1.1. Informaes Cadastrais do Site Lojista.................................................6 1.2. Instrues de Instalao do produto....................................................6 2.2. Ambiente de Teste do produto:............................................................8 2.3. Gerao do Ita Shopline URL Principal de Acesso ao produto........8 2.4. Reemisso de Boletos..........................................................................8 2.5. Retorno Online do Tipo de Pagamento.................................................9 2.6. Consulta de Operaes realizadas via Ita Shopline............................9 2.6.1. Consulta de Operaes do Mdulo Ita Shopline............................10 2.6.2. Arquivo Retorno de Cobrana.........................................................11 2.6.3. Consulta Automtica Situao do Pagamento (sonda).................12
DOS

ITA SHOPLINE...................................................6

3.LAYOUT

3.1. Parmetros e Critrios de Consistncias............................................15 4.1. Usando Itaucripto.dll - Para ambientes Microsoft (Windows NT 4.0 ou superior).....................................................................................................20 1.3. Passo 1: Criptografia.........................................................................20 1.4. Passo 2: Chamada tela do Ita Shopline.........................................20 4.2. Para ambientes Unix ou Linux............................................................21 4.2.1. Passo 1: Criptografia.......................................................................21 4.2.2. Passo 2: Chamada tela do Ita Shopline......................................22
DE

CAMPOS.........................................................15

4.INFORMAES TCNICAS.......................................................20

5.EXEMPLOS

5.1. Usando Itaucripto.dll - Para ambientes Microsoft (Windows NT 4.0 ou superior).....................................................................................................24 1.5. Envio dos Dados Pgina Inicial HTML...............................................24 1.6. Criptografia dos dados Cdigo ASP.................................................25 1.7. Retorno do Tipo de Pagamento Cdigo ASP...................................26 1.8. Consulta Situao do Pagamento Cdigo ASP..............................27 1.9. Reemisso do Boleto Cdigo ASP...................................................28 Para ambientes Unix ou Linux..................................................................28 5.2.1. Envio dos Dados Pgina Inicial HTML..........................................28 5.2.2. Criptografia dos dados Cdigo Java............................................30 5.2.3. Retorno do Tipo de Pagamento Cdigo Java...............................32 5.2.4. Consulta Situao do Pagamento Cdigo Java........................33 5.2.5. Reemisso do Boleto Cdigo Java................................................34 6.1. Mensagens de Erro de Sistema .........................................................37

CDIGO.........................................................24

ANEXOS DEMONSTRATIVOS.......................................................39

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.
Pg. 3

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.

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
Pg. 4

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. 5

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


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 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, (http://www.itau.com.br/) e digitar: necessrio entrar no site o Ita

- 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. 1.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.

Pg. 6

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. 7

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. 8

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.
Pg. 9

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. 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.

Pg. 10

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. 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. 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: 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. 11

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 escolhido pagamento ainda no
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) ONLINE E REAL TIME - 00 para pagamento efetuado

- 01 para Pagamento Vista (TEF e CDC)

- 01 - 02 para Boleto Bancrio

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)

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) - 04 para Boleto emitido com sucesso A PARTIR DE UM DIA TIL DA EMISSO DO BOLETO

- 00 para pagamento efetuado - 05 para pagamento efetuado, aguardando compensao - 06 para pagamento no compensado
Pg. 12

- 03 para Carto Itaucard

ONLINE E REAL TIME - 00 para pagamento efetuado

- 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)

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 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. 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: 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. 13

Pg. 14

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 Pedido Valor Descrio Critrios de Consistncia Cdigo da Empresa (Cdigo do Alfanumrico com exatas 26 posies. Site) (enviar o cdigo todo em maisculas) Nmero do Pedido Numrico com o mximo de 08 posies (99999999) (*) 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 de Criptografia Alfanumrico com exatas 16 posies (enviar a chave toda em maisculas)

Chave

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.
Pg. 15

( * ) 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.

Parmetros Opcionais
Parmetros Observacao Critrios de Consistncia Alfanumrico com o mximo de 40 posies 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. NomeSacado Nome do sacado Alfanumrico com o mximo de 30 posies Codigoinscric Cdigo de inscrio do sacado Numrico com exatamente 02 ao posies: - 01 para CPF - 02 para CNPJ NumeroInscri Nmero de inscrio do sacado Numrico com 14 posies cao (99999999999999) EnderecoSac Endereo do sacado Alfanumrico com o mximo de 40 ado posies BairroSacado Bairro do sacado Alfanumrico com o mximo de 15 posies CepSacado CEP do sacado Numrico com exatamente 08 posies (99999999) CidadeSacad Cidade do sacado Alfanumrico com o mximo de 15 o posies EstadoSacado Estado do sacado Alfanumrico com exatamente 02 posies Somente sero aceitos estados brasileiros. dataVencime Data de vencimento do ttulo Numrico com exatamente 08 posies nto Utilizar o formato ddmmaaaa UrlRetorna Parte final da URL de Retorno Alfanumrico com o mximo de 60 posies. Completa (2)
URL de Retorno Completa = URL de Retorno + urlRetorna

Descrio Espao disponvel para enviar uma linha de mensagem nica por pedido ou um parmetro indicando qual Mensagem (1) Adicional se quer apresentar.

Pg. 16

ObsAdicional 1

ObsAdicional 2

ObsAdicional 3

Espao disponvel para enviar uma linha de mensagem nica por pedido, que s ser exibida se o campo Observao contiver o texto 3. Espao disponvel para enviar uma linha de mensagem nica por pedido, que s ser exibida se o campo Observao contiver o texto 3. Espao disponvel para enviar uma linha de mensagem nica por pedido, que s ser exibida se o campo Observao contiver o texto 3.

Alfanumrico com o mximo de 60 posies.

Alfanumrico com o mximo de 60 posies.

Alfanumrico com o mximo de 60 posies.

(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 - 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. 17

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 Critrios de Consistncia Tipo de pagamento escolhido Numrico com 02 posies: pelo comprador - 00 para pagamento ainda no escolhido * - 01 para Pagamento vista (TEF e CDC) - 02 para Boleto - 03 para Carto Itaucard
* Este tipo de pagamento somente ser exibido na consulta.

Parmetros para Consulta Situao de Pagamento


Parmetros Formato Descrio Formato do consulta retorno Critrios da Numrico com 01 posio:
consulta visual

- 0 para formato de pgina HTML para - 1 para formato XML

TipPag

Tipo de pagamento escolhido Numrico com 02 posies: - 00 para pagamento ainda no escolhido * pelo comprador

- 01 para Pagamento vista (TEF e CDC) - 02 para Boleto - 03 para Carto Itaucard
* Este tipo de pagamento somente ser exibido na consulta.

SitPag

Situao pedido

de

pagamento

do Numrico com 02 posies:

- 00 para pagamento efetuado - 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 CodAut

Data do pagamento

Numrico com 08 posies no formato ddmmaaaa

Nmero de autorizao - Alfanumrico com 06 posies preenchido somente quando pagamento efetuado com
Pg. 18

carto Itaucard NumId CompVend 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 40 posies

Alfanumrico com 09 posies

TipCart

Alfanumrico com 1 posio: - M para cartes REDECARD (bandeira Mastercard ou Diners) - V para cartes VISANET (bandeira Visa)

Pg. 19

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. 1.3. 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

1.4.

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"


Pg. 20

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.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.
Pg. 21

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: 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.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
Pg. 22

RESIZABLE = YES STATUS = NO SCROLLBARS = YES WIDTH = 675 (sugesto) HEIGHT = 485 (sugesto)

EXEMPLO: out.println("<script language=\"JavaScript\">); out.println("<!--); out.println("function carregabrw() { ); out.println(" window.open('\', 'SHOPLINE',\"toolbar=yes,menubar=yes,resizable=yes,status=no,scrollbars=yes,width= 675,height=485\"); ); out.println("}); 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. 23

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. 1.5. 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>
Pg. 24

<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> <TD width=25% align=right><B>ObsAdicional2:</B></TD> <TD><INPUT type="text" maxlength=60 size=60 name="ObsAdicional2" value=""></TD> </TR> <TR> <TD width=25% align=right><B>ObsAdicional3:</B></TD> <TD><INPUT type="text" maxlength=60 size=60 name="ObsAdicional3" value=""></TD> </TR> </TABLE> </CENTER> <BR><BR> <INPUT TYPE="submit" value="Pagar" name="Pagar"> </FORM> </BODY> </HTML>

1.6.

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" maiscula pedido = Request.Form("pedido") valor = Request.Form("valor") observacao = Request.Form("observacao") nomeSacado = Request.Form("nomeSacado") codigoInscricao = Request.Form("codigoInscricao") "codigoInscricao" numeroInscricao = Request.Form("numeroInscricao") "numeroInscricao" enderecoSacado = Request.Form("enderecoSacado") "enderecoSacado" bairroSacado = Request.Form("bairroSacado") cepSacado = Request.Form("cepSacado") "cepSacado" cidadeSacado = Request.Form("cidadeSacado") "cidadeSacado" estadoSacado = Request.Form("estadoSacado") "estadoSacado" dataVencimento = Request.Form("dataVencimento") "dataVencimento" 'Coloque aqui o cdigo da empresa 'Coloque aqui a chave de criptografia em 'obtm 'obtm 'obtm 'obtm o valor do campo "pedido" o valor do campo "valor" o valor do campo "observacao" o valor do campo "nomeSacado" 'obtm o valor do campo 'obtm o valor do campo 'obtm o valor do campo 'obtm o valor do campo "bairroSacado" 'obtm o valor do campo 'obtm o valor do campo 'obtm o valor do campo 'obtm o valor do campo

Pg. 25

urlRetorna = Request.Form("urlRetorna") "urlRetorna" obsAdicional1 = Request.Form("obsAdicional1") "obsAdicional1" obsAdicional2 = Request.Form("obsAdicional2") "obsAdicional2" obsAdicional3 = Request.Form("obsAdicional3") "obsAdicional3"

'obtm o valor do campo 'obtm o valor do campo 'obtm o valor do campo 'obtm o valor do campo

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.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> <script language="JavaScript"> <!-function carregabrw() { window.open('', 'SHOPLINE', 'toolbar=yes,menubar=yes,resizable=yes,status=no,scrollbars=yes,width=675,height=485'); } //--> </script> </BODY> </HTML>

1.7.

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 Alfanumrico de 26 posies Numero do Pedido Numrico com 8 posies Tipo de pagamento escolhido pelo Numrico com 2 posies: 01 para Pagamento Vista (TEF ou comprador

CDC) 02 para Boleto 03 para Carto Itaucard

Pg. 26

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>

1.8.

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
Pg. 27

<?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>

1.9.

Reemisso do Boleto Cdigo ASP.

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. Para ambientes Unix ou Linux Neste item usamos Java (Servlet) como linguagem web. 5.2.1.
<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>
Pg. 28

Envio dos Dados Pgina Inicial HTML

<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 width=25% align=right><B>ObsAdicional1:</B></TD> <TD><INPUT type="text" maxlength=60 size=60 name="obsAdicional1" value=""></TD> </TR> <TR> <TD width=25% align=right><B>ObsAdicional2:</B></TD> <TD><INPUT type="text" maxlength=60 size=60 name="obsAdicional2" value=""></TD> </TR> <TR> <TD width=25% align=right><B>ObsAdicional3:</B></TD> <TD><INPUT type="text" maxlength=60 size=60 name="obsAdicional3" value=""></TD> </TR> </TABLE> </CENTER> <BR><BR> <INPUT TYPE="submit" value="Pagar" name="Pagar"> </FORM> </BODY> </HTML>

Pg. 29

5.2.2.
import import import import import

Criptografia dos dados Cdigo Java


java.io.*; java.text.*; java.util.*; javax.servlet.*; 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 private private private private private private private private private private private private private private private String String String String String String String String String String String String String String String String pedido; // Identificao do pedido valor; // Valor do pedido observacao; // Observaes nomeSacado; // Nome do sacado codigoInscricao; // Cdigo de Inscrio: 01->CPF, 02->CNPJ numeroInscricao; // Nmero de Inscrio: CPF ou CNPJ enderecoSacado; // Endereco do Sacado bairroSacado; // Bairro do Sacado cepSacado; // Cep do Sacado cidadeSacado; // Cidade do sacado estadoSacado; // Estado do Sacado dataVencimento; // Vencimento do ttulo urlRetorna; // URL do retorno obsAdicional1; // ObsAdicional1 obsAdicional2; // ObsAdicional2 obsAdicional3; // ObsAdicional3

public void destroy() { } public void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException { service(request, response); } public void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException { service(request, response); } public void init() { } public void service(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException { 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)

Pg. 30

// 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"); out.println("<html>"); out.println("<body bgcolor=\"white\">"); out.println("<head>"); out.println("<title> Teste Ita Shopline </title>"); out.println("</head>"); out.println("<body>");
Pg. 31

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("function carregabrw() { ); out.println(" window.open('\', 'SHOPLINE',\"toolbar=yes,menubar=yes,resizable=yes,status=no,scrollbars=yes,width=675,heigh t=485\"); ); out.println("}); 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 Alfanumrico de 26 posies Numero do Pedido Numrico com 8 posies Tipo de pagamento escolhido pelo Numrico com 2 posies: 01 para Pagamento Vista (TEF ou comprador

CDC) 02 para Boleto 03 para Carto Itaucard

EXEMPLO: public void service(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException { //Inicializa as variveis String dados, chave; String codEmp; String pedido; String tipPag; chave posies) = "ABCD123456ABCD12"; // <- Coloque aqui sua chave de criptografia (16

Pg. 32

//Recebe valores da pgina anterior dados = request.getParameter("DC"); //Inicializa a classe de criptografia do Shopline Itaucripto cripto = new Itaucripto(); //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.

EXEMPLO: public void service(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException { //Inicializa as variveis String codEmp, pedido, formato, chave; String dados; chave posies) = "ABCD123456ABCD12"; // <- Coloque aqui sua chave de criptografia (16

Consulta Situao do Pagamento Cdigo Java

//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"); //Inicializa a classe de criptografia do Shopline Itaucripto cripto = new Itaucripto(); //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. 33

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

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.

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>
Pg. 34

<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> </TR> <TR> <TD WIDTH=25% ALIGN=center><B>Observao Adicional1:<B/></TD> <TD><?php echo $row["obsAd1"]; ?></TD> </TR> <TR> <TD WIDTH=25% ALIGN=center><B>Observao Adicional2:<B/></TD> <TD><?php echo $row["obsAd2"]; ?></TD> </TR> <TR> <TD WIDTH=25% ALIGN=center><B>Observao Adicional3:<B/></TD> <TD><?php echo $row["obsAd3"]; ?></TD> </TR>
Pg. 35

</TABLE> <?php $codEmp ="J0046245690001890000001418"; $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,$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> <INPUT type="submit" name="Shopline" value="Ita Shopline"> </FORM> <script language="JavaScript"> function carregabrw() { window.open('','SHOPLINE',"toolbar=yes,menubar=yes,resizable=yes,status=no,scrollbars=yes,width=67 5,height=485"); } </script> <BODY> </HTML>

6.0 Auxlio Instalao do Ita Shopline

Pg. 36

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.

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 Informando seu CNPJ e Nome de Site e solicite a validao de seu contrato. Erro na decriptografia, tente novamente. Idem ao erro numrico.. Numero do pedido no

Cdigo de inscrio invlido.

Cdigo do sacado invlido. Data de vencimento invlida.

Erro 9 contate o Atendimento Cese

4828

Erro na decriptografia dos dados Formato invlido. Nmero de inscrio invlido.

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) 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) 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) 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
Pg. 37

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.

MENSAGEM

PROVIDNCIAS
2 casas decimais, separadas obrigatoriamente por vrgula (99999999,99)

Valor decimal no numrico.

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)

Pg. 38

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. 39

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. 40

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. 41

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. 42

Clique aqui para voltar ao item 2.2. deste manual tcnico.

Pg. 43

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
Pg. 44

conta. Isso significa, por exemplo, que se um comprador no tem Crdito Praprovado 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. 45

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. Clique aqui para voltar ao item 2.3. deste manual tcnico.

Pg. 46

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. Clique aqui para voltar ao item 2.4. deste manual tcnico.

Pg. 47

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. 48

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.

Clique aqui para voltar ao item 2.6.2. deste manual tcnico.


Pg. 49

Pg. 50

G. Tela de Exemplo da Consulta Automtica Situao do Pagamento (sonda):


Retorno da Consulta em em XML:

Retorno da Consulta em HTML :

Clique aqui para voltar ao item 2.6.3. deste manual tcnico.

Pg. 51

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) Bankline: vista Ita Bankline: Pagamento Vista por Transferncia ou ( 2 ) Ita

- Pgto. - Itaucard - Boleto

- Financiamento por Credirio Automtico Ita Financiado - Carto Itaucard - Boleto Bancrio

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 comunicar seu cliente que o site disponibiliza banners devem ser obtidos atravs do Ita Servios / Ita Shopline / Instalao Componentes. incluso no site da sua Loja, visando os meios de pagamento Ita. Estes Bankline pela Rota: Produtos e Manuais / Banners / Botes e

Shopline Shopline 140 x 50.gif

234

60.gif

Clique aqui para voltar ao item 1.1. deste manual tcnico.

Pg. 52

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 principalmente o Anexo V. de Cobrana Eletrnica Shopline (modelo 21831-3),

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 Cadastrais1 (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

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. 53

------------------------------------------------------------------------------------Ita Shopline, o jeito seguro de pagar pela internet! -------------------------------------------------------------------------------------

Pg. 54