Introduction

The IOM Connector is a set of cartridges that allows data exchange and communication between Intershop Commerce Management and Intershop Order Management. It is an extension (or "service") module for Intershop Commerce Management. As such, it requires a base version against which it can be deployed. The table below shows version dependencies between those entities.

Below you can find some general information about the IOM Connector - both technical and business related.

In summary, setting up Intershop with the IOM Connector has the following effects:

1. Orders placed in the e-commerce shop will be routed to IOM.
2. Order history, available in the My Account section, will show real-time IOM data on the status of orders.
3. Order return will be available as feature in said section.

Extended B2B features such as order approval or additional order information are fully compatible with the IOM Connector. Orders will be exported to IOM only after the corresponding approval processes are completed. In addition, all information stored at the order - such as message to merchant, cost center and project - will be exported as well.

As with any Intershop feature that connects ICM to another system, all features are realized using the managed services framework.

Dependency Version Information

For information on version dependencies, refer to the IOM Connector Release Notes.

Glossary

References

• Concept - Managed Service Framework
• Overview - IOM Public Release Notes

General ICM Configuration

Product Information Management

Do not use warranties. IOM has yet to support service product types.

Shopping Cart & Checkout Configuration

Disable pack slip messaging, gift wrapping and messaging and desired delivery date. Those features can be turned on and off for each application in the system individually. 

Perform the following steps:

1. Open the application you want to manage.
2. Click on Shopping Cart & Checkout tab.
   The application's shopping cart preferences will be displayed.
   
3. Disable the following settings and click Apply: 
   • Pack Slip Messaging under Gifting Options
   • Gift Wrapping under Gifting Options
   • Gift Messaging under Gifting Options
   • Desired Delivery Date under Shipping Options

Shipping Configuration

The following example shows how to disable shipping instructions for Standard Ground shipping:

1. From the menu bar select Orders | Shipping Configuration.
2. Click Shipping Methods.
3. Click on Shipping Method Name or Shipping Method ID to edit the shipping method.
   
   
   
4. If checked, uncheck the box after Enable Special Shipping Instructions and click Apply.
   
5. Repeat steps 3 to 4 for every shipping method.

IOM User

To enable communication between IOM and ICM, a user with sufficient permissions is required. These permissions are described in the corresponding SOAP/REST API documentation. When configuring ICM managed services, those credentials will be used. Each time a service is called, an attempt is made to identify the ICM to the IOM by using these credentials.

See the documentation for further information:

• Overview - Intershop Order Management REST API (Document View of the API)
• Order Management Online Help

ICM Service Configuration

The communication between ICM and IOM is realized by utilizing the managed service framework, see Concept - Managed Service Framework. As with any managed service, the following tasks must be performed for IOM-specific services to become operational:

1. Enable the managed service in the Operations back office.
2. Create a managed service configuration in the context of a channel.
3. Fill out the necessary configuration directives.

Once the IOM-Connector is installed, step 1 and 2 can be done with scripts. Afterwards the configuration has to be entered manually into the individual managed services. Alternatively, you can also perform these steps completely manually.
Therefore refer to the ICM Online Help for basic information on how to enable a managed service and how to create a managed service configuration.

This information is also available as PDF, e.g., Intershop Commerce Management - Managing Online Shops. See chapter Operation and Maintenance section Services Management.

With one exception, all of the managed services require the shop's name in order to function. The exception is IOM Inventory Service which requires the actual shop ID. In order to get the required information ask your IOM database admin to provide you with the result of the following query:

OmsDB=# select ID,name from "ShopDO";

The result should look similar to the one below:

  id   |        name
-------+--------------------
     0 | All Shops
     1 | OMS internal Shop
 10000 | inTRONICS
 10001 | inTRONICS Business

(4 rows)

When you configure one IOM Order Service, IOM Download Service, IOM Order State Service, IOM Reverse Service or IOM RMA Service enter the shop's name in the configuration field Shop Name, e.g. inTRONICS.
When configuring IOM Inventory Service, IOM Order Export Service or IOM Order History Service you must enter the actual shop ID, e.g. 10000, as configuration value of Shop ID.

Configure IOM Order Export Service

IOM Order Export Service requires several technical attributes that must be configured. In general, they control the connection settings to the IOM. Ask your system administrator if you do not have them at hand. Those settings include:

Logging and Monitoring sections are inherited from the standard managed service configuration. You may skip them at the moment.

Configure IOM Order History Service

The IOM Order History Service requires several technical attributes that must be configured. In general, they control the connection settings to the IOM. Ask your system administrator if you do not have them at hand. Those settings include:

Logging and Monitoring sections are inherited from the standard managed service configuration. You may skip them at the moment.

Configure IOM Order Service

IOM Order Service requires several technical attributes that must be configured. In general, they control the connection settings to the IOM. Ask your system administrator if you do not have them at hand. Those settings include:

Logging and Monitoring sections are inherited from the standard managed service configuration. You may skip them at the moment.

Configure IOM Order State Service

The IOM Order State Service requires several technical attributes that must be configured. In general, they control the connection settings to the IOM. Ask your system administrator if you do not have them at hand. Those settings include:

Logging and Monitoring sections are inherited from the standard managed service configuration. You may skip them at the moment.

Configure IOM Download Service

Configure at least the following properties for the IOM Download Service:

Logging and Monitoring sections are inherited from the standard managed service configuration. You may skip them at the moment.

Configure IOM Reverse Service

The IOM Reverse Service requires several technical attributes that must be configured. In general, they control the connection settings to the IOM. Ask your system administrator if you do not have them at hand. Those settings include:

Logging and Monitoring sections are inherited from the standard managed service configuration. You may skip them at the moment.

Configure IOM Inventory Service

The IOM Inventory Service provides a way to communicate inventory levels from Intershop Order Management to Intershop Commerce Management. ICM and IOM exchange inventory information via HTTP and thus some necessary communication parameters must be established before the service is activated:

Configure IOM RMA Service

The IOM RMA Service requires several technical attributes that must be configured. In general, they control the connection settings to IOM. Ask your system administrator if you do not have them at hand. Those settings include:

Logging and Monitoring sections are inherited from the standard managed service configuration. You may skip them at the moment.

Configure Order Export

Configure ICM Order Export

Once IOM Order Export Service is configured and activated, the ICM order export has to be configured. Using this scenario will route orders to IOM.

1. Switch to your preferred channel in Intershop Commerce Management.
2. Click DATA VIEW (one of the major tabs in the header).
3. Click Orders | Import & Export.

4. In the Order Export section click New to create a new order export.

5. Enter Name, Description and select a Configuration Type, i.e. IOMOrderService.
   

   The available options for Configuration Type depend directly on the created services of type IOM Order Services. I.e., you have as many options here as you have created services. It is recommended to manage only one service of a type in order to avoid confusion.

6. Click Apply.

7. Click Actions and configure how the order and line item status should change.
   Configuration on this page will trigger upon successful order export.

8. Click Scheduling and configure when the order export should be triggered.
   For example select On Order Creation to export the order immediately after it was captured.