Flujos de Solicitudes (Workflow)

El Flujo de Solicitudes (o workflow) es el circuito que recorre una solicitud de crédito desde que se ingresa hasta que se aprueba, se rechaza o se desiste. En lugar de tener un camino fijo y rígido, Plenario permite que cada empresa arme su propio circuito: definir por qué estados pasa una solicitud, qué transiciones (saltos de un estado a otro) están permitidas, qué documentación se exige en cada paso, cómo se identifican/auditan esos estados y qué se le muestra al cliente en la web.

Todo esto se configura una sola vez (normalmente al implementar el sistema) y luego el módulo de Solicitudes respeta esas reglas automáticamente: una solicitud solo podrá avanzar hacia los estados habilitados, y no podrá completarse si falta un documento marcado como obligatorio.

Conviene pensarlo así:

• Estados: las "estaciones" por las que pasa la solicitud (Ingresada, En análisis, Aprobada, etc.). Cada estado pertenece a un Flujo y a un Departamento.
• Transiciones de Estados: las "vías" que conectan una estación con la siguiente (de qué estado se puede pasar a qué estado).
• Documentos por Estados: la documentación requerida para estar o avanzar desde un estado.
• Identificadores de Flujos: etiquetas internas para clasificar y auditar los estados.
• Grupos de Visualización Web: qué estados se le muestran al cliente cuando consulta el avance de su solicitud por la web.

Importante: La configuración del workflow define el comportamiento de todas las solicitudes nuevas. Modificar estados, transiciones o documentos obligatorios afecta de inmediato a las operaciones en curso. Conviene coordinar estos cambios con el área que opera Préstamos.

Acceso general: Menú principal → Préstamos → (Flujos de Solicitudes). Desde ese grupo de menú se llega a las opciones Estados, Transiciones, Documentos por estados, Identificadores de estados y Visualización Web.

Nota técnica: en el sistema estas opciones de menú aparecen rotuladas como Estados, Transiciones, Documentos por estados, Identificadores de estados y Visualización Web. Las pantallas internas tienen títulos similares (por ejemplo "Flujo de estados" o "Add/Mod de Estados de Solicitudes").

Cada sub-opción del grupo Flujos de Solicitudes abre su propia pantalla de ABM (alta, baja y modificación). En todos los casos la pantalla muestra una grilla con los registros ya definidos en la parte central y una barra superior con los botones de acción (Nuevo, Modificar, Eliminar y, según la pantalla, atajos como Documentos Default).

Las cinco piezas que se configuran desde este grupo de menú son:

Las pantallas con muchos registros incluyen un panel de búsqueda para acotar la grilla. En particular, la pantalla de Estados permite filtrar por:

En las pantallas de Transiciones, Documentos por Estados y Visualización Web, los selectores de Flujo, SubFlujo y Departamento funcionan además como filtros: al elegirlos se acotan los estados de origen y destino disponibles.

La grilla principal de Estados muestra estas columnas:

Las demás pantallas muestran en su grilla los registros correspondientes (transiciones, documentos, identificadores o grupos de visualización) con sus datos clave, descriptos en cada subsección de Acciones disponibles.

Desde el grupo Flujos de Solicitudes se gestionan las cinco piezas del workflow. Cada una se describe a continuación.

Estados

Acceso: Menú principal → Préstamos → (Flujos de Solicitudes) → Estados.

Es el ABM (alta, baja y modificación) de los estados por los que puede pasar una solicitud. Cada estado representa una situación concreta dentro del circuito y se asocia a un Flujo y a un Departamento responsable.

La pantalla muestra una grilla con los estados ya definidos. Se puede filtrar por Flujo y por rango de fechas usando el panel de búsqueda.

Al dar de alta o modificar un estado se abre la ventana Add/Mod de Estados de Solicitudes, con estos campos:

Pasos para crear un estado:

