June 29, 2021 — 1.2124 Service Update

Production Tenant Features

eCommerce & Order Management Functionality

• Digital Gift Cards in Order Admin: Digital gift card information is now displayed as part of the shipment details in the Order Admin, including the card number and PIN, the names and emails of the sender and the recipient, and the gift card message. The recipient information and gift card message can be updated, and the gift card email can be resent to the recipient if needed. Note that these digital products are created as a shipment with the type “Digital” that is automatically marked as fulfilled and captured upon creation. See the Digital Gift Cards guide for more information.
• Mobile Fulfiller Enhancements: The ability to scan UPCs and SKUs from the Validate Stock step of BOPIS, Ship to Home, and Transfer shipments in the mobile fulfiller application has now been added to support scanning with Linea Pro Sled devices for a particular implementation. Several enhancements have been made to improve the display of text fields in the Validate Stock step and fix the search bar that was not returning results.
• Block Assignment for Backorders: The blockAssignment flag that blocks future assignment to a shipment’s original assigned location has now been added to the Backordered Items API. This allows assignment to be blocked from that location when you do not want backorders to be assigned to the same location when they are released. 

Production Sandbox Features

eCommerce & Order Management Functionality

• Preparation & Delivery: Merchants can now offer preparation and/or delivery services, which shoppers select when adding items to their cart and placing the order. Delivery is a new shipment type in which fulfillers personally deliver a product from the store to the customer, while preparation includes any additional tasks to ready the product such as assembly or warranty. These options, which are handled as “service items,” must be configured in the product catalog and enabled at the location level (in the case of delivery) before they are available to shoppers. See the documentation for more information.
• Refund Ranking: As with existing payment rankings for capture, you can now use site settings to specify the preferred order in which payment should be refunded. When creating a refund, the system will set default payment amounts based on the rankings starting from the one given highest priority. This is supported for both the one-click Initiate Refund and the manual Issue Refund options in the Order Admin. Auto crediting will also refer to refund ranking when it determines which payment methods to credit. If no refund ranking is set, then refunds and credit will be processed in the reverse order of payment ranking. If a payment type is not specified, then it will be processed last. For more information about rankings, see the Payment Settings guide.
• Multiship with Auto Capture: Automatic payment capture is now supported alongside multiship. When both of these features are enabled, then the auto capture will check all of the child orders on a multiship order to determine the total amount that needs to be captured, check all sibling orders to determine the total amount to reauthorize, and update the payment status on all child orders. In the event of a cancellation, the auto process will also determine the amount to be credited across all sibling orders. See the Auto Capture and Multiship documentation for more information.
• Updated Gift Card Email: When resending digital gift card emails from the Order Admin UI, the email template will now always retrieve the current gift card message from the API. This means that if a CSR changes the message and resends the email, then the email will reflect their update instead of displaying the old version. The card number and other data in the email will not change.
• Transfer Shipment Updates: A couple of enhancements have been made to the transfer shipment process. When viewing the list of pickup locations in the Order Admin to assign a transfer, the location options are offered based on inventory availability so that only correct pickup locations can be selected. Backorder shipments will now be created if there is excess quantity requested than available for transfer and pickup (if backordering is enabled, otherwise an error will be returned). Additionally, shoppers are able to add pickup items to their cart if inventory is available at pickup stores OR transfer locations, as transfer locations could supply the product to the pickup store even if the store is already out of stock. However, there is no core theme update to calculate this in the storefront. It will require custom code to make two API calls: one for inventory at the pickup location and one for aggregate inventory across transfer locations.

Order Management & Translated API Functionality

• Item Identifiers in TLogs: Item identifiers (such as physical gift card numbers and PINs that fulfillers record during fulfillment) are now displayed in the sales, returns, credits, and cancels transactional logs. When identifiers exist for an order item, new “unit” fields in the item element will report the name and value of the identifier such as . There will be a separate unit field for each identifier on that item. For more information about transactional logs, refer to the documentation.
• Exclude Future Assignment Toggle: The “Exclude Future Assignment” button that is displayed in steps of the Fulfiller UI such as Validate Stock can now be hidden from users who are not administrators or managers. The localization file within the theme now has a tenant setting for “isAllowExcludeLocation” that can be set to true or false to toggle the button. If toggled off, another setting will confirm whether to display the button for admins and managers or hide the button for all users. This prevents employees without higher access level from selecting that option. It is toggled on for all users by default.
• Historical Order Import Updates: Several improvements have been made to the historical order import process that copies orders from the previous version of Order Management to KCCP. An isHistoricalImport flag has now been added to the order data and a Site ID is now required. This process will also update the customer’s lifetime value in KCCP and use a separate queue to process these imports than the live KCCP orders. Note that historical orders’ status must be Completed or Cancelled and will result in an error otherwise. No fulfillment or shipment creation is done to these imported orders.
• Translated Gift Card Items: The Create Order API fields for a gift card recipient’s name, email address, and gift card message are now mapped to be supported by the translated APIs. Sending a Create Order request through the API translation layer with a request based on the previous version of OMS will convert the data and create a new order in KCCP with a digital gift card as an order item. See the API documentation for more information about translated APIs.
• Translated Routing Candidates: The POST request to retrieve order routing location candidates at …/api/v1/routing/candidates is now supported by the translation layer between KCCP and the previous version of OMS, allowing upgraded clients who are using translated APIs to continue making their existing requests to this API. See the API documentation for more information about translated APIs.

B2B Functionality

• Sales Representative Behaviors: The B2B Sales Representative role has been updated with additional behaviors to manage their B2B accounts. Previously, they did not have authorization to enable purchase orders, add customers or segments, add/update/delete users of B2B accounts, and perform other expected actions. This role now has an updated list of permissions and is able to manage B2B account users and customer segments, create and update purchase orders, manage pricelists, etc. See the B2B and User Roles documentation for more information.
• Account Upgrades: B2B APIs now better support the process of upgrading to KCCP from a previous version of Kibo eCommerce, allowing existing B2B accounts to be more easily upgraded without breaking due to missing approval statuses that are required in KCCP but may not exist in older instances. See the B2B documentation for more information.

Bug Fixes

The following list summarizes resolved issues for this release.