<h1 class="title">Point Of Sale - Meal Voucher</h1> <p><a class="reference external" href="https://odoo-community.org/page/development-status"><img alt="Beta" src="https://img.shields.io/badge/maturity-Beta-yellow.png" /></a> <a class="reference external" href="http://www.gnu.org/licenses/agpl-3.0-standalone.html"><img alt="License: AGPL-3" src="https://img.shields.io/badge/licence-AGPL--3-blue.png" /></a> <a class="reference external" href="https://github.com/OCA/pos/tree/12.0/pos_meal_voucher"><img alt="OCA/pos" src="https://img.shields.io/badge/github-OCA%2Fpos-lightgray.png?logo=github" /></a> <a class="reference external" href="https://translation.odoo-community.org/projects/pos-12-0/pos-12-0-pos_meal_voucher"><img alt="Translate me on Weblate" src="https://img.shields.io/badge/weblate-Translate%20me-F47D42.png" /></a> <a class="reference external" href="https://runbot.odoo-community.org/runbot/184/12.0"><img alt="Try me on Runbot" src="https://img.shields.io/badge/runbot-Try%20me-875A7B.png" /></a></p> <p>This module extend the Point of Sale Odoo module, regarding Meal Vouchers.</p> <p>Meal voucher is a payment method, available in some countries (France, Belgium, Romania, ...) that allows customer to buy food products in grocery stores or pay in restaurants.</p> <p><strong>Table of contents</strong></p> <div class="contents local topic" id="contents"> <ul class="simple"> <li><a class="reference internal" href="#configuration" id="id1">Configuration</a></li> <li><a class="reference internal" href="#usage" id="id2">Usage</a><ul> <li><a class="reference internal" href="#note" id="id3">Note</a></li> </ul> </li> <li><a class="reference internal" href="#known-issues-roadmap" id="id4">Known issues / Roadmap</a></li> <li><a class="reference internal" href="#bug-tracker" id="id5">Bug Tracker</a></li> <li><a class="reference internal" href="#credits" id="id6">Credits</a><ul> <li><a class="reference internal" href="#authors" id="id7">Authors</a></li> <li><a class="reference internal" href="#contributors" id="id8">Contributors</a></li> <li><a class="reference internal" href="#other-credits" id="id9">Other credits</a></li> <li><a class="reference internal" href="#maintainers" id="id10">Maintainers</a></li> </ul> </li> </ul> </div> <a name="configuration"></a> <h2 class="with-subtitle"><a class="toc-backref" href="#id1">Configuration</a></h2> <h2 class="section-subtitle" id="products"><span class="section-subtitle">Products</span></h2> <ul class="simple"> <li>go to your products, and click on the 'Meal Voucher' checkbox, if your product can be paid with meal vouchers.</li> </ul> <div class="figure"> <img alt="https://raw.githubusercontent.com/OCA/pos/12.0/pos_meal_voucher/static/description/product_product_form.png" src="https://raw.githubusercontent.com/OCA/pos/12.0/pos_meal_voucher/static/description/product_product_form.png" /> </div> <ul class="simple"> <li>You can configure your product categories to have a default value for the products that belong to this category.</li> </ul> <div class="figure"> <img alt="https://raw.githubusercontent.com/OCA/pos/12.0/pos_meal_voucher/static/description/product_category_form.png" src="https://raw.githubusercontent.com/OCA/pos/12.0/pos_meal_voucher/static/description/product_category_form.png" /> </div> <ul class="simple"> <li>configures your Account journals, mentioning the type of Meal Voucher:</li> </ul> <ul class="simple"> <li>Paper : the journal will be used when scanning meal voucher barcodes</li> <li>Dematerialized: the journal will be used for dematerialized meal vouchers</li> <li>Mixed: Specific configuration if your accountant want to use a single journal for Credit card AND dematerialized meal vouchers. In that case, the button of this journal will be duplicated, and an extra text can be set to display an alternative label.</li> </ul> <div class="figure"> <img alt="https://raw.githubusercontent.com/OCA/pos/12.0/pos_meal_voucher/static/description/account_journal_form.png" src="https://raw.githubusercontent.com/OCA/pos/12.0/pos_meal_voucher/static/description/account_journal_form.png" /> </div> <ul class="simple"> <li>go your point of sale configuration form, and set the maximum amount allowed by ticket. (optional)</li> </ul> <div class="figure"> <img alt="https://raw.githubusercontent.com/OCA/pos/12.0/pos_meal_voucher/static/description/pos_config_form.png" src="https://raw.githubusercontent.com/OCA/pos/12.0/pos_meal_voucher/static/description/pos_config_form.png" /> </div> <a name="usage"></a> <h2><a class="toc-backref" href="#id2">Usage</a></h2> <ul> <li><p class="first">Open your Point of Sale</p> </li> <li><p class="first">Cashier can see the food products, eligible for meal voucher payment, and see the total for Meal Voucher amount</p> <div class="figure"> <img alt="https://raw.githubusercontent.com/OCA/pos/12.0/pos_meal_voucher/static/description/front_ui_pos_order_screen.png" src="https://raw.githubusercontent.com/OCA/pos/12.0/pos_meal_voucher/static/description/front_ui_pos_order_screen.png" /> </div> </li> <li><p class="first">go to the payment screen</p> </li> </ul> <p>A Meal Voucher Summary is available:</p> <blockquote> <div class="figure"> <img alt="https://raw.githubusercontent.com/OCA/pos/12.0/pos_meal_voucher/static/description/front_ui_pos_payment_screen.png" src="https://raw.githubusercontent.com/OCA/pos/12.0/pos_meal_voucher/static/description/front_ui_pos_payment_screen.png" /> </div> </blockquote> <p>If the amount received is too important, a warning icon is displayed</p> <blockquote> <div class="figure"> <img alt="https://raw.githubusercontent.com/OCA/pos/12.0/pos_meal_voucher/static/description/front_ui_pos_payment_screen_summary.png" src="https://raw.githubusercontent.com/OCA/pos/12.0/pos_meal_voucher/static/description/front_ui_pos_payment_screen_summary.png" /> </div> </blockquote> <p>If the cashier try to validate the order, a warning is also display, asking confirmation</p> <blockquote> <div class="figure"> <img alt="https://raw.githubusercontent.com/OCA/pos/12.0/pos_meal_voucher/static/description/front_ui_pos_payment_screen_warning.png" src="https://raw.githubusercontent.com/OCA/pos/12.0/pos_meal_voucher/static/description/front_ui_pos_payment_screen_warning.png" /> </div> </blockquote> <p>It is a non blocking warning, because we don't want to prevent an order to be done, if products are not correctly set, or if a recent law changed the maximum amount that can be used each day. (A recent case occured in France, during the Covid-19 pandemy)</p> <a name="note"></a> <h3><a class="toc-backref" href="#id3">Note</a></h3> <p>A new barcode rule is available for Paper Meal Voucher of 24 chars:</p> <p><code>...........{NNNDD}........</code></p> <p>If you scan the following barcode <code>052566641320080017000000</code>, a new payment line will be added, with an amount of 8,00€ (<code>00800</code>)</p> <a name="known-issues-roadmap"></a> <h2><a class="toc-backref" href="#id4">Known issues / Roadmap</a></h2> <ul class="simple"> <li>Introduce the Meal Voucher Issuer model</li> <li>When scaning Meal Voucher, deduce the Issuer</li> <li>Add a reporting to make easily the deposit of Meal Vouchers, per issuers.</li> <li>Add an option to add subtotal of products that can be paid with meal vouchers, on the bill.</li> <li>Prevent to scan twice the same Meal Voucher barcode.</li> </ul> <a name="bug-tracker"></a> <h2><a class="toc-backref" href="#id5">Bug Tracker</a></h2> <p>Bugs are tracked on <a class="reference external" href="https://github.com/OCA/pos/issues">GitHub Issues</a>. In case of trouble, please check there if your issue has already been reported. If you spotted it first, help us smashing it by providing a detailed and welcomed <a class="reference external" href="https://github.com/OCA/pos/issues/new?body=module:%20pos_meal_voucher%0Aversion:%2012.0%0A%0A**Steps%20to%20reproduce**%0A-%20...%0A%0A**Current%20behavior**%0A%0A**Expected%20behavior**">feedback</a>.</p> <p>Do not contact contributors directly about support or help with technical issues.</p> <a name="credits"></a> <h2><a class="toc-backref" href="#id6">Credits</a></h2> <a name="authors"></a> <h3><a class="toc-backref" href="#id7">Authors</a></h3> <ul class="simple"> <li>GRAP</li> </ul> <a name="contributors"></a> <h3><a class="toc-backref" href="#id8">Contributors</a></h3> <ul class="simple"> <li>Sylvain LE GAL &lt;<a class="reference external" href="https://twitter.com/legalsylvain">https://twitter.com/legalsylvain</a>&gt;</li> </ul> <a name="other-credits"></a> <h3><a class="toc-backref" href="#id9">Other credits</a></h3> <p>The development of this module has been financially supported by:</p> <ul class="simple"> <li>Vracoop (<a class="reference external" href="https://portail.vracoop.fr/">https://portail.vracoop.fr/</a>)</li> <li>Demain Supermarché (<a class="reference external" href="http://www.demainsupermarche.org/">http://www.demainsupermarche.org/</a>)</li> </ul> <a name="maintainers"></a> <h3><a class="toc-backref" href="#id10">Maintainers</a></h3> <p>This module is maintained by the OCA.</p> <a class="reference external image-reference" href="https://odoo-community.org"><img alt="Odoo Community Association" src="https://odoo-community.org/logo.png" /></a> <p>OCA, or the Odoo Community Association, is a nonprofit organization whose mission is to support the collaborative development of Odoo features and promote its widespread use.</p> <p>Current <a class="reference external" href="https://odoo-community.org/page/maintainer-role">maintainer</a>:</p> <p><a class="reference external" href="https://github.com/legalsylvain"><img alt="legalsylvain" src="https://github.com/legalsylvain.png?size=40px" /></a></p> <p>This module is part of the <a class="reference external" href="https://github.com/OCA/pos/tree/12.0/pos_meal_voucher">OCA/pos</a> project on GitHub.</p> <p>You are welcome to contribute. To learn how please visit <a class="reference external" href="https://odoo-community.org/page/Contribute">https://odoo-community.org/page/Contribute</a>.</p>