1. Abrir la pantalla — Ir a Préstamos → (Flujos de Solicitudes) → Estados.
2. Nuevo — Hacer clic en el botón Nuevo de la barra superior.
3. Elegir Flujo y Departamento — Seleccionar a qué flujo pertenece y qué sector lo gestiona.
4. Completar Nombre y Sigla — Escribir el nombre visible y, opcionalmente, una sigla.
5. Asignar Identificador — Si corresponde, elegir el identificador de auditoría.
6. Aceptar — Confirmar. El sistema avisa "Se ha guardado correctamente el estado."

Importante: Desde la grilla de Estados, con un estado seleccionado, el botón Documentos Default abre la configuración de documentación requerida para ese estado (es un atajo a Documentos por Estados).

Transiciones de Estados

Acceso: Menú principal → Préstamos → (Flujos de Solicitudes) → Transiciones.

Una transición define qué camino puede recorrer la solicitud: desde qué estado (origen) puede pasar hacia qué estado (destino). Si dos estados no están conectados por una transición, la solicitud no podrá saltar de uno al otro. Esto es lo que evita, por ejemplo, que una solicitud pase de "Ingresada" directo a "Liquidada" sin pasar por el análisis.

Cada transición se define para un Flujo y un SubFlujo (agrupación de líneas) determinados. Los estados de origen y destino se filtran automáticamente según el flujo, el subflujo y el departamento elegidos.

Campos de la ventana de alta/modificación de transición (Transiciones Add/Mod):

Cada fila de la grilla de actividades de la transición tiene:

Pasos para crear una transición:

1. Abrir la pantalla — Ir a Préstamos → (Flujos de Solicitudes) → Transiciones y hacer clic en Nuevo.
2. Elegir Flujo y SubFlujo — Al seleccionarlos se habilitan los estados y departamentos disponibles.
3. Definir el origen — Elegir Departamento y Estado de origen.
4. Definir el destino — Elegir Departamento y Estado de destino.
5. Agregar actividades (opcional) — Con Agregar se suman actividades obligatorias; con Eliminar se quitan. Tildar Validar actividades obligatorias si deben cumplirse sí o sí.
6. Aceptar — Confirmar para guardar la transición.

Importante: Si una transición no se puede crear porque los estados aparecen deshabilitados, suele faltar definir antes el SubFlujo o el Departamento. La pantalla habilita los estados recién cuando esos datos están completos.

Documentos por Estados

Acceso: Menú principal → Préstamos → (Flujos de Solicitudes) → Documentos por estados. También se llega con el botón Documentos Default desde la grilla de Estados.

Acá se define qué documentación se asocia a cada estado del flujo: por ejemplo, exigir el DNI escaneado al ingresar la solicitud, o un comprobante de ingresos antes de aprobar. Cada documento puede marcarse como obligatorio, lo que impide avanzar la solicitud mientras no esté cargado.

El documento se elige navegando por Grupo → Subgrupo → Documento (la clasificación del módulo de Gestión Documental). Opcionalmente se puede adjuntar una plantilla (archivo modelo) y/o un modelo de autocompletado que arma automáticamente el documento (por ejemplo, una carta de términos y condiciones).

Campos de la ventana de alta/modificación de documento por estado:

Pasos para asociar un documento a un estado:

1. Abrir la pantalla — Desde el menú Documentos por estados o con Documentos Default desde Estados.
2. Elegir Flujo, SubFlujo y Estado — El sistema acota los estados disponibles según el flujo y el departamento.
3. Seleccionar el documento — Navegar Grupo → Subgrupo → Documento.
4. Marcar obligatoriedad — Tildar Documento obligatorio si la solicitud no puede avanzar sin él.
5. Adjuntar plantilla (opcional) — Cargar un archivo modelo y/o elegir un modelo de autocompletado.
6. Definir por líneas (opcional) — Si el documento solo aplica a ciertas líneas, tildar la opción y asignar las líneas correspondientes.
7. Aceptar — Confirmar para guardar.

Importante: No se puede definir el mismo documento dos veces para el mismo estado, línea y flujo. Si ya existe, el sistema avisa "El documento está definido para el estado seleccionado." y no permite duplicarlo.

Identificadores de Flujos

Acceso: Menú principal → Préstamos → (Flujos de Solicitudes) → Identificadores de estados.

