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).
- Creado el: la fecha en que emitiste el boleto.
- Acciones: menú de acciones.
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 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
1
En la página Boletos, haz clic en + Emitir nuevo boleto.
2
Selecciona la pestaña Individual.
3
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.
- 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.
- Instrucciones (opcional): el texto que se imprime en el boleto (por ejemplo, intereses o multas después de la fecha de vencimiento).
4
Haz clic en Emitir 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, listos para compartir con el pagador.
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).
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.
Estados del boleto
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).
Menú de acciones disponibles
El menú de acciones () 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.
Tratamiento de errores
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.

