- About the Vendor Product Selection Screen (aka Buying Preferences Screen)
- Prerequisites on Using Vendor Product Selection Screen
- Opening the Vendor Product Selection Screen
- Viewing Vendor Products Selected for Food Items
- Viewing the Verified Vendor Products for a Food Item
- If a Food Item has the "No Matching Vendor Product" Label?
- Viewing Information of a Vendor Product
- Setting Preferred Columns on Vendor Product Selection Screen
- Column Descriptions on the Vendor Product Selection Screen
- FAQs
About the Vendor Product Selection Screen (aka Buying Preferences Screen)
At a minimum, the Vendor Product Selection screen (aka Buying Preferences screen) allows you to view the vendor products selected for the food items (i.e., ingredient and prepared foods) included in the recipes on your menus. The product that is selected for a food item determines the nutrient data and price for the food item (see Verified Vendor Products and the Selected Product for a Food Item for more information) .
In addition, you can accomplish the following from the Vendor Product Selection screen.
- Export list of selected vendor products for food items
- View verified vendor products for a food item
- Favour a verified vendor product for a food item (facility accounts only)
- Favour a non-verified vendor product for a food item ("soft link") (facility accounts only)
- Use an approved purchasing list (APL) to select vendor products for food items
- Suggest a vendor product be linked to a food item
- View information about a vendor product
Prerequisites on Using Vendor Product Selection Screen
Prior to using the Vendor Product selection screen, ensure you have a vendor and associated distribution center (DC) set up with products. See the Managing Vendors Managing Vendors and Distribution Centers (DC's) section and the Managing Vendor Products section for instructions.
Opening the Vendor Product Selection Screen
To open the Vendor Product Selection screen.
- From the left navigation pane, select Procurement > Buying Preferences.
- By default, the Vendor Product Selection tab is selected, which displays the Vendor Product Selection screen (screenshot below; right-click to open and expand in new tab).
Viewing Vendor Products Selected for Food Items
You can search for one or multiple food items on the Vendor Product Selection screen to see what vendor product is selected for each food item. If you are a parent account you can also view the vendor product selections of your child accounts (including DC review unit accounts).
The results can then be exported to an Excel® file for a variety of uses such as sharing with your vendor to make product recommendations or for import as an ordering template in the associated vendor ordering websites. To view food item/vendor product selections:
- Open the Vendor Product Selection screen (as per above steps).
-
Click Filters at the top menu to open the Filters section.
- Depending if you are a corporate parent account or a facility child account, the following options are available:
- If you are a facility account looking to generate your vendor product selection list for one or more of your facility menus, select the My Menus filter, and from the drop-down, select your menus.
- If you are a corporate account looking to generate a vendor product selection list for one or more or your corporate menus, select the My Menus filter, and from the drop-down, select your menus.
- If you are a corporate parent account looking to generate a vendor product selection list for one or more menus used by your child accounts, select the Master Menus filter, and from the drop-down, select the applicable child account menus (note that the Master Menus option shows menus owned by your parent account hierarchy and also shows menus owned by your child accounts; click here for information on Master Menus).
- The following filters are available to narrow down the items to display from the selected menu(s):
- Menu Week - select the weeks of the menu cycles from which to populate the screen with items.
- Menu Day - select the days of the week from which to populate the screen with items.
- Meal - select the meal periods (breakfast, lunch, dinner) and snack times (snack am, snack pm, snack hs) from which to populate the screen with items.
-
Diet/Texture - displays the Diet/Texture Combination pop-up for you to select the diet/texture combinations from which to populate the screen with items.
- Recipe - select the recipes of the menus from which to populate the screen with items.
- Recipe Box - select any recipe boxes of the recipes to filter items that populate onscreen.
- Food Category - select any food categories to filter items that populate onscreen.
- Stock Item Category - select any stock item categories to filter items that populate onscreen.
- Items Without Vendor Product Only - select this check box to display items not linked to a vendor product.
-
Include Personal Menu Item - select this check box to display personal items from personal menus.
- After selecting the desired filters, click GO to refresh the screen with items that match the filter criteria.
- In the Search field, you can further refine the results by entering the name of a food item and clicking the magnifying glass to return results (note that entering the food item ID in the Search field does not return results).
- The Item column displays the item, and the Generated Products column displays the vendor product selected for the item (screenshot below; right click image to open and expand in new tab).
-
If you are a parent account, then you can select the child accounts (including DC review unit accounts) to display their vendor product selections. To do so:
-
Click the View As button (first screenshot below). The View As pop-up appears (second screenshot below).
- Click your account name to expand the section with a list of your child accounts.
- Select the check box of each child account you want to view.
- Click the Save button to apply your changes.
- You are returned to the Vendor Product Selection screen (screenshot below). For each food item, the selected vendor products across your accounts (including yours) are listed. Ensure to add the following columns to obtain relevant information of the products selected across your accounts.
- The Available In column shows the distribution centers (DC's) carrying the vendor products.
- The Not Available In column shows the DC's that do not carry the product.
- The Pack Price columns shows the price range from lowest-priced product to highest-priced product.
- The Cost/Serving column shows the cost/serving range of the lowest-priced product to the highest-priced product.
(Right-click image to open and expand in new tab)
- As a parent account, you can select the specific vendor product you want your child accounts to use by adding the vendor product to a DC-specific approved purchasing list (APL). To do so, see Using an Approved Purchasing List (APL) to Select Vendor Products for Food Items.
-
- Note that you can scroll through items via the top right by using the arrow keys or manually entering the page number.
Viewing the Logic of How a Vendor Product is Selected for a Food Item
When the Vendor Product Selection screen is open, you can view the logic the system utilizes to select a vendor product for a food item. To do so, click the icon in the Product ID column (either the blue I icon or the heart icon) and the Calculation Steps window appears describing the logic (second screenshot below).
Exporting Selected Vendor Product List to Excel® File
You can export the selected vendor product list to an Excel® file for a variety of uses such as sharing with your vendor to make product recommendations or for import as an ordering template in the associated vendor ordering websites.
- With the selected vendor product list set up as per above steps, click the Export button. The following message appears:
- Click OK. The following message appears when the file is processed.
- Click the Download button to download the file.
Viewing the Verified Vendor Products for a Food Item
To view the verified vendor products for a food item, complete the following steps:
- Open the Vendor Product Selection screen (as per above steps).
- In the Search field, enter the name of the food item and click the magnifying glass to return results (note that entering the food item ID in the Search field does not return results).
- For the food item, click the gear icon in the Actions column and select Edit.
- The Similar Vendor Products window appears (screenshot below). By default, the Vendor Product Linked To Food filter is selected, which lists the verified vendor products for the food item. The product that is currently-selected for the item is highlighted in yellow.
(Right-click image to open and expand in new tab)
What if a Verified Vendor Product is Not Correct for a Food Item?
If a verified vendor product is completely incorrect for its food item (i.e., strawberry is linked to grape), reach out to MealSuite Support to address the issue and provide the following information:
- Food item name (ingredient/prepared food)
- Vendor
- Product ID
If a Food Item has the "No Matching Vendor Product" Label?
On the Vendor Product Selection screen, a food item can have a No Matching Vendor Product label (screenshot below). This indicates that there are currently no verified vendor products for the food item, and as such there is no selected product for that food item.
A No Matching Vendor Product label can indicate one of the following:
- Products are in Out-of-Stock Status
- Products are no longer on Vendor Product List
- Your Corporate Account is Using a "Locked" Approved Purchasing List (APL)
If Products are in Out-of-Stock Status
A No Matching Vendor Product label can indicate the verified vendor products for the food item are in an out-of-stock status. To confirm, open the verified vendor products for the food item (as per above steps) to see if the products are in an out-of-stock status (first screenshot below).
If the product is in an out-of-stock status, then you can suggest a new vendor product be linked to the food item; see Suggesting a Vendor Product be Linked to a Food Item.
or
If you are a facility account, it is possible to select a vendor product for a food item when that vendor product is already linked (i.e., verified) to another food item. This is known as a "soft link" between the vendor product and new food item because the vendor product is not verified for the new food item.
When you create a soft link, the price of the vendor product will update the costing on recipes and menus, but the nutrient data of that vendor product will not be used.
For more information and how to create a "soft link", see Facility Accounts: Favouring a Non-Verified Vendor Product ("Soft Link").
If Products are no longer on Vendor Product List
A No Matching Vendor Product label can indicate the verified vendor products are no longer on the vendor product list. To confirm, open the verified vendor products for the food item (as per above steps) to see if if the food item has no verified vendor products (screenshot below).
If products are no longer on the vendor product list, the following options are available:
- You can search for a currently unverified (i.e., unlinked) vendor product and submit a "Suggest Link" request for that vendor product to be linked to the food item by the MealSuite Nutrition Services team; see Suggesting a Vendor Product be Linked to a Food Item.
- A product can be manually added. The means to manually add a product are different depending on your vendor and account setup:
- If your vendor is partner vendor (vendor with interface to automatically populate and update vendor products in your account), then contact the vendor to have a product added.
- If your vendor is a non-partner vendor (i.e., vendor without interface), and the vendor products are controlled by your parent corporate account, then contact your parent account to have them manually add a product.
- If your vendor is a non-partner vendor (i.e., vendor without interface), and the vendor products are controlled by your account, your account can manually add a product.
Once a product is added, the MealSuite system item-product selection logic should automatically verify and select the product for the food item; if not, then perform a "suggest link" to have the vendor product be linked to the food item by the MealSuite Nutrition Services team; see Suggesting a Vendor Product be Linked to a Food Item.
- If you are a facility account, it is possible to select a vendor product for a food item when that vendor product is already linked (i.e., verified) to another food item. This is known as a "soft link" between the vendor product and new food item because the vendor product is not verified for new the food item.
When you create a soft link, the price of the vendor product will update the costing on recipes and menus, but the nutrient data of that vendor product will not be used.
For more information and how to create a "soft link", see Facility Accounts: Favouring a Non-Verified Vendor Product ("Soft Link").
Your Corporate Account is Using a "Locked" Approved Purchasing List (APL)
A No Matching Vendor Product label can indicate your parent corporate account is limiting your vendor product selections via an approved purchasing list (APL) that is set as locked. If so, the item-product selection logic will only select a product for the food item if that product is on the APL. If the product is not on the APL, then the system returns a No Matching Vendor Product label for the food item.
See Determining Ownership of an APL to see if your parent account has published an APL to your account. And if so, it could be that the APL is set as locked. Contact your parent account to confirm.
Viewing Information of a Vendor Product
When the Vendor Product Selection screen is open, you can open a product to view its information. To do so, click the name link of the vendor product in the Generated Products column, and a product window appear displaying vendor information, including nutrient info, distribution centres that the product is available from, and a link to the food item the product is linked to.
For information on the Assigned Pack Size and the Vendor Pack Size, and how those values are calculated in MealSuite, see Vendor Product Pack Size and Weight.
Setting Preferred Columns on Vendor Product Selection Screen
You can set the columns to display on the Vendor Product Selection screen along with their sort order. To do so:
- From the left navigation pane, select Procurement > Buying Preferences.
- By default, the Vendor Product Selection tab is selected, which displays the Vendor Product Selection.
- Click the Set Columns button. The Set Columns pop-up appears.
- For the columns you want onscreen drag-and-drop them from the right side of the pop-up to the left side of the pop-up.
- You can set the sort order of the columns displayed onscreen by clicking, holding, and dragging a column to it desired spot in the column list.
- Click Apply to apply your changes and close the pop-up.
Column Descriptions on the Vendor Product Selection Screen
The columns on the Vendor Product Selection screen are explained as follows:
Food Item-Specific Columns
- ID - system-generated internal ID of the item.
- Item - name of the food item (ingredient or prepared food).
Vendor Product-Specific Columns
If a vendor product is selected for a food item, then the following columns are populated:
- Approved Purchasing List - shows any approved purchasing lists (APLs) the product is assigned to. Also allows you to add a product to an APL, or remove a product from an APL.
-
Assigned Pack Size - stock unit per pack and stock unit weight. Note the following:
-
- indicates the pack is breakable, which means an individual stock unit can be purchased from the pack. The green icon indicates the product's "always purchase" setting is set to full pack
-
- indicates the pack is breakable, which means an individual stock unit can be purchased from the pack. The blue icon indicates that the product's "always purchase" setting is set to individual stock unit.
-
- indicates the product is a catch weight, which is typically associated with meat products to allow pricing based on weight (i.e., price per pound or price per kilogram).
-
-
Attributes - displays an icon attribute associated with the vendor product. For example "Made in the USA" or "Vegetarian". Hovering your cursor over the icon displays the description:
For a description of each attribute icon, see Attribute Icon Descriptions for Vendor Products. - Availability - the stock status is listed here. For example “Active” or “Out of Stock”. Note that if you are a corporate account viewing the vendor product selections of your child accounts, and the availability status between the DC's of the child accounts is different, then "Varied" is displayed.
- Available In - lists the distribution centre IDs that carry the vendor product.
- Cost/Serving - the cost per serving of the item. Note that the serving is pulled from the portion size of the item. See also How Cost Per Serving is Calculated.
- Generated Products - the vendor product selected for the food item. If the item is not linked with a vendor product, then states “No matching vendor product.”
- Not Available In - lists the distribution centre IDs that do not carry the vendor product.
- Pack Price - the price of a pack/case.
- Product Brand - the brand of the vendor product is listed here.
-
Product ID - the external ID of the vendor product is listed here. Note the following:
-
- indicates that the MealSuite system performed an automatic link to the item using its product-item selection logic.
-
- indicates that the product has been manually selected for the food item by marking it as a favourite.
-
- Unit Price - the price of an individual stock unit.
- Vendor Pack Size - the original pack size from the vendor before it is automatically parsed or manually edited to the assigned pack size.
- Vendors - the vendor of the product.
FAQs
How do I see the recipe that a food item is included in?
Unfortunately, there is no direct way on the Vendor Production Selection screen (aka Buying Preferences screen) to see what recipe a food item is included in.
You will be required to locate the item on the Foods Listing screen (Recipes > Food Listing) and use the "Where Used" function to open its recipe(s). To do so see Seeing the Recipes of a Food Item.
How do I fix an "incorrect" food on the Buying Preferences screen? On the Buying Preferences screen, why do I see a food item that I do not use?
The food items displayed on the Vendor Product Selection screen (aka Buying Preferences screen) are sourced from the recipes contained in your menus. If a food item is shown on the screen, it is because it is used in a recipe that is on your menu. (To see the recipe a food item is used in, see Seeing the Recipes of a Food Item).
If your facility does not use a particular food item, you have the following options:
-
If you are a US account, you may have the ability to swap food items for an ingredient in a master recipe (aka, recipe variations). If so, then see the following article: Recipe Variations: Swapping a Similar Food for an Ingredient in a Master Recipe. If you do not have the ability to swap a food for an ingredient in a master recipe, and you are a US account, please reach out to MealSuite Support to request this function.
-
If you are a CDN account, or a US account that does not have or want the ability to swap food items for an ingredient in a master recipe, then you can make a copy of the master recipe for your account, and then edit the ingredients as needed (see Making a Copy of a Master Recipe). Then on the menu, you can swap the original recipe (i.e., menu item) with your new recipe (see Replacing a Menu Item).
-
If you do not want to create a new recipe, then you can swap the original recipe (i.e., menu item) with another appropriate recipe on the menu (see Replacing a Menu Item).