Document Tree
Document Properties
Last Modified
Added to KB
Public Access
Doc Type
Release Notes
IOM 3.0
Public Release Note - Intershop Order Management 3.0


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.


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

General Information

Additional References

New Features and Enhancements

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:

Enhancements of the User Interface OMT

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).

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.

Enhancements in Setup and Operations

Added Support for PostgreSQL 12

IOM is now supporting PostgreSQL 12.

Also see System Requirements - Intershop Order Management 3.0.

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.


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.

Expandability of DocumentTypeDefDO

The enumeration DocumentTypeDefDO can be extended now using ExpandedDocumentTypeDefDO.

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

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.


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.


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.

Setup & Configuration

For installation instructions see:

Docker-images are available at:


IOM Helm charts are available at:



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


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


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
IOM-10403UserMailLO.getCurrencySymbol() is mostly null in mail templates
IOM-10393Order state service doesn't return sales.currency
IOM-10292Persisted java enum modification check on initialization is not considering null values
IOM-10291Order creation fails for orders with 100% discount codes
IOM-10253Wrong status code for requests with empty payload
IOM-10227Wrong tax summary in default invoice xslt
IOM-10216The flag to "ignoreAdditionalPositions" by supplier-messages is not respected in all processes
IOM-10194Bad query performance on OrderPosDO state
IOM-10176Customer addresses comparison is incomplete when to store unknown addresses at customer profile
IOM-10174Order addresses are silently ignored when the first or last name is null
IOM-10128Some REST yaml-files are hosting the x-vendor version
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-10092Mismatch in PaymentSalesPricePosDO between salesSumTax and salesSumTaxDiscounted
IOM-10087Old dropped columns inadvertently reintroduced by older migration scripts
IOM-10052Missing summaries in cache management REST API
IOM-10048REST communication messages mixing attributes for sku (supplier or shop)
IOM-10047Exclude null reservationRef from the index on OrderDO
IOM-10035OMT can't handle products without stock
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
IOM-9809Missing summaries in health service REST API (monitoring)

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.
The Intershop Knowledge Portal uses only technically necessary cookies. We do not track visitors or have visitors tracked by 3rd parties. Please find further information on privacy in the Intershop Privacy Policy and Legal Notice.
Knowledge Base
Product Releases
Log on to continue
This Knowledge Base document is reserved for registered customers.
Log on with your Intershop Entra ID to continue.
Write an email to if you experience login issues,
or if you want to register as customer.