Alternate Ingredient Pack Size – More units of measure available to define ‘Pack Size’ (supply quantity).
Import API – Ingredient Validation updated to accommodate this change to alternate ingredient unit of measure.
Release date: 6th and 7th April 2021.
Reason for the Change
To increase usability by extending the units of measure available for alternate ingredient ‘pack size’.
All RME customers using alternate ingredients. This change is compatible with Fourth’s Inventory solution.
Alternate Ingredient ‘Pack Size UoM’ can be Defined using Parent Ingredient Conversion UoM
Current functionality: When an alternate ingredient is created, its ‘pack size’ (Supply Quantity) is defined using the ‘parent ingredient base UoM’ only.
Fig.1 - Parent ingredient base UoM
Fig.2 - Parent base UoM constrains alternate pack size UoM
New functionality: When an alternate ingredient is created, its ‘pack size’ (Supply Quantity) can be defined using the ‘parent ingredient base UoM’ or any of the parent ingredient ‘conversion UoMs’.
Fig.3 - Alternate pack size can use any parent UoM
The reason for this change is to add flexibility when defining an alternate ingredient’s pack size. This will allow users to define alternates in the pack size UoM required for ordering. It should reduce the need to create an additional parent ingredient for those ingredients that require a different unit of measure from the parent ingredient’s ‘base UoM’.
Alternate ingredient ‘unit of measure conversions’ will be displayed on the alternate ingredient record for easy reference – see Fig.4. Alternate ingredient conversions are derived from the parent ingredient values rather than being independently defined for each alternate ingredient.
Fig.4 - Alternate unit of measure conversions displayed underneath 'Supply Quantity' (pack size)
Import API – Ingredient Validation Updated to Accommodate this Change to Alternate Ingredient UoM (unit of measure)
POST /ingredients > Extend Validation of UoM to Include Parent Conversion UoMs
The validation for the above endpoint has been extended to allow the creation of an alternate ingredient with a supply quantity UoM which is different from the parent ingredient’s ‘base supply quantity UoM’. This is allowed if the UoM used to create the alternate ingredient exists as one of the conversion UoMs for the parent.
If the alternate ingredient UoM in the payload does not correspond to the parent ingredient’s ‘base supply quantity UoM’ or to one of the parent’s conversion UoMs, an error will be generated: ''Unit of Measure must match Parent Ingredient Unit of Measure family''.
POST /ingredientalternateswitch > Extend Validation of UoM to Include Parent Conversion UoMs
For alternate ingredients that are used in recipes, the validation will not change. The ‘target parent ingredient’ must have the same UoM as the one used for the alternate ingredient in the recipe.
Source Parent and Alternate ingredient are defined in weight UoM (KG for parent/Grams for alternate)
Source Parent ingredient has a conversion to 'each' UoM.
Source Alternate ingredient is used in a recipe in 'each' UoM.
Parent/alternate switch is attempted. Target parent does not have 'each' UoM conversion.
Result: The switch will fail because the alternate used as a recipe ingredient will not have an 'each' conversion after the switch to the target parent that is missing the 'each' UoM.
For alternate ingredients that are not used in a recipe, there is a change to validation. The ‘target parent ingredient’ must have a UoM that matches the alternate ingredient’s ‘base supply quantity UoM’. The matching UoM of the ‘target parent ingredient’ can be from any of the target parent’s UoMs’, either the ‘base supply quantity UoM’ or any of its conversion UoMs.
Given this parent/alternate group:
Source Parent base supply qty = 1 x 1 EA
Converted to 1 x 300 g
Alternate ingredient base supply qty = 1 x 1 KG
Alternate conversion = 1x 3.3 EA (or 3.3 x 1 EA)
Switch existing alternate to target parent with 'EA' UOM only
Target parent supply quantity = 2 x 10 EA
Expected result: Switch fails
Switch existing alternate to target parent with 'Gram' UOM only
Target parent supply quantity = 10 x 100g
Expected result: Switch succeeds