> ## 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 desde el plugin Payments para Midaz, siga sus estados del ciclo de vida y gestione errores de emisión y pago.
La página **Boletos** le permite emitir boletos y seguirlos a lo largo de su ciclo de vida. En esta sección aprenderá a emitir un boleto a través de [Lerian Console](/es/lerian-console/about-lerian-console), qué campos son obligatorios, los estados por los que puede pasar un boleto y cómo gestionar errores.
## Acceder a la página Boletos
***
Para abrir la página **Boletos**, haga 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 (y el código de barras/línea digitable cuando se ha emitido).
* **Payer** — la parte a la que se cobra.
* **Amount** — el monto del boleto.
* **Due Date** — la fecha de vencimiento del boleto.
* **Status** — el estado actual del ciclo de vida (consulte [Estados](#estados-del-boleto)).
* **Created At** — la fecha en que se emitió el boleto.
* **Actions** — menú de acciones.
Puede filtrar los boletos por estado, pagador o rango de fechas usando los campos de filtro situados sobre la tabla.
## Emitir un boleto
***
Para emitir un boleto, haga 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: elija el tipo de emisión que se ajuste a su 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** — boleto estándar registrado con el proveedor bancario.
* **Hybrid** — boleto con un código QR de Pix incrustado, que permite al pagador pagar mediante código de barras o código QR.
### Boleto Single
Desde la página **Boletos**, haga clic en **+ Issue new boleto**.
Seleccione la pestaña **Single**.
Complete los campos obligatorios:
**Detalles del boleto**
* **Amount** *(obligatorio)* — el valor del boleto (R\$).
* **Due date** *(obligatorio)* — la fecha límite en que debe pagarse 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)* — instrucciones impresas en el boleto (p. ej., intereses o multas tras la fecha de vencimiento).
Haga clic en **Issue boleto**.
Una vez procesado, el boleto aparece en la lista con su **código de barras** y **línea digitable** generados, listo para compartirse con el pagador.
### Serie de Installments
Los mismos campos que en Single, con las siguientes diferencias:
* **Total amount** *(obligatorio)* — el monto total que se repartirá entre todas las cuotas.
* **First due date** *(obligatorio)* — la fecha de vencimiento de la primera cuota; los boletos siguientes se generan 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).
Haga clic en **Issue installment series** para confirmar.
### Batch
La pestaña **Batch** le permite emitir hasta 10 boletos a la vez. Cada entrada se envía individualmente al proveedor.
Para cada entrada, complete: **Amount**, **Due date**, **Account ID**, **CPF / CNPJ** y **Full name**. Use **+ Add entry** para agregar más entradas. El contador muestra cuántas entradas están en cola (p. ej., `1 / 10 entries`).
Haga clic en **Issue batch** para enviar todas las entradas.
Después de emitir un boleto, copie la **línea digitable** o descargue el documento del boleto para compartirlo con el pagador.
## Estados del boleto
***
Un boleto pasa por los siguientes estados:
* **Registering** — la solicitud de emisión del boleto fue enviada y se está registrando.
* **Registered** — el boleto se registró correctamente y el pagador puede pagarlo.
* **Paid** — el pagador ha pagado el boleto.
* **Expired** — el boleto superó su fecha de vencimiento sin pago.
* **Cancelled** — el boleto fue cancelado antes del pago.
* **Failed** — la solicitud de emisión no pudo completarse (consulte [Manejo de errores](#manejo-de-errores)).
## Menú de acciones disponibles
***
Para cada boleto, las siguientes acciones pueden estar disponibles en el menú de acciones (), según su estado:
* **View details** — abre los detalles del boleto, incluyendo el código de barras, la línea digitable y el historial de estados.
* **Download** — descarga el documento del boleto.
* **Cancel** — cancela un boleto que aún no ha sido pagado.
## Manejo de errores
***
Si un boleto no puede emitirse, 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. Corrija el documento y emita un nuevo boleto.
* **Monto o fecha de vencimiento inválidos** — el monto es cero/negativo o la fecha de vencimiento está en el pasado. Ajuste los valores y vuelva a intentarlo.
* **Error del proveedor/registro** — el registro no pudo completarse con el proveedor bancario. Reintente la emisión; si persiste, contacte a soporte.
La emisión de boletos requiere los permisos de Payments correspondientes. Si no ve el botón **+ Issue new boleto**, consulte los permisos de su rol con su administrador.
## Páginas relacionadas
***