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.

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.

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

# 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.

Revisar funcionamiento del cuadre de caja, reorganizar su estructura y ajustar el lenguaje para que sea claro y natural para el cajero.

Crear los conceptos estándar que quedarán para el uso de gastos en EP Core, en la tabla de conceptos contables, y asignarlo a Jarvis para implementación/seguimiento.

28. Organizar el tamaño de los objetos según la resolución de pantalla y dejar el encabezado más pequeño. 29. Dejar cotizaciones solo para ferretería.

Completar la fase 3 pendiente, cerrando alcance funcional, validaciones y entregables asociados.

Corregir el tamaño visual de los totales para que no se salgan de proporción ni rompan la estructura de la tabla.

Ajustar el tamaño de letra de los saldos a favor de clientes y agregar el logo faltante para mantener consistencia visual y documental.

Revisar por qué Tools aparece bloqueado aunque existan permisos en perfil de empresa, identificar la causa y corregir la autorización efectiva.