Related Documents
Document Properties
Last Modified
Added to KB
Public Access
Doc Type
Release Notes
IOM 2.17

Public Release Note - Intershop Order Management 2.17

1 Introduction

Welcome to Intershop Order Management 2.17!

Intershop Order Management is an Intershop Commerce Suite application that is designed to combine omni-channel commerce processes into one system. It automates and streamlines the life cycle of orders and payments. Intershop Order Management processes orders from multiple touch points (web shop, mobile shop, call center and more), allocates them to multiple fulfillment solutions (fulfillment centers, drop-ship distributors, physical stores and more), and tracks all order and payment transactions.

Intershop Order Management offers a centralized platform for managing distributed inventory, order, invoice and payment life cycles, and provides call center functionality, enabling real-time visibility into customers' purchasing behavior, stock levels, payments, and more. As part of Intershop Commerce Suite, it utilizes the suite's transaction, PIM and merchandising features.

Intershop Order Management (IOM) offers the possibility to tailor your business models as flexible and free as you need and depict them in your e-commerce environment. The order management system adjusts the order processing for various sales channels and suppliers and can be seamlessly integrated with existing components of your IT environment.

1.1 Dependency Version Information

Intershop Order ManagementIntershop Commerce Management B2XIOM Connector

1.2 Glossary

Oops, it seems that you need to place a table or a macro generating a table within the Table Filter macro.

The table is being loaded. Please wait for a bit ...

APIApplication Programming Interface
FTPFile Transfer Protocol
ICMAbbreviation for Intershop Commerce Management
IMPEXImport/ Export
IOMAbbreviation for Intershop Order Management
OMSAbbreviation for Order Management System, the technical name of the IOM
OMTAbbreviation for  Order Management Tool , the graphical management tool of the IOM
RESTRepresentational State Transfer
SOAPSimple Object Access Protocol

2 General Information

3 Additional References

4 New Features and Enhancements

4.1 Enhancements of the User Interface OMT

4.1.1 Custom Order Search References

The order search can now be extended to search for additional references in order to quickly find orders without having to provide the "standard" order number.

This is useful in case customers cannot provide the order number created by the webshop when they are calling in, but they can provide other references like an ERP-number.

See Cookbook - IOM Extending the OMT Order Search to Consider Additional Order References for more information.

4.1.2 Visibility of Product Stock Information

To have complete insights to the stock of a product, the reserved stock, the blocked stock and the finally available stock were added to the product search results and the product detail page.

Next to the counts a visual bar is available, which shows the state of the stock at a glace.


4.1.3 Configurable Columns at Product Search Result Page

The visibility of the columns at the product search result page is now configurable.

4.1.4 Centralized Online Help

The online help was moved from the product to With the centralized hosting, the online-help is always up-to-date.

4.2 Enhancements in Setup and Operations

4.2.1 Added Standardized Database Cleanup Tasks

Additional cleanup/ archiving tasks were added for selected database objects to keep costs for database storage and maintenance tasks as low as possible.

These objects are:

  • OrderMessageLogDOs
  • ShopCustomerMailTransmissionDO
  • ShopCustomerMailTransmissionStateHistoryDO

Please see Guide - Setup Intershop Order Management 2.17 | Persisted Platform Wide PropertiesReference - Database Jobs and Reference - IOM Quartz Jobs 2.2 for more details.

Data of OrderSupplierEvaluation...DO are only required from creating the reservation until the order is assigned to a supplier. Therefore, a reasonable default to keep the data is 30 days. Later everything with an older modification date will be deleted.

4.2.2 Added New Cluster-Property

The OMT application is sending internal REST requests to the IOM application-server. Therefore it is using the base URL that is stored as value for the cluster-property The default value of this property is "http://localhost:8080". As long as the IOM application-server is using port 8080, this property can be used as is. If the IOM application-server is listening on another port than 8080, which is normally only the case if multiple IOM application-servers are running on one machine, the port-part of the property value has to be adapted, too.

In older IOM versions, these types of REST calls have used the value of the cluster-property is.oms.jboss.base.url, which is containing the public URL of the IOM system.

