Crea una o más cuentas comitentes en la versión 2 y obtén el investment_account_id para asociar cuentas bancarias y continuar otros flujos.

Antes de empezar

1. Creá primero la persona con 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.
5. Prepará investment_profile con la versión vigente de preguntas de perfil inversor de tu integración.

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": 3,
  "5": 2
}

En v2, usá la versión vigente de preguntas y respuestas definida para tu integración. Si tu implementación depende de tablas maestras, verificá que el versionado del cuestionario coincida con el que estás usando antes de enviar la solicitud.

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": "TI"
        }
      ],
      "referral_code": "CLIENT"
    }
  ]
}

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 y a la versión vigente del cuestionario.

Siguiente paso

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