Introdução:
Este documento é direcionado aos novos usuários BoletoMail e contem todas as instruções de utilização dos nossos sistemas.
Em caso de duvidas adicionais, contate atendimento@boletomail.com.br

Conteúdo deste Documento:

1. Como gerar os boletos?
1.1 Gerando Boletos através do Formulário.
1.2 Gerando Boletos on-line através da URL.
1.3 Sua pequena loja virtual emitindo boletos através do sistema BOLETOSTORE.
1.4 Enviando Boletos pela planilha Excel (BATCH).
1.5 Gerando boletos pela sua lista de clientes.

2. Como consultar os boletos gerados?


3. Monitoração dos boletos enviados via email.
3.1 Monitoração de problemas na entrega
3.2 Monitoração do recebimento de seus BoletoMails

CRÉDITOS



1. Como gerar os Boletos?
Existem 4 formas de se gerar boletos no nosso sistema, são elas:

1.1 Gerando Boletos através do Formulário.

Visite http://www.boletomail.com.br/ e digite seu user e senha;

A primeira tela a aparecer é o formulário onde voce deverá digitar os dados do boleto.


Os seguintes campos são de preenchimento obrigatorio:

data de vencimento
valor
nome
email,
nosso numero

DICA: Para gerar um boleto com data de vencimento "contra-apresentacao", deixe dia, mes e ano do vencimento em branco.

Em caso de necessidade, voce pode preencher os campos: sacador, quantidade, moeda

Atenção para os seguintes pontos:
Todos os campos ao lado são opcionais.


Atenção para os seguintes pontos:


Após preencher os dados do formulário, clique em GERAR BOLETO





1.2 Gerando Boletos on-line através da URL.

Se voce deseja que seus clientes possam gerar seus boletos on-line, voce deverá gerar uma URL como o exemplo abaixo:

http://www.boletomail.com.br/do.php?v_dia=15&v_mes=11&v_ano=2000&valor=115,98
&nossonum=12869888&nome=Roberto+M.+S.+Ferraz&action=1&user=vamonessa


Os dados tais como valor, vencimento, devem ser gerados dinamicamente pelo seu site.
Para isso você deverá ter programadores em sua empresa. Nossa consultoria, VERIX (http://www.verix.com.br/) terá um grande prazer em ajudá-lo nesta etapa.

Para as instruções completas de como gerar a URL para o BoletoMail, vá para http:www.boletomail.com.br/manual.htm

Caso você deseje gerar boletos on-line de uma forma mais simplificada, vá para o item 1.3.


1.3 Sua pequena loja virtual emitindo boletos através do sistema BOLETOSTORE.

Se você tem um site que disponibiliza alguns produtos para venda , utilize esse sistema que permite que seus clientes comprem, gerem e emitam seus próprios boletos, podendo imprimi-los e paga-los em qualquer agência bancária ou pelo bankline desejado, pois o boleto vai para o e-mail do cliente.

 

Para facilitar o seu entendimento, clique no link do SITE-EXEMPLO abaixo que foi feito utilizando o sistema BOLETOSTORE:

www.boletomail.com.br/boletostore

Procedimentos:

a) Você deve configurar sua página HTML de compra, com os devidos produtos de sua empresa, com foto, descrição ao seu gosto e com um botão ou link de compra, que é o único item a ser inserido obrigatóriamente,sendo melhor detalhado adiante,

b) Quando sua conta conosco já estiver pronta, entre com seu usuário e senha e clik no link 'boletostore'. Lá você encontrará uma tabela com produtos à inserir:





DICA: Para informar seus clientes que há uma promoção de um determinado produto escreva ao lado dele (na tabela) o seguinte texto:
NOME DO PRODUTO - <b>PROMOÇÃO</b>,
E para colocar uma figura na tabela utilize este texto:
<img src="ENDEREÇO DA IMAGEM"><BR>NOME DO PRODUTO

 

c) Após inserir seus produtos na tabela, e salvar, vá até o final da página, lá você encontrará um link, que deverá estar vinculado ao botão ou o link de compra do seu site:


No lugar de username=vamonessa terá : username=SEU NOME DE USUÁRIO

APÓS ESSE PROCEDIMENTO NÃO SERÁ NECESSÁRIO MAIS NENHUMA MODIFICAÇÃO EM SEU SITE.

d) Quando o seu cliente clicar neste link na sua página, abrirá uma página da boletomail, com todos os seus produtos, que você inseriu, ele irá escolher os produtos, e o sistema somará o valor total automaticamente, e logo abaixo terá um formulário onde o cliente irá preencher com : Nome,endereço, telefone, e-mail, etc:

