Skip to main content
A página Boletos permite emitir boletos e acompanhar o ciclo de vida. Esta seção mostra como emitir um boleto no Lerian Console. Ela lista os campos obrigatórios, os estados do boleto e como tratar erros.

​
Acessando a página de Boletos

Para abrir a página Boletos, clique em Payments → Boletos no menu lateral esquerdo. A página exibe todos os boletos da organização em uma tabela de dados, com as seguintes colunas:
  • Boleto — o identificador do boleto, mais o código de barras e a linha digitável após a emissão.
  • Pagador — a parte que você cobra.
  • Valor — o valor do boleto.
  • Data de vencimento — a data de vencimento do boleto.
  • Status — o estado atual do ciclo de vida (veja Estados).
  • Criado em — a data em que você emitiu o boleto.
  • Ações — menu de ações.
Você pode filtrar os boletos por status, pagador ou intervalo de datas. Use os campos de filtro acima da tabela.

​
Emitindo um boleto

Para emitir um boleto, clique no botão + Emitir novo boleto no canto superior direito da página Boletos. Um painel lateral abre com três abas — escolha o tipo de emissão que se encaixa no seu caso de uso:

​
Tipos de boleto

​
Tipo de registro

Os três tipos de emissão incluem um campo Tipo:
  • Tradicional — um boleto padrão que o provedor bancário registra.
  • Híbrido — um boleto com um QR code Pix incorporado. O pagador pode pagar por código de barras ou por QR code.

​
Boleto único

1
Na página Boletos, clique em + Emitir novo boleto.
2
Selecione a aba Único.
3
Preencha os campos obrigatórios:Dados do boleto
  • Valor (obrigatório) — o valor do boleto (R$).
  • Data de vencimento (obrigatório) — a data em que o pagador deve pagar o boleto.
  • Account ID (obrigatório) — a conta Midaz a ser associada ao boleto.
  • Tipo (obrigatório) — Tradicional ou Híbrido.
Dados do pagador
  • CPF / CNPJ (obrigatório) — o documento fiscal do pagador.
  • Nome completo (obrigatório) — o nome completo do pagador.
  • Rua (obrigatório) — o logradouro do pagador.
  • Número (obrigatório) — o número do endereço.
  • Complemento (opcional) — apartamento, sala ou informações adicionais de endereço.
  • Bairro (obrigatório) — o bairro do pagador.
  • Cidade (obrigatório) — a cidade do pagador.
Adicionais
  • Instruções (opcional) — o texto a imprimir no boleto (por exemplo, juros ou multa após o vencimento).
4
Clique em Emitir boleto.
5
Depois que o provedor o processa, o boleto aparece na lista. Ele mostra o código de barras e a linha digitável gerados, pronto para compartilhar com o pagador.

​
Série parcelada

Os mesmos campos do Único, com as seguintes diferenças:
  • Valor total (obrigatório) — o valor integral a dividir entre todas as parcelas.
  • Primeiro vencimento (obrigatório) — a data de vencimento da primeira parcela. A Lerian gera os boletos seguintes automaticamente.
  • Parcelas (obrigatório) — número de boletos a gerar (mínimo de 2).
  • Intervalo (dias) (obrigatório) — número de dias entre cada vencimento (padrão 30).
Clique em Emitir série parcelada para confirmar.

​
Lote

A aba Lote permite emitir até 10 boletos de uma vez. A Lerian envia cada entrada ao provedor individualmente. Para cada entrada, preencha: Valor, Data de vencimento, Account ID, CPF / CNPJ e Nome completo. Use + Adicionar entrada para incluir mais entradas. O contador mostra quantas entradas você colocou na fila (por exemplo, 1 / 10 entradas). Clique em Emitir lote para enviar todas as entradas.
Depois que você emite um boleto, copie a linha digitável ou baixe o documento do boleto. Compartilhe-o com o pagador.

​
Estados do boleto

Um boleto passa pelos seguintes estados:
  • Em registro — o provedor registra o boleto depois que você envia a solicitação.
  • Registrado — o provedor registrou o boleto e o pagador pode pagá-lo.
  • Pago — o pagador pagou o boleto.
  • Expirado — o boleto passou da data de vencimento sem pagamento.
  • Cancelado — um usuário cancelou o boleto antes do pagamento.
  • Falha — a emissão do boleto não foi concluída (veja Tratamento de erros).
O menu de ações () mostra ações diferentes para cada boleto. As ações disponíveis dependem do estado do boleto:
  • Ver detalhes — abre os detalhes do boleto: código de barras, linha digitável e histórico de status.
  • Baixar — baixa o documento do boleto.
  • Cancelar — cancela um boleto antes de o pagador pagá-lo.

​
Tratamento de erros

Se a emissão de um boleto falhar, ele aparece com o status Falha e um motivo de erro no painel de detalhes. As causas comuns incluem:
  • Documento do pagador inválido — o CPF/CNPJ está malformado ou falha na validação. Corrija o documento e emita um novo boleto.
  • Valor ou vencimento inválido — o valor é zero ou negativo, ou o vencimento está no passado. Ajuste os valores e tente novamente.
  • Erro de provedor/registro — o provedor bancário não pôde concluir o registro. Emita o boleto novamente. Se o erro persistir, entre em contato com o suporte.
Para emitir boletos, você precisa das permissões adequadas de Payments. Se você não vê o botão + Emitir novo boleto, peça ao administrador para verificar as permissões do seu papel.

​
Páginas relacionadas

Payments introduction

Bill Payments