Gestionar Escrows

Requisitos previos de acceso

• Permiso (módulo): viewEscrows (para ver) O manageEscrows (para editar/registrar entregas) — basta con uno de los módulos.
• Licencia/Feature: ESCROW
• Contenedor del menú: GENERAL → grupo Operaciones

Qué es / cuándo usar

Panel de seguimiento de los escrows corporativos — operaciones en las que el valor de una negociación entre comprador y vendedor queda retenido (en custodia) hasta que se cumplan las condiciones de entrega. El operador consulta el estado de cada escrow (aceptado, en espera, cancelado, suspendido) y abre los detalles para auditar la transacción y, según su permiso, registrar entregas.

Requisitos previos

• Permiso: viewEscrows para ver; manageEscrows para editar/registrar entregas (permiso doble — enum CPM + módulo dinámico en la BD).
• Licencia/Feature: ESCROW habilitada (sin ella el ítem ni siquiera aparece en el menú).
• Dependencias de otras pantallas: el escrow debe existir previamente (creado a partir de una negociación entre las partes).

Paso a paso

1. Acceda al menú Operaciones → Gestionar Escrows.
2. Busque por correo electrónico del comprador o vendedor y filtre por estado (Todos, Aceptado, En espera, Cancelado, Suspendido).
3. Haga clic en el ícono visualizar para abrir los detalles del escrow.

Filtros y columnas

Filtro/Columna	Qué muestra	Origen del dato
Búsqueda	Filtro local por correo electrónico (comprador o vendedor)	buyer_email / seller_email
Estado	Aceptado / En espera / Cancelado / Suspendido / Todos	status (EscrowBankingStatus)
Vendedor	Correo electrónico del vendedor (tooltip con el ID)	seller_email / seller
Comprador	Correo electrónico del comprador (tooltip con el ID)	buyer_email / buyer
Estado	Estado del escrow	status

Acciones y modales

• Visualizar (visibility): navega a manage-escrows/view/:id con los detalles del escrow (partes, saldo retenido, condiciones, entregas).
• Editar: ruta manage-escrows/edit/:id (disponible según manageEscrows).

El flujo de registrar entrega (update-delivery) es lo que hace avanzar el estado del escrow y, al cumplirse las condiciones, libera el saldo retenido al vendedor.

Reglas de negocio / precauciones

Atención

• El escrow solo libera fondos al vendedor cuando se cumplen las condiciones de entrega — esta pantalla es el punto de auditoría de ese ciclo.
• La búsqueda es local sobre la lista cargada (correo electrónico de comprador/vendedor), combinada con el filtro de estado.

Irreversible

• La liberación del saldo retenido al vendedor (al concluir el escrow) es definitiva. Confirme el cumplimiento de las condiciones antes de avanzar el estado.

• Valores financieros: tratados como BigNumber — sin redondeo; verificar decimales.
• Idempotencia: la liquidación del escrow en FinLib es idempotente por externalId; E00021 "already processed" indica que la liberación ya ocurrió — éxito, no error.
• Estado APPROVED: comprador y vendedor deben estar APPROVED para mover fondos.

Pantallas relacionadas

• Órdenes de la Exchange
• Ingresos de la Plataforma
• Volver al índice Financiero