June 14, 2022 - 1.2222 Service Update

Production Tenant Features

eCommerce & Order Management Functionality

Alternate Pickup Contact: BOPIS and Curbside orders can now support multiple pickup persons, allowing the customer to designate a second contact who can pick up the order at checkout. This additional contact is displayed with the order/shipment details in the Order Admin and Fulfiller UI, though it can only be edited in the Admin. The alternate contact will receive fulfillment emails and SMS about the order, including Order Confirmation and all Curbside notifications, in addition to the primary contact.
To support this, an alternateContact object that includes the firstName, lastNameOrSurname, emailAddress, and phoneNumbers fields is now available on the Order API so that this information can be set when creating the order. There are also new endpoints to update and remove the alternate contact on an order. The alternateContact object is passed to the Shipment API data as well, though the Shipment API schemas are not yet updated in documentation.
Unique Shipment Notes in Order Admin: Shipment-level notes can now be viewed and edited in the Order Admin. A new “Internal Shipment Notes” tab is displayed when viewing shipment details on an order and will include a table of internal notes with a button to add a new note to the list. These are similar to order notes, but recall that they are unique to the individual shipment and will not carry over to the order level or other shipments on the same order.
UPS SurePost Validation: In location group shipping settings, validation has been added to ensure that imperial unit types are used for UPS SurePost packages. If unit types are not set to imperial, then an error will be returned and a message will prompt you to update the units.
Subscription Core Theme Updates: The core theme has been updated to include sections in storefront page templates for subscription functionality. The subscription pricing and supported frequencies are now displayed on product details pages along with a Subscribe option that adds the item to the cart (and can be toggled between Subscribe and One-Time Purchase, in which case the subscription price and frequency will not be displayed).
Order Admin UI Enhancement: Clickable links are now highlighted in green instead of black to make them more clearly visible in the Order Admin UI.

Fulfiller Functionality

Shipment Manifest Window: The window of time in which the system looks for shipments to manifest has been extended from one day to one week, with approval from Canada Post and EasyPost. For example, this means that you are able to print a manifest on Monday that includes shipments that were fulfilled on Friday through Monday morning. You can select the range of time between 1 and 7 days that you wish to generate a manifest for on the Create Manifests page of the Fulfiller UI.
Fulfiller Settings Update: The “Action on BOPIS Reject” fulfiller configuration in the general site settings has been renamed to “Action on BOPIS/STH-C Reject” in order to support STH Consolidation. This setting determines whether items rejected during customer pickup or STH consolidation should be cancelled or sent to Customer Care.
Grouped Pick Wave Items: The Fulfiller UI will now display pick waves with similar items grouped together across shipments. Similar items will be listed under a collapsible parent row, with a child row for each shipment. For example, if 5 shipments have 1 quantity of Product 123, the pick sheet will show one parent row for Product 123 with a quantity of 5 and display child rows beneath it for each individual shipment that has a quantity of 1. This makes picking items more efficient and the sheet easier to reference.

Production Sandbox Features

eCommerce & Order Management Functionality

