Comrcio Eletrnico

Manual de Orientaes Tcnicas

verso novembro/2011

Solues em Comrcio Eletrnico Orientaes Tcnicas

ndice
1 1.1 1.2 2 2.1 2.2 2.3 3 3.1 3.2 3.3 4 4.1 4.2 4.3 4.4 4.5 5 6 6.1 Apresentao.......................................................................................................................................... 4 Vantagens oferecidas......................................................................................................................... 4 Requisitos necessrios ..................................................................................................................... 4 Modalidades de Pagamento.................................................................................................................. 5 Dbito em Conta via Internet............................................................................................................. 5 BB Credirio Internet.......................................................................................................................... 5 Boleto bancrio - Cobrana sem registro ........................................................................................ 5 Caractersticas........................................................................................................................................ 6 Como funciona.................................................................................................................................... 6 Intercmbio de informaes on line ................................................................................................. 6 Intercmbio de informaes em meio magntico........................................................................... 6 Roteiro para implantao ...................................................................................................................... 7 Formalizao de convnios............................................................................................................... 7 Desenvolvimento do cdigo.............................................................................................................. 7 Simulaes e homologao da implementao.............................................................................. 7 Ativao do convnio......................................................................................................................... 8 Banner e Logotipo .............................................................................................................................. 8 Fluxo dos Pagamentos .......................................................................................................................... 9 Formulrios........................................................................................................................................... 10 Variveis utilizadas nos formulrios .............................................................................................. 10

6.1.1 Formulrio Pagamento .................................................................................................................... 12 a. b. Gerao da 2 via do Boleto de cobrana...................................................................................... 12 Estrutura do formulrio Pagamento ............................................................................................... 12

6.1.2 Formulrio Retorno .......................................................................................................................... 12 a. Estrutura do formulrio Retorno..................................................................................................... 13

6.1.3 Formulrio Informa........................................................................................................................... 13 b. Para o Programa de Relacionamento de Pontos .......................................................................... 14

6.1.4 Formulrio Sonda ............................................................................................................................. 14 a. Estrutura do Formulrio Sonda ...................................................................................................... 14

Verso 20

www.bb.com.br

Solues em Comrcio Eletrnico Orientaes Tcnicas

b. c. d. e. Resposta do Formulrio Sonda ...................................................................................................... 14 Estrutura XML ................................................................................................................................... 15 Estrutura lojavirtual.dtd ............................................................................................................... 15 Resposta em forma de String.......................................................................................................... 15

6.1.5 Cancelamento de Venda BB Credirio Internet.......................................................................... 16 7 8 9 10 11 12 13 Leiaute do Arquivo Retorno Formato RCB001 Out/10 .................................................................. 17 Cdigos de erro e possveis solues............................................................................................... 18 Arquivo Retorno ................................................................................................................................... 19 Autorizao de usurio .................................................................................................................... 19 Como o usurio autorizado recebe o Arquivo Retorno................................................................ 22 Suporte Tcnico................................................................................................................................ 25 Histrico das atualizaes deste documento ............................................................................... 26

Verso 20

www.bb.com.br

Solues em Comrcio Eletrnico Orientaes Tcnicas

1 Apresentao

Este manual presta as informaes necessrias para a correta integrao da loja virtual com o ambiente de pagamento do Banco do Brasil. Disponibiliza alguns esclarecimentos bsicos do Comrcio Eletrnico do BB e como operacionalizado. Contempla variveis para permitir o tratamento de pontos do Programa de Relacionamento com empresas parceiras. As Solues de pagamento do Comrcio Eletrnico do BB realizam a intermediao financeira entre empresas e consumidores (B2C) e entre empresas e empresas (B2B), com diversas opes de pagamento e possibilidade de escolha das mais adequadas s suas necessidades. Trata-se de um servio seguro e completo. Para as modalidades de Dbito em Conta via Internet e BB Credirio Internet possvel acompanhar as transaes em tempo real por meio do back-office da empresa utilizando o Gerenciador Financeiro ou seu sistema prprio de gesto. 1.1 Vantagens oferecidas Simplicidade na implementao Todo clearing financeiro a cargo do Banco Confiabilidade e segurana do Banco do Brasil Menores tarifas e taxas do mercado 1.2 Requisitos necessrios Ser cliente do BB Ter cadastro atualizado Aderir ao regulamento do Comrcio Eletrnico do BB e formalizar os convnios para as modalidades de meio de pagamento escolhidas Seguir as orientaes deste manual para a implementao tcnica da soluo

Verso 20

www.bb.com.br

Solues em Comrcio Eletrnico Orientaes Tcnicas

2 Modalidades de Pagamento

2.1 Dbito em Conta via Internet Modalidade de pagamento vista, mediante dbito na conta corrente do comprador (Pessoa Fsica B2C ou Jurdica B2B) e crdito na conta corrente da empresa. O crdito correspondente compra/servio ser efetuado na conta da empresa em D+N, conforme float negociado na agncia de relacionamento. A confirmao do pagamento pode ser feita de duas maneiras: Arquivo Retorno (RCB001): demonstrao de todos os pagamentos realizados no dia anterior, incluindo os pagamentos via BB Credirio Internet, caso essa opo seja utilizada pelos compradores; Formulrio Sonda: informao on line da situao do pagamento.

