MisCreditos - Portal web de clientes

MisCreditos es la aplicación web que la financiera pone a disposición de sus clientes finales para gestionar sus préstamos por sí mismos, sin llamar ni acercarse a la sucursal. Es una aplicación ASP.NET MVC (.NET Framework 4.6.2) independiente del Back Office, que consume la misma base de datos y los mismos managers de negocio del ERP Plenario v14 (proyecto VPNET.WEB.MisCreditos).

Con su usuario y contraseña, el cliente puede:

• Ver el listado de sus préstamos/créditos con su estado (Vigente, Mora, Pendiente, Cancelado), cuotas pagas y saldo.
• Desplegar cada crédito para ver el detalle de cuotas y su estado (Pagada, Mora, Pendiente).
• Pagar una o varias cuotas online eligiendo el medio de pago habilitado.
• Ver sus vencimientos mensualizados y sus créditos pendientes de autorización.
• Consultar su margen disponible y solicitar una ampliación de ese margen.
• Solicitar un crédito / pagar con margen en un comercio a través de un QR.
• Ver y editar su perfil y cambiar su contraseña.

El alta del usuario web es de autogestión: el cliente se registra desde la propia web, pero sólo si su documento ya existe como cliente de la financiera. El registro exige un proceso de validación de identidad (KYC) por pasos.

Todo el alcance de datos se filtra automáticamente por el Id_Cliente asociado al usuario logueado: un cliente nunca ve información de otro.

El acceso es por navegador (Chrome, Edge, Firefox) con la dirección web que publique la financiera. La aplicación usa autenticación por Forms Authentication; cualquier URL protegida redirige a la pantalla de login ~/User/Login.

Para ingresar:

1. Abrir la dirección del portal. Se redirige automáticamente a /User/Login.
2. Escribir usuario y contraseña.
3. Tocar Ingresar.

Debajo del login hay dos enlaces: ¿Olvidaste tu contraseña? (/User/ForgotPassword) y Registra nuevo usuario (/User/Register).

Si el cliente todavía no tiene usuario, debe crearlo con el flujo de Registro (ver Acciones disponibles → Registro con validación de identidad). El registro sólo prospera si el número de documento ya está cargado como cliente en el sistema.

La sesión dura por defecto 30 minutos (parámetro Web.SessionTTL.Minutos, cookie con expiración deslizante). Al vencer, el portal vuelve a pedir login.

La pantalla principal es Inicio (Home/Index), titulada "Cuenta" / "Tus préstamos". Se sirve dentro del layout general (_Layout.cshtml), que aporta la barra superior con el logo y un menú lateral (sidebar) desplegable con el botón ☰.

El menú lateral contiene:

• Inicio (Home/Index) — listado de créditos.
• Mi Perfil (Home/Perfil) — datos personales.
• Salir (User/LogOff) — cierre de sesión.

El cuerpo de Inicio muestra, de arriba hacia abajo:

Cada tarjeta de crédito muestra: estado (con color: Mora=rojo, Vigente=verde, Pendiente=azul, otro=gris), entidad, progreso de cuotas ("Cuota X/N x $valor"), importe y fecha de operación. Al tocar la tarjeta se despliega el detalle de cuotas de ese crédito (carga vía AJAX).

El portal concentra estas funciones para el cliente final:

• Registro con validación de identidad (KYC) — onboarding multi-paso: verificación de e-mail, verificación de teléfono por SMS, captura y validación de selfie + DNI (frente y dorso), y alta de credenciales de usuario.
• Login / recuperación / cambio de contraseña — ingreso por Forms Auth, recupero por e-mail con enlace temporal, y cambio de contraseña desde el perfil.
• Consulta de créditos y cuotas — listado de préstamos, detalle de cuotas, vencimientos mensualizados y solicitudes pendientes de autorización.
• Pago de cuotas online — selección de cuotas contiguas, confirmación de importe y redirección al checkout del proveedor (Pago360, Mobbex o MercadoPago) según configuración.
• Solicitud de crédito / pago con margen (QR) — a partir de un QR de comercio se evalúa el algoritmo de crédito del cliente, se ofrecen planes de cuotas y se genera la solicitud/crédito.
• Solicitud de ampliación de margen — envío por e-mail al equipo de la financiera del pedido de más límite.
• Perfil — datos personales (nombre, e-mail, teléfono) y acceso a cambiar contraseña.

