Print and Printer Setup

The Print screen handles price tags, labels, receipts, consignor reports, settlement statements, and other printable documents. Resell4.me uses QZ Tray to send labels and thermal receipts directly from the browser to printers installed in Windows.

What You Can Print

Before Moving from BCSS to Resell4.me

Printer preparation is part of the workstation conversion. Complete it after loading the labels the shop will use with Resell4.me and before troubleshooting or changing Resell4.me print code.

  1. Install the printer manufacturer's current Windows driver.
  2. Connect the printer and confirm that Windows creates one working printer queue.
  3. Remove or clearly identify obsolete duplicate queues such as Printer Name (Copy 1) so the wrong queue is not selected.
  4. Load the intended receipt paper or label stock.
  5. For a thermal label printer, select the correct media sensor type:

- Gap for die-cut labels separated by gaps.
- Black mark for stock with registration marks.
- Continuous only for continuous media.

  1. Calibrate the printer's gap/black-mark media sensor using the printer manufacturer's procedure. Recalibrate whenever the label stock or dimensions change.
  2. Press the printer's physical Feed button several times. Each press should advance exactly one label and leave the printer in its ready state.
  3. Print a Windows test page through the exact queue that will be selected in Resell4.me.

Calibration is not an application setting. A printer can accept a successful job from Resell4.me, QZ Tray, and Windows but still produce nothing or behave intermittently when its media sensor has not learned the loaded stock.

Install and Start QZ Tray

  1. Install QZ Tray on the Windows workstation.
  2. Start QZ Tray.
  3. Confirm its icon appears in the Windows notification area beside the clock. Use the hidden-icons arrow if necessary.
  4. Keep QZ Tray running whenever direct printing is needed.
  5. Open or refresh https://app.resell4.me.

If the QZ Tray icon is missing, QZ Tray is either not installed or not running. A Connect button inside Resell4.me cannot install or start a missing QZ Tray application.

Permanently Authorize Resell4.me in QZ Tray

QZ Tray's authorization dialog does not allow Allow and Remember this decision to be selected together. Treat them as mutually exclusive. Never instruct a shop user to check Remember and then click Allow.

For a one-time test, click Allow without selecting Remember this decision. For normal permanent workstation setup, install Resell4.me's trusted certificate override and whitelist it instead of accepting recurring prompts.

Permanent certificate and whitelist setup

Sign in to the same Windows account that will run Resell4.me. Open PowerShell as Administrator and run:

$qzFolder = Join-Path $env:ProgramFiles "QZ Tray"
$downloadedCert = Join-Path $env:TEMP "resell4me-qz-certificate.txt"
$overrideCert = Join-Path $qzFolder "override.crt"

Invoke-WebRequest `
  "https://app.resell4.me/qz-certificate.txt" `
  -OutFile $downloadedCert

if ((Get-Content $downloadedCert -First 1) -ne "-----BEGIN CERTIFICATE-----") {
  throw "The downloaded file is not a valid certificate."
}