2.2 BB Credirio Internet Modalidade de pagamento prazo, mediante concesso de financiamento ao comprador (Pessoa Fsica) e crdito vista na conta corrente da empresa. O crdito correspondente compra/servio efetuado na conta da empresa em D+N, conforme float negociado junto agncia de relacionamento, agrupado com os pagamentos efetuados via Dbito em Conta Internet. disponibilizado empresa arquivo retorno (RCB001) com a demonstrao de todos os pagamentos, incluindo os pagamentos via Dbito em Conta via Internet. Para cancelar uma compra efetivada nessa modalidade, a empresa deve preencher formulrio especfico (item 6.1.5) e encaminh-lo para a agncia detentora do convnio de comrcio eletrnico. Para contratar a modalidade de pagamento BB Credirio Internet, necessrio que a empresa contrate tambm a modalidade de Dbito em Conta via Internet.

2.3 Boleto bancrio - Cobrana sem registro Forma de pagamento mediante a gerao de boleto de cobrana bancria, impresso pelo prprio comprador. O crdito correspondente compra/servio ser efetuado na conta da empresa em D+N, conforme float negociado na agncia de relacionamento e mediante a liquidao do ttulo. A empresa receber arquivo CBR643 ou CNAB240 com a demonstrao de todos os pagamentos.

Verso 20

www.bb.com.br

Solues em Comrcio Eletrnico Orientaes Tcnicas

3 Caractersticas

3.1 Como funciona A partir do site da loja, o comprador (Pessoa Fsica ou Pessoa Jurdica) faz sua opo de pagamento. Nesse momento so apresentadas as modalidades de pagamento permitidas para o convnio contratado com o Banco. Na chamada ao site do Banco ocorre a passagem de parmetros que identificam a origem e quais formas de pagamento devem ser oferecidas para a transao que est sendo realizada. A validao do convnio realizada no ambiente do Banco. Todo o processo de autenticao dos clientes envolvidos na transao e a verificao de disponibilidade financeira (para formas de pagamento que exijam essa validao), bem como o processamento financeiro da operao, so realizados em ambiente seguro, garantindo a integridade dos dados em todo o fluxo da transao. A atualizao na base de dados se d em tempo real, permitindo a consulta on line ao status de pagamento (consulta disponvel somente para pagamentos via Dbito em Conta via Internet ou BB Credirio Internet). O Banco oferece todas as informaes relativas s transaes financeiras realizadas no Comrcio Eletrnico BB, por meio do Gerenciador Financeiro ou de sistema prprio de gesto do cliente.

3.2 Intercmbio de informaes on line A atualizao da base de dados, relativas aos pagamentos efetuados, processada em tempo real, permitindo consulta on line (Formulrio Sonda) a situao do pagamento para as modalidades de Dbito em conta via Internet e BB Credirio Internet. A modalidade de pagamento por Boleto de cobrana, est disponvel somente em arquivo no dia seguinte ao pagamento. Mais informaes sobre o Formulrio Sonda, disponveis a partir da pgina 14. 3.3 Intercmbio de informaes em meio magntico Alm das informaes on line, diariamente o Banco disponibiliza, por vrios meios, inclusive o Gerenciador Financeiro, as informaes de todos os pagamentos realizados no dia anterior mediante a gerao de arquivos retorno. Na formalizao do convnio, a empresa deve optar por algum dos meios de troca dos arquivos oferecidos pelo Banco: Dbito em Conta via Internet e BB Credirio Internet: arquivo RCB001; Boleto de Cobrana: arquivos CBR643 ou CNAB240.

Verso 20

www.bb.com.br

Solues em Comrcio Eletrnico Orientaes Tcnicas

4 Roteiro para implantao

