Metadata-Version: 2.1
Name: odoo-addon-pos_margin
Version: 18.0.1.0.0.2
Requires-Python: >=3.10
Requires-Dist: odoo==18.0.*
Summary: Margin on PoS Order
Home-page: https://github.com/OCA/pos
License: AGPL-3
Author: GRAP, FactorLibre, Odoo Community Association (OCA)
Author-email: support@odoo-community.org
Classifier: Programming Language :: Python
Classifier: Framework :: Odoo
Classifier: Framework :: Odoo :: 18.0
Classifier: License :: OSI Approved :: GNU Affero General Public License v3
Description-Content-Type: text/x-rst

.. image:: https://odoo-community.org/readme-banner-image
   :target: https://odoo-community.org/get-involved?utm_source=readme
   :alt: Odoo Community Association

================
PoS Order Margin
================

.. 
   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
   !! This file is generated by oca-gen-addon-readme !!
   !! changes will be overwritten.                   !!
   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
   !! source digest: sha256:d425373415f13babde7037f8bad8b83a9ae7f8f1426ad1260bfae919ef9b25d9
   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!

.. |badge1| image:: https://img.shields.io/badge/maturity-Beta-yellow.png
    :target: https://odoo-community.org/page/development-status
    :alt: Beta
.. |badge2| image:: https://img.shields.io/badge/license-AGPL--3-blue.png
    :target: http://www.gnu.org/licenses/agpl-3.0-standalone.html
    :alt: License: AGPL-3
.. |badge3| image:: https://img.shields.io/badge/github-OCA%2Fpos-lightgray.png?logo=github
    :target: https://github.com/OCA/pos/tree/18.0/pos_margin
    :alt: OCA/pos
.. |badge4| image:: https://img.shields.io/badge/weblate-Translate%20me-F47D42.png
    :target: https://translation.odoo-community.org/projects/pos-18-0/pos-18-0-pos_margin
    :alt: Translate me on Weblate
.. |badge5| image:: https://img.shields.io/badge/runboat-Try%20me-875A7B.png
    :target: https://runboat.odoo-community.org/builds?repo=OCA/pos&target_branch=18.0
    :alt: Try me on Runboat

|badge1| |badge2| |badge3| |badge4| |badge5|

This module shows margins in PoS frontend during an order creation.

Margins are displayed below the final price of the POS order and under
each pos order line.

|You can see an example image at /static/description/pos_front_end.png|

This module also adds the margin fields to some secondary views. The
margin rate (%) is included in the POS order report, while the margin
amount is displayed in the POS order tree view.

.. |You can see an example image at /static/description/pos_front_end.png| image:: https://raw.githubusercontent.com/OCA/pos/18.0/pos_margin/static/description/pos_front_end.png

**Table of contents**

.. contents::
   :local:

Configuration
=============

- If you want to disable the display of the margin, in the front-office
  UI, you can uncheck the check box in the res.config.settings shop
  form. For that, go to Point of Sale / Configuration / Settings, and
  search the "Diplay Margin" field.

|You can see an example image at
/static/description/pos_config_setting.png|

.. |You can see an example image at /static/description/pos_config_setting.png| image:: https://raw.githubusercontent.com/OCA/pos/18.0/pos_margin/static/description/pos_config_setting.png

Known issues / Roadmap
======================

- Since version 16.0, Odoo already calculates the margin of POS orders
  and displays it in several views, such as the POS order form view.
  However, the UI improvements this module provides on the main POS
  screen, available since earlier versions, are still not covered by
  core Odoo.

Changelog
=========

16.0.1.0.0
----------

- Migrate to V16.0
- Remove the addition of the margin field to ``pos.order`` and
  ``pos.order.line`` introduced in v14.0, as this functionality is
  already provided by Odoo in v16.0.
- Remove tests.
- Create a ``res.config.settings`` field pos_iface_display_margin to
  display margins in PoS frontend.

14.0.1.0.0
----------

- Migrate to V14.0

13.0.1.0.0
----------

- Migrate to V13.0
- Reuse ``sale_margin`` computation to handle multi currency context.
- Correct computation of margin, if a module that adds ``uom_id`` on
  ``pos.order.line`` is installed.
- Add test

Bug Tracker
===========

Bugs are tracked on `GitHub Issues <https://github.com/OCA/pos/issues>`_.
In case of trouble, please check there if your issue has already been reported.
If you spotted it first, help us to smash it by providing a detailed and welcomed
`feedback <https://github.com/OCA/pos/issues/new?body=module:%20pos_margin%0Aversion:%2018.0%0A%0A**Steps%20to%20reproduce**%0A-%20...%0A%0A**Current%20behavior**%0A%0A**Expected%20behavior**>`_.

Do not contact contributors directly about support or help with technical issues.

Credits
=======

Authors
-------

* GRAP
* FactorLibre

Contributors
------------

- Sylvain LE GAL (https://twitter.com/legalsylvain)
- Wolfgang Pichler
- Murtaza Mithaiwala (https://twitter.com/MurtazaMithaiw4)
- Dhara Solanki <dhara.solanki@initos.com>
- Juan Carlos Bonilla <juancarlos.bonilla@factorlibre.com>
- Antonio Ruban <antoniodavid8@gmail.com>
- Alberto Martínez <alberto.martinez@sygel.es>

Maintainers
-----------

This module is maintained by the OCA.

.. image:: https://odoo-community.org/logo.png
   :alt: Odoo Community Association
   :target: https://odoo-community.org

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.

.. |maintainer-legalsylvain| image:: https://github.com/legalsylvain.png?size=40px
    :target: https://github.com/legalsylvain
    :alt: legalsylvain

Current `maintainer <https://odoo-community.org/page/maintainer-role>`__:

|maintainer-legalsylvain| 

This module is part of the `OCA/pos <https://github.com/OCA/pos/tree/18.0/pos_margin>`_ project on GitHub.

You are welcome to contribute. To learn how please visit https://odoo-community.org/page/Contribute.
