Order Management Integration

This chapter covers the following topics:

Integration

Processing an Order requires integration with many other business areas. Most integration points with other Oracle products are implemented via PL/SQL-based APIs. The following summarizes the integration points between OM and other products, organized by Product Family:

Applications Core Technology Family

AK - Common Modules

AK serves as a common runtime dictionary for both the Defaulting and Processing Constraints Frameworks. These modules use AK for object and attribute information. AK replaces the functionality provided by SO_OBJECTS and SO_ ATTRIBUTES in R11 Order Entry.

Additionally Order Management uses the following tables to extend the AK data model to support Usage functionality:

OE_AK_OBJECT_EXT

OE_AK_OBJ_ATTR_EXT

AOL

Order Management uses the following AOL features:

Document Sequences

AOL Document Sequences feature meets Order Numbering requirements. This lets you number Order and Returns using Manual, Automatic or Gapless sequences.

You can define Document Sequences using the AOL Define Document Sequences form. When you define an Order Transaction Type, the application automatically creates a Document Sequence Category of the same name. You can assign a pre-defined sequence to one or more Document Sequence Categories, using the AOL Sequence Assignments form. When an Order is created, Order Management calls AOL Document Sequence APIs to number the Order.

Attachments

Order Management drives off the AOL Attachment functionality enabling you to attach images and web pages as well as short or long text. It also offers multi-lingual document capability. Attachment definition and usage data is stored only in AOL.