4.1 Formalizao de convnios Na agncia de relacionamento da empresa, deve ser formalizado: convnio de arrecadao, para permitir o pagamento por Dbito em Conta via Internet; convnio de arrecadao e BB Credirio Internet para permitir o pagamento via BB Credirio Internet; convnio de cobrana para permitir o pagamento por boleto bancrio; convnio de comrcio eletrnico para permitir a troca eletrnica de parmetros/informaes dos formulrios. Devem ser informados ao Banco os seguintes atributos: Site (URL) do convenente para Retorno e Informao (verificar informaes detalhadas das variveis urlRetorno e urlInforma a partir da pgina 11); E-mail de contato do responsvel pelo desenvolvimento/manuteno da soluo; Valor limite de compras: valor mximo permitido para cada transao. Importante: Solicite ao gerente de relacionamento o documento Orientaes Iniciais para o Convenente, o qual traz orientaes complementares sobre os convnios e sua utilizao na soluo, bem como os nmeros dos convnios de Comrcio Eletrnico e de Cobrana. Inicialmente o convnio de comrcio eletrnico ficar com status 9 - No Ativo. Essa situao permite que a empresa realize o desenvolvimento e a homologao da soluo em seu site. 4.2 Desenvolvimento do cdigo A empresa deve desenvolver, no ambiente do site, cdigo da estrutura do Formulrio Pagamento para captura das variveis relativas aos pagamentos. Para possibilitar a consulta on line situao do pagamento, dever implementar tambm, no ambiente de administrao do site, cdigo da estrutura dos formulrios abaixo: Retorno (URL Retorno); Informa: (URL Informa); Sonda. A empresa responsvel pela implementao deve cumprir os seguintes requisitos tcnicos: O link para o banco deve ser acionado somente aps o comprador ter executado todos os passos necessrios a sua compra (checkout), faltando apenas efetuar o pagamento; A pgina que receber a postagem do formulrio no pode ser aberta em frame. Exemplo: a pgina no pode conter a tag html <frameset>. Verifique o detalhamento da implementao nos anexos deste manual. 4.3 Simulaes e homologao da implementao A equipe tcnica da empresa deve realizar simulaes de pagamentos de forma a garantir o perfeito funcionamento da soluo. A homologao realizada em ambiente de produo, ou seja, em funcionamento. Enquanto a situao do convnio estiver na situao 9 No Ativo, os pagamentos realizados por Dbito em Conta via Internet no sensibilizaro as contas envolvidas. O sistema do Banco permite o processamento de parte do fluxo, indicando que essa operao uma simulao, sem qualquer efeito contbil. Ao apresentar as opes dos meios de pagamento, exibida a palavra Teste ao lado do nome da loja conveniada. Para o meio de pagamento por Boleto, o convnio de Comrcio Eletrnico tambm permanecer com o status "No Ativo" at a finalizao dos testes, no entanto, mesmo em teste, o pagamento efetivado e gerado arquivo retorno para conciliao no dia seguinte.

Verso 20

www.bb.com.br

Solues em Comrcio Eletrnico Orientaes Tcnicas

4.4 Ativao do convnio Aps a concluso da fase de homologao, a empresa deve comunicar agncia de relacionamento que est apta a disponibilizar as Solues em Comrcio Eletrnico em seu site. Com essa informao, ser providenciada a ativao do convnio. Deve-se observar que somente aps a agncia confirmar que o convnio est ativo que a empresa poder disponibilizar as Solues em Comrcio Eletrnico em seu site. Aps a ativao do convnio, a palavra Teste deixar de ser exibida. 4.5 Banner e Logotipo No endereo www.bb.com.br/leiautes, esto disponveis as peas de identificao visual do BB para serem divulgadas na loja virtual.

Verso 20

www.bb.com.br

Solues em Comrcio Eletrnico Orientaes Tcnicas

Anexos
5 Fluxo dos Pagamentos
I. O comprador (Pessoa Fsica ou Pessoa Jurdica), aps concluir todas as fases de compra, solicita checkout do pedido no site do convenente; II. O pedido de compra calculado e registrado, e os atributos do pedido so apresentados ao consumidor no site do convenente; III. Variveis do Formulrio Pagamento so montadas no site do convenente; Para mais detalhes, observe o item Formulrio Pagamento. IV. Pedido de compra apresentado ao comprador para confirmao; V. Comprador confirma o pedido, e o site do vendedor submete Formulrio Pagamento ao site do BB; VI. O Formulrio Pagamento e o convnio so validados no site do BB e verificado se o valor solicitado menor ou igual ao valor mximo estipulado para o convnio; VII. Os atributos do convnio so recuperados pelo site do Banco (nome de fantasia do convnio, urlRetorno do site do Convenente e tipos de convnios que a empresa possui com o Banco); VIII. Site BB apresenta pgina com os dados para o pagamento. Caso a seleo do tipo de pagamento j tenha ocorrido no item V, ser apresentada tela somente com o tipo de pagamento selecionado. Caso contrrio, sero apresentados banners com as opes de pagamento (conforme as modalidades de pagamento contratadas pela empresa) por Boleto bancrio, Dbito em Conta via Internet (PF e PJ) e BB Credirio Internet (PF); IX. Como exemplo, o comprador seleciona pagamento por Dbito em Conta via Internet Pessoa Fsica; X. Comprador informa seus dados de agncia, conta e senha internet e autenticado pelo Banco; XI. Comprador informa senha final para confirmar o pagamento; Ateno: os pagamentos realizados por Pessoa Jurdica, na maioria dos casos, exigem a autorizao do pagamento mediante duas assinaturas. Caso a segunda assinatura autorize o pagamento apenas no dia seguinte, ser gerada a mensagem de erro: Dt invlida e a transao no efetivada. XII. Site BB apresenta pgina informando autenticao eletrnica do pagamento (o cliente deve imprimir a pgina como comprovante de pagamento). Nesse instante, acionado o Formulrio Informa, mesmo ocorrendo problemas no pagamento (erro de sistema, falta de saldo, falta de limite de crdito etc). Caso o comprador clique no boto Confirmar o pagamento na Loja, ser acionado o Formulrio Retorno , o qual direciona o cliente para o site do convenente; XIII. O servidor, site ou aplicao do convenente pode acionar o Formulrio Sonda, caso necessite saber de imediato a situao do pagamento no mesmo momento em que recebe os dados postados pelo formulrio Informa ou Retorno ou em qualquer outro momento aps a finalizao da transao. Esse formulrio utilizado exclusivamente para pagamentos de Dbito em Conta via Internet, BB Credirio Internet e troca de pontos no Programa de Relacionamento do Banco; XIV. O site do BB retorna a resposta do Formulrio Sonda; XV. O BB disponibiliza arquivo(s) retorno(s) no dia til posterior liquidao dos compromissos, conforme definido em cada forma de pagamento, com os dados relativos aos pagamentos realizados.

