Customer Provided Items Documentation

foundation/www/docs/user/manual/en/manufacturing/articles/customer-provided-items.md

@@ -0,0 +1,41 @@
+<!-- add-breadcrumbs -->
+# Customer Provided Items
+
+In Contract Manufacturing, in some cases Customer provides specific items as one or few of the BOM components. These items cannot be received using a `Buying Cycle` since that will mean making Customer as a Supplier at the same time and it will go through each doctype in the cycle.
+
+In this feature, Customer Provided Item is received through `Stock Entry` from a `Material Request` with type `Customer provided`.
+
+<img alt="Customer Provided Material Request" class="screenshot" src="{{docs_base_url}}/assets/img/articles/material-request-customer-provided.png">
+
+Here are the steps on how to setup a `Customer Provided` item.
+
+1.  Got to Item Doctype and add a new `Customer Provided` item.
+
+    `Stock > Item >`
+
+2.  In the `Purchase, Replenishment Details` section, check `Is Customer
+    Provided` and set a default `Customer`.
+
+    <img alt="Item Purchase Details" class="screenshot" src="{{docs_base_url}}/assets/img/stock/item-purchase.png">
+
+How to receive a `Customer Provided` Items?
+
+1.  If `Production Plan` is used, `Material Request` for this items can be auto
+    created.
+
+    <img alt="Material Request in Production Plan" class="screenshot" src="{{docs_base_url}}/assets/img/articles/material-request-production-plan.png">
+
+2. Once a component in a BOM is set as `Customer Provided` and `Material  
+   Request` is created from `Production Plan`, it will create both `Material Request` with type `Purchase` and `Customer Provided`. From there, a `Stock Entry` with purpose `Material Receipt` can be created.
+
+   <img alt="Stock Entry from Material Request" class="screenshot" src="{{docs_base_url}}/assets/img/articles/create-mr-from-material-request.png">
+
+3. A `Material Request` can have multiple `Stock Entry` - Material Receipt. It
+   will reflect it in the status.
+
+   <img alt="Partial Delivery from Stock Entry" class="screenshot" src="{{docs_base_url}}/assets/img/articles/partial-delivery-mr.png">
+
+4. Customer will be able to track their `Material Requests` in a Web Portal
+   `Material Requests`. The portal is filtered to show only the `Material Request` of the customer.
+
+   <img alt="Material Request Web Portal" class="screenshot" src="{{docs_base_url}}/assets/img/articles/material-request-web-portal.png">

foundation/www/docs/user/manual/en/stock/item/index.md

@@ -63,12 +63,16 @@ Inspection Required: If an incoming inspection (at the time of delivery from the
 
 Inspection Criteria: If a Quality Inspection is prepared for this Item, then this template of criteria will automatically be updated in the Quality Inspection table of the Quality Inspection. Examples of Criteria are: Weight, Length, Finish etc.
 
-### Purchase Details
+### Purchase, Replenishment Details
 
 <img alt="Item Purchase Details" class="screenshot" src="{{docs_base_url}}/assets/img/stock/item-purchase.png">
 
 <img class="screenshot" alt="Purchase details" src="{{docs_base_url}}/assets/img/stock/item-purchase.png">
 
+* **Is Purchase Item:** Checked if Item is purchased through a supplier and follows `Buying Cycle`.
+
+* **Is Customer Provided Item:** Checked if Item is provided by a customer and received through `Stock Entry - Material Receipt`. If Checked, `Customer` field is Mandatory as the default customer for `Material Request`.
+
 * **Lead time days:** Lead time days are the number of days required for the Item to reach the warehouse.
 
 * **Default Expense Account:** It is the account in which cost of the Item will be debited.

foundation/www/docs/user/manual/en/stock/material-request.md

@@ -10,7 +10,7 @@ To generate a Material Request manually go to:
 
 > Stock > Documents > Material Request > New
 
-#### Creating Material Request 
+#### Creating Material Request
 
 <img class="screenshot" alt="Material Request" src="{{docs_base_url}}/assets/img/buying/material-request.png">
 
@@ -27,6 +27,7 @@ A Material Request can be of type:
 * Material Transfer - If the requested material is to be shifted from one warehouse to another.
 * Material Issue - If the requested material is to be Issued.
 * Manufacture - If the requested material is to be Produced.
+* Customer Provided - If the requested material is to be provided by Customer.
 
 The User can also raise a [Request For Quotation](/docs/user/manual/en/buying/request-for-quotation.html) against a Material Request. To create a Request For Quotation the user can click on 'Make'.