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

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

Enhancements of the User Interface OMT

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.

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.


Configurable Columns at Product Search Result Page

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

Centralized Online Help

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

Enhancements in Setup and Operations

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.

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.


New Version of IOM Communication REST API (2.10)

With "IOM-9856 - Order response API is missing backorder quantity and date" 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.

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

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

8 Changelog

Version Intershop Order Management / 2.17.8

Fixed Defects

63337File transfer jobs are stuck after failovers or restarts

Version Intershop Order Management / 2.17.7

Fixed Defects

IOM-11137Blocked schedules due to undefined FTP connection timeout

Version Intershop Order Management / 2.17.6

Fixed Defects

IOM-10817Incorrect order state determination after export failures #3
IOM-10743Order calculation with free items has a wrong redistribution of order level promotions
IOM-10741Order calcuation may fail due to a wrong usage of BigDecimal.divide method
IOM-10546Encoding of Åland Islands is not correct in OMT
IOM-10453Long email addresses are not displayed properly

Version Intershop Order Management / 2.17.5

Fixed Defects

IOM-10460Shop cancelation/recall possible between routing and COMMISSIONED status
IOM-10430Address with country code of Åland Islands (AX) isn’t accepted at order creation

Version Intershop Order Management / 2.17.4

Fixed Defects

No fixed defects found.

Version Intershop Order Management / 2.17.3

Fixed Defects

IOM-10291Order creation fails for orders with 100% discount codes

Version Intershop Order Management / 2.17.2

Fixed Defects

IOM-10035OMT can't handle products without stock

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.

New Features

IOM-10144Submit messages for multiple suppliers

Fixed Defects

IOM-10121Stocklevel only returned for parent shop
IOM-10107JMS issues: AMQ153005: Unable to retrieve ${0} from JNDI. Creating a new ${1} named ${2} to be used by the MDB.
IOM-10048REST communication messages mixing attributes for sku (supplier or shop)
IOM-10015Editing an invalid dispatch confirmation fails
IOM-10014Dispatch-tab error-tooltip shows localization-key instead of display text
IOM-9984Validation after invalid values at delivery confirmation modal fails


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