Los Identificadores son etiquetas internas que se asignan a los estados para clasificarlos y auditarlos. Sirven, por ejemplo, para marcar un estado como "inicial", "de aprobación" o "final", o para vincularlo a un campo de auditoría que el sistema usa internamente. Un mismo identificador puede asignarse a varios estados.

Es el ABM más simple del workflow: una grilla con los identificadores existentes y una ventana de alta/modificación con tres datos.

Campos de la ventana de alta/modificación de identificador:

Pasos para crear un identificador:

1. Abrir la pantalla — Ir a Préstamos → (Flujos de Solicitudes) → Identificadores de estados y hacer clic en Nuevo.
2. Completar la Descripción — Escribir el nombre del identificador.
3. Indicar Tipo y Campo de Auditoría — Completar según la clasificación que se quiera aplicar.
4. Aceptar — Confirmar. El sistema avisa "Se ha guardado correctamente el Identificador."

Importante: El identificador por sí solo no cambia nada: surte efecto cuando se asigna a un estado desde la pantalla de Estados (campo Identificadores).

Grupos de Visualización Web

Acceso: Menú principal → Préstamos → (Flujos de Solicitudes) → Visualización Web.

Define qué le muestra el sistema al cliente en la web cuando sigue el avance de su solicitud. No todos los estados internos conviene mostrarlos al cliente; con los Grupos de Visualización se arma una vista simplificada: se eligen los estados que se quieren exponer, en qué orden aparecen y en qué canal (Retail o Bullet), además de qué acciones puede realizar el cliente desde la web.

Cada grupo se asocia a un Flujo y a un Departamento, tiene un nombre, un orden y una cantidad de días de visualización. La ventana se titula Add/Mod Visualización de grupos Web.

Campos de la ventana de alta/modificación del grupo:

En el recuadro Acciones a realizar en el grupo se habilitan las operaciones permitidas:

Dentro del grupo se cargan los estados asignados, cada uno con estas columnas:

Pasos para crear un grupo de visualización:

1. Abrir la pantalla — Ir a Préstamos → (Flujos de Solicitudes) → Visualización Web y hacer clic en Nuevo.
2. Elegir Flujo y Departamento — Definen el contexto del grupo.
3. Nombrar y ordenar — Completar Nombre del grupo, Orden y Días de visualización.
4. Definir acciones — Tildar las acciones permitidas en el recuadro Acciones a realizar en el grupo.
5. Agregar estados — Con Agregar sumar los estados a mostrar; ajustar su Orden y los tildes Ver en Retail / Ver en Bullet y demás acciones. Con Eliminar se quita un estado.
6. Activar y Aceptar — Tildar Agrupación Activa y confirmar. El sistema avisa "Se ha guardado correctamente el grupo."

Importante: Si un estado no aparece dentro de ningún grupo de visualización activo, el cliente no lo verá en la web aunque la solicitud efectivamente esté en ese estado.

Una financiera quiere que sus solicitudes de préstamo personal recorran este circuito: Ingresada → En análisis → Aprobada → Liquidada, con rechazo posible desde el análisis. La configuración sería:

1. Identificadores — Crear "Inicial", "Aprobación" y "Final" para clasificar los estados.
2. Estados — Dar de alta Ingresada (depto. Mesa de entrada, identificador Inicial), En análisis (depto. Riesgo), Aprobada (depto. Riesgo, identificador Aprobación), Rechazada (identificador Final) y Liquidada (depto. Operaciones, identificador Final).
3. Transiciones — Conectar Ingresada → En análisis; En análisis → Aprobada; En análisis → Rechazada; Aprobada → Liquidada. (No se crea transición de Ingresada a Liquidada, así nadie puede saltearse el análisis.)
4. Documentos por Estados — En Ingresada exigir el DNI escaneado como Documento obligatorio; en En análisis exigir el comprobante de ingresos.
5. Visualización Web — Crear un grupo activo que le muestre al cliente Ingresada, En análisis y Aprobada (en ese orden, tildados Ver en Retail), dejando Rechazada y Liquidada fuera de la vista web.

