EtchManager

• 01 — Inicio y navegación
• Dashboard
• Menú y permisos
• 02 — Grabados
• Tareas
• Histórico de grabados
• 03 — Reportes
• Reportes
• 04 — Órdenes de Venta
• Órdenes de venta
• Órdenes de servicio
• Intercambio con ERP
• 05 — Interación con ERP
• Configuración ERP — Dolibarr
• Sincronización de órdenes con Dolibarr
• 06 — Gestión de Insumos
• Productos
• Servicios
• Configuración de abastecimiento por sucursal
• Inventario por sucursal
• Movimientos de inventario
• Reposiciones
• Consumos y proyecciones
• 07 — Datos Maestros
• Marcas
• Organizaciones
• Sucursales
• Roles
• Permisos
• Usuarios
• Importaciones
• 08 — Gestión de dispositivos
• SIMs POS
• Dispositivos POS
• Notificaciones POS
• Diferencias POS / Backend
• Logs de dispositivos
• Herramientas de soporte POS
• 09 — Ajustes
• Ajustes generales
• Ajustes de EtchManager
• Ajustes de etiquetas
• Firebase Cloud Messaging
• Ajustes de grabados

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.

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

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.