Instrues de Implantao e Utilizao

Manual Tcnico do Desenvolvedor do Site

Verso para Windows NT 4.0 ou Superior, Unix ou Linux

Verso 05 SP. 20/10/2010

NDICE 1. INFORMAES GERAIS ....................................................................................................3

1.1. 1.2. 1.3. Utilizao do Ita Shopline ......................................................................................................... 3 Configurao do Ita Shopline .................................................................................................... 4 Implantao 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. 3.1. Mdulo Ita Shopline .................................................................................................................. 5 Informaes Cadastrais do Site Lojista....................................................................................... 5 Instrues de Implantao 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 Parmetros e Critrios de Consistncias .................................................................................. 13 Usando Itaucripto.dll - Para ambientes Microsoft (Windows NT 4.0 ou superior) ..................... 15 Passo 1: Criptografia ................................................................................................................ 15 Passo 2: Chamada tela do Ita Shopline ............................................................................... 15 Para ambientes Unix ou Linux .................................................................................................. 16 Passo 1: Criptografia ................................................................................................................ 16 Passo 2: Chamada tela do Ita Shopline ............................................................................... 16

3. LAYOUT DOS CAMPOS ...................................................................................................12 4. INFORMAES TCNICAS ...............................................................................................15

4.1. 4.1.1. 4.1.2. 4.2. 4.2.1. 4.2.2.

5. EXEMPLOS DE CDIGO ..................................................................................................18

5.1. Usando Itaucripto.dll - Para ambientes Microsoft (Windows NT 4.0 ou superior) ..................... 18 5.1.1. Envio dos Dados Pgina Inicial HTML ................................................................................... 18 5.1.2. Criptografia dos dados Cdigo ASP ...................................................................................... 19 5.1.3. Retorno do Tipo de Pagamento Cdigo ASP ........................................................................ 20 5.1.4. Consulta Situao do Pagamento Cdigo ASP .................................................................. 21 5.1.5. Reemisso do Boleto Cdigo ASP. ....................................................................................... 22 Para ambientes Unix ou Linux ................................................................................................................ 22 5.2.1. Envio dos Dados Pgina Inicial HTML .................................................................................. 22 5.2.2. Criptografia dos dados Cdigo Java ...................................................................................... 23 5.2.3. Retorno do Tipo de Pagamento Cdigo Java ........................................................................ 25 5.2.4. Consulta Situao do Pagamento Cdigo Java .................................................................. 26 5.2.5. Reemisso do Boleto Cdigo Java ........................................................................................ 27 6.1. Mensagens de Erro de Sistema ................................................................................................ 29

ANEXOS DEMONSTRATIVOS ...................................................................................................31

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) cdigo de filiao do lojista junto Redecard;

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 est 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 30 horas (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 Ita 30 horas, assim que aprovada encaminhada uma confirmao por e-mail indicando o acesso s Instrues de Cadastro e Instrues de implantao do produto em seu site. Todas as Informaes Cadastrais do site e as Instrues de implantao para uso do produto so disponibilizadas ao responsvel pela conta corrente do site no Mdulo Ita Shopline acessado via Ita 30 horas Empresa > Cobrana > Ita Shopline ou pelo Ita 30 horas Empresa Plus > Recebimentos, 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) 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; - 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;

1.3. Implantao 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 mais 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.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 30 horas (internet banking do Ita) da conta corrente do site do lojista. Dentro do Ita 30 horas, a rota de acesso a esta funo : Ita 30 horas Empresas > Cobrana > Ita Shopline > Informaes Cadastrais Ita 30 horas Empresas Plus > Recebimentos > Ita Shopline > Informaes Cadastrais