if (Test-Path $overrideCert) {
  Copy-Item $overrideCert `
    "$overrideCert.backup-$(Get-Date -Format yyyyMMdd-HHmmss)"
}

Copy-Item $downloadedCert $overrideCert -Force

& (Join-Path $qzFolder "qz-tray-console.exe") `
  --whitelist $downloadedCert

Verify that the whitelist was created for the current Windows user:

Get-Item "$env:APPDATA\qz\allowed.dat" |
  Select-Object FullName,Length,LastWriteTime

The expected path is under the current shop user's profile, for example:

C:\Users\ShopUser\AppData\Roaming\qz\allowed.dat

Then fully exit and restart QZ Tray and refresh Resell4.me. The permanent setup consists of both:

No per-shop Supabase change is normally required. The Resell4.me certificate and signing service are application-wide; the local certificate override and whitelist are workstation-specific.

Configure Printers in Resell4.me

  1. Open Settings → Printing.
  2. Confirm Resell4.me reports that QZ Tray is connected.
  3. Select the exact installed Windows queue from each printer dropdown:

- Receipt printer
- Hang-tag printer
- Sticker/label printer
- Document printer

  1. Do not type an approximate printer name or select an obsolete duplicate queue.
  2. Select the receipt format:

- Thermal for an 80 mm receipt printer.
- Standard for full-page receipts.

  1. Save settings and reopen the Printing settings to verify they persisted.

The same physical printer can be selected for tags and labels when appropriate. Receipt and document printers may be different.

Configure Label Dimensions

  1. Open the label/tag print controls.
  2. Select the intended preset or enter the exact width and height.
  3. For a roll printer, leave Sheet mode off so each label is one physical page.
  4. For multi-column stock, distinguish between the width of one tag and the full physical paper width. Use the Resell4.me preset designed for that stock when available.
  5. Save the dimensions and confirm the selected print type remains active.

For the Fantasia TSC TDP-247 setup, a 2.25 × 1.25-inch label is sent as 57.15 × 31.75 mm. The printer must be calibrated with that loaded stock before the application test.

Test in This Order

Use one label or one short receipt for each test.

  1. Printer hardware: Press Feed several times. Thermal labels should advance consistently one at a time.
  2. Windows: Print a test page through the exact configured queue.
  3. QZ connection: Confirm QZ Tray is running and Resell4.me shows it connected.
  4. Resell4.me label: Print one label and verify its content, alignment, and feed length.
  5. Resell4.me receipt: Print one thermal receipt and verify that right-aligned amounts remain on the same rows instead of appearing below the receipt.
  6. Repeat one successful test to check for intermittent behavior.

Do not start by reinstalling QZ Tray, changing Supabase, or modifying print code when the printer cannot consistently feed its loaded stock.

Printing from Resell4.me

Tags and labels

From Inventory, select the items and click Print Tags or Labels. Choose the intended format and printer, confirm the dimensions, and print.

Labels can include the item description, category, price, date in, barcode, and SKU depending on the selected options.

Receipts

Receipts can print immediately after a sale. To reprint one, open Sales History, open the sale, and click Print Receipt.

Other documents

Troubleshooting by Layer

Do not guess which component failed. Check the path in order:

Resell4.me → QZ Tray → Windows spooler/driver → printer port → printer/media

1. Resell4.me

Confirm:

2. QZ Tray

Open the QZ Tray log and inspect the print request. A healthy label job should show:

For an 80 mm thermal receipt, the job should use scaleContent:true so QZ fits the receipt to the printer driver's actual printable width.

QZ Tray's Printing complete means QZ handed the job to Windows. It does not prove that paper physically came out.

3. Windows print service

Open PowerShell as Administrator and enable the operational print log once:

wevtutil sl Microsoft-Windows-PrintService/Operational /e:true

After reproducing the problem, display the newest events:

wevtutil qe Microsoft-Windows-PrintService/Operational /rd:true /c:20 /f:text

Successful Windows evidence normally includes:

Check whether a job is still stuck in the queue:

Get-PrintJob -PrinterName "Exact Printer Queue Name" -ErrorAction SilentlyContinue |
  Format-List ID,DocumentName,JobStatus,Size,TotalPages,PagesPrinted

No output means no job is currently waiting in that queue.

4. Printer, media, USB, and driver

If QZ reports one page and Windows reports Event 307 plus Event 842 with 0x0, but nothing prints or printing is intermittent:

  1. Observe the printer's status light.
  2. Confirm the printer is ready rather than paused or in an error state.
  3. Press Feed several times.
  4. Calibrate the gap/black-mark media sensor using the manufacturer's procedure.
  5. Retry a Windows test page through the same queue.
  6. Confirm the Windows queue uses the expected driver and USB/network port.
  7. Inspect the USB cable, power supply, and physical connection if Windows tests remain intermittent.

A successful print immediately after calibration confirms a printer/media setup problem, not a Resell4.me, QZ Tray, Windows-spooler, or Supabase problem.

Common Symptoms

QZ Tray icon is missing

QZ Tray is not running or is not installed. Start or install it before using Connect in Resell4.me.

Authorization prompt appears every time

Do not combine Allow with Remember this decision. Install override.crt, run the QZ whitelist command, verify %APPDATA%\qz\allowed.dat, and restart QZ Tray.

QZ says two pages for one label

Confirm the app is current, sheet mode is off, and the saved label dimensions match the stock. Send the QZ log for review if it still reports two pages.

Receipt amounts print again underneath

The receipt was wider than the driver's printable area and was tiled horizontally. Current Resell4.me thermal receipt jobs use QZ content fitting. Confirm the QZ log shows scaleContent:true and one page.

QZ and Windows report success, but nothing comes out

Calibrate the printer with the loaded media, check repeated Feed operation, and test the exact Windows queue. Windows Event 307 is a successful handoff record, not a physical-paper confirmation.

Printing works once but not consistently

Repeat the physical Feed test and Windows test page. Intermittent behavior at those layers must be resolved before changing Resell4.me print code.

Final Workstation Checklist

Last generated: 2026-07-22 18:00