Crear operación de FCI

Envía una nueva operación de FCI (fondo común de inversión), ya sea una suscripción o un rescate, para una cuenta determinada.

POST/v1/broker/funds/send

Request

Headers

Campo	Tipo	Requerido	Descripción
Authorization	string	Sí	Token de acceso en formato Bearer ACCESS_TOKEN
Content-Type	string	Sí	Debe ser application/json

No aplica: Path Parameters, Query Parameters.

Body

Rescate vs. suscripción

fund_operation acepta SUBSCRIBE para suscribirse al fondo (comprar cuotapartes), o RETRIEVE para rescatar/retirar una posición existente.

Campo	Tipo	Requerido	Descripción
fund_operation	string	Sí	Tipo de operación. Valores posibles: SUBSCRIBE (suscripción al fondo), RETRIEVE (rescate/retiro del fondo).
bloomberg_code	string	Sí	Identificador Bloomberg del FCI a operar.
account_number	integer	Sí	Número de cuenta sobre la que se ejecuta la operación.
amount	number	Sí	Monto a operar, en la moneda del fondo.
is_total	boolean	Sí	Indica si la operación debe aplicarse sobre la totalidad de la posición (por ejemplo, un rescate total) en lugar del amount indicado.
tag	object	No	Metadatos libres en formato clave-valor para asociar a la operación.

Response

2XX Éxito

Campo	Tipo	Descripción
mutual_fund_id	integer	Identificador de la operación de FCI creada.

Códigos de error

Status	Descripción
400	Bad Request — parámetros inválidos o faltantes, o la cuenta no está habilitada para operar
401	Unauthorized — token de acceso inválido o faltante
403	Forbidden — el token no tiene permiso para acceder a este recurso
500	Internal Server Error

Estructura del error:

{
  "code": "BAD_REQUEST",
  "description": "The account number 4567890123 is not allowed to Operate."
}

Ejemplo de código

cURL

curl -X POST https://b2b.allaria.dev/v1/broker/funds/send \
  -H "Authorization: Bearer ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "fund_operation": "SUBSCRIBE",
    "bloomberg_code": "ALRRFIJA AR",
    "account_number": 4567890123,
    "amount": 10000.00,
    "is_total": false
  }'

JavaScript

const response = await fetch('https://b2b.allaria.dev/v1/broker/funds/send', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer ACCESS_TOKEN',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    fund_operation: 'SUBSCRIBE',
    bloomberg_code: 'ALRRFIJA AR',
    account_number: 4567890123,
    amount: 10000.00,
    is_total: false
  })
});

const data = await response.json();
console.log(data);

Python

import requests

response = requests.post(
  'https://b2b.allaria.dev/v1/broker/funds/send',
  headers={
    'Authorization': 'Bearer ACCESS_TOKEN',
    'Content-Type': 'application/json'
  },
  json={
    'fund_operation': 'SUBSCRIBE',
    'bloomberg_code': 'ALRRFIJA AR',
    'account_number': 4567890123,
    'amount': 10000.00,
    'is_total': False
  }
)

data = response.json()
print(data)

Node.js

const axios = require('axios');

const response = await axios.post(
  'https://b2b.allaria.dev/v1/broker/funds/send',
  {
    fund_operation: 'SUBSCRIBE',
    bloomberg_code: 'ALRRFIJA AR',
    account_number: 4567890123,
    amount: 10000.00,
    is_total: false
  },
  {
    headers: {
      Authorization: 'Bearer ACCESS_TOKEN',
      'Content-Type': 'application/json'
    }
  }
);

console.log(response.data);

2XX Éxito

{
  "mutual_fund_id": 1024
}