Verso 20

www.bb.com.br

Solues em Comrcio Eletrnico Orientaes Tcnicas

6 Formulrios

6.1 Variveis utilizadas nos formulrios Para a operacionalizao das Solues em Comrcio Eletrnico so utilizadas as variveis descritas abaixo. Essas variveis devem ser utilizadas conforme indicado em cada tipo de formulrio. Varivel
cep cidade dataPagamento dtVenc endereco formato IdConv

Tam Tipo
8 18 8 8 60 2 6 Num Alfa Num Num Alfa Num Num

Descrio
CEP do comprador, sem hfen, que ser apresentado no boleto de cobrana Cidade do comprador, que ser apresentada no boleto de cobrana Data do lanamento contbil do pagamento, no formato DDMMAAAA Data de vencimento do pagamento, no formato DDMMAAAA. OBS: Aceita data futura somente para emisso de Boleto Bancrio. Endereo do comprador, que ser apresentado no boleto de cobrana Formato de retorno dos formulrios de consulta submetidos ao banco: 01 HTML (Retorno visual em pgina do Banco para controle manual) 02 XML (Retorno em tag XML) 03 String (Retorno em forma de String) Cdigo do convnio de Comrcio Eletrnico fornecido pelo Banco Indica a situao da transao de pagamento: 000 transao concluda NNN transao no concluda, onde NNN numrico diferente de 000 Importante: o envio da varivel com cdigo 000 no garante a liquidao do compromisso. Dever acionar o formulrio Sonda para efetuar a confirmao. Instrues do cedente, que sero apresentadas no boleto de cobrana Nome do comprador, que ser apresentado no boleto de cobrana Nmero atribudo, gerado e controlado pelo Convenente, que identifica o pedido de compra em todas as fases do processo de pagamento. A cada nova transao dever ser gerado outro nmero refTran, no podendo ser reutilizado, inclusive os nmeros utilizados nos testes. Caso possua convnio de cobrana vinculado ao convnio de Comrcio Eletrnico, solicite o nmero desse convnio para sua agncia e verifique: a) para convnio de Cobrana com 6 (seis) posies as 17 posies so livres; b) para convnio de Cobrana com 7 (sete) posies informe: CCCCCCCNNNNNNNNNN, onde: CCCCCCC = nmero do convnio de cobrana NNNNNNNNNN = posies livres As 17 posies so livres quando no houver o meio de pagamento de Cobrana vinculado ao convnio de Comrcio Eletrnico. Para o Programa de Relacionamento de Pontos, a varivel composta da seguinte maneira: CCCCCCCCCPPPPPPPP, onde: CCCCCCCCC: Identificador do Programa de Relacionamento assume: 999999901 Programa de Relacionamento Cliente indica Cliente 999999902 Programa de Relacionamento PJ PPPPPPPP Nmero do pedido do Parceiro Indica a situao do pagamento: 00 pagamento efetuado 01 pagamento no autorizado/transao recusada 02 erro no processamento da consulta 03 pagamento no localizado 10 campo idConv invlido ou nulo 11 valor informado invlido, nulo ou no confere com o valor registrado 99 Operao cancelada pelo cliente Conforme a modalidade de pagamento: 0 Todas as modalidades contratadas pelo convenente 2 Boleto bancrio 21 2 Via de boleto bancrio, j gerado anteriormente 3 Dbito em Conta via Internet 5 BB Credirio Internet Para o Programa de Relacionamento de Pontos, a varivel composta da

informacao

Num

msgLoja Nome

480 60

Alfa Alfa

RefTran

17

Num

situacao

Num

tpPagamento

1 ou 2

Num

Verso 20

www.bb.com.br

10

Solues em Comrcio Eletrnico Orientaes Tcnicas

