Fulfiller UI Overview

In the Kibo Composable Commerce Platform, the fulfiller service performs all the fulfillment-related calls to the systems that maintain order and shipment related data. This interface is accessed through the KCCP Admin at Main > Fulfillment > Fulfiller.

Watch: Fulfiller Overview

Get an introduction to the Fulfiller application

This guide introduces the Fulfiller UI dashboard and basic information about viewing shipments. For more information and walkthroughs of how to process specific fulfillment types, see the Fulfillment Methods guides. For more information about the corresponding APIs and instructions for how to fulfill shipments through the API instead of the interface, see the Shipment API documentation and API walkthrough. The Fulfiller UI navigation menu consists of the following pages.

Home: Return to the Admin UI.
Locations: Access the updated dashboard’s map view.
Shipments: Access the updated dashboard’s list view.
Returns: Manage returns using the embedded Admin UI.
Pick & Pack: Prepare shipments for fulfillment by picking and packing the items. This will only be displayed if pick waves are enabled for the currently-selected location’s group.
Receive Transfers: If transfers are enabled, accept shipments from another fulfiller. This will not be displayed if your current location is not allowed to use transfer shipments.
Manage Blocked Locations: Update the list of locations that have been temporarily blocked from Order Routing assignment.
Links to Help, Settings, and Log Out.

Dashboard Overview

The Fulfiller dashboard can be viewed as either a location map or shipment list. Switch between the two views using the selector in the top right of the page. You can access this dashboard again at any point by clicking Locations in the navigation menu.

Map View

The collapsible map displays all active fulfillment locations that you have access to by default, and clicking on one displays a pop-up of the address and count of Ready shipments. You can further filter by specific location(s), look back period, shipment type, and Fulfillment SLA if those are enabled for your implementation. If SLAs are enabled, the pop-up will visualize the percentage of shipments in green, yellow, and red thresholds as shown below. Otherwise, those details will not be displayed. Click the shipment count in this pop-up to view the shipment list filtered to the selected shipment type and SLA at that location. If you click a threshold instead, you will be taken to the shipment list filtered to that threshold as well.

A location map with an example location selected

While the map is expanded by default, you can change it to be collapsed by default instead by setting the isMapViewCollapsedByDefault theme setting to “1.” Below the map are cards that represent the shipment types supported across the locations selected in the locations filter. Each card lists the shipment steps and count of shipments currently in each step. Click a step to view the shipments list filtered to that shipment type and step at the selected location.

Cards for pickup, ship to home, and transfer shipments

List View

By default, the list view displays Ready shipments at all locations you have access to. This grid includes sortable columns that detail the location, shipment type and step, shipment and order numbers, date and elapsed times, and order notes for each shipment. You can further filter by specific location(s), shipment type, and shipment workflow step. Additional toggles for Late Shipment or Express Shipment may appear depending on the shipment type you select, which allow you to include or exclude those shipments from the results. Click a shipment number to view its details page, or click the order number to view it in the Admin UI.

The shipments grid with a list of filters and example shipments

If Fulfillment SLAs or Estimated Delivery Dates are enabled, then that information will be displayed in the list as well. The above example shows how green, yellow, and red icons indicate each shipment’s current threshold in an SLA.

Customize the Dashboard

You can customize the text labels on the dashboard, such as the visible columns and their labels on the list view, via the tenant settings in your theme language files as shown below. Refer to Fulfiller Theme Customization for more instructions about accessing language files and editing them. Do not change the isModernFFUI setting, as this should remain set to “1” in order to enable the map and list views detailed here.

"isModernFFUI": 1,
"ShipmentListColumns": [
     {
       "name": "fulfillmentLocation",
       "displayName": "Location",
       "isVisible": true
     },
     {
       "name": "shipmentType",
       "displayName": "Shipment Type",
       "isVisible": true,
       "sort": true
     },
     {
       "name": "shipmentNumber",
       "displayName": "Shipment Number",
       "isVisible": true,
       "sort": true
     },
     {
       "name": "orderedAt",
       "displayName": "Shipment Date",
       "isVisible": true,
       "sort": true
     },
     {
       "name": "orderNumber",
       "displayName": "Order Number",
       "isVisible": true,
       "sort": true
     },
     {
       "name": "minutesSinceOrdered",
       "displayName": "Time on Shipment",
       "isVisible": true
     },
     {
       "name": "fulfillmentStep",
       "displayName": "Step",
       "isVisible": true
     },
     {
       "name": "fulfillmentStepTimeDuration",
       "displayName": "Time on Step",
       "isVisible": true
     }
],
"shipmentCountPerPage": 50,
"defaultLocationPageSize": 100,
"initialMapLatitude": 37.0902,
"initialMapLongitude": -95.7129,
"DashboardPeriodFilters" : [
     {
       "displayName": "Last 24 Hours",
       "duration": 24,
       "unit": "HOURS",
       "isVisible": true
     },
     {
       "displayName": "Last Week",
       "duration": 1,
       "unit": "WEEKS",
       "isVisible": true
     },
     {
       "displayName": "Last Month",
       "duration": 1,
       "unit": "MONTHS",
       "isVisible": true
     },
     {
       "displayName": "Last Year",
       "duration": 1,
       "unit": "YEARS",
       "isVisible": true
     }
]

