Creación de Órdenes

En el modelo de Inversión Manual, la Wallet crea las órdenes de suscripción y retiro cuando el usuario lo solicita explícitamente a través de la interfaz.

Órdenes de suscripción

Cuando el usuario decide invertir un monto, se debe crear una orden de suscripción utilizando el endpoint /v1/orders/.

Método: POST
URL: /v1/orders/

{
  "account_id": "acct_1wx3ivesBZhaANhq",
  "side": "buy",
  "asset_id": "asset_ailw0majWpcqGk8n",
  "amount": "15000",
  "currency": "COP",
  "responsible_doc_number": "39651529",
  "cvu": "01145678901497543"
}

Parámetro	Descripción
account_id	Identificador de la contrato de inversión
side	Tipo de orden: buy para suscripción
asset_id	Identificador del activo/fondo (opcional, se usa el default)
amount	Monto a suscribir
currency	Moneda
responsible_doc_number	Documento del responsable
cvu	Cuenta bancaria vinculada

Importante

Recomendamos enviar las órdenes al menos 20 minutos antes del cierre del fondo para que se puedan procesar a tiempo.

Órdenes en lote

Si se necesitan crear múltiples órdenes simultáneamente, se puede usar el endpoint de creación en lote (POST /v1/orders/batch_orders/). Se recomienda no superar las 1000 órdenes por lote.

Órdenes de retiro

Cuando el usuario decide retirar fondos, se crea una orden de retiro:

{
  "account_id": "acct_1wx3ivesBZhaANhq",
  "side": "sell",
  "asset_id": "asset_ailw0majWpcqGk8n",
  "amount": "5000",
  "currency": "COP",
  "responsible_doc_number": "39651529",
  "cvu": "01145678901497543"
}

• sell: Retiro parcial por el monto indicado.
• total_sell: Retiro total, liquida el 100% de la posición del cliente en el fondo.

Diferencia con suscripciones

Las órdenes de retiro no requieren transferencia previa. Se crean directamente con estado Lista para enviar.

Ciclo de vida de las órdenes

Suscripción (buy)

Pendiente de validación → Lista para enviar → Enviada a AM → Completa

Retiro (sell / total_sell)

Lista para enviar → Enviada a AM → Cubierta (fitted) → Pago Instruido → Completa

Estado	Descripción
Pendiente de validación	Orden creada, esperando confirmación de pago (solo suscripciones)
Lista para enviar	Orden validada, incluida en la nómina pendiente de envío
Enviada a AM	Orden enviada al Asset Manager
Cubierta (fitted)	El AM confirmó la operación de retiro
Pago Instruido	El AM instruyó el pago del retiro
Completa	Estado final. La operación se liquidó correctamente
Fallida	La orden no pudo procesarse

Simulación de pago en Sandbox

En sandbox, el pago de suscripciones debe simularse manualmente:

Método: POST
URL: /v1/orders/{order_id}/simulate_payment/

info

En producción este endpoint no existe. El pago se realiza mediante transferencia bancaria real.