Nota: la pantalla de Inicio no tiene filtros de búsqueda tipo grilla; la información se organiza por bloques desplegables. Las consultas de detalle (cuotas, deuda mensual, pendientes) se cargan bajo demanda con llamadas AJAX a acciones [HttpGet] del HomeController.

Las consultas de detalle devuelven JSON y se pintan como listas dentro de Inicio:

Reglas de la lista de cuotas al pagar:

• Sólo se pueden marcar cuotas impagas (Pendiente o Mora); las Pagadas se muestran con tilde.
• La selección debe ser contigua desde la más antigua: no se puede marcar una cuota si la anterior pendiente/mora no está marcada, ni desmarcar una si hay posteriores marcadas.
• No se pueden mezclar cuotas de distintos créditos en un mismo pago; al marcar cuotas de un crédito se desmarcan las de los demás.
• El totalizador inferior ("A pagar: $…") suma las cuotas seleccionadas.

Registro con validación de identidad (KYC)

El registro (User/Register) es un asistente multi-paso definido por la sección StepConfiguration del web.config y construido por StepHelper.GetStepsJson. El orden y los botones de cada paso salen de esa configuración; el motor de pasos del lado cliente es step.onb.js (StepManager).

Pasos (según la configuración vigente):

1. StepRegister — "Ingresá tus datos para el registro". El cliente ingresa número de documento (y sexo). Se llama StepRegisterGetCliente(NroDoc, Sexo): si el documento no existe como cliente, se corta el registro con el mensaje del parámetro Web.MisCreditos.Registro.NoCliente. Si existe, se arma un Tickets_ClientesUsuarios con los datos del cliente. Si el cliente ya tiene usuario, deriva a StepUserConfirmExist ("Cliente ya existe").
2. StepValidEmail / StepValidEmailVerify / StepValidEmailConfirmacion — validación de e-mail. StepValidEmailSendCodeMail(Email) genera un código de 4 dígitos, lo guarda en sesión (5 min de vigencia) y lo envía por correo (salvo modo test Web.MisCreditos.OnBoarding.Mail.Test = 1). StepValidEmailVerifyCode(code) valida el código. Rechaza e-mails ya registrados por otro usuario.
3. StepValidPhone / StepValidPhoneVerify / StepValidPhoneConfirmacion — validación de teléfono por SMS. StepValidPhoneSendCodePhone(Phone) genera y envía el código por SMS (Sms_Setup_Manager.SendSms, salvo modo test Web.MisCreditos.OnBoarding.Sms.Test = 1); StepValidPhoneVerifyCode(code) lo valida. Rechaza teléfonos ya registrados. (En la configuración de ejemplo vigente los pasos de teléfono están comentados; verificar según el web.config instalado.)
4. StepValidImagen — validación de identidad (biometría/OCR). El cliente captura Selfie, DNI frente y DNI dorso con la cámara. Las librerías pesadas (TensorFlow / face-api / tesseract / scanner de DNI) se cargan bajo demanda (window.cargarLibreriasIdentidad()), no al abrir la web. Parámetros: Web.MisCreditos.Registro.ValidarSelfie (selfie real), Web.MisCreditos.Registro.ValidarIdentidad (selfie vs. rostro del DNI), Web.MisCreditos.Registro.ValidarDniPDF417 (lectura del PDF417 del dorso vía ValidacionDni_Manager.Validacion_PDF417_Data) y Web.MisCreditos.Registro.ValidacionIdentidad.Obligatoria (si 0, la validación no es obligatoria y la solicitud queda para control manual). La captura puede hacerse desde otro dispositivo (celular) mediante un QR y SignalR (FotoHub) — la foto tomada en el celular aparece automáticamente en la PC.
5. StepUser — "Especifica tus credenciales". El cliente define usuario y contraseña (mínimo 8 caracteres, con mayúscula, minúscula y número/símbolo). StepSetUser recibe los datos del usuario y las 3 imágenes (Selfie, DNI frente, DNI dorso), da de alta el Tickets_ClientesUsuarios (activo y ActivoWebClient = true) y guarda las imágenes en galería (File_Manager.GuardarArchivo, entidad CLI). Si el cliente está en gestión judicial / bloqueado / fallecido (ClienteValido), se registra pero se muestra el mensaje de Web.MisCreditos.Registro.Cliente_GestionJudicial.
6. StepUserConfirm — "Cliente registrado". Confirmación final del alta.

Iniciar sesión

