May 17, 2022 - 1.2218 Service Update

Announcement: API Rate Limiting

Kibo now enforces rate limiting on API requests in sandbox, pre-prod, and production testing environments. If you submit too many requests to a API in a certain period of time, then further requests will be rejected by Kibo to avoid overburdening the Kibo Composable Commerce Platform system and negatively impacting performance for other users. For more information about how rate limits work and how to self-manage your own implementation, see the API Best Practices.

Production Tenant Features

eCommerce & Order Management Functionality

Imported Completed Orders: You can now fully import historical orders in Completed or Canceled status via the Create Order API and shipment records will be created for these orders. The isHistoricalImport flag should be set when performing the import, which will carry over to its shipments. These orders and shipments will be displayed in the Order Admin and Fulfiller UIs where you can perform returns, refunds, and credits on them. However, the creation of shipments and support for those actions requires a site setting (“Refund/Credit on imported orders”) to be toggled on prior to import.
Configurable Bundles for Subscriptions: You can now include bundled items in subscriptions. These “configurable bundles” are different from the existing Bundle product usage, as they require a standard product to be configured with product extras to represent the bundled items. That product must then have additional subscription attributes configured, which allow the bundle to be flattened into individual items at either the subscription or shipment level and have the total pricing distributed amongst the extras.
Other Subscription Updates: Additional follow-up enhancements have been made to the subscriptions feature:
- When using the minimum order amount or continuity order constraints for subscription discounts, only subscription items will be factored into those constraints. Likewise, subscription-only discounts will only apply to the subscription items (not one-time purchase items) when calculating the order total.
- The item subscription price will now be displayed when adding an item to an order or existing subscription in the Admin UI. This improves clarity and more accurate information, as the subscription price may be different from the one-time purchase price depending on the item’s price list configurations.
- The external subscription ID is now displayed in the subscription details if that value exists for that subscription, such as if it was imported as an existing subscription from another eCommerce system.
- A reprice now occurs whenever a continuity order is made from a subscription.
- Items that are canceled from a subscription are now tracked in a canceled items array of the subscription data.
- Additional validations are now enforced on the Subscriptions API, ensuring that an item cannot be added to a subscription if it doesn’t support the subscription’s frequency.

Fulfiller Functionality

STH Consolidation: A new variant of Ship to Home can now be enabled on locations, in which transfer shipments send STH items to a centralized location to be fulfilled together instead of splitting the shipment. This adds a Waiting For Transfer step to the STH fulfillment flow and saves on the customer’s shipping costs. For more details and information about how order routing logic handles consolidation of these items, see the STH Consolidation documentation.
Packing Slip Backwards Compatibility: Some upgraded OMS implementations had existing behavior to print multiple shipping labels on a single packing slip. However, the Split Packing Slips feature removed the ability to do this. There was no backwards compatibility to support generating multiple shipping labels and tracking numbers per slip while the feature was enabled. Support has now been added so that upgraded OMS clients can continue their existing behavior of generating multiple labels and tracking numbers on a single slip, as long as there is only one packing slip for that particular shipment.
Display Order Reference Number: The ability to query shipments by order reference number (the parentCheckoutNumber in Commerce APIs) was recently added with 1.2212. Now, this order reference number can also be displayed in the shipment details of the Fulfiller UI while viewing search results. By default, this field is not displayed and can be toggled on in the fulfiller theme settings (the displayOrderRefNumber option). Note that searching by this field will look for an exact match.

Production Sandbox Features

eCommerce & Order Management Functionality

Shipping Manifest Error Message: When an attempt to create shipping manifests for Canada Post fails, the error response will now include a list of affected shipment(s) that are causing the issue. Previously, you would have had to test generating the manifest for one shipment at a time to determine which were at fault. The error message also now prompts you to refresh the page, which is the recommended action in this scenario.
Fulfiller UI Advanced Search: Additional search parameters have been added to the Advanced search options of the Fulfiller UI for Shipment Number, Order Number, and UPC (which maps to the Product Code). While you could already search by shipment and order numbers in the quick search, adding them to the Advanced menu allows for more fine-tuned queries. For instance, using the Advanced menu to filter by Shipment Number will restrict the results to only those with a matching Shipment Number but the quick search may have returned matches from other fields as well.
Subscription Enhancements: More enhancements have been made to Subscriptions.
- When a subscription is created from an order, the initial order is saved as parentOrderId in the subscription data.
- Validation has been added to ensure that if an item is set up as subscription-only, then it cannot be bought as a one-time purchase and attempting to do so will result in an error.
- Item-level and order-level subscription discounts are now appropriately displayed in subscription details in a similar format to B2B quotes, including the discount name.
- When editing a subscription from the Customers page and adding a configurable product, a modal will now appear that allows you to select a product variation.
- Validation has also been added to product attributes to ensure that the Separate Product Extras During Subscription Creation attribute used for configurable bundles can only be enabled if Distribute Pricing to Extras on Shipment Creation is also enabled. This may also be called “Split Extras in Subscriptions.”

Bug Fixes

The following list summarizes resolved issues for this release.

