> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lerian.studio/llms.txt
> Use this file to discover all available pages before exploring further.

# Boletos

> Emita boletos pelo Lerian Console, acompanhe os estados do ciclo de vida e cancele boletos.

A página **Boletos** no [Lerian Console](https://docs.lerian.studio/pt/platform/console/about-lerian-console.md) permite emitir boletos e acompanhar o ciclo de vida deles. Ela lista os campos do formulário, os estados do boleto e como tratar erros.

## Acessando a página Boletos

***

Para abrir a página **Boletos**, clique em **Pagamentos** → **Boletos** no menu lateral esquerdo.

A página mostra os boletos em uma tabela de dados, com as seguintes colunas:

* **ID**: o identificador do boleto.
* **Tipo**: o tipo do boleto.
* **Valor**: o valor do boleto.
* **Data de vencimento**: a data de vencimento do boleto.
* **Status**: o estado atual do ciclo de vida (veja [Estados](#boleto-states)).
* **Criado em**: a data em que você emitiu o boleto.
* **Ações**: a ação de cancelar, quando o estado permite.

Você pode filtrar boletos por status, tipo ou intervalo de vencimento. Use os campos de filtro acima da tabela. Clique em uma linha para abrir a página de detalhes do boleto.

## Emitindo um boleto

***

**Step 1**

Na página **Boletos**, clique em **Emitir novo boleto**. Um painel lateral abre.

**Step 2**

Preencha os campos:

* **Valor** *(obrigatório)*: o valor do boleto (R\$).
* **Data de vencimento** *(obrigatório)*: a data em que o pagador deve pagar o boleto. Ela não pode estar no passado.
* **Ledger**: o ledger selecionado no cabeçalho do Console. Você não pode alterá-lo no painel.
* **Conta** *(obrigatório)*: a conta do Midaz a associar ao boleto. Digite o alias exato ou o ID completo dela e selecione-a nos resultados.
* **Tipo** *(obrigatório)*: **Tradicional**, ou **Híbrido**, um boleto que o pagador também pode pagar por Pix. Um boleto híbrido precisa da configuração do recebedor Pix. Você a define pela API, porque o Console não tem uma tela para isso.
* **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ção adicional do endereço.
* **Bairro** *(obrigatório)*: o bairro do pagador.
* **Cidade** *(obrigatório)*: a cidade do pagador.
* **UF** *(obrigatório)*: o estado do pagador.
* **CEP** *(obrigatório)*: o CEP do pagador.
* **Instruções** *(opcional)*: instruções de pagamento do boleto.

**Step 3**

Clique em **Emitir boleto**.

**Step 4**

A página de detalhes do boleto abre. Quando o provedor devolve a **linha digitável** e o **código de barras**, o card **Dados de pagamento** mostra os dois. Para um boleto híbrido, o card também mostra o **QR Code** do Pix depois que o provedor registra o boleto.

> [!NOTE]
>
> Todo boleto registra o titular da conta selecionada como beneficiário final. O serviço lê o titular no CRM do Midaz e recusa o boleto quando a conta não tem titular registrado ou quando o pagador é esse titular.

> [!TIP]
>
> Depois de emitir um boleto, compartilhe a **linha digitável** dele com o pagador.

## Estados do boleto

***

Um boleto passa pelos seguintes estados:

* **Pendente**: o provedor ainda não confirmou o boleto.
* **Criado**: o provedor registrou o boleto e o pagador pode pagá-lo.
* **Liquidado**: o pagador pagou o boleto.
* **Cancelado**: o boleto foi cancelado antes do pagamento.
* **Inativado**: o provedor inativou o boleto. O pagador não pode mais pagá-lo.
* **Com falha**: a emissão do boleto não foi concluída (veja [Tratamento de erros](#error-handling)).

## Cancelando um boleto

***

Você pode cancelar um boleto no estado **Criado**. Clique no ícone de cancelar na coluna **Ações**, ou em **Cancelar boleto** na página de detalhes. Informe um **Motivo** e clique em **Cancelar boleto** para confirmar.

## Tratamento de erros

***

O formulário verifica cada campo antes de enviar a requisição. Se o serviço recusa a requisição, aparece uma mensagem de erro. Um boleto cuja emissão não foi concluída mostra o estado **Com falha**. A página de detalhes dele mostra os **Detalhes da falha** no **Histórico de status**.

Se um envio não recebe resposta, o painel mostra um aviso. Confira a lista **Boletos** antes de enviar o formulário de novo. Se você alterou o formulário ou o ledger do cabeçalho depois desse envio, **Emitir boleto** fica desabilitado. Para emitir o boleto como um novo, clique em **Enviar como novo**, confirme e depois clique em **Emitir boleto**. Se o último envio foi processado, o novo envio pode emitir um segundo boleto.

> [!WARNING]
>
> Para emitir boletos, você precisa das permissões adequadas do Payments. Se você não vê o botão **Emitir novo boleto**, peça ao seu administrador para verificar as permissões do seu papel.

## Páginas relacionadas

***

> [card] [Introdução ao Payments](https://docs.lerian.studio/pt/interfaces/payments-btg/console/payments-introduction.md)

> [card] [Pagamento de contas](https://docs.lerian.studio/pt/interfaces/payments-btg/console/payments-bill-payments.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.