Crea una o más cuentas comitentes y obtén el investment_account_id para asociar cuentas bancarias y otros flujos posteriores.

Antes de empezar

1. Creá primero la persona con POST /api/accounts/persons o POST /api/accounts/v2/persons y guardá el person_id.
2. Reuní el person_account_type_id y los person_role_id que correspondan según tus tablas maestras.
3. Armá el arreglo investment_accounts con entre 1 y 10 cuentas.
4. Definí al menos un titular en owners para cada cuenta.

Qué envía este endpoint

El body acepta un objeto AccountsInput con un único campo requerido: investment_accounts.

Estructura de cada objeto investment_account

Objeto investment_profile

investment_profile representa las respuestas al cuestionario del perfil inversor. Cada clave es el identificador de una pregunta y cada valor es la opción elegida.

{
  "1": 1,
  "2": 1,
  "3": 4,
  "4": 2,
  "5": 1 
}

Usá las preguntas y opciones vigentes de tu integración para construir este objeto antes de crear la cuenta.

Objeto owners

Cada elemento del arreglo owners representa una persona vinculada a la cuenta.

Ejemplo de request

{
  "investment_accounts": [
    {
      "external_id": "ext_001",
      "person_account_type_id": "PFL",
      "investment_profile": {
        "1": 1,
        "2": 1,
        "3": 4,
        "4": 3,
				"5": 2
      },
      "market_type": [
        "stock_market"
      ],
      "owners": [
        {
          "person_id": "F-6bf4c899-c3ad-421d-a276-cfcd0f7ec48a",
          "person_role_id": "TIT"
        }
      ]
    }
  ]
}

Respuesta esperada

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

{
  "items": [
    {
      "external_id": "ext_001",
      "investment_account_id": 2,
      "investment_risk_profile": "MODERATE",
      "error": null
    }
  ]
}

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

Qué significa la respuesta

• external_id: el identificador que enviaste en la request.
• investment_account_id: identificador interno de la cuenta comitente creada.
• investment_risk_profile: perfil de riesgo calculado a partir de investment_profile.
• error: detalle del error para esa cuenta, si no pudo procesarse.

Errores frecuentes

• 422 Validation Error: revisá campos obligatorios, tipos y estructura del body.
• external_id_already_exists: ya existe una cuenta creada con ese external_id.
• person_not_found: alguno de los person_id enviados no existe.
• multiple_owners, no_owner o invalid_person_role_id: revisá la composición del arreglo owners y los roles enviados.
• invalid_account_type o invalid_answer_investor_question: verificá que los códigos y respuestas correspondan a las tablas maestras vigentes.

Siguiente paso

Después de crear la cuenta comitente, usá el investment_account_id para consultar la cuenta, o asociar una cuenta bancaria con POST /api/accounts/bank-accounts.