• Nenhum resultado encontrado

Soluções em Comércio Eletrônico. Manual da Empresa Convenente

N/A
N/A
Protected

Academic year: 2021

Share "Soluções em Comércio Eletrônico. Manual da Empresa Convenente"

Copied!
22
0
0

Texto

(1)

Soluções em Comércio Eletrônico

Meios de Pagamento na Internet

Manual da Empresa Convenente

Orientações Técnicas

(2)

I. Apresentação

Vantagens oferecidas...

3

Requisitos necessários...

3

II. Características

Fluxo operacional...

4

Como funciona...

4

Intercâmbio de informações em meio magnético...

4

III. Opções de Meios de Pagamentos

Débito em conta...

5

Bloqueto bancário...

5

IV. Roteiro de implantação

Formalização de convênios...

6

Implementação do código...

6

Simulações e homologação da implementação...

7

Ativação do convênio...

7

V. Anexos

1. Diagrama de seqüência – Pagamentos...

8

2. Formulários...

12

a) Formulário – Pagamento...

12

b) Formulário – Notifica...

13

c) Formulário – Sonda...

14

Retorno da consulta à situação do pagamento...

15

Estrutura XML ...

16

Estrutura “lojavirtual.dtd”...

16

Resposta em forma de String... 16

d) Formulário – Pagamento (segunda via de bloqueto de cobrança)...

17

3. Leiautes...

18

a) Leiaute de arquivo retorno – débito em conta...

18

b) Leiaute de arquivo retorno – cobrança de títulos – CBR643...

20

(3)

I. Apresentação

O Banco do Brasil desenvolveu a solução para Meios de Pagamento na Internet,

especialmente para empresas que atuam em comércio eletrônico.

Os Meios de Pagamento na Internet realizam a intermediação financeira entre empresas

e consumidores (B2C), entre empresas e empresas (B2B); oferecendo diversas opções de

pagamento, possibilitando à empresa escolher as mais adequadas às suas necessidades.

Trata-se de um serviço seguro e completo, que permite o acompanhamento da transação

em tempo real na modalidade débito em conta e, de todas, no back-office da empresa, utilizando

o Gerenciador Financeiro ou seu sistema de gestão.

O regulamento do comércio eletrônico do Banco encontra-se disponível para download

no endereço:

http://www.bb.com.br/portal/emp/ep/srv/dwn/regulamento.pdf

Vantagens oferecidas

Simplicidade de implementação;

Todo clearing financeiro a cargo do Banco;

Confiabilidade e segurança do Banco do Brasil;

Menores taxas do mercado;

Maior base de clientes usuário de Internet na América Latina;

Requisitos necessários

A empresa deverá ser cliente do Banco e possuir um cadastro em situação normal,

formalizando os convênios específicos para cada meio de pagamento e cumprir roteiro de

implantação.

(4)

II. Características

Fluxo operacional

Como funciona

A partir do site do Convenente, o comprador(Pessoa Física ou Pessoa Jurídica) faz sua

opção de pagamento. Nesse momento são apresentadas as opções de pagamento que o site

tem negociado com o Banco (caso o site tenha apenas uma forma de pagamento negociada

com o Banco, somente esse meio de pagamento será apresentado).

Na chamada ao site do Banco ocorre a passagem de parâmetros que identificam a

origem e qual a forma de pagamento deve ser oferecidas para a transação que está sendo

realizada. A validação do convênio é realizada no ambiente do Banco.

Todo o processo de autenticação dos clientes envolvidos na transação, verificação de

disponibilidade financeira - para formas de pagamento que exijam essa validação – bem como o

processamento contábil da operação comercial são realizados com segurança, garantindo a

integridade dos dados em todo o ciclo da transação. A atualização na base de dados se dá em

tempo real, permitindo a consulta on-line ao status de pagamento (a consulta ao status de

pagamento do pedido é feita a partir do site do Banco).

O Banco oferece todas as informações relativas às transações financeiras realizadas, no

próprio domicílio do cliente, através do Gerenciador Financeiro.

Intercâmbio de Informações em meio magnético

Diariamente, o Banco disponibiliza as informações de todos os pagamentos realizados no

dia anterior, através da geração de arquivo retorno.

A empresa receberá o arquivo RCB001, discriminando os pagamentos realizados por

débito em conta, seja Pessoa Física ou Pessoa Jurídica. A informação dos pagamentos

realizados por bloqueto bancário estará discriminada no arquivo CBR643 ou CNAB240.

O Banco disponibiliza diversas formas de acesso/conexão. A empresa deverá, quando da

formalização do convênio, fazer opção do tipo de acesso/conexão.

(5)

III. Opções de Meios de Pagamentos

Débito em conta

Forma de pagamento à vista, mediante débito em conta corrente do comprador (Pessoa

Física - B2C ou Jurídica – B2B) e crédito em conta corrente da empresa.

Fluxo da transação:

validação do convênio;

autenticação do cliente comprador;

verificação da disponibilidade de fundos;

lançamento do débito em conta corrente do comprador;

registro da transação em base de dados.