User/Login (POST, con antiforgery token). Valida credenciales con Seguridad_Usuarios_Manager.LoadByUserTicketCliente(usuario, clave). Si autentica, verifica que el cliente sea válido (ClienteValido: no judicial, no fallecido, no bloqueado); si no, muestra "Acceso denegado". Al aprobar, arma el ticket de Forms Auth (SessionHelper.SetFormsAuthenticationClienteTicket), registra el acceso (WEBClient_Log_Manager.Agregar_Log(..., "Login", ...)) y redirige a Home/Index.

Recuperar / cambiar contraseña

• Olvidé mi contraseña (User/ForgotPassword): el cliente ingresa su e-mail; se genera un GUID temporal (5 min en sesión) y se envía un correo con enlace a User/ChangedPassword (Seguridad_Usuarios_Manager.SendMailTicketUsuarioChangePassword). ChangedPassword valida el GUID (vigente/usado/vencido) y permite fijar la nueva clave (ChangePasswordGeneral).
• Cambiar contraseña (User/ResetPassword, requiere sesión): desde Mi Perfil → Cambiar Contraseña. Aplica las reglas de complejidad y llama Seguridad_Usuarios_Manager.ChangePasswordGeneral(1, IdUsuario, password).

Ver créditos y cuotas

Pasos:

1. En Inicio, mirar la lista Tus préstamos.
2. Tocar una tarjeta de crédito: se cargan sus cuotas (IndexGetCaidaCuotas) y se listan con estado y vencimiento.
3. Opcional: abrir Tus vencimientos mensualizados o Tus créditos pendientes de autorización para el resumen mensual o las solicitudes en análisis.

Pagar cuotas online

Pasos:

1. Desplegar un crédito y marcar las cuotas a pagar (contiguas, del mismo crédito).
2. Tocar Pagar en la barra inferior. Se abre la pantalla Confirmar Pago.
3. Revisar el Importe total y, si se desea, ajustar el importe a pagar (no puede superar el total).
4. Elegir el medio de pago con los botones: - Pagar con [proveedor base] — la etiqueta muestra "Pagos360" o "Tarjetas" según Web.Comerc.Dashboard.MetodoPago. - Pagar con MercadoPago — sólo si Web.MisCreditos.MercadoPago.Habilitado = 1.
5. El portal llama a Home/ProcesarPago (POST) y redirige al checkout del proveedor. Tras pagar, el proveedor devuelve al cliente a la pantalla de retorno correspondiente.

Ruteo del pago en ProcesarPago según model.Medio:

• Medio == "MP" → MercadoPago (complementario; se rutea antes que el proveedor base, sin importar Web.Comerc.Dashboard.MetodoPago). Crea una preferencia (Rest_MercadoPago.CrearPreferenciaAsync) con external_reference = IdSolicitud,Nrocredito,IdsCuotas…, notification_url armada desde BO.MercadoPago.WebHooks, y vigencia del link según Web.MisCreditos.MercadoPago.Link.DiasVigencia (default 7 días; 0 = sin vencimiento). Incluye un guard anti doble pago por cuota (BuscarPagoActivoQueSolape): si ya hay un pago activo que solapa las mismas cuotas, no genera otro. Retorno del cliente: Home/PagoExitosoMercadoPago.
• Medio con Web.Comerc.Dashboard.MetodoPago == "0" → Pago360 (Pago360_Manager.CrearSolictudPagoYEjecutarChekot).
• Web.Comerc.Dashboard.MetodoPago == "1" → Mobbex (Rest_Mobbex.Orden_PagoAsync), webhook desde BO.Mobbex.Suscripcion.WebHooks, modo test Web.CreditosOnline.Onboarding.Mobbex.Test. Retorno del cliente: Home/PagoExitosoMobbex.

La pantalla de retorno de MercadoPago (PagoExitosoMercadoPago.cshtml) interpreta el estado: aprobado (approved/success), en proceso (pending/in_process/in_mediation) o no completado, y muestra el ID de pago cuando corresponde. Advierte que la acreditación puede demorar unos minutos hasta que llegue el webhook.

Solicitar ampliación de margen

Desde la tarjeta de margen → botón Margen, se abre Home/SolicitarDisponible. El cliente escribe el motivo y envía; el POST manda un e-mail (Generic_Base_Manager.SendNewMail) a la casilla de Web.MisCreditos.SolicitudLimite.Email con asunto Web.MisCreditos.SolicitudLimite.Asunto (usa la plantilla Views\html\AmpliacionLimite.html si existe). No modifica el límite automáticamente: queda para revisión manual de la financiera.

