Release notes for OMS

These release notes document numerous functional fixes and enhancements of the Order Management System. Release notes are published in conjunction with the release to staging, approximately one week before the production release.

To see release notes specifically for hotfixes, check out Hotfixes.

Release notes include:

  • New features
  • Improvements
  • Known issues


Staging release—October 2, 2019

Production release—October 16, 2019

  • Service Bus updated to v2.0.6-The Magento Service Bus has been updated to version 2.0.6, which allows deleting expired messages from the SQS queue
  • Canceled ISPU - STS shipment request items move to canceled status—Now, when canceling an In-store Pickup (ISPU) - Ship to Store (STS) order in the Customer Service view after declining the items in the STS flow, the shipment request items are moved to a canceled status instead or remaining in a pending arrival status.

  • Single lists created when customizing generation of pick list—A previous issue, in which multiple pick lists were created when customizing the generation of the pick list during the Ship from Store (SFS) flow, has been resolved. Now, only one pick list is created during this customization.

  • Start Packing button now visible—The Start Packing button within the Ship from Store (STS) process is now active, and not grayed out (caused by the latest version of Google Chrome).

  • Multiple clicks of Start Packing button incurs single distribution—Multiple clicks of the Start Packing button now only produce one distribution action, instead of attempting to distribute the pick list multiple times and encountering an error.

  • Block search engine indexing with robots.txt—We updated the robots.txt file to ensure the Order Management System (OMS) Admin is not indexed by web search engines.

  • order_line_number added to line_cancelled message—The order_line_number was added to the magento.sales.order_management.line_cancelled specifications message.

  • New specifications for ISPU decline/cancel flow-We added a new set of fulfillment specification messages so that you can extend the current In-store Pickup (ISPU) decline/cancel picking/collection fulfillment flows to integrate your own ISPU fulfillment operations.

  • New specifications for ISPU ship/confirm collection flow-We added a new set of fulfillment specification messages so that you can extend the current In-store Pickup (ISPU) ship/confirm collection fulfillment flows to integrate your own ISPU fulfillment operations.

  • New specifications for ISPU pick flow-We added a new set of fulfillment specification messages so that you can extend the current In-store Pickup (ISPU) pick/confirm picking fulfillment flows to integrate your own ISPU fulfillment operations.

  • New specifications for SFS ship flow-We added a new set of fulfillment specification messages so that you can extend the current Ship from Store (SFS) shipping fulfillment flows to integrate your own SFS fulfillment operations.

  • Tracking info displayed in predictable format-The carrier, tracking link, and tracking number information now display in a consistent, easy-to-read format.


Staging release—August 27, 2019

