You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

144 lines
5.1 KiB

  1. ===============================
  2. Point of Sale - Price to Weight
  3. ===============================
  4. .. !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
  5. !! This file is generated by oca-gen-addon-readme !!
  6. !! changes will be overwritten. !!
  7. !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
  8. .. |badge1| image:: https://img.shields.io/badge/maturity-Beta-yellow.png
  9. :target: https://odoo-community.org/page/development-status
  10. :alt: Beta
  11. .. |badge2| image:: https://img.shields.io/badge/licence-AGPL--3-blue.png
  12. :target: http://www.gnu.org/licenses/agpl-3.0-standalone.html
  13. :alt: License: AGPL-3
  14. .. |badge3| image:: https://img.shields.io/badge/github-OCA%2Fpos-lightgray.png?logo=github
  15. :target: https://github.com/OCA/pos/tree/12.0/pos_price_to_weight
  16. :alt: OCA/pos
  17. .. |badge4| image:: https://img.shields.io/badge/weblate-Translate%20me-F47D42.png
  18. :target: https://translation.odoo-community.org/projects/pos-12-0/pos-12-0-pos_price_to_weight
  19. :alt: Translate me on Weblate
  20. .. |badge5| image:: https://img.shields.io/badge/runbot-Try%20me-875A7B.png
  21. :target: https://runbot.odoo-community.org/runbot/184/12.0
  22. :alt: Try me on Runbot
  23. |badge1| |badge2| |badge3| |badge4| |badge5|
  24. This module extends Odoo Point Of Sale features, to allow to scan barcode
  25. with price and to compute according quantity.
  26. In Odoo by default, there are three types of barcode rules for products.
  27. * 'Unit Product' (type='product'). Scanning a product will add a unit of this
  28. product to the current order.
  29. * 'Priced product' (type='price'). A price is extracted from the barcode, and
  30. a new line with the given price and a quantity = 1 is added to the current
  31. order.
  32. * 'Weighted product' (type='weight). A weight is extracted from the barcode,
  33. and a new line with the given weight, and a computed price
  34. (quantity * Unit price) is added to the current order.
  35. This module add a new option:
  36. * 'Priced Product (Computed Weight)' (type='price_to_weight'). A price is
  37. extracted from the barcode, and a new line with the given price, and a
  38. computed quantity (Price / Unit Price) is added to the current order.
  39. .. image:: https://raw.githubusercontent.com/OCA/pos/12.0/pos_price_to_weight/static/description/barcode_rule.png
  40. :width: 800 px
  41. This module is usefull in shops with products scaled, to manage correctly
  42. stock quantities.
  43. Samples
  44. * Given a product with a unit price of 1,50€ / kg
  45. * The barcode is 0212345{NNNDD}x where:
  46. * 02 is the prefix of the barcode rule
  47. * 12345 is the product number
  48. * {NNNDD} is the price of the scaled product
  49. * x is the control digit
  50. if {NNNDD} is 00265, the price is so 2,65€ and the according quantity is
  51. 2,65€ / 1,5 €/kg = 1,767 kg
  52. .. image:: https://raw.githubusercontent.com/OCA/pos/12.0/pos_price_to_weight/static/description/pos_test_1.png
  53. :width: 800 px
  54. if {NNNDD} is 00810, the price is so 8,10€ and the according quantity is
  55. 8,10€ / 1,5 €/kg = 5,400 kg
  56. .. image:: https://raw.githubusercontent.com/OCA/pos/12.0/pos_price_to_weight/static/description/pos_test_2.png
  57. :width: 800 px
  58. **Table of contents**
  59. .. contents::
  60. :local:
  61. Configuration
  62. =============
  63. * Go to Point of Sale > Configuration > Barcode Nomenclatures
  64. * Edit your barcode rules, according to your barcodes settings
  65. * Go to Point of Sale > Configuration > Point of Sale
  66. * Select the 'Unit Price' field that will be used to convert the price to weight.
  67. .. image:: https://raw.githubusercontent.com/OCA/pos/12.0/pos_price_to_weight/static/description/pos_config_form.png
  68. :width: 800 px
  69. **Note:**
  70. By default, this is the field ``list_price`` that will be used.
  71. If you want to use a custom field, it should be loaded in the javascript file calling
  72. ``models.load_fields("product.product", ['my_custom_field']);``
  73. Bug Tracker
  74. ===========
  75. Bugs are tracked on `GitHub Issues <https://github.com/OCA/pos/issues>`_.
  76. In case of trouble, please check there if your issue has already been reported.
  77. If you spotted it first, help us smashing it by providing a detailed and welcomed
  78. `feedback <https://github.com/OCA/pos/issues/new?body=module:%20pos_price_to_weight%0Aversion:%2012.0%0A%0A**Steps%20to%20reproduce**%0A-%20...%0A%0A**Current%20behavior**%0A%0A**Expected%20behavior**>`_.
  79. Do not contact contributors directly about support or help with technical issues.
  80. Credits
  81. =======
  82. Authors
  83. ~~~~~~~
  84. * La Louve
  85. * GRAP
  86. Contributors
  87. ~~~~~~~~~~~~
  88. * Sylvain LE GAL <https://twitter.com/legalsylvain>
  89. * Druidoo <https://www.druidoo.io>
  90. Other credits
  91. ~~~~~~~~~~~~~
  92. Icon parts come from http://icons8.com
  93. Maintainers
  94. ~~~~~~~~~~~
  95. This module is maintained by the OCA.
  96. .. image:: https://odoo-community.org/logo.png
  97. :alt: Odoo Community Association
  98. :target: https://odoo-community.org
  99. OCA, or the Odoo Community Association, is a nonprofit organization whose
  100. mission is to support the collaborative development of Odoo features and
  101. promote its widespread use.
  102. This module is part of the `OCA/pos <https://github.com/OCA/pos/tree/12.0/pos_price_to_weight>`_ project on GitHub.
  103. You are welcome to contribute. To learn how please visit https://odoo-community.org/page/Contribute.