El Print Bridge es una aplicación pequeña de escritorio (Windows / macOS / Linux) que se instala una sola vez por equipo y se encarga de toda la impresión que hace Axentra: recibos térmicos del POS, tickets de cocina del restaurante, conduces, reportes financieros en formato carta, etiquetas. El sistema no usa el diálogo de impresión del navegador; va siempre por el Print Bridge.
El navegador no fue diseñado para imprimir recibos térmicos. window.print() abre un diálogo, no controla la guillotina ni la gaveta y produce salidas distintas en cada PC. Las alternativas comerciales (QZ Tray) cobran licencia por equipo. El Print Bridge es la pieza pequeña, gratuita y oficial de Axentra que resuelve estas tres cosas:
Descargue el binario desde axentra.com.do/descargas:
| Sistema | Archivo recomendado |
|---|---|
| Windows | Setup .exe x64 |
| macOS Apple Silicon (M1/M2/M3) | binario arm64 |
| macOS Intel | binario amd64 |
| Linux | x86_64 (asume CUPS instalado) |
Una vez instalado:
~/Library/LaunchAgents/.systemd --user.No se requiere abrir puertos en el firewall: el Print Bridge solo escucha en 127.0.0.1:4000 (loopback). No expone nada a internet.
Dos endpoints HTTP:
| Endpoint | Para qué |
|---|---|
POST /print/image |
Recibos térmicos (raster monoespaciado de 576px), tickets de cocina, conduces térmicos |
POST /print/document |
Reportes en formato carta con tabla multi-columna que no caben en 80mm |
Las páginas de Axentra construyen la imagen del recibo del lado del cliente con un canvas builder por formato y la envían al endpoint correspondiente. El Print Bridge entonces:
/print/image: envía secuencias ESC/POS al spooler con corte automático y kick de gaveta/print/document: convierte a PDF y envía al spooler como hoja carta normal127.0.0.1:4000. No acepta conexiones desde la red local ni desde internet.axentra.com.do o el subdominio de su instancia (acme.axentra.com.do) pueden enviarle trabajos. El Print Bridge verifica el header Origin en cada request."Print Bridge no detectado". El servicio no está corriendo. En Windows abra Servicios y reinicie "Axentra Print Bridge". En macOS / Linux: launchctl load ~/Library/LaunchAgents/com.axentra.printbridge.plist o systemctl --user restart axentra-print-bridge.
"Conflicto de puerto: 4000 en uso". Otra aplicación tiene tomado el puerto 4000. Cierre la otra aplicación o reinicie el equipo.
Recibo sale en blanco / corta a la mitad. El navegador está cacheando un canvas viejo. Refresque la página con Cmd/Ctrl+Shift+R.
Gaveta no abre. El driver de la impresora no está mapeando el comando de kick. Asegúrese de usar el driver del fabricante (no el genérico de Windows). Para Epson use el driver "Epson Receipt Printer"; para Star, el "Star Line Mode".
Recibo sale en formato carta cuando debería ser térmico. Confirme que el formato configurado es "Ticket 80mm" en el selector de impresora del POS. La selección se guarda en localStorage por equipo, no por usuario.
El Print Bridge se versiona independiente del ERP. Para actualizar:
La versión actual instalada se ve en el menú del agente (icono en la barra de tareas / menú bar de macOS).