Guía de Inicio Rápido

Completa tu primera integración con la API de Voultech: autentícate, consulta parámetros válidos, registra un cliente, crea su cuenta y confirma el primer aporte.

Antes de empezar

1. Solicita al equipo de Voultech tus credenciales de Sandbox: userName, password y abrAsesor (código de asesor).
2. Guarda abrAsesor, porque lo usarás al crear el cliente y la cuenta.
3. Ejecuta los pasos en este orden para validar el flujo completo de punta a punta.

Paso 1: Autentícate

Envía tus credenciales al endpoint SignIn para obtener un Bearer Token que incluirás en todas las llamadas posteriores.

→ POST /api/publicapi/shared/auth/SignIn

{
  "userName": "tu_usuario_sandbox",
  "password": "tu_contraseña_sandbox"
}

{
  "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
  "expiration": "2025-10-21T18:00:00Z"
}

Resultado: ya puedes autenticar las llamadas siguientes con Authorization: Bearer {tu_token}.

Agrega el token en todas las solicitudes siguientes con este header:

Authorization: Bearer {tu_token}

🔄

Si tu token está por expirar, renuévalo con GET /api/publicapi/shared/auth/RefreshToken sin necesidad de volver a iniciar sesión.

Paso 2: Consulta los parámetros del sistema

Antes de crear clientes o cuentas, necesitas los códigos válidos que el sistema espera. No puedes enviar "Santiago" como texto libre — debes enviar el idComunaCiudad correspondiente.

Ejemplo: Obtener monedas disponibles

→ GET /api/publicapi/creasys/Moneda

[
  { "codMoneda": "CLP", "dscMoneda": "PESO CHILENO" },
  { "codMoneda": "USD", "dscMoneda": "DÓLAR USA" }
]

Resultado: ya tienes los códigos válidos que necesitas para crear el cliente, la cuenta y los movimientos.

Paso 3: Registra tu primer cliente

Con los códigos obtenidos, registra el cliente en el sistema, carga sus documentos y crea su cuenta de inversión.

3.1 Crear el cliente

→ POST /api/publicapi/creasys/Clientes

{
  "persona": {
    "identificador": "11111111-1",
    "tipoIdentificador": "R",
    "tipoEntidad": "N",
    "nombre": "Ana",
    "paterno": "Prueba",
    "email": "[email protected]",
    "direccionPersona": [
      {
        "direccion": "Av. Siempre Viva 123",
        "idComunaCiudadNavigation": {
          "dscComunaCiudad": "Santiago",
          "idRegionNavigation": {
            "dscRegion": "Metropolitana",
            "codPaisNavigation": {
              "dscPais": "CHILE"
            }
          }
        }
      }
    ]
  },
  "asesor": [
    { "abrNombre": "TU_CODIGO_ASESOR" }
  ]
}

Si la creación fue exitosa, recibirás una respuesta 201 Created.

Resultado: el cliente queda registrado para continuar con la carga de documentos y la apertura de cuenta.

3.2 Subir documentos

Sube la documentación requerida (cédula, contrato) codificada en Base64.

→ POST /api/publicapi/creasys/Documentos

{
  "Identificador": "11111111-1",
  "TipoDocumento": ".pdf",
  "NombreDocumento": "TuFintech_ciFrontal",
  "ContenidoBase64": "JVBERi0xLjQKJ...",
  "codTipo": "ciFrontal"
}

Resultado esperado: la documentación requerida quedará asociada al cliente.

3.3 Crear la cuenta de inversión

3.3 Crear la cuenta de inversión

→ POST /api/publicapi/creasys/Cuentas

{
  "numCuenta": "11111111/1",
  "dscCuenta": "Ana Prueba Inversiones",
  "identificador": "11111111-1",
  "codMoneda": "CLP",
  "codTipoAdministracion": "NF",
  "dscPerfilRiesgo": "MODERADO",
  "dscTipoCuenta": "NACIONAL",
  "abrAsesor": "TU_CODIGO_ASESOR"
}

Resultado: ya tienes una cuenta de inversión lista para registrar el aporte inicial.

Paso 4: Registra un aporte inicial

Simula el primer aporte de fondos del cliente.

→ POST /api/publicapi/creasys/Movimientos/IngresoAporteRetiro

{
  "Uuid": "gen-un-uuid-unico-aqui",
  "CodTipoMovimiento": "APO_PAT",
  "NumCuenta": "11111111/1",
  "Monto": "100000",
  "CodMoneda": "CLP",
  "DscMedioPagoCobro": "TRANSFERENCIA",
  "ObsMovimiento": "Aporte inicial de prueba"
}

⚠️

El Uuid debe ser único por operación. Si reintentas el mismo request con el mismo UUID, el sistema detectará que ya fue procesado y no lo duplicará.

Resultado esperado: el aporte quedará registrado una sola vez por cada Uuid único.

Resultado: el sistema procesará el aporte una sola vez por cada Uuid único.

Paso 5: Verifica el saldo

Confirma que el aporte se reflejó correctamente en la cuenta del cliente.

→ GET /api/publicapi/creasys/Cajas?NumCuenta=11111111/1

{
  "codMoneda": "CLP",
  "saldoDisponible": 100000
}

Si saldoDisponible refleja 100000, completaste el flujo básico de esta integración.

Integración completada

✅

Completaste el flujo básico: autenticación, consulta de parámetros, creación de cliente, apertura de cuenta y registro de aporte.

Próximos pasos