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

Public Release Note - Intershop Order Management 3.0

1 Introduction

Welcome to Intershop Order Management 3.0!

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

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
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
SOAPSimple Object Access Protocol

2 General Information

3 Additional References

4 New Features and Enhancements

4.1 IOM for Kubernetes

"A Docker container image is a lightweight, standalone, executable package of software that includes everything needed to run an application: code, runtime, system tools, system libraries, and settings." (

The new version of IOM is delivered in form of Docker-images, which can be used directly or can be the base for further customizations in the context of projects.

Additionally, IOM Helm-charts are provided, allowing the automated operation of IOM in Kubernetes, especially in Intershop CaaS Environment..

For more information see:

4.2 Enhancements of the User Interface OMT

4.2.1 Display of Shipping Buckets

With IOM 3.0 the OMT now displays the different shipping addresses in the section Shipping buckets including the position numbers that are assigned to the buckets.

Additionally, each position displays the assigned shipping address and shipping bucket (number).

4.2.2 Replaced Currency Symbol with ISO Currency Code

The OMT is now showing ISO-4217 currency codes. See

The standard currency codes are more cleary and have no redundancy than currency symbols.

4.3 Enhancements in Setup and Operations

4.3.1 Added Support for PostgreSQL 12

IOM is now supporting PostgreSQL 12.

Also see System Requirements - Intershop Order Management 3.0.

4.3.2 Properties Are Moved to be Helm-Parameters

Several properties are moved to be Helm-parameters and could be set at runtime now.

See Guide - IOM 3.0 Migration of Setup and Guide - Operate Intershop Order Management 3.X for more details.

4.4 Customization

4.4.1 Improved Customization of Quartz Jobs

It is now possible to delete standard IOM jobs, overwrite standard IOM jobs and to add custom jobs by defining them in quartz-jobs-custom.xml. Please note that the usage of quartz-jobs-cluster.xml is deprecated now.

See section quartz-jobs-custom.xml at Guide - IOM Standard Project Structure | Custom Properties for more details.

4.4.2 Expandability of DocumentTypeDefDO

The enumeration DocumentTypeDefDO can be extended now using ExpandedDocumentTypeDefDO.

Also see Guide - IOM 3.0 Migration of Customization and Overview - IOM Customization of Enumerations, especially Cookbook - Custom Enumerations.

4.4.3 Added SURCHARGE to ChargeTypeDefDO

The value SURCHARGE was added to ChargeTypeDefDO and can now be used to better specify extra fees that are added to the regular costs, e.g. for shipping to remote areas.

4.5 Interfaces

4.5.1 New IOM Schedules REST API (1.0)

Using the new REST API job-schedules and related information can be searched for and managed by runtime configuration.

The specification can be found in the delivery doc/REST/ or at Overview - Intershop Order Management REST API.

4.6 Others

4.6.1 Decoupled Currency from CountryDefDO

The usage of the currency was mostly decoupled from the shop's configuration at CountryDefDO.
Therefore the currency code will be added to each order instance (OrderDO.currencyCode) when placing the order and will be (and should be) used primarily from this location now.

Also see Guide - IOM 3.0 Deprecations and Removals for currency deprecations.

5 Setup & Configuration

For installation instructions see:

Docker-images are available at:


IOM 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

Key Summary
IOM-10975 Deprecated usage of PostgreSQL 9.5.X, 9.6.X
IOM-10444 Deprecated ShopDO.getCurrencyNameByShopCurrencyName()
IOM-10423 Deprecated the usage of quartz-jobs-cluster.xml for customization, use quartz-jobs-custom.xml instead
IOM-10416 Deprecated get|setCarrier() of OrderDO, use get|setCarrier() of ShippingBucketDO instead
IOM-10399 Deprecated getShippingAddress() of OrderDetails and OrderDetailsVO
IOM-10397 Deprecated methods of OrderPosDO ( get|setSubOrder(), get|setShopPosTax(), get|setTaxDO(), getRecalculatedShopPosTax() )
IOM-10390 Deprecated get|setCarrier() at OrderDO, use the get|setCarrier() of ShippingBucketDO instead
IOM-10384 Deprecated get|setEnumCurreny() for several Classes, use get|setCurrencyISO3() instead
IOM-10356 Deprecated database columns related to the removed feature "Order Merge"
IOM-10355 Deprecated get|setCurrencySymbol() of UserMailLO; use get|setOrderCurrencyCode() instead
IOM-10289 Deprecated get|setShopPosTax(), get|setTaxDO(), get|setRecalculatedShopPosTax() of OrderPosDO and get|setShopSumTax(), get|setTaxDO of OrderChargeDO use the new tax-collections instead
IOM-10163 Deprecated get|setShippingAddress() of OrderPosDO, use getShippingBucketDO().(get|set)ShippingAddress() instead
IOM-10162 Deprecated get|setOrderAddress() of OrderDO, use get|setOrderAddressList() instead
IOM-10115 Deprecated 'product.number' of REST Communication version 2.11 and later
IOM-10059 Deprecated class bakery.persistence.util.ShopDOUtil
IOM-9927 Deprecated persistence unit "reportingPU", OrderSearchPO, CustomerOrderDetailsPO, QueryUtil and methods of OrderReportPersistenceService

6.2 Removals

7 Fixed Defects

Key Summary
IOM-10460 Shop cancelation/recall possible between routing and COMMISSIONED status
IOM-10430 Address with country code of Åland Islands (AX) isn’t accepted at order creation
IOM-10403 UserMailLO.getCurrencySymbol() is mostly null in mail templates
IOM-10393 Order state service doesn't return sales.currency
IOM-10292 Persisted java enum modification check on initialization is not considering null values
IOM-10291 Order creation fails for orders with 100% discount codes
IOM-10253 Wrong status code for requests with empty payload
IOM-10227 Wrong tax summary in default invoice xslt
IOM-10216 The flag to "ignoreAdditionalPositions" by supplier-messages is not respected in all processes
IOM-10194 Bad query performance on OrderPosDO state
IOM-10176 Customer addresses comparison is incomplete when to store unknown addresses at customer profile
IOM-10174 Order addresses are silently ignored when the first or last name is null
IOM-10128 Some REST yaml-files are hosting the x-vendor version
IOM-10121 Stocklevel only returned for parent shop
IOM-10107 JMS issues: AMQ153005: Unable to retrieve ${0} from JNDI. Creating a new ${1} named ${2} to be used by the MDB.
IOM-10092 Mismatch in PaymentSalesPricePosDO between salesSumTax and salesSumTaxDiscounted
IOM-10087 Old dropped columns inadvertently reintroduced by older migration scripts
IOM-10052 Missing summaries in cache management REST API
IOM-10048 REST communication messages mixing attributes for sku (supplier or shop)
IOM-10047 Exclude null reservationRef from the index on OrderDO
IOM-10035 OMT can't handle products without stock
IOM-10015 Editing an invalid dispatch confirmation fails
IOM-10014 Dispatch-tab error-tooltip shows localization-key instead of display text
IOM-9984 Validation after invalid values at delivery confirmation modal fails
IOM-9809 Missing summaries in health service REST API (monitoring)

8 Changelog

Unable to render {include} The included page could not be found.


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