Send Notifications from Order Management to Other Systems

Set up Order Management to send a notification to a system that resides outside of Order Management.

Summary of the Steps

Add the connector.
Manage business event trigger points.
Set the notification frequency.

Learn how to do the set up. For details, see Guidelines for Integrating Order Management and Use Integration Cloud Service with Order Management.

Follow these guidelines:

Use a connector only to connect to an application that resides outside of Oracle.
Don't use a connector to connect to Integration Cloud Service.
Make sure the value that you specify in the Connector URL attribute references a resource that's up and running, and that you correctly format the URL.

Following these guidelines will help to make sure you don't degrade performance.

This topic uses example values. You might need different values, depending on your business requirements.

Add the Connector

Add the connector that Order Management uses to communicate with your system:

Go to the Setup and Maintenance work area, then go to the Manage External Interface Web Service Details task.

On the Manage Connector Details page, click Actions > Add Row, then set the values:

Attribute	Value
Target System	Select the system that must receive the notification. This system subscribes to the business event.
Connector Name	Enter text that describes the purpose of the connector. For example, to indicate that you use this connector to send notifications to a legacy system, enter `LEG_Notification`.
Connector URL	Specify an endpoint URL. The URL is the address of the web service that you deploy on a system that resides outside of Oracle Order Management. Order Management will call this web service, and the web service must accept the payload that Order Management sends. Make sure the web service uses this WSDL: `https://server:port/soa-infra/services/default/DooTaskExternalInterfaceVirtualPartnersComposite/businesseventsconnetor_client_ep?WSDL`
User Name	Enter the user name that the system requires.
Password	Enter the password that the system requires.

Manage Business Event Trigger Points

Manage the business event trigger points that determine when to communicate business events to your system:

Go to the Setup and Maintenance work area, then go to the Manage Business Event Trigger Points task.
On the Manage Business Event Trigger Points page, select a trigger point.

At run time, if the sales order reaches the trigger point you specify, then Order Management calls the web service you select in the Connector URL attribute. The web service then sends details of the business event to the system. For example, to send a notification when an order line closes, select the Fulfillment Line Closed trigger point.
Click Actions > Add Row.

Some trigger points include the Associated Connectors tab in the details area. If this tab displays, then click it to add the connector.

Set the values:

Attribute	Value
Connector Name	Select the connector you added earlier in this topic.
Override Default Visibility	Select one: Contains a check mark. Send a notification about each sales order even if the system that receives the notification doesn't have any knowledge about the sales order. Doesn't contain a check mark. If the system doesn't have any knowledge about the sales order, then don't send the notification about the sales order. Here's an example: Assume your implementation includes Source System 1 and Source System 2, and that each of these systems can send a source order to Order Management. Assume Source System 2 has no knowledge of source orders that originate in Source System 1, and that you don't want to notify Source System 2 when an event happens that's associated with a source order that originates in Source System 1. If Override Default Visibility doesn't contain a check mark, then Order Management won't call the connector for Source System 2, and Source System 2 won't receive the notification.

Attribute

Value

Connector Name

Select the connector you added earlier in this topic.

Override Default Visibility

Select one:

Contains a check mark. Send a notification about each sales order even if the system that receives the notification doesn't have any knowledge about the sales order.
Doesn't contain a check mark. If the system doesn't have any knowledge about the sales order, then don't send the notification about the sales order.

Here's an example:

Assume your implementation includes Source System 1 and Source System 2, and that each of these systems can send a source order to Order Management.
Assume Source System 2 has no knowledge of source orders that originate in Source System 1, and that you don't want to notify Source System 2 when an event happens that's associated with a source order that originates in Source System 1.
If Override Default Visibility doesn't contain a check mark, then Order Management won't call the connector for Source System 2, and Source System 2 won't receive the notification.

Optional. Repeat step 3 and step 4.

You can associate the same connector with more than one business event, as necessary.
Optional. Repeat step 2 through 5 for each trigger point you must administer.
Click Save and Close.

Set the Notification Frequency

Use the Notify Frequency parameter to specify how frequently Order Management sends notifications. For details, see Manage Order Management Parameters.

Avoid Two Calls When You Manually Update the Warehouse

