POS Printing QZ

pos_printing_qztray · OCA/pos

    Repository
    OCA/pos · module folder · Try on Runboat
    Module version
    Category
    Point Of Sale
    Folder size
    0.08 MB
    License
    AGPL-3
    Application
    No
    Auto-installable
    No
    Website
    https://github.com/OCA/pos
    Last tracking update
    2026-08-14 11:31:50
    Authors
    Odoo Community Association (OCA), APSL Nagarro
    Maintainers
    Odoo Community Association (OCA), APSL Nagarro
    Committers
    Weblate, OCA-git-bot, oca-ci, Miquel Alzanillas
    Odoo dependencies
    OCA/report-print-send:
    - base_report_to_printer_qztray
    - base_report_to_printer
    odoo/odoo:
    - point_of_sale
    - resource
    - base
    - web
    - stock_account
    - stock
    - product
    - mail
    - base_setup
    - bus
    - web_tour
    - html_editor
    - uom
    - barcodes_gs1_nomenclature
    - barcodes
    - digest
    - portal
    - http_routing
    - auth_signup
    - account
    - onboarding
    - analytic
    - phone_validation
    - partner_autocomplete
    - iap_mail
    - iap
    - iot_base
    - google_address_autocomplete
    Python dependencies
    python-escpos, pyOpenSSL
    System dependencies
    None
    Required by
    None
    Description
    This module provides a pure-software alternative to the Odoo IoT Box for
thermal receipt printing in the Point of Sale, using \[QZ
Tray\](<https://qz.io/>) as the print driver.

It extends base_report_to_printer_qz — which adds QZ Tray backend
support to printing.printer — and brings that functionality into the
POS, allowing users to select a printer with backend = qztray directly
from the POS configuration.

Key features:

- **Cash drawer support**: the cash drawer open command (ESC p) is sent
  automatically after each receipt print.
- **No IoT Box required**: designed as a software-only alternative for
  setups where deploying IoT infrastructure is not desirable.

    Code Analysis ⓘ

    Views touched (1)
    XML IDNameModelTypeStatus
    view_pos_config_form_qztray pos.config.form.qztray pos.config form Inherits point_of_sale.pos_config_view_form
    HTTP endpoints (2)
    Route(s)HandlerAuthTypeMethodsFlags
    /pos/escpos/render-image PosEscposController.render_any_report user jsonrpc ALL
    /pos/escpos/receipt PosEscposController.render_template user jsonrpc ALL
    Models touched (1)

    New fields (2)
    • iface_qztray_printer_id Many2one → printing.printer
      comodel_name='printing.printer' domain=[('backend', '=', 'qztray')] help='Printer to use for POS receipts when QZ Tray mode is enabled.' string='QZ Tray Printer'
    • is_qztray Boolean
      default=False help='Use QZ Tray instead of IoT Box for printing POS receipts.' string='Enable QZ Tray Printing'
    Public methods (0)

    No public methods.

    Status
    Open migration PR — not merged yet for this version
    CI status
    checks failing
    Open since
    41 days ago
    Last activity
    9 days ago
    Repository
    OCA/pos
    Pull request
    [17.0][MIG] pos_printing_qztray (#1582)
    Status
    Open migration PR — not merged yet for this version
    CI status
    checks failing
    Open since
    44 days ago
    Last activity
    9 days ago
    Repository
    OCA/pos
    Pull request
    [18.0][MIG] pos_printing_qztray (#1581)