Nesta funo encontram-se os Cdigos de Habilitao do site para uso do produto que so: Cdigo do Site e Chave de Criptografia. - A Chave de Criptografia um cdigo alfanumrico criado pelo site com exatamente 16 posies para dar segurana transmisso dos dados que iro trafegar entre o servidor do site e o servidor do banco no momento da gerao do Ita Shopline. - O Cdigo do Site um cdigo criado pelo banco que identifica a conta corrente onde sero creditados os pagamentos efetuados em ambiente seguro Ita Shopline. Os Cdigos de Habilitao devero ser informados ao responsvel pela instalao do Ita Shopline no site. Ateno: Qualquer informao alterada neste ambiente estar disponvel para utilizao on line aps a alterao. Para acessar o Ita 30 horas, 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 30 horas Empresa; - ou dados de Usurio Operador e Senha Eletrnica na barra de acesso ao Ita 30 horas Empresa Plus. Clique aqui para visualizar as principais telas do Mdulo Ita Shopline. 2.1.2. Instrues de Implantao do produto. Todas as Instrues de Implantao do produto esto contidas neste manual tcnico. Futuras atualizaes de verso estaro sempre disponveis para download no Mdulo Ita Shopline. Dentro do Ita 30 horas, a rota de acesso a esta funo : Cobrana ou Recebimentos > Ita Shopline > Instalao. A implantao do Ita Shopline est detalhada nos itens 2, 3 e 4 deste manual e para tal ser necessrio obter os Cdigos de Habilitao do site, o Componente de Criptografia e os Banners de identificao do produto e providenciar a programao dos parmetros necessrios gerao do Ita Shopline. 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 Central de Relacionamento Ita Empresas no tel: 0300 100 7575

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 30 horas. Forma de acesso: Ita 30 horas da conta corrente do site. A rota para esta consulta no Mdulo Ita Shopline : Ita 30 horas Empresas, Cobrana, Ita Shopline, Consulta de Operaes. Ita 30 horas Empresas Plus, Recebimentos, Ita Shopline, Consulta de Operaes. Formato da consulta: a partir da navegao no Ita 30 horas 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 30 horas da conta corrente do site. - Para usurios do Ita 30 horas Empresa, a rota para baixar o Arquivo Retorno : Cobrana, Transferncia de Arquivos, Retorno. - Para usurios do Ita 30 horas Empresa Plus, a rota : Transferncia de Arquivos, Arquivo Retorno. Formato da consulta: arquivo de texto (nome do arquivo .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 30 horas e siga a rota: Cobrana, 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 30 horas 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. 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
- 00 para pagamento ainda no escolhido

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

- 01 para Pagamento Vista (TEF e CDC)

- 02 para Boleto Bancrio

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

3. LAYOUT DOS CAMPOS

Parmetros Obrigatrios
Parmetros CodEmp Pedido Valor Descrio Critrios de Consistncia Cdigo da Empresa (Cdigo do Site) Alfanumrico com exatas 26 posies. (enviar o cdigo todo em maisculas) Nmero do Pedido Valor Total do Pagamento 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) Alfanumrico com o mximo de 30 posies Numrico com exatamente 02 posies: - 01 para CPF - 02 para CNPJ NumeroInscricao EnderecoSacado BairroSacado CepSacado CidadeSacado EstadoSacado Nmero de inscrio do sacado Endereo do sacado Bairro do sacado CEP do sacado Cidade do sacado Estado do sacado Numrico com 14 posies -99999999999999 Alfanumrico com o mximo de 40 posies Alfanumrico com o mximo de 15 posies Numrico com exatamente 08 posies (99999999) Alfanumrico com o mximo de 15 posies Alfanumrico com exatamente 02 posies Somente sero aceitos estados brasileiros.

Chave NomeSacado Codigoinscricao

Chave de Criptografia Nome do sacado Cdigo de inscrio do sacado

Parmetros Opcionais
Parmetros dataVencimento UrlRetorna ObsAdicional1 Descrio Data de vencimento do ttulo Critrios de Consistncia Numrico com exatamente 08 posies Utilizar o formato ddmmaaaa Parte final da URL de Retorno Alfanumrico com o mximo de 60 posies. Completa (2) URL de Retorno Completa = URL de Retorno + urlRetorna Espao disponvel para enviar uma Alfanumrico com o mximo de 60 posies. linha de mensagem nica por pedido, que s ser exibida se o campo Observao contiver o texto 3. Espao disponvel para enviar uma Alfanumrico com o mximo de 60 posies. linha de mensagem nica por pedido, que s ser exibida se o campo Observao contiver o texto 3.
Pg. 12

ObsAdicional2

ObsAdicional3

Observacao

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 ou um parmetro indicando qual Mensagem Adicional (1) se quer apresentar.

Alfanumrico com o mximo de 60 posies.

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.

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:

(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.
Pg. 13

Para mais detalhes sobre o acesso funo Informaes Cadastrais do Mdulo Ita Shopline, vide item 2.1. deste manual.

Os dados que sero utilizados para interpretar o Retorno 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 Critrios de Consistncia pelo Numrico com 02 posies: - 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 TipPag Descrio Formato do retorno da consulta Tipo de pagamento comprador escolhido Critrios
Numrico com 01 posio: - 0 para formato de pgina HTML para consulta visual - 1 para formato XML Numrico com 02 posies: pelo - 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.

SitPag

Situao de pagamento do pedido

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 Numrico com 08 posies no formato ddmmaaaa Alfanumrico com 06 posies

DtPag CodAut NumId CompVend

Data do pagamento 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 40 posies

Alfanumrico com 09 posies

TipCart

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

Pg. 14

4. INFORMAES TCNICAS
Para que seja feita a implantao do Ita Shopline, necessrio que exista um Servidor Web. Depois de instalado, devem ser executados os passos descritos a seguir.

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.1. Passo 1: Criptografia
A rota de acesso a este componente no: Ita 30 horas Empresas >> Cobrana >> Ita Shopline >> Instalao Ita 30 horas Empresas Plus >> Recebimentos >> Ita Shopline >> Instalao Aps este procedimento, deve-se registrar o componente no equipamento que for executar a aplicao e chamar o mtodo geraDados. Os procedimentos para registrar o componente de criptografia so: 1 - Menu "Iniciar" ("Start") do WindowsNT 2 - Menu "Executar" ("Run") 3 - Digitar na caixa "Abrir" ("Open") o comando: regsvr32 c:\....\Itaucripto.dll

4.1.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 name="DC" type=hidden value="Dados Criptografados"

Campo (INPUT) para os dados criptografados, com as propriedades:

Obs.: o nome do Input tem que ser DC pois os dados so recebidos a partir de um request com este nome.

Pg. 15

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 30 horas Empresas >> Cobrana >> Ita Shopline >> Instalao Ita 30 horas Empresas Plus >> Recebimentos >> 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. 16

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

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

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

5.1.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") obsAdicional2 = Request.Form("obsAdicional2") obsAdicional3 = Request.Form("obsAdicional3") '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" 'obtm o valor do campo "obsAdicional2" 'obtm o valor do campo "obsAdicional3"

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>

Pg. 19

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

5.1.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 Numrico com 8 posies Numrico com 2 posies:
-

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

01 para Pagamento Vista (TEF ou CDC) 02 para Boleto 03 para Carto Itaucard

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

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

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

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

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 private String obsAdicional2; // ObsAdicional2 private String obsAdicional3; // ObsAdicional3 public void destroy() { } public void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException { service(request, response);
Pg. 23

} 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) // 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. 24

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("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>); 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 Numrico com 8 posies Numrico com 2 posies:
-

EXEMPLO: public void service(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException { //Inicializa as variveis String dados, chave; String codEmp; String pedido; String tipPag; chave

01 para Pagamento Vista (TEF ou CDC) 02 para Boleto 03 para Carto Itaucard

= "ABCD123456ABCD12"; // <- Coloque aqui sua chave de criptografia (16 posies)

//Recebe valores da pgina anterior

Pg. 25

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.

Consulta Situao do Pagamento Cdigo Java

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

//Inicializa valores codEmp = " J1234567890123456789012345"; // <- Coloque aqui seu cdigo de empresa (26 posies) formato = 0 // <- Coloque aqui o tipo de retorno - 0 ou 1 dependendo do retorno //Recebe o pedido pedido = request.getParameter("pedido"); //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. 26

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

<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> </TABLE> <?php $codEmp ="J0046245690001890000001418"; $pedido ="98988812"; $valor ="0,01"; $observacao =""; $chave="A3G8E4C19N6W7BPS"; $nomeSacado =""; $codigoInscricao ="";
Pg. 28

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

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.

Pg. 29

Erro 9 contate o Atendimento Cese

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. Erro na decriptografia tente novamente. Idem ao erro Numero do pedido no numrico.. Verificar o campo de entrada NumeroInscricao 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 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)

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

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

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 Cobrana

Tela de Criao da Chave

Pg. 31

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

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 30 horas. 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 30 horas, portanto, para acess-las o comprador do site dever possuir seus dados de agncia, conta corrente, senha eletrnica e senha de carto junto ao banco 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 30 horas dever digitar seus dados de acesso ao Ita 30 horas 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 30 horas imediatamente visualizar, na tela de seu computador, o Boleto Bancrio do Ita Shopline, gerado pelo banco sob o registro na carteira de cobrana 176. Este Boleto j estar totalmente preenchido e apresentar alm do Valor da Compra e do N do Pedido j citados, todos os campos adicionais enviados pelo site (conforme instrues do item 4.1 deste manual). Clique aqui para voltar ao item 2.3. deste manual tcnico.

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 30 horas 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. 38

E. Telas de Exemplo da Consulta de Operaes do Mdulo Ita Shopline:

Para conhecer o Mdulo Ita Shopline, acesse o Ita 30 horas da conta corrente do site e siga a rota: Cobrana, Ita Shopline, Consulta de Operaes:

Pg. 39

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

Pg. 40

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

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

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 30 horas. 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 30 horas: Pagamento Vista por Transferncia Financiamento por Credirio Automtico Ita Carto Itaucard Boleto Bancrio ou ( 2 ) Ita 30 horas: - 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 30 horas pela Rota: Cobrana / Ita Shopline / Instalao Manuais / Banners / Botes e Componentes.

Shopline 234 x 60.gif

Shopline 140 x 50.gif

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

Pg. 43