Solicitar crédito / pagar con margen (QR)

Flujo iniciado por el escaneo de un QR de comercio (botón Comprar de la tarjeta de margen). Al leer el QR, Home/NuevaSolicitud (POST) recibe los datos del comercio/importe (QRClientModel) y abre "Pagar con margen". La vista se conecta por SignalR al host del comercio (json.UrlHost) para confirmar la vigencia del QR y notificar cada paso al comercio. Luego:

1. Home/ValidarAlgoritmoCliente (GET) evalúa el algoritmo de crédito del cliente (Algoritmos_Validaciones_Manager.Evaluar_Algoritmo, con datos de scoring). Según el estado del algoritmo se muestra "Pre-Aprobada", "Sin oferta", "Fallecido" o "Verifique DNI/sexo". Mensajes configurables: Web.MisCreditos.Onboarding.NoCliente, …SinOferta, …Fallecido.
2. Se ofrecen los planes de cuotas disponibles (GetCuotas → Prestamos_Lineas_Manager.PrestamosLineas_GetCuotas + GetValorCuotaWEB); el cliente elige un plazo.
3. Home/ProcesarOperacionSolicitud (POST) crea la solicitud (PrestamosSolicitudes_Manager.Save) en el estado inicial del flujo. Si el control digital es aprobado ("A") y hay límite disponible suficiente, genera el crédito automáticamente (Prestamos_Creditos_Manager.Generate_New_Credito) y avanza el flujo al estado final; si no, la solicitud queda pendiente de autorización manual y se disparan alertas/e-mails (Alertas_Manager.AlertaWeb, plantillas AvisoLimite.html / AvisoSolicitudFallo.html).

Querés pagar la cuota atrasada de tu préstamo con MercadoPago:

1. Ingresás al portal con tu usuario y contraseña.
2. En Inicio → Tus préstamos, tocás la tarjeta del crédito en Mora.
3. Se despliegan las cuotas; marcás la cuota (o cuotas contiguas) que querés abonar. Abajo ves "A pagar: $…".
4. Tocás Pagar → se abre Confirmar Pago. Verificás el importe.
5. Tocás Pagar con MercadoPago. El portal genera la orden y te redirige al checkout de MercadoPago.
6. Pagás en MercadoPago y volvés a MisCreditos, que muestra "Pago en proceso / recibido". En unos minutos, cuando MercadoPago confirma por webhook, la cuota queda marcada como cobrada.

• Para registrarte necesitás que tu documento ya esté cargado como cliente de la financiera; si no, el registro no avanza.
• Tené el celular a mano durante el registro: vas a recibir el código de e-mail y, si está activo, el de SMS, y podés capturar la selfie y el DNI desde el teléfono escaneando el QR.
• Para el DNI, girá el teléfono en horizontal, llená el recuadro con el documento y cuidá que el código del dorso se lea sin reflejos.
• Al pagar cuotas, seleccioná siempre desde la más antigua hacia adelante; el sistema no deja saltear cuotas ni mezclar créditos distintos en un mismo pago.
• El importe a pagar no puede superar el importe total de las cuotas seleccionadas.
• Después de pagar, no repitas la operación: la acreditación puede demorar unos minutos hasta que el proveedor confirma por webhook.
• La contraseña debe tener mínimo 8 caracteres con mayúscula, minúscula y número o símbolo.
• La sesión se cierra por inactividad (30 min por defecto); volvé a ingresar si te pide login.

• El acceso requiere un usuario de cliente web (Tickets_ClientesUsuarios, con ActivoWebClient = true) asociado a un Id_Cliente. Ese usuario se crea por autogestión en el propio portal (Registro con KYC).
• [Authorize] protege todo el HomeController (créditos, pagos, perfil, solicitudes). Las acciones de login, registro y los pasos del onboarding son [AllowAnonymous] o anónimas por diseño (el cliente aún no está logueado).
• Login por Forms Authentication (loginUrl = ~/User/Login, timeout 30 min); el ticket guarda un ExternalUsuario serializado en UserData. La sesión también se respalda con Owin Cookie Authentication (ApplicationCookie, 30 min, expiración deslizante).
• Alcance de datos: todas las consultas filtran por el Id_Cliente del usuario logueado (SessionHelper.GetClienteUSuario() / GetExternalUsuario()); un cliente nunca ve datos de otro.
• Bloqueos: ClienteValido niega el acceso/uso a clientes en gestión judicial, fallecidos o bloqueados (mensaje de Web.MisCreditos.Registro.Cliente_GestionJudicial).
• La habilitación de medios de pago, margen, QR e importes se controla por parámetros (Web.Comerc.Dashboard.*, Web.MisCreditos.MercadoPago.Habilitado).

