> For the complete documentation index, see [llms.txt](https://learn.moselle.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://learn.moselle.io/planning-and-execution/replenishment/supply-planning.md).

# Supply Planning

Plan purchases, production and transfers across every warehouse at once with a Moselle Supply Plan — and learn when to use it instead of a replenishment plan.

{% hint style="info" %}
**Quick Answer:** A **Supply Plan** plans your whole supply network at once — every warehouse, every supplier, and the transfers between your own locations — instead of one reorder list per warehouse. Use it when stock moves between sites or when you want to see how supply flows across the network. Setting up your first plan takes about 10 minutes once your Supply Chain map and supplier catalogs are in place.
{% endhint %}

## What Is a Supply Plan in Moselle?

**A Supply Plan is** a network-wide order schedule. For every item at every warehouse, over every month in your coverage period, it shows what you start with, what you expect to sell, what is arriving, what is moving between your own sites, and what you will have left — and it proposes the purchases, production runs, and transfers needed to keep every site covered.

It is built on the same forecast as a replenishment plan, but it reads your **Supply Chain map** to understand *how* stock actually reaches each location: which supplier or factory feeds which warehouse, how long each route takes, and which warehouses can ship to one another.

Three kinds of order live in a supply plan:

| Order type     | What it means                                                                      |
| -------------- | ---------------------------------------------------------------------------------- |
| **Purchase**   | Buy finished goods from a supplier, landing at one of your warehouses              |
| **Production** | Have a manufacturer or co-packer make product for you, then ship it to a warehouse |
| **Transfer**   | Move stock you already own from one of your warehouses to another                  |

Every order carries three dates: the date you must **order by**, the date it **ships**, and the date it **lands**. The plan is organised around those dates, so it tells you not just *how much* but *when you have to act*.

{% hint style="warning" %}
**Before you build a supply plan, two things must be set up:**

1. **Your Supply Chain map** — suppliers, warehouses, and channels connected on the canvas under **Operations > Inventory > Supply Chain**, with lead times on every connection. This is where the plan learns who supplies whom and how long each route takes.
2. **Supplier catalogs** — each supplier's list of the SKUs they carry, with price and order terms (MOQ, case pack, production lead time), under **Suppliers > \[supplier] > Catalog**.

Without a map, the plan has no routes to plan on. Without catalogs, it has no vendor to place orders with and no order terms to respect. See [Where Do I Set Supply Planning Conditions?](/planning-and-execution/replenishment/supply-planning/supply-planning-conditions.md) for exactly what lives where.
{% endhint %}

## Supply Plan vs. Replenishment Plan: Which Should I Use?

Both plan types start from your forecast and end in purchase orders. The difference is *how much of your supply chain* they take into account.

|                     | **Replenishment Plan**                                      | **Supply Plan**                                                                           |
| ------------------- | ----------------------------------------------------------- | ----------------------------------------------------------------------------------------- |
| **Scope**           | One warehouse (or all warehouses treated independently)     | Your whole network — every warehouse planned together                                     |
| **Order types**     | Purchases from suppliers                                    | Purchases, production runs, **and transfers between your own sites**                      |
| **Lead times**      | One lead time per item or supplier                          | Production time from the supplier catalog **plus** transit time for each route on the map |
| **What it answers** | "How much of each SKU should I reorder?"                    | "Where should stock come from, where should it go, and when must I act?"                  |
| **Setup needed**    | Forecast + supplier lead times                              | Forecast + **Supply Chain map** + **supplier catalogs**                                   |
| **Best for**        | Straightforward reorder cycles, single-warehouse businesses | Multi-warehouse networks, co-packers, 3PLs, businesses that rebalance stock between sites |

### Choose a Supply Plan when…

* **You have more than one warehouse** and stock flows between them — a central DC feeding regional sites, a 3PL and an FBA warehouse, or a factory warehouse shipping to a fulfilment centre.
* **You need transfer recommendations.** A replenishment plan can only tell you to buy more. A supply plan can tell you that a warehouse's shortfall is best covered by *moving* stock you already own.
* **You want to see the network, not a list.** The supply plan shows every warehouse's starting stock, demand, arrivals, transfers, and ending balance side by side, month by month.
* **Your supply chain has stages** — a manufacturer makes the product, ships it to your warehouse, and you ship onward — and you want each stage's lead time counted.

### Stick with a Replenishment Plan when…

* You buy finished goods for a single location and never transfer between sites.
* You want the quickest possible path from forecast to a reorder list.
* You have not yet mapped your supply chain or built supplier catalogs.

{% hint style="info" %}
You can run both. Supply plans and replenishment plans live side by side on the same Plans list, and both are built from the same forecast, so you can compare a network-wide plan against a simple reorder plan for the same period.
{% endhint %}

## How Does the Supply Planning Workflow Work?

**Time Required:** 10 minutes for your first plan, then a few minutes per review cycle\
**Difficulty:** Intermediate

{% stepper %}
{% step %}

### Set up your map and catalogs

Map suppliers, warehouses, and channels on the Supply Chain canvas with lead times on every connection. Upload each supplier's catalog with MOQ, case pack, and production lead time. Optionally set a `safety_stock` custom attribute on your products.

{% content-ref url="/pages/9hx2U4PVuZ3MulVHeVRx" %}
[Where to Set Supply Planning Conditions](/planning-and-execution/replenishment/supply-planning/supply-planning-conditions.md)
{% endcontent-ref %}
{% endstep %}

{% step %}

### Create and build the plan

From **Production** in the left sidebar, click **Create Production Plan**, choose **Supply Plan**, name it, pick a coverage period and forecast, and let Moselle build the first version.

{% content-ref url="/pages/fBYP5FOkgG236eVERDJ0" %}
[Create a Supply Plan](/planning-and-execution/replenishment/supply-planning/create-a-supply-plan.md)
{% endcontent-ref %}
{% endstep %}

{% step %}

### Triage in Total Overview

Start on the **Total Overview** tab to see, per SKU, how many units are suggested, how many you have already staged, how many transfers are proposed, and how much demand is still unserved.

{% content-ref url="/pages/Cuc2FOsrGDHotWXQnq8o" %}
[Supply Plan Views](/planning-and-execution/replenishment/supply-planning/total-overview-vs-monthly-breakdown.md)
{% endcontent-ref %}
{% endstep %}

{% step %}

### Work the plan in Monthly Breakdown

Switch to **Monthly Breakdown** to see each SKU month by month and warehouse by warehouse. Expand a warehouse row to see where its numbers come from, edit quantities and dates, add orders or transfers, and stage what you agree with. Click the list icon on any SKU or warehouse row to see all of its orders in one panel, or switch to a built-in view — **Days On Hand** to check cover, **Replenishment** to work purchases, **Transfer** to work moves between warehouses.
{% endstep %}

{% step %}

### Stage, then place

Accept suggestions by **staging** them — staged orders are yours and survive rebuilds. When you are ready to commit, **place** them: Moselle creates real purchase orders grouped by supplier, warehouse, and arrival date. To place many at once, ask Mo — "place all my September and October orders" — and approve the confirmation card.

{% content-ref url="/pages/cInnEqUhHY1rzz2BSgvs" %}
[Suggested, Staged & Placed Orders](/planning-and-execution/replenishment/supply-planning/suggested-staged-and-placed.md)
{% endcontent-ref %}
{% endstep %}

{% step %}

### Rebuild as things change

Rebuild right after placing, and whenever your forecast or inventory moves. Moselle regenerates its suggestions against the latest numbers while keeping every order you have staged or placed — so the suggestions your new purchase orders replaced disappear.
{% endstep %}
{% endstepper %}

## Supply Planning Pages

{% content-ref url="/pages/fBYP5FOkgG236eVERDJ0" %}
[Create a Supply Plan](/planning-and-execution/replenishment/supply-planning/create-a-supply-plan.md)
{% endcontent-ref %}

**Create a Supply Plan** — Choosing the plan type, filling in the plan dialog, understanding builds and versions, and rebuilding safely.

***

{% content-ref url="/pages/cInnEqUhHY1rzz2BSgvs" %}
[Suggested, Staged & Placed Orders](/planning-and-execution/replenishment/supply-planning/suggested-staged-and-placed.md)
{% endcontent-ref %}

**Suggested, Staged & Placed** — The three states an order moves through, explained plainly, with what each one means for rebuilds and for your suppliers.

***

{% content-ref url="/pages/Cuc2FOsrGDHotWXQnq8o" %}
[Supply Plan Views](/planning-and-execution/replenishment/supply-planning/total-overview-vs-monthly-breakdown.md)
{% endcontent-ref %}

**Supply Plan Views** — What Total Overview, Monthly Breakdown, and the built-in Days On Hand, Replenishment, and Transfer views each show, how to read the columns and rows, what the status badges and red rows mean, how to see every order for a SKU or warehouse, and how filters and views work.

***

{% content-ref url="/pages/9hx2U4PVuZ3MulVHeVRx" %}
[Where to Set Supply Planning Conditions](/planning-and-execution/replenishment/supply-planning/supply-planning-conditions.md)
{% endcontent-ref %}

**Where to Set Supply Planning Conditions** — Where MOQ, production lead time, transit lead time, and safety stock live, and how each one shapes the plan.

## Frequently Asked Questions

### Do I need a Supply Plan if I only have one warehouse?

**Answer:** Usually not. With a single warehouse and no transfers, a replenishment plan gives you the same reorder answer with less setup. A supply plan becomes valuable once stock moves between locations or a manufacturer sits between the supplier and your shelf.

### Does a Supply Plan replace my Replenishment Plans?

**Answer:** No. Both types coexist on the Plans list and are built from the same forecast. Use whichever fits the question you are asking.

### What happens if my Supply Chain map is incomplete?

**Answer:** The plan can only route stock along the connections you have drawn. A warehouse with no source or inbound lane will show its demand as **unserved** because nothing can reach it. Check the **Network problems** panel on the Supply Chain page and clear any findings before building.

### Does a Supply Plan send orders to my suppliers?

**Answer:** No. **Placing** an order records a purchase order inside Moselle. Sending it to the vendor is a separate step you take from the Orders page, exactly as with any other purchase order.

## Related Sections

{% content-ref url="/pages/fjQL5Ho3uiOxopJxw9pB" %}
[Supply Chain Network](/operations/inventory/supply-chain-network.md)
{% endcontent-ref %}

{% content-ref url="/pages/WCsX337cwTs46Xw0Ehqs" %}
[Supplier Catalog](/operations/suppliers/supplier-catalog.md)
{% endcontent-ref %}

{% content-ref url="/pages/vhTY249VKGoERw9TwQiu" %}
[Core Workflow](/planning-and-execution/replenishment/core-workflow.md)
{% endcontent-ref %}

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