Resultado: una solicitud nueva solo podrá avanzar por los caminos definidos, no se aprobará sin el comprobante de ingresos cargado, y el cliente verá por la web un resumen prolijo de su avance sin estados internos.

• Configurá en orden: primero Identificadores, luego Estados, después Transiciones, en paralelo Documentos por Estados y, por último, los Grupos de Visualización Web.
• No borres estados en uso: dejá de usarlos en transiciones nuevas en lugar de eliminarlos, para no romper referencias de solicitudes, documentos o grupos.
• Cuidá los documentos obligatorios: marcar uno como obligatorio frena de inmediato a todas las solicitudes que estén en ese estado y no lo tengan cargado.
• Usá el atajo Documentos Default desde la grilla de Estados para configurar rápido la documentación de un estado seleccionado.
• Revisá la vista web tras cada cambio: si modificás estados o grupos, confirmá que el cliente siga viendo lo que corresponde.
• Coordiná los cambios: cualquier modificación de workflow impacta sobre las operaciones en curso; avisá al área que opera Préstamos.

La configuración del workflow es una tarea de administración. Conviene restringirla a los perfiles que operan/implementan Préstamos.

Sección de referencia para soporte/desarrollo. Basada en el análisis del formulario real de la v14 (FormFlujos y formularios satélite del subsistema Workflow).

A diferencia del resto del módulo Préstamos (VB.NET), las pantallas del workflow son C#, en el proyecto VPNET_WinForms (...\VPNET_WinForms\VPNET_WinForms\Workflow\), namespace VPNET.Windows.Forms.Workflow. Todas heredan de FrmResult (grilla + ribbon Nuevo/Modificar/Eliminar + panel de búsqueda) y persisten con Entity Framework (VisualPlenarioNetContext, LINQ, SaveChanges), no con stored procedures.

Formularios principales

Formularios satélite por función (lanzados desde el menú)

Permisos reales

Tablas de base de datos principales

Relación con otros módulos / manuales

Notas para soporte (comportamiento real del código)

• "Documentos Default" es un alias del mismo form de Documentos por Estados (FormDocuemtosEstados_Default): tanto la opción de menú "Documentos por estados" como el botón "Documentos Default" de Estados/SubFlujos abren la misma clase.
• Identificadores 1–5 son del sistema y no se pueden eliminar: 1=E.Inicial, 2=E.Final, 3=E.Desistir, 4=Otras Clasificaciones, 5=E.Rechazada. Si faltan, Save() los reinserta con SQL crudo concatenado + SET IDENTITY_INSERT. La marca de "predefinido" usa un campo del modelo escrito Detault (errata, no "Default") que bloquea Modificar/Eliminar de esos registros.
• Importar/Exportar/Eliminar flujos usan SQL crudo por interpolación de strings (INSERT ... VALUES('{...}'), delete from ...) vía ExecuteSqlCommand — riesgo de inyección y de comillas en los datos. La exportación serializa a JSON (*.flj, Newtonsoft).
• Mensajes de error heredados: varios Catch muestran textos copy/paste ("Plantilla de gastos", "Limites Bullet", "Eliminando Plan de cobros") que no corresponden al workflow; ignorarlos como diagnóstico.
• Handlers vacíos / código comentado: hay eventos sin cuerpo (x_ItemClick, uC_..._EditValueChanged), bloques de filtro de fecha y de borrado comentados, y handlers con doble instanciación del form (la primera instancia se descarta — bug cosmético). El handler de Load de Transiciones se llama FFormFlujos_Estados_Transiciones_Load (doble "F", cableado en el Designer).
• Impacto: los cambios afectan de inmediato a las solicitudes nuevas y a las operaciones en curso. Transiciones, Documentos y Grupos requieren que los Estados ya existan.

Resumen: El workflow de Solicitudes se arma con cinco piezas: Estados (las situaciones), Transiciones (los caminos permitidos), Documentos por Estados (la documentación exigida), Identificadores (etiquetas de auditoría) y Grupos de Visualización Web (lo que ve el cliente). Configuradas estas piezas, el módulo de Préstamos controla automáticamente por dónde y cómo avanza cada solicitud.