first draft

Author: Jo

docs/partials/inventory/multi-location/overview.mdx

@@ -0,0 +1,22 @@
+The Inventory API allows you to optionally manage stock across multiple locations, giving you better control over your inventory and improving stock accuracy. By offering localized stock information and flexible order fulfilment options, you can enhance your customer's shopping experience.
+
+For example, you can use multi-location inventory to support the "Buy Online, Pick Up In-Store" process. Tagging inventory with specific locations, allows you to select a designated location for dispatch when adding stock to a product, ensuring that inventory is accurately tracked and readily available for in-store pickup orders. Multi-location inventory optimizes your fulfillment process by aligning stock with the most appropriate physical locations, improving efficiency and boosting customer satisfaction.
+
+## Setting-up Locations
+
+You can create locations for one or more locations.
+
+- Create locations, including name, description, and GPS location.
+- Import stock location positions.
+- Delete stock for products at specific locations.
+
+## Managing Inventory Locations
+
+- Merchandizers can explicitly set stock to for locations.
+- Merchandizers can change stock.
+- Merchandisers can move stock between locations automatically, stock positions can be updated in order with near real-time batch updates.
+- Merchandisers can identify the source of a stock position.
+- Merchandizers can see if there are failures when updating stock positions.
+- Locations can be disabled/enabled.
+
+

docs/partials/inventory/overview.mdx

@@ -0,0 +1,13 @@
+The Inventory API allows you to manage stock for products at both organization and store levels.
+
+Inventory is the quantity of each product that you have in stock. The inventory service allows you and your business to keep track of inventory, optionally at different locations, and including a transactional historic log.
+
+## What is Inventory?
+
+Inventory for each product is tracked using the following values:
+
+- **Total**: The amount of product in stock. This can be expressed by the following equation: Total = Available + Allocated
+- **Available**: The amount of product available in stock minus allocated products. This can be expressed by the following equation: Available = Total - Allocated)
+- **Allocated**: The amount of reserved product in stock.
+- **Location**: The location of the stock. For each location, this can be expressed by the following equation: Total = Available + Allocated. One or more locations contributes to an aggregated stock total.
+