Órdenes del Exchange
Requisitos previos de acceso
- Permiso (módulo):
viewExchangeOrdersJournal(para ver el listado). La cancelación de orden exige el módulootcAdmin. - Licencia/Feature:
EXCHANGE - Contenedor del menú: GENERAL → grupo Operaciones
Qué es / cuándo usar
Libro mayor administrativo de órdenes del exchange (order book) — todas las órdenes de compra y venta publicadas por los usuarios en el book P2P/OTC. El operador consulta el estado de las órdenes (creada, ejecutada, cancelada), inspecciona los matches (ítems casados) de cada orden y, con perfil otcAdmin, cancela órdenes aún abiertas (created).
Requisitos previos
- Permiso:
viewExchangeOrdersJournalpara ver;otcAdminpara cancelar (permiso doble — enum CPM + módulo dinámico en la DB). - Licencia/Feature:
EXCHANGEhabilitada (sin ella, el ítem ni siquiera aparece en el menú). - Dependencias de otras pantallas: las órdenes son generadas por los usuarios en la app/trade.
Paso a paso
- Acceda al menú Operaciones → Órdenes del Exchange.
- Filtre por estado (Todos, Creada, Ejecutada, Cancelada) y tipo (Todos, Compra, Venta). La búsqueda tiene debounce (~1s).
- Haga clic en el ícono de recibo para ver los ítems/matches de la orden (cuando existan).
- Para una orden en Creada, con
otcAdmin, haga clic en block para cancelar.
Filtros y columnas
| Filtro/Columna | Qué muestra | Origen del dato |
|---|---|---|
| Búsqueda | Filtro del book (debounce ~1s) | searchInput → getAllOrdersBookAdmin |
| Estado | Creada / Ejecutada / Cancelada / Todos | selectedStatus (OrderBookStatus) |
| Tipo | Compra / Venta / Todos | selectedType (OrderBookType) |
| ID | Identificador de la orden | id |
| Fecha | Fecha/hora de la orden | when |
| Usuario | Quién publicó la orden | userName |
| Tipo | Compra/Venta | type |
| Precio | Precio límite de la orden | price (6 decimales) |
| Moneda | Unidad negociada | unitOfMoney |
| Estado | Estado de la orden | status |
Acciones y modales
- Cancelar (block): solo aparece para órdenes en
CREATEDy con permisootcAdmin. Abre un bottom-sheet de confirmación →cancelOrderBookAdmin(id). Cancela la orden en el OrderBookControlService y devuelve la reserva. - Ver ítems (receipt): abre el modal de matches de la orden (
items), mostrando qué contrapartes casaron y a qué precios.
Reglas de negocio / precauciones
Atención
- La cancelación solo es posible en órdenes abiertas (
created); las órdenes ya ejecutadas son inmutables. - El precio mostrado es el precio límite de la orden, no necesariamente el precio de ejecución de cada match.
Ingreso de la casa (spread límite × ejecución)
- En la liquidación, el monto pagado al vendedor usa el precio límite (
order.price), nunca el precio de ejecución (executionPrice). Cuando hay diferencia entre el límite y la ejecución, la casa captura el delta como ingreso. Al auditar los números, no extrañe la diferencia: el vendedor recibe al precio límite, y el spread es apropiado por la plataforma.
- Valores financieros: tratados como BigNumber — sin redondeo; el precio se muestra con 6 decimales.
- Idempotencia: la liquidación de órdenes es idempotente por
externalIden FinLib;E00021"already processed" indica liquidación ya realizada — éxito.