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 los boletos en una tabla de datos, con estas columnas:
- ID: el identificador del boleto.
- Type: el tipo de boleto.
- Amount: el monto del boleto.
- Due date: la fecha en que vence el boleto.
- Status: el estado actual del ciclo de vida (consulta Estados).
- Created at: la fecha en que emitiste el boleto.
- Actions: la acción de cancelar, cuando el estado lo permite.
Emisión de un boleto
1
En la página Boletos, haz clic en Issue new boleto. Se abre un panel lateral.
2
Completa los campos:
- Amount (obligatorio): el valor del boleto (R$).
- Due date (obligatorio): la fecha en que el pagador debe pagar el boleto. No puede estar en el pasado.
- Ledger: el ledger seleccionado en el encabezado de Console. No puedes cambiarlo en el panel.
- Account (obligatorio): la cuenta de Midaz que se asocia al boleto. Escribe su alias exacto o su ID completo y selecciónala en los resultados.
- Type (obligatorio): Traditional, el único tipo que el servicio acepta.
- CPF / CNPJ (obligatorio): el documento fiscal del pagador.
- Full name (obligatorio): el nombre completo del pagador.
- Street (obligatorio): la calle del domicilio del pagador.
- Number (obligatorio): el número del domicilio.
- Complement (opcional): departamento, oficina o datos adicionales del domicilio.
- Neighborhood (obligatorio): el barrio del pagador.
- City (obligatorio): la ciudad del pagador.
- UF (obligatorio): el estado del pagador.
- ZIP code (obligatorio): el código postal del pagador.
- Instructions (opcional): instrucciones de pago del boleto.
3
Haz clic en Issue boleto.
4
Se abre la página de detalle del boleto. Cuando el proveedor devuelve la línea digitable y el código de barras, la tarjeta Payment data los muestra.
Estados del boleto
Un boleto pasa por estos estados:
- Pending: el proveedor todavía no confirmó el boleto.
- Created: el proveedor registró el boleto y el pagador puede pagarlo.
- Settled: el pagador pagó el boleto.
- Canceled: el boleto se canceló antes del pago.
- Inactivated: el proveedor inactivó el boleto. El pagador ya no puede pagarlo.
- Failed: la emisión del boleto no se completó (consulta Tratamiento de errores).
Cancelación de un boleto
Puedes cancelar un boleto en el estado Created. Haz clic en el ícono de cancelar en la columna Actions, o en Cancel boleto en la página de detalle. Escribe un Reason y haz clic en Cancel boleto para confirmar.
Tratamiento de errores
El formulario verifica cada campo antes de enviar la solicitud. Si el servicio rechaza la solicitud, aparece un mensaje de error. Un boleto cuya emisión no se completó muestra el estado Failed. Su página de detalle muestra los Failure details en el Status history. Si un envío no recibe respuesta, el panel muestra un aviso. Revisa la lista Boletos antes de enviar el formulario de nuevo. Si cambiaste el formulario o el ledger del encabezado después de ese envío, Issue boleto queda deshabilitado. Para emitir el boleto como uno nuevo, haz clic en Send as new, confirma y luego haz clic en Issue boleto. Si el último envío se procesó, el nuevo envío puede emitir un segundo boleto.