Document Properties
Kbid
306C45
Last Modified
06-May-2022
Added to KB
02-Nov-2022
Public Access
Everyone
Status
Online
Doc Type
References
Product
  • IOM 4.0
  • IOM 4.1
  • IOM 4.2
  • IOM 4.3
  • IOM 4.4
  • IOM 4.5
  • IOM 4.6
  • IOM 4.7
  • IOM 5.0
Reference - IOM Dispatch Business Process

Introduction

This document is part of the IOM Business Processes and is aimed at project developers.

It explains in detail the IOM Dispatch Business Process and its included sub-processes.

References

The IOM Dispatch Business Process

Introduction

The Dispatch Business Process captures dispatch notifications from 3rd party systems, e.g. fulfillment locations. It covers the complete capture and validation process and triggers dispatch notification according to the standard processes, mostly with derivatives from a fulfillment location or supplier. If necessary, an INITIAL order response notification to the order capture channel is created.

Boundaries

The Dispatch Process starts with a dispatch notification captured by the standard API and ends normally with an announced dispatch notification - if necessary - a submitted dispatch notification to the order capture channel.
The process ends by reaching the dispatch status CLOSED. Refer to IOM Dispatch Status Model.

Process Flow

  1. The Dispatch Capture, Validation and Announce Process captures a dispatch notification from a fulfillment location. After the dispatch is captured, missing fields are added and the dispatch is validated against predefined business rules to determine missing fields. After the dispatch is successfully validated, the dispatch is announced to the order.

  2. The Dispatch Notification Process processes the approved and announced dispatch notification and sends a response notification to the order capture channel if no INITIAL response has been sent by the fulfillment location before.

  3. The Finalize Submission Process initiates submission of created documents to a 3rd party system and finally sets the dispatch notification to CLOSED.

Dispatch Capture, Validation and Announce Process

Introduction

The Dispatch Capture and Validation Process captures a dispatch notification from 3rd party systems, e.g. fulfillment locations. It validates the dispatch to ensure data integrity and announces it to the related order.

Boundaries

The Dispatch Capture and Validation Process starts with an INITIAL dispatch notification captured by the standard API and ends normally with a dispatch that is successfully validated.
The process ends by reaching one of the statuses CHECKED or NOT_CHECKED. Refer to IOM Dispatch Status Model.

Process Flow

  1. Receive and store dispatch notification. The fulfillment location passed a dispatch notification. The status of the dispatch notification is set to INITAL.

  2. Assign order to order dispatch notification links the order to the dispatch notification. The shop order number will be added if missing in the dispatch notification.

    1. OK: The matching is successful and the process continues.

    2. FAILED: No matching order is found for the dispatch notification. Initiate the escalation workflow to handle the error.

  3. Unprocessed dispatch notifications available? Checks for unprocessed dispatch notifications for the order.

    1. YES: The dispatch notification is set to a wait status until “older” dispatch notifications are processed.

    2. NO: There are no “older” dispatch notifications and the process continues.

  4. Prepare dispatch and add missing data completes missing data in dispatch using the related order. This involves:

    1. Adding missing IOM product ID to the dispatch notification.

    2. Adding missing the order position number to the dispatch notification. In case no position number can be determined, these positions will not be processed.

  5. Validate dispatch. The dispatch is validated according to the defined dispatch validation rules.

    1. OK: The dispatch has been successfully validated and the process continues. The status of the dispatch will be set to CHECKED.

    2. FAILED: The validation detects errors (e.g. required fields are missing). Initiate the escalation workflow to handle the error.

  6. Set dispatch NOT_CHECKED. The status of the dispatch notification is set to NOT_CHECKED to indicate an error. Dispatch notifications in status NOT_CHECKED will be ignored until the status is changed to CHECKED.

  7. Announce dispatch to order. The dispatch notification in status DO_PROCESS is announced to the order. Selected information of the dispatch notification (quantity and date) is copied to the corresponding order positions. The data supplierConfirmedPurchaseItemNet is only copied if no confirmed purchase price has been provided in the response notification because the fulfillment location has accepted the order with the prices provided in the order response notification. If the order position is partly dispatched, the order position status is set to one of the following statuses (source status → target status):

    1. COMMISSIONED → COMMISSIONED_PARTLY_DISPATCHED

    2. COMMISSIONED_PARTLY_RETURNED → COMMISSIONED_PARTLY_DISPATCHED_PARTLY_RETURNED

      If the order position is completely dispatched, the order position status is set to one of the following statuses (source status → target status):

    3. COMMISSIONED or COMMISSIONED_PARTLY_DISPATCHED → DISPATCHED

    4. COMMISSIONED_PARTLY_RETURNED or COMMISSIONED_PARTLY_DISPATCHED_PARTLY_RETURNED → DISPATCHED_PARTLY_RETURNED

      If the status change fails because the order position is not in one of the mentioned statuses, the announcement process fails and the order dispatch notification is set to status NOT_ANNOUNCED.

  8. Outstanding recalls or backlog requests available? Checks if there are outstanding order recall or order backlog requests.

    1. YES: There are outstanding order recall or backlog requests.

    2. NO: No open recall or backlog requests are available.

  9. Cancel recall and order backlog requests. Recall and backlog requests are canceled because the requested products have been already delivered by the fulfillment location.

  10. Open responses for dispatched positions available? Checks if open response notifications in status NOT_CHECKED, NOT_CHECKED_DO_APPROVE or IN_EXTERNAL_PROSSING are available.

    1. YES: There are open response notifications.

    2. NO: There are no open response notifications are available.

  11. Set open responses to FAILED

  12. Set dispatch DO_PROCESS

