Diseñar e implementar la API necesaria para soportar el modelo multiempresa, cubriendo operaciones y reglas de negocio requeridas para la solución descrita.

Permitir entregas parciales en operaciones del tipo de negocio ferretería, con flujo claro para registrar lo entregado, lo pendiente, trazabilidad del saldo pendiente y consistencia comercial/operativa.

Implementar un tutorial guiado, activable desde configuración de perfil, con experiencia similar a onboarding de videojuegos: pasos, ayudas contextuales, posibilidad de reactivarlo y control por usuario.

# Plan: Movimientos de Caja y Cuadre de Caja v2 en EPC ## Resumen Implementar una base operativa de caja en EPC sin tocar documento soporte DIAN, porque ese flujo fiscal debe quedar en EP Contable. EPC manejará Movimientos de Caja como módulo operativo para gastos menores, retiros, consignaciones, bases y ajustes autorizados; y el Cuadre de Caja v2 consumirá facturación, pagos, devoluciones, plan separe, compras de contado y movimientos de caja para generar un reporte único por niveles. La tabla existente arqueo_diario se reutilizará como cierre/verificación de caja, no como fuente de movimientos. Los conceptos operativos tendrán vínculo opcional futuro con conceptos_contables_manuales, sin depender de que EP Contable esté completo. ## Cambios Clave - Crear migración V1_0_4_6_206__Movimientos_caja_y_arqueo.sql. - Crear tabla caja_conceptos_movimiento: - ID, NOMBRE, TIPO_MOVIMIENTO, SIGNO, AFECTA_CAJA, REQUIERE_MEDIO_PAGO, CONCEPTO_CONTABLE_MANUAL_ID nullable, ACTIVO, ORDEN, FECHA_CREACION. - FK opcional hacia conceptos_contables_manuales.ID. - Insertar conceptos base: transporte, domicilios, papelería, aseo, reparaciones menores, bienestar, servicios públicos, internet/telefonía, combustible, parqueadero/peajes, empaques/bolsas, comisiones bancarias, compra menor, alimentación, mensajería, retiro administración, retiro propietario, retiro para cambio/sencillo, traslado caja a caja, consignación bancaria, entrega a supervisor, base inicial, base final, otro ingreso, reintegro de gasto y recuperación de dinero. - Crear tabla caja_movimientos: - ID, CONCEPTO_ID, FECHA, USUARIO_ID, BODEGA_ID, CAJA_ID, MEDIO_PAGO_ID nullable, VALOR, OBSERVACION, ESTADO, ANULADO, FECHA_CREACION. - No manejar documento soporte DIAN aquí. - Reorganizar arqueo_diario para cierre: - Mantener campos útiles actuales: base inicial, ventas, descuentos, devoluciones, ingresos, egresos, caja cierre, efectivo contado, diferencia y verificado. - Agregar ID_BODEGA, FECHA_INICIO, FECHA_FIN, BASE_FINAL, SOBRANTE, FALTANTE, ESTADO, USUARIO_VERIFICA, FECHA_VERIFICACION, OBSERVACION. - Dejar IDFACTURAS sin uso funcional nuevo o migrarlo a nullable/compatibilidad si la FK lo permite sin romper bases existentes. ## Módulo Movimientos de Caja - Crear módulo Movimientos de Caja con diseño simétrico al sistema: - encabezado con nombre del módulo y bodega si multi-bodega está activa. - grilla de movimientos del día/rango. - formulario compacto para registrar movimiento. - botón/opción Arqueo / Cierre. - Tipos operativos: - GASTO, RETIRO, CONSIGNACION, BASE_INICIAL, BASE_FINAL, AJUSTE, OTRO_INGRESO. - Reglas: - GASTO, RETIRO, CONSIGNACION y BASE_FINAL restan caja cuando apliquen. - BASE_INICIAL y OTRO_INGRESO suman caja. - sobrante y faltante no se registran como conceptos base; se calculan en arqueo. - anulación solo con permiso. - Permisos nuevos: - CAJA_MOVIMIENTOS_VER - CAJA_MOVIMIENTOS_CREAR - CAJA_MOVIMIENTOS_ANULAR - CAJA_ARQUEO_CERRAR - CAJA_ARQUEO_VERIFICAR - CAJA_CUADRE_ADMIN - CAJA_CUADRE_VER_OTROS_USUARIOS - CAJA_CUADRE_VER_TODAS_BODEGAS ## Cuadre de Caja v2 - Reemplazar la tabla plana actual por un reporte único con niveles: - Cajero: efectivo esperado, efectivo contado, diferencia, ingresos/egresos reales por medio de pago del usuario/caja. - Supervisor: incluye descuentos, devoluciones, anticipos, recibos, ventas a crédito y movimientos informativos. - Administrador: incluye consolidado por usuario, bodega/caja, y todos los bloques. - Cambiar etiqueta Nombre forma de pago por Medio de pago. - Separar visualmente: - Ingresos reales: ventas pagadas, recaudos, anticipos plan separe, otros ingresos. - Egresos reales: devoluciones de dinero, pagos/proveedores si afectan caja, gastos, retiros, consignaciones. - Informativos: venta a crédito, saldo a favor aplicado, anticipo plan separe aplicado, compensación cartera. - Arqueo: base inicial, base final, efectivo esperado, efectivo contado, sobrante, faltante, verificación. - Evitar confusión de plan separe: - Anticipo plan separe - EFECTIVO/TRANSFERENCIA va en ingresos reales. - Anticipo plan separe aplicado queda solo en informativos y no suma caja. - Usar EP.REPORTES y PdfFormatoEstandar para el PDF. ## Integraciones - Facturación aporta ventas por medio de pago, crédito, descuentos, saldos a favor aplicados y anticipos plan separe aplicados. - Pagos/Finanzas aporta recaudos de clientes y pagos a proveedores cuando afecten caja. - Plan Separe aporta anticipos reales y devoluciones de anticipo. - Devoluciones aporta devoluciones de dinero, compensaciones e informativos. - Compras aporta solo compras pagadas de contado desde caja. - Movimientos de Caja aporta gastos, retiros, consignaciones, bases, ajustes y otros ingresos. - EP Contable queda como dueño de documento soporte DIAN; EPC solo podrá referenciar en el futuro un origen contable si existe. ## Pruebas - Registrar base inicial, venta en efectivo, venta a crédito, recaudo, anticipo plan separe, gasto, retiro y consignación; validar cuadre por nivel. - Confirmar que Anticipo plan separe aplicado no suma caja, pero aparece como informativo. - Confirmar que Saldo a favor aplicado no suma caja. - Validar sobrante/faltante calculado con efectivo contado - efectivo esperado. - Validar cajero sin permiso: solo ve su caja/usuario y nivel cajero. - Validar supervisor: puede verificar arqueo de otro usuario. - Validar administrador: puede ver consolidado por usuario/bodega. - Validar multi-bodega: si está activa, filtra por bodega/contexto; si no, usa bodega operativa actual. - Compilar EPC/EP.csproj y EPC.Tests/EPC.Tests.csproj. - Generar PDF de Cuadre de Caja y revisar visualmente con MCP. ## Supuestos - Documento soporte DIAN queda fuera de esta fase y se maneja en EP Contable. - conceptos_contables_manuales sigue siendo contable; EPC crea conceptos operativos propios y solo guarda vínculo opcional. - El modo por defecto será caja simple: un usuario puede registrar movimientos y cerrar si tiene permisos. - No se implementa todavía una administración avanzada de cajas físicas; CAJA_ID queda preparado con valor por defecto 1. - El módulo se crea para EPC y aplica transversalmente a los tipos de negocio donde ya opera facturación/caja, respetando multi-bodega cuando esté activa.

