April 6, 2021 — 1.2112 Service Update

Production Tenant Features

eCommerce and Order Management Functionality

  • User Management Updates: It is possible to search the list of all Kibo Composable Commerce Platform user accounts in the user management interface, filtering the list of users with access to the KCCP Admin by first name, last name, and email address. See the User Management documentation for more information about this interface.
  • Klarna, CrowdTwist, and Sezzle Payment Types: Support for payment via Klarna, CrowdTwist, and Sezzle has been added for clients upgrading from a previous version of OMS where these payment methods were used. These are processed through NoOp gateways and can be used as credit card types if configured in the Payment Types settings. See the Payment documentation for more information about gateways and payment types.
  • Future Inventory in Inquiry: With inventory tagging and segmentation, the ability to set a deliveryDate to indicate when future inventory will be available was added to the Inventory Refresh and Adjust capabilities. Now, future inventory information can be retrieved from the Get Inventory API call if a deliveryDate was set during inventory refresh.
  • FedEx Cross Border Support: FedEx Cross Border is now supported as a carrier options in KCCP. It can be configured like other carrier integrations, including setting rates and toggling available shipping types and defaults at the location group level. Tracking information and shipping labels will be communicated between the KCCP Fulfiller service and Cross Border when it is enabled in the shipping and location settings.
    Imported orders can use the FedEx Cross Border service types when their shipping methods are set to fedexcrossborder_FDXIE (International Express) and fedexcrossborder_FDXIP (International Priority). The order’s shipment(s) will have the type “FXCB” to indicate Cross Border.

    See the Shipping Settings guide for information on how to configure carriers including FedEx Cross Border and additional behavioral notes.

Fulfiller and Translated OMS Functionality

  • Block Assignment from Transfer Shipments: The “Exclude location from future assignments” option was previously only available for Ship to Home shipments but has now been added to Transfer shipments as a checkbox next to the Assign Shipment button of the Validate Stock step. When selected, order routing will not assign any more shipments to that location until inventory is refreshed. This setting correlates to the blockAssignment parameter of Shipment API data, and thus can be set if updating shipments via API.
  • Translated Shipment Transitions: The API calls to transition shipments through their BOPIS and Transfer BPM states are now fully supported in the translation layer, allowing some implementations that upgraded from the previous version of OMS to use their legacy API request bodies on KCCP endpoints for these actions. This includes the transitions waitForTransfer (or wait_for_transfer) on BOPIS shipments and shipped for Transfer shipments. See the Translated OMS API documentation for a template of these shipment calls.
  • Translated Orders with Multiple Payments: Support for multiple payment types within an order has been improved in the translated APIs, allowing clients who have upgraded from a previous version of OMS and are using translated APIs to continue using their existing order import and payment processes for multiple payment methods.

Production Sandbox Features

eCommerce and Order Management Functionality

  • Custom Order/Item Data in UI: Custom order and order item data is now displayed in the Order Admin UI alongside the standard order data, allowing for admins and customer service representatives to add, edit, and delete custom data values. 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. See the Order Admin guide for more instructions on how to view and edit custom data in the UI.
  • Bin Inventory Call Updates: Support for the Inventory Bin API calls …/v1/bin/loadInventory and …/vi/bin/searchInventory has been updated, allowing users familiar with these calls from the previous version of OMS to make these requests in KCCP. This includes support for tagged and non-tagged inventory.
  • OMS-Only Discount Totals: The discounted total displayed in the order totals information of the Order Admin UI will now display the discounted subtotal for OMS-only clients instead. This more closely matches behavior from the previous version of OMS, as discounts for OMS-only clients are calculated in their separate commerce system before the order is imported into KCCP.

