Órdenes FX (Spot)

Registra operaciones spot de compra o venta de divisas. Voultech resuelve el precio contra la API FX, valida la operación en GPI y confirma en el execution venue FX.

Ingresar orden Spot

→ POST /api/publicapi/creasys/Operaciones/OrdenSpot

Ver parámetros

Parámetro	Tipo	Obligatorio	Descripción
`NumeroCuenta`	string	Sí	Número de cuenta (máx. 15)
`Uuid`	string	Sí	Identificador único generado por el integrador (máx. 30) — para trazabilidad e idempotencia
`TipoOrden`	string	Sí	`Compra` o `Venta` — exactamente así, con mayúscula inicial
`TipoPrecio`	string	Sí	`Mercado`, `Limite` o `Quote`
`Spread`	decimal	Sí	Enviar siempre un valor numérico válido
`PrecioLimite`	decimal	Condicional	Obligatorio y > 0 si `TipoPrecio = Limite`
`IdCotizacion`	string	Condicional	Obligatorio si `TipoPrecio = Quote`
`MonedaOrigen`	string	Sí	Código moneda origen (ej. `USD`)
`MonedaDestino`	string	Sí	Código moneda destino (ej. `CLP`)
`MontoOrigen`	decimal	Sí	Monto en moneda origen (≥ 0)
`MontoDestino`	decimal	Sí	Monto en moneda destino (≥ 0)
`FechaLiquidacion`	date	Sí	Fecha de liquidación (YYYY-MM-DD)

Modos de precio

`TipoPrecio`	Comportamiento
`Mercado`	El backend obtiene precio de mercado vía API FX. Usa `Offer` para compra, `Bid` para venta
`Limite`	Requiere `PrecioLimite > 0`. No puede comprar sobre el `Offer` ni vender bajo el `Bid`
`Quote`	Requiere `IdCotizacion`. Obtiene el precio por ID de cotización

{
  "NumeroCuenta": "17931004/80",
  "Uuid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "TipoOrden": "Compra",
  "TipoPrecio": "Mercado",
  "Spread": 0.5,
  "MonedaOrigen": "USD",
  "MonedaDestino": "CLP",
  "MontoOrigen": 1000,
  "MontoDestino": 950000,
  "FechaLiquidacion": "2026-06-18"
}

{
  "fxOrderId": "fx-order-abc123",
  "resultado": [
    {
      "operacionSpotApis": {},
      "resultado": [
        {
          "tipoAlert": "success",
          "observacion": "...",
          "error": null
        }
      ]
    }
  ]
}

⚠️
Una respuesta 200 indica que la orden fue aceptada y enviada a FX, no que ya se ejecutó. Inspecciona siempre el campo resultado — si la persistencia local tuvo problemas, el endpoint igual devuelve 200 pero resultado lo refleja.

Códigos de respuesta

Código	Causa
`200 OK`	Orden enviada correctamente. Revisar `resultado` de todas formas
`207 Multi-Status`	La validación local detectó incidencias antes de enviar a FX
`400 Bad Request`	`TipoPrecio` ausente, `PrecioLimite` inválido, conflicto con precio de mercado, o fallo en la API FX
`404 Not Found`	No existe cuenta con el `NumeroCuenta` indicado

Próximos pasos

Movimientos de Caja

Aportes, retiros y operaciones sobre la caja del cliente.

Órdenes de Renta Variable

Ingresa y anula órdenes sobre instrumentos.

Sistema de Eventos

Recibe notificaciones cuando se ejecutan operaciones en tiempo real.