Movimientos de Caja

Registra movimientos sobre la caja del cliente: aportes y retiros patrimoniales, retiros automáticos vía Shinkansen y operaciones sobre cuenta remunerada.

🧭

Esta página cubre movimientos de caja. Para órdenes sobre instrumentos ver Órdenes de Renta Variable. Para compra/venta de divisas ver Órdenes FX (Spot).

Flujo estándar

El flujo de movimientos depende del modelo de negocio de cada fintech. Un ejemplo típico:

1. El cliente realiza un aporte sobre su caja
2. La fintech recibe la notificación a través del Sistema de Eventos
3. El cliente realiza una compra de divisas (ver Órdenes FX) o ejecuta una orden de instrumento financiero (ver Órdenes de Renta Variable)
4. Al cerrar la inversión, vende el instrumento o reconvierte la divisa
5. Se realiza el retiro de fondos desde la caja

Operaciones de caja disponibles

Aportes y retiros

Permite registrar aportes o retiros sobre la caja de un cliente.

→ POST /api/publicapi/creasys/Movimientos/IngresoAporteRetiro — Aporte o retiro puntual

→ POST /api/publicapi/creasys/Movimientos/IngresoAporteRetiroMasivo — Aportes o retiros masivos (acepta un array)

Tipos de movimientos y trazabilidad

El campo codTipoMovimiento identifica el tipo de movimiento registrado sobre una cuenta.

Movimientos no liquidados

Corresponden a movimientos que no nacen liquidados y pueden requerir validación o procesamiento posterior antes de quedar en estado final.

Movimientos liquidados

Corresponden a movimientos que nacen automáticamente en estado liquidado, por lo que no requieren validación adicional.

En estos casos, el código puede incorporar un identificador adicional de origen para efectos de trazabilidad.

Formato general:

{TIPO}_{ORIGEN}

Ejemplos genéricos:

• APO_PAT_XX
• RET_PAT_XX

Donde ORIGEN corresponde a un identificador interno del sistema, canal o integración que genera el movimiento.

Otros tipos de movimiento

💡

Los identificadores de origen utilizados en movimientos liquidados son de uso interno y no forman parte de la documentación pública de la API. No todos los movimientos utilizan sufijo de trazabilidad, ya que su uso depende de la configuración aplicable en cada caso.

[
  {
    "uuid": "123-123-123",
    "codTipoMovimiento": "APO_PAT",
    "numCuenta": "XXXXXXX/X",
    "obsMovimiento": "Aporte Patrimonial",
    "fechaMovimiento": "2024-06-11",
    "fechaLiquidacion": "2024-06-11",
    "monto": 1000000,
    "codMoneda": "CLP",
    "dscMedioPagoCobro": "TRANSFERENCIA",
    "banco": "Banco Itaú",
    "numeroCuenta": "XXXXXXXX",
    "tipoCuenta": "Cuenta Corriente"
  }
]

Resultado esperado: el movimiento queda registrado sobre la cuenta con el tipo y trazabilidad correspondiente.

Retiros vía Shinkansen

→ POST /api/publicapi/creasys/Movimientos/IngresoAporteRetiroMasivo

Los retiros vía Shinkansen permiten transferencias bancarias automáticas a cuentas del mismo cliente:

• Montos ≤ 5.000.000 CLP → automáticos e instantáneos
• Montos hasta 7.000.000 CLP → procesamiento aproximado a las 16:00 hrs, requieren firma de apoderado

🚨

Solo se permiten transferencias a cuentas bancarias del mismo cliente, nunca a terceros. El monto total no puede superar las 1.000 UF.

[
  {
    "uuid": "xxx-xxxx-xxxx-xxxx-xxxx-xxxx",
    "codTipoMovimiento": "RET_PAT_BA",
    "numCuenta": "17931004/60",
    "obsMovimiento": "RETIRO PATRIMONIAL SHINKANSEN",
    "fechaMovimiento": "2024-02-06",
    "fechaLiquidacion": "2024-02-06",
    "monto": 1000,
    "codMoneda": "CLP",
    "dscMedioPagoCobro": "TRANSFERENCIA",
    "banco": "Banco BICE",
    "numeroCuenta": "37684701",
    "tipoCuenta": "Cuenta Corriente"
  }
]

Resultado esperado: el retiro queda ingresado para procesamiento bancario y puedes consultar su estado posteriormente.

Aporte/Retiro con cuenta remunerada

→ POST /api/publicapi/creasys/Operaciones/IngresoOperacionCuentaRemunerada

Ingresa una operación de inversión o rescate sobre una cuenta remunerada. El endpoint genera automáticamente:

1. Un movimiento de caja
2. Una orden de compra/venta del instrumento
3. El impacto correspondiente en cartera y caja del cliente

[
  {
    "idOperacion": 0,
    "uuid": "xxx-xxxx-xxxx-xxxx",
    "numCuenta": "12345678/80",
    "codTipoOperacion": "INVERSION",
    "nemotecnico": "VECTOR-A",
    "fechaOperacion": "2024-08-27T20:55:41.260Z",
    "monto": 1000
  }
]

Resultado esperado: se genera el movimiento de caja y la orden financiera asociada en la cuenta del cliente.

Próximos pasos