[ADD] sales:sell amazon fba products by serial or lots

content/applications/inventory_and_mrp/manufacturing/advanced_configuration/kit_shipping.rst

@@ -10,14 +10,16 @@ also useful tools for managing more complex bills of materials (BoMs).
    To use, manufacture, and sell kits, both the :guilabel:`Manufacturing` and :guilabel:`Inventory`
    apps need to be installed.
 
+.. _manufacturing/adv-configuration/kits:
+
 Create the kit as a product
 ===========================
 
 To use a kit as a sellable product, or as a component organization tool, the kit should first be
 created as a product.
 
-To create a kit product, go to :menuselection:`Inventory app --> Products --> Products`, and then
-click :guilabel:`New`.
+To create a kit product, go to :menuselection:`Manufacturing app --> Products --> Products`, and
+then click :guilabel:`New`.
 
 Then, assign a name to the new kit product. Next, set the kit's product type depending on inventory
 tracking needs and accounting requirements. To do this, under the :guilabel:`General Information`
@@ -72,6 +74,8 @@ Regardless of which setup is used, there are some similarities between the two o
 * **Kit Value Does Not Change**: The stock's value is the same whether the kit's is tracked.
 * **Kit Internal Transfers**: An internal transfer for the kit breaks it into components.
 
+.. _manufacturing/adv-configuration/kit-bom:
+
 Set up the kit BoM
 ==================
 

content/applications/inventory_and_mrp/manufacturing/basic_setup/bill_configuration.rst

@@ -11,6 +11,8 @@ respective quantities, that are needed to produce or repair a product. In Odoo,
 blueprints for manufactured goods and kits, and often include production operations and step-by-step
 guidelines, as well.
 
+.. _manufacturing/basic-setup/bom-setup:
+
 BoM setup
 =========
 

content/applications/sales/sales/amazon_connector.rst

@@ -10,3 +10,4 @@ Amazon Connector
    amazon_connector/features
    amazon_connector/setup
    amazon_connector/manage
+   amazon_connector/fba

content/applications/sales/sales/amazon_connector/fba.rst

@@ -0,0 +1,92 @@
+=============================================
+Tracking serial/lot products with FBA orders
+=============================================
+
+When selling products tracked by serial numbers or lots via the Fullfilled By Amazon :abbr:`FBA
+(Fulfilled by Amazon)`, Amazon's API does not send the specific serials or lots used for the sale.
+The lack of information prevents the Odoo Amazon connector from validating the necessary stock move,
+consequently stopping the creation of the :abbr:`Sales Order (SO)`.
+
+To enable product tracking using the Amazon :abbr:`FBA (Fulfilled by Amazon)` orders, the user must
+configure a :ref:`kit product <manufacturing/adv-configuration/kits>` in Odoo and manage stock
+replenishment for that kit.
+
+Setting configuration
+=====================
+
+This workflow requires the **Sales**, **Inventory**, and **Manufacturing** apps to be installed.
+
+Create the kit product
+======================
+
+Navigate to :menuselection:`Manufacturing app --> Products --> Products` and click :guilabel:`New`.
+Then :ref:`create a kit as a product <manufacturing/adv-configuration/kits>` that will represent the
+Amazon item. Deselect the :guilabel:`Track Inventory` checkbox.
+
+.. important::
+   **Do not** enable any tracking for this product.
+
+.. image:: fba/kit-product-form.png
+   :alt: Example of a product form configured to be a kit in the Inventory app.
+
+Link the Amazon item SKU
+------------------------
+
+Next, go to the :menuselection:`Sales app --> Configuration ---> Offers` and click :guilabel:`New`.
+Type in the desired :guilabel:`Marketplace` and in the :guilabel:`Product` column, select the Odoo
+kit product. In the :guilabel:`Amazon SKU` column enter in the SKU for the desired Amazon item.
+
+Select the desired options for the following columns:
+
+- :guilabel:`Fulfullment Channel`
+- :guilabel:`Stock Synchronization`
+
+
+Create the product BoM
+----------------------
+
+Navigate by to the kit product using :menuselection:`Sales app --> Products --> Products` and select
+the kit product. Click on the :icon:`fa-flack` :guilabel:`Bill of Materials` icon. :ref:`Create a
+BoM <manufacturing/adv-configuration/kit-bom>`. In the :guilabel:`Components` tab click
+:guilabel:`Add a line` and type in the name of the Odoo kit product.
+
+.. important::
+   The Odoo kit product **must** be the sole component of the kit.
+
+   When a new FBA order syncs, Odoo sells the non-tracked Kit Product, which triggers the
+   consumption of the Lot/Serial-tracked Amazon product, bypassing the validation error.
+
+Stock replenishment
+===================
+
+Standard internal transfers (WH/Stock to WH/Amazon) of the kit product are not possible because Odoo
+moves the components (the Amazon product) instead of the kit products, which won't deduct from stock
+correctly when the FBA order arrives.
+
+The solutions is to create a :abbr:`Manufacturing Order (MO)` for replenishment. The following
+workflow is adjusts stock correctly in the Amazon Location.
+
+Create a second BoM
+-------------------
+Navigate to :menuselection:`Manufacture app --> Products --> Bill of Materials`. :ref:`Create a
+second BoM <manufacturing/basic-setup/bom-setup>` and select :guilabel:`BoM Type` as
+:guilabel:`Manufacture this product`.
+
+In the :guilabel:`Components` tab click :guilabel:`Add a line` and type in the name of the Odoo kit
+product.
+
+Create a Manufacturing Order (MO)
+---------------------------------
+
+Navigate to :menuselection:`Manufacturing app --> Operations --> Manufacturing Orders` and click
+:guilabel:`New`. Create a new Manufacturing Order for the desired quantity of the Kit Product.
+
+
+Create a "FBA resupply" operation type by duplicating the original "Manufacture". On this operation
+type, in the locations; define the default destination location as WH/Amazon.
+
+On the BOM, select "FBA resupply" as routing in the Miscellaneous tab.
+
+This :abbr:`MO (Manufacturing Order)` consumes the Lot/Serial-tracked Original Product from the main
+WH/Stock and "builds" the non-tracked Kit Product directly into the WH/Amazon location, correctly
+representing the FBA stock.