Órdenes de Renta Variable

Estos servicios cubren el ciclo de vida de una orden de renta variable: ingresarla, consultar su estado y anularla si es necesario.

Ingresar una orden

Ordenes/ingresarOrden recibe un arreglo Ordenes. Cada orden identifica al cliente por su documento y portafolio, e indica la operación de compra o venta con el instrumento, cantidad, precio y condiciones.

Campos centrales de cada orden:

• DocumentoIdentidad y CodigoPortafolio — el titular y la cuenta sobre la que se opera.
• Operacion — C (compra) o V (venta).
• Instrumento — el nemotécnico (por ejemplo, LTM, AAPL).
• Cantidad y PrecioOrden.
• IdTipoPrecio — L (límite) o M (mercado).
• IdCondicionDeLiquidacion — T0 a T7, OT u otras según el tipo de liquidación.
• IdTipoVigencia — SH (solo hoy), FF (fecha fija), SE (semanal), OP (permanente).
• IdBolsa — la bolsa donde se cursa (BCS, BEC, NYE, NDQ, etc.).

{
  "IdEmpresa": 1,
  "IdUsuario": "TU_USUARIO",
  "ClaveUsuario": "TU_CLAVE",
  "SimularOperacion": "N",
  "Ordenes": [
    {
      "IdInterno": 1,
      "TipoDocumentoIdentidad": "R",
      "DocumentoIdentidad": "9384769-5",
      "CodigoPortafolio": "1",
      "Operacion": "C",
      "Instrumento": "LTM",
      "Cantidad": 50000,
      "PrecioOrden": 50000,
      "IdTipoPrecio": "L",
      "IdCondicionDeLiquidacion": "T2",
      "IdTipoVigencia": "SH",
      "IdBolsa": "BCS"
    }
  ]
}

Simular antes de cursar

El campo SimularOperacion te permite validar una orden sin ejecutarla: envíalo en S para que el sistema calcule y valide sin cursar, y en N para el ingreso real. Útil para mostrar al cliente montos y cobros estimados antes de confirmar.

Consultar órdenes

Ordenes/consultarOrdenes devuelve las órdenes de un cliente con su estado. Filtra por DocumentoIdentidad, IdOrden, IdEstadoOrden, CodigoPortafolio, Instrumento, rango de fechas (FechaInicioConsulta / FechaTerminoConsulta) y más.

{
  "IdEmpresa": 1,
  "IdUsuario": "TU_USUARIO",
  "ClaveUsuario": "TU_CLAVE",
  "Clientes": [
    {
      "IdInterno": 1,
      "Filtro": "DocumentoIdentidad;FechaInicioConsulta;FechaTerminoConsulta",
      "Valor": "1-9;2021-03-01;2021-03-08"
    }
  ]
}

Anular una orden

Ordenes/anularOrden cancela una orden vigente. Se identifica por su IdOrden (el que obtuviste al ingresarla o consultarla) y admite un MotivoAnulacion.

{
  "IdEmpresa": 1,
  "IdUsuario": "TU_USUARIO",
  "ClaveUsuario": "TU_CLAVE",
  "Ordenes": [
    { "IdOrden": 89421, "MotivoAnulacion": "Datos equivocados" }
  ]
}

Solo pueden anularse órdenes que aún estén en un estado que lo permita; si la orden ya se ejecutó, la anulación será rechazada y el detalle vendrá en Mensajes.

Flujo recomendado

Consulta el portafolio del cliente, simula la orden para confirmar montos, ingrésala, y usa consultarOrdenes para hacer seguimiento del estado. Anula solo si la orden sigue viva.

Es relevante considera que una alternativa a rutear directamente es generar un consolidado con la instrucción de inversión, para que se ejecute en bloque y luego se hace la asignación por cliente.