seguinte maneira: 61 Tipo de pagamento com pontos do Programa de Relacionamento Cliente indica Cliente 62 Tipo de pagamento com pontos do Programa de Relacionamento PJ Estado do comprador, que ser apresentado no boleto de cobrana Complemento de endereo (URL) que ser acionado, indicando que uma transao foi finalizada no site do BB, cabendo ao convenente acionar o Formulrio Sonda para confirmar a liquidao financeira da compra O endereo acionado (URL) composto pela concatenao de duas partes: parte1: cadastrada na agncia. Exemplo: https://www.teste.com.br parte2: ser o complemento da parte fixa, que ser informada nessa varivel (urlInforma). Exemplo: /InformaBB.asp?1358568 Nesse exemplo, seria acionado o seguinte endereo: https://www.teste.com.br/InformaBB.asp?1358568 Importante: O acionamento do formulrio Informa no significa, de maneira alguma, a liquidao do compromisso. O convenente dever acionar o formulrio Sonda para obter essa confirmao ou aguardar a disponibilizao de arquivo retorno no dia til seguinte ao pagamento. Endereo (URL) para o qual o cliente ser direcionado, atravs do formulrio Retorno, caso deseje voltar identificado ao site do convenente, a partir da ltima pgina do processo de pagamento, clicando em boto disponvel nessa pgina. Composto pela concatenao de duas partes: parte1: cadastrada na agncia. Exemplo: https://www.teste.com.br parte2: ser o complemento da parte cadastrada na agncia, informada nessa varivel (urlRetorno). Exemplo: /RetornoBB.asp?1358568 Nesse exemplo, o cliente seria direcionado ao seguinte site: https://www.teste.com.br/RetornoBB.asp?1358568 Importante: O envio do formulrio Retorno ao site especificado no significa, de maneira alguma, a liquidao do compromisso. O convenente dever acionar o formulrio Sonda para efetuar essa confirmao ou aguardar a disponibilizao de arquivo retorno no dia til seguinte ao pagamento. Valor total da compra em Reais, com centavos, sem formatao. Exemplo: para R$ 195,72 informe 19572 Para o Programa de Relacionamento de Pontos, a varivel composta da seguinte maneira: Valor em reais da transao informe zeros Varivel exclusiva para o Programa de Relacionamento de Pontos. Quantidade de pontos que sero resgatados no Programa de Relacionamento. Valor total da compra em Reais, com centavos sem formatao. Exemplo: para R$ 195,72 informe 19572

Uf

Alfa

urlInforma

60

Alfa

urlRetorno

60

Alfa

Valor

15

Num

qtdPontos valorSonda

15 15

Num Num

Verso 20

www.bb.com.br

11

Solues em Comrcio Eletrnico Orientaes Tcnicas

6.1.1 Formulrio Pagamento Variveis de envio do formulrio Pagamento: Site do Convenente
Varivel IdConv RefTran Valor qtdPontos DtVenc tpPagamento urlRetorno urlInforma Nome endereco Cidade Uf Cep msgLoja

Site do Banco

Utilizao Obrigatria Obrigatria Obrigatria (para o Programa de Relacionamento de Pontos informe o valor que foi convertido) Obrigatria (varivel exclusiva para o Programa de Relacionamento de Pontos) Obrigatria Obrigatria Obrigatria Opcional Obrigatria Obrigatria quando permitir boleto bancrio Obrigatria quando permitir boleto bancrio Obrigatria quando permitir boleto bancrio Obrigatria quando permitir boleto bancrio Opcional

a. Gerao da 2 via do Boleto de cobrana Para a gerao de 2 via de boleto de cobrana, a varivel tpPagamento preenchida com 21 e todos os campos idnticos aos submetidos na gerao da 1 via do boleto de cobrana. Se necessria alterao dos campos, solicite a gerao de boleto com nova refTran e a varivel tpPagamento como modalidade 2. b. Estrutura do formulrio Pagamento <form action="https://www16.bancodobrasil.com.br/site/mpag/" method="post" name="pagamento"> <input type="hidden" name="idConv" value="<%= idConv %>"> <input type="hidden" name="refTran" value="<%= refTran %>"> <input type="hidden" name="valor" value="<%= valor %>"> <input type="hidden" name="qtdPontos" value="<%= qtdPontos %>"> <input type="hidden" name="dtVenc" value="<%= dtVenc %>"> <input type="hidden" name="tpPagamento" value= "<%= tpPagamento %>"> <input type="hidden" name="urlRetorno" value="<%= urlRetorno %>"> <input type="hidden" name="urlInforma" value="<%= urlInforma %>"> <input type="hidden" name="nome" value="<%= nome %>"> <input type="hidden" name="endereco" value="<%= endereco %>"> <input type="hidden" name="cidade" value="<%= cidade %>"> <input type="hidden" name="uf" value="<%= uf %>"> <input type="hidden" name="cep" value="<%= cep %>"> <input type="hidden" name="msgLoja" value="<%= msgLoja %>"> </form> 6.1.2 Formulrio Retorno Variveis de envio do formulrio Retorno: Site do Banco Site do convenente.

