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