Metadata-Version: 2.1
Name: odoo-addon-route_planning_stock
Version: 18.0.1.1.3
Requires-Python: >=3.10
Requires-Dist: odoo-addon-route_planning==18.0.*
Requires-Dist: odoo==18.0.*
Summary: Route Planning Stock Integration
Home-page: https://github.com/OCA/route-planning
License: AGPL-3
Author: Tecnativa,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

================================
Route Planning Stock Integration
================================

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

.. |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%2Froute--planning-lightgray.png?logo=github
    :target: https://github.com/OCA/route-planning/tree/18.0/route_planning_stock
    :alt: OCA/route-planning
.. |badge4| image:: https://img.shields.io/badge/weblate-Translate%20me-F47D42.png
    :target: https://translation.odoo-community.org/projects/route-planning-18-0/route-planning-18-0-route_planning_stock
    :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/route-planning&target_branch=18.0
    :alt: Try me on Runboat

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

Integration between Route Planning and Stock to automatically generate
routes and checkpoints from pickings.

This module automates route and checkpoint creation directly from stock
pickings and integrates inventory transit locations and stock rules into
Route Planning workflows.

**Key Features:**

- Automatic generation of a Transit Location per Route Area and
  corresponding stock rules.
- Automatic route and checkpoint generation upon picking validation.
- Automated validation of pickings when route checkpoints are marked as
  completed.

When you use the transit location created for the Route Area, the
delivery is performed in two steps:

The first step moves the stock from the internal location where it is
stored to the transit location. This movement represents the physical
transfer from your warehouse to the transport vehicle that will perform
the delivery. A second picking is created when you validate the first
picking. This picking waits for the corresponding checkpoint to be
completed when the delivery is completed at the customer. Once the
checkpoint is completed, the picking is automatically validated.

Note: For better integration and simplicity, we recommend using this
module with the ``route_planning_delivery`` module installed.

**Table of contents**

.. contents::
   :local:

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

- Go to ``Inventory / Configuration / Settings``.
- Enable ``Storage Locations`` and save.

Configuring Route Areas
-----------------------

- Go to ``Route Planning / Configuration / Areas``.
- Create or edit a Route Area.
- Set the Warehouse if you have more than one warehouse. Otherwise, the
  system will use the default warehouse for your company.

Upon saving, the system will automatically:

- Create or update a Transit Location under the warehouse view location.
- Create or update stock rules linking the warehouse stock location, the
  route area transit location, and the customer location.

Creating or Editing an Operation Type
-------------------------------------

- Go to ``Inventory / Configuration / Operation Types``.
- Create or edit an operation type.
- Set the ``Destination Location`` field to the transit location created
  automatically by the Route Area.

Usage
=====

- Create a Delivery Order using an operation type whose Destination
  Location is the transit location created automatically by the Route
  Area.
- Assign the Route Area to the picking.
- Confirm / Validate the picking.
- The system will automatically search for an existing draft route for
  that area and scheduled date, or create a new Route.
- A Route Checkpoint is created and linked to the picking and its
  partner.
- Go to the Route and plan it.
- When the visit to the customer is completed, validate the checkpoint.
  This will automatically validate the picking.

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

Bugs are tracked on `GitHub Issues <https://github.com/OCA/route-planning/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/route-planning/issues/new?body=module:%20route_planning_stock%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
-------

* Tecnativa

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

- Pedro M. Baeza
- Víctor Martínez
- Carlos Lopez

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

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

|maintainer-carlos-lopez-tecnativa| 

This module is part of the `OCA/route-planning <https://github.com/OCA/route-planning/tree/18.0/route_planning_stock>`_ project on GitHub.

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