> ## 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 desde el plugin Payments para Midaz, sigue sus estados del ciclo de vida y gestiona errores de emisión y pago con webhooks y auditoría.
La página **Boletos** te permite emitir boletos y seguir su ciclo de vida. Esta sección muestra cómo emitir un boleto en [Lerian Console](/es/platform/console/about-lerian-console). Enumera los campos obligatorios, los estados del boleto y cómo gestionar errores.
## Acceder 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 las siguientes columnas:
* **Boleto** — el identificador del boleto, más el código de barras y la línea digitable tras la emisión.
* **Payer** — la parte a la que cobras.
* **Amount** — el monto del boleto.
* **Due Date** — la fecha de vencimiento del boleto.
* **Status** — el estado actual del ciclo de vida (consulta [Estados](#estados-del-boleto)).
* **Created At** — la fecha en que emitiste el boleto.
* **Actions** — menú de acciones.
Puedes filtrar los boletos por estado, pagador o rango de fechas. Usa los campos de filtro situados sobre la tabla.
## Emitir un boleto
***
Para emitir un boleto, haz clic en el botón **+ Issue new 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 se ajuste a tu caso de uso.
### Tipos de boleto
| Tipo | Descripción |
| ---------------- | --------------------------------------------------------------------------------------------------------------------------- |
| **Single** | Emite un boleto para un único pagador con un monto y una fecha de vencimiento fijos. |
| **Installments** | Emite una serie de boletos para el mismo pagador, repartidos en varias fechas de vencimiento con un intervalo configurado. |
| **Batch** | Emite hasta 10 boletos para diferentes pagadores en una sola operación. Cada entrada se envía individualmente al proveedor. |
### Tipo de registro
Los tres tipos de emisión incluyen un campo **Type**:
* **Traditional** — un boleto estándar que registra el proveedor bancario.
* **Hybrid** — 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 Single
Desde la página **Boletos**, haz clic en **+ Issue new boleto**.
Selecciona la pestaña **Single**.
Completa los campos obligatorios:
**Detalles del boleto**
* **Amount** *(obligatorio)* — el valor del boleto (R\$).
* **Due date** *(obligatorio)* — la fecha en que el pagador debe pagar el boleto.
* **Account ID** *(obligatorio)* — la cuenta de Midaz que se asociará al boleto.
* **Type** *(obligatorio)* — **Traditional** o **Hybrid**.
**Detalles del pagador**
* **CPF / CNPJ** *(obligatorio)* — el documento tributario del pagador.
* **Full name** *(obligatorio)* — el nombre completo del pagador.
* **Street** *(obligatorio)* — la dirección (calle) del pagador.
* **Number** *(obligatorio)* — el número de la dirección.
* **Complement** *(opcional)* — apartamento, oficina o información adicional de la dirección.
* **Neighborhood** *(obligatorio)* — el barrio del pagador.
* **City** *(obligatorio)* — la ciudad del pagador.
**Adicional**
* **Instructions** *(opcional)* — el texto que se imprime en el boleto (por ejemplo, intereses o multas tras la fecha de vencimiento).
Haz clic en **Issue boleto**.
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, listo para compartir con el pagador.
### Serie de Installments
Los mismos campos que en Single, con las siguientes diferencias:
* **Total amount** *(obligatorio)* — el monto total a repartir entre todas las cuotas.
* **First due date** *(obligatorio)* — la fecha de vencimiento de la primera cuota. Lerian genera los boletos siguientes automáticamente.
* **Installments** *(obligatorio)* — número de boletos a generar (mínimo 2).
* **Interval (days)** *(obligatorio)* — número de días entre cada fecha de vencimiento (predeterminado 30).
Haz clic en **Issue installment series** para confirmar.
### Batch
La pestaña **Batch** te permite emitir hasta 10 boletos a la vez. Lerian envía cada entrada al proveedor de forma individual.
Para cada entrada, completa: **Amount**, **Due date**, **Account ID**, **CPF / CNPJ** y **Full name**. Usa **+ Add entry** para agregar más entradas. El contador muestra cuántas entradas pusiste en cola (por ejemplo, `1 / 10 entries`).
Haz clic en **Issue batch** para enviar todas las entradas.
Después de emitir un boleto, copia la **línea digitable** o descarga el documento del boleto. Compártelo con el pagador.
## Estados del boleto
***
Un boleto pasa por los siguientes estados:
* **Registering** — el proveedor registra el boleto después de que envías la solicitud.
* **Registered** — el proveedor registró el boleto y el pagador puede pagarlo.
* **Paid** — el pagador pagó el boleto.
* **Expired** — el boleto superó su fecha de vencimiento sin pago.
* **Cancelled** — un usuario canceló el boleto antes del pago.
* **Failed** — la emisión del boleto no se completó (consulta [Manejo de errores](#manejo-de-errores)).
## Menú de acciones disponibles
***
El menú de acciones () muestra distintas acciones para cada boleto. Las acciones disponibles dependen del estado del boleto:
* **View details** — abre los detalles del boleto: código de barras, línea digitable e historial de estados.
* **Download** — descarga el documento del boleto.
* **Cancel** — cancela un boleto antes de que el pagador lo pague.
## Manejo de errores
***
Si la emisión de un boleto falla, aparece con el estado **Failed** y un motivo de error en el panel de detalles. Las causas más comunes incluyen:
* **Documento de pagador inválido** — el CPF/CNPJ está mal formado o no supera la validación. Corrige el documento y emite un nuevo boleto.
* **Monto o fecha de vencimiento inválidos** — el monto es cero o negativo, o la fecha de vencimiento está en el pasado. Ajusta los valores y vuelve a intentarlo.
* **Error del proveedor/registro** — el proveedor bancario no pudo completar el registro. Emite el boleto de nuevo. Si el error persiste, contacta a soporte.
Para emitir boletos, necesitas los permisos de Payments correspondientes. Si no ves el botón **+ Issue new boleto**, pide a tu administrador que revise los permisos de tu rol.
## Páginas relacionadas
***