# EtchManager POS Manual de usuario y operación de la App Android EtchManager POS. # 01 — Introducción y acceso # ¿Qué es EtchManager POS? # ¿Qué es EtchManager POS? **EtchManager POS** es la aplicación Android utilizada por los operadores para registrar grabados, generar etiquetas, consultar trabajos y sincronizar la operación con la plataforma central EtchManager. ## Funciones principales - Registrar nuevos grabados. - Trabajar con una sucursal activa. - Consultar y editar grabados. - Imprimir y reimprimir etiquetas. - Consultar historial. - Generar reportes. - Trabajar temporalmente sin conexión. - Sincronizar con el backend al recuperar conectividad. ## Ciclo de puesta en marcha 1. **Instalación de la App.** 2. **Registro y autorización del dispositivo** con credenciales administrativas. 3. **Login del operador.** 4. **Selección de sucursal** cuando el usuario tiene más de una. 5. **Operación normal** de grabados, impresión y sincronización. # Registro y autorización inicial del POS # Registro y autorización inicial del POS La primera vez que se instala EtchManager POS, el dispositivo **todavía no está autorizado para operar**. Antes de que un usuario pueda iniciar sesión, debe completarse el registro inicial del equipo. ## Orden correcto del primer inicio 1. Instalar EtchManager POS en el dispositivo. 2. Abrir la App. 3. Completar la identificación técnica del POS. 4. Ingresar credenciales administrativas. 5. Validar el dispositivo contra EtchManager. 6. Guardar la configuración. 7. Una vez autorizado el POS, continuar al inicio de sesión normal del operador. ## Datos del dispositivo En el primer inicio, la App solicita o utiliza los siguientes datos: - **Base URL:** dirección del backend de EtchManager al que se conectará el POS. - **Número de serie:** identificador físico del dispositivo. - **IMEI:** identificador del equipo móvil. - **SIM:** información de la tarjeta SIM cuando corresponda. - **Android ID:** identificador generado por Android para el dispositivo. Base URL, Serial, IMEI y Android ID son necesarios para completar el registro. ## Credenciales administrativas El registro inicial **no utiliza las credenciales del operador**. Se debe ingresar un **RUT administrativo** y su **contraseña**. Estas credenciales permiten validar ante el backend que el equipo puede ser configurado como POS. ## Validación del dispositivo Al guardar la configuración, EtchManager POS envía al backend las credenciales administrativas junto con la identificación del dispositivo. El servidor valida tanto las credenciales como la autorización del equipo. ### Si la validación es correcta - La configuración del POS queda almacenada. - El dispositivo queda preparado para conectarse al backend. - La App continúa al flujo de inicio de sesión del usuario. ### Si la validación falla La App puede informar, según la causa: - Credenciales inválidas. - Dispositivo no autorizado. - Error del servidor. - Error de conexión. En estos casos no debe continuarse con la operación hasta corregir la configuración o autorizar el dispositivo desde EtchManager. ## Primer login del operador La autorización del POS y el inicio de sesión del usuario son procesos diferentes:
EtapaCredencialesObjetivo
Registro inicial del POSAdministradorAutorizar y configurar físicamente el dispositivo.
Inicio de sesión normalUsuario operadorIdentificar a la persona que realizará los grabados.
Una vez registrado correctamente el equipo, los siguientes usos normales de la App comienzan directamente en el login del usuario cuando no existe una sesión activa. # Inicio de sesión # Inicio de sesión El inicio de sesión identifica al **operador** que utilizará EtchManager POS. ## Requisito previo El POS debe haber sido previamente **registrado y autorizado**. En una instalación nueva, primero debe completarse el procedimiento descrito en **Registro y autorización inicial del POS**. ## Flujo de acceso 1. Abre EtchManager POS. 2. Ingresa las credenciales del usuario operador. 3. La App valida la sesión y carga la información autorizada para ese usuario. 4. Si el usuario dispone de más de una sucursal, selecciona la sucursal donde realizará la operación. 5. La App abre **Inicio**. ## POS compartido por varios usuarios Al cerrar sesión, EtchManager elimina la referencia al usuario activo, pero puede conservar el último RUT utilizado para facilitar el siguiente acceso. Esto no mantiene abierta la sesión anterior. ## No confundir con las credenciales administrativas Las credenciales administrativas utilizadas para registrar el POS son únicamente para la configuración/autorización del equipo. La operación diaria debe realizarse con la cuenta individual del usuario correspondiente. # Recuperar y cambiar contraseña # Recuperar y cambiar contraseña La App dispone de recuperación de contraseña desde la pantalla de acceso y cambio de contraseña para usuarios autenticados. El cambio puede iniciarse desde **Configuración → Usuario**. # 02 — Navegación y sucursal # Menú principal # Menú principal Después de iniciar sesión, el menú lateral contiene: - **Inicio** - **Grabados** - **Nuevo** - **Configuración** - **Reportes** - **Cerrar sesión** ## Interfaz adaptada a la operación Además del menú principal, determinados campos y funciones cambian según la organización y la sucursal activa. Consulta **Comportamiento según organización y sucursal**. # Selección y cambio de sucursal # Selección y cambio de sucursal EtchManager POS trabaja siempre sobre una **sucursal activa**. La sucursal seleccionada determina dónde se registra la operación y qué configuración funcional recibe el POS. ## Usuario con una sola sucursal Cuando el usuario tiene acceso a una sola sucursal, la App puede utilizarla directamente como sucursal activa, sin exigir una selección manual adicional. ## Usuario con varias sucursales Cuando el usuario pertenece o tiene acceso a más de una sucursal, EtchManager muestra una **ventana de selección de sucursal**. 1. Selecciona la sucursal donde estás trabajando físicamente. 2. La App establece esa sucursal como activa. 3. Los nuevos grabados y las reglas de operación se aplican según esa selección. ## Cambiar de sucursal durante la sesión El cambio se realiza desde **Inicio**, tocando el nombre de la sucursal mostrado en la barra superior. Si intentas cambiar la sucursal desde otra pantalla, la App indica que debes volver a **Inicio**. ## Importante Antes de registrar un grabado, confirma siempre que la sucursal activa corresponda al lugar donde se está realizando el trabajo. La selección puede modificar tanto la asociación del grabado como los campos y funciones disponibles en el POS. # Comportamiento según organización y sucursal # Comportamiento según organización y sucursal La interfaz de EtchManager POS **no es necesariamente idéntica para todos los usuarios o sucursales**. El backend envía configuraciones que determinan qué funciones deben estar activas según el contexto de operación. ## Cómo se determina el comportamiento Una configuración puede definirse con distintos alcances: - **No:** función deshabilitada. - **Todos:** función habilitada globalmente. - **Organización:** habilitada solo para organizaciones seleccionadas. - **Sucursal:** habilitada solo para sucursales seleccionadas. ## Funciones que pueden variar
FunciónEfecto en el POS
Número de OT / OrdenDetermina si el operador debe visualizar o utilizar el número de orden durante el grabado.
VIN / ChasisDetermina si se habilita el ingreso del VIN o número de chasis.
Patente de motocicletaDetermina si la sucursal u organización puede utilizar el flujo para motocicletas.
Logo de marca en etiquetaDetermina si la etiqueta impresa incorpora el logo correspondiente a la marca del vehículo.
## Relación con la sucursal activa Cuando una regla está definida por sucursal, cambiar la sucursal activa puede cambiar inmediatamente el conjunto de funciones aplicables al operador una vez que el POS dispone de la configuración correspondiente. ## Configuración sincronizada El POS conserva localmente los ajustes recibidos del backend para poder mantener el comportamiento esperado durante periodos sin conexión. ## Para el operador No es necesario modificar estos parámetros desde la App. Si una función esperada no aparece —por ejemplo VIN, motocicletas, número de OT o logo de marca— debe verificarse primero la configuración de la organización o sucursal en la plataforma EtchManager. # 03 — Grabados # Registrar un nuevo grabado # Registrar un nuevo grabado La opción **Nuevo** inicia el flujo de registro de un grabado. ## Antes de comenzar - Confirma que la **sucursal activa** sea correcta. - Verifica cuidadosamente la patente y los datos del vehículo. - Ten presente que algunos campos pueden aparecer o no según la configuración recibida desde EtchManager. ## Campos y funciones configurables EtchManager puede habilitar determinadas funciones para todos los POS, para organizaciones específicas o solamente para ciertas sucursales. ### Número de OT / Orden El campo de número de OT u orden se muestra y utiliza solamente cuando está habilitado para la organización o sucursal activa. ### VIN / Chasis El registro del VIN o número de chasis está disponible únicamente cuando la configuración correspondiente está habilitada para el contexto operativo actual. ### Motocicletas La posibilidad de registrar una patente de motocicleta depende de la configuración aplicada a la organización o sucursal. Si esa función no está habilitada, el operador no debe disponer del flujo de grabado de motocicletas. ## Validaciones La App valida la información capturada y aplica las reglas correspondientes al tipo de vehículo y a la configuración vigente. ## Trabajo sin conexión Cuando no existe conexión a Internet, el grabado puede almacenarse localmente usando la información y configuración previamente sincronizadas en el POS. Quedará pendiente de sincronización hasta recuperar conectividad. # Editar un grabado # Editar un grabado Los grabados pueden corregirse mientras continúen editables. 1. Abre el grabado. 2. Selecciona edición. 3. Corrige los datos. 4. Guarda. Los cambios se sincronizan con el backend al existir conectividad. Algunas reglas del servidor pueden bloquear registros ya cerrados o no editables. # Lista de grabados # Lista de grabados La opción **Grabados** muestra los registros disponibles para la operación del POS. Desde la lista puedes abrir un grabado y continuar con edición o impresión según su estado. Al volver desde una pantalla hija, la lista se actualiza para reflejar los cambios. # 04 — Impresión # Impresión y reimpresión # Impresión y reimpresión La pantalla de impresión permite generar las etiquetas asociadas al grabado y realizar reimpresiones. ## Logo o marca del vehículo en la etiqueta La etiqueta puede incluir el **logo de la marca del vehículo** cuando esta función está habilitada desde EtchManager. La regla puede aplicarse de forma general o solamente a determinadas organizaciones o sucursales. Por eso una etiqueta impresa en una sucursal puede tener una presentación distinta a la de otra. ## Información utilizada La etiqueta se genera con la información disponible para el grabado y con la configuración previamente recibida desde el backend. ## Reimpresión EtchManager POS permite volver a imprimir etiquetas de registros existentes, incluyendo grabados recuperados desde el historial cuando corresponda. ## Trabajo sin conexión La generación de etiquetas puede continuar con la información y recursos ya disponibles localmente en el POS aunque se pierda temporalmente la conexión a Internet. # Configurar la impresora # Configurar la impresora La configuración está disponible en **Configuración → Impresora**. La App utiliza Bluetooth para la impresión. Si la impresora no aparece, verifica Bluetooth, permisos Android y que la impresora esté encendida y disponible. # 05 — Historial y reportes # Historial y búsqueda de grabados # Historial y búsqueda de grabados La App dispone de una pantalla de **Historial** para consultar grabados anteriores. Con conectividad puede apoyarse en información del backend y recuperar trabajos fuera del conjunto local inmediato. # Reportes # Reportes **Reportes** permite consultar información resumida de la operación desde el POS. La App puede solicitar el envío de informes al correo del usuario autenticado. Si el backend no logra enviarlos, muestra un mensaje controlado para contactar a soporte. # 06 — Configuración del POS # Configuración del POS # Configuración del POS La pantalla **Configuración** tiene actualmente cinco pestañas: - Dispositivo - Mantenimiento - Usuario - Impresora - Acerca de Varias opciones están destinadas a administración o soporte. # Configuración del dispositivo # Configuración del dispositivo La pestaña **Dispositivo** contiene la identidad técnica con la que EtchManager reconoce y autoriza el POS. ## Información del dispositivo - **Base URL** del backend. - **Número de serie**. - **IMEI**. - **SIM**. - **Android ID**. ## Uso durante la instalación inicial Cuando la App se instala por primera vez y aún no existe información del dispositivo, EtchManager abre esta configuración antes de permitir el login normal. Para registrar el equipo deben completarse los datos técnicos e ingresarse un **RUT y contraseña de administrador**. La App valida estas credenciales contra el backend junto con Serial, IMEI, SIM y Android ID. Si el equipo no está autorizado, la configuración no puede completarse. ## Después de la autorización Una vez validado y guardado el dispositivo, la configuración queda almacenada localmente y el operador puede pasar al inicio de sesión normal. ## Edición posterior La configuración del dispositivo está protegida para evitar cambios accidentales. Las modificaciones de estos datos deben realizarse solamente por personal administrativo o soporte. ## Borrar configuración local Existe una acción para eliminar toda la información local del equipo. Esta operación borra usuarios, grabados y configuración almacenada en el POS. Después de borrar la configuración, el dispositivo deberá volver a pasar por el proceso de registro/autorización antes de utilizarse normalmente. # Información del usuario # Información del usuario La pestaña **Usuario** muestra usuario, organización, sucursal actual, sucursales disponibles y parámetros recibidos desde el backend. Desde aquí también puede iniciarse el cambio de contraseña. # Acerca de y versión de la App # Acerca de y versión de la App La pestaña **Acerca de** muestra información de la aplicación instalada, incluida su versión. Es útil para soporte y control de despliegues. # 07 — Sincronización y modo offline # Modo offline # Modo offline EtchManager POS está preparado para mantener continuidad cuando se pierde Internet. - Usa información ya almacenada en el dispositivo. - Puede registrar grabados localmente. - Puede generar etiquetas con datos disponibles. - Mantiene cambios pendientes hasta recuperar conexión. Al volver la conectividad, la App sincroniza pendientes y puede recibir marcas, sucursales, organizaciones y ajustes actualizados. ## Configuración disponible sin conexión Las reglas que ya fueron sincronizadas —como uso de OT, VIN, motocicletas o presentación de etiquetas— pueden seguir aplicándose con la información almacenada localmente. Los cambios realizados posteriormente en el backend requerirán una nueva sincronización para llegar al POS. # Pestaña Mantenimiento # Pestaña Mantenimiento **Configuración → Mantenimiento** incluye herramientas de soporte. - **Sincronizar:** ejecuta sincronización manual. - **Diagnóstico:** muestra usuario, organización, sucursal, URL, serial, IMEI, SIM y versión. - **Forzar Purga de Datos:** inicia manualmente sincronización y mantenimiento mensual. # Sincronización de datos # Sincronización de datos La sincronización es bidireccional: envía cambios locales y recibe actualizaciones desde el backend. La App programa sincronizaciones periódicas con un intervalo base aproximado de una hora y también permite ejecutar una sincronización manual desde **Configuración → Mantenimiento → Sincronizar**. # Mantenimiento mensual de datos # Mantenimiento mensual de datos La App realiza mantenimiento periódico para evitar crecimiento indefinido de la base local. Los registros antiguos deben eliminarse solo después de haber sido sincronizados. Si el mantenimiento no puede completarse, la App muestra un aviso solicitando conectividad. # 08 — Mantenimiento y soporte # Diagnóstico y envío de logs # Diagnóstico y envío de logs La herramienta de diagnóstico muestra trazas en vivo y permite: - Copiar. - Compartir. - Subir los logs al backend. - Limpiar las trazas locales. Los logs subidos quedan asociados al POS para que soporte pueda revisarlos desde EtchManager. # Permisos de Android # Permisos de Android La App solicita permisos necesarios para Bluetooth, conectividad, notificaciones e instalación de actualizaciones. En versiones antiguas de Android, el escaneo Bluetooth puede requerir permisos de ubicación por exigencia del sistema operativo. # Solución de problemas frecuentes # Solución de problemas frecuentes ## No puedo iniciar sesión Comprueba conectividad, autorización del usuario y configuración del dispositivo. ## No puedo cambiar de sucursal Vuelve a **Inicio** y toca la sucursal de la barra superior. ## No imprime Verifica Bluetooth, permisos, impresora encendida y configuración. ## Hay datos pendientes Recupera conectividad y usa **Configuración → Mantenimiento → Sincronizar**. ## Soporte necesita información Abre Diagnóstico y copia, comparte o sube los logs.