Asociá una o más cuentas bancarias a una cuenta comitente usando su investment_account_id.

Antes de empezar

1. Creá primero la cuenta comitente y guardá el investment_account_id.
2. Reuní la moneda de la cuenta bancaria en currency_id.
3. Enviá cbu, alias o ambos según la información disponible de la cuenta.
4. Verificá que la cuenta bancaria pertenezca al mismo titular de la cuenta comitente.

Cómo asociar cuentas bancarias

POST /api/accounts/bank-accounts

Qué envía este endpoint

El body acepta un objeto BankAccountsInput con un único campo requerido: bank_accounts.

Estructura de cada objeto bank_account

El schema actual exige investment_account_id y currency_id. Además, en términos operativos conviene enviar al menos uno de estos identificadores bancarios:

• cbu
• alias

Ejemplo de request

{
  "bank_accounts": [
    {
      "investment_account_id": 15,
      "currency_id": "ARS",
      "cbu": "0000003100056132456587",
      "alias": "mi.alias"
    }
  ]
}

Qué devuelve este endpoint

La respuesta devuelve un arreglo items. Cada elemento incluye el resultado de una cuenta bancaria procesada.

Respuesta esperada

{
  "items": [
    {
      "investment_account_id": 15,
      "cbu": "1234567891234567891234",
      "alias": "Alias",
      "bank_account_id": 34,
      "error": null
    }
  ]
}

Si una alta falla, error incluye error_code y message para ese registro.

Errores frecuentes

• 422 Validation Error: revisá campos obligatorios, tipos y formatos como cbu o alias.
• investment_account_not_found: la cuenta comitente enviada no existe.
• account_already_exists: la cuenta bancaria ya está asociada.
• alias_does_not_match o tax_identification_value_does_not_match: la titularidad bancaria no coincide con la cuenta comitente.
• invalid_currency o invalid_bank_entity_id: verificá los valores contra tus tablas maestras o validaciones previas.

Siguiente paso

Después de asociar la cuenta bancaria, consultala con GET /api/accounts/bank-accounts/{bank_account_id} o listá todas las cuentas bancarias de una cuenta comitente con GET /api/accounts/bank-accounts?investment_account_id={investment_account_id}.