e) Assim que o cliente clicar em 'comprar' aparecerá uma tabela com os dados da compra, e um botão para confirmação de compra, quando a compra estiver confirmada surgirá um boleto, que ele pode imprimir na hora, ou então ver pelo seu e-mail.

f) Logo depois do seu cliente confirmar a compra, você receberá um e-mail informando o nome do cliente, a data e a hora que a compra foi efetuada:


Para personalizar a aparência da sua página de compras consulte este guia.

1.4 Enviando Boletos pela planilha Excel (BATCH).

Se voce cobra mensalidades de seus clientes e todo mes (ou toda semana) manda uma grande quantidade de boletos, voce pode economizar seu tempo digitando-os numa planilha Excel.

A vantagem disso é que voce não precisa estar on-line para digitar os boletos, os dados de cobrança mudam pouco, então todo mes voce pode utilizar praticamente a mesma planilha.

INICIANDO:
Para utilizar este meio, abra o arquivo boletomail.xls.

Na planilha estão presentes 2 linhas-exemplo com os dados de 2 boleto fictícios. Observe o formato dos dados destes 2 boletos-exemplo, e apague essas 2 linhas.

INSERINDO SEUS BOLETOS:
A cada linha na planilha corresponde um boleto que será enviado via email.


Os dados com cor verde (Nossonum, valor, nome, email, data de vencimento) DEVEM SER PREENCHIDOS.

Os dados em rosa (Codigo do cliente, cod_conf, instrucoes, data do documento, data do processamento) são opcionais.

A seguir, a descrição de cada campo:
Campos obrigatórios
Nossonum é o nosso numero do boleto - deve ser digitado SEM o digito-verificador. Por exemplo, se o nosso numero nos seu boleto aparece como 00003421-2, ele deve ser digitado como 3421 (e não 3421-2). Se você tem a opção de numeração automática no BoletoMail, este campo deve conter o numero 0 (zero). IMPORTANTE: O nosso número deve ser único para cada boleto. No caso de repetição, haverá problemas para identificar o sacado.
Valor valor do boleto
Nome Nome do sacado. No caso de se desejar colocar o endereço, digitar assim: Jose da Silva<BR> Rua das pedras, 25 - JD S Carlos - Sao Paulo - SP - 01111-111
email email do sacado. (ex: jose@uxl.com.br)
data de vencimento o ano de vencimento deve ser digitado com 4 digitos (digitar 2001 e não 01)

Campos Opcionais
Codigo do cliente É o código que identifica o sacado na sua empresa. (p.ex. 1001-2, 34A, etc) Ao informar o codigo do cliente você facilita seu trabalho quando for dar baixa nos boletos. O codigo do cliente aparecerá no histórico do BoletoMail, e também é possível localizar um boleto através do Código do cliente.
cod_conf É o código de configuração no Boletomail. Normalmente deve conter o numero 0 (zero). Só deve ser preenchido por outro codigo para clientes que possuem mais de uma configuração no Boletomail.
Instruções Instruções do cedente. Se for deixado em branco, serão utilizadas as instruções padrão que foram configuradas no BoletoMai
data do documento o ano deve ser digitado com 4 digitos (digitar 2001 e não 01)
data de processamento o ano deve ser digitado com 4 digitos (digitar 2001 e não 01)

EXPORTANDO OS DADOS:
Ao terminar de digitar os dados do boleto, voce deve ir em:


[arquivo] [salvar como] [salvar_como tipo:] [texto (separado por tabulações) *.txt] ->informe o nome do arquivo
[salvar]


Deseja manter a pasta de trabalho neste formato? [sim]

Vá para http://www.boletomail.com.br/ digite seu nome de usuário e senha, clique em BATCH

Clique em [browse] (ou [procurar]) e selecione o arquivo que voce acabou de salvar.
Preencha seu email e clique em [executar batch] e AGUARDE.

Haverá um periodo de inatividade, tanto maior quanto mais boletos estiverem no arquivo, isto é normal.

Após, deverá aparecer uma nova tela, neste instante você já pode sair do BoletoMail.
Os boletos constantes no arquivo serão enviados via email aos seus clientes.

Voce receberá um email quando todos os boletos tiverem sido enviados, e será avisado de eventuais erros.

Os boletos com erros NÃO serão enviados, e devem ser enviados novamente via BATCH ou via FORMULÁRIO. dúvidas adicionais, contate: atendimento@boletomail.com.br


1.5 Gerando boletos pela sua lista de clientes

Para facilitar a cobrança de seus clientes, você pode tê-los cadastrados em uma lista que agilizará a geração de boletos. Veja como funciona:

Para cadastrar/modificar/excluir clientes:

  1. Após digitar seu username e sua senha na página principal, clique no link 'incluir' do menu, à esquerda da página.

  2. Preencha, no mínimo, os campos "Nome" e "Código do Cliente". Este último deve ser único para cada um deles. Após digitar, clique em salvar.

  3. Repita o segundo passo para todos seus clientes.
  4. Para modificar ou excluir, clique no menu "consultar" e depois em "editar" na linha correspondente ao cliente que terá seus dados alterados ou seu cadastrado excluído.
          

  5. Se necessário, faça as modificações e clique em "salvar" para atualizar os dados, ou em "excluir" para eliminar o cliente permanentemente do cadastro.

De que forma o cadastro irá lhe ajudar:
  1. Para gerar um boleto, basta clicar em "enviar boleto" e o modo formulário será acionado com todas as informações do cliente, anteriormente cadastradas, automaticamente preenchidas!
          

  2. Para encontrar apenas os boletos gerados para um cliente, basta clicar em "encontrar boletos" (na página de consulta de clientes).
Você pode utilizar a busca para localizar clientes na sua lista.



2. Consultando seus boletos emitidos.

Vá para www.boletomail.com.br, digite seu nome de usuário e senha, clique em [histórico].

Todos seus boletos emitidos pelo BoletoMail estão disponíveis para consulta.

BUSCA:

O site dispõe de uma ferramenta de busca para voce localizar facilmente um boleto.

Digite em 'busca' o 'nosso numero', 'valor', 'nome' ou 'cod_cli' para localizar rapidamente um boleto, e clique em go!

Voce pode digitar apenas parte do nome, ou parte do nosso numero, que o BoletoMail buscará aqueles que se encaixam nesse critério.

Selecione na lista se voce quer ver apenas os boletos que não foram pagos (pg=N), ou
apenas os que foram pagos (pg=S), ou
apenas os cancelados (pg=X).
Se voce selecionar (pg=' ') o sistema buscará todos os boletos, independente do seu valor de 'pg'.
   
Abaixo, alguns tipos de busca possiveis:
   
Busca todos os boletos emitidos para Francisco Roberto.
   
Busca todos os boletos com cod_cli=455
   
Busca todos os boletos que não foram pagos (pg=N)
   
Busca todos os boletos pagos (pg=S) de José da Silva.
   
   
DICA: Para mostrar novamente todos os boletos, deixe o campo 'busca' em branco e não selecione nada em pg e clique em Go!


Ordenando a lista:

Inicialmente os boletos são mostrados pela ordem cronológica, do mais recente para o mais antigo.
Voce pode reordenar esta lista,

clicando em 'NossoNum' voce ordernará a lista pelo Nosso Numero, clicando em 'Cod_cli', voce ordenará a lista pelo código do cliente, em 'nome' pelo nome do cliente, em 'valor', pelo valor do boleto e em 'Gerado em' pela data de geração do boleto.



Reemitindo um boleto:



Voce também pode clicar no Nosso Numero dos boletos, para reemitir um boleto que não tenha chegado, ou não tenha sido pago na data devida.
Os dados deste boleto serão enviados ao formulário, e lá voce pode alterar novamente todos os dados do boleto e envia-lo via email com as devidas correções.

DICA: Ao reemitir um boleto, marque o antigo com pg=X para facilitar seu controle.


Usando o campo pg:

O campo pg (pago) facilita seu controle dos boletos emitidos.
Existem 3 valores possiveis:

ps=S - O boleto foi pago

pg=N - O boleto ainda não foi pago

pg=X - O boleto foi substituido por outro

Valores possíveis para o campo ´pg`.

ATENÇÃO:

Após alterar o pg de algum boleto, voce deve apertar o botão SALVA, na parte de baixo da sua tela. Caso contrário, as alterações não serão salvas.
Salvando suas alterações no campo ´pg`.



Exemplo de controle com o campo pg:


" Vamos supor que voce deseja cobrar José da silva.

Voce lhe emite um boleto, que aparecerá no histórico com pg=N.

Passada a data de vencimento, José da Silva esqueceu de pagar o boleto e pede que voce emita outro boleto. Voce marca o boleto anterior com pg=X (cancelado) e gera um novo boleto, com pg=N.

Na nova data de vencimento José da Silva paga o novo boleto, e voce marca este novo boleto com pg=S.

Ao fazer uma busca pelos boletos emitidos para José da Silva, voce verá que ele tem um boleto vencido, mas que está com pg=X, e logo após verá que esse boleto foi substituido por um novo, que foi corretamente pago, portanto José da Silva está em dia com você."

