====== Replenish Pick Locations Flow ====== 

===== Overview =====

Replenishment can be used within the same SAP Business One / PMX WMS warehouse and the aim of the function is to make sure that enough stock is available on pick locations to perform the picking process for a given period. The function has got two types in Produmex WMS, it can be location or item based.

When replenishment configurations are set for a location or an item, the Replenish Tool automatically creates replenish orders when the conditions below are met.
  * The stock reaches the minimum quantity set for the location or the item.
  * There is available stock on the bulk locations for replenishment.

The generated replenish orders can be executed on the shop floor with the help of the Mobile Client.

{{ :implementation:wms:functionalguide:replenishment:process.png?400 |Replenishment}}
===== Prerequisites===== 

Define your bulk locations (locations that are not used for picking) and pick locations in your Organizational Structure.

During the process bulk locations are used to replenish pick locations in the warehouse.  The replenishment function does not work if all the locations are set as pick locations.


===== Configuration =====

==== 1. Set the Replenishment generator ====

Select the necessary replenishment type (extension) on the [[implementation:wms:replenishmentgenerator |Replenishment generator]] and define the related settings. You can set only one of the two types.
  * //Generates replenishment orders (DEREPGEN)//: Replenishment orders are triggered based on the configurations of pick __locations__.
  * // Generates item based replenishment orders (BREPGEN)// : Replenishment orders are triggered based on Item Master Data configurations.

==== 2a. Location based configuration ====

1. Go to the Organizational Structure and select the necessary bin.

2. On the General tab enable the //Pick Location// option.

3. On the General tab enable the // Can Be Replenished// option.

4. Adjust the minimum quantity, the maximum quantity and replenish quantity of the item for the pick location to be replenished.
  * Minimum quantity: When the quantity of an item is below the minimum quantity, the system generates a replenish order.
  * Maximum quantity: The maximum quantity of an item that can be stored in a location.
  * Replenish quantity: It usually refers to a box quantity, e.g. if the replenish quantity is set to 6, the item is stored in a box of 6 pieces.

For information on calculation and examples click [[implementation:wms:replenishmentgenerator|here]].

{{ :implementation:wms:functionalguide:replenishment:bin.png |}}

==== 2b. Item based configuration ====

1. Go to Item Master Data > Produmex > [[implementation:wms:imd_pmxsales|Sales tab]]. 

2. Fill in the //Replenishment: Quantity on Pick Locations// field.
 
3. Fill in the //Estimated Sales Quantity by Month// field.

For information on calculation and examples click [[implementation:wms:replenishmentgenerator|here]].

{{ :implementation:wms:functional:replenish:imd.png |Item based configuration}}

==== 3. Run the Replenish Tool ====

The tool is located in the installation folder of the Produmex Tools: //C: \Program Files\Produmex\Produmex Tools\Produmex.Sbo.Logex.Tools.ReplenishTool.exe //

The Replenish tool can be executed with the connection string parameter. The default value is //SboConnectionString//.\\

**Example:** <code>Produmex.Sbo.Logex.Tools.ReplenishTool.exe/cs:SboConnectionString</code>