Formulrio acionado pelo site do Banco desde que o comprador clique o boto "Confirmar o pagamento na Loja", o qual exibido aps efetivao do pagamento e direcionar o cliente novamente para o site da loja (endereo cadastrado no Banco: http://www.enderecoendereco.com.br). Permite que o convenente identifique qual cliente est retornando ao seu site aps o pagamento no BB.

Verso 20

www.bb.com.br

12

Solues em Comrcio Eletrnico Orientaes Tcnicas

No representa a liquidao do compromisso, a qual dever ser confirmada por meio do Formulrio Sonda. Varivel refTran idConv tpPagamento Utilizao Obrigatria Obrigatria Obrigatria

a. Estrutura do formulrio Retorno <form action="pgina de retorno do Convenente cadastrada no Banco+complemento*" method="post" name="retorno"> <!-Retorno de variveis para Loja --> <input type="hidden" name="refTran" value=""> <input type="hidden" name="idConv" value=""> <input type="hidden" name="tpPagamento" value=""> </form> (*) complemento o contedo da varivel urlRetorno obtida no Formulrio Pagamento.

6.1.3

Formulrio Informa

Formulrio disponvel apenas para compras efetuados por Pessoa Fsica e enviado automaticamente ao site da loja (endereo cadastrado no Banco). Sua funo informar que algum fez um pagamento, no significando a confirmao desse pagamento. A parte fixa (cadastrada no Banco) do endereo da URL Informa deve ser a mesma da Retorno. URL

O Formulrio Pagamento dever conter a varivel urlInforma. Quando apresentado o comprovante de pagamento, acionado o formulrio Informa com a seguinte estrutura: Dados do exemplo: Nmero do convnio de comrcio eletrnico (idConv) = 8308 Referncia da transao (refTran) = 52170785 Valor da transao (valor) = R$ 2.567,89 Exemplo 1 - concatenao SEM caracter "?" Parte fixa cadastrada no Banco: http://www.loja.com.br Contedo da varivel urlInforma: /teste.jsp O BB aciona o endereo: http://www.loja.com.br/teste.jsp?refTran=52170785&idConv=8308&valor=256789 Exemplo 2 - concatenao COM caracter "?" Parte fixa cadastrada no Banco: http://www.loja.com.br Contedo da varivel urlInforma: /teste.jsp?parametroDaLoja=xyz O BB aciona o endereo: http://www.loja.com.br/teste.jsp?parametroDaLoja=xyz&refTran=52170785&idConv=8308&valor=256789 Se na concatenao da urlInforma cadastrada no BB com a urlInforma enviada no Formulrio Pagamento no existir o caracter "?", o banco incluir ao final dessa concatenao o caracter "?" e as informaes: ?refTran=52170785&idConv=8308&valor=256789 Se houver caracter "?" nessa concatenao, o banco incluir ao final dessa concatenao o caracter "&" e as informaes: &refTran=52170785&idConv=8308&valor=256789

Verso 20

www.bb.com.br

13

Solues em Comrcio Eletrnico Orientaes Tcnicas

b. Para o Programa de Relacionamento de Pontos Variveis de envio do formulrio Informa: Site do Banco Site do Convenente

Esse formulrio utilizado pelo BB para enviar ao parceiro a informao de que uma transao de troca de pontos foi realizada. Com essa informao o parceiro aciona o Formulrio Sonda para buscar a confirmao da transao no BB. Varivel idConv refTran valor qtdPontos 6.1.4 Formulrio Sonda Variveis de envio do formulrio Sonda: Site do Convenente Site do Banco Utilizao Obrigatria Obrigatria Obrigatria (informe zeros) Obrigatria

a consulta on line situao do pagamento, sendo a nica garantia on line de que o pagamento foi efetivado. A empresa dever criar alternativa prpria para tratar essa informao. Sugerimos realizar 6 (seis) sondagens dentro de um periodo de 30 minutos ou a critrio da empresa, conforme a necessidade. Est disponvel apenas para os pagamentos realizados por Dbito em Conta via Internet e BB Credirio Internet.

Varivel idConv refTran valorSonda qtdPontos formato

Utilizao Obrigatria Obrigatria Obrigatria Obrigatria (exclusivo para o Programa de Relacionamento de Pontos) Obrigatria

a. Estrutura do Formulrio Sonda Para a passagem dos parmetros, o Formulrio Sonda deve ser chamado utilizando preferencialmente o mtodo POST, conforme o texto de cdigo abaixo: <form action="https://www16.bb.com.br/site/mpag/REC3.jsp" method="post" name="sonda"> <input type="hidden" name="idConv" value="<%= idConv %>"> <input type="hidden" name="refTran" value="<%= refTran %>"> <input type="hidden" name="qtdPontos" value="<%= qtdPontos %>"> <input type="hidden" name="valorSonda" value="<%= valor %>"> <input type="hidden" name="formato" value="<%= formato %>"> </form> b. Resposta do Formulrio Sonda Variveis de envio da resposta do formulrio Sonda: Site do Banco Varivel refTran valor idConv tpPagamento situacao dataPagamento qtdPontos Site do Convenente

Utilizao Obrigatria Condicional Obrigatria Obrigatria Obrigatria Obrigatria Obrigatria (exclusivo para o Programa de Relacionamento de Pontos)

Verso 20

www.bb.com.br

14

Solues em Comrcio Eletrnico Orientaes Tcnicas

c. Estrutura XML <?xml version='1.0' encoding='ISO-8859-1' standalone='no'?> <!DOCTYPE lojavirtual SYSTEM "lojavirtual.dtd"> <FORMULARIO> <ENTRADA nome="reftran" valor=""/> <ENTRADA nome="valor" valor=""/> <ENTRADA nome="idConv" valor=""/> <ENTRADA nome="tpPagamento" valor=""/> <ENTRADA nome="situacao" valor=""/> <ENTRADA nome="dataPagamento" valor=""/> <ENTRADA nome="qtdPontos" valor=""/> </FORMULARIO> d. Estrutura lojavirtual.dtd <?xml version="1.0" encoding="ISO-8859-1"?> <!ELEMENT FORMULARIO (ENTRADA)+> <!ELEMENT ENTRADA (EMPTY)> <!ATTLIST ENTRADA nome CDATA #REQUIRED valor CDATA #REQUIRED> e. Resposta em forma de String String = aaaaaaaaaaaaaaaaa000000000000000bbbbbbcddeeeeeeeeqqqqqqqqqqqqqqq Posio 01-17 18-32 33-38 39-39 40-41 42-49 50-64 Tipo Num (017) Num (15) Num (6) Num (1) Num (2) Num (8) Num (15) Onde aaaaaaaaaaaaaaaaa 000000000000000 bbbbbb c dd eeeeeeee qqqqqqqqqqqqqqq a Varivel RefTran Valor IdConv TpPagamento Situao DataPagamento qtdPontos (exclusivo para o Programa de Relacionamento
de Pontos)

