For the complete documentation index, see llms.txt. This page is also available as Markdown.

Supply Chain Network

Quick Answer: Go to Operations > Inventory > Supply Chain to see your network as a visual map. Drag suppliers, warehouses, and channels onto the canvas, connect them, and group warehouses into Regions so Moselle can forecast demand across locations together. Building an initial map takes about 10 minutes.

Watch: Setting Up Your Supply Chain Mapping

New to the Supply Chain canvas? This walkthrough shows the setup end to end — placing your suppliers, warehouses, and channels, connecting them, and grouping warehouses into regions.

Set Up Your Supply Chain Mapping with Moselle

What Is the Supply Chain Network?

The Supply Chain page is a visual map of where supply is made or bought, and what can move where — from supplier, to warehouse, to the channels that sell it. It lives alongside Stock Overview and Warehouses under Operations > Inventory, and all three share the same tab bar so you can move between them.

Below the canvas, four cards break the same information into tables: Lanes, Sources, Stock policies, and Regions. Once your network is mapped, Moselle uses it to route demand and supply correctly: which warehouse a channel's sales should pull from, how long stock takes to move between locations, and — with Regions — how demand should split across a group of warehouses instead of landing on just one.

Large network? Each table shows a 10-row preview. If you have more entries than that, a View all (N) button appears above the table — it opens the full list in a dialog with filters and pagination, so nothing is hidden past the first page.

What You Can Add to the Canvas

Item
What it represents

Supplier

Where product is made or sourced from — a finished goods vendor, or a manufacturer that makes it for you

Warehouse

A location holding stock (matches your warehouses in Operations > Inventory)

Channel

A place you sell (matches your sales channels)

Region

A named group of warehouses whose demand is forecast together

Lane

A connection carrying stock between two locations, with a transfer time

Source

A connection showing where a location's supply comes from — production, purchase, or transfer — and on what terms (lead time, order minimums and maximums)

Stock policy

Minimum/maximum inventory targets set on a warehouse

Drag any of these from the tray onto the canvas, then draw connections between them left to right — supplier → warehouse → region (if grouped) → channel — to match how product actually flows through your business.

Nodes and connections you place on the canvas are saved as drafts locally until you fill in the details that make them real — so your layout survives a refresh even before every connection is fully configured. A connection still in this state shows a red chip — see Work-in-Progress Lanes and the Red Chip below.

The tray on the left — Your places — lists the warehouses, suppliers, and channels you already have in Moselle. Drag them out; you don't recreate anything here. The Suppliers heading also has a +, which opens the same Add supplier dialog as the Suppliers page, so a vendor you'd forgotten can be created without leaving the map.

Suppliers, Manufacturers, and Co-Packers

Select a supplier's card and Moselle walks you through the same guided questions as the Add supplier dialog — whether they manufacture your product, who sources the components, and whether you track stock at their facility. The answers decide how that supplier's connections behave:

  • Finished goods supplier — a straight purchase, with one transfer lead time.

  • Turnkey manufacturer — they make your product and source their own inputs. Connections carry a production lead time and a transfer lead time, and planning uses the two added together.

  • Consignment manufacturer — they make your product from components you send, so Moselle tracks inventory at their facility.

A manufacturer can hold your stock: turn on inventory tracking and either create a new warehouse named after the supplier or link one you already have — either way, the card reads Inventory tracked at [warehouse]. Component vendors can then be connected into that manufacturer, which is how a "we send them the parts" arrangement gets drawn.

Supplier Types

Reading the Connections

Each kind of connection has its own colour and label, so a glance tells you how stock reaches a location:

Connection
What it means

Purchase

Bought from a supplier, with one lead time

Production

Made for you — production lead time plus transfer time, shown summed on the line

Transfer

Moved between two of your own locations over a lane

Sells from (channel)

The location (or region) a channel's demand is served from

Region share

Dotted and grey: not a movement, but which warehouses answer a region's demand and in what share

Work-in-Progress Lanes and the Red Chip

Quick Answer: A red chip on a lane or connection means it's still a work in progress — you've started it but haven't filled in and confirmed its details, so it hasn't saved to the database yet. Click into it, complete the details, and confirm to clear the chip and save it.

A red chip is a "not saved yet" flag, not an error. It exists so you can rough out a map — dragging nodes and drawing lines to plan how things should connect — before you're ready to fill in lead times, order terms, or other details on every connection.

  • It's local to you. While you're mid-edit, a teammate looking at the same canvas doesn't see your red, work-in-progress connections — only the version that's actually saved. That keeps one person's unfinished changes from showing up as "the network" for everyone else.

  • Clearing it is the only way it saves. Click into a red connection, fill in the details the connection type needs, and confirm. Once confirmed, the chip disappears and the connection saves like any other.

  • Until it's confirmed, it doesn't count. A red connection isn't reflected in your Lanes, Sources, or Stock policies tables, in forecasting or production planning, or in what Mo can see — it exists only on your screen.

