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).
- Created At — la fecha en que emitiste el boleto.
- Actions — menú de acciones.
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 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
1
Desde la página Boletos, haz clic en + Issue new boleto.
2
Selecciona la pestaña Single.
3
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.
- 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.
- Instructions (opcional) — el texto que se imprime en el boleto (por ejemplo, intereses o multas tras la fecha de vencimiento).
4
Haz clic en Issue boleto.
5
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).
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.
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).
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.