El módulo de solicitud de crédito de Comfaca Créditos en Línea guía al afiliado a través de un wizard multi-paso que recopila toda la información requerida para una solicitud formal de libranza. El formulario se persiste automáticamente enDocumentation Index
Fetch the complete documentation index at: https://mintlify.com/elegroag/nuxt-credito-caja/llms.txt
Use this file to discover all available pages before exploring further.
localStorage a medida que el usuario avanza, garantizando que no se pierdan datos ante cierres accidentales del navegador. Al finalizar, se genera la solicitud en base de datos y se emite un PDF que desencadena el proceso de firma digital.
Flujo del Wizard
El wizard expone 10 pasos definidos enWIZARD_STEPS dentro de useWizardSolicitud.ts. El paso activo se conserva en localStorage bajo la clave comfaca_credito_solicitud_current_step.
Solicitud — Selección de línea de crédito y simulador
useSimuladorStorage) se cargan automáticamente al montar el wizard, pre-rellenando valor_solicitud, cuota_mensual, plazo_meses y los campos de linea_credito.Solicitante — Datos personales del titular
trabajador almacenado en localStorage o desde la sesión activa.Cónyuge — Información del cónyuge (opcional)
casado o unión libre. Al activarlo con toggleConyuge(true), se inicializa el objeto conyuge con los campos identificacion, nombres_apellidos, ingresos_laborales, trabaja y telefono_movil. Si el cónyuge trabaja, toggleEmpresaConyuge(true) agrega el sub-objeto empresa.Laboral — Información laboral
trabajador vía la API SISU.Ingresos — Ingresos y descuentos
autocalcularIngresos() computa total_ingresos, total_descuentos y total_neto_recibido de forma reactiva.Económica — Información económica
Propiedades — Bienes inmuebles y vehículos
tipo_bien (vivienda | vehiculo), descripcion, ciudad, matricula_inmobiliaria y valor_comercial. Se agregan con addPropiedad() y se eliminan con removePropiedad(idx).Deudas — Obligaciones financieras vigentes
acreedor_nombre, concepto, valor_cuota y saldo_obligacion. Se administran con addDeuda() / removeDeuda(idx).Referencias — Referencias familiares y personales
familiares y personales. Cada referencia tiene nombre_apellidos y celular. Se gestionan con addReferencia(kind) / removeReferencia(kind, idx).Revisión y generación — Confirmación y envío
guardarSolicitud(payloadForm), que llama a POST /api/solicitudes/guardar-solicitud. En respuesta exitosa se abre el modal de confirmación con el número de solicitud asignado y se ofrece al afiliado ir a la sección de carga de documentos (/dash/solicitud/documentos/:id).Simulador de Crédito
El composableuseSimuladorCore expone funciones financieras puras para calcular cuotas, intereses y capacidad de pago. No tiene estado reactivo propio, lo que permite reutilizarlo en cualquier contexto sin efectos secundarios.
Fórmula principal — Cuota mensual
La tasa mensual se deriva siempre de la tasa efectiva anual (EA) usando la equivalencia compuesta:Capacidad de pago
El simulador evalúa si la cuota propuesta cabe dentro de la capacidad disponible del solicitante:Funciones de utilidad
| Función | Descripción |
|---|---|
calcularTotalPagar(cuota, plazo) | Cuota × número de cuotas |
calcularIntereses(totalPagar, monto) | Total a pagar − capital inicial |
convertirAnualAMensual(tasaEA) | División simple / 12 (solo para visualización) |
convertirMensualAAnual(tasaMensual) | Multiplicación × 12 (solo para visualización) |
fmt(value) | Formatea en COP con Intl.NumberFormat |
fmtPct(value) | Formatea porcentaje con 2 decimales |
Líneas de Crédito
Las líneas de crédito disponibles y sus parámetros financieros se obtienen desde la API externa SISU.- Tipos de crédito
- Parámetros financieros
tipcre, modxml4, detalle, numcuo, estado, pagseg, repdcr, tipfin, estcre, auxest). Este listado es el que alimenta el selector de línea de crédito en el paso 1 del wizard.Composables del Wizard
useWizardSolicitud
useWizardSolicitud
loadDataWizard), el polling del número de solicitud disponible cada 30 segundos y el envío final. Persiste el paso activo en localStorage y limpia el estado tras el envío exitoso.Retorna: form, step, currentStep, currentStepKey, steps, next, prev, goToStep, goToStepByIndex, guardarSolicitud, clearWizardProgress, entre otros.useSolicitudCreditoForm
useSolicitudCreditoForm
SolicitudCreditoPayload) usando useState para compartirlo entre componentes sin prop-drilling. Persiste el formulario en localStorage bajo la clave comfaca_credito_solicitud_form usando un watch profundo.Retorna: form, toggleConyuge, toggleEmpresaConyuge, autocalcularIngresos, addPropiedad, removePropiedad, addDeuda, removeDeuda, addReferencia, removeReferencia, reset, clearPersistedForm.useSolicitanteStep
useSolicitanteStep
useLaboralStep
useLaboralStep
useConyugeStep
useConyugeStep
toggleConyuge y expone toggleEmpresaConyuge para el sub-formulario de empresa del cónyuge.useRevisionStep
useRevisionStep
prettyPayload (JSON formateado) para visualización en desarrollo.useDocumentos
useDocumentos
Estados de Solicitud
El ciclo de vida de una solicitud sigue los siguientes estados definidos enshared/types/enums.ts:
| Estado | Descripción |
|---|---|
POSTULADO | Solicitud recién creada, pendiente de documentos |
DOCUMENTOS_CARGADOS | El afiliado completó la carga de documentos requeridos |
ENVIADO_VALIDACION | Solicitud enviada al equipo de validación interna |
PENDIENTE_FIRMADO | En proceso de firma digital con FirmaPlus |
FIRMADO | Todos los firmantes completaron la firma electrónica |
ENVIADO_PENDIENTE_APROBACION | Remitida al comité de crédito para aprobación |
APROBADA | Crédito aprobado por COMFACA |
RECHAZADA | Solicitud rechazada por el comité |
DESESTIMADA | Descartada por información incompleta o inconsistente |
CANCELADA | Cancelada administrativamente |
DESISTE | El afiliado desistió voluntariamente del proceso |
validateSolicitudLimit restringe el número de solicitudes activas simultáneas por afiliado. Si el usuario ya cuenta con una solicitud en estado activo (POSTULADO, DOCUMENTOS_CARGADOS, ENVIADO_VALIDACION o PENDIENTE_FIRMADO), el endpoint POST /api/solicitudes/guardar-solicitud retorna un error 422 indicando que debe completar o cancelar la solicitud existente antes de iniciar una nueva.