Gestión de Cuentas

Una vez registrado el cliente, gestiona su operativa creando una cuenta de inversión, asociando su cuenta bancaria y habilitando cajas por moneda.

🧭
Flujo base: Crear cuenta de inversión → Asociar cuenta bancaria → Crear cajas por moneda.

Cuenta de inversión vs cuenta bancaria

Son dos cosas distintas. La cuenta de inversión vive dentro de Voultech; la cuenta bancaria es la cuenta del cliente en su banco, sólo se asocia para mover plata entre el banco y Voultech.

	Cuenta de inversión	Cuenta bancaria
Endpoint	`POST /Cuentas`	`POST /CuentaCorriente`
Qué representa	Cuenta operativa del cliente dentro de Voultech (donde se administra la inversión, las cajas y la cartera)	Cuenta del cliente en un banco (BICE, Itaú, Santander, etc.)
Identificador	`numCuenta` (ej. `12345678/17`) — generado por la fintech	`numeroCuentaCte` — número real del cliente en el banco
Para qué sirve	Operar: comprar/vender instrumentos, registrar movimientos, ver cartera	Recibir abonos del cliente y ejecutar retiros hacia el cliente
Cuántas puede tener	Varias por cliente (distintos perfiles, monedas, mercados)	Varias por cliente (distintos bancos o monedas)

Operaciones disponibles

Cuentas de inversión

Crea y consulta cuentas asociadas a un cliente.

Cuentas bancarias

Vincula la cuenta bancaria utilizada para abonos y retiros.

Cajas por moneda

Habilita saldos separados por divisa dentro de una cuenta.

Crear cuenta de inversión

→ POST /api/publicapi/creasys/Cuentas

Crea una cuenta individual de inversión para un cliente existente, asociada a tu fintech como asesor.

Ver campos del body

Campo	Descripción
`numCuenta`	Identificador único de la cuenta (ej. `12345678/17`)
`dscCuenta`	Nombre descriptivo de la cuenta
`abrCuenta`	Abreviatura, usualmente igual a `numCuenta`
`identificador`	RUT del cliente (debe existir)
`codMoneda`	Moneda base: `CLP`, `USD`, `EUR`
`codTipoAdministracion`	Tipo de administración (`NF` por defecto)
`dscPerfilRiesgo`	Perfil de riesgo: `CONSERVADOR`, `MODERADO`, `ARRIESGADO`, `AGRESIVO`, `CALIFICADO`
`dscTipoCuenta`	Tipo: `NACIONAL`, `FIP`, `EXTRANJERA`, `PERSHING`
`abrAsesor`	Código de asesor vinculado a tu fintech

{
  "numCuenta": "12345678/17",
  "dscCuenta": "Javiera Río Casanova",
  "abrCuenta": "12345678/17",
  "identificador": "12345678-K",
  "codMoneda": "CLP",
  "codTipoAdministracion": "NF",
  "dscPerfilRiesgo": "AGRESIVO",
  "dscTipoCuenta": "NACIONAL",
  "abrAsesor": "TU_CODIGO_ASESOR"
}

💡
Consulta valores válidos con GET /Moneda, GET /PerfilRiesgo, GET /TipoCuenta. Ver Listados del Sistema.

Respuesta exitosa: 201 Created. La cuenta queda creada y asociada al cliente.

Consultar cuentas

→ GET /api/publicapi/creasys/Cuentas?identificador={RUT}

Retorna todas las cuentas asociadas al cliente identificado.

[
  {
    "numCuenta": "12345678/17",
    "dscCuenta": "Javiera Río Casanova",
    "abrCuenta": "12345678/17",
    "identificador": "12345678-K",
    "codMoneda": "CLP",
    "codTipoAdministracion": "NF",
    "dscPerfilRiesgo": "AGRESIVO",
    "dscTipoCuenta": "NACIONAL",
    "abrAsesor": "TU_CODIGO_ASESOR"
  }
]

Resultado esperado: detalle de cuentas asociadas al cliente.

Asociar cuenta bancaria

→ POST /api/publicapi/creasys/CuentaCorriente

Vincula la cuenta bancaria del cliente para recibir abonos y ejecutar retiros.

Ver campos del body

Campo	Descripción
`identificador`	RUT del cliente
`numeroCuentaCte`	Número de cuenta bancaria
`codMoneda`	Moneda: `CLP`, `USD`, `EUR`
`dscBanco`	Nombre del banco (ej. `BANCO BICE`)
`tipoCuenta`	`Cuenta Corriente`, `Cuenta Vista`, `Cuenta de Ahorro`, `Chequera`, `Electrónica`
`codEstado`	Estado de la cuenta (opcional)

{
  "identificador": "18737322-0",
  "numeroCuentaCte": "11111111112",
  "codMoneda": "CLP",
  "dscBanco": "BANCO BICE",
  "tipoCuenta": "Cuenta Corriente"
}

💡
Consulta los bancos válidos con GET /Banco y los tipos de cuenta bancaria con GET /TipoCuentaBanco.

Resultado esperado: la cuenta bancaria queda asociada al cliente y disponible para abonos/retiros.

Consultar cuenta bancaria

→ GET /api/publicapi/creasys/CuentaCorriente?numCuenta={numCuenta}

Devuelve la cuenta bancaria asociada a la cuenta de inversión consultada.

Resultado esperado: datos de la cuenta bancaria vinculada.

Crear caja por moneda

→ POST /api/publicapi/creasys/Cajas

Habilita una caja en una moneda específica dentro de la cuenta de inversión. Las cajas representan los saldos disponibles por divisa.

Ver campos del body

Campo	Descripción
`numCuenta`	Cuenta de inversión a la que se asocia la caja
`codMoneda`	Moneda de la caja (`CLP`, `USD`, `EUR`)
`codMercado`	Mercado asociado a la caja

{
  "numCuenta": "12345678/17",
  "codMoneda": "USD",
  "codMercado": "EXT"
}

💡
Una cuenta puede tener múltiples cajas en distintas monedas. Las cajas en CLP suelen crearse automáticamente al crear la cuenta; el resto se crean según necesidad operativa.

Resultado esperado: la cuenta dispondrá de una caja adicional para operar en la moneda indicada.

Consultar cajas

Para revisar saldos de las cajas, ver la sección Consultas Operativas que cubre GET /Cajas, GET /Cajas/ConSaldo y GET /Cajas/ConSaldoOnline.

Próximos pasos

Movimientos de Caja

Aportes, retiros y cuenta remunerada.

Órdenes de Renta Variable

Ingresa y anula órdenes de compra/venta de instrumentos.

Órdenes FX (Spot)

Compra y venta de divisas con liquidación spot.

Cuentas Internacionales (Alpaca)

Apertura de cuentas para operar instrumentos en mercados internacionales.