Update Shipping Addresses: You can now update shipping addresses regardless of the shipping or order status, including Fulfilled orders. This allows the address to be updated in cases such as where the shopper gave the wrong address and the carrier returned the shipment, so the shipment address can be fixed and the shipment re-sent. The tax will not be refreshed if the shipment is Fulfilled or Cancelled, or if the order is Completed. Pricing and tax for shipments in Customer Care or Backorder will be recalculated using the updated Ship To location. This can only be edited via the Order Admin UI or the Shipments API (not the Fulfiller UI).
Edit/Delete Shipment Notes: The ability to view and add new shipment notes to an order in the Order Admin was added in Version 1.2220, but this has now been extended with the ability to edit and delete existing notes as well. The “Internal Shipment Notes” tab of the shipment details when viewing an order in Admin will now display the Edit and Delete options where you can update a note or remove one from the list.
Quick Edit UI Enhancement: A loading spinner is now displayed when product lists are refreshing on the Product Quick Edits page (such as after changing the catalog selection or a filter is applied). This makes it clearer to the user that the products will be updated shortly.
Subscription Enhancements: Several updates have been made to the Subscriptions feature, including several new API extensions and improvements to trials and configurable bundles.
- A new API extension has been created to customize subscription cancellation reasons. This also determines the reasons for removing line items, reducing item quantities, and making appeasements/adjustments on subscriptions. The customized reasons set through this extension are displayed in the Admin UI as selectable options when performing those actions.
- Two new API extensions, validateProduct and flattenBundleOnConvert, are now available to override the catalog price field on subscription items when an item is added or its quantity is updated. With these extensions, you can choose whether to update only one item or all items in a subscription and the updated price will be effective immediately. This can also be used on items from configurable bundles, allowing you to override the distributed item price after flattening. See the API Extension documentation for more details.
- Subscription trials have been updated to maintain the user-selected product quantity for continuity orders, as previously the quantity was reset to 1 when the substitute product was swapped in. This meant that continuity orders could not be successfully created after the trial, as the quantity of the subscription item would be 1 and volume pricing would not be considered. Now, the subscription item will automatically be the customer’s desired quantity in continuity orders.
- Trials are now supported in addition to configurable bundles and configurable products in the same subscription.
- If two items are added to the cart that use the same trial product but there is a different substitute product, product variation, or product option, then the trial products will be added as a separate line items.
- When a configurable bundle is flattened in a subscription, the editable item adjustment field will be available on shipments in the Fulfiller UI. When viewing shipment details for a shipment that belongs to a subscription, a column for Item Adjustment will be visible for each individual line item and the user will be able to add/subtract from that item’s unit price.
- Configurable bundles now support scenarios with extras of the text or Boolean types (previously, only product-type extras were supported). Text and Boolean extras will remain associated with the parent product as one line item in the shipment, not split into separate line items like product extras.

Fulfiller Functionality

Reprint Packing Slips: The ability to reprint packing slips has been added to the Fulfiller UI’s Prepare For Shipment step, making it more convenient to reprint these documents as needed. This includes reprinting all slips for the shipment or only specific ones, which is selectable from the print preview. This option is displayed as an additional button at the bottom of the step.

Search Functionality

Search UI Enhancement: A typo has been fixed in the Search Configurations page where “Category” was misspelled in the Category Suggestion tab.
Search API Enhancement: The maximum allowed number of search redirects has been increased from 100 to 1000 to better support large numbers of records.

Bug Fixes

The following list summarizes resolved issues for this release.

