# Manage Your Production Plan

{% hint style="info" %}
**Quick Answer:** Go to **Planning** in the left nav to see all your replenishment plans organised under each forecast. Select the plan you want to manage, then review Mo's buy recommendations, edit quantities, filter by grade or product line, and generate purchase orders — all from the same table view.
{% endhint %}

## Order Schedule & Inventory Planning

The Production Planning feature provides a streamlined way to manage your order schedules and inventory planning. This table-based interface provides an actionable, editable experience that lets you plan your purchases directly within Moselle.

{% hint style="info" %}
**Pro Tip:** Blue values indicate Mo's suggested orders. These are recommendations based on your forecast and inventory data—use them as a reference point when planning your purchases.
{% endhint %}

## What's New

### Simplified Interface

* **Removed summary cards** – The stats cards at the top weren't providing actionable insights, so we've streamlined the view.
* **New table view** – Built with AG Grid for faster loading and better performance.
* **Direct editing** – Edit "Order" quantities directly in the table cells.
* **Expandable rows** – Click into any SKU to see detailed breakdowns (Starting Stock, Projected Sales, etc.).
* **Advanced Filtering** – Filter by **Grade (A/B/C)**, **Product Line**, **Product Type** (Sub-Line), or use the global **Search**.

### Editable Order Quantities

You can now edit order quantities directly in the table. When you expand a SKU row, you'll see the following detail rows:

| Row Label                | Description                                                                                                                                                                                                                                                                                                          |
| ------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Starting Stock Level** | Your inventory position at the beginning of each period.                                                                                                                                                                                                                                                             |
| **Projected Sales**      | Forecasted units based on your linked forecast scenario.                                                                                                                                                                                                                                                             |
| **Suggested Order**      | Mo's recommended order quantity. Appears in blue in the "Order" column.                                                                                                                                                                                                                                              |
| **Ending Quantity**      | The projected inventory balance for each period: **Starting Balance + Buys − Projected Sales**. When projected sales exceed available stock, the ending balance shows **zero** to indicate a stockout. When a purchase order arrives, you'll see the balance jump to a positive number reflecting the new inventory. |
| **Days on Hand**         | Coverage metric showing how many days of demand the projected ending inventory covers. Use this to spot coverage gaps before they become stockouts.                                                                                                                                                                  |

{% hint style="success" %}
**Key Concept:** The **Total Suggested Order** column is fixed and stays visible as a reference point, even when you adjust individual monthly orders. This helps you see how your actual orders compare to Mo's recommendations.
{% endhint %}

## Understanding the Table Layout

### Columns

* **Total Suggested Order**: The sum of Mo's recommendations (fixed).
* **Total Order**: The sum of your actual/edited orders (updates dynamically).
* **MOQ**: The Minimum Order Quantity for the item.
* **Period Columns** (e.g., "January 2026"):
  * **Order**: Your editable buy quantity.
  * **Ending**: The projected ending inventory.
  * **Days on Hand**: Coverage metric — how many days of forecasted demand the ending inventory covers. A low or negative value signals a coverage gap.

**Breakdowns available:** The plan table can be filtered and grouped by **Product Line**, **Product Type**, and **Grade (A/B/C)** using the tabs and filters at the top of the table.

You can customize which fixed columns are visible by clicking the **Overflow Menu (⋮)** > **Show Columns**.

### Visual Indicators

* **Blue Background/Text**: Indicates Mo's suggestions or "Total Suggested Order" column.
* **White Cells**: Editable fields for your actual order quantities.
* **Grey Cells**: Read-only calculated fields (like Ending Quantity).

## How to Use Production Planning

### Step 1: Access Your Production Plan

1. Navigate to **Production Planning** from the main menu.
2. Click into a specific production plan to open the Order Schedule view.

### Step 2: Review Mo's Suggestions

1. Look at the **Suggested Order** detail row or the **Total Suggested Order** column.
2. These suggestions are calculated based on your forecast, lead times, safety stock, and constraints.

### Step 3: Edit Order Quantities

