diff --git a/pos_cash_move_reason/README.rst b/pos_cash_move_reason/README.rst index 20c0ce506a..30630ca551 100644 --- a/pos_cash_move_reason/README.rst +++ b/pos_cash_move_reason/README.rst @@ -17,32 +17,31 @@ POS cash in-out reason :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/15.0/pos_cash_move_reason + :target: https://github.com/OCA/pos/tree/17.0/pos_cash_move_reason :alt: OCA/pos .. |badge4| image:: https://img.shields.io/badge/weblate-Translate%20me-F47D42.png - :target: https://translation.odoo-community.org/projects/pos-15-0/pos-15-0-pos_cash_move_reason + :target: https://translation.odoo-community.org/projects/pos-17-0/pos-17-0-pos_cash_move_reason :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=15.0 + :target: https://runboat.odoo-community.org/builds?repo=OCA/pos&target_branch=17.0 :alt: Try me on Runboat |badge1| |badge2| |badge3| |badge4| |badge5| -This module allow to define some reasons for the functionality of -"Put Money In" and "Take Money Out" available in point of sale session. +This module allow to define some reasons for the functionality of "Put +Money In" and "Take Money Out" available in point of sale session. -So, with this module it's possible to impact directly an expense or income -account which is defined on the related reasons and create according -accounting entries. +So, with this module it's possible to impact directly an expense or +income account which is defined on the related reasons and create +according accounting entries. **Typical Use Case (not exhaustive)** -* You want to track **Bank deposit** moves, using an intermediate - bank account named 'Cash Awaiting Bank Deposit'. - (In France, for instance, "581 - Espèce en attente d'encaissement") - -* You want to allow payments from Cash Journal to pay recurring - little expenses. (Gasoline, parking meter, etc.) +- You want to track **Bank deposit** moves, using an intermediate bank + account named 'Cash Awaiting Bank Deposit'. (In France, for instance, + "581 - Espèce en attente d'encaissement") +- You want to allow payments from Cash Journal to pay recurring little + expenses. (Gasoline, parking meter, etc.) **Table of contents** @@ -52,75 +51,79 @@ accounting entries. Configuration ============= -* Go to 'Point of Sale' / 'Configuration' / 'Move Reason' +- Go to 'Point of Sale' / 'Configuration' / 'Move Reason' -.. figure:: https://raw.githubusercontent.com/OCA/pos/15.0/pos_cash_move_reason/static/description/pos_cash_move_tree.png - :alt: PoS Move Reasons List +|image1| -* Create or update your PoS move Reasons. -* for each reason, you can mention the concerned journal(s), (Generally the - Cash Journal), and if it is a reason to 'put in' and / or to 'take out' - Money. +- Create or update your PoS move Reasons. +- for each reason, you can mention the concerned journal(s), (Generally + the Cash Journal), and if it is a reason to 'put in' and / or to + 'take out' Money. -.. figure:: https://raw.githubusercontent.com/OCA/pos/15.0/pos_cash_move_reason/static/description/pos_cash_move_form.png - :alt: PoS Move Reason +|image2| **Note** -You should have checked first 'Used in Point of Sale' for the Journals you want -to enable the feature. +You should have checked first 'Used in Point of Sale' for the Journals +you want to enable the feature. + +.. |image1| image:: https://raw.githubusercontent.com/OCA/pos/17.0/pos_cash_move_reason/static/description/pos_cash_move_tree.png +.. |image2| image:: https://raw.githubusercontent.com/OCA/pos/17.0/pos_cash_move_reason/static/description/pos_cash_move_form.png Usage ===== -* Go to your current session +- Go to your current session +- Click on the button "Put Money In" or "Take Money Out" -* Click on the button "Put Money In" or "Take Money Out" +|image1| -.. figure:: https://raw.githubusercontent.com/OCA/pos/15.0/pos_cash_move_reason/static/description/pos_session_form.png +- Select the reason, the journal, the amount, and optionaly an extra + description -* Select the reason, the journal, the amount, and optionaly an extra - description +|image2| -.. figure:: https://raw.githubusercontent.com/OCA/pos/15.0/pos_cash_move_reason/static/description/wizard_pos_move_reason_form.png +- When closing the session, an account move will be created, with two + lines, one with the default journal account, and one with the expense + / income reason account. -* When closing the session, an account move will be created, with two lines, - one with the default journal account, and one with the expense / income - reason account. +|image3| -.. figure:: https://raw.githubusercontent.com/OCA/pos/15.0/pos_cash_move_reason/static/description/account_move_form.png +.. |image1| image:: https://raw.githubusercontent.com/OCA/pos/17.0/pos_cash_move_reason/static/description/pos_session_form.png +.. |image2| image:: https://raw.githubusercontent.com/OCA/pos/17.0/pos_cash_move_reason/static/description/wizard_pos_move_reason_form.png +.. |image3| image:: https://raw.githubusercontent.com/OCA/pos/17.0/pos_cash_move_reason/static/description/account_move_form.png Known issues / Roadmap ====================== -As it is not possible to disable actions on Odoo, a new technical group is -added by this module, named 'Use Old PoS 'Put or Take Money' Actions', to -hide native obsolete actions available on the model ``pos.session`` -(the two buttons "Take Money Out" and "Put Money In") +As it is not possible to disable actions on Odoo, a new technical group +is added by this module, named 'Use Old PoS 'Put or Take Money' +Actions', to hide native obsolete actions available on the model +``pos.session`` (the two buttons "Take Money Out" and "Put Money In") Changelog ========= 12.0.3.0.0 (2019-08-13) -~~~~~~~~~~~~~~~~~~~~~~~ +----------------------- -* [MIG] Port module to version 12.0. -* [REF] Don't use ``product.product`` model for Reasons, because Odoo remove - the fields ``expense_pdt`` ``and income_pdt`` from the model. - Use instead a new model ``pos.move.reason`` for this purpose. -* [REF] Doesn't inherit from ``cash.box.in`` and ``cash.box.out`` model, - as there are bad designed and doesn't allow clean inheritance. - Instead, use new transient model ``wizard.pos.move.reason``. +- [MIG] Port module to version 12.0. +- [REF] Don't use ``product.product`` model for Reasons, because Odoo + remove the fields ``expense_pdt`` ``and income_pdt`` from the model. + Use instead a new model ``pos.move.reason`` for this purpose. +- [REF] Doesn't inherit from ``cash.box.in`` and ``cash.box.out`` + model, as there are bad designed and doesn't allow clean inheritance. + Instead, use new transient model ``wizard.pos.move.reason``. 8.0.2.0.0 (2018-06-25) -~~~~~~~~~~~~~~~~~~~~~~ +---------------------- -* [REF] Minor code refactoring. +- [REF] Minor code refactoring. 8.0.1.0.0 (2017-06-08) -~~~~~~~~~~~~~~~~~~~~~~ +---------------------- -* First Version of the module. +- First Version of the module. Bug Tracker =========== @@ -128,7 +131,7 @@ Bug Tracker Bugs are tracked on `GitHub 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 `_. +`feedback `_. Do not contact contributors directly about support or help with technical issues. @@ -136,19 +139,19 @@ Credits ======= Authors -~~~~~~~ +------- * ACSONE SA/NV * GRAP Contributors -~~~~~~~~~~~~ +------------ -* Sylvain LE GAL -* Dhara Solanki +- Sylvain LE GAL +- Dhara Solanki Maintainers -~~~~~~~~~~~ +----------- This module is maintained by the OCA. @@ -160,6 +163,6 @@ 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. -This module is part of the `OCA/pos `_ project on GitHub. +This module is part of the `OCA/pos `_ project on GitHub. You are welcome to contribute. To learn how please visit https://odoo-community.org/page/Contribute. diff --git a/pos_cash_move_reason/pyproject.toml b/pos_cash_move_reason/pyproject.toml new file mode 100644 index 0000000000..4231d0cccb --- /dev/null +++ b/pos_cash_move_reason/pyproject.toml @@ -0,0 +1,3 @@ +[build-system] +requires = ["whool"] +build-backend = "whool.buildapi" diff --git a/pos_cash_move_reason/readme/CONFIGURE.md b/pos_cash_move_reason/readme/CONFIGURE.md new file mode 100644 index 0000000000..587cf0deb5 --- /dev/null +++ b/pos_cash_move_reason/readme/CONFIGURE.md @@ -0,0 +1,15 @@ +- Go to 'Point of Sale' / 'Configuration' / 'Move Reason' + +![](../static/description/pos_cash_move_tree.png) + +- Create or update your PoS move Reasons. +- for each reason, you can mention the concerned journal(s), (Generally + the Cash Journal), and if it is a reason to 'put in' and / or to 'take + out' Money. + +![](../static/description/pos_cash_move_form.png) + +**Note** + +You should have checked first 'Used in Point of Sale' for the Journals +you want to enable the feature. diff --git a/pos_cash_move_reason/readme/CONFIGURE.rst b/pos_cash_move_reason/readme/CONFIGURE.rst deleted file mode 100644 index 8f1e74215c..0000000000 --- a/pos_cash_move_reason/readme/CONFIGURE.rst +++ /dev/null @@ -1,17 +0,0 @@ -* Go to 'Point of Sale' / 'Configuration' / 'Move Reason' - -.. figure:: ../static/description/pos_cash_move_tree.png - :alt: PoS Move Reasons List - -* Create or update your PoS move Reasons. -* for each reason, you can mention the concerned journal(s), (Generally the - Cash Journal), and if it is a reason to 'put in' and / or to 'take out' - Money. - -.. figure:: ../static/description/pos_cash_move_form.png - :alt: PoS Move Reason - -**Note** - -You should have checked first 'Used in Point of Sale' for the Journals you want -to enable the feature. diff --git a/pos_cash_move_reason/readme/CONTRIBUTORS.md b/pos_cash_move_reason/readme/CONTRIBUTORS.md new file mode 100644 index 0000000000..17c0087b86 --- /dev/null +++ b/pos_cash_move_reason/readme/CONTRIBUTORS.md @@ -0,0 +1,2 @@ +- Sylvain LE GAL \<\> +- Dhara Solanki \<\> diff --git a/pos_cash_move_reason/readme/CONTRIBUTORS.rst b/pos_cash_move_reason/readme/CONTRIBUTORS.rst deleted file mode 100644 index fb83b4a946..0000000000 --- a/pos_cash_move_reason/readme/CONTRIBUTORS.rst +++ /dev/null @@ -1,2 +0,0 @@ -* Sylvain LE GAL -* Dhara Solanki diff --git a/pos_cash_move_reason/readme/DESCRIPTION.md b/pos_cash_move_reason/readme/DESCRIPTION.md new file mode 100644 index 0000000000..315bdf687f --- /dev/null +++ b/pos_cash_move_reason/readme/DESCRIPTION.md @@ -0,0 +1,14 @@ +This module allow to define some reasons for the functionality of "Put +Money In" and "Take Money Out" available in point of sale session. + +So, with this module it's possible to impact directly an expense or +income account which is defined on the related reasons and create +according accounting entries. + +**Typical Use Case (not exhaustive)** + +- You want to track **Bank deposit** moves, using an intermediate bank + account named 'Cash Awaiting Bank Deposit'. (In France, for instance, + "581 - Espèce en attente d'encaissement") +- You want to allow payments from Cash Journal to pay recurring little + expenses. (Gasoline, parking meter, etc.) diff --git a/pos_cash_move_reason/readme/DESCRIPTION.rst b/pos_cash_move_reason/readme/DESCRIPTION.rst deleted file mode 100644 index e832eba6d0..0000000000 --- a/pos_cash_move_reason/readme/DESCRIPTION.rst +++ /dev/null @@ -1,15 +0,0 @@ -This module allow to define some reasons for the functionality of -"Put Money In" and "Take Money Out" available in point of sale session. - -So, with this module it's possible to impact directly an expense or income -account which is defined on the related reasons and create according -accounting entries. - -**Typical Use Case (not exhaustive)** - -* You want to track **Bank deposit** moves, using an intermediate - bank account named 'Cash Awaiting Bank Deposit'. - (In France, for instance, "581 - Espèce en attente d'encaissement") - -* You want to allow payments from Cash Journal to pay recurring - little expenses. (Gasoline, parking meter, etc.) diff --git a/pos_cash_move_reason/readme/HISTORY.md b/pos_cash_move_reason/readme/HISTORY.md new file mode 100644 index 0000000000..431b2b76aa --- /dev/null +++ b/pos_cash_move_reason/readme/HISTORY.md @@ -0,0 +1,17 @@ +## 12.0.3.0.0 (2019-08-13) + +- \[MIG\] Port module to version 12.0. +- \[REF\] Don't use `product.product` model for Reasons, because Odoo + remove the fields `expense_pdt` `and income_pdt` from the model. Use + instead a new model `pos.move.reason` for this purpose. +- \[REF\] Doesn't inherit from `cash.box.in` and `cash.box.out` model, + as there are bad designed and doesn't allow clean inheritance. + Instead, use new transient model `wizard.pos.move.reason`. + +## 8.0.2.0.0 (2018-06-25) + +- \[REF\] Minor code refactoring. + +## 8.0.1.0.0 (2017-06-08) + +- First Version of the module. diff --git a/pos_cash_move_reason/readme/HISTORY.rst b/pos_cash_move_reason/readme/HISTORY.rst deleted file mode 100644 index 1c52ee530f..0000000000 --- a/pos_cash_move_reason/readme/HISTORY.rst +++ /dev/null @@ -1,20 +0,0 @@ -12.0.3.0.0 (2019-08-13) -~~~~~~~~~~~~~~~~~~~~~~~ - -* [MIG] Port module to version 12.0. -* [REF] Don't use ``product.product`` model for Reasons, because Odoo remove - the fields ``expense_pdt`` ``and income_pdt`` from the model. - Use instead a new model ``pos.move.reason`` for this purpose. -* [REF] Doesn't inherit from ``cash.box.in`` and ``cash.box.out`` model, - as there are bad designed and doesn't allow clean inheritance. - Instead, use new transient model ``wizard.pos.move.reason``. - -8.0.2.0.0 (2018-06-25) -~~~~~~~~~~~~~~~~~~~~~~ - -* [REF] Minor code refactoring. - -8.0.1.0.0 (2017-06-08) -~~~~~~~~~~~~~~~~~~~~~~ - -* First Version of the module. diff --git a/pos_cash_move_reason/readme/ROADMAP.md b/pos_cash_move_reason/readme/ROADMAP.md new file mode 100644 index 0000000000..e45781bf5a --- /dev/null +++ b/pos_cash_move_reason/readme/ROADMAP.md @@ -0,0 +1,4 @@ +As it is not possible to disable actions on Odoo, a new technical group +is added by this module, named 'Use Old PoS 'Put or Take Money' +Actions', to hide native obsolete actions available on the model +`pos.session` (the two buttons "Take Money Out" and "Put Money In") diff --git a/pos_cash_move_reason/readme/ROADMAP.rst b/pos_cash_move_reason/readme/ROADMAP.rst deleted file mode 100644 index e9e7a13683..0000000000 --- a/pos_cash_move_reason/readme/ROADMAP.rst +++ /dev/null @@ -1,4 +0,0 @@ -As it is not possible to disable actions on Odoo, a new technical group is -added by this module, named 'Use Old PoS 'Put or Take Money' Actions', to -hide native obsolete actions available on the model ``pos.session`` -(the two buttons "Take Money Out" and "Put Money In") diff --git a/pos_cash_move_reason/readme/USAGE.md b/pos_cash_move_reason/readme/USAGE.md new file mode 100644 index 0000000000..4c7fb9fed0 --- /dev/null +++ b/pos_cash_move_reason/readme/USAGE.md @@ -0,0 +1,15 @@ +- Go to your current session +- Click on the button "Put Money In" or "Take Money Out" + +![](../static/description/pos_session_form.png) + +- Select the reason, the journal, the amount, and optionaly an extra + description + +![](../static/description/wizard_pos_move_reason_form.png) + +- When closing the session, an account move will be created, with two + lines, one with the default journal account, and one with the expense + / income reason account. + +![](../static/description/account_move_form.png) diff --git a/pos_cash_move_reason/readme/USAGE.rst b/pos_cash_move_reason/readme/USAGE.rst deleted file mode 100644 index ce5f7237a4..0000000000 --- a/pos_cash_move_reason/readme/USAGE.rst +++ /dev/null @@ -1,16 +0,0 @@ -* Go to your current session - -* Click on the button "Put Money In" or "Take Money Out" - -.. figure:: ../static/description/pos_session_form.png - -* Select the reason, the journal, the amount, and optionaly an extra - description - -.. figure:: ../static/description/wizard_pos_move_reason_form.png - -* When closing the session, an account move will be created, with two lines, - one with the default journal account, and one with the expense / income - reason account. - -.. figure:: ../static/description/account_move_form.png