Field ReferencePlanning
Batch-firstTTB-awareRev. 2026.06
Manual / Core / Planning

Planning

The Planning dashboard is your command center for orchestrating production planning. It brings together forecasts, MRP runs, shortage review, and schedule revisions into one view so you can see what needs attention and take action without hunting through separate pages.


Planning Dashboard

Navigate to Planning in the sidebar to see the command dashboard. Five cards show the state of your planning workflow at a glance.

Forecast Scope

Shows whether forecasts exist and are current.

  • Ready means forecasts are loaded and you can proceed to MRP.
  • Action Needed means no forecasts exist yet. Click View Forecasts to create one.

MRP Run

Shows the latest material requirements planning run.

  • Complete means MRP ran successfully with no shortages.
  • Action Needed means either no run has been done, or the latest run found shortages. Click Run MRP to start a new run.
  • The card shows a constraint count (e.g., “3 shortages”) when shortages were found.

Generate Batch Orders

Once an MRP run is confirmed, the Planned MOs tab lists every finished good the run says to produce — one row per driving forecast or sales order, with its planned case quantity and need-by date.

  • Generate Batch Orders (the button above the list) creates a draft Batch Order for every planned finished good in one step. Each new Batch Order pins the current published Formula, Vessel BOM, Case BOM (and Pallet BOM, when the product ships palletized) exactly as a hand-created one would.
  • The action is idempotent: running it again never duplicates a Batch Order. A finished good that already has one — whether created here or from its sales order — is skipped. The result line reads, for example, “4 created, 2 already done.”
  • The button is only available on a confirmed run. A draft run shows “Confirm the run first” — generating Batch Orders is a production-release step, so the plan must be confirmed before it commits work.
  • A finished good with no published Case BOM is skipped (it can’t be produced until its BOM chain is published), and the rest still generate.
  • Prefer one Batch Order at a time? Each row also has a Schedule MO link that opens the Batch Order wizard prefilled with that finished good’s product, cases, and due date.

Shortage Review

Shows open shortages that need resolution.

  • Complete means no open shortages remain.
  • Action Needed means shortages are waiting for review. Click Review Shortages to see them in your inbox.
  • Waiting means no MRP run has been done yet, so there are no shortages to review.
  • The card shows a count of critical shortages when any exist.

Schedule Revision

Shows draft schedule scenarios and their publish readiness.

  • Ready means no draft scenarios exist. You can create one.
  • Action Needed means one or more draft scenarios are waiting to be published or resolved. Click Open Schedule to work on them.
  • The card shows a constraint count (e.g., “1 blocked”) when blockers prevent publishing.

Active Blockers

The bottom card aggregates all blocking constraints across every stage. It shows a total count plus a breakdown by type:

  • Material — MRP shortages (not enough raw materials).
  • Capacity — schedule conflicts (double-booked work centers, missing assignments).
  • Compliance — compliance filing deadlines approaching or overdue.

When there are no blockers, the card shows “No active blockers.” The blocker counts refresh automatically every 30 seconds.

Resume Flow

The amber Resume Flow button appears in the top right of the dashboard. It reads the current state of all cards and suggests the most useful next action:

  • Run MRP — when forecasts exist but no MRP run has been done, or the latest run is stale.
  • Review Shortages — when MRP found shortages that haven’t been addressed.
  • Publish Revision — when a draft scenario is ready to publish.
  • Create Revision — when no draft scenarios exist and the schedule is clean.

The button is hidden when no clear next step applies.

Card Actions

Each card has an action button that opens the relevant page in a new browser tab. Keep the dashboard open alongside detail work so you can return to it and check overall status at any time.


Limiting Factor Tool

The Limiting Factor tool lets you check whether you can make a target quantity of a finished good before committing to a schedule. It answers: “If I want to produce 50 cases of this product, what would stop me?”

Running a Check

  1. Navigate to Tools > Limiting Factor in the sidebar (or use the embedded panel in the schedule revision flow).
  2. Select a Case BOM from the dropdown. This defines the finished-good packaging spec: which recipe, which bottle, how many per case.
  3. Enter a target quantity in cases.
  4. Click Check Feasibility.

Reading Results

The results panel shows three sections:

Hero metric — the headline number. For example, “32 of 50 cases” means you can make 32 cases, but you asked for 50. The verdict banner below tells you whether the target is achievable:

  • Green banner (“Can make 50 cases”) — nothing binds.
  • Red banner (“Can only make 32 of 50 cases — limited by Neutral Grain Spirit (material)”) — something caps production, and the single binding constraint is named, along with its class (material or capacity).

