OdooWiki OCA HUB

Point of Sale XML in Header and Footer of Receipt

pos_receipt_xml_header_footer folder_open OCA/pos open_in_new
Point of Sale License: AGPL-3

This module adds support for header_xml and footer_xml in the PosTicket XML template.

auto_awesome What this module does

AI-generated from the code · Odoo 12.0

Lets Point of Sale receipts show custom XML/HTML content in the header and footer, so shops can print richer, formatted information on customer tickets.

This module extends the Point of Sale receipt template so that a receipt can display extra content at the top and at the bottom, using XML or HTML instead of plain text.

  • When a receipt contains header content, it is printed above the normal receipt header, centred on the ticket.
  • When a receipt contains footer content, it is printed below the normal receipt footer, also centred, with a line break before it.
  • The content is rendered as-is, so formatted markup (for example bold text, images or layout) can appear on the printed receipt.

It works by extending the existing PosTicket receipt template used by the Point of Sale. No new menus, screens, buttons or database models are added, and no business rules, checks or automatic calculations are introduced. The module only changes how the receipt is displayed when the corresponding header and footer values are present.

Because it depends on point_of_sale, it applies to the Point of Sale area and to the receipt shown or printed at the end of a sale. If no header or footer content is set, the receipt looks exactly as before.

Depends on

point_of_sale

Text generated by AI (DeepSeek) from reading the Odoo 12.0 code on GitHub; it may contain mistakes, so check the code before deciding. View the code on GitHub

Availability by version

Reviewed: 2026-11-03
Confirmed (verified in repository and branch) Estimated (unverified) No information

Confirmation status: 1 confirmed, 8 with no information of 9 versions.

terminal Installation and usage

OCA documentation · Odoo 12.0

Usage

Source · Odoo 12.0

To use XML (Odoo QWeb) and HTML in the headers and footers of your receipts, do the following:

  • Open the Point of Sale application.
  • Go to Configuration → Point of Sale, and select your POS.
  • Enable 'Header & Footer'.
  • Prepend your header or footer with a single line containing <!DOCTYPE QWEB.

For example, to use line breaks:

<!DOCTYPE QWEB
Hello<br />
world!

Or to use QWeb templating magic:

<!DOCTYPE QWEB
<t t-esc='receipt.cashier'/> helped you today.

No verified information in OCA: Installation, Configuration.

info

Data imported from GitHub: this sheet reflects the latest catalog review, not a live lookup. Always check the module documentation and staging before installing in production.