Los recibos se imprimen con el diálogo del navegador o en silencio con PrintNode: conecta PrintNode desde Configuración, asigna computadora, impresoras y báscula por tienda y por caja, y el punto de venta imprime recibos y etiquetas y abre el cajón automáticamente.

PHP Point Of Sale imprime de dos maneras. De entrada, los recibos pasan por el diálogo de impresión del navegador — nada que instalar, funciona en cualquier dispositivo. Con PrintNode conectado, la impresión se vuelve silenciosa: el recibo va directo a la impresora correcta, el cajón de dinero se abre solo y el diálogo del navegador desaparece del flujo por completo.

La mayoría de las tiendas empieza con impresión por navegador y agrega PrintNode cuando quiere un cobro más rápido. Ambos caminos imprimen los mismos recibos — lo que dice el recibo se explica en personalizar recibos.

Elegir una impresora

La impresora de recibos recomendada es la serie Star TSP100 (como la TSP143 ECO) con Chrome o Firefox; otros clientes han tenido éxito con impresoras térmicas de Epson y similares. Si compras otra, busca una que imprima en papel de 72 mm o más de ancho. La impresora de etiquetas recomendada es la Zebra LP 2824 Plus / ZD410 con etiquetas de 2 × 1 — la impresión de etiquetas se cubre en códigos de barras y etiquetas. La página de hardware y la tienda de hardware listan el equipo probado.

Si agregas un logotipo a los recibos, usa una imagen de 255 × 90 píxeles — en blanco y negro se ve mejor en papel térmico.

Impresión por navegador

Sin configuración extra, al terminar una venta el recibo se genera y pasa al diálogo de impresión del navegador. Dos ajustes de Configuración → Recibo moldean el flujo:

• ¿Desea imprimir el recibo después de una venta? — envía el recibo a imprimir automáticamente al completar la venta.
• Formato de recibo para impresora ancha — un diseño más ancho para impresoras de página completa cuando el recibo angosto queda apretado.

Preparación única del navegador para una impresora térmica (Windows)

1. Instala el driver de la impresora — para la Star TSP100, descarga TSP100 futurePRNT del sitio de soporte de Star Micronics y sigue el asistente.
2. Define el tamaño de papel: Panel de control → Impresoras → clic derecho en la impresora → Propiedades de impresora → Configuración de dispositivo, y en la asignación de formularios elige 72mm x Receipt.
3. En el diálogo de impresión del navegador, pon todos los márgenes en 0 y los encabezados y pies en blanco (Firefox: menú → Imprimir → Configurar página → Márgenes y encabezado/pie; Chrome: abre Más ajustes en el diálogo). Desmarca la impresión de imágenes de fondo.
4. Para cortar entre copias al imprimir duplicados, pon Page Cut Type en Partial Cut en la misma pestaña de configuración del dispositivo.

Imprimir sin diálogo (modo quiosco)

• Firefox — escribe about:config en la barra de direcciones, crea una preferencia booleana nueva llamada print.always_print_silent, ponla en true y reinicia Firefox. Con imprimir el recibo después de una venta activo, los recibos salen sin un solo clic.
• Chrome — edita el acceso directo de Chrome y agrega --kiosk --kiosk-printing al final del campo Destino. Chrome abre a pantalla completa e imprime al instante en la impresora predeterminada (la vista previa de impresión debe seguir habilitada).

Configuración en Mac

Descarga el driver CUPS de tu impresora desde el fabricante (Star publica uno para la TSP100), ejecuta el paquete instalador (pide la contraseña de administrador de la Mac) y agrega la impresora en Ajustes del Sistema → Impresoras y escáneres con el botón +. Para una impresora de red/inalámbrica necesitas su dirección IP: apágala, mantén presionado el botón de avance de papel mientras la enciendes y suéltalo — imprime dos páginas de prueba, y la segunda muestra "Current IP Parameters Status" con la dirección.

iOS y Android

La app móvil de PHP Point Of Sale imprime en impresoras de recibos de red (por ejemplo una Star TSP100 LAN): conecta la impresora al router, pon el teléfono o tableta en la misma red, toca el botón de imprimir en un recibo y elige la impresora en el diálogo.

Configurar PrintNode

PrintNode es el servicio de impresión silenciosa y es una función de plan, así que verifica que tu plan lo incluya. Todo vive en Configuración → Nodo de impresión (PrintNode):

1. Haz clic en Configurar PrintNode — PHP Point Of Sale crea una cuenta administrada de PrintNode para tu tienda; no hay alta aparte ni claves API que buscar.
2. Haz clic en Descargar aplicación e instala el cliente de PrintNode en la computadora a la que está conectada físicamente la impresora. Corre en segundo plano y expone las impresoras (y básculas) de esa computadora.
3. Asigna el hardware por tienda y por caja (siguiente sección).

La misma pantalla ofrece:

• Actualizar perfil / Eliminar cuenta — administra la cuenta gestionada de PrintNode.
• Ajustes de caché — un interruptor y un tiempo de expiración (300 segundos predeterminado) que reducen las consultas de tu lista de impresoras.
• Historial de trabajos de impresión con una página de registros — la bitácora de cada trabajo enviado, para que cuando alguien diga "nunca imprimió" veas si el trabajo salió y qué reportó PrintNode.