Translated OMS Functionality

  • Assign Order API: The Assign Order API is now fully supported by the translated Order Management APIs for upgraded clients, allowing users from the previous version of OMS to continue using their existing requests to make calls to the KCCP endpoint. 
  • Assign Shipment API Updates: The Shipment Assign API (…/shipment/action/assign) can now accept shipment statuses of SHIPPED and CANCELLED with different behavior to better reflect functionality in the previous version of OMS. Assigning a shipment in KCCP creates a new shipment ID, where the previous version of OMS only creates a new shipment when splitting an existing one. To address this discrepancy:
    When assigning a shipment with the SHIPPED status and it is a partial assignment case, the item assignment values will be split into a new shipment and the new child shipment will be fulfilled. In a full assignment case, the given shipment is fulfilled and there is no new shipment created.

    When assigning a shipment with CANCELLED status, the item assignment values are split into a new shipment and the new child shipment will be cancelled while a cancel shipment notification is triggered. This matches OMS functionality where canceled items are not tracked on the same shipment as items that are ready to be fulfilled.

Bug Fixes

The following list summarizes resolved issues for this release.

StatusResolution
Targeted for Production TenantsTheme packages were not deleting successfully in the Dev Center, even if there was a success message after clicking Delete, as the package would still be listed and selectable in the dropdown menu. This has been fixed so that deleting a package will fully remove it from the Dev Center options.
Targeted for Production TenantsCreating a return in the Fulfiller UI did not always include the refund amount in the API data, preventing the product loss amount from being calculated. This process has been updated so that refund amounts will be properly calculated and returned by the APIs.
Targeted for Production TenantsWhen an order included multiple shipments and one was returned, the returns transaction log would include all shipments for the order – even those that were not returned. This has been corrected so that returns transaction logs will only report shipments that were actually returned.
Targeted for Production TenantsThe packing slip that was downloaded from the FFUI for printing was generically named “pdf.pdf.” A distinction is now made between the file names, displaying the shipment number in the format “shipments_123.pdf” to make the documents more accessible.
Targeted for Production TenantsThe cancel transaction log was not returning any entries, despite the existence of canceled orders and shipments in the system. This was due to missing identifiers in the payment authorization information that this log uses to search for cancelations. This has been fixed so that the log will be properly populated.
Targeted for Production TenantsThe Fulfiller UI would not display all labels if the browser’s default language was set to a language other than French or English, meaning that text would be missing from the UI. This has been fixed so that browser languages other than French or English will default to the English version of the UI.
Targeted for Production TenantsThe SMART_POST service type was being stored incorrectly in the KCCP database, causing errors while generating shipping labels for FedEx SmartPost shipments. The service type data has been updated so that SmartPost shipments can be properly retrieved and labels can be properly created.
Targeted for Production TenantsPick sheets were blank when attempting to print them from the FFUI. This was due to pick wave numbers being incorrectly set in the back-end URLs, and has now been fixed so that pick sheet documents can be properly viewed and printed.
Targeted for Production SandboxesWhen a handling override amount was set, there would be a mismatch in the Admin interface between the balance listed in the order summary (at the top corner of the order view) and the order total in the order details tab. This was due to the order summary not taking the handling amount into account when calculating the payment balance, and has been corrected so that it displays the accurate total.
Targeted for Production SandboxesVariant attribute data was displayed on the product details page, but not available in product data from the cart or checkout page. This has been corrected by adding the product’s variant property information to the cart and checkout data payloads to be displayed on the appropriate pages.
Targeted for Production SandboxesThe “Express Shipping” filter attribute in Order Routing was not properly excluding groups and the associated isExpress parameter was not shown in the Suggestion Log API call, making troubleshooting difficult. This caused locations to be assigned to when they should have been excluded. This routing process has been updated to properly filter out locations based on whether they support express shipping and indicate that data in the logs.
Targeted for Production SandboxesShipment details were often not loading on Zebra scanners or other mobile devices such as phones when using the Fulfiller UI, while the discount and line item subtotals were not being shown at all. Enhancements have been made to improve the loading time and display all of the shipment information on mobile devices.
Targeted for Production SandboxesMaking a translated Create Order API call with a PayPal payment resulted in an API Transformation Error. This has been updated so that the auto capture process will handle these payments as usual.
Targeted for Production SandboxesThe translated Create Order API did not accept payments with a “V1” card issuer field even though it was a valid payment type for the particular implementation of the Kibo Composable Commerce Platform, and transaction logs did not display the correct card issuers or subtype data. This has been fixed so that the V1 payment type can be successfully used in order creation and transaction logs are accurate.