Pasta "Lixeira":
Todos os boletos com pg='X', pg='', action='R' (regen) ou que nao foram gerados por causa de erros, são movidos automaticamente para a lixeira. Com isso, sua área de trabalho fica muito mais limpa e clara, facilitando seu trabalho.
Voce pode fazer busca tanto na pasta "historico" quanto na "lixeira", mas a busca se dará apenas na pasta atual. Para mover um boleto da lixeira, voce deve alterar o campo pg para 'S' ou 'N'. Duvidas adicionais, contate

Explicação sobre os campos que aparecem no histórico:

pg - =S para boletos pagos =N para boletos que ainda não foram pagos, =X para boletos cancelados

NossoNum
- Nosso número dos boletos: aparece com o dígito verificador.

Cod_cli - Código do cliente - o código que voce usa na sua empresa para identificar seu cliente;

Nome - Nome do Sacado;

Valor - Valor do Boleto;

Gerado em: Data e hora em que o boleto foi gerado;

Lido: Data e hora em que o boleto foi lido. Quando estiver em branco, significa que a data de leitura é desconhecida ou que seu boleto ainda não foi lido;

Action: 1,2,3 - action selecionado no momento de geração do boleto. R (regen)- significa que seu boletomail foi gerado no navegador de seu cliente usando o link do email (2 de 2); B (Batch) - Significa que seu BoletoMail foi gerado via BATCH.

Cod_config: código de configuração utilizado no momento de se gerar seu BoletoMail;

erro: Mensagem de erro ao se tentar gerar um BoletoMail. Boletos com erros não são gerados pelo sistema, por razões de segurança;

 

3. Monitoração dos boletos enviados via email.


3.1 Monitoração de problemas na entrega 

O BoletoMail tenta fazer com que seus boletos enviados via email tenham a máxima confiabilidade possível.
No caso de algum problema na entrega de seus boletos via email (endereço errado, demora na entrega), você receberá um aviso na sua caixa postal. Segue abaixo um exemplo:

Friday, 25/June/2004 15:09
Seu boleto de nosso numero 06/00/000325021-2 gerado para José Maria 
nao pode ser entregue com sucesso.

SMTP; 550 Host unknown

Cheque se voce digitou corretamente o email e se ele realmente eh valido.
Normalmente a falha na entrega se deve a um email invalido ou escrito
incorretamente.

Caso o email esteja correto, voce pode pode encaminhar o texto abaixo para seu
cliente gerar o boleto atraves do navegador. Ao fazer isso, voce garante que o
Boletomail sera entregue diretamente do seu computador para o email de seu
cliente, mimizando a possiblidade de bloqueio por parte do servidor de email
de seu cliente.

--inicio texto para geracao do boleto

Voce esta recebendo um boleto enviado via email por: Nome da sua empresa <seu@email.com>
Para gera-lo clique no link abaixo ou copie e cole-o no seu navegador.

http://www.boletomail.com.br/do.php?hash=f3ff07d2e465d59de6d013ae30f8b474

--fim texto para geracao de boleto
Neste caso Host unknown significa "domínio desconhecido" (de fato houve um erro de digitação do e-mail). Mas se o endereço estiver correto, o erro ocorrido poderá ser evitado caso você mesmo envie a mensagem entre --incio texto... e --fim texto... ao seu cliente que, ao recebê-lo, acessará o link encaminhado e visualizará o boleto.


3.2 Monitoração do recebimento de seus BoletoMails

O BoletoMail conta com um sistema que detecta o momento que seu cliente visualizou (i.e. descarregou E LEU) seu BoletoMail. Seu cliente não precisará apertar nenhum botão para emitir esse aviso, ele é emitido independente da vontade dele.

Você também pode receber um AR (aviso de recebimento) no seu email no exato momento em que seu cliente visualizar seu BoletoMail, se essa opção estiver habilitada em sua conta Boletomail.

Além disso há ícones no histórico que permitem saber se o boleto foi entregue no e-mail especificado com sucesso, se houve erro, se já foi aberto pelo cliente (com dia e horário da leitura), se o boleto foi impresso ao invés de enviado por e-mail, e há também um ícone que diferencia os boletos gerados por batch dos demais.


Confira o significado de cada um dos ícones:

CRÉDITOS

O sistema BoletoMail foi desenvolvido por: Edison Koji Maruyama <dekkard@verix.com.br> e Miguel Feitosa <mfeitosa@verix.com.br>.
Utiliza PHP3 e MySQL, gerenciamento de sessões e recursos proprietários desenvolvidos pela Verix (http://www.verix.com.br/).

Agradecimentos:

A Comunidade Linux,
A Luiz Passarelli
A Alessandro Rubini,
A Richard Heyes,
A Pablo Martins.

 


© 2001 Boletomail