Órdenes de Pago
Requisitos previos de acceso
- Permiso (módulo):
viewPayments - Licencia/Feature: Ninguna específica.
- Contenedor del menú: GENERAL → grupo Operaciones (ruta
/manage-orders)
Ruta sin elemento de menú
Esta pantalla existe en la aplicación (/manage-orders) pero no tiene un elemento fijo en el menú. Se mantiene para el flujo de pedidos/órdenes de pago (precatórios y asignaciones). Antes de divulgarla a los operadores, confirme con el coordinador si permanece activa en este tenant.
Qué es / cuándo usar
Son órdenes creadas por asignación o precatórios, en las que se libera un NFT de valor. El usuario, sabiendo que tiene un valor por recibir, puede esperar el pago o comercializar su NFT por el precio que determine; al final, quien tenga el NFT en su poder recibe el valor total del precatório/asignación. Esta pantalla lista esos pedidos, permite hacer seguimiento del estado, ver el detalle de cada orden y exportar la lista en PDF.
Requisitos previos
- Permiso:
viewPayments(permiso doble — enum CPM + módulo dinámico en la BD). - Licencia/Feature: Ninguna específica.
- Dependencias de otras pantallas: el pedido/NFT de valor debe haber sido emitido previamente (asignación o precatório).
Paso a paso
- Acceda a
/manage-orders(Órdenes de Pago). - Busque por ID del pedido o correo electrónico del cliente.
- Haga clic en visualizar para abrir los detalles del pedido; use enviar (camión) para avanzar el estado; use Generar PDF para exportar la lista.
Filtros y columnas
| Filtro/Columna | Qué muestra | Origen del dato |
|---|---|---|
| Búsqueda | Filtro local por ID del pedido o correo electrónico | id / userEmail |
| Pedido | Número del pedido (con indicador de mensaje) | id, hasMessage, hasNewMessage |
| Fecha | Fecha/hora de creación | createdAt |
| Correo / Cliente | Comprador y nombre | userEmail, user.data.firstName/lastName |
| Documento | CPF/CNPJ/pasaporte (con máscara automática) | user.data.identifier |
| Total | Monto del pedido | totalAmount (moneda fiduciaria del tenant) |
| Estado | Estado del pedido (rojo = cancelado, verde = entregado) | status (orderStatus) |
Estados posibles: esperando pago, en curso, entregado, procesando cancelación, cancelado, separando inventario.
Acciones y modales
- Visualizar (visibility): abre el modal
DialogOrderViewComponentcon los detalles del pedido. - Marcar como enviado (local_shipping): llama a
changeOrderStatus('finished', id)— avanza el pedido a finalizado. Acción inmediata, con retroalimentación vía snackbar. - Generar PDF: exporta la lista de pedidos en
pedidos.pdf(jsPDF/autoTable).
Reglas de negocio / consideraciones
Atención
- El filtro/búsqueda es local sobre la lista cargada (ID o correo electrónico).
- El cambio de estado es inmediato (sin bottom-sheet de confirmación) — confirme el pedido antes de hacer clic.
- Valores financieros: tratados como BigNumber — sin redondeo; el total se muestra en la moneda fiduciaria del tenant.
- Idempotencia: las liquidaciones asociadas al pedido siguen la idempotencia por
externalIdde FinLib (E00021= ya procesado = éxito). - Estado APPROVED: los movimientos financieros presuponen un usuario
APPROVED.