Crear flujo para conteo de inventario desde Tools usando plantilla exportable de Excel. Al cargarla, antes de ajustar, debe generar reporte de auditoría guardable como historial para trazabilidad en el tiempo. Debe permitir confrontar inventario físico vs sistema, apoyar seguimiento, KPIs y toma de decisiones. También debe servir para primer inventario, validando que en ese primer inventario no aplique la misma lógica de auditoría que sí debe aplicar después. Incluir además inventarios parciales por una o varias secciones, pero no necesariamente todas.

Crear funcionalidad de impresión de etiquetas con código QR, contemplando formato usable en operación y asignación a Jarvis para desarrollo/seguimiento.

Diseñar e implementar manejo multiempresa para ingreso de mercancía, módulo de productos y compras, generando cartera tanto en empresa principal como secundaria. Debe contemplar devoluciones en compra, saldos a favor y demás variaciones que actualicen cartera automáticamente. Si los establecimientos están bajo la misma razón social, podrá usarse una sola base de datos con tablas de establecimiento. Si son razones sociales distintas, deben ser bases de datos separadas por razón social. En ese caso, clientes, productos, proveedores y demás datos compartidos deben configurarse para que la empresa principal lidere creación, además del inventario y la cartera. Esta capacidad debe existir solo en un tipo de negocio especial, no para los demás.

El documento soporte DIAN debe vivir en EP Contable porque no es solo una salida de caja: requiere manejo fiscal, tercero, numeración, impuestos, XML/PDF, estado DIAN y contabilización. En EPC solo deberíamos registrar el impacto operativo en caja y referenciar ese documento, evitando duplicar lógica tributaria y contable en dos proyectos.