<callout type="info">
**Useful Tip:**\\
Windows Task Scheduler can be used to run the Replenishment Tool regularly. Create a .bat file to pass the connection string parameter to the tool. Please not that creating a .bat file is fully optional.
\\
\\
**How to create a .bat file:** 
  - Open an empty text file.
  - Add the path of the ReplenishTool.exe file between quotations marks. Press the Space button and add the connection string.
  - Save the text file as a .bat file. (e.g. //Run_ReplenishTool.bat//)
  - Run the .bat file to have replenish orders generated.

 </callout>

After running the tool, a **Move Order** is generated (not a log file). **The created Move Order** is specifically of the **Replenishment type** (as multiple Move Order types exist in the system).
Check the generated Move Order under the **Business One > Produmex menu > Reports > Open Document Report > Document Type: Move orders**. The tool does not generate a separate log file, the output of the process is the Replenishment Move Order itself.




===== Workflow =====

{{map> :implementation:wms:functional:replenish:flowchart.png |}}
  * [[implementation:wms:replenishment#select_a_zone|Select zone @141,88,265,145 ]]
  * [[implementation:wms:replenishment#select_replenish_order_line|Select replenish order line @141,172,265,229 ]]
  * [[implementation:wms:replenishment#identify_source_logistic_unit_or_location|Identify source logistic unit or location @5,259,402,390 ]]
  * [[implementation:wms:replenishment#identify_product|Identify product @170,482,295,540 ]]
  * [[implementation:wms:replenishment#enter_quantity|Enter quantity @170,567,295,625 ]]
  * [[implementation:wms:replenishment#scan_destination_location_SSCC|Scan destination location/SSCC @170,650,295,710 ]]
  * [[implementation:wms:replenishment#logistic_unit_item_are_moved|Logistic unit/Item are moved @170,737,295,795 ]]
{{<map}}

===== Replenish Pick Locations Flow steps =====

==== 1. Start the flow ====

On the Mobile Client select Logistics > Move > Replenish Pick Locations.

{{ :implementation:wms:functional:replenish:replenish.png |Start the flow}}
==== 2. Select a zone ====
If the //Select zone on replenishment flow?// option is enabled on the [[implementation:wms:replenishmentgenerator|Replenishment generator]], select a zone. A zone is listed if there is a location in the zone that is the destination location of a replenish order. 

{{ :implementation:wms:functional:replenish:01_zone.png |}}

==== 3. Select a replenish order ====
On the next screen every open line of replenishment orders from the warehouses assigned to the scanner is listed. If a zone was selected, only the lines of replenishment orders for locations that belong to the selected zone are listed.

The order of the displayed repenishment orders is defined by the //Order view name// and  //Orders view order by// settings of the [[implementation:wms:replenishmentgenerator|Replenishment generator]].

<WRAP round box>In the example the replenishment order (1036) for a specific pick location (A0003) is split in multiple lines, because the system requires product from multiple sources (e.g. locations, SSCC’s, batches) to assemble the required replenishment quantity to fulfill the order.</WRAP>

{{ :implementation:wms:functional:replenish:02_order_line.png |Select a replenish order}}

==== 4. Identify source logistic unit or location ====
After selecting the replenishment order, scan the source SSCC. The bulk location and the source SSCC are displayed on the screen. Only the SSCC from the order can be scanned. If the scanned SSCC is a mono pallet with the exact same quantity as the quantity to replenish, the system automatically proceeds to the [[#scan_destination_location|Scan destination location]] screen. \\
In case of there is no SSCC present, scan the pick location or select it from a list after pressing the ‘Select location’ button. 

{{ :implementation:wms:functional:replenish:03_source.png |}}

==== 5. Identify product ====

If multiple items are stored on the logistic unit or bulk location, identify the product to move. 

Scan the product or select it from a list after tapping the ''Select a product'' button. Every item that is stored on the logistic unit/bulk location is listed, but only the item to replenish can be scanned or selected. \\
If there is only one item on the SSCC/ location, the system automatically proceeds with that item.

{{ :implementation:wms:functional:replenish:04_product.png |}}

==== 6. Enter quantity ====
Enter the quantity. By default the quantity on the replenish order line will be displayed, but it is possible to proceed with another quantity. The maximum quantity depends on the quantity of the item on the SSCC/ location.

{{ :implementation:wms:functional:replenish:05_quantity.png |}}

==== 7. Scan destination location/SSCC ====

After having identified the products to move, scan the destination location or SSCC. To select the destination location from a list, tap the ''Select location'' button. \\
It is possible to move the products to a new logistic unit. Tap the ''New SSCC'' button and identify the destination location.

{{ :implementation:wms:functional:replenish:06_destination.png |}}

==== 8. Logistic unit/item moved ====

After having confirmed the destination location, the system registers the move of the logistic units or items and goes back to the Select a replenish order screen.

When all replenish order lines are processed, the replenish order is closed.

{{ :implementation:wms:functional:replenish:07_moved.png |}}