Você está na página 1de 12

Mamboleto 2.

0 RC2

Manual Bsico

Verso 1.0

1. Instalao Para comear voc deve baixar o pacote do Mamboleto do site http://www.fernandosoares.com.br/ ou de outro site onde estiver disponvel para download como http://www.joomla.com.br/. O nome do pacote pode variar de acordo com a verso baixada porm para fins de exemplificao aqui neste manual vou adotar a verso atual que a 2.0 RC2 e ento teremos um arquivo com o nome abaixo: mamboletojoomla_2-0_rc2.zip Bom, este arquivo o pacote que contm os demais arquivos do Mamboleto 2.0 RC2, sendo eles: leiame.txt mamboleto_2-0_rc2.zip mamboleto_virtuemart_payment_6-0 Arquivo com informaes e instrues bsicas necessrias para o uso do Mamboleto. Este o arquivo compactado do componente e este arquivo que deve ser usado na instalao. Contm os arquivos do mtodo (mdulo) de pagamento Boleto Bancrio para ser implementado no Virtuemart e assim possibilitar o uso do boleto de um banco. Contm os arquivos do mtodo (mdulo) de pagamento Boleto Multi-Banco para ser implementado no Virtuemart e assim possibilitar o uso do boleto de mais de um banco.

mamboleto_virtuemart_payment_multi_6-0

Entendido isso, descompacte o arquivo mamboletojoomla_2-0_rc2.zip em um diretrio qualquer. Ex.: C:\temp Ento acesse seu Joomla! Atravs da interface de administrao e v ao menu Installers (Instaladores) e selecione Components (Componentes) (Fig.1). Ento surgir uma tela como a da imagem abaixo.(Fig.2)

Fig.2

Fig.1

Procure e selecione o arquivo mamboleto_2.0_rc2.zip e ento clique no boto Upload File & Install (Carregar arquivo e instalar).

1.1. Configurao da Integrao A integrao com o Joomla feita de forma automtica e transparente durante o processo de instalao. Apesar disso pode ser necessrio uma interveno manual em alguns casos como, por exemplo, quando voc faz a instalao em um servidor e depois migra para outro. Para estes casos h no menu do Mamboleto a opo Configuraes Gerais onde possvel acessar e modificar as configuraes de conexo com o banco de dados utilizado. Voc acessa esta configurao clicando no menu Components do Joomla e em seguida no Mamboleto que aparecer neste menu. Aps voc clica em Configuraes Personalizadas e se for modificar algo clica no boto Modificar Configurao.(Fig.3)

Fig.3 Nesta tela ( direita) h como configurar o tipo de banco de dados a usar (MySQL,...), o endereo do servidor do banco de dados e tambm o nome do banco de dados e seus respectivos nome de usurio e senha. Aps realizar estas configuraes s clicar no boto Salvar Configuraes. ATENO: Lembre-se que estas configuraes so crticas para o correto funcionamento do componente portanto no altere absolutamente nada aqui se no tiver absoluta certeza do que est fazendo.

2. Configurao dos Boletos Antes de comearmos a configurao e teste dos boletos preciso esclarecermos um pouco sobre o funcionamento da cobrana via boletos bancrios. Bom, a primeira coisa a ser entendia que no adianta simplesmente colocar o nmero de sua agncia e conta e sair gerando e imprimindo boletos bancrios. Isso porque a cobrana via boleto bancrio precisa de um contrato firmado entre voc e o banco, ou bancos, que voc ir utilizar para a gerao dos boletos. Assim voc deve firmar um contrato de cobrana com seu banco e ento receber um nmero de cedente ou nmero de convnio. Normalmente ser utilizada a cobrana sem registro para as operaes com o Mamboleto por permitir custos menores e a emisso total da cobrana pelo cliente, ou seja, voc emite os boletos e gerencia seu envio/entrega e recebimento. Entendido estes pontos podemos passar configurao dos boletos. Para isso acesse o Mamboleto no menu Components > Mamboleto e depois no menu principal do Mamboleto(Fig.4) clique no Icone Administrar Boletos. Ento ser apresentada a listagem de boletos disponveis como visto na figura abaixo(Fig.5).

Fig.4

Fig.5 Nesta tela (Fig.5) voc deve escolher na coluna Ttulo do Boleto o boleto a ser configurado e clicar nele. Para fins de exemplificao vou utilizar aqui o Boleto BB que o boleto do Banco do Brasil. 4

Logo, ao clicar em Boleto BB da coluna Ttulo do Boleto da tela representada na figura 5 voc ser encaminhado para a tela de configurao do boleto bancrio do Banco do Brasil representada abaixo(Fig.6).

Todos os boletos que hoje esto disponveis e os demais que venham a ser disponibilizados no futuro faro uso desta tela para sua configurao.

Em Dados do Banco no preciso alterar nada pois j est tudo certo. Contudo vou explanar um pouco sobre o bvio:

