Overview of Using Business Events with Order Management

Use business events to integrate Oracle Order Management with some other Oracle Application or with an application that resides outside of Oracle Applications.

Use the Oracle ERP Cloud adapter to achieve results:

• Send a notification to each subscriber when a condition happens.

• Use the Manage Business Event Trigger Points page to set up the criteria that uses the business event.

• Use a different integration for each subscriber system. The subscriber can use a single web service that listens for the conditions through the business event that you specify.

• Allow each subscriber to enrich data in the integration.

You can use this flow:

Note

• Use this flow to deploy a single web service on each of your subscriber systems.

  The subscriber can receive the notification for each condition that triggers the business event.

  You use the Subscribe to ICS integration to subscribe each channel system to the business event.

• Order Management sends one event notification to Integration Cloud Service, and then Integration Cloud Service broadcasts it to each of the subscribers that you integrate.

• If you set up the web service that you deploy on these systems to subscribe to the business event, and if they share the same underlying schema, then you use a similar mapping between the business event's output and each web service.

If you use the Sales Order Notification business event, then Order Management can send a notification each time one of these conditions happens:

• Update order header status.

• Update fulfillment line status.

• Split fulfillment line.

• Close fulfillment line.

• Apply hold.

• Change the jeopardy priority.

• Update a predefined attribute on a sales order.

• Finish changing a fulfillment plan.

Manage Business Event Trigger Points

To get started, go to the Setup and Maintenance work area, then use the Manage Business Event Trigger Points page to set up the trigger points that determine the notifications that you want to send to subscribers.

Note

• Use the Sales Order Notification event when you set up the end point in Integration Cloud Service. You use this event to publish trigger points to Integration Cloud Service.

• As an alternative to using Integration Cloud Service, you can add a connector that you set up on the Manage Connector Details page in the Setup and Maintenance work area. The trigger publishes the event to the connector.

  For example, if you add the Delivery Confirmation connector to the Fulfillment Line Status Update trigger point, then Order Management will send the business event to Delivery Confirmation every time it updates the status on the fulfillment line.

  The connector that you create in Integration Cloud Service is entirely separate from the connector that you create on Manage Connector Details. These connectors aren't related to one another in any way.

For details, see Send Notifications from Order Management to Other Systems.

Create Connector and Integrate

Sign into Integration Cloud Service, create the connector, create the integration, then drag and drop your connector onto the integration.

To configure the end point, click the connection that you dropped onto your integration, then click Edit. Use the wizard to select With Business Events and the Sales Order Notification event.

Sales Order Notification gets the active trigger points that you set up on Manage Business Event Trigger Points, then publishes them in Integration Cloud Service.

The trigger points inform each subscriber when something significant happens on the sales order. For example, when Order Management finishes compensation for a change order, updates the status on the fulfillment line, closes the fulfillment line, and so on.

Specify Operations

Specify the operations that each web service must do. You edit the Publish To node in your integration.

Use Order Information Service

Select the Orchestration Order business object, select the OrderInformationService web service, then select an operation.

Operation	Description
ChangeOrderAllowed	Determines whether Order Management allows changes on the sales order or the fulfillment line.
ChangeOrderAttributeAllowed	Determines whether Order Management allows changes on each sales order's attribute.
GetCrossReferencedData	Allow a source system that subscribes to the Sales Order Notification business event to get cross-referenced values that the calling application can use. Use this operation as an enrichment service when you receive Sales Order Notification. For details, see Overview of Creating Cross-References in Order Management.

You can also use the OrderImportService web service to send a new sales order or to revise a sales order.

Learn how to specify the data that you need to communicate. For details, see the Create Connections chapter in Using Integrations in Oracle Integration.

Use Order Fulfillment Response Service

Here's how you can use OrderFulfillmentResponseService to process the response that your fulfillment system sends to Order Management.

Note

1. Order Management uses a business event so it can send a fulfillment request to your fulfillment system.

2. Integration Cloud Service calls the document service of the business event to send the request to the fulfillment system. The the document service's output payload includes data that the fulfillment system uses to fulfill the request. You can map this output payload to the web service's interface that processes the inbound call on the fulfillment system.

3. The fulfillment system receives the fulfillment request from Order Management, then calls the processAcknowledgement operation of OrderFulfillmentResponseService to acknowledge that it received the fulfillment request.

4. Integration Cloud Service sends the acknowledgment to Order Management.

5. The fulfillment system fulfills the request, then calls the processFulfillmentResponse operation to communicate the result to Order Management.

6. Integration Cloud Service sends the response to Order Management.

7. Order Management processes the response.

Set the web service to OrderFulfillmentResponseService when you configure the endpoint:

Select an operation.

Operation	Description
processAcknowledgement	The fulfillment system will send an acknowledgment that confirms it received the fulfillment request. processAcknowledgement accepts and processes the acknowledgment.
processFulfillmentResponse	The fulfillment system will call processFulfillmentResponse to communicate the result of the fulfillment request to Order Management. The service adds the Response suffix to the operation name, which results in a response name of processFulfillmentResponseResponse. The processFulfillmentResponse name operation indicates that it processes a fulfillment response in reply to an Order Management fulfillment request.
StageFulfillmentResponse	For future use.

Map Source to Target

If you map a data element from the source to a data element on the target, then the interface adds a green check mark to the source and target.

• The target also displays the name of the data element at the source.

• The mapping applies to one target web service, so you must do this mapping for each target system.

• If your deployment must do other operations under Order Information Service, then you must create an integration in Integration Cloud Service, and then map the source payload to the target payload for each channel. However, you only need one connection between ERP Service Catalog and Integration Cloud Service because it can support an integration under each web service that you publish in the catalog with a WSDL (Web Services Description Language).

Learn how to create a mapping. For details see the Map Data chapter in Using the Oracle Mapper with Oracle Integration.