# Supply Orders

The Supply Orders module is your order management hub. It gives you full visibility into the lifecycle of your purchase and production orders — from **Planned** to **Validated**, **Released**, and **Delivered**. It is closely linked to the Planning module: any changes you make to planned orders (My Supply) in Planning are reflected here as well. Think of this page as your workflow for moving orders from the planning stage to execution. You can view orders at the order level or drill down into individual order lines.

### Orders vs Order lines

Use the toggle in the top-right corner to switch between two perspectives:

* **Orders** — Each row represents a purchase requisition grouped by supplier and delivery date. Columns include the Flowlity order ID, external ID, delivery date, supplier, number of order lines, comments, and tags for order grouping. This is the high-level view to manage orders as a whole.
* **Order lines** — Each row represents an individual product line across all orders. Columns include reference, product name, delivery date, quantity (editable), and comments. Use this view when you need to work at the product level across multiple orders.

You can also create a new order line manually using the **Create Order line** button.

### Views and filters

Custom views are now available in the Orders module, just like in Demand and Planning. You can create, save, duplicate, and share views with your own combination of filters, columns, and sorting. The built-in views are based on order statuses — **Planned**, **Validated**, **Released**, and **Delivered** — and apply across supply orders, order lines, supply agreements, and sales orders. See [Views and filtering](/concepts/views-and-filtering.md) for details.

<figure><img src="/files/dPh8UAnko3x5rUOVjVEi" alt=""><figcaption></figcaption></figure>

### Order lifecycle

Orders progress through four status tabs, each showing a count of orders in that stage:

1. **Planned** — Orders recommended by Flowlity's optimization engine based on your demand and inventory parameters. These are provisional: they are recalculated every night and may be adjusted or removed if the situation changes. Manual planned orders also sit here until confirmed.
2. **Validated** — Orders reviewed and confirmed by the planner. Once validated, an order is locked — Flowlity's nightly computation will not delete or modify it. These are the orders you typically export or send to the supplier.
3. **Released** — Firm purchase orders imported from your ERP, representing actual commitments to suppliers. These are read-only in Flowlity; changes are made in the ERP and synced back.
4. **Delivered** — Orders that have been fully received and closed.

Use the filter bar to search and narrow down by **Suppliers**, **Tags**, **Sites**, **Date Range**, or **Alerts** (including the new **Stockout response** alert type). You can also filter by **Ordering Date** — including a **Due today** option and an **In the past** option to surface orders whose expected placement date is today or has already passed — by **Release Date** (e.g. orders to place this week, in 2 weeks, in 1 month), and by **Delivery Date** (e.g. all orders arriving next month). You can also filter by a **list of product references**: paste a list of references to zoom in on a specific set of products across all orders. The **Sites** filter lets you narrow results by site type (e.g. Warehouse, Factory) — a **Select all** option is available to quickly include all sites. Order views refresh automatically when switching between sites.

### Compliance checks

For each order — especially planned ones — Flowlity checks whether constraints and policies are respected and surfaces warnings as icons on the order line:

* **Product constraints** — e.g. the order quantity does not meet the product's MOQ or is not a valid lot-size increment.
* **Supplier constraints** — e.g. the combined order does not fill a Full Truck, or orders are more frequent than the supplier's allowed order frequency.

These warnings are informational: you can still validate an order that violates a constraint if you have a reason (e.g. phasing out a product), but the system ensures you do so consciously. See [Supplier constraints](/concepts/supplier-constraints.md) for details on how constraints shape order generation.

### Order detail view

Clicking on an order opens its detail view, showing the full list of order lines for that purchase requisition. For each line you can see the reference, product name, quantity (editable), stock coverage at delivery date, and net requirements. A **secondary unit quantity** column is also visible alongside the primary quantity, making it easy to read quantities in both units side by side. A unit price column is available and editable, letting you adjust the valuation of specific order lines when needed.

<figure><img src="/files/trSYgicyomu8wNahto6i" alt=""><figcaption></figcaption></figure>

For planned orders, you can also adjust the \*\*delivery date\*\* or \*\*split\*\* an order — for example, if Flowlity grouped two products in one order but you want to separate them. You can leave a \*\*comment\*\* on any order line to explain a change (e.g. why a quantity was overridden or an order was delayed); comments are saved and visible to other planners for collaboration and audit purposes. You can also edit multiple delivery dates at once directly in the table. Changed dates are highlighted in purple with a tooltip showing the original date. A \*\*Save\*\* button appears with a count of pending changes; a discard option is also available. A \*\*Validate\*\* button lets you confirm the order and move it to the next stage.

The **Order details** side panel provides key information about the order:

* **Dates** — Order placement deadline, delivery date, and estimated delivery date.
* **Supplier constraints** — Full truck quantity, supplier MOQ (minimum order quantity), and order frequency.
* **Order quantity** — Total quantity, number of products, and total order price.

### Actions

* **Bulk validation with confirmation** — Select multiple planned orders and validate or discard them in one action. A confirmation modal summarizes the operation before it is applied.
* **Select all pages** — Selection now works across all pages, not just the current page, so you can act on your entire filtered result set at once.
* **Multi-format export** — Download order data in XLSX, CSV, or TSV. See [Downloads](/settings/downloads.md) for more details.
* **Supply agreement export** — Download supply agreements in XLSX, CSV, or TSV from the list page or the detail page.
* **Create order line** — Manually add a new order line using the **Create Order line** button.
* **Ctrl+click on a component** — When working with multi-component products, Ctrl-clicking on a component opens its Planning view in a new tab, making cross-product navigation faster.

### Supply Agreements

The Supply Agreements view gives you visibility into your contractual replenishment commitments. An **Order Placement Deadline** column is available in this view, helping you prioritize which agreements need to be acted on first. Key agreement constraints — such as price, MOQ, and other commercial terms — are now displayed directly in the app for quick reference. You can download supply agreements in XLSX, CSV, or TSV from the list page or the detail page.

### When to use it

Use Supply Orders after reviewing your Planning module. This is where you validate and release the orders that Flowlity recommends, track orders already in progress, and ensure nothing falls through the cracks. Start from the Orders view for a supplier-level overview, then drill into individual orders to review and adjust quantities before validating. Check compliance warnings before confirming — they help you catch constraint violations early so that your suppliers receive clean, executable orders.

### Learn more

* [Alerts](/concepts/alerts.md) — Alert types and how to act on them.
* [Supplier constraints and order management](/concepts/supplier-constraints.md) — How constraints shape order generation.
* [KPIs](/concepts/kpis.md) — KPI columns for monitoring supply chain metrics.
* [Comments](/concepts/comments.md) — Collaborate on orders via the comment panel.
* [Review and validate supply orders](/how-tos/review-validate-orders.md) — Step-by-step order review guide.
* [Downloads](/settings/downloads.md) — Export order data.


---

# 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://docs.flowlity.com/modules/supply-orders.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.
