Saltar al contenido principal

🖨️ CloudSuite Printer Service

Servicio de impresión para usar impresoras térmicas directamente desde CloudSuite Pro.

¿Qué es?​

El CloudSuite Printer Service es una aplicación pequeña que se instala en tu computadora y permite imprimir facturas y tickets directamente en impresoras térmicas (como las Epson TM-T20, Star TSP650, etc.).

¿Para qué sirve?​

  • ✅ Imprimir facturas con NCF en impresoras térmicas
  • ✅ Imprimir tickets de venta rápidos
  • ✅ Abrir el cajón de dinero automáticamente
  • ✅ Reportes de cierre de caja (Z y X)

Descargar​

Windows​

⬇️ Descargar para Windows (v1.0.0)

Requisitos: Windows 10/11

macOS​

⬇️ Descargar para macOS (v1.0.0)

Requisitos: macOS 10.15 o superior (Intel y Apple Silicon)

Instalación​

En Windows​

  1. Descarga el instalador .exe
  2. Ejecuta el archivo descargado
  3. Si aparece advertencia de Windows SmartScreen:
    • Click en "Más información"
    • Click en "Ejecutar de todas formas"
  4. Sigue el asistente de instalación
  5. El servicio se iniciará automáticamente
Windows SmartScreen

Windows puede mostrar una advertencia porque la aplicación no está firmada digitalmente. Esto es normal y seguro. Solo debes hacer click en "Más información" y luego "Ejecutar de todas formas".

tip

El servicio se ejecuta en segundo plano. Verás un icono en la bandeja del sistema (al lado del reloj).

En macOS​

  1. Descarga el archivo .dmg
  2. Abre el archivo descargado
  3. Arrastra la aplicación a la carpeta Aplicaciones
  4. Intenta abrir la aplicación desde Aplicaciones
Primera vez: Verificación de seguridad

La primera vez que abras la app, macOS mostrará una advertencia de seguridad. Esto es normal para apps no firmadas.

Para permitir la ejecución:

  1. Ve a Preferencias del Sistema (o Ajustes del Sistema)
  2. Click en Privacidad y Seguridad
  3. Baja hasta la sección "Seguridad"
  4. Verás un mensaje sobre "CloudSuite Printer Service"
  5. Click en "Abrir de todas formas"
  6. Confirma en el diálogo que aparece
  7. La app se abrirá y no volverá a pedir permiso

Alternativa rápida (Terminal):

sudo xattr -cr '/Applications/CloudSuite Printer Service.app'

Configuración​

Primera Configuración​

  1. Busca el icono del servicio en la bandeja del sistema
  2. Click derecho en el icono
  3. Selecciona Configuración
  4. En la ventana que se abre:
    • Selecciona tu impresora de la lista
    • Elige el tipo (usualmente Epson)
    • Ajusta el ancho si es necesario (48 para impresoras de 80mm)
  5. Click en Guardar
  6. Click en Imprimir Prueba para verificar que funciona

Conectar una Impresora​

USB:

  1. Conecta la impresora a tu computadora
  2. Instala los drivers si es necesario
  3. Abre la Configuración del servicio
  4. Refresca la lista de impresoras
  5. Selecciona tu impresora

Red (Ethernet/WiFi):

  • Asegúrate de que la impresora tiene una IP fija
  • Configura la impresora en tu sistema operativo
  • Aparecerá en la lista del servicio

Uso desde CloudSuite Pro​

Una vez instalado y configurado:

  1. Ve al Punto de Venta
  2. Procesa una venta normalmente
  3. Al finalizar, verás el botón "Imprimir Ticket"
  4. Click en el botón → el ticket se imprime automáticamente ✅
info

Si el servicio no está activo, el botón mostrará la opción de imprimir desde el navegador (como backup).

Impresoras Compatibles​

Marcas Probadas​

  • ✅ Epson TM-T20, TM-T88, TM-U220
  • ✅ Star TSP650, TSP700, TSP100
  • ✅ Bixolon SRP-350, SRP-380, SRP-275
  • ✅ Citizen CT-S310, CT-S2000
  • ✅ Cualquier impresora compatible con ESC/POS

Conexiones​

  • ✅ USB
  • ✅ Serial (RS-232)
  • ✅ Ethernet/Red
  • ✅ WiFi

Solución de Problemas​

El servicio no se detecta​

  1. Verifica que el icono esté en la bandeja del sistema
  2. Si no está, busca "CloudSuite Printer Service" en tus aplicaciones e inícialo
  3. Ve a http://localhost:9100/health en tu navegador
  4. Debe mostrar: {"status":"ok"}

La impresora no aparece en la lista​

  1. Verifica que la impresora esté conectada y encendida
  2. Instala los drivers del fabricante
  3. Prueba imprimir un documento de prueba desde tu sistema operativo
  4. Reinicia el servicio (salir y volver a abrir)

No imprime nada​

  1. Verifica que hay papel en la impresora
  2. Revisa que la impresora esté seleccionada en la configuración
  3. Haz una impresión de prueba desde la configuración
  4. Verifica los logs del servicio (Click derecho → Ver logs)

El cajón no abre​

  • El cajón debe estar conectado al puerto RJ12 de la impresora
  • Verifica el cable de conexión
  • Algunas impresoras requieren configuración especial para el cajón

Desinstalar​

Windows​

  1. Panel de Control → Programas → Desinstalar un programa
  2. Busca "CloudSuite Printer Service"
  3. Click en Desinstalar

macOS​

Problema: "La aplicación está dañada"​

Si macOS muestra el mensaje "CloudSuite Printer Service" is damaged and can't be opened, esto es normal con apps no firmadas. Para solucionarlo:

  1. Abre Terminal (Aplicaciones → Utilidades → Terminal)
  2. Ejecuta este comando: 
    sudo xattr -cr /Applications/CloudSuite\ Printer\ Service.app
  3. Ingresa tu contraseña de administrador
  4. Intenta abrir la app de nuevo
Alternativa

También puedes:

  1. Click derecho en la app → Abrir
  2. En el diálogo de seguridad, click en Abrir de nuevo

Desinstalar​

  1. Ve a Aplicaciones
  2. Arrastra "CloudSuite Printer Service" a la Papelera
  3. Vacía la papelera

Soporte Técnico​

Si tienes problemas con el servicio:

Actualizaciones​

El servicio se actualiza automáticamente cuando hay una nueva versión disponible. Recibirás una notificación en la bandeja del sistema.

Versión actual: 1.0.0
Última actualización: 5 de marzo de 2026