Verso 20

www.bb.com.br

15

Solues em Comrcio Eletrnico Orientaes Tcnicas

6.1.5 Cancelamento de Venda BB Credirio Internet

Para cancelar compras efetivadas na modalidade BB Credirio Internet, a empresa deve preencher o modelo de formulrio abaixo. Encaminhe a solicitao agncia detentora do convnio de comrcio eletrnico.

Local e data

Ao Banco do Brasil S.A. Agncia (Nome da Agncia)

Sr. Gerente,

CANCELAMENTO DE VENDA De acordo com o regulamento de Comrcio Eletrnico Banco do Brasil, Clusula Stima, alnea i, comunicamos o(s) cancelamento(s) abaixo: Cdigo idConv Data da venda Valor da venda Nmero do pedido Cdigo reftran (id.banco/id.loja)

Desde j, autorizo (amos) esse Banco a estornar de nossa conta corrente o valor acima.

Assinatura da Empresa

Verso 20

www.bb.com.br

16

Solues em Comrcio Eletrnico Orientaes Tcnicas

Leiaute do Arquivo Retorno Formato RCB001 Out/10

HEADER DO ARQUIVO RETORNO CDIGO DE REGISTRO A

Campo A1 A2 A3 A4 A5 A6 A7 A8 A9 A10 A11 A12 A13 A14 Posio 01-01 02-02 03-08 09-09 10-18 19-22 23-42 43-45 46-65 66-73 74-79 80-81 82-142 143-150 Tipo Alfa (001) Num (001) Num (006) Alfa (001) Num (009) Alfa (005) Alfa (020) Num (003) Alfa (020) Num (008) Num (006) Num (002) Alfa (061) Alfa (008) Contedo Cdigo do registro assume A Cdigo de remessa assume 2 (retorno enviado pelo banco) Nmero do convnio Uso futuro Seqencial de retorno do Intercmbio Eletrnico de Dados Uso futuro Nome da empresa / rgo Cdigo do banco na compensao interbancria Nome do banco Data da gerao do arquivo formato AAAAMMDD Nmero seqencial do arquivo Verso do leiaute Febraban adotado para registro tipo G verso 4 Reservado uso futuro No caso do comrcio eletrnico, este campo ser vazio.

DETALHE DO ARQUIVO RETORNO CDIGO DE REGISTRO G

Campo G1 G2.1 G2.2 G2.3 G2.4 G2.5 G3 G4 G5 G6 G7 G8 G9.1 G9.2 G10 G11 G12 G13 Posio 01-01 02-05 06-06 07-15 16-16 17-21 22-29 30-37 38-81 82-93 94-100 101-108 109-112 113-116 117-117 118-140 141-141 142-150 Tipo Alfa (001) Num (004) Alfa (001) Num (009) Alfa (001) Alfa (005) Num (008) Num (008) Alfa (044) Num (010)v99 Num (005)v99 Num (008) Num (004) Alfa (004) Num (001) Alfa (023) Num (001) Alfa (009) Contedo Cdigo do registro assume G Prefixo da agncia creditada Digito verificador do prefixo da agncia (mdulo 11) Nmero da conta corrente creditada Digito verificador do n da conta corrente (mdulo 11) Uso futuro Data do pagamento - formato AAAAMMDD Data do credito formato AAAAMMDD Cdigo de barras vide especificao abaixo (G5-Cdigo de Barras) Valor recebido Valor da tarifa Nmero sequencial de registro Prefixo da agncia recebedora Uso futuro Meio de arrecadao: 1- Caixa, 2 - Eletrnica, 3 - Internet Autenticao eletrnica Forma de recebimento: 1- Dinheiro, 2 - Cheque, 3 - No identificada Uso futuro

CAMPO G5 - CDIGO DE BARRAS

Campo G5.1 G5.2 G5.3 G5.4 G5.5 G5.6 G5.7 G5.8 G5.9 Posio Tipo Contedo 01-01 Num (001) Cdigo identificao do produto - assume 8 (arrecadao) Identificao do segmento e a forma de identificao da empresa/rgo 02-02 Num (001) assume: 9 03-03 Num (001) Identificador do valor real ou referencia assume 6 (real) 04-04 Num (001) Digito verificador geral modulo 10 05-15 Num (011) Valor em reais 16-19 Num (004) Cdigo do BB na compensao. Assume: 0001 20-21 Num (002) Preenchido com o valor 01. 22-27 Num (006) Cdigo do convnio RCB Nmero do pedido ( o valor que foi atribudo a varivel refTran gerado 28-44 Num (017) pelo conveniado)

TRAILLER DO ARQUIVO RETORNO CDIGO DE REGISTRO Z

