Guía operativa para instaladores y soporte. Cubre la conexión de una impresora térmica por cable USB a la PC de la sucursal donde corre el Idoo Restaurant Print Client.
A diferencia de la instalación por red, aquí la impresora sí se instala en el sistema operativo: el cliente no le habla al puerto USB directamente, sino que entrega los mismos comandos ESC/POS crudos a una impresora compartida del propio equipo (\\localhost\NOMBRE en Windows, una cola de CUPS en Linux). El spooler los pasa tal cual (RAW), sin renderizarlos.
Contenido
- Cuándo aplica esta guía
- Requisitos
- Nombre de la impresora
- Instalar y compartir la impresora en Windows
- Instalar la impresora en Linux
- Verificación
- Registrar la impresora en Idoo
- Calibrar el ancho del ticket
- Problemas comunes
— Anexo: hoja de registro por sucursal
1. Cuándo aplica esta guía
- La impresora tiene puerto Ethernet
→ Use la guía de red: Instalación de impresoras térmicas por red. Sigue siendo la opción recomendada.
- La impresora solo tiene USB y está junto a la PC del cliente de impresión
→ Aplica esta guía.
- La impresora solo tiene USB pero está lejos de la PC (cocina, barra)
→ Use un print server USB→Ethernet y siga la guía de red (Anexo A de esa guía).
❗ IMPORTANTE
Una impresora USB solo puede imprimir desde la PC a la que está conectada. El cliente de impresión tiene que correr en esa misma PC. Si la PC se apaga, se suspende o se cierra sesión, esa impresora deja de imprimir.
2. Requisitos
- Idoo Restaurant Print Client versión 2.11.0 o superior. Las versiones anteriores solo imprimen por red. El panel de Idoo solo ofrece la conexión USB cuando el cliente de la sucursal ya reporta una versión que la soporta.
- Cable USB de la impresora (normalmente USB A–B, "tipo impresora").
- Usuario administrador en la PC para instalar y compartir la impresora.
- No hace falta el driver del fabricante. Se usa el driver que trae Windows: Generic / Text Only.
3. Nombre de la impresora
Antes de instalar, decida el nombre con el que va a quedar compartida. Ese nombre es el que se escribe después en el panel de Idoo, así que tiene que ser exactamente el mismo en los dos lados.
Reglas:
- Solo letras sin acento, números, espacio, guion
-, guion bajo _ y punto .
- Sin acentos, sin
ñ, sin paréntesis — el cliente rechaza el nombre por seguridad y el ticket no sale.
- Corto y en mayúsculas, sin espacios de preferencia.
Ubicación Nombre recomendado
------------ ------------------
Caja CAJA
Cocina COCINA
Barra BARRA
⚠️ ADVERTENCIA
Windows suele nombrar solo a las impresoras como POS-80C (Copia 1) o Impresora de recibos. Esos nombres no sirven: los paréntesis y los acentos hacen que el cliente rechace el trabajo. Renombre siempre.
4. Instalar y compartir la impresora en Windows
4.1 Conectar
- Conecte el cable USB y encienda la impresora.
- Espere a que Windows termine de detectarla. Puede aparecer en Dispositivos no especificados o crear una impresora con un nombre genérico: no importa, en el siguiente paso se configura bien.
💡 TIP
Elija un puerto USB fijo de la PC y márquelo. Windows asocia la impresora a un puerto virtual (USB001, USB002…) y si mañana alguien la conecta en otro puerto físico, se crea un puerto nuevo y la impresora configurada deja de recibir trabajos (ver sección 9).
4.2 Agregar la impresora con el driver Generic / Text Only
Win + R → control printers → Enter.- Agregar una impresora → La impresora que deseo no está en la lista.
- Agregar una impresora local o de red con configuración manual → Siguiente.
- Usar un puerto existente: elija
USB001 (Puerto de impresora virtual para USB).
- Si hay varios
USB00x, use el más reciente o desconecte/conecte la impresora para identificarlo.
- Fabricante:
Generic → Impresoras: Generic / Text Only → Siguiente.
- Nombre de la impresora: el definido en la sección 3 (ej.
COCINA).
- Compartir esta impresora: Sí, con nombre del recurso compartido igual al de la impresora (ej.
COCINA).
- Finalizar. No imprima la página de prueba de Windows (sale texto sin formato y sin corte, no indica nada útil).
Si Windows ya había creado una impresora sola al conectar el USB, elimínela o déjela sin compartir para que nadie la use por error.
4.3 Revisar que quedó compartida
En PowerShell:
Get-Printer | Select-Object Name, ShareName, Shared, PortName, DriverName
Debe aparecer algo así:
Name ShareName Shared PortName DriverName
---- --------- ------ -------- -----------------
COCINA COCINA True USB001 Generic / Text Only
Si Shared sale en False, o ShareName es distinto de lo que va a escribir en el panel, corríjalo en Propiedades de impresora → Compartir.
Servicio de uso compartido: compartir depende del servicio Servidor de Windows. Si al compartir aparece un error, revise que esté corriendo:
Get-Service LanmanServer
Debe decir Running. La impresora se usa solo desde la propia PC (\\localhost), así que no hace falta abrir el firewall ni cambiar el perfil de red.
5. Instalar la impresora en Linux
En Linux no se comparte nada: el cliente manda el trabajo a la cola de CUPS por su nombre (lp -d NOMBRE -o raw).
# 1. Ver la URI USB de la impresora
sudo lpinfo -v | grep usb
# 2. Crear la cola en modo RAW con el nombre de la sección 3
sudo lpadmin -p COCINA -E -v "usb://LA/URI/QUE/SALIO" -m raw
# 3. Confirmar
lpstat -p COCINA
Si su versión de CUPS se queja del modo raw, cree la cola con el driver genérico de texto y verifíquela con la prueba de la sección 6.
6. Verificación
Ejecute los niveles en orden. Si uno falla, no siga: el problema está ahí.
Nivel 1 — Windows ve la impresora
Get-Printer -Name COCINA | Select-Object Name, PrinterStatus, Shared
PrinterStatus debe ser Normal. Si sale Offline, revise cable, encendido y que el puerto sea el correcto (sección 9).
Nivel 2 — Ticket de prueba real por el recurso compartido
Esto hace exactamente lo mismo que el aplicativo: escribe ESC/POS crudo a un archivo y lo copia en binario a \\localhost\COCINA. Si esto imprime y corta, la instalación está lista.
Windows (PowerShell):
$archivo = "$env:TEMP\idoo-prueba.bin"
$bytes = [byte[]]@(0x1B,0x40) `
+ [Text.Encoding]::ASCII.GetBytes("IDOO - PRUEBA USB`n`n`n") `
+ [byte[]]@(0x1D,0x56,0x00)
[IO.File]::WriteAllBytes($archivo, $bytes)
cmd /c copy /b "$archivo" "\\localhost\COCINA"
Debe responder 1 archivo(s) copiado(s). y la impresora debe imprimir el texto y cortar el papel.
Linux:
printf '\x1b@IDOO - PRUEBA USB\n\n\n\x1dV\x00' | lp -d COCINA -o raw
⚠️ ADVERTENCIA — "copiado" no significa "impreso"
El spooler acepta el trabajo aunque la impresora esté apagada, sin papel o desconectada: lo deja en cola y responde que todo salió bien. Lo mismo pasa con el cliente de impresión. La única prueba válida es ver el papel salir.
7. Registrar la impresora en Idoo
- Reinicie el cliente de impresión (ícono de bandeja → Salir, y vuelva a abrirlo). El cliente reporta al panel las impresoras instaladas en la PC, pero solo las lee al arrancar: si la impresora se instaló con el cliente abierto, el panel no la verá hasta reiniciarlo.
- En el panel de administración de la sucursal, en la ficha de la impresora:
- Tipo de conexión: USB (impresora compartida)
- Nombre de la impresora compartida:
COCINA (exactamente el de la sección 3)
- Guarde y dispare un ticket de prueba desde el panel.
En el visor de logs del cliente (ícono de bandeja → Ver logs) debe aparecer:
Preparing Share Print for: \\localhost\COCINA
Data sent to share "COCINA".
Y, otra vez: confirme que salió el papel. Ese log solo dice que Windows aceptó el trabajo.
Confirme también que el ícono de la bandeja está en verde: el cliente está conectado al servidor y listo para recibir trabajos.
8. Calibrar el ancho del ticket
Al pasar por el spooler de Windows, el ancho útil del ticket depende de la fuente de la impresora y del driver. Si no coinciden, cada renglón se parte en dos y el precio queda en la línea de abajo.
No hay que deducirlo: el ticket de prueba del panel imprime al final una regla de calibración:
ANCHO DEL TICKET
La ultima linea que NO se parta
es el ancho de esta impresora:
32 -----------------------------
42 ---------------------------------------
48 ---------------------------------------------
56 -----------------------------------------------------
64 -------------------------------------------------------------
- Mire cuál es la última línea que sale completa en un solo renglón.
- Ese número es el ancho de la impresora: guárdelo en la ficha de la impresora en el panel (ancho en caracteres).
- Vuelva a imprimir una prueba y un ticket de venta real para confirmar que los precios quedan alineados a la derecha.
Referencia (no la asuma, mida): rollo de 80 mm → 48 columnas normalmente; rollo de 58 mm → 32.
9. Problemas comunes
🔴 El log dice Invalid share name
Causa: el nombre en el panel tiene acentos, ñ, paréntesis u otros símbolos.
Solución: renombre la impresora y el recurso compartido según la sección 3, y actualice el panel.
🔴 El log dice Share Printer Error / "No se encuentra el nombre de red"
Causa: la impresora no está compartida, o el nombre del panel no coincide con el nombre del recurso compartido.
Solución: revise con Get-Printer (sección 4.3) que Shared sea True y que ShareName sea idéntico al del panel.
🔴 El log dice "Data sent to share" pero no sale nada
Causa: impresora apagada, sin papel, en otro puerto USB, o la cola de Windows trabada.
Solución: abra la cola (control printers → doble clic en la impresora). Si hay trabajos detenidos, cancélelos, revise la impresora y vuelva a probar con la sección 6.
🔴 Funcionaba y dejó de imprimir después de mover el cable
Causa: se conectó en otro puerto USB y Windows creó un puerto virtual nuevo (USB002); la impresora sigue apuntando al anterior.
Solución: regrese el cable al puerto marcado, o en Propiedades de impresora → Puertos marque el USB00x nuevo.
🔴 Aparece una impresora "(Copia 1)"
Causa: Windows reinstaló la impresora al reconectarla.
Solución: elimine la copia y deje solo la compartida con el nombre correcto.
🔴 Los renglones se parten y el precio queda abajo
Causa: el ancho configurado es mayor al que cabe con ese driver.
Solución: calibre el ancho con la regla del ticket de prueba (sección 8).
🔴 Imprime caracteres raros, hojas en blanco o texto sin corte
Causa: la impresora quedó con un driver que convierte el trabajo en imagen o texto (por ejemplo el del fabricante en modo gráfico) en lugar de pasarlo en crudo.
Solución: cambie el driver a Generic / Text Only (sección 4.2). Si con ese driver persisten acentos raros, reporte a desarrollo con el modelo exacto; el codificado es PC850.
🔴 El panel no ofrece la conexión USB, o no lista la impresora
Causa: el cliente es anterior a 2.11.0, o no se reinició después de instalar la impresora.
Solución: actualice el cliente y reinícielo (sección 7, paso 1).
🔴 Imprime dos veces el mismo ticket, o se mezclan tickets
Causa: otro sistema (el punto de venta anterior) sigue imprimiendo a la misma impresora, o hay dos PCs de la sucursal con el cliente de impresión abierto.
Solución: deje un solo sistema imprimiendo y un solo cliente de Idoo por sucursal.
🔴 Deja de imprimir cuando la PC lleva rato sin usarse
Causa: suspensión de la PC o ahorro de energía del USB.
Solución: configure la PC para no suspenderse en el plan de energía y desactive la suspensión selectiva de USB.
🔴 Ícono de bandeja en rojo
Causa: la PC no tiene internet o el token es inválido. No tiene que ver con la impresora.
Solución: verifique el internet primero (ping idoo.restaurant), luego los logs.
Anexo: Hoja de registro por sucursal
Llenar al terminar la instalación y archivar junto al expediente de la sucursal.
[spoiler]
Sucursal: ______________________________ Fecha: ______________
Instaló: ______________________________
PC
Sistema operativo: [ ] Windows [ ] Linux
Versión del cliente: ______________ (2.11.0 o superior)
Suspensión desactivada: [ ] Sí
IMPRESORAS USB
# | Ubicación | Modelo | Nombre compartido | Puerto | Ancho | Prueba
1 | ___________ | _____________ | _________________ | USB00__ | _____ | [ ] OK
2 | ___________ | _____________ | _________________ | USB00__ | _____ | [ ] OK
VERIFICACIÓN FINAL
[ ] Ícono de bandeja en verde
[ ] Ticket de prueba impreso desde el panel Idoo en cada impresora (papel visto)
[ ] Regla de ancho leída y guardada en el panel
[ ] Ticket de venta real con precios alineados
[ ] Reinicio de PC: el cliente arranca solo, reconecta e imprime
[ ] Ningún otro sistema imprimiendo a las mismas impresoras
[/spoiler]
¿Encontraste un modelo que se comporta distinto, o un caso que esta guía no cubre? Respóndelo en este hilo para irlo documentando.