O crédito correspondente à compra/serviço será contabilizado na conta da empresa em

D+N, conforme float negociado junto à agência de relacionamento, agrupado em único

lançamento.

A empresa receberá arquivo RCB001 com a demonstração de todos os pagamentos,

bem como poderá iniciar transação de consulta, no site do Banco, para verificação do status de

pagamento do pedido de compra/serviço.

Para que a empresa tenha acesso a esse meio de pagamento, é necessário:

possuir conta corrente;

possuir convênio de arrecadação;

indicar o tipo de intercâmbio de informações em meio magnético.

cumprir roteiro de implantação

Bloqueto bancário - Cobrança sem registro

Forma de pagamento mediante geração de bloqueto de cobrança bancária impresso pelo

próprio comprador (Cobrança sem registro). O crédito correspondente à compra/serviço será

contabilizado na conta da empresa quando da liquidação do título. A empresa receberá arquivo

CBR643 ou CNAB240 com a demonstração de todos os pagamentos.

Para que a empresa tenha acesso a esse meio de pagamento, é necessário:

possuir conta corrente;

possuir convênio de cobrança;

indicar o tipo de intercâmbio de informações em meio magnético.

cumprir roteiro de implantação.

(6)

IV. Roteiro para Implantação

Formalização de convênios

Na agência de relacionamento da empresa, deverá ser formalizado:

convênio de arrecadação para permitir o pagamento por Débito em Conta para

Pessoa Física e Pessoa Jurídica - RCB;

convênio de cobrança para pagamento por Bloqueto bancário de acordo com as

necessidades do cliente;

convênio de comércio eletrônico para permitir a troca eletrônica de parâmetros/

informações dos formulários.

Deverá ser informado ao Banco, para uso como meio de pagamento via Internet, os

seguintes atributos:

Valor limite de compras – esse atributo determina o valor máximo permitido para cada

pagamento;

URL que identificará o site do Convenente.

(exemplos:

http://www.lojavirtual.com.br

ou

https://lojavirtual.com.br

).

Solicitar ao gerente responsável pela formalização do(s) convênio(s) o fornecimento do

identificador do convênio para uso via Internet (esse será o número atribuído à variável idConv –

vide código de implementação).

O convênio de comércio eletrônico ficará com status “9 - Não Ativo”. Essa situação é

desejável, pois permitirá a homologação da implementação.

Implementação do código

A empresa deverá implementar, no ambiente do site, código da estrutura do formulário,

para captura das variáveis relativas ao pagamento da compra/serviço.

Deverá implementar também, no ambiente de administração do site, o código da

estrutura de formulário que permitirá a consulta à situação do pagamento.

No endereço

https://www11.bb.com.br/site/mpag/simulador/loja.jsp

pode-se efetuar a

simulação de pagamentos, permitindo visualizar solução de implementação.

A empresa responsável pela implementação deverá cumprir os seguintes requisitos

técnicos:

O link para o Banco deverá ser acionado somente após o comprador ter executado

todos os passos necessários a sua compra (checkout), faltando apenas efetuar o

pagamento;

A página que receberá a postagem do formulário não poderá ser aberta em frame.

Exemplo: a página não poderá conter a tag html <frameset>.

(7)

Simulações e homologação da implementação

A equipe técnica da empresa deverá realizar simulações de pagamentos, de forma a

garantir o perfeito funcionamento da implementação.

Enquanto a situação do convênio for “9 – Não Ativo” os pagamentos realizados pela

opção débito em conta não sensibilizarão as contas envolvidas. O sistema do Banco permitirá o

processamento de todo o fluxo indicando, porem, que essa operação é uma simulação sem

qualquer efeito contábil. Nesta situação, será apresentado o nome empresa precedido da

palavra “Teste”.

A homologação deverá ser realizada em ambiente de produção.

Ativação do convênio

Após a conclusão da fase de homologação, a empresa deverá comunicar ao Banco que

está apta a oferecer os Meios de Pagamentos do Banco.

De posse dessa informação, a agência providenciará a ativação do convênio. Deve-se

observar que, apenas após a ativação do convênio pela agencia, a empresa poderá

disponibilizar os Meios de Pagamentos em seu site.

Após a ativação do convênio, a palavra “Teste” deixará de ser mostrada. A variável

refTran deverá ser sequencial, não podendo ser reutilizados os números usados nos testes.

(8)

V. Anexos

1. DIAGRAMA DE SEQÜÊNCIA – PAGAMENTOS

1. O comprador (Pessoa Física e/ou Pessoa Jurídica), após concluir todas as fases de compra,

solicita check out do pedido;