Exceptions

In case of exceptions, the processing stops and the errors must be solved. After the errors have been solved, the process is continued automatically by the control app.

More

Extension points

  • Queues: CheckDispatchQueue

  • Statuses: INITIAL, NOT_CHECKED, NOT_CHECKED_DO_APPROVE, IN_EXTERNAL_PROCESSING, CHECKED, FAILED (refer to IOM Dispatch Status Model)

Related processes

Dispatch Notification Process

Introduction

The Dispatch Notification Process checks if a response notification should be created, or if one is already created. In some cases, the fulfillment location is not able to send or does not send an initial response, which is necessary. In this case, the process creates a response notification to the corresponding order capture channel. Information about the created response is derived from the order.

Boundaries

The Process Dispatch Notification Process starts with a validated dispatch notification in status DO_PROCESS and ends normally with a processed dispatch notification and, if necessary, a created response notification (INITIAL — refer to IOM Response Status Model). The process ends by reaching the dispatch status PROCESSED. Refer to IOM Response Status Model.

Process Flow

  1. Create response notification? Checks if a response notification of type INITIAL was created by the fulfillment location.

    1. YES: A response notification of type INITIAL was created by the fulfillment location.

    2. NO: No response notification was created by the fulfillment location.

  2. Create INITIAL response notification. A new response notification will be created using the dispatch notification.

  3. Initialize and process response submission initiates the Order Response Business Process to submit the response notification to the order capture channel.

Exceptions

In case of exceptions, the processing stops and the errors must be solved. After the errors have been solved, the process is continued automatically by the control app.

More

Extension points

  • Queues: ProcessDispatchQueue

  • Statuses: DO_PROCESS, DO_COMPOSE_RESPONSE, COMPOSED_RESPONSE, PROCESSED (refer to IOM Response Status Model)

Related processes

Finalize Dispatch Process

Introduction

The Finalize Dispatch Process determines if documents should be created during the order dispatch processes and submits a dispatch message to a 3rd party system in order to inform about new dispatches.

Boundaries

The Finalize Submission Process starts when the dispatch is in status PROCESSED and ends, if configured, with created documents and/or sent dispatch notifications.
The process ends by reaching the dispatch status CLOSED. Refer to IOM Dispatch Status Model.

Process Flow

  1. Dispatch notification should be sent to the order capture channel? According to the configuration of the order capture channel, this processes determines if a dispatch notification should be sent to the order capture channel.

    1. YES: An dispatch notification should be sent to the order capture channel.

    2. NO: No dispatch notification should be sent to the order capture channel.

  2. Create dispatch transmission creates a dispatch transmission of type SEND_DISPATCH.

  3. Send dispatch notification. The dispatch notification will be sent to the order capture channel.

  4. Receive dispatch notification. The dispatch notification will be captured and processed by the order capture channel.

  5. Set dispatch CLOSED. Finally, the dispatch is set to the status CLOSED to indicate that the dispatch processes are finished.

Exceptions

In case of exceptions, the processing stops and the errors must be solved. After the errors have been solved, the process is continued automatically by the control app.

More

Extension points

  • Queues: PrepareDocumentDispatchQueue, DispatchTransmissionRequiredQueue, CloseDispatchQueue

  • Statuses: DO_PREPARE_DOCUMENT, PREPARED_DOCUMENT, DO_CLOSE, CLOSED (refer to IOM Dispatch Status Model)

Related processes

Disclaimer
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.
Home
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 supportadmin@intershop.de if you experience login issues,
or if you want to register as customer.