abdul.aziz/pos_custom_receipt
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
1 Commit 1 Branch 0 Tags 66 KiB
CSS 43.6%
JavaScript 32.1%
Python 24.3%
b20c84e2b1
Go to file
Abdul Aziz Amrullah b20c84e2b1 Initial Commit
2026-05-20 16:28:55 +07:00
static/src/xml Initial Commit 2026-05-20 16:28:55 +07:00
__init__.py Initial Commit 2026-05-20 16:28:55 +07:00
__manifest__.py Initial Commit 2026-05-20 16:28:55 +07:00
.gitignore Initial Commit 2026-05-20 16:28:55 +07:00
README.md Initial Commit 2026-05-20 16:28:55 +07:00

README.md

POS Custom Receipt

This custom module is designed for Odoo 19 to override and customize the standard Point of Sale (POS) receipts, specifically adjusting the layout and content of the receipt header and footer. It provides a cleaner and more business-specific printed receipt.

Features

  1. Hide Tracking Number: Removes the short tracking_number element from the top of the receipt header to avoid confusion with the main POS reference number.

  2. Custom Ticket Prefix: Replaces the default "Ticket" text prefix with "NO" on the main receipt reference sequence (e.g., instead of "Ticket 0001", it prints "NO 0001").

  3. Custom "Pro Forma" Text: When using the Early Receipt or Bill printing feature (before payment is finalized), Odoo natively prints "Pro forma receipt". This module replaces that text with an attention-grabbing "!!! INI ADALAH TAGIHAN SEMENTARA, BUKAN BUKTI PEMBAYARAN !!!". Furthermore, this text is explicitly hidden when printing a Basic Receipt (gift receipt without prices).

  4. Address & Email Removal: Hides the detailed company/branch address and the company email from the receipt footer, keeping the receipt concise.

  5. Remove Odoo Branding: Hides the "Powered by Odoo" text and logo from the bottom of the receipt footer.

Technical Details

The module utilizes Odoo's OWL xpath inheritance mechanism to modify the front-end QWeb templates dynamically.

  • pos_custom_receipt.ReceiptHeader extends point_of_sale.ReceiptHeader.
  • pos_custom_receipt.OrderReceipt extends point_of_sale.OrderReceipt.

Dependencies:

  • point_of_sale: Base module for the POS system.
  • pos_restaurant: Required to ensure the proper loading sequence for overriding the "Pro forma receipt" text, which is inherently injected by the restaurant module.

Installation

  1. Place the pos_custom_receipt directory into your Odoo custom addons path.
  2. Enable Developer Mode in Odoo.
  3. Go to Apps -> Update Apps List.
  4. Search for "POS Custom Receipt" and click Install.
  5. Once installed, refresh your POS session to load the updated XML assets.

Compatibility

  • Odoo Version: 19.0
  • Tested on standard POS and POS Restaurant profiles.