2 4 : g e r a i n f o r m a ç ã o : C o m p r a d o r : S i t e L o j a : F e c h a r P e d i d o : S i t e B B : H o s t B B : B a c k O f f i c e L o j a 1 : c h e c k o u t 2 : c h e c k o u t 3 : v a l i d a 4 : c a l c u l a 5 : r e s u m o p e d i d o 6 : m o n t a f o r m u l á r i o 7 : a p r e s e n t a p e d i d o 8 : s u b m e t e f o r m u l á r i o 9 : v a l i d a f o r m u l á r i o 1 0 : s u b m e t e 1 1 : v a l i d a c o n v ê n i o 1 2 : r e c u p e r a a t r i b u t o s 1 3 : a p r e s e n t a o p ç õ e s d e p a g a m e n t o 1 4 : e f e t u a p a g a m e n t o - d é b i t o e m c o n t a 1 5 : s u b m e t e p a g a m e n t o 1 6 : a u t e n t i c a c l i e n t e 1 7 : c o n t a b i l i z a p a g t o 1 8 : p a g a m e n t o e f e t i v a d o 1 9 : r e t o r n a 2 0 : c o n s u l t a s i t u a ç ã o p a g a m e n t o 2 1 : s o l i c i t a c o n s u l t a 2 2 : r e c u p e r a i n f o r m a ç ã o 2 3 : i n f o r m a s i t u a ç ã o p a g a m e n t o 2 5 : e n t r e g a p r o d u t o / s e r v i ç o

(9)

2. A solicitação de check out é encaminha para validação;

3. O pedido de compras é validado;

4. O pedido de compras é calculado e registrado;

5. Atributos do pedido de compras é encaminhado para apresentação;

6. Variáveis do formulário “pagamento” são montadas;

Obs: Verificar item “Formulários – Pagamento”, para maiores detalhes.

7. Pedido de compra é apresentado ao comprador para confirmação;

8. Comprador confirma o pedido e submete formulário montado pela Convenente ao site do

Banco;

9. O formulário “pagamento” é validado:

verificado se o conteúdo das variáveis “idConv”, “valor” e “refTran” é numérico e maior

que zero;

verificado se o conteúdo das variáveis “dtVenc” e “tpPagamento” é numérico;

10. Submete transação de pagamento;

Para pagamentos por Débito em conta, verifica-se se a data do pagamento (variável

“dtVenc”) informada pelo site é data útil, caso não seja, o Banco automaticamente

programa o débito para próximo dia útil.

11. Convênio é validado:

verificado se convênio existe;

verificado se permite o tipo de pagamento selecionado;

verificado se o valor solicitado é menor ou igual ao valor máximo de compra estipulado

para o convênio.

12. Recupera os atributos do convênio:

nome de fantasia do convênio;

url do site da Convenente (cadastrada na formalização do convênio);

tipos de convênios que a empresa Convenente possui com o Banco.

13. Apresenta página com os dados para o pagamento:

Caso a seleção do tipo de pagamento já tenha ocorrido no item “10”, será apresentado o

leiaute do bloqueto bancário ou será solicitado que o comprador informe os dados

necessários para realizar o débito em conta. Caso contrário, serão apresentados banners

com as opções de pagamento por Bloqueto bancário e Débito em conta (desde que a

empresa tenha firmado essas modalidades de convênios).

O pagamento por Débito em conta inicia com a apresentação da página a seguir, e tem

associado ao link “

Voltar para loja” a URL formada com a concatenação do endereço do

site da Convenente (informado ao Banco no momento da formalização do convênio) + o

conteúdo da variável “urlRetorno” do formulário ‘pagamento’.

(10)

O pagamento por Débito em conta conclui com a apresentação da página abaixo, e tem

associado ao botão “Continua” a URL da página de retorno da Convenente que irá

receber a notificação da conclusão do pagamento do comprador. A URL da página é

formada com a concatenação do endereço do site da empresa (informado ao Banco no

momento da formalização do convênio) + o conteúdo da variável “urlRetorno” do

formulário ‘pagamento’.

14. Efetua pagamento por Débito em conta – Pessoa Física:

A partir desse ponto o fluxo apresentado assume que o pagamento será realizado

utilizando a modalidade de Débito em conta.

15. Submete pagamento;

16. Autentica comprador cliente do Banco;

17. Contabiliza o pagamento

(11)

18. Apresenta página informando autenticação eletrônica do pagamento:

Essa página de conclusão do pagamento contém o form “notifica”, com objetivo de

notificar a conclusão do processo de pagamento, desde que o comprador acione o botão

‘Continua’ disponível na página;

a URL associada ao parâmetro “action” do formulário “notifica” será montado a partir da

URL do site da empresa, cadastrada no Banco quando da formalização do convênio

(recuperada no item 12 acima), e complementada com o conteúdo da variável

“urlRetorno” do formulário “pagamento” (submetido pelo comprador no item 8 acima);

o formulário “notifica” será submetido por método “post” após click no botão ‘

Continua’

disponível na página de conclusão de pagamento.

19. Comprador clica botão ‘Continua’;

Na página de retorno da Convenente, recupera-se as variáveis do formulário “notifica”,

possibilitando que a empresa atualize o banco de dados de pedidos de compra;

Mesmo que o comprador não clique no botão “continua”, a operação de débito em conta

ou de emissão do bloqueto, está realizada no banco. Para saber se o pagamento foi

efetuado, o conventente deve utilizar a opção de “Sonda”.

20. Consulta situação de pagamento (Sonda);

consultar a situação do pagamento é opcional, devendo ser utilizada quando a empresa