Diseñar e implementar un control de divisas en EP para gestión de cambio de divisas a nivel global, contemplando tasas, trazabilidad, consistencia operativa, reglas por región/empresa y base lista para integración con procesos financieros y comerciales.

Definir, configurar y operar el manejo de retención en la fuente para procesos de compras y facturación en EPC.

Implementar informes tributarios en EP Contable.

Estructurar y aterrizar los informes de INVENTARIO con enfoque funcional y operativo. Alcance: 1) relación entrada/salida de referencias por proveedor (cuánto llegó, cuánto se vendió, cuánto quedó), 2) saldos de inventario, 3) relación de inventario por proveedor y saldos con código, referencia, descripción, costo, cantidad y totalización de cantidad y costo, 4) relación de referencias que salen de bodega hacia las tiendas, 5) informe para identificar cuáles referencias están sin fotos, 6) informe de distribución de referencias en tiendas mostrando también pendientes por enviar por referencia/talla/sede. Entregables: lista depurada de informes, objetivo funcional de cada uno, columnas/campos mínimos, filtros sugeridos, dudas o vacíos de definición y priorización recomendada para desarrollo.

Diseñar la alerta funcional de que se está agotando una referencia. Entregables: 1) lógica de disparo de la alerta, 2) criterio mínimo de stock, 3) definición de si aplica por bodega, tienda y variante/talla, 4) niveles de severidad, 5) texto exacto de la alerta para usuario, 6) lugares o momentos donde debe mostrarse, 7) casos borde para evitar ruido o falsas alertas.

Evaluar formularios de la DIAN para IBAS, retenciones, renta jurídica, renta natural e impoconsumo.

Implementar la funcionalidad para cargar saldos a favor y reflejar el saldo compensado en los movimientos de cartera dentro del módulo de pagos. Cuando un cliente tenga saldo a favor, este debe poder compensarse automáticamente al realizar nuevos pagos o facturas, con trazabilidad completa del movimiento.

Mejorar la experiencia de selección de elementos en el módulo de pagos. Actualmente el check de selección no es claro. Proponer y aplicar una mejora usando sombreado (highlight) para que la selección sea más visual e intuitiva para el usuario.

Alinear las cajas de texto de los inputs en el formulario de registro de pago. Reorganizar todo el panel de pagos para que tenga una estructura limpia, con campos alineados, espaciado consistente y una distribución lógica del formulario.

Reubicar el botón salir en el módulo de pagos a una posición más accesible y lógica. Además, aplicar un estilo de contorno/borde al botón salir de manera general en todo el sistema para que sea consistente y visualmente diferenciado de otros botones de acción principal.

Crear plantillas de impresión globales para comprobantes de pago en dos formatos: TIRILLA (formato pequeño/ticket) y CARTA (formato completo). Estas plantillas deben ser reutilizables en todo el sistema, con diseño profesional, datos del comprobante, logo, y formato estandarizado.

Remover las etiquetas modales de descripción que aparecen como tooltips en la interfaz. Estos tooltips están generando ruido visual y no aportan valor al usuario. Eliminarlos de manera general en los componentes donde aparezcan.

En los DataGrids, al seleccionar un registro, se aplica un doble sombreado: uno cuando el cursor está encima (hover) y otro que permanece después de quitar el cursor. Dejar solo el sombreado de hover (el que sale cuando el cursor está encima) y retirar el sombreado persistente que queda después de quitar el cursor. La selección debe ser clara solo con el hover.

Urgente: Resolver y arreglar las funcionalidades del sistema EP que estan relacionadas con multi bodega. Esto incluye: 1. Revisar y corregir el manejo de inventario en modo multi-bodega (entradas, salidas, transferencias entre bodegas) 2. Verificar que facturacion respete el contexto de bodega activa 3. Asegurar que cartera y cuentas por cobrar se manejen correctamente por bodega 4. Revisar que compras y recepcion de mercancia asignen correctamente la bodega 5. Validar que los reportes de inventario y ventas filtren por bodega cuando multi-bodega esta activa 6. Corregir cualquier bug o comportamiento inconsistente detectado 7. Probar el flujo completo: ingreso de mercancia -> venta -> cierre de caja en modo multi-bodega Este阻bloqueo afecta directamente la operacion de clientes que manejan multiples sedes. Prioridad maxima.

Diseñar, implementar y dejar operando el módulo contable completo en EPC.

Los módulos nuevos deben actualizar los registros en el módulo de registros tal y como todos los demás movimientos. Evaluar cuáles movimientos sí deben impactar registros y cuáles no, y dejar ese comportamiento definido e implementado donde corresponda.

Implementar exportación de informes a Excel tanto en EP como en EP Contable.