--- audiencia: usuario screen_key: solicitudes/credito titulo: Solicitud de Crédito aliases: [credito, crédito, prestamo, préstamo, financiacion, financiación, cuotas, solicitud, politica cobranza] --- # Solicitud de Crédito — Guía para el Usuario Esta guía describe el flujo completo de una **solicitud de crédito**: desde que el vendedor la carga, pasa por aprobación del supervisor, hasta que se factura desde el POS. También cubre los **planes de cuotas por producto**, la **política de cobranza acordada** (frecuencia + días fijos + gracia) que viaja de la solicitud a la factura y a la agenda del cobrador, y las configuraciones relacionadas. --- ## ¿Qué es una solicitud de crédito? Es un **pedido formal** que un vendedor arma para un cliente que quiere comprar a crédito (en cuotas). En lugar de facturar directamente, primero se genera la solicitud con todos los datos (cliente, productos, plan de cuotas, cronograma, **política de cobranza acordada**) y queda **pendiente de aprobación** del supervisor. Una vez aprobada, se puede convertir en factura desde el POS y la política acordada se **propaga automáticamente** a la cuenta a cobrar — para que el cobrador en campo (móvil) sepa exactamente qué día visitar al cliente. Sirve para: - Tener un registro previo a la facturación con autorización explícita. - Mostrar al cliente un cronograma de pagos claro antes de cerrar la venta. - Que un supervisor revise el historial crediticio del cliente antes de aprobar. - **Persistir la política de cobranza** (día fijo del mes, día semanal, días de gracia especiales) que después usa el cobrador en su ruta. - Documentar quién aprobó qué y cuándo, con auditoría completa. --- ## ¿Dónde encuentro esto en el menú? - **Ventas → Créditos**: listado principal con filtros, resumen (Total / Borradores / Pendientes / Aprobadas / Facturadas) y acciones. (El ítem del menú lateral se llama "Créditos"; la pantalla en sí se titula "Solicitudes de Crédito".) - **Ventas → Créditos → Nueva Solicitud**: formulario en dos pasos (Cliente → Productos). - **POS Admin** (facturación): botón **"Solicitudes Crédito"** para facturar una solicitud ya aprobada. - **Configuración → Facturación → Planes de Cuotas Automáticos**: ABM de los planes de cuotas por empresa (no es una sección dentro del detalle del producto — ver más abajo). - **Configuración → Cobranzas → Configuración de Mora**: define el **período de gracia por default** de la empresa (heredado por todas las solicitudes salvo override explícito). - **Cobranzas → Mesa de Gestión → filtro "Cobros de hoy"**: usa la política para mostrar solo los clientes que hoy toca visitar según su día acordado. --- ## Estados posibles Una solicitud puede estar en uno de estos estados, identificables por color de chip en el listado: | Estado | Color | Significado | |---|---|---| | **borrador** | gris | Se está armando, todavía no se envió a aprobación. Editable. | | **pendiente_aprobacion** | naranja | Esperando que un supervisor la apruebe o rechace. | | **aprobada** | verde | Lista para facturar desde el POS. | | **rechazada** | rojo | El supervisor la rechazó (queda el motivo). | | **facturada** | azul | Ya se convirtió en factura. Solo lectura. | | **cancelada** | gris oscuro | Anulada manualmente. | --- ## Planes de cuotas por producto (requisito previo) Antes de poder cargar una solicitud, conviene tener configurados **planes de cuotas en los productos**. Esto agiliza la carga porque el vendedor solo elige el plan en lugar de calcular monto y cantidad manualmente. ### Crear un plan de cuotas 1. Ir a **Configuración → Facturación → Planes de Cuotas Automáticos**. 2. Tocar el botón de **agregar plan** (ícono "+"). 3. Completar: - **Nombre** (y código): descriptivo, ej. "3 sin interés", "6 mensuales". - **Cantidad de cuotas** e **intervalo en días** entre cada una. - **Tasa de interés** (opcional) y **tipo de interés**: Simple, Compuesto o Francés. - **Cuota inicial requerida** (toggle), con su **monto mínimo** si aplica. - **Rango de aplicación**: monto mínimo / monto máximo del producto (y opcionalmente categoría) para que el plan se ofrezca automáticamente. 4. Guardar. El plan **no se asigna manualmente a cada producto**: el sistema lo ofrece automáticamente en la solicitud de crédito y en el POS cuando el precio del producto cae dentro del rango configurado (o su categoría coincide). La pantalla incluye un simulador para ver el desglose de cuotas antes de guardar. > Los planes son por empresa y se reutilizan en cualquier sucursal. --- ## Crear una solicitud de crédito ### Pasos 1. Entrar a **Ventas → Créditos** y tocar **"Nueva Solicitud"**. 2. **Cliente**: buscar con el selector con buscador. Al seleccionar aparece: - Historial crediticio compacto (deuda, límite, cuotas vencidas). - Botón **"Ver detalle"** que abre el drawer completo del cliente (facturas, gestiones de mora, refinanciaciones, timeline, estado de cuenta PDF) — el mismo drawer que se ve desde Contactos. 3. **Vendedor / Cobrador**: selectores con **buscador integrado** (`Autocomplete`), no un dropdown gigante scrolleable. El cobrador es opcional y puede ser distinto al vendedor. 4. **Sucursal, punto de expedición, moneda**: se configuran arriba. 5. **Productos**: por cada producto: - Buscar y agregar (el modal de búsqueda soporta filtro por **categoría** y **marca**). - Cargar la cantidad. - Si el producto tiene **planes de cuotas configurados**, elegir uno del desplegable (precarga cantidad de cuotas y monto). Si no, cargar manual. 6. Panel derecho **"Condiciones"** con la política de cobranza — ver siguiente sección. 7. **Cuota inicial** (opcional): si el cliente paga una entrada distinta de los planes de producto. 8. **Observaciones**: texto libre. 9. **Guardar como borrador** → queda editable. **Enviar a aprobación** → genera el número formal (formato `establecimiento-punto-numero`) y cambia el estado. ### Validaciones - No se puede enviar a aprobación una solicitud **sin ítems**. - Solo se puede editar mientras está en estado **borrador**. - Una vez enviada, los cambios requieren cancelar y crear de nuevo. --- ## Política de cobranza acordada **Novedad clave**: la solicitud captura la **política de cobranza específica del cliente** (no una condición genérica). Esa política viaja del acuerdo al cronograma, y **cuando la solicitud se factura, se copia automáticamente a la cuenta a cobrar** — así el cobrador en su app móvil ve "Cobrar los días 5 y 20" sin que nadie lo cargue de nuevo. ### Frecuencia Se elige entre **Semanal (7 días)**, **Quincenal (15 días)** o **Mensual (30 días)**. Se puede alternar libremente (las cuotas se recalculan manteniendo el monto total). ### Vencimientos según frecuencia - **Mensual** — un solo día fijo: `Día 1`, `Día 15`, `Día 30`, etc. Todas las cuotas caen ese día de cada mes. Si el día no existe (ej. 31 de febrero) se ajusta al último día del mes. - **Quincenal** — **dos días fijos por mes** que alternan. Los presets rápidos son: - **15 y último** (típico para sueldo mensual + medio mes). - **5 y 20** (patrón habitual en clientes con sueldo del sector privado). - **1 y 15**. - **10 y 25**. También se pueden elegir manualmente en los dos selectores independientes. - **Validación**: los dos días no pueden ser iguales; su separación debe ser ≥ 5 días. Si están muy cerca (5–9 días) aparece un warning ámbar; el sistema bloquea la confirmación si es < 5 días. - **Semanal** — se elige el día de la semana (Lunes / Martes / … / Domingo). Todas las cuotas caen ese día. ### Fecha de la primera cuota - Se elige libremente con un date picker. - Si la fecha elegida **no coincide con un día fijo** de la política, el sistema **ajusta automáticamente** al próximo día fijo posterior. Se muestra un mensaje ámbar tipo "El día 10 no coincide con la política (5 / 15). Primera cuota ajustada a 15/08/2026." — así el vendedor sabe qué fecha va a arrancar el cronograma sin sorpresas. - No se generan cuotas anteriores a la fecha elegida como arranque, incluso si la política tiene un día previo en el mes. ### Días de gracia - Por default se heredan de **Configuración → Cobranzas → Configuración de Mora → Período de gracia (días)** de la empresa (ej. 5 días). - El chip en el panel muestra el valor efectivo con la etiqueta *"según config. mora"*. - Se puede **ajustar por solicitud** si hay un acuerdo especial con ese cliente: clic en el chip → popover con input numérico y **motivo obligatorio** (queda en auditoría). Ejemplo de motivos válidos: "cliente VIP", "convenio empresa", "empleado". - Cuando hay override, el chip cambia a color warning con la etiqueta *"acuerdo"* y en el detalle de factura queda visible el número acordado. ### Cronograma - Se calcula en vivo mientras se completa el formulario. - Cada cuota se ajusta al día fijo correspondiente. En quincenal las cuotas alternan entre día_1 y día_2. - El **residuo por redondeo** se absorbe en la última cuota, así el total del cronograma coincide exactamente con el monto a financiar (nunca genera una cuota extra corta). --- ## Aprobar o rechazar una solicitud (supervisor) El supervisor necesita el permiso **`VEN_SOL_SOLICITUD_APROBAR`** (submódulo `VENTA_SOLICITUD_CREDITO`, dentro del módulo Ventas). No se pide PIN — el sistema valida por el permiso del rol del usuario. ### Pasos del supervisor 1. Entrar al listado y filtrar por estado **"Pendiente de aprobación"**. 2. Tocar la solicitud → abre el **diálogo de detalle** con: - **Información general** (número, fecha, cuotas total, moneda). - **Cliente** + botón **"Ver detalle"** que abre el drawer histórico completo. - **Historial crediticio compacto** con deuda, cuotas vencidas, últimas facturas. - **Política de Cobranza** — chips visibles con frecuencia, días fijos y gracia acordada. - **Detalle de productos** con cantidad, cuotas, monto/cuota y total. - **Cronograma de pagos** completo con fechas y saldos. - **Vendedor** y **creador** (usuario que cargó). 3. Opcionalmente, imprimir el PDF para revisar en papel. 4. Decidir: - **Aprobar** → estado pasa a `aprobada`, queda registrado `aprobado_por` + `fecha_aprobacion`. - **Rechazar** → pide motivo obligatorio, estado pasa a `rechazada`. ### Auditoría Cada acción queda en `solicitud_credito_historial` (creado, enviado, aprobado, rechazado, cancelado, facturado) con usuario, fecha y datos del momento. Visible en el detalle. Los cambios de política (gracia override, edición de días fijos) también se auditan. --- ## Imprimir el PDF de la solicitud Disponible en cualquier estado (sirve para que el vendedor lleve la solicitud impresa al supervisor o al cliente). - Desde el listado: ícono **"PDF"** en la fila. - Desde el detalle: botón **"Generar PDF"**. El PDF (formato A4) incluye: - Encabezado con datos de la empresa. - Datos del cliente, vendedor, cobrador, condición de pago. - Tabla de productos con cantidad, plan de cuotas y total. - **Cronograma de cuotas** con fechas y montos. - Espacio para firmas de vendedor y supervisor. --- ## Facturar una solicitud aprobada (desde POS) Una vez aprobada, la solicitud queda lista para convertirse en factura. ### Pasos 1. Entrar al **POS Admin** (facturación). 2. Tocar **"Solicitudes Crédito"**. 3. Se abre el diálogo **`SolicitudesCreditoPendientesDialog`** con la lista. Cada solicitud muestra en su card: - Número, estado y cantidad de cuotas. - Cliente y RUC. - **Frecuencia real** (Semanal / Quincenal / Mensual) — no el descripción genérico de la condición de pago. - **Días fijos**: `"Días 5 y 15"` (quincenal) o `"Día 15"` (mensual) o `"Lun/Mar/…"` (semanal). - **Gracia acordada** si hay override. - Total y observaciones. 4. Seleccionar la solicitud. 5. El POS precarga automáticamente: - Cliente, vendedor, cobrador. - Condición de pago **real** (intervalo, cantidad de cuotas, cuota inicial). - Todos los ítems con su producto, cantidad, precio y plan de cuotas. - **Cronograma con las fechas correctas** — respetando día fijo mensual, alternancia quincenal (día_1/día_2) y días de gracia. 6. Revisar, ajustar si hace falta, y **facturar normal**. 7. Al confirmar la factura, el sistema: - Crea la factura electrónica. - **Marca la solicitud como `facturada`** y guarda el `factura_id` para trazabilidad. - **Copia la política de cobranza** (intervalo, día_1, día_2, día_semana, gracia_override) desde la solicitud a la nueva `cuentas_cobrar`, con el link `solicitud_credito_id` para trazabilidad. > Una solicitud aprobada solo se puede facturar una vez. Después queda en solo lectura. --- ## Después de facturar — visibilidad de la política La política acordada se ve en múltiples pantallas para que **nadie tenga que recordarla ni buscarla**: ### En el detalle de la factura Sección **"Política de Cobranza"** con chips: - Frecuencia (Semanal / Quincenal / Mensual). - Días de vencimiento (`Días 5 y 20 de cada mes` / `Día 15 de cada mes` / `Lunes de cada semana`). - Chip warning "Gracia acordada: N días" si hay override. También aparece **"Documentos vinculados"** con las card de la solicitud de origen (número, fecha, estado, total) y del pedido si aplica. ### En el drawer del cliente (Contactos → Historial) Al expandir cualquier factura de crédito, sobre las cuotas se muestra la fila de chips con la política acordada. ### En gestión de cobros (web) Al ver el detalle de una factura crédito desde el módulo Cobros, aparece la sección "Política de cobranza" con frecuencia, vencimientos y gracia. ### En la app móvil del cobrador - **Pantalla del cliente**: chip destacado con el resumen de política común si todas sus facturas comparten el mismo acuerdo (ej. `📅 Cobrar quincenal · días 5 y 20`). - **Estado de cuenta**: chip discreto en cada factura y chip más destacado en el header del bottom sheet cuando se abre el detalle. ### En la Mesa de Gestión de cobranzas Nuevo botón **"Cobros de hoy"** (color info, ícono `calendar-clock`) que filtra el worklist a los clientes cuyo día fijo (5, 15, 20, etc.) coincide con hoy, o cuyo día semanal es el actual, o que tienen cuotas venciendo dentro del período de gracia. Sirve para armar la ruta del día. ### En el endpoint `/panel-cobrador/agenda-hoy` Devuelve la agenda derivada del día para el cobrador, resolviendo la precedencia del cobrador asignado: 1. Cobrador de la factura (override específico). 2. Cobrador de la dirección de entrega (`cliente_direcciones.cobrador_id`). 3. Cobrador default del cliente. Cada item viene con `cobrador_origen` (`FACTURA` / `DIRECCION` / `CLIENTE`) y `motivo` (`DIA_FIJO_1`, `DIA_FIJO_2`, `DIA_SEMANAL`, `VENCIDA`, `PROXIMA`) para trazabilidad. ### Reporte de cartera por día de cobro Endpoint `/panel-cobrador/cartera-por-dia-cobro` devuelve la distribución de clientes/cuentas/saldo agrupada por día del mes y día de la semana, incluyendo un bucket "sin política" para clientes que todavía no tienen acuerdo definido. Sirve para dimensionar carga por día del cobrador y planear rutas. --- ## Cancelar una solicitud - Mientras está en **borrador**, **pendiente** o **aprobada** (no facturada), se puede cancelar desde el detalle. - Si ya fue **facturada**, no se puede cancelar — habría que anular la factura por el flujo de anulación de facturas. --- ## Permisos del módulo Submódulo: **`VENTA_SOLICITUD_CREDITO`** (dentro del módulo Ventas). Permisos: | Permiso | Quién lo necesita | |---|---| | **`VEN_SOL_SOLICITUD_CREAR`** | Vendedores que cargan solicitudes. | | **`VEN_SOL_SOLICITUD_VER`** | Quien necesite ver el listado / detalle. | | **`VEN_SOL_SOLICITUD_EDITAR`** | Vendedor que ajusta borradores. | | **`VEN_SOL_SOLICITUD_APROBAR`** | Supervisores. Permite aprobar/rechazar. | | **`VEN_SOL_SOLICITUD_ELIMINAR`** | Cancelar/anular. | | **`VEN_SOL_PRECIO_EDITAR`** | Editar a mano el precio unitario de un producto en la solicitud. | Se configuran desde **Configuración → Usuarios y Permisos → Perfiles y Roles**. --- ## Filtros del listado La página de listado soporta: - **Filtros rápidos** de fecha: Hoy, Ayer, Esta semana, Este mes, Mes anterior. - **Chip "Solo refinanciaciones"** para ver solo las solicitudes generadas por refinanciación. - **Estado** (multi-selección). - **Cliente** (buscador). - **Vendedor**. - **Sucursal**. - **Rango de fechas** (desde / hasta). - **Búsqueda libre** por número, cliente o RUC. Resumen arriba con 5 KPI cards: Total / Borradores / Pendientes / Aprobadas / Facturadas. Las columnas muestran (visibles por default): número, fecha, cliente, cantidad de ítems, cantidad de cuotas, total, estado, **creado por** (nombre completo del usuario). Vendedor es opcional y se puede activar desde el menú de columnas. --- ## Problemas frecuentes - **"No puedo enviar a aprobación"** → la solicitud no tiene ítems, o falta seleccionar vendedor. Agregarlos primero. - **"No me deja confirmar por los días quincenales"** → los dos días están iguales o su separación es < 5 días. Ajustar (típico: 15 y último, 5 y 20). - **"La fecha primera cuota no es la que puse"** → la fecha se ajusta al próximo día fijo de la política. Se muestra un aviso ámbar con la fecha efectiva. - **"No me deja editar"** → solo los borradores son editables. Si está pendiente, hay que cancelar y crear de nuevo (o pedir rechazo al supervisor). - **"No aparece en el POS"** → solo aparecen las solicitudes en estado **aprobada** que no estén facturadas. Verificar el estado en el listado. - **"No tengo permiso para aprobar"** → falta el permiso `VEN_SOL_SOLICITUD_APROBAR` en el rol del usuario. - **"Las cuotas no cuadran por unos guaraníes"** → es normal: el sistema redondea cada cuota al millar y mete la diferencia en la última. Se puede editar manualmente el cronograma si se necesita exactitud. - **"El cobrador de la ruta no ve una factura que sí es suya"** → verificar la precedencia del cobrador. Si la factura tiene `cobrador_id` seteado, gana ese; sino gana el de la dirección; sino gana el default del cliente. Se resuelve corrigiendo en el nivel adecuado (factura / dirección / cliente). - **"Los días de gracia no son los que puse"** → el default se hereda de **Configuración → Cobranzas → Configuración de Mora**. Si necesitás otro para ese cliente, usar el override desde la solicitud (con motivo obligatorio). --- ## Limitaciones actuales (a tener en cuenta) - **No hay reserva de stock al aprobar**: el sistema no descuenta ni reserva mercadería. El stock solo se mueve al facturar. Si vendiste el mismo producto a dos clientes a crédito y solo tenés una unidad, hay que coordinarlo manualmente. - **No hay scoring automático**: el supervisor decide aprobar mirando el historial crediticio compacto, no hay reglas automáticas. - **Aprobación de un solo nivel**: no hay flujo multi-nivel (solo vendedor → supervisor). - **No se facturan parcialmente**: la solicitud se factura entera o nada. No se puede dividir en dos facturas. - **Cálculo manual de cuotas**: los planes de cuotas en producto se cargan a mano (no hay auto-cálculo de interés). - **La política de cobranza se decide en la solicitud original**: si el acuerdo con el cliente cambia después de facturar, hoy se ajusta directamente en `cuentas_cobrar` (regenerar cuotas respeta la política actual de la cuenta). No hay flujo específico de "cambio de política" con aprobación. - **Rutas de cobro materializadas**: la agenda del día se calcula en vivo desde la política; todavía no hay un job cron que congele "las visitas del día" en la tabla `rutas_cobranza` (queda como paso opcional).