Ttulo do Boleto o nome dado a este boleto dentro do Mamboleto. Voc s precisar alterar este nome se acrescentar um novo boleto do mesmo banco com uma configurao diferente por exemplo. Banco o banco que ser usado para gerar este boleto. Configurao Personalizada onde voc define qual configurao personalizada ir utilizar para este boleto. Este tema ser abordado mais adiante neste manual.

Bom, vamos ao que realmente interessa aqui que so os Dados da Conta e os Dados do Boleto onde vamos comear entrando com os dados da conta. No h dvidas aqui uma vez que tudo bem simples, ou seja, em Agncia / Conta do Cedente voc tem quatro campos a serem preenchidos respectivamente com o nmero da agncia, dgito verificador do nmero da agncia, nmero da conta corrente (ou conta do cedente) e dgito verificador do nmero da conta corrente (ou conta do cedente). Caso voc no tenha o dgito verificador do nmero da agncia ou do nmero da conta corrente (ou conta do cedente) deixe em branco ou consulte seu banco. Exemplo: Dados da Conta Corrente Agncia: 0180-5 Conta: 35835-1 Preenchimento dos campos [ 180] [ 5] / [ 35835] - [ 1]

Agora em Carteira / Convnio voc tem dois campos a serem preenchidos com os dados referentes a seu contrato de cobrana e que so fornecidos pelo banco. Normalmente voc ir utilizar a cobrana sem registro, ou cobrana simples de acordo com a denominao de cada banco. Para a maioria boletos ser necessrio alterar somente o nmero do convnio que em alguns casos dever incluir o dgito verificador do mesmo. Exemplo: Dados da Cobrana Carteira: 18 Convnio: 068955 Preenchimento dos campos [ 18] / [ 68955]

Note que os zeros frente dos nmeros devem ser ignorados como nos exemplos acima.

Fig.6 Passamos agora para a parte da tela onde temos Dados do Boleto. Nesta parte podemos configurar algumas opes especficas do boleto como a Espcie de Documento e o Cedente. Em Espcie de Documento normalmente temos a sigla DM que significa Duplicata Mercantil mas tambm podemos ter outras siglas como REC (Recibo), FT (Fatura) e outras tantas. Voc deve verificar com seu banco quais so os tipos de siglas aceitos para seu contrato de cobrana. O campo Cdigo deve ser deixado com o valor 1 para quase todos os boletos pois serve apenas para selecionar o tipo de configurao do boleto. Atualmente s h um caso de boleto em que este campo deve ser modificado para um valor diferente de 1 (um) porm isso tratarei na forma de uma tabela de configuraes possveis para os boletos mais adiante neste manual. J no campo Cedente voc dever informar o nome da sua empresa, ou seu nome, conforme seu contrato de cobrana com o banco. Se voc fez o contrato de cobrana em nome de sua empresa ento informe sua razo social neste campo. Exemplo: Empresa de Laminados Ltda. Por outro lado, h bancos que fazem contratos de cobrana para pessoas fsicas e neste caso voc informar neste campo seu nome ou nome da pessoa fsica que possui o contrato de cobrana firmado com o banco. Exemplo: Jos Silvander de Aquino. Feito isso chegamos ento ao campo Local de Pagamento onde, como o nome j diz, devemos informar o local para pagamento do boleto bancrio. Neste campo sugiro que seja mantida a frase que j vem setada no Mamboleto (At o vencimento em qualquer agncia bancria ou lotrica.). Nos campos de Instrues para Pagamento informe os dados que julgar relevantes para o caixa do banco ou agncia lotrica que ir receber o pagamento deste boleto. Exemplo: Aps o vencimento cobrar multa de R$5,00 e R$ 1,56 de juros por dia de atraso. Finalmente no ltimo campo de Dados do Demonstrativo voc pode informar dados relevantes ao cliente como por exemplo o nmero da nota fiscal ou do pedido de compra, uma oferta ou propaganda ou tambm o produto que o cliente est adquirindo. Por fim no esquea de clicar no boto SALVAR ou seu trabalho at aqui estar perdido.

3. Configuraes Personalizadas As Configuraes Personalizadas permitem que voc defina algumas personalizaes que se tornaro disponveis para uso com qualquer dos boletos configurados. Por exemplo, voc pode configurar o boleto do banco Real usando o logotipo de sua empresa X e o boleto do banco Ita usando o logotipo de sua empresa Y. O Mamboleto j vem com uma configurao personalizada definida que tem o nome de Mamboleto porm nada impede que voc crie outras. Primeiramente vamos ver como configurar esta Configurao Personalizada que j vem com o Mamboleto. Bom, vamos l... na administrao do Joomla v ao menu Components (componentes) e depois em Mamboleto. Ento clique no cone Configuraes Personalizadas e voc ter uma tela(Fig.7) com a lista das configuraes personalizadas disponveis. Agora nesta tela clique no ttulo da configurao personalizada que deseja editar, no nosso caso, Mamboleto.

