Gestión de Clientes

El sistema de Gestión de Clientes abarca el ciclo de vida completo del cliente, desde el registro inicial y la verificación KYC hasta el estado de cuenta activa.

Componentes del Sistema

Componente	Módulo	Propósito
Gestión de Clientes	core-customer	Persistencia, perfiles y documentos
Procesamiento KYC	core-applicant	Integración con Sumsub
Onboarding de Usuarios	user-onboarding	Aprovisionamiento en Keycloak

Ciclo de Vida del Cliente

┌─────────────┐    ┌─────────────┐    ┌─────────────┐    ┌─────────────┐
│   Registro  │───▶│ Verificación│───▶│   Cuenta    │───▶│   Cliente   │
│   Inicial   │    │     KYC     │    │  de Depósito│    │   Activo    │
└─────────────┘    └─────────────┘    └─────────────┘    └─────────────┘

El sistema establece la capa de identidad fundamental requerida antes de que los clientes puedan acceder a productos financieros:

1. Registro inicial: Captura de datos básicos del cliente
2. Verificación KYC: Validación de identidad mediante Sumsub
3. Cuenta de depósito: Creación automática tras aprobación KYC
4. Acceso a productos: Habilitación de facilidades de crédito

Tipos de Cliente

El sistema soporta múltiples tipos de cliente para clasificación regulatoria:

Tipo	Descripción	Tratamiento Contable
INDIVIDUAL	Persona natural	Cuentas individuales
GOVERNMENT_ENTITY	Organización gubernamental	Cuentas gubernamentales
PRIVATE_COMPANY	Corporación privada	Cuentas empresariales
BANK	Institución bancaria	Cuentas interbancarias
FINANCIAL_INSTITUTION	Empresa de servicios financieros	Cuentas institucionales
FOREIGN_AGENCY_OR_SUBSIDIARY	Agencia/sucursal extranjera	Cuentas foráneas
NON_DOMICILED_COMPANY	Corporación no domiciliada	Cuentas no residentes

Estados del Cliente

Estado	Descripción
ACTIVE	El cliente puede realizar operaciones
INACTIVE	La cuenta está inactiva
SUSPENDED	La cuenta está suspendida

Documentación Relacionada

• Proceso de Onboarding - Flujo completo de incorporación
• Gestión de Documentos - Manejo de documentos del cliente

Integración con otros módulos

El registro del cliente es referenciado por prácticamente todos los demás módulos del sistema:

• Depósitos: Cada cliente tiene una cuenta de depósito (creada automáticamente después de la aprobación KYC). El tipo de cliente determina a qué conjunto de cuentas contables pertenece la cuenta de depósito.
• Crédito: Las propuestas de facilidades crediticias están vinculadas a un cliente. La verificación KYC puede ser requerida antes de que se permitan los desembolsos.
• Contabilidad: El tipo de cliente determina la ubicación en el plan de cuentas tanto para los pasivos de depósitos como para las cuentas por cobrar de crédito.
• Gobernanza: Los procesos de aprobación para retiros y operaciones de crédito referencian al cliente indirectamente a través de las entidades asociadas.

Documentación relacionada

• Proceso de onboarding - Flujo completo de onboarding con KYC de Sumsub
• Gestión de documentos - Manejo de documentos del cliente