Search for Shipments

Shipments can also be found via the search bar at the top of the interface. You can search for and view any shipment within the entire tenant, even if you aren’t associated with the location that a shipment is assigned to. Filter shipments on the following fields by typing them into the quick search bar:

Order Number (exact match)
Shipment Number (exact match)
Destination Contact Short Full Name (contains match)
Destination Contact Address Line 1 (contains match)
Email (exact match)
Item Name (contains match)
External Order ID (contains match)
Order Reference Number (exact match; this refers to the parentCheckoutNumber used in the Commerce APIs which is passed from orders to shipments)

You can also expand the Advanced Filter menu to view more options. Additional terms that can be searched for through this menu include customer information and phone number, item product code, shipment status, order payment status, the submitted date of the shipment, and the return number and status. However, the Advanced Filter will only return exact matches. For example, if you search for a Customer Last Name of “Smi” then the results will not include any customers with the last name “Smith.” Multiple terms can be applied in one search query from either the quick search bar or the Advanced Filter menu.

Close-up of the Advanced Filter search options

Filter by Shipment Attributes

The Advanced Filter modal includes a Shipment Attributes filter section that allows you to search for shipments by custom attribute values. This section uses a three-step dropdown approach, and you can add multiple attribute filter rows as needed.

Screenshot Placeholder: fulfiller-advanced-filter-shipment-attributes.png Caption: The Fulfiller UI Advanced Filter modal showing the Shipment Attributes filter section with attribute filter rows.

How to Filter by Shipment Attributes

Open the Advanced Filter modal from the Fulfiller search bar.
In the Shipment Attributes section, a filter row appears with three dropdowns:
1. Attribute Type — Select the attribute level:
  - Shipment Attribute — header-level Extensible Attributes configured for the Shipment entity
  - Shipment Item Attribute — line-item-level Extensible Item Attributes configured for the Shipment Line entity
2. Choose Attributes — Select a specific attribute key. The dropdown populates based on your selection in the Attribute Type dropdown, displaying the attribute’s Administration Name.
3. Value — Enter or select a value. The input control renders dynamically based on the selected attribute’s data type:

Data Type	Filter Control
Date	Date field with calendar picker
Text (Text Box / Text Area)	Text input field
Yes/No (Boolean)	Dropdown with Yes / No options
List	Dropdown showing all configured list values (supports multi-select)

Shipment Attribute Filter On Advance Filter Page

To add another attribute filter, click the + (plus icon) button. Each additional row follows the same three-dropdown pattern and can be independently set as either a Shipment Attribute or Shipment Item Attribute.
Click Filter to apply the search. The search query is constructed and displayed on the search bar.

Search Bar FFUI Shipment Attribute Search

Multiple Attribute Filtering Logic

AND logic is applied across different attributes and across multiple filter rows — all attribute conditions must be met.
OR logic is applied within a single list-type attribute — you can select multiple values for the same attribute, and the filter matches shipments containing any of those values.
For Shipment Item Attribute filters, a shipment is included in the results if any of its line items has a matching attribute value.
All attribute filters are combined with existing Advanced Filter fields (customer name, email, phone, shipment status, etc.) using AND logic.

Note: Only active (non-disabled) attributes appear in the filter dropdowns. If no extensible attributes are configured for the Shipment or Shipment Line entity, the dropdowns display a message prompting you to add Shipment attributes.

The search results will be displayed as a listing page that includes all shipments fitting the criteria. From this listing page, you will be able to view more details or continue fulfillment.

Catalog

Customers

B2B

Fulfillment

Inventory

Locations

Marketing

CMS

Orders

Publishing

Order Routing

Reporting

Search

Subscriptions

System

Call Center

Content

Import/Export

Kibo AI

Dropship

Watch: Fulfiller Overview

Navigation Menu