Skip to main content

Variant Search

Variant Search provides advanced product search capabilities for finding models and their variants. It supports searching by GTIN, free text, or browsing through categories. Results can be filtered by configurable product attributes like color and size.

Overview​

Variant Search enables:

  • Browsing hierarchical product categories
  • Searching by barcode (GTIN), item id, or free text
  • Filtering results by configurable product attributes
  • Viewing variant details and stock availability
  • Adding items to receipt or Customer Order
  • Starting new customer orders from search results

Permissions​

Required roles:

  • pnp.master-query
  • pnp.item-query

Configuration​

PNP Configuration​

Variants and their attributes are configured in the Product & Price (PNP) system.

Access Variant Search in two ways:

  1. From Shortcuts Menu:

    • Click Item Search button from the shortcuts panel

  2. From quick search:

    • Click Advanced Search at the bottom of the quick search results

Item Search Shortcut

Note: When opened from Customer Order context, adding items will add them to the order basket instead of the main receipt.

Category Navigation​

The initial screen shows the category browser:

Category Browser

Browsing Categories​

  1. Click on a category tile to navigate into it
  2. Continue clicking subcategories to drill down
  3. End-level categories (with products) will open the search screen

The breadcrumb trail at the bottom shows your current location:

Breadcrumbs

  • Click any breadcrumb to jump back to that level
  • Click X to close Variant Search entirely
  • Click Back arrow to go up one level

Click the Search icon in the header to skip category browsing and search across all products:

Note: You can switch to search mode at any time during category browsing by clicking the search icon. This allows you to search within the current category context.

Search Screen​

After selecting a category (or starting a direct search), the search screen is displayed:

Search Screen

Search Methods​

  1. Text Search:

    • Type in the search field
    • Search begins after typing stops (700ms debounce)
    • Searches product names and descriptions

  2. Barcode Scanning:

    • Scan a product barcode
    • Auto-populates the search field
    • Works for model or variant GTINs

  3. Manual Barcode Entry:

    • Type the full barcode number
    • Supports GTIN, model codes, and item IDs

Search Results​

Results display as model and variant cards showing:

  • Product name
  • Product image (if available)
  • Identifiers (GTIN, item ID)
  • Price (if available)

Loading More Results​

If more results are available:

  • Results load automatically as you scroll
  • "Load More" button appears when additional pages exist
  • System auto-fetches more when filtered results count is below minimum

Filtering Results​

  • Use the Include stopped items toggle at the top of the filters panel to also show items with STOPPED status in results (by default only ACTIVE and DISCONTINUED items are shown).

When filters are available, they appear in the left panel:

Search Filters

  • Filters are derived from product attributes (e.g., Brand, Color, Style)
  • Click filter options to narrow results
  • Multiple options can be selected within a filter
  • Selecting all options in a filter is equivalent to no filter (clears selection)
  • Only filters with 2+ distinct values are shown

Variant Details​

Click an item from search results to open the Variant Details screen:

Variant Details

Variant Selection​

The left panel displays all variants of the selected model

For each variant:

  • Variant name and differentiating attributes (color, size)
  • Local stock availability indicator
  • Price

Filtering Variants​

If many variants exist, use the filter buttons below the list:

Variant Filters

  • Click an attribute value to filter variants
  • Auto-selects variant when only one matches
  • Clears selection if current variant doesn't match filter

Details Tab​

Shows product information for the selected variant:

  • Product images
  • Full description
  • Additional product attributes
  • Price information

Stock Tab​

Switch to Stock tab to view availability

Local Stock​

Shows stock level in the current store.

Nearby Stock​

Lists other stores and warehouses with stock:

Nearby Stock

Each location shows:

  • Store/warehouse name
  • Address of the location
  • Distance from current location
  • Available stock quantity

Stock Filters​

  • Include Warehouses - Toggle to show/hide warehouse locations
  • Search - Filter locations by name, city, or postal code

Quantity Selector​

Before adding an item, you can adjust the quantity using the + and − buttons next to the register button:

  • Default quantity is 1
  • Click + to increase, − to decrease (minimum 1)
  • Quantity resets to 1 after successful registration or when selecting a different variant
  • Controls are disabled while a registration is in progress

Actions​

Based on context, different actions are available:

When opened from Main Application:​

  1. Add to Receipt - Registers the selected variant with the specified quantity.
  2. Start Order - Creates a new Customer Order with this item

When opened from Customer Order:​

  1. Add to Receipt - Adds the variant to the customer order basket
  2. Start Order - Hidden (order already started)

Registration Notification​

After clicking Add to Receipt, a notification toast appears in the top-right corner:

  • Success — Shows the item name and registered quantity. Click the notification to close Variant Search and navigate to the receipt.
  • Error — Shows an error message. The notification is not clickable; you can retry or close Variant Search manually.

The notification auto-hides after a few seconds. You can continue selecting and registering items while the notification is visible.

Registration Notification

Start Pickup Order​

When a nearby store is selected in the Stock tab:

  1. Select a variant
  2. Switch to Stock tab
  3. Click on a store to select it
  4. Start Pickup Order button appears

Start Pickup Order

This creates a Customer Order with:

  • The selected item
  • PICKUP_IN_STORE fulfillment pre-configured
  • Selected store as the fulfillment business unit

If the product has related items configured, they appear at the bottom:

Related Items

Click a related item to select it as the current variant. The selected related item is highlighted with a border. You can then adjust the quantity and click Add to Receipt to register it.

This is commonly used for frequently purchased together items or recommended accessories.

  • Click the success notification to close and navigate to the receipt
  • Click Close in the top right to close entirely and return to main screen
  • When in Customer Order context, returns to Customer Order view

Going Back​

  • Click Back arrow to go to previous screen (Details → Search → Categories)
  • Maintains search context and filters

Mobile​

Variant Search is currently supported on Desktop (POS Web). Mobile implementation is available for Tablet devices.