Status	Resolution
Targeted for Production Tenants	Tracking number information that used to be included in the shipment history on the Fulfiller UI was no longer displayed on some shipments. This has been fixed so that tracking number change events will always be included in shipment history as expected.
Targeted for Production Tenants	Duplicate item cancelation emails were being triggered when a transfer shipment was canceled, because it would create notifications for the item on both the parent shipment and the transfer. This has been corrected so that these emails are only triggered from the parent shipment and duplicates are not received from transfers.
Targeted for Production Tenants	The Auto Reassign API was not behaving like the Auto Reassign action in the Admin UI, as it would put the shipment into Customer Care instead of a new fulfillment location as expected. This has been fixed so that you can successfully auto reassign shipments to new locations via API.
Targeted for Production Tenants	Transfer shipments were not being captured in pick waves when the STH order type was selected. This has been fixed so that applicable transfer shipments are properly included in pick waves for both STH and BOPIS order types.
Targeted for Production Tenants	Changing a location’s hours of operation in the Admin UI did not successfully update the label associated with that day of the week in API data. While this could be updated with the Update Location API, this behavior has been improved so that the label is synced with the hours of operation in the Admin UI and will update to reflect edits. If a location is marked as Closed for a day, the label will be cleared.
Targeted for Production Tenants	Aggregate inventory values were not being correctly calculated and displayed in the Inventory UI. This has been fixed so that the proper aggregate inventory levels are displayed.
Targeted for Production Tenants	Attempting to edit a customer address on an order through the Admin UI resulted in a validation error, even though the address was correct. This has been corrected so that addresses can be successfully updated on orders.
Targeted for Production Tenants	Changes made to the email options in General Settings were being wiped after clicking Save. This has been fixed so that these settings are able to be properly updated and the changes will not revert.
Targeted for Production Tenants	A particular user was no longer appearing as an option when querying the Discounts UI with the “Created By” filter, due to there being more users than the maximum received by the UI. This has been updated so that the users are paginated instead, allowing them all to be available in filtering.
Targeted for Production Tenants	The Search spell check did not work if more than one facet was added to the search string, as the misspelled word would be queried for instead and return zero results. This has been fixed so that spell checking supports multiple facets and filters and search results will be returned correctly.
Targeted for Production Sandboxes	Admin users were unable to edit line item prices before submitting a new order, as an error message would be displayed after attempting to save and the price would reset. This has been fixed so that line item quantity, unit price, fulfillment method/location, email address, and contact information can all be successfully updated during order placement.
Targeted for Production Sandboxes	If a user was added to a sandbox and a dev account and accepted both invites, then logging in would always direct them to their first sandbox instead of the Launchpad. This prevented them from accessing their dev account, but has now been corrected so that users will land on the Launchpad as expected after logging in.
Targeted for Production Sandboxes	When using STH Consolidation, a parent shipment was able to be fulfilled from the Fulfiller UI without fulfilling the transfer shipment. This process has been updated so that the consolidated parent shipment will stay in the Waiting For Transfer step as expected until the transfer is complete.
Targeted for Production Sandboxes	The option to manually re-assign a BOPIS transfer shipment from the Order Admin UI was missing due to recent UI changes for STH Consolidation. This has been fixed so that the Manual Reassign button will only be disabled for those STH transfers, and BOPIS transfers can be reassigned as intended.
Targeted for Production Sandboxes	The Get Wishlists API call returned a 500 Error when a call was made with a startIndex of a value higher than 15000. This query has been optimized with better indexing so that it can retrieve wishlists from large databases with a high startIndex parameter.
Targeted for Production Sandboxes	When making an API call using the “eq” operator for the closedDate field, an internal server error would be returned instead of the expected results. The API filtering process has been fixed so that filters can be successfully created with the “eq” operator.
Targeted for Production Sandboxes	Adding users to a sandbox from the Admin UI resulted in a validation error even if their email addresses were valid. This has been corrected so that validation does not generate a false negative and users can be successfully added.
Targeted for Production Sandboxes	Users’ names were not displayed in the Created By field of order notes if there were more than 200 users in the system and the user who created the note was located above the 200th place in the user list. Order notes have been updated to support larger user lists and can now successfully retrieve user names appropriately.
Targeted for Production Sandboxes	Product extra images were not being displayed in the Fulfiller UI, and those items instead displayed the parent product’s image. This has been fixed so that the appropriate image is displayed for product extras that have their own images.
Targeted for Production Sandboxes	Categories were not being properly indexed between Personalization and KCCP, resulting in visual searches not returning expected categories. This integration has been improved so that categories are imported and indexed appropriately and can be returned in personalized searches.
Targeted for Production Sandboxes	Facets were unable to be ordered via drag-and-drop in the Search Results template of Site Builder. This has been fixed so that they can be reordered by dragging within this template and then saved successfully.
Targeted for Production Sandboxes	After splitting a shipment, payment reauthorization requests did not include the details of the previous transaction. This has been fixed so that the second authorization can be completed with the information from the first transaction in this scenario.

​Production Tenant Features

​eCommerce & Order Management Functionality

​Fulfiller Functionality

​Production Sandbox Features

​eCommerce & Order Management Functionality

​Fulfiller Functionality

​Search Functionality

​Bug Fixes

Production Tenant Features

eCommerce & Order Management Functionality

Fulfiller Functionality

Production Sandbox Features

eCommerce & Order Management Functionality

Fulfiller Functionality

Search Functionality

Bug Fixes