necessita saber de imediato se o pagamento foi efetivado;

a informação sobre a situação do pagamento apenas esta disponível para os

pagamentos realizados por Débito em conta corrente;

independente de submeter o formulário “sonda”, diariamente o Banco disponibiliza

arquivo com informações dos pagamentos realizados.

21. Solicita consulta;

22. Recupera informação da situação do pagamento;

23. Informa situação do pagamento:

o Banco disponibiliza três formatos de apresentação da consulta, em forma de página

HTML, em XML e String.

24. Gera diariamente arquivo – RCB001 e CBR643 - com os dados relativos aos pagamentos

realizados;

25. Efetua a entrega do produto/serviço ao comprador;

(12)

a) Formulário – Pagamento

Variáveis de Envio do formulário – Pagamento: Comprador à Site do Banco

Enviar para URL: "https://www11.bb.com.br/site/mpag/"

Variável Tam Tipo Utilização Descrição

idConv 006 Num M Código do convênio de Comércio Eletrônico fornecido pelo Banco

valor 015 Num M Valor total da compra em reais, com centavos sem formatação.

exemplo: R$ 100,00 assume 10000

refTran 017 Num M Número atribuído e controlado pelo Convenente, que identifica o pedido de compra em todas as fases do processo de pagamento. A cada nova transação deverá ser gerado outro número refTran, não podendo ser reutilizado.

Caso possua convênio de cobrança vinculado ao convênio de Comércio Eletrônico, solicite o número desse convênio para sua agência e verifique:

- para convênio de Cobrança com seis posições as 17 posições são livres.

- para convênio de Cobrança com sete posições - numeração superior a 1000000 (um milhão) - informe CCCCCCCNNNNNNNNNN, onde:

"C" = número do convênio de cobrança "N" = número livre de controle do Convenente.

urlRetorno 060 Alfa M Complemento final para montagem da URL de retorno ao site da empresa.

Exemplo: “ /PgtoFinal.asp “

nome 060 Alfa MC Nome do comprador a ser apresentado no bloqueto de cobrança.

endereço 060 Alfa MC Endereço do comprador

cidade 018 Alfa MC Cidade do comprador

uf 002 Alfa MC Estado

cep 008 Num MC CEP

dtVenc 008 Num M Data de vencimento do pagamento no formado: DDMMAAAA

msgLoja 480 Alfa O Instruções do cedente a ser apresentada no bloqueto de cobrança

versão 003 Num M Versão da implementação. informar: 002

moeda 003 Num M Código da moeda utilizada no pagamento. informar:

986 – Real

convClasse 003 Num M Classificação do convênio. Informar: 001

tpPagamento 001 M Tipo de pagamento, assume: 0 - Todas as opções 2 - Bloqueto bancário 3 - Débito em conta corrente

Utilização (legenda):

M = mandatório para qualquer tipo de pagamento

MC = mandatório para tipo de pagamento por bloqueto bancário

O = opcional

(13)

Estrutura do formulário - Pagamento

<form action="https://www11.bb.com.br/si te/mpag/" method="post" name="pagamento"> <input type="hidden" name="idConv" value="<%= idConv %>">

<input type="hidden" name="valor" value="<%= valor %>"> <input type="hidden" name="refTran" value="<%= refTran %>"> <input type="hidden" name="urlRetorno" value="<%= urlRetorno %>"> <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="dtVenc" value="<%= dtVenc %>"> <input type="hidden" name="msgLoja" value="<%= textoLivre %>"> <input type="hidden" name="versao" value="002">

<input type="hidden" name="moeda " value="986"> <input type="hidden" name="convClasse " value="001"> <input type="hidden" name="tpPagamento" value= " "> </form>

b) Formulário - Notifica

Variáveis de Envio do formulário – Notifica: Site do Banco à Site da empresa

Convenente.

Enviar para URL: “página de retorno da Convenente cadastrada no Banco +

complemento”

Variáveis

Tam Tipo Utilização Descrição

refTran 017 Num M Número atribuído e controlado pelo Convenente, que identifica o pedido de compra em todas as fases do processo de pagamento. A cada nova transação deverá ser gerado outro número refTran, não podendo ser reutilizado.

Caso possua convênio de cobrança vinculado ao convênio de Comércio Eletrônico, solicite o número desse convênio para sua agência e verifique:

- para convênio de Cobrança com seis posições as 17 posições são livres.

- para convênio de Cobrança com sete posições - numeração superior a 1000000 (um milhão) - informe CCCCCCCNNNNNNNNNN, onde:

"C" = número do convênio de cobrança "N" = número livre de controle do Convenente.

idConv 006 Num M Código do convênio de Comércio Eletrônico fornecido pelo Banco

tpPagamento 001 M Informa qual tipo de pagamento utilizado, assume: 2 - Bloqueto bancário

3 - Débito em conta corrente

(14)

method="post" name="notifica">

<!-- Retorno de variáveis para Loja --> <input type="hidden" name="refTran" value=""> <input type="hidden" name="idConv" value=""> <input type="hidden" name="tpPagamento" value=""> </form>

