Beruflich Dokumente
Kultur Dokumente
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;
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.
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.
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.3.
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.
Pg. 8
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:
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
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
- 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
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
( * ) 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.
(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:
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
DtPag CodAut
Data do pagamento
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
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.
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.
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, , , , , , , , , , , , ,)
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.
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
<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.
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.
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
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.
'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.
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
<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
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.
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
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
//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.
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
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>
Pg. 36
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
4828
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
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.
MENSAGEM
PROVIDNCIAS
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)
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
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
Pg. 41
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
Pg. 43
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
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
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
Lembramos que para programar a leitura do arquivo retorno e integr-lo ao sistema de conciliao bancria de sua empresa, necessrio obter o Manual de Intercmbio de Arquivos que especifica todos os campos que sero informados no Arquivo Retorno de Cobrana. Para conhecer o Layout da Cobrana Ita acesse o Ita Bankline da conta corrente do site e siga a rota: Produtos e Servios, Download Center, Cobrana Manual de Intercmbio de Arquivos.
Pg. 50
Pg. 51
- 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
234
60.gif
Pg. 52
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.
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
Pg. 54