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).
- Created At — la fecha en que se emitió el boleto.
- Actions — menú de acciones.
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
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.
- 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) — instrucciones impresas en el boleto (p. ej., intereses o multas tras la fecha de vencimiento).
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).
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.
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).
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.