From c4e40d86a28bb4974b6b725353c79e88c3668795 Mon Sep 17 00:00:00 2001 From: Benjamin Willems Date: Thu, 31 May 2018 12:21:58 -0700 Subject: [PATCH 1/3] Change description of how admins count inventory --- guides/source/developers/inventory/stock-items.html.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/guides/source/developers/inventory/stock-items.html.md b/guides/source/developers/inventory/stock-items.html.md index 4df4857134e..7a7463e0ff2 100644 --- a/guides/source/developers/inventory/stock-items.html.md +++ b/guides/source/developers/inventory/stock-items.html.md @@ -25,8 +25,8 @@ items you have in stock. ## Count on hand -When administrators create a new product using the `solidus_backend`, they can -set an initial inventory "Count On Hand" value for the new product. +Administrators can manage the "Count On Hand" value for every product they sell +on their store. The `count_on_hand` value changes whenever a [stock movement][stock-movements] occurs. For example, if one unit of a product is sold the `count_on_hand` would From 039f1a31759dc91e6abe4b437a5f914ec846be7d Mon Sep 17 00:00:00 2001 From: Benjamin Willems Date: Thu, 31 May 2018 12:22:17 -0700 Subject: [PATCH 2/3] Add stub about product stock backend UI --- guides/source/users/products/product-stock.md | 14 ++++++++++++++ 1 file changed, 14 insertions(+) create mode 100644 guides/source/users/products/product-stock.md diff --git a/guides/source/users/products/product-stock.md b/guides/source/users/products/product-stock.md new file mode 100644 index 00000000000..86ade39419d --- /dev/null +++ b/guides/source/users/products/product-stock.md @@ -0,0 +1,14 @@ +# Product stock + +You can view how many stock items are available for a product while you are +editing it. Go to the **Product Stock** page to see a list of the available +stock items. + +Note that you may see multiple listings for each product, depending on how many +[variants][variants] and [stock locations][stock-locations] that you have +configured. + + + +[variants]: variants.html +[stock-locations]: ../stock/overview.html#stock-locations From 0bdb41362e7e5dcc5912363bea069078f5935e79 Mon Sep 17 00:00:00 2001 From: Benjamin Willems Date: Thu, 31 May 2018 12:22:41 -0700 Subject: [PATCH 3/3] Add initial stock documentation for end users --- guides/source/users/stock/overview.html.md | 78 ++++++++++++++++++++++ 1 file changed, 78 insertions(+) create mode 100644 guides/source/users/stock/overview.html.md diff --git a/guides/source/users/stock/overview.html.md b/guides/source/users/stock/overview.html.md new file mode 100644 index 00000000000..5634a5d9a3e --- /dev/null +++ b/guides/source/users/stock/overview.html.md @@ -0,0 +1,78 @@ +# Overview + +From the **Stock** page of the Solidus admin interface, you can view and manage +the stock for all of your store's products. + +You can change the [**Stock On Hand**](#stock-on-hand) value for any +[product][products] (or variant) in your store after selecting the **Edit** +button next to it. + +Note that you can also [view stock in a product context][product-stock]. + + + +[product-stock]: ../products/product-stock.html + +## Stock information + +On the **Stock** page, you can see the following information about your stock +items: + +- **Item**: Identifying information about the current item. This information + includes the primary product image, the name, and the SKU of the item. +- **Options**: If the current item is [a variant][variants] of a product, this + details which variant it is. For example, which size and color the current + item is. +- **Stock Location**: The [stock location](#stock-locations) of the current + item. +- **Back orderable**: Sets whether the current item should be + [backorderable](#backorderable) or not. +- **Count On Hand**: The number of items that a stock location has of the + current item. See [Count on hand](#count-on-hand) for more information. + +## Filter and search + +You can search for specific stock items. This makes locating stock information +easier when you have hundreds or thousands of products. You can filter by the +following values: + +- **Stock Location**: Choose one of your existing [stock + locations](#stock-locations) to filter results by. +- **Variant**: You can enter a product's SKU or [option value][option-values] to + filter down your results. For example, you could enter a partial SKU to find + a range of products that you know have similar SKUs. Or, you could enter + "Yellow" to find all of the variants with a "Yellow" option value. + +Note that the **Variant** filter searches for option **Name** values +as well as their **Presentation** values. For example, you may an option value +with the name "Extra Large" that is presented as "XL" on your storefront. This +means that you can search for either term and find the same results. + +## Stock locations + +Stock locations represent a location where your inventory is shipped from. For +every stock location that you create, a complete set of stock items that +represents your product collection is also created. + +For example, if your store only sells one product, but it ships the product from +two stock locations, then you should have two items in the list of stock items +on the **Stock** page. + + + +## Count on hand + +For each product you sell in your store, you can manage the **Count On Hand** +value. You may have inventory for this product at multiple stock locations, and +you can manage the count for each location. + +### Changing the count on hand value + +When you update the **Count On Hand** value for a stock item, be aware that you +are resetting the count. + +For example, if your "T-Shirt" product has `5` in stock items and you received +`15` new shirts from your supplier, you should update the **Count On Hand** +value to `20`.