Creación de Órdenes
En el modelo de Inversión Manual, la Wallet crea las órdenes de suscripción y rescate 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": "ARS",
"responsible_doc_number": "39651529",
"cvu": "01145678901497543"
}
| Parámetro | Descripción |
|---|---|
account_id | Identificador de la cuenta cuotapartista |
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 | CVU de la cuenta bancaria vinculada |
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 rescate
Cuando el usuario decide retirar fondos, se crea una orden de rescate:
{
"account_id": "acct_1wx3ivesBZhaANhq",
"side": "sell",
"asset_id": "asset_ailw0majWpcqGk8n",
"amount": "5000",
"currency": "ARS",
"responsible_doc_number": "39651529",
"cvu": "01145678901497543"
}
sell: Rescate parcial por el monto indicado.total_sell: Rescate total, liquida el 100% de la posición del cliente en el fondo.
Las órdenes de rescate 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 SG → Completa
La orden de suscripción queda en Pendiente de validación hasta que se confirme el pago. Una vez confirmado, pasa a Lista para enviar y se incluye en la próxima nómina.
Rescate (sell / total_sell)
Lista para enviar → Enviada a SG → 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 SG | Orden enviada a la Sociedad Gerente / Asset Manager |
| Cubierta (fitted) | La SG confirmó la operación de rescate |
| Pago Instruido | El ACDI/AM instruyó el pago del rescate |
| 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 para que la orden avance:
Método: POST
URL: /v1/orders/{order_id}/simulate_payment/
En producción este endpoint no existe. El pago se realiza mediante transferencia bancaria real.