Insert Mutual Fund Request

Time	Status	User Agent
Retrieving recent requests…

Enviá una solicitud de suscripción o rescate de un fondo común de inversión usando una cuenta comitente.

Antes de empezar

Tené a mano el investment_account_id de la cuenta comitente que va a operar.
Obtené el mutual_fund_id del fondo con GET /api/instruments/mutual-funds/all.
Definí si la operación va a ser una suscripción (subscription) o un rescate (redemption).
Generá un external_id único para evitar duplicados y poder reconciliar la respuesta.
Si tu cuenta admite método de colocación, definí method_type y bank_account_id cuando corresponda.

Cómo enviar una solicitud de FCI

POST /api/market/fund-requests
Content-Type: application/json

Body parameters

El body acepta un objeto InsertFundInput.

Campo	Tipo	Requerido	Descripción
`investment_account_id`	integer	Sí	Identificador de la cuenta comitente en ApiBroker.
`mutual_fund_id`	integer	Sí	Código del instrumento de FCI.
`fund_operation_type`	string	Sí	Tipo de operación: `subscription` o `redemption`.
`currency_id`	string	Sí	Moneda de la operación.
`amount`	number	No	Importe de la transacción.
`is_total`	boolean	Sí	Indica si el rescate es total o parcial.
`external_id`	string	Sí	Identificador único de la petición.
`by_share_quantity`	boolean	No	Indica si la operación se define por cantidad de cuotapartes.
`share_quantity`	number	No	Cantidad de cuotapartes.
`bank_account_id`	string	No	Cuenta bancaria asociada, compatible con `method_type=SIMPLE`.
`method_type`	string	No	Método de colocación: `SIMPLE` o `ACDI`.

Valores operativos relevantes

fund_operation_type: subscription para suscripciones o redemption para rescates.
method_type:
- SIMPLE: permite operar con intervención bancaria.
- ACDI: opera dentro de la cuenta comitente sin intervención bancaria.

Consideraciones sobre `method_type` y `bank_account_id`

method_type es opcional. Si no lo enviás, el sistema aplica el valor que corresponda según sus validaciones internas.
bank_account_id también es opcional.
bank_account_id solo es compatible con method_type=SIMPLE.
Si la cuenta comitente tiene cuenta cuotapartista, podés usar estos campos para definir el origen o destino de los fondos.

Posibles estados de la solicitud

`fund_request_status_id`	Descripción
`SENDING_PENDING`	Pendiente de envío. Será enviada tan pronto como sea posible.
`RETRY`	Se envió, pero falló y se marcó para reintentar.
`SENT`	Enviada y a la espera de liquidación.
`CANCELLED`	Cancelada manualmente.
`NOT_SENT`	No enviada.
`SETTLED`	Liquidada.
`PARTIALLY_CANCELLED`	Parcialmente cancelada.
`PARTIALLY_SENT`	Parcialmente enviada.
`PARTIALLY_SETTLED`	Parcialmente liquidada.

Consideración sobre rescates parcialmente cancelados

Si un rescate queda en estado PARTIALLY_CANCELLED, evitá enviar de inmediato una nueva solicitud por el mismo fondo y el mismo monto. Mientras el rescate anterior no esté completamente cancelado, la nueva solicitud puede ser rechazada por inconsistencia con la posición actual.

Ejemplo de request

{
  "investment_account_id": 74659,
  "mutual_fund_id": 45,
  "fund_operation_type": "subscription",
  "currency_id": "ARS",
  "amount": 100000,
  "is_total": false,
  "external_id": "fci_ext_123",
  "by_share_quantity": false,
  "share_quantity": 0,
  "method_type": "SIMPLE",
  "bank_account_id": "34"
}

Qué devuelve este endpoint

La respuesta devuelve un arreglo items. Cada elemento representa una solicitud de FCI procesada.

Campo	Tipo	Descripción
`investment_account_id`	integer	Cuenta comitente que envió la solicitud.
`fund_request_id`	integer	Código identificador de la solicitud.
`mutual_fund_id`	integer	Código del instrumento de FCI.
`external_id`	string	Identificador externo enviado en la request.
`fund_operation_type`	string	Tipo de operación.
`currency_id`	string	Moneda de la operación.
`amount`	number	Importe operado.
`is_total`	boolean	Indica si el rescate es total.
`method_type`	string	Método de colocación utilizado.
`bank_account_id`	string	Cuenta bancaria asociada, si corresponde.
`name`	string	Nombre del fondo.
`ticker`	string	Identificador del fondo.
`clazz`	string	Clase del instrumento.
`share_quantity`	number	Cantidad de cuotapartes.
`share_price`	number	Precio de la cuotaparte.
`trade_date`	string	Fecha de concertación.
`settlement_date`	string	Fecha de liquidación.
`created_at`	string	Fecha de creación de la solicitud.
`updated_at`	string	Fecha de última actualización.
`approved`	boolean	Indica si la solicitud fue aprobada.
`fund_request_status_id`	string	Estado actual de la solicitud.

Respuesta esperada

{
  "items": [
    {
      "investment_account_id": 74659,
      "fund_request_id": 2001,
      "mutual_fund_id": 45,
      "external_id": "fci_ext_123",
      "fund_operation_type": "subscription",
      "currency_id": "ARS",
      "amount": 100000,
      "is_total": false,
      "method_type": "SIMPLE",
      "bank_account_id": "34",
      "name": "FCI Renta Pesos",
      "ticker": "FCIRP",
      "clazz": "A",
      "share_quantity": 95.5,
      "share_price": 1047.12,
      "trade_date": "2026-04-17",
      "settlement_date": "2026-04-18",
      "created_at": "2026-04-17T15:30:00Z",
      "updated_at": "2026-04-17T15:30:00Z",
      "approved": true,
      "fund_request_status_id": "SENDING_PENDING"
    }
  ]
}

Errores frecuentes

409 Conflict: ya existe una solicitud con el mismo external_id o hay un conflicto de negocio para la operación.
422 Validation Error: alguno de los campos obligatorios tiene un formato inválido.
500 Internal Server Error: ocurrió un error inesperado durante el procesamiento de la solicitud.

Siguiente paso

Usá GET /api/market/fund-requests/{request_id} para consultar el estado de una solicitud puntual o GET /api/market/fund-requests/fund-requests-by-investment-account/{investment_account_id} para listar solicitudes por cuenta comitente.