4.3 Interfaces

4.3.1 New Version of IOM Communication REST API (2.10)

With " IOM-9856 - Getting issue details... STATUS " a new version is required. The specification can be found in the delivery doc/REST/ or at

For more information also see Overview - Intershop Order Management REST API.

4.3.2 Published IOM Inventory Service REST API (2.0)

The Inventory (ATP) REST service already existed, but was not yet published as a yaml file. The specification can be found in the delivery doc/REST/ or at

For more information also see Overview - Intershop Order Management REST API.

5 Setup & Configuration

The distribution package that contains the binary distribution of Intershop Order Management 2.17 is available in the Product Calendar and only consists of this file:

  • IOM_2.17.0.0.tgz

For installation instructions please see:

Please note that the installation requires installed and preconfigured:

  • JDK 11
  • WildFly 17
  • Postgres 11

6 Interfaces

For a complete list of all interfaces please see Overview - IOM Interfaces.

6.1 Deprecations

6.2 Removals

7 Fixed Defects

Key Summary
IOM-10007 Transmission UI: Stacktrace on screen when searching for payment transmissions
IOM-10003 Transmission UI cannot handle ReturnAnnouncementTransmissions
IOM-9996 Invalid Trigger on Postgres table DocumentDO
IOM-9995 Missing not null Constraint on "Shop2SupplierDO".active
IOM-9994 Disabled Shop2SupplierDO is ignored in ATP/Reservation API
IOM-9982 DatePicker used for delivery date behaves like a DateRangePicker
IOM-9958 Misspelled "Cancelation" at different places
IOM-9919 Custom decision beans don't work for Shop2Supplier2ApprovalTypeDefDO
IOM-9915 Stock gets blocked again after cancellations
IOM-9898 SOAP order service doesn't respect given order position numbers
IOM-9897 When sending a return label via OMT, the header of documents will be hidden
IOM-9889 Transmission search does not work after bulk action
IOM-9856 Order response API is missing backorder quantity and date
IOM-9838 Wrong logic while splitting the OrderPosDOs in OrderPosItemDOs can lead to negative quantities for the latter.
IOM-9826 Wrong handling of position discounts in credit notes
IOM-9822 SOAP order service v1.2 raises NPE instead of error message for a wrong address id
IOM-9769 Validation of response positions doesn't check for duplicates
IOM-9752 Position product link is not supported for known products in initial order status
IOM-9751 Reservation performance bottleneck with DOSE enabled
IOM-9747 Unhandled NPE at InvoicingDO
IOM-9743 Position Product Link not working for initial order status
IOM-9738 Performance issues because of the ReturnRequestService
IOM-9731 CreateOrderReturnPTBean uses hardcoded reduce reason
IOM-9723 Wrong splitting of order level promotions on order items
IOM-9713 Order details page slow loading time
IOM-9690 Typo in date form item of order search
IOM-9682 REST CORS preflight requests returns all options (RMA, GDPR, Communication, Transmissions, Order State)
IOM-9671 Return validation fails under specific circumstances if created in OMT
IOM-8137 Overflow of tables and column elements are not working in modals

8 Changelog

8.3 Version Intershop Order Management / 2.17.4

8.3.1 Fixed Defects

Key Summary

8.4 Version Intershop Order Management / 2.17.3

8.4.1 Fixed Defects

8.5 Version Intershop Order Management / 2.17.2

8.5.1 Fixed Defects

8.6 Version Intershop Order Management / 2.17.1

The Communication REST API was updated to version 2.11. The specification can be found in the delivery doc/REST/ or at

It's now possible to submit supplier messages (response, dispatch and return) for multiple suppliers at once, if permission is granted to the related order positions.

8.6.1 New Features

8.6.2 Fixed Defects


The information provided in the Knowledge Base may not be applicable to all systems and situations. Intershop Communications will not be liable to any party for any direct or indirect damages resulting from the use of the Customer Support section of the Intershop Corporate Web site, including, without limitation, any lost profits, business interruption, loss of programs or other data on your information handling system.

Customer Support
Knowledge Base
Product Resources