Fig.7 Logo voc ter a tela abaixo (Fig.8) onde ser possvel definir o Ttulo para esta configurao personalizada. Aqui tambm possvel habilitar ou desabilitar a opo de envio de e-mails com o boleto bancrio bem como configurar a linha de assunto deste e-mail que ser enviado. Por ltimo h como definir o caminho para uma imagem ou logotipo que ser exibida no recibo do sacado no topo do boleto. Caso esta imagem esteja em seu prprio site bastar colocar o caminho a partir da raiz como visto na figura abaixo que o Mamboleto o reconhecer como sendo local. Por outro lado voc tambm pode especificar uma URL completa onde esteja a imagem que voc vai utilizar, como, por exemplo, http://www.site.com.br/imagens/logotipo.jpg. Procure usar imagens com tamanho mximo de 160 x 40 pixels (Largura x Altura) para evitar a deformao do boleto. Ao final no esquea de clicar no boto Salvar.

Fig.8 7

Entendidos estes passos de configurao fica mais fcil de voc criar uma nova configurao personalizada. E para isso acesse as Configuraes Personalizadas e voc notar que na parte inferior desta tela (Fig.7) que lista de configuraes personalizadas h um boto para criar uma nova configurao denominado Nova Configurao Personalizada. Clique neste boto e voc ter uma tela como a da Fig.8 porm com todos os campos em branco. Agora, ento, voc preenche os campos com os dados relevantes e clica no boto Salvar. No esquea de dar um nome(ttulo) diferente esta nova configurao personalizada. Pronto, voc criou uma nova configurao personalizada que estar disponvel para seleo na tela de configurao dos boletos (Fig.6) em Configurao Personalizada (Fig.9).

Fig.9

4. Teste dos boletos Finalizadas todas as configuraes podemos passar a testar os boletos. Isso feito acessando a tela de configurao dos boletos (Fig.5) e nesta tela voc pode notar que h uma opo esquerda chamada Revisar Boleto (Fig.10). Clique nesta opo.

Fig.10 Ao clicar na opo Revisar Boleto voc ter uma outra tela (Fig.11) onde possvel entrar com algumas opes para testar os boletos. Alguns campos j esto preenchidos com valores padro para teste mas voc pode alter-los como quiser. Bem na parte inferior desta tela h um campo vazio chamado Email do Destinatrio e neste campo voc pode digitar seu e-mail para receber o boleto e verificar seu funcionamento. Mas ateno, para que o envio por e-mail funcione voc precisa ter ativado esta opo na configurao personalizada utilizada para o boleto em questo. Isso pode ser verificado logo acima do campo Email do Destinatrio em Mandar boleto por Email que dever estar como Sim.

Fig.11 Terminadas as alteraes s clicar no boto Gerar Boleto >>> e voc ter o boleto (Fig.12). 9

Fig.12 Para voltar tela de reviso de boleto s clicar no link Voltar para Revisar Boleto que fica aps o cdigo de barras do boleto bem na parte inferior da tela.

10

5. Tabela de Boletos Boleto Banco Carteira Convnio ESP. Boleto HSBC HSBC CNR COB -Nosso nmero 8 dg -Cobcaixa -Pode pessoa fsica -Nosso nmero 9 dg Cd Tipo 1 2 1 1 1 1 Sem Registro Com Registro Sem Registro Sem Registro Sem Registro Carteira Sem Registro / Eletrnica Carteira Rpida Sem Registro

Boleto Unibanco Unibanco

Boleto Bradesco Bradesco Boleto Santander Santander Banespa Boleto CEF Caixa Econmica SR Federal CR Boleto BB Banco do Brasil

1 1

12, 17 e 4 dgitos 18 6 dgitos 7 dgitos 8 dgitos 16 e 18

6 dgitos com nosso 2 nmero de 17 posies. 1

Sem Registro Sem Registro

Boleto Ita

Banco Ita S.A.

126, 131, 146, 150, 168, 174, 175 106, 107, 122, 142, 143, 195, 196, 198

Obs.: Nosso nmero de 1 15 posies = 8 posies do nosso nmero + 7 posies do seu nmero (nmero do documento). 1 1 1

Sem Registro

Boleto Banrisul Boleto Real

Banrisul Banco Real

Sem Registro Sem Registro Sem Registro

Boleto Mercantil Mercantil do Brasil

11

6. Consideraes Finais

No me responsabilizo por qualquer dano que o uso indevido e/ou indiscriminado deste software possa causar. Todos os boletos foram desenvolvidos com base em manuais fornecidos pelos prprios bancos. Os boletos podem conter erros e devem ser enviados para testes junto ao banco antes de seu efetivo uso. Relatem os sucessos e falhas nos boletos atravs do menu CONTATO no site http://www.fernandosoares.com.br/. Ao relatar o sucesso no uso de um boleto por favor envie junto todos os dados como, por exemplo: banco, tamanho do convnio (6 dgitos, 7 dgitos...), carteira, tipo de cobrana, etc... Assim podemos certificar um a um os boletos. Ao relatar uma falha informe o mximo de detalhes possvel. Muitos bancos informam o que est incorreto no boleto. Se puder ajudar faa uma doao atravs do link PagSeguro existente no site no menu CONTATO.

12