Automatic Addition rule definitions are stored in Order Management (OE_ ATTACHMENT_RULES, OE_ATTACHMENT_RULE_ELEMENTS). In addition to the attributes (Customer, Ship-to, Invoice-to, Order Type, Item, PO #) that were previously available, you can now define rules based on the Order Category, Line Category and Line Type.

The Profile Option OM: Apply Automatic Attachments determines whether rule based attachments are automatically applied (without User intervention).

eCommerce Gateway

The eCommerce Gateway has the ability to load orders and order changes into Order Management via Order Import. Order Management pushes Order Acknowledgment and Change Order Acknowledgment data back to the eCommerce Gateway.

iSetup

iSetup pushes setup information into the Order Management schema after an implementer has answered questions regarding their business setup.

Workflow

Order Management uses Oracle Workflow to manage Order and Line processing. PL/SQL based Workflow is a natural replacement for Order Cycles functionality. It provides a Graphical User Interfaces for defining activities, notifications, flows and viewing flow status. There are no limits on the number of custom functions or notifications you can define.

Additionally, it provides the following features:

Every Order Header and Line entered into the system starts a workflow. Order Headers follow Header flows and Order Lines follow Line flows. The product comes seeded with several Order and Line flows. Every business function is workflow enabled and the product comes seeded with functional workflow sub-processes.

Order Headers are mapped to the OM Order Header workflow item type (OEOH). Order Lines are mapped to the OM Order Line workflow item type (OEOL). The Workflow Engine APIs are used to create, start and manage flows. The Order Type tied to an Order determines the Header flow it starts. The Order Type, Line Type, and Item type determines the Line flow a Line starts.

The FLOW_STATUS column on Order headers and Lines provides summary information about the flow. Its value changes as the Order or Line progresses in its respective flow. You can also use the Public query APIs (OE_HEADER_STATUS_ PUB, OE_LINE_STATUS_PUB) to get information regarding various functional statuses and when an Order or Line activity was completed.

The Workflow builder is available on the Windows (NT, 98 and 2000) platform. You can use this graphical tool to define flows. The Workflow monitor is a Java based tool that can be launched from the Sales Orders form. It lets you graphically monitor a workflow's progress as well and view its transaction history.

XML Gateway

The XML Gateway has the ability to load orders and order changes into Order Management via Order Import. Order Management pushes Order Acknowledgment and Change Order Acknowledgment data back to the XML Gateway.

Order Fulfillment Family

Advanced Pricing

Order Management leverages many business objects belonging to Advance Pricing, including price lists, modifiers, and agreements. Order Management, through its Sales Agreement functionality, creates price lists and pushes them into the Advanced Pricing tables. Order Management calls the Pricing Engine to make pricing requests during the processing of orders, and receives pricing information back from Advanced Pricing.

Configurator

Order Management integrates with Oracle Configurator to support ordering and validation of configurations. The Configurator window is a Java Applet that can be launched from the Sales Order form. Order Management communicates with Oracle Configurator through XML messaging. See: Oracle Configurator Developer User's Guide

iStore

iStore generates quote header and lines which are then sent to Order Management using the Order Capture API. RMAs are generated using Order Management's Process Orders API.

Release Management

Oracle Release Management pushes orders, lines and Sales Agreement releases into Order Management via the Process Order API. Order changes arising from changes to schedules in Release Management are also communicated to Order Management via Process Order. Order Management sends order status information back to Release Management, so that its schedules can be kept in sync with the orders.

Shipping Execution

Order Management provides APIs to Shipping to view lines that are eligible for delivery planning, picking and shipping. The view OE_DELIVERY_LINES_V returns all open, booked, shippable lines that are not interfaced to Shipping. When an Order Line reaches the Ship Line workflow activity, Order Management calls Shipping APIs to indicate that a line is pick eligible and communicate changes to the line once it is interfaced to Shipping. When a delivery is ship-confirmed, Shipping calls OM APIs to communicate the event, triggering the line flow to move forward. If Freight Costs were input during ship confirmation, that information is communicated back to Order Management when the delivery line is interfaced back from Shipping.

Oracle Order Management/Shipping Execution, provides an XML-based adapter to integrate to International Trade Management (ITM) Applications. The Oracle International Trade Management Adapter serves as the interface point to third party international trade management partners. With this adapter, Oracle E-Business Suite applications can embed global trade functionality into core business transactions.Oracle Order Management has expanded the ITM features that are available when using Oracle Order Management and the Oracle ITM Adapter in conjunction with a third party ITM partner. Features include:

Business Intelligence Products

Business Intelligence

Booked and fulfilled order lines from Order Management are pulled into the Applications Data Warehouse, where they become input to the various sales Business Intelligence reports.

Daily Business Intelligence

Order lines from Order Management are pulled into the Daily Business Intelligence product to produce up-to-date performance metrics.

Financials Product Family

Oracle Payment

Order Management accepts Credit Card information when entered on orders. It integrates with Oracle Payment to validate this information and get Credit Card authorizations. This information is then interfaced to Receivables.

iReceivables

Order Management integrates with iReceivables through the Order Information Portal. This integration allows users of the Order Information Portal to view invoices and credits related to the order they are viewing.

Payables

Order Management accesses the AP Bank Accounts table to populate the Credit Card LOV when an order is being entered with a payment type of Credit Card. Additionally, if a new credit card number is entered and the authorization of that card through iPayment is successful, Order Management calls an AR API to create a new bank account record for the customer in the Bank Accounts table.

Receivables

Order Management integrates with Oracle Receivables in the following function areas:

Trading Community Architecture

Order Management integrates with Oracle Trading Community Architecture to access customer setup information, including party data, account information, account sites, relationships and contacts. Many attributes of importance to Order Management, such as preferred warehouse, preferred order type, set preferences, price list and many others, are stored in the TCA data model at the account and account site level and are used by Order Management as defaulting sources.

In addition, Order Management, through the 'Add Customer' functionality, allows users to input new customer accounts, addresses and contacts. This data is pushed to the TCA schema, using TCA APIs. 'Add Customer' functions can also be performed through Order Management's Order Import program.

Human Resources Product Family

Training Administration

Order Management integrates with Oracle Training Administration to link classes and enrollments with orders for the purpose of billing. When classes or enrollments are marked as having been attended, the associated order lines are updated as fulfilled, and their line flows advance to the invoicing step.

Logistics Product Family

Inventory Management

Order Management integrates with Oracle Inventory Management through Managing Reservations. Order Management calls Inventory's reservation APIs to manage reservations. You can create reservations to on-hand quantities from the Sales Orders form. You can also go to Inventory's reservation form from the Sales Orders form and create a reservation to any level of inventory such as sub-inventory, locator, or lot if supply is available.

When supply is created for a ATO configuration (for a configuration item), it is reserved to a Work Order. This reservation gets transferred to on-hand when the work order is completed, thus reserving the Order line to on-hand. For every Order created, Order Management creates a record in MTL_SALES_ORDERS, an entity that Inventory uses to manage demand from various sources.

Reservation information is stored in MTL_RESERVATIONS. Reservation records for order Lines point to both MTL_SALES_ORDERS and OE_ORDER_LINES_ALL.

Product Lifecycle Management Family

Bills of Material

Order Management integrates with Oracle Bill of Material when models and kits are entered on sales orders. Order Management uses the Bill of Material defined for the model or kit or explode the model into its components, for the purpose of the user selecting options and for shipping purposes.

PLM

Order Management integrates with Oracle Product Lifecycle Management in the following areas:

Procurement Family

Purchasing

Order Management integrates with Oracle Purchasing in the following functional areas:

Supply Chain Planning Family

Advanced Planning System/Global Order Promising/ Advanced Supply Chain Planning

Order Management uses Advanced Supply Chain Planning's Global Order Promising functionality to check the availability of ordered items and to schedule order lines. Scheduled Order Lines are viewed as demand by the Advanced Planning System.

To check availability or schedule an order line (scheduling checks availability and consumes supply if there is any available), Order Management calls an MRP API (MRP_ATP_PUB.CALL_ATP). MRP checks for item availability (or group availability if a group of lines is passed) and returns back the results. The API also sources the line (find a ship from location) when a ship from location is not specified. A source will only be returned if there are sourcing rules set up in MRP. To ascertain open demand Planning looks at the view MTL_DEMAND_OM_VIEW, based off OE_ORDER_LINES. This returns open (un-shipped) lines whose visible to MRP flag is set to Y. The visible to MRP flag is set to Y, when a line is scheduled.

Before booking, Advanced Supply Chain Planning also performs item substitution during scheduling for order lines, when the ordered item is not available at the sourcing location and a substitute is available for the total line amount.

Sourcing rules can be used in scheduling for ATO models to select a warehouse for an ATO model. You do not need to specify a warehouse for the ATO model. To supply the warehouse for an ATO model, there is interaction with GOP and ASCP. Licensing these applications for autosourcing of the warehouse is not necessary, but you cannot use the Match feature without licensing both GOP and ASCP, and using PDS.

Manufacturing Product Family

Cost Management

Order Management calls the Cost Management CST_COST_API to obtain cost from cst_item_costs or cst_quantity_layers when the Gross Margin feature of OM is enabled. Item cost is stored on the order line, for ease of calculating the margin.

CTO

Order Management integrates with Configure-to-Order processes to fulfill orders for Replenish to Order models and items. These business functions are Workflow enabled. If the item is a 'buy' item, the process routes the items to Purchasing by creating a requisition. This process is called back-to-back orders. If the item is a 'make' item, the process flow creates the Configuration Item, BOM, Routings, Work Orders, and Flow Schedules. When the item is replenished (either by making it or buying it), the item is received into inventory and the reservation is transferred to the OM order line, so it can be shipped.

Order Management's Sales Order UI provides a link to the Supply to Order Workbench where the user can see the supply details and status for documents (purchase order or work order) that are reserved or referenced to the ATO sales order line. This enables customer service representatives to give customers an order status without having to navigate to the PO, WIP or flow forms.

Process Manufacturing

Order Management is able to process orders for items whose inventory is tracked in the Oracle Inventory application.

When processing orders for items in inventory organizations, Order Management enables additional attributes at the order line level to allow dual unit-of-measure (catchweight) and grade support. The secondary unit-of-measure and pricing unit-of-measure are interfaced to Advanced Pricing for catchweight items to enable accurate pricing at time of shipment.

Project Manufacturing

If a line is sold for a project tracked in PJM, you can record in Order Management the project and task number. Order lines that are identified as belonging to a project and task are pulled into PJM after fulfillment to update status in PJM.

Quality

Oracle Order Management provides visibility to Quality Plans for items displayed via the Order Information Portal through integration with Quality.

Work in Process

Order Management integrates with Oracle Work in Process to fulfill orders for Assemble to Order models and items. These business functions are Workflow enabled. The ATO process flow creates the Configuration Item, BOM, Routings, Work Orders, and Flow Schedules as required. The Work Order carries a link back to the OM order line, and the OM user can see the WIP job number and status by viewing the Inventory Reservation associated with the order line. Once the WIP job is complete or partially complete, the reservation is transferred to the OM line, and the line continues on its process flow.

Marketing and Sales Family

Oracle Sales Contracts

Oracle Order Management together with Oracle Sales Contracts can create long term agreements or a one-time sale, including terms and conditions for use by Sales Managers, Sales Representatives, Contract Negotiators, Contract Administrators as well as Legal Representatives. This functionality enables Oracle Sales Contracts and includes formal negotiation complete with internal approval and customer acceptance. Fundamental capabilities required for sales negotiation are supported, as well as additional contractual capabilities such as terms and conditions, price holds and the capability to enforce the agreed upon terms for future customer purchases. All Oracle Order Management transactions support the formal sales contract flows.

Incentive Compensation

Incentive Compensation (previously called Sales Compensation) pulls order lines from Order Management using a transaction collection API to calculate commissions and effectively align compensation with business objectives.

Order Capture

Order Management integrates with a few CRM products such as iStore, Quoting, and Depot Repair through Order Capture. The external teams can use the Order Management Process Order Group APIs to convert a quote to an order. Any changes to the Order Management Objects are communicated on-line to Order Capture via the Order Capture feedback queue. CRM products which are interested in the Order related information need to subscribe to the Order Capture queue to poll the messages.

Partners Online

Partners Online sends orders and lines entered through its user interface to Order Management by way of the Process Order API.

Telesales

Telesales' eBusiness Center has several integrations with Order Management. There is an Order tab to view order history and create new orders. The New button on the Order tab launches the Sales Order window. The Party, Account, Address and Contact information entered in the eBusiness Center are carried over and populated in the Sales Orders window. Order Management automatically creates an account, if an Account does not yet exist for the Party provided in TeleSales. The user can then enter the other details and process the Order.

Trade Management

Order Management can receive RMA orders and lines from Oracle Trade Management as part of its dispute handling functionality. In addition, Order Management leverages the Promotion Limits feature of Trade Management through Advanced Pricing calls.

Service Family

Depot Repair

Order Management is the ERP module used by Depot Repair to create RMA and Sales Orders, validate customer accounts, and invoice customers for repairs.

See: Order Capture

Field Service

Field Service Report requires specifically that you setup Price Lists, Units of Measure (UOM), and two Inventory Item Attributes in Order Management. Price Lists contain the list price for an item. Items could be material, but also labor and expenses like units of driving distance. Once material, expense and labor transactions for a task have been taken down on the Field Service Debrief, this information is updated to Charges. In Charges the list price for the item is received from Order Management and is used to generate an invoice for a customer.

Install Base

Information about Install Base trackable items is interfaced to Install Base in the following ways:

Install Base also supports Internal Sales Order transactions by appropriately creating / updating item instances as a result of transactions between internal organizations such as pick transactions, shipments, and receipts.

Service Contracts

Service Contracts has an API which pulls information from the Install Base newly created customer records and creates an ownership record.

In previous releases, Service Contracts used Order Capture as an integration point to create service contracts initiated by Order Management. In release 12, direct API calls from Order Management to Service Contracts replace Order Capture.

The Service Contracts (OKS) API processes one order line at a time, however it is also used for High Volume Order Processing for multiple lines.

This OKS API processes extended warranty/service (immediate or delayed) order lines.

The OKS Service Contracts Order Processing Concurrent program takes the data from the interface tables that have been populated by the API call and creates service contracts. You can run this concurrent program in multiple instances to create service contracts.

The Service Contracts Order Processing Concurrent program verifies that the instances are interfaced to Install Base before processing the interfaced service order lines.

Service Fulfillment Manager

Order Management integrates with SFM via workflow activities that can be inserted into the Order Management header and line flows. Order lines holding items that are marked as provisionable will be sent to SFM instead of through the Shipping Execution process for fulfillment.

Spares Management

As part of the Oracle Service suite of products, Spares Management is classified as an installable module provided with the Field Service solution. Oracle Inventory and Oracle Order Management are the only prerequisite products specifically required for a Spares Management implementation.

Integration with Oracle Order Management provides the ability to move parts among multiple inventory organizations and includes several sophisticated warehouse management features.

Oracle Spares Management supports the business processes involved in the management of spares parts in a field service organization. It is integrated with a number of Oracle's ERP and CRM applications. This integration provides extensive functionality to manage the business activities involved in the spares management process.

Oracle Order Management provides the functionality for the processing of an internal order to deliver parts to a field engineer for a specific task. An internal order is initiated in Spares Management in the Parts Requirement window. Within Order Management, the internal order is processed almost exactly like an order that is to be shipped to an external customer. This processing includes the picking, packing, shipping and receiving of the order.

Key integration features with Oracle Order Management include:

Authoring and Negotiating Contract Terms

Overview

Oracle Order Management users can create long-term agreements or contracts for a one-time sale, including contract terms and conditions based on a library of pre-approved clauses and contract templates, using Oracle Sales Contracts functionality. This functionality includes formal contract terms negotiation complete with internal approval and customer acceptance. All Oracle Order Management documents provide access to the contract terms library, and to the contract terms negotiation features provided by Sales Contracts:

Profiles

OKC: Enable Sales Contracts

This profile determines if an installation is authorized to use the contractual option provided in Order Management, and is set at the site level to enable terms and conditions integration in Order Management. If the profile option is set to Yes, you can author, negotiate and manage sales contracts including Agreements and Sales Orders and leverage Sales Contracts functionality such as Microsoft Word Integration and Collaboration, and Contract Expert to assemble your contract rapidly and efficiently.

Setup

To set up Oracle Sales Contracts for Authoring and Negotiating Contract Terms

  1. Set up the Contract Terms Library. Create any necessary:

    • Clauses

    • Contract Templates

    • Contract Expert Rules

    See Oracle Sales Contracts Implementation and Administration Guide

  2. You may create a Contract Template or you could add terms using the MS Word Integration functionality. Terms in the form of an MS Word document, pdf, or any format can be attached as well. If it is an Oracle generated document, terms are merged during preview of Sales Agreements / Sales Orders. Also terms are attached to notification for approval. Contract Templates can be enabled for different document types. You can have one or more Contract Templates per Document Type, such as for Sales Orders or Sales Agreements. It is not mandatory to define a default Contract Template on the Transaction Type. See Oracle Sales Contracts Implementation and Administration Guide.

  3. Create at least one Layout Template. The Layout Template is part of Oracle Applications Technology Group (ATG) functionality. If you are using Preview and Print, a template must be available. The layout template is not mandatory to define on the transaction type. A layout template can also be chosen from Oracle Sales Contracts or defined as a default. The transaction type default will override Oracle Sales Contract default.

    NOTE: During Layout Template setup, it is recommended to leave the end date blank. Without an end date, Layout Templates will not become inactive thus preventing use of an inactive Layout Template with an open sales document.

    See:Preview and Print Sales Documents

  4. Set the profile option OKC: Enable Sales Contracts to Yes. See Setup Profile Options for more information.

    Oracle Sales Contracts Implementation and Administration Guide

To set up Authoring and Negotiating Contract Terms

  1. Set up workflow extensions. Add the Sales Agreement/Sales Order Generation activity to the Negotiation with Approval workflow between Submit Draft and Internal Approval. This enables automatic attachment on the workflow notification to allow approvers to easily view the document and on the transaction itself as a reference in Contract Documents.

    If your business process includes an additional approval layer for non-standard clauses, extend workflow to check the sales document for the existence of non-standard clauses, and if they exist, route the sales document to additional approvers. As an example, the workflow activity, "Non Standard Clause Exists?" can be inserted between "Get Next Approver" and "Approved" to route to additional legal approvers while the Quote or Sales Agreement is in the "Pending Internal Approval" status.

  2. If needed, set the profile option OM: Printed Document Extension Class Name. Use this profile with a custom java code class path to enable printing from customized tables. See Preview and Print.

  3. Set up the transaction type. This can include:

    • Contract Templates

    • Layout Templates

    • A setup list of approvers

    Assigning default templates for Contract and Layout are not mandatory. If your workflow supports Approvals, set up an Approval list for each transaction type. See Approvals.

    Note: Contract Templates and Layout Templates can be attached to any OM transaction type.

Related Topics

See:Oracle Sales Contracts Implementation and Administration Guide for more details on authoring and negotiating Contract terms.

Sales Contracts Workbench

There are two ways to use the Sales Contracts Workbench: Sales Contracts Workbench Administrator and Sales Contracts Workbench User. Sales Contracts Workbench Administrator has additional ability to update Contracts Admin via Assign Contract Administrator functionality. Contract Administrators now can use the Contracts Workbench to carry out tasks like viewing and accessing contracts, and notifications. The Contracts Workbench is an HTML page that can be personalized by administrators. Bins or personalizable views are used in the Workbench page to enable administrators to displaying contract information, and additional seeded bins will display a user’s notifications, and commonly used shortcuts to additional contract functions. Administrators can take actions on the contracts directly from the bins, depending on their access rights and the contract status. They can also bookmark contracts for frequent use.

The available functionalities for Workbench are listed below:

Please see the Oracle Sales Contracts Implementation and Administration Guidefor more details.

Siebel Order Capture

The integration between Siebel Order Capture and Oracle eBusiness Suite (EBS) Order Management modules enables two way movement of data at user defined business events between these products. This feature supports inbound integration for create, update, and cancel of sales order or line using web service and outbound integration to notify selective sales order changes (like hold application, release, close) by raising work flow business events.

Using this integration, you can:

Integrating Siebel Order Capture and Oracle EBS Order Management

To integrate Siebel Order Capture and Oracle EBS Order Management, you must set up the following:

Setting up Profile Options

You must set the following profiles at Site level, to a value of Yes or No. If you do not set any value, then the application considers the default value of No, and implements appropriate behavior. The application treats an SQL NULL value for these profile option values as a No, for the purpose of computation of the freight charges and tax amounts.

Extending the Flow Status Synchronization Capability

The integration between Siebel Order Capture and Oracle eBusiness Suite (EBS) Order Management modules use the predefined flow status codes where the Oracle EBS Order Management application raises an event on a change in the flow status code. As an Order Management administrator, you can enable or disable specific flow status code change to raise an outbound communication event using the AIA – Sales Order Status Synchronization window. Using this window, you can update the data defined in the OE_FLOW_STATUS_AIA_SYNC table. This table stores the information about the order/line flow status codes, and whether a specific change to a given flow status code needs to initiate a communication to AIA layer (by raising business event). Based on the configurations, EBS Order Management sends applicable information to Siebel Order Capture.

You can configure the following flow status codes to raise a business event to communicate status change with Siebel Order Capture application:

  1. Awaiting Fulfillment

  2. Awaiting Receipt

  3. Cancelled

  4. Inventory Interfaced

  5. Interfaced to Receivables

  6. Partially interfaced to Receivables

  7. Awaiting Invoice Interface – Pending Complete Delivery

  8. Awaiting Invoice Interface – On Hold

  9. Awaiting Invoice Interface – Incomplete Data

  10. In Receiving

  11. In Receiving Partial

  12. Returned

  13. External Req Open

  14. External Req Partial

  15. External Req Requested

  16. Internal Req Open

  17. Internal Req Partial

  18. Internal Req Requested

  19. BOM and Routing Created

  20. Config Item Created

  21. Supply Eligible

  22. Booked

  23. Awaiting Shipping

  24. Shipped

  25. Fulfilled

  26. Closed

  27. Awaiting Invoice Interface - RFR Item

  28. Invoice Interface – Not Applicable

  29. Pending pre-billing acceptance

  30. Awaiting Return

  31. Awaiting Return Disposition

Of these, statuses 3, 23, 24, 25, 26 are enabled by default for synchronization while the others are disabled by default for synchronization. You can edit the synchronization preferences for all these status using the AIA – Sales Order Status Synchronization window.

To extend the flow status synchronization capability:

  1. Navigate to the AIA – Sales Order Status Synchronization window.

  2. Indicate synchronization for the applicable flow statuses to raise a business event to communicate status change with Siebel Order Capture application.

  3. Save and close the window.