Status	Resolution
Targeted for Production Tenants	When a shipment item was canceled, the `shopperEnteredValue` field in the options object of its API data was lost. This has been corrected so that this value stays with the shipment item when it moves from the regular item array to the canceled items array.
Targeted for Production Tenants	When attempting to create orders using the DKK currency code, a 409 Error would be encountered instead. This was due to a validation issue with rounding strategies, which has now been fixed so that DKK orders can be placed.
Targeted for Production Tenants	A gift card gateway connection issue caused a child order in a multiship scenario to be placed in the Pending and then Abandoned state, although it had a collected PayPal payment. Order creation logic has been updated so that multiship child orders will go into the Errored state if the order submission fails due to a reason such as gateway timeout.
Targeted for Production Tenants	Multiship orders were being put into the Pending state when there was no inventory for an item. However, the expected behavior was for the order to be accepted and then moved into Customer Care or Canceled status by Order Routing. This was due to the logic of the product validation process, which is now skipped by multiship cases so that orders are placed in the proper status.
Targeted for Production Tenants	The KCCP version of the Get Returns API did not include any product options in the items array, though that information was provided in the Get Returns API on the previous version of eCommerce. The KCCP version of this API has been updated so that product options are passed to the return record.
Targeted for Production Tenants	The “Send Test Email” option in the Site Editor did not actually send a test email as expected. This option has been removed for now, until support for that function is in place.
Targeted for Production Tenants	Orders with declined payments were unable to be canceled as they couldn’t be refunded or voided, leaving them stuck in processing. This behavior has been updated so that unpaid and fully voided orders with canceled shipments can be successfully canceled.
Targeted for Production Tenants	The Avalara application was showing a “CompletedFailure” status code in its event log after fulfilling a shipment, though the event was successfully processed. This has been fixed so that the event status code will properly display “Success” when appropriate.
Targeted for Production Tenants	Credits and refunds on gift cards were being duplicated when there were multiple payments on an order. This has been corrected so that these payment actions only occur once per order for the proper gift card record.
Targeted for Production Sandboxes	When viewing the mobile Fulfiller UI, page elements were offset and pushed to the left side which caused words to wrap around and make the page difficult to read. This has been fixed so that tables and other elements are properly displayed on mobile.
Targeted for Production Sandboxes	Orders canceled by Cybersource during the fraud review process did not trigger Order Cancel email notifications. This has been corrected so that cancellation emails are properly sent to the customer when Cybersource cancels their order.
Targeted for Production Sandboxes	Transfer shipments were not visible on the Admin order details page if the order had more than 50 shipments. This has been fixed by changing the limit to 80 shipments for now, though paging may be added in the future for better support. Currently, there may be performance issues on the page if the order has more than 50 shipments.
Targeted for Production Sandboxes	The Import/Export tool was experiencing errors in sandbox environments when the user attempted to download any export job. This was due to the cache not refreshing and returning old data when retrieving a job. This has been corrected so that exports can be successfully downloaded.
Targeted for Production Sandboxes	The GBP currency was being incorrectly displayed as USD in price lists and when selecting products to order on the storefront. This has been corrected so that the configured currency is displayed in price lists as expected.
Targeted for Production Sandboxes	When configuring a product type for digital gift cards, the Advanced option for “This product type is a digital gift card” did not properly map the goodsType value in API data. The interface has been updated to list all of the possible options with proper mapping: physical items, service items, digital items, digital credit items, and digital gift cards.
Targeted for Production Sandboxes	Merchandizers were able to edit the spell correction and whitespace fields on the Search Settings configuration page, which should not have been allowed for the merchandizing role. Attempting to change those fields still resulted in the proper error, but the UI has now been updated so that these configurations are disabled from interaction in the first place.
Targeted for Production Sandboxes	When there were a large number of facets in a catalog, changes to these facets could not be saved from the Site Editor due to timeout errors. This prevented adding and removing facets as well. Optimizations have been made so that facet edits can now be successfully saved without timing out.
Targeted for Production Sandboxes	Adding the same subscription product to a subscription twice with different frequencies merged the line items when they should have stayed separate. This has been fixed so that the product remains as a separate line item if it is re-added to the subscription with a different frequency. This fix also applies to trial products (where re-adding the same trial product with a different frequency will keep it as a separate line item) and when the same product is added as both a subscription and one-time purchase on the order.
Targeted for Production Sandboxes	Selecting a saved address to be a customer’s new primary address was not successful, as the account details would still display the old primary address after clicking Save. This has been fixed so that primary addresses will properly update with the selected address.
Targeted for Production Sandboxes	On Order Management-only implementations, all completed orders were displaying the “This order is an imported historical order and cannot be edited” message even when it was not an imported order. This has been corrected so that the message is only displayed on applicable orders and shipments.
Targeted for Production Sandboxes	Attempting to refresh inventory was returning a “foreign key” error from the database. This process has been updated so that refreshes can be successfully performed without this error.

​Announcement: API Rate Limiting

​Production Tenant Features

​eCommerce & Order Management Functionality

​Fulfiller Functionality

​Production Sandbox Features

​eCommerce & Order Management Functionality

​Bug Fixes

Announcement: API Rate Limiting

Production Tenant Features

eCommerce & Order Management Functionality

Fulfiller Functionality

Production Sandbox Features

eCommerce & Order Management Functionality

Bug Fixes