(*) complemento é o conteúdo da variável “urlRetorno” obtida no formulário “pagamento”

c) Formulário - Sonda

Variáveis de envio do formulário – Sonda: Site da Convenente à Site do Banco

Observação: a consulta à situação do pagamento esta disponível apenas para os pagamentos realizados por Débito em conta.

Enviar para URL: “

https://www11.bb.com.br/site/mpag/REC3.jsp"

Variáveis

Tam Tipo Utilização Descrição

idConv 006 Num M Código do convênio de Comércio Eletrônico fornecido pelo Banco

refTran 017 Num M Número atribuído e controlado pelo Convenente, que identifica o pedido de compra em todas as fases do processo de pagamento. A cada nova transação deverá ser gerado outro número refTran, não podendo ser reutilizado.

Caso possua convênio de cobrança vinculado ao convênio de Comércio Eletrônico, solicite o número desse convênio para sua agência e verifique:

- para convênio de Cobrança com seis posições as 17 posições são livres.

- para convênio de Cobrança com sete posições - numeração superior a 1000000 (um milhão) - informe CCCCCCCNNNNNNNNNN, onde:

"C" = número do convênio de cobrança "N" = número livre de controle do Convenente.

valorSonda 015 Num M Valor da compra em reais, com centavos, sem formatação. Exemplo: R$100,00 assume 10000

formato 002 Num M Formato de retorno da apresentação da consulta assume:

01 = HTML – retorno visual em página do Banco para controle manual;

02 = XML – retorno em tag XML

03 = String – retorno em forma de String

Utilização (legenda):

M = mandatório

(15)

Estrutura do formulário - Sonda

<form action=" https://www11.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="valorSonda" value="<%= valor %>"> <input type="hidden" name="formato" value="">

</form>

Retorno da consulta situação do pagamento

Variáveis

Tam Tipo Utilização Descrição

refTran 017 Num M Número atribuído e controlado pelo Convenente, que identifica o pedido de compra em todas as fases do processo de pagamento. A cada nova transação deverá ser gerado outro número refTran, não podendo ser reutilizado.

Caso possua convênio de cobrança vinculado ao convênio de Comércio Eletrônico, solicite o número desse convênio para sua agência e verifique:

- para convênio de Cobrança com seis posições as 17 posições são livres.

- para convênio de Cobrança com sete posições - numeração superior a 1000000 (um milhão) - informe CCCCCCCNNNNNNNNNN, onde:

"C" = número do convênio de cobrança "N" = número livre de controle do Convenente.

valor 015 Num C Valor do pagamento, com centavos sem formatação. exemplo: R$ 100,00 assume 10000

idConv 006 Num M Código do convênio de Comércio Eletrônico fornecido pelo Banco

tpPagamento 001 Num M 2 - Bloqueto bancário 3 - Débito em conta corrente

situacao 002 Num M Indica situação do pagamento, assume: 00 = pagamento efetuado;

01 = pagamento não autorizado

02 = erro no processamento da consulta 03 = pagamento não localizado

10 = campo ”idConv” inválido ou nulo

11 = valor informado é inválido, nulo ou não confere com o valor registrado.

12 = campo “refTran” inválido ou nulo 99 = operação cancelada pelo cliente

dataPagame nto

008 Num C Data do lançamento contábil do pagamento, no formado DDMMAAAA

Utilização (legenda):

M = mandatório

C = condicional

(16)

<!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=""/> </FORMULARIO>

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>

Resposta em forma de String

String = aaaaaaaaaaaaaaaaa000000000000000bbbbbbcddeeeeeeee, onde:

Variáveis

Tam Tipo Descrição

aaaaaaaaaaaaaaaa a

(refTran)

017 Num Número atribuído e controlado pelo Convenente, que identifica o pedido de compra em todas as fases do processo de pagamento. A cada nova transação deverá ser gerado outro número refTran, não podendo ser reutilizado. Caso possua convênio de cobrança vinculado ao convênio de Comércio Eletrônico, solicite o número desse convênio para sua agência e verifique:

- para convênio de Cobrança com seis posições as 17 posições são livres.

- para convênio de Cobrança com sete posições - numeração superior a 1000000 (um milhão) - informe CCCCCCCNNNNNNNNNN, onde:

"C" = número do convênio de cobrança "N" = número livre de controle do Convenente.

000000000000000

(valor)

015 Num Valor do pagamento, com centavos sem formatação. exemplo: R$ 100,00 assume 10000

bbbbbb

(idConv)

006 Num Código do convênio de Comércio Eletrônico fornecido pelo Banco

c(tpPagamento) 001 Num 2 = Bloqueto Bancário 3 = Débito em conta corrente

dd

(situacao)

002 Num Indica situação do pagamento, assume: 00 = pagamento efetuado;

01 = pagamento não autorizado

02 = erro no processamento da consulta 03 = pagamento não localizado

99 = operação cancelada pelo cliente

eeeeeeee

(dataPagamento)

008 Num Data do lançamento contábil do pagamento, no formado DDMMAAAA

(17)

d) Formulário – Pagamento (segunda via de bloqueto de cobrança - opcional)

