> ## 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

> Emite boletos individuales, en cuotas o por lote (tradicionales o híbridos con QR de Pix) desde Lerian Console, sigue los estados del ciclo de vida y resuelve errores de pago.

La página **Boletos** en [Lerian Console](/es/platform/console/about-lerian-console) te deja emitir boletos y seguir su ciclo de vida. Lista los campos obligatorios, los estados del boleto y cómo atender los errores.

## Acceso a la página Boletos

***

Para abrir la página **Boletos**, haz clic en **Payments** → **Boletos** en el menú lateral izquierdo.

La página muestra todos los boletos de la organización en una tabla de datos, con estas columnas:

* **Boleto**: el identificador del boleto, más el código de barras y la línea digitable después de la emisión.
* **Pagador**: la parte a la que cobras.
* **Monto**: el monto del boleto.
* **Fecha de vencimiento**: la fecha en que vence el boleto.
* **Estado**: el estado actual del ciclo de vida (consulta [Estados](#boleto-states)).
* **Creado el**: la fecha en que emitiste el boleto.
* **Acciones**: menú de acciones.

Puedes filtrar los boletos por estado, pagador o rango de fechas. Usa los campos de filtro que están arriba de la tabla.

## Emisión de un boleto

***

Para emitir un boleto, haz clic en el botón **+ Emitir nuevo boleto** en la parte superior derecha de la página **Boletos**. Se abre un panel lateral con tres pestañas. Elige el tipo de emisión que corresponde a tu caso de uso:

### Tipos de boleto

| Tipo           | Descripción                                                                                                                |
| -------------- | -------------------------------------------------------------------------------------------------------------------------- |
| **Individual** | Emite un boleto para un solo pagador, con monto y fecha de vencimiento fijos.                                              |
| **Cuotas**     | Emite una serie de boletos para el mismo pagador, repartidos en varias fechas de vencimiento con un intervalo configurado. |
| **Lote**       | Emite hasta 10 boletos para distintos pagadores en una sola operación. Cada entrada se envía al proveedor por separado.    |

### Tipo de registro

Los tres tipos de emisión incluyen un campo **Tipo**:

* **Tradicional**: un boleto estándar que registra el proveedor bancario.
* **Híbrido**: un boleto con un código QR de Pix incrustado. El pagador puede pagar por código de barras o por código QR.

### Boleto individual

<Steps>
  <Step>
    En la página **Boletos**, haz clic en **+ Emitir nuevo boleto**.
  </Step>

  <Step>
    Selecciona la pestaña **Individual**.
  </Step>

  <Step>
    Completa los campos obligatorios:

    **Datos del boleto**

    * **Monto** *(obligatorio)*: el valor del boleto (R\$).
    * **Fecha de vencimiento** *(obligatorio)*: la fecha en que el pagador debe pagar el boleto.
    * **ID de cuenta** *(obligatorio)*: la cuenta de Midaz que se asocia al boleto.
    * **Tipo** *(obligatorio)*: **Tradicional** o **Híbrido**.

    **Datos del pagador**

    * **CPF / CNPJ** *(obligatorio)*: el documento fiscal del pagador.
    * **Nombre completo** *(obligatorio)*: el nombre completo del pagador.
    * **Calle** *(obligatorio)*: la calle del domicilio del pagador.
    * **Número** *(obligatorio)*: el número del domicilio.
    * **Complemento** *(opcional)*: departamento, oficina o datos adicionales del domicilio.
    * **Barrio** *(obligatorio)*: el barrio del pagador.
    * **Ciudad** *(obligatorio)*: la ciudad del pagador.

    **Adicional**

    * **Instrucciones** *(opcional)*: el texto que se imprime en el boleto (por ejemplo, intereses o multas después de la fecha de vencimiento).
  </Step>

  <Step>
    Haz clic en **Emitir boleto**.
  </Step>

  <Step>
    Después de que el proveedor lo procesa, el boleto aparece en la lista. Muestra el **código de barras** y la **línea digitable** generados, listos para compartir con el pagador.
  </Step>
</Steps>

### Serie de cuotas

Los mismos campos que en Individual, con estas diferencias:

* **Monto total** *(obligatorio)*: el monto completo que se reparte entre todas las cuotas.
* **Primera fecha de vencimiento** *(obligatorio)*: la fecha de vencimiento de la primera cuota. Lerian genera los boletos siguientes de forma automática.
* **Cuotas** *(obligatorio)*: cantidad de boletos que se generan (mínimo 2).
* **Intervalo (días)** *(obligatorio)*: cantidad de días entre cada fecha de vencimiento (predeterminado 30).

Haz clic en **Emitir serie de cuotas** para confirmar.

### Lote

La pestaña **Lote** te deja emitir hasta 10 boletos a la vez. Lerian envía cada entrada al proveedor por separado.

Para cada entrada, completa: **Monto**, **Fecha de vencimiento**, **ID de cuenta**, **CPF / CNPJ** y **Nombre completo**. Usa **+ Agregar entrada** para sumar más entradas. El contador muestra cuántas entradas pusiste en la cola (por ejemplo, `1 / 10 entries`).

Haz clic en **Emitir lote** para enviar todas las entradas.

<Tip>
  Después de emitir un boleto, copia la **línea digitable** o descarga el documento del boleto. Compártelo con el pagador.
</Tip>

<h2 id="boleto-states">
  Estados del boleto
</h2>

***

Un boleto pasa por estos estados:

* **Registrando**: el proveedor registra el boleto después de que envías la solicitud.
* **Registrado**: el proveedor registró el boleto y el pagador puede pagarlo.
* **Pagado**: el pagador pagó el boleto.
* **Vencido**: el boleto pasó su fecha de vencimiento sin pago.
* **Cancelado**: un usuario canceló el boleto antes del pago.
* **Fallido**: la emisión del boleto no se completó (consulta [Tratamiento de errores](#error-handling)).

## Menú de acciones disponibles

***

El menú de acciones (<Icon icon="ellipsis-vertical" />) muestra acciones distintas para cada boleto. Las acciones disponibles dependen del estado del boleto:

* **Ver detalles**: abre el detalle del boleto: código de barras, línea digitable e historial de estados.
* **Descargar**: descarga el documento del boleto.
* **Cancelar**: cancela un boleto antes de que el pagador lo pague.

<h2 id="error-handling">
  Tratamiento de errores
</h2>

***

Si la emisión de un boleto falla, aparece con el estado **Fallido** y un motivo de error en el panel de detalle. Las causas comunes incluyen:

* **Documento del pagador inválido**: el CPF/CNPJ tiene un formato incorrecto o no pasa la validación. Corrige el documento y emite un boleto nuevo.
* **Monto o fecha de vencimiento inválidos**: el monto es cero o negativo, o la fecha de vencimiento ya pasó. Ajusta los valores y vuelve a intentar.
* **Error del proveedor o del registro**: el proveedor bancario no pudo completar el registro. Emite el boleto de nuevo. Si el error persiste, contacta al soporte.

<Warning>
  Para emitir boletos, necesitas los permisos de Payments correspondientes. Si no ves el botón **+ Emitir nuevo boleto**, pide a tu administrador que revise los permisos de tu rol.
</Warning>

## Páginas relacionadas

***

<Columns cols={2}>
  <Card title="Introducción a Payments" icon="money-bill-wave" horizontal href="/es/interfaces/payments-btg/console/payments-introduction" />

  <Card title="Pago de facturas" icon="file-invoice-dollar" horizontal href="/es/interfaces/payments-btg/console/payments-bill-payments" />
</Columns>