Production release—September 5, 2019

  • New warehouse fulfillment flow specifications—Integrated a new set of specifications for the fulfillment warehouse flow, which expand the existing flow.

  • New Ship from Store (SFS) flow for picking—Integrated a new set of specifications for the fulfillment picking process, which expands the current OMS fulfillment flow to allow merchants to integrate their own custom SFS fulfillment operations.

  • New specifications for the Ship from Store (SFS) cancellation flow—Added a new specification, [magento.logistics.fulfillment_management.cancel_lines]((, for the fulfillment cancellation process.

  • New specification for the Ship from Store (SFS) decline picking flow—Integrated a new specification, magento.logistics.fulfillment_management.decline_lines, in the decline picking fulfillment process.

  • Implemented a status validation for shipment request items—A new validation was created for status transitions of the new fulfillment specifications.

  • New payment summary feature—Added a new payment information summary to the Order details page.

  • Payment information in the Order details view—Added payment information to the Order details page, with improvements in both the Customer Service and Sales views.

  • New standard error handling warning for the fulfillment specs—Added a new standard warning exception that is shown when there is a problem with the fulfillment flow and related specifications.

  • PickListController method checks the carrier integration configuration—Updated the PickListController method that checks whether the carrier integration is enabled to use the Order_Sales sales channel, instead of the default configuration client.

  • Shipping address update validation fix—Now, once orders are in the remorse period, the customer service agent can change the shipping address.

  • UpdateShippingAddress configuration shows the change shipping address functionality—Now if the UpdateShippingAddress configuration is disabled, it does not hide the action for changing the shipping address in the Customer Service view.

  • Force shipment button creates a single package for all items—The Force shipment button now creates a single package for all items.

  • Defined ItemName in the order_line_cancelled template—Order product name is now shown in the customer service view. Appears in the history details section when an order line has been cancelled.

  • Added address custom attributes for generated shipment requests—Address custom attributes are now created when a shipment request is generated, via the magento.logistics.shipment_request_management spec.


Staging release—June 4, 2019

Production release—June 12, 2019

  • Recommended limit of order lines that can be correctly processed—The recommended number of order lines is 200 lines per order. See the Orders page for more information.

  • Order creation date available in the Backoffice export—The order export functionality in the Backoffice now exports the order_creation_date attribute.

  • Maximum number of characters allowed in the product_name field increased—This fix allows the product_name description field on the order.create message to be updated from 300 to a maximum of 1000 characters.

  • shipment_date allowed when shipment_done event is triggered—Now, there is a shipment_date event available when the customer_shipment_done is triggered.


Staging release—May 7, 2019

Production release—May 21, 2019

  • Loader shows progress of mass actions—We have implemented a visual loader to indicate the status of the batch operation, or mass action, during the picking and collection processes.


Staging release—April 9, 2019

Production release—April 16, 2019

  • Expanded Manual Actions functionality—Users with roles restricted by Sales Channel can now access the Manual Actions tab for a specific order in the OMS Backoffice.

  • Decline collection of all items—We added the ability to decline the collection of all lines and items of an ISPU bulk pick list.

  • Decline picking of all items—We added the ability to decline the picking of all lines and items of an ISPU bulk pick list.

  • Confirm Picking and Decline Picking options—Availability of new Confirm Picking and Decline Picking options when confirming or declining ISPU orders and Confirm Collection and Decline Collection options when confirming or declining customer collection.

  • Show number of items in pick list—Now you can see the total number of items in the pick list.

  • Decline reason in Customer Collection View—We have added the ability to select the decline reason in the Customer Collection view for declined lines of an ISPU bulk pick list.

  • Confirm/decline collection of multiple items—Store assistants can now Confirm & Collect or Decline the collection of multiples lines of an ISPU pick list in the Customer Collection view.

  • Confirm/decline collection of all items—Store assistants can now Confirm & Collect or Decline the collection of all lines of an ISPU pick list in the Customer Collection view.

  • Select decline reason in PickList view—Store assistants can now select the decline reason of selected lines of an ISPU bulk pick list.

  • Confirm/decline picking of multiple items—Store assistants can now confirm and decline multiple items of selected lines of an ISPU bulk pick list.

  • Confirm picking of all items—Store assistants can now confirm all lines of an ISPU bulk pick list.

  • Improved custom attributes modification—The process of modifying customer attributes has been greatly improved with the addition of a dropdown menu showing valid values for selection, including supported attribute types and associated validations, and modifiable entities.

  • Re-trigger payment capture—In a payment capture exception, you now have the ability to re-trigger the payment capture to recover captures during a payment integration outage or other similar event.

  • Inflight stock info available at source level—To ensure the most up-to-date info for available stock per source, information about inflight stock is available at the source level to the broadcasted event via the source_stock_management.updated message.


Staging release—March 12, 2019

Production release—March 19, 2019

  • Implement feedback banner in Magento Admin—To gather helpful feedback from users/clients, we have implemented a feedback banner in the Magento Admin requesting information from users about the system’s capabilities and functionality.

  • Add shipment date in order view—The shipment date for an order is now visible in the order view for Shipment Requests and Shipments.

  • Dashboard to display exceptions—The dashboard will provide users, with the appropriate permissions, visibility to pending payment issues.

  • Revise user configuration template—The previous configuration option for adding new users in the CSV template file for user creation, “access_all_sales_channels_and_sources”, was removed from the CSV template so that only current functionality and options are visible.

  • Provide notification for payment event failure—Payment events failures will now generate a magento.common.error_management.notify message to allow the System Integrators (SIs) to understand which events were not correctly processed by the OMS.

  • Custom attributes search usability improvements—We improved the usability of the custom attributes search field. Values are shown in a dropdown menu to assist in properly filling in this field.

  • Add the custom attribute type URL—Now you can define a custom attribute as a URL to access an external source.

  • Custom attributes showing properly in the In Store Pickup page—Custom attributes are now properly visible in the In-store Pickup Magento Admin page.

  • Order ingestion validations—Custom attributes are now received with matching definitions, defined by the business, so that if you receive invalid data you can prevent any corrupted data coming from integrations like ERP or CRM.


Staging release—February 12, 2019

Production release—February 19, 2019

  • Promotional info added to shipment request message—Line level promotional information was added to the magento.logistics.warehouse_management.request_shipment message.

  • Configure order attributes visibility in Sales grids—You can now configure which custom order attributes are visible on some Sales grids in Backoffice (Sales, Customer service, and ISPU). The newly configured customer order attribute columns will be saved in your user profile, and are visible when you log back in.

  • Custom attributes and promise delivery date added to sourcing request—Custom attributes prefixed with mom_srcrr_ and the promise delivery date have been added to the sourcing request, so that you can overwrite specific sourcing rules via custom attributes provided in the order and source orders by promise date.

  • Access to manual order actions—New comprehensive user and roles functionality now provides the ability to perform manual actions for an order.

  • Support bundles with multiple quantities—We now support bundles with multiple quantities via the parent_line_number field in the order create message, which allows you to provide definition of the parent/child relationship. The parent_line_id field is now deprecated.

  • Generate a payment ingestion failure message—A message will be generated each time a payment event fails to be ingested by the OMS, and will provide helpful information for troubleshooting the integration or other issues, via the magento.common.error_management specification.

  • agedBackorders sourced at same time—Now, instead of submitting orders in the sourcing wave every X hours when stock is received in the warehouse/source, the stock snapshot is used to validate which of the agedBackorders received stock. Then the agedBackorders be re-queued for the next allocation wave (same day).

  • Information is searchable by sales channel—You can search for information per sales channel with the optional (for search fields and response) sales_channel_id in the command.


Staging release—January 14, 2019

Production release—January 23, 2019

  • Overwrite bundle sourcing rule—You can now overwrite the bundle sourcing rule at the order level using a custom attribute.

  • Define order-specific sourcing override rules—You can now overwrite the generic order configuration to treat single-shipment orders as split orders if stock is available in different sources, but should not be partially sourced due to stock availability or rule limitations.