1. Click on any editable cell in the **Order** column to modify the quantity.
2. Your changes will automatically recalculate the **Ending** quantity for future periods.
   * **Note:** Inventory updates reflect the item's lead time. For example, increasing an order in January for an item with a 3-month lead time will increase the Ending Quantity starting in April.
3. The **Total Order** column will update to reflect your changes.

{% hint style="info" %}
**Tip:** Most users work at the top level (collapsed rows). Expand a row only when you need to verify the detailed breakdown or verify calculations.
{% endhint %}

### Step 4: Switch Views

Use the toggles at the top left to switch between:

* **Quantity View** – Default view, fully editable (Unit counts).
* **Value View** – Shows dollar amounts ($) instead of units.

{% hint style="danger" %}
**Important:** Value View is read-only. Switch back to Quantity View to make edits.
{% endhint %}

### Step 5: Filter by Grade (ABC Analysis)

Use the tabs to filter your order schedule by inventory grade:

* **All SKUs**
* **Grade A** – High-value, high-priority SKUs.
* **Grade B** – Medium priority.
* **Grade C** – Lower priority.

### Step 6: Generate Purchase Orders

Once you're satisfied with your order schedule, click **Generate Purchase Orders**. You will be presented with two optimization options:

1. **Cost**: Minimize spend by optimizing for cash flow and unit costs.
2. **Lead time**: Get inventory sooner by prioritizing supplier lead time and geographic distance.

{% content-ref url="/pages/c3H9nIfH0qdJQffJKIWc" %}
[Generate Orders](/planning-and-execution/replenishment/generate-orders.md)
{% endcontent-ref %}

### Step 7: Export Options

You can export your plan data to CSV by clicking the **Overflow Menu (⋮)** > **Download Order Schedule**. The export respects your current aggregation view:

* **Item Level**: Detailed row-by-row data for every SKU.
* **Product Line**: Aggregated totals grouped by product line.
* **Product Type**: Aggregated totals grouped by product type.

## Working with Mo (AI Assistant)

Mo is available in two places when you're inside a plan:

**Contextual Mo (sidebar)** — The primary way to use Mo during planning. Click the **Mo** button on the plan detail page to open Mo in a sidebar. Mo is automatically injected with context about the open plan — its type (replenishment or allocation), coverage period, frequency, and the linked forecast scenario. You don't need to explain what you're looking at; Mo already knows.

**Full-page Mo (/mo)** — For broader, multi-step analysis not tied to a specific plan. Access from the main nav. Useful for cross-plan comparisons or open-ended demand questions.

### Ask Questions About Your Plan

Click any cell in the table, then open the Mo sidebar. Mo will use the selected cell as context for the most precise answer.

* "Why did you suggest this quantity?"
* "What's driving this recommendation?"
* "Is my starting inventory showing correctly?"
* "Which SKUs are projected to stock out before the end of the plan?"

### Bulk-Edit Buy Quantities via Mo

Mo can calculate and apply changes across many SKUs at once. Describe your intent in plain language — Mo will run the math, show you a summary of what will change, and wait for your explicit confirmation before committing anything.

**Example prompts:**

* "Adjust all buys to cover 90 days of demand"
* "Reduce buys for items with more than 6 months of stock on hand"
* "Bring everything in Product Line X up to 12 weeks of coverage"
* "Cut buys on Grade C items by 20%"

{% hint style="warning" %}
Mo always previews bulk changes and requires your explicit confirmation before any quantities are updated. No edits are committed automatically.
{% endhint %}

### Mo's Capabilities in This Context

| Feature                                    | Status      |
| ------------------------------------------ | ----------- |
| Explain cell values                        | ✅ Available |
| Answer questions about the plan            | ✅ Available |
| Surface stockout risk across the plan      | ✅ Available |
| Bulk-edit buy quantities with confirmation | ✅ Available |
| Generate purchase orders from the plan     | ✅ Available |

## Tips for Success

