Fulfiller Returns

This guide details how fulfiller users can create and process returns using the streamlined returns experience

The Return Process

Create a Return

An update in which the the Fulfiller application has now adopted Admin UI's create return  flow.  This ensures a consistent workflow across both applications and delivers additional features and functionality to better support return processes.

Process a Return

An update in which the Admin UI's return dashboard is embedded within the Fulfiller UI is now available, giving fulfillers access to more robust return management.

The existing functions to create and process returns within the Fulfiller UI will be removed in 2026. Kibo will be upgrading all Fulfiller implementations to the new process. Please contact Kibo Support if you have any questions.

An overview of each version is detailed below.

Restricted Content

Internal Note: Theme Setting

The theme setting being used to upgrade clients is isDisplayAdminReturns. When set to true ("1'), existing return functionality will be hidden and replaced by the navigation link to the embedded Admin UI. When set to false ("0"), existing functionality will be visible.

Classic Fulfiller Returns


The following processes represent the existing Fulfiller behavior that is being deprecated in 2025 and replaced with the embedded Admin UI.

Initiate a Return

To begin creating a return:

  1. Go to Main > Fulfiller.
  2. Search for a shipment using the search function. This could be located by looking up the customer’s name, the shipment/order ID, or searching for shipments in the Fulfilled status.
  3. The Return Status column in the item details will say “Item can be returned” if the item is eligible. 
  4. If the desired item is eligible, click Create Return at the bottom of the shipment view. The Create Return modal will be displayed.Close-up of the Flexible Auto Capture configurations in general site settings
  5. Select which items from the shipment to return and the quantity of each item.
  6. Select the reason for the return from the drop-down list.The Create Return module with a drop-down menu for return reasons
  7. Click Create Return for These Items to confirm the selections and open the return.

Process a Return

To process the return in the Fulfiller UI when the items are received:

  1. Use the search bar to search for the shipment with the active return. The displayed shipment information will include a Return Status column with the associated status, Return ID, and External ID (if one was provided in the return data—this field is not included in the UI creation process described above).
    An example shipment with an active return
  2. Click Process Return at the bottom of the shipment view (in the same location where the user initially clicked Create Return). This will display a pop-up for you to confirm the return information and close the return.
  3. If you have not selected a location in the UI and/or are viewing shipments under All Stores, then you will be prompted to select the location where you are processing the return. This allows the inventory record to be restocked at the proper location.Pop-up prompting the user to select a store from a list of available locations
  4. In the Process Return pop-up, confirm the item quantity being accepted and reduce the amount that will refunded to the consumer’s original payment method if necessary (such as if there is a restocking fee). This is called the Refund Reduction. For instance, if an item’s cost was $10.99 and the refund reduction is $5.99, then the total refund for the customer will be $5.00. 
  5. Click Process Items to close the return, and KCCP will both refund the customer and update the location inventory levels as needed. The return details module with a Process These Items button

Print Return Receipt

After the return is closed, you will be returned to the shipment details view. From here, there will be an option to print a return receipt. The return receipt lists the returned items and quantities, as well as provides an explanation of the refund that the customer can expect to receive.

Updated Return UI


Once your implementation is upgraded, the navigation menu will display links for create and process returns.

Create a Return

To create a return using the streamlined flow:

  1. Navigate to Returns: Go to Main > Fulfiller > Returns > Create Return.
  2. Search and Select Order: Search for the order or shipment you want to process a return for using the improved search functionality.

  3. Select Returnable Items: Use the checkboxes on the right of the Returnable Items table to select the product(s) to return.  You can create multiple returns for a single order as needed

If you are using return rules that limit a product to a maximum quantity and/or a return window that is now closed, then that information will be noted in Returnable Items. 

  1. Select Return Reason: For each selected product, select the reason for the return using the Reported Issue drop-down menu. The default reasons that are available out-of-the-box are listed below, but you can customize your list of return reasons with an API Extension action.

    • Damaged
    • Defective
    • Missing Parts
    • Different Expectations
    • Late
    • No Longer Wanted
    • Other

5. For each selected product, select the resolution type that the shopper seeks under Resolution:

Type

Description

Replace

Select this option if the shopper desires a replacement product. You can still provide a refund to the shopper under this option.

Refund

Select this option if the shopper only desires a refund. You can still send a replacement if conditions change later in the process.

  1. For each selected product, enter the Quantity to Return.

  2. Click Initiate Return

  3. Select a return location from the drop-down menu that appears

    • The selected location will be where all returned items should be delivered by the customer

    • Choose Return Location: Create return location drop down in Fulfiller will only display locations that the Fulfiller has access to

  4. Create the Return: Click Create Return to finalize the return creation

The return will now be visible in the Returns section and can be managed using the enhanced returns interface.

Process a Return

The Process Return button will load the Admin UI returns dashboard in the Fulfiller UI as shown below. For more information about managing returns using this UI, refer to the Returns user guides.

The returns dashboard with example returns

While viewing the embedded returns screen, the navigation menu will still be that of the Fulfiller UI. This allows you to easily navigate back to the dashboard or shipment listing page.

Email Notifications

If the appropriate emails are enabled in your site settings, customers will receive email notifications with their return status and item details whenever a return is created, accepted, rejected, updated, and/or closed.