Guía de Configuración de EmiliaCloudPrinter¶

Captura de Pedidos POS en la Nube¶

Esta guía técnica explica cómo configurar impresoras virtuales en Windows que envían los datos de impresión directamente al servicio CloudPOS de Emilia Vision.

Público objetivo: Administradores de sistemas, técnicos de soporte y proveedores de POS.

Descripción General¶

EmiliaCloudPrinter permite capturar los pedidos que su sistema POS envía a impresoras térmicas (cocina, bar, postres, caja) y almacenarlos en la nube para análisis.

Existen cuatro métodos de configuración:

*Requiere driver APD preinstalado (ver Método C, Pasos 1-2)

Requisitos Previos¶

• Windows 10 o Windows 11
• Permisos de Administrador
• Conectividad a Internet

Datos de conexión:

Verificar conectividad (PowerShell):

Test-NetConnection -ComputerName printer.emiliavision.com -Port 9100

Debe mostrar TcpTestSucceeded : True

Método A: Configuración con PowerShell (Recomendado)¶

Este método es más rápido y permite crear múltiples impresoras en segundos.

Paso 1: Abrir PowerShell como Administrador¶

1. Presione Win + X
2. Seleccione "Windows PowerShell (Admin)" o "Terminal (Admin)"
3. Acepte el cuadro de UAC si aparece

Paso 2: Crear Impresora Básica¶

Add-PrinterPort -Name "EmiliaCloud" -PrinterHostAddress "printer.emiliavision.com" -PortNumber 9100
Add-Printer -Name "EmiliaCloudPrinter" -DriverName "Generic / Text Only" -PortName "EmiliaCloud"

Paso 3: Crear Múltiples Impresoras por Estación¶

Configuración recomendada: Una impresora virtual por cada estación de trabajo.

Script completo:

# EmiliaCloudPrinter - Script de Instalación

# Cocina
Add-PrinterPort -Name "EmiliaCloud-Kitchen" -PrinterHostAddress "printer.emiliavision.com" -PortNumber 9100
Add-Printer -Name "EmiliaCloudPrinter-Kitchen" -DriverName "Generic / Text Only" -PortName "EmiliaCloud-Kitchen"

# Bar
Add-PrinterPort -Name "EmiliaCloud-Bar" -PrinterHostAddress "printer.emiliavision.com" -PortNumber 9100
Add-Printer -Name "EmiliaCloudPrinter-Bar" -DriverName "Generic / Text Only" -PortName "EmiliaCloud-Bar"

# Postres
Add-PrinterPort -Name "EmiliaCloud-Desserts" -PrinterHostAddress "printer.emiliavision.com" -PortNumber 9100
Add-Printer -Name "EmiliaCloudPrinter-Desserts" -DriverName "Generic / Text Only" -PortName "EmiliaCloud-Desserts"

# Caja
Add-PrinterPort -Name "EmiliaCloud-Cashier" -PrinterHostAddress "printer.emiliavision.com" -PortNumber 9100
Add-Printer -Name "EmiliaCloudPrinter-Cashier" -DriverName "Generic / Text Only" -PortName "EmiliaCloud-Cashier"

Write-Host "Instalación completada" -ForegroundColor Green

Paso 4: Verificar Instalación¶

Get-Printer | Where-Object {$_.Name -like "*Emilia*"} | Format-Table Name, DriverName, PortName

Método B: Configuración con Interfaz Gráfica¶

Este método utiliza el asistente de Windows para agregar impresoras.

Paso 1: Abrir Configuración de Impresoras¶

1. Presione Win + I para abrir Configuración
2. Vaya a Dispositivos → Impresoras y escáneres
3. Haga clic en "La impresora deseada no está en la lista"

Paso 2: Seleccionar Tipo de Conexión¶

Seleccione "Agregar una impresora mediante una dirección TCP/IP o nombre de host" y haga clic en Siguiente.

Paso 3: Ingresar Datos de Conexión¶

Importante: Desmarque "Consultar la impresora y seleccionar automáticamente el controlador"

Paso 4: Detección de Puerto¶

Espere mientras Windows detecta el puerto TCP/IP.

Paso 5: Configurar Puerto RAW¶

Cuando aparezca el diálogo de configuración de puerto:

Deje desmarcado "SNMP habilitado".

Paso 6: Seleccionar Controlador¶

• Fabricante: Generic
• Impresora: Generic / Text Only

Paso 7: Usar Controlador Existente¶

Si el controlador ya está instalado, seleccione "Usar el controlador instalado actualmente".

Paso 8: Nombrar la Impresora¶

Ingrese el nombre: EmiliaCloudPrinter

Paso 9: Instalación Completada¶

La impresora aparece en la lista de dispositivos instalados.

Para crear impresoras adicionales (Kitchen, Bar, Desserts, Cashier), repita el proceso cambiando el nombre del puerto y de la impresora.

Método C: Driver Epson (Interfaz Gráfica)¶

Este método utiliza el driver nativo EPSON TM-T20II con el asistente de Windows.

Requisitos Previos¶

1. Complete primero el Método A o B para crear el puerto TCP/IP
2. Descargue e instale el Epson APD (Advanced Printer Driver)

Paso 1: Descargar Driver APD de Epson¶

Vaya al sitio de soporte de Epson para TM-T20II:

Descargue: Advanced Printer Driver (APD) v5.13 (~70 MB)

Paso 2: Instalar el Driver APD¶

Extraiga el ZIP y ejecute APD_513_T20II.exe como Administrador:

Paso 3: Agregar Impresora con Configuración Manual¶

1. Vaya a Configuración → Dispositivos → Impresoras y escáneres
2. Haga clic en "La impresora deseada no está en la lista"
3. Seleccione "Agregar una impresora local o de red con configuración manual"