Variáveis de envio do formulário - Pagamento: Comprador --> site do Banco Enviar para URL: "https://www11.bb.com.br/site/mpag/"

Variáveis Tam Tipo Utilização Descrição

idConv 006 Num M Código do convênio de Comércio Eletrônico fornecido pelo Banco

valor 015 Num M Valor total da compra em reais, com centavos sem formatação

Exemplo: R$ 100,00 assume 10000

refTran 017 Num M Número atribuído e controlado pelo Convenente, que identifica o pedido de compra em todas as fases do processo de pagamento. A cada nova transação deverá ser gerado outro número refTran, não podendo ser reutilizado.

Caso possua convênio de cobrança vinculado ao convênio de Comércio Eletrônico, solicite o número desse convênio para sua agência e verifique:

- para convênio de Cobrança com seis posições as 17 posições são livres.

- para convênio de Cobrança com sete posições - numeração superior a 1000000 (um milhão) - informe CCCCCCCNNNNNNNNNN, onde:

"C" = número do convênio de cobrança "N" = número livre de controle do Convenente.

urlRetorno 060 Alfa M Complemento final para montagem da URL de retorno ao site da Convenente.

Exemplo: “ /PgtoFinal.asp “

nome 060 Alfa MC Nome do comprador a ser apresentado no bloqueto de cobrança.

endereço 060 Alfa MC Endereço do comprador

cidade 018 Alfa MC Cidade do comprador

uf 002 Alfa MC Estado

cep 008 Num MC Cep

dtVenc 008 Num M Data de vencimento do pagamento no formato: DDMMAAAA

msgLoja 480 Alfa O Instruções do cedente a ser apresentada no bloqueto de cobrança

versão 003 Num M Versão da implementação. informar: 002

moeda 003 Num M Código da moeda utilizada no pagamento. informar: 986 – Real

convClasse 003 Num M Classificação do convênio. Informar: 001

tpPagamento 001 Num M Tipo de pagamento, assume: 0 - Todas as opções

2 - Bloqueto Bancário 3 - Débito em conta corrente

(18)

MS = Mandatório somente para tipo de pagamento correspondente a segunda via de bloqueto bancário.

Exemplos:

- Quando se tratar de :

a) emissão de segunda via, informar tpPagamento = 21 b) todas as opções, informar tpPagamento = 0

c) bloqueto bancário, infomar tpPagamento = 2

d) débito em conta corrente, informar tpPagamento = 3 O = Opcional

Estrutura do formulário - Pagamento (2ª via de bloqueto de cobrança - opcional)

<form action="https://www11.bb.com.br/site/mpag/" method="post" name="pagamento"> <input type="hidden" name="idConv" value="<%= idConv %>">

<input type="hidden" name="valor" value="<%= valor %>"> <input type="hidden" name="refTran" value="<%= refTran %>"> <input type="hidden" name="urlRetorno" value="<%= urlRetorno %>"> <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="dtVenc" value="<%= dtVenc %>"> <input type="hidden" name="msgLoja" value="<%= textoLivre %>"> <input type="hidden" name="versao" value="002">

<input type="hidden" name="moeda" value="986"> <input type="hidden" name="convClasse" value="001"> <input type="hidden" name="tpPagamento" value="21"> </form>

3. LEIAUTES

a) Leiaute do arquivo de retorno – pagamentos (débito em conta)

HEADER DO ARQUIVO RETORNO – CÓDIGO DE REGISTRO A

Campo Posição Tipo Conteúdo

A1 01-01 X(001) Código do registro assume “A”

A2 02-02 9(001) Código de remessa assume 2 (retorno enviado pelo banco)

A3 03-08 9(006) Número do convênio A4 09-09 X(001) Uso futuro

A5 10-18 9(009) Seqüencial de retorno do IED –Intercâmbio Eletrônico de Dados

A6 19-22 X(005) Uso futuro

A7 23-42 X(020) Nome da empresa / órgão

A8 43-45 9(003) Código do banco na compensação interbancária A9 46-65 X(020) Nome do banco

A10 66-73 9(008) Data da geração do arquivo – formato AAAAMMDD A11 74-79 9(006) Número seqüencial do arquivo

A12 80-81 9(002) Versão do leiaute adotado pela Febraban para registro tipo G

A13 82-142 X(061) Reservado uso futuro

A14 143-150 X(008) No caso do comércio eletrônico, este campo se apresentará vazio.

(19)

DETALHE DO ARQUIVO RETORNO – CÓDIGO DE REGISTRO G

Campo Posição Tipo Conteúdo

G1 01-01 X(001) Código do registro assume “G” G2 02-05 9(004) Prefixo da agência creditada

G3 06-06 X(001) Digito verificador do prefixo da agência – módulo 11

G4 07-15 9(009) Número da conta corrente creditada

G5 16-16 X(001) Digito verificador do numero da conta corrente-módulo 11

G6 17-21 X(005) Uso futuro

G7 22-29 9(008) Data do pagamento - formato AAAAMMDD G8 30-37 9(008) Data do credito - formato AAAAMMDD