1. **Start with Mo's suggestions** – They're calculated based on your forecast, lead times, and safety stock requirements. Remember that item-level **Transit Lead Time** and **Safety Stock** custom attributes will override any defaults set during plan creation.
2. **Work at the top level first** – Make your main adjustments on the collapsed rows, then expand only when you need to verify the math.
3. **Use Value View for reporting** – Great for sharing with finance teams, but remember to switch back for editing.
4. **Check your constraints** – If recommendations look off, check your constraints. Moselle uses a **3-tier lookup** order:
   1. **SKU Level** (Highest priority)
   2. **Product Type Level**
   3. **Product Line Level** (Lowest priority) *A constraint set on a specific SKU will override a general constraint set on its Product Line.*
5. **Rebuild if needed** – If you've updated underlying data (like lead times or Safety Stock), use the **Settings (⚙️)** menu > **Rebuild** to refresh the plan calculations.

{% hint style="danger" %}
**Rebuild resets manual edits.** Any order quantities you have manually changed in the plan will be overwritten when you rebuild. Export or note your manual edits before running a rebuild.
{% endhint %}

## Frequently Asked Questions

### Q: Why doesn't my Total Order match the sum of my monthly orders?

**A:** The **Total Suggested Order** is fixed and reflects Mo's original recommendation (which may include MOQ adjustments). Your **Total Order** column *should* match the sum of your edits. If it doesn't, ensure you aren't viewing a cached version by refreshing the page.

### Q: Can I edit orders in Value View?

**A:** No, Value View is read-only for display purposes. Switch to Quantity View to make changes.

### Q: Why are my constraints not applying?

**A:** Check the hierarchy. A constraint on a specific **SKU** will always take precedence over a **Product Type** constraint, which takes precedence over a **Product Line** constraint. Ensure you haven't accidentally set a stricter constraint at a lower level.

### Q: Can I change the plan frequency?

**A:** Yes, the production plan supports **Daily, Weekly, and Monthly** views. This is configured when you first create the plan. To change it, you would need to create a new production plan with the desired frequency.

### Q: How do I generate monthly POs instead of one large PO?

**A:** Currently, POs are generated for the full coverage period. For monthly POs, export your schedule using the **Download Order Schedule** option and create them manually in your procurement system.

### Q: Can I track unfulfilled demand from previous periods?

**A:** By default, Moselle calculates inventory independently for each period. When a period shows zero inventory (stockout), that unfulfilled demand does not carry forward as a "debt" to future periods. This prevents phantom backlog from accumulating.

If your business model accepts preorders or backorders and you want unfulfilled demand to carry forward, contact your Moselle team to enable the **Preorder Demand** setting. With this enabled, negative inventory balances will accumulate across periods until fulfilled by arriving orders.

## Troubleshooting Common Issues

| Problem                                                     | Solution                                                                                                                                                                                                                                                                     |
| ----------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Table is slow to load**                                   | The new table uses optimized batch loading. If it feels stuck, try refreshing the page to trigger a new data fetch.                                                                                                                                                          |
| **Cannot find a product**                                   | Check your active filters (Grade, Product Line, Product Type). If still missing, use the global search bar to locate the specific SKU.                                                                                                                                       |
| **Export looks different**                                  | Check your aggregation view. The export matches the current grouping (Line/Type/Item) you see on screen.                                                                                                                                                                     |
| **Starting stock is 0**                                     | This usually means the plan data is stale or there's a sync issue. Check the actual inventory on the Item page. If it matches, go to **Settings (⚙️)** > **Rebuild** to refresh the plan.                                                                                    |
| **Ending shows zero even though I have projected sales**    | When projected sales exceed available inventory, the Ending balance shows **zero** to indicate a stockout. This is expected behavior and signals that you need to place an order for this period.                                                                            |
| **Ending jumps from zero to a positive number**             | This happens when a purchase order arrives. The periods before the order show zero (stockout), and when the order lands, the balance jumps to reflect the new inventory. Check the Order row to see when buys are scheduled to arrive.                                       |
| **Zero ending inventory doesn't carry forward as negative** | Ending inventory balance resets each period based on actual stock, sales, and arriving orders. When a period shows zero, it means stock runs out that period — but unfulfilled demand doesn't create a "debt" that carries forward. Each period is calculated independently. |


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://learn.moselle.io/planning-and-execution/replenishment/production-planning.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