If you use the Order Attribute Update business event with the Fulfillment Organization ID attribute, then Integration Cloud Service calls the event only one time. Order Management then schedules the sales order and populates the Warehouse attribute on the order line. If you manually update the warehouse on the order line, then Integration Cloud Service calls the event two times. To avoid the second call, you can use getSalesOrderNotificationDetailsResponse as the input resource in your web service call, and use these attributes to identify the business:

SourceTransactionNumber
EventCode
StatusCode

Note that the status code comes from the order line, not the order header.

For example:

<inputToInvoker>
  <part xmlns:xsi=http://www.w3.org/2001/XMLSchema-instance name="payload">
    <process xmlns=http://xmlns.oracle.com/PublicEventHandler/Invoker>
      <subscriberId>aHR0cHM6Ly9sY2Rldm9pYy1heDhla2E1dm5yaG8tcHguaW50ZWdyYXRpb24udXMtcGhvZW5peC0xLm9jcC5vcmFjbGVjbG91ZC5jb20vaWMvd3MvaW50ZWdyYXRpb24vdjEvZmxvd3MvZXJwL1BPQ19WSVNIXzA1MDVfRlVMTF9MSU5FX1NUQVRfVVBELzEuMC8=</subscriberId>
      <enrichmentType>SOAP</enrichmentType>
      <ns0:getSalesOrderNotificationDetailsResponse xmlns:ns0=http://xmlns.oracle.com/apps/scm/doo/common/businessEventService/types/ xmlns="" xmlns:env=http://schemas.xmlsoap.org/soap/envelope/ xmlns:wsu=http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd xmlns:wsa=http://www.w3.org/2005/08/addressing>
        <ns1:result xmlns:ns1=http://xmlns.oracle.com/apps/scm/doo/common/businessEventService/types/ xmlns:ns0=http://xmlns.oracle.com/apps/scm/doo/common/businessEventService/ xmlns:ns3=http://xmlns.oracle.com/adf/svc/types/ xsi:type="ns0:DocumentServiceOrder">
          <ns0:EventCode>OrderAttributeUpdated</ns0:EventCode>
          <ns0:SourceTransactionIdentifier>300000015913725</ns0:SourceTransactionIdentifier>
          <ns0:SourceTransactionSystem>ORA_ELECTRONIC_DOCUMENTS</ns0:SourceTransactionSystem>
          <ns0:RevisionSourceSystem>OPS</ns0:RevisionSourceSystem>
          <ns0:SourceTransactionNumber>138896</ns0:SourceTransactionNumber>
          <ns0:BuyingPartyIdentifier>100000119745404</ns0:BuyingPartyIdentifier>
          <ns0:BuyingPartyName>My Customer</ns0:BuyingPartyName>
          <ns0:BuyingPartyNumber>228990</ns0:BuyingPartyNumber>
          <ns0:BuyingPartyContactIdentifier>100000120196212</ns0:BuyingPartyContactIdentifier>
          <ns0:BuyingPartyContactFirstName>Tan</ns0:BuyingPartyContactFirstName>
          <ns0:BuyingPartyContactLastName>Tan</ns0:BuyingPartyContactLastName>
          <ns0:BuyingPartyContactMiddleName xsi:nil="true"/>
          <ns0:BuyingPartyContactNumber>18454</ns0:BuyingPartyContactNumber>
          <ns0:CustomerPONumber xsi:nil="true"/>
          <ns0:RequestingBusinessUnitIdentifier>300000007361014</ns0:RequestingBusinessUnitIdentifier>
          <ns0:RequestingBusinessUnitName>My Business Unit</ns0:RequestingBusinessUnitName>
          <ns0:TransactionTypeCode>MY_SHIP_BILL</ns0:TransactionTypeCode>
          <ns0:TransactionDocumentTypeCode xsi:nil="true"/>
          <ns0:SourceTransactionRevisionNumber>1</ns0:SourceTransactionRevisionNumber>
          <ns0:CancelReasonCode xsi:nil="true"/>
          <ns0:CancelReason xsi:nil="true"/>
          <ns0:RequestCancelDate xsi:nil="true"/>
          <ns0:OrigSystemDocumentReference xsi:nil="true"/>
          <ns0:PartialShipAllowedFlag>false</ns0:PartialShipAllowedFlag>
          <ns0:HeaderIdentifier>300000016713228</ns0:HeaderIdentifier>
          <ns0:OrderNumber>174</ns0:OrderNumber>
          <ns0:OrderedDate>2025-07-11</ns0:OrderedDate>
          <ns0:StatusCode>OPEN</ns0:StatusCode>
          <ns0:OpenFlag>true</ns0:OpenFlag>
          <ns0:CanceledFlag>false</ns0:CanceledFlag>
          <ns0:ChangeVersionNumber>4</ns0:ChangeVersionNumber>
          <ns0:PreviousStatusCode xsi:nil="true"/>
          <ns0:CompensationStatus xsi:nil="true"/>
          <ns0:CompensationMessage xsi:nil="true"/>
          <ns0:TransactionalCurrencyCode>USD</ns0:TransactionalCurrencyCode>
          <ns0:TransactionalCurrencyName>US Dollar</ns0:TransactionalCurrencyName>
          <ns0:OrderLine xmlns:ns2=http://xmlns.oracle.com/apps/scm/doo/processOrder/model/>
            <ns0:SourceTransactionLineIdentifier>300000015913723</ns0:SourceTransactionLineIdentifier>
            <ns0:SourceTransactionScheduleIdentifier>1</ns0:SourceTransactionScheduleIdentifier>
            <ns0:SourceTransactionLineNumber>1</ns0:SourceTransactionLineNumber>
            <ns0:SourceTransactionScheduleNumber>1</ns0:SourceTransactionScheduleNumber>
            <ns0:SourceTransactionIdentifier>300000015913725</ns0:SourceTransactionIdentifier>
            <ns0:SourceTransactionSystem>ORA_ELECTRONIC_DOCUMENTS</ns0:SourceTransactionSystem>
            <ns0:SourceTransactionNumber>138896</ns0:SourceTransactionNumber>
            <ns0:ProductIdentifier>100000120526192</ns0:ProductIdentifier>
            <ns0:ProductNumber xsi:nil="true"/>
            <ns0:ProductDescription xsi:nil="true"/>
            <ns0:OrderedQuantity unitCode="EA">6</ns0:OrderedQuantity>
            <ns0:OrderedUOMCode>EA</ns0:OrderedUOMCode>
            <ns0:OrderUOM>Each</ns0:OrderUOM>
            <ns0:RequestedFulfillmentOrganizationIdentifier>300000012785142</ns0:RequestedFulfillmentOrganizationIdentifier>
            <ns0:RequestedFulfillmentOrganizationCode>MY_CODE</ns0:RequestedFulfillmentOrganizationCode>
            <ns0:RequestedFulfillmentOrganizationName>MY_WAREHOUSE</ns0:RequestedFulfillmentOrganizationName>
            <ns0:CancelReasonCode xsi:nil="true"/>
            <ns0:CancelReason xsi:nil="true"/>
            <ns0:SubstitutionReasonCode xsi:nil="true"/>
            <ns0:SubstitutionReason xsi:nil="true"/>
            <ns0:CustomerPONumber xsi:nil="true"/>
            <ns0:CustomerPOLineNumber xsi:nil="true"/>
            <ns0:CustomerPOScheduleNumber xsi:nil="true"/>
            <ns0:CustomerProductIdentifier xsi:nil="true"/>
            <ns0:CustomerProductNumber xsi:nil="true"/>
            <ns0:CustomerProductDescription xsi:nil="true"/>
            <ns0:InvoicingRuleCode xsi:nil="true"/>
            <ns0:InvoicingRule xsi:nil="true"/>
            <ns0:AccountingRuleCode xsi:nil="true"/>
            <ns0:AccountingRule xsi:nil="true"/>
            <ns0:RequestedShipDate>2025-07-13T20:17:26Z</ns0:RequestedShipDate>
            <ns0:RequestedArrivalDate xsi:nil="true"/>
            <ns0:ScheduleShipDate>2025-07-31T14:05:00Z</ns0:ScheduleShipDate>
            <ns0:ScheduleArrivalDate>2025-07-31T14:05:00Z</ns0:ScheduleArrivalDate>
            <ns0:DemandClassCode xsi:nil="true"/>
            <ns0:DemandClass xsi:nil="true"/>
            <ns0:PaymentTermsCode>7</ns0:PaymentTermsCode>
            <ns0:PaymentTerms>NET 45</ns0:PaymentTerms>
            <ns0:TransactionCategoryCode>ORDER</ns0:TransactionCategoryCode>
            <ns0:ReturnReasonCode xsi:nil="true"/>
            <ns0:ReturnReason xsi:nil="true"/>
            <ns0:ShippingServiceLevelCode xsi:nil="true"/>
            <ns0:ShippingServiceLevel xsi:nil="true"/>
            <ns0:ShippingModeCode xsi:nil="true"/>
            <ns0:ShippingMode xsi:nil="true"/>
            <ns0:ShipmentPriorityCode xsi:nil="true"/>
            <ns0:ShipmentPriority xsi:nil="true"/>
            <ns0:ShippingCarrierCode xsi:nil="true"/>
            <ns0:ShippingCarrier xsi:nil="true"/>
            <ns0:InventoryOrganizationIdentifier>300000007310007</ns0:InventoryOrganizationIdentifier>
            <ns0:InventoryOrganization>ITEM_MASTER_GLOBAL</ns0:InventoryOrganization>
            <ns0:InventoryOrganizationName>MY_ORGANIZATION</ns0:InventoryOrganizationName>
            <ns0:FreightTermsCode xsi:nil="true"/>
            <ns0:FreightTerms xsi:nil="true"/>
            <ns0:RequestCancelDate xsi:nil="true"/>
            <ns0:ShipToPartyIdentifier>100000119745404</ns0:ShipToPartyIdentifier>
            <ns0:ShipToPartyName>My Customer</ns0:ShipToPartyName>
            <ns0:ShipToPartyPersonFirstName xsi:nil="true"/>
            <ns0:ShipToPartyPersonLastName xsi:nil="true"/>
            <ns0:ShipToPartyPersonMiddleName xsi:nil="true"/>
            <ns0:ShipToPartyNumber>228990</ns0:ShipToPartyNumber>
            <ns0:ShipToPartySiteIdentifier>100000119758237</ns0:ShipToPartySiteIdentifier>
            <ns0:ShipToAddress1>My Address</ns0:ShipToAddress1>
            <ns0:ShipToAddress2>My Address 2</ns0:ShipToAddress2>
            <ns0:ShipToAddress3 xsi:nil="true"/>
            <ns0:ShipToAddress4 xsi:nil="true"/>
            <ns0:ShipToCity>My City</ns0:ShipToCity>
            <ns0:ShipToPostalCode>12345</ns0:ShipToPostalCode>
            <ns0:ShipToState>My State</ns0:ShipToState>
            <ns0:ShipToProvince xsi:nil="true"/>
            <ns0:ShipToCounty>My City</ns0:ShipToCounty>
            <ns0:ShipToCountry>My Country</ns0:ShipToCountry>
            <ns0:ShipToPartyContactIdentifier>100000120196212</ns0:ShipToPartyContactIdentifier>
            <ns0:ShipToPartyContactName>Amy Tan</ns0:ShipToPartyContactName>
            <ns0:ShipToPartyContactFirstName>Amy</ns0:ShipToPartyContactFirstName>
            <ns0:ShipToPartyContactLastName>Tan</ns0:ShipToPartyContactLastName>
            <ns0:ShipToPartyContactMiddleName xsi:nil="true"/>
            <ns0:BillToCustomerIdentifier>100000119783144</ns0:BillToCustomerIdentifier>
            <ns0:BillToCustomerNumber>228990</ns0:BillToCustomerNumber>
            <ns0:BillToAccountSiteUseIdentifier>100000119795825</ns0:BillToAccountSiteUseIdentifier>
            <ns0:BillToAddress1>Invoice Processing Dept</ns0:BillToAddress1>
            <ns0:BillToAddress2>My Address</ns0:BillToAddress2>
            <ns0:BillToAddress3 xsi:nil="true"/>
            <ns0:BillToAddress4 xsi:nil="true"/>
            <ns0:BillToCity>My City</ns0:BillToCity>
            <ns0:BillToPostalCode>12345</ns0:BillToPostalCode>
            <ns0:BillToState>My State</ns0:BillToState>
            <ns0:BillToProvince xsi:nil="true"/>
            <ns0:BillToCounty>My City</ns0:BillToCounty>
            <ns0:BillToCountry>My Country</ns0:BillToCountry>
            <ns0:BillToAccountContactIdentifier>100000121406282</ns0:BillToAccountContactIdentifier>
            <ns0:BillToAccountContactName>Amy Tan</ns0:BillToAccountContactName>
            <ns0:BillToAccountContactFirstName>Amy</ns0:BillToAccountContactFirstName>
            <ns0:BillToAccountContactLastName>Tan</ns0:BillToAccountContactLastName>
            <ns0:BillToAccountContactMiddleName>Middle Name</ns0:BillToAccountContactMiddleName>
            <ns0:PartialShipAllowedFlag>false</ns0:PartialShipAllowedFlag>
            <ns0:RequestedSupplierCode xsi:nil="true"/>
            <ns0:RequestedSupplierName xsi:nil="true"/>
            <ns0:RequestedSupplierSiteCode xsi:nil="true"/>
            <ns0:SupplierAddressLine1 xsi:nil="true"/>
            <ns0:SupplierAddressLine2 xsi:nil="true"/>
            <ns0:SupplierAddressLine3 xsi:nil="true"/>
            <ns0:SupplierAddressLine4 xsi:nil="true"/>
            <ns0:SupplierAddressCity xsi:nil="true"/>
            <ns0:SupplierAddressState xsi:nil="true"/>
            <ns0:SupplierAddressZipCode xsi:nil="true"/>
            <ns0:SupplierAddressProvince xsi:nil="true"/>
            <ns0:SupplierAddressCounty xsi:nil="true"/>
            <ns0:SupplierAddressCountry xsi:nil="true"/>
            <ns0:Comments xsi:nil="true"/>
            <ns0:UnitSellingPrice currencyCode="USD">13.54</ns0:UnitSellingPrice>
            <ns0:ExtendedAmount currencyCode="USD">81.24</ns0:ExtendedAmount>
            <ns0:EarliestAcceptableShipDate xsi:nil="true"/>
            <ns0:LatestAcceptableShipDate xsi:nil="true"/>
            <ns0:LatestAcceptableArrivalDate xsi:nil="true"/>
            <ns0:PromiseShipDate xsi:nil="true"/>
            <ns0:PromiseArrivalDate xsi:nil="true"/>
            <ns0:ShipSetName xsi:nil="true"/>
            <ns0:TaxExempt>S</ns0:TaxExempt>
            <ns0:TaxClassificationCode xsi:nil="true"/>
            <ns0:TaxClassification xsi:nil="true"/>
            <ns0:UnitQuantity unitCode="EA">1</ns0:UnitQuantity>
            <ns0:FOBPointCode xsi:nil="true"/>
            <ns0:FOBPoint xsi:nil="true"/>
            <ns0:OrigSystemDocumentReference xsi:nil="true"/>
            <ns0:OrigSystemDocumentLineReference xsi:nil="true"/>
            <ns0:ContractStartDate xsi:nil="true"/>
            <ns0:ContractEndDate xsi:nil="true"/>
            <ns0:RequiredFulfillmentDate xsi:nil="true"/>
            <ns0:HeaderIdentifier>300000016713228</ns0:HeaderIdentifier>
            <ns0:LineIdentifier>300000016713231</ns0:LineIdentifier>
            <ns0:LineNumber>1</ns0:LineNumber>
            <ns0:StatusCode>SCHEDULED</ns0:StatusCode>
            <ns0:OpenFlag>true</ns0:OpenFlag>
            <ns0:CanceledFlag>false</ns0:CanceledFlag>
            <ns0:ActualShipDate xsi:nil="true"/>
            <ns0:CanceledQuantity xsi:nil="true"/>
            <ns0:FulfilledQuantity xsi:nil="true"/>
            <ns0:FulfillmentDate xsi:nil="true"/>
            <ns0:RMADeliveredQuantity xsi:nil="true"/>
            <ns0:ShippedQuantity xsi:nil="true"/>
            <ns0:LineOnHoldFlag>false</ns0:LineOnHoldFlag>
            <ns0:ItemTypeCode>4</ns0:ItemTypeCode>
            <ns0:FulfillLineIdentifier>300000016713230</ns0:FulfillLineIdentifier>
            <ns0:FulfillLineNumber>1</ns0:FulfillLineNumber>
            <ns0:ReservedQuantity unitCode="EA">6</ns0:ReservedQuantity>
            <ns0:ParentFulfillLineIdentifier xsi:nil="true"/>
            <ns0:RequestType xsi:nil="true"/>
            <ns0:RootParentFulfillLineIdentifier xsi:nil="true"/>
            <ns0:SplitFromFlineIdentifier xsi:nil="true"/>
            <ns0:FulfillLineOnHoldFlag>true</ns0:FulfillLineOnHoldFlag>
            <ns0:ActualCompletionDate xsi:nil="true"/>
            <ns0:EstimateFulfillmentCost>6</ns0:EstimateFulfillmentCost>
            <ns0:EstimateMargin>7</ns0:EstimateMargin>
            <ns0:FulfillInstanceIdentifier xsi:nil="true"/>
            <ns0:FulfillmentSplitReferenceIdentifier xsi:nil="true"/>
            <ns0:RemnantFlag>false</ns0:RemnantFlag>
            <ns0:SchedulingReasonCode xsi:nil="true"/>
            <ns0:SchedulingReason xsi:nil="true"/>
            <ns0:ConfigInventoryItemIdentifier xsi:nil="true"/>
            <ns0:ConfigItemReference xsi:nil="true"/>
            <ns0:ConfigInventoryItemNumber xsi:nil="true"/>
            <ns0:BuyerIdentifier xsi:nil="true"/>
            <ns0:BuyerFirstName xsi:nil="true"/>
            <ns0:BuyerLastName xsi:nil="true"/>
            <ns0:BuyerMiddleName xsi:nil="true"/>
            <ns0:BuyerName xsi:nil="true"/>
            <ns0:PreSplitOrderedQuantity xsi:nil="true"/>
            <ns0:PreviousStatusCode xsi:nil="true"/>
            <ns0:JeopardyPriority xsi:nil="true"/>
            <ns0:ActualShipDateTime xsi:nil="true"/>
            <ns0:ContractStartDateTime xsi:nil="true"/>
            <ns0:ContractEndDateTime xsi:nil="true"/>
            <ns0:FulfillmentDateTime xsi:nil="true"/>
            <ns0:ActualCompletionDateTime xsi:nil="true"/>
            <ns0:CanceledBackorderQuantity xsi:nil="true"/>
            <ns0:CancelBackordersFlag>false</ns0:CancelBackordersFlag>
            <ns0:EnforceSingleShipmentFlag>false</ns0:EnforceSingleShipmentFlag>
            <ns0:LineHold>
              <ns0:HoldCode>HOLD_FOR_CHANGE_REQUEST</ns0:HoldCode>
              <ns0:HoldComments xsi:nil="true"/>
              <ns0:LineHoldCode xsi:nil="true"/>
              <ns0:LineHoldComments xsi:nil="true"/>
              <ns0:EventFlag>false</ns0:EventFlag>
            </ns0:LineHold>
            <ns0:AdditionalOrderLineInformationCategories xmlns:ns4=http://xmlns.oracle.com/apps/scm/doo/processOrder/flex/fulfillLineContextsB/ xmlns:ns5=http://xmlns.oracle.com/apps/scm/doo/processOrder/flex/fulfillLineCategories/ xsi:type="ns5:j_FulfillLineEffDooFulfillLinesAddInfoprivate">
              <ns2:Category>DOO_FULFILL_LINES_ADD_INFO</ns2:Category>
              <ns2:FulfillLineId>300000016713230</ns2:FulfillLineId>
            </ns0:AdditionalOrderLineInformationCategories>
          </ns0:OrderLine>
        </ns1:result>
      </ns0:getSalesOrderNotificationDetailsResponse>
      <parentContext xmlns="">1658117/SalesOrderNotification</parentContext>
    </process>
  </part>
</inputToInvoker>