G9 38-81 X(044) Código de barra – vide especificação abaixo G10 82-93 9(010)v99 Valor recebido

G11 94-100 9(005)v99 Valor da tarifa

G12 101-108 9(008) Número seqüencial de registro G13 109-112 9(004) Prefixo da agencia recebedora G14 113-116 X(004) Uso futuro

G15 117-117 9(001) Forma de arrecadação: 1 - Caixa, 2 - Eletrônica, 3 - Internet

G16 118-140 X(023) Autenticação eletrônica

G17 141-141 9(001) Forma de recebimento: 1- Dinheiro, 2 – Cheque, 3 – Não identificada

G18 142-150 X(009) Uso futuro

Tipo (legenda):

X = conteúdo alfanumérico

9 = conteúdo numérico

DETALHE DO CAMPO G9 - CÓDIGO DE BARRAS

Campo Posição Tipo Conteúdo

G9.1 01-01 9(001) Código identificação do produto - assume 8 (arrecadação)

G9.2 02-02 9(001) Identificação do segmento e a forma de identificação da empresa/órgão – assume: 9 G9.3 03-03 9(001) Identificador do valor real ou referencia –

assume 6 (real)

G9.4 04-04 9(001) Digito verificador geral – modulo 10 G9.5 05-15 9(011) Valor em reais

G9.6 16-19 9(004) Código do Banco no sistema de compensação. Assume: 0001 G9.7 20-21 9(002) Preenchido com o valor ‘01’. G9.8 22-27 9(006) Código do convênio RCB

G9.9 28-44 9(017) Número do pedido (é o valor que foi atribuído a variável refTran gerado pelo conveniado)

(20)

Z1 01-01 X(001) Código do registro assume “Z”

Z2 02-07 9(006) Total de registros do arquivo, inclusive header e trailler

Z3 08-24 9(017) Valor total recebido dos registros do arquivo Z4 25-150 X(126) livre

Tipo (legenda):

X = conteúdo alfanumérico 9 = conteúdo numérico

b) Leiaute do arquivo de retorno – cobrança de títulos – CBR643

HEADER DO ARQUIVO RETORNO – CÓDIGO DE REGISTRO

Campo Posição Tipo Conteúdo

H1 001-001 9(001) Assume: 0 (zero) H2 002-002 9(001) Assume: 2 (dois) H3 003-009 X(007) Assume: RETORNO H4 010-011 9(002) Assume: 01 H5 012-019 X(008) Assume: COBRANCA H6 020-026 X(007) Uso futuro

H7 027-030 9(004) Prefixo da agência de relacionamento do Convenente

H8 031-031 X(001) Digito verificador do prefixo da agência de relacionamento

H9 032-039 9(008) Código do Cedente

H10 040-040 X(001) Digito verificador do código do Cedente H11 041-046 9(006) Número do Convenente líder

H12 047-076 X(030) Nome da Empresa Convenente H13 077-094 X(018) Assume: 001BANCO DO BRASIL

H14 095-100 9(006) Data da gravação do arquivo no formado DDMMAA H15 101-107 9(007) Número seqüencial de retorno

H16 108-394 X(287) Uso futuro H17 395-400 9(006) Assume: 000001

Tipo (legenda):

X = conteúdo alfanumérico

9 = conteúdo numérico

DETALHE DO ARQUIVO RETORNO – CÓDIGO DE REGISTRO D

Campo Posição Tipo Conteúdo

D1 001-001 9(001) Assume: 1 (um) D2 002-003 9(002) Assume: 00 (zeros) D3 004-017 9(014) Assume: 000... (zeros)

D4 018-021 9(004) Prefixo da agência de relacionamento do Convenente

D5 022-022 X(001) Digito verificador do prefixo da agência de relacionamento

D6 023-030 9(008) Código do Cedente

D7 031-031 X(001) Dígito verificador do código do Cedente D8 032-037 9(006) Número do Convênio

D9 038-062 X(025) Campo de controle do participante D10 063-073 9(011) Assume: 000... (zeros)

(21)

D12 075-085 X(011) Uso futuro

D13 086-088 9(003) Variação da carteira de cobrança D14 089-106 X(018) Uso Futuro

D15 107-108 9(002) Número da carteira de cobrança

D16 109-110 9(002) Assume: 06=liquidação normal, 07=liquidação por conta, 08=liquidação por saldo, 15=liquidação em cartório

D17 111-116 9(006) Data da liquidação no formato DDMMAA D18 117-152 X(036) Uso futuro

D19 153-165 9(11)V99 Valor do título D20 166-168 9(003) Assume: 001

D21 169-172 9(004) Prefixo da agência recebedora

D22 173-173 X(001) Dígito verificador do prefixo da agência recebedora D23 174-175 9(002) Uso futuro

