Utilizando a API do MAMBOLETO 2.0 RC1

Escrito por Fernando Soares

Ter, 01 de Maio de 2007 00:19

Para utilizar este componente no Frontend:

1 - Passe os valores (pode ser por formulário, pela url, por sessão.. tanto faz) correspondentes a cada campo do boleto (veja a lista abaixo).

2 - Certifique-se de que está chamando este componente numa nova janela (index2.php?option=com_mamboleto&no_html=0) e que todos os parâmetros estão sendo passados.

-Lista dos valores que podem ser passados para o MamboletoJoomla 2.0 RC1:

* Estrutura dos parâmetros que devem ser passados ao método:

Parâmetro		Tipo		Descrição		Valor padrão
vencimento	=>	data	=>	a data de vencimento do boleto bancário (dd/mm/aaaa)	=>	Data atual + 7 dias
nosso_numero	=>	numérico	=>	seu número de controle do documento	=>	0
numero_documento	=>	numérico	=>	número do documento ou do pedido	=>	0
data_documento	=>	data	=>	a data de emissão do documento ou do pedido (dd/mm/aaaa)	=>	Data atual
valor_documento	=>	numérico	=>	valor do documento (xxx,xx ou xxx.xx)	=>	0
id	=>	numérico	=>	id do boleto a ser emitido: 3 -> Bradesco 4 -> Santander 5 -> Caixa Econ.Federal 6 -> Banco do Brasil 7 -> Itaú 8 -> Banrisul	=>	6 (Banco do Brasil)
sacado	=>	alfa-numérico	=>	o nome do sacado	=>	o dizer: "Não informado"
	=>	alfa-numérico	=>	o endereço do sacado	=>	- (vazio)
	=>	numérico	=>	o cgc ou cpf do sacado	=>	- (vazio)

* Parâmetros necessários somente para o envio do boleto por email:

Parâmetro		Tipo		Descrição		Valor padrão
boletomail	=>	numérico	=>	ativa ou desativa o envio de e-mail com o boleto bancário: 1 -> para ativa 0 -> para desativa	=>	0 (desativado)
recipiente_email	=>	alfa-numérico	=>	e-mail do destinatário	=>	- (vazio)
assunto	=>	alfa-numérico	=>	a linha de assunto do e-mail com o boleto bancário	=>	- (vazio)

* Parâmetros opcionais que normalmente são gravados no banco de dados:

Parâmetro		Tipo		Descrição		Valor padrão
instrucoes_linha1	=>	alfa-numérico	=>	Linha 1 das instruções do boleto	=>	definido na configuração do boleto
instrucoes_linha2	=>	alfa-numérico	=>	Linha 2 das instruções do boleto	=>	definido na configuração do boleto
instrucoes_linha3	=>	alfa-numérico	=>	Linha 3 das instruções do boleto	=>	definido na configuração do boleto
instrucoes_linha4	=>	alfa-numérico	=>	Linha 4 das instruções do boleto	=>	definido na configuração do boleto
instrucoes_linha5	=>	alfa-numérico	=>	Linha 5 das instruções do boleto	=>	definido na configuração do boleto
demons1	=>	alfa-numérico	=>	Linha 1 do demonstrativo do boleto	=>	definido na configuração do boleto
demons2	=>	alfa-numérico	=>	Linha 2 do demonstrativo do boleto	=>	definido na configuração do boleto
demons3	=>	alfa-numérico	=>	Linha 3 do demonstrativo do boleto	=>	definido na configuração do boleto
demons4	=>	alfa-numérico	=>	Linha 4 do demonstrativo do boleto	=>	definido na configuração do boleto

* Parâmetros normalmente não necessários:

Parâmetro		Tipo		Descrição		Valor padrão
acrescimos	=>	numérico	=>	o valor dos acréscimos	=>	- (vazio)
valor_cobrado	=>	numérico	=>	o valor total cobrado pelo boleto	=>	- (vazio)
data_processamento	=>	data	=>	a data do processamento do boleto	=>	Data do documento
especificacao_moeda	=>	alfa-numérico	=>	Símbolo da moeda a usar	=>	a expressão "R$"
quantidade	=>	numérico	=>	a quantidade da moeda a usar	=>	- (vazio)
valor_moeda	=>	numérico	=>	o valor da cotação da moeda a usar	=>	- (vazio)
descontos	=>	numérico	=>	o valor total dos descontos	=>	- (vazio)
deducoes	=>	numérico	=>	o valor total das deduções	=>	- (vazio)
multa	=>	numérico	=>	o valor total da multa	=>	- (vazio)

Exemplo de utilização:

http://seu.site.com.br/index2.php?option=com_mamboleto&no_html=0&vencimento=20/07/2007

&nosso_numero=961580786&numero_documento=123&data_documento=16/07/2007

&valor_documento=1250,00&id=6&sacado=Nome&endereco=Endereço

Última atualização em Dom, 29 de Julho de 2007 14:25