Epson Printer Integration Guide

This POS system integrates with Epson thermal receipt printers via the ePOS SDK.

Architecture

Files

• resources/js/epos-2.20.0.js - Epson ePOS SDK library (253KB)
• resources/js/store/modules/printing.js - Vuex module for print management
• resources/js/store/modules/epos.js - Device connection management
• resources/js/printing.js - Legacy printing utilities

Connection Details

• IP Address: 192.168.200.80
• Port: 8008
• Protocol: ePOS Device Service

Vuex Store Structure

State

javascript
1state: {
2    ePosDev: null,           // ePOS device instance
3    printer: null,           // Printer object
4    printingNotification: false,
5    printingAttempts: 0,
6    printing: {
7        order: null,         // Current order being printed
8        invoice: null,       // Current invoice being printed
9    },
10    printingHistory: []
11}

Key Actions

javascript
1// Connect to printer
2this.$store.dispatch('setEpsonDevice')
3
4// Print an order (kitchen ticket)
5this.$store.dispatch('setPrintingOrder', order)
6
7// Print an invoice (receipt)
8this.$store.dispatch('setPrintingInvoice', invoice)

Connection Flow

javascript
1// In printing.js store module
2
3setEpsonDevice({ commit, state }) {
4    const ePosDev = new epson.ePOSDevice();
5
6    ePosDev.connect('192.168.200.80', 8008, (result) => {
7        if (result === 'OK' || result === 'SSL_CONNECT_OK') {
8            ePosDev.createDevice('local_printer',
9                ePosDev.DEVICE_TYPE_PRINTER,
10                { crypto: false, buffer: false },
11                (printer, code) => {
12                    if (code === 'OK') {
13                        printer.timeout = 60000;
14                        commit('setEpsonDevice', { ePosDev, printer });
15                    }
16                }
17            );
18        }
19    });
20}

Receipt Formatting

Order Ticket (Kitchen)

javascript
1// Header
2printer.addTextAlign(printer.ALIGN_CENTER);
3printer.addTextSize(1, 2);
4printer.addTextStyle(false, false, true, printer.COLOR_1);
5printer.addText('TABLE NAME\n\n');
6
7// Time
8printer.addTextSize(1, 1);
9printer.addText(` Vreme: ${time}\n`);
10
11// Items
12printer.addTextSize(1, 2);
13printer.addText(' —————————————————\n');
14items.forEach(item => {
15    printer.addText(` ${item.qty} x ${item.name}\n`);
16});
17
18// Cut
19printer.addFeedLine(1);
20printer.addCut(printer.CUT_FEED);

Invoice Receipt

javascript
1// Header
2printer.addText('PREDRAČUN\n');  // "Bill" in Serbian
3
4// Items with prices
5items.forEach(item => {
6    printer.addText(formatLine(item.name, item.total));
7});
8
9// Totals
10printer.addText('—————————————————\n');
11printer.addText(formatLine('UKUPNO:', total));
12printer.addText(formatLine('PDV (20%):', tax));
13
14// Receipt number
15printer.addText(`\nBroj: ${receiptNumber}\n`);
16
17// Cut
18printer.addCut(printer.CUT_FEED);

Helper Functions

javascript
1// Right-align text with spacing
2function printerTextBetween(left, right, width = 48) {
3    const spaces = width - left.length - right.length;
4    return left + ' '.repeat(spaces) + right;
5}
6
7// Format price
8function formatPrice(price) {
9    return new Intl.NumberFormat('de-DE').format(price);
10}

Error Handling

javascript
1// Sentry integration for error tracking
2import * as Sentry from '@sentry/vue';
3
4printer.onreceive = (response) => {
5    if (!response.success) {
6        Sentry.captureException(new Error('Print failed'));
7        commit('setPrintingNotification', true);
8    }
9};
10
11// Retry logic
12if (state.printingAttempts < 3) {
13    commit('incrementPrintingAttempts');
14    dispatch('setEpsonDevice');
15}

Printer Commands Reference

javascript
1// Text formatting
2printer.addTextAlign(printer.ALIGN_LEFT | ALIGN_CENTER | ALIGN_RIGHT);
3printer.addTextSize(width, height);  // 1-8 each
4printer.addTextStyle(reverse, underline, bold, color);
5
6// Line spacing
7printer.addTextLineSpace(pixels);  // Default ~30
8printer.addFeedLine(lines);
9
10// Paper cutting
11printer.addCut(printer.CUT_FEED);     // Feed then cut
12printer.addCut(printer.CUT_NO_FEED);  // Cut without feed
13
14// Send to printer
15printer.send();

Troubleshooting

1. Printer not connecting: Check IP/port, ensure printer is on network
2. Print jobs stuck: Call disconnect() and reconnect
3. Garbled text: Ensure UTF-8 encoding for Serbian characters
4. Slow printing: Check buffer: false setting

Real-time Notifications

The printing module shows a notification when:

• Print job is in progress
• Print job fails (with retry option)
• Timeout after 30 seconds