Movimientos Internacionales

Registra y consulta movimientos patrimoniales internacionales entre cuentas locales y cuentas Alpaca.

Operaciones disponibles

Aporte o retiro patrimonial entre cuenta local y Alpaca.

Listado por cuenta con filtros opcionales.

Registrar movimiento internacional

→ POST /api/publicapi/creasys/MovimientosAlpaca/MovimientoInternacionalAlpaca

Registra un movimiento internacional de tipo retiro o aporte patrimonial entre cuentas locales y cuentas Alpaca.

Tipos de movimiento

Código	Descripción
`APO_PAT_IT`	Aporte patrimonial (Voultech → Alpaca)
`RET_PAT_IT`	Retiro patrimonial (Alpaca → Voultech)

Ver parámetros

Parámetro	Tipo	Obligatorio	Descripción
`codTipoMovimiento`	string	Sí	`APO_PAT_IT` o `RET_PAT_IT`
`numCuenta`	string	Sí	Número de cuenta (máx. 15 caracteres)
`monto`	decimal	Sí	Monto del movimiento (> 0)
`codMoneda`	string	Sí	Código de moneda (máx. 3 caracteres, ej: `USD`)
`obsMovimiento`	string	No	Observaciones (máx. 100 caracteres)
`dscMedioPagoCobro`	string	No	Medio de pago/cobro (máx. 20 caracteres)
`id`	int	No	ID asociado
`uuid`	string	No	UUID para trazabilidad e idempotencia

{
  "codMoneda": "USD",
  "monto": 5,
  "numCuenta": "18784154/0",
  "id": 864857,
  "codTipoMovimiento": "RET_PAT_IT",
  "obsMovimiento": "Retiro a caja USD",
  "dscMedioPagoCobro": "TRANSFERENCIA"
}

{
  "id": 14380256,
  "codTipoMovimiento": "RET_PAT_IT",
  "numCuenta": "18784154/0",
  "fechaMovimiento": "2025-12-01T00:00:00-03:00",
  "monto": 5,
  "codMoneda": "USD",
  "uuidJournal": "85de80c1-5389-4e0e-a9a9-3b5cab378121"
}

💡
Usa uuid para mantener trazabilidad e idempotencia sobre cada movimiento internacional registrado.

Consultar movimientos patrimoniales por cuenta

→ GET /api/publicapi/creasys/MovimientosAlpaca/patrimoniales/{numCuenta}

Listado de movimientos patrimoniales para una cuenta específica, con filtros opcionales.

Ver parámetros

Parámetro	Tipo	Descripción
`numCuenta` (path)	string	Número de cuenta Voultech
`idMovimiento`	int	ID específico del movimiento
`fechaDesde`	date	Fecha inicial del rango (YYYY-MM-DD)
`fechaHasta`	date	Fecha final del rango (YYYY-MM-DD)
`CuentaOrigen`	string	UUID de cuenta origen en Alpaca
`CuentaDestino`	string	UUID de cuenta destino en Alpaca
`estadoActual`	string	Estado del journal: `executed`, `pending`, `canceled`

[
  {
    "idMovimiento": 14380227,
    "fechaMovimiento": "2025-12-01T00:00:00",
    "codOrigen": "RET_PAT_IT",
    "monto": 5.0,
    "descripcion": "RETIRO PATRIMONIAL ALPACA",
    "entryType": "JNLC",
    "cuentaOrigen": "57c57391-426b-3474-99d7-d94830d0447e",
    "cuentaDestino": "5d2b13eb-0765-4364-8115-a65c7695303d",
    "journalAmount": 5.0,
    "estadoActual": "executed",
    "numeroCuenta": "18784154/0"
  }
]

Campos destacados

Campo	Descripción
`idMovimiento`	ID del movimiento
`codOrigen`	Tipo de movimiento (`APO_PAT_IT`, `RET_PAT_IT`)
`entryType`	Tipo de entry de Alpaca (ej: `JNLC`)
`cuentaOrigen`	UUID de cuenta Alpaca origen
`cuentaDestino`	UUID de cuenta Alpaca destino
`estadoActual`	`executed`, `pending`, `canceled`

Flujo recomendado

Aporte (Voultech → Alpaca)

El cliente deposita CLP/USD en su cuenta Voultech
Registra el aporte con POST /MovimientosAlpaca/MovimientoInternacionalAlpaca con codTipoMovimiento: APO_PAT_IT
Guarda el uuid y id retornados
Espera confirmación asíncrona

Retiro (Alpaca → Voultech)

El cliente solicita un retiro
Registra el retiro con codTipoMovimiento: RET_PAT_IT
Verifica el estado consultando GET /MovimientosAlpaca/patrimoniales/{numCuenta} con estadoActual=executed

Relación con otros componentes

Usa Cuentas Internacionales para validar el saldo antes de procesar un retiro
Consulta Actividad y Custodias para ver el detalle del JNLC asociado