# EtchManager Documentación funcional y de usuario de EtchManager. # 01 — Inicio y navegación # Dashboard ## **Descripción General** El dashboard es la vista principal que permite a los usuarios supervisar y gestionar los datos clave del sistema. Proporciona una visión consolidada de estadísticas, gráficos y tablas dinámicas para facilitar la toma de decisiones. [![dashboard.png](https://docs.ricor.cl/uploads/images/gallery/2026-08/scaled-1680-/K6UMm3OT1PNYaWgo-download.png)](https://docs.ricor.cl/uploads/images/gallery/2026-08/K6UMm3OT1PNYaWgo-download.png) ## **Funcionalidades Principales** 1. **Filtro por rango de fechas**: - Selecciona el período que deseas analizar. - Los indicadores, gráficos y listados se actualizan según el rango elegido. 2. **Cajas Informativas**: - Muestra estadísticas clave como: - **Nuevos**: Elementos recientemente añadidos. - **En Proceso**: Elementos que están en proceso. - **Terminados**: Elementos completados. - **Total**: Cantidad total de elementos. - **Usuarios Conectados** (visible solo para el rol **Super Admin**). 3. **Gráficos**: - **Grabados por Estados**: Visualiza el desglose de grabados según su estado. - **Grabados por Sucursal**: Muestra datos agrupados por sucursal y organización. 4. **Listados de actividad**: - Listas de elementos "Nuevos" o "Realizados", basadas en el rango de fechas seleccionado. # Menú y permisos ## Menú principal La navegación de EtchManager se construye según los permisos y roles del usuario. Las secciones principales actuales son: - Inicio. - Grabados. - Reportes. - Órdenes. - Insumos. - Maestros. - Usuarios. - Ajustes. - Ayuda. ## Grabados Incluye: - Tareas. - Histórico. ## Órdenes Incluye: - Grabados. - Servicios. ## Insumos Puede incluir: - Productos. - Servicios. - Reposiciones. - Inventarios. - Consumos. - Configuración. ## Maestros Para perfiles administrativos puede incluir: - Organizaciones. - Sucursales. - Marcas. - Dispositivos. - Notificaciones POS. - SIMs POS. - Logs de dispositivos. - Diffs POS/Backend. - Importaciones. ## Usuarios Incluye, según permisos: - Usuarios. - Permisos. - Roles. ***Estos dos ultimos estan disponibles solo para **Admin** y **Super Admin**.* ## Ajustes Disponible normalmente para **Admin** y **Super Admin**. ## Ayuda Redirige a esta documentación # 02 — Grabados # Tareas # Tareas ## ¿Qué puedes hacer en esta sección? En esta sección puedes gestionar las tareas y revisar su estado. #### Alcance: - La vista de tareas solo muestra las tareas ejecutadas durante el mes en curso - Para visualizar tareas de meses anteriores debe ir al menú **Histórico** y filtrar por fecha, o por el criterio disponible. ### Opciones principales: - **Crear una nueva tarea:** Haz clic en el botón **Nueva** para registrar una nueva tarea. - **Ver detalles:** Haz clic en el icono acción correspondiente para revisar los detalles de una tarea o reimprimir - **Editar:** Usa el icono acción correspondiente para modificar una tarea - **NOTA:** Debes tener en cuenta que una tarea solo puede ser modificada mientras se encuentra en estado Nuevo; una vez que hayas confirmado la generacion de etiquetas y, haya pasado al estado En Proceso, ya No podrá ser corregido cualquier error de marca, patente, número de orden o codigo del colaborador. ### Estados de las tareas: - **Nuevo:** La tarea está recién registrada. - **En Proceso:** La tarea está siendo trabajada. - **Terminado:** La tarea está completa. ## Filtros y Busquedas: - Puedes filtrar las tareas por sucursal, fecha o Codigo de colaborador (si esta habilitado) usando las flechas al lado del encabezado de la tabla. - Para realizar una busqueda de patente sigue los siguientes consejos: 1. Introduce o selecciona el criterio de búsqueda para los campos que tienes habilitados como el número de orden, codigo del colaborador, o patente. 2. Haz clic en el botón **Buscar** para filtrar los resultados. 3. Los resultados se mostrarán en la tabla. ## Ejemplos de búsquedas - Para buscar la patente como HJGD68, puedes ingresar cualquiera de estas variantes: - '68' : devolverá todas las patentes terminadas en 68. - 'JG' : devolverá todas las patentes que contengan un J seguida de una G. - 'HJGD' : devolverá todas las patentes que empiecen con HJGD. - 'D68' : devolverá todas las patentes que terminen con D68. - Si buscas un número de orden, utiliza el mismo principio que para las patentes Haz clic en **Volver** para regresar a la página principal. # Histórico de grabados ## Introducción En esta sección, puedes buscar y visualizar el historico de grabados registrados en el sistema. ## Cómo realizar una búsqueda 1. Introduce o selecciona los criterios de búsqueda en el formulario, como el numero de orden, nombre del colaborador, sucursal, o el rango de fechas. 2. Haz clic en el botón **Buscar** para filtrar los resultados. 3. Los resultados se mostrarán en una tabla con información detallada. ## Detalles de los Resultados - **Colaborador:** El nombre del colaborador asociado al grabado. - **Sucursal:** La sucursal donde se realizó el grabado. - **Fecha:** Fecha en la que se registró el grabado. - **Total Grabados:** Cantidad total de grabados realizados. ## Ejemplos de búsquedas - Para buscar la patente como HJGD68, puedes ingresar cualquiera de estas variantes: - '68' : devolverá todas las patentes terminadas en 68 dentro del rango de fecha que elegiste - 'JG' : devolverá todas las patentes que contengan un J seguida de una G, dentro del rango de fecha que elegiste - 'HJGD' : devolverá todas las patentes que empiecen con HJGD, dentro del rango de fecha que elegiste - 'D68' : devolverá todas las patentes que terminen con D68, dentro del rango de fecha que elegiste - Si buscas un numero de orden, utiliza el mismo principio que para las patentes ## Usos practicos Algunas combinaciones de busqueda no tienen sentido y devolveran un resultado vacio porque no se cumplirán las condiciones; por ejemplo: - Supongamos que la patente TTJU59 se registró para un vehiculo MAZDA. Si haces una busqueda de la patente TTJU59 pero elijes la marca SUZUKI, a pesar de que esa patente existe, no devolverá resultado alguno porque la marca asociada es MAZDA y no SUZUKI. - Lo mismo podria ocurrir si combinas la busqueda de un numero de orden con un patente, o con un colaborador. ** NOTAS: - Ten en cuenta que siempre debes elegir un rango de fechas y, que obtendras unicamente el resultado asociado a tu sucursal. - Si tu sucursal no tiene habilitada el registro de tareas de grabado por Colaborador, no tendrás informacion en ese campo. Idem para el numero de orden # 03 — Reportes # Reportes El módulo de **Reportes** permite generar y consultar reportes consolidados de los grabados realizados en la plataforma. Los reportes están diseñados para ofrecer una visión clara y detallada de las operaciones en función de diferentes filtros y parámetros. ## Funcionalidades Principales | Elemento | Descripción | |---------------------------|----------------------------------------------------------------------------------------------| | **Seleccionar Periodo** | Permite elegir el rango de fechas para el cual se generará el reporte. Incluye opciones como: | | | - **Mes Actual**: Obtiene los datos del mes en curso. | | | - **Enero-Diciembre**: Filtra los datos por meses específicos. | | | - **Rango de Fechas**: Permite seleccionar fechas personalizadas. | | **Tipo de Informe** | Ofrece tres opciones principales para categorizar los datos del reporte: | | | - **Grabados General**: Incluye todos los grabados registrados. | | | - **Grabados por sucursal y organización**: Agrupa los datos por sucursales y organizaciones. | | | - **Grabados por marca, sucursal y organización**: Segmenta los datos por marcas y ubicación. | | **Botones Exportar** | Opciones de exportación de datos en formatos como **Excel** e **Imprimir**. | ## Ejemplo de Flujo de Uso 1. **Selección de Periodo**: - Escoge un rango de fechas que abarque el tiempo que deseas analizar. - Si seleccionas **Rango de Fechas**, se abrirá un calendario para elegir un intervalo específico. 2. **Selección de Tipo de Informe**: - Marca una de las tres opciones para definir cómo se estructurará el reporte. 3. **Generación del Reporte**: - Pulsa el botón **Filtrar** para cargar los datos en la tabla de resultados. 4. **Exportación del Reporte**: - Una vez generado el reporte, utiliza los botones **Excel** o **Imprimir** para exportar o visualizar los datos. ## Tablas y Columnas ### Encabezado de la Tabla | Columna | Descripción | |---------------|----------------------------------------------------------------| | **Organización** | Nombre de la organización asociada al grabado. | | **Sucursal** | Sucursal donde se realizó el grabado. | | **Patente** | Matrícula o identificación del vehículo. | | **Usuario** | Persona que gestionó o realizó el grabado. | | **Código** | Código del Colaborador asociado (si aplica). | | **Estado** | Estado actual del grabado (`Nuevo`, `En Proceso`, `Terminado`). | | **Fecha** | Fecha y hora en la que se registró el grabado. | ## Consideraciones 1. **Accesibilidad por Roles**: - Solo los usuarios con permisos específicos pueden acceder al módulo de reportes. - Ejemplo: Roles como `Supervisor Branch`, `Supervisor Organization`, y `Admin`. 2. **Limitaciones del Filtro**: - El rango de fechas debe ser válido. Si el intervalo es incorrecto, se mostrará un mensaje de error. 3. **Exportación**: - Los reportes exportados a Excel mantendrán la estructura y los filtros aplicados. ## Ejemplo Visual ### Vista General del Módulo [![report.png](https://docs.ricor.cl/uploads/images/gallery/2026-08/scaled-1680-/FtbSfm8DacYVtOLx-download.png)](https://docs.ricor.cl/uploads/images/gallery/2026-08/FtbSfm8DacYVtOLx-download.png) # 04 — Órdenes de Venta # Órdenes de venta ### Descripción La vista de **Órdenes de Venta** permite a los usuarios visualizar, gestionar y realizar acciones sobre las órdenes de venta creadas. Estas órdenes incluyen información detallada sobre la organización, servicios, totales financieros, y grabados realizados. ### Características 1. **Visualización de datos clave**: - Número de la orden de venta. - Organización asociada. - Mes correspondiente. - Servicio asociado o consolidado. - Totales financieros: Neto, IVA y Total. - Estado de la orden. 2. **Acciones disponibles según permisos y roles**: - **Generar una nueva orden de venta**: Solo para administradores y superadministradores. - **Ver detalles de una orden**: Permite acceder a información detallada. - **Descargar resumen en PDF**: Genera un documento con un resumen. - **Descargar reporte en Excel**: Genera un reporte detallado. - **Eliminar órdenes de venta**: Permitido solo para superadministradores. 3. **Interactividad**: - Tabla con soporte para desplazamiento horizontal y búsquedas rápidas. - Confirmación para acciones críticas como eliminar. ### Ventajas - Presentación clara y ordenada de las órdenes de venta. - Navegación sencilla mediante búsquedas y ordenación. - Acceso controlado según roles, asegurando seguridad y permisos. - Integración de descargas en múltiples formatos (PDF y Excel). # Órdenes de servicio ### Descripción La vista de **Órdenes de Servicio** permite gestionar las órdenes relacionadas con servicios realizados por la organización. Incluye detalles financieros y proporciona acceso a acciones clave para administración y supervisión. ### Características 1. **Visualización de datos clave**: - Código de referencia de la orden. - Organización asociada. - Fecha de la orden. - Total financiero. 2. **Acciones disponibles según permisos y roles**: - **Crear una nueva orden de servicio**: Accesible para administradores y superadministradores. - **Ver detalles de la orden**: Permite una revisión más detallada. - **Descargar en PDF**: Genera un documento descargable de la orden. - **Editar una orden existente**: Modificar datos o corregir errores. - **Eliminar órdenes de servicio**: Permitido para administradores y superadministradores. 3. **Interactividad**: - Tabla con soporte para desplazamiento horizontal y búsquedas rápidas. - Confirmación visual para acciones destructivas como eliminar. ### Ventajas - Gestión eficiente de órdenes de servicio con información consolidada. - Acciones rápidas desde una interfaz intuitiva. - Descargas en formatos amigables para su distribución o análisis. - Respaldo de seguridad mediante roles y permisos bien definidos. # Intercambio con ERP Las órdenes de grabados y de servicios incorporan información de sincronización con Dolibarr. ## En los listados Los listados pueden mostrar una columna **Estado Dolibarr** para identificar rápidamente la situación de cada documento en el ERP. ## En el detalle El detalle de la orden puede mostrar: - estado Dolibarr; - ID Dolibarr; - referencia remota; - última sincronización; - enlace a Dolibarr; - errores de sincronización; - acciones para enviar, reenviar, recrear o validar según corresponda. ## Acciones administrativas Las acciones de sincronización están reservadas a usuarios autorizados, principalmente **Admin** y **Super Admin**. La disponibilidad de cada acción depende del estado de la conexión ERP, la autorización de la organización y el estado remoto de la orden. # 05 — Interación con ERP # Configuración ERP — Dolibarr ## Descripción EtchManager permite conectar el sistema con Dolibarr para sincronizar notas de venta generadas desde las órdenes de grabados y de servicios. La configuración se administra desde: **Ajustes → Integración ERP (Dolibarr)** Esta sección está destinada a usuarios con rol **Admin** o **Super Admin**. ## Datos de conexión La configuración incluye: - **Habilitar integración Dolibarr**. - **Nombre de la conexión**. - **URL API**. - **API key**. - **Estado de verificación**. - **Organizaciones autorizadas**. ## API key La API key se guarda de forma cifrada. Después de guardar una conexión existente, la clave no vuelve a mostrarse. Si se deja el campo vacío al editar, EtchManager conserva la clave actual. ## Verificar la conexión Después de guardar los datos: 1. Presiona **Probar conexión**. 2. EtchManager consulta la instancia Dolibarr configurada. 3. Si la verificación es correcta, el estado cambia a **Verificada**. 4. Se muestra la empresa emisora identificada por Dolibarr. ## Organizaciones autorizadas La integración puede habilitarse de forma granular por organización cliente. Solo podrán sincronizarse las órdenes pertenecientes a organizaciones marcadas como autorizadas. Para que una orden pueda enviarse a Dolibarr deben cumplirse simultáneamente estas condiciones: 1. Existe una conexión Dolibarr configurada. 2. La conexión está habilitada. 3. La conexión está verificada. 4. La organización de la orden está autorizada. ## Seguridad de la configuración - La API key no se muestra nuevamente una vez guardada. - Cambiar la API key obliga a verificar nuevamente la conexión. - Las organizaciones no autorizadas quedan bloqueadas para sincronización. # Sincronización de órdenes con Dolibarr # Sincronización de órdenes con Dolibarr ## Órdenes compatibles La integración ERP puede utilizarse desde: - **Órdenes de grabados**. - **Órdenes de servicios**. En los listados se muestra un **Estado Dolibarr** independiente del estado propio de la orden en EtchManager. ## Estados Dolibarr Una orden puede mostrar alguno de los siguientes estados: - No sincronizada. - Borrador. - Validada. - Facturada. - Cerrada. - Anulada. - Eliminada. - Error. El estado remoto no reemplaza el estado local de la orden en EtchManager. ## Enviar una orden Desde el detalle de una orden, un usuario autorizado puede utilizar **Enviar a Dolibarr**. La orden se crea inicialmente en Dolibarr y EtchManager conserva la referencia remota. ## Validar una orden Una orden ya sincronizada puede validarse mediante **Validar en Dolibarr**. EtchManager solicita confirmación antes de realizar esta acción, ya que una orden validada en Dolibarr puede quedar sujeta a restricciones de edición. ## Abrir la orden en Dolibarr Cuando existe una referencia remota válida, EtchManager ofrece un acceso directo para abrir la orden correspondiente en Dolibarr. ## Orden eliminada en Dolibarr Si la orden vinculada deja de existir en Dolibarr, EtchManager la identifica como **Eliminada**. En ese caso puede utilizarse **Recrear en Dolibarr**. El nuevo ID y la nueva referencia remota reemplazan el vínculo anterior. ## Orden facturada Cuando Dolibarr informa que la orden ya fue facturada, EtchManager muestra el estado **Facturada** y evita operaciones incompatibles con ese estado. ## Requisitos para sincronizar La sincronización solo está disponible cuando la conexión ERP está habilitada y verificada, y la organización de la orden está autorizada en **Ajustes → Integración ERP (Dolibarr)**. # 06 — Gestión de Insumos # Productos ## **Descripción General** El módulo de productos permite gestionar los suministros utilizados en los procesos operativos, ofreciendo herramientas para listar, crear y editar productos. Cada vista está diseñada para simplificar la administración y garantizar datos consistentes. ## Cómo usar el módulo ## Consultar productos - **Descripción**: Muestra un listado de todos los productos registrados en el sistema. - **Características**: - **Tabla dinámica**: - Columnas clave: - Nombre. - Durabilidad. - Estado (Activo/Inactivo). - Acciones (Editar, Eliminar). - Funciones de búsqueda y ordenamiento mediante tablas interactivas. - **Acciones disponibles**: - Crear nuevos productos. - Editar productos existentes. - Eliminar productos. - **Exportación**: - Permite exportar los datos de la tabla a Excel, si el usuario tiene permisos. - **Uso principal**: - Proporcionar una vista centralizada para gestionar y visualizar los productos disponibles. ## Crear un producto - **Descripción**: Permite registrar un nuevo producto en el sistema. - **Características**: - Formulario con los siguientes campos: - Nombre del producto. - Durabilidad (cantidad de usos o grabados). - Estado (Activo/Inactivo). - Validaciones dinámicas para garantizar que los datos ingresados sean correctos. - Botón para guardar el producto y redirigir al listado. - **Uso principal**: - Facilitar la creación de nuevos productos. ## Editar un producto - **Descripción**: Diseñada para modificar la información de un producto existente. - **Características**: - Formulario pre-llenado con los valores actuales del producto. - Campos disponibles para edición: - Nombre del producto. - Durabilidad. - Estado (Activo/Inactivo). - Validaciones dinámicas para evitar errores o duplicados. - Botones para guardar los cambios o cancelar la operación. - **Uso principal**: - Permitir ajustes y actualizaciones en los productos registrados. ## Flujo de trabajo 1. **Consultar el listado**: Muestra un listado general de los productos, con opciones para gestionarlos. 2. **Crear un registro**: Permite agregar nuevos productos al sistema. 3. **Editar un registro**: Facilita la edición y actualización de productos existentes. ## Funciones disponibles - **Tablas Dinámicas**: - Búsqueda, filtrado y exportación en la vista de listado . - **Validaciones**: - Formularios protegidos con validaciones dinámicas para garantizar la calidad de los datos ingresados. - **Interacción Visual**: - Mensajes de confirmación para acciones como eliminación o guardado. - **Diseño Responsivo**: - Todas las vistas están optimizadas para dispositivos móviles y escritorio. - **Seguridad**: - Control de permisos para acciones como creación, edición y eliminación de productos. # Servicios ### **Documentación del Flujo de Servicios** ### **Introducción** El módulo de **Servicios** permite gestionar los servicios ofrecidos, asignar precios base, y definir precios específicos para organizaciones. Este sistema proporciona una forma centralizada de administrar servicios y personalizar los costos según las necesidades de los clientes. ### **Flujo de Gestión de Servicios** #### **1. Creación de un Nuevo Servicio** Cuando se crea un nuevo servicio, el usuario debe proporcionar la información básica del mismo: - **Nombre del Servicio:** Descripción breve que identifica el servicio. - **Precio Base:** Valor predeterminado del servicio, que se utiliza como referencia o precio por defecto. Adicionalmente, el usuario puede asignar precios específicos a diferentes organizaciones: - Seleccionar una organización del listado disponible. - Asignar un precio personalizado para esa organización. - Repetir este proceso para tantas organizaciones como sea necesario. El sistema guarda el servicio con su precio base y las configuraciones específicas para cada organización. #### **2. Edición de un Servicio Existente** El usuario puede editar un servicio para: - Modificar su nombre. - Cambiar el precio base. - Actualizar, añadir o eliminar precios específicos para organizaciones. En esta etapa, el sistema precarga la información existente: - **Precios personalizados:** Se muestran los precios específicos ya asignados a las organizaciones. - **Organizaciones disponibles:** Se listan solo las organizaciones que no tienen un precio personalizado asignado. El usuario puede: 1. Editar los precios de las organizaciones existentes. 2. Agregar nuevas organizaciones y asignarles precios. 3. Eliminar organizaciones asociadas previamente. #### **3. Listado de Servicios** En la vista de listado, los usuarios pueden ver todos los servicios registrados en el sistema junto con: - Nombre del servicio. - Precio base. - Acciones disponibles: editar o eliminar. ### **Roles y Responsabilidades** - **Administrador del Sistema:** Gestiona todos los servicios y precios organizacionales. - **Usuarios Clientes:** Visualizan los servicios disponibles y los precios asociados. ### **Escenarios de Uso** #### **Escenario 1: Creación de un Servicio Genérico** 1. El administrador crea un nuevo servicio. 2. Define un precio base que se aplicará por defecto. 3. No se asignan precios específicos para ninguna organización. #### **Escenario 2: Personalización de Precios por Organización** 1. El administrador crea un nuevo servicio con un precio base. 2. Añade precios específicos para ciertas organizaciones: - Selecciona las organizaciones relevantes. - Asigna precios personalizados. #### **Escenario 3: Modificación de un Servicio Existente** 1. El administrador busca un servicio existente en el listado. 2. Accede a la opción de edición. 3. Modifica el nombre, precio base o precios personalizados. #### **Escenario 4: Eliminación de Precios Específicos** 1. El administrador accede al servicio que desea modificar. 2. Identifica una organización que ya no necesita un precio personalizado. 3. Elimina la asociación del precio para esa organización. ### **Reglas del Sistema** 1. **Precio Base Obligatorio:** Cada servicio debe tener un precio base definido. 2. **Organizaciones Únicas:** Una organización no puede tener múltiples precios personalizados para el mismo servicio. 3. **Precios Personalizados Opcionales:** No es obligatorio asignar precios personalizados a las organizaciones; el precio base se aplica automáticamente en su lugar. 4. **Actualización Dinámica:** La lista de organizaciones disponibles para agregar precios personalizados se actualiza automáticamente para evitar duplicaciones. ### **Beneficios del Sistema** - **Flexibilidad:** Permite ajustar precios para organizaciones específicas sin afectar el precio base. - **Centralización:** Gestión unificada de servicios y precios. - **Eficiencia:** Listados claros y procesos automatizados para evitar errores humanos. - **Escalabilidad:** Soporte para múltiples servicios y organizaciones. ### **Preguntas Frecuentes (FAQ)** #### **¿Es obligatorio definir precios personalizados para las organizaciones?** No, si no se asigna un precio personalizado, el sistema aplicará automáticamente el precio base. #### **¿Qué ocurre si se elimina un servicio?** Todos los precios personalizados asociados a ese servicio también serán eliminados. #### **¿Puedo asignar diferentes precios a una misma organización para distintos servicios?** Sí, los precios personalizados se gestionan de manera independiente para cada servicio. ### **Conclusión** El módulo de **Servicios** simplifica la gestión de servicios y precios, permitiendo una personalización detallada sin perder la coherencia central. Este flujo flexible y eficiente está diseñado para adaptarse a diversas necesidades organizacionales. # Configuración de abastecimiento por sucursal ## Descripción EtchManager permite definir cómo administra cada sucursal su stock y su consumo de insumos. La configuración está disponible para usuarios con rol **Admin** o **Super Admin** desde: **Insumos → Configuración** ## Organización cliente Primero selecciona la organización cliente que deseas configurar. El sistema muestra sus sucursales y el comportamiento asignado a cada una. ## Modos disponibles ### Independiente La sucursal mantiene su propio stock, reposiciones y consumo. En este modo no necesita una sucursal de reposición asociada. ### Consolidada La sucursal utiliza el stock de otra sucursal de la misma organización, definida como **Sucursal de reposición (ancla)**. Esto permite centralizar el abastecimiento de varias sucursales mientras el consumo continúa considerando la actividad de las sucursales asociadas. ## Configurar una sucursal 1. Ingresa a **Insumos → Configuración**. 2. Selecciona la organización cliente. 3. En la fila de la sucursal, selecciona **Independiente** o **Consolidada**. 4. Si seleccionas **Consolidada**, indica la **Sucursal de reposición (ancla)**. 5. Presiona **Guardar configuración**. ## Efecto sobre otros módulos Esta configuración afecta la forma en que EtchManager resuelve el stock y el consumo utilizado por: - Reposiciones. - Inventarios. - Movimientos. - Consumos. - Proyecciones de reposición. Cuando una sucursal está consolidada, las operaciones de stock se realizan sobre la sucursal ancla configurada. ## Consideraciones - La sucursal ancla debe pertenecer a la misma organización. - Una sucursal independiente trabaja sobre su propio stock. - Si una sucursal consolidada no tiene una sucursal ancla válida, la configuración no puede guardarse. # Inventario por sucursal ## **Descripción** La funcionalidad de **Inventario en Sucursales** permite a los usuarios visualizar el stock de los insumos para grabados en distintas organizaciones y sucursales para getsionar si fuere necesario. Este módulo cuenta con un sistema de filtrado dinámico que actualiza las opciones disponibles en función de la organización seleccionada, proporcionando una experiencia intuitiva y eficiente. ## **Características Principales** 1. **Filtrado por Organización y Sucursal** - Los usuarios pueden seleccionar una **organización** y, con base en esa selección, el sistema muestra las **sucursales** asociadas. - Este filtrado dinámico asegura que los usuarios trabajen únicamente con la información relevante. 2. **Visualización de Datos Clave** La tabla muestra información detallada sobre el inventario, incluyendo: - Producto. - Organización. - Sucursal. - Stock después de la última reposición. - Stock calculado, teniendo en cuenta el consumo de grabados. - Cantidad de grabados realizados en el mes actual. - Cantidad de grabados realizados desde la última reposición. 3. **Interactividad y Actualización Dinámica** - Cuando se selecciona una nueva organización, las sucursales disponibles se actualizan automáticamente sin necesidad de recargar la página. - Esto mejora la eficiencia al momento de aplicar filtros y explorar los datos. 4. **Fácil Navegación** - Los filtros son accesibles en la parte superior de la vista. - El diseño es claro y responsivo, adaptándose a diferentes dispositivos. ## **Ventajas** ### **1. Ahorro de Tiempo** - Los usuarios no necesitan buscar manualmente las sucursales disponibles para cada organización; el sistema lo hace por ellos automáticamente. ### **2. Datos Precisos y Actualizados** - El stock calculado incluye las métricas más recientes sobre consumo y grabados, asegurando una planificación basada en información confiable. ### **3. Experiencia Intuitiva** - La funcionalidad de filtrado es directa y fácil de usar, incluso para usuarios sin experiencia técnica. - El diseño dinámico asegura que siempre se muestren las opciones correctas, evitando errores. ### **4. Flexibilidad** - El sistema permite trabajar con múltiples organizaciones y sucursales, adaptándose a las necesidades de diferentes roles y niveles de responsabilidad. ### **5. Análisis y Toma de Decisiones** - Los datos sobre grabados y consumo permiten a los usuarios identificar patrones y prever necesidades de reposición. - Esto facilita la gestión de recursos y evita desabastecimientos. ## **Cómo Usarlo** 1. **Acceder al Módulo** Navega al módulo de **Inventario en Sucursales** desde el menú principal. 2. **Seleccionar Filtros** - En el formulario de filtros, selecciona una **organización** del menú desplegable. - Una vez seleccionada la organización, el sistema actualizará automáticamente las opciones disponibles en el campo de **sucursal**. 3. **Aplicar Filtros** - Selecciona una sucursal y haz clic en el botón **"Aplicar Filtros"** para cargar los datos del inventario. 4. **Revisar los Resultados** - Consulta la tabla con la información del inventario filtrado. - Analiza los datos de stock, grabados y consumo para planificar acciones. ## **Escenarios de Uso** - **Supervisión del Stock** Los supervisores pueden verificar rápidamente el estado del inventario en diferentes sucursales y planificar reposiciones según el consumo. - **Análisis de Consumo** Los responsables de la gestión de recursos pueden identificar tendencias de consumo y ajustar la distribución de productos en función de las necesidades reales. - **Toma de Decisiones Informada** Los gerentes pueden acceder a una visión consolidada del inventario para priorizar la asignación de recursos y evitar interrupciones en las operaciones. ## **Notas Importantes** - **Filtros Obligatorios:** Es necesario seleccionar al menos una **organización** para habilitar el campo de **sucursal**. - **Datos Responsivos:** La tabla de inventario se ajusta automáticamente al tamaño de la pantalla, garantizando una experiencia óptima en dispositivos móviles, tablets y escritorios. - **Acceso por Roles:** Solo los usuarios con los permisos adecuados podrán acceder a esta funcionalidad y los datos estarán restringidos según su rol. # Movimientos de inventario ## **Descripción General** El módulo de movimientos permite gestionar y registrar los movimientos de inventario, como entradas y salidas de productos, en función de las organizaciones y sucursales. Incluye funcionalidades avanzadas para filtrar, listar y registrar movimientos de manera eficiente. ## Cómo usar el módulo ## Consultar movimientos - **Descripción**: Muestra un listado general de todos los movimientos registrados en el sistema. - **Características**: - **Filtros avanzados**: - Organización. - Sucursal. - Rango de fechas. - **Tabla dinámica**: - Columnas clave: - Organización. - Sucursal. - Fecha del movimiento. - Producto. - Cantidad restante. - Cantidad repuesta. - Stock total. - Funcionalidades de búsqueda, ordenamiento y agrupación. - **Exportación**: - Permite exportar los datos filtrados a Excel mediante un botón interactivo. - **Uso principal**: - Gestionar y supervisar los movimientos de inventario, aplicando filtros para analizar los datos relevantes. ## Registrar un movimiento - **Descripción**: Permite registrar un nuevo movimiento de inventario en el sistema. - **Características**: - Formulario que incluye los siguientes campos: - Tipo de movimiento (entrada/salida). - Producto asociado. - Cantidad. - Organización o sucursal, según el tipo de movimiento. - Fecha del movimiento. - Notas adicionales. - **Interacción dinámica**: - El formulario cambia según el tipo de movimiento seleccionado: - **Entrada**: Solicita un proveedor. - **Salida**: Solicita una sucursal. - Validaciones dinámicas para garantizar la calidad de los datos ingresados. - Botón para guardar el movimiento y redirigir al listado principal. - **Uso principal**: - Registrar entradas o salidas de productos, manteniendo actualizado el inventario. ## Flujo de trabajo 1. **Consultar el listado**: - Muestra un listado general de los movimientos registrados, con filtros y opciones para exportar. 2. **Crear un registro**: - Permite registrar nuevos movimientos de inventario con los datos necesarios. ## Funciones disponibles - **Tablas Dinámicas**: - Búsqueda, agrupación y ordenamiento en el listado . - **Interacción Dinámica**: - El formulario adapta su comportamiento según el tipo de movimiento (entrada o salida). - **Exportación de Datos**: - Los movimientos listados pueden exportarse a Excel para facilitar su análisis o documentación. - **Validaciones y Seguridad**: - Formularios protegidos con validaciones dinámicas para garantizar la consistencia de los datos. - **Diseño Responsivo**: - Todas las vistas están optimizadas para dispositivos móviles y escritorio. # Reposiciones ## **Descripción General** El módulo de reposiciones permite gestionar y supervisar la reposición de productos asociados a organizaciones y sucursales. Proporciona herramientas para listar, crear, editar y consultar detalles de reposiciones, garantizando un control eficiente de los recursos. ## Cómo usar el módulo ## Consultar reposiciones - **Descripción**: Muestra un listado de todas las reposiciones registradas en el sistema. - **Características**: - **Tabla dinámica**: - Columnas clave: Organización, Sucursal, Productos, Fecha de reposición, Acciones. - Funcionalidades de búsqueda y ordenamiento mediante tablas interactivas. - **Filtros avanzados**: - Organización, sucursal y rango de fechas. - **Acciones disponibles**: - Crear nuevas reposiciones. - Editar reposiciones existentes. - Consultar detalles de una reposición. - Eliminar registros (si el usuario tiene permisos). - **Uso principal**: - Ofrecer una vista centralizada para gestionar y supervisar todas las reposiciones. ## Registrar una reposición - **Descripción**: Permite registrar una nueva reposición asociada a una organización y sucursal específicas. - **Características**: - Formulario con los siguientes campos: - Fecha de reposición. - Organización y sucursal. - Productos con cantidades a reponer. - Notas opcionales. - Validaciones dinámicas para garantizar la integridad de los datos ingresados. - Botón para guardar la reposición y redirigir al listado. - **Uso principal**: - Registrar nuevas reposiciones de productos en el sistema. ## Editar una reposición - **Descripción**: Diseñada para modificar la información de una reposición existente. - **Características**: - Formulario pre-llenado con los datos actuales de la reposición. - Campos disponibles para edición: - Fecha de reposición. - Organización y sucursal. - Productos (cantidades restantes y repuestas). - Notas. - Validaciones dinámicas para evitar errores o duplicados. - Botón para guardar los cambios y redirigir al listado. - **Uso principal**: - Actualizar y ajustar los datos de reposiciones registradas. ## Consultar detalles - **Descripción**: Muestra los detalles de una reposición específica, proporcionando una visión completa de los productos y cantidades involucradas. - **Características**: - Información clave: - Fecha de reposición. - Organización y sucursal asociadas. - Productos con cantidades restantes y repuestas. - Notas adicionales. - Indicador visual para mostrar si la reposición ha sido aceptada. - Botón para regresar al listado principal. - **Uso principal**: - Consultar detalles específicos de las reposiciones registradas. ## Flujo de trabajo 1. **Consultar el listado**: Muestra un listado general de reposiciones con opciones para filtrarlas y gestionarlas. 2. **Crear un registro**: Facilita la creación de nuevas reposiciones con los datos necesarios. 3. **Editar un registro**: Permite actualizar y ajustar reposiciones existentes. 4. **Consultar detalles**: Proporciona una visión detallada de una reposición específica. ## Funciones disponibles - **Tablas Dinámicas**: - Búsqueda, filtrado y ordenamiento en la vista de listado . - **Validaciones**: - Formularios protegidos con validaciones dinámicas para garantizar la calidad de los datos ingresados. - **Interacción Visual**: - Uso de notificaciones (mensajes de confirmación) para confirmar acciones como eliminación o guardado. - **Diseño Responsivo**: - Todas las vistas están optimizadas para dispositivos móviles y escritorio. - **Exportación y Reportes**: - Permite descargar datos en formatos como Excel desde el listado principal. # Consumos y proyecciones # **Módulo de Consumos y Proyecciones** ## **Descripción General** El módulo de consumos está diseñado para analizar y proyectar el consumo de productos en sucursales, permitiendo identificar necesidades de reposición y optimizar la logística de suministros. Incluye vistas dinámicas que presentan consumos actuales, proyecciones futuras, y alertas visuales para facilitar la toma de decisiones. ## **Lógica y Cálculos** El sistema utiliza datos históricos y proyecciones para calcular las métricas clave del reporte. A continuación, se detallan las fórmulas y la lógica aplicada: ### **1. Stock Actual** - **Definición:** El stock registrado después de la última reposición en el inventario de la sucursal. - **Origen de los datos:** Directamente de la última reposición registrada. ### **2. Grabados del Mes** - **Definición:** Total de grabados realizados en la sucursal durante el mes actual. ### 3. Grabados Desde Última Reposición Definición: Total de grabados realizados desde la última reposición del producto. ### **4. Proyección de Grabados** - **Definición:** Estimación del total de grabados que se realizarán en el mes actual considerando tendencias históricas y días restantes. - **Lógica:** 1. Obtener grabados del mes anterior (`etchings_last_month`). 2. Calcular la variación respecto del mes anterior. 3. Utilizar esa tendencia junto con los días restantes del mes para estimar el total esperado. ### **5. Consumo Estimado** - **Definición:** Cantidad de unidades de un producto necesarias para cubrir los grabados realizados. - **Cálculo:** divide la cantidad de grabados considerados por la durabilidad configurada del producto. Donde: - `grabados_totales`: Puede ser de los últimos 7, 15 días, o del mes. - `durabilidad_producto`: Número de grabados que una unidad del producto soporta. ### **6. Días Cubiertos** - **Definición:** Días que el stock actual puede cubrir basado en el consumo estimado. - **Cálculo:** relaciona el stock disponible con el consumo estimado para obtener una cobertura aproximada en días. ### **7. Cantidad a Reponer** - **Definición:** Cantidad sugerida para reponer, considerando el consumo estimado y las proyecciones de grabados. - **Cálculo:** sugiere reponer solo cuando el consumo esperado supera el stock disponible; nunca propone valores negativos. ## **Campos Mostrados en el Reporte** El reporte presenta la siguiente información por cada sucursal y producto: ### **1. Organización** Nombre de la empresa a la que pertenece la sucursal. ### **2. Sucursal** Nombre de la sucursal donde se realiza el consumo del producto. ### **3. Producto** Nombre del producto monitoreado. ### **4. Stock Actual** Cantidad actual disponible en la sucursal después de la última reposición. ### **5. Grabados Mes** Número total de grabados realizados durante el mes actual en la sucursal. ### **6. Grabados Desde Última Reposición** Número de grabados realizados desde la última reposición del producto. ### **7. Proyección de Grabados** Número estimado de grabados que se realizarán hasta el fin de mes. ### **8. Consumo Estimado** Cantidad estimada de unidades necesarias para cubrir los grabados. ### **9. Días Cubiertos** Número de días que el stock actual puede cubrir, clasificado visualmente: - **Rojo:** Crítico (0-3 días). - **Amarillo:** Alerta (4-7 días). - **Verde:** Óptimo (>7 días). ### **10. Cantidad a Reponer** Cantidad sugerida para reponer, calculada para evitar desabastecimiento. ## **Alertas Visuales** Se utilizan colores en el reporte para identificar rápidamente los estados críticos: - **Rojo:** Días cubiertos <= 3. - **Amarillo:** Días cubiertos entre 4 y 7. - **Verde:** Días cubiertos > 7. ## **Cómo Usar el Reporte** 1. **Revisar métricas clave:** Analice las columnas "Días Cubiertos" y "Cantidad a Reponer". 2. **Planificar reposiciones:** Use la columna "Cantidad a Reponer" para priorizar las sucursales con estado crítico. 3. **Analizar proyecciones:** La "Proyección de Grabados" ayuda a anticipar cambios en la demanda. ## **Notas Adicionales** - Los cálculos son estimaciones basadas en datos históricos y deben ajustarse en tiempo real según las condiciones actuales. - Las alertas visuales ayudan a priorizar acciones, pero las decisiones finales deben considerar otros factores logísticos. ## **Ejemplo Práctico de Cálculo** #### **Producto: Crema Grabado** - **Durabilidad del producto:** 30 grabados por unidad. - **Grabados del mes actual:** 65 grabados. - **Grabados desde la última reposición:** 45 grabados. - **Stock actual:** 18 unidades. **Cálculos Detallados:** 1. **Consumo mensual estimado:** - Fórmula: `consumo_estimado = grabados_totales / durabilidad_producto` - Sustituyendo valores: `consumo_estimado = 65 / 30 = 2.17 ≈ 3 unidades` - **Interpretación:** Se estima que se consumirán 3 unidades de crema para realizar los 65 grabados de este mes. 2. **Días cubiertos:** - Fórmula: `dias_cubiertos = stock_actual / consumo_estimado` - Sustituyendo valores: `dias_cubiertos = 18 / 3 = 6 días` - **Interpretación:** El stock actual puede cubrir 6 días de operaciones, suponiendo un consumo constante. 3. **Proyección de grabados hasta fin de mes:** - **Días restantes del mes:** 10 días. - **Historial del mes anterior:** Supongamos que el mes anterior hubo 80 grabados. - **Tasa de crecimiento:** `tasa_crecimiento = (grabados_actuales - grabados_mes_anterior) / grabados_mes_anterior tasa_crecimiento = (65 - 80) / 80 = -0.1875 ≈ -18.75%` - **Proyección para los días restantes:** `proyeccion = grabados_actuales * (1 + tasa_crecimiento) proyeccion = 65 * (1 - 0.1875) ≈ 53 grabados` - **Interpretación:** Se proyecta que se realizarán aproximadamente 53 grabados en los próximos días del mes. 4. **Cantidad a reponer:** - Fórmula: `cantidad_a_reponer = max(0, consumo_estimado - stock_actual)` - Sustituyendo valores: `cantidad_a_reponer = max(0, 3 - 18) = 0 unidades` - **Interpretación:** Actualmente no se necesita reposición, pero se deben considerar las proyecciones para evitar desabastecimiento. ### **Resumen del Ejemplo** - **Producto:** Crema Grabado. - **Durabilidad:** 30 grabados por unidad. - **Grabados del mes:** 65 grabados. - **Stock actual:** 18 unidades. - **Consumo mensual estimado:** 3 unidades. - **Días cubiertos:** 6 días. - **Proyección de grabados (días restantes):** 53 grabados. - **Cantidad a reponer:** 0 unidades (pero con monitoreo constante). Este ejemplo demuestra cómo se integran las diferentes variables para obtener un análisis completo y tomar decisiones informadas. ## **Cómo Leer los Gráficos?** Los gráficos en este módulo están diseñados para ofrecer una visión clara y detallada del consumo y la reposición de insumos por sucursal y producto. A continuación, se describe cada gráfico y cómo interpretarlo. ### **1. Gráfico de Barras Apiladas: Consumo vs Stock** **Objetivo**: Comparar el consumo proyectado de insumos con el stock actual en cada sucursal. - **Ejes**: - **Eje X**: Lista de sucursales. - **Eje Y**: Cantidad en unidades (stock y consumo proyectado). - **Barras**: - **Parte Inferior (Stock Actual)**: Representa el inventario actual disponible en cada sucursal para un producto específico. - **Parte Superior (Consumo Proyectado)**: Representa la cantidad estimada que se consumirá en base a la proyección de grabados. - **Cómo Leerlo**: - Si el **Stock Actual** es menor que el **Consumo Proyectado**, es probable que sea necesario reponer insumos en esa sucursal. - Una barra más alta indica un mayor nivel de actividad (ya sea en stock o consumo). **Ejemplo**: - Sucursal "Movicenter": - Stock Actual: 50 unidades. - Consumo Proyectado: 70 unidades. - Resultado: Se necesitarían 20 unidades adicionales para cubrir la proyección. ### **2. Gráfico de Líneas: Proyección de Grabados** **Objetivo**: Visualizar la tendencia de grabados reales hasta la fecha y la proyección futura. - **Ejes**: - **Eje X**: Días del mes. - **Eje Y**: Cantidad de grabados realizados. - **Líneas**: - **Línea Azul (Grabados Reales)**: Representa los grabados ya realizados en días pasados. - **Línea Roja (Proyección de Grabados)**: Predice el comportamiento de los grabados en días futuros, basado en tendencias históricas (como el mes anterior o semanas recientes). - **Cómo Leerlo**: - Si la proyección de grabados supera consistentemente los grabados reales, indica una tendencia de crecimiento. - La diferencia entre ambas líneas ayuda a evaluar la exactitud de las proyecciones y a planificar insumos con mayor precisión. **Ejemplo**: - Día 15 del mes: - Grabados reales: 60. - Proyección para fin de mes: 120. - Resultado: Es probable que se necesite ajustar el stock para cubrir los grabados proyectados restantes. ### **3. Gráfico de Torta: Distribución del Consumo por Producto** **Objetivo**: Mostrar la participación porcentual de cada producto en el consumo total. - **Segmentos**: - Cada segmento representa un producto. - El tamaño del segmento está basado en el impacto ajustado por durabilidad de ese producto en el consumo total. - **Cómo Leerlo**: - Los productos con segmentos más grandes tienen una mayor participación en el consumo total. - Un balance desequilibrado (un producto domina el gráfico) puede indicar la necesidad de revisar inventarios o estrategias de reposición. **Ejemplo**: - **Distribución**: - Rollo Papel: 50%. - Crema Grabado 50ml: 30%. - Líquido Espejos: 20%. - Resultado: El "Rollo Papel" tiene la mayor demanda y podría ser prioritario para reposición. ### **4. Gráfico de Barras: Días Cubiertos por Producto** **Objetivo**: Identificar cuántos días puede cubrir el stock actual para cada producto. - **Ejes**: - **Eje X**: Productos (Rollo Papel, Crema Grabado, etc.). - **Eje Y**: Días que el stock actual puede cubrir. - **Colores**: - **Verde**: Más de 7 días de cobertura (bajo riesgo). - **Amarillo**: Entre 3 y 7 días de cobertura (alerta). - **Rojo**: Menos de 3 días de cobertura (alto riesgo). - **Cómo Leerlo**: - Productos con barras rojas deben ser repuestos de forma prioritaria. - Productos con barras verdes indican que no hay urgencia de reposición inmediata. **Ejemplo**: - **Producto**: Rollo Papel. - Stock actual: 30 unidades. - Consumo diario proyectado: 5 unidades. - Días cubiertos: 6 días (barrar amarilla). - Resultado: Se debe planificar una reposición en breve para evitar desabastecimiento. ### **5. Gráfico de Radar: Comparativa entre Sucursales** **Objetivo**: Comparar varias métricas clave entre sucursales. - **Dimensiones**: - Stock Actual. - Consumo Proyectado. - Días Cubiertos. - **Líneas**: - Cada sucursal tiene una línea que conecta sus valores en las dimensiones. - **Cómo Leerlo**: - Sucursales con áreas más grandes en el radar están en mejor posición (más stock, más días cubiertos). - Sucursales con áreas más pequeñas podrían requerir atención prioritaria. **Ejemplo**: - Sucursal A tiene altos valores en stock y días cubiertos. - Sucursal B tiene bajos valores en todas las dimensiones. - Resultado: Priorizar la reposición en la Sucursal B. Estas explicaciones ayudan a interpretar las métricas clave y a tomar decisiones informadas basadas en los datos visualizados en los gráficos. # 07 — Datos Maestros # Marcas ## **Descripción General** El módulo de marcas gestionan la creación, edición, visualización y listado de marcas asociadas al sistema. Incluyen creación, edición y carga de logos. ## **Funcionalidades Principales** 1. **Gestión de Marcas**: - Crear nuevas marcas con su información básica y logo. - Editar detalles de marcas existentes. - Eliminar marcas de forma segura. 2. **Relaciones de Datos**: - Asociar marcas con sucursales y organizaciones. 3. **Interfaz Amigable**: - Tablas dinámicas con búsqueda y ordenamiento. - Formularios con validación de entradas y carga de archivos usando el cargador de archivos. ## Cómo usar el módulo ## Crear una marca Para registrar una nueva marca: - **Características**: - Campos: Nombre de la marca, logo, organización asociada y sucursales. - Carga de archivos (logo) mediante el cargador de archivos. - Validación dinámica de entradas. - **Ejemplo de Ruta**: # Organizaciones # Organizaciones ## **Descripción General** El módulo de organizaciones permiten gestionar entidades relacionadas con clientes, proveedores y sus datos asociados como sucursales, precios, y logos. ## **Campos Destacados** A continuación, se describen los campos clave utilizados en las vistas de organizaciones: 1. **RUT**: - **Descripción**: Identificador único de la organización (por ejemplo, número tributario). - **Validación**: Debe ser único y seguir el formato correcto. - **Ejemplo**: `12345678-9`. 2. **Nombre**: - **Descripción**: Nombre oficial de la organización. - **Validación**: Campo obligatorio con un máximo de 255 caracteres. - **Ejemplo**: `Corporación Ejemplo Ltda.` 3. **Rol**: - **Descripción**: Define si la organización es un cliente o proveedor. - **Opciones**: - `Cliente` - `Proveedor` - **Ejemplo**: `Cliente`. 4. **Precio por Grabado**: - **Descripción**: Costo asociado a un servicio de grabado. - **Validación**: Debe ser un número positivo. - **Ejemplo**: `1500` (CLP). 5. **Estado**: - **Descripción**: Indica si la organización está activa o inactiva. - **Opciones**: - `Activo` - `Inactivo` - **Ejemplo**: `Activo`. 6. **Logo**: - **Descripción**: Imagen representativa de la organización. - **Validación**: Opcional; se aceptan formatos `.jpeg`, `.jpg`, `.png` con un tamaño máximo de 5 MB. - **Ejemplo**: Archivo `logo.png`. 7. **Orden de Ventas (Consolidación)**: - **Descripción**: Define si las órdenes de venta se consolidan o se separan por tipo de servicio. - **Opciones**: - `Consolidada` - `Por tipo de Servicio` - **Ejemplo**: `Consolidada`. 8. **Sucursales**: - **Descripción**: Lista de sucursales asociadas a la organización. - **Validación**: Selección múltiple en el caso de clientes. - **Ejemplo**: `Sucursal Central`, `Sucursal Norte`. ## Cómo usar el módulo ## Crear una organización - **Descripción**: Vista para crear una nueva organización. - **Campos destacados**: - **RUT**, **Nombre**, **Rol**, **Precio por Grabado**, **Estado**, **Logo**, **Orden de Ventas**. - **Ejemplo de Ruta**: # Sucursales # Sucursales ### **Módulo de Sucursales** ## **Descripción General** El módulo de sucursales permite gestionar ubicaciones físicas o virtuales asociadas a organizaciones. Este módulo permite funcionalidades para la creación, edición, visualización y listado de sucursales. Se han diseñado con formularios intuitivos, tablas dinámicas y validaciones robustas para garantizar una experiencia de usuario optimizada. ## Consultar sucursales - **Descripción**: La vista principal para los usuarios que desean explorar o gestionar sucursales. Presenta un listado de todas las sucursales registradas en el sistema. - **Características**: - Muestra una tabla dinámica con columnas clave como: - Nombre de la sucursal. - Organización asociada. - Servicios ofrecidos. - Marcas relacionadas. - Colaboradores asignados. - Ofrece funcionalidades de búsqueda y ordenamiento mediante tablas interactivas (tablas interactivas). - Proporciona accesos rápidos para: - Crear nuevas sucursales. - Editar sucursales existentes. - Eliminar registros. - Diseñada para ser el punto de inicio del flujo de trabajo con sucursales. ## Crear una sucursal - **Descripción**: Permite a los usuarios registrar una nueva sucursal en el sistema, asociándola con una organización y configurando las relaciones necesarias. - **Características**: - Presenta un formulario con los siguientes campos: - Nombre de la sucursal. - Organización a la que pertenece (selección de una lista de organizaciones existentes). - Servicios ofrecidos (selección múltiple). - Marcas asociadas (selección múltiple). - Colaboradores asignados (selección múltiple). - Valida dinámicamente las entradas del usuario, asegurando que los datos sean correctos antes de enviarse. - Diseñada para ser simple e intuitiva, facilitando la creación de registros. ## Editar una sucursal - **Descripción**: Esta vista permite modificar la información de una sucursal existente. Es ideal para actualizar datos, corregir errores o agregar nuevas relaciones. - **Características**: - Los campos del formulario están pre-llenados con la información actual de la sucursal. - Permite modificar: - Nombre. - Organización asociada. - Servicios ofrecidos. - Marcas relacionadas. - Colaboradores asignados. - Incluye opciones para eliminar relaciones existentes o agregar nuevas. - Valida las entradas para garantizar que los cambios sean consistentes y válidos. ## Consultar detalles - **Descripción**: Diseñada para mostrar detalles específicos de una sucursal. Ofrece una visión completa de su información y relaciones asociadas. - **Características**: - Presenta información básica como: - Nombre de la sucursal. - Organización a la que pertenece. - Lista de servicios ofrecidos. - Marcas relacionadas. - Colaboradores asignados. - Ideal para consultas rápidas sobre la configuración y detalles de una sucursal específica. ## Flujo de trabajo 1. **Consultar el listado**: El usuario comienza en el listado de sucursales, explorando las existentes. 2. **Crear un registro**: Si necesita agregar una nueva sucursal, puede hacerlo desde el listado. 3. **Editar un registro**: Para corregir o actualizar datos, el usuario accede a la edición desde el listado. 4. **Consultar detalles**: Si desea ver más detalles sobre una sucursal, puede acceder a esta vista desde el listado. # Roles # Roles ## Propósito La vista permite gestionar roles y sus permisos asignados en la aplicación. ## Funcionalidades principales 1. `**Listado de roles**`: Tabla con los roles creados. 2. `**Crear un rol**` Botón para añadir nuevos roles. 3. `**Editar un rol**`: Modificar roles existentes. 4. `**Eliminar un rol**`: Borrar roles innecesarios. ## Permisos | Permiso | Descripción | |-----------------------|-----------------------------------------| | `dashboard.index` | Acceso al panel de control. | | `organizations.show` | Ver las organizaciones disponibles. | | `etchings.index` | Ver lista de grabados. | | `roles.create` | Crear nuevos roles. | | `users.assign` | Asignar usuarios a roles. | ## Ejemplo ### **Rol Usuario** - `dashboard.index` - `etchings.index` - `etchings.show` - `etchings.create` - `etchings.edit` ## Consideraciones - Los roles eliminados no se podrán recuperar. - Es importante asignar permisos correctos para evitar accesos no deseados. ## Roles ejecutivos Los **Roles Ejecutivos** están diseñados para proporcionar un control estructurado dentro de diferentes niveles organizacionales. Este documento detalla los permisos y responsabilidades asignados a cada rol ejecutivo: **Supervisor Group**, **Supervisor Organization** y **Supervisor Branch**. ## **Supervisor Group** El rol de **Supervisor Group** permite supervisar múltiples sucursales dentro de un grupo de organizaciones asignadas. ### Permisos principales: - `dashboard.index`: Acceso al panel de control. - `etchings.index`: Ver la lista de grabados asociados al grupo. - `etchings.show`: Ver detalles específicos de grabados. - `reports.index`: Consultar reportes grupales. - `reports.show`: Ver detalles de reportes grupales. - `apply`: Realizar solicitudes específicas dentro del grupo. - `members.edit`: Editar información de miembros del grupo. - `view.group`: Acceso consolidado a la información grupal. ### Responsabilidades: - Supervisar las operaciones de las sucursales dentro de su grupo. - Generar reportes y compartir métricas con niveles superiores. - Asegurar la correcta gestión de los grabados asignados al grupo. ## **Supervisor Organization** El rol de **Supervisor Organization** está diseñado para supervisar toda la organización y todas sus sucursales. ### Permisos principales: - `dashboard.index`: Acceso al panel de control. - `etchings.index`: Supervisar grabados a nivel organizacional. - `etchings.show`: Ver detalles de grabados dentro de la organización. - `reports.index`: Consultar reportes organizacionales. - `reports.show`: Ver reportes de operaciones. - `members.index`: Ver la lista completa de miembros de la organización. - `members.show`: Consultar detalles de los miembros de la organización. - `view.organization`: Acceso completo a la información organizacional. ### Responsabilidades: - Supervisar todas las operaciones de la organización. - Coordinar con supervisores de sucursales y grupos para optimizar las operaciones. - Asegurar que los grabados en proceso y tareas pendientes se gestionen eficientemente. ## **Supervisor Branch** El rol de **Supervisor Branch** se centra exclusivamente en supervisar y gestionar una única sucursal. ### Permisos principales: - `dashboard.index`: Acceso al panel de control. - `etchings.index`: Ver todos los grabados asociados a la sucursal. - `export.etchings`: Exportar grabados de la sucursal. - `reports.index`: Consultar reportes específicos de la sucursal. - `reports.show`: Ver detalles de reportes relacionados con la sucursal. - `members.show`: Consultar detalles de los miembros de la sucursal. - `view.branch`: Supervisar todas las operaciones relacionadas con la sucursal. ### Responsabilidades: - Gestionar grabados y operaciones específicas de una sucursal. - Supervisar las tareas y responsabilidades asignadas a los miembros de la sucursal. - Generar reportes de rendimiento y coordinar con niveles superiores. ## Comparación entre Roles Ejecutivos | Rol | Ámbito de supervisión | Permisos clave | Alcance principal | |-----------------------|------------------------|-------------------------------------|------------------------------------------| | **Supervisor Group** | Grupo de sucursales | `view.group`, `members.edit` | Supervisar varias sucursales del grupo. | | **Supervisor Organization** | Toda la organización | `view.organization`, `members.index` | Supervisión global de la organización. | | **Supervisor Branch** | Una sucursal | `view.branch`, `export.etchings` | Supervisión específica de una sucursal. | ## Consideraciones - **Limitación de permisos**: Los permisos están diseñados para que cada rol acceda solo al ámbito que supervisa. - **Escalabilidad**: Los permisos son lo suficientemente flexibles para adaptarse a cambios en responsabilidades. - **Independencia operativa**: Los roles ejecutivos tienen control suficiente para operar de forma autónoma en su ámbito, reduciendo la dependencia de niveles superiores. # Permisos # Permisos ### Módulo de Permisos #### **Descripción General** El módulo de permisos permite gestionar los accesos y las autorizaciones en el sistema. Los permisos están asociados a roles y definen qué acciones pueden realizar los usuarios. Este módulo incluye vistas para la creación, edición y listado de permisos, proporcionando una interfaz amigable y funciones avanzadas como validación de datos y manejo de errores. ## Consultar permisos - **Descripción**: Es la vista principal del módulo de permisos. Muestra una lista de todos los permisos registrados en el sistema. - **Características**: - **Tabla dinámica**: - Columnas principales: - ID. - Definición (nombre del permiso). - Descripción. - Funciones de búsqueda y ordenamiento mediante tablas interactivas. - **Acciones disponibles**: - Crear un nuevo permiso. - Editar permisos existentes. - Eliminar permisos. - **Diseño interactivo**: - Uso de mensajes de confirmación para confirmaciones de eliminación. - Notificaciones de éxito o error para operaciones realizadas. - **Uso principal**: Punto de inicio para la gestión de permisos. ## Crear un permiso - **Descripción**: Esta vista permite agregar un nuevo permiso al sistema. - **Características**: - Formulario sencillo con los siguientes campos: - **Definición**: Nombre único del permiso. - **Descripción**: Explicación breve del propósito del permiso. - Validaciones dinámicas para garantizar que el nombre del permiso sea único y los campos sean válidos. - Botón para guardar el nuevo permiso y redirigir al listado. ## Editar un permiso - **Descripción**: Diseñada para modificar los datos de un permiso existente. - **Características**: - Formulario pre-llenado con los valores actuales del permiso. - Campos disponibles para edición: - **Definición**: Nombre único del permiso. - **Descripción**: Descripción del propósito del permiso. - Validaciones para evitar duplicados y mantener la integridad de los datos. - Botón para guardar los cambios y redirigir al listado. ## Flujo de trabajo 1. **Consultar el listado**: - Inicio del módulo. Permite explorar, buscar y gestionar permisos. 2. **Crear un registro**: - Agrega un nuevo permiso desde el listado. 3. **Editar un registro**: - Modifica un permiso existente para mantener la información actualizada. ### Funciones disponibles - **Búsqueda y Filtrado**: - La tabla en la pantalla correspondiente incluye herramientas de búsqueda y ordenamiento para facilitar la localización de permisos. - **Validación y Seguridad**: - Los formularios en la pantalla correspondiente y la pantalla correspondiente garantizan que los datos ingresados sean únicos y válidos. - **Interacción Visual**: - Notificaciones y confirmaciones mediante mensajes de confirmación mejoran la experiencia del usuario. # Usuarios # Usuarios ## **Descripción General** El módulo de usuarios permite gestionar el acceso y las autorizaciones dentro del sistema. Proporciona herramientas para listar, crear y editar usuarios, así como para asignar roles, organizaciones y sucursales, garantizando un control granular sobre los permisos. ## Cómo usar el módulo ## Consultar usuarios - **Descripción**: Muestra un listado de todos los usuarios registrados en el sistema. - **Características**: - **Tabla dinámica**: - Columnas clave: Nombre, Email, Organización, Sucursal, Roles, Estado. - Funcionalidades de búsqueda y ordenamiento mediante tablas interactivas. - **Acciones disponibles**: - Crear nuevos usuarios. - Editar usuarios existentes. - Eliminar usuarios (si el usuario tiene permisos). - **Diseño responsivo**: - Optimizado para dispositivos móviles y escritorio. - **Uso principal**: - Gestionar y visualizar usuarios del sistema con sus roles y permisos asociados. ## Crear un usuario - **Descripción**: Permite registrar un nuevo usuario en el sistema. - **Características**: - Formulario con los siguientes campos: - Nombre. - Email. - Contraseña. - Organización (selección múltiple). - Sucursal (selección múltiple). - Roles (selección de uno o más roles). - Validaciones dinámicas para garantizar que los datos ingresados sean únicos y correctos. - Botón para guardar el usuario y redirigir al listado. - **Uso principal**: - Agregar nuevos usuarios al sistema y asignarles roles y permisos. ## Editar un usuario - **Descripción**: Diseñada para modificar la información de un usuario existente. - **Características**: - Formulario pre-llenado con los datos actuales del usuario. - Campos disponibles para edición: - Nombre. - Email. - Contraseña (opcional, deja la existente si está vacío). - Organización (selección múltiple). - Sucursal (selección múltiple). - Roles (roles actualmente asignados). - Validaciones dinámicas para garantizar la integridad de los datos actualizados. - Botón para guardar los cambios y redirigir al listado. - **Uso principal**: - Actualizar información y permisos de usuarios existentes. ## Flujo de trabajo 1. **Consultar el listado**: - Muestra un listado de usuarios y permite gestionarlos mediante acciones rápidas. 2. **Crear un registro**: - Facilita la creación de nuevos usuarios con sus roles y permisos asociados. 3. **Editar un registro**: - Permite modificar la información y los permisos de usuarios existentes. ## Funciones disponibles - **Tablas Dinámicas**: - El listado incluye búsqueda, filtrado y exportación. - **Roles y Permisos**: - Las pantallas de creación y edición incluyen un sistema de selección de roles y permisos basado en casillas de selección. - **Interacción Visual**: - Mensajes de confirmación para acciones como eliminación. - **Validaciones Dinámicas**: - Garantizan que el email sea único y que los datos ingresados sean válidos. - **Diseño Responsivo**: - Todas las vistas están adaptadas para dispositivos móviles y de escritorio. - **Seguridad**: - Control de acceso basado en roles para acciones como creación, edición y eliminación de usuarios. # Importaciones # Importaciones ## **Descripción General** El módulo de importaciones permiten subir archivos CSV/Excel para cargar datos de forma masiva en el sistema. Incluye un formulario para subir archivos, selección del tipo de información a importar y una tabla para visualizar los resultados. ## **Funcionalidades Principales** 1. **Cargar Archivos**: - Soporte para archivos `.csv` y `.xls`. - Validación de formato y contenido. 2. **Tipos de datos soportados**: - Permite importar datos para: - Sucursales - Marcas - Modelos de Marca - Permisos - Usuarios - Colaboradores - Inscripciones 3. **Visualización de Resultados**: - Muestra los datos importados en una tabla interactiva con búsqueda y paginación. ## Cómo usar el módulo ## Realizar una importación - Utiliza esta sección para cargar información masivamente. ### Pasos generales - Selección del modelo de datos a importar mediante opciones de radio. - Formulario para cargar archivos `.csv` o `.xls`. - Validación y retroalimentación del proceso de importación. - **Ejemplo de Ruta**: # 08 — Gestión de dispositivos # SIMs POS # SIMs POS ## Descripción El módulo **Maestros → SIMs POS** administra las tarjetas SIM utilizadas por los dispositivos. ## Buscar y filtrar Puedes buscar por: - MSISDN. - ICCID. - Operadora. También puedes filtrar por estado: - **Vigentes**. - **Inactivas**. ## Registrar una SIM Presiona **Nueva SIM** para crear un registro individual. ## Importación masiva La pantalla permite importar un archivo **CSV, TXT o XLSX**. Debes indicar: 1. La **operadora contratada**. 2. El archivo a importar. El archivo debe contener las columnas esperadas por EtchManager, entre ellas `PCS` y `SIMCARD`. ## Información del listado Se muestra: - ID. - MSISDN. - ICCID. - Operadora. - Estado. - Dispositivo al que está asignada. ## Acciones Según permisos, se puede: - Ver. - Editar. - Inactivar. - Reactivar. Al inactivar manualmente una SIM, EtchManager registra la baja correspondiente. # Dispositivos POS ## Descripción El módulo **Maestros → Dispositivos** permite administrar los POS utilizados por EtchManager. ## Filtros La pantalla permite filtrar por: - Organización. - Estado de asignación: **Asignado** o **No asignado**. - Dispositivos **sin versión reportada**. ## Información mostrada El listado incluye: - Número de serie. - IMEI. - Android ID. - SIM detectada. - SIM asignada. - Versión de la App. - Código de versión. - Fecha/hora en que se reportó la versión. - Estado operativo. - Sucursales y organizaciones vinculadas. - Cantidad de usuarios asociados. - Fecha del último movimiento. ## Acciones Según permisos, desde el listado se puede: - Crear un dispositivo con **Nuevo**. - Ver detalles. - Editar. - Consultar historial. - Cambiar estado operativo. - Eliminar. ## Estados operativos EtchManager contempla los siguientes estados: - `activo` - `inactivo` - `retirado` - `averiado` - `perdido` - `sustituido` Cuando el estado es distinto de `active`, debe indicarse un motivo. ## Uso recomendado El estado operativo permite distinguir un POS habilitado de equipos dados de baja, retirados, averiados, perdidos o reemplazados sin eliminar su historial. # Notificaciones POS # Notificaciones POS ## Descripción **Maestros → Notificaciones POS** permite enviar mensajes o instrucciones a uno o más dispositivos POS mediante Firebase Cloud Messaging. ## Selección de destinatarios El envío puede segmentarse por: - Organizaciones. - Usuarios. - Dispositivos. Cuando se selecciona una organización, puede limitarse además a sucursales específicas. ## Tipos de mensaje EtchManager contempla: - **Mensaje del sistema**. - **Prueba**. - **Sincronización forzada**. La sincronización forzada utiliza automáticamente la acción correspondiente en el POS. ## Vista previa obligatoria Antes de enviar una notificación debes generar una **vista previa**. La vista previa resuelve los dispositivos destinatarios, identifica cuáles son notificables y muestra los que serán omitidos. Si modificas los datos después de generar la vista previa, debes generar una nueva antes de enviar. ## Envío Una vez validada la vista previa, EtchManager pone las notificaciones en cola para su procesamiento. Si no existen POS notificables, el envío no puede realizarse. ## Cancelación Una notificación puede cancelarse solamente mientras siga en cola y aún no se haya procesado ningún envío exitoso o fallido. # Diferencias POS / Backend ## Descripción El módulo **Maestros → Diffs POS/Backend** ayuda a detectar diferencias entre los datos reportados por un POS y los datos almacenados en el backend. Muestra el último resultado disponible por combinación de dispositivo, sucursal y placa. ## Filtros Puedes filtrar por: - Serial del POS. - Placa. - Sucursal. - Flag de diferencia. - Origen. ## Comparación Para cada registro se muestran lado a lado datos del POS y del backend, entre ellos: - Estado. - Marca. - Número de orden. - Usuario. ## Flags Las diferencias detectadas se muestran mediante flags, lo que permite identificar rápidamente qué dato no coincide. ## Sugerencia Cuando está disponible, EtchManager presenta una **Sugerencia** para orientar la revisión o corrección. Este módulo está pensado como herramienta de diagnóstico y no como flujo operativo habitual. # Logs de dispositivos # Logs de dispositivos ## Descripción El módulo **Maestros → Logs de dispositivos** permite revisar archivos de diagnóstico enviados por los POS. Está orientado principalmente a soporte y diagnóstico. ## Filtros Puedes filtrar por: - Serial. - IMEI. - Nombre del archivo. ## Información mostrada Cada registro incluye: - ID. - Serial del dispositivo. - IMEI. - Nombre original. - Nombre almacenado. - Tamaño. - Fecha. ## Acciones Según permisos, puedes: - **Ver** el contenido del log directamente en la pantalla. - **Descargar** el archivo completo. - **Eliminar** el log y su archivo asociado. ## Visualización Al seleccionar **Ver**, el contenido se carga en la sección **Contenido del log** sin necesidad de descargar el archivo. # Herramientas de soporte POS # Herramientas de soporte POS EtchManager incluye varias herramientas administrativas para soporte de los dispositivos: - **Logs de dispositivos:** revisión y descarga de archivos de diagnóstico. - **Diffs POS/Backend:** comparación de información sincronizada entre el POS y el servidor. - **Notificaciones POS:** envío segmentado de mensajes, pruebas o solicitudes de sincronización. Estas funciones están separadas del flujo normal de grabados y normalmente requieren permisos administrativos. # 09 — Ajustes # Ajustes generales # Ajustes generales ## Acceso La sección **Ajustes** está disponible para usuarios autorizados, normalmente con rol **Admin** o **Super Admin**. Actualmente EtchManager organiza sus ajustes en cinco bloques: - Generales. - Etiquetas. - Grabados. - Firebase Cloud Messaging. - Integración ERP (Dolibarr). ## Generales Permite configurar elementos visuales de la plataforma. ### Texto del logo principal Define el texto mostrado junto al logo en la barra lateral. ### Logo del formulario de entrada Puede cargarse desde el dispositivo o seleccionarse entre archivos existentes en el servidor. ### Imagen de la barra lateral Permite definir el logo mostrado en el menú lateral. ### Fondo de la pantalla de entrada Permite seleccionar o cargar la imagen de fondo utilizada en la pantalla de acceso. Cada bloque muestra la imagen actualmente configurada cuando corresponde. ## Guardar cambios Presiona **Guardar Configuración General** para aplicar los cambios de esta sección. # Ajustes de EtchManager # Ajustes de EtchManager El menú **Ajustes** centraliza parámetros globales e integraciones de la plataforma. ## Secciones actuales - **Generales:** identidad visual de la plataforma y pantalla de entrada. - **Etiquetas:** uso del logo de marca en etiquetas. - **Grabados:** número de orden, VIN/Chasis y patente de motocicleta por alcance. - **Firebase Cloud Messaging:** credenciales y configuración para notificaciones POS. - **Integración ERP (Dolibarr):** conexión con el ERP y autorización de organizaciones. ## Alcances por organización o sucursal Algunas configuraciones pueden aplicarse globalmente o restringirse a organizaciones o sucursales específicas. Cuando se selecciona **Organización** o **Sucursal**, EtchManager habilita un selector para definir los objetivos. ## Diferencia con Insumos → Configuración No debe confundirse **Ajustes** con **Insumos → Configuración**: - **Ajustes** modifica parámetros globales o integraciones de EtchManager. - **Insumos → Configuración** define cómo cada sucursal administra stock, consumo y reposiciones. # Ajustes de etiquetas # Ajustes de etiquetas ## Descripción La sección **Etiquetas** controla elementos utilizados al imprimir etiquetas desde EtchManager. ## Usar logo de marca La opción **Usar Logo de Marca** permite definir dónde se utilizará el logo correspondiente a la marca. Los alcances disponibles son: - **No:** no se utiliza. - **Todos:** se aplica globalmente. - **Organización:** se aplica solo a las organizaciones seleccionadas. - **Sucursal:** se aplica solo a las sucursales seleccionadas. Cuando el alcance es **Organización** o **Sucursal**, EtchManager habilita el selector **Seleccionar objetivos**. ## Guardar Presiona **Guardar Configuración de Etiquetas**. # Firebase Cloud Messaging # Firebase Cloud Messaging ## Descripción EtchManager utiliza **Firebase Cloud Messaging (FCM)** para funciones de notificación hacia los dispositivos POS. Esta configuración es administrativa y debe ser modificada únicamente por personal responsable de la integración móvil. ## Project ID El campo **FCM Project ID** identifica el proyecto Firebase utilizado por EtchManager. ## Service Account EtchManager permite: - seleccionar una referencia de Service Account existente; - seleccionar un archivo JSON ya disponible en el servidor; - subir un nuevo archivo JSON de credenciales. La pantalla muestra tanto la referencia guardada como la ruta efectiva que está utilizando el sistema. ## Guardar Presiona **Guardar FCM** después de completar o modificar la configuración. ## Precaución Cambiar estas credenciales puede afectar la capacidad de EtchManager para enviar notificaciones a los POS. # Ajustes de grabados # Ajustes de grabados ## Descripción Esta sección permite habilitar determinados campos del flujo de grabados según el alcance deseado. Cada opción puede configurarse como: - **No:** deshabilitada. - **Todos:** habilitada para todos. - **Organización:** habilitada solo para organizaciones seleccionadas. - **Sucursal:** habilitada solo para sucursales seleccionadas. ## Número de orden **Usar Número de Orden** controla si el flujo de grabados solicita o utiliza este dato. ## VIN / Chasis **Usar VIN / Chasis** permite habilitar el registro del VIN o número de chasis. ## Patente de motocicleta **Usar Patente de Motocicleta** permite habilitar el tratamiento de patentes de motocicleta en los alcances definidos. ## Seleccionar objetivos Cuando una opción utiliza alcance por **Organización** o **Sucursal**, selecciona los objetivos correspondientes antes de guardar. ## Guardar Presiona **Guardar Configuración de Grabados**.