Skip to main content

Formulas (Bill of Materials)

The formula defines the bill of materials for a recipe -- which input materials are needed, in what quantities, and with what tolerances. Each formula item links to a material from the material master and specifies the required quantity with its unit of measure.

Formula tab in recipe edit dialog

Accessing the Formula​

The formula is managed through the Formula tab in the recipe edit dialog:

  1. Navigate to the Recipe List
  2. Click the edit button on a Draft recipe
  3. Switch to the Formula tab
info

The Formula tab is only available when editing an existing recipe. Create the recipe first, then open it for editing to manage formula items.

Formula grid​

The formula DataGrid displays the following columns:

ColumnDescription
#Sequence order (determines the display order of ingredients)
MaterialMaterial name from the material master
QuantityRequired quantity for one batch
UnitUnit of measure (kg, L, pcs, etc.)
CriticalRed chip if the ingredient is marked as critical; dash otherwise
Tolerance %Allowed deviation as a percentage (e.g. +/-5%); dash if not set
ActionsDelete button (only visible for Draft recipes)

Items are sorted by sequence order by default.

Adding a Formula Item​

  1. Click Add Item above the formula grid
  2. Fill in the dialog fields:
FieldDescriptionRequired
MaterialSearchable dropdown of all materials (shows name and code)Yes
QuantityNumeric value, must be greater than 0Yes
UnitSearchable dropdown of all units of measureYes
CriticalCheckbox to flag this ingredient as criticalNo (default: off)
Tolerance %Allowed deviation percentage (e.g. 5 means +/-5%)No
  1. Click Add Item to save

Add formula item dialog

The sequence order is automatically assigned based on the current number of items. The new item appears at the end of the list.

Critical ingredients​

Marking an ingredient as critical serves two purposes:

  1. Visual indicator -- a red chip appears in the formula grid, making it immediately visible
  2. Production awareness -- operators can quickly identify ingredients that require extra verification during production
tip

Use the critical flag for allergens, active pharmaceutical ingredients, or any material where deviation from the specified quantity could impact product quality or safety.

Tolerance​

The tolerance percentage defines the acceptable range around the specified quantity. For example:

QuantityToleranceAcceptable Range
500 kg5%475 -- 525 kg
200 L2%196 -- 204 L
50 kg10%45 -- 55 kg

When no tolerance is set, the column displays --.

Removing a Formula Item​

  1. Click the delete button (red trash icon) on the formula item row
  2. Confirm the removal in the dialog (shows the material name and quantity)
  3. The item is removed immediately
info

Only Draft recipes allow formula modifications. If the recipe is in Review, Approved, or Obsolete status, the delete buttons are hidden and the Add Item button is not shown. To make changes, either return the recipe to Draft or create a new version.

Example formula​

Here is an example formula for an "Orange Juice" recipe:

#MaterialQuantityUnitCriticalTolerance
1Water500L-+/-2%
2Orange Concentrate200LCritical+/-5%
3Sugar50kg-+/-3%
4Citric Acid2kgCritical+/-1%

Prerequisites​

Next steps​