Metadata-Version: 2.1
Name: odoo-addon-base_external_stock
Version: 17.0.1.0.0.1
Requires-Python: >=3.10
Requires-Dist: odoo>=17.0a,<17.1dev
Summary: Base to sync stock data of suppliers from an external webservice
Home-page: https://github.com/sygel-technology/sy-stock-logistics-warehouse
License: AGPL-3
Author: Sygel
Classifier: Programming Language :: Python
Classifier: Framework :: Odoo
Classifier: Framework :: Odoo :: 17.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

===================
Base External Stock
===================

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

.. |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-sygel--technology%2Fsy--stock--logistics--warehouse-lightgray.png?logo=github
    :target: https://github.com/sygel-technology/sy-stock-logistics-warehouse/tree/17.0/base_external_stock
    :alt: sygel-technology/sy-stock-logistics-warehouse

|badge1| |badge2| |badge3|

This module provides a base to allow you to get the stock data of
external suppliers and import it into odoo creating inventory
adjustments

**Table of contents**

.. contents::
   :local:

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

To configure the external inventory adjustments:

1. Go to "Inventory / Configuration / External Inventory Adjustments
   Config"
2. Create a record
3. Select the supplier
4. Select the stock location where its stock will be recorded (Back in
   the external inventory adjustments configuration). The stock in this
   locations should not compute as available stock for the products. We
   recommend an internal stock location whithout parent and childrens,
   with no relation with the main warehouses (you can create a new
   warehouse for this).
5. Review or fill the other configuration fields if needed. They
   configure technical elements of the call, point your cursor over them
   to see their help text. Keep their default values if you do not
   underestand them.
6. Install a module that extends with a concrete implementation. You can
   also put the configuration record in test mode, which contains a
   simple testing implementation of this module's funcionality.

IMPORTANT: The modules that inherit base_external_stock should implement
the \__get_external_stock_data_batch_enabled() and \_test_connection()
functions.

Usage
=====

To manually use this module, you need to:

1. Go to "Inventory / Configuration / External Inventory Adjustments
   Configuration"
2. Open your configured inventory adjustment
3. Click on "Create Inventory Adjustment". You will see the created
   inventory adjustment

Note: If the method configured is the "Asyncronous", the inventory
adjustment will be created in progress. The adjustment will be processed
with a queue of jobs, that will be called gently by the scheduled action
named "External Stock Queues"

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

Bugs are tracked on `GitHub Issues <https://github.com/sygel-technology/sy-stock-logistics-warehouse/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/sygel-technology/sy-stock-logistics-warehouse/issues/new?body=module:%20base_external_stock%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
-------

* Sygel

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

- `Sygel <https://www.sygel.es>`__:

  - Alberto Martínez
  - Valentin Vinagre
  - Harald Panten

Maintainers
-----------

This module is part of the `sygel-technology/sy-stock-logistics-warehouse <https://github.com/sygel-technology/sy-stock-logistics-warehouse/tree/17.0/base_external_stock>`_ project on GitHub.

You are welcome to contribute.
