Documentação

Español

Português
English

Español

Português
English

Appearance

Línea de tiempo de las colas de pago ​

Requisitos previos de acceso

  • Permiso (módulo): processPaymentQueue (controla los botones de la UI) + manageToken (exigido por el backend en las rutas /v1/assets/...)
  • Licencia/Feature: Ninguna específica.
  • Contenedor del menú: GENERAL → grupo Cobros → ítem Órdenes de Pago (ícono timeline, ruta /manage-payment-queues-timelines)

Misma pantalla, dos nombres

En el menú lateral este ítem aparece como "Órdenes de Pago" (etiqueta i18n paymentQueuesTimelines, ícono de línea de tiempo). Es la ejecución, en orden de prioridad, de las Colas de Pago — cada fila es un NFT a ser recomprado. El detalle campo a campo de la liquidación de cada NFT (qué sucede al aprobar) está en Órdenes de la cola de pago; esta página describe la línea de tiempo/listado priorizado y la acción de procesar. No confundir con la pantalla Órdenes de Pago (/manage-orders), del grupo Operaciones.

Qué es / cuándo usar ​

Esta pantalla es la línea de tiempo de pago de las colas: lista cada NFT individual que entró en una cola de recompra (deudas judiciales, debentures, deuda pública tokenizada, etc.), ordenada por prioridad según lo definido en Colas de Pago. Aquí es donde el operador procesa (aprueba) el pago de cada NFT, en orden.

El orden de visualización de la tabla es la línea de tiempo: del más prioritario (order menor) al menos. Las órdenes ya pagadas permanecen visibles con Pagado = Sí, sin acción disponible; las no pagadas muestran el botón de aprobar.

Al aprobar un NFT, el sistema:

  1. Paga al tenedor actual el monto price_paid (lo que pagó por el NFT), desde la billetera de la plataforma, en la moneda fiduciaria del tenant;
  2. Transfiere el NFT de regreso al TKN_OWNER;
  3. Marca la orden como pagada y reordena las entradas restantes.

Requisitos previos ​

  • Permiso: processPaymentQueue para los botones de la UI; el backend valida manageToken en las rutas (getPaymentQueuesTimelines, executePaymentQueue). Permiso doble — enum CPM en el backend + módulo dinámico en la BD.
  • Licencia/Feature: Ninguna específica.
  • Dependencias de otras pantallas: las Colas de Pago deben estar configuradas y tener NFTs seleccionados (por colección + atributo + valor). El tenedor del NFT debe tener billetera válida y estar en APPROVED.

Paso a paso ​

  1. Acceda a Cobros → Órdenes de Pago (ruta /manage-payment-queues-timelines).
  2. La página carga la línea de tiempo (GET /v1/assets/getPaymentQueuesTimelines), ya ordenada por prioridad (del más prioritario al menos). Cada fila es un NFT.
  3. Identifique el NFT por el Nombre del activo y el NFT ID.
  4. En las filas con Pagado = No, haga clic en el ícono de verificación (Aprobar).
  5. El sistema ejecuta el pago al tenedor, devuelve el NFT al TKN_OWNER, muestra el mensaje "Cola procesada con éxito" y recarga la página.

Filtros y columnas ​

La pantalla es un listado priorizado (sin filtros de búsqueda), paginado (5/10/25/100 por página, por defecto 25).

ColumnaQué muestraOrigen del dato
NombreNombre del activo/colección del NFTassetName (resuelto a partir del asset_id)
OrdenPosición del NFT en la cola (prioridad efectiva)order
NFT IDIdentificador on-chain del NFTblockchain_token_id
PagadoSi el NFT ya fue liquidado (Sí/No)paid
AcciónBotón Aprobar (verificación), visible solo cuando paid = false—

El propio orden de la tabla (order) es la línea de tiempo: refleja la prioridad configurada en las colas. No hay botón de creación en esta pantalla — la composición de la cola proviene de la configuración en Colas de Pago.

Acciones y modales ​

  • Aprobar (verificación): llama a POST /v1/assets/executePaymentQueue con la orden seleccionada. No hay modal de confirmación — la acción es inmediata. En caso de éxito, muestra el snackbar "Cola procesada con éxito" y recarga la página; en caso de error, muestra "Error al procesar la cola".

Reglas de negocio / consideraciones ​

Atención

  • La aprobación es inmediata y sin confirmación — un clic ya dispara el pago. Verifique el NFT (Nombre + NFT ID) antes de hacer clic.
  • El backend bloquea el repago: si el NFT ya está pagado, executePaymentQueue rechaza la operación ("It was already paid"). Si el NFT o el tenedor no se encuentran, falla sin pagar.
  • El monto pagado es el price_paid del NFT (lo que el tenedor pagó), no un valor ingresado en la pantalla.
  • Respete el orden: la tabla ya viene priorizada; saltarse filas fuera de orden puede contrariar la precedencia de pago deseada.

Movimiento financiero efectivo

Aprobar una orden paga dinero real al tenedor y le retira el NFT (vuelve al TKN_OWNER). Es una liquidación — trátela como irreversible desde el punto de vista operativo.

  • Valores financieros: el price_paid se trata como BigNumber — sin redondeo. El pago sale de la billetera de la plataforma en la moneda fiduciaria del tenant.
  • Idempotencia: un NFT ya pagado no se paga nuevamente (guarda explícita paid); las transacciones al FinLib siguen la idempotencia por externalId — E00021 ("already processed") es éxito, no falla (ej.: reintento tras crash).
  • Estado APPROVED: el tenedor debe estar aprobado para recibir el pago en su billetera.

Pantallas relacionadas ​