This is different from the Network problems panel further down the page: that panel flags gaps in your saved network. A red chip means a connection was never saved in the first place.

Align Your Map with the Database

Quick Answer: Click Align with database on the Supply Chain canvas to reset the map to what's actually saved — the same data shown in the Lanes, Sources, Stock policies, and Regions tables below the canvas. Use it when the canvas looks stale or cluttered, for example after someone left unfinished changes behind. It erases any connections still showing a red chip.

More than one person can work on the same map over time, and the canvas can drift from what's actually saved — someone starts rearranging or adding connections, doesn't finish, and moves on. The next person to open the Supply Chain page sees that unfinished layout mixed in with the real network, which can look messy or out of date.

Align with database resets the canvas to match your saved network exactly, using the same Lanes, Sources, Stock policies, and Regions your tables already show — the quickest way back to a clean, accurate map.

To use it, click Align with database on the Supply Chain canvas.

Group Warehouses into Regions

A Region groups several warehouses so you can forecast demand against them collectively — for example, an "NA Region" made up of an East Coast and a West Coast warehouse, split 60/40 between them. Instead of every channel's demand pointing at a single location, it fans out across the region's members according to the percentage you set.

Create a Region

1

Open the New Region dialog

Go to Operations > Inventory > Supply Chain. Click + Region on the canvas, or open the overflow menu and select New region.

2

Name the region and add warehouses

Give the region a name (e.g. "NA region"), then use Add warehouse to build the list of warehouses that belong to it. Next to each warehouse, enter its percentage share of the region's demand — a running total shows you how close you are to 100%.

  • Percentages must be set on every warehouse in the region, or left blank on all of them — you can't mix set and unset shares.

  • A warehouse can only belong to one region at a time; it drops out of the list once it's assigned.

3

Save

Click Create region. The dialog shows which channels are already forecasting into the region — channels themselves are connected to a region from the canvas, not from this dialog (see next step). The region appears on the canvas as a small pill showing its name and split (e.g. "North America region · 60 / 40") wherever its member warehouses feed into it.

4

Connect channels to the region

On the canvas, draw a connection from the region to each channel whose demand should route through it, the same way you'd connect a channel to a single warehouse.

Editing a Region

  • Change the percentage split from the region's pill on the canvas — click the pencil icon to open the split editor. It still requires every member to total 100% before saving.

  • Add or remove member warehouses from the Regions table (next to Lanes, Sources, and Stock policies on the same page), using Edit region.

  • A region and its member warehouses are always connected on the canvas — that connection is the region, so it can't be deleted by removing the line. To remove a region entirely, archive it.

Fix Network Problems

When something in your network can't work, a Network problems panel appears above the canvas listing each finding by name. They're worth clearing: a location nothing can reach, or a channel with nowhere to sell from, is a gap in planning rather than a cosmetic issue.

Finding
What it means
How to fix it

Channels without location

A channel's demand has nowhere to be served from

Connect the channel to a warehouse or region on the canvas

Channels fulfilled by unreachable location

The channel points at a location that nothing can stock

Give that location a way in — a supplier, production, or an active transfer lane

Channels fulfilled by archived location

An active channel is still pointed at a retired warehouse

Repoint the channel at a live location

Locations with no way in

Stock is expected here, but nothing produces, buys, or transfers into it

Add a source or an inbound lane

Lanes touching archived locations

A lane still runs to or from a warehouse you've archived

Delete the lane, or unarchive the warehouse if it's still in use

Archived warehouses and channels don't raise problems of their own — switching something off is not a fault. What still gets flagged is a live reference to something archived, so nothing dangles unnoticed.

Regions count as reachable through their members. A region isn't a physical place, so supply never lands on the region itself — it arrives at the member warehouses. As long as at least one member can be stocked, the region is fine. A member that nothing can reach is flagged against that warehouse instead.

How This Fits Into Your Planning Cycle

Mapping your supply chain isn't just documentation — Moselle uses it during forecasting and production planning:

  • Forecasting: When a channel is connected to a warehouse (or to a Region), that channel's forecasted demand is assigned there. For a region, demand is split across member warehouses using the percentages you set — this is what makes the split real, rather than a label.

  • Production Planning: Lanes and Sources tell Moselle how stock actually reaches a warehouse — production and purchase lead times, and transfer times between locations. If more than one warehouse could supply the same destination, Moselle plans from a single warehouse rather than duplicating the recommendation: it follows an explicit priority you've set on a transfer source first, falling back to the shortest transfer time when you haven't set one.

  • Mo: Mo reads your mapped network, so questions about where stock comes from and how long it takes are answered against your own routes rather than general rules — and you never have to explain your setup first. It knows which locations supply which, the production and transit time on every route, order minimums and multiples, which channels ship from where, and the same gaps the Network problems panel lists. Ask in plain language:

    • "What feeds our East Coast warehouse, and how long does each route take?"

    • "Is transferring SKU-001 from the West Coast faster than a new order from Acme Supply Co?"

    • "Are there any problems with how my supply network is mapped?"

    The more of the map you fill in, the sharper those answers get — a route with no lead time recorded can't produce an arrival date. Mo reads the network but never edits it, so changes still happen on the canvas.

