📊 Dashboard de xPOS-Core
El Dashboard es la interfaz web que corre en el mismo equipo que xPOS-Core. Permite revisar el estado operativo del servicio, consultar los documentos procesados, administrar folios y ejecutar tareas de mantenimiento sobre la instalación.
Esta página describe la consola local, la que corre en el equipo de la tienda. La administración centralizada de todo el parque de dispositivos —Pool, Monitor, Versiones, Logs— vive en el Portal de clientes (Gadget xPOS), que es un producto distinto y corre en la nube.
🔐 Acceso al Dashboard
- Abrir un navegador web en el equipo donde está instalado xPOS.
- Ir a la siguiente dirección:
http://localhost:3200/dashboard/
- Iniciar sesión con las credenciales de la instalación.
| Campo | Valor de ejemplo |
|---|---|
| Usuario | admin |
| Contraseña | 1234 |
Las credenciales mostradas son de ejemplo: las reales de tu instalación se entregan durante el onboarding con el equipo de Gosocket.
Para versiones de xPOS-Core igual o superior a v2.X.X:
Para versiones de xPOS-Core igual o inferior a v1.X.X:
Una vez autenticado, se accede al Dashboard principal:
¿Necesitas entrar desde otro equipo? Ver Acceso remoto a xPOS-Core.
🆔 Información del xPOS
En la parte superior del dashboard se muestra un resumen de los datos principales del xPOS instalado:
- Versión: versión del ejecutable X.XX.X.
- Nombre del xPOS.
- UUID: identificador único del xPOS.
- Ambiente: Sandbox (SBX) o Producción (PRD).
- Estado:
- 🟢 Activo: el xPOS puede procesar documentos.
- 🔴 Bloqueado: el xPOS no puede operar debido a un bloqueo realizado por el usuario desde el portal de administración o el Gadget xPOS.
- 🔴 Bloqueo financiero: el xPOS no puede operar debido a un bloqueo solicitado por el área financiera y/o comercial de Gosocket.
- 🔴 Versión vencida: el xPOS no puede operar porque la versión está discontinuada y no se le brindará soporte.
🏢 Selector de emisor (multiroot)
A partir de xPOS-Core 2.6.0 un mismo equipo puede tener varios emisores instalados (varios onboardings, cada uno con su certificado, credenciales y folios propios).
Cuando hay más de un emisor, la barra lateral incluye un selector que determina con qué emisor estás trabajando. Muestra el emisor actual destacado, permite buscar por nombre o identificador, copiar el identificador y dar de alta un emisor nuevo.
Todas las vistas del dashboard muestran únicamente los datos del emisor seleccionado. El filtro se aplica en el servidor, no en el navegador.
El emisor con el que se procesa cada venta lo determina el parámetro origin que envía el POS en la llamada a la API — ver Multiroot. El selector del dashboard solo decide qué se muestra en pantalla.
📥 Módulo: Inicio
Resume las transacciones de documentos enviadas al xPOS.
Métricas mostradas
- Documentos procesados ✅ — total de documentos generados correctamente.
- Contingencias 🕓 — transacciones realizadas en modo contingencia.
- Documentos erróneos ⚠️ — documentos con errores en la creación o envío.
- Documentos encolados ⏳ — documentos pendientes de envío a la entidad tributaria o al portal Inbox.
📑 Módulo: Documentos
Permite explorar el historial de documentos procesados.
Submódulos disponibles
- Documentos procesados: documentos procesados correctamente, con acceso a los XML de salida generados.
- Contingencias: documentos procesados durante una contingencia, con acceso a los XML de salida generados.
- Documentos erróneos: documentos que tuvieron algún error, ya sea en el procesamiento o por rechazo de la entidad tributaria.
Tabla informativa
| Campo | Descripción |
|---|---|
| UUID | ID único interno generado por xPOS. |
| Tipo de documento | Factura, boleta, nota de crédito, etc. |
| Folio | Número de folio del documento. |
| PartnerFolio | Número de folio asignado por la entidad tributaria o el PAC. Solo habilitado para Guatemala. |
| Fecha | Fecha de creación del documento. |
| Estado en ET | Estado final del documento según la respuesta de la entidad tributaria: Aceptado, Rechazado o Pendiente (esperando procesar o actualizar el estado final). |
| Estado en Inbox | Estado de sincronización con el portal Gosocket/Inbox: Pendiente o Sincronizado. |
| Estado en Kiosco | Estado de sincronización con el producto Kiosco: Pendiente, Sincronizado o Rechazado. |
Orden y filtros
Hasta la versión anterior, el orden y algunos filtros operaban solo sobre las filas ya cargadas en pantalla. Desde 2.6.0 se aplican sobre el conjunto completo de documentos, resueltos en el servidor.
- Orden por columna: fecha, tipo de documento, número de documento, folio, folio del socio y etapa del error. El encabezado indica qué columna está activa y en qué dirección (ascendente → descendente → sin orden).
- Filtros: tipo de documento, estado ante la autoridad (Aceptado / Rechazado / En proceso, más Aceptado condicional en República Dominicana), etapa del error (solo en Documentos erróneos) y rango de fechas con presets (Hoy, 3 días, 7 días, rango libre).
- Búsqueda por número de documento: busca también por identificador de transacción.
- Los filtros activos se muestran como etiquetas removibles individualmente, con un botón Limpiar filtros.
Las columnas de estado no son ordenables, porque son campos derivados; para acotarlas está el filtro correspondiente.
Acciones disponibles
- Copiar ID: copia el UUID (transaction ID) del documento en xPOS.
- Ver documento: visualiza el XML fiscal o el JSON, con opción de descarga.
Disponible solo en las versiones 1.XX.X.
Disponible a partir de las versiones 2.1.X.
- Ver respuesta ET: visualiza el XML o JSON de la respuesta de la entidad tributaria, con opción de descarga.
Disponible a partir de las versiones 2.1.X.
🧾 Módulo: Folios
Visualiza los folios disponibles y los subrangos asignados por el Gestor de Folios 3.0.
Acciones generales
- Recargar folios: solicita subrangos de folios al GF 3.0 para todos los documentos del xPOS.
Acciones a nivel de rango de folios
- Liberar folios: libera el rango desde el folio actual hasta el límite establecido.
Desde la versión 2.6.0 ambas acciones operan sobre el emisor seleccionado y reportan el resultado real de la operación, incluido el caso en que no se alcanzó el umbral de recarga.
⚙️ Módulo: Configuraciones
Permite ejecutar tareas técnicas y administrativas sobre el xPOS.
Acciones disponibles
| Acción | Botón | Qué hace |
|---|---|---|
| Nuevo onboarding 🆕 | + TaxID | Abre el asistente de onboarding para registrar una nueva organización (TaxID) en el dispositivo, permitiendo múltiples onboardings. |
| Enviar logs | Enviar | Sincroniza y envía manualmente los logs locales al Portal para análisis de soporte técnico. |
| Recargar configuración | Recargar | Fuerza la descarga de esquemas de validación, certificados y plantillas actualizadas desde la nube de xPOS. |
| Compactar base de datos 🆕 | Compactar | Devuelve al disco el espacio que la purga liberó dentro del archivo. El xPOS no responde mientras dura. |
| Healthcheck | Checklist | Ejecuta un diagnóstico de conectividad e integridad para verificar el estado de los enlaces y la configuración del xPOS. |
| Actualizar versión 🆕 | xUpdater | Comprueba la disponibilidad de parches de seguridad y actualizaciones de software a través de xPOS-Updater. |
| Contingencia Manual | ON / OFF | Modo Offline: retiene localmente los documentos sin enviarlos a la entidad tributaria. Al desactivarse, se reanuda la cola de transmisión automática. |
| Reiniciar xPOS | Reiniciar | Restablecimiento de fábrica: elimina toda la configuración local, revoca las credenciales y desvincula el UUID de la terminal. |
🆕 = disponible desde la versión 2.6.0.
Nuevo onboarding (+ TaxID)
Da de alta otro emisor en el mismo equipo, sin desinstalar ni afectar a los ya instalados. Abre el asistente de onboarding para el nuevo tax-id, incluido su paso de verificación.
Compactar base de datos
La purga nocturna borra filas antiguas, pero el espacio que libera queda dentro del archivo de base de datos: el archivo no se encoge solo. Compactar es lo que devuelve ese espacio al disco.
Al terminar, la acción informa el tamaño antes y después de la operación y cuánto tardó.
Mientras dura la compactación el xPOS no responde: no procesa documentos. Ejecutarla fuera del horario de operación de la tienda. Por eso la acción informa el tiempo que tomó — sirve para dimensionar la ventana necesaria en las siguientes ejecuciones.
Compactar recupera espacio. No repara una base de datos dañada. Si sospechas de un problema de integridad, escala a Gosocket en lugar de compactar.
Healthcheck
Es la misma verificación que se ejecuta como paso obligatorio durante la instalación — ver Verificación de la instalación. Desde el dashboard puede relanzarse en cualquier momento para diagnosticar un equipo ya operativo.
Actualizar versión (xUpdater)
Consulta si hay parches de seguridad o versiones nuevas disponibles, y abre el Dashboard del Updater sin tener que iniciar el servicio a mano en el equipo.
Contingencia Manual
Interruptor que activa el modo offline en el dispositivo: los documentos se emiten y se retienen localmente, sin enviarlos a la entidad tributaria. Al desactivarlo, se reanuda la cola de transmisión automática y los documentos retenidos se envían.
Al activarla se solicitan datos obligatorios de responsable y motivo, y mientras esté activa se muestra un banner de advertencia en pantalla.
Reiniciar xPOS
Restablecimiento de fábrica: elimina toda la configuración local, libera los folios al GF 3.0 (si aplica), revoca las credenciales, restaura la base de datos local sin datos y desvincula el UUID de la terminal, dejándolo en estado "inactivo".
Reiniciar el xPOS borra los datos locales de la instalación. En un equipo con varios emisores, verifica sobre cuál estás operando antes de ejecutarla.