May 18, 2021 — 1.2118 Service Update

Production Tenant Features

eCommerce & Order Management Functionality

• Item Identifiers – A new type of item-level data, called the item identifier or fulfillment field, is now supported in Order Management. This can be a serial number, manufacturer number, or a number for a gift card item to load a value to, and can be set by fulfillers while fulfilling shipments. These identifiers are ingested from the Create Order API and flagged as required or optional for the fulfillment process. Fulfillers then set the attribute values while validating stock in the FFUI, and the values are displayed with the shipment and returnable item details in both the FFUI and Order Admin. In the order items object when creating and importing orders, a new “fulfillmentField” object is supported for each item. For example, a required serial number identifier would look like:

  "fulfillmentField": [
    {
        "name": "serialNumber",
        "userEnteredValue": "sdklj34kl343kl98712n",
        "isRequired": true
    }
  ]

  See the Order and Shipments API documentation as well as the FFUI and Order Admin user guides for more information about how this data is presented.
• Discount Mismatch Handling: An adjustment has been made to how discounts are applied in KCCP. Occasionally, there could be a small discrepancy between the Discount Total and the Calculated Discount Total due to price variations which would result in an error. When the discount total doesn’t match the calculated discount from RetailPrice – ActualPrice, the discount values will now automatically adjust to account for the difference and instead of failing.
• Capture Imported PayPal Orders: PayPal import orders can now be captured as soon as the order is placed. The existing Admin payment setting to select between “Authorize and Capture on Order Placement” or “Authorize on Order Placement and Capture on Order Shipment” has been leveraged for these PayPal payments. If this setting is set to auth and capture on order placement, then imported orders will be captured upon placement in the same manner as non-import orders.
• TLog Shipment Update: Transaction logs now report what amount is captured for each shipment in the payment records. The payment interaction has a breakdown of what amount was captured on each shipment, including Ready to Capture shipments. The report includes the gift card or authorization data and capture amount with the Order ID. Note that this only applies to auto capture. Manual captures are not recorded in transaction logs. Additionally, cancelled shipments are credited immediately if capture occurred before fulfillment (such as store credits, PayPal, and forced captures).
• Custom Shipment Data in UI: In Version 1.2112, the ability to manage custom order and order item data via the Admin UI was released. Similar functionality has now been added for custom data at the shipment level. This allows admins and customer service representatives to add, edit, and delete custom data values on individual shipments. Note that custom data is configured in key:value string format and is passed to the shipments that are generated upon initial order creation. If you wish to edit custom data after the fact then it must be done on a per-shipment basis. This means that you should update the custom item data on each shipment within the order because a change will not be applied across the board.
• Order Routing UI Update: As part of ongoing improvements to the Order Routing UI, some tweaks have been made to the routes page. This includes updating the active toggle design as well as adding radio buttons to select between single or multiple assignment more easily. The functionality of this routes page remains the same.

B2B Functionality

• Restore Expired B2B Quote: The B2B quote process now supports moving an expired quote back to In Review status when the seller wants to revive the quote. When the seller views an expired quote, there is a Revive button option that will prompt the seller to provide a new expiration date and then restore the quote to be reviewed and edited again. See the B2B documentation for more information about this feature.
• B2B Third-Party Payments: The B2B checkout can now support third-party payment integrations when placing an order created from a quote. No changes to shipping address, method, or other fulfillment options restricted by B2B buyer permissions are allowed through these integrations. See the B2B documentation for more information about this feature.

Translated OMS Functionality

• Get Order Item API Update: Parameters for shipmentID and itemState have been added to the translated Get Order Item API. These parameters did not exist in the previous version of OMS, but can be used by upgrade clients to return items from a specified shipment as well as items in a particular state (either NORMAL or CANCELED). These can be used to filter the GET request in addition to being provided in the request body, such as in …/orderItem/?shipmentID=0000, though either an orderID or shipmentID must be provided in the endpoint for every call.
• Canceled Items in Shipment/Order APIs: A canceledItems array has now been added to the response payload for the translated GET Shipment and GET Order APIs. The existing shipments array in these APIs included a list of active items in Ready status, but there was no way to retrieve a list of items that had been canceled from these APIs. The new canceledItems array is also located within the shipments data and includes items in the Canceled state, allowing users to retrieve a comprehensive information for all items in the shipment and/or order.
• Special Shipment Canceled Notification: A new cancel shipment notification has been created for certain OMS upgrades that may require it. This notification is sent any time that items are cancelled, matching the behavior of the shipment cancellation notification in the previous version of OMS. The notification includes the list of order item IDs that were canceled. This notification is not available on all implementations, as it is a special event enabled in the tenant configurations. If this feature is not enabled, then normal KCCP notifications will be sent out instead.

Production Sandbox Features

eCommerce & Order Management Functionality

• File Manager: The existing file manager at Main > Site Builder > Files has been updated with a new UI and additional functionality, improving organization and management of images and other files for the storefront at the master catalog level. Uploaded files can be arranged into folders within the tree hierarchy and various actions can be performed on them, including adding tags. See the File Manager user guide for more information about how to view custom item data.
• Item Identifier Validation: Additional validation has been added to the new Item Identifier feature when fulfiller users are required to provide it. This validation will check serial numbers and PINs to make sure that the user is not setting a value of null or a blank space to avoid inputting the actual data. The fields can accept other alphanumeric values, including special characters.
• Item Identifiers in Returns: If item identifiers were set for an item, then that information is now displayed as a tool-tip on that line item when creating and processing returns in the Fulfiller UI. This makes it easier for fulfiller user to reference item information when needed for handling return cases.
• View Fulfilled Custom Data: Custom item data can now be viewed on shipments in the Admin UI that have been fulfilled. Previously, viewing item data was not an option for fulfilled shipments though it was allowed on those in other states. The option to view item data after fulfillment enables users to review and reference all of the item information at any point if needed. See the Orders UI guide for more information about how to view custom item data.

Translated OMS Functionality

• Event Notification Updates: The translated Order Management APIs for upgraded clients have been updated with improved event notification processes to prevent duplicate notifications from being sent on occasions where they may be triggered. The system will check to determine whether the notification has already been sent, and if so then it will not be delivered. This should reduce problems in the future for implementations that rely on certain notifications being sent only once.
• Transfer Received Notification Updates: A new Transfer Received event is now supported for the Stock Validated and Accept Transfer notifications in upgraded implementations that use translated APIs and notifications. Previously, if multiple transfer shipments were being received then no events or notifications would be triggered until the last shipment was received. With the new event process, notifications will be triggered for every received transfer. The notification will be Accept Transfer if the previous step was Wait For Transfer, otherwise it will be Stock Validated.
• Order Status Updates: The translated Search Order and Search Shipment APIs have been updated to represent order statuses in an improved hierarchy, matching existing behavior in other areas of KCCP. Order statuses will now be determined in the following priorities: Payment Hold (order is flagged for Pending Review), Payment Error (payment status is flagged as Errored regardless of any other order or fulfillment status), Backorder (at least one shipment is in Backorder), Customer Care (at least one shipment is in Customer Care), Ready (at least one shipment is still ready), Fulfilled (all non-canceled shipments are fulfilled), and Canceled (order status is canceled).

Bug Fixes

The following list summarizes resolved issues for this release.