An unmapped network doesn't block forecasting or planning — Moselle falls back to your existing warehouse and channel setup. Mapping lanes, sources, and regions makes those calculations reflect how stock actually moves, rather than treating every warehouse as independent.

Ask Mo About Your Supply Chain

Step-by-Step: Build Your Network

1

Click Inventory in the left sidebar under Operations, then click the Supply Chain tab.

2

Place your nodes

Drag your suppliers, warehouses, and channels from the tray onto the canvas. Existing warehouses and channels already in Moselle appear automatically — you don't need to recreate them here.

3

Connect them

Draw a Lane or Source between nodes to represent how stock actually moves — supplier to warehouse, warehouse to channel, or warehouse to warehouse. Add a Stock policy to a warehouse to set its minimum/maximum inventory targets.

4

Group warehouses into a Region (optional)

If multiple warehouses serve the same demand together, group them into a Region and set the percentage split. See Group Warehouses into Regions above.

Frequently Asked Questions

What happens if I don't set a percentage split on a region?

Answer: The region is flagged with a "No splits set — demand not planned" warning, and its member warehouses receive none of the channel demand assigned to the region. Set a split totaling 100% to activate planning for that region.

Does a region need its own warehouse or location?

Answer: No. A region is a forecasting grouping, not a physical location — it doesn't need a backing warehouse of its own. It's made up entirely of the warehouses you add as members.

Can a warehouse belong to more than one region?

Answer: No, a warehouse can only be a member of one region at a time. It drops out of the selection list for other regions once assigned.

Why is my region flagged as unreachable?

Answer: It shouldn't be, as long as one of its member warehouses can be stocked — supply lands on the members, not on the region itself. If the warning persists, check whether every member is missing a source or inbound lane.

Can I create a supplier from the canvas?

Answer: Yes. Click the + on the Suppliers heading in the tray. It opens the same Add supplier dialog as the Suppliers page, and the new supplier appears in the tray ready to drag out.

Can I delete a region's connection to its member warehouses?

Answer: No. That connection represents the region's membership, not a route you drew — it updates automatically as you add or remove members in the Regions table. To remove a region altogether, archive it.

What does the red chip on a lane mean?

Answer: It means that connection is a work in progress — you've started it, but its details haven't been filled in and confirmed, so it hasn't saved to the database yet. It's local to you; open the connection, complete its details, and confirm to save it and clear the chip.

What happens to red connections if I click Align with Database?

Answer: They're erased. Align with database resets your canvas to match what's actually saved, and a red connection was never saved — so it's discarded rather than kept. Finish or accept losing any red connections before you align.

Why does my supply chain map look different from a coworker's?

Answer: Red, work-in-progress connections are local to whoever placed them — nobody else sees a chip until it's confirmed and saved. If two people are looking at the same map and one sees connections the other doesn't, check for red chips first: whoever placed them should finish and confirm the details, or you can click Align with database to reset the view to what's actually saved. Everything saved is shared identically across all users; only unconfirmed, red connections can differ from person to person.

Troubleshooting Common Issues

Problem
Solution

A region shows a warning on the canvas

Open the region and check whether its percentage split totals 100%. Add or adjust shares until it does.

A warehouse isn't available when creating a region

It's likely already a member of another region. Remove it from that region first, or choose a different warehouse.

A channel's demand isn't reaching the warehouses I expect

Confirm the channel is assigned to the correct region (or directly to a warehouse) in the Regions or connection card.

I can't find the Supply Chain tab

It's under Operations > Inventory, alongside Stock Overview and Warehouses.

A Network problems panel is showing findings I don't understand

Each finding names the entity involved — see Fix Network Problems for what each one means.

A supplier won't accept a component vendor connection

Set the supplier to a manufacturing type and turn on inventory tracking at its facility first.

A supplier I need isn't in the tray

Click the + on the Suppliers heading to create it without leaving the page.

A connection is showing a red chip

It's a work in progress and hasn't saved yet. Click into it, fill in the required details, and confirm to save it and clear the chip.

My map looks cluttered, outdated, or has connections I don't recognize

Click Align with database to reset the canvas to your actual saved network. This erases any unresolved red connections, so finish or accept losing them first.

My map looks different from a coworker's

Check for red chips — they're local to whoever placed them, so unconfirmed work won't show up on someone else's screen. Finish and confirm them, or click Align with database to see only what's actually saved.

Create a WarehouseStock OverviewSupplier TypesAsk Mo About Your Supply Chain

Last updated