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

Public Release Note - Intershop Order Management 3.5

1 Introduction

Welcome to Intershop Order Management 3.5!

Intershop Order Management (IOM) is an application of the Intershop Commerce Suite (ICS) that is designed to combine omni-channel commerce processes into one system. It automates and streamlines the life cycle of orders and payments. IOM 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.

IOM 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 ICS, it utilizes the suite's transaction, PIM and merchandising features.

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 Glossary

APIApplication Programming Interface
DockerAn operating system-level virtualization software. Also see Kubernetes and Helm.

A package manager for Kubernetes. Also see Docker.

ICMAbbreviation for Intershop Commerce Management
IOMAbbreviation for Intershop Order Management

An open-source system for automating deployment, scaling, and management of containerized applications. Also see Docker and Helm.

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

2 General Information

3 Additional References

4 New Features and Enhancements

4.1 Change of Orders

With the IOM Order REST API 2.2, IOM now supports creating change requests for an order in certain statuses using a REST API, see Reference - IOM REST API - Order 2.2.

See Concept - IOM Order Change to get more insights for this first MVP. The Cookbook - IOM Order Change explains selected use cases.

4.2 Enhancements in Setup and Operations

4.2.1 Update of Infrastructure Components

The following infrastructure components were updated:

  • IOM application image is now based on ubuntu:20.10
  • IOM now uses AdoptOpenJDK 11.0.11+9

4.3 Customization

4.3.1 IOM is now based on Wildfly 23.0.1.Final

IOM is now running in Wildfly 23.0.1.Final. Projects have to use the updated dependencies.

4.4 Interfaces

4.4.1 New Version of IOM REST API Order 2.2

The IOM REST API Order 2.2 offers additional endpoints to:

  • Get an order
  • Create an order change request
  • Get an order change request
  • Get all order change requests of an order

The specification can be found in the delivery doc/REST/ or in the Knowledge Base.

For more information also see Reference - IOM REST API - Order 2.2 and Fixed Defects below.

5 Setup & Configuration

For installation instructions see:

Docker-images are available at:


Helm Charts are available at:


6 Interfaces

For a complete list of all interfaces please see Overview - Intershop Order Management REST API and Overview - IOM Interfaces.

6.1 Deprecations

Please also see Guide - IOM 3.5 Deprecations and Removals for more details about  IOM-11175 - Getting issue details... STATUS

6.2 Removals

7 Fixed Defects

Key Summary
IOM-11320 REST Order API uses same attribute 'selectedSupplier' for different information
IOM-11317 Order charge taxes are distributed incorrectly
IOM-11310 Undocumented constraints at prices in REST-API/order, net must not be greater than gross, amountDiscounted must not be greater than amount
IOM-11293 Invalid rounding of order level promotions on the orderPosItemsDOs
IOM-11292 Undocumented value-constraint at position.number which doesn't allow negative numbers
IOM-11278 Order import fails when passing multiple tax records with rate zero
IOM-11263 Undocumented (breaking) change in address mapping behavior
IOM-11261 Blocked/reserved stock not counted in OMT (shop hierarchy)
IOM-11232 Selected attributes are not stored if not required
IOM-11227 Deprecations related to the multitaxes are not correctly implemented
IOM-11226 REST order creation fails with 500 if rate of multiple taxes is 0
IOM-11210 Possible database migration error due to a trigger definition
IOM-11206 Migration scripts don't create InvoicingSalesPricePosTaxDO records
IOM-11169 Unable to edit product stock data in OMT
IOM-11164 Missing data type in Cancellation(Pos)-v1.0.xsd
IOM-11152 YAML-specification of REST-API order order-states misses returned objects and attributes
IOM-11150 Stock import fails if there are only 2 lines and both lines are related to the same SKU
IOM-11137 Blocked schedules due to undefined FTP connection timeout
IOM-11125 AddressLocationPackstation for invoice addresses returns message key instead of error message
IOM-11108 Tax rate returns message key instead of error message
IOM-11061 Credit note processing fails in some return scenarios (manual credit notes)
IOM-11031 Doubled JoinColumns hide persistence errors (e.g. OneToOne Relation in DispatchPosItemDO to OrderPosDO should be ManyToOne)
IOM-11030 OrderStateMapperUtil provides incorrect subtotal net price
IOM-10990 NPE in reservation for disabled Shop2SupplierDOs
IOM-10989 Exception in OMT for disabled Shop2SupplierDOs

8 Changelog


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