OdooWiki OCA HUB

Point Of Sale - Meal Voucher

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

This module allows to handle meal vouchers in the point of sale.

Meal vouchers are a payment method, available in some countries (France, Belgium, Romania,…) that allows customers to buy food products in grocery stores or pay in restaurants.

auto_awesome What this module does

AI-generated from the code · Odoo 16.0

Lets you accept meal vouchers (paper or electronic) as a payment method in the Point of Sale, tracking which products are eligible and warning when the voucher amount exceeds the eligible or maximum allowed amount.

This module adds meal voucher handling to the Point of Sale. You can mark a payment method as a meal voucher type (Paper or Electronic) on the payment method form, and mark products or whole product categories as "Can be Paid for by Meal Vouchers".

In the Point of Sale settings you can set a maximum amount per order payable by meal vouchers, show a fork-and-knife icon on eligible order lines, and print meal voucher information on receipts. On the product category form a button applies the eligibility setting to all products in that category.

During a sale, the payment screen shows a Meal Vouchers summary with the total eligible amount, the maximum amount (if set) and the total received, with warning icons when the received amount exceeds the eligible or maximum amount. Paper vouchers can be scanned with a barcode reader; each scanned voucher is added as a payment line and the same code cannot be scanned twice. Receipts can show an asterisk before eligible products plus eligible and non-eligible totals.

It touches pos.config, pos.payment.method, pos.order, pos.session, product.template, product.product, product.category, barcode.rule and res.config.settings.

Depends on

point_of_sale

Required by other modules

Models and fields (7)
  • pos.config · extends an existing modelmax_meal_voucher_amount (Meal Voucher Maximum Amount), has_meal_voucher_payment_method, enable_meal_voucher_receipt_info (Meal Voucher Information on Receipt), enable_meal_voucher_order_lines_icon (Meal Voucher Icon on Order Lines)
  • barcode.rule · extends an existing modeltype
  • product.product · extends an existing model
  • product.category · extends an existing modelmeal_voucher_ok (Can be Paid for by Meal Vouchers)
  • product.template · extends an existing modelmeal_voucher_ok (Can be Paid for by Meal Vouchers)
  • pos.payment.method · extends an existing modelmeal_voucher_type
  • res.config.settings · extends an existing modelpos_max_meal_voucher_amount, pos_enable_meal_voucher_receipt_info, pos_enable_meal_voucher_order_lines_icon

Text generated by AI (DeepSeek) from reading the Odoo 16.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: 2 confirmed, 7 with no information of 9 versions.

terminal Installation and usage

OCA documentation · Odoo 16.0

Products

On a product form, in the "Sales" tab, the "Can be Paid for by Meal Vouchers" checkbox controls whether the product can be paid for by meal vouchers.

.. figure:: ../static/description/product_product_form.png

Product categories can be configured to have a default value for the "Can be Paid for by Meal Vouchers" field for its products.
The "Apply to All Products" button allows to set the value on all products of the category.

.. figure:: ../static/description/product_category_form.png

Point of Sale Payment Methods

Point of sale payment methods (Point of Sale > Configuration > Payment Methods) have a "Meal Voucher Type" field that defines what type of meal voucher payment method they are:

  • (empty): The payment method is not a meal voucher payment method.
  • Paper: The payment method will be used when scanning meal voucher barcodes.
  • Electronic: The payment method will be used for electronic meal vouchers.

Settings

This module adds a "Meal Vouchers" section in the point of sale settings (Point of Sale > Configuration > Settings, or Settings > Point of Sale) with several options:

* **Maximum Amount**: Optional maximum amount per order that can be paid by meal vouchers. Set to 0 to disable.
* **Icon on Order Lines**: Whether to display an icon on point of sale order lines (on the product screen) for products that can be paid for by meal vouchers.
* **Information on Receipt**: Whether to display an asterisk (*) on receipts before each product that can be paid for by meal vouchers as well as the total eligible amount.

.. figure:: ../static/description/pos_settings.png

Product Screen

On the product screen, the products that can be paid for by meal vouchers are (optionally) identified with an icon and the total amount of those products is displayed.

.. figure:: ../static/description/pos_order_screen.png

Payment Screen

On the payment screen, a meal voucher summary is displayed:

If the received amount is too high, a warning icon is displayed:

Receipt

The receipts can optionally contain information about the products that can be paid for by meal vouchers and the total amount of those products:

.. figure:: ../static/description/receipt_information.png

Barcodes

A new barcode rule is defined for paper meal vouchers (with 24 characters):

...........{NNNDD}........

If you scan the following barcode: 052566641320080017000000, a new payment line with an amount of ¤8.00 (00800) will be added.

No verified information in OCA: Installation.

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.