Initial commit: OCA Technical packages (595 packages)

odoo-bringout-oca-pos-pos_picking_delayed/pos_picking_delayed/README.rst

@@ -0,0 +1,144 @@
+========================================
+Point of Sale - Picking Creation Delayed
+========================================
+
+.. 
+   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+   !! This file is generated by oca-gen-addon-readme !!
+   !! changes will be overwritten.                   !!
+   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+   !! source digest: sha256:0dba587a9bb0737c10fa5c7a62c9dec15cb1614fb6f13459c2d59447d7d6b244
+   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+
+.. |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/licence-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/16.0/pos_picking_delayed
+    :alt: OCA/pos
+.. |badge4| image:: https://img.shields.io/badge/weblate-Translate%20me-F47D42.png
+    :target: https://translation.odoo-community.org/projects/pos-16-0/pos-16-0-pos_picking_delayed
+    :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=16.0
+    :alt: Try me on Runboat
+
+|badge1| |badge2| |badge3| |badge4| |badge5|
+
+This module extends the functionality of odoo Point Of Sale to reduce creation
+time of the PoS orders, via the front UI.
+
+For that purpose, it delays the creation of the picking associated, that will
+be created later by queue job.
+
+This module is interesting specially in a context of Synchroneous Point Of
+Sale that is introduced by certification modules like 'l10n_fr_pos_cert' because
+in such cases, the bill will be printed only when the pos order is created (
+after the call of the function create_from_ui) and the creation of the picking
+is the process that takes the most time.
+
+See https://github.com/odoo/odoo/pull/26314#issuecomment-422949266
+for more information.
+
+**Table of contents**
+
+.. contents::
+   :local:
+
+Configuration
+=============
+
+* Go to 'Point of Sale' / 'Configuration' / 'Point of Sale'
+* Select your Point of Sale
+* Set the value in the field 'Picking Creation Delayed'. (Checked by default)
+
+.. image:: https://raw.githubusercontent.com/pos_picking_delayed/static/description/pos_config_form.png
+
+* This module depends on ``queue_job`` module that requires specific
+  configuration to works properly. Make sure your config file is correctly set.
+  See https://github.com/OCA/queue/tree/12.0/queue_job
+
+You should update your ``odoo.cfg`` file to add a new channel named
+``root.pos_picking_delayed``:
+
+
+.. code-block::
+
+  [queue_job]
+  channels = root:2,root.pos_picking_delayed:1
+
+Otherwise, you'll have a non blocking warning in your log, like this one.
+
+.. code-block::
+
+  WARNING ? odoo.addons.queue_job.jobrunner.channels: unknown channel root.pos_picking_delayed, using root channel for job 23f6b872-1d2c-4003-bd38-a8486bbec664
+
+Usage
+=====
+
+* Use your Point of Sale as usual. When validating an order, the order will
+  be in a different color until the job is executed
+
+.. image:: https://raw.githubusercontent.com/pos_picking_delayed/static/description/pos_order_tree.png
+
+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_picking_delayed%0Aversion:%2016.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
+
+Contributors
+~~~~~~~~~~~~
+
+* Sylvain LE GAL <https://twitter.com/legalsylvain>
+* `Tecnativa <https://www.tecnativa.com>`_:
+
+  * Carlos Roca
+
+Other credits
+~~~~~~~~~~~~~
+
+The development of this module has been financially supported by:
+
+* GRAP, Groupement Régional Alimentaire de Proximité (www.grap.coop)
+* Mind & Go, (https://mind-and-go.com/)
+
+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/16.0/pos_picking_delayed>`_ project on GitHub.
+
+You are welcome to contribute. To learn how please visit https://odoo-community.org/page/Contribute.