Campo Z1 Z2 Z3 Z4 Posio 01-01 02-07 08-24 25-150 Tipo X(001) 9(006) 9(017) X(126) Contedo Cdigo do registro assume Z Total de registros do arquivo, inclusive header e trailler Valor total recebido dos registros do arquivo livre

Verso 20

www.bb.com.br

17

Solues em Comrcio Eletrnico Orientaes Tcnicas

8 Cdigos de erro e possveis solues Erro Soluo

O convnio pode no estar cadastrado e ativado no sistema do BB. C009-000 Entre em contato com sua agncia de relacionamento. O convnio pode no estar cadastrado e ativado no sistema do BB. Convnio recebimento invlido Entre em contato com sua agncia de relacionamento. Boleto Invlido para Pagamento: Consulte Contate o suporte tcnico e solicite anlise de leiaute, onde poder ser o cedente (C436) (G999-750) pedida a emisso de um boleto para a anlise. C021-000 HTTP Status 404 Error Message: /site/saida.jsp Pagto Web no autorizado (C021-001) H um problema no certificado de segurana do site. The underlying connection was closed: Could not establish trust relationship with remote server. SUN Java System Server - HTTP Status 500 Error type: exception report, messege: internal server error;exception, java.lang.nullpointer exception Error 500 Internal Server Error Dt invlida Rejeitado pelo Codificador O convnio de cobrana est com status encerrado. Servidor do Banco informado incorretamente. Observe item Estrutura do formulrio de Pagamento. Os acessos a conta utilizada para o pagamento foram realizados a partir de um computador que no possibilitou validar os requisitos de segurana da mquina que provavelmente no de uso habitual, sendo necessrio cadastramento da mquina para efetivar o pagamento. A passagem dos parmetros do Formulrio Sonda deve ser chamado utilizando o mtodo POST e no a URL. Mais informaes neste manual, item Estrutura do Formulrio Sonda.

Utilizao de um frame na aplicao da loja virtual para visualizao do site dos meios de pagamento, o qual no permitido. Certifique-se que o servidor utilizado est correto. Mais detalhes na Estrutura do Formulrio de Pagamento. Casos em que exigida segunda assinatura para pagamentos realizados por Pessoa Jurdica e a autorizao feita apenas no dia seguinte. O pagamento no efetivado. Limite de pagamento dirio excedido.

Verso 20

www.bb.com.br

18

Solues em Comrcio Eletrnico Orientaes Tcnicas

9 Arquivo Retorno

Diariamente disponibilizado arquivo retorno (RCB001 / CBR643 / CNAB240) com as informaes de todos os pagamentos realizados no dia anterior. Por meio desse arquivo a loja dar o tratamento necessrio para confirmar os pagamentos recebidos. 10 Autorizao de usurio As telas abaixo demonstram a maneira que o Administrador de Segurana do Gerenciador Financeiro autoriza um usurio a receber arquivos retorno de Boleto de Cobrana, Dbito em Conta via Internet e BB Credirio Internet.

Verso 20

www.bb.com.br

19

Solues em Comrcio Eletrnico Orientaes Tcnicas

Verso 20

www.bb.com.br

20

Solues em Comrcio Eletrnico Orientaes Tcnicas

Verso 20

www.bb.com.br

21

Solues em Comrcio Eletrnico Orientaes Tcnicas

11 Como o usurio autorizado recebe o Arquivo Retorno

Verso 20

www.bb.com.br

22

Solues em Comrcio Eletrnico Orientaes Tcnicas

Verso 20

www.bb.com.br

23

Solues em Comrcio Eletrnico Orientaes Tcnicas

Verso 20

www.bb.com.br

24

Solues em Comrcio Eletrnico Orientaes Tcnicas

12 Suporte Tcnico Ao acionar o Suporte Tcnico do BB, tenha em mos algumas informaes que podero ser solicitadas para agilizar a identificao da empresa no atendimento: Agncia e conta CNPJ da empresa N do convnio de Comrcio Eletrnico (idConv) Telefones de contato: Atacado - Cliente de agncia de relacionamento Empresarial ou Corporate: 3003-0600 para capitais e regies metropolitanas ou 0800-7290600 para as demais localidades Varejo - Cliente de agncia de relacionamento Empresa: 3003-0500 para capitais e regies metropolitanas ou 0800-7290500 para as demais localidades

Verso 20

www.bb.com.br

25

Solues em Comrcio Eletrnico Orientaes Tcnicas

13 Histrico das atualizaes deste documento
Atualizao nmero: Motivo da atualizao: Atualizaes nmero: Motivo da atualizao: 020 Mensagens de erro Data de publicao: 04.11.2011

019 Data de publicao: 07.01.2011 Nova formatao do manual, alterao do detalhamento String, conceitos sobre os formulrios, leiaute do arquivo retorno RCB001, incluso de cdigo de erro, orientao para download de banners e logotipos do BB, passo a passo da autorizao para usurio do Gerenciador Financeiro 018 Data de publicao: Alterao no leiaute do arquivo retorno 001 a 017 Publicadas at 2009 21.05.2010

Atualizao nmero: Motivo da atualizao: Atualizaes nmero: Motivo da atualizao:

Verso 20

www.bb.com.br

26