2.5 KiB
2.5 KiB
Printer Central (Epson ePOS)
Resumen
- Backend Node.js que envía comandos ePOS-Print vía SOAP a una impresora Epson configurada en HTTPS con certificado autofirmado.
- Frontend Vue 3 (Vite) con glassmorphism en escala de grises para escribir texto y activar funciones: alineación, fuente, tamaño, estilos, feed, corte, cajón, QR y código de barras. También permite componer un lote de operaciones genéricas.
Requisitos
- Node.js 18+ (probado con v22) y npm.
Instalación y ejecución
-
Instalar dependencias: npm install
-
Configurar destino (opcional, valores por defecto entre paréntesis): export PRINTER_HOST=192.168.87.147 # IP/DNS de la impresora export PRINTER_DEVICE_ID=matricial2 # DeviceId export PRINTER_TIMEOUT_MS=60000 # Timeout ePOS
-
Desarrollo con hot reload (cliente + servidor): npm run dev
- Frontend (Vite + Vue 3) en http://localhost:5173
- Proxy /api → http://localhost:3030 (Express)
- El servidor se recarga con nodemon al cambiar archivos en src/
-
Producción (build del cliente + servidor Express): npm run build # genera assets en public/ npm start # sirve API y estáticos desde public/ (por defecto en :3030)
API principal
- POST /api/print Body JSON: { operations: [ { op: string, ...attrs }, ... ] } Construye el cuerpo de según las operaciones y lo envía dentro de un sobre SOAP a: https://PRINTER_HOST/cgi-bin/epos/service.cgi?devid=PRINTER_DEVICE_ID&timeout=PRINTER_TIMEOUT_MS
Operaciones soportadas (clave op)
- text { value }
- textLang { lang }
- textAlign { align: left|center|right }
- textRotate { rotate: boolean }
- textLineSpace { linespc }
- textFont { font: font_a|font_b|... }
- textSmooth { smooth: boolean }
- textDouble { dw: boolean, dh: boolean }
- textSize { width: 1..8, height: 1..8 }
- textStyle { reverse?: boolean, ul?: boolean, em?: boolean, color?: color_1..color_4 }
- textPosition { x }
- textVPosition { y }
- feed {}
- feedUnit { unit }
- feedLine { line }
- feedPosition { pos }
- cut { type: no_feed|feed|reserve|no_feed_fullcut|feed_fullcut|reserve_fullcut }
- pulse { drawer?: drawer_1|drawer_2, time?: pulse_100|...|pulse_500 }
- barcode { data, type, hri, font, width, height }
- qrcode { data, model, level, size }
Notas
- El backend desactiva la verificación TLS (self-signed) únicamente para la conexión con la impresora.
- Si necesitas más funciones (logo/imágenes, páginas, líneas, etc.), se pueden añadir fácilmente replicando los métodos del ePOSBuilder oficial.