Paso 4: Usar Puerto Existente¶

Seleccione "Usar un puerto existente" y elija el puerto EmiliaCloudPrinter que creó anteriormente.

Paso 5: Seleccionar Driver Epson¶

• Fabricante: EPSON
• Impresora: EPSON TM-T20II Receipt5

Paso 6: Usar Driver Instalado¶

Seleccione "Usar el controlador instalado actualmente (recomendado)"

Paso 7: Compartir Impresora (Opcional)¶

Configure el uso compartido si es necesario. Nombre compartido: EmiliaCloudPrinterEpson

Paso 8: Instalación Completada¶

La impresora Epson está ahora configurada para enviar datos a la nube de EmiliaVision.

Método D: Driver Epson (PowerShell)¶

El método más rápido si ya tiene el driver APD de Epson instalado.

Requisitos Previos¶

• Driver APD de Epson instalado (ver Método C, Pasos 1-2)

Impresora Individual¶

# Crear puerto e impresora con driver Epson
Add-PrinterPort -Name "EmiliaCloud" -PrinterHostAddress "printer.emiliavision.com" -PortNumber 9100
Add-Printer -Name "EmiliaCloudPrinterEpson" -DriverName "EPSON TM-T20II Receipt5" -PortName "EmiliaCloud"

Múltiples Impresoras con Driver Epson¶

# Cocina
Add-PrinterPort -Name "EmiliaCloud-Kitchen" -PrinterHostAddress "printer.emiliavision.com" -PortNumber 9100
Add-Printer -Name "EmiliaCloudPrinter-Kitchen-Epson" -DriverName "EPSON TM-T20II Receipt5" -PortName "EmiliaCloud-Kitchen"

# Bar
Add-PrinterPort -Name "EmiliaCloud-Bar" -PrinterHostAddress "printer.emiliavision.com" -PortNumber 9100
Add-Printer -Name "EmiliaCloudPrinter-Bar-Epson" -DriverName "EPSON TM-T20II Receipt5" -PortName "EmiliaCloud-Bar"

# Postres
Add-PrinterPort -Name "EmiliaCloud-Desserts" -PrinterHostAddress "printer.emiliavision.com" -PortNumber 9100
Add-Printer -Name "EmiliaCloudPrinter-Desserts-Epson" -DriverName "EPSON TM-T20II Receipt5" -PortName "EmiliaCloud-Desserts"

# Caja
Add-PrinterPort -Name "EmiliaCloud-Cashier" -PrinterHostAddress "printer.emiliavision.com" -PortNumber 9100
Add-Printer -Name "EmiliaCloudPrinter-Cashier-Epson" -DriverName "EPSON TM-T20II Receipt5" -PortName "EmiliaCloud-Cashier"

Verificar Instalación¶

Get-Printer | Where-Object {$_.Name -like "*Epson*"} | Format-Table Name, DriverName, PortName

Cuándo Usar Driver Epson vs Generic¶

Pruebas de Funcionamiento¶

Prueba Individual¶

"Prueba de impresion EmiliaCloudPrinter" | Out-Printer -Name "EmiliaCloudPrinter"

Prueba por Estación¶

"=== COCINA ===`r`nMesa: 12`r`n2x Hamburguesa`r`n1x Ensalada" | Out-Printer -Name "EmiliaCloudPrinter-Kitchen"
"=== BAR ===`r`nMesa: 12`r`n2x Margarita`r`n1x Cerveza" | Out-Printer -Name "EmiliaCloudPrinter-Bar"
"=== POSTRES ===`r`nMesa: 12`r`n1x Cheesecake" | Out-Printer -Name "EmiliaCloudPrinter-Desserts"
"=== CAJA ===`r`nMesa: 12`r`nTotal: $45.50" | Out-Printer -Name "EmiliaCloudPrinter-Cashier"

Contacte al equipo de Emilia Vision para confirmar la recepción de los datos.

Comandos Útiles¶

Listar Drivers Disponibles¶

Get-PrinterDriver | Format-Table Name

Verificar si el Driver Epson está Instalado¶

Get-PrinterDriver | Where-Object {$_.Name -like "*TM-T20II*"}

Si el comando no retorna nada, el driver APD de Epson no está instalado. Ver Método C, Pasos 1-2.

Listar Todas las Impresoras¶

Get-Printer | Format-Table Name, DriverName, PortName

Listar Solo Impresoras EmiliaCloud¶

Get-Printer | Where-Object {$_.Name -like "*Emilia*"} | Format-Table Name, DriverName, PortName

Eliminar una Impresora¶

Remove-Printer -Name "EmiliaCloudPrinter"

Eliminar un Puerto de Impresora¶

Remove-PrinterPort -Name "EmiliaCloud"

Eliminar Todas las Impresoras y Puertos EmiliaCloud¶

# Eliminar impresoras
Get-Printer | Where-Object {$_.Name -like "*Emilia*"} | Remove-Printer

# Eliminar puertos
Get-PrinterPort | Where-Object {$_.Name -like "*Emilia*"} | Remove-PrinterPort

Solución de Problemas¶

Error: "Windows no puede conectar con la impresora"¶

1. Verifique conectividad:

   Test-NetConnection -ComputerName printer.emiliavision.com -Port 9100
   

2. Revise configuración de firewall

Los datos llegan como binario/basura¶

• Verifique que está usando el controlador Generic / Text Only
• NO use "Microsoft Software Printer Driver"

La impresora no aparece en la lista¶

Restart-Service Spooler

Resumen de Configuración¶

¡Configuración Completada!¶

Para soporte técnico, contacte al equipo de Emilia Vision.