account-closing/account_cutoff_picking/README.rst

=======================
Account Cut-off Picking
=======================

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

.. |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%2Faccount--closing-lightgray.png?logo=github
    :target: https://github.com/OCA/account-closing/tree/17.0/account_cutoff_picking
    :alt: OCA/account-closing
.. |badge4| image:: https://img.shields.io/badge/weblate-Translate%20me-F47D42.png
    :target: https://translation.odoo-community.org/projects/account-closing-17-0/account-closing-17-0-account_cutoff_picking
    :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/account-closing&target_branch=17.0
    :alt: Try me on Runboat

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

This module generates expense/revenue accruals and prepaid
expense/revenue based on the status of orders, pickings and invoices.
The module is named *account_cutoff_accrual_picking* because it
initially only supported accruals ; support for prepaid expense/revenue
was added later (it should be renamed in later versions).

To understand the behavior of this module, let's take the example of an
expense accrual. When you click on the button *Re-Generate Lines* of an
*Expense Accrual*:

1. Odoo will look for all incoming picking in Done state with a
   *Transfer Date* <= *Cut-off Date*. For performance reasons, by
   default, the incoming picking dated before *Cut-off Date* minus 30
   days will not be taken into account (this limit is configurable via
   the field *Picking Analysis*). It will go to the stock moves of those
   pickings and see if they are linked to a purchase order line.
2. Once this analysis is completed, Odoo has a list of purchase order
   lines to analyse for potential expense accrual.
3. For each of these purchase order lines, Odoo will:

   -  scan the related stock moves in *done* state and check their
      transfer date,
   -  scan the related invoices lines and check their invoice date.

4. If, for a particular purchase order line, the quantity of products
   received before the cutoff-date (or on the same day) minus the
   quantity of products invoiced before the cut-off date (or on the same
   day) is positive, Odoo will generate a cut-off line.

Now, let's take the example of a prepaid expense. When you click on the
button *Re-Generate Lines* of a *Prepaid Expense*:

1. Odoo will look for all vendor bills dated before (or equal to)
   *Cut-off Date*. For performance reasons, by default, the vendor bills
   dated before *Cut-off Date* minus 30 days will not be taken into
   account (this limit is configurable via the field *Picking
   Analysis*). It will go to the invoice lines of those vendor bills and
   see if they are linked to a purchase order line.
2. Once this analysis is completed, Odoo has a list of purchase order
   lines to analyse for potential prepaid expense.
3. For each of these purchase order lines, Odoo will:

   -  scan the related stock moves in *done* state and check their
      transfer date,
   -  scan the related invoices lines and check their invoice date.

4. If, for a particular purchase order line, the quantity of products
   invoiced before the cutoff-date (or on the same day) minus the
   quantity of products received before the cut-off date (or on the same
   day) is positive, Odoo will generate a cut-off line.

This module should work well with multiple units of measure (including
products purchased and invoiced in different units of measure) and in
multi-currency.

**Table of contents**

.. contents::
   :local:

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

For configuration instructions, refer to the README of the module
*account_cutoff_base*.

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

Bugs are tracked on `GitHub Issues <https://github.com/OCA/account-closing/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/account-closing/issues/new?body=module:%20account_cutoff_picking%0Aversion:%2017.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
-------

* Akretion

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

-  Alexis de Lattre <alexis.delattre@akretion.com>

Other credits
-------------

The migration of this module from 16.0 to 17.0 was financially supported
by Camptocamp

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-alexis-via| image:: https://github.com/alexis-via.png?size=40px
    :target: https://github.com/alexis-via
    :alt: alexis-via

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

|maintainer-alexis-via| 

This module is part of the `OCA/account-closing <https://github.com/OCA/account-closing/tree/17.0/account_cutoff_picking>`_ project on GitHub.

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