Basada en el análisis del formulario real de la v14. Aplicación ASP.NET MVC 5 (.NET Framework 4.6.2), proyecto VPNET.WEB.MisCreditos (VPNET_WEB_MisCreditos\VPNET.WEB.MisCreditos). Referencia los managers de negocio del ERP en VPNET_DataModel (namespaces VPNET.Data.Model / VPNET.Data.Model.Manager) y la librería RestApiNCG. Ruteo MVC por defecto ({controller}/{action}/{id} → Home/Index).

Controllers y vistas

Managers y clases de negocio

Stored Procedures y servicios

Tablas de base de datos

Parámetros y seguridad

Parámetros de configuración (leídos con Generic_Base_Manager.GetParameter / GetParameterValue):

Seguridad e infraestructura:

• Forms Authentication (system.web/authentication mode="Forms", ~/User/Login, timeout 30) + Owin Cookie Authentication (Startup.cs: ApplicationCookie, ExpireTimeSpan = 30 min, SlidingExpiration).
• CORS (Owin) con reflejo dinámico del Origin y SupportsCredentials = true.
• SignalR habilitado (app.MapSignalR) para FotoHub.
• 2FA: el LoginViewModel declara TipoAutentificacion y Code2fa, pero el POST de Login de este proyecto no consume el código 2FA (no hay flujo de doble factor cableado aquí). Si la financiera requiere 2FA/GoogleAuthenticator, verificar contra binario instalado / otra capa. Ver Notas para soporte.
• Cadenas de conexión en web.config (DefaultConnection / VisualPlenarioNetContext) — SQL Server; en el fuente vienen apuntando a un entorno de QA (verificar contra el web.config instalado en producción).

Relación con otros módulos / manuales

• MercadoPago — configuración de MercadoPago, preferencias de checkout y webhook/IPN que acredita las cuotas pagadas desde MisCreditos.
• Nueva solicitud de crédito — el módulo de Préstamos del Back Office donde se administran las solicitudes/créditos que el cliente ve y origina desde el portal.
• Web de Workflow — otras aplicaciones web del ecosistema Web / Workflow de Plenario v14.

El portal reutiliza los managers de negocio del ERP (préstamos, créditos, algoritmos, clientes, seguridad) y depende del motor de decisión/algoritmos de crédito (scoring) y de los proveedores de pago (Pago360, Mobbex, MercadoPago).

Notas para soporte

• 2FA no cableado en el login de este proyecto: existe el campo Code2fa en LoginViewModel y TipoAutentificacion (inicializado en 2), pero la acción Login no valida un segundo factor. No hay referencias a GoogleAuthenticator ni a parámetros DobleFactor.* en el fuente de VPNET.WEB.MisCreditos. Si un cliente reporta 2FA, verificar contra el binario instalado / otra versión.
• Pasos de teléfono comentados: en la StepConfiguration de ejemplo del web.config los pasos StepValidPhone* están comentados (el flujo salta de e-mail a validación de imagen). El backend (StepValidPhoneSendCodePhone, etc.) existe igual. Confirmar la configuración instalada.
• Cadena de conexión de QA en el fuente: el web.config versionado apunta a PC-NORBERTO\PlenarioNET_CorvalanProdQa. Antes de deployar, verificar que apunte a la base correcta.
• FotoHub con namespace legacy VPNET_WEB_CreditoOnline.Controllers (nombre heredado del proyecto de crédito online); no afecta la funcionalidad, pero puede confundir en búsquedas.
• Vistas "- Copia": existen StepValidImagen - Copia.cshtml y StepValidImagenCapturar - Copia.cshtml en Views\User\; son copias de trabajo, no forman parte del flujo activo.
• Guard anti doble pago (MercadoPago): la idempotencia es a nivel cuota (BuscarPagoActivoQueSolape), no sólo por external_reference; una selección distinta de cuotas genera otra referencia.
• La acreditación efectiva de las cuotas depende del webhook del proveedor (API Plenario), no del portal; si una cuota no se marca como pagada, revisar el procesamiento del webhook antes que el portal.