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).
- Ledger: el ledger del boleto. La lista muestra los boletos de todos los ledgers de la organización.
- Created at: la fecha en que emitiste el boleto.
- Actions: la acción de cancelar, cuando el boleto se puede cancelar.
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, o Hybrid, un boleto que el pagador también puede pagar por Pix. Un boleto híbrido necesita la configuración del receptor Pix. La defines a través de la API, porque la Console no tiene una pantalla para eso.
- 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.
- Our number (nosso número) (opcional): el número del boleto en el banco. Si lo dejas vacío, el banco asigna el número. Payments rechaza un número que otro boleto activo ya tiene en la misma cuenta bancaria, incluso de otra cuenta Midaz. La Console enlaza ese boleto cuando puede abrirlo. Si no, indica que el boleto que tiene el número no está en esta organización.
3
Haz clic en Issue boleto.
4
Se abre la página de detalle del boleto. Muestra al pagador y el nosso número, con un botón para copiar el número. Mientras el boleto no está registrado, la tarjeta Payment data lo avisa, consulta de nuevo por un tiempo y ofrece Refresh. Cuando el proveedor devuelve la línea digitable y el código de barras, la tarjeta Payment data los muestra. Para un boleto híbrido, la tarjeta también muestra el QR Code de Pix después de que el proveedor registra el boleto.
Todo boleto registra al titular de la cuenta seleccionada como beneficiario final. El servicio lee al titular en el CRM de Midaz y rechaza el boleto cuando la cuenta no tiene titular registrado o cuando el pagador es ese titular.
Estados del boleto
Un boleto pasa por estos estados:
- Not sent: el boleto existe y todavía no se envió al proveedor.
- Awaiting registration: el proveedor aceptó el boleto y todavía no lo registró.
- Registered: 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 Registered. 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. Para conservar el boleto, haz clic en Keep boleto.
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.