The tool considers two resource classes and reports the one that binds first:

  • Materials — do you have enough of each ingredient on hand right now? This compares your target against current inventory. It does not yet subtract material already promised to other scheduled-but-unissued batches — see the note below.
  • Capacity — do the tanks and lines this recipe runs on have enough hours in the planning window, once you add this batch on top of what’s already scheduled? The capacity check does account for the committed schedule.

Whichever is tighter becomes the limiting factor. If materials are fine but a bottling line is already nearly full, capacity is named — and vice versa.

Note on shared materials. The material check reads current on-hand inventory, so it does not subtract ingredients already committed to other scheduled batches. When several scheduled batches draw on the same ingredient, that cross-batch depletion is computed by MRP today. Unifying it into this tool is a planned enhancement.

Material bars — a visual breakdown of each ingredient’s availability. Bars are sorted worst-to-best:

  • Red (shortage) — not enough to meet the requirement.
  • Yellow (tight) — enough, but less than 20% buffer.
  • Green (OK) — sufficient inventory.

Each bar shows the required vs. available quantity and the UOM.

Constraint summary — three rows at the bottom: Materials, Capacity, and Compliance. Each shows a count of issues. The Capacity row now counts over-scheduled work centers — any tank or line that would exceed 100% of its available hours once this batch is added. Each over-scheduled work center is listed below the summary with its true utilization (for example, “BT-02 — 132%”), so you can see how far over the line is, not just that it is over.

Embedded in Schedule

When you are working on a schedule revision (at Calendar > Schedule), the Limiting Factor tool is available as a collapsible Feasibility Check panel. This lets you check material availability for a manufacturing order without leaving the scheduling flow.


Demand Horizon

The Demand Horizon page shows your production demand organized into three time windows. Each window represents a different level of commitment and planning detail.

Navigate to Planning > Demand Horizon (or click the back link from the horizon page to return to the main Planning dashboard).

The Three Horizons

Locked (2 weeks) Near-term firm commitments. You can see individual batches with their scheduled dates and quantities. Changes to the schedule within this window require a versioned revision with a stated reason. This prevents casual changes to near-term commitments that downstream teams (purchasing, floor operations) are already acting on.

Firm (3 months) Medium-term planning commitments. Demand is shown as weekly aggregates: total cases planned per week and how many batches make up that total. These commitments are expected to hold but can be adjusted without the locked-window friction.

Directional (12 months) Long-range demand signals. Monthly bars show rough volume by month. Use this view for capacity planning and raw material procurement lead times. The further out the signal, the less reliable — the visual opacity on this tile is intentionally lower to communicate that.

The three tiles across the top of the page are the navigation. Click a tile to filter the detail view below to that horizon’s timeframe. The active tile gets an amber highlight. No page reload happens — the switch is instant.

Lock Semantics

When you publish a schedule scenario that includes entries within the locked 2-week window, vestl requires a versioned revision with a stated reason. The system enforces this in two layers:

  • The publish readiness check flags entries in the locked window as locked-window changes.
  • These appear in the readiness panel alongside other blockers (missing tanks or lines, double bookings).
  • Unlike hard blockers, locked-window changes can be overridden: provide a publish reason explaining why the change is necessary, and the publish will proceed.
  • Hard blockers (missing tanks or lines, double bookings) always prevent publishing and cannot be overridden.

This means planners can still make urgent changes within the locked window, but they must document why. The reason is captured in the publish history for audit and team communication.


Field Reference

Dashboard Cards

FieldDescription
Status badgeReady, Complete, Action Needed, or Waiting. Shows the card’s current state.
Constraint countA count like “2 shortages” or “1 blocked” — shows how many issues exist for that planning stage.
Action buttonOpens the relevant detail page in a new tab with planning context pre-loaded.

Limiting Factor Tool

FieldDescription
Case BOMThe packaging definition to check. Includes the recipe, vessel BOM, and case configuration.
Target quantityHow many cases you want to produce.
Max feasible qtyThe most cases you can make, given current on-hand inventory and the committed capacity schedule.
Fill bar percentageHow much of the required quantity is available. 100% = fully covered.
Limiting constraintThe specific material or capacity factor that caps production at less than target.

Demand Horizon

FieldDescription
Total casesThe sum of all forecast quantities in that horizon window.
Batch count (locked)How many individual forecast entries fall within the locked 2-week window.
Week count (firm)How many distinct weeks have forecast entries in the 3-month firm window.
Month count (directional)How many distinct months have forecast entries in the 12-month directional window.
Schedule revisionA versioned schedule change. Required when modifying entries in the locked window. The publish reason explains what changed and why.