Overview

Use Contracts and Contract Pricing for some B2B customers? Add the Contract Item Filter on any product list page to let B2B users display only their contract items (when they exist), only non-contract items, or all products in the list.  For versions 3.88+,


Prerequisites

For contract filtering to work:

  • the customer account must have contract product records in the ERP (and which have been integrated online).  
  • the user has a Role with the following flags enabled: Filter Contract Items + Filter Non Contract Items. Update in the CMS via Users → Roles, on the Functions tab. 

     

Learn more: Highlight Contract Items

Step-by-step guide 

  1. In the CMS, go to Content → Content → Pages & Templates.

  2. Select the Product List template.

  3. Locate the appropriate zone in your layout and add the Contract Item Filter Widget (we chose zone: Feature).
     

  4. To open the widget's settings, click Edit.

  5. Update the values as required. See:  Contract Item Filter Widget.
     

  6. Click Save.

TESTING

  1. In another browser or incognito window, launch your website. 

  2. Login as a B2B user on an account with contract products already set up in the ERP.
     
  3. Go to a category containing contract products, or search using a term that will return contract products.

  4. Verify that Contract Item Filtering appears in the layout according to your placement of the widget.
     

  5. Test that the filter options work as expected, and that messages update appropriately.


Contract Products Not Filtering?

Check the setting is correct for Contract Item Source on the Items tab (SettingsSettingsIntegration).



Related Resources