Enrolamiento de Clientes

Registra un cliente en Voultech con sus datos personales y documentación KYC, y consulta sus datos para confirmar el alta.

🧭

Flujo típico: Crear cliente (con documentos) → Consultar cliente. La validación KYC/Compliance se ejecuta automáticamente cuando los documentos quedan asociados al cliente.

Operaciones disponibles

Crear cliente

→ POST /api/publicapi/creasys/Clientes

Crea un cliente en el sistema. El body incluye los datos de la persona (natural o jurídica) y el asesor (tu fintech). Esta llamada crea simultáneamente la persona y el cliente — no necesitas llamar a POST /Personas por separado.

📎

En el flujo típico de enrolamiento, la documentación KYC del cliente (cédula, contrato, etc.) se carga junto con la creación del cliente. Sólo si enrolás con datos mínimos y posponés la carga, usa POST /Documentos después (ver Subir documentos).

{
  "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" }
  ]
}

💡

Antes de enviar el cliente, consulta los catálogos válidos: GET /Comuna, GET /Pais, GET /EstadoCivil, GET /TipoIdentificacion, GET /TipoEntidad. Ver Listados del Sistema.

🆔

El codIdentificacion identifica al proveedor KYC que validó la identidad del cliente. Voultech soporta Rillis e Identyz. Cuando integras uno de los dos, el proveedor te entrega un código por verificación que debes guardar y enviar acá. Si dejas el campo vacío, el sistema asume que la validación se ejecutará por el flujo interno de Voultech.

Respuesta exitosa: 201 Created. El cliente queda registrado y la documentación KYC asociada queda lista para validación automática.

Consultar cliente

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

Devuelve los datos completos del cliente, incluyendo persona, dirección, teléfonos, emails y asesor asociado. Útil para validar que el alta quedó correctamente registrada.

💡

Esta consulta ya devuelve los datos de contacto. No es necesario llamar a endpoints separados de teléfono, dirección o email para consultarlos.

Resultado esperado: obtienes la información completa del cliente y sus contactos en una sola respuesta.

Consultar persona (sin cliente)

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

Si necesitas los datos de una persona que aún no es cliente (por ejemplo, un representante legal o relacionado), usa este endpoint.

Resultado esperado: datos de la persona registrada, sin el contexto de cliente/asesor.

Subir documentos (caso avanzado)

📌

En el flujo típico no necesitas este endpoint — la documentación KYC se carga junto con POST /Clientes. Usa POST /Documentos sólo si enrolaste con datos mínimos y quieres adjuntar los documentos en una llamada posterior.

→ POST /api/publicapi/creasys/Documentos

Carga documentos KYC del cliente codificados en Base64. La validación de identidad se ejecuta automáticamente cuando los documentos requeridos están cargados.

{
  "identificador": "11111111-1",
  "tipoDocumento": ".pdf",
  "nombreDocumento": "TuFintech_ciFrontal",
  "contenidoBase64": "JVBERi0xLjQKJ...",
  "codTipo": "ciFrontal"
}

Resultado esperado: el documento queda asociado al cliente. Repetí la llamada por cada documento que necesites cargar.

Crear persona asociada (caso avanzado)

📌

Persona ≠ Cliente. Una persona es la entidad natural o jurídica registrada en el sistema; un cliente es una persona enrolada con tu fintech. En el flujo base no necesitas este endpoint — POST /Clientes ya crea la persona internamente.

→ POST /api/publicapi/creasys/Personas

Crea una persona que no es cliente pero que está asociada a un cliente con un tipo de relación. Casos típicos:

• Cónyuge del cliente (relevante para régimen patrimonial conyugal)
• Representante legal (en clientes jurídicos)
• Beneficiario, apoderado o relacionado según norma CMF

La persona queda registrada y luego se vincula al cliente principal con un codTipoRelacion (cónyuge, representante, etc.).

Resultado esperado: la persona queda registrada en el sistema, disponible para vincularse a un cliente existente con su tipo de relación.