QZ tray compatibility issue
11 views
Skip to first unread message
Maranga Vincent James
Jul 6, 2025, 11:06:12 PMJul 6
to qz-print
Good day, I have a question regarding about qz tray's compatibility. These are the facts:
1. I am using a receipt printer and the app QzTray to handle printing connections from my app to my printer.
1. I am using a receipt printer and the app QzTray to handle printing connections from my app to my printer.
2. But by using the standard formatting by qz tray which is the HTML format, the printing is slow. Thus, I am using a native approach which is to create the printing commands manually to make the printing faster.
3. However, sometimes this causes an issue. When I print, it only prints upto the header and it will not proceed anymore. I already encountered this with my 2 printers and it would not continue. It led me to buy new printers instead and it works fine with my new printers. The model of the printers are the same: `Epson TM-U220 Receipt`.
4. If I print using microsoft word, it works. But using qz tray, it wont. What would be the issue? How can I solve it?
This is an example of my native printing code:
This is an example of my native printing code:
import {
formatDate,
formatInPeso,
formatTime,
formatDateTime,
} from '../../../utils';
import { PESO_SIGN, EMPTY_CELL } from '../../helper-receipt';
import { printCenter } from '../../helper-escpos';
import { EscPosCommands } from '../../utils/escpos.enum';
import {
generateItemBlockCommands,
generateReceiptFooterCommands,
generateReceiptHeaderCommands,
} from '../../helper-escpos';
import { PrintZReadReport } from './types';
import dayjs from 'dayjs';
export const printZReadReportNative = ({
report,
siteSettings,
user,
}: PrintZReadReport) => [
...generateZReadContentCommands(report, siteSettings, user),
EscPosCommands.LINE_BREAK,
EscPosCommands.LINE_BREAK,
EscPosCommands.LINE_BREAK,
EscPosCommands.LINE_BREAK,
EscPosCommands.LINE_BREAK,
EscPosCommands.LINE_BREAK,
];
const generateZReadContentCommands = (
report: PrintZReadReport['report'],
siteSettings: PrintZReadReport['siteSettings'],
user: PrintZReadReport['user'],
): string[] => {
const commands: string[] = [];
commands.push(
...generateReceiptHeaderCommands({
branchMachine: report.branch_machine,
title: 'Z-READING REPORT',
}),
EscPosCommands.LINE_BREAK,
);
if (report.generation_datetime) {
commands.push(printCenter('Report Generation Datetime'));
commands.push(EscPosCommands.LINE_BREAK);
commands.push(
printCenter(
`${formatDate(report.generation_datetime)} - ${formatTime(report.generation_datetime)}`,
),
);
commands.push(EscPosCommands.LINE_BREAK);
}
commands.push(printCenter('Day Datetime'));
commands.push(EscPosCommands.LINE_BREAK);
const openTime = report.branch_day_open_datetime
? formatTime(report.branch_day_open_datetime)
: null;
const closeTime = report.generation_datetime
? formatTime(report.generation_datetime)
: null;
const openDate = report.branch_day_open_datetime
? formatDate(report.branch_day_open_datetime)
: EMPTY_CELL;
const timeRange = [openTime, closeTime].filter(Boolean).join(' - ');
commands.push(printCenter(`${openDate} | ${timeRange}`));
commands.push(EscPosCommands.LINE_BREAK);
commands.push(EscPosCommands.LINE_BREAK);
commands.push(
...generateItemBlockCommands([
{
label: 'Beg Sales Invoice #:',
value: report.beginning_or?.or_number || EMPTY_CELL,
},
{
label: 'End Sales Invoice #:',
value: report.ending_or?.or_number || EMPTY_CELL,
},
{
label: 'Beg Void #:',
value: report.ending_void_or?.or_number || EMPTY_CELL,
},
{
label: 'End Void #:',
value: report.ending_void_or?.or_number || EMPTY_CELL,
},
{ label: 'Beg Return #:', value: EMPTY_CELL },
{ label: 'End Return #:', value: EMPTY_CELL },
]),
);
commands.push(EscPosCommands.LINE_BREAK);
commands.push(
...generateItemBlockCommands([
{ label: 'Reset Counter No.:', value: report.reset_counter },
{
label: 'Z Counter No.:',
value: report.gross_sales === 0 ? EMPTY_CELL : report.z_counter,
},
]),
);
commands.push(printCenter('----------------'));
commands.push(EscPosCommands.LINE_BREAK);
commands.push(
...generateItemBlockCommands([
{
label: '+Current Accum. Sales (end)',
value: formatInPeso(report.ending_sales, PESO_SIGN),
},
{
label: '-Previous Accum. Sales (beg)',
value: formatInPeso(report.beginning_sales, PESO_SIGN),
},
{
label: '=Gross Sales of the Day',
value: formatInPeso(report.current_day_gross_sales, PESO_SIGN),
},
]),
);
commands.push(printCenter('----------------'));
commands.push(EscPosCommands.LINE_BREAK);
commands.push(
...generateItemBlockCommands([
{
label: '+Gross Sales of the Day',
value: formatInPeso(report.current_day_gross_sales, PESO_SIGN),
},
{
label: '-Deductions',
value: formatInPeso(report.current_day_deductions, PESO_SIGN),
},
{
label: '-VAT Amount',
value: formatInPeso(report.current_day_vat_deductions, PESO_SIGN),
},
{
label: '=Net Amount',
value: formatInPeso(report.current_day_net_sales, PESO_SIGN),
},
]),
);
commands.push(printCenter('----------------'));
commands.push(EscPosCommands.LINE_BREAK);
commands.push(printCenter('Current Day Payment Received'));
commands.push(EscPosCommands.LINE_BREAK);
commands.push(
...generateItemBlockCommands([
{ label: '+Cash', value: formatInPeso(report.cash_payment, PESO_SIGN) },
{ label: '+Check', value: formatInPeso(report.check_payment, PESO_SIGN) },
{
label: '+Credit Card',
value: formatInPeso(report.credit_card_payment, PESO_SIGN),
},
{
label: '=Total',
value: formatInPeso(report.total_payment_received, PESO_SIGN),
},
]),
);
commands.push(printCenter('----------------'));
commands.push(EscPosCommands.LINE_BREAK);
commands.push(printCenter('Current Day Cash on Hand'));
commands.push(EscPosCommands.LINE_BREAK);
commands.push(
...generateItemBlockCommands([
{
label: '+Payment Received',
value: formatInPeso(report.total_payment_received, PESO_SIGN),
},
{
label: '+Opening fund',
value: formatInPeso(report.opening_fund, PESO_SIGN),
},
{ label: '+Cash In', value: formatInPeso(report.cash_in, PESO_SIGN) },
{ label: '-Cash Out', value: formatInPeso(report.cash_out, PESO_SIGN) },
{
label: '-Cash Collection',
value: formatInPeso(report.cash_collection, PESO_SIGN),
},
{
label: '=Total',
value: formatInPeso(report.total_cash_on_hand, PESO_SIGN),
},
]),
);
commands.push(printCenter('----------------'));
commands.push(EscPosCommands.LINE_BREAK);
commands.push(printCenter('Current Day Transaction Summary'));
commands.push(EscPosCommands.LINE_BREAK);
commands.push(
...generateItemBlockCommands([
{
label: '+Cash in Drawer',
value: formatInPeso(report.cash_in_drawer, PESO_SIGN),
},
{
label: '-Cash on Hand',
value: formatInPeso(report.total_cash_on_hand, PESO_SIGN),
},
{
label: '=(Short)/Over',
value:
(report.short_over < 0 ? '(' : '') +
formatInPeso(Math.abs(report.short_over), PESO_SIGN) +
(report.short_over < 0 ? ')' : ''),
},
]),
);
commands.push(printCenter('----------------'));
commands.push(EscPosCommands.LINE_BREAK);
commands.push(printCenter('Accumulated Sales Breakdown'));
commands.push(EscPosCommands.LINE_BREAK);
commands.push(
...generateItemBlockCommands([
{
label: 'VAT Exempt Sales',
value: formatInPeso(report.vat_exempt, PESO_SIGN),
},
{
label: 'VATable Sales',
value: formatInPeso(report.vat_sales, PESO_SIGN),
},
{
label: 'VAT Amount (12%)',
value: formatInPeso(report.vat_amount, PESO_SIGN),
},
{ label: 'Zero Rated Sales', value: formatInPeso(0, PESO_SIGN) },
]),
);
commands.push(printCenter('----------------'));
commands.push(EscPosCommands.LINE_BREAK);
commands.push(printCenter('Accumulated Deductions'));
commands.push(EscPosCommands.LINE_BREAK);
commands.push(
...generateItemBlockCommands([
{
label: '+Disc. SC',
value: formatInPeso(report.sc_discount, PESO_SIGN),
},
{
label: '+Disc. PWD',
value: formatInPeso(report.pwd_discount, PESO_SIGN),
},
{
label: '+Disc. NAAC',
value: formatInPeso(report.naac_discount, PESO_SIGN),
},
{
label: '+Disc. Solo Parent',
value: formatInPeso(report.sp_discount, PESO_SIGN),
},
{
label: '+Disc. Others',
value: formatInPeso(report.others_discount, PESO_SIGN),
},
{ label: '+Return', value: formatInPeso(0, PESO_SIGN) },
{ label: '+Void', value: formatInPeso(report.void, PESO_SIGN) },
{
label: '=Total',
value: formatInPeso(report.total_deductions, PESO_SIGN),
},
]),
);
commands.push(printCenter('----------------'));
commands.push(EscPosCommands.LINE_BREAK);
commands.push(printCenter('Accumulated VAT Adjustment'));
commands.push(EscPosCommands.LINE_BREAK);
commands.push(
...generateItemBlockCommands([
{
label: '+Disc. SC',
value: formatInPeso(report.vat_sc_discount, PESO_SIGN),
},
{
label: '+Disc. PWD',
value: formatInPeso(report.vat_pwd_discount, PESO_SIGN),
},
{
label: '+Disc. Others',
value: formatInPeso(report.vat_others_discount, PESO_SIGN),
},
{ label: '+VAT on Returns', value: formatInPeso(0, PESO_SIGN) },
{ label: '+Others', value: formatInPeso(report.vat_others, PESO_SIGN) },
{
label: '=Total',
value: formatInPeso(report.total_vat_adjusted, PESO_SIGN),
},
]),
);
commands.push(printCenter('----------------'));
commands.push(EscPosCommands.LINE_BREAK);
commands.push(printCenter('Accumulated VAT Payable'));
commands.push(EscPosCommands.LINE_BREAK);
commands.push(
...generateItemBlockCommands([
{
label: '+VAT Amount (12%)',
value: formatInPeso(report.vat_amount, PESO_SIGN),
},
{
label: '-VAT Adjustment',
value: formatInPeso(report.total_vat_adjusted, PESO_SIGN),
},
{ label: '=Total', value: formatInPeso(report.vat_payable, PESO_SIGN) },
]),
);
commands.push(EscPosCommands.LINE_BREAK);
if (user) {
commands.push(
printCenter(
`Print Details: ${formatDateTime(dayjs(), false)} ${user.employee_id}`,
),
);
commands.push(EscPosCommands.LINE_BREAK);
commands.push(EscPosCommands.LINE_BREAK);
}
commands.push(...generateReceiptFooterCommands(siteSettings));
commands.push(
printCenter('This Document Is Not Valid For Claim Of Input Tax'),
);
commands.push(EscPosCommands.LINE_BREAK);
commands.push(printCenter('Thank You!'));
commands.push(EscPosCommands.LINE_BREAK);
return commands;
};
Tres Finocchiaro
Jul 7, 2025, 10:11:44 AMJul 7
to Maranga Vincent James, qz-print
Hi,
The code example doesn't appear to use QZ Tray at all (but rather a bunch of ESCPOS helper libraries which we did not author).
With regards to the mixed results (e.g. "works" on new printers, "does not work" on old printers) this is hard to say with the information provided, but is best isolated by sending the commands manually until your print succeeds.
This "manual" technique is what we use in our example here: https://qz.io/docs/raw#escpos. This will help determine if your issue is isolated to a particular library or command that you're sending and then adjust accordingly as to be compatible with the old and new printers.
In our experience, most ESCPOS commands are universal and work with all printers, however some commands will vary. Epson provided documentation on each command here: https://download4.epson.biz/sec_pubs/pos/reference_en/escpos/index.html
-Tres
--
You received this message because you are subscribed to the Google Groups "qz-print" group.
To unsubscribe from this group and stop receiving emails from it, send an email to qz-print+u...@googlegroups.com.
To view this discussion visit https://groups.google.com/d/msgid/qz-print/cb5a8c78-04ab-481f-a5b3-4c3826308b70n%40googlegroups.com.
Reply all
Reply to author
Forward
0 new messages