D24 176-181 9(006) Data do crédito no formato DDMMAA D25 182-188 9(05)V99 Valor da tarifa D26 189-201 9(11)V99 Outras despesas D27 202-227 9(026) Assume: 000...(zeros) D28 228-240 9(11)V99 Valor do abatimento D29 241-253 9(11)V99 Desconto concedido D30 254-266 9(11)V99 Valor recebido D31 267-279 9(11)V99 Juros de mora D32 280-292 9(11)V99 Outros recebimentos D33 293-305 9(11)V99 Assume: 000... (zeros) D34 306-318 9(11)V99 Valor do lançamento

D35 319-319 9(001) Indicativo de débito/crédito, assume: 0=sem lançamento, 1=débito, 2=crédito

D36 320-394 X(075) Uso futuro

D37 395-400 9(006) Número seqüencial de registro

DETAL HE DO CAMPO D9 - Campo de controle do participante

Campo Posição Tipo Conteúdo

D9.1 01-02 9(002) Assume: 21 D9.2 03-08 X(006) Assume: brancos

D9.3 09-25 9(017) Numero do pedido (é o valor que foi atribuído a variável refTran gerado pelo cedente)

Tipo (legenda):

X = conteúdo alfanumérico

9 = conteúdo numérico

TRAILLER DO ARQUIVO RETORNO – CÓDIGO DE REGISTRO T

Campo Posição Tipo Conteúdo

T1 001-001 9(001) Assume: 9 (nove) T2 002-002 9(001) Assume: 2 (dois) T3 003-004 9(002) Assume: 01 (um)

T4 005-007 9(003) Número do Banco Assume: 001 T5 008-394 X(386) Filler

(22)

Motivo da atualização: Alteração do texto de Descrição da variável "refTran" e outros ajustes redacionais

Atualização número: 010 Data de publicação: 09.07.2004

Motivo da atualização: Ajustes redacionais. Atualização número: 009

Data de publicação: 14.06.2004

Motivo da atualização: Alteração da Descrição da variável "refTran" e outros ajustes redacionais. Atualização número: 008

Data de publicação: 27.02.2003

Motivo da atualização: Correção na página 19 do detalhe do campo G9 – CÓDIGO DE BARRAS Atualização número: 007

Data de publicação: 29.11.2002

Motivo da atualização: - Inclusão da configuração de 2ª via de bloqueto de cobrança - Alterações redacionais

Atualização número: 006 Data de publicação: 13.11.2002

Motivo da atualização: Alteração do refTran de 12 posições para 17 posições no servidor www11 Atualização número: 005

Data de publicação: 13.05.2002

Motivo da atualização: Alteração no nome do Manual e inclusão do telefone do Suporte Técnico Atualização número: 004

Data de publicação: 13.12.2001

Motivo da atualização: Alteração do endereço de envio do formulário de pagamento e da Sonda. Inclusão do débito em conta para Pessoa Jurídica, e novo formato de retorno da sonda.

Atualização número: 003 Data de publicação: 09.04.2001

Motivo da atualização: Permite que o tamanho da variável refTran seja de 17 posições, quando a opção de pagamento for por bloqueto bancário (tpPagamento = 2). Somente disponibilizado para transações que apontem para o servidor do www10. Atualização número: 002

Data de publicação: 12.03.2001

Motivo da atualização: Retorno da sonda – consulta situação do pagamento, em formato XML; Alteração na sistemática de montagem na url da página de retorno ao site da Convenente;

Alteração do leiaute do bloqueto bancário. Atualização número: 001

Data de publicação: 15.12.2000

Motivo da atualização: Alteração da URL para postagem do formulário de pagamento e consulta pagamento.

Observações: É necessário que a empresa direcione a postagem do formulário para o novo endereço (www10.bancodobrasil.com.br/bbscr/mpag/bbpag.asp) para pagamentos e o endereço

(www10.bancodobrasil.com.br/bbscr/mpag/sondaLoj.asp) para consultas a pagamentos.

Referências

Documentos relacionados

Cartão de Identificação do Candidato a ser disponibilizado no endereço eletrônico do PRÓ-MUNICÍPIO http://www.promunicipio.com, na data prevista no cronograma do processo

A combinação dessas dimensões resulta em quatro classes de abordagem comunicativa, que podem ser exemplificadas da seguinte forma: interativo/dialógico: professor e

(2008), o cuidado está intimamente ligado ao conforto e este não está apenas ligado ao ambiente externo, mas também ao interior das pessoas envolvidas, seus

5 “A Teoria Pura do Direito é uma teoria do Direito positivo – do Direito positivo em geral, não de uma ordem jurídica especial” (KELSEN, Teoria pura do direito, p..

Garantias: (i) Regime Fiduciário constituído sobre os créditos correspondentes a 41,6666% de 50% dos valores decorrentes dos Contratos de Compra e Venda através

Deste modo, o autor defende que as estruturas sociais são, ao mesmo tempo, condicionadas e condicionantes das ações; enquanto os indivíduos se apresentam como

Um teste utilizando observa¸c˜ oes de fra¸c˜ ao de massa do g´ as de aglomerados de ga- l´ axias e SNe Ia foi proposto por Gon¸calves, Holanda e Alcaniz (2012)[ 41 ]. Eles

One of the main strengths in this library is that the system designer has a great flexibility to specify the controller architecture that best fits the design goals, ranging from