Asignar hardware por tienda y por caja

Con PrintNode conectado, el formulario de cada tienda (Tiendas → editar → pestaña PrintNode, sección Configuración de hardware) asigna los valores predeterminados:

• Seleccionar computadora — la computadora con PrintNode que atiende a esta tienda.
• Impresora de recibos — con su botón de Impresión de prueba.
• Ancho de la impresora de recibos — el formato del recibo: Recibo (80 × 297 mm) para papel térmico estándar, Página completa (A4 / Carta) para impresoras de oficina, o Ticket (54 × 28 mm) para papel de boletos.
• Seleccionar impresora de etiquetas — para que las etiquetas de códigos de barras salgan en el dispositivo correcto, con su propia Impresión de prueba.
• Seleccionar báscula y Tipo de peso (KG / LB / OZ) con botón de prueba de báscula — PrintNode también lee el peso de una báscula digital conectada, explicado en básculas, escáneres y pantallas para clientes.

Cada fila de caja en la pestaña Registros y terminales tiene después un botón de configuración de PrintNode que abre un diálogo por caja con tres pestañas — por computadora (elige computadora, impresora de recibos, impresora de etiquetas y báscula de ese carril), todas las impresoras (cada impresora de la cuenta con insignia En línea/Sin conexión y control de asignación) y todas las básculas. Como las asignaciones son por caja, una tienda de dos carriles puede dar a cada carril su impresora y cajón mientras comparte una impresora de etiquetas en la trastienda. Ver tiendas y cajas.

Cajones de dinero

Los cajones de apertura automática se conectan a través de la impresora de recibos — un cajón estilo APG Vasario con cable RJ12 (parece cable telefónico) se enchufa al puerto de cajón de la impresora, y el cajón se abre cuando se imprime un recibo.

Configuración única del driver en Windows para una impresora Star:

1. Panel de control → Dispositivos e impresoras → clic derecho en la impresora → Propiedades de impresora → Configuración de dispositivo.
2. Pon Peripheral Unit Type en Cash Drawer.
3. Pon el pulse width (ancho de pulso) en 200 ms y Peripheral Unit 1 en Document Top.

En Mac, abre la administración de CUPS en el navegador en localhost:631/printers/ (si CUPS dice que su interfaz web está desactivada, ejecuta primero en Terminal el comando que muestra), selecciona la impresora, elige Set Default Options y define ahí las opciones de control del cajón.

Abrir el cajón sin una venta: el menú de tres puntos de la caja tiene Abrir la caja (abrir el cajón). Con PrintNode conectado envía el comando de apertura directo a la impresora — sin papel y sin diálogo; sin PrintNode abre una página mínima cuya impresión dispara la apertura gastando muy poco papel. En ambos casos la acción está protegida por la acción de permiso de Ventas Añadir Eliminar importes de la caja registradora, así que solo los empleados autorizados pueden abrirlo. El conteo del cajón y el cierre están en cajas y manejo de efectivo.

Copias y duplicados

• Imprima automáticamente un recibo duplicado para las transacciones con tarjeta de crédito (Configuración → Recibo) — imprime la copia del comercio en ventas con tarjeta, para requisitos de voucher firmado.
• La opción de duplicado para todas las transacciones (Configuración → Recibo) duplica todo.

Solución de problemas

Los recibos dejaron de imprimirse en silencio. Verifica que el cliente de PrintNode esté corriendo en la computadora asignada (la pestaña de todas las impresoras del diálogo por caja muestra En línea/Sin conexión) y revisa el Historial de trabajos de impresión en Configuración → PrintNode para ver si los trabajos salen y qué pasó con ellos.

El diálogo de impresión aparece en cada venta. Eso es la impresión por navegador normal. Configura el modo quiosco (Firefox print.always_print_silent, o el acceso directo de Chrome con --kiosk --kiosk-printing) o conecta PrintNode para impresión realmente silenciosa.

El recibo sale diminuto o con márgenes enormes. Define el tamaño de papel 72mm x Receipt en el driver, pon los márgenes del navegador en cero y deja en blanco encabezados y pies. Con PrintNode, revisa que el Ancho de la impresora de recibos de la tienda coincida con tu papel.

El cajón no abre. El cajón solo se abre cuando la impresora se lo ordena: revisa que el cable RJ12 esté en el puerto de cajón de la impresora y, en Windows, confirma Peripheral Unit Type = Cash Drawer en el driver. Con PrintNode, usa Abrir la caja desde el menú de la caja para probar la apertura sin una venta.

¿Cada caja puede tener su propia impresora? Sí — haz clic en el botón de configuración de PrintNode en la fila de la caja en Registros y terminales y asigna la computadora, impresora de recibos, impresora de etiquetas y báscula de ese carril.

¿PrintNode funciona desde tabletas y teléfonos? Sí — ese es su mejor truco. El navegador de cualquier dispositivo envía el trabajo a la computadora con PrintNode, que lo imprime, así que una caja en iPad imprime en la térmica del mostrador sin diálogo.

¿Quién puede abrir el cajón sin una venta? Los empleados con la acción de permiso de Ventas Añadir Eliminar importes de la caja registradora. Los demás no ven la opción del menú.