OMS Compass Documentation
website·Indexed 30 days ago
https://jhennycervera.github.io/OMS-repository-test/docs/introduccionTechnical documentation for OMS Compass, covering mass pre-order generation (Generación Masiva de Pre Órdenes), PICTET DVP assignment configurations, and the activation of confirmations for consolidated broker orders.
What's inside OMS Compass
- When performing a search for bulk pre-order generation, the system allows the selection of more than one asset and more than one portfolio. Users must validate the portfolio positions via the PIVOLT API to ensure data accuracy before proceeding with the bulk pre-order entry process.
Generate unitary pre-orders by quantity
To create a single pre-order, select the specific asset and enter the desired quantity. Upon generating the pre-order, the system updates the corresponding cash balance.Update assets from Pivolt
To update assets with the latest changes from Pivolt, navigate to the Positions menu. This allows you to visualize the account status of investors who hold a selected asset in their portfolios. Clicking the 'Actualizar Activo' (Update Asset) button will synchronize the assets; a success message 'Activos Actualizados' will appear upon completion.Menu Path: Órdenes ➔ Generación Masiva de Órdenes ➔ PosicionesGenerate pre-orders in bulk
Bulk pre-order generation allows the creation of pre-orders across multiple accounts simultaneously. After filling in the required fields and clicking 'Guardar', a 'Guardado' message appears. The system then updates the settlement date values (DO, D1, D2, DN) on the cash screen based on the generated pre-orders.Menu Path: Órdenes ➔ Generación Masiva de Órdenes ➔ PosicionesGenerate bulk buy pre-orders by Cash or NAV percentage
The system allows bulk generation based on percentages:
- % Caja: Pre-orders are only created for accounts that have a defined amount in their Cash (Caja) account. If no amount is defined, the system will trigger a warning notification.
- % NAV: Pre-orders are generated based on a percentage of the Net Asset Value (NAV).
Generate bulk pre-orders by NAV
When generating pre-orders based on Net Asset Value (NAV):
- Single Asset, Multiple Portfolios: If multiple portfolios are selected for one asset, pre-orders are only generated for portfolios that currently hold a position in that asset.
- Mixed Asset Types: When generating for multiple types (Equity, FIncome, Fund, and Option), the system will issue a warning for any asset that does not have a position in a specific portfolio. Pre-orders will not be generated for those without positions, but will be created for those with a 'saved' status.
Generate bulk sell pre-orders by quantity
To generate bulk sell pre-orders for multiple assets (e.g., 1 Equity, 1 Fund, 1 Fixed Income), select the assets and portfolios in the Position tab and click 'Generar Pre-ordenes'. The system will process the sell orders and update the Cash (Caja) balances accordingly.Generate and route mass orders
After pre-orders are created and edited, they can be converted into final orders via Órdenes -> Generación Masiva de Órdenes -> Pre Órdenes.
Once generated, orders are automatically routed based on the counterparty:
- OMS Broker: Orders where the counterparty is 'CGCO' are sent here for approval. Access via Órdenes -> Aprobar Órdenes.
- OMS Ria: Orders where the counterparty is NOT 'CGCO' are sent to the 'Cruzar / Consolidar Órdenes' screen. Access via Órdenes -> Cruzar / Consolidar/ Enviar Órdenes.
Edit pre-orders individually or in bulk
Pre-orders can be managed through two primary methods:
- Unitary Transaction Editing: Allows generating a pre-order after a search and mass selection of portfolios.
- Pre-order View Editing: Supports both unitary and mass editing. When performing a mass edit via the 'Edición Masiva de Pre-ordenes' modal, only the fields explicitly updated in the modal are saved; all other fields retain their original generated values.
Distribute buy pre-orders by position amount
The system supports distributing a total placed amount across multiple pre-orders based on position:
- Same Asset, Different Portfolios: If the same asset is selected across different portfolios, the total amount (e.g., 10,000) is distributed among the pre-orders for each portfolio.
- Different Assets, Different Portfolios: When multiple asset types (FIncome, Fund, Equity, Option) are selected across different portfolios, the total amount (e.g., 20,000) is distributed based on the existing position amounts of those assets within each portfolio.
Create a single pre-order in the OMS
To create a pre-order for a single account, navigate to Órdenes ➔ Generación Masiva de Órdenes ➔ Caja. The input fields are similar to bulk orders but focused on a single entity:
- Transaction Type: Buy, Sell, or Buy/Sell.
- Broker: Routing counterparty (defaults to account custodian if empty).
- Asset: The asset for the pre-order.
- Ingresar por: Processing method (Cantidad, Monto, % Caja, % NAV, or % Posición).
- Monto/ Cantidad/ Tasa: Numerical value for calculation.
- Order Type: Execution type (Mercado, Limit, or Stop).
- Precio Stop/ Limit: Price for Stop/Limit orders.
- Tipo de Envío: Shipping type (Cantidad or Monto).
- Precio Market: Current market price (editable).
- Observación: Associated notes.
Upon saving, the system updates the settlement dates (DO, D1, D2, DN) for the generated pre-order.
Generate mass sale pre-orders by position percentage
When generating sale pre-orders by%Posición, the system only creates pre-orders for assets that currently exist in the portfolio's position. If an asset is missing, the system will display a warning message and skip the pre-order for that specific asset.