XPOS

Cambio de Logos en POS y Ticket

Guía técnica para el reemplazo y configuración de logotipos en la interfaz del punto de venta y en la impresión de tickets térmicos.

Esta guía detalla el procedimiento para actualizar la identidad visual del cliente tanto en la interfaz de usuario del POS como en los comprobantes impresos en ticketera térmica.

Requisitos de Archivos

Para garantizar compatibilidad con XPOS, XSPOS y las impresoras térmicas, los archivos deben respetar estrictamente los siguientes nombres, formatos y dimensiones:

Archivo	Formato	Dimensiones recomendadas	Uso
`logo.png`	.PNG con fondo transparente	576 x 576 px	Visualización en pantalla del POS.
`logo-ticket.bmp`	.BMP monocromático	576 x 576 px	Impresión en ticketera térmica.

Ambos archivos deben conservar un marco cuadrado de 576 x 576 px. El logotipo debe adaptarse dentro del marco sin recortarse, manteniendo su proporción original y centrado.

No usar el nombre logo_ticket.bmp. El archivo correcto para ticket debe llamarse exactamente logo-ticket.bmp.

Preparación de Archivos

Antes de copiar los logos al servidor, validar lo siguiente:

logo.png debe tener fondo transparente.
logo-ticket.bmp debe estar en blanco y negro o monocromático.
Ambos archivos deben medir 576 x 576 px.
El logotipo debe estar centrado dentro del marco.
No se debe cortar ninguna parte del logotipo.
No cambiar los nombres de archivo.

Procedimiento de Actualización

Transferencia al Servidor

Establecer conexión con el servidor del cliente, habitualmente mediante AnyDesk, y transferir los archivos preparados a una carpeta temporal:

logo.png
logo-ticket.bmp

Reemplazo en Terminal POS

Copiar el archivo logo.png en la siguiente ruta:

C:\XetuxXPOS\xpos

Acción:

Reemplazar el archivo logo.png existente.
Eliminar archivos BMP de logos que no correspondan, si existen en esta carpeta.

Reemplazo en Servidor de Aplicaciones

Abrir la siguiente ruta:

C:\Xetux-Server\tomcat-xspos\webapps\xspos\conf

En esta carpeta deben quedar únicamente los siguientes archivos:

info.txt
logo.png
logo-ticket.bmp

Acción:

Conservar info.txt.
Eliminar cualquier otro archivo existente en la carpeta.
Copiar logo.png.
Copiar logo-ticket.bmp.

Configuración en el Administrador Web

Para actualizar la caché visual del sistema:

Abrir Google Chrome en el servidor.
Acceder a la URL: http://localhost:8090/xspos
Autenticarse con las credenciales técnicas.
Navegar a la sección Themes.
Hacer clic en Seleccionar archivo.
Seleccionar el archivo C:\XetuxXPOS\xpos\logo.png.
Ejecutar la acción Upload / Save.

Reinicio de Servicios

Para aplicar los cambios, reiniciar los servicios en el siguiente orden:

Servicio de impresión xprinter
- Finalizar el proceso del servicio si se queda detenido o no responde.
- Iniciar nuevamente el servicio.
Servicio XSPOS xspos
- Detener e iniciar el servicio normalmente.

El servicio de impresión puede quedarse atorado al detenerse de forma normal. En ese caso, se puede finalizar el proceso asociado y después iniciar nuevamente el servicio.

Verificación

Después de completar el procedimiento, validar lo siguiente:

En pantalla: abrir XPOS y confirmar que el nuevo logotipo se muestra correctamente.
En administrador web: confirmar que el logo cargado corresponde al cliente.
En ticket: realizar una impresión de prueba, como corte X o Z, para validar alineación, nitidez y tamaño del logotipo.
En carpeta XSPOS: confirmar que conf contiene únicamente info.txt, logo.png y logo-ticket.bmp.

En dispositivos móviles, como tabletas Android, el cambio de logo podría requerir reinstalar el archivo .apk si la imagen fue compilada como recurso estático dentro de la aplicación.

Edit this pageorReport an issue

Activación Appio

Guía técnica para la configuración e integración de plataformas de delivery (Uber, Rappi, DiDi) mediante el motor Appio en Xetux.

Instalación XCONNECT

Guía rápida para el despliegue del componente XCONNECT en el servidor backend de Xetux.