Order Import and Export

Intershop Commerce Management can export orders and import order status information, see Order Import and Export: Concept. For the order export and the order status import to work, corresponding services must be properly set up for your organization.

Note:
This documentation covers the generic order export service and order status import service as shipped with Intershop Commerce Management. If your system uses other service implementations, some details may vary, but the general approach will be similar.

The Order Import & Export manager is divided into two sections, Order Export and Order Status Import. Each section includes a list of the corresponding export or import configurations.

Creating New Configurations

To create a new configuration for an order export or an order status import:
  1. Select the channel from the context selection box, then select Orders | Import & Export.
    This displays the Order Import & Export manager, showing the Order Export and Order Status Import sections.
  2. In the corresponding section, click New.
    This displays the General tab of a new order export or order status import configuration.
  3. Provide the general information as required.
    Mandatory information includes name and configuration type. Optionally, a description can be provided.
  4. Click Apply.
    The new configuration is created. All other tabs become active.
  5. Change to the other tabs to specify all data as required.
    For export configurations, this includes actions, scheduling and conditions. For import configurations, this includes scheduling. For details, see the configuration data tables in Order Import and Export: Concept.

Running Export/Import Manually

To execute an order export/order status import job with a certain configuration:
  1. Select the channel from the context selection box, then select Orders | Import & Export.
    This displays the Order Import & Export manager, showing the Order Export and Order Status Import sections.
  2. In the corresponding section, select the configuration to use for the export or import job and click the Run button.
    This starts the export or import job with the selected configuration. Click the Refresh button to update the current page.
    Note:
    For export jobs, make sure that the configured local directory to which the exported file is written exists. For import jobs, make sure that the file to be imported exists in the configured location.

Running Export/Import Automatically

Besides manual execution, order export/order status import processes can also be triggered via scheduled jobs.
  1. Select the channel from the context selection box, then select Orders | Import & Export.
    This displays the Order Import & Export manager, showing the Order Export and Order Status Import sections.
  2. In the corresponding section, click the name of the intended configuration.
  3. Change to the Scheduling tab.
  4. Specify the execution interval for the current configuration, then click Apply.
    The order export/order status import process with the selected configuration will be executed as a scheduled job in the defined interval.

Enabling/Disabling Status Updates for Order Exports

The order export of Intershop Commerce Management allows to export orders to ERP systems or order management systems, which take responsibility for further order processing. During the export, the order status of each exported order is set to the specified order state transition or EXPORTFAILED (in case of export errors). However, this behavior is not always desired. For instance, for exports to reporting systems such as the Intershop BI Data Hub or external tools, the order status as well as the line item status should usually remain unchanged. Therefore, Intershop Commerce Management provides the option to enable or disable status updates for order exports.

To toggle order export status updates and line item updates for existing exports, perform the following steps:
  1. Select the channel from the context selection box, then select Orders | Import & Export.
    This displays the Order Import & Export manager, showing the Order Export and Order Status Import sections.
  2. Open the order export configuration to be adjusted. For creating a new configuration, refer to Creating New Configurations.
    The order export detail page opens.
  3. Switch to the Actions tab.
  4. Uncheck Enable status updates to disable status updates or check it to enable status updates.
    By default, status updates are enabled.
Tip:
Order exports with disabled status updates continue to be logged in Intershop Commerce Management, i.e. possible errors are still recorded.