User guide
POS Advanced Receipt Design for Odoo: Complete User Guide
How to install, set up and use POS Advanced Receipt Design for Odoo 19 and 20. Covers the 8 thermal receipt designs, live preview, the AI Receipt Assistant, bilingual receipts, offline printing and known limitations.
KalvyAI Engineering · · 8 min read

POS Advanced Receipt Design is an Odoo module that replaces the standard Point of Sale receipt with one of 8 ready thermal receipt designs. You configure it visually, with a live preview, or by describing what you want to an AI assistant. This guide covers installation, setup, each main feature, limitations and common questions.
You can buy and install the module from the store page: POS Advanced Receipt Design.
What the module is for
The module lets you design Point of Sale receipts without writing code. All 8 designs are black-and-white layouts built for 58 mm and 80 mm thermal printers. The on-screen receipt, the paper print and the customer email use the same layout, so they look identical.
You can:
- Pick one of 8 ready designs and adjust it with a live preview.
- Show or hide individual blocks such as tax ID, cashier, SKU codes or the order barcode.
- Add your logo, a custom QR code, promo coupons and return terms.
- Print in 18 languages, or print bilingual receipts such as Arabic + English with right-to-left layout.
- Ask the AI Receipt Assistant to change the layout in plain language, then review the result before saving.
Who it helps
- Retailers and boutiques who want branded receipts with a logo, QR code to a review page and return terms.
- Supermarkets that need savings banners, discount lines and SKU codes.
- Restaurants and cafes that want tip suggestions or a QR code to a digital menu or Wi-Fi.
- International businesses that serve customers in more than one language and need bilingual or right-to-left receipts.
- ERP admins who want receipt changes without custom QWeb development.
Requirements
- Odoo 19.0 or 20.0, Community or Enterprise
- Hosting on Odoo.sh or your own server (Odoo Online is not supported)
- The standard Odoo Point of Sale module
- The free KalvyAI AI Base module (included and installed automatically)
- A standard 58 mm or 80 mm thermal receipt printer, connected by ESC/POS, IoT Box or browser print
- Optional: an API key from an AI provider (Gemini, OpenAI, Claude, Grok, DeepSeek) or a local LLM, only if you want to use the AI Assistant
Installation and setup
1. Install the module
- Get the module from the store page.
- Add it to your Odoo.sh repository or your server's addons path. [CHECK: delivery format and recommended deployment steps from the store]
- In Odoo, go to Apps, update the apps list, search for POS Advanced Receipt Design and click Install.
Point of Sale and the free AI Base module are installed and configured automatically.
If you manage a self-hosted server from the command line, you can also install by technical name:
./odoo-bin -d your_database -i ki_pos_advanced_receipt_design2. Enable Advanced Receipts
- Go to Point of Sale › Configuration › Settings.
- Select the Point of Sale you want to configure.
- In the Bills & Receipts section, enable Advanced Receipt Design.
- Choose your default template.
- Save.
Settings are per Point of Sale, so repeat this for each counter that should use the advanced receipt.
3. Customize in Receipt Designer
Open the Receipt Designer [CHECK: menu path or button to open Receipt Designer]. From here you pick a design, toggle blocks, add your logo and QR code, or let the AI Assistant configure it with a prompt. The sections below explain each part.
4. Reload the POS and sell
Reload your Point of Sale session. From then on, customer receipts, printouts and digital emails use your customized design.
Using the main features
Choosing one of the 8 designs
The module ships with these designs:
Design | Typical use |
|---|---|
Classic Thermal | [CHECK: short description] |
Modern Accent | [CHECK: short description] |
Elegant Boutique | [CHECK: short description] |
Minimal Clean | [CHECK: short description] |
Supermarket Saver | [CHECK: short description] |
Restaurant & Cafe | [CHECK: short description] |
Tax Invoice | [CHECK: short description] |
Brand Story | [CHECK: short description] |
To switch designs:
- Open the Receipt Designer for your Point of Sale.
- Select a design.
- Check the live preview.
- Save, then reload the POS session.
Working with the live preview
The preview shows the exact printed receipt in real time as you toggle blocks, change fonts or adjust branding.
- Choose the paper width, 58 mm or 80 mm, to match your printer. [CHECK: name of the paper size control]
- Make a change, for example hide the order barcode.
- Watch the preview update.
- Save when you are happy with the result.
Always preview at the paper width you actually use. A layout that fits comfortably on 80 mm can feel crowded on 58 mm.
Showing and hiding blocks
You can show or hide these blocks:
- Company address
- Tax ID / GSTIN
- Cashier
- Customer
- Product SKU codes
- Discounts
- Savings banner
- Amount in words
- Order barcode
Toggle each block in the designer and confirm the result in the preview. A short receipt with only the blocks you need saves paper and is easier for customers to read.
Adding your logo, QR code and promotions
- Upload your logo in the designer. [CHECK: logo field name and recommended image size or format]
- Add a custom QR code and enter its target, such as a review page, digital menu, Wi-Fi details or your website. [CHECK: QR code field names and Wi-Fi format]
- Add promo coupon text and return terms if you want them printed. [CHECK: field names for promo and return terms]
- Check the preview, then save.
Because the receipts are black-and-white, use a logo that still reads clearly in pure black on white.
Using the AI Receipt Assistant
The AI Receipt Assistant changes receipt settings from plain-language requests. It works with any provider configured in AI Base, including Claude, OpenAI, Gemini, Grok, DeepSeek and local LLMs.
First, connect a provider:
- Open the AI Base settings. [CHECK: menu path for AI Base provider configuration]
- Choose your provider and enter the API key, or point it at your local LLM. [CHECK: field names for provider, model and key]
- Save.
Then use the assistant:
- Open the Receipt Designer.
- Open the AI Assistant. [CHECK: name or location of the assistant panel]
- Type a request in plain words.
- Review the updated layout in the preview.
- Save if it looks right, or refine your request.
Example requests:
Add the GST number and cashier name
Hide the barcode and enlarge text
Show the savings banner and amount in words
Add a QR code to our review pageThe assistant only updates the layout for your review. Nothing is saved until you confirm it.
Printing in other languages and bilingual receipts
Receipts can print in the cashier's, the company's or the customer's language. You can also enable a second language to print bilingual labels, for example الإجمالي / Total. Arabic, Hebrew, Persian and Urdu use a right-to-left layout automatically.
- Activate the languages you need in Odoo General Settings. The module can only use languages that are active there.
- In the receipt settings for your Point of Sale, choose which language the receipt uses: cashier, company or customer. [CHECK: field name for receipt language]
- To print bilingual receipts, enable Second Language and choose the language. [CHECK: exact location of the Second Language setting]
- Check the preview, save and reload the POS.
The module includes 18 built-in languages. [CHECK: list of the 18 supported languages]
Printing offline
The logo, barcodes, QR codes and translated labels are cached in the browser POS session. If the internet drops, receipts still print normally. Load the POS session at least once while online after any design change, so the latest assets are cached.
Using the counter design switcher
Cashiers can switch between receipt templates directly from the POS receipt screen. This is useful to reprint an order with a different layout, for example the Tax Invoice design for a business customer.
- Complete or open an order on the POS receipt screen.
- Use the design switcher to pick another template. [CHECK: button name and location on the receipt screen, and whether it must be enabled per POS]
- Print or reprint the receipt.
Different designs per counter
Receipt design and formatting settings are configured independently per Point of Sale. A shop counter can use Elegant Boutique while a cafe counter in the same database uses Restaurant & Cafe.
Tips
- Match the preview width to the paper in each printer before fine-tuning.
- Start from the design closest to your business type, then toggle blocks, rather than changing everything at once.
- Keep AI requests short and specific, and change one thing at a time so the result is easy to check.
- Test print on the real printer after each significant change. Different printers can render fonts slightly differently.
- Remember to reload the POS session after saving changes.
- Activate languages in General Settings before you try to select them for receipts.
Limitations
- Odoo Online (SaaS) is not supported. Custom modules require Odoo.sh or on-premise hosting.
- Certified fiscal receipts. Localizations that require certified legal content, such as Saudi ZATCA QR or German TSE, should keep standard receipts.
- Loyalty data is not printed yet. Loyalty point balances, coupon codes and eWallet details from pos_loyalty do not appear on the advanced receipt.
- Fixed black-and-white layouts. Colors and custom CSS positioning are not supported.
- Amount in words is English only, including the Indian lakh/crore format for INR.
- Languages must be active in General Settings before you can select them for receipts.
FAQ
Which Odoo versions and hostings are supported?
Odoo 19.0 and 20.0, Community and Enterprise, on Odoo.sh or self-hosted servers. Odoo Online (SaaS) is not supported.
Do I need an AI provider key?
No. The visual designer, all 8 designs, thermal layouts and 18 languages work completely without AI. You only need a key for the conversational assistant.
Will it work with my thermal printer?
Yes. All designs are pure black-and-white layouts optimized for standard 58 mm and 80 mm thermal paper rolls. Printing works through ESC/POS, an IoT Box or browser print.
Can different counters use different designs?
Yes. Receipt design and formatting settings are configured independently per Point of Sale.
Does it work without internet?
Yes. The logo, barcodes, QR codes and translated labels are cached in the browser POS session, so receipts print normally offline.
Can I print Arabic and English on the same receipt?
Yes. Enable Second Language to print bilingual labels, such as الإجمالي / Total, with right-to-left layout for Arabic, Hebrew, Persian and Urdu.
How KalvyAI can help
We build and connect Odoo, ERPNext and Shopify systems, and we add AI agents that work inside them with human approvals, budgets and an audit trail. If you need help deploying this module on Odoo.sh or your own server, setting up printers and AI Base providers, or adapting your Point of Sale to your business, contact us.
To buy and install the module, visit the POS Advanced Receipt Design store page.
- User guide
- Odoo
- Point of Sale
- POS Receipts
- Thermal Printing
- AI Assistant
- Odoo 19
KalvyAI Engineering · Engineering team
The engineers who build, connect and fix business systems at KalvyAI: Odoo, ERPNext, Shopify and AI agents that work inside them with approvals, budgets and an audit trail.



Comments
No comments yet. Questions and corrections are welcome.
Rate this post or leave a comment