Órdenes Internacionales

Envía órdenes de compra/venta para activos internacionales (ALPACA) usando el mismo endpoint que las órdenes nacionales, cambiando solo codBolsa y algunos parámetros.

⚠️
La ejecución no es inmediata. La confirmación llega de forma asíncrona vía Service Bus.

Ingresar orden

→ POST /api/publicapi/creasys/Ordenes/IngresarOrdenesMercado

Ingresa órdenes para cuentas nacionales (XSGO) o internacionales (ALPACA) en el mismo endpoint. Solo cambia codBolsa y algunos parámetros específicos.

Ver parámetros

Parámetro	Obligatorio	Descripción
`uuid`	Sí	Identificador único de la orden (idempotencia)
`numCuenta`	Sí	Número de cuenta del cliente (`xxxxx/x`)
`nemotecnico`	Sí	Símbolo o ticker del activo
`tipoSeguridad`	Sí	Para ALPACA usar `"CS"` (Common Stock)
`tipoOperacion`	Sí	`C` = Compra, `V` = Venta
`modalidadOrden`	Sí	`"CANTIDAD"`
`cantidad`	Sí	Cantidad de títulos (mayor a 0)
`monto`	Sí	Monto total de la operación
`precio`	Condicional	Requerido si `tipoPrecio = LIMIT`, debe ser > 0
`tipoPrecio`	Sí	`MARKET` o `LIMIT`. Con `MARKET` no enviar `precio`
`codBolsa`	Sí	`XSGO` para nacional, `ALPACA` para internacional
`tipoLiquidacion`	Sí	Para ALPACA usar `"T2"`
`comision`	Sí	Comisión local. Usar `0` en QA
`comisionInternacional`	Sí	Comisión Alpaca. Usar `0` en QA; en producción definir el monto
`tipoComisionInternacional`	Sí	`notional` / `bps` / `qty`. Usar `"notional"` en QA

🧪
QA (Sandbox): Alpaca no permite cobrar comisión en el entorno de certificación. Envía siempre comision: 0, comisionInternacional: 0 y tipoComisionInternacional: "notional".
Producción: Define el monto y tipo de comisión libremente:

comisionInternacional → monto de la comisión

tipoComisionInternacional → notional (monto fijo en USD), bps (puntos base sobre el monto), qty (por cantidad de títulos)

[
  {
    "uuid": "550e8400-e29b-41d4-a716-446655440021",
    "numCuenta": "18784154/0",
    "nemotecnico": "AMZN",
    "modalidadOrden": "CANTIDAD",
    "cantidad": 1,
    "precio": 180,
    "monto": 180.00,
    "tipoPrecio": "LIMIT",
    "tipoOperacion": "C",
    "tipoSeguridad": "CS",
    "tipoLiquidacion": "T2",
    "codBolsa": "ALPACA",
    "comision": 0,
    "comisionInternacional": 0,
    "tipoComisionInternacional": "notional"
  }
]

[
  {
    "uuid": "550e8400-e29b-41d4-a716-446655440022",
    "numCuenta": "18784154/0",
    "nemotecnico": "AAPL",
    "modalidadOrden": "CANTIDAD",
    "cantidad": 2,
    "monto": 430.00,
    "tipoPrecio": "MARKET",
    "tipoOperacion": "C",
    "tipoSeguridad": "CS",
    "tipoLiquidacion": "T2",
    "codBolsa": "ALPACA",
    "comision": 0,
    "comisionInternacional": 0,
    "tipoComisionInternacional": "notional"
  }
]

📌
En MARKET no se envía precio. La orden se ejecuta al mejor precio disponible.

[
  {
    "uuid": "550e8400-e29b-41d4-a716-446655440021",
    "mensaje": "Orden internacional procesada correctamente.",
    "exitoso": true,
    "uuidBolsa": null
  }
]

⚠️
La respuesta exitosa significa que la orden fue aceptada para enviarse a Alpaca, no que ya se ejecutó. La confirmación de ejecución llega vía Service Bus de forma asíncrona.

Diferencias clave: nacional vs. internacional

Campo	Nacional (XSGO)	Internacional (ALPACA)
`codBolsa`	`XSGO`	`ALPACA`
`tipoSeguridad`	varía según instrumento	`CS`
`tipoLiquidacion`	varía	`T2`
Horario	bolsa local	mercado USA (lun-vie 14:30–21:00 UTC)
Confirmación	Service Bus	Service Bus

Flujo recomendado

Verifica que el mercado esté abierto con GET /ClockAlpaca
Busca el ticker disponible con GET /Asset?search=... o GET /Asset?nemo=...
Consulta la cotización actual con GET /Asset/LastQuote?nemo=...
Generá un uuid único (idempotencia)
Envía la orden con POST /Ordenes/IngresarOrdenesMercado
Espera la confirmación de ejecución vía Service Bus
Consulta la posición resultante con GET /CuentaAlpaca/Custodias/{numCuenta}

Errores comunes

Código	Descripción
`401 Unauthorized`	Token expiró
`403 Forbidden`	Sin acceso a la cuenta
`500 Server Error`	Fallo al enviar a Alpaca