Professional Documents
Culture Documents
Implementing Order Management
Implementing Order Management
21B
Oracle SCM Cloud
Implementing Order Management
21B
Part Number F39754-02
Copyright © 2011, 2021, Oracle and/or its affiliates.
This software and related documentation are provided under a license agreement containing restrictions on use and disclosure and are protected
by intellectual property laws. Except as expressly permitted in your license agreement or allowed by law, you may not use, copy, reproduce, translate,
broadcast, modify, license, transmit, distribute, exhibit, perform, publish, or display any part, in any form, or by any means. Reverse engineering,
disassembly, or decompilation of this software, unless required by law for interoperability, is prohibited.
The information contained herein is subject to change without notice and is not warranted to be error-free. If you find any errors, please report
them to us in writing.
If this is software or related documentation that is delivered to the U.S. Government or anyone licensing it on behalf of the U.S. Government, then
the following notice is applicable:
U.S. GOVERNMENT END USERS: Oracle programs (including any operating system, integrated software, any programs embedded, installed or
activated on delivered hardware, and modifications of such programs) and Oracle computer documentation or other Oracle data delivered to or
accessed by U.S. Government end users are "commercial computer software" or "commercial computer software documentation" pursuant to the
applicable Federal Acquisition Regulation and agency-specific supplemental regulations. As such, the use, reproduction, duplication, release, display,
disclosure, modification, preparation of derivative works, and/or adaptation of i) Oracle programs (including any operating system, integrated
software, any programs embedded, installed or activated on delivered hardware, and modifications of such programs), ii) Oracle computer
documentation and/or iii) other Oracle data, is subject to the rights and limitations specified in the license contained in the applicable contract. The
terms governing the U.S. Government's use of Oracle cloud services are defined by the applicable contract for such services. No other rights are
granted to the U.S. Government.
This software or hardware is developed for general use in a variety of information management applications. It is not developed or intended for
use in any inherently dangerous applications, including applications that may create a risk of personal injury. If you use this software or hardware
in dangerous applications, then you shall be responsible to take all appropriate fail-safe, backup, redundancy, and other measures to ensure its safe
use. Oracle Corporation and its affiliates disclaim any liability for any damages caused by use of this software or hardware in dangerous applications.
Oracle and Java are registered trademarks of Oracle and/or its affiliates. Other names may be trademarks of their respective owners.
Intel and Intel Inside are trademarks or registered trademarks of Intel Corporation. All SPARC trademarks are used under license and are trademarks
or registered trademarks of SPARC International, Inc. AMD, Epyc, and the AMD logo are trademarks or registered trademarks of Advanced Micro
Devices. UNIX is a registered trademark of The Open Group.
This software or hardware and documentation may provide access to or information about content, products, and services from third parties. Oracle
Corporation and its affiliates are not responsible for and expressly disclaim all warranties of any kind with respect to third-party content, products, and
services unless otherwise set forth in an applicable agreement between you and Oracle. Oracle Corporation and its affiliates will not be responsible
for any loss, costs, or damages incurred due to your access to or use of third-party content, products, or services, except as set forth in an applicable
agreement between you and Oracle.
The business names used in this documentation are fictitious, and are not intended to identify any real companies currently or previously in existence.
Oracle SCM Cloud
Implementing Order Management
Contents
Preface i
1 Hello 1
Overview .......................................................................................................................................................................................... 1
Details ............................................................................................................................................................................................. 21
3 Integrate 173
Introduction ................................................................................................................................................................................ 173
Oracle Applications ................................................................................................................................................................... 195
Web Services .............................................................................................................................................................................. 385
Upstream Source Systems ..................................................................................................................................................... 460
Downstream Fulfillment Systems ......................................................................................................................................... 474
Cross-References ....................................................................................................................................................................... 619
eBusiness Suite .......................................................................................................................................................................... 631
Drop Ship ................................................................................................................................................................................... 668
9 Configure-to-Order 1529
Overview .................................................................................................................................................................................... 1529
Main Setup ............................................................................................................................................................................... 1546
Other Setups ............................................................................................................................................................................ 1597
Web Services ............................................................................................................................................................................ 1652
Oracle SCM Cloud
Implementing Order Management
10 Extend 1687
Extensions ................................................................................................................................................................................ 1687
Flexfields ................................................................................................................................................................................... 1863
Preface
This preface introduces information sources that can help you use the application.
Help
Use help icons to access help in the application. If you don't see any help icons on your page, click your user image
or name in the global header and select Show Help Icons. Not all pages have help icons. You can also access the Oracle
Help Center to find guides and videos.
Watch: This video tutorial shows you how to find and use help.
Additional Resources
• Community: Use Oracle Cloud Customer Connect to get information from experts at Oracle, the partner
community, and other users.
Conventions
The following table explains the text conventions used in this guide.
Convention Meaning
boldface Boldface type indicates user interface elements, navigation paths, or values you enter or select.
monospace Monospace type indicates file, folder, and directory names, code examples, commands, and URLs.
i
Oracle SCM Cloud Preface
Implementing Order Management
Documentation Accessibility
For information about Oracle's commitment to accessibility, visit the Oracle Accessibility Program website.
Videos included in this guide are provided as a media alternative for text-based help topics also available in this guide.
Contacting Oracle
ii
Oracle SCM Cloud Chapter 1
Implementing Order Management Hello
1 Hello
Overview
What's New in Implementing Order Management
Get details about help topics that are new or significantly revised for each release.
To get details about.
• New features in each release, see the Order Management in Oracle Cloud Release Readiness page at https://
cloud.oracle.com/saas/readiness?offering=order-management.
• Known issues for each release, see Oracle Supply Chain Management Cloud Functional Known Issues and
Maintenance Packs (Doc ID 1563075.1) on My Oracle Support.
Release 21B
Topic Description
Use Credit Card Tokens to Improve New. Use tokens to improve security for the credit cards that you use with Order Management
Security Cloud.
Use Integration Algorithms to New. Use an integration algorithm when you must implement logic that you can't do through
Implement Complex Logic only a service mapping.
Import and Export Processing New. Import and export processing constraints between environments, such as between your
Constraints test environment and your production environment.
Integrate a Predefined Attribute New. Use a service mapping to map the Contract Start Date from the fulfillment line of a sales
Between Order Management and order, to the Start Date on the invoice line of an invoice in Accounts Receivable.
Accounts Receivable
Integrate Your Own Header Attribute New. Use an extensible flexfield on the order header in Order Management to capture a value,
Between Order Management and then send that value to Oracle Receivables so Receivables can display it on an invoice.
Oracle Receivables
Integrate Your Own Order New. Use extensible flexfields and descriptive flexfields to integrate attributes on an order line
Line Attributes between Order in Order Management and send their values to Oracle Receivables.
Management and Oracle Receivables
Guidelines for Importing Pricing Data New. Use guidelines to help you import pricing data.
Item Validation Organization Revised. Get details about how to set the Item Validation Organization order management
parameter.
1
Oracle SCM Cloud Chapter 1
Implementing Order Management Hello
Topic Description
Manage Order Management Revised. Specify the number of seconds to wait before giving control back to the user for sales
Parameters orders that have a large number of order lines.
Use Order Profiles to Control Order Revised. Use the Hours to Wait Before Allowing Date Changes on Fulfillment Lines profile to
Management Behavior specify the number of hours to wait.
Overview of Importing Orders into Revised. Its recommended that you use file-based data import (FBDI) instead of web services
Order Management or REST API to import a large number of source orders.
Use SQL to Query Order Revised. Find out which reservations have finished.
Management Data
Use Order Profiles to Control Order Revised. Get details about the Send Fulfillment Details for Drop Shipments to Accounts
Management Behavior Receivable order profile.
Apply Logic in Business Rules Revised. The priority determines the sequence that Order Management uses when it applies
the rule.
Indicate an Ownership Change Revised. Learn how to recover an advance shipment notice.
During Drop Ship
Track Items as Assets in Order Revised. If you sell covered items and coverage items, and if you have a step that calls the
Management DOO_Subscription task, then you must call the DOO_AssetManagement task before you call
the DOO_Subscription task.
Import Different Kinds of Data Revised. Import a source order and immediately close it.
2
Oracle SCM Cloud Chapter 1
Implementing Order Management Hello
Topic Description
Overview of Using Flexfields to Revised. If your flexfield is on a fulfillment line, then use only one context for each entity.
Integrate Order Management with
Other Oracle Applications
Resume Paused Orchestration Revised. Examine some example payloads that release a pause task.
Processes
Troubleshoot Problems in Revised. Fix a problem when the price on the order line is different than the price on the
Downstream Fulfillment invoice.
Create a Return Reason Revised. You can't disable or change the End Date on predefined lookup codes that have an
ORA_ prefix,
Manage Connector Details Between Revised. If you create more than one connector for the same target system, then you must use
Order Management and Your the same user name and password on each of those connectors.
Fulfillment System
Fix an Order Status That Doesn't Revised. What does Partially Closed mean, and how do I fix that?
Update to Shipped
Troubleshoot Problems with Web Revised. Fix a performance problem when you use OrderFulfillmentResponseService with
Services Integration Cloud Service.
Don't Use Order Promising to Revised. Includes new details about the attributes you must set on the order line.
Schedule Fulfillment
Release 21A
Topic Description
Credit Cards New section. Integrate Order Management Cloud with Oracle Fusion Payments so your users
can select an existing credit card or add a new one to a sales order.
Example of Integrating Order New. Use a demonstration to learn how to integrate Order Management with another Oracle
Management with Other Oracle Application.
Applications
Remove Infolets in the Order New. Remove an infolet that displays on the Overview page of the Order Management work
Management Work Area area.
3
Oracle SCM Cloud Chapter 1
Implementing Order Management Hello
Topic Description
Get and Display Approval Details for New. Get approval details and use them for your specific needs, such as in an audit report.
Sales Orders
Resolve Problems with the New. Resolve a problem where the Warehouse attribute on the order line is empty or doesn't
Warehouse Attribute on Sales Orders contain the warehouse that you need to pick.
Get Things Moving Again in Accounts New. Manually run a scheduled process to resolve a sales order that's stuck in a particular
Receivable status.
Transfer Inventory Between Business New. Transfer inventory between business units when there isn't enough inventory to fulfill a
Units to Fulfill Sales Orders sales order for one of them.
Set Up Currency Conversion New. Set up Order Management so it converts currency when you sell into markets that use
different currencies.
Guidelines for Processing Return Revised. Don't assign outbound lines to an orchestration process that processes returns.
Orders
More Code Examples for Order Revised. If your billing application already authorized payment, then run an extension to
Management Extensions prevent the user from editing payment attributes.
Import and Update Source Revised. If you import a billing plan, then make sure the PeriodicityCode attribute doesn't
Orders That Include Coverages or contain ONE TIME under the BillingPlans entity for the order line in your import payload.
Subscriptions
Manage Order Management Revised. Specify values for new parameters: Use Price on Imported Orders That Oracle Fusion
Parameters Already Priced, and Use Pricing Algorithms to Calculate Totals for Sales Order.
Import Orders into Order Revised. Use the Order Interface Status parameter to specify whether to process source orders
Management that failed during a previous import.
Troubleshoot Problems With Order Revised. Fix a sales order that's stuck in shipped status.
Import
4
Oracle SCM Cloud Chapter 1
Implementing Order Management Hello
Topic Description
Import Different Kinds of Data Revised. If you import a draft sales order, then do another import that changes the draft, then
Order Management assigns a new order number to the draft. You must use the new order
number in any subsequent updates or processing.
Transformation Rules Revised. Order Management runs transformation rules differently depending on where you
manage your sales orders.
Retain Sales Order Number During Revised. Get details about how to make sure the order number in Order Management and the
Import order number in Accounts Receivable are the same.
Indicate an Ownership Change Revised. Use the Manage Receiving Transactions scheduled process to receive and deliver a
During Drop Ship drop shipment in Oracle Fusion Receiving.
Troubleshoot Order Management Revised. If you adjust price on a referenced return line for an outbound line that has recurring
Cloud billing, and if the unit price on the return line is different from the unit price on the original line,
then you must set the CancelReasonCode attribute to ORA_PRICE_CHANGE
Troubleshoot Problems with Web Revised. Fix a problem when you have gaps in your order line numbers.
Services
Troubleshoot Tax Set Up Revised. Use the Assessable Value attribute to calculate tax for an order line that has a value of
zero in the Amount attribute.
Example Web Service Payloads That Revised. You can't include the Attachment entity in a stage order payload.
Integrate Order Management
Specify Transaction Types When Revised. Get details about how to set the transaction type before you transform.
Integrating Order Management with
Oracle Receivables
Guidelines for Integrating Order Revised. Make sure the user has the privilege you need.
Management with Transportation
Management
Freeze Price on Sales Orders Revised. Learn now to freeze price on return orders.
Display Contacts on Sales Orders Revised. Learn how to remove duplicate contacts that display in the list of values when you
click the down arrow in the Contact attribute on the order header.
Create Different Types of Business Revised. If the order header and the order line contain the same attribute, such as the
Rules Freight Terms attribute, and if you need to transform the value on the line, then use a
posttransformation rule.
5
Oracle SCM Cloud Chapter 1
Implementing Order Management Hello
Topic Description
Set Default Value for Contact on Revised. Learn how to remove duplicate contacts from the Contact attribute on the order
Order Header header.
Import Customer Items into Order Revised. Clarified what a customer item is and how to import it.
Management
Guidelines for Setting Up Revised. If you import a revision that includes the entire component list for a configuration
Configuration Models model, then you must make sure the sequence that you use in the revision is identical to the
sequence you used in the original import.
Guidelines for Setting Up Revised. If you copy or duplicate an orchestration process, then make sure you validate it and
Orchestration Processes remove all validation errors before you create the copy or duplicate.
Guidelines for Setting Up Revised. Use Advanced Mode when you add a business rule to the first step of a custom
Orchestration Process Steps orchestration process.
Filter Lines In Your Extensions, Rules, Revised. If you set the nonKitModelFlag attribute to Y on a line-selection criteria, and if the
and Constraints order line contains a configuration model, and if the model contains a kit, then select the line
and process it.
Import Tax on Sales Orders Revised. Get details about how How Order Management integrates tax with Accounts
Receivable.
Resume Paused Orchestration Revised. Make sure you have the privileges you need to release pause tasks.
Processes
Manage Connector Details Between Revised. If you attach a large number of documents to the sales order, then its recommended
Order Management and Your that you set Invocation Mode to Asynchronous Service.
Fulfillment System
Create Different Types of Business Revised. Don't create a routing rule that depends on a pause task and that sets the connector.
Rules
Guidelines for Setting Up Holds on Revised. You can't use the web service to release a hold on a fulfillment line.
Sales Orders
Release 20D
6
Oracle SCM Cloud Chapter 1
Implementing Order Management Hello
Topic Description
Tax New section. Learn how to set up and apply tax to sales orders.
Create Direct Links to Order New. Create a direct link from your application or an Oracle Fusion Application to a page in the
Management Pages Order Management work area.
Use Order Management to Fulfill New. Use Order Management to fulfill a range of order types.
Different Types of Sales Orders
Automatically Import Source Orders New. You can use the Order Import Template to manually import orders from your source
into Order Management system into Order Management. This topic describes how to do it automatically.
Troubleshoot Global Order Promising New. Get details about how to troubleshoot problems that including promising in your
in Order Management implementation.
Don't Use Order Promising to New. Your implementation might not need to use Order Promising to schedule fulfillment. You
Schedule Fulfillment can set up Order Management so it doesn't.
Create a Return Reason New. Create a return reason so the Order Entry Specialist can choose it when returning an
order line.
Another Example of Importing New. Add an extensible flexfield to store a status on the order line, and import it through the
Flexfield Data Through Web Services Receive Order Request Service.
Example of Using an Extension to Get New. Identify the public view object you need, then reference it in an order management
Data from Oracle Applications extension.
Set Default Values for Attributes on New. Create a business rule that sets the default value for an attribute on a sales order.
Sales Orders
Use Different Attributes in the New. Create a pretransformation rule on a variety of attributes in the condition or action, and
Condition and Do Simple Math include a simple mathematical equation.
Set Values for Attributes That Depend New. Some attributes depend on each other. For example, if you need to use a shipment set,
On Each Other you must first enable the Shipset attribute.
Set Default Values for Shipping New. You can specify the default value that Order Management uses to set the Shipping
Methods Method attribute when the Order Entry Specialist creates a sales order.
Set Warehouse According to the New. Set up Order Management so it sets the default value for the Warehouse attribute on the
Value of Some Other Attribute fulfillment line according to the value of the Business Unit attribute on the order header.
Use Business Rules When You Can't New. Create a business rule when an Order Management extension doesn't meet your
Use Extensions requirements.
7
Oracle SCM Cloud Chapter 1
Implementing Order Management Hello
Topic Description
Add Promotional Items That Reward New. Add an item to a sales order to reward customers who purchase larger quantities.
Your Customers
Set Attribute Values After You New. Set the default value for an attribute after you transform the source order.
Transform Source Orders
Set Promised Ship and Arrival Dates New. Learn how to set the Promised Ship Date and the Promised Arrival Date.
on Fulfillment Lines
Use Flexfields to Allow Users to Set New. Allow your Order Entry Specialists to enter a value in a flexfield to indicate they need to
Attribute Values change the value of an attribute.
Remove Records That Contain New. Remove records that contain data about actions that Order Management users have
Data About Actions to Improve done while managing sales orders. Removing these records can improve performance.
Performance
Import Price Details Revised. If you copy a sales order that has a configured item, and if the order also includes
an order line that has a coverage for the configured item, then Order Management uses the
pricing that you specify in the Pricing Administration work area for the coverage item even if
you freeze pricing during import.
• You must map time units for your coverages and subscriptions.
• You can't use an order management extension or a transformation rule to set shipment
set values on an order line that contains a coverage.
• If you import a sales order, and if your import includes a shipment set on an order line
that contains a coverage item, then the import ignores the value for the shipment set on
the line.
Overview of Importing Orders into Revised. If you must import binary data, then you must convert your binary data to text before
Order Management you do the import, and you must use the base64 encoding scheme when do the conversion.
Set Up Orchestration Processes for Revised. Use a pause task to make sure the coverage item and covered item go to billing at the
Coverage Items same time.
Troubleshoot Problems With Order Revised. If you import a referenced return order but Receivables doesn't create a credit memo
Import for the return, then make sure the business unit on the order line that you import is the same
as the business unit on the original order line.
Guidelines for Setting Up Approval Revised. Use the Make Notifications Secure option to secure your notifications.
Import Source Orders That Include Revised. Learn how to import coverages or subscriptions through FulfillmentResponseService.
Coverages or Subscriptions
Create One Invoice for Sales Orders Revised. Make sure you use square brackets to enclose the list when you set the GL Date.
with Items That Can and Can't Ship
8
Oracle SCM Cloud Chapter 1
Implementing Order Management Hello
Topic Description
Code Snippets for Order Revised. Set the Requested Ship Date on the order line to the same value that the Requested
Management Extensions Ship Date attribute contains on the order header.
Set Up Shipping Tolerances in Order Revised. Set the Over Shipment Tolerance attribute to a positive number that's greater than
Management zero. Set the Under Shipment Tolerance to a positive number that's greater than zero but less
than 100.
Guidelines for Setting Up and Using Revised. Get new details about predefined processing constraints. They're in the Manage
Drop Ship Change subtopic.
Guidelines for Setting Up an Revised. Make sure you can use Purchase Request Service to update the attributes that you
Integration Algorithm map.
Guidelines for Using Extensions to Revised. Get details about tables, views, and public view objects.
Get Data from Oracle Applications
Troubleshoot Order Management Revised. Troubleshoot an extension that doesn't run when you cancel a sales order.
Cloud
Release 20C
Topic Description
Identify Flexfield Contexts and New. Identify the flexfield contexts and category codes that you reference in an Oracle
Category Codes for Your Business Business Rule.
Rules
Examples of Pausing Orchestration New. Peruse these examples to learn how you can use business rules to meet your business
Processes requirements.
Example of Integrating Order New. Assume you need to integrate Order Management with your shipment system. Use this
Management with an External topic to learn how.
Fulfillment System
Get Help From My Oracle Support New. Use the My Oracle Support website at support.oracle.com to troubleshoot a range of
problems.
Include Price, Discounts, and New. Make sure that the values you send in the payloads you use to integrate with various
Shipping Charges in Your Payloads systems include accurate values for price, discounts, and shipping charges.
Cancel Backordered Quantity During New. You can use the order import service to cancel a backordered line.
Order Import
9
Oracle SCM Cloud Chapter 1
Implementing Order Management Hello
Topic Description
Set Up Item Substitution in Order New. Set up substitution in Order Management so you can use a substitute item to fulfill an
Management order line when the preferred item is out of stock.
Overview of Integrating Order New. Automate how Revenue Management gets sales order data from Order Management so
Management with Revenue Revenue Management can recognize revenue for the sales order.
Management
Manage Order Attributes That Revised. Restart the Oracle server when you do the Manage Order Attributes That Identify
Identify Change Change task.
Guidelines for Setting Up Order-to- Revised. Avoid a runtime error. Consider how processing constraints affect your setup.
Cash
How Configure-to-Order Works Revised. You can't cancel a configure option in a pick-to-order item or kit when the shipment is
out of proportion.
Use Integration Cloud Service with Revised. Get details about articles on Oracle Help Center that describe other ways you can use
Order Management Integration Cloud Service with Order Management.
Manage Processing Constraints Revised. If you create your own processing constraint or modify a predefined one, and if you
update to a new release, then you must generate packages immediately after you do the
update.
Convert Shipment Costs to Freight Revised. Includes revised payloads and new diagrams to help you set up the connector.
Charges
Use Order Profiles to Control Order Revised. Specify the number of minutes for the hold operation to wait before timing out while
Management Behavior aggregating order lines.
Set Up Coverage for Sales Orders Revised. Get details about how Coverage Start Date works.
Quick Start for Setting Up Order-to- Revised. Includes some revised details about setting up your URL and security.
Cash
Use Extensible Flexfields to Integrate Revised. The attribute View Object Attribute is required for each mapping you create in this
Order Management with Other topic.
Applications
Use Descriptive Flexfields to Integrate Revised. If you add a value in the Alias attribute, then make sure the value begins with an
Order Management with Other Oracle upper case character.
Applications
10
Oracle SCM Cloud Chapter 1
Implementing Order Management Hello
Topic Description
• If your return line is stuck in the Awaiting Receiving status, then run the Send Receipt
Confirmation scheduled process.
• If you encounter a currency conversion error, then you might need to set up a default
value for the conversion rate type.
• If you can't set a value for the Profile Value attribute on the Manage Administrator
Profile Values page, then you might need to collect data.
Allow Users to Return Items Without Revised. Get new details about how Pricing prices a return.
Original Sales Order
Example Web Service Payloads That Revised. Get new example payloads for manual price adjustment.
Integrate Order Management
Guidelines for Setting Up Holds on Revised. You can now use a web service to apply or release a hold on a sales order that's in
Sales Orders Draft status.
Overview of Using Extensible Revised. If the order line that the fulfillment line references is closed, then the Order Entry
Flexfields in Order Management Specialist can't update the value in the extensible flexfield on the fulfillment line.
Guidelines for Setting Up Extensible Revised. Make sure the name for each segment or context you create uses the correct
Flexfields in Order Management nomenclature.
Code Snippets for Order Revised. Includes new snippets that you can use with your order management extensions.
Management Extensions
Display Ship-to Addresses On Sales Revised. Set the default value for the Contact Method attribute on each sales order.
Orders
Guidelines for Importing Orders into Revised. If you don't want to submit your imported order to fulfillment, but instead
Order Management want to import it as a draft sales order, then set the Submit Flag attribute to N on the
DOO_ORDER_HEADERS_ALL_INT worksheet.
How Drop Ship Works in Order Revised. Procurement doesn't use the Product Category or Product Fiscal Classification to
Management create a purchase order.
Release 20B
11
Oracle SCM Cloud Chapter 1
Implementing Order Management Hello
Topic Description
Collect Planning Data for Order New. Get details about how to collect planning data, including a complete list of data that you
Management can collect.
Modify Report Templates New. The Reports and Analytics work area comes predefined with several reports that you can
use. You can modify a template to meet your needs.
Import Shipping Method New. If you import a shipping method through REST API or FBDI, you must make sure the
method is valid.
Guidelines for Setting Up Units of New. Use guidelines to help you set up the units of measure that you use in Order
Measure Management.
Create One Invoice for Sales Orders New. Set up order management so it creates a single invoice when your sales order includes
with Items That Can and Can't Ship order lines that can ship and lines that can't.
Guidelines for Creating Business Revised. If your rule references an attribute that doesn't contain a value, and if your rule does
Rules a calculation that requires a value, then it might create an error or result in a null pointer
exception at run time.
Guidelines for Managing Shipment Revised. Includes some new guidelines. Includes new details about importing a shipment set.
Sets
Use Extensions to Get Values for Revised. Get purchase order details from the order header and order line of the original order,
Return Orders then copy them to the return order and return order line.
Use Diagnostics to Troubleshoot Revised. Use the Order Management Health Check test to scan through your database and
Sales Orders identify problems across sales orders.
Drop Ship section New and revised. Read the new topics and revised topics that clarify how to set up drop ship.
Guidelines for Importing Orders into Revised. If you import an order, revise it, submit it, then import it again in a subsequent import,
Order Management then you must import the most recent attribute values in the subsequent import.
Quick Start for Setting Up Order-to- Revised. You must deploy the predefined Update Shipping Request Validation processing
Cash constraint.
Set Up Messages in Order Revised. Read up on some new details about how to set up messages.
Management
Use SQL to Query Order Revised. Find the reservations that have finished for an item in your sales order.
Management Data
Overview of Setting Up Sales Revised. Learn about new date attributes you can use when you import or integrate an
Agreements in Order Management agreement.
12
Oracle SCM Cloud Chapter 1
Implementing Order Management Hello
Topic Description
Guidelines for Setting Up Approval Revised. You can use the order type attribute on the order header in an approval rule.
Troubleshoot Order Management Revised. Write an order management extension that won't error out when your sales order
Setup doesn't use the English language.
Examine predefined processing constraints to see if that's the cause of an error you're
encountering.
Guidelines for Setting Up and Using Revised. If the quantity on the advance shipment notice (ASN) exceeds the ordered quantity,
Drop Ship then Oracle Fusion Receiving rejects the fulfillment request regardless of how you set the
Over-Receipt Action attribute.
Use Order Profiles to Control Order Revised. If you use OPS as your source system in a channel, then you must set Retain Sales
Management Behavior Order Number to N.
Allow Users to Return Items Without Revised. Requirements for what you can return depend on whether the item is pick-to-order or
Original Sales Order assemble-to-order.
Guidelines for Setting Up Revised. Make sure you specify the value Canceled as an exit criteria status to exit the wait task
Orchestration Process Steps in your orchestration process.
Copy Setups Between Instances of Revised. If you migrate from a production environment to a test environment, and if your
Order Management migration includes an orchestration process that's currently in progress, then the sales order
that references the process will become stuck. You can't recover the stuck order.
Manage Order Management Revised. Order Management doesn't use the value for any other attribute as the preparer. For
Parameters example, it doesn't use the Created By attribute. It uses only the value you specify in Preparer
for Procurement.
Example Web Service Payloads That Revised. Use the ProjectDetail tag to include project details in your payload.
Integrate Order Management
13
Oracle SCM Cloud Chapter 1
Implementing Order Management Hello
Note.
• Capture. Capture demand from channels, such as web, mobile, call center, direct sales, or partners. Provide the
functionality that your users need during order capture, such as price items, determine availability, get order
status, and so on.
• Orchestrate and monitor fulfillment across channels. Coordinate with other Oracle Supply Chain
Management Cloud applications during fulfillment, such as purchasing, manufacturing, inventory
management, and other solutions.
• Fulfill. Integrate Order Management with systems that reside outside of Order Management.
14
Oracle SCM Cloud Chapter 1
Implementing Order Management Hello
For details about how Order Management integrates channels with other systems, see the Overview of Integrating
Order Management topic.
15
Oracle SCM Cloud Chapter 1
Implementing Order Management Hello
Set Up Processing
Set up the orchestration process that Order Management uses to fulfill each sales order. Create a new orchestration
process or modify an existing one that comes predefined with Order Management and that already meets most of your
business requirements.
• Use common, conditional, parallel, or interrelated flows for order lines.
• Create change order rules that automatically modify order fulfillment.
• Create rules that calculate order completion date according to requested date.
• Create common statuses to use across your business process.
• Create draft orders in Order Management that you can later submit for processing.
Create an orchestration process that plans fulfillment processes, calculates lead times, modifies order compensation
steps, and so on.
You can also write your own Groovy script in an order management extension to modify your Order Management
deployment. Create the extension point that determines when to run this script. For details, see the Overview of
Extensions That Modify Order Management topic.
16
Oracle SCM Cloud Chapter 1
Implementing Order Management Hello
• Add details to improve fulfillment. For example, add or modify attributes or add more items so Order
Management can efficiently fulfill the sales order.
17
Oracle SCM Cloud Chapter 1
Implementing Order Management Hello
Capture orders from your channels in an order capture system, such as the Order Management work area, or Configure,
Price and Quote. You can also import orders from your source system, such as a legacy order capture system.
• Web sales
• Call centers
• Direct sales
• Partners
18
Oracle SCM Cloud Chapter 1
Implementing Order Management Hello
Use work areas in supply chain management to set up and capture your item.
Use work areas to orchestrate order fulfillment across sources, such as suppliers, finance, and distribution centers.
Get Details
What Where
Use these books. Go to Oracle Supply Chain Management Cloud on Oracle Help Center at https://
docs.oracle.com/en/cloud/saas/supply-chain-management/18b/index.html.
• Implementing Order
Management
• Using Order Management
• Administering Pricing
• Tables and Views for Oracle
Supply Chain Management
Cloud
• REST API for Oracle Supply
Chain Management Cloud
Technical details not covered in books Search for Document ID 2051639.1 (White Papers for Order Management Cloud) on My Oracle
Support at https: //supportoracle.com
What's New in each release and Oracle Cloud Release Readiness at https://cloud.oracle.com/saasreadiness/scm
release content documents
19
Oracle SCM Cloud Chapter 1
Implementing Order Management Hello
Order Management can work with your fulfillment system in different fulfillment flows.
Note.
Flow Value
Back-to-back Global Order Promising reserves supply against each sales order until you ship it.
Drop shipment Your supplier ships the sales order directly to your customer, bypassing your factory,
warehouse, and distribution system. The shipper for a drop shipment that occurs outside of
your organization is usually a 3rd party supplier. The shipper for a drop shipment that occurs
inside of your organization is another business unit.
20
Oracle SCM Cloud Chapter 1
Implementing Order Management Hello
Flow Value
Internal material transfer Transfer an item between two different parts of the same organization. For example,
transfer the AS54888 desktop computer from the Vision Incorporated factory to the Vision
Incorporated warehouse. Global Order Promising can promise an internal material transfer and
prioritize supply across internal orders and external orders.
Related Topics
• How Orchestration Processes Back-to-Back Flows
• Overview of Drop Ship in Order Management
• How Orchestration Processes Internal Material Transfers
Details
How Order-to-Cash Works in Order Management
Use Order Management Cloud to order and fulfill an item, such as a printer, a configured item, such as a desktop
computer, or a service, such as monthly maintenance for a network of desktop computers.
21
Oracle SCM Cloud Chapter 1
Implementing Order Management Hello
Here's how Order Management fulfills a sales order when the user creates it in the Order Management work area.
Note.
1. A user, such as the Order Entry Specialist, clicks Create Order in the Order Management work area to create a
new sales order.
◦ The user searches the Customer attribute on the order header. Order Management gets details about the
customer from the party object in Trading Community Architecture. For details, see the Guidelines for
Controlling Customer Details in Order Management topic.
◦ Order Management communicates with Pricing Administration to get pricing details that apply to the
entire order, such as the pricing strategy and pricing segment. The strategy depends on the value that
22
Oracle SCM Cloud Chapter 1
Implementing Order Management Hello
you set in the Customer attribute. For details, see the How Profiles, Segments, and Strategies Work
Together topic.
◦ The user searches for an item on the catalog line of the sales order. Order Management gets details
about the item from the Product Information Management work area. You use the Product Information
Management work area to set up and manage details about the item.
Order Management also communicates with the Pricing Administration work area to price the line. For
details, see the How Pricing Prices Sales Orders topic.
◦ The user clicks Add to move the line to the order line area, then clicks Submit.
◦Order Management validates the order, converts order lines to fulfillment lines, then an assignment rule
identifies the orchestration process that Order Management runs to fulfill each fulfillment line. You can
set up this rule. For details, see the Assign Orchestration Processes topic.
2. An orchestration process contains steps that fulfill the order. Examples of steps include schedule, reserve, ship,
invoice, and so on.
The steps vary so they optimize order fulfillment according to the needs of each order. The orchestration
process determines process logic, such as statuses to use for the order, how to do forward planning and
backward planning, how to compensate for change to the order, and so on.
◦ References data in Product Information Management to determine how to orchestrate the order
according to the item. You can specify this data. For details, see the Get Data from Product Information
Management topic.
◦ References Supply Chain Planning to cross-reference and validate data.
You can set up data collection parameters, enable data for collections, and so on. For details, see the
Quick Start to Implementing Order-to-Cash topic.
◦ Uses business rules to orchestrate each order. You can set up a variety of rules.
For example, set up a rule that uses a different lead time depending on whether the inventory
organization resides in Denver or San Francisco, or a rule that makes sure Order Management doesn't
attempt to ship a nonshippable item, such as a video that your customers can only stream from the cloud.
For details, see the Overview of Using Business Rules With Order Management topic.
23
Oracle SCM Cloud Chapter 1
Implementing Order Management Hello
3. To orchestrate fulfillment, each orchestration process step calls a service that does a fulfillment task.
For example.
◦ The Create Scheduling service communicates with Order Promising. Order Promising determines
availability and promises the order.
• Cross-references items before it sends the fulfillment request to your fulfillment system.
• Gets supply and demand data from Supply Chain Planning Cloud to determine availability in the
supply chain, such as inventory levels in warehouses.
• Schedules the best fulfillment options for each fulfillment line. Your users can also manually use
the Order Management work area to choose some options.
24
Oracle SCM Cloud Chapter 1
Implementing Order Management Hello
Most predefined orchestration processes include a scheduling step that calls Order Promising. You
can also set up an orchestration process that doesn't include a scheduling step and that doesn't use
Order Promising. For example, if your organization sells downloadable literature that doesn't require a
warehouse or shipping.
◦ Task services interpret replies and updates from fulfillment systems, such as Inventory Management. For
example, the orchestration process calls.
• The Create Inventory Reservation service to reserve inventory for your item, then waits until
Inventory Management sends confirmation that it reserved inventory.
• The Create Shipping service to create a shipment, and Wait for Shipment to wait for confirmation
from Inventory Management that the carrier successfully delivered the item.
• The Create Billing Lines service and the Wait for Billing service to call Receivables and finish the
order-to-cash process. It makes sure you get paid.
For details about how to use task services, see the Task Types topic.
You use the Setup and Maintenance work area to set up an orchestration process.
4. The External interface communicates order details between Order Management and the fulfillment system. It
primarily routes the fulfillment request and converts data so the fulfillment system can correctly use the data.
You can also use the external interface to send a request to your fulfillment system that resides outside of
Oracle Fusion to fulfill the order. The external system processes the request and sends completion updates
through the external interface so the orchestration process can move to the next step. For details, see the
Integrate chapter in the Implementing Order Management book.
5. Here's what happens during fulfillment.
◦ Inventory Management manages logistics and inventory for the order, including schedule, reserve,
receive, and ship each item.
◦ Receivables processes billing details, including one-time charges and recurring charges, then sends them
to Oracle Financials Cloud.
◦ Oracle Financials Cloud does financial transactions for the order. It creates an invoice, manages accounts
receivable, processes payments, and manages revenue.
The fulfillment system communicates updates through the external interface to task services throughout
fulfillment.
Note.
• This topic describes one way to fulfill orders. You can set up Order Management to do fulfillment differently,
according to your unique fulfillment environment.
• You can import orders into Order Management from an upstream order capture system. For details, see the
Overview of Importing Orders into Order Management topic.
• For details about other fulfillment flows, such as drop ship, back-to-back shipping, or internal transfer, see
Oracle SCM Cloud, Implementing Manufacturing and Supply Chain Materials Management. For illustrations of
these flows, see the articles on My Oracle Support.
◦ Order to Cash - Standard Pick from Stock Order Flow (Doc ID 2239712.1)
◦ Order to Cash - Back to Back (B2B) - Buy Flow (Doc ID 2276547.1)
◦ Order to Cash - Back to Back (B2B) - Make Flow (Doc ID 2275403.1)
◦ Order to Cash - Back to Back (B2B) - Transfer Flow (Doc ID 2273369.1)
25
Oracle SCM Cloud Chapter 1
Implementing Order Management Hello
Related Topics
• Overview of Drop Ship in Order Management
• Orchestration Processes
Note.
1. Capture orders. A source system that resides outside of Order Management sends a source order to Order
Management.
The terminals and databases in step 1 in the diagram represent different channels that your deployment can
use as source systems. For example, a legacy system, or some other channel.
26
Oracle SCM Cloud Chapter 1
Implementing Order Management Hello
The flow for a sales order that the Order Entry Specialist creates in the Order Management work area is similar,
except it typically starts with orchestration at step 3.
2. Transform orders. Transformation rules separate the source order into a hierarchy that Order Management can
use and process.
Transformation finishes, then assignment rules assign an orchestration process to the sales order.
3. Orchestrate orders. One or more orchestration processes contain steps that do fulfillment tasks. Each
fulfillment request starts here.
4. Do tasks. Task services send a request to the fulfillment system to run the fulfillment task, such as ship the
item or invoice the item. A system that resides outside of Order Management can also send a request to a task
service.
5. Integrate. Here's what the external interface does.
◦ Cross-references data that the request contains.
◦ Uses routing rules to identify the fulfillment system to use to fulfill each fulfillment line. For details about
these rules and how to create them, see the Route Requests from Order Management to Fulfillment
Systems topic.
◦ A connector sends the request to the fulfillment system.
6. Fulfill. The fulfillment system processes the request.
◦ The fulfillment system accepts the request then sends a reply.
◦ The external interface converts the reply from the fulfillment system.
◦ The task service processes the reply from the fulfillment system.
◦ The orchestration process runs the next orchestration process step.
External Interface
The external interface manages communication between Order Management and your fulfillment system.
• The fulfillment system doesn't communicate directly with the orchestration process. Instead, the external
interface provides an intermediary that Order Management uses to route requests.
• Order Management uses a web service to route each request from the task service to the fulfillment system,
and then from the fulfillment system to the task service.
• The connector modifies the structure and content of the outbound message so it matches the inbound
interface that the fulfillment system uses.
• You can set up each web service and routing rule, then register the connector web service. This set up
integrates the fulfillment system with the external interface.
Related Topics
• Task Services
27
Oracle SCM Cloud Chapter 1
Implementing Order Management Hello
• Manage Connector Details Between Order Management and Your Fulfillment System
• Integrate Order Management with Source Systems
28
Oracle SCM Cloud Chapter 1
Implementing Order Management Hello
Order Management uses the flow described in the How Order-to-Cash Works topic, but with these important
differences.
1. An order capture system that resides outside of Order Management captures a source order. For example, a
user might use your legacy application to enter a source order.
2. You set up a connector that the capture system can use to send the source order to Order Management. If
the source system and Order Management use different domain values, then the connector transforms the
structure and values from the domain that the source system uses to the domain that Order Management uses.
For details, see the Integrate Order Management with Source Systems topic.
3. Supply Chain Planning collects data about the source order, then uses it to create cross-references and planning
data.
Use a cross-reference help to manage the representation of data across systems. A cross-reference relates
business data between your order capture system, order fulfillment system, and Order Management. For
example, an item cross-reference can create a relationship between an item, such as Widget x, that resides in
your source system, and a representation of Widget x in Order Management.
You can cross-reference across warehouses, units of measure, carriers, currencies, shipping methods, payment
terms, accounting rules, invoicing rules, service levels, tax classification codes, and so on.
4. An orchestration process references business rules to transform each source order into a sales order that Order
Management can understand and fulfill.
5. Order Promising gets item details from Product Information Management, customer details from Trading
Community Architecture, and planning data from Supply Chain Planning to promise the sales order.
6. Order Management uses the order-to-cash flow to continue processing.
Note.
• Order Management updates the order status, fulfillment line status, and invoice status during the flow, and
communicates each update to your order capture system.
• Order Management can use an order capture service to communicate updates to the source system. To receive
these updates, the source system must subscribe to the events. If Order Management receives an update from
the source system, then it replans the orchestration process. It replans every time it receives an update.
• Here's the attributes that Order Management uses to calculate the planned dates for each step and task,
starting with the first step it does in chronological order.
• Order Management doesn't do the same amount of transformation for a sales order that a user creates in the
Order Management work area because these orders already include the data and use the structure that Order
Management requires.
• A single source order might contain order lines that include one-time charges, and other order lines that
include recurring charges. If Order Management receives a source order that includes a recurring charge, then
Oracle Receivables creates a recurring billing invoice for these lines.
• Order import typically uses the same flow that this topic describes, except you import source orders from a
spreadsheet or through a web service.
Related Topics
• Import Orders into Order Management
29
Oracle SCM Cloud Chapter 1
Implementing Order Management Hello
30
Oracle SCM Cloud Chapter 2
Implementing Order Management Implement Business Process Flows
Order-to-Cash
Roadmap for Setting Up Order-to-Cash
Use this road map as the high-level procedure you use to implement order-to-cash.
• Do the tasks that this topic references in the same sequence that the topic displays them.
• Steps after step 3 primarily reference tasks in the Orders functional area. Do each of these tasks depending on
your business requirements.
• To do a task, click each one in the Orders area. If the Orders area doesn't display a task, then search for it in the
Search Tasks field.
• The set up you do depends on your business requirements. You typically do most or all of the tasks that
integrate Order Management. Other tasks depend on your requirements, such as tasks that control order
status, constrain changes, or modify an orchestration process.
• The Topic column references topics in Oracle SCM Cloud, Implementing Order Management. Use these topics
to get help with the task.
• The Prepare column describes what you do to prepare for implementation. Do this set up before you administer
order-to-cash. It will help to avoid interruption and downtime during administration. Use the Prepare column to
check off preparation work as you finish it.
• To monitor progress, add a check mark to the Done column when you finish each functional area or task.
• To implement drop ship, see the Implement Drop Ship section in the Implementing Order Management book.
Implement order-to-cash.
1. Read the Guidelines for Implementing Order-to-Cash topic. It contains details that help to make the
implementation go smoothly.
2. In the Navigator, click Setup and Maintenance.
3. On the Setup page, click Order Management.
This topic assumes you will modify the predefined implementation that's available through Setup. For details
about setting up a new implementation, see Points to Consider When Implementing Order-to-Cash.
4. Set up these functional areas.
31
Oracle SCM Cloud Chapter 2
Implementing Order Management Implement Business Process Flows
Items _____
Catalogs _____
Customers _____
These areas reference common tasks. A typical implementation requires that you complete most or all common
tasks. For details about how to set them up, see the book titled Oracle SCM Cloud, Implementing Common
Features for Oracle SCM Cloud.
5. In the Functional Areas list, click Orders.
6. In the Orders area, click Required Tasks > All Tasks
7. Integrate Order Management. For details, see the Integrate chapter in the Implementing Order Management
book.
Manage Web Service Details Create User Credential Keys _____Gained access to the administrator
privilege and administrator role so we can
use Oracle Wallet Manager.
Manage Trading Community Source Integrate Order Management with Source _____Located the time zone where the
Systems Systems server that the source system uses is
located.
Manage Trading Community Source Using Web Services to Integrate Order _____Identified source system details
Systems Management chapter, including Define
Your Source System, and Create Cross-
References in Order Management _____Identified role and privilege
requirements
Manage External Interface Web Service Integrate Order Management with _____Identified an integrated
Details Fulfillment Systems development environment we can use to
create a transformation style sheet.
32
Oracle SCM Cloud Chapter 2
Implementing Order Management Implement Business Process Flows
Manage External Interface Routing Rules Route Requests from Order Management _____Created a list that includes the
to Fulfillment Systems names of the items we must route
to fulfillment systems, the unique
identifier for each item, and the name
of each fulfillment system where Order
Management must route the request.
8. Control application behavior. For details, see the Application Behavior section in the Implementing Order
Management book.
Manage Order Management Parameters Manage Order Management Parameters _____ Determined whether our business
requirements will allow or disallow
the Configurator to choose items
in a configuration and to modify a
configuration after the user adds a
configured item.
33
Oracle SCM Cloud Chapter 2
Implementing Order Management Implement Business Process Flows
Manage Order Profiles Manage Order Profiles _____ Identified the value to use when
converting a currency.
9. Administer pricing. For details, see the book titled Oracle SCM Cloud, Administering Pricing.
10. Import source orders. If you use a source system, then you must import source orders. For details, see the
Import section in the Implementing Order Management guide.
Not applicable Import Orders into Order Management ____ Acquired access to our source order
data.
Create Source System Use Web Services to Import Source ____ Determined whether we will use the
Orders product model or the product hub.
34
Oracle SCM Cloud Chapter 2
Implementing Order Management Implement Business Process Flows
11. Transform source orders. If you use a source system, then you must transform source orders. For details, see
the Transform section in the Implementing Order Management book.
Manage Product Transformation Rules Set Up Transformation ____ Acquired user and password we
need to sign into the Product Information
Management work area.
Manage Product Transformation Rules Create Transformation Rules ____ Described the structure of the
source order data.
Manage Product Transformation Rules Create Advanced Product Transformation ____ Described requirements for
Rules advanced posttransformation rules, if
necessary.
12. Set up statuses. For details, see the Sales Order Status section in the Implementing Order Management book.
Manage Task Status Conditions Manage Task Status Conditions ____ Described our requirements
for managing the statuses that our
fulfillment systems provide.
Manage Status Values Set Up Fulfillment Lines Statuses ____ Described our requirements
for managing the statuses for each
fulfillment line.
Manage Orchestration Process Add Status Conditions to Fulfillment
Definitions Lines
Manage Status Values Create Orchestration Process Classes ____ Described our requirements for
grouping orchestration process statuses
so they're meaningful.
Manage Orchestration Process Add Status Conditions to Orchestration ____ Described our requirements
Definitions Processes that specify when to set statuses for
orchestration processes.
35
Oracle SCM Cloud Chapter 2
Implementing Order Management Implement Business Process Flows
13. Set up processing constraints. For details, see the Constrain Sales Orders section in the Implementing Order
Management book.
Manage Processing Constraints Manage Processing Constraints ____ Described requirements regarding
who can change a sales order, what can
change in the sales order, and when the
change can occur.
Manage Constraint Entities Constrain Changes to Attributes ____ Described requirements regarding
the order attributes that can change.
14. Control change orders. For details, see the Change Orders section in the Implementing Order Management
book.
Manage Order Attributes That Identify Manage Order Attributes That Identify ____ Described our requirements
Change Change regarding what changes Order
Management will allow on an existing
sales order, and when it allows the
change, including order attributes, users,
and timing.
Manage Orchestration Process Measure the Cost of Change ____ Estimated the business cost
Definitions associated with each change.
Manage Orchestration Process Compensate Sales Orders That Change ____ Described our requirements
Definitions regarding the order compensation we will
allow Order Management to do.
15. Notify systems when orders change. For details, see the Notify Systems section in the Implementing Order
Management book.
Manage Business Event Trigger Points Send Notifications from Order ____ Described our requirements
Management to External Systems regarding when Order Management must
notify external systems that a sales order
changed.
16. Use jeopardy to manage delays. For details, see Delays section in the Implementing Order Management book.
36
Oracle SCM Cloud Chapter 2
Implementing Order Management Implement Business Process Flows
Manage Jeopardy Priorities Set Up Jeopardy and Lead Time to ____ Described our requirements
Manage Delay regarding when Order Management
must notify an order manager that a
Manage Orchestration Process sales order is in jeopardy, including the
Definitions threshold when to notify for each step in
an orchestration process.
Manage Jeopardy Thresholds
____ Described requirements regarding
the amount of lead time that Order
Management must use to finish each
orchestration process step.
17. Manage task types. For details, see the Task Types section in the Implementing Order Management book.
Manage Task Types Set Up Task Types ____ Described our requirements
regarding setting up task types.
18. Set up flexfields. For details, see the Flexfields section in the Implementing Order Management book.
Manage Order Extensible Flexfields Deploy Extensible Flexfields in Order ____ Described our requirements
Management regarding what details we must display in
fields, including the data and location in
the user interface.
19. Set up orchestration processes. For details, see the Orchestration Processes chapter in the Implementing Order
Management book.
Manage Orchestration Process Guidelines for Setting Up Orchestration ____ Confirmed that the predefined
Definitions Processes orchestration processes don't meet our
requirements.
Manage Orchestration Process Set Up Orchestration Processes ____ Described the IF/THEN rules that we
Definitions need for each orchestration process.
37
Oracle SCM Cloud Chapter 2
Implementing Order Management Implement Business Process Flows
Manage Orchestration Process Set Up Lead-Times for Orchestration ____ Described the IF/THEN rules and
Definitions Process Steps conditions that determine the lead-time
to use for each orchestration process
step.
Manage Orchestration Process Select the Fulfillment Lines That Run for ____ Described the IF/THEN rules that
Definitions Orchestration Process Steps select the fulfillment line to run for each
orchestration process step.
Manage Orchestration Process Add Branches to Orchestration Processes ____ Specified subprocesses and
Definitions parallel processing that our orchestration
process requires.
Manage Orchestration Process Pause Orchestration Processes ____ Specified the IF/Then rules that
Definitions Order Management must use when
it pauses each of our orchestration
processes and each orchestration
process step.
Manage Orchestration Process Assign Orchestration Processes ____ Specified the IF/Then rules that
Assignment Rules Order Management must use when
it assigns each of our orchestration
processes and each orchestration
process step.
Not applicable Automatically Resume Paused ____ Identified the pause tasks we will
Orchestration Processes release to resume a paused orchestration
process.
Related Topics
• Overview of Order Management Cloud
38
Oracle SCM Cloud Chapter 2
Implementing Order Management Implement Business Process Flows
Create a rough estimate of the amount of effort your set up will require. A predefined feature usually needs less set up
than a feature that isn't predefined. For example, if you need the configurator and order import, then include the setup
effort for them in your project plans, and consider whether you must administer job roles to support them.
Dashboard Yes No
Configurator No Yes
Constraints No Yes
Notifications No Yes
Jeopardy No Yes
39
Oracle SCM Cloud Chapter 2
Implementing Order Management Implement Business Process Flows
Flexfield No Yes
Attachments No Yes
Order Management comes predefined with most setup tasks already done for you, but you can modify the predefined
offering.
40
Oracle SCM Cloud Chapter 2
Implementing Order Management Implement Business Process Flows
If you find that modifying the predefined offering doesn't meet your business requirements, then create a new
implementation.
Create a New Implementation Project
If the predefined offering doesn't meet your business requirements for some reason, then create a new implementation
project.
You can create one or more implementation projects for the offerings and options. Each Oracle application
creates the task list you must finish for each project you create. An Application Implementation Manager can
set up these task lists, and assign and track each task that these lists contain.
7. On the Implementation Project page, in the Task list, expand Order Management, then do the tasks that your
business flow requires.
Perform Data Load from Staging Tables You collect organization parameters from Collect Data section in the Quick Start for
your source system and load them into Setting Up Order-to-Cash topic
staging tables. You use Perform Data Load
from Staging Tables to process data in
these tables.
Refresh and Start the Order Promising Updates the Global Order Promising data. Set Up Global Order Promising section in
Server the Quick Start for Setting Up Order-to-
Cash topic
Load Interface File for Import Use these scheduled processes when you Import Orders into Order Management
import source orders.
Transfer Invoice Details to Supply Chain Send details about validated invoices, Specify Events That Indicate an Ownership
Financial Flow Orchestration canceled invoices, and corrected invoices Change
to Financial Orchestration.
41
Oracle SCM Cloud Chapter 2
Implementing Order Management Implement Business Process Flows
Update or Close Sales Orders Order Management might display sales Close Fulfillment Lines That Remain Open
orders and fulfillment lines as open even
if it closed all fulfillment lines that these
orders and lines reference. You can use
Update or Close Sales Orders to fix this
problem.
Generate Constraint Packages Constrain changes your users can make. Manage Processing Constraints
Publish Extensible Flexfield Attributes Publish and deploy an extensible flexfield. Deploy Extensible Flexfields in Order
Management
Plan Orchestration Processes Update an orchestration process plan Set Up Orchestration Processes
at regular intervals according to the
frequency that your deployment requires.
Release Pause Tasks Release a pause task so processing can Pause Orchestration Processes Until an
continue. Event Occurs
Generate Bucket Sets Automatically keep bucket sets up to date Use Decision Tables and Bucket Sets in
with reference data and transactional data. Business Rules
Import AutoInvoice Import and validate transaction data from AutoInvoice Import: How Data Is
Order Management or financial systems Processed
that reside outside of Oracle to create
invoices, debit memos, credit memos,
and account credits in Oracle Fusion
Receivables.
Here are a few more examples of predefined constraints that might affect your custom set up.
Constraint Description
Ordered Date Update Prevent updates to the Ordered Date attribute on the order header.
42
Oracle SCM Cloud Chapter 2
Implementing Order Management Implement Business Process Flows
Constraint Description
Fulfillment Line Bill-to Customer Prevent updates to the Bill-to Customer attribute on the fulfillment line.
Update
Payment Terms Are Missing Prevent submitting a fulfillment line when the line doesn't have payment terms.
There are many predefined constraints, but you can filter them to reduce the ones you must examine.
◦ On the order header before the user clicks Submit, set the filter for Constraint Entity to Order Header.
◦ On the order line before the user clicks Submit, set the filter for Constraint Entity to Order Line.
◦ After the user clicks Submit, set the filter for Constraint Entity to Order Fulfillment Line.
3. Refine the search results. Use Query by Example to filter the constrained operation. For example, if your set up.
◦ Updates the value of an attribute, set the filter for Constrained Operation to Update.
◦ Deletes something, set the filter for Constrained Operation to Delete.
4. Refine the search results. If you know the name of the attribute that your set up manipulates, use Query by
Example to filter for it. For example, if your set up updates the value of the Ship-to Customer on the fulfillment
line, then.
Assume you create an order management extension that updates the Bill-to Customer attribute on the
fulfillment line when the status is Awaiting Billing. At run time you encounter an error that prevents you from
updating the line. You decide to examine the constraints.
The Message attribute in the Details area describes that you can't update the Bill-to Customer because Order
Management already fulfilled the fulfillment line.
43
Oracle SCM Cloud Chapter 2
Implementing Order Management Implement Business Process Flows
For details about how to use the predefined set up, see the Guidelines for Setting Up Order-to-Cash topic.
1. Prepare.
2. Set up common components.
3. Set up item organizations and product models, and import items.
4. Connect source systems and set up customers.
5. Collect data.
6. Set up Global Order Promising.
7. Set up Order Management and Pricing, and test your set up.
Prepare
1. Consider the data you will use in your test environment.
For example.
As part of planning your test, create a list for each of these data, such as a list of items, list of customers, and so
on. You can then use these details later during set up.
2. Get the URLs, User IDs, and passwords you need to access Order Management Cloud and other applications,
such as the Security Console.
44
Oracle SCM Cloud Chapter 2
Implementing Order Management Implement Business Process Flows
User Description
Super user for Oracle Cloud The default user name is FAADMIN.
Applications
◦ Identify the items that the test orders will contain and the customers who will order them.
◦ Identify the item organizations that you will associate with these items.
◦ Identify the units of measure (UOMs) and currencies that these test orders will use.
See the Overview of Security Console topic to get a list of tasks you might need to do.
Here are the tasks you can do in the Setup and Maintenance work area after you acquire the super user.
A large task list displays when you create the list for the Order Management offering. Make sure you do step 5,
Set Up Enterprise Structures. Also do step 3, Set up Item Organizations, through step 10, Set up Pricing, then
create or import orders.
4. Set up implementation users.
For details, see the Set Up User Roles and Privileges in Order Management topic.
5. Set up the enterprise structure.
45
Oracle SCM Cloud Chapter 2
Implementing Order Management Implement Business Process Flows
◦A set is a collection of business units. Order Management uses sets to restrict access to holds and
orchestration processes. You must specify a default set when you create a business unit. You can use the
predefined Common Set for the default set.
6. Set up users who will do functional testing.
An implementation user can access a wide range of privileges. To test with users who have fewer privileges, set
up users with roles that are specific to Order Management.
Role Name
Examine how these roles implement security. Create at least one user for each of these roles.
The Supply Chain Application Administrator role provides the Order Administrator role.
For details about job roles, see the Job Roles in Order Management topic.
• You need at least one organization that represents a warehouse where your implementation can
collect the supply data it uses to fulfill each order.
• You must set up each warehouse from a fulfillment system as an item organization in Oracle.
• You must not associate an item organization with a business unit.
46
Oracle SCM Cloud Chapter 2
Implementing Order Management Implement Business Process Flows
◦ The Import and Transform chapter in the Implementing Order Management book.
◦ The Item Imports topic.
◦ The Define Product Information Management section in the Using Product Master Data Management
book.
◦ You plan to use a source system. For details, see the Integrate Order Management with Source Systems
topic.
◦ You plan to import customer data from a source system.
◦ You plan to use cross-references. For details, see the Cross-References in Order Management topic.
If you will use only the Order Management work area to create sales orders, then you don't need to set up a
source system.
2. Optional. Import customers.
47
Oracle SCM Cloud Chapter 2
Implementing Order Management Implement Business Process Flows
You can use this import process to import a batch from the interface tables into Trading Community
Architecture. The batch you import must include the customers your orders will reference. For details, see
topics Defining the Import Process for Customers and Consumers: Points to Consider, and Defining the Import
Process for Customers and Consumers: Worked Example.
Get Customer Details when Not Integrating or Importing
If you don't integrate with a source system or fulfillment system, or if you don't import customers, then create
customers in one of these ways.
• Offering: Financials
• Functional Area: Customers
• Task: Create Customer
For details, click the help icon on the Create Organization Customer page. Also, see the user book for
Oracle Trading Community Architecture.
• Synchronize them in Trading Community Architecture. If the customer and customer entities that Order
Management needs to fulfill the sales order don't exist, then Trading Community Architecture synchronizes the
customer master with customer details from the sales order. Important details include sold-to party, ship-to
party, and bill-to account.
48
Oracle SCM Cloud Chapter 2
Implementing Order Management Implement Business Process Flows
Task Description
• Display Currency
• Currency Conversion Type
For details, see the Use Order Profiles to Control Order Management Behavior topic.
Manage Orchestration Process Set up and deploy these predefined orchestration processes.
Definitions
• ShipOrderGenericProcess
• ReturnOrderGenericProcess
For a complete list of tasks, see the Roadmap to Setting Up Order-to-Cash topic.
3. Deploy the required processing constraints.
Attribute Value
The validation rule sets in this constraint prevent Order Management from attempting to update the
validation for each shipping request when certain conditions are true.
Ordered Quantity Isn't Zero The ordered quantity on the fulfillment line isn't zero. If its zero, then the line is in
Canceled status and we don't want to process it.
Update Shipping Request Data validation doesn't fail for the Update Shipping fulfillment service because the flow
Validation doesn't provide values for all the required attributes.
49
Oracle SCM Cloud Chapter 2
Implementing Order Management Implement Business Process Flows
Fulfillment Organization ID Is Null The Warehouse attribute on the fulfillment line contains a value. Order Management
uses the Warehouse attribute to populate the fulfillment organization ID.
Fulfill Line Request Dates are Null The requested ship date or the requested arrival date on the fulfillment line contains
a value. We can't calculate shipping dates if we don't have a value in one of these
attributes.
Scheduled Ship Date on the The scheduled ship date on the fulfillment line contains a value. We can't calculate
Fulfillment Line Is Empty shipping dates if we don't have a value in this attribute.
◦ Enable or add other constraints to meet your needs, as necessary. For details, see the Manage Processing
Constraints topic.
◦ Click Generate Packages.
This action deploys all enabled constraints into your implementation.
4. Optional. Set up the orchestration that your test environment requires.
For details, see the chapters that describe controlling order processing and setting up orchestration processes
in the Implementing Order Management book.
5. Set up pricing.
If you use Order Management to create sales orders, and don't import them or integrate to a source system that
contains price details, then you must set up pricing. Order Management requires details about pricing entities,
such as the pricing strategy, to determine price for each item that you add to the sales order.
You can't submit a sales order in Order Management without the price. For details about how to set up pricing,
see the Oracle SCM Cloud, Administering Pricing book.
In addition, it might be necessary to do this.
◦ Use a tool of your choice, such as SOAP (Simple Object Access Protocol), to simulate sending a test order.
Note the order number.
◦ In the Order Management work area, use the order number to search for the order.
◦ Confirm that Order Management received the order and is processing it.
50
Oracle SCM Cloud Chapter 2
Implementing Order Management Implement Business Process Flows
Feature Description
Drop Ship The set up for drop ship depends on your business requirements. For details, see the Drop
Ship section in the Implementing Order Management book.
Internal Material Transfer Internal Material Transfers comes predefined as available. The predefined job roles include this
feature. No setup is required except that an option in Supply Chain Orchestration determines
whether inventory routes the transfer order to Order Management. For details, see Supply
Chain Orchestration: Overview.
Back-to-Back Shipping Back-to-back shipping can create supply only after Order Management successfully submits
the sales order to order fulfillment. Back-to-back shipping can then create supply in these
ways.
The fulfillment warehouse receives the supply, then back-to-back shipping ships it to the
customer.
Configure to Order Use Configure to Order to efficiently fulfill each configured item. Here are the order
management parameters you can set to control the configurator.
You can also use Configure to Order to set up a kit. A kit is a configured item that includes one
or more configure options, but the Order Management work area doesn't allow the Order Entry
Specialist to modify the configure options of a kit.
• You set the subtype for a kit to KIT-SMC when you set up the configuration model.
• Order Management sends the shippable lines of a kit as a shipment set to Global Order
Promising.
• The Order Management work area doesn't display values for On Hand and Item
Availability for kits because Global Order Promising doesn't support the quick availability
check feature for kits.
51
Oracle SCM Cloud Chapter 2
Implementing Order Management Implement Business Process Flows
Feature Description
Integrate Order Management with You use a file or web service to import source orders from a source system. For details, see
Upstream Source Systems these sections in the Implementing Order Management book.
• Import
• Web Services
• Upstream Source Systems
Integrate Order Management with Use a web service to allow Order Management to communicate with a fulfillment system. Use
Downstream Fulfillment Systems a predefined web service or create a new one. For details, see the Downstream Fulfillment
Systems section of the Implementing Order Management book.
Related Topics
• How the Order Orchestration and Order Promising Processes Use the Collected Planning Data
• Overview of Security Console
• How Units of Measure, Unit of Measure Classes, and Base Units of Measure Relate to Each Other
Orders Do a wide variety of set up tasks for Order Management, from managing how you import your
source orders, transforming source orders, integration, application behavior, business rules,
orchestration, and so on.
Pricing Set up pricing for Order Management. For example, define pricing parameters, totals,
elements, bases, messages, matrix types, lookups, and so on.
To get the complete list of functional areas and features, use the Associated Features report when you plan your
implementation.
52
Oracle SCM Cloud Chapter 2
Implementing Order Management Implement Business Process Flows
Upgrade or Update
To upgrade or update your release, go to Performing Your Quarterly Update (Doc ID 2337485.1) on My Oracle Support to
get important details.
Related Topics
• Plan Your Implementation
• Overview of Functional Setup Manager
Business-to-Business Messaging
Overview of Business-to-Business Messaging in Order
Management
Use Order Management Cloud as your central location when you interact with more than one channel.
Improve order capture and order fulfillment in the order-to-cash flow when you communicate a sales order between
businesses.
The business-to-business flow uses Collaboration Messaging Framework to automate message flow so Order
Management can receive and process each source order from a trading partner, then reply with an advance shipment
notice after shipping successfully finishes.
Web services use Open Applications Group Integration Specification (OAGIS) messages in the payload that it uses to
handle interactions that occur between Oracle Cloud Applications and each trading partner. You can use your existing
Electronic Data Interchange (EDI) infrastructure with OAGIS. Use this configuration to receive each source order, then
your trading partner and supplier can process it through order fulfillment.
If a delay in supply occurs, then Supply Orchestration might send an update for the scheduled ship date to Order
Management. Order Management updates the scheduled ship date but doesn't update the scheduled arrival date on the
fulfillment line.
53
Oracle SCM Cloud Chapter 2
Implementing Order Management Implement Business Process Flows
Order Management updates the scheduled ship date, scheduled arrival date, and shipping method only if you set up
Global Order Promising to calculate shipping, such as how to calculate transit time. If you don't set it up, the scheduled
dates and shipping method might not contain a value.
This behavior affects fulfillment, including choices that your end-users make when they override the schedule. For
details, see the Schedule Fulfillment Lines Manually topic.
54
Oracle SCM Cloud Chapter 2
Implementing Order Management Implement Business Process Flows
55
Oracle SCM Cloud Chapter 2
Implementing Order Management Implement Business Process Flows
Note.
1. A trading partner uses a web service endpoint that they set up and enabled on their server to send an XML
document that contains source orders to the CollaborationMessage web service on Collaboration Messaging
Framework.
2. Collaboration Messaging Framework converts each source order to a CSV format (comma separated value) that
Order Management supports.
3. Collaboration Messaging Framework uses a web service to upload the CSV files to a folder in Oracle WebCenter
Content.
4. You use the order import template and a scheduled process to convert CSV files into sales orders.
5. Collaboration Messaging Framework subscribes to a business event that the scheduled process raises when it
finishes. Order Management recognizes the event, then sends an order acknowledgment in an OAGIS message
(Open Applications Group Integration Specification) through Collaboration Messaging Framework to the
trading partner.
6. Order Management processes the sales order, then sends it to shipping for order fulfillment.
7. Oracle Fusion Shipping creates and processes the shipment.
8. Shipping finishes delivery, then sends the ship confirm and advance shipment notice in an OAGIS message,
through Collaboration Messaging Framework, then in a reply to the trading partner.
OAGIS_10.1_ACK_PO_COLLAB_MSG_OUT Send acknowledgment to the trading partner that Collaboration Messaging received the
purchase order.
OAGIS_10.1_ACK_CHANGE_PO_COLLAB_MSG_OUT
Send acknowledgment to the trading partner that Collaboration Messaging received the
purchase order change.
OAGIS_10.1_PROCESS_SHIPMENT_COLLAB_MSG_OUT
Send details to the trading partner about shipments.
OAGIS_10.1_PROCESS_RCV_DEL_COLLAB_MSG_OUT
Send details to the trading partner about purchase order deletions.
Here are the types of messages that Collaboration Messaging can receive from the trading partner.
OAGIS_10.1_PROCESS_PO_COLLAB_MSG_IN
Process purchase orders.
56
Oracle SCM Cloud Chapter 2
Implementing Order Management Implement Business Process Flows
• Allow Computer Service and Rentals to receive sales orders, updates, and cancellations from Computer
Associates
• Allow Computer Service and Rentals to send acknowledgments and shipments to Computer Associates
Use Manage Trading Partners to communicate with a trading partner directly or through a service provider. For
example, communicate through a service provider to set up a solution where the trading partner must use EDI
(Electronic Data Interchange), a modified XML format, a proprietary format, and so on.
In this example, you set up the configuration to communicate directly with the trading partner.
5. In the Create Trading Partner dialog, set values, then click Save and Close.
Attribute Value
57
Oracle SCM Cloud Chapter 2
Implementing Order Management Implement Business Process Flows
Attribute Value
Computer Service and Rentals will communicate directly with Computer Associates instead
of going through a service provider, so set this attribute to None.
In the Delivery Methods tab, click Actions > Add Row, set values, then click Save and Close.
Attribute Value
Name CMKDelivery00
Not applicable This integration uses the Process method of the CollaborationMessage web service. Make
sure the trading partner already deployed this web service on their server.
Endpoint Enter the URL that locates the server and port that the trading partner uses at their location
as the end point for their web services.
For example.
http://ComputerAssociates.com:7012
User Name Enter the user name that the trading partner server requires to access the endpoint.
Password Enter the password that the trading partner server requires to access the endpoint.
7. Set up the messages that Collaboration Messaging sends to the trading partner.
58
Oracle SCM Cloud Chapter 2
Implementing Order Management Implement Business Process Flows
CMKORDERACK001 OAGIS_10.1_ACK_PO_COLLAB_MSG_OUT
CMKORDERACK002 OAGIS_10.1_ACK_CHANGE_PO_COLLAB_MSG_OUT
CMKSHIPCONFIRM001 OAGIS_10.1_PROCESS_SHIPMENT_COLLAB_MSG_OUT
Note.
CMKORDERIN001 OAGIS_10.1_CANCEL_PO_COLLAB_MSG_IN
CMKORDERIN002 OAGIS_10.1_CHANGE_PO_COLLAB_MSG_IN
CMKORDERIN003 OAGIS_10.1_PROCESS_PO_COLLAB_MSG_IN
59
Oracle SCM Cloud Chapter 2
Implementing Order Management Implement Business Process Flows
Attribute Value
Note that you specified this ID earlier in this topic when you identified the trading partner.
Order Processing Business Unit Specify the business unit that processes each sales order that Order Management Cloud
receives. For this example, Computer Service and Rentals resides in the Vision Operations
business unit, so choose Vision Operations.
5. In the Collaboration Documents for Service Provider area, add these documents.
◦ PROCESS_PO_IN
◦ CHANGE_PO_IN
◦ CANCEL_PO_IN
◦ ACKNOWLEDGE_PO_OUT
◦ ACKNOWLEDGE_CHANGE_PO_OUT
◦ PROCESS_SHIPMENT_OUT
Note.
◦ You use this area to specify the documents that this customer will communicate with the trading partner.
◦ Set the Association Status to Enabled for each document.
6. Click Save and Close, then click Done.
The customer can now communicate with the trading partner.
Attribute Value
Not applicable You will be testing a flow that sends a new source order from the trading partner, Computer
Associates, so you use the Partner ID that you specified earlier in this topic.
60
Oracle SCM Cloud Chapter 2
Implementing Order Management Implement Business Process Flows
Attribute Value
External Message ID Enter the number that identifies the message you're testing, such as 08192016_001.
Notice that the Message Payload area uses the settings that you specified in step 2 to create, then display the
XML that this test will use to communicate the message. You can modify the XML, if necessary.
4. Click Process.
A separate web service in Collaboration Messaging simulates communication from the trading partner. It
receives the XML document, validates it, then displays a Processing Confirmation dialog that includes the XML
result of the test. If the test is successful, then the XML will include this code.
<ProcessingResultCode><Success>/<ProcessingResultCode>
5. Make a note of the line that includes the message ID, such as.
<BODID>IN_8001</BODID>
1. Use a scheduled process to import the source orders. For details, see the Import Orders into Order Management
topic.
◦ When you run the Load Interface File for Import scheduled process, set the Data File to the file that
Messaging Framework created when you simulated collaboration messaging. The data file will include a
concatenation of the document name plus the message ID. For example.
PROCESS_PO_IN-1.0-IN_8001
◦ Set the Source System to ORA_ELECTRONIC_DOCUMENTS when you run the Import Sales Order
scheduled process. Order Management uses this predefined source system for each source order it
receives from the trading partner.
◦ As an option, in the Batch Name parameter, specify the unique ID of the message you received, such as
08192016_001.
◦ Order Management uses the setup from the Pricing work area to determine pricing. It will ignore any
pricing data that the source order contains.
◦ When the Import Sales Order scheduled process finishes, Order Management can process the sales
orders through order fulfillment.
2. In the Order Management work area, on the Overview page, search for the simulated order, such as
Demo_Order.
61
Oracle SCM Cloud Chapter 2
Implementing Order Management Implement Business Process Flows
3. In the search results, note that the value in the Source Order attribute includes the order number you simulated,
such as Demo_Order_0819_001.
4. In the Order column, click the order number.
5. On the Order page, notice that the order status is Processing, and the fulfillment line status is Awaiting
Shipping, which indicates that Order Management released the sales order to order fulfillment.
The messaging framework creates an acknowledgment message, then publishes it to the trading partner.
Attribute Value
Document PROCESS_PO_IN
3. In the Messages area, in the External Message ID column, click the row that references the message you
simulated earlier, such as 08192016_001.
4. Click Actions, then click a menu item.
View Source Document View the input XML that Collaboration Messaging received from the trading partner.
View Output Document View the output XML that Collaboration Messaging converted from the input XML, and then
sent to Order Management.
5. Click Done.
6. Click Tasks > Manage Collaboration Messaging History.
7. Examine the results of the acknowledgment.
In the Search area, set the value, then click Search.
62
Oracle SCM Cloud Chapter 2
Implementing Order Management Implement Business Process Flows
Attribute Value
Document ACKNOWLEDGE_PO_OUT
Attribute Value
Document PROCESS_SHIPMENT_OUT
Related Topics
• Import Orders into Order Management
Various Setups
Security
Job Roles and Duty Roles That You Use to Implement Order Management
A duty role allows Order Management Cloud to access the web services that it uses to communicate with an external
system according to the user currently signed in. You must make sure the job roles that you create can reference the
duty roles that Order Management requires.
• A job role is the sign in that allows each user to access the application features that the user needs to do their
job in their organization, and to access the data that these features reference. Here are some example job roles
that you use in Order Management.
• A duty role is a group of functions and data privileges that represent one duty of a job. Each duty role is specific
to an application.
Assume one of your users releases a sales order for shipping. The job role that this user uses must reference the duty
roles that allow Order Management to call the shipping system and to receive details about the shipment from the
shipping system. In this example, you must assign a job role that references duty roles.
• Shipment Request Processing Web Service Duty
• Orchestration Order Shipping Web Service Duty
63
Oracle SCM Cloud Chapter 2
Implementing Order Management Implement Business Process Flows
• Create new sales orders, update existing sales orders, and create return sales order.
Order Entry Specialist
• Create sales orders in the Order Management work area or modify sales orders that you
import from a source system.
• Monitor order fulfillment.
• Work directly with customers who purchase items.
• Manage sales orders that you create in the Order Management work area or that you
Order Manager import from a source system. Makes sure Order Management books sales orders so
they can proceed to order fulfillment.
• Approve sales orders that require approval.
• Work with other professionals in your organization, such as pricing administrator,
customer contract manager, credit manager, and accounts receivable manager, to help
determine set up requirements and troubleshoot problems.
• Set up and maintain Order Management Cloud so it supports order entry and order
Order Administrator fulfillment.
• Set up rules, policies, constraints, and so on. For example, set up defaulting rules, order
Supply Chain Application entry preferences, order entry privileges, orchestration processes, change order rules,
Administrator process planning, jeopardy conditions, order statuses, and hold definitions.
• Set up orchestration.
Duty Roles
Duty roles allow Order Management to communicate with a system that resides outside of Order Management Cloud.
The Description column describes the communication that the web service provides.
64
Oracle SCM Cloud Chapter 2
Implementing Order Management Implement Business Process Flows
Order Orchestration Decomposition Communicate with source systems so Order Management can separate source orders during
Web Service Duty transformation.
Orchestration Order Activity Communicate with a fulfillment system that can process an activity.
Management Web Service Duty
Orchestration Order Billing Web Communicate with a system that processes the billing for each sales order.
Service Duty
Orchestration Order External Allow a system that resides outside of Order Management Cloud to call Order Management
Integration Web Service Duty Cloud.
Orchestration Order Fulfillment Web Allow a fulfillment system to send status updates to Order Management through a task service.
Service Duty
Orchestration Order Inquiry Web Extract order details from a sales order.
Service Duty
Orchestration Order Template Web Allow a fulfillment system to send status updates for fulfillment tasks through a task service.
Service Duty
Here are some of the roles that you might need, depending on your set up requirements. If your organization's security
goals prevent you from accessing these work areas, then you might need to work with other individuals in your
organization who can access them.
Work Area That You Need to Access Job Role That Allows You to Access It Where to Get Details on Oracle Help
Center
65
Oracle SCM Cloud Chapter 2
Implementing Order Management Implement Business Process Flows
Work Area That You Need to Access Job Role That Allows You to Access It Where to Get Details on Oracle Help
Center
Financials offering in the Setup and Financial Application Administrator Security Reference for Oracle Financials
Maintenance work area. For example, to Cloud
integrate Order Management with Oracle
Receivables.
Accounts Receivable Accounts Receivable Manager Security Reference for Oracle Financials
Cloud
Integrate Social Objects from Order Use the Order Manager or the Order Orchestration error recovery role.
Management Into Oracle Social
Network
For details, see the Integrate Order Management with Global Trade Management topic.
• Uses authentication through a user name and password during sign in to allow each user to access the Order
Management work area
66
Oracle SCM Cloud Chapter 2
Implementing Order Management Implement Business Process Flows
• Uses authorization through user roles and privileges to allow each user to do different tasks according to job
outcome in the Order Management work area
This topic describes how to examine privileges and job roles that come predefined to use with Order Management, and
how to add an Order Management user. For background details, see the books on Oracle Help Center.
Book Details
Securing Oracle SCM Cloud Job roles, privileges, duty roles, and how to set up security, including values you set for each
user.
Security Reference for Order Job roles that come predefined to use with Order Management.
Management
Here are some examples of roles you might need to set up.
Role Description
Pricing Administrator- All Use this role to administer pricing. Add it when you do the Set up Pricing task.
Business Units, which is
QP_PRICING_ADMINISTRATOR_ALL_BUSINESS_UNITS_DATA
Product Manager, which is Use this role to set up organizations and items so you can add items to your sales orders.
EGP_PRODUCT_MANAGER_JOB
1. Sign into Oracle Fusion Applications as the it_security_manager or with a job role that you can use to manage
job roles.
If you don't sign in with a job role that you can use to manage job roles, then various actions will be grayed out
when you do the Create Implementation Users task, such as copying a job role, and you won't be able to add
privileges to a job role.
2. Go to the Setup and Maintenance work area, then go to the task.
67
Oracle SCM Cloud Chapter 2
Implementing Order Management Implement Business Process Flows
3. On the User Accounts page, click Add User Account, enter values, then click Add Role.
Attribute Value
Email diane.cho@yourComany.com
4. In the Add Role Membership dialog, enter Order Manager, then click Search.
5. In the search results, click the row that contains the values.
Attribute Value
Code ORA_DOO_ORDER_MANAGER_JOB
6. In the Confirmation dialog, click Add Role Membership > OK, then click Done
7. On the Add User Account page, add passwords for the user, then click Save and Close.
Each user can use these passwords the first time the user signs in. Instruct your users to change passwords
immediately after sign in.
Create another user and assign a job role so the user can only view sales orders, but not create, update, or delete them.
1. Identify the role that provides only view access to sales orders.
◦ On Oracle Help Center, locate the Security Reference for Order Management book.
◦ Examine the roles, duties, privileges, and policies until you locate one that meets your needs. For this
example, the Order Entry Specialist is the most likely role.
◦ In the Order Entry Specialist section, scroll through the Privileges area until you locate the Item Inquiry
granted role.
Item Inquiry Queries and views items in the Manage Item Attachment
enterprise.
Item Inquiry Queries and views items in the Manage Item Catalog
enterprise.
Item Inquiry Queries and views items in the Manage Item Global Search
enterprise.
68
Oracle SCM Cloud Chapter 2
Implementing Order Management Implement Business Process Flows
Item Inquiry Queries and views items in the Manage Trading Partner Item
enterprise. Reference
Item Inquiry Queries and views items in the View Item Organization Association
enterprise.
Item Inquiry Queries and views items in the View Item Relationship
enterprise.
◦ For this example, you must provide only read access, so you will use the View Item privilege.
2. On the User Accounts page, click Add User Account, set values, then click Add Role.
Attribute Value
First Name Yu
Last Name Li
Email yu.li@yourComany.com
3. In the Add Role Membership dialog, enter the role you located earlier in this procedure, Order Entry Specialist,
then click Search.
4. In the search results, click the row that contains the values.
Attribute Value
Code ORA_FOM_ORDER_ENTRY_SPECIALIST_JOB
5. In the Confirmation dialog, click Add Role Membership > OK , then click Done.
6. On the Add User Account page, add passwords for this user, then click Save and Close.
69
Oracle SCM Cloud Chapter 2
Implementing Order Management Implement Business Process Flows
Attribute Value
Code ORA_FOM_ORDER_ENTRY_SPECIALIST_JOB
Tip: Reduce your work load. Modify the copy of a predefined role rather than create a new one.
4. In the Copy Options dialog, choose Copy Top Role, then click Copy Role.
5. On the Basic Information page, enter values, then click Next.
Attribute Value
Description Search for and view sales orders, including sales order header, order lines, price details, and
price totals. Don't allow user to create, update, or delete any part of the sales order.
6. On the Function Security Policies page, delete all rows except rows that contain these privileges.
70
Oracle SCM Cloud Chapter 2
Implementing Order Management Implement Business Process Flows
For example.
Note.
◦ If you must add a privilege, then click Add Function Security Policy.
◦If you must add all privileges, for example you choose to not copy a predefined role, then, in the Add
Function Security Policy dialog, enter the first characters that are similar across a group of privileges,
such as View Customer, click Search, then add each privilege from the search results.
7. On the Data Security Policies page, delete each row that includes these values.
Attribute Values
71
Oracle SCM Cloud Chapter 2
Implementing Order Management Implement Business Process Flows
Attribute Values
To delete a row, click the down arrow in the row, then click Remove Data Security Policy.
8. Verify that the Data Security Policies page displays these policies.
Grant on Trading Community Customer Order entry specialist can view customer Read, View Customer Account Site Use
Account Site Use account site use.
Grant on Trading Community Order entry specialist can view trading Read, View Trading Community
Relationship community relationship. Relationship
Grant on Trading Community Order entry specialist can view trading Read, View Trading Community
Organization Party community organization. Organization
Grant on Application Reference Data Set Order entry specialist can view customer View Customer Account Site Use
account site use.
Grant on Application Reference Data Set Order entry specialist can view customer View Customer Account Site,
account site.
Grant on Trading Community Party Order entry specialist can view trading Read, View Trading Community Person
community person.
Grant on Trading Community Customer Order entry specialist can view customer Read, View Customer Account
Account account.
Grant on Application Reference Data Set Order entry specialist can view customer View Customer Account Relationship
account relationship.
Grant on Trading Community Customer Order entry specialist can view customer Read, View Customer Account Site
Account Site account site.
◦ In the Policy Name column, in the row that contains this value, click Actions > Edit Data Security Policy.
72
Oracle SCM Cloud Chapter 2
Implementing Order Management Implement Business Process Flows
Attribute Value
◦ In the Edit Data Security Policy dialog, next to Actions, click the down arrow, then add or remove the
check mark next to each of the actions you will allow or disallow the user to do.
For example, View Customer Account Site, Manage Customer Account Site, Read, Delete, Update, and
so on. For this example, you're setting up a read-only view, so make sure only the view actions and read
actions contain a check mark.
A business unit set as a group of business units that you can use for a specific setup. For example, assume you
add business unit 1 and business unit 2 to business unit set x, and then attach Payment Term NET30 to set x. You
can then use this payment term for business unit 1 and business unit 2.
The Set Id identifies the business unit set. For details about the business unit set, see the Overview of Multiple
Business Units in Sales topic.
You can specify the actions that each policy allows according to Set Id. For example.
◦ In the Policy Name column, in the row that contains this value, click Actions > Edit Data Security Policy.
Attribute Value
◦ In the Edit Data Security Policy dialog, next to Actions, click the down arrow, then notice you can specify
a wide range of views and manage actions that the user can perform.
You can specify the actions that each policy allows according to business unit. For example.
Attribute Value
73
Oracle SCM Cloud Chapter 2
Implementing Order Management Implement Business Process Flows
Attribute Value
You can also use Select by Key to specify the business unit according to BU_ID.
Condition Name Specify how to filter according to business unit. For most situation, choose Access the
Business Unit for Which the User is Explicitly Authorized.
Actions Choose the actions that you must allow the user to do for the business unit.
9. Click Next.
10. On the Role Hierarchy page, delete all role hierarchies except for. . .
Use the Role Hierarchy page to specify other job roles that the job role you're creating can access. A role
hierarchy is a hierarchy that specifies other job roles that a job role references.
For example, here's the predefined role hierarchy that the Order Entry Specialist job role uses.
Item Inquiry
74
Oracle SCM Cloud Chapter 2
Implementing Order Management Implement Business Process Flows
For details about the role hierarchy that each predefined job role uses, see the Security Reference for Order
Management book.
11. Click Next.
12. On the Users page, click Add User.
13. In the Add User dialog, search for Yu Li, wait for the results to display, click Add User to Role > OK in the
confirmation dialog, then click Cancel.
14. Click Next > Save and Close.
For details about this task, see the Implementing Common Features for Oracle SCM Cloud book on Oracle Help
Center.
2. On the Manage Data Access for Users page, enter a value, then click Search.
Attribute Value
The search results display the data access you set up for Yu, including for the Order Entry Specialist role where
you added Yu as a user on the User Accounts page, and the other job roles you specified when you created the
Order Entry Specialist View Only job role, and then assigned to Yu.
3. Click Authorize Data Access.
4. In the Opening SecurityDataAccessTemplate.xls dialog that displays, accept the Open With option, then click
OK.
75
Oracle SCM Cloud Chapter 2
Implementing Order Management Implement Business Process Flows
◦ In the Security Context Value column, in the first row that contains data, right-click the cell, then click
Invoke Action.
Caution: Use this action instead of manually entering text. This action searches the Oracle database
for the data access sets you can use. If you manually enter text, and if your text doesn't exactly
match text that the database contains, then the upload will fail.
◦ In the Select Security Context Value dialog, set the value, then click Search.
Attribute Value
◦ In the search results, click the row that includes Vision Operations, then click OK.
Notice that Excel adds Vision Operations to the cell you selected in the Security Context Value column.
◦ Repeat the above steps for each of the other rows that contain data.
For example, for the row that contains Asset Book, set value Security Context to an asset book.
76
Oracle SCM Cloud Chapter 2
Implementing Order Management Implement Business Process Flows
◦ In the command ribbon that displays across the top of Excel, click Authorize Data Access for Users >
Upload.
◦ Wait for the upload to finish, then verify that the Status column displays Successfully Uploaded for each
row.
◦ Click Status Viewer, then verify that the Status View displays No Error.
◦ Sign out.
6. Go back to Oracle Fusion Applications.
7. In the Navigator, click Scheduled Processes
8. On the Scheduled Processes page, click Schedule New Process, then run the scheduled process.
Retrieve Latest LDAP Changes Synchronizes users, roles, and role grants with the definitions that exist in LDAP (Lightweight
Directory Access Protocol ) that Order Management uses to determine who can access the
Order Management work area.
Related Topics
• Overview of Multiple Business Units in Sales
General
Opt Into Features in Order Management
Get details about features you can enable or disable according to your business requirements.
1. Go to the Setup and Maintenance work area, then go to the offering.
Examine the features that you can use with Order Management.
77
Oracle SCM Cloud Chapter 2
Implementing Order Management Implement Business Process Flows
Maintain Common Reference Objects Support common functionality, such as Overview of Common Reference Objects
data security, reference data sets, and topic
other preferences. Leave this feature
enabled for most deployments.
Governance, Risk, and Compliance Manage governance, risk, and compliance Governance, Risk, and Compliance
across processes and systems. Management at http://www.oracle.com/
us/solutions/corporate-
governance/018760.htm
Local Installation of Help Write your own help. Define Help Configuration section in
Implementing Common Features for SCM.
Transformation Rules Transform source orders that you create Transformation Rules topic
in Order Management or that you import
from a source system to optimize order
fulfillment.
Order Holds Allow the Order Entry Specialist to place a Manage Hold Codes topic
hold on a sales order.
Drop Ship Leave this feature disabled unless you Implementing Drop Ship section in
implement drop ship. Implementing Order Management book
Enterprise Structures Guided Flow Leave this feature disabled unless you Define Enterprise Structures chapter in
implement enterprise structures. Implementing Common Features for SCM
Application Toolkit Component Leave this feature disabled unless you Define Application Toolkit Configuration
Maintenance use Application Toolkit to modify various chapter in Implementing Common
components, such as application help, Features for SCM
reports and analytics, the Watchlist, and
so on.
Click to Dial Use Click to Dial to place a call to a contact Not applicable
from a hyperlink on the phone number or
phone icon.
Enterprise Scheduler Job Definitions and Leave disabled unless you run scheduled Define Custom Enterprise Scheduler
Job Sets processes according to Oracle Enterprise Jobs chapter in Implementing Common
Scheduler Services. Features for SCM
78
Oracle SCM Cloud Chapter 2
Implementing Order Management Implement Business Process Flows
Enable Custom Payloads for Downstream Use view objects to integrate with Integrate Order Management with Other
Integration systems that reside downstream of Order Oracle Applications topic
Management.
Specify Business Unit for Selling Profit Set the selling profit center on a sales Set Business Units for Selling Profit
Center for Goods and Services Tax order line that's different from the Centers topic
business unit on the order header.
Enable Coverage and Subscription Include coverage items and subscription Set Up Coverage for Sales Orders topic
items in sales orders.
Update Selected Lines in Sales Order Allow the Order Entry Specialist to select Update More Than One Order Line topic
one or more order lines in a sales order,
specify the attributes and values to
update, then update all selected lines.
Return Items or Cancel Services Without a Allow the Order Entry Specialist to return Allow Users to Return Items Without
Reference Order an item without specifying the sales order Original Sales Orders topic
that originally ordered the item.
Pricing Use the set up in the Pricing Administering Pricing book on Oracle Help
Administration work area to price items Center
in Order Management. Leave this feature
enabled unless you plan to use some other
way to price your sales orders.
Order Management Business Intelligence Enable analytic reporting in the Order Use Reports and Analytics with Order
Analytics Management work area. Leave this feature Management topic
enabled.
Related Topics
• Plan Your Implementation
• Overview of Common Reference Objects
• Configure Offerings
79
Oracle SCM Cloud Chapter 2
Implementing Order Management Implement Business Process Flows
◦ Expand SCMDomain.
◦ In the SCM-SOA row, examine the values for External Server Host and External Server Port.
5. Get details for services you can use with Oracle Fusion Applications.
Name Values
FSCMServices Host and port for ADF services (Oracle Application Development Framework).
◦ In the SCM-SOA row, examine the values for External Server Host and External Server Port.
Parameter Description
Activate Credit Check on Order Specify whether to run credit check when the Order Entry Specialist submits the sales order.
Submit
For details, see the Manage Credit Check in Order Management topic.
Allow Changes Through Configurator Allow the configurator to choose items in a configuration and to modify configuration options
Validation after the Order Entry Specialist adds a configured item to a sales order, and then save the sales
order as a draft, but before the Order Entry Specialist submits the sales order.
For example.
1. The Order Entry Specialist adds a configured item to a sales order, then saves the sales
order as a draft.
80
Oracle SCM Cloud Chapter 2
Implementing Order Management Implement Business Process Flows
Parameter Description
2. A configuration manager modifies the configuration model and configuration rules for
the configured item in such a way that it affects the configuration that the Order Entry
Specialist added.
3. The Order Entry Specialist returns to the draft several days later, then submits the sales
order.
In this example, if you set Allow Changes Through Configurator Validation to.
• Yes. The configurator uses the modified configuration model and configuration rules to
update the configuration that the Order Entry Specialist specified. It allows the submit to
proceed. It doesn't report these modifications to the Order Entry Specialist.
This setting is useful when your business process doesn't require the Order Entry
Specialist to understand and agree to modifications that the configurator makes.
• No. The configurator doesn't modify the configuration that the Order Entry Specialist
specified. Instead, it doesn't allow the submit to proceed, and displays a validation error
when the Order Entry Specialist attempts to submit or validate the sales order.
This setting is useful when your business process requires that the Order Entry
Specialist understand and agree to modifications that the configurator makes.
Note.
• This parameter doesn't apply to a source order that includes a configured item. For
details about importing source orders, see the Use Files to Import Orders into Order
Management topic.
• This parameter affects all business units.
For details about the configurator, see the Oracle SCM Cloud, Configurator Modeling book on
My Oracle Support.
Allow User to Remove Project Details A referenced return order gets its attribute values from the original sales order that it
on Referenced Returns references.
If you set this parameter to Yes, then Order Management allows the Order Entry Specialist to
remove these original values from project attributes on a referenced return order, but only if
the return order is in Draft status.
You must enable an opt-in feature before you can set this parameter.
Automatically Set Values on Sales Control default values that Order Management sets for sales agreement attributes when the
Agreement Attributes user creates or updates the sales order.
• If only one sales agreement exists for the customer and business unit, then Order
Management sets the agreement on the order header to this one sales agreement.
81
Oracle SCM Cloud Chapter 2
Implementing Order Management Implement Business Process Flows
Parameter Description
• If more than one agreement exists, then Order Management leaves the agreement on
the order header empty.
• If the agreement on the order header is empty, and if only one sales agreement exists
for the item on the order line, then Order Management sets order line attributes Sales
Agreement, Sales Agreement Line, and Sales Agreement to the order line agreement.
Otherwise, it leaves these order line attributes empty.
If you set this parameter to No, then Order Management doesn't set any default values. It
leaves them all empty.
Order Management constrains the customer, business unit, and currency on the order header.
It also constrains the item on the order line.
Business Unit for Selling Profit Center See the Set Business Units for Selling Profit Centers topic.
Compare Change Order to Fulfillment See the section below in this topic.
Values
Configuration Effective Date Specify the date that Order Management uses to determine the configure options to display for
a configured item. The configure options might vary depending on the ones that exist in the
configuration model on a given date.
Set a value.
• Ordered Date. Use the options that exist according to the Ordered Date attribute that
displays on the Create Order page.
• Configuration Date. Use the options that exist when you create the model.
• Current Date. Use the options that exist as of today.
• Requested Date. Use the options that exist according to the requested date.
If you don't set a value, then Order Management uses Current Date.
Configuration Effective Date for Use this parameter with or without setting Configuration Effective Date. For details, see the
Exploding Included Items Control Explosion Dates for Configuration Models topic.
• Shipment Date. Set the start date of the coverage to the date that Order Management
ships the covered item.
• Delivery Date. Set the start date of the coverage to the date that Transportation
Management sends to Order Management when Transportation Management delivers
the covered item.
82
Oracle SCM Cloud Chapter 2
Implementing Order Management Implement Business Process Flows
Parameter Description
For details, see the Set Up Coverage for Sales Orders topic.
Credit Check Failure at Order Submit Specify how to proceed if credit check fails.
• Save Order in Draft Status. Save the sales order in Draft status and don't proceed to
fulfillment.
• Submit the Order with Hold on Lines That Failed Credit Check. Save the sales order
in Submitted status, place a hold on each order line that fails credit check, then proceed
with fulfillment for order lines that aren't on hold.
For details, see the Manage Credit Check in Order Management topic.
Customer Relationship Type Specify values that the Order Entry Specialist can set for the Ship-to Customer attribute and
the Bill-to Customer attribute.
Set a value.
• Single Customer. Allow the Order Entry Specialist to select only the bill-to customer
and ship-to customer that's the same as the sold-to customer.
For example, if the Order Entry Specialist creates a sales order for Company x, then
Order Management sets Ship-to Customer and Bill-to Customer to Company x. The
Order Entry Specialist can't modify these values.
• All Customers. Allow the Order Entry Specialist to select any bill-to customer or ship-to
address, regardless of sold-to customer.
For example, if the Order Entry Specialist creates a sales order for Company x, then
Order Management sets Bill-to Customer and Ship-to Customer to Company x, by
default, and allows the Order Entry Specialist to search and select any bill-to customer,
or any ship-to customer and address.
Enable Orchestration Process Specify whether to do orchestration process planning and to calculate jeopardy on each sales
Planning and Calculate Jeopardy order during order processing.
Filter Ship-To Addresses Filter addresses that the Order Entry Specialist can choose when setting the Ship-to Address
attribute on the order header.
Set a value.
83
Oracle SCM Cloud Chapter 2
Implementing Order Management Implement Business Process Flows
Parameter Description
Note.
• In some situations, you might need to prevent the Order Entry Specialist from using
a Ship-to Address when Usage for the address is Bill-to. For example, if you use
Oracle Fusion Receivables, then you must set Filter Ship-To Addresses to Yes because
Receivables comes predefined to ship only to a ship-to address.
In another example, it might not be appropriate for a bill-to location in your deployment,
such as an accounting center, to receive shipment.
• If you import a source order, and if the Filter Ship-To Addresses parameter is Yes, and
if the value of the Site Usage attribute for the ship-to address in Trading Community
Architecture isn't Ship-to, then the import will fail.
• To specify the value that the Usage attribute displays, navigate to Trading Community
Architecture, then set the Site Usage attribute to one of these values.
◦ Ship-to
◦ Bill-to
From Address for Email Messages Specify the From email address that the Universal Messaging Service uses when it sends an
email from the order document or from an automatic notification.
The From address comes predefined as no-reply@orderreport.com. You can modify this
value to use an address in the domain that your company uses. You must use a valid email
address format. For example, something@somethingelse.xxx.
Halt Configurator Validation on First Error affects only order entry. It doesn't affect order
import.
Notify Frequency Specify an integer that represents the number of hours to wait before consolidating, and then
sending a notification.
Notify Frequency comes predefined with a value of 1. You can set it to any value that's
greater than or equal to 0 (zero). If you set it to 0, then Order Management won't consolidate
notifications, and will send each notification when the event that it references occurs.
84
Oracle SCM Cloud Chapter 2
Implementing Order Management Implement Business Process Flows
Parameter Description
For details, see the Send Notifications from Order Management to External Systems topic.
Number of Processes for Order Set the maximum number of scheduled processes that can run concurrently for one set of
Import source orders. Adjust this value as necessary depending on how it impacts performance.
For details, see the Import Orders into Order Management topic.
Number of Times to Retry Pause Specify the number of times to retry a pause task that pauses until time elapses. Adjust this
value according to performance.
For details, see the Pause Orchestration Processes Until Time Elapses topic.
Preparer for Procurement Specify an Order Management user who the buyer can contact to help resolve a problem that
occurs with a fulfillment line that involves a drop ship supplier. The buyer is a procurement
application user. Order Management sends these details to purchasing.
• If you don't specify Preparer for Procurement, and if an error occurs, then the
procurement system will reply with an error that the preparer is missing.
• You must specify at least one value so Order Management can successfully send a
purchase request to Oracle Procurement Cloud.
• The default value applies across all business units.
• You can specify a separate preparer for each selling business unit.
• You can specify a preparer as the default value for all business units. Order Management
will use this default value only for business units where you don't specify a preparer.
• Order Management doesn't use the value for any other attribute as the preparer. For
example, it doesn't use the Created By attribute. It uses only the value you specify in
Preparer for Procurement.
For details, see the Set Up Drop Ship in Order Management topic.
Send Discount Details to Billing Specify whether to send the list price and discounts, or only the net price, to your downstream
Systems billing system.
Start Approval Process for Sales Specify whether to get sales order approval.
Orders
• If you must enable approval, then you must set this parameter to Yes even if you must
enable approval only for Order Management.
• If you set this parameter to No, then Order Management won't route sales orders for
approval even if you define and activate an approval rule.
• If you set this parameter to Yes but you don't define and activate an approval rule, then
Order Management won't route the sales order for approval, but will instead send it to
order fulfillment.
For details about this parameter, see the How Managing Approval Rules for Sales Orders Works
topic.
85
Oracle SCM Cloud Chapter 2
Implementing Order Management Implement Business Process Flows
Parameter Description
This parameter applies only when you import through REST API.
• Yes. Allow a web service or file-based data import to change fulfillment line values even after the Order Entry
Specialist revises the sales order in the Order Management work area.
• No. Don't allow.
• Order Management compares attribute values in the revision to attribute values in the import data to determine
whether the user revised the order.
• If the user revised the order, then Order Management will replace the user's revisions with values from the
imported data.
• Make sure your import data includes values for attributes the user didn't revise. You must get these values from
the orchestration process that's currently processing the order.
Use the getOrderDetails operation of web service Order Information Service or use Oracle Transactional
Business Intelligence (OTBI) to get attribute values from the sales order that Order Management is currently
processing. Create a new payload for the order revision, change attribute values in the payload to reflect the
revision, then send the payload to Order Management.
Set the value for this parameter only one time. For example, if you set it to Yes during set up, then don't set it to No after
you deploy your set up.
Example
86
Oracle SCM Cloud Chapter 2
Implementing Order Management Implement Business Process Flows
Step 1. Your user creates a sales order, doesn't set a value for the Warehouse attribute, submits the order, and Order
Promising schedules it.
Step 2. Your user creates an order revision, sets the Warehouse to M1, then submits the order.
37564 1 10 M1
• Compares the payload in step 3 to the payload in step 2 to identify attributes that changed.
• The warehouse in step 2 is M1 buts its empty in step 3, so Order Management detects a change on the order
line.
• Order Management updates your fulfillment system to process the change.
Note.
• If the line already shipped, then Order Management rejects the change.
• If your user makes another revision before step 3, then you can use a web service or order import to process it.
Improve your user experience. Sales orders that have a large number of order lines might take a few minutes to process.
You can specify the number of seconds to wait before giving control back to the user for sales orders that have a lot of
order lines.
87
Oracle SCM Cloud Chapter 2
Implementing Order Management Implement Business Process Flows
• If Order Management finishes submitting the order to fulfillment before the time that you specify elapses, then
Order Management displays the same success message or error message that it displays when you don't use
Response Time in Seconds.
• If Order Management doesn't finish submitting the order to fulfillment before the time that you specify elapses,
then the Order Management work area displays a dialog that you can use to navigate away from the sales order
while Order Management continues to process the submit. If you're still on the order page, then you can refresh
the page to get an updated order status. If you navigate away from the order page, then you can search for the
sales order and get a status update. If you encounter an error or warning, you can edit the order or discard the
draft just like you can if you don't set a value in the parameter.
• This feature applies only for sales orders that you submit in the Order Management work area. It doesn't apply
for source orders that you import.
• Response Time in Seconds doesn't come predefined with a value.
• This feature works only when you click Submit in the Order Management work area to create, revise, or cancel a
sales order. It doesn't apply during order import.
• This feature applies to all users and all business units.
Related Topics
• Administer Email Format in Order Management
• Overview of Sending Notifications from Order Management to Other Systems
• Overview of Setting Up Trade Compliance
88
Oracle SCM Cloud Chapter 2
Implementing Order Management Implement Business Process Flows
Assume your Vision Operations business unit only sells items that the Denver Manufacturing organization builds, so
you must filter search so it only returns items from Denver Manufacturing.
Try it.
1. Go to the Manage Order Management Parameters page and click the row that contains the value.
Attribute Value
89
Oracle SCM Cloud Chapter 2
Implementing Order Management Implement Business Process Flows
Attribute Value
The Organization attribute only displays values that Product Information Management
associates with the business unit that you choose in the Business Unit attribute. You can
use Product Information Management to set up an inventory organization and create these
associations.
3. Go to the Order Management work area, create a sales order, and set the Business Unit to Vision Operations.
4. Search for an item on the catalog line on the sales order.
5. Verify that the search returns only the items that Denver Manufacturing builds.
Note.
• You must specify an organization for each business unit. If you don't, then at run time, Order Management
disables search for the item in each sales order that references a business unit that you don't specify.
As an alternative, if you use the same master organization for every business unit, then you can specify these
values.
Attribute Description
• You can set the Item Validation Organization parameter only for business units that Order Management
associates with your sign in responsibility. If it associates your sign in responsibility with only one business unit,
then it uses this business unit as the item validation organization.
• If you change the value of the Item Validation Organization parameter, then the change that you make doesn't
affect the sales orders that your orchestration process is currently processing. Orchestration will apply your
change only to sales orders that you create after you make the change.
90
Oracle SCM Cloud Chapter 2
Implementing Order Management Implement Business Process Flows
Note.
You then click Associations to add an inventory organization as a child of the master. This way, the downstream
flow can create a work definition during manufacturing.
91
Oracle SCM Cloud Chapter 2
Implementing Order Management Implement Business Process Flows
2. Product Information Management automatically creates a duplicate of the master when you add the child, but
with a few important differences, such as the organization.
◦ Assume you add M1 to V1. To see them, go to the Manage Items page and query for your item. You will
see V1 and M1 on separate rows, but with different values in the Organization column.
◦ V1 is the master. V1 means Vision Operations, which is headquarters for Vision Corporation. They keep all
the masters.
◦ M1 and M2 are children. M1 means Seattle Manufacturing, and M2 means Boston Manufacturing.
3. You can edit V1 and M1 separately. M1 and M2 inherit most of their attribute values from V1, but you might need
to set attributes for M1 and M2 differently from what you set for the master to meet the unique needs that each
manufacturing plant has. For example, you can set the Reservable attribute to No on the master and then set it
to Yes on the child.
92
Oracle SCM Cloud Chapter 2
Implementing Order Management Implement Business Process Flows
Consider an example.
Note.
1. Assume you set the Reservable attribute in Product Information Management to No for the V1 master, and you
set it to Yes for the M1 child.
2. You set the Item Validation Organization parameter to V1 for all business units.
3. At run time, you create a sales order for an item that's in the V1 organization. Order Management will use
the values that you specify for V1 in Product Information Management. It doesn't use values from the child,
and since you usually specify the inventory organization as the child, that means it won't use values from the
inventory organization when it fulfills your sales order.
4. The orchestration process won't reserve inventory for the item during fulfillment because it uses values from
the master, not the child.
93
Oracle SCM Cloud Chapter 2
Implementing Order Management Implement Business Process Flows
◦ Add an order line and then select the warehouse. Order Management sets the Tax Classification Code
on the order line according to the value that you set for the Output Tax Classification Code on the master.
◦ Select the warehouse and then add an order line. Order Management sets the Tax Classification Code
on the order line according to the value that you set for the Output Tax Classification Code on the child.
If you don't set the Item Validation Organization parameter, and if Product Information Management associates more
than one inventory organization with the same business unit, and.
Associates the same master Sets Item Validation Organization to the master, then informs the Order Entry Specialist of
organization with these inventory this setting. The Order Entry Specialist can accept this value and continue entering the sales
organizations. order, or reject it and contact the Order Administrator with a request to use the Item Validation
Organization parameter to specify the inventory organization.
Associates different master Informs the Order Entry Specialist that the Order Administrator must first set up the inventory
organizations with these inventory organization before the Order Entry Specialist can create the sales order.
organizations.
Related Topics
• What You Can Do in Product Master Data Management
• Inventory Organizations
94
Oracle SCM Cloud Chapter 2
Implementing Order Management Implement Business Process Flows
Using the time zone where the inventory organization resides provides more accurate values in date fields, and helps
to avoid undesirable time shifts between demand and supply. For example, to prevent the scheduled ship date from
occurring before the requested date or the ordered date.
Note.
• Order Management applies this behavior for sales orders that the Order Entry Specialist creates in work area
Order Management and for source orders that you import order from a source system.
• This behavior doesn't apply for drop ship.
For example.
1. The Order Entry Specialist sets the requested date on the sales order to 3/2/18 5:00 PM, which is a Friday, then
submits the sales order.
2. Order Management interacts with Global Order Promising in UTC, so it sends 3/3/18 00:00AM (UTC) as the
requested date.
3. Global Order Promising converts the requested date to the time zone where the inventory organization resides,
which is 2/3/18, Friday, 05:00 PM (UTC minus 7).
4. Global Order Promising schedules the shipment at the inventory organization to the end of the day, which is
2/3/18, 11:59 PM local time (UTC minus 7), because this day is a working day.
5. Global Order Promising sends schedule details to Order Management as Saturday, 3/3/18, 6:59 AM (UTC).
06:59 is a seven hour offset from UTC. The calculation is Friday, 11:59 PM local time (UTC minus 7) plus
seven hours equals Saturday, 3/3/18 06:59 AM (UTC).
6. The Order Management work area now displays the scheduled ship date in UPTZ, which is UTC minus 7.
The scheduled ship date in UTC was 3/3/18 minus 06:59AM (UTC). The time and date in UPTZ is 2/3/18 minus
11:59 PM (UTC-7).
Global Order Promising uses UTC. Order Management displays dates in UPTZ (User Preference Time Zone) so
they're meaningful to the person who uses the Order Management work area.
Requirements for how you format dates are different depending on how you import your source order.
95
Oracle SCM Cloud Chapter 2
Implementing Order Management Implement Business Process Flows
You use web service ReceiveOrder. Dates in your import payload can use UTC with or without a negative or positive offset.
For details, see the Overview of
Using Web Services with Order
Management topic.
You use the order import template. Dates in your import payload must use UTC.
For details, see the Use Files
to Import Orders into Order
Management topic.
Here's an example payload of the ReceiveOrder web service. It includes a UTC offset for the Earliest Acceptable Ship
Date attribute. This value indicates that the end of day is April 3, 2018, and the time is 1:10:10 AM in the time zone that's
8 hours behind UTC.
where
96
Oracle SCM Cloud Chapter 2
Implementing Order Management Implement Business Process Flows
T Time designator.
z Time zone indicator with or without a UTC offset. For example, 0-8.00 is eight hours behind
UTC.
Consider an example.
2018-04-03T01:10:10.0-08:00
where
Value Variable
t Time designator.
0-08:00 where
• 0. Specifies 0 UTC.
97
Oracle SCM Cloud Chapter 2
Implementing Order Management Implement Business Process Flows
Value Variable
Import
If you import a source order through FBDI or a web service.
• Collect units of measure from your order capture system so Order Management can validate the units of
measure it receives later when you import source orders from your capture system. For details, see the Collect
Data subtopic in the Quick Start for Setting Up Order-to-Cash topic.
• Use the Ordered UOM attribute to specify the unit of measure. Use the OrderedUOMCode attribute to specify
the abbreviation for the measure. For example, Ea is an abbreviation for Each.
• The import uses the value you import instead of the value you specify in Product Information Management.
• If you use the Pricing Administration work area to set up pricing for your item, then the import validates the
unit of measure according to how you set up the price list. For example, if you set the Pricing UOM attribute for
the item on the price list to Ea, and if your import doesn't use Ea for the unit of measure, then the import fails
and displays an error message.
• If you encounter an error during order import, like Cross-Referenced Value Not Found for UOM_CODE, see the
Cross-Reference Error subtopic in the Troubleshoot Problems With Order Import topic.
Fulfill
• If you don't encounter an error during import but the order gets stuck during fulfillment, then create a
conversion rule.
• If your shipping system uses a unit of measure to represent shipping that's different from the unit of measure
that Order Management uses in the sales order, then the shipment service converts the unit of measure back to
the unit of measure that the sales order uses, then communicates the shipped quantity to Order Management.
For details, see the Task Services topic.
• If you use the Create Inventory Reservations fulfillment task to reserve supply, then you must provide the item,
quantity, unit of measure, and warehouse. For details, see the Guidelines for Reserving Inventory topic.
• If you use an Oracle Fusion inventory system, then create a conversion rule that converts the UOM from the
sales order into a UOM that the inventory system can understand. If you use your own fulfillment system, then
make sure it accepts the UOM that the sales order specifies.
Related Topics
• Troubleshoot Problems With Order Import
• Task Services
• Guidelines for Reserving Inventory
98
Oracle SCM Cloud Chapter 2
Implementing Order Management Implement Business Process Flows
• How Units of Measure, Unit of Measure Classes, and Base Units of Measure Relate to Each Other
The Overview page comes predefined to only display data from the Order Management offering. However, you can set
it up so it displays data from other offerings.
1. In the Setup and Maintenance work area, go to the Order Management offering.
2. Click Actions > Edit Implementation Status, set status to Implemented, then click Done.
3. Repeat steps 1 and 2 for each offering that must display data in infolets.
For example.
◦ Order Promising is part of Supply Chain Planning. To display promising data, in step 1, go to Supply Chain
Planning.
◦ Shipping is part of Manufacturing and Supply Chain Materials Management. To display ship data, in step
1, go to Manufacturing and Supply Chain Materials Management.
Your users must sign in with the FOM_VIEW_ORDER_TO_CASH_INFOLET_PAGE privilege to view infolets.
Here are more privileges you need to view infolets from each offering.
Orders in Process
Shipment Exceptions
99
Oracle SCM Cloud Chapter 2
Implementing Order Management Implement Business Process Flows
1. Create a sandbox.
Attribute Value
Name My Sandbox
◦
In the row that contains Page Composer, add a check mark to the Active option, then click Create and
Enter.
2. Remove the infolet.
◦ Go to the Order Management work area, then, on right side of the Overview page, under the Create Order
button, click My Infolets.
◦ In the My Infolets dialog, in the row that contains Fulfillment Lines in Jeopardy, remove the check mark.
◦ On the banner at the top of the page, click My Sandbox > Publish.
◦ On the Sandbox Details page, click Publish.
3. Test your setup.
Collect Data
Overview of Collecting Promising Data for Order Management
Collect data for order promising at various points of your set up process, and also after you finish set up.
Global Order Promising promises orders that it receives from Order Management Cloud. It uses data from your supply
chain network and supplies that you collect. You set up rules in Promising that specify how to plan and promise.
You must collect data into the Global Order Promising repository. The repository stores details about the setups that you
make in the Global Order Promising work area, such as rules for sourcing, available-to-promise, and allocating supply.
Promising and sourcing work together to determine what to deliver to your customer within the time frame that the
sales order requests. Collecting also makes sure that you can search for and select data in the Order Management work
area, such as adding an item to an order line, or selecting a value in an attribute, such as the Warehouse.
100
Oracle SCM Cloud Chapter 2
Implementing Order Management Implement Business Process Flows
For example, collect the catalog that you assign to an item in the Product Information Management work area so you
can use it in an available-to-promise rule that you create in the Global Order Promising work area.
Use the Collect Planning Data task to collect data each time that you do the work described in the Source column. You
must collect the entity listed in the Entity column.
101
Oracle SCM Cloud Chapter 2
Implementing Order Management Implement Business Process Flows
Source Entity
- Demand Class
• Freight terms
• FOB points
• Invoicing rules
• Accounting rules
• Shipment priorities
• Payment terms
• Return reason
• Tax classification code
102
Oracle SCM Cloud Chapter 2
Implementing Order Management Implement Business Process Flows
Source Entity
If Order Promising must consider the transit time that occurs during shipping between the
warehouse and a destination, then you must collect shipping methods. If you don't, then Order
Management uses a transit time of zero days.
- Subinventories
Order Management validates the units measures and currencies against data that it already
collected from your order capture system when it receives source orders from this system.
Note: You use different job roles to access different work areas. You might need to create a super user that has these
job roles. For details, see the Job Roles and Duty Roles That You Use in Order Management topic.
103
Oracle SCM Cloud Chapter 2
Implementing Order Management Implement Business Process Flows
Notes
• A pilot set up expects your test orders to use the same values for the unit of measure, currency, and currency
conversion that you collect into the data repository.
During a full set up, if more than one order capture system uses different values for these entities, then you
must do more set up. For example, if one order capture system uses Ea for each item, and if another order
capture system uses Each for each item, then you must set up cross-references for these order capture
systems.
• Your can collect reference data from more than one system. However, a reference data entity is a global object,
so Order Management and Global Order Promising use the most recent data that your set up collects.
So, identify the source system that contains the master data list, then collect data from the source system
after you collect data from all other source systems. For example, if source system x contains the master list of
currencies, then collect currencies from source system y so Order Management can cross-reference currencies
to system y, then collect currencies from system x.
Related Topics
• Overview of Data Collections for Supply Chain Planning
• Manage Planning Source Systems for Data Collections
• How You Collect Different Data Types for Supply Chain Planning
Try it.
1. Do your setups in various work areas. For example.
Product Information Management ◦ Use the Manage Items task and Create Item Structure task to set up the AS54888
item.
◦ Use the Manage Catalogs task to set up catalogs for the AS54888.
Setup and Maintenance ◦ Use the Manage Units of Measure task to set up the units of measure you need for the
AS54888.
◦ Use the Create Workday Pattern task and the Create Work Schedule task to set up
calendar data for the AS54888.
Work Definition Use the Manage Work Definitions task to set up the work definitions that manufacturing will
use to build the AS54888.
2. Go to the Plan Inputs work area, then click Tasks > Collect Planning Data.
◦ You use the Collect Planning Data task to collect the set ups you made in step 1. This task makes the
objects that you set up available to other Oracle Fusion work areas and applications.
104
Oracle SCM Cloud Chapter 2
Implementing Order Management Implement Business Process Flows
◦ Don't use the Plan Inputs task that's available in the Setup and Maintenance work area. Use the Plan
Inputs work area instead.
3. In the Collect Planning Data dialog, set the values.
Attribute Value
Source System Choose the source system that your implementation uses for planning, such as OPS (Oracle
Fusion Order Orchestration and Planning).
If you're not sure, here's how you identify the source system that your implementation uses.
◦ Targeted. Delete all data in the repository for the entities that you select, collect new
data for these entities, then save it in the repository.
◦ Net Change. Collect data in increments, and collect only changed or new data. This
choice is faster than using Targeted. Use Net Change when you already performed a
targeted collection and now must keep your planning data current with data in your
run time environment.
◦ Automatic Selection. Let the server decide.
Templates are available, such as Static Data for Supply Planning. For this example, to help you learn how it
works, do the steps instead so you can more clearly visualize the flow.
4. On the Reference Data tab, move entities from the Supply Entities list to the Selected Entities list.
Choose the entities you need. Here are the entities that you typically collect for an Order Management
implementation.
◦ Calendars
◦ Currencies
◦ Items
◦ Item Structures
◦ Order Orchestration Reference Objects
◦ Organizations
◦ Sub Inventories
◦ Units Of Measure
For the complete list, see the Overview of Collecting Promising Data for Order Management topic.
105
Oracle SCM Cloud Chapter 2
Implementing Order Management Implement Business Process Flows
You might need to collect some entities periodically. For example, the conversion rate between currencies, such
as the Euro and the Dollar, might change each day. If you sell in markets that use different currencies, and if you
don't use a currency conversion list, then you might need to collect the Currencies entity one time each day so
Order Management can use the current conversion rate.
6. Click Submit.
The Plan Inputs work area automatically starts a scheduled process named Collection Job Set.
7. In the Status dialog, note the process number. For this example, assume its 50465.
8. Go to the Scheduled Processes work area.
9. On the Overview page, locate 50465 in the Process ID column. Monitor the process until the Status column
displays Succeeded.
Collection Job Set might automatically start other scheduled processes, such as Extract Oracle Fusion Entity.
You can examine the log for Collection Job Set to monitor them too. For example, here's the log for a Collection
Job Set that finished successfully.
10. Use Oracle Fusion work areas and applications to continue your set up.
For example, use the Create Assignment Set task in the Global Order Promising work area to specify the
AS54888 item that you set up in the Product Information Management work area.
Related Topics
• Overview of Data Collections for Supply Chain Planning
• Manage Planning Source Systems for Data Collections
• How You Collect Different Data Types for Supply Chain Planning
106
Oracle SCM Cloud Chapter 2
Implementing Order Management Implement Business Process Flows
Assume you must set up collections for the AS54888 Desktop Computer.
Note
• You use the Manage Planning Source Systems task to specify Oracle Fusion Order Orchestration And Planning
as your source system, to specify Vision Manufacturing as the inventory organization for the AS54888, and to
enable Vision Manufacturing for collections.
• You use the Manage Inventory Organizations task to specify Vision Manufacturing as a manufacturing plant.
• At run time, Order Management uses the inventory in Vision Manufacturing to fulfill the AS54888.
107
Oracle SCM Cloud Chapter 2
Implementing Order Management Implement Business Process Flows
Attribute Value
Attribute Value
Shippable Yes
Entities Value
For details, see the Refresh the Order Promising Server for Order Management topic.
Attribute Value
3. In the search results, click that row that has your organization, then click Manage Organization Parameters.
108
Oracle SCM Cloud Chapter 2
Implementing Order Management Implement Business Process Flows
4. On the Manage Inventory Organization Parameters page, in the Additional Usages area, set the value.
Attribute Value
Attribute Value
Version Fusion
◦ Set values for each system that your set up must integrate, such as an order capture system or fulfillment
system.
109
Oracle SCM Cloud Chapter 2
Implementing Order Management Implement Business Process Flows
Attribute Value
Version Others
For details, see the Manage Planning Source Systems for Data Collections topic.
2. Collect data for Vision Manufacturing, which is the organization that contains the inventory you plan to use to
fulfill the item.
◦ Select your source system in the Source Systems list, then click Manage Organization List.
◦ In the Manage Organization List dialog, click Refresh Organization List.
◦ Add a check mark to the Enable for Collections option for each organization that you use to fulfill the
item, then click Save and Close.
Attribute Value
3. Collect planning data. You must do the Collect Planning Data task each time after you do the Manage Planning
Source Systems task. Here are your values for this example.
Parameter Value
Reference Data Move the Items entity and the Organizations entity to the Selected Entities window.
For details, see the Collect Planning Data for Order Management topic.
4. Refresh the Order Promising Server for Order Management.
Parameters Value
110
Oracle SCM Cloud Chapter 2
Implementing Order Management Implement Business Process Flows
Parameters Value
For details, see the Refresh the Order Promising Server for Order Management topic.
Related Topics
• Overview of Data Collections for Supply Chain Planning
• Manage Planning Source Systems for Data Collections
Its important to periodically collect data for each new item that your users add when they create a sales order because
collecting gets the on-hand quantity for return orders and canceled orders, which makes that quantity available for
other sales orders. The quantity affects planning.
Try it.
1. Go to the Plan Inputs work area, then click Tasks > Collect Planning Data.
2. In the Collect Planning Data dialog, set a value in the Source System attribute, click Supply Planning Data, then
move entities from the Supply Entities list to the Selected Entities list.
Entity Value
On Hand Promising uses this entity to get the inventory that's in stock for the item.
Purchase Orders and Requisitions Add these entities so Global Order Promising can get availability across the entire supply
chain.
Transfer Orders
3. Click Submit.
4. Refresh the Global Order Promising server.
Related Topics
• Refresh the Global Order Promising Server
• Overview of Data Collections for Supply Chain Planning
• Manage Planning Source Systems for Data Collections
• How You Collect Different Data Types for Supply Chain Planning
111
Oracle SCM Cloud Chapter 2
Implementing Order Management Implement Business Process Flows
Note.
1. Your customer places a sales order that includes the item and requested delivery date.
2. You create an available-to-promise rule, which is a set of instructions you specify that tells Order Promising how
to analyze supply that's available in your supply chain so it can promise the item and meet the delivery date.
You specify the supply type to consider, such as supply that's on hand or in transit. You can also specify supply
that various documents create, such as purchase orders, requisitions, or work orders.
112
Oracle SCM Cloud Chapter 2
Implementing Order Management Implement Business Process Flows
3. You create a sourcing rule that specifies the supply sources to consider when promising, such as whether to
consider make, buy, or transfer sources. You can also specify the optimal location that can supply the demand.
Summary of the Setup
1. Go to the Global Order Promising work area, then click Tasks > Manage Sourcing Rules.
2. On the Manage Sourcing Rules page, Click Actions > Create, then set values.
Attribute Value
Set to.
◦ Global when you must specify where to fulfill and ship the sales orders. You don't
specify an organization to create supply. Instead, you specify a transfer or buy source.
◦ Local when you must specify how to create supply and the organization that creates
it.
You create a global sourcing rule that specifies the warehouse that Order Management uses
when it fulfills the sales order. For details, see the Overview of Sourcing Rules and Bills of
Distribution topic.
3. In the Sourcing Rule Effective Dates area, click Actions > Add Row, then set the start date.
4. In the Sources area, Click Actions > Add Row, then set values.
Attribute Value
113
Oracle SCM Cloud Chapter 2
Implementing Order Management Implement Business Process Flows
Attribute Value
Global Order Promising enables Make At only when you set assignment type to Local.
If you add more than one source, then you can allocate demand across sources. For example,
if you add a row for Vision Manufacturing and set allocation to 70%, add another row for
Vision Distribution and set allocation to 30%, then Promising will use Vision Manufacturing
to promise 70% of the orders.
Rank 1
If you add more than one source, then you can specify the rank order to use for sources.
For example, if you add a row for Vision Manufacturing and set Rank to 1, add another row
for Vision Distribution and set Rank to 2, then Promising will use Vision Manufacturing to
promise the order first. If Promising determines that Vision Manufacturing can't fulfill the
order, then Promising will consider Vision Distribution.
Shipping Method Global Order Promising disables Shipping Method for a local rule. You can't edit it. Leave it
empty for a global rule.
If you set a value for a global rule, you might get an error.
Don't set shipping method in this context because it specifies where supply originates, not
how to ship it to the customer.
Exclude for Options and Option Exclude options and option classes when promising a sales order. Exclude them for a Make
Classes At or Buy From sourcing type.
For example, exclude an item from planning when you know your source can't make it
because it includes toxic chemicals that the source isn't authorized to handle, or your
company limits production to only one specific site.
For another example, assume you know Seattle Manufacturing created a large oversupply
of the CTO_474100 screen option class from a prior marketing campaign. You already
know supply is available. To improve planning performance, you decide to exclude it from
planning.
114
Oracle SCM Cloud Chapter 2
Implementing Order Management Implement Business Process Flows
Attribute Value
Catalog GOP_Catalog
Use the same catalog that you use for your item in Product Information Management and in
your available-to-promise rule.
4. In the Sourcing Assignments area, click Actions > Add Row, then set values.
Attribute Value
Note.
◦ Promising fulfills your sales order only from the source that you assign to the
assignment set.
◦ Assign at least one sourcing rule at the global level so Global Order Promising can use
it to identify a ship-from location. If you don't, then your users must manually set a
value in the Warehouse attribute on each sales order.
Item AS54888
Sourcing Rule or Bill of Distribution Sourcing Rule for the AS54888 Item
Attribute Value
Description Rule that specifies how to determine availability for the AS54888 item.
115
Oracle SCM Cloud Chapter 2
Implementing Order Management Implement Business Process Flows
3. Click ATP Rule Assignment, click Actions > Add Row, set values, then click Save.
Attribute Value
Use the same value that you use in the Organization attribute in your sourcing rule.
Attribute Value
3. In the search results, click the row that has MSP_DEFAULT_ASSIGNMENT_SET in the Profile Option Code
column.
4. In the Profile Values area, click Actions > New, set values, then click Save and Close.
Attribute Value
Profile Value Pick the name of the assignment set that you created earlier in this topic. In this example,
pick Assignment Set for Sourcing Rules.
5. On the Manage Administrator Profile Values page, set the value, then click Search.
Attribute Value
6. In the search results, in the Profile Values area, set the value.
116
Oracle SCM Cloud Chapter 2
Implementing Order Management Implement Business Process Flows
Attribute Value
Profile Value Set to the same value that you use with the assignment set. For this example, set it to
GOP_Catalog.
Related Topics
• How the Order Orchestration and Order Promising Processes Use the Collected Planning Data
• Overview of Security Console
• How Order Promising Rules Work Together
• Create Sourcing Rules for Configured Items
Attribute Value
3. Add a check mark to the parameters that you must update, then click Submit.
Here are the parameters you refresh for most set ups.
◦ On Hand. You need the on-hand inventory to replenish each item in an inventory transaction or to
process a return order.
◦ ATP Rules.
◦ Sourcing.
◦ Items.
◦ Organizations. Include only when you create a new inventory organization.
◦ Resources. Include only when you create a new resource.
4. Click Actions > Refresh, then verify the status is Succeeded. Wash, rinse, and repeat, as necessary.
Related Topics
• Refresh the Global Order Promising Server
• Overview of Data Collections for Supply Chain Planning
• Manage Planning Source Systems for Data Collections
• How You Collect Different Data Types for Supply Chain Planning
117
Oracle SCM Cloud Chapter 2
Implementing Order Management Implement Business Process Flows
• Set the default value that the Order Management work area displays for each customer attribute and address
attribute.
• Use an address from a related customer to set the default value for ship-to address.
• Use data from the customer master to set the default value for preferences on each sales order.
Order Management gets customer details from Oracle Trading Community Architecture (TCA). Trading Community
Architecture is a data model you can use to manage details about customers who belong to your community, such as
organizations, locations, and the relationships that define your community. For details, see Oracle Trading Community
Architecture User Guide on My Oracle Support.
118
Oracle SCM Cloud Chapter 2
Implementing Order Management Implement Business Process Flows
Party Object
The party object in Trading Community Architecture contains customer data. Order Management uses it to get the
customer data it displays.
Note.
Object Description
1. Party. A trading partner. Each party can reference one or more party usages.
119
Oracle SCM Cloud Chapter 2
Implementing Order Management Implement Business Process Flows
Object Description
2. Party Usage. How you use the party, such as customer, supplier, prospect, and so on. Order Management
uses only the customer party usage. For example, searches and lists of values in the Order
Management work area display only customer party usage.
3. Party Site. An address that the party uses. Each party can reference one or more party sites.
4. Party Site Use. How the party uses the address. For example, ship-to, bill-to, and so on. Each party site can
reference one or more party site usages.
5. Location. Physical address where the party site resides. Each party site can reference only one location.
6. Party Relationship. Each party can reference one or more other parties. You can use the party relationship to
establish a relationship between two different parties.
120
Oracle SCM Cloud Chapter 2
Implementing Order Management Implement Business Process Flows
Account Object
Order Management uses the customer account object from Trading Community Architecture.
Note.
121
Oracle SCM Cloud Chapter 2
Implementing Order Management Implement Business Process Flows
Object Description
1. Customer Account. The customer account is a child of the party. It includes financial details that Order
Management uses to communicate with a financial application. Each party can reference
one or more customer accounts, however each party typically references only one customer
account.
2. Account Site. Set of party addresses that the account uses. Each customer account can reference one or
more account sites.
3. Account Site Use. How the account site uses the address. Each account site can reference one or more account
site usages.
4. Account Contact. Person in the account. Each account can reference one or more contacts. Account contact is a
subset of party contacts.
• Uses the party object to display data for customer attributes, such as Customer, Bill-to Customer, or Ship-to
Customer.
• Uses the account object to display data for account attributes, such as Bill-to Account or Bill-to Address.
122
Oracle SCM Cloud Chapter 2
Implementing Order Management Implement Business Process Flows
If the Order Entry Specialist sets the value for the Customer attribute on the order header, then Order Management
automatically sets the value for other attributes to the data it gets from the party and account, such as contact, ship-to
customer, address, bill-to customer, account, payment terms, and so on.
Note.
• In Oracle Fusion, the party object contains data for each customer, and the account object contains data for the
bill-to account and bill-to address.
• In Oracle eBusiness Suite, the account object contains data for each customer. For example, the account
contains the ship-to address, sold-to address, and bill-to address.
Collect Data
You must collect data any time you modify party data. For details, see the Collect Planning Data for Order Management
topic.
◦ Offering: Financials
◦ Functional Area: Customers
123
Oracle SCM Cloud Chapter 2
Implementing Order Management Implement Business Process Flows
If you create a new account site, then the application also creates a party site that includes objects from the
account site. This behavior helps to maintain the relationship between the party and the account.
Note.
• Don't delete a contact or address or set the end date for a contact or address. If you delete a contact or address,
then sales orders that already exist might not display the correct data.
• Each account is a child of a party. If you add a contact, account site, or account site usage in the account, then
Manage Customers adds objects in the party that correspond to the contact, account site, or account site usage
that you added.
124
Oracle SCM Cloud Chapter 2
Implementing Order Management Implement Business Process Flows
• If you delete or end date an object in a child contact, account site, or account site usage, then Manage
Customers doesn't update the corresponding object in the parent party.
For example, if you delete the ship-to address of a contact, then Manage Customers doesn't delete the
corresponding ship-to address of the party. Manage Customers uses this functionality to maintain the
relationship between party and customer account, which is one to many. Some other account might reference
the ship-to address of the party.
125
Oracle SCM Cloud Chapter 2
Implementing Order Management Implement Business Process Flows
5. Use the Organization Details page to manage the party profile, party address, and party usage.
Note.
• Modify the value in the Purpose attribute to control site usage. For example, Order Management uses Ship-to
purpose to filter the list of values that it displays for ship-to address.
• Add a check mark to the Primary attribute to specify the address that Order Management displays as the
default value.
• You can't use the Manage Organization page to manage accounts.
To get details about how to manage an organization, go to Oracle Help Center at https://docs.oracle.com/en/cloud/
saas/index.html. Under Customer Experience, click Customer Data Management > Books, then find Implementing
Customer Data Management or Using Customer Data Management.
126
Oracle SCM Cloud Chapter 2
Implementing Order Management Implement Business Process Flows
To control the values that the user can choose, set the Customer Relationship Type order management parameter.
Value Description
All Customers Allow the user to choose any customer for Bill-to Customer and Ship-to Customer.
Single Customer Allow the user to choose only the same value that the Customer attribute references for Bill-to
Customer and Ship-to Customer.
Business Unit Specify the business unit where this behavior applies. Use All Business Units to apply behavior
to all sales orders.
127
Oracle SCM Cloud Chapter 2
Implementing Order Management Implement Business Process Flows
Note.
• Order Management applies the behavior you specify to sales orders in the Order Management work area and to
sales orders that you import.
• Order Management doesn't use relationships that you set up in Trading Community Architecture. If you must
create a relationship, then set Customer Relationship Type to All Customers, and write an order management
extension that enforces ship-to or bill-to customer for each party that Trading Community Architecture defines.
For details, see the Define Extensions That Modify Order Management topic.
• For other relevant details, see the Manage Order Management Parameters topic.
128
Oracle SCM Cloud Chapter 2
Implementing Order Management Implement Business Process Flows
You can use the Organization Details page to set the default value for Ship-to Address.
129
Oracle SCM Cloud Chapter 2
Implementing Order Management Implement Business Process Flows
Note.
130
Oracle SCM Cloud Chapter 2
Implementing Order Management Implement Business Process Flows
131
Oracle SCM Cloud Chapter 2
Implementing Order Management Implement Business Process Flows
If you use Oracle Fusion Financials, then set order management parameter Filter Ship-to Address According to Ship-
to Usage to Yes. This setting makes sure your users select only ship-to sites to avoid an error from occurring when the
import automatically invoices the transaction.
132
Oracle SCM Cloud Chapter 2
Implementing Order Management Implement Business Process Flows
For example, assume you support a retailer named Computer Service and Rentals who sells at 200 separate physical
locations. You can allow your users to search on the text Computer Service to return all locations that begin with the text
Computer Service.
133
Oracle SCM Cloud Chapter 2
Implementing Order Management Implement Business Process Flows
<org:PartySite>
<par:PartySiteId>300100178657747</par:PartySiteId>
<par:PartySiteUse>
<par:PartySiteUseId>300100178657752</par:PartySiteUseId>
<par:PrimaryPerType>Y</par:PrimaryPerType>
</par:PartySiteUse>
</org:PartySite>
</typ:organizationParty>
</typ:mergeOrganization>
</soapenv:Body>
</soapenv:Envelope>
where
Code Description
server:port Address to the server that hosts your Oracle Fusion deployment.
PartySiteId Value that uniquely identifies the party site, such as 300100178657747.
PartySiteUseId Value that uniquely identifies the party site use, such as 300100178657752. You specify the Id
of the ship-to site use.
You replace the values for PartyId, PartySiteId, and PartySiteUseId with values that identify the party, the address, and
the site use Id that identifies the address to set as the default ship-to address on each sales order for the party.
To set the primary ship to site, use findOrganization to get the identifiers for mergeOrganization.
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body xmlns:ns1="http://xmlns.oracle.com/apps/cdm/foundation/parties/organizationService/
applicationModule/types/">
<ns1:findOrganization>
<ns1:findCriteria xmlns:ns2="http://xmlns.oracle.com/adf/svc/types/">
<ns2:fetchStart>0</ns2:fetchStart>
<ns2:fetchSize>-1</ns2:fetchSize>
<ns2:filter>
<ns2:conjunction>And</ns2:conjunction>
<ns2:group>
<ns2:conjunction>And</ns2:conjunction>
<ns2:upperCaseCompare>false</ns2:upperCaseCompare>
<ns2:item>
<ns2:conjunction>And</ns2:conjunction>
<ns2:upperCaseCompare></ns2:upperCaseCompare>
<ns2:attribute>PartyNumber</ns2:attribute>
<ns2:operator>=</ns2:operator>
<ns2:value>1001</ns2:value>
</ns2:item>
</ns2:group>
</ns2:filter>
<ns2:excludeAttribute>false</ns2:excludeAttribute>
</ns1:findCriteria>
<ns1:findControl xmlns:ns3="http://xmlns.oracle.com/adf/svc/types/">
<ns3:retrieveAllTranslations>false</ns3:retrieveAllTranslations>
134
Oracle SCM Cloud Chapter 2
Implementing Order Management Implement Business Process Flows
</ns1:findControl>
</ns1:findOrganization>
</soap:Body>
</soap:Envelope>
For details about how to use web services with Trading Community Architecture, see SOAP Web Services for Oracle
Sales Cloud on My Oracle Support at https://docs.oracle.com/en/cloud/saas/sales/r13-update17d/oesws/toc.htm.
Assume you need to set Taizong's site to 1800 Satellite Drive, Distribution Center, and you need to set the default value
for the Contact Method to Taizong's email address, but you haven't yet specified a contact point for Taizong.
135
Oracle SCM Cloud Chapter 2
Implementing Order Management Implement Business Process Flows
You edit Taizong's contact details in the Setup and Maintenance work area at design time to specify the contact point.
Order Management then displays the contact point in the Contact Method on the sales order at run time.
To set the default value that displays at run time in the Contact Method attribute, make sure you have only one contact
point on the Edit Contacts page. For example, if you have an email contact point and a phone contact point, then no
value will display in the Contact Method attribute, by default.
Try it.
1. Go to the Setup and Maintenance work area, then open the task.
◦ Offering: Financials
◦ Functional Area: Manage Customers
136
Oracle SCM Cloud Chapter 2
Implementing Order Management Implement Business Process Flows
Attribute Value
3. Scroll down to the Sites area, then click the link in the Site Number column in the row that contains the address
you're looking for.
Attribute Value
Attribute Value
Email tang.taizong@oracle.com
Make sure the Contact Points list contains only one row. If it has more than one row, then Order Management
won't set a default value for the Contact Method attribute on the sales order.
7. Click Save and Close.
8. On the Manage Customers page, click Done.
Test Your Set Up
Attribute Value
137
Oracle SCM Cloud Chapter 2
Implementing Order Management Implement Business Process Flows
Attribute Value
138
Oracle SCM Cloud Chapter 2
Implementing Order Management Implement Business Process Flows
139
Oracle SCM Cloud Chapter 2
Implementing Order Management Implement Business Process Flows
If . . . . . . Then
Only one site specifies bill-to usage. Order Management defaults the address to this one site.
More than one site specifies bill-to Use the Address Purposes area to set the Primary. Order Management will use the primary as
usage. the default value for Bill-to Address.
140
Oracle SCM Cloud Chapter 2
Implementing Order Management Implement Business Process Flows
To control the addresses that display, set the Purpose on the account site to bill-to usage when you set up your account.
141
Oracle SCM Cloud Chapter 2
Implementing Order Management Implement Business Process Flows
142
Oracle SCM Cloud Chapter 2
Implementing Order Management Implement Business Process Flows
If the Order Entry Specialist clicks Search, then the Contact attribute displays all contacts that reference a sold-to or
ship-to contact.
Note that Contact on the order header displays party contacts. It doesn't display account contacts.
If you set the primary contact on the account site, then Order Management populates the Contact attribute on the order
header to this primary when the user sets the Customer attribute on the order header.
You might see the same contact more than one time in the list of values that displays when you click the down arrow
in the Contact attribute on the order header in the Order Management work area. To remove the duplicate, set the end
date for the duplicate contact at the party level. Don't delete it at the site level because this list of values doesn't get its
values from the site.
Assume you create a sales order for Computer Service and Rentals, and you see the Diane Cho contact two times in the
Contact list of values.
143
Oracle SCM Cloud Chapter 2
Implementing Order Management Implement Business Process Flows
The Organizations work area is part of the Customer Data Management offering. For details about the license
and user you need, see the Display Party Details on Sales Orders topic. If you don't have the license, then skip
this part of the procedure and use REST API to set the end date for the contact.
2. On the Organizations page, search for the value.
Attribute Value
3. In the search results, in the Name column, click Computer Service and Rentals.
4. On the Edit Organization page, click Relationships.
5. In the Relationships area, click View > Columns, then add a check mark to To Date.
6. Look for Diane Cho in the Related Name column. There are probably two rows that have Diane Cho. Set the To
Date in one of the rows to yesterday's date, then click Save and Close.
7. Collect data for the Organizations entity.
For details, see the Collect Planning Data for Order Management topic.
144
Oracle SCM Cloud Chapter 2
Implementing Order Management Implement Business Process Flows
5. On the Edit Contacts page, click Actions > Set Primary Contact.
If the user clicks Search, then the drop down for Contact displays each contact that references a bill-to address.
145
Oracle SCM Cloud Chapter 2
Implementing Order Management Implement Business Process Flows
Note that Contact in the Billing and Payment Details area displays account contacts. It doesn't display party contacts.
146
Oracle SCM Cloud Chapter 2
Implementing Order Management Implement Business Process Flows
Attribute Description
From Bill-to Address Get and display the payment term that you define on the bill-to address for the bill-to site
during set up.
From Bill-to Contact Get and display the payment term that you define on the bill-to account during set up.
Note.
• If you don't specify the payment term on the bill-to address or the bill-to account in Trading Community
Architecture, then Order Management doesn't set any default value for the payment term, and the Order Entry
Specialist must manually set it.
• The Order Entry Specialist can click Payment Terms to view all values that you collect during data collection,
including values from Oracle Fusion, Oracle Advanced Supply Chain Planning, your channel systems, and so on.
For details about data collection, see the How Order-to-Cash with Order Capture Systems Works topic.
147
Oracle SCM Cloud Chapter 2
Implementing Order Management Implement Business Process Flows
148
Oracle SCM Cloud Chapter 2
Implementing Order Management Implement Business Process Flows
This requirement helps to avoid problems when Financials invoices the fulfillment line. This constraint comes
predefined as disabled. You can enable it.
Set values on the Managing Processing Constraints page. For details, see the Manage Processing Constraints topic.
Attribute Description
149
Oracle SCM Cloud Chapter 2
Implementing Order Management Implement Business Process Flows
Attribute Description
Constraint Entity Prevent Order Management from performing the operation that Constrained Operation
specifies on Order Fulfillment Line.
Validation Rule Set Specifies to use the Fulfillment Line Payment Term Is Null rule set to determine whether the
Payment Term attribute on the fulfillment line contains a value.
• Order Management runs pretransformation rules each time the user modifies the Customer attribute. This
configuration makes sure Order Management updates default values according to rules you define. For details,
see the Use Business Rules With Order Management topic.
• Set up an order management extension. For example, get data from a customer entity on the sales order, and
then use this data as the default value.
• Use the DOO_ORDER_ADDRESSES_INT worksheet to specify default values for the order header and order
lines.
• Set values depending on whether your import creates or updates.
150
Oracle SCM Cloud Chapter 2
Implementing Order Management Implement Business Process Flows
Create a new sales order Send addresses on the order header, and the import will cascade order header data to the
new order line.
Update a sales order To set the order header, leave these columns empty.
To set order lines, make sure these columns contain values. An update must contain data for
each order line.
151
Oracle SCM Cloud Chapter 2
Implementing Order Management Implement Business Process Flows
• Use the instructions in the worksheet to set ship-to and bill-to values.
For details, see the Import Orders into Order Management topic.
152
Oracle SCM Cloud Chapter 2
Implementing Order Management Implement Business Process Flows
Note.
• Use the DOO_ORDER_LINES_ALL_INT worksheet of the order import template to import payment terms.
• Use the Payment Term Code or the Payment Term column.
• If you use Oracle Fusion Financials, then make sure you send payment terms for each order line in each
imported order that you must invoice.
• Order import doesn't support payment terms on the order header so you can't cascade payment terms from
the order header to order lines.
153
Oracle SCM Cloud Chapter 2
Implementing Order Management Implement Business Process Flows
◦ DOO_ORDER_HEADERS_ALL_INT
◦ DOO_ORDER_ADDRESSES_INT
154
Oracle SCM Cloud Chapter 2
Implementing Order Management Implement Business Process Flows
Copy Setups
Copy Setups Between Instances of Order Management
Copy your setup from one instance of Order Management into another instance during the lifecycle of your Order
Management deployment. For example, migrate your setup from a test environment to a production environment.
• Use the Manage Configuration Packages page in the Setup and Maintenance work area to export and import a
configuration package.
• For the list of business rules that the copy migrates, see the Migrate Business Rules in Order Management
topic.
• For details about migrating approval rules, see the Copy Approval Rules Between Instances of Order
Management topic.
• You can use WebLogic Scripting Tool (WLST) commands to move order orchestration rules. Order Management
stores order orchestration rules in the Metadata Services (MDS) Repository. You can also use data collection
and interface tables to import your setup and your transaction data. For details, see the Importing and
Exporting Setup Data section in Implementing Common Features for Oracle SCM Cloud on Oracle Help Center.
• The migration adds hold codes that you set up in the source instance to hold codes that exist in the target
instance. If the same hold codes exist in the source and target, then the holds in the source replace the holds in
the target.
• The migration doesn't migrate holds that apply a credit check hold or release a credit check hold.
• The migration migrates only your set ups. It doesn't migrate transactional data, such as sales orders.
• Don't modify the orchestration process name, task name in an orchestration process step, or the status rule
set name in either environment. Modifying the name might prevent Order Management Cloud from updating
references to other data in the orchestration process. For details, see these topics.
• If you created an order management extension, then prepare it before you migrate. For details, see the
Guidelines for Creating Order Management Extensions topic.
• If you migrate from a production environment to a test environment, and if your migration includes an
orchestration process that's currently in progress, then the sales order that references the process will become
stuck. It isn't possible to recover the stuck order.
• The migration migrates only your set ups. It doesn't migrate transactional data, such as sales orders.
155
Oracle SCM Cloud Chapter 2
Implementing Order Management Implement Business Process Flows
Attribute Value
Name Choose the name of the implementation project that defines the source instance.
7. On the Select Objects for Export page, accept default values, then click Next.
The Select Objects for Export page comes predefined to select the objects that the export needs to support
most instances of Order Management. For details about the objects you can export, see the Copy Setup Data
Between Instances of Order Management topic.
8. On the Schedule and Notifications page, accept the default value, click Submit, then, in the Warning dialog,
click Yes.
Attribute Value
9. On the Manage Configuration Packages page, examine results in the elements, then sign out.
Element Description
Export Setup Data button Export a configuration package after you create it. The export identifies setup data
according to the export definition and adds it to the configuration package.
Export a configuration package more than one time. Each export creates a different
configuration package version that you can manage individually.
Download Latest Version Download the most recent version of the configuration page.
Export and Import Processes area Get details of the export or import for each configuration package.
Click the status to get details about each step of the export or import process.
156
Oracle SCM Cloud Chapter 2
Implementing Order Management Implement Business Process Flows
Element Description
Setup Data Report View or download a report that contains the setup data exported to the configuration
package, including the business objects processed and details about errors that occurred.
Deploy Flexfields
You must deploy each flexfield that you import.
Get details.
• How to handle objects that aren't flexfields after the import, see the Importing and Exporting Setup Data
section in Implementing Common Features for Oracle SCM Cloud on Oracle Help Center.
• Flexfields, see the Deploy Extensible Flexfields in Order Management topic.
Deploy flexfields.
1. In the Setup and Maintenance work area, go to the task.
◦ Offering: Order Management
◦ Functional Area: Orders
◦ Task: Manage Order Extensible Flexfields
2. On the Manage Order Extensible Flexfields page, identify each flexfield where the deployment status isn't
Deployed, then deploy it.
3. Repeat steps 1 and 2 on each of these pages, as necessary.
◦ Manage Item Revision Descriptive Flexfields
157
Oracle SCM Cloud Chapter 2
Implementing Order Management Implement Business Process Flows
Attribute Description
Value Specify the time frame that has elapsed since the last time you deployed the flexfields. Use
this format.
For example, if one month and one day have elapsed since the last time you deployed
flexfields, then use this format.
P1M1D
You can specify only the month, only the days, or months and days.
7. Run the UpdateSOAMDS composite to synchronize SOA (Service Oriented Architecture) with flexfields in Order
Management.
8. In Order Management, in the Navigator, click Scheduled Processes.
9. On the Scheduled Processes page, click Schedule New Process, then run the Publish Extensible Flexfield
Attributes scheduled process.
Related Topics
• Deploy Extensible Flexfields
158
Oracle SCM Cloud Chapter 2
Implementing Order Management Implement Business Process Flows
Collect Reference Data and Transaction Data for Order Orchestration and Order Promising
The order orchestration and planning data repository includes the data that Order Management needs to orchestrate
sales order fulfillment and that Global Order Promising needs to promise sales orders. Use data from your source
system or from an Oracle Fusion source system to populate the repository.
Specify the source system and maintain data collection parameters for the source system. Collect data from
applications.
Application Description
• Oracle Fusion data. Including nonproduct and noncustomer reference entities for
validation and cross-reference
• Order capture codes
• Accounts receivable codes
• Accounting terms and currencies
• Miscellaneous
You must refresh Global Order Promising after you collect data to make sure it uses the data you most recently
collected.
Use pages in the Setup and Maintenance work area to manage source systems and collect data.
Page Description
Manage Orchestration Source Manage an orchestration source system and collection parameters so you can use it to collect
Systems data.
Manage Orchestration Data Manage orchestration reference data from other source systems. Specify whether to enable
Collection Processes cross-referencing for various entities, such as Currencies, Units of Measure, and so on.
Review Orchestration Collected Data Examine the data that you collected from other source systems for order orchestration.
159
Oracle SCM Cloud Chapter 2
Implementing Order Management Implement Business Process Flows
Page Description
Manage Planning Source Systems Manage planning source systems and collection parameters so you can use it to collect data.
Manage Planning Data Collection Manage planning data from a source system.
Processes
Review Planning Collected Data Examine the data that you collected from other source systems.
Monitor Planning Data Collection Monitor the planning data collection work that's currently running or that completed.
Process
Setup Description
• Export and import a configuration package to copy item setup data, such as item
Item Setup organization, item class, item catalog, item category, item lifecycle phase, and so on.
• Use item interface tables to copy items, item structures, and item relationships.
• Use the Import Items page and Monitor Item Imports page to manage item imports.
• Export, then import a configuration package to copy party setup data, such as party
Party Setup relationship type, party classification, geography lookup, trading community source
system, and so on.
• Use party interface tables to copy parties.
• Use the Import Persons and Organizations page to manage party imports.
Security Setup Use commands in Lightweight Directory Access Protocol (LDAP) to copy job roles. For
assumptions, prerequisites, and procedures, see Moving Security Artifacts in the Identity Store
in Oracle Fusion Applications Administrator Guide.
160
Oracle SCM Cloud Chapter 2
Implementing Order Management Implement Business Process Flows
Export and import business objects in the Supply Chain Management family.
Advanced Supply Chain Manage Enterprise Scheduler Manage Oracle Enterprise Enterprise Scheduler Job List
Planning Jobs for Advanced Planning Scheduler jobs and their list of of Values Source
Applications values sources for Advanced
Planning applications, such as
Global Order Promising.
Advanced Supply Chain Manage Global Order Manage profile options and Application Profile Value
Planning Promising Profile Options values to control Oracle Fusion
Global Order Promising, such
as page display defaults or
timeout parameters.
Order Management Generate Constraint Package Create a dynamic package Orchestration Change
that activates new validation Constraint
rule sets for processing
constraints.
Order Management Manage Constraint Entities Manage the entities to use Orchestration Change
when applying constraints. Constraints Object
Order Management Manage Enterprise Scheduler Manage jobs for Oracle Enterprise Scheduler Job List
Jobs for Order Orchestration Enterprise Scheduler and the of Values Source
sources that these jobs use
for lists of values in Order
Management.
Order Management Manage Hold Codes Manage the abbreviations that Orchestration Hold Code
Order Management uses to
hold processing for a sales
order or order line.
161
Oracle SCM Cloud Chapter 2
Implementing Order Management Implement Business Process Flows
Order Management Manage Jeopardy Priorities Manage score codes that Orchestration Jeopardy
indicate the severity of the Priority
delay of a task.
Order Management Manage Jeopardy Thresholds Manage jeopardy threshold Orchestration Jeopardy
definitions that determine Threshold
the degree of action to take
when orchestration highlights
potential or actual fulfillment
issues because of delays.
Order Management Manage Order Lookups Manage lookup values for Application Standard Lookup
order orchestration, such
as Return Reason Code or
Activity Type.
Order Management Manage Orchestration Process Manage definitions that Orchestration Process
Definitions specify how to perform
orchestration processing.
Order Management Manage Orchestration Profiles Manage profile definitions Application Profile Value
to specify how orchestration
processes data.
Order Management Manage Order Attributes That Manage the attributes Orchestration Change
Identify Change necessary to identify changes Attribute
in each sales order.
Order Management Manage Processing Manage the rules that control Orchestration Change
Constraints attempted changes to order Constraint
orchestration.
162
Oracle SCM Cloud Chapter 2
Implementing Order Management Implement Business Process Flows
Order Management Manage Status Values Manage status values for Orchestration Status Code
tasks.
Order Management Manage Task Status Manage the process status Orchestration Status
Conditions conditions that indicate when
the process uses a status.
Specify these conditions when
you define the orchestration
process.
Order Management Manage Task Types Manage the task types that Orchestration Task
group tasks and services for
status management, jeopardy,
orchestration processes, and
run time behavior.
Global Order Promising Manage Order Promising Manage profile option settings Application Profile Value
Server Profile Options and values to control Oracle
Order Promising Server,
such as setting the sourcing
assignment set or enabling an
external ATP Web service.
Inventory Management Manage Enterprise Scheduler Manage Oracle Enterprise Enterprise Scheduler Job List
Jobs for Logistics Common Scheduler jobs and their list of Values Source
Applications of values sources for Logistics
Common Components.
Inventory Management Manage Units of Measure Manage units of measure Unit of Measure
that your organization uses
to identify the quantity of an
item. Unit of Measure Class
Product Model Create Catalog Create an item catalog, and Item Catalog, Item Category
add attachments and images.
Product Model Manage Enterprise Scheduler Manage Oracle Enterprise Enterprise Scheduler Job List
Jobs for Product Management Scheduler jobs and their list of Values Source
Common Applications of values sources for Product
Management Common
Components.
Product Model Manage Default Catalogs Manage catalog assignments Functional Area Item Catalog
for functional areas.
163
Oracle SCM Cloud Chapter 2
Implementing Order Management Implement Business Process Flows
Product Model Manage Default Item Class Manage the root item class. Item Class
Product Model Manage Item Organizations Manage item organization Item Organization
structures to use in
standalone application
deployments with Oracle
Fusion Product Model.
Product Model Manage Key Flexfield for Manage key flexfield Application Key Flexfield
Catalogs segments for each catalog and
the validation to use for the
catalog classification key. You
must define the catalog key
flexfield to make sure Oracle
Fusion Product Model works
as expected.
Product Model Manage Lifecycle Phases Manage the phases of each Item Lifecycle Phase
item lifecycle.
Supply Chain Management Manage Data Security Policies Manage grants of entitlement Application Data Security
Common Components for each user or role on an Policy
object or attribute group
according to a condition.
Common Family
Export and import business objects in Oracle Middleware Extensions for Applications in the Common family.
Manage Administrator Profile Values Manage profile option settings and values Application Profile Value
to control application behavior.
Manage Applications Manage profile option settings and values Application Profile Value
to control Oracle Middleware Extensions
for Applications behavior.
Core Administrator Profile Values
Manage Applications Core Attachment Manage attachment categories for Oracle Application Attachment Category
Categories Middleware Extensions for Applications.
164
Oracle SCM Cloud Chapter 2
Implementing Order Management Implement Business Process Flows
Manage Applications Core Attachment Manage attachment entities for Oracle Application Attachment Entity
Entities Middleware Extensions for Applications.
Manage Applications Core Descriptive Manage descriptive flexfields for Oracle Application Descriptive Flexfield
Flexfields Middleware Extensions for Applications.
Manage Applications Core Messages Manage messages for Oracle Middleware Application Message
Extensions for Applications.
Manage Applications Core Profile Manage categories to group profile Application Profile Category
Categories options in Oracle Middleware Extensions
for Applications according to their
functional area. Use categories to search
for related profiles and to define data
security rules.
Manage Applications Core Profile Options Manage profile options that affect Oracle Application Profile Value
Middleware Extensions for Applications
behavior, and specify the levels at which
they can be set.
Manage Applications Core Standard Manage lookup values for Oracle Application Standard Lookup
Lookups Middleware Extensions for Applications.
Manage Applications Core Value Sets Manage value sets for Oracle Middleware Application Flexfield Value Set
Extensions for Applications.
Manage Attachment Categories Manage categories for attachments for Application Attachment Category
security purposes.
Manage Attachment Entities Manage the default repository folders to Application Attachment Entity
use when storing attachments for each
application entity.
Manage Common Lookups Manage lookups that are common across Application Common Lookup
applications and used in the common
lookup views.
Manage Data Security Policies Manage grants of entitlement to each user Application Data Security Policy
or role on an object or attribute group
according to a condition.
Manage Descriptive Flexfields Manage segments, validation, and Application Descriptive Flexfield
display properties of descriptive flexfields
that you use to store details about an
165
Oracle SCM Cloud Chapter 2
Implementing Order Management Implement Business Process Flows
Manage Document Sequence Categories Manage categories that group documents Application Document Sequence Category
for sequencing purposes.
Manage Document Sequences Manage document sequences to create Application Document Sequence
an audit trail that identifies the application
that created the transaction.
Manage Extensible Flexfields Manage segments, validation, and display Application Extensible Flexfield
properties of extensible flexfields that you
use to store details about an enterprise
that Order Management doesn't typically
store.
Manage ISO Languages Manage ISO languages. Application Reference ISO Language
Manage Key Flexfields Manage key flexfield segments and Application Key Flexfield
validation. You must define most key
flexfields so that the applications work as
expected.
Manage Messages Manage messages that you use in each Application Message
application.
Manage Natural Languages Manage natural, spoken languages. Application Reference Natural Language
Manage Profile Categories Manage categories that group profile Application Profile Category
options according to functional area. Use
categories to search for profiles and to
define data security rules.
Manage Profile Options Manage profile options that affect Application Profile Value
application behavior, and specify the
levels at which they can be set.
Manage Reference Data Sets Manage sets for separating and sharing Application Reference Data Set
reference data across organizations.
Manage Set Assignments for Set Manage reference data set assignments to Application Reference Data Set
Determinant Type determine the type of set. Assignment
166
Oracle SCM Cloud Chapter 2
Implementing Order Management Implement Business Process Flows
Manage Set Enabled Lookups Manage lookups with codes that vary Application Set-Enabled Lookup
depending on the value of the reference
data set determinant and are exposed in
the set-enabled lookups view.
Manage Standard Manage lookups that are common across Application Standard
applications and used in the lookups view.
Lookups Lookup
Manage Taxonomy Hierarchy Manage the hierarchy of functional units Application Taxonomy
that make up Oracle Fusion Applications,
from product families and applications to
functional components.
Manage Time Zones Manage time zones. Application Reference Time Zone
Manage Tree Labels Manage the labels to use as tags for tree Application Tree Label
nodes.
Manage Tree Structures Manage tree structures to group common Application Tree Structure
business rules for a family of trees.
Manage Trees and Tree Versions Manage trees to contain data in a Application Tree
hierarchy, allowing the user to group and
consolidate details that already exist in an
organization.
Manage Value Sets Manage value sets to validate the content Application Flexfield Value Set
of a flexfield segment.
Register Descriptive Flexfields Register the existence of descriptive Application Descriptive Flexfield
flexfields on a table.
Set Activity Stream Options Set options that determine the types of Application Activity Stream Configuration
activities to display in the Activity Stream
regions in Oracle Fusion Applications.
Export and import business objects in the Transactional Business Intelligence application in the Business Intelligence
family.
167
Oracle SCM Cloud Chapter 2
Implementing Order Management Implement Business Process Flows
Configure Descriptive Flexfields for Specify validation and display descriptive Application Descriptive Flexfield
Transactional Business Intelligence flexfield properties for Transactional
Business Intelligence. Use descriptive
flexfields to add modified attributes to
entities.
Configure Key Flexfields for Transactional Specify the key flexfield segments and Application Key Flexfield
Business Intelligence validation to use as classification keys
for Transactional Business Intelligence.
You must specify these flexfields so
Transactional Business Intelligence works
as expected.
Export and import business objects in the Customer Relationship Management family.
Marketing Manage File Import Mappings Manage mappings between File Import Mapping
columns in a source file in a
source system and columns
in a staging table in Order
Management. Use these
mappings when you import
business objects, such as sales
leads, customers, contacts, or
sales catalogs.
Marketing Manage File Import Objects Manage business objects, File Import Object
such as sales leads and
opportunities, that you can
import from a file.
Trading Community Model Enable Click to Dial Enable automated dialing Application Profile Value
when clicking a phone
number.
Trading Community Model Manage Geography Lookups Manage lookup values that Application Standard Lookup
provide choices related to
geographies, such as different
ways to validate an address.
Trading Community Model Manage Import Lookups Manage lookup values that Application Standard Lookup
provide choices about data
import batch processing,
such as batch status, batch
identifier, batch configuration,
or process status.
168
Oracle SCM Cloud Chapter 2
Implementing Order Management Implement Business Process Flows
Trading Community Model Manage Source System Manage fields the user Application Descriptive
Descriptive Flexfields can use to enter details. Flexfield
Validate descriptive flexfields
according to values that the
user enters in other areas of
the page.
Trading Community Model Manage Source System Manage entity associations for Trading Community Original
Entities source systems. For example, System Mapping
use one source system to
import customer data, and use
another to import customers Trading Community Source
and contacts. System
Trading Community Model Manage Source System Manage lookup values that Application Standard Lookup
Lookups provide choices related to the
source system model, such as
original system type.
Trading Community Model Manage Trading Community Manage the source system for Examine and define the types
Source Systems a trading community. of information imported for
each source system
Export and import business objects in the Human Capital Management family.
Global Human Resources Manage Enterprise HCM Manage details about the Enterprise
Information enterprise, such as details
about the default work day.
Global Human Resources Manage Locations Manage locations for your Location
enterprise. For example, create
the locations where people
work or the locations of your
external organizations.
Financials Family
Export and import business objects in the Financials Common Module application in the Financials family.
169
Oracle SCM Cloud Chapter 2
Implementing Order Management Implement Business Process Flows
Manage Business Unit Manage details about enterprise units Business Unit, Business Unit Detail
to provide a consistent entity so you
can control and report on transactions,
and to share reference data sets across
applications.
Manage Business Unit Set Assignment Manage reference data that represents Business Unit Set Assignment
business rules and policies. Assign this
data to business units.
ATF Family
Export and import business objects in the Application Toolkit application in the ATF family.
Manage Help Security Groups Manage security groups that you Application Data Security Policy
associate with help to determine who can
access it. Associate each group with a
duty role. This page creates lookup codes, Application Standard Lookup
database resource conditions, and data
security policies that you can edit.
Map Reports to Work Areas Select the reports that display in the Reports and Analytics Mapping
Reports and Analytics area in Oracle
Fusion Applications work areas.
Set Help Options Set options for help features, such as Help Configuration
collaboration, access to external web sites,
settings for modified help content, or
access to an Oracle User Productivity Kit Help Topic
library.
Set Watchlist Options Specify the Watchlist categories and items Watchlist User and Site Preference
that are available at your site.
Export and import business objects in GRC Application Access Controls Governor application of the Governance Risk
and Compliance family.
Manage Application Access Controls Manage rules and resolve issues regarding Governance Risk and Compliance Setup
access in an application. Configuration
170
Oracle SCM Cloud Chapter 2
Implementing Order Management Implement Business Process Flows
Manage Application Configuration Manage rules and resolve issues regarding Governance Risk and Compliance Setup
Controls configurations in an application. Configuration
Manage Application Preventive Controls Manage rules regarding how users interact Governance Risk and Compliance Setup
in an application. Configuration
Manage Application Transaction Controls Manage rules and resolve issues regarding Governance Risk and Compliance Setup
transactions in an application. Configuration
171
Oracle SCM Cloud Chapter 2
Implementing Order Management Implement Business Process Flows
172
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
3 Integrate
Introduction
Overview of Integrating Order Management
Use web services to integrate Order Management with other applications and systems.
Order Management comes predefined with integrations to other Oracle cloud services so you can use fulfillment
processes that require minimal set up to get them up and running in your environment.
For example, Order Management and Oracle Fusion Inventory Management work together to fulfill each sales order that
an Order Entry Specialist enters in the Order Management work area or that you import from a source system.
173
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Use a web service to integrate with some other Oracle application, a third-party cloud application, or an on-premise
application that your supply chain uses to complete the order-to-cash process. Here are some ideas.
Note.
Integration Description
Integrate with cloud processes. Integrate cloud processes, including order-to-cash, drop-ship, back-to-back, configure-to-
order, or internal orders.
174
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Integration Description
Integrate with other applications. Order Management comes predefined with integrations to cloud services.
Inventory, shipping, receiving, finance, and order management are each an example of a
fulfillment system.
Here are some examples of the functionality you can implement through integration.
Related Topics
• Fix Connection Problems with Source Systems
175
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Guidelines
Guidelines for Integrating Order Management
Use a variety of technologies to integrate Order Management with a fulfillment system that resides outside of Oracle
Fusion.
Get details.
Business Event Integrate your business processes to Overview of Using Integration Cloud
operate across applications in the cloud or Service to Integrate Order Management
on premise.
Web Service Integrate with some other Oracle Overview of Using Web Services to
application, a third-party cloud Integrate Order Management.
application, or an on-premise application
that your supply chain uses to finish the
order-to-cash process.
Order Management Extension Write your own Groovy script that Overview of Setting Up Extensions That
modifies your Order Management Modify Order Management
deployment, implements your own
functionality, and specifies the extension
176
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
File Based Data Import Use an Excel file to simplify order import. Overview of Importing Orders into Order
This file contains a structure that the Management
Oracle database requires for each
database table.
177
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Note.
1. Use the import web service, file-based data import, or B2B messaging (business-to-business) to import source
orders from your source system into Order Management.
2. A step in your orchestration process starts the integration. Order management assigns each source order to an
orchestration process. The orchestration process orchestrates fulfillment for each fulfillment line. You add an
integration step that integrates the orchestration process with your fulfillment system.
3. Web service endpoints identify each of your fulfillment systems that reside outside of Oracle Fusion.
4. Routing rules specify the conditions to use when determining how to route each fulfillment line to each
connector.
178
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
5. Order Management creates a service data object (SDO) and sends a request that includes the SDO payload. The
SDO contains details about the endpoint, connector to use, fulfillment lines, and so on.
6. A connector web service transforms the SDO payload into a message payload that your fulfillment system
can understand, and then calls the fulfillment system. You can create a separate connector for each of your
fulfillment systems.
Note.
• To avoid logic problems, make sure rules are mutually exclusive. Make sure no two rules can be true at the same
time, or false at the same time. For details, see the Guidelines for Creating Business Rules topic.
179
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
◦ To aggregate fulfillment lines before you send them to your fulfillment system, use the Maximum Lines
to Aggregate and Send attribute and the Maximum Time to Wait Before Sending attribute. Run several
tests and adjust these values after each test until you achieve the optimal balance between waiting and
performance.
◦ Use other attributes to control processing, as necessary, such as Resolve Cross-Reference for Customer
to determine whether to use a cross-reference, or Set Acknowledgement Timeout to determine how long to
wait before exiting out of an implicit wait during an interaction with your fulfillment system.
For details, see the Actions You Can Set in Routing Rules topic.
• Use Perform an Action. Avoid using Set a Value. Perform an Action automatically filters attributes and values
for you to help make sure you specify values that the rule can understand.
180
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Enable Cross-References
You must create and maintain cross-references that relate business data between your fulfillment system and Order
Management Cloud. Use the Manage Planning Source Systems page as part of this set up.
Attribute Value
181
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Attribute Value
More
• Set up status behavior. Order Management typically sends statuses for each fulfillment line to your fulfillment
system throughout the order fulfillment lifecycle. In return, your fulfillment system can send status updates to
Order Management. You can set up this behavior. For details, see Orchestration Process Status topic.
• Determine whether you must add a wait step. For example, if a task occurs almost instantly, as with credit
check, then you typically don't need a wait step. However, a task that requires a long time to finish typically
does require a wait step to allow the orchestration process to pause for the task to finish. For details, see the
Overview of Pausing Orchestration Processes topic.
• Set up failure logic. For example, if a task fails, then it goes into error recovery and you must retry or recover the
task.
Assume your analysis determines you must allow an Order Manager to override a delivery confirmation that
fails and allow processing to continue. You can set up an extensible flexfield that allows the Order Manager to
record the results of the transaction, then set up a pause task that uses the contents of the flexfield to allow the
process to release the pause and continue to the next step.
• Use business events and web services with Integration Cloud Service. For details, see the Overview of Using
Integration Cloud Service to Integrate Order Management topic.
• Use Order Management Extensions. For details, see the section about calling web services in the Guidelines for
Setting Up Order Management Extensions topic.
• Pay attention to case-sensitive usage. A number of the objects that you use during integration use case-
sensitive text. Make sure you use the case-sensitive text that the predefined objects use and that you see in the
documentation. For example.
Failing to use the correct case-sensitive text might not cause an obvious compiler error, but might result in
runtime problems that are more difficult to troubleshoot, such as data not displaying on an invoice.
Related Topics
• Fix Connection Problems with Source Systems
182
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Add each role to the user that you use to call the web service. For example, if your integration manages shipping details,
then add privilege Manage Orchestration Order Shipping Interface Web Service.
Add the Manage Order Specialist duty role for an upstream integration to your source system, for example, for order
import.
For details about job roles, duty roles, and how to set them up, see book Oracle SCM Cloud Security Reference for Order
Management on Oracle Help Center.
183
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Note.
184
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Note.
1. Add the step at the point in your orchestration process where you must integrate. This example integrates after
the orchestration process finishes the schedule, promise, reserve, and ship tasks, but before the invoice task.
2. On the integration step, set the Task Type attribute and the Task attribute to the task type you set up on the
Manage Task Types page.
3. Set the Service attribute to the service you set up on the Services tab of the Manage Task Types page.
For details, see the Set Up Orchestration Processes topic.
185
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Note.
https://server:port/7818/soa-infra/services/default/ConfirmDelivery
186
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
To make sure the connection is secure, use https in the URL. Don't use http.
• Use the User Name and Password attributes to specify the name and password you use when you sign into
fulfillment system 3. In this example, assume you set up a user named myName on System 3.
◦ Use a user name that works with an SSL security policy (secure sockets layers) that you set up on your
fulfillment system.
◦ Make sure the user name and password you specify are valid on your fulfillment system. Use them to
verify that you can successfully sign into your fulfillment system. Note that this name isn't the name you
use to sign into Oracle Fusion.
◦ Use CA signed certificates (certification authority) on your fulfillment system and on the connector.
• For details, see the Manage Connector Details That Integrate Order Management with Fulfillment Systems
topic.
For example.
• If you use this connector to communicate a business event, then set the Keystore Recipient Alias attribute to
NA, and set the Invocation Mode attribute to Business Event.
187
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
• If you use this connector with a web service, then set Invocation Mode to Asynchronous Service or Synchronous
Service.
Note.
1. Use Visual Information Builder to create the rule. For details, see the Overview of Using Business Rules With
Order Management topic.
2. Add an If statement to determine whether the task type matches the type you specified in the Task Type
attribute on the orchestration process step.
188
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
3. Add a Then statement to set the Connector Name attribute to the connector you created earlier that connects
to your fulfillment system.
4. Add a Then statement to set the Interaction Interface Type attribute. Recall from the flow that order
orchestration uses an SDO payload to communicate with your fulfillment system. You must use Service Data
Object for any new implementation. Use other values only for backward compatibility to an earlier Oracle
Fusion release.
189
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Summary
Here's a summary of the set up you do.
Related Topics
• Fix Connection Problems with Source Systems
190
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Guidelines for Sending the Response from Your Order Fulfillment System
The connector sends a request to your order fulfillment system, then the fulfillment system sends a response. You can
use services to communicate status updates from your fulfillment system to Order Management.
Order Fulfillment Response Service Overview of Using Integration Cloud Service to Integrate Order Management
For example.
• If you use Oracle Application Development Framework (ADF), then use the host and port for FSCMServices.
• If you use Oracle Service-Oriented Architecture (SOA), then use the host and port for FASOA (Oracle Fusion
Applications, Service-Oriented Architecture).
191
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
The payload that your fulfillment system sends must include these attributes.
<ns2:FulfillLineId>Id number</ns2:FulfillLineId>
<ns2:SourceOrderSystem>system name</ns2:SourceOrderSystem>
For example.
<ns2:FulfillLineId>300100072403436</ns2:FulfillLineId>
<ns2:SourceOrderSystem>GPR</ns2:SourceOrderSystem>
where
As an option, you can also send other attributes, such as ShippedQuantity, according to your business requirements.
Order Management needs SourceOrderSystem so it can get the user name, password, and Keystore Recipient Alias
from the Manage Connector Details page and use them when it sends a reply to your order fulfillment system. It uses
SourceOrderSystem to search the list of connectors on the Manage Connector Details page. It searches the list in
alphanumeric order, and chooses the first connector it finds where the value in the Target System attribute matches the
value in SourceOrderSystem. Make sure you add your connectors and name them so Order Management uses the one
you need.
192
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Assume SourceOrderSystem contains OrderCapture1, and the Manage Connector Details page contains three
connectors.
Order Management will use the Administrator1 user, password, and Keystore Recipient Alias from the row for My
Connector A.
193
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
The payload that your fulfillment system sends must include these attributes.
<com:IntegrationContextCode>context_code</com.IntegrationContextCode>
<com:FulfillmentSystem/>
<com:FulfillLineIdentifier>numeric_value</com:FulfillLineIdentifier>
<com:TaskInstanceStatusCode>status_code</com:TaskInstanceStatusCode>
For example.
<com:IntegrationContextCode>DOO_TransportationPlanning</com.IntegrationContextCode>
<com:FulfillmentSystem/>
<com:FulfillLineIdentifier>3001000071295736</com:FulfillLineIdentifier>
<com:TaskInstanceStatusCode>DOO_TP_DELIVERED</com:TaskInstanceStatusCode>
where
• DOO_TransportationPlanning is the IntegrationContextCode.
• 3001000071295736 is the FulfillLineIdentifier.
• DOO_TP_DELIVERED is the TaskInstanceStatusCode.
194
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Related Topics
• Fix Connection Problems with Source Systems
Oracle Applications
Overview
Overview of Integrating Order Management with Other Oracle Applications
Integrate Order Management to send details to some other Oracle application.
Use a predefined attribute to send details, or create an extensible flexfield in Order Management to store them, then
map it to some other Oracle application.
For example.
• Map the Purchase Order Line Number attribute on a fulfillment line in Order
Oracle Receivables Management (CUSTOMER_PO_LINE_NUMBER) to the Invoice Line Level descriptive
flexfieldin Oracle Receivables. Order Management doesn't come predefined to display
this attribute.
• Create an extensible flexfield on the order header or order line in Order Management.
Map this flexfield to an interface column or descriptive flexfield in Oracle Receivables.
• Send a concatenated value that represents the attributes of a covered item, such as
Description, Start Date, or End Date, to the TranslatedDesription attribute in Oracle
Receivables. Use an interface column in Oracle Receivables to send the data.
• Send a covered item description, such as hardware, with coverage lines. Send freight
charges that apply for a covered item as a separate line so you can invoice freight by
itself.
Oracle Procurement Create an extensible flexfield on a fulfillment line in Order Management to capture the price for
the item. You can send the price that you negotiate with your supplier to the purchase request
in Oracle Procurement.
Order Management comes predefined to send a set of attributes to your fulfillment system for
a purchase order in a drop ship flow. You can use a service mapping to send an attribute that
isn't predefined. For example, send a price that you negotiate with your supplier during drop
ship, or send a deliver-to address to your supplier during drop ship.
195
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Oracle Receiving Create extensible flexfields on the fulfillment line in Order Management to capture lot details
and serial details. Send these details to the receiving request in Oracle Receiving.
196
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
How it Works
Note.
1. Capture order details, such as in a sales order that you create in Order Management.
2. Use a predefined task type in the integration step of your orchestration process to send details to your
fulfillment system.
3. Did you enable the Enable Custom Payloads for Downstream Integration feature?
197
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Enabled Description
Yes Use the service mapping. You can set up the payload to integrate with your fulfillment
systems.
No Use the predefined SDO payload (service data object) and proceed to fulfillment. For
an example that uses an SDO, see the Send Charges from Order Management to Oracle
Receivables topic.
4. Call the service mapping that you set up that maps attributes between Order Management and your fulfillment
system.
5. Did you create an integration algorithm?
Yes Call it. Use the integration algorithm to do more complex logic, as necessary.
6. Use the service mapping and the integration algorithm to create the payload.
Note.
• You set up an integration algorithm and a service mapping when you create the integration.
• An integration algorithm uses logic that's similar to a pricing algorithm.
• A service mapping that you set up for an integration uses logic that's similar to the service mapping that you
set up for pricing.
• You use the Pricing Administration work area to set up the integration algorithm and the service mapping that
you use for integration. However, your service mapping and integration algorithm are completely separate
from Pricing. You use Pricing Administration only to leverage some of the logic that Pricing uses for its service
mappings and integration algorithms.
• An integration algorithm and the service mapping that you set up for an integration doesn't affect pricing.
Related Topics
• Pricing Algorithm
• Service Mapping
Get Started with Integrating Order Management with Other Oracle Applications
Enable the features you need and determine whether you need a service mapping, integration algorithm, or both when
you integrate Order Management with another Oracle application.
Enable Feature
Enable the feature you need.
1. Go to the Setup and Maintenance work area, then choose the Order Management offering.
2. Click Actions > Change Feature Selection.
3. On the Edit Features page, in the Enable Custom Payloads for Downstream Integration row, click Features.
198
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
199
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Note.
◦ Each integration adds processing overhead. To improve performance, enable only the integrations you
need.
◦ If you don't enable the feature, then you can still send a predefined SDO payload to your fulfillment
system, but you can't send a payload that includes your service mapping or integration algorithm.
5. Click Save and Close, then click Done.
200
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Note.
Object Usage
Service mapping Map an attribute from an entity in the view object that you're using as the source. Don't use an
integration algorithm to do this mapping.
• From an entity other than the view object that you're using as the source. For example,
use an algorithm to map an attribute from the order header to an interface line.
• With an extensible flexfield.
• To a descriptive flexfield in Accounts Receivable.
201
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
The Service Mappings page and Algorithms page use values that are case sensitive. Enter exact names consistently,
including _ (underscore), upper case, and lower case letters.
• Use a service mapping to map attributes from entities in the source view object. Don't use an integration
algorithm to map them.
• If you add an attribute in the Sources tab, then make sure you also add it on the Services tab for each entity. If
you forget to add it in Services, then the algorithm might run but not include your attribute in the payload.
• Use an expression or view object attribute to assign a value.
• Use the Expressions attribute to implement simple logic, such as If, If Then, If Then Else, or to concatenate.
• If you add an extensible flexfield.
◦ Add it in the Entities tab, Sources tab, and Services tab. Add it in all three tabs. Don't add it in only one or
two of these tabs.
◦ Add an entity for your extensible flexfield one time for each context that you require.
◦ Reuse an entity for your extensible flexfield in more than one service, as necessary.
• Use an algorithm to map attributes from entities other than the view object or when you use a flexfield.
• Remember to enter the algorithm name on the Services tab.
• Remember to publish your algorithm.
• If you encounter a runtime error when a task runs, then correct the algorithm and recover the task.
Related Topics
• Create a Sandbox So You Can Edit Service Mappings
Assume you have a special relationship with your customer where you use Oracle Fusion Procurement as part of a drop
shipment. You need to capture details about each deal that you make with the customer on the order header, identify
the quote for the vendor, and specify how you must submit the invoice on each sales order. And then on the order line,
you.
• Override the price for the ASR1006 Chassis item and add your own price that you negotiate with your supplier.
This is the price that Order Management will send on the purchase order for the drop ship to supplier. It isn't the
price for your customer.
• Identify the stock keeping unit (SKU) for the item.
202
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
1. You use extensible flexfields and descriptive flexfields to add attributes to the order header and the order line.
◦ Deal Identifier
◦ Vendor Quote Number
◦ Invoice Submission
◦ Item Cost
◦ Service SKU
203
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
◦ Drop Shipment PO
2. You use a service mapping to map these attributes between Order Management and Oracle Fusion
Procurement.
3. You create an integration algorithm that specifies how to assign values to these attributes.
4. At run time, you use the Procurement work area to verify that your integration accurately reflects data from
Order Management.
As part of development, you create a mock up that illustrates the approach you will use to implement the requirement.
Related Topics
• Pricing Algorithm
• Service Mapping
Guidelines
Create Your Service Mapping
Learn how to use a service mapping when you integrate Order Management with another Oracle application.
Note.
204
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Object Description
Context You specify the context for each service mapping. The context is the overall container for all
objects that you create in your set up.
Entity Specify the structure of each object. Examples of an entity include the order header, fulfillment
line, purchase order request, and so on.
Source Create what your mapping uses as the source for attribute values.
Service Specify the attributes to send to your fulfillment system. You use it in the output that
communicates with the fulfillment system. For example, in the structure of the SDO.
205
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Note.
• You use the Pricing Administration work area to leverage the service mapping functionality that Pricing
Administration provides, but you aren't setting up pricing.
• Sign in as order administrator. Don't sign in as pricing manager.
• In the Navigator, click Pricing Administration.
• Click Tasks, then, under Order Management Configuration, click a link.
• Don't click links under Pricing Configuration.
206
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Note.
207
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Specify Source
Note.
208
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
• View object attribute specifies the attribute in the view object to use as the source for the value. Do specify the
view object attribute.
If you select a new source from a predefined entity, then you must add a suffix to entity name.
Flexfield Suffix
209
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Specify Service
Note.
210
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Related Topics
• Create a Sandbox So You Can Edit Service Mappings
211
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Note.
◦ Header Information
◦ Fulfillment Line Information
◦ Fulfillment Line Detail Information
4. Click Actions > Download Flexfield Archive.
5. Open the .zip file you downloaded and navigate to oracle/apps/scm/doo/processOrder/flex/
myObjectContextsB/view/myVO.xml.
where
212
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Note.
1. Expand ViewObject.
2. Notice the value in the Name attribute of the view object. This is the name of the view object that you copy and
paste into the View Object attribute of your service mapping.
The name in the screen capture above is truncated. The full name for this example is
FulfillLineEffBItemPriceForSupplierprivateVO.
213
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
5. Expand ViewAttribute.
6. Notice the value of EntityAttrName. This is the name of the view object that you copy and paste into the
attribute View Object Attribute of your service mapping. EntityAttrName for the example earlier in this topic
would equal _complianceInfo.
214
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Specify Entity
Note.
You must use the EFF_Custom suffix for entity name. For example, OMHeaderEFF_Custom. If you don't use this
suffix, then your service mapping will fail.
3. Add an attribute that identifies the entity. In this example, HeaderId identifies the sales order header.
4. Add an attribute that contains data.
Note.
• Specify the data type. If you don't specify the correct data type for the attribute, then your service mapping will
fail.
215
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
This example uses the Long data type for the HeaderId attribute because identifiers are typically a Long
numeric value. It uses String for the complianceInfo attribute because, in this example, complianceInfo contains
text.
• Use the _Custom suffix for attributes.
Specify Source
Note.
1. Click Sources.
2. On the Entity Mappings tab, add your new entity, such as OMHeaderEFF_Custom.
216
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
◦ Locate the view object name in the XML of the flexfield archive, copy it, then paste it into the View Object
attribute. In this example, the view object name is HeaderEFFBComplianceDetailsprivateVO.
◦ The values must match exactly, or your service mapping will fail. To avoid problems, use copy and paste.
Don't manually enter it.
◦ Add your attributes.
For each attribute you add, locate the view object attribute in the XML, copy it, and paste it into the
attribute View Object Attribute. In this example, notice that the _complianceInfo view object attribute
begins with an underscore because the XML also contains an underscore.
Add Entity
• Before you add the entity, click View > Joined Entity > Joined Entity Attribute.
• Set values.
Attribute Value
217
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Attribute Value
Joined Entity Attribute Specify the attribute in the entity you're joining, such as HeaderId.
Related Topics
• Create a Sandbox So You Can Edit Service Mappings
218
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Note.
219
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
◦ Provide a value.
◦ Reference an attribute in a view object or add an expression.
◦ You typically add an expression.
◦ If you add a string in your expression, then enclose it with double quotation marks ( " " ).
Note.
• A view object, such as FulfillLineVO, contains attributes, such as FulfillLineId.
• VO is an abbreviation for view object.
220
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
• The value you chose for the View Object attribute determines the values you can choose for the attribute View
Object Attribute.
Note.
1. Use a predefined entity for accounts receivable, such as TransactionInterfaceHeaderDff, which is a descriptive
flexfield that stores details about the receivables transaction header. Examine the entities that are available on
the Entities tab to identify the one you need.
221
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
◦ FulfillLineId
◦ NameSpace
◦ XsiType
◦ _FLEX_Context
You must add these attributes for each context entity that you define for a descriptive flexfield.
3. Add the descriptive flexfield attributes that you must send to accounts receivable, such as
GlobalSegment1_Custom.
Note.
If you must map an attribute from the order header, extensible flexfield, or fulfillment line detail, then you must use an
integration algorithm. Order Management uses this hierarchy.
Order header
Fulfillment line
Fulfillment line details
Other Oracle applications might not organize these objects into a hierarchy. Instead, they might represent them in
a single object named ARLine. ARLine also includes descriptive flexfields, so it can represent the same data that
the fulfillment line represents. If you must copy attributes from the fulfillment line to ARLine, then you require an
integration algorithm only if you must implement conditional logic.
222
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Note.
223
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Attribute Expression
"Gl1"+ProductNumber.substring(0,Math.min(11,ProductNumber.length))
NameSpace Enter the value from the XML file you downloaded for your flexfield archive. For example.
"http://xmlns.oracle.com/apps/financials/receivables/transactions/
shared/model/flex/TransactionHeaderDff/"
For example.
"TransactionHeaderFLEX"
_FLEX_Context Enter the value of the context code from the XML file you downloaded for your flexfield
archive.
This example uses GlobalSegment1, so you can leave _FLEX_Context empty. If you didn't
include a global segment in this example, you would enter "ItemPriceForSupplier".
224
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Note.
225
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Attribute Alias
GlobalSegment1_Custom _AR_5FRRRF_5FDFF_5FRCT_5FGlobal_2D1
Order Management uses this value when it creates the payload to create the task.
If you prefer to send this value in your integration algorithm, then you add it to the algorithm
instead.
5. Add the predefined attributes. It isn't necessary to define the alias for predefined attributes.
Related Topics
• Create a Sandbox So You Can Edit Service Mappings
226
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Create Algorithm
Note.
• When you create the algorithm, save the header before you work on details.
• You must set up the algorithm and variables.
• Functions are optional.
• Test is a design time test. It isn't a run time test. Its optional, but recommended.
227
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Use Variables
Note.
• Create and save the header first, and then set up the variables. Don't define the algorithm yet because you use
variables in the algorithm. You must set up the variables first.
• Click Variables.
• Set attributes.
Attribute Value
Name Enter a meaningful name because the value you enter will display throughout the set up.
228
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Attribute Value
where
Caution: Its important to choose the correct service. If you choose the wrong service, the
integration will fail.
229
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Add Step
Note.
1. Click Algorithm.
2. Add steps. At run time, the algorithm runs the steps sequentially.
3. Enter a name.
4. Set up the data set that determines which records to process in this step.
5. Set up the condition and action that determines how to process records.
230
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Attribute Description
where
• VariableName. Name of the variable you defined on the Variables tab, such as
ARChargeIntegration.
• Entity. Copy and paste the entity name from your service mapping.
If you join many order lines to one order header, then choose Many.
231
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Attribute Description
where
Note.
• The algorithm runs the default action when algorithm logic doesn't meet any other conditions.
• This predefined action interfaces freight charges as a separate line item on the invoice.
• Predefined code is commented. Remove comments to enable the action.
• Write your code in Groovy script.
• Use comments to document your code.
232
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
• Make sure the variable isn't empty before you use it as the source for a value. In particular, make sure your
extensible flexfield contains a value. If it doesn't contain a value, then you can't get a value from it, and your
algorithm might fail.
• Use format DatasetName.Alias.
where
◦ DatasetName. Name of the data set that you defined in the integration algorithm.
◦ Alias.Alias or attribute name that you defined in your service mapping.
For example, ChargeRow.ChargeApplyTo.
For details, including the exact content of the Actions that this example uses, see the Send Charges from Order
Management to Oracle Receivables topic.
For example.
You set up an attribute named This example code won't cause an error. This example code will cause an error.
TotalSale_Custom in the Sources tab of
the service mapping, and you don't define
an alias in the Services tab of the service Hdr.Attribute3 = Hdr.Attribute3 =
mapping. HdrEFF.TotalSale_Custom HdrEFF.totalSale_Custom
You set up TotalSale_Custom in the This example code won't cause an error. This example code will cause an error.
Sources tab of the service mapping, and
you set up an alias as TotalSale in the • Hdr.Attribute3 = • Hdr.Attribute3 =
Services tab. HdrEFF.TotalSale_Custom HdrEFF.totalSale_Custom
• Hdr.Attribute3 = • Hdr.Attribute3 =
HdrEFF.TotalSale HdrEFF.totalSale
Here's a message that's an example of the type of error you might encounter at run time. In this example, the Sources
tab of the service mapping includes the totalSale_Custom attribute, but code in the integration algorithm uses
TotalSale_Custom.
01.03:llLine><PurchaseRequestService:FulfillLineId>300000002330472</
PurchaseRequestService:FulfillLineId><PurchaseRequestService:HeaderId>300000002330464</
PurchaseRequestService:HeaderId> </PurchaseRequestService:FulfillLine> <PurchaseRequestService:ChangeSummary
xmlns:sdo="commonj.sdo"/></PurchaseRequestService:PurchaseRequestServiceType>'-
oracle.apps.scm.pricing.priceExecution.algorithms.publicQuery.exception.SetQueryException:
233
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Step 'Step 1' not executed properly. Failed to execute onEach Closure. DataObject
com.oracle.xmlns.apps.scm.pricing.priceexecution.servicemappings.publicmappings.purchaserequestservicetype.HeaderEff_Cus
does not have property 'TotalSale_Custom' defined in the schema. Can not get value from the property.
null Payload: VariableName:'PRCIntegration'DateType:'commonj.sdo.DataObject' IOType:'InOut' value:'<?xml
version="1.0"encoding="UTF-8"?> <PurchaseRequestService:PurchaseRequestServiceType xmlns:PurchaseRequestService
Make Sure You Can Use Purchase Request Service to Update the Attributes That You Map
Attribute Value
Entity PurchaseRequestLine
5. In the Details list, click View > Columns, then add a check mark to Description.
This attribute is available You can use PurchaseRequestService to update the attribute.
with the create and with
the update operation
This attribute is available You can't use PurchaseRequestService to update the attribute.
only with the create
operation
234
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Note.
• In the Navigator, click Pricing Administration, click Tasks, then under Order Management Configuration, click
Manage Algorithms.
• Create different versions so you can test different set ups while maintaining a working copy.
• You must publish your algorithm.
• Before you publish, refresh the page: save, close the page, open the page, and requery algorithms.
• After you publish, refresh, and verify that the status is Published.
235
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
• You can't edit a published algorithm. You must create a new version instead, or deactivate, and then activate.
Note.
236
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Note.
◦ Notice value of Last Execution Status. Green check mark means success.
◦ Examine test output carefully. Make sure output not only exists, but that it contains values you expect
from your integration. For example, if you logic concatenates an item description, then make sure the test
displays concatenated values that you expect.
◦ If you modify logic or a data set, then delete your test data, recreate test data, and run test again.
◦ You must submit your test sales orders from the same sandbox that you use for your service mapping.
An integration algorithm doesn't require a sandbox but a service mapping does.
◦ Test the business unit that you use to submit the sales order.
237
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
◦ Verify attribute values throughout the sales order lifecycle, including before you submit it and in
fulfillment views up through the point where the sales order is closed.
Related Topics
• Create a Sandbox So You Can Edit Service Mappings
Procedures
Use a Service Mapping to Integrate Order Management with Other Oracle
Applications
Set up Order Management so it uses a view object to integrate with Oracle Receivables, Oracle Shipping, Oracle
Receiving, or Oracle Procurement.
Assume you must.
238
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
You will modify the predefined FulfillmentIntegration service mapping so it uses these cross-references.
This topic includes example values. You might use different values, depending on your business requirements.
Try it.
You use the Pricing Administration work area to set up an integration algorithm, but you aren't setting up
pricing. Order Management leverages the Pricing Administration work area because an integration algorithm's
structure and logic is very similar to a pricing algorithm. If you sign in as the.
◦ Order Administrator. the Pricing Administration work area displays only integration algorithms.
◦ Pricing Administrator. the Pricing Administration work area displays only pricing algorithms.
239
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
4. On the Overview page, click Tasks, then, under Order Management Configuration, click Manage Service
Mappings.
5. On the Manage Service Mappings page, in the Name column, click FulfillmentIntegration.
Notice the entities, such as ARInterfaceLine, and attributes, such as AccountRuleDuration. The
FulfillmentIntegration service mapping comes predefined with these entities and attributes so you can use
them to add attributes when you integrate Order Management with these Oracle applications.
ShipmentRequestLine
ReceiptAdviceLine
ReceiptAdviceLineLot
ReceiptAdviceLineLotWithSerials
PurchaseRequestLine
PurchaseRequestConfig
6. Click Sources.
In this example, you examine the entity or the view object that defines the view object as FulfillLineVO, and
then map an attribute of this entity or view object from the fulfillment line.
The Entity Mappings tab lists entities, each entity references a view object, and each entity on the Attribute
Mappings tab also references one or more attributes. You will create a map that references one of these entities
from this view object without using an integration algorithm.
However, if you must map an attribute from some other entity that doesn't reside at the same hierarchy level,
then you must use an integration algorithm. For example, if an attribute references an extensible flexfield from
the order header or the fulfillment line, then you must use an integration algorithm.
240
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Other Oracle Fusion Applications use a similar hierarchy. For example, here's that hierarchy that Purchasing
uses for a purchase order.
Purchase order
fulfillLine
purchaseLine
Shipping header
shipping line
fulfillLine
Here's the hierarchy that Purchasing uses for the receiving receipt.
Receipt header
ReceiptLine
FulfillLine
Lot or lot serial details
7. In the InvoiceSources - Details area, click the row that contains ARInterfaceLine in the Entity attribute.
8. In the ARInterfaceLine - Details area, add values, then click Save.
RuleStartDate ContractStartDate
RuleEndDate ContractEndDate
The RuleStartDate and RuleEndDate are now integrated to reference the view objects that you specified. Here's what
Order Management does at run time.
• Get the value of the ContractStartDate attribute from the Order Management work area, then display it in the
RuleStartDate attribute in Oracle Receivables.
• Get the value of ContractEndDate from the Order Management work area, then display it in the RuleEndDate
attribute in Oracle Receivables.
You can use Expression Language (EL) in the Expression column to implement logic or a constant value. For example,
you can implement this logic.
• If the value of variable x is greater than the value of variable y, then populate an attribute.
Related Topics
• Pricing Algorithm
• Service Mapping
241
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Here's an example.
Note.
• You get attributes value on the fulfillment line from Order Management, including the Item Description,
Quantity, Unit of Measure, Contract Start Date, and Contract End Date.
• You use an integration algorithm in the Pricing Administration work area to concatenate the values for the
attributes into a single string of text, and then use a service mapping to map it to Accounts Receivable.
• The Description on the invoice in Accounts Receivable displays the string.
• If the sales order contains a coverage item, such as a warranty, then you create another concatenated string for
the description of the coverage item. This string includes the description of the coverage item plus the same
attribute values that the string for the covered line has.
242
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Your mapping requirement is too complex to meet with only a service mapping, so you set up an integration algorithm
that creates the concatenated string and gets the data you'll need from the order line that has the covered item.
Attribute Value
Description Get the description for a covered line, and then add it to the description for the
coverage line on the invoice.
2. Click Variables, click Actions > Add Row, then set the values.
Attribute Value
Name ARIntegration
243
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Attribute Value
This value instructs the algorithm to get the attribute values you need from the invoice
service.
This variable will store the object definition that you need to integrate with Accounts Receivable.
3. Click Save.
Try it.
1. Add a function.
◦ Click Functions, click Actions > Add Row, then set values.
Attribute Value
Name GetCoveredFromDocRef
244
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Attribute Value
Description Get the value that identifies the order line that has the covered item.
Attribute Value
Name FLineId
Comments Use this argument to send the FLineId (fulfillment line identifier) that identifies the
fulfillment line that contains the coverage item, and then return a value that identifies
the covered item.
Attribute Value
This is a predefined value. You must not use any other value.
This is a predefined value. You must not use any other value.
This view object contains mapping values from coverage item and the covered item.
The getCoveredLine view criteria on the DocumentReferenceVO view object helps the
algorithm identify the fulfillment line that has the covered item.
245
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Attribute Value
◦ Click Save.
2. Add another function.
Attribute Value
Name GetCoveredFLine
This is a predefined value. You must not use any other value.
This is a predefined value. You must not use any other value.
Attribute Value
Name GetItemDesc
246
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Attribute Value
This is a predefined value. You must not use any other value.
This is a predefined value. You must not use any other value.
4. Click Save.
247
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Try it.
1. Click the Algorithm tab, click Add Step > Conditional Action, then set values.
Attribute Value
248
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Attribute Value
Description Concatenate the descriptions for the covered item and the coverage item.
ARLine ARIntegration.ARInterfaceLine
Doesn't contain a One FulfillLineId:
check mark. {Fline.FulfillLineId}
The data sets help the algorithm to filter and find the data that it can access.
◦ FLine. Will contain details from the fulfillment line that the algorithm will use to write the description
onto the covered item.
◦ ARLine. Identifies the destination where the algorithm will write the concatenated string.
◦ AllFLines. Use data from the coverage line to go and get the description from the fulfillment line that
contains the covered item. AllFLines allows the algorithm to traverse all fulfillment lines in the sales order
until it finds the line that has the covered item.
3. In the Execute Condition area, click Add Condition > Add Local Variable, then add two local variables.
You will use these variables to store temporary values that the algorithm needs while processes data.
4. In the Execute Condition area, click Add Condition > Default Action.
You will add the code that creates the concatenated string for the covered item.
where
249
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
ARLine.TranslatedDescription Create a variable named TranslatedDescription and add it to the ARLine data set.
=
FLine.ProductDescription Get the value of the description for the fulfillment line that we're currently processing. This is
the description for the covered item from the FLine data set.
FLine.ContractStartDate Get the value of the contract start date for the covered item from the FLine data set.
If you add coverage to a covered item, then you use the Contract Start Date and Contract
End Date on the covered item, not the coverage item. The coverage item provides coverage
for a duration, such as 1 Year, but not for the specific start date and end date. Instead, you set
the start date and end date on the covered item. This way, you can use the coverage item for
a variety of covered items.
FLine.ContractEndDate Get the value of the contract end date for the covered item from the FLine data set.
+ ' ' + Concatenate the value of one string to another. Insert a space between these concatenated
strings.
+ ' warranty coverage ' + Concatenate the value of one string to another. Insert text between these concatenated
strings. For example, insert the phrase warranty coverage between these concatenated
strings.
+ ' through ' +
This action applies to fulfillment lines that contain a standard item or shippable item.
This code specifies how to concatenate the attribute values. Here's an example of the run time value that this
code renders.
5. Add the code that creates the concatenated string for the coverage item.
You will add a new conditional action that applies only if the item is a coverage item. The concatenation is
slightly different for a coverage item than it is for a covered item. You also need to get some details from the
line that has the covered item.
◦ In the Execute Condition area, click Add Condition > True Condition.
◦ In the Conditional Actions area, add code in the True Condition window.
FLine.SalesProductTypeCode in
['COVERAGE','PREVENTIVE_MAINTENANCE','SERVICE_LEVEL_AGREEMENT','SOFTWARE_MAINTENANCE','INCLUDED_WARRANTY']
The SalesProductTypeCode attribute on the fulfillment line specifies whether the line contains a coverage
item, such as a maintenance agreement, warranty, and so on. So this code specifies to do this conditional
action only if the line contains a coverage item.
250
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
CoveredFlineDocRefRow = GetCoveredFromDocRef(FLine.FulfillLineId)
if (CoveredFlineDocRefRow?.DocSublineId != null) {
// Locate the covered line according to DocSublineId
CoveredFLineRow = AllFLines.locate([FulfillLineId:
Long.parseLong(CoveredFlineDocRefRow?.DocSublineId)])
where
Code Description
CoveredFlineDocRefRow = Use the GetCoveredFromDocRef function that you created earlier on the algorithm to
GetCoveredFromDocRef(FLine.FulfillLineId)
get the value the identifies the fulfillment line that contains the covered item.
Store the value in the CoveredFlineDocRefRow variable that you created earlier on the
algorithm.
if Ask whether DocSublineId contains a value. If it does contain a value, then it means
(CoveredFlineDocRefRow?.DocSublineId!
the sales order contains a covered line and we need to process it.
=null)
CoveredFLineRow = Set the value of the CoveredFLineRow attribute that you created earlier on the
AllFLines.locate([FulfillLineId:
algorithm to the fulfillment line that contains the covered item.
Long.parseLong(CoveredFlineDocRefRow?.DocSublineId)])
if (CoveredFLineRow == If we can't find the covered line in memory then get it. Use the DocSublineId
null) CoveredFLineRow = attribute with the GetCoveredFLine function that you created earlier to find it, then use
GetCoveredFLine(CoveredFlineDocRefRow?.DocSublineId)
the results to set the value for CoveredFLineRow to the line that contains the covered
item..
def item = Define a variable named item and set its value to the contents of the
CoveredFLineRow?.ProductDescription
ProductDescription attribute. Get the value of ProductDescription from the fulfillment
line that CoveredFLineRow identifies.
if (item == null) If your item variable is empty, then it means we still need to find the description for the
{ def itemRow = covered line in memory.
251
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Code Description
GetItemDesc(CoveredFLineRow.InventoryItemId,
CoveredFLineRow.InventoryOrganizationId)
Define a variable named itemRow.
item =
itemRow.Description; } Use the GetItemDesc method that you added earlier to the algorithm to get the values
of the InventoryItemId attribute and the InventoryOrganizationId attribute from the
fulfillment line that CoveredFLineRow contains. Use these values to verify that the row
contains the item, then set the value of itemRow to this fulfillment line.
Set the item variable to the value of the Description on the fulfillment line that
itemRow identifies.
ARLine.TranslatedDescription Create a variable named TranslatedDescription and add it to the ARLine data set. Store
= FLine.ProductDescription the value of the concatenated string in TranslatedDescription.
+ ' for ' + item + ' ' +
FLine.OrderedQty.toString()
+ ' ' + FLine contains attribute values for the line that we're currently processing, which is the
FLine.OrderedUom + ' ' + coverage item.
FLine.ContractStartDate
+ ' through ' + • FLine.ProductDescription is the description of the coverage item.
FLine.ContractEndDate • item is a variable that contains the description of the covered item, such as
Desktop Computer.
• FLine.OrderedQty.toString() is the quantity of the coverage item,
converted to a string.
• FLine.ContractStartDate is the start date of the coverage item.
• FLine.ContractEndDate is the end date of the coverage item.
This description is going on the invoice line that has the coverage item, so its useful to
identify the item that the coverage covers.
Here's an example of the run time value that this code renders.
Extended Warranty 4 month fixed, for Network Gateway Switch 1 Ea 2021-03-01 through 2021-07-01
◦ Click Save and Close, then close the Manage Algorithms tab.
1. Create a sand box. For details, see the Create a Sandbox So You Can Edit Service Mappings topic.
2. In the Tasks pane, under Order Management Configuration, click Manage Service Mappings.
3. On the Manage Service Mappings page, click FulfillmentIntegration.
4. Click Sources.
5. Click the row that contains InvoiceSource in the Source column.
6. Add an attribute that you will use to send the translated description to Accounts Receivable.
◦ In the Entity Mappings list, click the row that contains ARInterfaceLine in the Entity column.
◦ In the ARInterfaceLine Details area, click Actions > Add Row, then set the value.
252
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Attribute Value
Attribute TranslatedDescription
◦ In the Entity Mappings list, click the row that contains FulfillLine in the Entity column.
◦ In the FulfillLine Details area, add new attributes.
SalesProductTypeCode SalesProductTypeCode
ProductDescription ProductDescription
OrderedQty OrderedQty
OrderedUom OrderedUom
ContractStartDate ContractStartDate
ContractEndDate ContractEndDate
◦ Click Services.
◦ Click the row that contains InvoiceService in the Service column.
◦ Set the values.
This is the name of the integration algorithm that you created earlier in this procedure.
253
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
9. Add your attributes to the service so the service includes them in the payload that it sends to Accounts
Receivable.
◦ In the Entities list, click the row that contains ARInterfaceLine in the Entity column.
◦ In the ARInterfaceLine Entities area, add an attribute.
◦ In the Entities list, click the row that contains FulfillLine in the Entity column.
◦ In the FulfillLine Entities area, add your attributes.
• SalesProductTypeCode
• ProductDescription
• OrderedQty
• OrderedUom
• ContractStartDate
• ContractEndDate
Make sure the Read attribute and the Write attribute contain a check mark for each attribute that you
add.
◦ Click Save and Close
10. Publish your algorithm.
◦ Click Tasks, and then under Order Management Configuration, click Manage Algorithms
◦ On the Manage Algorithms page, click the row that contains Translated Description Custom in the Name
column.
◦ Click Actions > Publish.
◦ Go to the Order Management work area, create a sales order, then add two order lines.
Item Quantity
OAL_EW_4M_Fixed - Extended 1
Warranty
◦ Click Submit
◦ Notice the sales order number. For this example, assume its 529986.
254
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
2. Verify that Order Management correctly sends your data to Oracle Receivables.
◦ Sign into Oracle Fusion applications with a job role that you can use to access Accounts Receivable,
such as Accounts Receivable Manager. For details, see the Job Roles and Duty Roles That You Use to
Implement Order Management topic.
◦ Go to the Billing work area, then click Tasks > Manage Transactions.
For details, see the Requirements for Completing a Receivables Transaction topic.
◦ On the Manage Transactions page, search for the transaction.
Attribute Value
Reference 529986
Attribute Value
Notice that this value is a concatenation of the description of the covered item, and
then the start date and end date of the coverage. It is the result of the Default action
that you created in the algorithm.
◦ Verify the description for the invoice line that has the extended warranty.
Attribute Value
Notice that this value is a concatenation of the description of the coverage item, and
then the description of the covered item, and then the quantity, unit of measure, start
date, and end date of the coverage item.
This line contains a coverage item, so it meets the condition from the algorithm. It is
the result of the Conditional action that you created in the algorithm.
255
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Receivables
Overview of Integrating Order Management with Accounts Receivable
Get an overview of how you can specify the way Order Management Cloud sends charges and charge lines to Oracle
Fusion Accounts Receivable.
Set up an integration algorithm so it sends the values to Accounts Receivable that receivables needs to calculate various
charges, such as how to calculate tax on the shipping charge of a shipping line.
For example, tax rules on freight might vary according to region or to details on the sales order. Determining tax
manually might delay order fulfillment, introduce unnecessary tax, or result in an invoice error. Instead, you can.
• Specify one or more shipping charges for an order line to automate tax calculation, such as sending freight
charges to Receivables to calculate the tax amount for freight.
• Calculate freight tax in Oracle Fusion Pricing, send it to Order Management, then display it on an order line in
Order Management.
• Set up an integration algorithm to help achieve tax compliance, minimize sales order exceptions, and improve
the accuracy of billing details.
• For details about managing order numbers that you import when you integrate with Receivables, see the Retain
Sales Order Number During Import topic.
Shipping Charges
In some prior releases, Order Management sent secondary charges, including freight charges, to Receivables.
Receivables added the secondary charges together, then displayed them as a single freight charge on the invoice
header. Receivables couldn't apply a tax on this single charge because it might need to tax individual charges at
256
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
different tax rates, and some of these charges might not be taxable. Order Management can now send the shipping
charge on a separate charge line.
• This feature adds a new charge line for each shipping charge for each item. For example, if the sales order
contains three items, and if each item includes a shipping charge, then the invoice will contain six lines. Order
Management will ship three lines, and the other three lines will contain freight charges.
• The charge line will include the item number and description that you set up in the Product Information
Management work area. To relate each freight charge to the shippable line, you can override the Description
attribute and TranslatedDescription attribute so they reference the correct shippable item.
• If you override an attribute in the algorithm, then you must include the attribute in the Sources tab and the
Services tab of the entity you're modifying in the service mapping.
• As an option, you can also modify discount lines.
• Make sure you set up the item in Product Information Management.
Related Topics
• Pricing Algorithm
• Service Mapping
• Create a Sandbox So You Can Edit Service Mappings
You use the Order Administrator job role so you can access the integration algorithm in the Pricing
Administration work area.
2. On the Overview page, click Tasks.
3. In the Tasks pane, under Order Management Configuration, click Manage Algorithms.
4. On the Manage Algorithms page, click Integration Algorithm for Sales Order Charges.
257
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
5. On the Edit Algorithm page, in the Step Details area, in the Execute Condition area, in the Default Action area,
locate the code in the Default Actions window.
/*You can set up this integration algorthim so it uses accounts receivable to calculate tax on the
shipping charge. To do this, you must interface taxes and charges to accounts receivable as LINE and
not as FREIGHT. Do the following work:
1. Remove the comments from the lines below.
2. Publish your integration algorithm.
3. Use the Manage Service Mappings page to map your integration algorithm to service InvoiceService.
If an integration algorithm already maps to InvoiceService, then do not map your your integration
algorithm to InvoiceService. Instead, incorporate steps from your integration algorithm into the
integration algorithm that already maps to InvoiceService.
*/
//FreightRow.LineType = ChargeRow.ChargeApplyTo == "SHIPPING" ? "LINE" : FreightRow.LineType
//FreightRow.InventoryItemId = ChargeRow.ChargeApplyTo == "SHIPPING" ? '<Replace with Freight Inventory
Item Id>' : null
7. Remove the commented instructional text, remove the two forward slashes (//) from the following code, then
add the line and Id details for your shipping line.
258
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
where
◦ LINE. Specifies the shipping line where you're requesting Receivables to calculate tax on the shipping
charge.
◦ <Replace with Freight Inventory Item Id>. Specifies the Item Id of the freight inventory item that
Receivables will use to calculate tax.
You can also add a description.
For example, here's some code that specifies to use item 123456789.
FreightRow.LineType = ChargeRow.ChargeApplyTo == "SHIPPING" ? "LINE" : FreightRow.LineType
FreightRow.InventoryItemId = ChargeRow.ChargeApplyTo == "SHIPPING" ? '123456789' : null
As an option, you can specify other attributes. For details, see the Specify Charges That Order Management
Sends to Accounts Receivables topic.
8. Click Save and Close.
9. On the Manage Algorithms page, click Actions > Publish.
If you already set up an integration algorithm that maps to InvoiceService, then don't map your integration algorithm
to InvoiceService. Instead, incorporate steps from your integration algorithm into the integration algorithm that
already maps to InvoiceService. For details about how to map your integration algorithm to InvoiceService, see the Use
Extensible Flexfields to Integrate Order Management with Other Applications topic.
259
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
• LineType
6. Set up the source for the charge.
◦ Click Sources.
◦ Click the row that contains InvoiceSource in the Source column.
◦ In the Entity Mappings list, click the row that contains Charge in the Entity column.
◦ In the Attribute Mappings list, add an attribute.
ChargeApplyTo ChargeAppliesTo
◦ Click Services.
◦ Click the row that contains InvoiceSource in the Service column.
◦ In the Entities list, click the row that contains Charge in the Entity column.
◦ In the Attribute list, add an attribute.
Attribute Value
Attribute ChargeApplyTo
Enable Feature
Enable the Invoice option in the Enable Custom Payloads for Downstream Integration feature. For details, see the Get
Started with Integrating Order Management with Other Oracle Applications topic.
Related Topics
• Pricing Algorithm
• Service Mapping
• Create a Sandbox So You Can Edit Service Mappings
260
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Note.
• You use the predefined FulfillmentIntegration service mapping. Its already set up to do most of the work for
you.
• You use predefined objects in FulfillmentIntegration to create the mapping, such as the InvoiceSources source,
the ARInterfaceLine entity, and the InvoiceService service.
261
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
• You don't have to significantly modify the predefined objects. All you need to do is add and map the attribute.
• At runtime, the service mapping gets the value of the Contract State Date from the fulfillment line, maps it to
the RuleStartDate, then sends the value to Receivables.
• Receivables displays the value in the Start Date attribute on the invoice line.
1. Sign into Oracle Fusion Applications with the Order Administrator job role so you can access the service
mapping that you use in the Pricing Administration work area to set up the integration.
2. Go to the Pricing Administration work area.
3. On the Overview page, click Tasks, then, under Order Management Configuration, click Manage Service
Mappings.
4. On the Manage Service Mappings page, in the Name column, click FulfillmentIntegration.
5. Modify the source.
Specify how the payload that you send to Accounts Receivable will get the Contract Start Date from the
fulfillment line on the sales order. You will write the logic to make sure you populate the RuleStartDate with the
correct value.
◦ Click Sources.
◦ In the Sources list, click the row that has the value.
Attribute Value
Source InvoiceSources
◦ On the Entity Mappings tab, notice that most entities use the FulfillLineVO view object to get their
attribute values.
◦ In the InvoiceSources - Details area, on the Entity Mappings tab, click the row that has the value.
Attribute Value
Entity ARInterfaceLine
◦ In the ARInterfaceLine Details area, on the Attribute Mappings tab, click Actions > Add Row, set values,
then click Save.
262
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Attribute Value
Attribute RuleStartDate
This value identifies the attribute that you will as the target attribute.
You're getting the value for RuleStartDate from the FulfillLineVO view object, so you
examine an attribute in the FulfillLineVO view object to see if it has a value.
6. Map your attributes to the service that Order Management uses to communicate with Oracle Receivables.
◦ Click Services.
◦ In the Services list, click the row that has the value.
Attribute Value
Service InvoiceService
◦ In the InvoiceService - Details area, click the row that has the value.
Attribute Value
Entity ARInterfaceLine
◦ At the bottom of the page, in the ARInterfaceLine area, click Actions > Add Row to add the RuleStartDate
attribute so Order Management can communicate it through the InvoiceService.
Attribute Value
Attribute RuleStartDate
263
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Attribute Value
Attribute Value
Item AS54888
Quantity 1
Attribute Value
Quantity 1
Assume this item has a Contract Start Date of June 30, 2021.
◦ Click Submit.
Assume your order number is 523371, and that the orchestration process schedules and ships the order
lines.
2. Verify that Order Management correctly sends your data to Oracle Receivables.
◦ Sign into Oracle Fusion applications with a job role that you can use to access Accounts Receivable, such
as Accounts Receivable Manager.
For details, see the Job Roles and Duty Roles That You Use to Implement Order Management topic.
◦ Go to the Billing work area, then click Tasks > Manage Transactions.
For details, see the Requirements for Completing a Receivables Transaction topic.
◦ On the Manage Transactions page, search for the transaction.
264
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Attribute Value
Reference 523371
◦ On the Review Transaction page, in the Invoice Details area, verify the value for the invoice line that has
the warranty.
Attribute Value
Related Topics
• Service Mapping
• Create a Sandbox So You Can Edit Service Mappings
• Job Roles and Duty Roles That You Use to Implement Order Management
• Requirements for Completing a Receivables Transaction
Integrate Your Own Header Attributes Between Order Management and Accounts
Receivable
In this example, you use an extensible flexfield on the order header in Order Management to capture the primary
salesperson, then send that value through the ResourceSalesPersonId attribute on an interface line to Oracle Fusion
Accounts Receivable so receivables can display it on an invoice.
265
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Note.
1. You create an extensible flexfield in the Setup and Maintenance work area.
2. The Order Entry Specialist uses your extensible flexfield to set the Primary Salesperson on the order header in
the Order Management work area.
3. You use the Pricing Administration work area to create a service mapping. The mapping uses the view object
and the view attribute from the flexfield to map it to Accounts Receivable.
4. You use the Pricing Administration work area to create an integration algorithm that tells Order Management to
include the salesperson from the flexfield when it sends the payload to Accounts Receivable.
5. Your accounts receivable manager uses the Billing work area to open the invoice for the sales order and view
the salesperson in the Salesperson attribute.
266
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
For details, see the Get Started with Integrating Order Management with Other Oracle Applications topic.
2. Create a sand box, and activate the Service Mappings tool and the Flexfields tool in the sand box.
For details, see the Create a Sandbox So You Can Edit Service Mappings topic.
Attribute Value
This is a predefined extensible flexfield that you can use on the order header.
Attribute Value
267
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Attribute Value
Enabled Enabled.
◦ In the Context Usages area, click Actions > Create, then set values.
Attribute Value
◦ Click Save.
◦ In the Context Sensitive Segments area, click Actions > Create.
◦ On the Create Segment page, set values, then click Save and Close.
Attribute Value
Enabled Enabled.
268
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
◦ Click Save and Close on the current page and subsequent pages until you're on the Edit Extensible
Flexfield page.
◦ In the Category area, click the row that has Additional Header Information in the Display Name attribute.
◦ In the Additional Header Information Details area, on the Associated Context tab, click Actions > Select
and Add.
◦ Add the Primary Salesperson context.
◦ On the Edit Extensible Flexfield page, click Save and Close.
◦ On the Manage Order Extensible Flexfields page, select the line in the search results that contains
Header Information in the Name attribute, then click Deploy Flexfield.
◦ In the Confirmation dialog, verify that the deployment finished successfully, then click OK.
◦ Click Actions > Download Flexfield Archive, wait for processing to finish, then, in the Confirmation
dialog, click Download.
◦ In the dialog that displays, save the file to your preferred location.
◦ Use your browser's download feature to navigate to the archive.
For example, if you're using Firefox, click the down arrow on the top banner, then navigate
to the 10008_DOO_HEADERS_ADD_INFO file, such as C:\Users\your_name\Downloads
\10008_DOO_HEADERS_ADD_INFO.zip.
◦ Unzip 10008_DOO_HEADERS_ADD_INFO.zip.
◦ Navigate to folder C:\Users\user_name \Downloads\ 10008_DOO_HEADERS_ADD_INFO.zip\oracle\apps\scm\doo
\processOrder\flex\headerContextsB\view.
◦ Find the Name attribute of the view object, then note its value. It should be on about the 4th line of code.
<ViewObject
xmlns="http://xmlns.oracle.com/bc4j"
Name="HeaderEffBPrimary__Sales__RepresentativeprivateVO"
ViewAttribute Name="primarySalesperson"
The flexfield archive has a number of attributes, so make sure you identify the correct one.
269
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
2. On the Overview page, click Tasks, then, under Order Management Configuration, click Manage Service
Mappings.
3. On the Manage Service Mappings page, in the Name column, click FulfillmentIntegration.
4. Add an entity for the extensible flexfield.
◦ On the Edit Service Mappings page, on the Entities tab, click Actions > Add Row, then set values.
Attribute Value
Entity HeaderEFF_Custom
You must include the _Custom suffix with any new entity that you create.
You must include the EFF_Custom suffix with any new entity that you create for an
extensible flexfield.
Description Extensible flexfield that stores the salesperson on the order header.
Attribute Type
HeaderId_Custom Long
SalesPersonId_Custom Long
Enable the Allow Null attribute. Leave all other attributes at the current values.
You must use the same Type for each attribute that you specify for the corresponding attribute in the
descriptive flexfield. If you don't use the same data type, then your service mapping might not fail when
compiling but will fail in your runtime environment. The runtime failure might be difficult to troubleshoot
because you might not encounter any errors but your set up might not work as you expected.
5. Modify the source.
◦ Click Sources.
◦ In the Sources list, click the row that has the value.
Attribute Value
Source InvoiceSources
◦ In the InvoiceSources Details area, click View > Columns, then enable the Joined Entity and Joined Entity
Attribute.
◦ On the Entity Mappings tab, click Actions > Add Row, set values, then click Save.
270
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Attribute Value
Entity HeaderEFF_Custom
This value is the name of the view object that you noted earlier in this procedure when
you downloaded the flexfield archive.
The invoice service primarily references the fulfillment line, so you query for the
HeaderId from the fulfillment line. You use the Joined Entity to create a relationship
between the HeaderId query attribute and the fulfillment line, and you use the Joined
Entity Attribute to specify how to identify the joined entity.
◦ On the Attribute Mappings tab, add your custom attributes, then click Save.
HeaderId_Custom HeaderId
SalesPersonId_Custom primarySalesperson
This value is the name of the ViewAttribute that you noted earlier in this procedure
when you downloaded the flexfield archive.
◦ On the Entity Mappings tab, click the row that has ARInterfaceLine in the Entity column.
Order Management uses the ARInterfaceLine entity to communicate the attribute value in the payload
that it sends to Accounts Receivable. You will add this attribute to the source. Later, you will also add it to
the service.
◦ In the ARInterfaceLine Details area, add the attribute, then click Save.
271
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Attribute Value
Attribute ResourceSalesrepId
Leave the View Object Attribute and the Expression attribute empty. The integration algorithm that you
set up in this topic will use the extensible flexfield on the order header to determine these values.
6. Modify the service that Order Management uses to communicate with Accounts Receivable.
◦ Click Services.
◦ In the Services list, click the row that has the value.
Attribute Value
Service InvoiceService
◦ In the InvoiceService - Details area, click Actions > Add Row, set the values, then click Save.
Attribute Value
Entity HeaderEFF_Custom
Read Enabled
Write Enabled
Attribute Value
Enable the Read attribute and Write attribute for each of the attributes that you add.
◦ In the InvoiceService Details area, click the row that has ARInterfaceLine in the Entity column.
272
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Attribute Value
Attribute ResourceSalesrepId
1. Create the integration algorithm described in the Use Integration Algorithms to Implement Complex Logic
topic.
2. Add a new data set.
Attribute Value
Name HeaderEFF
3. Add code to the conditional action. Add it as a new line at the end of the code.
ARLine.ResourceSalesrepId=HeaderEFF.SalesPersonId_Custom
This code says to get the value for the sales person from the SalesPersonId_Custom attribute on the HeaderEFF
flexfield, then store it in the ResourceSalesrepId attribute in the ARLine data set.
4. Copy the code that you added to the conditional action, and paste it as a new line the end of the code in the
default action.
The algorithm you're modifying has a conditional action for order lines that contain a coverage item and a
default action for lines that contain a covered item. You need to populate the ARLine data set regardless of
whether the item on the line is a coverage item or a covered item, so you add the same code to the conditional
action and the default action.
You use this data set to make sure that you have the values you need for the extensible flexfield on the order
header.
5. Publish the algorithm.
273
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
◦ Go to the Order Management work area, create a sales order, then add an order line.
◦ On the order header, click Actions > Edit Additional Information.
The work area displays the Additional Information dialog. This dialog displays extensible flexfields that
you create on the order header, by default.
◦ Verify that the Additional Information dialog displays the Sales Representatives area, which is the flexfield
context, and that this area displays the Primary Sales Rep attribute.
◦ Set the Primary Sales Rep to Diane Cho.
◦ Click Submit.
◦ Sign into Oracle Fusion applications with a job role that you can use to access Accounts Receivable,
such as Accounts Receivable Manager. For details, see the Job Roles and Duty Roles That You Use to
Implement Order Management topic.
◦ Go to the Billing work area, then click Tasks > Manage Transactions.
For details, see the Requirements for Completing a Receivables Transaction topic.
◦ On the Manage Transactions page, search for the transaction.
Attribute Value
Reference 54758
◦ On the Review Transaction page, in the General Information area, verify that the Salesperson attribute
contains Diane Cho, which is the same value that you set on the order header in Order Management.
Related Topics
• Create a Sandbox So You Can Edit Service Mappings
• Job Roles and Duty Roles That You Use to Implement Order Management
• Requirements for Completing a Receivables Transaction
Integrate Your Own Order Line Attributes between Order Management and Oracle
Receivables
Use an extensible flexfield in Order Management to capture your own order line details, then send them to a descriptive
flexfield so you can see these details on invoices in Oracle Receivables.
274
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Use an extensible flexfield in Order Management to capture your own order line details, then send them to a descriptive
flexfield so you can see these details on invoices in Oracle Receivables.
Note.
1. Assume you need to add your own shipping details when you create an order line for a new sales order in Order
Management. The Order Entry Specialist clicks the down arrow in the Amount column on the order line, clicks
Edit Additional Information, then uses it to add the details.
◦ Packing instructions
◦ Packing material
◦ Packing date
275
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
2. You will add these attributes to the Fulfillment Line Information extensible flexfield.
3. You edit the Invoice Lines descriptive flexfield so you can display shipping details on the invoice line.
4. You modify the FulfillmentIntegration service mapping to map the extensible flexfield between Order
Management and the descriptive flexfield in Accounts Receivable.
5. You create an integration algorithm that specifies the data to communicate.
6. You use the Billing work area to examine the invoice that contains the shipping details.
Summary of the Setup
1. Prepare your setup.
2. Edit extensible flexfield.
3. Edit service mapping for extensible flexfield.
4. Edit descriptive flexfield.
5. Edit service mapping for descriptive flexfield.
6. Create integration algorithm.
7. Test your set up.
This topic uses example values. You might use different values, depending on your business requirements.
1 View object
5 SdoNameSpace
276
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
You will use this spreadsheet to help you remember some of the values that you need during the procedure. Add values
while you do the setup, such as when you create the flexfields. We'll provide you reminders at the appropriate points.
Here's the spreadsheet with the values that you will use in this example.
5 SdoNameSpace http://xmlns.oracle.com/apps/flex/
financials/receivables/transactions/
autoInvoices/TransactionLineDff/
277
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
2. On the Manage Order Extensible Flexfields page, search for the value.
Attribute Value
This is a predefined extensible flexfield that you can use on the order header.
Attribute Value
◦ In the Context Usages area, click Actions > Create, then set the value.
Attribute Value
◦ Click Save.
5. Create the segment for the packing instructions.
Attribute Value
278
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Attribute Value
Attribute Value
279
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Attribute Value
8. Click Save and Close on the current page and subsequent pages until you're on the Edit Extensible Flexfield
page.
9. Deploy your flexfield.
◦ Click Actions > Download Flexfield Archive, wait for processing to finish, then, in the Confirmation
dialog, click Download.
◦ In the dialog that displays, save the file to your preferred location.
◦ Use your browser's download feature to navigate to the archive.
For example, if you're using Firefox, click the down arrow on the top banner, then navigate to
the 10008_DOO_FULFILL_LINES_ADD_INFO file, such as C:\Users\user_name \Downloads
\10008_DOO_FULFILL_LINES_ADD_INFO.zip.
280
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
◦ Unzip 10008_DOO_FULFILL_LINES_ADD_INFO.zip.
◦ Navigate to the folder.
◦ Find the Name attribute of the view object, then note its value. It should be on about the 3rd or 4th line of
code.
<ViewObject
xmlns="http://xmlns.oracle.com/bc4j"
Name="FulfillLineEffBShipment__InstructionsprivateVO"
Search the File for the Value Edit Your Memory Jogger
Use the Order Administrator job role so you can access the integration algorithm and service mappings that
you use in the Pricing Administration work area to set up the integration.
2. On the Overview page, click Tasks, then, under Order Management Configuration, click Manage Service
Mappings.
3. Enter your sand box.
4. On the Manage Service Mappings page, in the Name column, click FulfillmentIntegration.
5. Add an entity.
◦ On the Edit Service Mappings page, on the Entities tab, click Actions > Add Row, then set values.
281
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Attribute Value
Entity PackingInstructions_Custom
Description Context for an extensible flexfield on the order line. It contains details about packing
instructions.
Note.
• You must use the same Type for each attribute that you specify for the corresponding attribute in
the descriptive flexfield. If you don't use the same data type, then your service mapping might not
fail when compiling but will fail in your runtime environment. The runtime failure might be difficult
to troubleshoot because you might not encounter any errors but your set up might not work as you
expected.
• Make sure Allow Null contains a check mark for each attribute that you add.
• Leave other attributes empty.
6. Modify the source.
◦ Click Sources.
◦ In the Sources list, click the row that has the value.
Attribute Value
Source InvoiceSources
◦ In the InvoiceSources Details area, click View > Columns, then enable Joined Entity, and Joined Entity
Attribute.
◦ On the Entity Mappings tab, click Actions > Add Row, set values, then click Save.
282
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Attribute Value
Entity PackingInstructions_Custom
Scroll all the way to the end of the list. Pricing Administration adds your custom
attributes at the end of the list.
Get the value from your memory jogger. Recall that this is the name of the view object
that you noted earlier in this procedure when you downloaded the flexfield archive.
If you can't pick the value, select another line in the Entity Mappings list, then go back
to your PackingInstructions_Custom line.
◦ On the Attribute Mappings tab, add your custom attributes, then click Save.
FulfillLineId_Custom FulfillLineId
OrderLinePackingInstructions_Custom OrderLinePackingInstructions
OrderLinePackingMaterial_Custom OrderLinePackingMaterial
OrderLinePackingDate_Custom OrderLinePackingDate
283
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
7. Map your custom attributes to the service that Order Management uses to communicate with Oracle
Receivables.
◦ Click Services.
◦ In the Services list, click the row that has the value.
Attribute Value
Service InvoiceService
◦ In the InvoiceService - Details area, click Actions > Add Row, set the values, then click Save.
Attribute Value
Entity PackingInstructions_Custom
Read Enabled
Write Enabled
Attribute Alias
FulfillLineId_Custom FulfillLineId
OrderLinePackingInstructions_Custom OrderLinePackingInstructions
OrderLinePackingMaterial_Custom OrderLinePackingMaterial
OrderLinePackingDate_Custom OrderLinePackingDate
Enable the Read attribute and Write attribute for each of the attributes that you add.
◦ Click Save and Close, then click Done.
284
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
◦ Offering: Financials
◦ Functional Area: Receivables
◦ Task: Manage Receivables Descriptive Flexfields
2. On the Manage Receivables Descriptive Flexfields page, search for the value.
Attribute Value
Attribute Value
285
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Attribute Value
Attribute Value
286
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Attribute Value
◦ Click Actions > Download Flexfield Archive, wait for processing to finish, then, in the Confirmation
dialog, click Download.
◦ In the dialog that displays, save the file to your preferred location.
◦ Use your browser's download feature to navigate to the archive.
For example, if you're using Firefox, click the down arrow on the top banner, then navigate to the
navigate to the 222_RA_CUSTOMER_TRX_LINES file, such as C:\Users\user_name\Downloads
\222_RA_CUSTOMER_TRX_LINES.zip.
2. Unzip 222_RA_CUSTOMER_TRX_LINES.zip.
3. Navigate to the folder.
C:\Users\user_name\Downloads\222_RA_CUSTOMER_TRX_LINES.zip\oracle\apps\flex\financials\receivables
\transactions\autoInvoices\TransactionLineDff\view
For this example, assume SdoNameSpace in your XML contains this value.
SdoNameSpace="http://xmlns.oracle.com/apps/flex/financials/receivables/transactions/autoInvoices/
TransactionLineDff/".
287
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Search the File for the Value Edit Your Memory Jogger
◦ On the Edit Service Mappings page, on the Entities tab, click the row that contains the value.
Attribute Value
Entity TransactionLineDff
◦ In the details area, verify that you have the attributes you need. If any are missing, add them now.
Attribute Type
FulfillLineId Long
NameSpace String
XsiType String
__FLEX_Context String
288
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Note.
• Make sure the Primary Key doesn't contain a check mark for any of the attributes you add.
• Make sure Allow Null contains a check mark for each attribute that you add.
• Make sure the Referenced Entity attribute for FulfillLineId contains ARInterfaceLine.
• Leave other attributes empty.
◦ In the details area, add your attributes, then click Save.
Attribute Type
InvoiceLinePackingMaterial_Custom String
InvoiceLinePackingDate_Custom Date
InvoiceLinePackingInstructions_CustomString
Note.
• Make sure the Primary Key doesn't contain a check mark for any of the attributes you add.
• Make sure Allow Null contains a check mark for each attribute that you add.
• Leave all other attributes empty.
6. Modify the source.
◦ Click Sources.
◦ In the Sources list, click the row that has the value.
Attribute Value
Source InvoiceSources
◦ In the InvoiceSources - Details area, on the Entity Mappings tab, click the row that has the value.
Attribute Value
Entity TransactionLineDff
FulfillLineId FulfillLineId -
289
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
NameSpace - "http://xmlns.oracle.com/
apps/flex/financials/
receivables/transactions/
autoInvoices/
TransactionLineDff/"
Note.
XsiType - "TransactionLineFLEX"
__FLEX_Context - -
InvoiceLinePackingMaterial_Custom - -
InvoiceLinePackingDate_Custom - -
InvoiceLinePackingInstructions_Custom InvoiceLinePackingInstructions -
Note.
◦ Click Services.
◦ In the Services list, click the row that has the value.
290
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Attribute Value
Service InvoiceService
◦ In the InvoiceService - Details area, click the row that has the value.
Attribute Value
Entity TransactionLineDff
◦ At the bottom of the page, in the TransactionLineDff - Entities area, add your custom attributes so Order
Management can communicate them through the InvoiceService.
Attribute Alias
FulfillLineId FulfillLineId
NameSpace -
XsiType -
__FLEX_Context -
InvoiceLinePackingMaterial_Custom InvoiceLinePackingMaterial
InvoiceLinePackingDate_Custom InvoiceLinePackingDate
InvoiceLinePackingInstructions_CustomInvoiceLinePackingInstructions
Note.
291
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Attribute Value
You can use any text, except you must suffix the name with a space, then the word Custom.
4. Click Save.
5. Click Variables, click Actions > Add Row, set the values, then click Save.
Attribute Value
Name ARIntegration
6. Click Algorithm.
7. Click Add Step > Conditional Action.
8. In the Data Sets area, click Add Row, then set the values.
Attribute Value
Name FLine
9. In the Execute Condition area, click Add Condition > Default Action.
10. In the Actions window, add the code, then click Save.
292
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Code Description
ARLineDFF.invoiceLinePackingDate=FLineEFF
If the value of !
the orderLinePackingDate attribute on the extensible flexfield.
= null ?
FLineEFF.orderLinePackingDate:
null
◦
Contains a value. Set the value of the invoiceLinePackingDate attribute on the
descriptive flexfield to the value that orderLinePackingDate contains.
◦
Doesn't contain a value. Set the value of invoiceLinePackingDate to empty.
ARLineDFF.invoiceLinePackingMaterial=FLineEFF !
If the value of the orderLinePackingMaterial attribute on the extensible flexfield.
= null ?
FLineEFF.orderLinePackingMaterial: Contains a value. Set the value of the invoiceLinePackingMaterial attribute on the
null
◦
descriptive flexfield to the value that orderLinePackingMaterial contains.
◦
Doesn't contain a value. Set the value of invoiceLinePackingMaterial to empty.
Attribute Value
293
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Attribute Value
Item AS54888
Quantity 1
◦ Click the down arrow on the order line, then click View Additional Information.
◦ In the Additional Information dialog that displays, click Ship Instructions, then verify that the Ship
Instructions area contains your Packing Material and Packing Date flexfield attributes.
◦ Add some test values in your flexfield attributes, then click Done.
Attribute Value
◦ Click Submit.
◦ Sign into Oracle Fusion applications with a job role that you can use to access Accounts Receivable,
such as Accounts Receivable Manager. For details, see the Job Roles and Duty Roles That You Use to
Implement Order Management topic.
◦ Go to the Billing work area, then click Tasks > Manage Transactions.
For details, see the Requirements for Completing a Receivables Transaction topic.
◦ On the Manage Transactions page, search for the transaction.
Attribute Value
Reference 55748
294
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
◦ On the Review Transaction page, in the Invoice Details area, verify that the invoice contains attributes and
attribute values for packing instructions, packing material, and packing date.
Related Topics
• Create a Sandbox So You Can Edit Service Mappings
• Job Roles and Duty Roles That You Use to Implement Order Management
• Requirements for Completing a Receivables Transaction
Customer Name Project Type Sales Order Number AR Transaction Type Revenue Account
Note.
• Accounts Receivable doesn't set the default value for Receivables Transaction.
• Here's the predefined behavior that Order Management uses to set the default value.
Fulfilling Invoice
You can create a pretransformation rule or posttransformation rule to modify this behavior.
Don't modify this behavior. You must use the Credit Memo transaction type for each return
line.
• If you specify AR Transaction Type in a pretransformation rule or posttransformation rule, then write your rule
so it uses one of these combinations of attributes.
295
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Attributes Description
Line category and business unit Use this combination when you must assign the business unit according to the transaction
type.
◦ Use the same AR Transaction Type, such as ARTT-Invoice1, for order lines you're
fulfilling.
◦ Use the same AR Transaction Type, such as ARTT-Credit1, for return order lines.
Use one of these combinations. Use this combination when you must assign the business unit according to transaction
types.
◦ Line type and line category,
and business unit
◦ Use more than one AR Transaction Type for order lines that you're fulfilling.
◦ Line type or line category, and
business unit ◦ Use more than one AR Transaction Type for return order lines.
Order category and business unit Use this combination when your source system sends a source order that includes return
order lines but doesn't include order lines that you're fulfilling.
Order type and business unit Use this combination when a sales order that you create in the Order Management work area
includes return order lines but doesn't include order lines that you're fulfilling.
• If the Inventory Item Id attribute on the fulfillment line is 149, then set the Transaction Type attribute to 1.
296
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
For example.
For details about how to create a business rule, see the Use Business Rules With Order Management topic.
Try it.
1. Run an SQL to get the value you need for the Billing Transaction Type ID attribute.
297
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
SetIdSetPEO.SET_ID AS SET_ID1 ,
RaCustTrxTypesAll.CUST_TRX_TYPE_ID ,
RaCustTrxTypesAll.END_DATE ,
RaCustTrxTypesAll.START_DATE ,
RaCustTrxTypesAll.TYPE
FROM fusion.ra_cust_trx_types_all RaCustTrxTypesAll,
fusion.fnd_setid_sets_vl SetIdSetPEO
WHERE RaCustTrxTypesAll.SET_ID = SetIdSetPEO.SET_ID
AND RaCustTrxTypesAll.Type IN ('INV','CM','DM')
Assume the query returns a value of 1 for the Billing Transaction Type ID.
2. In the Setup and Maintenance work area, go to the task.
Attribute Value
Fline is a PostTransformationRules.FulfillLineVO
Fline.InventoryItemId is 149
◦ Navigate to the Order Management work area, then create a new sales order.
◦ In the Order Lines area, add an item that references the inventory item you specified earlier in this
procedure.
◦ On the Billing and Payment Details tab, in the Order Line Details area, on the order line you must modify,
click Edit Accounting Details.
◦ In the Edit Accounting Details dialog, set the Receivables Transaction attribute, then click Submit..
◦ Verify that Accounts Receivable correctly categorized the transaction.
298
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Related Topics
• Examples of Order Management Extensions for Order Headers
• Overview of Transformation Rules
You must make sure that the values you send in the payloads you use to integrate with various systems or applications
use the formula. . .
HeaderCurrencyUnitPrice equals HeaderCurrencyExtendedAmount divided by Quantity
If you don't use this formula, then Order Management might send an incorrect amount to Accounts Receivable for
billing. This requirement applies during order import or with any fulfillment task you set up in Order Management that
populates charge or charge component data, such as a task that converts shipping cost to billable charges.
For example, assume your payload includes a quantity of 2, unit price of $10, and amount of $30 for a discount. Order
Management will send the quantity of 2 and $10 unit price to Receivables. Order Management will ignore the $30
amount and instead calculate the amount as quantity 2 multiplied by unit price of $10 equals $20, then send $20 as a
discount to Receivables. Receivables bills the amount as $20, not $30. Order Management applies the same logic for a
shipping charge.
Note.
• If the unit price for the discount or shipping charge isn't available, then Order Management uses the same
behavior it uses in releases before 20A.
• If the $10 unit price isn't available for the discount or shipping charge, and if only the $30 amount and quantity
of 2 are available, then Order Management sends only the amount and quantity to Receivables. Receivables
calculates the unit price as the $30 amount divided by a quantity of 2 equals $15 for the discount.
• If the fulfillment line contains a service duration, then Order Management doesn't send the unit price for the
item, discounts, or shipping charges. This is the same behavior across the current and earlier releases.
• You must make sure your payload includes a value for the quantity, unit price, and amount. If you don't include
these values, then the amount for the discount or shipping charge between the sales order and billing will be
different.
Create One Invoice for Sales Orders with Items That Can and Can't Ship
Set up order management so it creates a single invoice when your sales order includes order lines that can ship and
lines that can't.
If your sales order includes order lines that can ship and lines that can't, then accounts receivable creates one invoice for
each line.
299
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
For example, if one order line contains the AS54888 desktop computer, which you can ship, and another line contains
the 3 Year Warranty for the AS54888, which can't ship, then accounts receivable creates two separate invoices, but you
only want one invoice because you're selling the computer and the warranty the that covers the computer to the same
customer on the same sales order.
This problem happens because you can ship the warranty immediately, but it takes more time to ship the computer. So
the Ship Date Actual attribute on the order line for the computer is different than the Ship Date Actual attribute on the
line for the warranty.
As a result, the GL Date (General Ledger Date) is different, and accounting creates two different invoices, one for each
date.
• The warranty doesn't have a fulfillment date or ship date in Order Management or in Shipping.
• Order Management sets the SHIP_DATE_ACTUAL column in the RA_INTERFACE_LINES_ALL table for the.
• The Import AutoInvoice scheduled process determines the General Ledger date. If the GL_DATE column.
300
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Note.
• Use the Pricing Administration work area to create a service mapping that maps an attribute value from
the sales order in Order Management, such as the requested ship date, to the GL Date attribute in Oracle
Receivables. You modify the FulfillmentIntegration service mapping. It doesn't affect pricing, but it does use
some of the same processing that Pricing uses. That's why its in the Pricing Administration work area.
• Run the Import AutoInvoice scheduled process to update the invoice.
301
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
◦ Create a sand box. For details, see the Create a Sandbox So You Can Edit Service Mappings topic.
◦ Go to the Pricing Administration work area.
◦ On the Overview page, click Tasks, then, under Order Management Configuration, click Manage Service
Mappings.
◦ On the Manage Service Mappings page, in the Name column, click FulfillmentIntegration.
2. Edit the source.
Attribute Value
Attribute GlDate
This value sets GlDate to the current date of the Oracle server instead of using the
actual ship date. It assumes you're shipping the item on the current data and time.
You can also set the GL Date only for business units that you specify.
OrgId in [list]?now():
where
For example, set GL Date only for business units 204 and 205.
OrgId in [204,205]?now():
302
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Attribute Value
You can also set GL Date to the value of an attribute, and only for specific business
units.
OrgId in list?attribute_name():
where
• attribute_name is the name of an attribute that contains the value you will set.
For example, set GL Date only for business units 204 and 205, and set it to the
requested ship date.
OrgId in [204,205]?RequestShipDate:null
View Object Attribute To populate your date according to an attribute, leave Expression empty and specify
the attribute in View Object Attribute.
For example, to set the GL Date to the same value as the requested date, enter
RequestShipDate in View Object Attribute.
If you set a value in the Expression, then leave View Object Attribute empty.
Attribute Value
Attribute GlDate
For details, see the Use SQL to Query Order Management Data topic.
4. Verify that ship_date_actual contains the date value of the Oracle server on both order lines.
Recall that you set GlDate to the current date of the Oracle server when you set up the service mapping.
303
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
5. Go to the Scheduled Processes work area, then run the Import AutoInvoice scheduled process.
6. Examine the results of running Import AutoInvoice. Verify that the process created a single invoice, and didn't
create two invoices.
Related Topics
• Create a Sandbox So You Can Edit Service Mappings
• Use SQL to Query Order Management Data
304
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Try it.
1. Run an SQL query to identify the Request ID for a specific invoice.
SELECT rcta.trx_number ,
rcta.ct_reference,
rctla.Sales_order,
rctla.request_id ,
rctla.line_number
FROM fusion.ra_customer_trx_all rcta ,
fusion.ra_customer_trx_lines_all rctla,
fusion.doo_fulfill_lines_all dfla
WHERE rcta.customer_trx_id = rctla.customer_trx_id
AND rctla.interface_line_attribute5 = TO_CHAR(dfla.fulfill_line_id)
AND
(
dfla.source_order_number = 'ORDER_NUMBER'
OR rctla.INTERFACE_LINE_ATTRIBUTE1 = 'ORDER_NUMBER'
OR rctla.Sales_order = 'ORDER_NUMBER'
)
ORDER BY rcta.customer_trx_id,
rctla.line_number
Replace each instance of ORDER_NUMBER in your query with the order number from Order Management. For
example, here's the code you use for order 57485.
dfla.source_order_number = '57485'
OR rctla.INTERFACE_LINE_ATTRIBUTE1 = '57485'
305
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
OR rctla.Sales_order = '57485'
For details about using SQL, see the Use SQL to Query Order Management Data topic.
2. Go to the Scheduled Processes work area.
3. On the Overview page, locate the instance of the Import AutoInvoice scheduled process you must reference.
Assume you see three instances, but you only need the most recent one that Import AutoInvoice processed for
the Vision Operations business unit. Click each instance, expand the Parameters area, then examine the value
in the Business Unit attribute. Assume your instance is.
Name Process ID
4. Click Schedule New Process, then run the Notify Feeder System of Receivables Transactions scheduled
process.
Parameter Value
Request ID 32364
Use the value that your SQL returned earlier in this procedure.
Set the Request ID parameter to the Process ID that identifies a specific instance of Import
AutoInvoice. If you don't, and if Import AutoInvoice runs more than one time, then Notify
Feeder System of Receivables Transactions might not work as expected because it can't
identify which instance of Import AutoInvoice to reference. Notify Feeder System of
Receivables Transactions might send details about the wrong invoice, or send no details at
all.
5. If the problem with the order status persists or the scheduled process doesn't run successfully, wait a few hours
then run Notify Feeder System of Receivables Transactions again. Sometimes there's a delay or a change in the
fulfillment system that affects the scheduled process.
Related Topics
• Use SQL to Query Order Management Data
Attributes You Can Use When Integrating Order Management with Accounts
Receivable
Get details about the attributes you can specify when you use an integration algorithm to send charges from Order
Management Cloud to Oracle Fusion Accounts Receivable.
306
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
YYYY/MM/DD
307
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
308
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
309
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
310
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
311
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
312
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
313
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
314
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
315
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
316
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Attribute Description
ApplyTo Indicates whether pricing applied the charge for the item, for shipping, or for the return.
AverageUnitSellingPrice Weighted average of the selling price. This average is the total sales revenue divided by total
units sold.
ChargeAppliesTo Indicates whether pricing applied the charge for the item, for shipping, or for the return.
ChargeDefinition Charge definition that defines the price type, charge type, and subtype.
ChargeType Charge type, such as item sale, service sale, financing, lease, shipping, restocking penalties,
and so on.
GSAUnitPrice Price for each unit. Determined from the price list on the pricing strategy.
PricedQuantity Abbreviation that identifies the unit of measure for the priced quantity, such as Ton.
PricedQuantityUOM Unit of measure for priced quantity, such as Ton. Product Information Management or a
service in Order Management Cloud provides this value.
PricedQuantityUOMCode Abbreviation that identifies the unit of measure for the priced quantity.
317
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Attribute Description
PricePeriodicity Time period for a recurring price, such as month, quarter, or year.
PricePeriodicityCode Abbreviation that identifies the time period for the price.
SourceChargeId Value that uniquely identifies the charge. The source system applies this value.
Attribute Description
ChargeCurrencyCode Abbreviation that identifies the currency that the charge component uses.
ChargeCurrencyDurationExtendedAmountExtended amount for the duration displayed in the currency that the charge uses.
ChargeCurrencyExtendedAmount Extended amount displayed in the currency that the charge uses. Extended amount equals
the unit price multiplied by the quantity on the order line. For a configured item, the extended
amount equals the unit price multiplied by the extended quantity on the order line.
ChargeCurrencyUnitPrice Price or adjustment for each unit displayed in the charge currency that the order line uses.
ExplanationMessageName Message name of the explanation that displays in the price break down dialog.
318
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Attribute Description
HeaderCurrencyCode Abbreviation that identifies the currency that the order header uses.
HeaderCurrencyDurationExtendedAmountExtended amount for the duration, displayed in the currency that the order header uses.
HeaderCurrencyExtendedAmount Extended amount, displayed in the currency that the order header uses.
HeaderCurrencyUnitPrice Price or adjustment for each unit of the item, displayed in the currency that the order header
uses.
PercentOfComparisonElement Percent that the unit price constitutes of the basis charge component. The default value for
the basis is List Price. This attribute stores the margin percent, the percent that net price
constitutes of the list price, and so on.
PriceElement Name of the price element, such as list price, net price, and so on.
PricingSourceId Value that identifies the source of the lowest level pricing. For example, it contains the Id that
identifies a line on the price list, a tier rule, a shipping line, and so on.
PricingSourceType Type of the price source, such as the lines of a segment price list. The lookup
QP_ENTITY_TYPES or a manual price adjustment provides the value for this attribute.
RollupFlag Indicates whether the value is a rollup value for the charge component.
SourceChargeComponentId Value that uniquely identifies the charge component that the source system assigns.
TaxIncludedFlag Indicates whether the price for the charge component includes tax.
319
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Related Topics
• Pricing Algorithm
• Service Mapping
Revenue Management
Overview of Integrating Order Management with Revenue Management
Automate how Revenue Management gets sales order data from Order Management so Revenue Management can
recognize revenue for the sales order.
Revenue Management uses this data to create a customer contract and record the performance obligations for the
contract. Revenue Management recognizes revenue for the performance obligations when Order Management fulfills
the sales order.
Use this integration to meet IFRS 15 (International Financial Reporting Standard) and ASC 606 (Financial Accounting
Standards Board and International Accounting Standards Board) requirements.
• Identify the contracts you have with your customers for your order lines.
• Identify the performance obligations that the contract specifies.
• Determine the transaction price, which is the price you charge your customer to fulfill the order line according
to the contract requirements.
• Recognize the revenue you realize when you meet the performance obligation, such as fulfilling the order line
by the requested fulfillment date.
Note.
• Revenue Management automatically calculates the transaction price according to the sum of the selling price,
and allocates the transaction price to each performance obligation.
• Use this integration to manage change throughout the sales order lifecycle, including revisions to the quantity
or price on the order line, return order, and so on. Revenue Management automatically modifies the contract to
reflect these changes and reallocates the new price to the performance obligation.
320
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Explanation of Numbers
1. An Order Entry Specialist creates a sales order in the Order Management work area, or you import one into
Order Management.
2. You use the Extract Sales Orders for Revenue Management scheduled process to interface the sales order so
Revenue Management can process revenue and Cost Management can process the cost of goods sold.
3. Revenue Management uses rules that you set up to identify accounting contracts and their performance
obligations. One accounting contract might reference one or more sales orders from different source systems,
or several contracts might reference one sales order that has more than one order line. Each sales order line
becomes a promised detail line in Revenue Management.
321
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
4. Order Management sends fulfillment details, such as the fulfilled quantity, amount, and delivery date. It
sends these details when the line reaches the Ship Confirm status regardless of which step you specify as the
fulfillment completion step. For details about this step, see the Guidelines for Setting Up Orchestration Process
Steps topic.
Order Management sends fulfillment details for each fulfillment line, such as the fulfilled quantity, amount,
and delivery date. It only sends these details when the line reaches the Shipped status for an outbound line or
Delivered status for a return line. Order Management uses this behavior regardless of the orchestration process
step that you specify as the fulfillment completion step. Order Management uses this behavior even if you set
up your own step in the orchestration process and specify it as the fulfillment completion step.
One fulfillment line in Order Management corresponds to one promised detail line in Revenue Management. If
Order Management splits a fulfillment line, then Revenue Management represents each of these split lines as
one promised detail line.
5. Revenue Management records the event that satisfies the performance obligations, then recognizes revenue.
◦ If the item on the fulfillment line is a service item or subscription item, then Revenue Management
automatically recognizes revenue for it over the full duration of the service or subscription, according to
the satisfaction plan for the item.
◦ You can set up the satisfaction plan in Revenue Management and use a revenue scheduling rule to assign
it to each fulfillment line.
◦ The default satisfaction plan uses the daily rate to calculate revenue.
6. Order Management sends the fulfillment line to Receivables, Receivables creates an invoice to debit the
Receivables account and credit the Revenue Clearing account, then sends it to your customer.
7. Revenue Management sends revenue details to Cost Management so Cost Management can recognize the cost
of goods sold in the same time frame and in the same proportion that Revenue Management uses to recognize
revenue.
8. Cost Management can use these details to analyze gross margin.
Guidelines
• If you revise the price or quantity on an order line, then Revenue Management automatically revises the
corresponding accounting contracts to reflect these revisions.
• If you return a sales order, then Revenue Management automatically modifies the contract to reflect the return.
You can return part or all of a shipment, reduce the price in the return, or cancel a subscription or service that
has recurring billing.
For details about how to set up Order Management to return a sales order, see the Integrate Return Orders
topic.
• Make sure each service item or subscription item includes a start date and an end date before you run the
scheduled process.
• You can invoice an internal material transfer or internal order in Receivables but this integration doesn't
integrate them with Revenue Management.
• Revenue Management processes all sales orders except for internal material transfers and transfer orders.
• Make sure you assign the Extraction Start Date system option.
◦ The scheduled process processes sales orders that you submit on or after the Extraction Start Date in
Revenue Management.
◦ The first extract can include sales transactions that you submit up to 90 days before the current date.
◦ The extract includes only the primary charge for the item, the profit center business unit on the
fulfillment line, and flexfield data.
322
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
• If you need to set up an extensible flexfield to allow the Order Entry Specialist to identify contracts or
performance obligations, then create and use a context named.
Greater than the ordered quantity You invoice the shipped quantity Insert a new document line, increment the
version and set the quantity so its equal to
the shipped quantity.
Greater than the ordered quantity You invoice the ordered quantity Add a subline that has the quantity for the
satisfaction event equal to the ordered
quantity.
For details about these parameters, see the Set Up Shipping Tolerances in Order Management topic.
Example Flows
Here are descriptions of some typical order flows.
Ship and invoice one shipment When Order Management sends Applies to shippable items, including
fulfillment details various configured items, such as
assemble-to-order, pick-to-order, kits, and
combinations of these configurations.
Ship and invoice a split shipment When Order Management sends Applies when Order Management splits
fulfillment details a fulfillment line. Some lines are fulfilled,
others are pending.
323
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Ship and invoice a shipment that uses an When Order Management sends Revenue Management automatically
overshipment tolerance fulfillment details updates the contract with the adjusted
price to reflect the overshipment.
For ship only, ship the item but don't When Order Management sends Use this flow to integrate Revenue
invoice it fulfillment details Management with your legacy billing
system.
For bill only, send the invoice but not the After you submit the invoice Order Management sends the fulfilled
shipment because the item isn't shippable quantity to Revenue Management after
you submit the invoice.
For bill only with a a service or Over time according to the daily rate or a Revenue Management automatically
subscription, send the invoice but not the satisfaction plan that you set up recognizes revenue over the duration
shipment because the item is a service of the service or subscription, starting
or subscription. Include more detail that according to the start date and stopping
Revenue Management needs for a service according to the end date on the
or subscription. fulfillment line.
Note.
• Each flow identifies contracts and performance obligations when the Order Entry Specialist clicks Submit to
submit the sales order to fulfillment.
• Each flow recognizes cost of goods sold immediately after it recognizes revenue, except for the service or
subscription flow because cost of goods sold aren't applicable for a service or subscription.
Example Transaction
A transaction in Order Management can include two sales orders that use the same purchase order number to identify
them as falling under one contract. Revenue Management groups these orders into one accounting contract, and
Cost Management matches cost of goods sold to the revenue that Revenue Management recognizes. For details,
see Integrate Revenue Management with Order Management and Supply Chain Cost Management at https://
www.oracle.com/webfolder/technetwork/tutorials/tutorial/cloud/r13/wn/om/releases/20C/20C-order-mgmt-
wn.htm#F13859.
For other details, see ERP - Integration of Revenue Management with Order Management and Supply
Chain Cost Management with Demo of End to End Flow on Oracle Cloud Customer Connect at https://
cloudcustomerconnect.oracle.com.
Related Topics
• Guidelines for Processing Return Orders
• Guidelines for Setting Up Orchestration Process Steps
• Set Up Shipping Tolerances in Order Management
324
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
◦ Offering: Financials
◦ Functional Area: Revenue Management
◦ Task: Manage System Options for Revenue Management
3. In the Source Document Types area, locate the row you will modify. If the row doesn't exist, then create a new
one.
Attribute Value
You can use this integration only with the Sales Order document type.
Attribute Value
If the Order Entry Specialist uses the Edit Currency Details action on the order header to set
the Type attribute in the Conversion for Accounting area, then the integration uses that value
instead of the value you set in Currency Conversion Type.
5. Click Extraction Start Date in the row you just modified, then set values.
325
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Attribute Value
Company 01 Operations
These roles have the Extract Sales Orders for Revenue Management privilege that you need to run the
scheduled process.
3. Go to the Scheduled Processes work area, then click Schedule New Process.
4. Search for the scheduled process.
Attribute Value
The process sends sales orders, return orders, order revisions, and fulfillment details to
Revenue Management.
326
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
5. Set the business unit, click Schedule, then schedule the process to run at least one time each day.
6. Set the parameters depending on how they impact performance.
Attribute Value
If you don't specify a value, then the scheduled process will process up to 5,000 lines in each
batch, by default.
Number of Processes Specify the number of instances of this scheduled process to run concurrently. Running
processes concurrently helps to finish the batches more quickly, but also consumes more
resources.
If you don't specify a value, then the scheduled process will run up to 4 concurrent instances,
by default.
7. Click Submit, then notice the process number that the confirmation dialog displays, such as 122044.
8. Click Refresh, then monitor the search results for your process, such as 122044.
The search results might display more than one instance of your process depending on how you set the
parameters. For example, if you set Number of Processes to 6, then it might display up to 6 instances of
122044.
◦ Offering: Financials
◦ Functional Area: Receivables
◦ Task: Manage Receivables Lookups
2. On the Manage Receivables Lookups page, search for the value.
Attribute Value
3. In the Lookup Codes area, click Actions > New, then set values.
Attribute Value
327
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Attribute Value
Display Sequence 1
Related Topics
• Pricing Dimensions
• Standalone Selling Price Profiles
• Performance Obligation Identification Rules
Flexfields
Overview of Using Flexfields to Integrate Order Management with Other Oracle
Applications
Use a descriptive flexfield to integrate Order Management Cloud with Oracle Receivables, Oracle Shipping, Oracle
Receiving, or Oracle Procurement.
You can send each value that an extensible flexfield uses to an upstream source system or to a downstream fulfillment
system. You use a web service payload to send the value.
Guidelines
Consider these guidelines.
• Oracle Receivables comes predefined with a separate entity for each descriptive flexfield. You don't have to
use separate entities for descriptive flexfields in Shipping, Receiving or Procurement because their predefined
entities already have the descriptive flexfields you need.
• You make attributes available in the main entity.
• You must make sure your set up only references attributes that each application supports. For a list of
attributes, see the Entities and Attributes You Can Use When Integrating Order Management with Other Oracle
Applications topic.
• You must reference the database code that identifies each attribute, such as Attribute1 or Attributedate2. You
must not use the implemented names to reference the attributes.
• If you reference a descriptive flexfield according to context, then you must make sure your set up populates
AttributeCategory. If you use a global segment, then it isn't necessary to populate AttributeCategory.
• If your flexfield is on a fulfillment line, then use only one context for each entity. Your set up must not attempt
to process two different contexts at the same time. For example, if you need to process two attributes, then add
328
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
two segments to the same context. Add segment x and segment y to context A. Don't add segment x to context
A and segment y to context B.
You can use the Copy-of feature in XLST (Extensible Stylesheet Language Transformations) instead of doing this work
manually. This feature dynamically maps the input extensible flexfields to the Order Management entities and maps the
extensible flexfield entity in Order Management to the SDO or modified node.
Example Payloads
You can examine an example payload that uses a flexfield to send custom data to your downstream fulfillment system.
Go to My Oracle Support, search for Document ID 2051639.1 (Technical Reference for Order Management Cloud),
download the Payloads and Other Example Files attachment, then see the Other section in the attachment.
Here's part of an example orderImportService payload that uses a flexfield to import custom data from an upstream
source system. For the entire payload, see the attachment in document ID 2051639.1.
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<ns1:createOrders
xmlns:ns1="http://xmlns.oracle.com/apps/scm/fom/importOrders/orderImportService/types/">
<ns1:request
xmlns:ns2="http://xmlns.oracle.com/apps/scm/fom/importOrders/orderImportService/">
<ns2:Order>
<ns2:SourceTransactionIdentifier>SN_201117_Desktop_02</ns2:SourceTransactionIdentifier>
<ns2:SourceTransactionSystem>GPR</ns2:SourceTransactionSystem>
<ns2:SourceTransactionNumber>SN_1811_01_Desktop_02</ns2:SourceTransactionNumber>
<ns2:BuyingPartyId>1006</ns2:BuyingPartyId>
<ns2:TransactionalCurrencyCode>USD</ns2:TransactionalCurrencyCode>
<ns2:TransactionOn>2020-11-08T13:50:50.0340</ns2:TransactionOn>
<ns2:RequestingBusinessUnitIdentifier>204</ns2:RequestingBusinessUnitIdentifier>
<ns2:RequestingLegalUnitIdentifier>204</ns2:RequestingLegalUnitIdentifier>
<ns2:FreezePriceFlag>false</ns2:FreezePriceFlag>
<ns2:FreezeShippingChargeFlag>false</ns2:FreezeShippingChargeFlag>
<ns2:FreezeTaxFlag>false</ns2:FreezeTaxFlag>
<ns2:CustomerPONumber>SNVALE</ns2:CustomerPONumber>
<ns2:Line>
. . .
<ns2:AdditionalFulfillmentLineInformationCategories
xsi:type="ns12:j_FulfillLineEffDooFulfillLinesAddInfoprivate"
xmlns:ns12="http://xmlns.oracle.com/apps/scm/doo/processOrder/flex/fulfillLineCategories/"
xmlns:ns22="http://xmlns.oracle.com/apps/scm/doo/processOrder/flex/fulfillLineContextsB/"
xmlns:ns8="http://xmlns.oracle.com/apps/scm/doo/processOrder/model/"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<ns8:Category>DOO_FULFILL_LINES_ADD_INFO</ns8:Category>
<!--Single Context(DOO_FULFILL_LINES_ADD_INFO)-->
<ns12:FulfillLineEffBPackShipInstructionprivateVO>
<ns8:ContextCode>PackShipInstruction</ns8:ContextCode>
<ns22:_PackingInstruction>Place bubble wrap on
top and at the bottom</ns22:_PackingInstruction>
329
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
<ns22:_ShippingInstruction>SOMETHINGRIGHT</ns22:_ShippingInstruction>
<ns22:_ShippingCost>1999</ns22:_ShippingCost>
<ns22:_NeedbyDate>2020-12-01T00:00:00</ns22:_NeedbyDate>
<ns22:_PickDate>2020-12-01T00:00:00</ns22:_PickDate>
</ns12:FulfillLineEffBPackShipInstructionprivateVO>
</ns2:AdditionalFulfillmentLineInformationCategories>
</ns2:Line>
. . .
<ns2:AdditionalHeaderInformationCategories
xsi:type="ns12:j_HeaderEffDooHeadersAddInfoprivate"
xmlns:ns12="http://xmlns.oracle.com/apps/scm/doo/processOrder/flex/headerCategories/"
xmlns:ns22="http://xmlns.oracle.com/apps/scm/doo/processOrder/flex/headerContextsB/"
xmlns:ns8="http://xmlns.oracle.com/apps/scm/doo/processOrder/model/"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<ns8:Category>DOO_HEADERS_ADD_INFO</ns8:Category>
<ns12:HeaderEffBComplianceDetailsprivateVO>
<ns8:ContextCode>ComplianceDetails</ns8:ContextCode>
<ns22:_ComplianceInfo>This order complies with the
all regulations</ns22:_ComplianceInfo>
<ns22:_ComplianceReason>ASLDFSome compliance reason</ns22:_ComplianceReason>
<ns22:_ComplianceDate>2015-07-02T10:10:10</ns22:_ComplianceDate>
<ns22:_CompleteCompliancedate>2015-07-01T10:10:10</ns22:_CompleteCompliancedate>
<ns22:_ComplianceValue>12345</ns22:_ComplianceValue>
</ns12:HeaderEffBComplianceDetailsprivateVO>
<ns12:HeaderEffBHeaderContext1privateVO>
<ns8:ContextCode>HeaderContext1</ns8:ContextCode>
<ns22:_H1AttributeChar1>3zVendorrelocationtoUSy</ns22:_H1AttributeChar1>
<ns22:_H1AttributeChar2>ABC - xyz</ns22:_H1AttributeChar2>
<ns22:_H1AttributeNum1>1999</ns22:_H1AttributeNum1>
<ns22:_H1AttributeDateTime1>2015-01-01T10:10:10</ns22:_H1AttributeDateTime1>
</ns12:HeaderEffBHeaderContext1privateVO>
<ns12:HeaderEffBEND_5FUSE_5FPARTYprivateVO>
<ns2:ContextCode>END_USE_PARTY</ns2:ContextCode>
<ns22:endUserCustomerName>Attr 1 and 3</ns22:endUserCustomerName>
<ns22:endUserAddress>4405</ns22:endUserAddress>
<ns22:endUserCustomer>1289</ns22:endUserCustomer>
<ns22:endUserAddress2>4420</ns22:endUserAddress2>
</ns12:HeaderEffBEND_5FUSE_5FPARTYprivateVO>
</ns2:AdditionalHeaderInformationCategories>
</ns2:Order>
</ns1:request>
</ns1:createOrders>
</soap:Body>
</soap:Envelope>
Related Topics
• Overview of Using Extensible Flexfields in Order Management
In this example, you use a descriptive flexfield named Invoice Lines to integrate Order Management with Oracle
Receivables.
330
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
For details, see the Get Started with Integrating Order Management with Other Oracle Applications topic.
Use a spreadsheet editor, such as Microsoft Excel, to create a spreadsheet that contains columns and values.
The Source column describes the source you will use to get the value you will enter in the Value column. Leave
the Value column empty for now. You will add values to it during this procedure.
2. Go to the Setup and Maintenance work area, then go to the task.
◦ Offering: Financials
◦ Functional Area: Receivables
◦ Task: Manage Receivables Descriptive Flexfields
The task name is different for other Oracle Fusion applications. For example, if you're integrating with
Purchasing, then go to the Manage Purchasing Descriptive Flexfields task instead.
3. On the Manage Receivables Descriptive Flexfields page, search for the value.
Attribute Value
4. In the search results, click the row that contains the value.
331
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Attribute Value
The name of this file will include the value of the Flexfield Code attribute. For this example, the file name
is 222_RA_CUSTOMER_TRX_LINES.zip.
◦ Use Windows Explorer to navigate to 222_RA_CUSTOMER_TRX_LINES.zip.
◦ Expand 222_RA_CUSTOMER_TRX_LINES.zip > Oracle > Apps > Financials > Receivables > transactions >
shared > model > flex > TransactionLineDff.
◦ Use an editor, such as Notepad++ or an XML editor, to open one of the files.
This folder contains several XSD files. You open the XSD file that contains the context
code you use for this example, which is RA_CUSTOMER_TRX_LINES_Con1.
If you don't set up a context, then the DefaultValue attribute is empty, and
_FLEX_Context is empty in the Sources tab of the service mapping.
If you set up the context for only one attribute in the flexfield, then you can use
DefaultValue of this attribute when you specify _FLEX_Context in the VO.xml file.
6. Copy values to your spreadsheet, then close the editor. Make sure you include the single quotation marks ( ' ) in
each value.
Attribute Value
targetNamespace 'http://xmlns.oracle.com/apps/financials/receivables/transactions/shared/model/flex/
TransactionLineDff/'
332
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Attribute Value
complexType If you.
For example, the RACUSTOMERTRXLINESCon1.xsd file contains the attributes on lines 2 and 4.
7. In Windows Explorer, expand View, then use an XML editor to open the file that includes the public view object
with the context you need.
9. Identify the name of the view attribute you must map, then copy it to your spreadsheet.
333
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
In this example, search the XML file for a view attribute that contains RACUSTOMERTRXLINESSSeq1.
Attribute Value
Attribute Value
◦ Cancel pages until you're back on the Setup and Maintenance page.
11. Verify that your spreadsheet contains the values.
You must enclose each string value with single quotation marks.
334
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Fulfillment Integration
Service Mapping 1
Invoice Sources
Invoice Service
3 4
TransactionLineDff NameSpace
XsiType
_FLEX_Context
RACUSTOMERTRXLINESCon
1_Custom
1. Source. Provides a structure so Order Management can model data in the input SDO (service data object).
◦ Modify the InvoiceSources source on the predefined FulfillmentIntegration service mapping. You will map
this source to the TransactionLineDff entity. This entity comes predefined with attributes NameSpace,
XsiType, and _FLEX_Context.
◦ Add the RACUSTOMERTRXLINESCon1_Custom attribute. The FulfillmentIntegration context comes
predefined with the descriptive flexfields and global descriptive flexfields that Order Management
supports.
2. Service. Requests the service mapping and receives the output SDO. In this example, the InvoiceService service
references the entities and attributes that the integration algorithm uses to get the value of the descriptive
flexfield.
335
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
3. Entity. The entity that the service mapping requires to structure the output SDO. In this example, you modify
the TransactionLineDff entity so it references the descriptive flexfield.
4. Attributes. The attributes that the service mapping requires to structure the output SDO. You will set up these
attributes so they reference objects and properties in Oracle Receivables.
For details about the service data object, see the How Service Mappings, Pricing Algorithms, and Matrixes Work
Together topic.
1. Sign into Order Management with the Order Administrator job role.
Use the Order Administrator job role so you can access the integration algorithm and service mappings that
you use in the Pricing Administration work area to set up the integration.
2. Create a sand box. For details, see the Create a Sandbox So You Can Edit Service Mappings topic.
3. Go to the Pricing Administration work area.
4. On the Overview page, click Tasks, then, under Order Management Configuration, click Manage Service
Mappings.
5. On the Manage Service Mappings page, in the Name column, click FulfillmentIntegration.
6. On the Edit Service Mappings page, on the Entities tab, click the row that contains the value.
Attribute Value
Entity TransactionLineDff
7. Click Sources.
8. In the InvoiceSources - Details area, on the Entity Mappings tab, click the row that contains the value.
Attribute Value
Entity TransactionLineDff
Include only the attributes that you want. For example, the integration uses the POLineNumber attribute to
populate the ATTRIBUTE_CATEGORY column of the RA_INTERFACE_LINE_ALL table. If you don't want any
values in ATTRIBUTE_CATEGORY, then make sure the Entity Mappings tab doesn't contain the POLineNumber
attribute.
9. On the Attribute Mappings tab, add expressions, then click Save.
Attribute Expression
NameSpace "http://xmlns.oracle.com/apps/financials/receivables/publicFlex/TransactionLineDff/"
XsiType "RACUSTOMERTRXLINESCon1"
336
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Copy values from your spreadsheet into the expression. You must use one set of double quotation marks ( " ) to
enclose each string that you define in the expression.
10. Click Services, then click the row that contains the value.
Attribute Value
Entity TransactionLineDff
11. In the TransactionLineDff - Entities area, add a row for each entity.
◦ _FLEX_Context
◦ XsiType
◦ NameSpace
◦ RACUSTOMERTRXLINESCon1_Custom
Note.
◦ Make sure the Read attribute and the Write attribute each contain a check mark in each row.
◦ You must add a value in the Alias attribute in each row, and the alias must begins with an upper case
character, such as My Alias. Don't begin the alias with a lower case character, such as my alias.
12. Click Save and Close.
Related Topics
• Pricing Algorithm
• Service Mapping
• How Service Mappings, Pricing Algorithms, and Matrixes Work Together
Assume you implemented a context and segment for the header extensible flexfield.
• HeaderContext as the context
• H1AttributeNum as the segment
You will you add an extensible flexfield on the order header in the service mapping, store the Id of the primary
salesperson in the extensible flexfield, then map it to the Id of the primary salesperson on the Accounts Receivable line.
337
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
This topic includes example values. You might use different values, depending on your business requirements.
Attribute Value
5. In the search results, click the row that contains the value.
Attribute Value
338
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Attribute Value
11. Copy the name of the attribute you will use to store the Id of the primary salesperson to your spreadsheet.
Look for the ViewAttribute that matches the segment you're using to store the value you need. For this
example, here's the value you copy.
Attribute Value
For example, the HeaderEffBHeaderContext1privateVO.xml file contains the view attribute name.
339
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Fulfillment Integration
Service Mapping Invoice Sources
Entity Mapping
Entity: HeaderSalesPersonEFF_Custom
View Object: HeaderContext1privateVO
Query Attribute: HeaderId
Joined Entity: Header
Joined Entity Attribute: HeaderId
Attribute Mapping:
- HeaderId_Custom references HeaderId
- SalesPersonId_Custom references H1AttributeNum1
Invoice Service
maps
HeaderSalesPersonEFF
HeaderId_Custom
_Custom
SalesPersonId_Custom
Header HeaderId
ARInterfaceLine ResourceSalesrepId
340
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Try it.
1. Sign into Oracle Management with the Order Administrator job role, then, in the Navigator, click Pricing
Administration.
Use this job role to access the integration algorithm and service mappings you use in the Pricing Administration
work area to set up the integration.
2. On the Overview page, click Tasks, then, under Order Management Configuration, click Manage Service
Mappings.
3. On the Manage Service Mappings page, in the Name column, click FulfillmentIntegration.
4. On the Edit Service Mappings page, on the Entities tab, click Actions > Add Row, then set values.
Attribute Value
Entity HeaderSalesPersonEFF_Custom
Description Context for an extensible flexfield on the order header. It contains details about the
salesperson.
Attribute Type
HeaderId_Custom Long
SalesPersonId_Custom Long
If you use a descriptive flexfield as part of this solution, then you must specify the same Type that you specify
for the attribute in the extensible flexfield. For example, if you use SalesPersonId of type Long in the descriptive
flexfield, then you must also specify SalesPersonId as Long on the extensible flexfield. In a different scenario, if
you use an attribute named packingInstructions of type String on your descriptive flexfield, then you must also
set packingInstructions to String on your extensible flexfield. If you don't use the same data type, then your
service mapping might not fail when compiling but will fail in your runtime environment. The runtime failure
might be difficult to troubleshoot because you might not encounter any errors but your set up might not work
as you expected.
6. Set up the sources.
◦ Click Sources.
◦ In the InvoiceSources - Details area, on the Entity Mappings tab, click View > Columns, then add a check
mark to each value.
• Joined Entity
• Joined Entity Attribute
• Use Existing View Object
◦ Click Actions > Add Row, set values, then click Save.
341
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Attribute Value
Entity HeaderSalesPersonEFF_Custom
HeaderId_Custom HeaderId
SalesPersonId_Custom _H1AttributeNum1
The attribute View Object Attribute is required for each mapping you create in this topic.
◦ On the Entity Mappings tab, click the row that contains the value.
Entity ARInterfaceLine
◦ In the ARInterfaceLine - Details area, click Actions > Add Row, set the value, then click Save.
342
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Attribute Value
Attribute ResourceSalesrepId
◦ Click Services.
◦ In the InvoiceService - Details area, click Actions > Add Row, then set the value.
Attribute Value
Entity HeaderSalesPersonEFF_Custom
Attribute Alias
HeaderId_Custom Optional
SalesPersonId_Custom Optional.
The alias is optional. You can add a value or leave it empty. If you add an alias, make sure it begins with
an upper case character, such as My Alias. Don't begin the alias with a lower case character, such as my
alias.
◦ In the InvoiceService - Details area, click the row that contains the value.
Attribute Value
Entity Header
Attribute Alias
◦ In the InvoiceService - Details area, click the row that contains the value.
343
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Attribute Value
Entity ARInterfaceLine
◦ In the ARInterfaceLine - Entities area, add the attribute, then click Save and Close.
Attribute Alias
Attribute Value
4. Click Variables > Actions > Add Row, set the values, then click Save.
Attribute Value
Name ARIntegration
5. Click Algorithm > Add Step > Conditional Action, set the values, then click Save.
Attribute Value
Description Map the primary salesperson from the extensible flexfield that resides on the order header.
344
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
6. In the Data Sets area, add the data sets, then click Save.
HdrEFF ARIntegration.HeaderSalesPersonEFF_Custom
Zero or one [HeaderId_Custom:
{FLine. HeaderId}]
where
Code Description
ARIntegration.ARInterfaceLine Specifies to use entity ARInterfaceLine of the service mapping to get order details, then store
them in ARIntegration, which is the variable you added to this integration algorithm earlier in
this topic.
This integration uses ARIntegration to temporarily store the data that this integration
algorithm will communicate through the service mapping. The Data Set Join is empty in
primary data set ARLine because the secondary data set populates ARLine.
ARIntegration.HeaderSalesPersonEFF_Custom
Filters the results in ARIntegration according to order header.
The join [HeaderId_Custom: {FLine. HeaderId}] uses the HeaderId attribute of the
HeaderSalesPersonEFF_Custom entity to filter the FLine data set so it contains only order
headers.
Note.
◦ In the Variable Path, make sure you use the exact entity names from the service mapping, such as
ARInterfaceLine, FulfillLine, and HeaderSalesPersonEFF_Custom.
◦ To make ARLine the primary, enable the Primary option.
◦ Each group of data sets includes one primary data set and one or more secondary data sets.
◦ Cardinality specifies that there is zero or one records in the secondary data set to one or many records in
the primary data set. It determines whether the join is an inner join or outer join.
◦ Data Set Join defines the constraint that this step uses to filter records that the secondary data set saves
in the primary.
345
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
◦ FLine represents a row from entity FulffillLine that matches the join condition. The name is case-
sensitive. Make sure you use FLine, not Fline.
◦ HdrEFF represents a row from entity HeaderSalesPersonEFF_Custom that matches the join condition.
◦ ARInterfaceLine and FufillLine come predefined.
◦ You create HeaderSalesPersonEFF_Custom in the service mapping.
◦ARInterfaceLine comes predefined with attribute ResourceSalesRepId. Your set up will
populate ResourceSalesRepId with the value from attribute SalesPerson_Custom in entity
HeaderSalesPersonEFF_Custom that you define. You define HeaderSalesPersonEFF_Custom in the join
conditions for the data set so it uniquely identifies the row that your set up uses to do the mapping.
7. In the Execute Condition area, click Add Condition > Default Action, add the value, then click Save and Close.
Attribute Value
Action ARLine.ResourceSalesrepId=HdrEFF.SalesPerson_Custom
where
Attribute Value
Service InvoiceService
where
◦ Accounts Receivable Mapping Custom is the name of the integration algorithm you created.
346
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
AttributeCategory RequestingBusinessUnitName
The rest of the setup is similar to using a descriptive flexfield. For details see, Use Descriptive Flexfields to Integrate
Order Management with Other Oracle Applications.
Related Topics
• Create a Sandbox So You Can Edit Service Mappings
Reference
Entities and Attributes You Can Use When Integrating Order Management with Other
Oracle Applications
Use a variety of entities and attributes when you integrate Order Management Cloud with some other Oracle
application.
Summary
Here's a summary of the entities, sources, and services you can use in a service mapping or integration algorithm.
Object Value
Common Header
FulfillLine
FilfillLineDetails
ShipmentSource ShipmentRequestHeader
ShipmentRequestLine
347
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Object Value
InvoiceSource ARChargeInterfaceLine
ARInterfaceLine
Charge
ChargeComponent
TransactionInterfaceGdf
TransactionInterfaceHeaderDff
TransactionInterfaceLinkToDff
TransactionInterfaceLinkToDff
TransactionLineInterfaceGdf
PurchaseRequestSource PurchaseRequestHeader
PurchaseRequestLine
PurchaseRequestConfig
ReceiptSource ReceiptAdvice
ReceiptAdviceLine
ReceiptAdviceLineLot
ReceiptAdviceLineLotWithSerials
Entity Description
348
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Entity Description
TransactionInterfaceGdf, Flexfield that stores receivable transactions that are available globally.
TransactionLineInterfaceGdf, Flexfield that stores receivable transaction lines that are available globally.
ReceiptAdviceLineLotWithSerials Serial number and lot number details for the receipt advice line.
TransactionInterfaceHeaderDff Descriptive flexfield that stores details about the receivables transaction header.
ARChargeInterfaceLine Account receivables on the interface line. You use this object primarily for charges, discounts,
or freight.
You can map the attributes that the ARInterfaceLine entity contains.
349
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
ApproverEmail string
ApproverId long
AssessableAmount decimal
Attribute1 string
Attribute10 string
Attribute11 string
Attribute12 string
Attribute13 string
Attribute14 string
Attribute15 string
Attribute16 string
Attribute17 string
Attribute18 string
Attribute19 string
Attribute2 string
Attribute20 string
Attribute3 string
Attribute4 string
350
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Attribute5 string
Attribute6 string
Attribute7 string
Attribute8 string
Attribute9 string
AttributeCategory string
AttributeDate1 date
AttributeDate10 date
AttributeDate2 date
AttributeDate3 date
AttributeDate4 date
AttributeDate5 date
AttributeDate6 date
AttributeDate7 date
AttributeDate8 date
AttributeDate9 date
AttributeNumber1 decimal
AttributeNumber10 decimal
AttributeNumber2 decimal
AttributeNumber3 decimal
351
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
AttributeNumber4 decimal
AttributeNumber5 decimal
AttributeNumber6 decimal
AttributeNumber7 decimal
AttributeNumber8 decimal
AttributeNumber9 decimal
AttributeTimestamp1 dateTime
AttributeTimestamp10 dateTime
AttributeTimestamp2 dateTime
AttributeTimestamp3 dateTime
AttributeTimestamp4 dateTime
AttributeTimestamp5 dateTime
AttributeTimestamp6 dateTime
AttributeTimestamp7 dateTime
AttributeTimestamp8 dateTime
AttributeTimestamp9 dateTime
Description string
DocumentStatusCode string
EmergencyPONumber string
HeaderId Long
352
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
InterfaceSourceLineId long
Justification string
RequisitionNumber string
SoldToLegalEntityId long
SoldToLegalEntityName string
TaxationCountryCode string
TaxationTerritory string
AttachmentCategory string
AttachmentEntityName string
AttachmentPrimaryKey1 string
AttachmentPrimaryKey2 string
AttachmentPrimaryKey3 string
AttachmentPrimaryKey4 string
AttachmentPrimaryKey5 string
DocumentFiscalClassification string
DocumentFiscalClassificationCode string
ExternallyManagedFlag boolean
InterfaceHeaderKey string
353
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
PreparerEmail string
PreparerId long
RequisitioningBUId long
RequisitioningBUName string
Amount decimal
Attribute1 string
Attribute10 string
Attribute11 string
Attribute12 string
Attribute13 string
Attribute14 string
Attribute15 string
Attribute16 string
Attribute17 string
Attribute18 string
Attribute19 string
Attribute2 string
354
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Attribute20 string
Attribute3 string
Attribute4 string
Attribute5 string
Attribute6 string
Attribute7 string
Attribute8 string
Attribute9 string
AttributeCategory string
AttributeDate1 date
AttributeDate10 date
AttributeDate2 date
AttributeDate3 date
AttributeDate4 date
AttributeDate5 date
AttributeDate6 date
AttributeDate7 date
AttributeDate8 date
AttributeDate9 date
AttributeNumber1 decimal
355
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
AttributeNumber10 decimal
AttributeNumber2 decimal
AttributeNumber3 decimal
AttributeNumber4 decimal
AttributeNumber5 decimal
AttributeNumber6 decimal
AttributeNumber7 decimal
AttributeNumber8 decimal
AttributeNumber9 decimal
AttributeTimestamp1 dateTime
AttributeTimestamp10 dateTime
AttributeTimestamp2 dateTime
AttributeTimestamp3 dateTime
AttributeTimestamp4 dateTime
AttributeTimestamp5 dateTime
AttributeTimestamp6 dateTime
AttributeTimestamp7 dateTime
AttributeTimestamp8 dateTime
AttributeTimestamp9 dateTime
AutosourceFlag boolean
356
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
BaseModelNumber string
BaseModelPrice decimal
BuyerEmail string
BuyerId long
BuyerName string
CategoryId long
CategoryName string
ChangeActionReason string
CurrencyCode string
CustomerItemDescription string
DaysEarlyReceiptAllowed decimal
DeliverToCustomerContactEmail string
DeliverToCustomerContactId long
DeliverToCustomerContactName string
DeliverToCustomerContactNumber string
DeliverToCustomerId long
DeliverToCustomerLocationCLLICode string
DeliverToCustomerLocationOriginalSystemReference
string
DeliverToCustomerName string
DeliverToCustomerNumber string
357
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
DeliverToLocationCode string
DeliverToLocationId long
DestinationSubinventory string
FulfillLineId Long
GroupCode string
HazardClass string
HazardClassId long
ItemDescription string
ItemRevision string
LineType string
LineTypeId long
NegotiatedByPreparerFlag boolean
NegotiationRequiredFlag boolean
NewSupplierFlag boolean
NoteToBuyer string
NoteToReceiver string
NoteToSupplier string
Price decimal
ProcurementBUId long
ProcurementBUName string
358
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Rate decimal
RateDate date
RateType string
RequesterEmail string
RequesterId long
SecondaryQuantity decimal
SecondaryUOM string
SecondaryUOMCode string
ShipToCustomerContactEmail string
ShipToCustomerLocationOriginalSystemReference
string
ShipToLocationCode string
ShipToLocationId long
SourceAgreementId long
SourceAgreementLineId long
SourceAgreementLineNumber decimal
SourceAgreementNumber string
SupplierContactEmail string
SupplierContactFax string
SupplierContactId long
SupplierContactName string
359
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
SupplierContactPhone string
SupplierItemNumber string
UNNumber string
UNNumberId long
UrgentRequisitionLineFlag boolean
AssessableAmount decimal
AttachmentCategoryItem string
AttachmentCategoryShip string
AttachmentEntityName string
AttachmentPrimaryKey1 string
AttachmentPrimaryKey2 string
AttachmentPrimaryKey3 string
AttachmentPrimaryKey4 string
AttachmentPrimaryKey5 string
BackToBackFlag boolean
BaseModelId long
Carrier string
CarrierId long
360
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
ConfiguredItemFlag boolean
CustomerItemNumber string
CustomerPOLineNumber string
CustomerPONumber string
CustomerPOScheduleNumber string
DaysLateReceiptAllowed decimal
DeliverToCustomerLocationId long
DeliverToOrganizationCode string
DeliverToOrganizationId long
DestinationTypeCode string
FirstPartyTaxRegistrationId long
FirstPartyTaxRegistrationNumber string
InterfaceLineKey string
ItemId long
ItemNumber string
LineIntendedUse string
LineIntendedUseId long
LineIntendedUseName string
LocationOfFinalDischargeCode string
LocationOfFinalDischargeId long
361
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
ModeOfTransportCode string
OrchestrationCode string
OverReceiptTolerancePercent decimal
ProductCategory string
ProductCategoryName string
ProductFiscalClassification string
ProductFiscalClassificationId long
ProductFiscalClassificationName string
ProductType string
ProductTypeName string
Quantity decimal
RequestedDeliveryDate date
RequestedShipDate date
SalesOrderLineNumber string
SalesOrderNumber string
SalesOrderScheduleNumber string
ServiceLevelCode string
ShipToCustomerContactId long
ShipToCustomerContactName string
ShipToCustomerContactNumber string
362
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
ShipToCustomerId long
ShipToCustomerLocationCLLICode string
ShipToCustomerLocationId long
ShipToCustomerName string
ShipToCustomerNumber string
SupplierId long
SupplierName string
SupplierSiteId long
SupplierSiteName string
TaxClassificationCode string
TaxClassificationName string
ThirdPartyTaxRegistrationId long
ThirdPartyTaxRegistrationNumber string
TransactionBusinessCategory string
TransactionBusinessCategoryName string
UnitOfMeasure string
UnitOfMeasureCode string
UserDefinedFiscalClassification string
UserDefinedFiscalClassificationName string
WorkOrderId long
363
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
WorkOrderNumber string
WorkOrderOperationId long
WorkOrderOperationSequence decimal
WorkOrderProduct string
WorkOrderSubTypeCode string
Description string
FulfillLineId long
ItemRevision string
Price decimal
SupplierItemNumber string
AttachmentCategory string
AttachmentEntityName string
AttachmentPrimaryKey1 string
364
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
AttachmentPrimaryKey2 string
AttachmentPrimaryKey3 string
AttachmentPrimaryKey4 string
AttachmentPrimaryKey5 string
BaseModelId long
BaseModelNumber string
ComponentLineId long
ComponentLineNumber long
InterfaceConfigurationComponentKey string
ItemId long
ItemNumber string
ItemType string
ParentComponentLineId long
Quantity decimal
UnitOfMeasure string
UnitOfMeasureCode string
You can't use these attributes in any element with drop ship.
interfaceSourceCode string
365
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
requisitioningBUId long
requisitioningBUName string
groupBy string
nextRequisitionNumber int
initiateApprovalAfterRequisitionImport string
maximumBatchSize int
errorProcessingLevel string
Comments string
CurrencyConversionDate date
CurrencyConversionRate decimal
CurrencyConversionType string
CustomerSiteId long
DocumentRevisionDate dateTime
DocumentRevisionNumber string
FreightCarrierId long
FreightCarrierName string
366
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
FreightTerms string
HeaderId long
NoteToReceiver string
OutsourcerContactId long
OutsourcerContactName string
OutsourcerPartyId long
OutsourcerPartyName string
ShipFromLocationCode string
ShipFromLocationId long
ShipToLocationCode string
ShipToLocationId long
ShipToOrganizationCode string
ShipToOrganizationId long
VendorId long
VendorName string
VendorSiteId long
VendorSiteName string
CustomerPartyName string
367
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
ActionCode string
BUId long
CurrencyCode string
CustomerId long
DocumentCreationDate dateTime
DocumentLastUpdateDate dateTime
DocumentNumber string
ReceiptAdviceNumber string
ReceiptAdviceOriginalSystemReference string
ReceiptSourceCode string
SourceDocumentType string
SourceSystemId long
ReceiptAdviceLine
AllowSubstituteReceipt string
Comments string
CountryOfOriginCode string
DaysEarlyReceiptAllowed decimal
DaysLateReceiptAllowed decimal
368
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
DocumentScheduleNumber string
EnforceShipToLocCode string
FulfillLineId long
ItemCategory string
ItemRevision string
NoteToReceiver string
OrigSourceFulfilLineNumber string
OverReceiptExceptionCode string
OverReceiptTolerance decimal
ReceiptDaysExceptionCode string
RoutingCode string
RoutingHeaderId long
SecondaryQuantityExpected decimal
SecondaryUnitOfMeasure string
SecondaryUOMCode string
ShipFromLocationCode string
ShipFromLocationId long
ShipToLocationCode string
ShipToLocationId long
SourceLineNumber string
369
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
SubstituteItemId long
SubstituteItemNumber string
VendorItemNumber string
AssessableValue decimal
CustomerItemId long
CustomerItemNumber string
DefaultTaxationCountry string
DocumentFiscalClassification string
DocumentLineCreationDate dateTime
DocumentLineLastUpdateDate dateTime
DocumentLineNumber string
ExpectedReceiptDate dateTime
FinalDischargeLocationId long
FirstPtyRegId long
IntendedUseClassifId long
ItemDescription string
ItemId long
ItemNumber string
370
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
OrigSalesOrderLineNumber string
OrigSalesOrderNumber string
OrigSourceHeaderNumber string
OrigSourceLineNumber string
ProductCategory string
ProductFiscClassId long
ProductType string
QuantityExpected decimal
ReceiptAdviceLineNumber string
ReceiptSourceCode string
ShipToOrganizationCode string
ShipToOrganizationId long
SourceFulfillmentLineNumber string
SourceHeaderNumber string
TaxClassificationCode string
TaxInvoiceDate date
TaxInvoiceNumber string
TaxShipFromLocationId long
ThirdPtyRegId long
TransactionDate dateTime
371
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
TrxBusinessCategory string
UnitOfMeasure string
UOMCode string
UserDefinedFiscClass string
FulfillLineId long
GradeCode string
LotExpirationDate dateTime
ParentLotNumber string
SecondaryTransactionQuantity decimal
SecondaryTransactionQuantityUOMCode string
TransactionQuantityUOMCode string
LotNumber string
TransactionQuantity decimal
372
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
FulfillLineId long
FromSerialNumber string
ToSerialNumber string
FulfillLineId long
GradeCode string
LotExpirationDate dateTime
ParentLotNumber string
SecondaryTransactionQuantity decimal
SecondaryTransactionQuantityUOMCode string
TransactionQuantityUOMCode string
TransactionQuantity decimal
Lot for Receipt Advice Line When Serials Control the Lot
373
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
You can't use any attributes in the ReceiptAdviceLineLotSerials element. Specifically, you can't use these attributes.
FromSerialNumber string
ToSerialNumber string
CarrierPartyId long
CarrierPartyName string
CarrierPartyNumber string
FobCode string
FreightTermsCode string
HeaderId Long
ModeOfTransport string
OutsourcerPartyId long
OutsourcerPartyName string
OutsourcerPartyNumber string
ServiceLevel string
ShipFromLocationId long
374
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
ActionType string
BillToContactId long
BillToContactName string
BillToContactNumber string
BillToPartyId long
BillToPartyName string
BillToPartyNumber string
BillToPartySiteId long
BillToPartySiteNumber string
ConversionDate dateTime
ConversionRate decimal
ConversionType string
CurrencyCode string
DocumentNumber string
OrganizationCode string
OrganizationId long
OrganizationName string
SalesOrderNumber string
ShipToContactId long
ShipToContactName string
375
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
ShipToContactNumber string
ShipToPartyId long
ShipToPartyName string
ShipToPartyNumber string
ShipToPartySiteId long
ShipToPartySiteNumber string
SoldPartyName string
SoldToContactId long
SoldToContactName string
SoldToContactNumber string
SoldToPartyId long
SoldToPartyNumber string
SourceDocumentType string
SourceHeaderNumber string
SourceSystemId long
SourceSystemName string
ArrivalSetName string
376
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
CurrencyCode string
CustomerItemNumber string
DoNotShipAfterDate dateTime
DoNotShipBeforeDate dateTime
EarliestDropoffDate dateTime
EarliestPickupDate dateTime
EndAssemblyItemNumber string
FinalDischargeLocCode string
FulfillLineId long
InitialDestinationLocationId long
IntendedUse string
ItemDescription string
LatestDropoffDate dateTime
LatestPickupDate dateTime
OrderedQuantity2 decimal
OrderedQuantityUomCode2 string
OrderedQuantityUomName2 string
PreferredGrade string
ShipToleranceAbove decimal
ShipToleranceBelow decimal
377
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
SourceLineUpdateDate dateTime
SourceShipmentId long
SrcAttribute1 string
SrcAttribute10 string
SrcAttribute11 string
SrcAttribute12 string
SrcAttribute13 string
SrcAttribute14 string
SrcAttribute15 string
SrcAttribute16 string
SrcAttribute17 string
SrcAttribute18 string
SrcAttribute19 string
SrcAttribute2 string
SrcAttribute20 string
SrcAttribute3 string
SrcAttribute4 string
SrcAttribute5 string
SrcAttribute6 string
SrcAttribute7 string
378
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
SrcAttribute8 string
SrcAttribute9 string
SrcAttributeCategory string
SrcAttributeDate1 date
SrcAttributeDate2 date
SrcAttributeDate3 date
SrcAttributeDate4 date
SrcAttributeDate5 date
SrcAttributeNumber1 decimal
SrcAttributeNumber10 decimal
SrcAttributeNumber2 decimal
SrcAttributeNumber3 decimal
SrcAttributeNumber4 decimal
SrcAttributeNumber5 decimal
SrcAttributeNumber6 decimal
SrcAttributeNumber7 decimal
SrcAttributeNumber8 decimal
SrcAttributeNumber9 decimal
SrcAttributeTimestamp1 dateTime
SrcAttributeTimestamp2 dateTime
379
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
SrcAttributeTimestamp3 dateTime
SrcAttributeTimestamp4 dateTime
SrcAttributeTimestamp5 dateTime
TradeComplianceScreeningDate dateTime
TradeComplianceScreeningReason string
TradeComplianceScreeningStatus string
TransportationPlanningStatus string
TransportationShipment string
TransportationShipmentLine string
AssessableValue decimal
BaseItemId long
BaseItemNumber string
BillToContactId long
BillToContactName string
BillToContactNumber string
BillToPartyId long
BillToPartyName string
BillToPartyNumber string
380
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
BillToPartySiteId long
BillToPartySiteNumber string
BusinessUnitName string
CarrierPartyId long
CarrierPartyName string
CarrierPartyNumber string
CategoryId long
CategoryName string
CustPoNumber string
DateRequested dateTime
DateScheduled dateTime
DefaultTaxationCountry string
DocumentSubType string
ExemptCertificateNumber string
ExemptReasonCode string
FinalDischargeLocationId long
FirstPtyNumber string
FirstPtyRegId long
FobCode string
FreightTermsCode string
381
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
FromSubinventoryCode string
IntendedUseClassifId decimal
InventoryItemId long
ItemNumber string
LineActionType string
ModeOfTransport string
OrderedQuantity decimal
OrderedQuantityUomCode string
OrderedQuantityUomName string
OrganizationCode string
OrganizationId long
OrganizationName string
OrgId long
PackingInstructions string
ParentInventoryItemId long
ParentItemNumber string
ParentSourceShipmentId long
ProductCategory string
ProductType string
ReleaseLock string
382
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
RequestDateTypeCode string
SalesOrderLineNumber string
SalesOrderShipmentNumber string
SellingPrice decimal
ServiceLevel string
ShipmentPriorityCode string
ShippingInstructions string
ShipSetName string
ShipToContactId long
ShipToContactName string
ShipToContactNumber string
ShipToPartyId long
ShipToPartyName string
ShipToPartyNumber string
ShipToPartySiteId long
ShipToPartySiteNumber string
SoldToContactId long
SoldToContactName string
SoldToContactNumber string
SoldToPartyId long
383
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
SoldToPartyName string
SoldToPartyNumber string
SourceLineNumber string
SourceShipmentNumber string
TaxClassificationCode string
TaxInvoiceDate date
TaxInvoiceNumber string
ThirdPtyNumber string
ThirdPtyRegId long
TrxBusinessCategory string
UnitPrice decimal
UserDefinedFiscClass string
You can't use any attributes in the ShipmentRequestOrderLineHold element. Specifically, you can't use these attributes.
HoldActionCode string
HoldId long
HoldReasonCode string
HoldReason string
Related Topics
• Pricing Algorithm
384
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
• Service Mapping
Web Services
Overview
Web Services You Can Use to Integrate Order Management
Use Order Import Service, Receive Order Request Service, or Order Information Service to integrate Order Management
with other systems.
Here are some examples of other systems you can integrate.
• Channel
• Legacy
• Quoting
• Contract
• Service request
• Purchasing
• Inventory
• Warehouse
• Shipping
• Invoicing
• Billing
385
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Create, read, update, and delete the same data that Oracle Applications use.
For example.
386
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Terminology
• Source system. An order capture system or application that sends the Order Request object to the Order
Import Service web service. For brevity, this document mentions only source system.
• Internal. An action, process, or object that resides in Order Management. A cross-reference that resides in
Order Management and Planning Repository is an example of an internal object.
• External. An action, process, or object that resides outside of Order Management . A source order that a source
system creates in an order capture system is an example of an external object.
• Source order. An order that a source system creates in an order capture system.
• Sales order. A source order that Order Management converts into a sales order so it can fulfill the source order.
Starting with Release 12, use Order Import Service instead of Receive Order Request Service. Order Management
continues to support Receive Order Request Service in Release 12, but will retire it and no longer support it in
subsequent releases.
Use Order Import Service instead of Receive Order Request Service to create a sales order.
Order Management no longer supports the Create operation or Submit operation of Receive Order Request Service.
You can use the pause task, apply hold, release hold, and check availability operations of Receive Order Request Service.
Order Import Service is a SOAP (Simple Object Access Protocol) service that uses Order Request Object as the payload.
For details about the operations you can use and the attributes you reference, go to SOAP Web Services for Oracle SCM.
Its on Oracle Help Center at https://docs.oracle.com/en/cloud/saas/supply-chain-management/20d/oessc/index.html.
In the table of contents, expand Business Object Services > Import Sales Orders.
Details Description
Type Technical
Required No
387
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Details Description
Description This Service receives source orders from different channel systems.
WSDL http://host:port/fomImportOrdersService/OrderImportService?wsdl
Input OrderImportServiceRequest
Output OrderImportServiceResponse
Use the createOrders operation to import source orders from different channels into Order Management. Create a sales
order in draft mode or submit mode according to the SubmitFlag attribute in the payload.
Use the stageOrders operation to import orders from different channels to staging tables. You can then run a scheduled
process that imports data from interface tables, processes them, then imports each interface record into Order
Management as a sales order.
Use the SubmitDraftOrder operation to submit a draft sales order to order fulfillment.
388
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Receive Order Request Service is a SOAP (Simple Object Access Protocol) service that uses Order Request Object as the
payload.
Use the Order Import Service web service instead of Receive Order Request Service to create a sales order.
Details Description
Type Technical
Required No
Description This service receives source orders from different channel systems.
Input ReceiveOrderServiceRequestMessage
Output ReceiveOrderServiceResponseMessage
389
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
◦ LotSerialDetails
◦ Payments
◦ PriceAdjustments
◦ SalesCredits
◦ Projects
Related Topics
• Overview of Importing Orders into Order Management
Plan
Plan Your Integration
Requirement Description
Register source system. You must register each source system that sends the order request as a source system.
More than one source system might create a source order, so the web service stores details
that identify the source system on the order so it can track the source system that sends the
order.
The web service uses the source system during cross-referencing to determine the
corresponding internal identifier or value that's specific to the source system.
Plan how you will synchronize You must synchronize customer master data before you import a source order.
customer master data.
If the customer on the order doesn't exist in the customer model in Oracle Fusion Trading
according to the CreateCustomerInformationFlag preference in the service schema, then Order
Management can create the customer details.
Plan for attributes in Oracle If you use Oracle Configure, Price, and Quote Cloud (CPQ), then CPQ sends details about the
Configure, Price, and Quote Cloud. attributes that Order Management requires to use this functionality, such as FreezePriceFlag,
FreezeShippingChargeFlag, FreezeTaxFlag, and so on.
390
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Requirement Description
Plan for pricing. You can send a source order that your upstream system already priced, or the web service can
price the source order for you.
If you use a predefined implementation of Oracle Configure, Price, and Quote Cloud, then the
web service assumes the upstream system already priced the source order and won't allow
price changes in Order Management.
Plan how to handle draft sales orders. Your source system can send a submitted source order or a source order that's in draft status.
• If the source order is in draft status, then you must submit the sales order that
references the source order.
• Order Management won't run the orchestration process that fulfills your sales order
until you submit it.
• If the web service creates the order in draft status, then you can submit it from the Order
Management work area, or you can use operation SubmitDraftOrder in the web service
to submit it.
• If you use SubmitDraftOrder, then you must add the payload that defines it.
The integration platform or Use the asynchronous operation because asynchronous is more resilient and fault tolerant
application that uses the service than synchronous. If the response from the fulfillment system is delayed for some reason, then
supports an asynchronous service. an asynchronous operation can continue processing but a synchronous operation might time
out and go into an error state.
The platform or application doesn't Use synchronous as long as the number of lines in the sales order doesn't result in a timeout
support an asynchronous service, or after 300 seconds.
you prefer not to use asynchronous
because its more complex to
implement. If you use synchronous, and if a sales order times out, then you must make sure you set up
your implementation to resubmit the sales order.
• stageOrders. The only operation that can accept more than one sales order in the payload.
• createOrders. Can accept only one sales order in the payload.
The Receive Order Request web service can accept only one sales order in the payload.
For details about input messages and output messages you can use with Order Import Service, go to SOAP Web
Services for Oracle SCM. Its on Oracle Help Center at https://docs.oracle.com/en/cloud/saas/supply-chain-
management/20d/oessc/index.html. In the table of contents, expand Business Object Services > Import Sales
Orders.
391
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
• Header
◦ Order Payment
◦ Order Sales Credit
◦ Order Attachments
◦ Order Lines
• Line LotSerial
• Line SalesCredit
• Line Payments
• Line Document References
• Line Attachments
• Line Transactional Item Attributes
• Charge
• Charge - Charge Components
◦ Order Preferences
392
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Response Payload
Make sure your integration can accommodate the response that Order Management sends. The response payload
returns a status.
393
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Status Description
SUCCESS The response includes source keys and Order Management keys. It sends this response after
Order Management successfully creates the sales order.
394
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
To make sure the payload includes all the required details, the web service processes some attributes as a group. For
example, here are the attributes that the web service examines as a group to make sure the payload identifies the
buying party.
1. BuyingPartyId
2. BuyingPartyName
3. BuyingPartyNumber
Here's the sequence that the web service uses when it processes each group.
1. Use the attribute that specifies the identifier, such as BuyingPartyId.
2. If the attribute that specifies the identifier is empty, then use the attribute that specifies the number, such as
BuyingPartyNumber.
3. If the attribute that specifies the number is empty, then use the attribute that specifies the name, such as
BuyingPartyName.
If the attribute that specifies the identifier includes a value, then the web service will always use this value even if the
attributes that specify the name or number aren't empty.
If the payload doesn't include a value for the identifier, name, or number, then your order import will likely fail.
Some attributes, such as ReturnReasonCode, store an abbreviation for a longer term. The abbreviation is typically text
that the user can view to quickly identify the meaning of a lookup value.
You can think of the value of this attribute as coded. A coded attribute typically includes a partner attribute. For
example, the ReturnReason attribute is the partner for ReturnReasonCode.
If you provide a value only for the coded attribute in the payload, then Order Management will use the value that the
database cross-references from the lookup value to the meaning. For example, it cross-references the RET lookup value
to the meaning for RET, which is Return.
Continuing this example, assume you set ReturnReasonCode=RET in the payload, and.
• You set ReturnReason="Return Order", then the web service will ignore this value and use the code. This
behavior is similar to using Identifier when you don't supply the Name.
• You don't specify a value for ReturnReason, and if the value that the database cross-references to the meaning
is Return, then the web service will use Return for the reason.
The web service uses this logic for each of these sets of attributes.
AccountingRulecode AccountingRule
CancelReasonCode CancelReason
ChargeDefinitionCode ChargeDefinition
395
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
ChargeSubtypeCode ChargeSubType
DemandClassCode DemandClass
FOBPointcode FOBPoint
FreightTermsCode FreightTerms
InvoicingRuleCode InvoicingRule
OrderedUOMCode OrderedUOM
PaymentMethodCode PaymentMethod
PaymentTerm PaymentTermCode
RequestedFulfillmentOrganizationCode RequestedFulfillmentOrganizationName
RequestedSupplierCode RequestedSupplierName
ShipmentPriorityCode ShipmentPriority
ShippingCarrierCode ShippingCarrier
ShippingModeCode ShippingMode
ShippingServiceLevelCode ShippingServiceLevel
SubInventoryCode Subinventory
SubstitutionReasonCode SubstitutionReason
TaxExemptReasonCode TaxExemptReason
TransactionalCurrencyCode TransactionalCurrencyName
TransactionLineTypeCode TransactionLineType
396
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Use an attribute that includes the word Identifier in the name to send the identifier, such as Requesting Business Unit
Identifier. If you send the identifier and the value for the identifier, then the web service uses the identifier.
Master data includes customers and items. The source system can send different details, depending on whether it uses
the same master data and references data that Order Management uses.
• Uses the same data. The source system can send the Oracle identifier or the values.
• Doesn't use the same data. The source system can send the identifiers and values that it contains. Order
Import Service uses them as keys to look up the cross-reference, depending on whether the key references
customer data or product data. If the cross-reference resides in.
◦ Oracle Trading Community Model, then resolve it into Oracle customer data
◦ Oracle Fusion Product Model, then resolve it into Oracle product data
Each service typically uses a pair of synchronous and asynchronous operations. The service appends the operation
name with a value.
For example, GetOrderDetails and GetOrderDetailsAsync is a pair of services. GetOrderDetails is synchronous and
GetOrderDetailsAsync is asynchronous.
To modify a sales order, you call a web service with a payload that includes these details.
The web service will process the order as a change order according to the combination of source transaction system and
source transaction identifier.
• Use the same web service that you used to create the sales order. The payload structure for a change order is
similar to the payload structure for create order.
• Design your payload so it sends the modified value for each attribute.
• Make sure your payload includes all attributes for the order line that you modify.
• If you don't modify any part of an order line, then you can exclude the entire line from the payload.
To cancel a sales order or order line, you call the same web service that you use to create the sales order.
397
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Cancel the entire sales order. Set the OperationCode for the order header to CANCEL. You must also identify the source
transaction system and include the source transaction identifier.
Cancel the entire order line. Send the SourceTransactionLineIdentifier and SourceTransactionScheduleIdentifier for the
order. Do one of.
Cancel part of a shipped order line. Set the ordered quantity to the quantity that already shipped. For example, if the quantity on
the original order line is 10 Each, and if 7 shipped, and if 3 were back ordered, then set the
ordered quantity in the payload to 7 Each.
Make sure your payload also includes all other attributes from the original order line.
Consider an example.
Your customer needs a revised total 55 The quantity of 55 in the payload replaces
quantity of 55. the original quality.
You must cancel the quantity that hasn't 40 The quantity of 40 in the payload replaces
shipped. the original quality.
398
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
• oracle/wss11_saml_or_username_token_with_message_protection_service_policy
• oracle/wss_username_token_over_ssl_client_policy
• oracle/wss_username_token_over_ssl_client_policy LPA
Use these settings to call the web service only with SSL (Secure Sockets Layer).
Automate using files to import source orders. Oracle provides a set of web services you can use to upload the
completed import template to the server that hosts Oracle WebCenter Content. You then run a scheduled process that
imports the uploaded file to the interface tables, processes them, then imports each interface record as a sales order.
For details, see the book Using External Data Integration Services for Oracle ERP Cloud on My Oracle Support.
Here are the parameters you use when you run the scheduled process.
Parameter Value
JobDefinitionName ImportOrdersJob
JobPackageName oracle/apps/ess/scm/doo/decomposition/receiveTransform/receiveSalesOrder
Related Topics
• Overview of Importing Orders into Order Management
399
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Reference
Example Web Service Payloads That Integrate Order Management
Get some example payloads in xml files.
To download the xml files, go to Technical Reference for Order Management Cloud (Doc ID 2051639.1) at https://
support.oracle.com/epmos/faces/DocumentDisplay?id=2051639.1, then download the Example Web Service Payloads
attachment.
Description Payload
submit_draft_order_sync.xml
single_line_priced_in_oracle_fusion.xml
Note.
child_entity_sales_credits
child_entity_manual_price_adjustment.xml
child_entity_lot_serial.xml
customer_sync_organization.xml
This payload includes the text EFF, which is an acronym for extensible flexfield.
400
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Description Payload
Here are some more examples that use the Create Order operation.
Description Payload
AttachmentsYou can't include the Attachment entity in a stage order payload. For example, if you include this content
in your payload, it will fail.
<ord:Attachment>
<ord:Title>HeaderTEXTTitle</ord:Title>
<ord:FileContent></ord:FileContent>
<ord:FileName></ord:FileName>
<ord:Data>VGhlIHNvdXJjZSBmaWxlIGlzIGhhbmRsZWQgYXMgYSBiaW5hcnkgZGF0YS4gVGhlIHRleHRib3gg
aXMgaGFuZGxlZCBhcyBhIHN0cmluZyBkYXRhLCBkZWZhdWx0IGNoYXJhY3RlciBzZXQgZm9yIHRo
ZSB0ZXh0Ym94IGlzICdpc28tODg1OS0xJy4gWW91IGNhbiBjaGFuZ2UgdGhlIGNoYXJzZXQgdXNp
bmcgZm9ybSBiZWxsb3cu</ord:Data>
<ord:Description>HeaderTEXTDesc</ord:Description>
<ord:url></ord:url>
<ord:EntityAttributes></ord:EntityAttributes>
<ord:DataTypeCode>TEXT</ord:DataTypeCode>
</ord:Attachment>
Other Examples
Project Details
401
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
402
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Optional Attributes
403
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
• Sales order
• Purchase order
• Internal material transfer
404
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
405
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
406
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
407
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Optional Attributes
408
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
409
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
410
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
411
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
412
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
413
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
414
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
415
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Comments VARCHAR2 Text that the user can use to add details
that are related to the order line.
416
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
LatestAcceptableShipDate Date Date that specifies the latest time that the
customer is willing to ship the sales order.
LatestAcceptableArrivalDate Date Date that specifies the latest time that the
customer is willing to receive the sales
order at the ship-to address.
417
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
• Goods
• Services
418
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
419
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Other Attributes
Attribute Description
Fulfillment Line Transactional Value Equals the Ordered Quantity multiplied by the Unit Selling Price.
Fulfillment Line Standardized Value Equals the Ordered Quantity multiplied by the Unit Selling Price multiplied by the Unit
Currency Conversion Rate.
420
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
You can include these optional attributes in the request payload for the source transaction.
You typically include these attributes when you specify one of these objects.
• Lot Numbers and serial numbers
• Sales credits
• Payments
• Attachments
• Document references
• Transaction items
• Charges
• Charge components
You can include these optional attributes in the request payload to define lot numbers and serial numbers.
421
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Sales Credits
You can include these optional attributes in the request payload to define sales credits.
Payments
You can include these optional attributes in the request payload to define payments.
422
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Attachments
You can include these optional attributes in the request payload to define attachments.
Document References
423
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
You can include these optional attributes in the request payload to define document references. The web service
currently accepts only the original sales order or order line reference when creating a return line for the document
reference entity.
424
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Transaction Items
You can include these optional attributes in the request payload to define transaction items.
Charges
You can include these optional attributes in the request payload to define charges.
425
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
• Goods sale
• Service sale
• Financing compared to lease
• Shipping charges
• Restocking penalties
• Special charges
• Line
• Line Coverage
• One-time
• Recurring
PricedQuantityUOMCode VARCHAR2 Brief text that identifies the UOM for the
priced quantity. For example, Ton. Values
for this attribute come from PIM (Product
Information Management), or a similar
service that Order Management provides.
426
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Charge Components
You can include these optional attributes in the request payload to define charge components.
• List Price
• Invoice Price
427
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Related Topics
• Manage Lookups in Order Management
Operations and Attributes You Can Use with the Receive Order Request Service
Get details about operations and attributes you can use with the Receive Order Request Service when you integrate
Order Management Cloud with other systems.
428
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
ReleasePausedTasks Operation
The ReleasePausedTasks operation releases paused tasks according to a combination of search parameters.
You can use it only as an asynchronous web service. You must include these attributes in a request that uses
ReleasePausedTasks.
429
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
430
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
CheckAvailability Operation
The CheckAvailability operation allows an order capture system to get, view, and analyze the availability of a sales order
item and the promising options for this item. You can use it only as an asynchronous web service. An asterisk ( * ) in the
Required column indicates a group of attributes. You must include at least one attribute from the group. You can use
these attributes.
431
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
432
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
433
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
434
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
CheckAvailabilityInput RequestedDropShipSupplierSite
String No Site of the supplier. You
PromisingLine can specify this value
RequestedDropShipSupplierSite only if you also choose
the supplier.
435
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
436
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
437
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
PromisingLineSetReply
NumberOfAltOptions
438
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
PromisingLineSetResult
PromisingLineResult
439
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
PromisingModelReply
DefaultAvailabilityModelOption
PromisingLineModelResult
RootParentFulfillId
440
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
441
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
PromisingLineResult
TotalPrice
442
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
PromisingLineReply
DefaultAvailabilityOption
PromisingLineResult
NumberOfCtpItems
443
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
ResultDetail
InternalSalesOrderDestOrg
InstanceId
444
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
DefaultAvailabilityOption
PromisingLineResult
ResultDetail ExpectedPickDate
checkAvailabilityOutput ExpectedAvailabilityOnRequestedDate
Double Expected item availability on
PromisingResult the request date.
PromisingLineReply
DefaultAvailabilityOption
PromisingLineResult
ResultDetail
ExpectedAvailabilityOnRequestedDate
445
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
DefaultAvailabilityOption
PromisingLineResult
ResultDetail
ExpectedDropShipSupplierSite
446
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
ResultDetail
ExpectedShippingCost
447
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
448
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
449
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
PromisingLineResult
SourcingRule
450
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
ResultDetail
InternalSalesOrderDestOrg
OrgId
451
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
PromisingLineResult
ResultDetail RequestedItemId
checkAvailabilityOutput ExpectedAvailabilityOnRequestedDate
Double Expected item availability on
PromisingResult the request date.
PromisingLineReply
AlternateAvailabilityOptions
PromisingLineResult
ResultDetail
ExpectedAvailabilityOnRequestedDate
452
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
453
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
PromisingLineResult
ResultDetail ExpectedMargin
454
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
The GetAvailabilityCheck operation and the GetAvailabilityCheckSync operation gets the supply of an item that's
currently available in an organization or supplier. You can use them as a synchronous or asynchronous web service. You
must include these required attributes in a request that uses GetAvailabilityCheck or GetAvailabilityCheckSync.
455
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
456
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
RequestHold Operation
The RequestHold operation put the sales order or fulfillment process on hold. You can use it only as an asynchronous
web service. You must include these required attributes in a request that uses RequestHold.
457
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
ReleaseHold Operation
458
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
The ReleaseHold operation releases a hold that's currently holding a sales order or fulfillment process. You can use it
only as an asynchronous web service. You must include these required attributes in a request that uses ReleaseHold.
459
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
460
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
If your deployment must integrate with a system that resides outside of Order Management, then you can register a
connector that allows Order Management to communicate with it. You must create, deploy, and register the connector.
This topic describes how to register the connector and connect Order Management to a source system, such as Oracle
Configure, Price, and Quote Cloud. You add a connector that uses a web service that communicates order details with
the source system.
The external interface uses open access protocols, such as HTTP, so extra security setup is required. You must make
sure the user credential is valid in the source system you're integrating, and in the security certificate so the integration
can encrypt and decrypt messages.
461
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Attribute Description
Code Enter any text that Order Management can use as an abbreviation for the external system.
Order Management uses this code to identify this external system throughout the user
interface, such as in lists and logs.
For example, assume you work for a company named Vision Corporation, and that your
deployment must integrate with a legacy order capture system named Vision Capture. You
can enter VCAP.
The Manage Trading Community Source Systems page comes predefined to use Oracle
Fusion Order Orchestration and Planning (OPS) for order orchestration and planning. If you
use the Order Management work area to create sales orders, then you must not change this
behavior, but you can use this page to add the source system you use to import a source
order from a channel system.
Name Enter text that describes the source system, such as Vision Capture.
◦ Purchased. Identifies a purchased system, such as data from a third party provider.
◦ Enable for Trading Community Members. Required. Import data for the trading
community. Establishes the Original System Unique Reference (OSR) for customer
entities.
◦ Enable for Order Orchestration and Planning. Required. Import data for Order
Orchestration.
◦ Enable for Assets. Optional. Import data for assets.
For example, if you add a check mark to Enable for Trading Community Members,
then you can choose the source system as a data source on various pages in the
Order Management work area and the Order Orchestration work area.
462
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Attribute Description
Code Choose the code that you created earlier, such as VCAP.
Time Zone Choose the time zone where the server is located.
◦ Uses the same values that Oracle Fusion uses, and you already set up these values in
Oracle Fusion, then don't enable this option.
463
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Attribute Description
Target System Choose the code you created in the Create Source System dialog, such as VCAP.
Connector Name Enter text that describes the connector. For example, enter Connector_to_VCAP
Connector URL Enter the URL that locates the connector service that resides on the source system. In this
example, enter the URL that locates the VCAP system.
User Name and Password Enter the values that the Status Update service requires. For example, the user that you
specify must be a valid user, and this user must use the privileges that allow this user to run
the Status Update service.
Order Management uses the credentials you provide so it can communicate with the order
capture system when it creates the order, and when it provides a status update.
4. Optional. Allow more than one source system instance to communicate with Order Management.
◦ Use Trading Community Architecture to add a value to the Target System list.
◦ Repeat step 3, except set Target System to the value that you added in Trading Community Architecture.
For example, assume you work for a telecommunications company. You add one connection to a
system named PER_ORA_BM_CPQ for personal phone lines, then add another connection to a system
named BUS_ORA_BM_CPQ for business lines. CPQ is an acronym for Configure, Price and Quote. Order
Management will deliver status notifications and billing notifications to any system that contains the
string ORA_BM_CPQ.
You can add a prefix, a suffix, a prefix and a suffix, or no prefix or suffix to the string. For example, you
can use ABC_ORA_BM_CPQ_XYZ.
5. Verify that Order Management is connected to the source system, and that its communicating sales order data.
◦ Use a page in the Order Management work area to verify that it updated the order status. For example,
verify that it updated the status from Scheduled to Shipped.
◦ Sign into your source system, then verify that it displays the updated status of the sales order that you
examined in Order Management. For example, if Order Management updated the status from Scheduled
to Shipped on the fulfillment line, then verify that your source system also displays Shipped.
If Order Management can't connect to your source system, then it might display an error message that
indicates it can't connect. For help, see topic Troubleshooting Connection Problems With Source Systems:
Procedure.
Connecting to Configure, Price, and Quote
464
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
• The setup you make for Fulfillment Line Status Update and the corresponding set up in the Edit Status
Rule Set area of the Manage Orchestration Process Definitions page doesn't affect how Order Management
communicates status values.
• Order Management sends only the following status values. You can't modify this behavior.
◦ Scheduled
◦ Shipped
◦ Awaiting Billing
◦ Billed
◦ Canceled
◦ Closed
This role and privilege makes sure each service and response request from a source system works correctly when the
source system isn't part of Oracle Fusion, or when receiving a request from a task layer that isn't in Oracle Fusion.
Attribute Value
465
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
4. Navigate to the Search Authorization Policies tab, then search for DOOCustomAppRole.
5. In the Functional Policies tab, click New.
466
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
6. In the Untitled tab, set the value, then save your changes.
Attribute Value
Name DOOCustomRolePolicy
Attribute Value
467
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
468
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
9. Add the privileges you need for each of the web services that you must grant to the user.
469
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
470
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Attribute Value
Name The value you enter must match the name you used when you created the user credential
key earlier in this topic.
Description User name and password to use when sending a message to the test client.
Provider DefaultAuthentication
Password The value you enter must match the name you used when you created the user credential
key earlier in this topic.
4. Test the client in your source system to make sure it can send and receive messages to and from Order
Management.
Related Topics
• Fix Connection Problems with Source Systems
An order capture system typically sends sales order data that contains names or codes to an orchestration process, and
the orchestration process must display a meaning for the name or a description for the code. You must collect the data
that determines these meanings and descriptions into the Order Orchestration and Planning Data repository.
Assume your order capture system sends sales order data that includes a payment term of 2/10, Net 30 to an
orchestration process, and data in the Order Orchestration and Planning Data repository includes a payment term of
2/10, Net 30. The orchestration process uses the matching codes to identify the payment term description.
2% discount earned if paid within 10 days
To get the complete list of orchestration reference objects, you can examine the collected data for them, and view the
list of values for the Lookup Type field.
471
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
472
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
doa.ADDRESS_USE_TYPE = 'SHIP_TO'
OR doa.ADDRESS_USE_TYPE IS NULL
)
AND doa.party_site_id = hzps.party_site_id (+)
AND hzcasa.PARTY_SITE_ID (+) = hzps.PARTY_SITE_ID
AND hzps.party_id = hzp_ship_to.party_id (+)
AND HZcasa.CUST_ACCounT_ID = hza.CUST_ACCOUNT_ID (+)
AND hzps.location_id = hzl.location_id (+)
AND DHA.SOURCE_ORDER_NUMBER = ('&SOURCE_ORDER_NUMBER')
AND DHA.status_code <> 'DOO_REFERENCE'
AND DHA.Submitted_Flag = 'Y' -- is this the active/submitted version
473
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
dha.submitted_Flag ,
dfla.SHIP_TO_PARTY_ID ,
dfla.SHIP_TO_PARTY_SITE_ID,
dfla.BILL_TO_CUSTOMER_ID ,
dfla.BILL_TO_SITE_USE_ID
FROM Fusion.DOO_headers_all dha,
Fusion.DOO_fulfill_lines_all dfla
WHERE dha.header_id = dfla.header_id
AND dha.source_order_number = '&ENTER SOURCE_ORDER_NUMBER'
Related Topics
• Use SQL to Query Order Management Data
• Overview of Importing Orders into Order Management
• How Order-to-Cash Works with Order Capture Systems
◦ You specify the URL that locates the outbound connector when you set up the external interface.
◦ You deploy the outbound connector on a third-party application server.
◦ Your information technology group must set up the WSDL for the outbound endpoint.
2. Specify the business conditions that will route the request to the connector.
3. The outbound connector transforms the message into a format that your fulfillment system can understand,
then sends the message to your fulfillment system. You can use an integrated development environment, such
as Oracle JDeveloper, to specify how to do transformation.
4. The fulfillment system sends a response to the inbound connector.
Response Description
A long running task is a task that includes a wait step in the orchestration process. An
immediate response doesn't wait to process a fulfillment request that involves a long
running task. Instead, it only acknowledges receipt and replies with details that are
immediately available.
For example, assume the message requests a Boolean value, such as whether the customer
is credit worthy or not credit worthy, and the fulfillment system already determined this
value. The fulfillment system can respond immediately with the requested details.
474
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Response Description
Delayed The fulfillment system sends the response only after a delay so it can finish the long running
task.
For example, assume the message requests a status update for the Received Date attribute,
which is the date that shipping delivered the item to the customer. Shipping is normally
a long running task that includes a pause step because shipping a physical item typically
requires one or more days to finish. The fulfillment system can't respond immediately with
the requested details. It must delay its response while it waits for the shipping task to finish.
Note.
◦ The fulfillment system might also communicate more than one update over time. To process a delayed
response, you can add another entry point service in the connector, or you can set up another connector.
It isn't necessary to use the external interface to set up the connector that receives the message from
your fulfillment system and that sends a delayed response.
◦ This topic assumes you use the same connector to send the delayed response to Order Management.
5. To send the response, the fulfillment system calls the inbound interface that you set up in Order Management.
Order Management uses a single service to accept the response for each task type. You specify the URL that
locates the WSDL for the service when you set up the connector.
6. The connector transforms the response into a message that Order Management can understand, then sends it
to Order Management.
Here are the task types that the connector uses in Order Management to communicate with your fulfillment system.
For details about the flow you integrate, see the How Data Flows Through Order Management topic.
1 Set Up Task Types Specify how to process the sales order and
order lines.
475
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
4 Select Fulfillment Lines for Orchestration Create a business rule that selects
Process Steps fulfillment lines, then specify whether to
process them.
6 Manage Connector Details Between Specify the web service that enables Order
Order Management and Your Management to communicate with your
Fulfillment System fulfillment system.
7 Route Requests from Order Specify a rule that selects your fulfillment
Management to Fulfillment Systems system connector according to sales order,
fulfillment line, or orchestration process
attribute.
Related Topics
• How Data Flows Through Order Management
• Fulfillment Tasks
476
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Note.
1. You will specify status values and status conditions on your fulfillment task according to the values that your
fulfillment system uses. You also specify the web services to use when communicating status.
2. Set up shipping steps on your orchestration process so they call your fulfillment system through the
fulfillment task and task type that you set up for your integration. Modify status values and conditions on the
orchestration process so they meet your integration requirements.
477
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
3. Set up a connector that includes the URL to your fulfillment system and any sign in requirements, such as user
and password. Order Management uses the connector to find your fulfillment system and communicate with it.
4. Set up a routing rule that routes calls from your fulfillment system to the connector according to the task type
that you specify.
5. At run time, Order Management and your fulfillment system use the connector to communicate status updates
throughout the fulfillment lifecycle, such as Started, Picked, Awaiting Shipping, and Shipped.
Summary of the Steps
Assume you must integrate your shipping system, Vision Shipments, with Order Management Cloud so you can fulfill
sales orders that you create in the Order Management work area. Vision Shipments uses status values that are unique
to Vision Shipments, such as Awaiting Fulfillment and Awaiting Fulfillment Line Aggregation. You specify them in the
Setup and Maintenance work area. Here's a summary of the steps you will do in this topic.
478
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Try it.
479
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
2. On the Manage Task Types page, click Actions > Add Custom, set values, then click Save.
Attribute Value
Description Task type we use to communicate with our Vision Shipments fulfillment system.
3. In the Details area, on the Services tab, add the services you will use to communicate with your Vision
Shipments fulfillment system.
Its recommend that you use these operations to accommodate the various statuses that Order Management
uses when it processes each sales order. This way, the statuses in your fulfillment system will be synchronized
with the statues in Order Management.
4. Click Tasks, click Actions > Add Row, set values, then click Save and Close.
Fulfill_Vision_Shipments Fulfill Vision Shipments Fulfill Vision Shipments Doesn't contain a check mark.
Order Management uses the task to communicate status values with your fulfillment system.
480
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Create status values on the Manage Status Values page so you can reference them when you set up the orchestration
process.
Note.
481
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Try it.
Change Pending 10
Not Started 20
Started 30
Various 39
Canceled 990
These values match what Order Management uses. You can add, delete, or modify them to accommodate your
fulfillment system, as necessary. In general, its recommended that you keep these statuses so your fulfillment
system is synchronized with statuses in Order Management, but you can add more.
For example, here's the same set of statuses but with a few new ones that Vision Shipments uses. The bold
statuses are new. This way, Vision Shipments can communicate its statuses, such as Awaiting Fulfillment or
Awaiting Fulfillment Line Aggregation, to Order Management and Order Management can display them in the
Order Management work area, or you can reference them in your other set ups, as necessary.
482
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Awaiting Fulfillment 2
Change Pending 20
Not Started 30
Started 40
Various 60
Partially Picked 70
Partially Backordered 80
Picked 90
Backordered 100
Shipped 110
Canceled 120
483
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Create status values on the Manage Task Status Conditions page so you can reference them when you set up the
orchestration process.
484
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Internal Status Value Internal Status Code Display Status Value Display Status Code
As with the status values, these status conditions match what Order Management uses. You can add, delete, or
modify them to accommodate your fulfillment system, as necessary.
Here's the same set with some new conditions. The bold conditions are new. Make sure only the Shipped status
contains a check mark in the Mark as Complete column.
Internal Status Value Internal Status Code Display Status Value Display Status Code
485
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Internal Status Value Internal Status Code Display Status Value Display Status Code
Attribute Value
486
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
◦ Click Actions > Duplicate, modify the attributes, then click Save.
Attribute Value
Description Custom orchestration process that fulfills sales orders in the Vision Shipments
fulfillment system.
3. Modify steps.
◦ In the Process Details area, modify values in the row that contains Create Shipment Request in the Step
Name attribute.
Attribute Value
487
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Attribute Value
1. Click Status Conditions, then, on the Orchestration Process Status Values tab, verify values in the Expression
column.
488
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Make sure you verify the correct rows. For example, several rows contain the Awaiting Shipping status value,
but you must verify only row 600.
If you don't have these values, then modify the expression, as necessary. For example, if you must modify row
600.
Attribute Value
Sequence 1600
Recall that in this example you created a fulfillment task named Fulfill Vision Shipments, so enter
"Fulfill Vision Shipments" =.
Attribute Value
Sequence 1700
◦ In the Expression column, use the Calculator icon to add "Fulfill Vision Shipments " =
"AWAIT_FLINE_AGGREGATE".
489
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
4. Click Save.
4. Click Actions > Add Row, set values, then click Save and Close.
490
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Set Up Connector
1. Go to the Setup and Maintenance work area, then go to the task.
For details about how to set up a connector, see the Overview of Connecting Order Management to Your
Fulfillment System topic.
2. On the Manage Connector Details page, click Actions > Add Row, set values, then click Save and Close.
Attribute Value
Connector URL Enter the URL that locates your fulfillment system.
Connector Description Connect Order Management to the Vision Shipments fulfillment system.
User Name Name of a user you have set up on your fulfillment system.
491
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Note.
• Reference the task type that you created on the Manage Task Types page when you create the If statement.
• Reference the connector that you created on the Manage Connector Details page when you set the connector
name in the Do statement.
492
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Try it.
1. Go to the Setup and Maintenance work area, then go to the task.
◦ Offering: Order Management
◦ Functional Area: Orders
◦ Task: Manage External Integration Routing Rules for Sales Orders
For details about how to set up a routing rule, see the Use Visual Information Builder topic.
2. On the Manage External Interface Routing Rules page, click Create New Rule.
3. Set values, then click Save and Close.
Attribute Value
Related Topics
• Fulfillment Tasks
• Orchestration Processes
• Use Visual Information Builder
493
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
• The connector and the fulfillment system use security certificates that a certificate authority (CA) publishes.
• You have the privileges that you need to deploy the connector on the fulfillment system, or you licensed Oracle
SOA (Service Oriented Architecture) Cloud Service so you can access Oracle JDeveloper on the cloud and
integrate with other cloud applications and systems.
• Services in the fulfillment system all use the same user credentials.
For details, see Java Downloads for All Operating Systems at https://www.java.com/en/download/manual.jsp.
4. Open a web browser, then install Java SE Development Kit.
◦ Go to the Oracle SOA Suite 12.2.1.3.0 QuickStart Download page on Oracle Technology Network at http://
www.oracle.com/technetwork/middleware/soasuite/downloads/index.html.
◦ Download, then unzip these files.
Download them to the bin folder where you installed Java SE Development Kit, such as C:\Program Files
\Java\jdk-9.0.4\bin.
◦ Follow the prompts in the installer until you finish the installation.
6. Open a web browser, then verify your browser can open the URLs you plan to use for your WSDLs. For details
about these WSDLs, see the next section in this topic.
Create Connector
1. Open Oracle JDeveloper.
494
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
For details about how to use Oracle JDeveloper, see Oracle JDeveloper Tutorials at https://docs.oracle.com/cd/
E37547_01/tutorials/toc.htm.
2. In the Select Role dialog, choose Studio Developer, then click OK.
3. Click Application > New.
4. In the New Gallery dialog, in tree Categories, expand General, then click Applications.
5. In the Items area, click SOA Application > OK.
6. In the Name Your Application dialog, set values, then click Next.
Attribute Value
Directory C:\JDeveloper\mywork\ConnectorService
You can accept the default value or choose some other folder. For example.
C:\JDeveloper\mywork\ConnectorService
◦
7. In the Name Your Project dialog, set values, then click Next.
Attribute Value
Directory C:\JDeveloper\mywork\ConnectorService\ConnectorServiceComposite
8. In the Configure SOA Settings dialog, set values, then click Finish.
Attribute Value
495
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
This composite includes the Exposed Services, Components, and External References panes. You will use these
panes during this procedure.
9. Click File > Save.
10. Specify the service that will communicate data from your fulfillment system to Order Management.
◦ Drag and drop BPEL Process from the Component Palette onto the Components pane.
◦ In the Create BPEL Process dialog, set values, then click OK. Make sure you set each value in the same
sequence that this table displays them.
Attribute Value
Name ConnectorProcess
Namespace http://xmlns.oracle.com/ConnectorService/
ConnectorServiceComposite/ConnectorProcess
Directory C:\JDeveloper\mywork\ConnectorService\ConnectorServiceComposite
\SOA\BPEL
496
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Attribute Value
https://host:port/soa-infra/services/default/
DooTaskExternalInterfaceVirtualPartnersComposite/
fulfillmentrequest_client_ep?WSDL
where
• host. Identifies the computer that hosts your Oracle Fusion Applications.
• port. Identifies the port that Oracle Fusion Applications uses to communicate
data. Port is optional.
https://server:port/soa-infra/services/default/
DooTaskExternalInterfaceVirtualPartnersComposite/
fulfillmentrequest_client_ep?WSDL
To identify the host and port, see the Identify Hosts and Ports for Order Management
topic.
This URL locates the WSDL that FulfillOrderService uses. This service communicates
data from your fulfillment system to Order Management. It uses these operations and
inputs.
If you can't access or use this service for some reason, then see the Use Alternative
WSDL Files section in this topic, immediately after this procedure.
497
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Attribute Value
iii. In the window below the location you just set, click
FulfillmentRequest.wsdl > OK.
iv. In the Localized Files dialog, add a check mark to Maintain Original Directory
Structure for Imported Files, then click OK.
11. Create the web service that you use to send the request to your fulfillment system.
◦ In the External References pane, right-click, then click Insert > Direct.
◦ In the Create Direct Binding dialog, set values, then click OK.
Attribute Value
Name FulfillmentApplication
Type Reference
498
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Attribute Value
Drag and drop a connection from the Component Palette to create a connection between the
ConnectorProcess node in the Components pane and the FulfillmentApplication node in the External
References pane.
13. Create the web service you use to send the delayed response back to Order Management.
◦ In the External References pane, right-click, then click Insert > Web Service.
◦ In the Create Web Service dialog, set values, then click OK.
Attribute Value
Name OM-DelayedResponse
Type Reference
https://host:port/soa-infra/services/default/
DooTaskFulfillOrderResponseInterfaceComposite/
fulfillmentresponse?WSDL
where
• host. identifies the computer that hosts your Oracle Fusion Applications.
• port. identifies the port that your Oracle Fusion Applications use to
communicate data.
This URL locates the WSDL that FulfillmentResponseService uses. This service
communicates status updates from your fulfillment system to Order Management. It
uses these operations and inputs.
499
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Attribute Value
14. Connect the connector to the OM-DelayedResponse web service. Drag and drop a connection from the
Component Palette to create a connection between the ConnectorProcess node in the Components pane and
the OM-DelayedResponse node in the External References pane.
15. In the Components pane, right-click the ConnectorProcess node, then click Edit.
500
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
16. Set up the condition that specifies when to do the Create operation for the service in the fulfillment system.
◦ Drag and drop a Switch activity from Component Palette to immediately after the receiveInput activity.
◦ Immediately below the switch activity that you just added, click Condition, then set values.
Attribute Value
Label Create
Description CreateFulfillmentReqeuest
501
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
502
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
xp20:upper-case(bpws:getVariableData('inputVariable','payload','/ns4:headerTL/ns4:OperationMode'))
= "CREATE"
◦ Click OK.
◦ In the Condition dialog, click OK.
503
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
You typically use the FulfillOrderService service and FulfillmentResponseService service to communicate with your
fulfillment system. If you can't access or use these services for some reason, then do a different set up, depending on
whether you use extensible flexfields in your implementation.
504
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
You use extensible flexfields. Click Download Files in the Related Links section at the end of this topic, then use the WSDL
and XSD in the FulfillmentRequest.zip file that downloads.
2. On the Manage Connector Details page, click Download WSDL for External
Integration.
If you set up Order Management to raise a business event, then do these steps.
Attribute Value
The connector uses the pushPayload operation and the body input value of FulfillOrderService.
2. Make sure the web service operation can do these steps.
◦Accept the user name and password that you enter on the Manage External Interface Web Service Details
page. You use this page later during this integration setup after you finish setting up the connector.
◦ Receive a payload that uses the signature in the business_events_connnector_payload.xsd file. To get a
copy of this file, click Download Files in the Related Links section at the end of this topic.
3. Use the Associated Connectors tab to specify the connector that references the WSDL that you set up in step 1.
You can access this tab when you use the Manage Business Events Trigger Points page to set up the business
event.
For details about business events and the Associated Connectors tab, see the Send Notifications from Order
Management to External Systems topic.
You typically use FulfillOrderService to handle business events. If you can't access or use this service for some reason,
then use a different set up.
505
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
You don't use extensible flexfields. Click the Download Files link in the Related Links section at the end of this topic, then use the
WSDL and XSD in the business_events_wsdl.zip file that downloads.
2. On the Manage Connector Details page, click Download WSDL for External
Integration.
• Create
• Update
• Apply Hold
• Release Hold
• Cancel
So you add five switch case branches, one for each task.
506
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
For details about these tasks and other tasks that you can use, see the Task Types topic.
507
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
508
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
◦ Drag and drop Invoke from Component Palette onto branch Create.
◦ Right-click Invoke1, then, in the Edit Invoke dialog, set the value.
Attribute Value
Name InvokeCreateFulfillmentRequest
509
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Attribute Value
Operation create
◦ In the Edit Invoke dialog, in the Variables section, next to the Input window, click Add.
◦ In the Create Variable dialog, set the value, then click OK.
Attribute Value
Name InvokeCreateFulfillmentRequest_create_InputVariable
510
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
For example.
511
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
512
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
◦ Drag a receive activity from Component Palette, then drop it immediately downstream of the
InvokeCreateFulfillmentRequest node.
Attribute Value
Name ReceiveAcknowledgementForCreate
513
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Attribute Value
Operation createResponse
Variable ReceiveAcknowledgementForCreate_createResponse_InputVariable
514
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
For example.
515
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
4. Add an activity that transforms the input value into a message that your fulfillment system can understand.
◦ Drag a transform activity from Component Palette, then drop it immediately upstream of the
InvokeCreateFulfillmentRequest node.
Attribute Value
Name TransformationInputToCreate
◦ On the Transformation tab, in the Source area, click Add, then set values.
Attribute Value
Variable inputVariable
516
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Attribute Value
Part payload
◦ Set values.
Attribute Value
517
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
◦ In the page that displays, connect each attribute that you must send from Order Management to your
fulfillment system.
518
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
5. Add an activity that transforms the reply that your fulfillment system sends into a message that Order
Management can understand.
◦ Drag a transform activity from Component Palette, then drop it immediately downstream of the
ReceiveAcknowledgementForCreate node.
Attribute Value
Name TransformFulfillmentAckToOMAck
◦ On the Transformation tab, in the Source area, click Add, then set values.
519
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Attribute Value
Variable ReceiveAcknowledgementForCreate_createResponse_InputVariable
Part payload
◦ Set values.
Attribute Value
◦ On the ConnectorProcess process that you created earlier, drag an invoke activity from the Component
Palette, then drop it immediately downstream of the TransformFulfillmentAckToOMAck activity.
520
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
◦ Drag a Receive activity from Component Palette, then drop it immediately downstream of the
SendAcknowledgement activity that you just added.
This activity receives the delayed response from the fulfillment system.
◦ Right-click Receive1.
◦ In the Edit Receive dialog, on the General tab, set values, then click Apply > OK.
Attribute Value
Name ReceiveDelayedResponseFromFulfillment
521
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Attribute Value
Operation CreateResponse
Variable ReceiveDelayedResponseFromFulfillment_CreateResponse_InputVariable
For each operation, modify the values slightly to reflect the operation. For example, add the
Update operation to the Update branch, and use ReceiveAcknowledgementForUpdate instead of
ReceiveAcknowledgementForCreate.
8. Repeat steps 1 through 6 for the Apply Hold operation.
9. Repeat steps 1 through 6 for the Release Hold operation.
10. Repeat steps 1 through 6 for the Cancel operation.
522
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
1. Drag an Invoke activity from Component Palette, then drop it immediately downstream of the switch node.
2. Right-click Invoke1.
3. In the Edit Invoke dialog, on the General tab, set values, then click Apply > OK.
Attribute Value
Name SendDelayedResponseToOM
523
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Attribute Value
Operation process
Variable SendDelayedResponseToOM_process_InputVariable
4. Transform the delayed response message that your fulfillment system sends to a message that Order
Management can understand.
◦ Drag the Transform activity from Component Palette, then, in the create branch, drop it immediately
downstream of the ReceiveDelayedResponseFromFulfillment activity.
524
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Attribute Value
Name TransformDelayedResponseToOM
◦ On the Transformation tab, in the Source area, click Add, then set values.
Attribute Value
Variable ReceiveDelayedResponseFromFulfillment_createResponse_InputVariable
Part payload
◦ Set values.
Attribute Value
525
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
◦ Drag a receive activity from Component Palette, then drop it immediately downstream of the
SendDelayedResponseToOM activity.
Attribute Value
Name ReceiveResponseFromOM
526
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Attribute Value
Operation processResponse
Variable ReceiveResponseFromOM_processResponse_InputVariable
6. Set up a condition that specifies how to handle errors that Order Management might send.
◦ Drag and drop the Switch activity from Component Palette to immediately downstream of the
ReceiveResponseFromOM activity.
◦ Immediately below the switch activity that you just added, click Condition, set values, then click OK.
Attribute Value
Label ErrorCondition
527
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Attribute Value
Condition xp20:upper-
case(bpws:getVariableData('ReceiveResponseFromOM_processResponse_InputVariab
ns3:FulfillmentResponse/ns3:Status') !="SUCCESS"
7. Add nodes.
◦ AssignErrorConditionProcess. Specify actions to take in the Error Condition branch when an error
occurs.
◦ AssignSucess. Specify actions to take in the Otherwise branch when an error doesn't occur.
If the delayed response from the web service that calls Order Management includes a charge, then Order Management
deletes all previous charges and replaces them with the values that the response sends. Therefore, you must make sure
the response includes all charges that Order Management sent in the outgoing request.
For example, if Order Management sends the ORA_SHIPPING_FREIGHT value and the QP_NET_PRICE value for
the ChargeTypeCode charge, then the response must include ORA_SHIPPING_FREIGHT and QP_NET_PRICE for
ChargeTypeCode.
528
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Policy Description
oracle/ Uses SSL (Secure Sockets Layer) to secure communication in the transport layer.
wss_username_token_over_ssl_client_policy
Use Oracle JDeveloper or Oracle Enterprise Manager to secure your connector. This example uses Oracle JDeveloper.
For details about Oracle Enterprise Manager, see https://www.oracle.com/technetwork/oem/enterprise-manager/
overview/index.html.
1. Specify the security policy for the Request service. In the Exposed Services pane, right-click the end point of
ConnectorProcess, then click Configure WS Policies > For Request.
2. In the Configure SOA WS Policies dialog, in the Security area, click Add.
3. In the Select Server Security Policies dialog, choose the value.
529
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
oracle/ws11_saml_or_username_token_with_message_protection_service_policy
4. Click OK.
5. Specify the security policy for the callback service. In the Exposed Services pane, right-click the end point of
ConnectorProcess, then click Configure WS Policies > For Callback.
6. In the Configure SOA WS Policies dialog, in the Security area, click Add.
7. In the Select Server Security Policies dialog, choose the value.
oracle/wss_username_token_over_ssl_client_policy
8. Click OK.
9. In the Security area, click the row that you just added, then click Edit.
10. Set values.
Attribute Value
Note.
◦ This value specifies the key for Credential Store Framework (CSF).
◦ You must create this key in the application where you deploy the connector.
◦ This key must use the same user name and password that you use to sign into Order
Management Cloud.
530
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
11. Edit and assign the security policy for the connector that handles the delayed response.
Repeat the above steps. Use the same security policies and specify the same Credential Store Framework key.
12. Create and deploy your project. .
13. Create a user credential key, then add it to the identity store on the server that will call the web service. For
details, see the Integrate Order Management with Source Systems topic.
14. Get the user credentials that the service provider needs when they call their web service. You can typically get
these details from the service provider.
15. Send a request to your IT administrator to add the user credentials that you identified in step 4. Request to add
them to the server that will call the web service. Use the CSF-KEY (Credential Store Framework) reference.
531
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
1. In the transformation activity, navigate to the appropriate EffCategories node, such as FulfillLineEffCategories.
2. Expand the node.
532
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
5. Expand ns1:FulfillLineEFFCategories.
533
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
The navigation tree displays the hierarchy that includes the contexts and extensible flexfields that you can map
to the target XSD.
For example.
<xsl:if test="/ns1:headerTL/ns1:FulfillLineTLVO1/ns1:FulfillLineEffCategories/
ns10:FulfillLineEffBPackShipInstructionprivateVO/ns21:shipDate">
<ns21:shipDate>
<xsl:if test="/ns1:headerTL/ns1:FulfillLineTLVO1/ns1:FulfillLineEffCategories/
ns10:FulfillLineEffBPackShipInstructionprivateVO/ns21:shipDate/@xsi:nil">
<xsl:attribute name="xsi:nil">
<xsl:value-of select="/ns1:headerTL/ns1:FulfillLineTLVO1/ns1:FulfillLineEffCategories/
ns10:FulfillLineEffBPackShipInstructionprivateVO/ns21:shipDate/@xsi:nil"/>
</xsl:attribute>
</xsl:if>
<xsl:value-of select="/ns1:headerTL/ns1:FulfillLineTLVO1/ns1:FulfillLineEffCategories/
ns10:FulfillLineEffBPackShipInstructionprivateVO/ns21:shipDate"/>
</ns21:shipDate>
</xsl:if>
534
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
• EXT_FULFILLMENT_SALES_ORDER.
References the sales order or
document in your fulfillment
system.
• ORIGINAL_SALES_ORDER.
References the source order from a
source system or sales order from
Order Management Cloud that
contains the item that a return is
returning.
• EBS_ORDER. References a sales
order created in Oracle E-Business
Suite (EBS) where Oracle E-
Business Suite is the fulfillment
system.
• DROPSHIP_REQ_REFERENCE.
References a requisition for an
order line in a drop shipment in a
purchasing application.
• DROPSHIP_PO_REFERENCE.
References a purchase order for an
order line in a drop shipment in a
purchasing application.
DocId Value that uniquely identifies the Purchase Order Identifier in the
document. Order Management creates purchasing system
this value.
DocLineId Value that uniquely identifies the Purchase Order Line Identifier in the
document line. Order Management purchasing system
creates this value.
DocLineUserKey Line number that an end-user can Purchase Order Line Number
understand and recognize.
DocSublineId Value that uniquely identifies the Purchase Order Schedule Identifier in the
document subline. Order Management purchasing system
creates this value.
DocSubLineUserKey Number for the subline that an end-user Purchase Order Schedule Number
can understand and recognize.
535
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Related Topics
• Download Files
• How Order-to-Cash Works with Order Capture Systems
• How Data Flows Through Order Management
Manage Connector Details Between Order Management and Your Fulfillment System
Use a web service to allow Order Management to communicate with your fulfillment system. Use a predefined web
service or create a new one.
The connector in this topic sends each message from Order Management to your fulfillment system, then sends the
response message from your fulfillment system to Order Management.
1. Sign into Oracle Enterprise Manager.
For details about Oracle Enterprise Manager, see https://www.oracle.com/technetwork/oem/enterprise-
manager/overview/index.html.
2. In the navigation tree, expand Farm_fusion_domain > SOA > soa-infra (soa_server1) > default, then click
ConnectorServiceComposite.
3. In the ConnectorServiceComposite area, click Service Endpoint.
4. In the Service Endpoint and WSDL dialog, copy the value of the Endpoint URI and the WSDL to your clipboard.
Here are some examples.
WSDL http://server:port/soa-infra/services/default/ConnectorServiceComposite/
connectorprocess_client_ep?WSDL
Attribute Description
Connector Name Enter text that describes the connection you're making.
536
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Attribute Description
Connector URL Enter the URL that locates the connector that resides on your fulfillment system. For
example.
http://server:port/soa-infra/services/default/
ConnectorServiceComposite/connectorprocess_client_ep
where
Replace server:port with the name of the server that hosts your web service and
◦ the port number that the web service uses to communicate.
User Name and Password Enter the user name and password that the service requires.
As an option, use CSF-KEY. This key references the user credential that Order Management
uses to interact with the external web service.
There's no requirement to match the actual name of the connector, so you can provide a
short name. You can then use this short name in a routing rule. The value CSF-KEY applies
to all services that your fulfillment system provides.
◦ Set up each server that uses a web service to call Order Management.
◦ The Oracle WebLogic Server advertises the security certificates, by default. If your
servers support this advertisement, then enable it on your servers.
If you set up your server to advertise the security certificate, then use the keystore recipient
alias. Do these steps.
If you find that these options don't work, then set up the servers to use the Oracle security
certificate, and then import the certificate into your servers. The calling server doesn't
require you to set up this security certificate.
◦ Reject All Lines on First Error. Reject all fulfillment lines as soon as the connector
encounters the first error.
This setting stops processing immediately so you can fix the first error. If subsequent
fulfillment lines contain errors, then you must run fulfillment again, correct the error,
and repeat until you correct all errors.
◦ Reject All Lines When Error on at Least One Line Occurs. Process all fulfillment
lines. Add an error status to any fulfillment line that contains an error. When
537
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Attribute Description
processing finishes, if any fulfillment line contains an error, then reject all fulfillment
lines.
Use this setting to examine all lines that contain errors and correct them without
having to run fulfillment for each error.
◦ Reject Groups With Lines That Contain Errors. Reject the entire group of fulfillment
lines even if only one line in the group contains an error.
Your fulfillment system can send fulfillment lines in a group. For example, it can
send all lines in a shipment as a group or all lines in a sales order as a group. Use this
setting to manage these groups.
Invocation Mode Specify how Order Management should call the connector when the orchestration process
requires an interface to your fulfillment system.
◦ Business Event. Raise a business event so Order Management can interact with the
fulfillment system.
If you use Integration Cloud Service to integrate Order Management with the
fulfillment system, then you must choose Business Event. For details, see the
Overview of Using Integration Cloud Service to Integrate Order Management with
Other Systems topic.
◦ Synchronous Service. Make a synchronous call to the web service. Requires Order
Management to wait for the response from the web service before it continues
processing.
Use synchronous when Order Management depends on the response. For example,
use synchronous when calling credit check because Order Management must wait for
credit check to finish, then reply with the Credit Check Succeeded status before it can
send the sales order to order fulfillment.
◦ Asynchronous Service. Make an asynchronous call to the web service. Allows Order
Management to continue other processing while it waits for the response from the
web service.
Use asynchronous when Order Management doesn't depend on the response.
An asynchronous call is useful in an environment where a service, such as a loan
processor, can take a long time to process a request. For example, scheduling an
appointment to install an item that includes a computer network might cause a delay
but it doesn't affect order processing.
Note.
◦ You can use Business Event only with Oracle Global Trade Management and Oracle
Transportation Management
◦ If you screen trade compliance during order submit, then you must use a business
event to integrate with Oracle Global Trade Management.
◦ Use Business Event to integrate with trade compliance only for compliance screening
that occurs when the Order Entry Specialist submits the sales order, and not during
order fulfillment.
Send Attachments Choose Yes to enable Order Management to send attachments on sales orders.
If you use the OrderInformationService web service to connect with your fulfillment system.
◦ You can set the ExcludeAttachments attribute to false in the import payload of the
GetOrderDetails operation of OrderInformationService to allow Order Management to
send attachments.
◦ If you attach a large number of documents to the sales order, then its recommended
that you set Invocation Mode to Asynchronous Service. If you need to set Invocation
Mode to Synchronous Service, then set ExcludeAttachments to Yes in your input
payload, and GetorderDetails will exclude attachments.
538
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
7. Repeat step 7 for each web service that you use with Order Management.
8. Create a routing rule that selects the web services.
For details, see the Route Requests from Order Management to Fulfillment Systems topic.
Assume you use a target system named LEG, which is an abbreviation for the word legacy. You need to create one
connector to LEG to communicate details about orders that you capture in your legacy system, and another connector
to LEG to communicate status updates for these orders. Here's what your set up would look like.
539
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
If you create more than one connector for the same target system, then you must use the same user name and
password on each of those connectors. In this example, you must use the same user name and password for the Order
Capture connector and for the Status Update connector.
Order Management uses the name of the source system that your web service sends to identify the name of the target
system that it should use for the connector. If you create more than one connector for the same target system, then
Order Management uses the first connector it finds for the target system and uses the values that you set for the
User Name attribute and Password attribute on that connector to verify security for the response for any connector
that references the same target system. So, you must use the same user name and password on each connector that
contains the same value in the Target System attribute. If you don't, then your target system can't send the response,
and you might encounter one of these errors.
• Invalid security header.
• The security token cannot be authenticated.
• An error occurred while calling the service of the target application.
• Unable to verify the request sent by the client application. The request sent to OIC integration flow is
rejected.
• Unable to invoke endpoint URI successfully. Connection timed out.
Related Topics
• How Order-to-Cash Works with Order Capture Systems
• How Data Flows Through Order Management
Here are some examples that describe ways you might use a routing rule.
Example Description
Route sales order according to the For example, route each sales order that's ready to ship to a fulfillment system according to
value of an orchestration process task type.
attribute.
• If type code is Shipment, then route sales order to connector ABCShippingSystem.
Route sales order according to the For example, assume your company uses two invoicing systems, and that system ABC sends
value of a customer attribute. invoices to customer Computer Service and Rentals.
• If product type is Goods, and if task type is Invoice, then route request to connector
ABCInvoicingSystem.
540
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
• If task type is Shipment, and if quantity is 1000 or more, then route shipment request to Big Warehouse.
1. Set up connector.
2. Create the If statement.
3. Create the Then statement.
4. Test your set up.
This topic includes example values. You might use different values, depending on your business requirements.
Set Up Connector
Set values.
541
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Attribute Value
Description Route each shipping request that exceeds a quantity of 999 to the Big Shipments warehouse.
For details, see the Manage Connector Details That Integrate Order Management with Fulfillment Systems topic.
Attribute Value
Description Route each shipping request that exceeds quantity of 999 to Big Warehouse.
◦ Click And.
◦ In the Create Condition dialog, enter Quantity, wait a moment, then click Ordered Quantity (Order
Fulfill Line).
◦ Change = to >.
◦ Enter 999, then click OK.
542
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Attribute Value
Note that the Manage Connector Details page defines the connectors that the Search dialog displays on the
Manage External Interface Routing Rules page.
543
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
6. In the dialog that displays, add a check mark to Activate Rule, then click Save and Close > Publish.
Related Topics
• Use Visual Information Builder
Route a request from Order Management to your fulfillment system without a cross-reference.
1. Create a routing rule that implements this logic.
◦ If task type is Shipment, and if quantity is 1000 or more, then route shipment request to Big Warehouse.
544
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
For details, see the Route Requests from Order Management to Fulfillment Systems topic.
2. On the Manage External Interface Routing Rules page, open your rule for editing, then, in the flowchart, click
And > Perform an Action.
3. In the Create Action dialog, choose Resolve Cross-Reference for Customer.
4. Choose a value, then click OK For this example, choose No.
Value Description
Prepare Result Don't use this action Not applicable Not applicable Not applicable
or the ResultKey and
545
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
ResultValue parameters
that it uses. They are
for Oracle internal only.
Set Time frame to wait Use a numeric value for ACK_TIMEOUT_PERIOD Number
Acknowledgement before exiting out of an days, hours, minutes,
Timeout implicit wait during an or seconds. For
interaction with your example, 10 minutes.
fulfillment system or
with an Oracle Fusion
application.
Set Connector Name Connector name that You can use the SERVICE_NAME String
the web service uses to following predefined
communicate details to connectors.
your fulfillment system.
This name helps • Connector to
Order Management Oracle Fusion
route the message to Receivables
the web service URL system.
that this connector • Connector to
references. For details Oracle Fusion
about how to define a Inventory
connector so you can Management
specify it in this action, system.
see topic Manage
• Connector to
Connector Details
Oracle Fusion
That Integrate Order
Receiving
Management with
system.
Fulfillment Systems.
• Connector to
Oracle Fusion
Shipping
system.
Set Interaction Format to use when Use one of these InterfaceType String
Interface Type Order Management values.
interacts with the
fulfillment system. • Service Data
Object
546
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
• Enterprise
Business
Message
Set Maximum Time to Order Management Use a numeric value ABORT_ENABLE_PERIOD Number
Wait Before Allowing sends a request to your to express time of day,
Cancel fulfillment system or such as days, hours,
to some other Oracle minutes, or seconds.
Fusion application, and
then waits to receive
a reply. The reply
typically arrives within
a few seconds.
• 30 minutes. If
the reply doesn't
arrive within
30 minutes,
then Order
Management
enables
the Cancel
Current Task
action in the
orchestration
process that
processes the
fulfillment line.
If the Order
Entry Specialist
uses the
Cancel Current
Task action,
547
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
then Order
Management
places the
fulfillment line in
error recovery,
and the Order
Entry Specialist
can then end the
task.
• One month. If
the reply doesn't
arrive within
one month,
then Order
Management
places the
fulfillment line in
error recovery.
Note.
• Don't use the Set a Value operation in the DO clause.
• You must set the Connector Name action and the Interface Type action. All other actions are optional.
• You can use any action when you integrate with an application that isn't an Oracle Fusion application. You can
also use the Set Acknowledgement Timeout action or the Set Maximum Time to Wait Before Allowing Cancel
action when you integrate with some other Oracle Fusion application.
Related Topics
• Use Visual Information Builder
• Task Services
Action Description
Set Maximum Lines to Aggregate Number of pending requests that must aggregate before calling the fulfillment system.
Set Maximum Time to Wait Before Amount of time to wait before calling the fulfillment system. This time starts when the
Sending aggregator receives the first request.
548
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
An aggregator collects requests, and then sends them a single request when a time limit expires or when the aggregator
has aggregated a number of fulfillment lines for the sales order. If the sales order includes more than one fulfillment
line, and if these lines finish the task before the timeout occurs, then it sends all requests when the task finishes.
• The aggregator can aggregate only one time for each fulfillment system for each sales order. If Order
Management receives more fulfillment lines for the sales order after the aggregator sends a request, then it
sends each of these lines individually.
• The default timeout is five minutes.
• You can use the aggregator only with the Fulfill Order task or with a task that you define.
• If you specify Set Maximum Lines to Aggregate and also specify Set Maximum Time to Wait Before Sending,
then Order Management uses the first action that meets the conditions.
Action Value
At run time, assume 50 lines aggregate before 10 minutes elapse. Order Management will send the lines as
soon as 50 lines aggregate. If only 40 lines aggregate after 10 minutes, then Order Management won't send any
lines until 10 minutes elapse.
Note.
Consider only wait time. Set the Set Maximum Lines to Aggregate action to 0.
Ignore maximum fulfillment lines. This setup is equivalent to the default behavior when you don't specify Set Maximum Lines to
Aggregate.
Ignore wait time. Set the Set Maximum Lines to Aggregate action to 1.
Send only one line for each request. This setup is equivalent to the default behavior when you don't specify either action.
549
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Set Maximum Lines to Aggregate equals 10, so Order Management will send 10 lines to the fulfillment system in the first
request as soon as the aggregator receives the tenth order line.
Next, assume five minutes elapse by the time the aggregator receives the eleventh order line. During this time, the
aggregator receives another three order lines. The value of Set Maximum Time to Wait Before Sending equals 5, so
Order Management will send these four order lines in the second request to the fulfillment system.
The value of Set Maximum Time to Wait Before Sending is 5, so Order Management will send these 12 lines in the first
request to the fulfillment system.
Related Topics
• Use Visual Information Builder
• Task Services
Business Events
Overview of Using Business Events with Order Management
Use business events to integrate Order Management Cloud with some other Oracle Fusion Application or with an
application that resides outside of Oracle Fusion.
Use a business event with the Oracle ERP Cloud adapter to achieve results.
550
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Here's a flow you can use to deploy a single web service on each of your subscriber systems to receive the notification
for each condition that triggers the business event.
Note.
• 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, then Integration Cloud Service
broadcasts it to each of the subscribers 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 mapping between the business event output schema and each web
service is very similar.
If you use the Sales Order Notification business event, then Order Management can send a notification each time a
condition occurs.
• 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.
551
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Note.
• Use the Sales Order Notification event when you set up the end point in Integration Cloud Service 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.
552
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
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 you create in Integration Cloud Service is entirely separate from the connector you create on
Manage Connector Details. These connectors aren't related to one another in any way.
For more details, see the Send Notifications from Order Management to Other Systems topic.
553
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
To configure the end point, click the connection you dropped onto your integration, then click Edit. Use the wizard that
displays to choose 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.
554
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
The trigger points inform each subscriber when a significant development occurs with a 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.
555
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Specify Operations
Specify the operations that each web service must do. Edit the Publish To node in your integration.
Choose the Orchestration Order business object, choose the OrderInformationService web service, then choose an
operation.
556
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Operation Description
GetOrderDetails Get details about the progress of a sales order from Order Management.
ChangeOrderAllowed Determine whether Order Management allows changes on the sales order or fulfillment line.
ChangeOrderAttributeAllowed Determine whether Order Management allows changes on each sales order 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 the Overview of Creating Cross-References in Order Management topic.
You can also use the OrderImportService web service to send a new sales order or to revise a sales order that already
exists.
For details about how to specify data to communicate, go to Oracle Help Center, then see section Creating Connections
and Creating Integrations in book Using Oracle Integration Cloud Service.
Here's how you can use OrderFulfillmentResponseService to process the response that your fulfillment system sends to
Order Management.
557
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Note.
1. Order Management raises 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 output payload of the document service includes data that the fulfillment system uses to fulfill the
request. You can map this output payload to the web service 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.
When you configure the endpoint, set the web service to OrderFulfillmentResponseService.
558
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Choose an operation.
Operation Description
processAcknowledgement The fulfillment system sends an acknowledgment that confirms it received the fulfillment
request. processAcknowledgement accepts and processes the acknowledgment.
processFulfillmentResponse The fulfillment system calls processFulfillmentResponse to communicate the result of the
fulfillment request to Order Management.
559
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Operation Description
The service adds the Response suffix to the operation name, which results in a response
name of processFulfillmentResponseResponse.
This example includes part of the mapping between the response payload of the GetOrderDetails operation of Order
Information Service, to a target web service.
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.
560
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
• The mapping applies to one target web service, so you must do this mapping for each target system.
• If your deployment includes more than one channel system that must call GetOrderDetails, or if it 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).
For details about how to create a mapping, go to on Oracle Help Center, then see the Mapping Data chapter in book
Oracle Cloud, Using the Oracle Mapper.
561
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Assume you set up the integration to broadcast the Sales Order Notification event to subscribers when Order
Management updates the order status, such as from Processing to Closed.
1. The channel receives shipment for the sales order, then sends a successful delivery notification to Order
Management.
2. Order Management changes the order status from Processing to Closed.
3. Order Management raises a business event. Assume you set the Order Header Status Update event to Active on
the Manage Business Event Trigger Points page, and also set it up to raise an event when Order Management
updates the order header status to Closed.
562
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Oracle ERP Cloud Adapter recognizes the event, then uses your set up on the Oracle ERP Cloud Endpoint to
determine the service and operation to use.
5. To determine how to map source payload to target payload, Oracle ERP Cloud Adapter reads the source to
target mapping you set up.
6. Integration Cloud Service sends a notification to the subscriber on the channel.
Integration Cloud Service can integrate Order Management with a channel that's in or out of the cloud.
For example, send a notification to each subscriber when Order Management changes the status on the sales
order header to Closed.
◦ On the Manage Business Event Trigger Points page, click the Order Header Status Update row, then
make sure the Active option in this row contains a check mark.
◦ In the Details area, in the Closed row, add a check mark to the Raise Event option.
◦ Click Save.
563
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
1. On the Manage Business Event Trigger Points page, click the Fulfillment Line Status Update row, then make
sure the Active option in this row contains a check mark.
2. Click Save and Close.
3. Go to the task.
Each orchestration process controls the status value for each fulfillment line, so you must modify the
orchestration process that controls the status value. In this example, you modify the orchestration process that
controls the shipping status value.
5. In the search results, click the row that contains OrderFulfillmentGenericProcess, then click Actions > Edit.
6. In the Process Details area, click Status Conditions > Fulfillment Line Status Values > Edit Status Rule Set.
7. On the Edit Status Rule Set page, add a check mark to the Notify External System option for each Status Value
where your deployment must send a notification.
For example, to send a notification when Order Management changes the fulfillment line status to Shipped,
add a check mark to the Notify External System option in the Shipped row.
8. Repeat step 7 for other status values, as necessary.
Order Management will send a notification when each fulfillment line that this orchestration process processes
reaches the status you specify in steps 7 and 8.
9. Repeat steps 4 through 8 for each orchestration process in your deployment that updates status values, as
necessary.
Create a Connection
Create a connection between Integration Cloud Service and Order Management. For details about how to use
Integration Cloud Service, including the URL you use when you sign in, see Starting Oracle Integration Cloud Service on
Oracle Help Center.
1. Create a service request so the Cloud Operations team can register the CSF-KEY (Credential Store Framework).
You need the key to sign into Integration Cloud Service.
Request a separate key for each order administrator who uses Integration Cloud Service. For details, see the
Request CSF Keys for Oracle Integration Cloud Service topic.
2. Get access to the SOA Infra Operations Duty role.
The Order Administrator job role and the Supply Chain Application Administrator job role each come
predefined so they include SOA Infra Operations Duty.
◦ If you use a different role, such as Order Manager, then use the Security Console to get access to the SOA
Infra Operations Duty role.
564
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
◦ If your connection publishes the Sales Order Notification event to Integration Cloud Service, then you
must specify the login credentials of an Oracle Cloud Application user so you can access the Event
Catalog URL. You must assign the SOA Operator Role role to this user.
◦ Assign the Order Manager job role so this same user can call the web services that Order Management
uses. The integration must use the same login credentials to call web services at run time that you use
when you set up the integration at design time. These are Oracle Cloud Application user credentials.
If you use this connection to publish a business event to Integration Cloud Service, and to call Order
Management web services, then the Oracle Cloud Application user must use the Order Manager job role
and the SOA Infra Operations Duty role.
For more details, see the Assign Job Roles in Order Management topic.
3. Create the connection.
Attribute Value
Name Enter any text that describes the connection. For example,
Connection_for_Order_Status_Update.
Identifier Enter any text that describe the connection. For example,
CONNECTION_FOR_ORDER_STATUS_UPDATE.
Description Enter any text that describe the connection. For example, Connection for the
order status update.
Attribute Value
ERP Services Catalog WSDL URL Enter the URL that locates the WSDL. Use this format.
https://server:port/fndAppCoreServices/ServiceCatalogService?wsdl
For example.
https://my_server.com:9999/fndAppCoreServices/
ServiceCatalogService?wsdl
565
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Attribute Value
ERP Events Catalog URL (optional) Enter the URL that locates the events catalog. Use this format.
https://server:port/soa-infra
For example.https://my_server.com:7818/soa-infra
These URLs allow Integration Cloud Service to connect to Oracle ERP so Integration Cloud Service can
get details about the services and events that are available in Oracle ERP Cloud. Contact your system
administrator to determine the URLs you must use.
4. Configure security.
Create an Integration
Here's the integration you create.
This procedure provides only part of an example integration. In an actual integration, its more likely you will
choose Map My Data. To create a full, end-to-end integration, see the Integration Cloud Service documentation.
4. In the Create New Integration dialog, set values, then click Create.
566
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Attribute Value
What do you want to call your Describe the connection. For example, enter Connection_for_Order_Status_Update.
integration?
What does your integration do? Describe the connection. For example, enter Integration that uses a business
event to monitor updates to the order status.
5. On the page that displays, you will identify the source of the connection that provides the details. For this
example, in the search window, enter Connection_for_Order_Status_Update, which is the integration that you
created earlier, then click ENTER.
The test you did earlier for the connection you created must finish successfully. If it doesn't, then the search
won't return the connection.
6. Drag and drop Connection_for_Order_Status_Update from the search results onto the Drag and Drop a
Trigger area.
7. In the Configure Oracle ERP Cloud Endpoint dialog, specify the events and scenarios for the ERP Cloud
connection. Set values, then click Next.
Attribute Value
What do you want to call your Describe the endpoint. For example, enter PublishOrderStatusUpdated.
endpoint?
What does this endpoint do? Describe the connection. For example, enter Publish the OrderStatusUpdated
event.
Integration Cloud Service uses the URLs you set up earlier to get the event catalog, and then display it in the
Business Event for Subscription list. This list helps you choose from the events that are available in Oracle ERP
Cloud.
9. In the Business Event for Subscription list, enter Order, then click Sales Order Notification > Next.
10. On the Configure the Response to Send to the Oracle ERP Cloud Application page, note that Integration Cloud
Service only listens for events in this integration, then sends them to subscribers without replying to Order
Management. So, click None > Next.
11. On the Summary page, click Done.
567
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Use Tracking to test your set up. Use it to view the business events that your integration raises in the
monitoring system that Integration Cloud Service provides.
2. For this example, on the Business Identifiers for Tracking page, in the Source tree, under the result branch, click
Load More.
3. Drag and drop SourceTransactionNumber from the hierarchy tree to the first row of the Tracking Field
column.
4. Drag and drop Event from the hierarchy tree to the second row of the Tracking Field column.
5. In the result branch, expand LineStatusUpdate, then click Load More.
6. Drag and drop StatusCodeNewValue from the hierarchy tree to the third row of the Tracking Field column.
7. Click Done.
8. On the page that displays, click Save > Exit Integration.
9. On the Integrations page, in the Connection_for_Order_Status_Update row, click Pending Activation.
10. In the Confirmation dialog, add a check mark to the Enable Tracingoption, then click Yes.
568
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Other Setups
Go to Oracle Help Center at support.oracle.com to get details about other ways you can use Integration Cloud Service
with Order Management.
• Order Management Integration - ICS - Simulating External Fulfillment / Shipping (Doc ID 2578377.1)
• Order Management Integration - ICS - Testing Integration (Doc ID 2578387.1)
• Order Management Integration - Submitting a Fulfillment Response Payload From an External Fulfillment
Application (Doc ID 2579275.1)
569
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Related Topics
• Overview of Security Console
Filter Details when Using Integration Cloud Service with Order Management
Filter the event notifications that Integration Cloud Service sends to your channel or fulfillment system.
1. Use the Manage Business Event Trigger Points page to set up trigger points that enable event Order Status
Updated.
2. Use Integration Cloud Service to create an integration.
For details, see resources on the Oracle Help Center.
◦ Using Integration Cloud Service with Order Management to Communicate Events: Procedure
◦ Tutorials for Oracle Integration Cloud Service
◦ Videos for Oracle Integration Cloud Service
◦ Developing Integration Flows with Integration Cloud Service at http://www.oracle.com/webfolder/
technetwork/tutorials/obe/cloud/ics/DevelopingIntegrationFlowswithIntegrationCloudServicesOBE/
ICS_OBE.html
3. Sign into Integration Cloud Service and add filters.
◦ Open the mapping that maps the integration to Order Management Cloud.
◦ To allow events that only originate for sales orders from Order Management, create a filter on the Source
Transaction System attribute.
◦ To ignore events for a trigger that you set up on the Manage Business Event Trigger Points page, create a
filter on the Event Code attribute for each trigger you must filter.
Use different attributes, such as Country, SourceTransactionSystem, or EventCode, to create an expression.
For details, see topics in the Using Oracle Integration Cloud Service section on Oracle Help Center.
◦ Configuring Oracle ERP Cloud Trigger Request Properties
◦ Configuring Oracle HCM Cloud Trigger Request Properties
◦ Creating Routing Expression Logic in Both Expression Mode and Condition Mode in Creating Integrations
Get CSF Keys So You Can Sign Into Integration Cloud Service
Get the CSF (Credential Store Framework) key you need to sign into Oracle Integration Cloud Service.
Body Provide the identity domain that your integration can use for Order Management
Cloud and for Oracle Integration Cloud Service subscriptions. For example,
icssvc.identity.domain=idm2152.
570
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Request a separate CSF-KEY for each order administrator who must access Integration Cloud
Service.
2. Wait for Oracle to reply to your service request. When Oracle does reply, provide them with the user name and
password that you use to access Integration Cloud Service. Oracle will then create the CSF-KEY.
Transportation
Overview of Integrating Order Management with Transportation Management
Integrate Order Management Cloud with Oracle Transportation Management or some other transportation
management system that resides outside of Oracle so it sends sales orders for transportation planning, and receives
updates at fulfillment milestones, such as plan complete or proof of delivery.
• Leverage your transportation management system so it can efficiently plan transportation.
• Optimize the shipment that ships each sales order and minimize freight costs while meeting your customer
delivery requirements.
• Use Transportation Management to schedule and optimize shipments, finalize the transportation plan, tender
shipments to carriers, and send updated schedule dates to Order Management, providing the Order Manager
with visibility to the new shipment schedule.
• Enable your users to search sales orders according to scheduled ship date, scheduled arrival date, actual
delivery date, or transportation planning order.
• Update Order Management after the customer receives shipment. Use updated dates and statuses to identify
exceptions and control orchestration process flow.
• Provide final delivered status after the item ships.
• Enable Order Management to use the same process for a change order that it uses for the original sales order.
• Invoice each sales order only after delivery.
• Get a delivery notification when fulfillment delivers the shipment.
• Implement an end-to-end flow with Oracle Inventory Cloud for shipments.
571
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Order Management sends order status details to Transportation Management when the user creates, revises, or cancels
the sales order. Transportation Management plans and does fulfillment, sends updated scheduling details to Order
Management, then Order Management displays them in fulfillment views in the Order Management work area.
This example illustrates how the fulfillment line and Shipping tab display updated values for shipping attributes.
572
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
• Shipped Quantity
• Fulfilled Quantity
• Actual Fulfillment Date
1
9
Send Tender
Screen Party to Carrier
for Compliance
5
Legend:
Global Trade Management or Transportation Management
Supply Chain Management Cloud
1. Define Party and Classify Product. A Compliance Manager uses the administrative interface in Global Trade
Management to set up the party that identifies the customer and to classify the item.
2. Create Sales Order. An Order Entry Specialist creates a sales order in the Order Management work area. The
sales order references the customer and item that the Compliance Manager created.
3. Screen Party for Compliance, Screen for Export Control, and Determine License.
Screening Request
Inventory
Integration Global Trade
Management
Cloud Service Management
Cloud
Screening Result
Inventory
Global Trade Integration
Management
Management Cloud Service
Cloud
573
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Note.
◦ Inventory Management Cloud sends a screening request through Integration Cloud Service to Global
Trade Management. You can also set up Order Management to do trade compliance screening before
submitting the sales order, and you can use Inventory Management Cloud to screen during shipping.
◦ Global Trade Management screens the party for trade compliance according to request details that
you set up in Inventory Management Cloud. For example, you can request to screen shipment lines on
a specific step during the fulfillment process according to your business requirements, such as after
fulfillment staged fulfillment lines but hasn't shipped them. Global Trade Management can also screen
the transaction for export controls, and can screen the party and transaction for licensing.
◦ Global Trade Management sends screening results through Integration Cloud Service to Inventory
Management Cloud.
4. Orchestrate Order. Order Management orchestrates fulfillment for the sales order, including creating a
shipment request in Shipping.
5. Fulfill Order. Transportation Management receives a transportation management request for the fulfillment
line from Order Management, acknowledges the request, and converts it to an order release.
The Order Management work area updates the screening status on the Order page during orchestration. It also
updates the transportation planning order and orchestration process number on the Fulfillment Lines tab, and
it updates the status of the orchestration plan on the Orchestration Process tab with the details it receives from
Transportation Management.
6. Pick and Pack. Oracle Fusion Shipping picks and packs the sales order in the warehouse.
7. Create Export Documents. Optional. If the flow includes Global Trade Management, then it creates export
documents, if necessary, and also creates the Shipment Trade Transaction. As an option, it can also screen
for compliance according to how you set it up for screening during order fulfillment, and then send screening
results and reason to Shipping.
8. Send Tender to Carrier. Oracle Transportation Management creates and sends the tender to carrier. If
necessary, Global Trade Management declares the export.
9. Ship Item. Oracle Shipping ships the item and sends the shipment advice to Order Management and
Transportation Management. The customer receives and acknowledges receipt, then Transportation
Management sends shipment delivery confirmation to Order Management. Order Management sends the
fulfillment line to Oracle Fusion Accounts Receivable for invoicing, then sets the fulfillment line status to Closed.
574
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
• Required.
◦ Send details from Order Management to Transportation Management when the user creates, revises, or
cancels a sales order.
◦ Send acknowledgement from Transportation Management to Order Management.
• Optional.
◦ As an option, send fulfillment details from Transportation Management to Order Management. For
example, confirm that Transportation Management created the order release, send transportation plan
that includes updated schedule dates, or send delivery confirmation details, such as delivery date.
575
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
576
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Note.
• Use the predefined DOO_TransportationPlanning task type in the orchestration process. This task type allows
Order Management to send a new request to the transportation management system, and to update or cancel
a request that already exists.
• Reference DOO_TransportationPlanning at any point in the stepwise sequence of an orchestration process,
depending on your business requirements. For example, set up an orchestration process so it identifies the
source of supply, reserves inventory, then plans transportation.
• It might be necessary to wait for a response from Transportation Management in some situations. For
example, an order release is a representation of the sales order in Transportation Management. Transportation
Management uses the sales order as input to create the order release.
If Transportation Management can't successfully create the release, for example, an attribute that it requires for
planning transportation is missing a value, then it might be useful to prevent the orchestration process from
577
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
proceeding, such as to a ship item step, until the Order Manager can determine whether to allow the process to
proceed without the release.
• To add a wait step, copy the Send Request step, then modify the copy as necessary.
• Use value DOO_TP_REQ_ACCEPT or value CANCELED in the Status Code attribute as the exit criteria for the
wait step.
• Flow doesn't proceed to the next step until Transportation Management replies that it successfully created the
sales order release.
• Don't wait for a response unless you need it to meet a business requirement. Waiting for the response increases
the possibility that the orchestration process might take a long time to finish, or get stuck waiting for the
response.
• Process the response from Transportation Management at different steps in the orchestration process, such
as after the transportation plan finishes, or after Transportation Management sends proof of delivery. Order
Management can use the response after the transportation plan finishes even if the orchestration process isn't
currently running the DOO_TransportationPlanning task.
• DOO_TransportationPlanning uses an indicator to mark each fulfillment line that Transportation Management
planned so some other system can process it.
For example, the predefined integration with Inventory Cloud sets a transportation planning hold on each
shipment request that references a fulfillment line that contains this indicator. The integration releases the hold
only after Transportation Management receives the transportation shipment plan.
At run time, the Status attribute on the order line references DOO_TransportationPlanning on the orchestration process
to get the status for Awaiting Transportation Planning Response.
578
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
• The DOO_TransportationPlanning task and Shipment task come predefined to use different attributes to
identify change. You must modify them so they use the same attributes. For details, see the Manage Order
Attributes That Identify Change topic.
• If your orchestration process includes branching, and if you include the Shipment task in one or more
branch, and if you expect transportation and shipping will process the order line, then you must include the
DOO_TransportationPlanning task in each branch that includes the Shipment task. For Example, if you include
Shipment in branch x for normal shipping and branch y for back-to-back shipping, then you must include
DOO_TransportationPlanning in x and y instead of including DOO_TransportationPlanning in a step that occurs
before the branch.
579
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
• Make sure the DOO_TransportationPlanning task and the Shipment task use the same compensation pattern.
For details about compensation patterns, see the Manage Change That Occurs During Order Fulfillment topic.
Note.
• Get updated scheduled dates and order release number from Transportation Management.
• Prevent Order Management from updating the sales order after it sends it to Transportation Management. See
the section about constraints later in this topic.
580
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Note these points about getting the transportation plan and delivery confirmation.
• The transportation plan uses the DOO_TP_PLANNED value in the TaskInstanceStatusCode attribute.
• The transportation plan updates the Scheduled Ship Date attribute and the Scheduled Arrival Date attribute.
• If Transportation Management splits the transportation plan into two separate shipments, then Transportation
Management sends the latest date of these shipments to Order Management. For example, if shipment
one delivers on January 1, and shipment two delivers on January 15, then the transportation plan that
Transportation Management sends to Order Management will include only the latest date of the finished
shipment, which is January 15.
• If the orchestration process receives the transportation plan when its not on a wait step, then it will reject the
plan and will reject the request to update.
To make sure the orchestration process reaches a wait step, allow about 10 minutes between the most recent
update that Order Management sends to Transportation Management, and the time when Transportation
Management sends the plan update to Order Management.
• Add a pause step that's similar to the Shipping step in the orchestration process.
• Get delivery confirmation at different points in the orchestration process, such as Awaiting Billing.
For example, to prevent the Invoice step from running before confirming delivery, add a pause step before the
invoice step, then set up the pause so it waits until Order Management receives delivery confirmation.
• Use the SAC_SYSTEM_EVENT_POD_PAUSE event and the TransportationPlannedFlag attribute.
• Use SAC_SYSTEM_EVENT_POD_PAUSE to release the pause when Transportation Management sends status
DOO_TP_DELIVERED.
• Make sure the orchestration process is on a wait step when it receives the response.
• The status description for DOO_TP_DELIVERED is Shipment Delivered. However, if you use a pause to get
delivery status, then Shipment Delivered doesn't display. Instead, set up a pause status that displays Shipment
Delivered.
On the pause step, click Click for Rule, then create two pause rules.
Order Management releases SAC_SYSTEM_EVENT_POD_PAUSE after it receives delivery confirmation so you can use
this event to process a subsequent sales order.
Rule 1
where
581
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Code Description
If "D" equals ignore case If the TransporationPlannedFlag attribute on the fulfillment line contains D.
DooSeededOrchestrationRules.DOOFLine.TransporationPlannedFlag
assert new Then immediately release the pause task and continue to the next step in the orchestration
DooSeededOrchestrationRules.SacResult
process.
(sacType:DooSeededOrchestrationRules.SacResult.SAC_TYPE_IMMEDIATE)
Rule 2
where
Code Description
For details about how to create a pause rule, see the Pause Orchestration Processes topic.
582
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Note.
• Shipment Plan Complete prevents the user from revising the order line in the Order Management work area
after Transportation Management sends the transportation plan to Inventory Management. This constraint
comes predefined as disabled. You can enable it during set up.
583
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Before Release 18C, Inventory Management supports only a quantity change or order cancel after
Transportation Management sends the transportation plan to Inventory Management. Inventory Management
doesn't support any other order revisions before Release 18C.
Inventory Management supports revisions starting with Release 18C. You can disable Shipment Plan Complete
after you upgrade to Release 18C.
• Order Management uses the transportation plan to determine whether Transportation Management already
sent the transportation plan to Shipping.
• If you don't use Oracle Inventory Management, then don't enable the Shipment Plan Complete constraint.
Set Up Integration
Set Up Connector
Note.
584
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Attribute Description
Order Management uses this name at various locations in the flow. Using
TransportationPlanning will help you identify the connector involved in the flow that you're
setting up or during troubleshooting.
• Use the predefined integration in Integration Cloud Service, then set Invocation Mode to
Business Event.
• Don't use the predefined integration, then set Invocation Mode to Synchronous or
Asynchronous.
User Name Make sure the user has the privilege you need.
Use a predefined integration in Integration Cloud Service as a starting point for your integration. Use the
TransportationPlanning connector to connect through a business event.
585
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
For example.
586
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Note.
587
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
• Click Get App to access article Integration with OTM or GTM using ICS (Doc ID 2209248.1) on My Oracle
Support.
• Import one of the example integrations into Integration Cloud Service. For example, import integration
OTM_OM, Communicate Order Shipping Information to Order Management Cloud.
• Examine the integration in the Integration Cloud Service user interface.
Note.
• The predefined integration in Integration Cloud Service uses this structure. If you modify it, then use this
payload as an example of the data that your fulfillment system must send.
588
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Related Topics
• Orchestration Processes
In this example, you create an orchestration process so it sends the request for transportation planning after the
fulfillment system identifies a source and reserves inventory.
589
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
This topic includes example values. You might use different values, depending on your business requirements.
Try it.
1. Use Integration Cloud Service to create an integration between Order Management and Transportation
Management.
Make sure you set the business event trigger points that you need to start the integration process. For details,
see the Overview of Using Integration Cloud Service with Order Management topic.
2. Create the orchestration process.
You can integrate Order Management with Transportation Management only through a long-running
task.
◦ In the Edit Orchestration Process Definition dialog, set values, then click Save.
Attribute Value
Process Name Enter any text. For this example, enter ShipOrder_PlanTransportation.
Process Display Name Enter any text. For this example, enter Ship Order and Plan Transportation.
Attribute Value
590
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Attribute Value
4. On the Step Definition tab, add a step at any location in the sequence of steps.
Attribute Value
Task TransportationPlanning
This step sends the sales order to the fulfillment system for transportation planning. For this example, add this
step immediately after the Create Reservation step.
5. Optional. Add this step immediately after the Send Request to Transportation Management step.
Attribute Value
591
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Attribute Value
Task TransportationPlanning
◦ Canceled
This exit criteria causes the orchestration process to wait until the Transportation Planning
Request Accepted status equals Y, or until Order Management cancels the request, such as
through a time out.
Note.
◦ This step temporarily pauses the orchestration process so Transportation Management can validate the
planning request before the orchestration process creates the shipment request.
◦ Set up your orchestration process so it processes the response while waiting on a pause step.
◦ If you don't add this step, then the orchestration process will continue to run and fulfill the sales order
without waiting for validation from Transportation Management.
Related Topics
• Orchestration Processes
592
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Note.
1. Transform your input into an immediate response and set it to Order Management.
2. Wait for two minutes.
3. Initialize local variables, such as Result and Counter.
4. Transform your input into a delayed response. It converts cost to charge, including a mark up, if necessary.
5. Send a delayed response, then wait for a SUCCESS reply.
Make sure you also implement error handling to handle an ERROR reply.
6. Send the delayed response that contains charges back to Order Management. Not included on the diagram.
593
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
The connector updates these charges in Order Management Cloud, then sends them to invoicing.
Note.
1. Send charges in a delayed response to Order Management.
2. Receive a reply from Order Management. The reply contains SUCCESS or ERROR.
3. Save the results of the reply in a local variable.
4. If condition that routes the flow depending on the value of the local variable, SUCCESS or ERROR.
5. If condition that routes the flow depending on the Counter local variable that counts the number of attempts.
6. Depending on the error you receive, wait five minutes, then call the service in Order Management again.
7. Increment the Counter variable.
594
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Points to Consider
• Set up your task as a long-running task that uses a wait step in your orchestration process.
• Send the existing charges back through the task response in addition to the new charges that you're adding for
freight.
• Make sure you use only one primary charge for each ChargeAppliesTo on each fulfillment line.
• Make sure you set the Applies To attribute to SHIPPING for each new charge you add.
• If you split the shipment lines, and if you capture more than one shipping cost in one fulfillment line, then sum
the costs and send a single freight charge through your task.
• If you must calculate tax on the freight charges, see the Integrate Order Management with Oracle Receivables
topic.
• Make sure the user who calls the delayed response service has these privileges.
◦ Manage Orchestration Order Template Interface Web Service
◦ Manage Orchestration Order Fulfillment Interface Web Service
To verify charge definition codes, go to the Setup and Maintenance work area, then open the Manage Pricing Charge
Definitions page. For details, see the Manage Pricing Charge Definitions topic.
File Description
The PriceAdjustmentTL tag contains the cost that the flow records when it confirms
shipment.
CostToChargeMappings.xlsx Example mapping that the flow uses for a delayed response.
595
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
File Description
Example Payloads
Immediate Response
Delayed Response
Here's an example payload that the CostToChargeDelayedResponse.xml file contains. Use the
FulfillLineOrderChargeSDOTR tag to send back the shipping charges.
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<ns1:FulfillmentRequest xmlns:ns1="http://xmlns.oracle.com/apps/scm/doo/taskLayer/fulfillOrder/
DooTaskFulfillOrderResponseInterfaceComposite">
<ns1:FLine xmlns:ns2="http://xmlns.oracle.com/apps/scm/doo/common/process/model/">
<ns2:FulfillLineId>300100135839049</ns2:FulfillLineId>
<ns2:Status>COMPLETED</ns2:Status>
<ns2:TaskType>ConvertCostToCharge</ns2:TaskType>
<ns2:FulfillLineOrderChargeSDOTR>
<ns2:ChargeDefinitionCode>QP_SHIP_FREIGHT</ns2:ChargeDefinitionCode>
<ns2:ChargeSubtypeCode>ORA_PRICE</ns2:ChargeSubtypeCode>
<ns2:PriceTypeCode>ONE_TIME</ns2:PriceTypeCode>
<ns2:PricedQuantity>3</ns2:PricedQuantity>
<ns2:PricedQuantityUOMCode>Ea</ns2:PricedQuantityUOMCode>
<ns2:PrimaryFlag>true</ns2:PrimaryFlag>
<!-- Below Attribute indicates that this charge is a shipping charge. -->
<ns2:ChargeAppliesTo>SHIPPING</ns2:ChargeAppliesTo>
<ns2:RollupFlag>false</ns2:RollupFlag>
<ns2:SourceChargeIdentifier>300100171244129</ns2:SourceChargeIdentifier>
<ns2:ChargeTypeCode>ORA_SHIPPING_FREIGHT</ns2:ChargeTypeCode>
<ns2:ChargeCurrencyCode>USD</ns2:ChargeCurrencyCode>
<ns2:SequenceNumber>2</ns2:SequenceNumber>
<ns2:GsaUnitPrice/>
<ns2:FulfillLineOrderChargeComponentSDOTR>
<ns2:ChargeCurrencyCode>USD</ns2:ChargeCurrencyCode>
<ns2:HeaderCurrencyCode>USD</ns2:HeaderCurrencyCode>
<ns2:HeaderCurrencyExtendedAmount>15</ns2:HeaderCurrencyExtendedAmount>
<ns2:PriceElementCode>QP_NET_PRICE</ns2:PriceElementCode>
<ns2:SequenceNumber>1</ns2:SequenceNumber>
<ns2:PriceElementUsageCode>NET_PRICE</ns2:PriceElementUsageCode>
<!-- Below Attribute indicates the unit net price of the of the charge in the currency in which charge was
calculated.
It can be same or different than the order header currency. -->
<ns2:ChargeCurrencyUnitPrice>5</ns2:ChargeCurrencyUnitPrice>
596
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
<!-- Below Attribute indicates the per unit net price of the of the charge in the currency of the order
header.
It can be same or different than the charge currency. -->
<ns2:HeaderCurrencyUnitPrice>5</ns2:HeaderCurrencyUnitPrice>
<ns2:RollupFlag>false</ns2:RollupFlag>
<!-- Below Attribute indicates the charge identifier for this charge component in the source system. -->
<ns2:SourceChargeId>300100171244129</ns2:SourceChargeId>
<!-- Below Attribute indicates the charge component identifier in the source system. -->
<ns2:SourceChargeComponentId>1</ns2:SourceChargeComponentId>
<!-- Below Attribute indicates the total line amount for the respective charge component of the charge sent
in charge currency.
This should be quantity times the unit price in the charge currency. -->
<ns2:ChargeCurrencyExtendedAmount>15</ns2:ChargeCurrencyExtendedAmount>
<ns2:Explanation>UPS Freight Costs</ns2:Explanation>
</ns2:FulfillLineOrderChargeComponentSDOTR>
<ns2:FulfillLineOrderChargeComponentSDOTR>
<ns2:ChargeCurrencyCode>USD</ns2:ChargeCurrencyCode>
<ns2:HeaderCurrencyCode>USD</ns2:HeaderCurrencyCode>
<ns2:HeaderCurrencyExtendedAmount>15</ns2:HeaderCurrencyExtendedAmount>
<ns2:PriceElementCode>QP_LIST_PRICE</ns2:PriceElementCode>
<ns2:SequenceNumber>2</ns2:SequenceNumber>
<ns2:PriceElementUsageCode>LIST_PRICE</ns2:PriceElementUsageCode>
<!-- Below Attribute indicates the unit net price of the of the charge in the currency in which charge was
calculated.
It can be same or different than the order header currency. -->
<ns2:ChargeCurrencyUnitPrice>5</ns2:ChargeCurrencyUnitPrice>
<!-- Below Attribute indicates the per unit net price of the of the charge in the currency of the order
header.
It can be same or different than the charge currency. -->
<ns2:HeaderCurrencyUnitPrice>5</ns2:HeaderCurrencyUnitPrice>
<ns2:RollupFlag>false</ns2:RollupFlag>
<!-- Below Attribute indicates the charge identifier for this charge component in the source system. -->
<ns2:SourceChargeId>300100171244129</ns2:SourceChargeId>
<!-- Below Attribute indicates the charge component identifier in the source system. -->
<ns2:SourceChargeComponentId>2</ns2:SourceChargeComponentId>
<!-- Below Attribute indicates the total line amount for the respective charge component of the charge sent
in charge currency.
This should be quantity times the unit price in the charge currency. -->
<ns2:ChargeCurrencyExtendedAmount>15</ns2:ChargeCurrencyExtendedAmount>
</ns2:FulfillLineOrderChargeComponentSDOTR>
</ns2:FulfillLineOrderChargeSDOTR>
<!-- Below are the existing charges Those need to be sent as is -->
<ns2:FulfillLineOrderChargeSDOTR>
<ns2:ChargeAppliesTo>PRICE</ns2:ChargeAppliesTo>
<ns2:ChargeCurrencyCode>USD</ns2:ChargeCurrencyCode>
<ns2:ChargeDefinitionCode>QP_SALE_PRICE</ns2:ChargeDefinitionCode>
<ns2:ChargeSubtypeCode>ORA_PRICE</ns2:ChargeSubtypeCode>
<ns2:ChargeTypeCode>ORA_SALE</ns2:ChargeTypeCode>
<ns2:ParentEntityCode>LINE</ns2:ParentEntityCode>
<ns2:PricePeriodicityCode xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:nil="true"/>
<ns2:PriceTypeCode>ONE_TIME</ns2:PriceTypeCode>
<ns2:PricedQuantity>3</ns2:PricedQuantity>
<ns2:PricedQuantityUomCode>Ea</ns2:PricedQuantityUomCode>
<ns2:PrimaryFlag>true</ns2:PrimaryFlag>
<ns2:ReferenceOrderChargeId xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:nil="true"/>
<ns2:RollupFlag>false</ns2:RollupFlag>
<ns2:SequenceNumber>1</ns2:SequenceNumber>
<ns2:SourceChargeId>300100171226040</ns2:SourceChargeId>
<ns2:AvgUnitSellingPrice xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:nil="true"/>
<ns2:FreightReferenceLineId xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:nil="true"/>
<ns2:CanAdjustFlag>true</ns2:CanAdjustFlag>
<ns2:FulfillLineOrderChargeComponentSDOTR>
<ns2:ChargeCurrencyCode>USD</ns2:ChargeCurrencyCode>
<ns2:ChargeCurrencyExtendedAmount>7500</ns2:ChargeCurrencyExtendedAmount>
<ns2:ChargeCurrencyUnitPrice>2500</ns2:ChargeCurrencyUnitPrice>
<ns2:Explanation>Base List Price Applied from Corporate Segment Price List</ns2:Explanation>
597
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
598
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
<ns2:ModifiedFlag>N</ns2:ModifiedFlag>
<ns2:PercentOfComparisonElement>-0.0044</ns2:PercentOfComparisonElement>
<ns2:PriceElementCode>QP_CUSTOM_ADJUSTMENT</ns2:PriceElementCode>
<ns2:PriceElementUsageCode>PRICE_ADJUSTMENT</ns2:PriceElementUsageCode>
<ns2:PricingSourceId>300100171226080</ns2:PricingSourceId>
<ns2:PricingSourceTypeCode>MANUAL_ADJUSTMENT</ns2:PricingSourceTypeCode>
<ns2:ReferenceOrderChargeCompId xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:nil="true"/>
<ns2:RollupFlag>false</ns2:RollupFlag>
<ns2:SequenceNumber>1003</ns2:SequenceNumber>
<ns2:SourceChargeComponentId>300100171226082</ns2:SourceChargeComponentId>
<ns2:SourceChargeId>300100171226040</ns2:SourceChargeId>
<ns2:SourceParentChargeCompId xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:nil="true"/>
</ns2:FulfillLineOrderChargeComponentSDOTR>
<ns2:FulfillLineOrderChargeComponentSDOTR>
<ns2:ChargeCurrencyCode>USD</ns2:ChargeCurrencyCode>
<ns2:ChargeCurrencyExtendedAmount>-7.5</ns2:ChargeCurrencyExtendedAmount>
<ns2:ChargeCurrencyUnitPrice>-2.5</ns2:ChargeCurrencyUnitPrice>
<ns2:Explanation>Manual Discount of 0.1% on price element List Price for reason code Sales negotiation</
ns2:Explanation>
<ns2:ExplanationMessageName xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:nil="true"/>
<ns2:HeaderCurrencyCode>USD</ns2:HeaderCurrencyCode>
<ns2:HeaderCurrencyExtendedAmount>-7.5</ns2:HeaderCurrencyExtendedAmount>
<ns2:HeaderCurrencyUnitPrice>-2.5</ns2:HeaderCurrencyUnitPrice>
<ns2:PercentOfComparisonElement>-0.001</ns2:PercentOfComparisonElement>
<ns2:PriceElementCode>QP_CUSTOM_ADJUSTMENT</ns2:PriceElementCode>
<ns2:PriceElementUsageCode>PRICE_ADJUSTMENT</ns2:PriceElementUsageCode>
<ns2:PricingSourceId>300100171226101</ns2:PricingSourceId>
<ns2:PricingSourceTypeCode>MANUAL_ADJUSTMENT</ns2:PricingSourceTypeCode>
<ns2:ReferenceOrderChargeCompId xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:nil="true"/>
<ns2:RollupFlag>false</ns2:RollupFlag>
<ns2:SequenceNumber>1004</ns2:SequenceNumber>
<ns2:SourceChargeComponentId>300100171226103</ns2:SourceChargeComponentId>
<ns2:SourceChargeId>300100171226040</ns2:SourceChargeId>
<ns2:SourceParentChargeCompId xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:nil="true"/>
</ns2:FulfillLineOrderChargeComponentSDOTR>
<ns2:FulfillLineOrderChargeComponentSDOTR>
<ns2:ChargeCurrencyCode>USD</ns2:ChargeCurrencyCode>
<ns2:ChargeCurrencyExtendedAmount>7429.5</ns2:ChargeCurrencyExtendedAmount>
<ns2:ChargeCurrencyUnitPrice>2476.5</ns2:ChargeCurrencyUnitPrice>
<ns2:Explanation xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:nil="true"/>
<ns2:ExplanationMessageName xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:nil="true"/>
<ns2:HeaderCurrencyCode>USD</ns2:HeaderCurrencyCode>
<ns2:HeaderCurrencyExtendedAmount>7429.5</ns2:HeaderCurrencyExtendedAmount>
<ns2:HeaderCurrencyUnitPrice>2476.5</ns2:HeaderCurrencyUnitPrice>
<ns2:PercentOfComparisonElement>0.9906</ns2:PercentOfComparisonElement>
<ns2:PriceElementCode>QP_NET_PRICE</ns2:PriceElementCode>
<ns2:PriceElementUsageCode>NET_PRICE</ns2:PriceElementUsageCode>
<ns2:PricingSourceId xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:nil="true"/>
<ns2:PricingSourceTypeCode xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:nil="true"/>
<ns2:ReferenceOrderChargeCompId xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:nil="true"/>
<ns2:RollupFlag>false</ns2:RollupFlag>
<ns2:SequenceNumber>1005</ns2:SequenceNumber>
<ns2:SourceChargeComponentId>300100171226044</ns2:SourceChargeComponentId>
<ns2:SourceChargeId>300100171226040</ns2:SourceChargeId>
<ns2:SourceParentChargeCompId xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:nil="true"/>
</ns2:FulfillLineOrderChargeComponentSDOTR>
<ns2:FulfillLineOrderChargeComponentSDOTR>
<ns2:ChargeCurrencyCode>USD</ns2:ChargeCurrencyCode>
<ns2:ChargeCurrencyExtendedAmount>1485.9</ns2:ChargeCurrencyExtendedAmount>
<ns2:ChargeCurrencyUnitPrice>495.3</ns2:ChargeCurrencyUnitPrice>
<ns2:Explanation>Exclusive Tax ( 20%)</ns2:Explanation>
<ns2:ExplanationMessageName xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:nil="true"/>
<ns2:HeaderCurrencyCode>USD</ns2:HeaderCurrencyCode>
<ns2:HeaderCurrencyExtendedAmount>1485.9</ns2:HeaderCurrencyExtendedAmount>
<ns2:HeaderCurrencyUnitPrice>495.3</ns2:HeaderCurrencyUnitPrice>
<ns2:PercentOfComparisonElement>0.19812</ns2:PercentOfComparisonElement>
599
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
<ns2:PriceElementCode>QP_EXCLUSIVE_TAX</ns2:PriceElementCode>
<ns2:PriceElementUsageCode>EXCLUSIVE_TAX</ns2:PriceElementUsageCode>
<ns2:PricingSourceId xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:nil="true"/>
<ns2:PricingSourceTypeCode xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:nil="true"/>
<ns2:ReferenceOrderChargeCompId xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:nil="true"/>
<ns2:RollupFlag>false</ns2:RollupFlag>
<ns2:SequenceNumber>1015</ns2:SequenceNumber>
<ns2:SourceChargeComponentId>300100171226200</ns2:SourceChargeComponentId>
<ns2:SourceChargeId>300100171226040</ns2:SourceChargeId>
<ns2:SourceParentChargeCompId xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:nil="true"/>
</ns2:FulfillLineOrderChargeComponentSDOTR>
<ns2:FulfillLineOrderChargeComponentSDOTR>
<ns2:ChargeCurrencyCode>USD</ns2:ChargeCurrencyCode>
<ns2:ChargeCurrencyExtendedAmount>8915.4</ns2:ChargeCurrencyExtendedAmount>
<ns2:ChargeCurrencyUnitPrice>2971.8</ns2:ChargeCurrencyUnitPrice>
<ns2:Explanation xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:nil="true"/>
<ns2:ExplanationMessageName xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:nil="true"/>
<ns2:HeaderCurrencyCode>USD</ns2:HeaderCurrencyCode>
<ns2:HeaderCurrencyExtendedAmount>8915.4</ns2:HeaderCurrencyExtendedAmount>
<ns2:HeaderCurrencyUnitPrice>2971.8</ns2:HeaderCurrencyUnitPrice>
<ns2:PercentOfComparisonElement>1.18872</ns2:PercentOfComparisonElement>
<ns2:PriceElementCode>QP_NET_PRICE_PLUS_TAX</ns2:PriceElementCode>
<ns2:PriceElementUsageCode>NET_PRICE_PLUS_TAX</ns2:PriceElementUsageCode>
<ns2:PricingSourceId xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:nil="true"/>
<ns2:PricingSourceTypeCode xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:nil="true"/>
<ns2:ReferenceOrderChargeCompId xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:nil="true"/>
<ns2:RollupFlag>false</ns2:RollupFlag>
<ns2:SequenceNumber>1016</ns2:SequenceNumber>
<ns2:SourceChargeComponentId>300100171226201</ns2:SourceChargeComponentId>
<ns2:SourceChargeId>300100171226040</ns2:SourceChargeId>
<ns2:SourceParentChargeCompId xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:nil="true"/>
</ns2:FulfillLineOrderChargeComponentSDOTR>
<ns2:FulfillLineOrderChargeComponentSDOTR>
<ns2:ChargeCurrencyCode>USD</ns2:ChargeCurrencyCode>
<ns2:ChargeCurrencyExtendedAmount>7429.5</ns2:ChargeCurrencyExtendedAmount>
<ns2:ChargeCurrencyUnitPrice>2476.5</ns2:ChargeCurrencyUnitPrice>
<ns2:Explanation xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:nil="true"/>
<ns2:ExplanationMessageName xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:nil="true"/>
<ns2:HeaderCurrencyCode>USD</ns2:HeaderCurrencyCode>
<ns2:HeaderCurrencyExtendedAmount>7429.5</ns2:HeaderCurrencyExtendedAmount>
<ns2:HeaderCurrencyUnitPrice>2476.5</ns2:HeaderCurrencyUnitPrice>
<ns2:PercentOfComparisonElement>0.9906</ns2:PercentOfComparisonElement>
<ns2:PriceElementCode>QP_MARGIN</ns2:PriceElementCode>
<ns2:PriceElementUsageCode xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:nil="true"/>
<ns2:PricingSourceId xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:nil="true"/>
<ns2:PricingSourceTypeCode xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:nil="true"/>
<ns2:ReferenceOrderChargeCompId xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:nil="true"/>
<ns2:RollupFlag>false</ns2:RollupFlag>
<ns2:SequenceNumber>1017</ns2:SequenceNumber>
<ns2:SourceChargeComponentId>300100171226045</ns2:SourceChargeComponentId>
<ns2:SourceChargeId>300100171226040</ns2:SourceChargeId>
<ns2:SourceParentChargeCompId xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:nil="true"/>
</ns2:FulfillLineOrderChargeComponentSDOTR>
</ns2:FulfillLineOrderChargeSDOTR>
</ns1:FLine>
</ns1:FulfillmentRequest>
</soap:Body>
</soap:Envelope>
Related Topics
• Manage Pricing Charge Definitions
• Create Your Own Task Type
600
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
This topic provides a summary of the set up. This integration is similar to the integration that you create with
transportation management or trade compliance. Here are some topics where you can get more details.
601
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
screening for you. For details about orchestration processes, see the Setting Up Orchestration Processes
topic.
602
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
◦ If you don't use DOO_SubmitSalesOrderProcess, then add steps that call the DOO_TradeCompliance task
type to some other predefined orchestration process or one that you create.
603
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
It isn't necessary to use steps 100 and 200. You can place these steps anywhere in the sequence of steps.
But you must request screening first, and then wait.
3. Route the request.
604
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Note.
For details about how to add a connector, see topic Manage Connector Details Between Order
Management and Your Fulfillment System.
◦ Create a routing rule that routes sales orders that you send to Global Trade Management according to the
DOO_TradeCompliance task type.
◦ Use Visual Information Builder to create a routing rule.
Here's your logic if you use Oracle Business Rules instead of Visual Information Builder.
For details about how to create a routing rule, see the Overview of Using Business Rules With Order
Management topic.
605
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
2. Click Connections, search for Oracle ERP Cloud, then click Select.
<secure_protocol>://<host>:<secure_port>/fndAppCoreServices/ServiceCatalogService?WSDL
5. Enter the URL for the ERP Event Catalog. For example.
<Protocol>://<host>:<port>/soa-infra
6. Enter the user name and password that you use to sign into Order Management as the administrator.
606
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
607
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
http://<server:port>/GC3Services/TransmissionService/call?wsdl
5. Enter the user name and password that you use to access the WSDL.
608
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
If it doesn't, you might encounter an error, during setup or in your runtime environment. The error will be
something that starts with.
For details about privileges, see the Job Roles and Duty Roles That You Use to Implement Order Management
topic.
6. Test and save the connection. You should see this page.
609
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Attribute Value
Type BusinessEvent
Attribute Value
Type Delayed
Operation processAcknowledgement
3. Search for the GTMfromOM connection you created earlier, then drag and drop it onto the target. The target is
on right side of the integration.
4. In the dialog that displays, enter details.
Attribute Value
610
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
611
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
For example.
Note.
◦ See the Attributes in Request Payloads That Integrate Order Management topic to get a list of the
attributes that you can map.
612
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Use this example payload as a guide to help determine the mapping that you need to create. Global Trade
Management sends this payload as a response to the call from Order Management.
<?xml version="1.0"?>
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:typ="http://
xmlns.oracle.com/apps/scm/doo/taskLayer/commonService/types/" xmlns:com="http://xmlns.oracle.com/apps/
scm/doo/taskLayer/commonService/" xmlns:mod="http://xmlns.oracle.com/apps/scm/doo/processOrder/model/">
<soapenv:Body>
<typ:processFulfillmentResponse>
<typ:responseMessageHeader>
<com:IntegrationContextCode>DOO_TradeCompliance</com:IntegrationContextCode>
<com:FulfillmentSystemResponseIdentifier/>
</typ:responseMessageHeader>
<typ:fulfillLineList>
<com:OrderNumber/>
<com:FulfillLineIdentifier>300100175497843</com:FulfillLineIdentifier>
<com:TradeComplianceScreeningResultCode>ORA_PASSED</com:TradeComplianceScreeningResultCode>
<com:TradeComplianceScreeningDate>2018-11-23T12:12:12</com:TradeComplianceScreeningDate>
<com:FulfillmentDetail>
<com:TradeComplianceTypeCode>ORA_SANCTIONED_TERR</com:TradeComplianceTypeCode>
<com:TradeControlCode/>
<com:TradeComplianceComments/>
<com:TradeComplianceScreeningResultCode>ORA_PASSED</com:TradeComplianceScreeningResultCode>
</com:FulfillmentDetail>
<com:FulfillmentDetail>
<com:TradeComplianceTypeCode>ORA_RESTRICTED_PARTY</com:TradeComplianceTypeCode>
<com:TradeControlCode/>
<com:TradeComplianceComments/>
<com:TradeComplianceScreeningResultCode>ORA_PASSED</com:TradeComplianceScreeningResultCode>
</com:FulfillmentDetail>
<com:FulfillmentDetail>
<com:TradeComplianceTypeCode>ORA_TRADE_CONTROL</com:TradeComplianceTypeCode>
<com:TradeControlCode/>
<com:TradeComplianceComments/>
<com:TradeComplianceScreeningResultCode>ORA_PASSED</com:TradeComplianceScreeningResultCode>
</com:FulfillmentDetail>
</typ:fulfillLineList>
</typ:processFulfillmentResponse>
</soapenv:Body>
</soapenv:Envelope>
Note.
• TaskInstanceId
• SourceTransactionSystemCode
• RequestStatusCode with a value of SUCCESS
◦ The integration uses this return mapping only when it calls processAcknowledgement, and only when
Global Trade Management sends a successful response.
613
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
For example.
On the menu at the top right of the edit integration page, click Tracking, drag a payload field from the Source,
and drop it onto the Tracking Field section.
Integration Cloud Service uses business identifiers to track messages at run time. You can use them to help
identify and monitor instances of the integration.
614
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
For example.
The screen print is hard to read and displays only part of the hierarchy. Here's the Source hierarchy that it
displays.
onEvent
getOrderRequestFulfillmentDetails
result
SourceTransactionIdentifier
SourceTransactionSystemIdentifier
TargetSystemName
TargetSystemCode
TargetSystemIdentifier
615
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
FusionSystemName
FusionSystemCode
FusionSystemIdentifier
SourceTransactionNumber
BuyingPartyIdentifier
BuyingPartyName
BuyingPartyNumber
Related Topics
• Orchestration Processes
• Overview of Setting Up Trade Compliance
• Job Roles and Duty Roles That You Use to Implement Order Management
616
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Here's how the flow from Order Management to Global Trade Management works.
1. Submit an order through an orchestration process that includes the GTM step.
2. The orchestration process reaches the create step, then raises a GTM event. Integration Cloud Service
subscribes to the event.
3. The flow creates a new instance of Integration Cloud Service. The instance calls the mapping that maps output
from OrderFulfillmentRequestService to the input to Global Trade Management, then calls the service in Global
Trade Management.
617
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
4. The flow successfully establishes the integration, then calls the processAcknowledgement operation of
service OrderFulfillmentResponseService. processAcknowledgement changes the fulfillment line status to
DOO_GTM_AWAIT.
Here's how the flow from Order Management to Global Trade Management works.
618
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Lookup Description
• Failed
• Under Review
• Passed
Each response from trade compliance screening contains the screening result for the
fulfillment line and details for each screening type for the fulfillment detail. It stores these
details in the TradeComplianceScreeningResultCode attribute.
• Restricted Party
• Sanctioned Country or Territory
• Trade Control
Each fulfillment detail in the response corresponds to a screening type that the
TradeComplianceTypeCode attribute specifies in the fulfillment detail.
ORA_DOO_TRADE_CONTROL_CODE Contains values for the TradeControlCode attribute in the fulfillment detail.
Cross-References
Overview of Creating Cross-References in Order Management
Create and maintain cross-references that relate data between your source system, fulfillment system, and Order
Management Cloud.
Each cross-reference helps manage data across systems. For example, your source system might use the value Net
30 Days for a payment term while your billing system uses 30 Days. Use a cross-reference in Order Management to
standardize how you represent the payment term.
Interaction Description
Receive a source order from your The web service that receives the source order uses a cross-reference in the Order
source system. Orchestration and Planning repository to resolve the imported value to a common value in
Oracle Fusion.
619
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Interaction Description
If a cross-reference doesn't exist between your source system and the common value, then the
order fails with an error when you submit it to fulfillment.
Send a request to your fulfillment Order Management cross-references values from the common value to the source system
system. value.
If it can't find the source system value in the Order Orchestration and Planning repository, in
Trading Community Architecture, or Product Information Management, then fulfillment goes
into error.
620
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
For example, assume your source system sends a record that includes an identifier value of O-524.
The web service uses the Original System Unique Reference (OSR) to map customer details from the source system to
the registry ID in the customer registry in Trading Community Architecture.
1. Load the record from the source system into the customer registry.
2. Assign a registry ID of P242 to the record in the registry.
3. Create a cross-reference between Original System Unique Reference O-524, and registry ID P242.
4. Use registry ID P242 as the relationship to Original System Unique Reference M-42 from the fulfillment system.
P242 is the common value that ties the source system to the order fulfillment system.
621
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Use the Source System Product Reference attribute when you cross-reference item data.
622
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
• Continuous collection. Collect data incrementally. It provides fast collection for each entity that Order
Management must source.
• Targeted collection. Refresh data for a single business object. You run a scheduled process that does targeted
collection, as needed or on a schedule.
For details, see the Collect Planning Data for Order Management topic.
Related Topics
• How Order Management Transforms Source Orders Into Sales Orders
• How the Order Orchestration and Order Promising Processes Use the Collected Planning Data
• Import Customer Data for Your Sales Orders
• Overview of Collecting Promising Data for Order Management
623
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
This topic includes example values. You might use different values, depending on your business requirements.
624
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
For details about how to create cross-references, including using the Manage Item Relationships page, see Document
ID 1309859.1 (Oracle Fusion Product Information Management - Understanding Item Cross References), on My Oracle
Support.
1. Sign in with a role, such as PRODUCT_MANAGER, that you can use to access the Product Information
Management work area.
2. Create a lookup.
• Charge Master
• Old Item Number
• Supplier Part Number
• Golden Tax Adaptor
You can use these predefined values, or create a new one. For this example, you create a new one.
◦ In the Lookup Codes area, click Actions > New, set values, then click Save and Close.
Attribute Value
The value you enter must match the value you import from the source system. Product
Information Management uses this value when it receives data from your source
system, such as in a web service payload, to complete the cross-reference.
Description Item relationship type to use when cross-referencing to an old item name in a legacy
source system.
625
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Attribute Value
Item AS54888
1. On the Manage Item Relationships page, set Item Relationship Type to Spoke System Items.
2. In the Create Spoke System Item Relationship dialog, set values.
Attribute Value
Assume you already set up this spoke system in Oracle Product Hub.
Product Information Management creates a cross-reference between item AS54888 in Product Information
Management and item AS54000 Desktop Computer in Oracle Product Hub.
626
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Related Topics
• Overview of Using Business Rules With Order Management
• If the task type is FulfillOrder, and if Organization is 204, then use Oracle Fusion values that identify customer
data to resolve cross-references to the fulfillment system.
627
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
628
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Attribute Value
Description Route fulfillment requests without using a customer attribute that resides in the fulfillment
system as a cross-reference.
Value Description
Related Topics
• Download Files
629
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Global Reference more than one instance of an entity that resides in more than one source system.
Data Collection collects each entity into the Order Orchestration and Planning repository,
validates it, then consolidates all the entities it collects into a single record that represents all
entity instances across all systems. This single record is the global entity.
Source Don't represent the same data in more than one source system. The instances of source data
are distinct. For example, one source system might consider Warehouse as an organization
while another source system uses some other classification.
Data Collection collects the transactions that are related to supply and demand so Global Order Promising can do
planning and promising. It collects transactions into the Order Orchestration and Planning Repository. You set up the
source system so Order Management can store details that identify the source of records and manage collection. The
repository uses these details so it can identify the source system where records originate.
630
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Related Topics
• How the Order Orchestration and Order Promising Processes Use the Collected Planning Data
• Data Collection Sequence
eBusiness Suite
Overview of Integrating Order Management with eBusiness Suite
If you own an application that's part of Oracle E-Business Suite, Enterprise Resource Planning (Oracle EBS ERP), and plan
to migrate to Order Management Cloud in phases, then you can integrate Order Management with E-Business Suite and
continue to use E-Business Suite to do some of the order fulfillment.
You deploy a connector that sits between Order Management and the Integrated SOA Gateway in E-Business Suite.
Use it to send sales orders and communicate status updates between Order Management and E-Business Suite. This
connector uses a SOA (service-oriented architecture) and BPEL (Business Process Execution Language) composite that
you can use to deploy to a SOA server.
• Set up Order Management to send sales orders to eBusiness Suite so eBusiness Suite can fulfill the sales order,
including shipment and invoice.
• Set up eBusiness Suite to send status updates to Order Management. If customer details don't already exist in
eBusiness Suite, then this integration synchronizes them when eBusiness Suite receives the sales order.
These integration flows use a connector that you deploy on the SOA server. They also use services from Order
Management and the Integrated SOA Gateway in eBusiness Suite. The gateway is part of Oracle eBusiness Suite, release
12.1 and higher. It includes.
• Integration Repository. Use public APIs (application program interface) in eBusiness Suite that create and
deploy the integration as a web service. Use this integration to send sales orders from Order Management to
eBusiness Suite, and to use the Process Order API in eBusiness Suite as a SOA (service-oriented architecture)
web service.
In general, this document describes APIs that use PL (Procedural Language) or SQL (Structured Query
Language).
• Service Invocation Framework (SIF). Use the business events that eBusiness Suite raises, and use event
details to call a web service. This integration uses the Service Invocation Framework in Integrated SOA Gateway
to send status update from eBusiness Suite to Order Management. Order Management uses a web service to
process the status update response that the Service Invocation Framework calls.
631
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Oracle provides this connector and example integration only for testing purposes. Oracle doesn't support this connector
or example integration in a production environment.
• Order Management, see the How Order-to-Cash Works in Order Management topic.
• Integrated SOA Gateway, go to https://docs.oracle.com/cd/E18727-01/doc.121/e12169/toc.htm, Oracle E-
Business Suite Integrated SOA Gateway Implementation Guide. See sections Administering Native Services,
Implementing Service Invocation Framework, and Creating and Using Integration Interfaces.
Feature Description
Synchronize sales orders. Synchronize entities when you create a sales order in eBusiness Suite.
• Customers
• Addresses
• Contacts
Create new sales orders. Create sales orders that include different types of items.
• Items
• Ship sets
• Pick-to-order configured item
• Assemble-to-order configured item
• Kits
• Return Material Authorization (RMA)
Synchronize status updates. Synchronize order status updates and sales order splits. Here's what you can synchronize.
• Order Line status, including Awaiting Shipping, Shipped, Fulfilled, Awaiting Return, and
Returned
• Scheduled Ship Date
• Scheduled Arrival Date
• Warehouse
• Shipping Method
• Line Split
632
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
◦ Sales credit
◦ Attachment
◦ Shipping charge
◦ Tax
◦ Lot serial number
Requirement Description
• Order Management allows a return order to reference the original order so it can identify
the sales order you're returning.
• Order Management sends only the configured item that eBusiness Suite uses for
returns. It doesn't send the order lines that the configured item references.
Synchronization You must synchronize item data before you use this integration.
Bill of Materials The BOM (bill of materials) structure for each kit, pick-to-order, and assemble-to-order must
be identical in Oracle Fusion Product Master and in eBusiness Suite.
Customer details If you modify customer details in Order Management, then this integration doesn't synchronize
these details directly from the customer master in Order Management to the customer master
in eBusiness Suite.
633
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Requirement Description
This integration synchronizes these details only if it uses the customer or address during
ordering, and it only synchronizes the addresses and contacts that the sales order references.
Deployment Options
Use this integration with Order Management, the on-premise version of eBusiness Suite, and with connectors deployed
on SOA Cloud Service (PAAS).
634
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Note.
1. You create a sales order in the Order Management work area.
2. Order Management uses routing rules that you set up to determine how to route the sales order to eBusiness
Suite, including the connector it will use to do routing.
3. Order Management uses a connector that you set up on the Manage Connector Details page to identify the
location of the connector on the SOA server. For this example, assume you named the server My_SOA_Server.
4. Order Management uses the Fulfillment Task Layer business service to transform the sales order to a message,
and then send it to DooFulfillOrderEBSConnector on My_SOA_Server.
635
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
5. The SOA server transforms the message, uses the set up you make in Integrated SOA Gateway on eBusiness
Suite to call a web service on the gateway, and then send the message to eBusiness Suite.
6. eBusiness Suite processes the message as a sales order.
For example, if eBusiness Suite schedules the sales order for shipping, or if eBusiness Suite changes scheduled
ship date or scheduled arrival date because some other attribute that influences scheduling changes, then
eBusiness Suite raises a business event, and then uses the event to send these dates to Order Management. It
also sends the warehouse and ship method.
eBusiness Suite uses the set up you do on business events in eBusiness Suite to communicate status changes.
You enable the business event, subscribe to it so eBusiness Suite knows when to raise it, and specify the web
service to use when communicating with My_SOA_Server.
7. eBusiness Suite uses your set up for the web service and business event in Integrated SOA Gateway to send the
update to the connector on My_SOA_Server.
8. The connector on My_SOA_Server server sends status updates to Order Management.
9. Order Management updates sales order attributes in the Order Management work area.
Order Management also uses this flow for a status update or order line split. Other flows use a similar sequence.
636
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Note.
1. The Fulfillment Task Layer service in Order Management uses DooEBSConnectorService to call the
fulfillOrderEBSRequest operation of DooFulfillOrderEBSConnector on My_SOA_Server.
637
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Operation fulfillOrderEBSRequest
The Fulfillment Task Layer service in Order Management manages the create flow, update flow, and hold flow.
2. Fulfillment Task Layer uses security that you set up in Oracle Enterprise Manager and WebLogic Console on
My_SOA_Server. The user and password you use in Enterprise Manager must match the user and password you
use on the Manage Connector Details page.
For details about Oracle Enterprise Manager, see https://www.oracle.com/technetwork/oem/enterprise-
manager/overview/index.html.
3. My_SOA_Server uses the set up you do in Enterprise Manager and WebLogic Console to call the Sales Order
Service in Integrated SOA Gateway on eBusiness Suite. The user and password you use in Enterprise Manager
must match the user and password you use in eBusiness Suite.
4. An event occurs in eBusiness Suite that requires communication with Order Management, such as an update to
the sales order status.
5. Sales Order Service in eBusiness Suite calls the fulfillOrderEBSInboundRequest operation on
DooFulfillOrderEBSConnector.
Operation fulfillOrderEBSInboundRequest
eBusiness Suite uses the security you set up in Enterprise Manager on My_SOA_Server for the eBusiness Suite
user that calls DooFulfillOrderEBSConnector.
638
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Attribute Value
Connector URL Enter the URL that locates the connector. For example.
https://server.port/8002/soa-infra/services/default/
DooFulfillOrderEbsComposite
User Name and Password Enter any user name and password. It isn't necessary to enter a user name and password
that you already set up.
Order Management uses this name and password when it calls the connector on the SOA
server.
For details, see the Connect Order Management to Fulfillment Systems topic.
639
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
For details about how to use the rules editor, see the Manage Routing Rules topic.
1. Open the Manage External Interface Routing Rules for Sales Orders page.
For details, see the Overview of Using Business Rules With Order Management topic.
2. On the Manage External Interface Routing Rules page, click Create New Rule, then set values.
640
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Attribute Value
Attribute Value
Attribute Value
Priority Highest
641
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Do it.
1. On the Manage External Interface Routing Rules page, click Create New Rule, then set values.
Attribute Value
642
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Attribute Value
Description Route sales orders that don't include a configured item from Order Management to
eBusiness Suite.
Attribute Value
Attribute Value
Priority Medium
643
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Attribute Value
644
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Attribute Value
Description Route sales orders that include a configured item from Order Management to eBusiness
Suite.
Attribute Value
Attribute Value
Priority Medium
• Create Order
• Create Return Order
• Create Return Order for Models
645
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Create a routing rule that supports return orders that include a configured item.
1. On the Manage External Interface Routing Rules page, click Create New Rule, then set values.
Attribute Value
Description Route return orders that include a configured item from Order Management to eBusiness
Suite.
Tip: Click New Condition, then, in the Create Condition dialog, enter Category, wait for the list to display
values, then click Category Code (Order Fulfill Line).
3. In the Do area, create a statement for the attribute.
Attribute Value
Note: Click New Action > Set a Value. In the Create Action dialog, set the top value to Fulfillment Instance
ID, then, below is set to, click Attribute, then enter Category. Using this technique displays attributes that
are already defined, and helps to make sure you choose an attribute that the rule can use.
646
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Attribute Value
Priority Medium
647
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
6. Verify that you set the Route Sales Orders to eBusiness Suite rule to the highest priority, and that you activated
each of your rules.
1. Set up connector.
648
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Set Up Connector
Set up the connector on the SOA server. For this example, assume the server is named My_SOA_Server.
To get a copy of this file, click Download Files in the Related Links section at the end of this topic.
2. Unzip DooFulfillOrderEBSConnectorRev1.0.zip.
3. Use an XML editor to open DooFulfillOrderEBSComposite_cfgplan.xml.
4. Modify the responsibility.
</property>
<property name="bpel.preference.responsibility">
<replace>EBS responsibility</replace>
</property>
where
For example.
</property>
<property name="bpel.preference.responsibility">
<replace>ORDER_MGMT_SUPER_USER</replace>
</property>
Reference Value
<replace>http://server:port/soa-infra/services/default/
DooTaskFulfillOrderResponseInterfaceComposite/fulfillmentresponse?wsdl</replace>
649
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
For example.
650
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Attribute Value
Key FUSION_APPS_FOM_CON_APPID-KEY
Type Password
User name and Password Use the same user name and password that the connector uses to call the Fulfillment Task
Layer service in Order Management.
Attribute Value
Key FUSION_APPS_FOM_EBS_APPID-KEY
Type Password
User name and Password ◦ Use the user name and password that the connector must use to call the Process
Order service in eBusiness Suite.
◦ You must create grants when you create and deploy Process Order.
◦ You must use the same user name for FUSION_APPS_CON_EBS_APPID-KEY that
you use for the grants. For details, see topic Set up Gateway and Business Events in
eBusiness Suite: Procedure.
Administer Security
Administer security for the Order Management user and the eBusiness Suite user that will call the connector.
651
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
For example.
Related Topics
• Download Files
652
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
• Oracle E-Business Suite Integrated SOA Gateway Developer's Guide, Release 12.2, Part Number E20927-10.
• Installing Oracle E-Business Suite Integrated SOA Gateway, Release 12.1.3 (Doc ID 556540.1).
653
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
For example.
6. In the Procedures and Functions area, add a check mark to the Select option for the row that includes these
values.
If a global grant exists for all users, then it might not be necessary to create an individual grant.
8. Set the value.
654
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Attribute Value
9. Click Deploy.
10. Click View WSDL, then note the URL that the WSDL (Web Service Definition Language) uses.
You use this URL when you set up the connector on the SOA server. Make sure this URL is similar to the
following URL.
http://server:port/wEBServices/SOAProvider/plsql/oe_inbound_int/?wsdl
where
◦ server:port identifies the address of the server that hosts the web service.
11. Repeat steps 1 through 10 to create and deploy another service.
Attribute Value
1. In eBusiness Suite, expand the Workflow Administrator Web Applications responsibility, then click
Administrator Workflow.
2. Click Business Events.
3. On the Business Events tab, in the Search area, in the Display Name attribute, enter the value.
oracle.apps.ont.genesis.outbound.update
655
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
For example.
4. Click Go.
656
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Attribute Value
3. Click GO.
4. Wait for the result to display, then click Select.
For example, click Select in the row that contains these values.
Attribute Value
5. In the Update Event Subscriptions area, set values, then click Next.
Attribute Value
Phase 100
Status Enabled
657
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
6. Notice that step 1 of the task-based user interface displays. This interface guides you through the set up.
7. On the Load WSDL step, enter the URL that locates the WSDL of the connector, then click Next.
Attribute Value
8. On the Select Service step, set the value, then click Next.
Attribute Value
9. On the Select Service Port step, make sure the Select option is enabled for the service.
FulfillOrderEbsProcess_pt http://server:port/soa-infra/services/default/DooFulfillOrderEbsComposite/
DooEbsConnectorInboundService_ep
658
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
13. On the Subscription Documentation step, set values, then click Apply.
Attribute Value
This Java rule function is part of the eBusiness Suite patch. It allows the connector to use the
status update flow.
Attribute Value
WFBES_SOAP_USERNAME Enter the user name of the service that you're calling. For example.
OPERATIONS
ONT
operationsKey
2. Store the password so its secure. Sign into the database that resides on the eBusiness Suite server, then use
SQL to query the Order Management database.
For example.
659
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Related Topics
• Use SQL to Query Order Management Data
Details Description
• Bill To Account
Customer details
• Ship To Account
• Bill To Address
• Ship To Address
• Contacts
• Items, including simple items or complex items, such as kits or pick-to-order configured
Order Lines items.
• Prices. This integration sets the CALCULATE_PRICE_FLAG attribute to P when it
synchronizes the sales order so eBusiness Suite doesn't recalculate prices on the order
line. This setting primarily affects freight charges.
• Ship Set.
• Requested Ship Date.
• Payment Terms.
Scheduling Details If you use Global Order Promising (GOP), then Order Management sends these details.
660
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Synchronize Sales Order Status Between Order Management and eBusiness Suite
This integration synchronizes statuses between eBusiness Suite and Order Management while it processes the sales
order through fulfillment.
This integration synchronizes customer details from Order Management to eBusiness Suite when it creates or updates a
sales order.
• Parties or Accounts
• Addresses
• Contacts
If the customer, address, or contact for a new customer doesn't exist in eBusiness Suite, then eBusiness Suite creates
them.
In Order Management, attribute Sold To and attribute Ship To are each a party, and attribute Bill To is an account.
However, each of these attributes is an account in eBusiness Suite. To solve this problem for Ship To and Bill To, Order
Management sends an address when it sends the Ship To customer or Bill To customer to eBusiness Suite. eBusiness
Suite uses the combination of address and customer details to identify the account it must use.
The Sold To attribute doesn't include an address, so the integration determines the account differently depending on
the condition.
Condition Result
Order Management sends a party eBusiness Suite creates the party and the customer account.
name that doesn't exist in eBusiness
Suite.
Order Management sends a party eBusiness Suite creates an error and exits the flow.
name, but more than one party in
eBusiness Suite matches the name
that Order Management sends.
661
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Condition Result
Order Management sends a party eBusiness Suite creates a new customer account for the party.
name that exists in eBusiness Suite,
but eBusiness Suite doesn't contain a
customer account for this party.
Order Management sends a party eBusiness Suite uses the party and customer account that Order Management sends.
name that exists in eBusiness Suite,
and eBusiness Suite contains one
customer account for this party.
This integration supports configured items that use pick-to-order and assemble-to-order.
Here's the sequence this integration uses to create a sales order for a configured item that uses pick-to-order.
1. Order Management sends the entire configured item to eBusiness Suite. The status for the configured item and
each configure option is Awaiting Fulfillment.
2. eBusiness Suite triggers events that communicate shipping statuses for Awaiting Shipping and Shipped.
eBusiness Suite triggers the events only for shippable lines.
3. eBusiness Suite sends events to Order Management while it ships each line.
4. Order Management updates the shippable lines. These lines are in the Shipped status while the remaining lines,
such as Model or Option Class, are in the Awaiting Fulfillment status.
5. eBusiness Suite finishes shipping each order line, the flow moves to the Fulfillment activity, then this step
marks each line as Fulfilled. To allow this step to occur, you must enable the Fulfilled status.
6. eBusiness Suite creates an event for the Fulfilled status for each order line.
7. Order Management updates each status and marks each order line of the configured item as Fulfilled.
Create Sales Orders for Configured Items That Use Assemble-to-Order
Here's the sequence this integration uses to create a sales order for a configured item that uses assemble-to-order. Note
that eBusiness Suite stores an assemble-to-order configured item as a separate line.
1. Order Management sends the configured item to eBusiness Suite.
2. eBusiness Suite creates the configured item in eBusiness Suite.
3. eBusiness Suite creates an event for the order lines that the configured item references while it fulfills the
assemble-to-order.
4. eBusiness Suite synchronizes each status to Order Management in the same way it synchronizes for a pick-to-
order configured item, except Order Management stores each configured item as an attribute while eBusiness
662
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Suite stores each configured item as an order line. So, this integration doesn't synchronize status updates for
these order lines from eBusiness Suite to Order Management.
5. Order Management updates the status for the configured item, configure options, and items in the same way it
updates them for a pick-to-order configured item.
6. eBusiness Suite eventually closes each order line, then creates a status change event. The connector ignores
the Closed status. This integration marks each line in Order Management as Closed when the process finishes
all steps.
If the Fulfillment Task Layer is the last step in the process, then the integration marks each order line as Closed
when the Fulfillment Task Layer task finishes.
Map Status When Creating Sales Order for Configured Item
This integration maps statuses between Order Management and eBusiness Suite when it creates a sales order for a
configured item the same way it maps statuses for an item that isn't configured. For details, see the Mapping Statuses
When Creating Sales Order for Items section.
This integration supports revisions to a sales order, such as revising an attribute on the order header. Here's the
sequence it uses to revise a sales order.
1. Order Management sends a request to eBusiness Suite to place each order line on hold. If eBusiness Suite.
◦ Rejects the hold request. This integration sends an exception message to Order Management and ends
this sequence.
◦ Successfully places the hold. Order Management sends a change request to eBusiness Suite.
2. eBusiness Suite processes the change, then this integration releases the hold on the order lines.
Note.
• If the change management flow starts, then this integration releases any hold that already existed on the sales
order in eBusiness Suite.
• Change management applies the hold at the start of processing and releases it when the change finishes.
• eBusiness Suite can't distinguish whether change management or a user applied the hold. eBusiness Suite only
applies one hold when Order Management sends a hold request. If this integration releases a hold as a result of
change management, then eBusiness Suite releases the hold in Order Management.
• eBusiness Suite doesn't automatically release a change management hold. Instead, it applies the release hold
request that it receives during the change management flow.
663
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
• An end-user splits the order line. For example, to meet a customer requirement to receive part of the sales
order.
• The on-hand inventory is less than the ordered quantity and eBusiness Suite ships only part of the quantity,
then a split might occur when confirming the shipment.
Here's the sequence that this integration uses when the user splits an order line.
Here's the sequence that this integration uses when eBusiness Suite ships only part of an order line.
This integration supports only a proportional split when splitting a configured item. For example.
• Assume a configured item includes a quantity of 5, and configure option x of the configured item includes a
quantity of 10.
• Assume you split the configured item into a quantity of 2 for configured item b and a quantity 3 for configured
item c.
• A proportional split will split option x into a quantity of 4 for item b and 6 for item c.
To support this flow, you must set up a process that includes Step Level Line Criteria to send only the configured item
for a return. For details, see the Integrate Order Management with eBusiness Suite topic.
Here's the sequence that this integration uses when eBusiness Suite splits a configured item.
1. eBusiness Suite splits a configured item, creates a split event, then sends it to Order Management.
2. The connector processes the event and Order Management splits the configured item.
If the split references a partial shipment, then Order Management sets the status for each shippable line to
Shipped for the part of the configured item that eBusiness Suite shipped, and sets the status for the entire
configured item to Awaiting Fulfillment.
3. Order Management sets the status of the part of the configured item that it created for the remaining quantity,
and the order lines that this part of the configured item references, to Awaiting Fulfillment.
664
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
4. eBusiness Suite sets the status of the shippable lines to Shipped and the status of the configured item to
Awaiting Fulfillment when it ships the rest of the configured item.
5. The flow in eBusiness Suite reaches the Fulfillment activity, and then creates another event that sets the status
to Fulfilled. Lines for each configure option and nonshippable lines remain in the Awaiting Fulfillment status
until the eBusiness Suite flow reaches this step.
6. Order Management processes the event and sets the status of the order lines that the configured item
references to Fulfilled.
Note.
• If an assemble-to-order split occurs in eBusiness Suite, then the connector ignores the configured item.
• If one of your users splits an order line in eBusiness Suite, then the order line in Order Management remains in
status Awaiting Fulfillment. eBusiness Suite sets the status of the shippable lines to Shipped when it ships each
line, and it leaves the nonshippable order lines in status Awaiting Fulfillment.
This integration doesn't synchronize status Closed in eBusiness Suite with the status in Order Management. It
ignores status Closed from eBusiness Suite. Instead, it sets the status of the order lines in Order Management
to Closed when the process finishes all steps.
This integration can send a return material authorization (RMA) to eBusiness Suite for receiving. eBusiness Suite fulfills
it, then sends the Return statuses to Order Management.
Return an Item
Here's the sequence that this integration uses to return a configured item.
1. Order Management sends the configured item and a reference to the original eBusiness Suite configured item
to eBusiness Suite. The return lines in Order Management are in status Awaiting Fulfillment.
2. eBusiness Suite expands the order lines in the return configured item according to the order lines that the
original configured item references. The configured item in eBusiness Suite isn't in status Returned because
eBusiness Suite doesn't receive the configured item.
3. The integration creates the return material authorization and sets the status of the configured item to Awaiting
Fulfillment.
4. One of your users or an automated process returns the order lines that the configured item references in
eBusiness Suite.
5. eBusiness Suite sends the updated statuses to Order Management.
6. Order Management updates the status to Received, then Fulfilled, then Closed.
Process a Hold
665
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Here's the sequence that this integration uses to process a hold that one of your users creates.
1. One of your users creates a hold in Order Management.
2. Order Management sends the hold to eBusiness Suite.
This integration can send only one hold at a time from Order Management to eBusiness Suite because it can't
send the Hold Name to eBusiness Suite.
3. eBusiness Suite applies only the DOO O2C Change Management Hold to the sales order in eBusiness
Suite. eBusiness Suite ignores any subsequent hold that Order Management sends. Note that DOO is an
abbreviation for distributed order orchestration, which is an earlier version of Order Management, and O2C is
an abbreviation for Order To Cash.
4. Your user releases the hold in Order Management.
5. Order Management sends the release to eBusiness Suite.
6. eBusiness Suite releases DOO O2C Change Management Hold.
Process a Hold That Change Management Creates
Here's the sequence that this integration uses to process a hold that change management creates.
1. Change management revises a sales order in Order Management.
2. Change management creates a hold in Order Management.
3. Order Management sends the hold to eBusiness Suite to stop eBusiness Suite from processing the sales order.
4. eBusiness Suite attempts to hold the sales order. If successful, then eBusiness Suite sends a reply to Order
Management that it successfully placed the hold.
If eBusiness Suite can't hold the sales order, then it sends a reply to Order Management that the hold failed, and
Order Management doesn't allow the change. For example, if eBusiness Suite already scheduled the sales order
for shipping, it might not be able to change it.
5. If eBusiness Suite successfully places the hold, then Order Management makes the change, releases the hold,
then sends the release to eBusiness Suite.
6. eBusiness Suite releases the hold.
eBusiness Suite can't determine whether one of your users created the hold or change management created
the hold, so eBusiness Suite releases all holds for this sales order.
Schedule a Sales Order
Here's the sequence that this integration uses to process a sales order that Order Management schedules.
1. Order Management schedules the sales order, sets values for the Scheduled Ship Date and Scheduled Arrival
Date, then sends these attributes to eBusiness Suite.
2. eBusiness Suite sends these attributes to eBusiness Suite Shipping.
eBusiness Suite can't and doesn't reschedule these order lines.
Process a Sales Order That eBusiness Suite Schedules
Here's the sequence that this integration uses to process a sales order that eBusiness Suite schedules.
1. Order Management doesn't schedule the sales order, and it sends the Scheduled Ship Date and Scheduled
Arrival Date to eBusiness Suite with empty values.
2. eBusiness Suite schedules the order lines, then uses the Schedule Ship Date Change event to send schedule
details to Order Management. The order line status in Order Management remains at Awaiting Shipping.
Using Global Order Promising
666
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Global Order Promising uses attributes from the sales order to schedule the sales order.
• Schedule Ship Date
• Schedule Arrival Date
• Ship From Warehouse
• Shipping Method
Order Management Order Management sends attributes to eBusiness Suite, and eBusiness Suite doesn't
reschedule the sales order.
eBusiness Suite eBusiness Suite sends attributes to Order Management, and Order Management doesn't
reschedule the sales order.
Here's the sequence that this integration uses to split a return material authorization.
1. One of your users does a partial receipt, not a delivery, in eBusiness Suite.
2. eBusiness Suite receives the partial order line.
3. The eBusiness Suite user does a deliver transaction.
4. eBusiness Suite splits the order line for the return material authorization into two order lines, and then sets the
status of the received line to Returned and the status of the new line to Awaiting Return.
5. eBusiness Suite sends the split event to Order Management.
6. Order Management splits the order line into two order lines, and then sets the status of the received line to
Received and the status of the new line to Awaiting Fulfillment.
Split Return Material Authorization for a Configured Item
667
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Order Management doesn't support splitting a return material authorization that includes a configured item. It
processes status updates only for the configured item, and not for individual order lines that the configured item
references. Instead, here's the sequence that this integration uses.
1. Order Management waits for eBusiness Suite to fulfill the entire configured item.
2. eBusiness Suite fulfills the entire configured item, then sends an update to Order Management.
3. Order Management sets the status for the configured item to Fulfilled.
For example, if the ordered quantity is 10, and if the quantity returned is 5, then Order Management sets the
status for 5 of the order lines in the configured item to Awaiting Return, and will process the configured item
only after it receives the remaining 5 lines.
Map Status When Splitting a Return Material Authorization
Here are the statuses that this integration maps between Order Management and eBusiness Suite when it splits a return
material authorization.
Drop Ship
Overview
Overview of Drop Ship in Order Management
Drop ship is a supply chain management technique where the seller relies on a supplier or contract manufacturer to
build, store, and ship an item to your customer. You can use Order Management Cloud to automate this process.
668
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Note.
• Assume your customer places a sales order with you and you want to drop ship it.
• Order Management sends a purchase request to Oracle Procurement Cloud, which places a purchase order with
your supplier, then your supplier ships directly to your customer.
• You provide a purchase order for the item and instructions that describe how to ship directly to the customer.
• The supplier or contract manufacturer ships the item, and your company earns a profit.
For a more detailed flow, including screen prints of various applications you use in the flow, see Order to Cash - Drop
Ship Order Flow (Doc ID 2278649.1) on My Oracle Support.
669
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Note.
• You can drop ship a standard item, configured item, kit, configuration model, pick-to-order item, or assemble-
to-order item.
• You can't drop ship a subscription or coverage item.
• Your customer can return a drop ship order only to your warehouse. Your customer can't return a drop ship
order directly to the supplier. When you receive the item in the warehouse, use the Return Receipts action in
Inventory Management so Inventory Management can deplete the received quantity.
• You can't use a third party application in your drop ship flow.
Related Topics
• Schedule Fulfillment Lines Manually
670
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Note.
1. An order capture system captures a source order.
◦ Each horizontal row in the diagram represents a system or application.
◦ The drop ship flow is a variation of the order-to-cash flow.
◦Order Management comes predefined to capture sales orders in the Order Management work area. You
can also capture source orders in an order capture system that resides outside of Order Management.
2. Order Management assigns an orchestration process to the sales order, uses the Schedule Order task to start
scheduling the sales order, then sends a scheduling request to Global Order Promising.
671
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
3. Global Order Promising considers sourcing rules, supplier calendar, capacity, and so on to identify the supplier
and supplier site that can fulfill the order in the most efficient way. If the sales order specifies a supplier, then
Global Order Promising uses this supplier.
4. The orchestration process gets the requisition organization from Supply Chain Financial Orchestration so it can
create a purchase request.
5. Order Management sends a purchase request to Oracle Procurement.
Note.
◦ Procurement doesn't use the Product Category or Product Fiscal Classification to create a purchase order.
◦ Order Management doesn't set a default value for the Product Category attribute on the order line. The
Order Entry Specialist can specify this value when setting tax determinants, but Order Management
doesn't send it to Procurement, so the purchase order doesn't contain a value for Product Category. For
details, see the Edit Tax on Order Lines topic.
◦ Order Management sets a default value for the Product Fiscal Classification in the sales order. The
purchase order in Procurement also has a Product Fiscal Classification attribute and Procurement sets it
to the same value that's on the sales order, but it isn't required.
672
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
6. Procurement creates a purchase requisition, approves the requisition, creates a purchase order, then sends the
purchase order to the supplier.
Note.
Customer Sales Order attribute in Number attribute on the sales order in the Order Management work area
the Purchase Requisitions work area
673
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
◦ Order Management sets the order line status when Procurement creates the requisition and the purchase
order.
• Receiving can send an advance shipment notice to Order Management after the
status goes to Awaiting Shipping.
• Receiving can create an advance shipment notice for the entire quantity or for
only part of the quantity.
◦ If a blanket purchase agreement exists, then Procurement might source the requisition from the
agreement.
◦ Procurement sends responses to Order Management while the purchase order moves through its
lifecycle.
7. The supplier examines the purchase order and uses your shipping fulfillment system to ship the item to the
customer. The enterprise supplier also communicates with the receiving part of Inventory Management to cost
the shipment.
674
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
8. The supplier uses a supplier portal to enter an ASN. Order Management sends the notice to interested parties
and Financial Orchestration. For details about the supplier portal, see the Supplier Portal topic.
9. The receiving part of Inventory Management creates a logical receipt in the receiving organization. It doesn't
create a physical receipt because the supplier ships the item directly to your customer.
10. Financial Orchestration runs a financial flow that comes predefined to handle drop ships, and that specifies
how to handle the flow that runs from the supplier to the customer.
11. Cost Management does receipt accounting and cost accounting.
12. Order Management waits to receive the advance shipment notice from receiving. The notice indicates that the
item shipped and that the customer acknowledged receipt.
13. Order Management communicates with Oracle Receivables to create an invoice and process payments.
You can modify some of these steps. For example, use Manage Sourcing Rules to modify how Global Order Promising
considers sourcing rules, or use Manage Drop Ship Financial Flows to modify how Supply Chain Financial Orchestration
sets up a relationship between the selling business unit and the requisition organization. For details, see the Set Up
Drop Ship in Order Management topic.
Related Topics
• How Order-to-Cash Works in Order Management
• How Order-to-Cash Works with Order Capture Systems
• Supplier Portal
Guidelines
Integrate with Procurement Cloud
Use guidelines to help you integrate with Procurement Cloud when you set up drop ship for Order Management.
For details about attachment categories and how to set them up, see the Overview of Integrating Attachments in Order
Management topic.
675
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Order Management updates the scheduled ship date, scheduled arrival date, and shipping method only if you set up
Global Order Promising to calculate shipping, such as how to calculate transit time. If you don't set it up, the scheduled
dates and shipping method might not contain a value.
This behavior affects fulfillment, including choices that your users make when they override the schedule. For details,
see the Schedule Fulfillment Lines Manually topic.
Here's an example payload that sends an extensible flexfield named ComplianceDetails to Procurement Cloud.
676
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Note.
• Use web service Request Fulfill Order Orchestration Task Service to send your payload. For details, see the
Overview of Using Extensible Flexfields in Order Management topic.
• Set up profile options in Procurement Cloud.
◦ Copy the requisition for the purchase order to a descriptive flexfield.
◦ Copy the requisition line for the purchase order to a descriptive flexfield.
◦ Copy the order header for the purchase order to a descriptive flexfield.
Related Topics
• Processing Constraints
• Overview of Integrating Attachments in Order Management
• Schedule Fulfillment Lines Manually
• Overview of Using Extensible Flexfields in Order Management
• Use Order Profiles to Control Order Management Behavior
Set Up Features
Each feature comes predefined as already available except for Fulfill a Customer Order Through Drop Shipment and
Handle Landed Cost Charges for Drop Ship Receipts. Each feature includes a predefined job role.
677
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Manage Change
The aggregator aggregates change requests for each combination of sales order and its related purchase order. If
the Order Entry Specialist modifies a fulfillment line during a drop ship, then the aggregator sends each combination
as a single request to Procurement Cloud. The aggregator sends these details when a time limit expires or when it
aggregates a specific number of lines. For details, see these topics.
If a sales order has a large number of order lines, then the aggregator only aggregates some of the changed lines
according to a time limit. This behavior might cause the sales order to become stuck in Order Management because an
error occurs during the change or the buyer in Procurement Cloud makes a change at the same time while the purchase
order isn't on hold.
To avoid this problem in a drop ship flow, you can enable the Aggregate According to Number of Order Lines That
Changed profile option, starting with Release 20C. If you enable the option, then the aggregator aggregates according
678
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
to the number of order lines that have changed in the current revision of the sales order. For details, see the Use Order
Profiles to Control the Order Management Work Area topic.
Constraint Description
Constraint. Prevents the Order Entry Specialist from updating or canceling the fulfillment line when the
purchase request in Procurement Cloud is at the Purchase Order stage. For example, if the user
• Display Name: Update attempts to update, then a message displays.
Fulfillment Line That Drop
Ships
Order management can't update the fulfillment line because the purchase
• Constraint Name: request in the procurement application is at the Purchase Order stage.
DOO_DS_FULFILLMENT_LINE_UPDATE
Order Management applies these constraints until the received quantity or invoiced quantity
Constraint. equals the quantity on the order line.
If you must allow your users to cancel a fulfillment line that's at the Awaiting Shipping status in
a drop shipment, and if DOO_DS_FULFILLMENT_LINE_CANCEL is enabled, then tell your users
to cancel the purchase order, wait until Order Management receives the updated status for the
purchase order, revise the sales order, cancel the order line, and submit the revision.
Display Name: Update Fulfillment Prevents the Order Entry Specialist from canceling a fulfillment line for the drop ship when any
Line When Purchase Order Isn't of these conditions exist.
Available
• The purchase order for the line is locked or is on hold.
• The quantity received or the quantity billed doesn't equal the quantity shipped.
Constraint Name:
DOO_FULFILLMENTLINE_DROPSHIP_PO_RECEIVED_UPDATE
If the quantity that Order Management shipped doesn't match the quantity that Procurement
Cloud received or billed, then you can't change the value for.
Order Management prevents these change at run time on order lines that it has shipped and
on lines that it hasn't shipped.
679
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Constraint Description
You can change the value of an attribute that isn't eligible for a constraint regardless of
whether its mapped between Order Management and Procurement Cloud.
Display Name: Cancel Fulfillment Line Prevents the Order Entry Specialist from canceling a fulfillment line for the drop ship when any
When Purchase Order Isn't Available of these conditions exist.
Constraint. If the Scheduled Arrival Date attribute on the fulfillment line is empty, and if its a drop
shipment, then this constraint makes sure.
• Display Name: Create Purchase
Request Validation • The Requested Arrival Date or the Scheduled Arrival Date on the fulfillment line contains
• Constraint Name: a value.
DOO_CREATE_PURCHASE_REQUEST_VALIDATION
• The ordered quantity on the fulfillment line is greater than zero.
• The Record Set contains the values that the Update Purchase Request fulfillment task
requires.
Constraint.
• Display Name: Update If you Don't Use Global Order Promising, and if you.
Purchase Request Validation
• Constraint Name: • Enable the buyer to manage transportation for the supplier agreement, then Order
DOO_UPDATE_PURCHASE_REQUEST_VALIDATION
Management requires the ship date.
• Don't enable the buyer to manage transportation for the supplier agreement, then Order
Management requires the arrival date.
Order Management makes sure the required date contains a value when you submit the sales
order.
Constraint Name: Prevents the Order Entry Specialist from modifying an extensible flexfield on the fulfillment
DOO_UPDATE_EFF_FULFILLMENTLINE_DROPSHIP
line when the line is at the requisition stage in Procurement Cloud.
If you disable these constraints to meet your business requirements, then you must create your own constraints that
prevent Order Management from accepting a sales order revision that Procurement Cloud rejects. For example, create a
constraint that implements this logic.
• If the supplier can fulfill the change when it occurs two days or more before the ship date, then reject the
change only if it occurs within two days before the ship date.
680
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
4. Drag attributes from the Subject Areas tree and drop them onto the Selected Columns area.
For details, see the Create Your Own Report section in the Use Reports and Analytics with Order Management topic.
Reject an Over-Receipt
If the quantity on the advance shipment notice (ASN) exceeds the ordered quantity, then Oracle Fusion Receiving will
reject the fulfillment request and display a message requesting the user to modify the quantity regardless of how you
set the Over-Receipt Action attribute on the Manage Receiving Parameters page in the Setup and Maintenance work
area. If receiving rejects the request, you must correct the quantity on the ASN or in receiving.
For details about this attribute, see the General Receiving Parameter Options topic.
You can use File-Based Data Import to upload the time zones for your supplier sites. You can also specify them in the
Global Order Promising work area. If you don't upload or specify them, then Promising uses UTC (Coordinated Universal
Time).
Do Other Setups
Here are some other set ups you might need to do, depending on your drop ship requirements.
• Create a separate requisition and purchase order for each order line.
• To improve performance, aggregate fulfillment lines before you send them to Procurement Cloud. For details,
see the Actions You Can Set When Routing Requests to Fulfillment Systems topic.
• If you use a source system as part of your drop ship flow, then you might need to specify a Drop Ship Validation
Organization. You can also set up transit times, and a drop ship plan. For details, see the Drop Shipments in
Supply Planning topic.
• Set up a promising rule. For details, see these topics.
◦ Set Up Promising Rules and Sourcing Rules for Order Management
◦ Refresh the Order Promising Server for Order Management
Related Topics
• Processing Constraints
• Overview of Integrating Attachments in Order Management
• Overview of Using Extensible Flexfields in Order Management
• Use Order Profiles to Control Order Management Behavior
• Time Zone Differences in Order Management
681
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Note.
• Specify a value in the Supplier attribute to implicitly start the drop ship flow.
• Manually set Supplier and Supplier Site attributes on the sales order, or create a sourcing rule that does it
automatically.
Use REST API, file-based data import, or a web service to create the order.
682
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Different technologies use different attribute names to represent the same data.
Technology Description
• As an option, set the Order Type attribute to Drop Ship Orders on the order header.
Sales order in the Order Management
work area
683
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Technology Description
• Set the Supplier attribute and Supplier Site attribute on the Supply tab of the order line.
If you don't specify a value for supplier site, then Procurement Cloud sets it according to
rules in Procurement Cloud.
Sourcing rule in the Order Promising Use the Manage Sourcing Rules page in the Order Promising work area. Set the attributes.
work area
• Supplier
• Supplier Site
REST API Use the salesOrdersforOrderHub REST resource. In the request payload, provide.
• SupplierId
• SupplierName (optional)
• SupplierSiteId
• SupplierSiteName (optional)
• TransactionType or TransactionTypeCode
For example.
{
"SourceTransactionNumber":"87956",
"SourceTransactionSystem":"GPR",
"SourceTransactionId":"87956",
"BusinessUnitName":"Vision Operations",
"BuyingPartyName":"Computer Service and Rentals",
"BuyingPartyContactName":"Brian Smith",
"TransactionType":"Standard Orders",
"RequestedShipDate":"2019-10-19T20:49:12+00:00",
.
.
.
"SupplierId" : 11176859,
"SupplierName" : "Green Bytes Inc.",
"SupplierSiteId" : 76846573869,
"SupplierSiteName" : "Denver Distribution Center"
"TransactionType" : "Dropship Orders"
"TransactionTypeCode" : "STD_DS"
.
.
.
}
684
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Technology Description
For example.
<ns2:Order>
.
.
.
<ns2:TransactionType>Dropship Orders</ns2:TransactionType>
.
.
.
<ns2:Line>
.
.
.
<ns2:RequestedSupplierName>Green Bytes Inc.</
ns2:RequestedSupplierName>
<ns2:SupplierSiteCode>76846573869</ns2:SupplierSiteCode>
.
.
.
Note.
• If you don't specify the supplier and supplier site in a sourcing rule, then you must include the Schedule Ship
Date on the order line in the payload or FBDI template.
• To verify the values you must use for TransactionType or TransactionTypeCode, in the Navigator,
click Setup and Maintenance, open the Manage Order Lookups task, then search for lookup type
ORA_DOO_ORDER_TYPES. Use a value from the.
◦ Meaning column for the TransactionType attribute.
◦ Lookup Code column for the TransactionTypeCode attribute.
Modification Description
• If your sales order includes a configured item or a shipment set, and if your supplier
Ship a configured item, pick-to-order, already shipped some order lines but other lines are awaiting shipment, then you can
or shipment set cancel only the lines that the supplier hasn't shipped.
685
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Modification Description
• Don't revise the purchase order in Procurement Cloud even if you intend to cancel the
purchase order schedule.
• Don't change a configured item, pick-to-order item, or shipment set in Procurement
Cloud.
• Don't use a shipment set to group sales order lines into a single purchase order.
Procurement Cloud doesn't support shipment sets for this usage.
Assign supplier Don't assign a new supplier on the requisition, then split the schedule on the draft purchase
order.
Change on-hand flow to drop ship If you scheduled a sales order line so your warehouse fulfills it, and you want to change the
flow order to a drop ship.
Removing a value from the warehouse and adding a value to the supplier and supplier site
creates a drop ship flow. The flow needs the date so it can create the requisition.
Cancel order line If the order line is in Requisition Created status, then you can cancel it in the Order
Management work area, but you can't make any other changes.
Remove a hold If Order Management applies a hold on a sales order, then Procurement Cloud also applies
a hold on the corresponding purchase order. However, a buyer can use the Purchase Orders
work area to remove the hold.
Specify behavior to calculate dates You can modify the Use Global Order Promising to Recalculate Dates in Order Management
that involve a purchase order order profile. For details, see the Use Order Profiles to Control Order Management Behavior
topic.
Change other attributes The buyer can change values in attributes that don't affect the drop ship flow.
Here's what you can and can't do regarding combining and splitting.
686
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Modification Description
You can't make any other revisions on the purchase order in Procurement Cloud.
Split the schedule The buyer can split the schedule, but don't split the schedule and also change the quantity or
supplier at the same time.
Combine sales orders into one If the flow creates one purchase order for requisition lines that reference more than one sales
purchase order order, and if you revise these sales orders, then the flow places a hold on one of the sales
orders and revises the purchase order. It doesn't revise the other sales orders and they fail.
To fix this problem, go to the Order Management work area, delete the sales order revisions
that failed, wait for Order Management to finish processing the sales order it placed on hold,
then revise the other sales orders.
You can only combine sales orders for the same customer or for the same supplier site. You
can't consolidate sales orders across customers or across supplier sites.
Combine sales order lines into Manually combine sales order lines into one or more purchase orders. You can create one
purchase orders purchase order for each order line, resulting in several purchase orders for one sales order.
687
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Modification Description
Modify the quantity If you split the purchase order schedule across more than one delivery date, then make sure
the total quantity across your split schedules equals the ordered quantity on the fulfillment
line.
If shipping has received the ASN, then you can't modify the quantity.
Set the quantity for advance Make sure you use a single order line to specify the quantity for an advance shipment notice.
shipment notice Don't split the quantity across more than one line.
Modify the receipt quantity The drop ship flow creates a receipt when it receives an invoice from accounts payable or an
advance shipment notice. The flow then moves to the next orchestration process step in Order
Management. Order Management won't display a subsequent change you make to the receipt
quantity.
Related Topics
• Processing Constraints
• Overview of Integrating Attachments in Order Management
• Schedule Fulfillment Lines Manually
• Overview of Using Extensible Flexfields in Order Management
• Use Order Profiles to Control Order Management Behavior
Procedures
Set Up Drop Ship in Order Management
Set up Order Management so it supports your drop ship flow.
Summary of the Set Up
1. Set up Oracle Applications.
2. Enable features.
3. Manage items.
4. Manage sourcing rules.
5. Manage financial flows. For details, see the Set Up Financial Flows for Drop Ship topic.
6. Specify preparer for procurement.
7. Manage suppliers and supplier sites.
8. Manage agreements.
9. Manage orchestration processes.
10. Manage agreements, orchestration processes, and test.
Note.
• Each of these set ups are required except for Manage Agreements and Manage Orchestration Processes, which
are optional.
• In this example, you enable the AS54888 Sentinel Desktop Computer for drop ship.
• This topic includes example values. You might use different values, depending on your business requirements.
688
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Here are the tasks you do to get started with setting up drop ship.
1. Define Blanket Agreement and ASL in Procurement. Sign in with a privilege that you can use to set up
Procurement.
2. Create Drop-Ship Validation Org in Inventory Management. Sign in with a privilege that you can use to set up
Inventory Management.
3. Do tasks in Global Order Promising.
◦ Sign in with a privilege that you can use to set up Global Order Promising.
◦ Manage Data Collections.
◦ Define Item Processing Lead Times.
◦Manage Sourcing Rules and Manage ATP Rules. Set up sourcing rules and ATP rules so they support
drop ship. For details, see the How Order Promising Rules Work Together topic.
4. Do tasks in the Manufacturing and Supply Chain Materials Management offering.
For details, see the Implementing Common Features for Oracle SCM Cloud topic.
Enable Features
1. Implement the Order Management offering.
For details, see the Implement chapter in the Implementing Order Management book.
2. Sign into Order Management with administrative privileges.
3. In the Navigator, click Setup and Maintenance.
4. In the Setup and Maintenance work area, go to the Order Management offering.
5. Click Actions > Change Feature Selection.
6. On the Edit Features page, in the Drop Ship row, add a check mark to Enable, then click Done.
Enabling this feature lets you access various attributes and to do the setup tasks you need to implement drop
ship, such as in Financial Orchestration.
7. Click Actions > Go to Offerings.
8. In the Setup and Maintenance work area, go to the Procurement offering.
9. Click Actions > Change Feature Selection.
10. On the Edit Features page, in the Customer Sales Order Fulfillment row, add a check mark to Enable, then click
Done.
This feature allows Oracle Procurement to accept purchase requests for sales orders that a drop ship supplier
fulfills, and to display some of the attributes that you use to set up drop ship.
689
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Manage Items
Set up items so they can participate in drop ship.
1. Sign in with a privilege that you can use to set up Product Information Management.
2. In the Navigator, click Product Information Management.
3. On the Overview page, click Tasks > Manage Items.
4. On the Manage Items page, search for the item you want to drop ship, such as Sentinel Desktop Computer.
5. In the search results, in the Item column for the item you must manage, click the link .
For example, in the Sentinel Desktop Computer row, click AS54888.
6. On the Edit Item page, click Specifications, then click Purchasing.
7. In the Item Organization: Purchasing area, set the attribute.
Attribute Description
8. If a blanket purchase agreement doesn't exist for the item, then, in the Pricing area, enter a number in the List
Price attribute.
9. Click Save.
Note.
◦ You specify the item as purchasable in the organization that's responsible for purchasing the item.
◦ The Product Information Management work area comes predefined to set the Purchasable attribute to
Yes, so you modify it only if you previously set it No.
◦ For details about how to make a large number of items purchasable, see the Implementing Product
Management book.
Attribute Description
Organization Assignment Type Make sure the type is Global. If it isn't Global, then you can't use this sourcing rule.
7. In the Effective Start Date area, to add a sourcing rule for your drop ship flow, click Actions > Add, then set
values.
690
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Attribute Description
Organization Leave empty. The Organization is typically the warehouse that stores inventory for a flow
that doesn't include a drop ship.
Type Choose Buy From. Global Order Promising interprets Buy From to indicate that this value
must come from a drop ship supplier.
Supplier Choose the supplier who will drop ship the item.
Supplier Site Choose the site that the supplier uses to store the drop ship item. The supplier ships the item
from this site.
Attribute Description
Assignment Level Set to Item. This setting assigns the sourcing rule to the item.
Item Choose the item that the supplier you specified in step 6 supplies. For this example, choose
AS54888.
Sourcing Type Set to Sourcing Rule. This value associates the sourcing rule with the assignment set so
Order Management can use the rule to assign the item.
Sourcing Hierarchy
Click Sourcing Hierarchy on the Edit Assignment Set page to see how Promising decides to assign the sourcing rule.
Here's the hierarchy that it uses for a drop shipment.
Rank Description
2 Item, Customer
691
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Rank Description
4 Item, Region
6 Category, Customer
8 Item
9 Category, Region
10 Category
12 Customer
13 Demand Class
14 Region
15 Global
1 is the highest ranking, and 15 is the lowest ranking. Promising assigns from 1 through 15, sequentially.
• Promising assigns the sourcing rule to the item's customer or customer site.
• If Promising can't assign the sourcing rule to the item's customer or customer site, then it assigns the rule to the
item's customer.
• If Promising can't assign the sourcing rule to the item's customer, then it assigns the rule to the item's demand
class.
• And so on.
Attribute Description
692
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Attribute Description
• The calendar you specify can be different from the calendar that the Supplier Site uses.
• Global Order Promising considers only working days when it calculates and incorporates
lead times.
Supplier Capacity Specify the supplier capacity according to item, supplier, and supplier site. Order Promising
measures the supplier capacity that exists on the arrival date.
Supplier Lead Times You specify and collect the lead times for item processing on the item master in Oracle Fusion
Product Model. You can specify a lead time for each supplier in Global Order Promising.
Attribute Value
693
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
This option specifies that the supplier site fulfills a purchasing role for the client business unit.
9. Click Site Assignments, then set the value.
Attribute Value
Client BU Choose the client business unit that will requisition and process invoices for the supplier site.
Oracle Fusion Purchasing allows your buyer to create a blanket purchase agreement for items it will drop ship from the
supplier. You must define an agreement for each supplier and supplier site, and associate one or more items with the
agreement. You do this work when you set up purchasing.
This topic describes how to modify the setup so it supports drop ship. Purchasing uses the prices that the agreement
specifies to set default values in the purchase documents. For details, see Blanket Purchase Agreement Lines topic.
You manage agreements differently for a drop ship that includes a configured item. For details, see the Set Up Drop
Ship for Configured Items topic.
Manage agreements.
1. Sign in with a privilege that lets you access the Purchasing work area.
2. In the Navigator, click Purchasing.
3. Click Tasks > Manage Agreements.
4. On the Manage Agreements page, choose a value in the Procurement BU attribute, such as Vision Operations,
then click Search.
5. In the search results, in a row that includes an agreement with a supplier who will drop ship your item, in the
Agreement column, click the link.
6. On the Agreement page, click Actions > Edit.
7. On the Edit Document page, click Controls, then set values.
Attribute Description
◦ Contains a check mark. Purchasing will automatically convert each requisition that
it sources from the blanket purchase agreement. It will convert each requisition to a
purchase order.
◦ Doesn't contain a check mark. Your buyer must do the conversion manually in the
Purchasing work area.
694
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Attribute Description
◦ Buyer
◦ Supplier
◦ Supplier site
◦ Source agreement
Automatically Submit for Approval Make sure this option contains a check mark. If it doesn't, then Order Management will
create the order with an incomplete status, and the buyer must manually submit it for
approval.
◦ Contains a check mark. Purchasing will group requisition lines that reference the
same sales order number. It will group them on a single purchase order.
◦ Doesn't contain a check mark. Purchasing won't group.
Use this orchestration process as the default process assignment in your Assign and Launch rule. You can also create
your own orchestration process that meets your business requirements. For details, see the Set Up Orchestration
Processes topic.
695
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
5. If necessary, make a copy of this process, then modify it so it meets your business requirements, or create a
new orchestration process and use DOO_OrderFulfillmentGenericProcess as a starting point.
Test Your Set Up
Related Topics
• How Order Promising Rules Work Together
• Supplier Sites and Supplier Site Assignments
You can specify more than one requisition business unit to manage and own more than one transaction that requests
the item. You can also specify the selling business unit in the legal entity that sells the item.
One The selling business unit and the requisition business unit are the same unit, and Financial
Orchestration uses only one financial flow for the drop ship.
More than one Financial Orchestration might run through more than one business unit that involves
procurement financial flows and shipment financial flows.
Set it Up
1. Sign in with Order Administrator privileges.
2. In the Navigator, click Setup and Maintenance.
696
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Attribute Description
Priority 1
Attribute Description
Supplier Ownership Change Event Specify when to start the ownership change.
◦ ASN From Supplier. Change ownership when the supplier sends an advance
shipment notice (ASN) to the financial flow for the drop ship order.
◦ AP Invoice Match. Change ownership when the supplier sends an invoice to the
financial flow for the drop ship order.
For details, see the Indicate an Ownership Change During Drop Ship topic.
7. In the Selling BU to Receiving BU Relationships area, click Actions > Add Row, then specify the relationship.
For details, see the Specify Business Units for Drop Ship Flows topic.
8. Repeat these steps for each selling business unit that your enterprise contains.
9. Click Save and Close.
Related Topics
• Financial Orchestration Flows
697
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Note.
698
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
The Create Drop Ship Financial Flow page sets the Receiving BU attribute and the Receiving Legal Entity attribute
according to the value you set in the Receiving Trade Organization attribute.
Assume you set Receiving Trade Organization to Vision Operations, and you set up the application to create a
requisition in the Vision Operations inventory organization for each sales order you drop ship that Vision Operations
creates. Here are the attributes that will contain a value of Vision Operations.
• Selling BU
• Selling Legal Entity
• Receiving Trade Organization
• Receiving BU
• Receiving Legal Entity
• Requisition BU
Order Management Cloud gets the value for the Requisition Organization attribute and the Requisition BU attribute
from the purchase requisition it creates for each drop ship order that involves a supplier, and that requires a requisition
organization.
Set the Selling Business Unit and the Receiving Business Unit
Use Financial Orchestration to set up and run the financial flow according to the ownership transfer that occurs between
the parties that are involved in the drop ship flow. Set up the relationship that exists between the selling business unit
and the receiving business unit. Financial Orchestration uses this relationship when it creates a purchase requisition for
the drop ship.
If you set the value for the Selling BU attribute to a value that's different from the value in the Receiving BU attribute,
then Financial Orchestration determines whether it must do more financial and accounting transactions according to
the procurement and shipping flows.
699
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
If a procurement financial flow exists in Financial Orchestration, and if Financial Orchestration can use it for the
purchase order that the drop ship references, then Financial Orchestration uses the procurement financial flow when it
orchestrates the drop ship.
For example, assume you must create a requisition that references the China inventory organization for each Metal
item, and create a requisition that references the United States inventory organization for each Plastic item. Here's your
set up.
Flow 1 Resides in China as the receiving trade Use Metal as the item category.
organization.
Flow 2 Resides in the United States as the Use Plastic as the item category.
receiving trade organization.
700
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
You use the Supplier Ownership Change Event attribute on the Manage Drop Ship Financial Flows page to specify when
to change ownership.
701
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
3. Order Management starts the downstream processes that cost and bill the shipment, including creating the
drop ship receipt, starting the billing process, and starting the financial orchestration process for the drop ship
order.
4. Receiving sends status and event details to Financial Orchestration and Order Management.
◦ Financial Orchestration processes the trade transactions in costing, processes the receivable invoices
between companies, processes payable invoices between companies, and so on.
◦ Order Management sends status and event details to billing and order orchestration.
The supplier can use actions on the supplier portal to create the advance shipment notice.
• Create ASN
• Create ASBN
• Upload ASN
• Upload ASBN
If the supplier uses an informal communication, such as email, to report the shipment of a purchase order that
references a drop shipment, then the warehouse manager can also use these features on the Receipts page in the
Warehouse Operations work area to manually enter the advance shipment notice. You can also upload an advance
shipment notice electronically through XML or EDI. For details, see these topics.
• Supplier Portal
• Overview of Creating ASNs and ASBNs
AP Invoice Match
What happens if the supplier doesn't send an advance shipment notice, but instead sends an invoice?
The receiving process works the same way it does for ASN From Supplier, except the process doesn't create an
advance shipment notice.
3. Order Management receives and delivers the drop shipment when it creates the accounts payable invoice for
the purchase order. Its the same purchase order that the drop ship references.
Scheduled processes automatically do the hard work for you.
Transfer Invoice Details to Supply Send details about validated invoices, canceled invoices, and corrected invoices to Financial
Chain Financial Flow Orchestration Orchestration.
Transfer Ownership Change Events to Send details about the AP invoice match from Financial Orchestration to the receiving process.
Receiving
Manage Receiving Transactions Receive and deliver a drop shipment in Oracle Fusion Receiving.
702
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
• Order Management never receives the event because there's a problem in the environment, such as a network
that's down, a server isn't available, and so on.
• Order Management receives several events in a short period of time. For example, shipping creates several
partial shipments and immediately sends an event for each one.
• Order Management receives an event while the sales order is in the Awaiting Shipping status, but Order
Management is currently revising the order. Order Management rejects the shipment update because the wait
step on the orchestration process isn't the current step. Receiving already raised the event and can't raise it
again until after Order Management finishes the change.
• Order Management receives an event while the sales order is in the Requisition Created status. In this example,
Order Management never received an update for the purchase order, but the purchase order proceeded and
shipping already created a shipping notice.
• Order Management receives an update for the advanced shipment notice but the sales order is in error
recovery.
• The value in the Change Sequence Number attribute on the fulfillment line of the sales order doesn't match the
Change Sequence Number on the purchase order.
In some situations, Order Management doesn't receive or can't use the event, the status on the sales order remains in
Awaiting Shipping, but the status on the purchase order is different depending on what fulfillment shipped.
Now, the status on the sales order isn't synchronized with the status on the purchase order. Order Management will
automatically attempt to fix the problem three times in approximately 15 minute intervals. Each attempt will try to
recover from errors in the advance shipment notice or from technical errors that occur in the environment when
processing the advance shipment notice.
If these retries fail, then you use the Recover Order action in the Order Management work area or the Recover Errors
scheduled process to recover sales orders that fail when you update the advance shipment notice in a drop ship flow.
Fix problems that happen when Order Management validates the advance shipment notice, such as the sales order and
purchase order aren't synchronized, purchase order details aren't available on the sales order, or attempting to process
the notice while someone is revising the sales order or when a change on the purchase order isn't finished.
Constraints
703
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Constraint Description
Update Fulfillment Line When Prevents the user from changing the Shipped Quantity in Order Management.
Purchase Order Isn't Available
• Makes sure the Shipped Quantity in Order Management matches the received quantity
and the billed quantity in Procurement.
• Makes sure the Ordered Quantity in Order Management matches the received quantity
and the billed quantity in Procurement.
For details, see the Guidelines for Setting Up and Using Drop Ship topic.
Cancel Fulfillment Line When For details, see the Guidelines for Setting Up and Using Drop Ship topic.
Purchase Order Isn't Available
Here are some fixes you can try if you encounter an error even when these constraints are enabled.
Trouble Shoot
The request to revise the sales order Wait a few minutes so Order Management can finish processing the shipment details, then
fails because Order Management resubmit your changes.
hasn't finished processing shipment
details that receiving created for the
sales order.
The request to process details on the Use the Recover Order action in the Order Management work area to process the shipment
order line for an advance shipment details.
notice fails because someone is
currently revising the sales order in
order management. As an alternative, wait for the revision to finish, go to the Scheduled Processes work area, then
run the Recover Errors scheduled process to process the shipment details.
The request to process shipment Create an order revision, revise the quantity on the order line to the original ordered quantity,
details on the order line fails because then submit the sales order. Next, go to the Scheduled Processes work area, then run the
the ordered quantity on the sales Recover Errors scheduled process to process the shipment details.
order doesn't match the quantity on
the purchase order for the advance
shipment notice in Procurement.
The request wasn't successful Use the Oracle Enterprise Manager to recover from this problem.
because Order Management can't
unlock groups for the fulfillment lines.
704
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Trouble Shoot
Related Topics
• Supplier Portal
• Overview of Creating ASNs and ASBNs
Attribute Value
You must use this value for an assemble-to-order configuration model. For details, see
Supplier Agreement Creation: Points to Consider.
Supplier Select the supplier who will drop ship the configured item.
6. On the Edit Document page, in the Lines area, add at least one line, then click Submit.
Note.
• A hybrid configuration model is a type of configuration model that includes an assemble-to-order configuration
model as the child and a purchase-to-order configuration model as the parent.
Order Management Cloud uses one blanket purchase agreement to source the assemble-to-order options, and
a different blanket purchase agreement to source the purchase-to-order options. So, Order Management issues
separate purchase orders to the supplier.
• Use File-Based Data Import to import more than one agreement.
Related Topics
• How File-Based Data Import Works
705
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Attribute Value
Description Use this integration algorithm to send our custom data from Order Management Cloud to
Procurement Cloud.
5. In the Execute Condition area, click Add Condition > Default Action.
6. In the Edit Actions window, then enter this code.
706
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
As an option, add code that maps an attribute you add to the entity for your extensible flexfield in the service
mapping, or that you code as a string. For example.
PRCLine.NoteToBuyer = "We negotiated price with the supplier"
7. Click Save.
8. Test and publish. For details see the Set Up an Integration Algorithm topic.
Attribute Value
Entity FLinePackShip_EFF_Custom
Description Entity for an extensible flexfield that stores details on the fulfillment line. It describes the
price we negotiated.
7. Add attributes. In the Details area, click Actions > Add Row to add each attribute.
Attribute Type
FullfillLineId_Custom Long
ShippingCost_Custom Double
Price Decimal
NegotiatedByPreparerFlag Boolean
NoteToBuyer String
707
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
◦ Joined Entity
◦ Joined Entity Attribute
4. Click Actions > Add Row, set values, then click Save.
Attribute Value
Entity FLinePackShip_EFF_Custom
Attribute Value
6. In the FLinePackShip_EFF_Custom Details area, add new attributes, then click Save.
FulfillLineId_Custom FulfillLineId
708
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
ShippingCost_Custom _ ShippingCost
Attribute Value
This is the name of the algorithm you created earlier in this procedure.
◦ FLinePackShip_EFF_Custom
◦ Header
◦ FulfillLine
◦ PurchaseRequestConfig
◦ PurchaseRequestHeader
◦ PurchaseRequestLine
Note.
◦ You add these entities because they contain the attributes that the service will send in the payload that it
sends to Procurement.
709
Oracle SCM Cloud Chapter 3
Implementing Order Management Integrate
Attribute Alias
FulfillLineId_Custom FulfillLineId
◦ FulfillLineId
◦ NegotiatedByPreparerFlag
◦ NoteToBuyer
◦ Price
◦ Make sure the Read attribute and Write attribute contain a check mark for each attribute.
◦ Leave the other attributes empty.
Attribute Value
Related Topics
• Create a Sandbox So You Can Edit Service Mappings
710
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
4 Set Up Features
Approvals
Guidelines
Overview of Setting Up Approval
Set up Order Management Cloud to route each sales order for sales order approval.
Sales order approval is a process that includes one or more approvers who must approve a sales order before Order
Management sends it to order fulfillment. An approval rule determines whether to do approval. Here are some
examples.
Assume your company policy limits the discount you provide to your customer to 10%. Create a rule to implement the
policy.
If an Order Entry Specialist adds a 20% discount, then route the sales order to an Order Manager for approval.
Note.
• You can set it up to accept or reject the sales order according to a variety of approval rules, and on a variety of
sales order attributes.
• Use approval to streamline how you enforce a policy, such as to streamline communication between the Order
Entry Specialist and one or more approvers, and to improve the experience for people who enter and approve
the order.
• Approving the sales order before starting order fulfillment can reduce the number of sales orders that Order
Management must return to Draft status because they don't meet a fulfillment requirement for some reason,
which in turn reduces rework after fulfillment starts.
711
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
Approval includes at least one Order Entry Specialist and one or more approvers. Consider an example where you need
approval when the sales order total exceeds $10,000.
Note.
1. An Order Entry Specialist creates a sales order, and then clicks Submit.
712
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
2. If the Source Order System value that you set in the Start Approval Process for Sales Orders order management
parameter matches the source order system attribute of the sales order, and if Source Order System is Yes, and
if you create an approval rule.
◦ Then. Order Management sets the order status to Approval Pending and routes the sales order for
approval.
◦ Else. Order Management doesn't evaluate any approval rules, even if defined, and proceeds to step 5.
3. The rule you create on the Manage Order Approval Rules page routes the sales order through the approval
process, such as assign and route the sales order to an order manager.
4. The approver uses their Pending Notifications page or worklist to view and approve the approval request.
If the approver rejects the approval request, then Order Management sets the sales order status to Draft,
unlocks it, routes it back to the person who created the sales order, and displays a message on the Order page
that describes the rejection.
The person who creates the order can use the Approval Notes tab on the sales order to get approval details,
including suggested actions the approver entered in comments when rejecting the approval request. For
example.
◦ Split the sales order into two separate orders so the total amount of the sales order doesn't
exceed $10,000
5. Order Management sets the order status to Processing, then sends it to order fulfillment.
6. Order fulfillment fulfills the sales order.
Related Topics
• Get Approvals for Sales Orders
713
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
Create Condition
Specify the condition that determines when to do approval according to the value of an attribute.
• Choose from a wide range of attributes.
714
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
◦ Order total
◦ Order charge
◦ Price adjustment
◦ Validation
◦ Order type attribute on the order header
The Manage Order Approval Rules page filters the attributes you can use. Use the tree to choose the attribute, or, more
simply, enter it in the If statement. If you use the Tree, only use attributes under the Order Header branch. Don't use the
HierarchyPrincipal or Task branches.
715
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
• Assign to Individual. A dialog displays where you can choose the individual. It includes other options, such as
Information Only or Approval Required.
• Assign to Group. A different dialog displays where you can choose the group.
716
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
• Assign to Supervisors. A different dialog displays where you can specify the approval chain, first approver,
level of supervisors, highest approver, and so on.
717
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
The rule is
If Manual Adjustment Type is Discount Percent, and if Manual Adjustment Value is greater than 10, then assign
approval to Diane Cho.
Notes
• Order Management doesn't come with predefined approval rules because they're specific to your requirements.
If you need approval, then you must create an approval rule.
• Sign in with privilege fom_manage_order_approval_rules_priv.
• Approval evaluates each order line, one at a time, sequentially.
• If more than one rule applies for different order lines, then approval creates a separate approval flow for each
line that requires approval.
718
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
For example, if approval rule b applies to line 1, and approval rule c applies to line 2, then approval sends
approval request x for line 1 and request y for line 2. The approvers in request x might be different from the
approvers in request y, depending on how you set up your rules.
• You can set up a group of approvers. For example, get three separate approvals from user x, user y, and user z
for a single approval request. Use the Manage Approval Groups page in the Setup and Maintenance work area,
and assign the group in your rule. Approval will send notification to each user, sequentially. For example, it will
send notification to user, x, and then y, and then z.
Limitations
• Order Management approves only the entire sales order. It can't approve only an order line.
• You can't start approval according to order status. For example, you can't start approval depending Draft status
or Processing status. Approval automatically sets status to Approval Pending.
• You can't start an approval flow according to a change in an attribute value during order revision.
• You can't start an approval flow according to comparison between different versions of the sales order.
• Use an approval only before Order Management submits the sales order to order fulfillment. You can't do
approval during order fulfillment.
A sales order includes more than one total. For example, it includes the header total, total list price, total net price, total
tax, total credit, and so on. The header total is the primary total. In the price breakdown dialog, it displays on the Pay
Now row.
Assume you create an approval rule that filters only according to Order Total Amount is greater than 10,000. At
runtime, the rule will create a separate approval request for each order total that's greater than 10,000 although you
require only one approval request for the sales order.
To avoid this problem, add another condition that filters approval according to Primary equals Yes. This way, the rule
evaluates only the primary order total, ignores the other totals, and sends only one approval request.
719
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
For example.
Related Topics
• Overview of Using Business Rules With Order Management
• Manage Order Management Parameters
• More Setup for Workflow Email Notifications
720
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
Note.
• Go to the Setup and Maintenance work area, then open the task.
721
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
• On the BPM Worklist page, search for and edit task ApprovalHumantask. Don't edit the TaskApproval task
because its for supply orders, not sales orders. Don't edit ApproversTask. Its for another type of flow.
• Use the tabs to specify a range of behavior.
Tab Description
Make sure you only add users you have already set up in an Oracle Fusion Application.
• Use participant when you set up the worklist. Don't use other levels, such as position.
722
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
Set Up Notifications
Note.
• Use the Task Status list to specify when to send a notification when the approval status changes.
• Example statuses include Assign, Complete, Error, Request Info, Suspend, Withdraw, Resume, and so on.
• Specify who to send the notification to, such as Assignees, Initiator, Approvers, and so on.
• The initiator is the person who creates the sales order and requests approval. The task assignee is the person
who approves the request.
• The list comes predefined to send a notification to the task assignee when the flow changes the status to
Assign, and to send a notification to the initiator when the flow changes the status to Complete.
723
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
• You can change the status, add new statuses, and delete statuses. For example, an approver can Request
Information, Suspend, Withdraw, or Resume an approval request. You can send a notification each time the
approver takes one of these actions.
• As an option, add text to include in the notification header.
Note.
724
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
Attribute Value
Email "From" Display Name Specify text to include in the From line of the email message.
For details about setting up email, see the Overview of Setting Up Workflow Email Notifications
topic.
Group Notification Configuration Specify whether to send a separate email to each recipient or to send only one email to all
recipients.
Don't Send Multiple Notifications for Send only one approval request for each sales order.
the Same Human Task Event
Enable this attribute so approval sends only a single request for the entire order instead of
sending a separate request for each rule.
• Contains a check mark. Let the recipient take action directly in the notification.
• Doesn't contain a check mark. Don't let the recipient take action directly in the
notification.
725
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
Specify Access
Use the Access tab to specify who can see what, where.
Note.
• Access determines visibility of data, such as the history section and comment section of the approval request in
Order Management.
• Specify who, such as administrator, approver, assignee, creator, owner, or reviewer.
• Specify data, such as attachments, assignees, comments, dates, and history.
• Specify what the user can see, such as read attachments or read comments.
726
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
Use the Actions area of the Access tab to specify who can do what, where.
Note.
727
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
Attribute Description
Allow All Participants to Route Task to Allow a participant to send the approval request to another user.
Other Participants
Assume you're an approver and have a large backlog of approval requests. You need to
reassign the request to another approver. Enable this attribute so the approver can route the
approval to another participant.
Allow Participants to Edit Future Allow a participant in the approval flow to add another downstream participant.
Participants
Allow Initiator to Add Participants Allow the person who creates the sales order to add an approver or reviewer to the approval
request.
Mandate Comments Before Updating Make comments required and use them to establish an audit trail.
These Outcomes
Complete Parallel Subtasks Early Use a subtask to separate an approval request into different parts.
Complete Parent Tasks of Early Assume you work at company headquarters and receive a large order with a quantity of 1,000.
Completing Subtasks You are authorized to approve large quantities for the customer but you first must make sure
you can deliver the quantity by the delivery date. Create a subtask and approval will send a
request to someone in your warehouse or factory to verify they can meet the delivery deadline.
Related Topics
• Overview of Using Business Rules With Order Management
• Manage Order Management Parameters
• More Setup for Workflow Email Notifications
728
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
For example, assume your in house staff has authority to set discounts that exceed 10%, and they use the Order
Management work area to create sales orders. You also receive orders from a partner, but the partner isn't authorized to
provide these discounts.
729
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
Note.
For details, see the Integrate Order Management with Source Systems topic.
• Use the Manage Order Management Parameters page to add your source system to the Start Approval Process
for Sales Orders parameter.
• At run time, Order Management will do approval for each source order where the Source System attribute
equals Partner.
• In this example, the All source system and GPR source system are each No, so the rule runs only when the
source system is Partner.
If you set the Start Approval Process for Sales Orders attribute to No, then the flow doesn't do approval and
proceeds directly to fulfillment.
For example, if the hold occurs because of a licensing effective date, then the Order Manager can choose to
release the sales order to fulfillment, then manage the license problem at some later time.
Related Topics
• Overview of Using Business Rules With Order Management
• Manage Order Management Parameters
• More Setup for Workflow Email Notifications
Procedures
Set Up Approval Rules for Sales Orders
Set up an approval rule that routes a sales order to one or more approvers.
Assume you must create a routing rule.
• If the order total is greater than $10,000, and if the Primary is yes, and if the customer is Computer Service and
Rentals, then request and get approval from a manager.
730
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
731
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
2. Set the Start Approval Process for Sales Orders order management parameter to Yes for all source systems.
For details, see the Manage Order Management Parameters topic.
3. In the Navigator, click Setup and Maintenance.
4. In the Setup and Maintenance work area, go to the task.
◦ Offering: Order Management
◦ Functional Area: Orders
◦ Task: Manage Order Approval Rules
5. On the Manage Order Approval Rules page, click Create New Rule.
6. Change the rule name.
Field Value
Value 10000
732
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
Field Value
Attribute Primary
Condition Is equal to
Value Yes
4. Click Save.
Field Value
Attribute Customer
Condition Equals ( =)
4. Click Search.
5. In the Search dialog, in the Name attribute, enter Computer Service and Rentals, then click Search.
6. In the search results, click Computer Service and Rentals, then click OK.
7. In the Create Condition dialog, click OK.
Notice that the IF area now displays the condition.
8. Click Save.
Create the DO
1. Click THEN > DO.
2. Name the DO so it reflects the meaning of the action.
733
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
Field Value
6. Click Search.
7. In the Search dialog, next to Users, enter manager, then click Search.
8. In the Search for Highest Possible Approver dialog, in the manager row, click the radio button, then click OK.
9. Verify that Highest Possible Approver contains manager, then click OK.
Notice that the DO area now displays the condition.
◦ Assign to Job Level
10. Click Save and Close.
Attribute Value
Amount Add items to an order line so that the Amount exceeds $10,000.
734
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
2. Verify that Order Management updates the order status to Approval Pending.
3. Click View Approval Information, then verify the approval details reflect the approval rule you created.
4. In a separate browser session, sign into Order Management with the Order Manager job role.
5. Open the Pending Notifications page, locate the link for the approval request, such as Action Required:
Approval Request for Order 258093, then click Approve.
6. Navigate to the browser session for the Order Entry Specialist, refresh the page, then verify that the order status
is now Processing.
Related Topics
• Get Approvals for Sales Orders
• Manage Order Management Parameters
735
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
• Send a reminder to the approver one hour before the approval request expires.
• Include text in the From line of the email notification.
Order Entry Specialist Requests Your Approval
• Send only one email to all users who participate in the approval request. Don't send separate emails.
• Allow everyone to read attachments and comments, but don't allow reviewers to edit them.
• Allow the assignee and owner to send an information request, but allow only the assignee to approve it.
• Assume your company policy requires an audit trail, so make sure each approval and each rejection contains a
comment.
Attribute Value
Reviewers Li Yu
Attribute Value
736
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
Attribute Value
Day 1
The approval request will expire one day after approval sends the request to the approver.
Hour 0
Minutes 0
Set Up Notifications
1. Click Notifications.
Notice the Task Status list comes predefined with a separate row for three different statuses.
Assign Assignees
Complete Initiator
Error Owner
◦ In the assign row, in the Notification Header column, click the pencil.
◦ In the Edit Notification Message dialog, enter text, then click OK.
Please approve the request for this sales order.
The notification that approval sends to the approver will include this text.
3. Add a reminder.
Attribute Value
Repeat 1
Approval will send the reminder before the deadline that you set earlier in this
procedure expires.
737
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
Attribute Value
Frequency Day 0
Hour 4
Minutes 0
Approval will send the reminder four hours before the deadline expires. You set the
deadline at 1 day, so approval will send the reminder 20 hours after approval sends the
request to the approver.
Attribute Value
Approval will add your text to the From line of the email notification that it sends to the
approver.
You must enclose your text with double quotation marks (" ").
Group Notification Configuration Specify how to display the email message. You can.
Set Up Access
1. Click Access, then set values.
Task Content Individuals with Read Access Individuals with Write Access
Attachments Make sure each option contains a check Make sure only the Reviewers option
mark. doesn't contain a check mark.
Comments
◦ Admin
◦ Approvers
◦ Assignees
◦ Creator
738
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
Task Content Individuals with Read Access Individuals with Write Access
◦ Owner
◦ Reviewers
◦ Assignees
◦ Owners
Approve Make sure only the Assignees option contains a check mark.
Set Up Configuration
1. Click Configuration, then set values.
Attribute Value
Mandate Comments Before Make sure each option contains a check mark.
Updating These Outcomes
◦ Approve
◦ Reject
Related Topics
• Overview of Using Business Rules With Order Management
• Manage Order Management Parameters
• More Setup for Workflow Email Notifications
739
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
• Migration copies only the If condition of each rule. It doesn't copy the Then part of the rule. During testing, you
typically use the Then part to assign approval to a specific test user. However, you need to replace the test user
with an actual user in your production environment, so you need to redo the Then statement after you migrate.
• If even one rule contains an error, then migration fails and it won't migrate any rule.
This topic includes example values. You might use different values, depending on your business requirements.
Attribute Value
You can use any text. Tab out of the Name attribute after you enter the value to
populate other attributes.
◦ On the Select Offerings to Implement page, in the Order Management row, add a check mark to Include,
then click Save and Open Project.
◦ In the Task Lists and Tasks area, click Actions > Select and Add.
◦ In the Select and Add dialog, set Search to Task, search for Manage Order Approval Rules, then click
Apply > Done.
◦ On the Implementation Project page, click Done > Done.
3. Create the configuration package you will use to implement the project that you created in step 2.
◦ On the Setup page, click Tasks > Manage Configuration Packages.
◦ On the Manage Configuration Packages page, click Actions > Create.
◦ On the Create Configuration Package page, in the Source Implementation Project area, set values.
Attribute Value
◦ In the Configuration Package Details area, make a note of the value that displays, then click Next >
Submit.
740
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
Attribute Value
Attribute Value
◦ In the Download column, click Download, then click Download Configuration Package.
◦ Save the file to a location on your computer. Make a note of the location and the file name, such as
Project to Export Approval Rules_1_20180310_1805.zip.
◦ Click Done, then sign out of Order Management.
4. Import the rule dictionary that you downloaded in step 4.
◦ Sign into the Order Management instance where you must import the approval rules.
◦ In the Navigator, click Setup and Maintenance.
◦ On the Setup page, click Tasks > Manage Configuration Packages.
◦ On the Manage Configuration Packages page, click Upload, locate the file you downloaded in step 4, click
Get Details > Submit.
◦ In the Search Results area, click the row that includes the value.
Attribute Value
Attribute Value
Type Upload
741
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
◦ On the Import Setup Data page, in the Import Options area, note the value, then click Submit.
Attribute Value
◦ In the Search Results area, click the row that includes the value.
Attribute Value
Attribute Value
5. Navigate to the Manage Order Approval Rules page, then verify that your approval rules imported successfully.
Related Topics
• Get Approvals for Sales Orders
• Manage Order Management Parameters
Assume you need to get details for sales order 514517. To start, get the header ID.
select header_id from doo_headers_all where order_number='514517';
Assume the query returns a header ID value of 300100246104588. Next, get the task ID.
select taskid from FA_FUSION_SOAINFRA.WFTASK where identificationkey like '%300100246104588%';
Assume the query returns task ID cdfdb0b2-639d-4cc8-acce-df5031154d8f. Use the task ID to get approval details, such
as Approval Date, Comments, Approved By, and so on.
select WFCOMMENT from FA_FUSION_SOAINFRA.WFCOMMENTS; where taskid ='cdfdb0b2-639d-4cc8-acce-df5031154d8f'
select * from FA_FUSION_SOAINFRA.WFTASKHISTORY where roottaskid='cdfdb0b2-639d-4cc8-acce-df5031154d8f';
742
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
743
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
Related Topics
• Get Approvals for Sales Orders
• Manage Order Management Parameters
• Use SQL to Query Order Management Data
Credit
744
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
Credit Check
Overview of Setting Up Credit Check
Use credit check in Order Management to minimize the financial risk that your organization assumes during day-to-day
operations. Validate each sales order and verify your customer has credit available that's sufficient to cover the cost of
purchase.
For example.
745
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
Order Management can do a credit check on each sales order or on each order line, and can hold an order line that
doesn't pass credit check.
Note.
1. The Order Entry Specialist creates a sales order in Order Management, adds order lines, sets payment terms,
payment method, and Bill-to Customer, then clicks Submit.
2. If you set the Activate Credit Check on Order Submit order management parameter to.
746
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
3. Do credit check.
• Passes. Receivables sends the result to Order Management, and Order Management orchestrates
fulfillment.
• Fails. Credit check continues.
4. Order Management processes the sales order depending on how you set the value of the Credit Check Failure
at Order Submit order management parameter.
Value Description
Save Order in Draft Status Save the sales order in Draft status and don't proceed to fulfillment. Wait for the credit
analyst to approve or decline.
Submit the Order with Hold on Lines Save the sales order in Processing status, place a hold on each order line that fails credit
That Failed Credit Check check, then send order lines that aren't on hold to fulfillment.
For details, see the Handle Credit Check Failure section later in this topic.
5. Receivables creates a case folder for the credit request and determines credit status.
Status Description
Failed Receivables sends the credit check result to Order Management, including credit
authorization number, credit authorization amount, and credit expiration date.
The credit analyst uses the Credit Reviews page in the Receivables work area to examine the case folder, then
approves or declines the credit request. Receivables sends the result of the credit review to Order Management.
6. If the credit analyst.
◦ Approves. Receivables sends the authorization ID, date, Bill To, and release reason to Order
Management. Order Management sets the status to Processing and orchestrates fulfillment for the entire
sales order.
◦ Declines. Order Management sets the status to Draft and doesn't send any part of the sales order to
fulfillment. The Order Entry Specialist must revise the sales order.
Note.
• Credit check establishes a credit line only for a single currency, and only for the customer account.
• Order Management runs credit check when the user submits the sales order, and immediately before running
approval. If credit check succeeds, and if approval fails, then Order Management removes authorization for the
authorization number, then gets a new authorization number after the user resubmits the sales order.
• If the Order Entry Specialist modifies an attribute that affects payment sometime after Order Management runs
credit check, then Order Management runs credit check again. Bill-To Customer is an example of an attribute
that affects payment.
747
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
• If the Order Entry Specialist cancels a sales order before fulfillment finishes, then Order Management
communicates with Credit Management in Receivables to reverse the credit amount of the sales order. It
reverses this amount in the customer account in Oracle Fusion Financials.
You can use the Receivables work area to define a different formula, such as modifying credit limit, including shipping
charges and taxes, and so on. For details, see Oracle Credit Management User Guide on Oracle Help Center.
This section assumes you enable the Credit Management feature in Receivables.
If any order line fails credit check, then the entire sales order fails during order submit.
748
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
◦ Changes order status and continues processing depending on how the credit analyst sets the
recommendation.
Approve Source Transaction Credit Depends on whether you implement trade compliance check or order approval.
Request
• Don't implement. Changes order status to Processing, automatically removes
credit hold, and proceeds to order fulfillment.
• Do implement. Sets status according to the state of compliance check or order
approval, then proceeds to compliance check or order approval.
The Order Entry Specialist must revise and resubmit the sales order.
This section assumes you enable the Credit Management feature in the Receivables work area.
1. Submits the sales order to order fulfillment even if credit check fails.
2. Applies a credit check hold on each order line that fails credit check.
3. Holds the lines that fail credit check on the first step of the orchestration process.
4. Opens a case folder for the sales order in Credit Management.
5. Sends fulfillment lines that pass credit check to the next step in the orchestration process.
6. The credit analyst sets the recommendation and closes the case folder in Credit Management.
7. Order Management does these steps.
◦ Updates attributes and displays a message. This behavior is similar to the behavior that occurs when you
use Save Order in Draft Status.
◦ Changes order status depending on how the credit analyst sets the recommendation when closing the
case folder.
Approve Source Transaction Credit Release credit check hold on fulfillment lines and send them to order fulfillment.
Request
Decline Source Transaction Credit Doesn't release credit check hold on fulfillment lines. These lines remain on hold, and
Request Order Management doesn't send them to order fulfillment.
The Order Entry Specialist can query or cancel failed lines, but can't revise them.
749
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
Note.
• If a revision fails credit check, then Order Management sets the status to Credit Review Pending regardless of
how you set the order management parameter.
• If the sales order or order revision is in the Credit Review Pending status, then the Order Entry Specialist can't
make any changes. The Order Entry Specialist must use the Revert to Draft action, and then make changes.
• If you enable or don't enable the Credit Management feature.
◦ Enable. Order Management waits for the credit analyst to close the case folder before submitting failed
lines to order fulfillment.
◦ Don't enable. The Order Entry Specialist must manually revise the revision to a draft, modify the sales
order, such as delete lines that failed credit check, reduce quantity so the sales order total doesn't exceed
credit limit, and so on, and then resubmit.
• The revision must successfully pass credit check so Order Management can merge the Draft sales order into
the Processing instance of the same sales order that's currently running in order fulfillment.
This section assumes you don't enable the Credit Management feature in Receivables, and credit check fails during
order submit.
1. Order Management takes action depending on the value of the Credit Check Failure at Order Submit parameter.
Value Result
Save Order in Draft Status Set order status to Credit Review Pending.
Wait for the credit analyst to resolve the issue and close the case folder.
Place each order line that fails credit check on credit check hold.
Submit all order lines, including order lines that fail credit check, to order fulfillment.
2. Credit analyst resolves the issue and closes the case folder.
3. Order Entry Specialist must revise the sales order, then resubmit it.
Related Topics
• Release Holds for Order Lines That Fail Credit Check
• Reauthorize Payment
• Manage Order Management Parameters
750
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
Note.
• Option 1. Check credit when the Order Entry Specialist clicks Submit when creating or revising a sales order.
◦ Submit the sales order to order fulfillment but hold order lines that fail credit check.
751
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
◦ Don't submit the sales order to order fulfillment. Instead, set the status to Credit Review Pending, and
route the sales order to a credit analyst to do credit check.
• Option 2. Check credit during order fulfillment. For example, add a credit check step to the orchestration
process after scheduling and reserving the item, but before shipping it.
• Option 3. Check credit during order entry at order submit, then check credit again during order fulfillment.
Order Management processes credit check differently during order submit or order fulfillment.
How does Order Management send order Send order lines as a group according to Send one fulfillment line at a time.
lines to Credit Management? bill-to customer.
What happens when an order line fails Order Management does one of these. Set fulfillment line to error.
credit check?
• Place order line on credit check
hold.
• Lock order line, set status to Credit
Review Pending, and wait for credit
analyst to review case folder.
How can an order line that fails credit Order Entry Specialist does one of these. Do one of these.
check proceed?
• Manually releases hold. • Order Entry Specialist revises the
• Revises the sales order to status sales order.
Draft, modifies it, and submits it • Credit analyst adjusts credit limit,
again. then Order Management runs
a scheduled process that you
define that retries the orchestration
process step. The Order Entry
Specialist can also manually retry.
Limitations Credit check occurs only for all order lines Order Entry Specialist can't manually
in the entire sales order. You can't check proceed past the credit check. Can only
credit for a single line or only for some retry the step.
lines.
Order Management processes credit check differently depending on the state of the order lines.
State of Order Lines Check Credit On Submit Check Credit During Order Fulfillment
752
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
State of Order Lines Check Credit On Submit Check Credit During Order Fulfillment
Lines are in order fulfillment, and. Order Management rechecks each line Allow all changes. Apply normal change
that it checked earlier during submit. processing.
• Before credit check step. It does the recheck regardless of the
• In error because credit check failed change. It creates a new authorization.
If Order management finished credit
during fulfillment. check during order fulfillment, and if credit
• Credit check finished. check fails when processing the change,
then Order Management doesn't allow the
Order Entry Specialist to revise the sales
order. You must use error recovery to fix
the problem.
In order fulfillment, on credit hold. If changed attributes. Allow all changes. Apply normal change
processing.
• Affect credit. Reject revision.
• Don't affect credit. Recheck credit.
• Your fulfillment cycles run for a long time. For example, run credit check immediately before shipping to make
sure credit authorization hasn't expired while process the sales order through fulfillment.
• You import sales orders from a source system, the source system already checked credit, so you don't want
to check credit again when submitting the order to fulfillment. But you also don't want to send the order to
shipping if credit authorization expired. A long delay might exist between the time the source system checks
credit and when the item is ready to ship.
753
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
Note.
◦ If credit check passes the first time Receivables performs credit check, then it creates an authorization
number and authorization expiration date.
754
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
For example, assume you do credit check during order submit on January 1, 2019, credit check passes,
and Receivables sets the expiration date to January 10, 2019. If the orchestration process runs the credit
check step on.
• January 2 during fulfillment, then it won't run credit check again, but will instead proceed to the
next orchestration process step.
• January 11, then it will run credit check again.
◦ The orchestration process sends only the fulfillment lines that require credit check. It doesn't send the
entire sales order.
4. If credit check fails, then the fulfillment line goes into error and processing stops.
755
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
Note.
Value Description
Save Order in Draft Status Save the sales order in the Draft status. Don't send any lines to order fulfillment.
756
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
Value Description
Use when.
• Your sales order includes more than one value for Bill-to Customer on the order lines,
and you must move the order to fulfillment only if credit check passes for all bill-to
customers.
• You don't need to do credit check during fulfillment.
• You don't need to release credit check hold so fulfillment can continue. You can wait for
the credit analyst to resolve the hold.
Submit Order with Hold on Lines that Save the sales order in Processing status, place a hold on each order line that fails credit check,
Failed Credit Check then send order lines that aren't on hold to fulfillment.
Use when.
• Your sales orders sometimes include more than one value for Bill-to Customer on the
order lines, and you must move the order to fulfillment even if credit check fails for
some or all bill-to customers.
For example, if credit check for Bill To Customer x succeeds, and if credit check for Bill
To Customer y fails, then Order Management can send order lines for customer x to
order fulfillment, and place order lines for customer y on hold.
If order lines include only one Bill To Customer value, then Order Management uses the
order total when it checks credit.
• You don't revise attributes that affect credit check, or you might cancel the failed lines.
• You must release credit check hold so fulfillment can continue, even if you must
manually release the hold.
Question Description
Why does Order Management place The orchestration process orchestrates and Order Management tracks each fulfillment line
credit check hold on the fulfillment separately so they can optimize fulfillment.
line instead of on the order header
when all fulfillment lines of the sales
order fail credit check? For example, if supply is available for lines x and y but not z, then it can reserve supply and
move to the next orchestration process step for x and y.
If Order Management placed the hold on the sales order instead of the fulfillment lines, then it
would have to pause orchestration for all lines while it waits for supply to become available for
z.
How can we allow fulfillment lines Manually release the credit check hold. To make sure you don't ship a line that fails credit
that are on credit check hold to check, add another orchestration process step that does credit check. Add it after the
proceed beyond scheduling? scheduling step.
Assume credit check fails during You must retry the step and it must pass credit check so the fulfillment line can move forward
fulfillment and the credit check step is in the flow.
in error. Can we manually get that line
past the credit check step?
757
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
Question Description
You can't manually remove a hold because Order Management doesn't place a hold when
credit check fails during fulfillment. It only places the line in error.
Related Topics
• Release Holds for Order Lines That Fail Credit Check
• Reauthorize Payment
• Manage Order Management Parameters
◦ Is active.
◦ Has an established credit line.
◦ Make sure the Include in Credit Check option for the account contains a check mark.
◦ Set these attributes on the account.
• Credit Limit
• Credit Currency
• Order Amount Limit
2. Verify customer account setup.
758
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
• Inventory is out of stock for the item and requires several days to replenish.
• The credit that's available for a customer might decrease during this time because the customer continues to
make other purchases.
759
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
You can add a credit check step at any point in the orchestration process. For example, to occur immediately before
shipping. Use this functionality to make sure the credit check is accurate and up to date so you don't ship an item when
customer credit no longer covers the purchase amount.
For example, you can add a credit check step to an orchestration process immediately after the Reserve step, and
immediately before the Ship step.
Here's the values you set for the credit check step you add.
760
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
Attribute Value
Step Name Enter text that describes the step, such as Credit Check.
Task DOO_CreditCheck
If credit check fails when you run it from the DOO_CreditCheck task, then credit check sets the task to an error state,
stops processing order lines, and pauses the orchestration process. To recover, you must set up the Recover Tasks
scheduled process. Attempting to release a hold won't resume processing.
If you add a credit check step to an orchestration process, and if the orchestration process already checked credit for the
sales order before order submit, then Order Management examines the expiration date of the credit check.
• If the current date occurs after the expiration date. Order Management does the credit check.
• If the current date occurs on or before the expiration date. Order Management doesn't do the credit check.
Related Topics
• Manage Order Management Parameters
• Orchestration Processes
For details about case folders and the set ups you must do to use them, see these books on My Oracle Support.
• Oracle Financials Cloud, Implementing Receivables Credit to Cash
• Oracle Financials Cloud, Using Receivables Credit to Cash
In this example, you will allow user Aaron Holmes to close case folders.
1. Assign a role to your user that allows the user to view and approve credit.
For details, see Oracle Credit Management User Guide.
2. Sign into Order Management with the predefined it_security_manager job role.
3. In the Navigator, click Setup and Maintenance.
4. In the Setup and Maintenance work area, go to the task.
◦ Offering: Order Management
◦ Functional Area: Users and Security
◦ Task: Manage Job Roles
761
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
The Security Console displays the Roles page after you click Manage Job Roles. For details, see book
Securing Oracle HCM Cloud.
5. Add your user to the Credit Manager job role.
◦ On the Roles page, search for, then open the Credit Manager job role.
◦ Click Actions > Copy Role.
◦ In the Copy Options dialog, click Copy Top Role and Inherited Roles > Copy Role.
◦ On the task-based page that displays, click Next four times until Users is the active step on the task line.
◦ On the Copy Role Credit Manager Custom Users page, click Add User.
◦ In the Add User dialog, in the search window, enter the predefined user ar_mgr_operations, then click
Search.
If you don't use a predefined user, but instead create your own user, then make sure the user includes a
role that allows the user to close case folders.
◦ In the search results, click the row that contains Aaron Holmes, the user you must add, then click Add
User to Role > Cancel.
◦ Confirm that the Copy Role Credit Manager Custom Users page displays the user you just added, then
click Next > Submit and Close.
6. Import the user and role.
Repeat until this value displays for the Import User and Role Application scheduled process.
Attribute Value
Status Succeeded
Related Topics
• Manage Order Management Parameters
• Orchestration Processes
762
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
763
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
◦ Notice that you can use the Release Hold dialog to set values and release the hold.
764
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
◦ On the Manage Hold Definitions page, click Query by Example, enter the value, then press Enter on your
keyboard.
Attribute Value
Attribute Value
◦ In the search results, click the row that includes Order Manager, then click Apply > OK.
◦In the Details area, make sure the Release Hold attribute contains a check mark, then click Save and
Close.
3. Test your set up.
Notice that Order Management changes the Status attribute on the order line from Not Started to
Scheduled. If the status doesn't change, wait a moment, then try again.
◦ Click Actions > Switch to Fulfillment View.
◦ Click Fulfillment Lines.
765
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
◦ In the Details area, click Holds, then examine the release details.
Related Topics
• Manage Order Management Parameters
• Orchestration Processes
766
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
Set attributes in the payload you use to import your source order.
767
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
Attribute Description
• True. Don't check credit. Order Management won't do credit check on the source order
even if you enable credit check for the business unit.
• False. Do check credit.
Order Management uses the value that you set to populate the Credit Reference attribute on
the order line.
If you import a source order, and if a sales order already exists in Order Management that
matches the source order, then Order Management examines the value of Credit Reference in
the sales order. If Credit Reference isn't equal to the value of CreditCheckAuthorizationCode,
then Order Management checks credit for the source order.
Order Management uses the value that you set to populate the Expiration Date attribute on the
order line.
Note.
• You can reference PreCreditCheckedFlag from a transformation rule or an order management extension.
• You can send PreCreditCheckedFlag only through order import.
• PreCreditCheckedFlag doesn't display in the Order Management work area.
To view the code and date, in the Order Management work area, navigate to a fulfillment view, then open a sales order.
On the Order page, in the Fulfillment Line Details area, in the Attributes area, on the Billing tab, in the Credit Approval
area, note.
For example.
768
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
769
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
<ns2:BuyingPartyContactId></ns2:BuyingPartyContactId>
<ns2:BuyingPartyContactName></ns2:BuyingPartyContactName>
<ns2:BuyingPartyContactNumber></ns2:BuyingPartyContactNumber>
<ns2:CustomerPONumber></ns2:CustomerPONumber>
<ns2:TransactionalCurrencyCode>USD</ns2:TransactionalCurrencyCode>
<ns2:TransactionalCurrencyName></ns2:TransactionalCurrencyName>
<ns2:TransactionOn>2017-06-07T10:10:10</ns2:TransactionOn>
<ns2:PlacedOn></ns2:PlacedOn>
<ns2:RequestingBusinessUnitIdentifier>204</ns2:RequestingBusinessUnitIdentifier>
<ns2:TransactionTypeCode></ns2:TransactionTypeCode>
<ns2:CurrencyConversionType></ns2:CurrencyConversionType>
<ns2:CurrencyConversionRate></ns2:CurrencyConversionRate>
<ns2:CurrencyConversionDate></ns2:CurrencyConversionDate>
<ns2:TransactionDocumentTypeCode></ns2:TransactionDocumentTypeCode>
<ns2:CancelReasonCode></ns2:CancelReasonCode>
<ns2:CancelReason></ns2:CancelReason>
<ns2:RequestCancelDate></ns2:RequestCancelDate>
<ns2:Comments></ns2:Comments>
<ns2:BatchIdentifier></ns2:BatchIdentifier>
<ns2:RequestingLegalUnitIdentifier>204</ns2:RequestingLegalUnitIdentifier>
<ns2:RequestingLegalUnit></ns2:RequestingLegalUnit>
<ns2:OrigSystemDocumentReference>ManualShipmentProcess</ns2:OrigSystemDocumentReference>
<ns2:InterfaceStatus></ns2:InterfaceStatus>
<ns2:PartialShipAllowedFlag>false</ns2:PartialShipAllowedFlag>
<ns2:FreezePriceFlag>true</ns2:FreezePriceFlag>
<ns2:OperationMode></ns2:OperationMode>
<ns2:PreCreditCheckedFlag>true</ns2:PreCreditCheckedFlag>
<ns2:OrchestrationOrderRequestLine>
<ns2:SourceTransactionLineIdentifier>101</ns2:SourceTransactionLineIdentifier>
<ns2:SourceTransactionScheduleIdentifier>101</ns2:SourceTransactionScheduleIdentifier>
<ns2:SourceTransactionLineNumber>1</ns2:SourceTransactionLineNumber>
<ns2:SourceTransactionScheduleNumber>1</ns2:SourceTransactionScheduleNumber>
<ns2:ProductIdentifier>149</ns2:ProductIdentifier>
<ns2:ProductNumber></ns2:ProductNumber>
<ns2:ProductName></ns2:ProductName>
<ns2:OrderedQuantity>10</ns2:OrderedQuantity>
<ns2:CanceledQuantity></ns2:CanceledQuantity>
<ns2:OrderedUOMCode>Ea</ns2:OrderedUOMCode>
<ns2:RequestedFulfillmentOrganizationIdentifier>204</ns2:RequestedFulfillmentOrganizationIdentifier>
<ns2:RequestedFulfillmentOrganizationCode></ns2:RequestedFulfillmentOrganizationCode>
<ns2:BusinessUnitIdentifier></ns2:BusinessUnitIdentifier>
<ns2:BusinessUnitName></ns2:BusinessUnitName>
<ns2:RequestingBusinessUnitIdentifier>204</ns2:RequestingBusinessUnitIdentifier>
<ns2:RequestingBusinessUnitName></ns2:RequestingBusinessUnitName>
<ns2:CancelReasonCode></ns2:CancelReasonCode>
<ns2:CancelReason></ns2:CancelReason>
<ns2:SubstitutionAllowedFlag></ns2:SubstitutionAllowedFlag>
<ns2:SubstitutionReasonCode></ns2:SubstitutionReasonCode>
<ns2:CustomerPONumber></ns2:CustomerPONumber>
<ns2:CustomerPOLineNumber></ns2:CustomerPOLineNumber>
<ns2:CustomerPOScheduleNumber></ns2:CustomerPOScheduleNumber>
<ns2:CustomerProductIdentifier></ns2:CustomerProductIdentifier>
<ns2:TransactionLineTypeCode></ns2:TransactionLineTypeCode>
<ns2:ParentLineReference></ns2:ParentLineReference>
<ns2:RootParentLineReference></ns2:RootParentLineReference>
<ns2:ShippingInstructions>XYZ</ns2:ShippingInstructions>
<ns2:PackingInstructions>XYZ</ns2:PackingInstructions>
<ns2:InvoicingRuleCode></ns2:InvoicingRuleCode>
<ns2:InvoicingRule></ns2:InvoicingRule>
<ns2:AccountingRuleCode></ns2:AccountingRuleCode>
<ns2:AccountingRule></ns2:AccountingRule>
<ns2:RequestedShipDate></ns2:RequestedShipDate>
<ns2:RequestedArrivalDate>2015-11-15T10:10:10</ns2:RequestedArrivalDate>
<ns2:ScheduleShipDate>2015-11-15T10:10:10</ns2:ScheduleShipDate>
<ns2:ScheduleArrivalDate>2015-11-15T10:10:10</ns2:ScheduleArrivalDate>
<ns2:DemandClassCode></ns2:DemandClassCode>
770
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
<ns2:DemandClass></ns2:DemandClass>
<ns2:IncotermCode></ns2:IncotermCode>
<ns2:Incoterm></ns2:Incoterm>
<ns2:ShippingCarrierCode></ns2:ShippingCarrierCode>
<ns2:ShippingCarrier></ns2:ShippingCarrier>
<ns2:PaymentTerms></ns2:PaymentTerms>
<ns2:PaymentTermsCode>1</ns2:PaymentTermsCode>
<ns2:TransactionCategoryCode>ORDER</ns2:TransactionCategoryCode>
<ns2:ReturnReasonCode></ns2:ReturnReasonCode>
<ns2:ReturnReason></ns2:ReturnReason>
<ns2:ShippingServiceLevelCode></ns2:ShippingServiceLevelCode>
<ns2:ShippingServiceLevel></ns2:ShippingServiceLevel>
<ns2:ShippingModeCode></ns2:ShippingModeCode>
<ns2:ShippingMode></ns2:ShippingMode>
<ns2:ShipmentPriorityCode></ns2:ShipmentPriorityCode>
<ns2:ShipmentPriority></ns2:ShipmentPriority>
<ns2:InventoryOrganizationIdentifier>204</ns2:InventoryOrganizationIdentifier>
<ns2:InventoryOrganization></ns2:InventoryOrganization>
<ns2:FreightTermsCode></ns2:FreightTermsCode>
<ns2:FreightTerms></ns2:FreightTerms>
<ns2:RequestCancelDate></ns2:RequestCancelDate>
<ns2:OriginalProductIdentifier></ns2:OriginalProductIdentifier>
<ns2:OriginalProductName></ns2:OriginalProductName>
<ns2:OriginalProductNumber></ns2:OriginalProductNumber>
<ns2:ShipToPartyIdentifier>1006</ns2:ShipToPartyIdentifier>
<ns2:ShipToPartyName></ns2:ShipToPartyName>
<ns2:ShipToPartyNumber></ns2:ShipToPartyNumber>
<ns2:ShipToPartySiteIdentifier>1036</ns2:ShipToPartySiteIdentifier>
<ns2:ShipToAddress1></ns2:ShipToAddress1>
<ns2:ShipToAddress2></ns2:ShipToAddress2>
<ns2:ShipToAddress3></ns2:ShipToAddress3>
<ns2:ShipToAddress4></ns2:ShipToAddress4>
<ns2:ShipToCity></ns2:ShipToCity>
<ns2:ShipToPostalCode></ns2:ShipToPostalCode>
<ns2:ShipToState></ns2:ShipToState>
<ns2:ShipToProvince></ns2:ShipToProvince>
<ns2:ShipToCountry></ns2:ShipToCountry>
<ns2:ShipToContactPartyIdentifier></ns2:ShipToContactPartyIdentifier>
<ns2:ShipToContactPartyNumber></ns2:ShipToContactPartyNumber>
<ns2:ShipToContactPartyName></ns2:ShipToContactPartyName>
<ns2:BillToCustomerIdentifier>1002</ns2:BillToCustomerIdentifier>
<ns2:BillToCustomerName></ns2:BillToCustomerName>
<ns2:BillToCustomerNumber></ns2:BillToCustomerNumber>
<ns2:BillToAccountSiteUseIdentifier>1009</ns2:BillToAccountSiteUseIdentifier>
<ns2:BillToAddress1></ns2:BillToAddress1>
<ns2:BillToAddress2></ns2:BillToAddress2>
<ns2:BillToAddress3></ns2:BillToAddress3>
<ns2:BillToAddress4></ns2:BillToAddress4>
<ns2:BillToCity></ns2:BillToCity>
<ns2:BillToPostalCode></ns2:BillToPostalCode>
<ns2:BillToState></ns2:BillToState>
<ns2:BillToProvince></ns2:BillToProvince>
<ns2:BillToCountry></ns2:BillToCountry>
<ns2:BillToAccountContactIdentifier></ns2:BillToAccountContactIdentifier>
<ns2:BillToAccountContactName></ns2:BillToAccountContactName>
<ns2:BillToAccountContactNumber></ns2:BillToAccountContactNumber>
<ns2:PartialShipAllowedFlag>false</ns2:PartialShipAllowedFlag>
<ns2:FulfillmentLineIdentifier></ns2:FulfillmentLineIdentifier>
<ns2:ShipToRequestRegion></ns2:ShipToRequestRegion>
<ns2:RequestedSupplierCode></ns2:RequestedSupplierCode>
<ns2:RequestedSupplierName></ns2:RequestedSupplierName>
<ns2:RequestedSupplierNumber></ns2:RequestedSupplierNumber>
<ns2:RequestedSupplierSiteCode></ns2:RequestedSupplierSiteCode>
<ns2:SupplierAddressLine1></ns2:SupplierAddressLine1>
<ns2:SupplierAddressLine2></ns2:SupplierAddressLine2>
<ns2:SupplierAddressLine3></ns2:SupplierAddressLine3>
771
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
<ns2:SupplierAddressLine4></ns2:SupplierAddressLine4>
<ns2:SupplierAddressCity></ns2:SupplierAddressCity>
<ns2:SupplierAddressState></ns2:SupplierAddressState>
<ns2:SupplierAddressZipCode></ns2:SupplierAddressZipCode>
<ns2:SupplierAddressProvince></ns2:SupplierAddressProvince>
<ns2:SupplierAddressCountry></ns2:SupplierAddressCountry>
<ns2:FulfillmentMethodCode></ns2:FulfillmentMethodCode>
<ns2:Comments></ns2:Comments>
<ns2:ReferenceTransactionLineId></ns2:ReferenceTransactionLineId>
<ns2:InterfaceStatus></ns2:InterfaceStatus>
<ns2:UnitListPrice>5</ns2:UnitListPrice>
<ns2:UnitSellingPrice>5</ns2:UnitSellingPrice>
<ns2:ExtendedAmount>100</ns2:ExtendedAmount>
<ns2:BatchIdentifier></ns2:BatchIdentifier>
<ns2:DestinationShippingOrganizationIdentifier></ns2:DestinationShippingOrganizationIdentifier>
<ns2:DestinationShippingLocationIdentifier></ns2:DestinationShippingLocationIdentifier>
<ns2:EarliestAcceptableShipDate></ns2:EarliestAcceptableShipDate>
<ns2:LatestAcceptableShipDate></ns2:LatestAcceptableShipDate>
<ns2:EarliestAcceptableArrivalDate></ns2:EarliestAcceptableArrivalDate>
<ns2:LatestAcceptableArrivalDate></ns2:LatestAcceptableArrivalDate>
<ns2:PromiseShipDate></ns2:PromiseShipDate>
<ns2:PromiseArrivalDate></ns2:PromiseArrivalDate>
<ns2:SubInventoryCode></ns2:SubInventoryCode>
<ns2:SubInventory></ns2:SubInventory>
<ns2:ShipSetName></ns2:ShipSetName>
<ns2:TaxExemptFlag>S</ns2:TaxExemptFlag>
<ns2:TaxClassificationCode></ns2:TaxClassificationCode>
<ns2:TaxExemptionCertificateNumber></ns2:TaxExemptionCertificateNumber>
<ns2:TaxExemptReasonCode></ns2:TaxExemptReasonCode>
<ns2:DefaultTaxationCountry></ns2:DefaultTaxationCountry>
<ns2:FirstPartyTaxRegistration></ns2:FirstPartyTaxRegistration>
<ns2:ThirdPartyTaxRegistration></ns2:ThirdPartyTaxRegistration>
<ns2:DocumentSubType></ns2:DocumentSubType>
<ns2:FinalDischargeLocationIdentifier></ns2:FinalDischargeLocationIdentifier>
<ns2:ProductFiscalCategoryIdentifier></ns2:ProductFiscalCategoryIdentifier>
<ns2:ProductType></ns2:ProductType>
<ns2:ProductCategory></ns2:ProductCategory>
<ns2:TransactionBusinessCategory></ns2:TransactionBusinessCategory>
<ns2:AssessableValue></ns2:AssessableValue>
<ns2:UserDefinedFiscClass></ns2:UserDefinedFiscClass>
<ns2:IntendedUseClassificationIdentifier></ns2:IntendedUseClassificationIdentifier>
<ns2:FOBPointCode></ns2:FOBPointCode>
<ns2:FOBPoint></ns2:FOBPoint>
<ns2:OrigSystemDocumentReference>ORIGSYS</ns2:OrigSystemDocumentReference>
<ns2:OrigSystemDocumentLineReference>ORIGSYSLINE</ns2:OrigSystemDocumentLineReference>
<ns2:CreditCheckAuthorizationCode>1235</ns2:CreditCheckAuthorizationCode>
<ns2:CreditCheckAuthorizationExpiryDate>2016-11-15T10:10:10</ns2:CreditCheckAuthorizationExpiryDate>
<ns2:ContractStartDate></ns2:ContractStartDate>
<ns2:LineCharge>
<ns2:ChargeDefinitionCode>QP_SALE_PRICE</ns2:ChargeDefinitionCode>
<ns2:ChargeSubtypeCode>ORA_PRICE</ns2:ChargeSubtypeCode>
<ns2:PriceTypeCode>ONE_TIME</ns2:PriceTypeCode>
<ns2:PricedQuantity>1</ns2:PricedQuantity>
<ns2:PricedQuantityUOMCode>Ea</ns2:PricedQuantityUOMCode>
<ns2:PrimaryFlag>true</ns2:PrimaryFlag>
<ns2:ApplyTo>PRICE</ns2:ApplyTo>
<ns2:RollupFlag>false</ns2:RollupFlag>
<ns2:SourceChargeIdentifier>SC1</ns2:SourceChargeIdentifier>
<ns2:ChargeTypeCode>ORA_SALE</ns2:ChargeTypeCode>
<ns2:ChargeCurrencyCode>USD</ns2:ChargeCurrencyCode>
<ns2:SequenceNumber>1</ns2:SequenceNumber>
<ns2:PricePeriodicityCode></ns2:PricePeriodicityCode>
<ns2:GsaUnitPrice></ns2:GsaUnitPrice>
<ns2:ChargeComponent>
<ns2:ChargeCurrencyCode>USD</ns2:ChargeCurrencyCode>
<ns2:HeaderCurrencyCode>USD</ns2:HeaderCurrencyCode>
772
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
<ns2:HeaderCurrencyExtendedAmount>97</ns2:HeaderCurrencyExtendedAmount>
<ns2:PriceElementCode>QP_NET_PRICE</ns2:PriceElementCode>
<ns2:SequenceNumber>2</ns2:SequenceNumber>
<ns2:PriceElementUsageCode>NET_PRICE</ns2:PriceElementUsageCode>
<ns2:ChargeCurrencyUnitPrice>97</ns2:ChargeCurrencyUnitPrice>
<ns2:HeaderCurrencyUnitPrice>97</ns2:HeaderCurrencyUnitPrice>
<ns2:RollupFlag>false</ns2:RollupFlag>
<ns2:SourceParentChargeComponentId></ns2:SourceParentChargeComponentId>
<ns2:SourceChargeIdentifier>SC1</ns2:SourceChargeIdentifier>
<ns2:SourceChargeComponentIdentifier>SCC1</ns2:SourceChargeComponentIdentifier>
<ns2:ChargeCurrencyExtendedAmount>97</ns2:ChargeCurrencyExtendedAmount>
</ns2:ChargeComponent>
<ns2:ChargeComponent>
<ns2:ChargeCurrencyCode>USD</ns2:ChargeCurrencyCode>
<ns2:HeaderCurrencyCode>USD</ns2:HeaderCurrencyCode>
<ns2:HeaderCurrencyExtendedAmount>97</ns2:HeaderCurrencyExtendedAmount>
<ns2:PriceElementCode>QP_LIST_PRICE</ns2:PriceElementCode>
<ns2:SequenceNumber>1</ns2:SequenceNumber>
<ns2:PriceElementUsageCode>LIST_PRICE</ns2:PriceElementUsageCode>
<ns2:ChargeCurrencyUnitPrice>97</ns2:ChargeCurrencyUnitPrice>
<ns2:HeaderCurrencyUnitPrice>97</ns2:HeaderCurrencyUnitPrice>
<ns2:RollupFlag>false</ns2:RollupFlag>
<ns2:SourceParentChargeComponentId></ns2:SourceParentChargeComponentId>
<ns2:SourceChargeIdentifier>SC1</ns2:SourceChargeIdentifier>
<ns2:SourceChargeComponentIdentifier>SCC2</ns2:SourceChargeComponentIdentifier>
<ns2:ChargeCurrencyExtendedAmount>97</ns2:ChargeCurrencyExtendedAmount>
</ns2:ChargeComponent>
</ns2:LineCharge>
</ns2:OrchestrationOrderRequestLine>
</ns1:OrchestrationOrderRequest>
</ns1:process>
</soap:Body>
</soap:Envelope>
Related Topics
• Reauthorize Payment
• Overview of Importing Orders into Order Management
773
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
774
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
Related Topics
• Overview of Creating Order Management Extensions
Credit Card
Overview of Setting Up Credit Cards
Integrate Order Management Cloud with Oracle Fusion Payments so your users can select an existing credit card or add
a new one to a sales order.
Here's a summary of what you can do.
• Allow your users to select an existing credit card or add a new one to a sales order, with or without the three
digit card verification value.
• Import a transaction that's already authorized.
• Import a transaction and use the primary card that's already available on the customer account.
• Use a digital verification code when you use a credit card to pay for the sales order.
• The Order Entry Specialist can select a credit card on the sales order in the Order Management work area from
a list of cards that are available for the bill-to-customer. Use a single credit card to pay for the entire sales order,
or use a different credit card on each order line.
• Use a digital verification code for each credit card.
• If you set the Payment Method attribute on the sales order to Credit Card, then the Payment Details area
displays the card that you specify as the primary card for the account in the Accounts Receivable work area.
Note that you can use only one payment method for each sales order.
• If you enable the Digital Verification Code attribute in Oracle Fusion Payments, then the Payment Details area
on the order header displays the Security Code attribute. The Override Order Line dialog also displays the
Security Code attribute.
• Use an order management extension to prevent the Order Entry Specialist from editing a sales order that's
already authorized.
• Use the integration to make sure your implementation complies with the Payment Card Industry Data Security
Standard (PCI DSS).
Note.
• You must not send credit card numbers that aren't tokenized to Oracle Fusion Applications.
• You must consult with your own Qualified Security Assessor (QSA) to make sure your deployment complies
with the Payment Card Industry Data Security Standard (PCI DSS) and the compliance requirements set by the
PCI Security Standards Council.
How it Works
Order Management uses Oracle Fusion Payments to manage and process credit card transactions. Oracle Fusion
Payments handles the details, such as authorizing the purchase, communicating with the bank that issues the credit
card, making sure funds are available for the credit card, that the card hasn't expired, and so on.
775
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
Here's how the flow works for credit cards that already exist.
776
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
If you enable Voice Authorization, and if the Order Entry Specialist adds voice authorization details, then Order
Management sends them to Oracle Financials Cloud.
4. Oracle Financials creates an assignment for the card and a transaction extension for the transaction, then sends
the Txn Extension Id attribute to Order Management.
5. The Order Entry Specialist adds an order line to the sales order, then clicks Submit.
6. Oracle Fusion Payments attempts to authorize the transaction.
For details, see the How Authorizations for Credit Cards Are Processed topic.
7. Order Management fulfills the sales order, then sends fulfillment details including the Payment Transaction
Extension Identifier to Oracle Receivables.
8. Oracle Receivables creates an invoice, sends it to the customer, and settles the payment with the customer.
The flow is similar for other scenarios, with a few variations.
Scenario Variation
Order Entry Specialist creates a new Oracle Financials Cloud creates and tokenizes the card in Financials. The card is now ready for
credit card. the current and future sales orders.
You import a sales order that includes Oracle Financials Cloud works with your upstream order capture system to authorize credit,
credit authorization details. then sends the Payment Transaction Extension Identifier attribute to Order Management Cloud
in the import payload.
Prevent the Order Entry Specialist From Editing a Sales Order That's Already Authorized
You can use an order management extension to prevent the Order Entry Specialist from editing a sales order that's
already authorized. For details, see the Prevent Users From Editing Payment Attributes section in the More Code
Examples for Order Management Extensions topic.
Related Topics
• Overview of Displaying Customer Details on Sales Orders
• How Authorizations for Credit Cards Are Processed
• More Code Examples for Order Management Extensions
777
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
Attribute Value
4. In the search results, in the Profile Option Levels area, set the values to meet your requirements.
For example.
Attribute Value
Level Site
That's it! You can now use credit cards in Order Management.
778
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
Note.
• You add a credit card to the account in the Accounts Receivable work area.
• You can set the card as the primary card when you add it.
• At run time, Order Management chooses and displays the primary card, by default. It also makes the other
cards that you add in the Accounts Receivable work area available on the sales order.
779
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
Enable Tokenization
1. Sign into Oracle Fusion Applications with a job role that you can use to manage security. For example,
it_security_manager.
2. Go to the Setup and Maintenance work area, then go to the task.
◦ Offering: Financials
◦ Functional Area: Payments
◦ Task: Manage System Security Options
3. On the Manage System Security Options page, click Edit Tokenization Payment System.
4. In the Edit Tokenization Payment System dialog, choose the value, then click Save and Close.
Attribute Value
The error will display when you attempt to add a credit card to the account in the Accounts Receivable work
area, or when you attempt to add it to a sales order in the Order Management work area.
For details, see the Options for System Security topic.
Attribute Value
5. In the search results, click the link in the Account Number column.
780
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
Attribute Value
6. On the Edit Account page, in the Payment Instruments area, in the Credit Cards list, click Create a Credit Card.
It's the icon that looks like a page.
Attribute Value
Notice that this is the same value you clicked on the Manage Customers page.
Attribute Value
5. In the Payment Details area, verify that the attribute value defaults to the primary card.
Attribute Value
Related Topics
• Options for System Security
781
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
<ns2:SourceTransactionPaymentIdentifier>H101</ns2:SourceTransactionPaymentIdentifier>
<ns2:PaymentMethod/>
<ns2:PaymentTypeCode>ORA_CREDIT_CARD</ns2:PaymentTypeCode>
</ns2:Payment>
782
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
<!--Optional:-->
<ns2:ScheduleArrivalDate>2018-11-20T06:08:52.0340</ns2:ScheduleArrivalDate>
<!--Optional:-->
<ns2:PaymentTermsCode>1</ns2:PaymentTermsCode>
<ns2:TransactionCategoryCode>ORDER</ns2:TransactionCategoryCode>
<ns2:ShipToPartyIdentifier>1006</ns2:ShipToPartyIdentifier>
<ns2:ShipToPartySiteIdentifier>1220</ns2:ShipToPartySiteIdentifier>
<ns2:ShipToPartyContactName/>
<ns2:BillToCustomerIdentifier>1006</ns2:BillToCustomerIdentifier>
<ns2:BillToCustomerName>1006</ns2:BillToCustomerName>
<ns2:BillToAccountSiteUseIdentifier>1025</ns2:BillToAccountSiteUseIdentifier>
<ns2:BillToAccountContactIdentifier>4820</ns2:BillToAccountContactIdentifier>
<ns2:InventoryOrganizationIdentifier>204</ns2:InventoryOrganizationIdentifier>
<ns2:ShippingInstructions/>
<ns2:UnitListPrice currencyCode="USD">105</ns2:UnitListPrice>
<ns2:PartialShipAllowedFlag>FALSE</ns2:PartialShipAllowedFlag>
<ns2:FOBPoint>Destination</ns2:FOBPoint>
<ns2:InvoicingRuleCode/>
<!--Optional:-->
<!--ns2:InvoicingRule>Immediate</ns2:InvoicingRule-->
<!--Optional:-->
<ns2:AccountingRuleCode/>
<!--Optional:-->
<!--ns2:AccountingRule>Advance Invoice</ns2:AccountingRule-->
<ns2:OrderCharge>
<ns2:ChargeDefinitionCode>QP_SALE_PRICE</ns2:ChargeDefinitionCode>
<ns2:ChargeSubtypeCode>ORA_PRICE</ns2:ChargeSubtypeCode>
<ns2:PriceTypeCode>ONE_TIME</ns2:PriceTypeCode>
<ns2:PricedQuantity>1</ns2:PricedQuantity>
<ns2:PricedQuantityUOM>Each</ns2:PricedQuantityUOM>
<ns2:PricedQuantityUOMCode/>
<ns2:PrimaryFlag>true</ns2:PrimaryFlag>
<ns2:ApplyTo>PRICE</ns2:ApplyTo>
<ns2:RollupFlag>false</ns2:RollupFlag>
<ns2:SourceChargeIdentifier>SC1</ns2:SourceChargeIdentifier>
<ns2:ChargeCurrencyCode>USD</ns2:ChargeCurrencyCode>
<ns2:ChargeTypeCode>ORA_SALE</ns2:ChargeTypeCode>
<ns2:ChargeCurrencyCode/>
<ns2:SequenceNumber>1</ns2:SequenceNumber>
<ns2:PricePeriodicityCode/>
<ns2:GsaUnitPrice/>
<ns2:OrderChargeComponent>
<ns2:ChargeCurrencyCode>USD</ns2:ChargeCurrencyCode>
<ns2:HeaderCurrencyCode>USD</ns2:HeaderCurrencyCode>
<ns2:HeaderCurrencyExtendedAmount>1000</ns2:HeaderCurrencyExtendedAmount>
<ns2:PriceElementCode>QP_LIST_PRICE</ns2:PriceElementCode>
<ns2:SequenceNumber>1</ns2:SequenceNumber>
<ns2:PriceElementUsageCode>LIST_PRICE</ns2:PriceElementUsageCode>
<ns2:ChargeCurrencyUnitPrice>10</ns2:ChargeCurrencyUnitPrice>
<ns2:HeaderCurrencyUnitPrice>10</ns2:HeaderCurrencyUnitPrice>
<ns2:RollupFlag>false</ns2:RollupFlag>
<ns2:SourceParentChargeComponentId/>
<ns2:SourceChargeIdentifier>SC1</ns2:SourceChargeIdentifier>
<ns2:SourceChargeComponentIdentifier>SCC2</ns2:SourceChargeComponentIdentifier>
<ns2:ChargeCurrencyExtendedAmount>100</ns2:ChargeCurrencyExtendedAmount>
</ns2:OrderChargeComponent>
<ns2:OrderChargeComponent>
<ns2:ChargeCurrencyCode>USD</ns2:ChargeCurrencyCode>
<ns2:HeaderCurrencyCode>USD</ns2:HeaderCurrencyCode>
<ns2:HeaderCurrencyExtendedAmount>10001</ns2:HeaderCurrencyExtendedAmount>
<ns2:ChargeCurrencyExtendedAmount>90</ns2:ChargeCurrencyExtendedAmount>
<ns2:PriceElementCode>QP_NET_PRICE</ns2:PriceElementCode>
<ns2:SequenceNumber>2</ns2:SequenceNumber>
<ns2:PriceElementUsageCode>NET_PRICE</ns2:PriceElementUsageCode>
<ns2:ChargeCurrencyUnitPrice>9</ns2:ChargeCurrencyUnitPrice>
<ns2:HeaderCurrencyUnitPrice>9</ns2:HeaderCurrencyUnitPrice>
783
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
<ns2:RollupFlag>false</ns2:RollupFlag>
<ns2:SourceParentChargeComponentId/>
<ns2:SourceChargeIdentifier>SC1</ns2:SourceChargeIdentifier>
<ns2:SourceChargeComponentIdentifier>SCC1</ns2:SourceChargeComponentIdentifier>
</ns2:OrderChargeComponent>
</ns2:OrderCharge>
</ns2:Line>
<ns2:Payment>
<ns2:PaymentMethodCode>30</ns2:PaymentMethodCode>
<ns2:PaymentTransactionIdentifier>101</ns2:PaymentTransactionIdentifier>
<ns2:PaymentSetIdentifier>56001</ns2:PaymentSetIdentifier>
<ns2:SourceTransactionPaymentIdentifier>H101</ns2:SourceTransactionPaymentIdentifier>
<ns2:PaymentMethod/>
<ns2:PaymentTypeCode>ORA_CREDIT_CARD</ns2:PaymentTypeCode>
</ns2:Payment>
<ns2:OrderPreferences>
<!--Optional:-->
<ns2:CreateCustomerInformationFlag>false</ns2:CreateCustomerInformationFlag>
<!--Optional:-->
<ns2:SubmitFlag>true</ns2:SubmitFlag>
</ns2:OrderPreferences>
</ns2:Order>
</ns1:request>
</ns1:createOrders>
</soap:Body>
</soap:Envelope>
<ns2:PaymentTypeCode>ORA_CREDIT_CARD</ns2:PaymentTypeCode>
<ns2:SourceTransactionPaymentIdentifier>H101</ns2:SourceTransactionPaymentIdentifier>
</ns2:Payment>
784
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
<ns2:FreezeShippingChargeFlag>true</ns2:FreezeShippingChargeFlag>
<ns2:FreezeTaxFlag>true</ns2:FreezeTaxFlag>
<ns2:OrigSystemDocumentReference></ns2:OrigSystemDocumentReference>
<ns2:Salesperson>James Seller</ns2:Salesperson>
<ns2:Line>
<ns2:SourceTransactionLineIdentifier>101</ns2:SourceTransactionLineIdentifier>
<ns2:SourceTransactionScheduleIdentifier>101</ns2:SourceTransactionScheduleIdentifier>
<ns2:SourceTransactionLineNumber>1</ns2:SourceTransactionLineNumber>
<ns2:SourceTransactionScheduleNumber>1</ns2:SourceTransactionScheduleNumber>
<ns2:ProductNumber>AS92888</ns2:ProductNumber>
<ns2:OrderedQuantity unitCode="Ea">100</ns2:OrderedQuantity>
<ns2:ShippingServiceLevelCode/>
<ns2:ShipmentPriorityCode/>
<ns2:ShipmentPriority/>
<ns2:OrderedUOMCode>Ea</ns2:OrderedUOMCode>
<ns2:RequestedFulfillmentOrganizationIdentifier>207</ns2:RequestedFulfillmentOrganizationIdentifier>
<ns2:RequestingBusinessUnitIdentifier>204</ns2:RequestingBusinessUnitIdentifier>
<ns2:RequestedShipDate>2019-12-04T06:08:52.0340</ns2:RequestedShipDate>
<ns2:PaymentTermsCode>4</ns2:PaymentTermsCode>
<ns2:TransactionCategoryCode>ORDER</ns2:TransactionCategoryCode>
<ns2:InventoryOrganizationIdentifier>204</ns2:InventoryOrganizationIdentifier>
<ns2:UnitListPrice currencyCode="USD">105</ns2:UnitListPrice>
<ns2:ShipToPartyIdentifier>1006</ns2:ShipToPartyIdentifier>
<ns2:ShipToPartySiteIdentifier>1036</ns2:ShipToPartySiteIdentifier>
<ns2:ShipToPartyContactIdentifier>1560</ns2:ShipToPartyContactIdentifier>
<ns2:BillToCustomerIdentifier>1006</ns2:BillToCustomerIdentifier>
<ns2:BillToCustomerName>1006</ns2:BillToCustomerName>
<ns2:BillToAccountSiteUseIdentifier>1025</ns2:BillToAccountSiteUseIdentifier>
<ns2:BillToAccountContactIdentifier>4820</ns2:BillToAccountContactIdentifier>
<ns2:PartialShipAllowedFlag>FALSE</ns2:PartialShipAllowedFlag>
<ns2:OrderCharge>
<ns2:ChargeDefinitionCode>QP_SALE_PRICE</ns2:ChargeDefinitionCode>
<ns2:ChargeSubtypeCode>ORA_PRICE</ns2:ChargeSubtypeCode>
<ns2:PriceTypeCode>ONE_TIME</ns2:PriceTypeCode>
<ns2:PricedQuantity>1</ns2:PricedQuantity>
<ns2:PricedQuantityUOM>Each</ns2:PricedQuantityUOM>
<ns2:PricedQuantityUOMCode/>
<ns2:PrimaryFlag>true</ns2:PrimaryFlag>
<ns2:ApplyTo>PRICE</ns2:ApplyTo>
<ns2:RollupFlag>false</ns2:RollupFlag>
<ns2:SourceChargeIdentifier>SC1</ns2:SourceChargeIdentifier>
<ns2:ChargeCurrencyCode>USD</ns2:ChargeCurrencyCode>
<ns2:ChargeTypeCode>ORA_SALE</ns2:ChargeTypeCode>
<ns2:ChargeCurrencyCode/>
<ns2:SequenceNumber>1</ns2:SequenceNumber>
<ns2:PricePeriodicityCode/>
<ns2:GsaUnitPrice/>
<ns2:OrderChargeComponent>
<ns2:ChargeCurrencyCode>USD</ns2:ChargeCurrencyCode>
<ns2:HeaderCurrencyCode>USD</ns2:HeaderCurrencyCode>
<ns2:HeaderCurrencyExtendedAmount>10001</ns2:HeaderCurrencyExtendedAmount>
<ns2:PriceElementCode>QP_LIST_PRICE</ns2:PriceElementCode>
<ns2:SequenceNumber>1</ns2:SequenceNumber>
<ns2:PriceElementUsageCode>LIST_PRICE</ns2:PriceElementUsageCode>
<ns2:ChargeCurrencyUnitPrice>100</ns2:ChargeCurrencyUnitPrice>
<ns2:HeaderCurrencyUnitPrice>100</ns2:HeaderCurrencyUnitPrice>
<ns2:RollupFlag>false</ns2:RollupFlag>
<ns2:SourceParentChargeComponentId/>
<ns2:SourceChargeIdentifier>SC1</ns2:SourceChargeIdentifier>
<ns2:SourceChargeComponentIdentifier>SCC2</ns2:SourceChargeComponentIdentifier>
<ns2:ChargeCurrencyExtendedAmount>3027</ns2:ChargeCurrencyExtendedAmount>
</ns2:OrderChargeComponent>
<ns2:OrderChargeComponent>
<ns2:ChargeCurrencyCode>USD</ns2:ChargeCurrencyCode>
785
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
<ns2:HeaderCurrencyCode>USD</ns2:HeaderCurrencyCode>
<ns2:HeaderCurrencyExtendedAmount>10001</ns2:HeaderCurrencyExtendedAmount>
<ns2:ChargeCurrencyExtendedAmount>10001</ns2:ChargeCurrencyExtendedAmount>
<ns2:PriceElementCode>QP_NET_PRICE</ns2:PriceElementCode>
<ns2:SequenceNumber>2</ns2:SequenceNumber>
<ns2:PriceElementUsageCode>NET_PRICE</ns2:PriceElementUsageCode>
<ns2:ChargeCurrencyUnitPrice>100</ns2:ChargeCurrencyUnitPrice>
<ns2:HeaderCurrencyUnitPrice>100</ns2:HeaderCurrencyUnitPrice>
<ns2:RollupFlag>false</ns2:RollupFlag>
<ns2:SourceParentChargeComponentId/>
<ns2:SourceChargeIdentifier>SC1</ns2:SourceChargeIdentifier>
<ns2:SourceChargeComponentIdentifier>SCC1</ns2:SourceChargeComponentIdentifier>
</ns2:OrderChargeComponent>
</ns2:OrderCharge>
</ns2:Line>
<ns2:Payment>
<ns2:PaymentTypeCode>ORA_CREDIT_CARD</ns2:PaymentTypeCode>
<ns2:SourceTransactionPaymentIdentifier>H101</ns2:SourceTransactionPaymentIdentifier>
</ns2:Payment>
</ns2:Order>
</ns1:request>
</ns1:createOrders>
</soap:Body>
</soap:Envelope>
Note.
• To use this feature, you must enable the FOM_ENABLE_CARD_PAYMENT order profile. For details, see the
Enable the Credit Card Feature in Order Management topic.
• This feature applies only for source orders that you import through REST API.
• You can process credit card details in Oracle Fusion Applications only under controlled availability.
• Credit card processing is available only for Oracle Fusion Applications services that use Oracle Fusion Payments.
• Credit card processing is available only in data centers where Oracle Fusion Payments is certified for Payment
Card Industry Data Security Standard (PCI DSS v3.2.1).
786
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
• You can use Oracle Fusion Payments only with payment gateways that can process tokens and credit card
payments. For details about the certified data centers and payment gateways that you can use, see Is Credit
Card Processing Supported In Oracle Fusion Applications? (Doc ID 1949941.1) on My Oracle Support.
• Send tokenization attributes for the credit card only when the Payment Method attribute equals Credit Card. If
you don't use this method, then Order Management won't create the sales order.
• The Credit Card Token attribute is required only if your import payload includes the token attributes for the
credit card.
Caution: You must never send credit card numbers to Oracle Fusion Cloud Service that aren't tokenized. If they aren't
tokenized, then you must modify them so they don't reveal the actual card number. For example, you can truncate the
number so that you send no more than the first six digits or the last four digits of the number. You must never send
the credit card data, including credit card tokens, outside the supported business flows through a file, attachment,
email, descriptive flexfield, or any other attribute.
787
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
How it Works
Here's a summary of how it works.
Note.
788
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
REST API
Use attributes in your REST API payload.
Scenario Variation
789
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
Scenario Variation
Related Topics
• Overview of Displaying Customer Details on Sales Orders
• How Authorizations for Credit Cards Are Processed
• More Code Examples for Order Management Extensions
Projects
Overview of Setting Up Projects in Order Management
Create and fulfill sales orders that include project attributes, such as Project Number, Task Number, and Expenditure
Organization.
Store project details on sales orders and order lines to reduce order processing time and improve the accuracy of
tracking cost, revenue, and profitability throughout your supply chain.
• Store project details on each sales order.
• Fulfill all sales order for one project from the same inventory.
• Examine the cost of services and items that you shipped for the project.
• Compare budgeted costs to actual costs.
• Create an invoice according to percent complete or milestone.
• Manage more than one project from the same set of warehouses while maintaining visibility to material and
cost for each project.
• Ship each sales order for your project from project inventory or common inventory, according to your business
rules.
• Create a business rule that reserves project-specific inventory first, then reserves the remaining quantity from
common inventory.
• Set up orchestration so it reserves order line quantity in project-specific inventory, a mix of project-specific and
common inventory, or only common inventory.
• If you ship from common inventory, then you can send the cost of shipped goods to the project during
shipment.
790
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
• Use the ProjectRecordIndicator attribute to prevent Order Management from sending project-specific order
lines to Receivables. Use the indicator when you set up your orchestration process and set up your assignment
rule.
For example, Green Corp. bids on a project to design and supply 100 custom batteries for an electric vehicle
manufacturer. Green Corp. expects design and development will require 100 hours at a cost of $50,000, and it will cost
$1,000 to manufacture each unit. Green Corp. adds 40% overhead and profit, and bids the job at $210,000, or $2,100
for each battery. Green Corp. decides to run invoicing from the sales order when it ships the first 20 batteries, and then
again when it ships the remaining 80.
Green Corp. creates a project to capture cost and revenue, and then to calculate gross margin for the project.
• Set up a project with a cost budget of $150,000 and revenue budget of $210,000.
• Use the existing Quick Charge Battery item as the base item. Don't modify the original set up for this item
because most items on the project are minor variances of Quick Charge Battery.
• Standard cost for Quick Charge Battery is $1,000.
• Charge 90 hours at a total of $45,000 directly to the project for design and development.
• Include $100,000 for material in the project.
• Project creates invoice for $210,000.
The project captures cost for manufacturing, design and development. It also captures revenue. For brevity, this
example doesn't include shipping and other costs.
791
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
How it Works
Note.
1. Create a sales order that includes project details, such as project number, task number, and so on.
Order Management gets the list of projects defined in Project Management, filters them according to Sales
Order Business Unit and Warehouse Business Unit, then displays them as choices in the Edit Project Details
dialog on the order line.
792
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
The user clicks Submit, then Order Management validates each order line that includes project details. For
example, Order Management makes sure.
◦ The project that the user chooses is associated with a project contract.
◦ The value in the Ship-to Address attribute on the order line matches the value in the Ship-to Address for
the contract.
◦ The value in the Bill-to Address attribute on the order line matches the value in the Bill-to Address for the
contract.
If validation fails, Order Management displays an error and the user must update the order and submit again.
For details about how to set up and manage projects, see book Using Project Costing on Oracle Help Center.
2. An orchestration process orchestrates fulfillment for the item, including schedule, reserve, and ship.
The ProjectRecordIndicator attribute comes predefined as set to No. If the Order Entry Specialist adds project
details, then Order Management sets it to Yes, then sends it in a request to Warehouse Management. Shipping
ships the order line, then uses the indicator to determine whether to add project details to the inventory
transaction.
3. Fulfillment.
◦ Global Order Promising promises and schedules without the context of the project, project task, or other
project details, and updates order fulfillment details.
Global Order Promising determines the warehouse for the order line, then Order Management
validates the line again immediately before the orchestration process sends the line to shipping. Order
Management also sets the Scheduled Ship Date to the Expenditure Item Date so it reflects the actual
transaction date.
◦ Inventory Management reserves the item in inventory.
◦Warehouse Management creates the shipment, picks the item from inventory, ships the item, then sends
shipment confirmation to Cost Management.
4. Cost Management uses the sales order as input when it does cost accounting.
5. Project Management imports costs into the project.
If you enable Grants Management, then the Order Management work area displays the Contract Number and Funding
Source attributes.
You can't.
• Include project details in a drop-ship or back-to-back flow. For details, see the Overview of Drop Ship in Order
Management topic and the Overview of Back-to-Back Fulfillment topic.
• Send a transfer order that includes project details through Order Management.
• Use project details with sales orders that you capture through a business-to-business flow (B2B) or electronic
data interchange (EDI).
• Use project details to bill an item that provides a service, such as a coverage or subscription.
• Do order promising according to project or project task.
793
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
Extend
Include project attributes in an order management extension.
Order Management calls Project Management when the On Start of Submission event occurs. The call validates the
changes that the Order Entry Specialist makes.
For example.
if("PROJECT EXTN".equals(header.getAttribute("CustomerPONumber"))){
def lines = header.getAttribute("Lines"){
while(lines.hasNext()){
def line = lines.next();
if("N".equals(line.getAttribute)("ProjectRecordIndicator"))){
def rowIter = line.getAttribute("Projects");
def row = rowIter.createRow();
row.setAttribute("ProjectNumber","BAT-PJCBAT-Proj-02");
794
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
row.setAttribute("TaskId",new BigDecimal"1000000019394094");
row.setAttribute("ExpenditureType","Cartridges");
row.setAttribute("ExpenditureOrganization","Vision Operations");
row.setAttribute("ExpenditureItemDate",java.sql.Date.valueOf("2018-07-30"));
rowIter.insertRow(row);
}
}
}
Note.
• Examine the ProjectRecordIndicator attribute to determine whether the order line contains project details.
• Set a value for each of the required project attributes.
◦ ProjectNumber
◦ TaskId
◦ ExpenditureType
◦ ExpenditureOrganization
◦ ExpenditureItemDate
• Use extension event On Save, On Start of Submission, or On End of Submission to read project attributes on
the order line and ProjectRecordIndicator.
• Use the On Save event or the On Start of Submission event to update project attributes on the order line.
• Use an extension to set the default value of a project attribute when the value is empty.
• Don't use.
795
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
Constrain
The DOO_PRJ_FULFILLMENTLINE_UPDATE processing constraint comes predefined to prevent the Order Entry
Specialist from updating a fulfillment line that includes project details. You can disable it to meet your business
requirements. For details about how, see the Processing Constraints topic.
Related Topics
• Different Ways of Managing Project Lifecycle
• Overview of Back-to-Back Fulfillment
• Overview of Creating Order Management Extensions
• Import Different Kinds of Data
• Overview of Project Execution Management Offering Implementation
796
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
• Import the project number, task number, expenditure organization, and other attributes for each project.
• Set the default value for expenditure type, user defined attributes, contract number, and funding source when
you do your import.
• Include pricing in the source order that you import, or leave pricing empty in the source order and do pricing in
Order Management.
Here's the part of the payload where you include project details. All attributes are required.
<ns2:Project xmlns:pjc="http://xmlns.oracle.com/apps/flex/scm/doo/processOrder/pjcDff/" xmlns:xsi="http://
www.w3.org/2001/XMLSchema-instance">
<ns2:PJCDFFVA xsi:type="pjc:OmSalesOrder">
<pjc:projectId_Display>PDSC-CT-PDSCM1X-004</pjc:projectId_Display>
<pjc:taskId_Display>1.1.1</pjc:taskId_Display>
<pjc:expenditureItemDate>2019-03-20</pjc:expenditureItemDate>
<pjc:expenditureTypeId_Display>Material</pjc:expenditureTypeId_Display>
<pjc:organizationId_Display>Vision Operations</pjc:organizationId_Display>
</ns2:PJCDFFVA>
</ns2:Project>
where
pjcDff Indicates that you're using a descriptive flexfield to store project details.
xsi:type Identifies the source type as OmSalesOrder, which means Order Management sales order.
797
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
Reservation ID The example payload doesn't include this attribute. The web service uses the attribute only for
earlier releases. For the current release, the value is empty, and the web service doesn't use it.
_Display indicates to use the value when we display the attribute in an Oracle Fusion application.
798
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
<ns2:Line>
<ns2:SourceTransactionLineIdentifier>101</ns2:SourceTransactionLineIdentifier>
<ns2:SourceTransactionScheduleIdentifier>101</ns2:SourceTransactionScheduleIdentifier>
<ns2:SourceTransactionLineNumber>1</ns2:SourceTransactionLineNumber>
<ns2:SourceTransactionScheduleNumber>1</ns2:SourceTransactionScheduleNumber>
<ns2:ParentLineReference/>
<ns2:RootParentLineReference/>
<ns2:TransactionCategoryCode>ORDER</ns2:TransactionCategoryCode>
<ns2:ProductNumber>OM-PDSC-STD-03-C</ns2:ProductNumber>
<ns2:OrderedQuantity>100</ns2:OrderedQuantity>
<ns2:OrderedUOM>Each</ns2:OrderedUOM>
<ns2:RequestedFulfillmentOrganizationCode>PDSCM1</ns2:RequestedFulfillmentOrganizationCode>
<ns2:CustomerPONumber>NKPO2017/10/005/01</ns2:CustomerPONumber>
<ns2:CustomerPOLineNumber>1</ns2:CustomerPOLineNumber>
<ns2:RequestedShipDate>2019-06-30T23:08:52Z</ns2:RequestedShipDate>
<ns2:PaymentTerms>30 Net</ns2:PaymentTerms>
<ns2:PartialShipAllowedFlag>false</ns2:PartialShipAllowedFlag>
<ns2:Comments/>
<ns2:TaxExempt>S</ns2:TaxExempt>
<ns2:ShipToPartyName>FOM-Customer-001</ns2:ShipToPartyName>
<ns2:ShipToAddress1>1045, 5th Avenue</ns2:ShipToAddress1>
<ns2:ShipToCity>San Diego Country Estate</ns2:ShipToCity>
<ns2:ShipToPostalCode>92065</ns2:ShipToPostalCode>
<ns2:ShipToState>CA</ns2:ShipToState>
<ns2:ShipToCountry>US</ns2:ShipToCountry>
<ns2:ShipToPartyContactName>James Pattison</ns2:ShipToPartyContactName>
<ns2:BillToPartyType>ORGANIZATION</ns2:BillToPartyType>
<ns2:BillToCustomerName>FOM-Customer-001</ns2:BillToCustomerName>
<ns2:BillToCustomerIdentifier>300100046859202</ns2:BillToCustomerIdentifier>
<ns2:BillToAddress1>1045, 5th Avenue</ns2:BillToAddress1>
<ns2:BillToCity>San Diego Country Estate</ns2:BillToCity>
<ns2:BillToPostalCode>92065</ns2:BillToPostalCode>
<ns2:BillToState>CA</ns2:BillToState>
<ns2:BillToCountry>US</ns2:BillToCountry>
<ns2:BillToAccountContactName>James Pattison</ns2:BillToAccountContactName>
<ns2:Project xmlns:pjc="http://xmlns.oracle.com/apps/flex/scm/doo/processOrder/pjcDff/" xmlns:xsi="http://
www.w3.org/2001/XMLSchema-instance">
<ns2:PJCDFFVA xsi:type="pjc:OmSalesOrder">
<pjc:projectId_Display>PDSC-CT-PDSCM1X-004</pjc:projectId_Display>
<pjc:taskId_Display>1.1.1</pjc:taskId_Display>
<pjc:expenditureItemDate>2019-03-20</pjc:expenditureItemDate>
<pjc:expenditureTypeId_Display>Material</pjc:expenditureTypeId_Display>
<pjc:organizationId_Display>Vision Operations</pjc:organizationId_Display>
</ns2:PJCDFFVA>
</ns2:Project>
<ns2:AdditionalFulfillmentLineInformationCategories
xsi:type="ns12:j_FulfillLineEffDooFulfillLinesAddInfoprivate" xmlns:ns12="http://xmlns.oracle.com/
apps/scm/doo/processOrder/flex/fulfillLineCategories/" xmlns:ns22="http://xmlns.oracle.com/apps/scm/doo/
processOrder/flex/fulfillLineContextsB/" xmlns:ns8="http://xmlns.oracle.com/apps/scm/doo/processOrder/
model/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<ns8:Category>DOO_FULFILL_LINES_ADD_INFO</ns8:Category>
<ns12:FulfillLineEffBShipment__InstructionsprivateVO>
<ns8:ContextCode>Shipment Instructions</ns8:ContextCode>
<ns22:packInstructions>OM-PI-Test</ns22:packInstructions>
<ns22:shipInstructions>OM-SI-Test</ns22:shipInstructions>
<ns22:handlingCost>12.5</ns22:handlingCost>
<ns22:needByDate>2018-10-15</ns22:needByDate>
<ns22:expectedPickDate>2018-10-15T12:12:12</ns22:expectedPickDate>
</ns12:FulfillLineEffBShipment__InstructionsprivateVO>
</ns2:AdditionalFulfillmentLineInformationCategories>
</ns2:Line>
<ns2:Line>
</ns2:Order>
</ns1:request>
</ns1:createOrders>
</soap:Body>
799
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
</soap:Envelope>
For brevity, this payload contains only one order line. To see a more complete payload, see White Papers for
Order Management Cloud (Doc ID 2051639.1) at https://support.oracle.com/epmos/faces/DocumentDisplay?
_afrLoop=472607338634463&id=2051639.1. Download attachment Payloads and Other Files That Support
Implementation.
The web service validates the business unit for the selling profit center and the warehouse during the On Submission
event.
◦ Project Number
◦ Task Number
◦ Expenditure Organization
◦ Expenditure Item Date
◦ Expenditure Type
• The flow has assigned a contract to the project.
• The expenditure item date that the user set occurs within the project start date and finish date.
• The bill-to address on the sales order matches the bill-to address of the contract.
• The ship-to address on the sales order matches the ship-to address of the contract.
If validation fails, then Order Management displays a warning or error and a suggestion of how to fix it.
Order Management does these validations to prevent problems from occurring during shipping or when it invoices the
contract. For example, if the ship-to location on the sales order doesn't match the ship-to location on at least one of the
contract lines, then the sales order might use an incorrect tax when Order Management invoices the contract for the
project. Shipping might also ship the item to an incorrect location. The user would need to change the fulfillment line
and manually recover the order so Order Management can send the corrected lines to shipping.
Here's an example response that the web service sends when the expenditure item date occurs outside the project
dates.
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<ns1:createOrders
<ns0: createOrdersResponse xmlns:ns0="http://xmlns.oracle.com/apps/scm/fom/importOrders/orderImportService/
types/">
<ns1:result xsi:type="ns0:OrderImportResponse xmlns:ns1=
"http://xmlns.oracle.com/apps/scm/fom/importOrders/orderImportService/">
<ns0:Order>
<ns0:SourceTransactionNumber>RRFPDSC_TEST_112</ns0:SourceTransactionNumber>
<ns0:SourceTransactionIdentifier>RRFPDSC_TEST_112</ns0:SourceTransactionIdentifier>
<ns0:SourceTransactionSystem>LEG</ns0:SourceTransactionSystem>
<ns0:OrderNumber>514626</ns0:OrderNumber>
<ns0:HeaderId>xsi:nil="true"</ns0:HeaderId>
<ns0:OrderStatus>DOO_DRAFT</ns0:OrderStatus>
<ns0:ReturnStatus>ERROR</ns0:ReturnStatus>
<ns0:MessageName>env:Server</ns0:MessageName>
800
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
<ns0:MessageText>The submit failed for sales order RRFPDSC_TEST_112 on order line1, in schedule 1. The
expenditure item date occurs outside the project dates. Change the project start and finish dates, or
change the expenditure item date.</ns0:MessageText>
<ns0:flowType>xsi_nil="true"</ns0:flowType>
• Import a batch. Import sales order lines that include project details and lines that don't in the same batch.
• Import project details for shippable items.
• Import configured items.
• Validate the combination of project attributes as part of the order submission process.
• Use the DOO_PROJECTS_INT worksheet in the template to capture project attributes on the sales order line.
Attribute Value
Source Transaction Line Identifier Identify the order line in the source transaction, such as 1.
Source Transaction Schedule Identify the schedule in the source transaction, such as 1.
Identifier
Include a value for at least one of these attributes, such as 300100113461421 for Project ID.
Include a value for at least one of these attributes, such as 1.1 for Task Number.
Include a value for at least one of these attributes, such as Material for Expenditure Type.
801
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
Attribute Value
Expenditure Organization or Identify the business unit, such as Vision Operations for Expenditure Organization.
Expenditure Organization ID
Contract Number or Contract ID If you enable grants for the project, then identify the contract.
Funding Source Number or Funding If you enable grants for the project, then identify the funding source.
Source Id
For some templates that include example values, see White Papers for Order Management Cloud (Doc ID 2051639.1) at
https://support.oracle.com/epmos/faces/DocumentDisplay?_afrLoop=472607338634463&id=2051639.1. Download
attachment Payloads and Other Files That Support Implementation.
For more details, see the Guidelines for Importing Orders into Order Management topic. For assistance with using the
template to import project details, contact Oracle support.
Resource Description
Project Includes the DooOrderPrjId attribute. It identifies the project, such as 300100010341182.
Here are attributes from an example payload that uses the project detail resource.
"DooOrderPrjId": 300100181049087,
"__FLEX_Context": "OM_Sales_Order",
"__FLEX_Context_DisplayValue": "SCM: General",
"projectId": 300100010341182,
802
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
"projectId_Display": "Projects-TL-Int-01",
"taskId": 300100010341193,
"taskId_Display": "1.1",
"expenditureItemDate": null,
"expenditureTypeId": 10028,
"expenditureTypeId_Display": "Material",
"organizationId": 204,
"organizationId_Display": "Vision Operations",
"contractId": null,
"contractId_Display": null,
"reservedAttribute1": null,
"reservedAttribute1_Display": null,
"billableFlag": null,
"billableFlag_Display": null,
"capitalizableFlag": null,
"capitalizableFlag_Display": null,
"workTypeId": null,
"workTypeId_Display": null,
Here's an example payload that creates a sales order for item AS92888 in a project named Projects-TL-Int-01. It includes
display attributes that use values to identify the project, such as projectId_Display.
URL: https://fuscdrmsmc347-fa-ext.myCompany.com:443/fscmRestApi/resources/11.13.20.01/salesOrdersForOrderHub
METHOD: POST
{
"SourceTransactionNumber": "R13_project_valueattrs_01",
"SourceTransactionSystem": "GPR",
"SourceTransactionId": "R13_project_valueattrs_01",
"BusinessUnitId": 204,
"BuyingPartyId": 1006,
"BuyingPartyContactId": 2663,
"TransactionalCurrencyName": "US Dollar",
"RequestedShipDate": "2019-01-20T20:51:21+00:00",
"PartialShipAllowedFlag": false,
"RequestingBusinessUnitId": 204,
"RequestingLegalEntityId": 204,
"FreezePriceFlag": "N",
"FreezeTaxFlag": "N",
"RequestedFulfillmentOrganizationId":207,
"PaymentTerms": "30 Net",
"SubmittedFlag": true,
"billToCustomer": [
{
"CustomerAccountId": 1006,
"SiteUseId": 1025,
"ContactFirstName": "Sarah",
"ContactLastName": "Takesh"
}
],
"shipToCustomer": [
{
"PartyId": 1006,
"SiteId": 1036
}
],
"lines": [
{
"SourceTransactionLineId": "1",
"SourceTransactionLineNumber": "1",
"SourceScheduleNumber": "1",
"SourceTransactionScheduleId": "1",
"ProductNumber": "AS92888",
"OrderedUOMCode": "Ea",
"PurchasingUOMCode": "Ea",
"OrderedQuantity": 1,
"project": [
803
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
{
"projectDetail": [
{
"projectId_Display": "Projects-TL-Int-01",
"taskId_Display": 1.1,
"expenditureTypeId_Display": "Material",
"organizationId_Display": "Vision Operations",
"contractId": null,
"reservedAttribute1": null,
"billableFlag": null,
"capitalizableFlag": null,
"workTypeId": null
}
]
}
]
}
]
}
Here's another example that creates a sales order for item AS92888 in project 300100010341182. It includes attributes
that use an identifier to identify the project, such as projectId.
URL: https://fuscdrmsmc347-fa-ext.myCompany.com:443/fscmRestApi/resources/11.13.20.01/salesOrdersForOrderHub
METHOD: POST
{
"SourceTransactionNumber": "R13_project_Idattrs_01",
"SourceTransactionSystem": "GPR",
"SourceTransactionId": "R13_project_Idattrs_01",
"BusinessUnitId": 204,
"BuyingPartyId": 1006,
"BuyingPartyContactId": 2663,
"TransactionalCurrencyName": "US Dollar",
"RequestedShipDate": "2019-01-20T20:51:21+00:00",
"PartialShipAllowedFlag": false,
"RequestingBusinessUnitId": 204,
"RequestingLegalEntityId": 204,
"FreezePriceFlag": "N",
"FreezeTaxFlag": "N",
"RequestedFulfillmentOrganizationId":207,
"PaymentTerms": "30 Net",
"SubmittedFlag": true,
"billToCustomer": [
{
"CustomerAccountId": 1006,
"SiteUseId": 1025,
"ContactFirstName": "Sarah",
"ContactLastName": "Takesh"
}
],
"shipToCustomer": [
{
"PartyId": 1006,
"SiteId": 1036
}
],
"lines": [
{
"SourceTransactionLineId": "1",
"SourceTransactionLineNumber": "1",
"SourceScheduleNumber": "1",
"SourceTransactionScheduleId": "1",
"ProductNumber": "AS92888",
"OrderedUOMCode": "Ea",
"PurchasingUOMCode": "Ea",
804
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
"OrderedQuantity": 1,
"project": [
{
"projectDetail": [
{
"projectId": 300100010341182,
"taskId": 300100010341193,
"expenditureTypeId": 10028,
"organizationId": 204,
"expenditureItemDate": "2019-09-24",
"contractId": null,
"reservedAttribute1": null,
"billableFlag": null,
"capitalizableFlag": null,
"workTypeId": null
}
]
}
]
}
]
}
For details about how to use REST API, see Sales Orders for Order Hub at https://docs.oracle.com/en/cloud/saas/
supply-chain-and-manufacturing/19d/fasrp/api-sales-orders-order-hub.html.
Related Topics
• Import Different Kinds of Data
Create an orchestration process that doesn't include an invoice task, then assign the process to the Project line
type.
• Create an orchestration process that does include an invoice task and that uses line selection criteria to skip the
lines that include the Project line type.
In this example, assume you must modify the ShipOrderGenericProcess orchestration process, and that you already
released this process into production.
1. Enable the Process Sales Orders for Projects opt-in feature. For details, see the Opt Into Features in Order
Management topic.
805
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
806
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
3. Create a lookup.
Attribute Value
Name CUSTOM_ORA_DOO_LINE_TYPES
Description Allow Order Entry Specialist to specify whether order line contains project details.
Module Orchestration
Attribute Value
Sequence 1
Attribute Value
Sequence 2
Related Topics
• Opt Into Features in Order Management
• Manage Lookups in Order Management
807
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
Agreements
Overview of Setting Up Sales Agreements in Order Management
Set up Order Management so it uses a sales agreement that applies pricing terms when your customer buys from your
company, such as offering a reduced price when buying a specific quantity of an item over time.
Here's what you can do with sales agreements.
808
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
Note.
1. If you use a web service or file to import the order, and if your source system.
◦ Already priced the order. Skip steps 2 through 7. Instead, validate the order and start orchestration.
◦ Didn't price the order. Go to step 3.
2. The Order Entry Specialist sets the customer and business unit on the order header.
3. Order Management sends the sold-to party, business unit, currency, and current system date to Contract
Management.
809
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
4. Contract Management searches all of its contracts. It applies filters during the search.
Contract Management sends the contracts that pass these filters to Order Management. Here are the attributes
that it sends for each contract.
◦ Contract ID
◦ Version Number
◦ Contract Number
◦ Contract Name
◦ Description
◦ Start Date
◦ End Date
5. Select contract.
◦Order Management displays the list of filtered contracts in the Sales Agreement attribute on the order
header.
◦ If Contract Management sends only one contract, then Order Management sets Sales Agreement to this
contract, by default.
◦ The Order Entry Specialist chooses a contract in the Sales Agreement attribute. Order Management
references this value later when it sets the sales agreement number on each order line.
◦ Order Management searches for an item on the catalog line, then sends a request to Pricing
Administration to calculate price. Assume you already defined an agreement line for the item.
6. Pricing gets contract details from Contract Management, prices the order line, then sends the result to Order
Management.
7. The Order Entry Specialist clicks Submit.
8. Order Management validates the sales order to make sure the contract is active, the current system date occurs
within the contract date, that the contract line and version are valid, then starts orchestration.
Note.
• Order Management processes each order line as soon as the Order Entry Specialist enters it. It repeats step 6
for each order line.
• If the Order Entry Specialist doesn't set an agreement on the order header, and doesn't set an agreement on
the order line, then Pricing prices the item in the same way it prices without an agreement.
810
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
• Filters values that it allows the user to choose in the Sales Agreement attribute.
• Gets values from attributes in Contract Management, then displays them in the sales order.
811
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
If you set Start Date on the agreement line in Contract Management, then Contract Start
Date contains the agreement line date.
If you set End Date on the agreement line in Contract Management, then Contract End Date
contains the agreement line date.
• Applies a 10% discount on each order line when Computer Service and Rentals orders a quantity of 10 or more
of item AS54888.
Pricing calculates price for the item on the catalog line according to the price adjustment you specify in the sales
agreement. The Sales Agreement attribute on the order header specifies the agreement to apply.
812
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
813
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
Note.
Attribute Value
• Apply to Qualifying Price Lists. Apply the price adjustment that you set up on
the agreement regardless of whether the price list on the sales order matches the
negotiated price list on the sales agreement.
• Enforce Price List and Apply Price. Apply the price adjustment only if the price list on
the sales order matches the negotiated price list on the sales agreement.
Price List Specify the price list to set the price for the item. For details, see the Manage Price Lists topic.
Price Type
List Price
814
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
Attribute Value
Adjustment Type Specify the type of adjustment, such as discount amount or discount percent.
Adjustment For example, if list price is $1000, and if you set Adjustment Type to Discount Percent,
Adjustment to 10, and Adjustment Basis to List Price, then the adjustment equals one of these
values.
Adjustment Basis
• 1000 list price multiplied by 10 percent equals 100 adjustment
• 1000 list price minus 100 adjustment equals 900 amount
You can also create a tier adjustment according to quantity or extended amount.
For an example that includes a value for each adjustment type, and details about tiers, see the
Add Tiers to Pricing Rules topic.
Allow Price Override on Order Allow the Order Entry Specialist to edit Your Price on the sales order.
Apply Pricing Strategy Adjustments Apply adjustments that the pricing strategy calculates.
For details, see the How Profiles, Segments, and Strategies Work Together topic.
Pricing uses the Apply Pricing Terms pricing algorithm to apply the pricing terms it receives from Contracts.
815
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
This algorithm evaluates and applies a list of pricing terms to each charge for the item.
816
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
For an example that modifies pricing terms, see the Set Up Discounts That Accumulate or Cascade topic.
Note.
• Use Oracle Application Development Framework (ADF), File-Based Data Import (FBDI), REST API, or electronic
data interchange (EDI) in a Business-to-Business implementation.
• Use these technologies to create, edit, view, or revise sales orders.
• You must enable the Add Sales Agreements to Sales Orders opt-in feature to import or integrate.
• For details about the attributes you can import or integrate, see the Reference for Setting Up Sales Agreements
in Order Management topic.
• Use a POST operation with the Sales Orders for Order Hub REST API.
• Use the Create Order operation or Stage Order operation with an ADF web service.
817
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
Pricing a configured item is similar to pricing an item that isn't configured. Assume the user sets the agreement on the
order header to 101. If the user searches for a configured item on the catalog line, then clicks.
• Configure and Add. Order Management displays the configurator, and Pricing uses agreement 101 to price
each configure option.
If sometime later, the user clicks View Components on the order line, then, in the dialog, Order Management
sets the agreement for each configure option to 101. If the user changes this agreement to 102, then Pricing
uses agreement 102 to price the option.
• Add. Order Management adds an order line, sets the order line agreement to 101, and prices the item and its
configure options according to agreement 101.
If the user changes the order line agreement to 102, clicks Edit on the line and edits the configured item, then
Pricing uses agreement 102 to price configure options.
818
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
Report
Use the Reports and Analytics work area to get data that includes sales agreement attributes.
Next, expand Sales Agreement to examine the attributes you can use in your report.
For details, see the Use Reports and Analytics with Order Management topic.
819
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
Reference the Sales Agreement attribute in a processing constraint, pretransformation rule, order approval rule, or order
management extension.
Related Topics
• Manage Price Lists
• Add Tiers to Pricing Rules
• How Profiles, Segments, and Strategies Work Together
• Create Discounts That Accumulate or Cascade
• Use Reports and Analytics with Order Management
820
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
Attribute Value
Type SalesAgreement
Number 101
This value will display in the Sales Agreement attribute throughout the Order Management
work area.
Currency USD
Intent Sell
821
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
5. On the Edit Contract page, click Lines > Actions > Add, set values, then click Submit.
Attribute Value
Type Product
Name AS54888
UOM Each
Adjustment 10
Related Topics
• Overview of Enterprise Contracts
822
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
Value is LINE.
823
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
Related Topics
• How Service Mappings, Pricing Algorithms, and Matrixes Work Together
Trade Compliance
Overview of Setting Up Trade Compliance
Use Order Management Cloud with your trade management solution to create and manage trade transactions that
comply with global import trade rules, export global trade rules, and other trade regulations that the country or region
requires.
Some governments and companies impose rules and regulations on trade with different countries, people, companies,
financial institutions, and so on. Use trade compliance to meet these rules.
• Trade compliance is a structure of rules that makes sure trade between countries or regions occurs only
according to the approved laws and guidelines that these countries or regions use.
• Manage legal, regulatory, and corporate requirements for each transaction that crosses a government border,
such as across states, provinces, regions, or countries, according to the unique requirements of each country,
region, company, and so on.
824
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
For example, set up trade controls that apply United States rules and Chinese rules on each transaction that
occurs between a company that resides in the United States and another one that resides in China.
• Apply trade controls on various items, such as munitions, computer equipment, licenses, license exceptions,
documents, registrations, and so on.
• Manage trade compliance policy, hold transactions until they clear trade compliance screening, and so on.
• Screen each sales order for restricted parties and sanctioned countries when submitting the sales order in
Order Management.
• Don't screen sales order at submit, but do screen before shipping.
• Screen each sale order at different points during a long fulfillment cycle.
Here's an example flow that illustrates how you can use your trade management solution with Order Management.
This supply chain imports raw materials from more than one source into a factory in the United States, sends a partially
finished assembly to a factory in Europe, then sends the final assembly to distribution centers in more than one country
in Africa.
Each import and export point might require a different set of trade compliance rules for each transaction. For example,
you can manage compliance according to trade compliance policies.
• Product classification, such as weapons or dangerous chemicals
• Export and import embargo
• Status on the Denied and Restricted Parties List
825
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
Your users can manage compliance in the Order Management work area.
Related Topics
• Manage Sales Orders That Require Trade Compliance Screening
826
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
827
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
Note.
1. An Order Entry Specialist creates a sales order in the Order Management work area, then clicks Submit. Order
Management validates the sales order in the same way it validates any sales order, then sends it to Global Trade
Management for screening.
◦ If you set order management parameter Check for Trade Compliance When User Submits Sales Order to
Yes, then Order Management sends a request to Global Trade Management to screen the sales order for
trade compliance.
◦ Global Trade Management can screen an item that isn't configured, a configured item, or a change order.
◦ You can screen a source order that you import form a source system.
◦ You can screen only for restricted part or sanctioned territory during order submit.
◦ This integration can't screen a return line.
2. Global Trade Management screens the sales order.
◦Apply trade compliance policies that you set up for this integration to the sales order, then create a
screening result. Global Trade Management supports a variety of compliance screening types. For
example, restricted party, sanctioned countries or territories, and trade control.
◦ Set the trade compliance status to Passed, Under Review, or Failed, according to the screening result. You
can't modify this value.
◦ If the trade compliance status is Failed or Under Review, then provide the screening failure reason for
each order line that fails screening.
◦ Send the screening result to Order Management. You can use the screening result in a constraint or
approval rule.
3. Order Management updates the trade compliance status on the sales order according to the most restrictive
trade compliance status that applies on the order lines in the sales order.
For example, if status is Failed for one order line, then the sales order status is Failed.
Here's the hierarchy that Order Management uses to determine which status is most restrictive, where 1 is least
restrictive, and 3 is most restrictive.
1. Passed
2. Under Review
3. Failed
Note.
◦ Global Trade Management typically finishes screening and sends the result to Order Management
without delay. However, Global Trade Management might require a few minutes to screen a large or
complex sales order.
◦ If the sales order hasn't moved to order fulfillment, then the Order Entry Specialist can click Actions, then
click Revert to Draft. Order Management will set order status to Draft and stop screening.
4. If screening fails, then Order Management sends the sales order back to the Order Entry Specialist because a
predefined processing constraint prevents Order Management from submitting a sales order that includes a
trade compliance exception. The Order Entry Specialist can modify or cancel the sales order.
You can disable the constraint or create a new one that allows the sales order to proceed according to a
condition. For details, see the Constrain Compliance Screening topic.
5. If screening doesn't fail, then Order Management sends the sales order to order fulfillment.
828
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
If the constraint allows the sales order to proceed according to a condition, then, as an option, you can set up
an approval rule that uses the trade compliance result of the order header or order line to route the sales order
to an Order Manager for approval.
6. As an option, you can also screen during order fulfillment according to an orchestration process step that you
set up.
This flow uses Oracle Global Trade Management as the trade compliance solution. You can use your own solution. As
an option, it identifies the points where you can screen for trade compliance during order fulfillment in Oracle Fusion
Shipping. For details about Global Trade Management and how to set it up, see Oracle SCM Solutions, Global Trade
Management at https://www.oracle.com/applications/supply-chain-management/solutions/logistics/global-trade-
management.html.
829
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
Note.
• Use the Manage Order Management Parameters page in the Setup and Maintenance work area.
830
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
• As an option, to screen at order submit, set parameter Check for Trade Compliance When User Submits Sales
Order to Yes.
• This parameter comes predefined as No.
Constrain Changes
Note.
• Use the Manage Processing Constraints page in the Setup and Maintenance work area.
• As an option, use the DOO_GTM_EXCEPTION predefined processing constraint to implement a condition.
831
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
832
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
Note.
• Use the Manage Order Approval Rules page in the Setup and Maintenance work area to create an approval rule.
• Approval comes predefined to display the screening result in the Pending Notifications page or worklist for the
approver.
• As an option, you can create an approval rule to request review and approval for each sales order that doesn't
pass screening.
For example, if the sales order fails screening, then Order Management rejects the submit and sets the order
status to Draft. You can create an approval rule that allows the sales order to proceed to order fulfillment while
compliance is under review.
• Test on a variety of conditions, such as Trade Compliance Status of the order header, Trade Compliance
Comment on an order line, and so on.
Choose an action.
833
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
Note.
For details about approvals and how to set them up, see the How Approvals Work in Order Management topic.
834
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
At order submit You must use Integration Cloud Service, and you must set Invocation Mode on the connector
to Business Event.
During order fulfillment You can use some other integration service, and you can set Invocation Mode to Asynchronous
Service or Synchronous Service. However, you must set up your own integration and
connector. You can't use the example integrations that Integration Cloud Service provides as a
starting point.
For details, see the Set Up Integration section in the Guidelines for Integrating Order Management with Transportation
Management topic.
Note.
• Use TradeComplianceScreeningResultCode to provide the result for each request.
835
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
◦ ORA_SANCTIONED_TERRITORY
◦ ORA_RESTRICTED_PARTY
◦ ORA_TRADE_CONTROL
• Set TradeComplianceScreeningResultCode of the overall result to the most restrictive value from the
FulfillmentDetail sections. For example, if. . .
◦ ORA_SANCTIONED_TERRITORY is ORA_PASSED.
◦ ORA_RESTRICTED_PARTY is ORA_PASSED.
◦ ORA_TRADE_CONTROL is ORA_FAILED.
For example, if compliance checks ORA_SANCTIONED_TERRITORY for the ship to customer and for the bill to
customer, then make sure the payload includes one ORA_SANCTIONED_TERRITORY FulfillmentDetail for the
ship to customer, and another ORA_SANCTIONED_TERRITORY FulfillmentDetail for the bill to customer.
836
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
◦ If compliance type is Restricted Party, then use a comment to identify the customer on the restricted
party list.
◦ If compliance type is Sanctioned Country or Territory, then use a comment to identify the country or
territory.
In this example, the screening violation occurs in the International Traffic in Arms Regulations trade agreement.
• Include one Trade Control Type for each FulfillmentDetail. Its applicable only for these compliance types.
◦ Trade Control
◦ Sanctioned Country or Territory
837
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
Note.
• Lookup codes and values are predefined. You can't modify them, but you can create your own codes. For
details, see the Manage Trade Control Types topic.
• Search for lookup type ORA_DOO_TRADE_COMPLIANCE_TYPE on the Manage Standard Lookups page to
verify codes that your implementation uses.
• Make sure your response payload includes each lookup code. At a minimum, your payload must include these
codes.
◦ ORA_RESTRICTED_PARTY
◦ ORA_SANCTIONED_TERRITORY
◦ ORA_TRADE_CONTROL
838
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
Note.
• Search for lookup type ORA_DOO_VALIDATION_RESULT on the Manage Standard Lookups page.
• Make sure your response payload includes each lookup code. At a minimum, your payload must include these
codes.
◦ ORA_FAILED
◦ ORA_PASSED
◦ ORA_HOLD
839
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
Trade control type clarifies the government policy, document, agreement, and so on, that Trade Management uses
when it verifies trade compliance. Export Administration Regulations and Atomic Energy Act is an example of a
government policy.
Note.
• Search for lookup type ORA_DOO_TRADE_CONTROL_CODE on the Manage Standard Lookups page.
• This lookup type is predefined, but comes without lookup codes. You can add your own codes. Here are the
codes that we added in this example.
◦ AT. Antiterrorism.
◦ CB. Chemical and Biological Weapons.
840
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
Related Topics
• Manage Order Management Parameters
Set up trade compliance screening so it occurs before sending the sales order to order fulfillment.
1. Set up an integration between Order Management and your trade management system.
Related Topics
• Manage Order Management Parameters
841
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
Note.
◦ The request step sends a request to Global Trade Management to screen the sales order.
◦ The wait step pauses the orchestration process while it waits for the reply from Global Trade
Management. The pause makes sure fulfillment doesn't finish without first clearing trade compliance
842
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
check. The wait step also processes the response depending on the compliance status that Global Trade
Management sends.
• Set up exit criteria for the wait step according to compliance status, and according to your business needs.
• As an option, add a pause step at some point after the wait step to allow for manual intervention. For example,
assume you prefer to allow fulfillment to continue while an approver investigates the reason for screening
failure, right up to the point of shipping the item. You can add a pause step immediately before Create
Shipment Request.
• Add the request and wait steps at any point in the orchestration process. For example, screen before creating
the reservation, screen before creating the shipment request, screen after creating the invoice, and so on.
• Use any text for the Step Name attribute.
• You must use the predefined value DOO_TradeCompliance for the Task Type attribute and the Task attribute.
• Choose from a variety of services, such as Request Screening for Trade Compliance or Wait for Trade
Compliance Screening.
This topic includes example values. You might use different values, depending on your business requirements.
Attribute Value
For details about how to set up an orchestration process, see the Set Up Orchestration Processes topic.
3. In the Search Results, click Actions > Duplicate.
4. On the Edit Orchestration Process Definitions page, set values, accept all other default values, then click Save.
Attribute Value
Description Screen sales order for trade compliance, then process it through order fulfillment.
843
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
Attribute Value
Task DOO_TradeCompliance
Set attribute Default Lead Time and attribute Lead-Time UOM according to your business
requirements. Order Management will normally create and send the request in a few
seconds.
However, set Default Lead Time to 1 hour to account for an unexpected problem, such as
unscheduled network downtime.
Note.
844
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
◦ The values for the Task attribute and the Service attribute are required to call the compliance screening
service. Other attribute values are optional.
6. In the Process Details area, create a step immediately after the Request Screening for Trade Compliance step.
Attribute Value
Task DOO_TradeCompliance
Set up the exit criteria to continue processing or stop processing, according to your needs.
For example, to require the Order Entry Specialist to modify an order line that doesn't pass
trade compliance screening, use Passed DOO_PASSED Y to allow only Passed status as
the exit criteria. If the compliance screening fails or is under review, then the Order Entry
Specialist can examine the message details that Order Management displays, then decide on
an action to take, such as revise the sales order.
For another example, to continue processing order lines while the ship-to-customer is
under compliance review, include status Under Review as part of the exit criteria. Order
Management will process each order line through order fulfillment while trade management
reviews the ship-to-customer for trade compliance.
Set the Default Lead Time attribute and the Lead-Time UOM attribute according to your
needs. This example uses a 1 day lead time to allow Global Trade Management to process
screening that depends on an action in the fulfillment system that requires a long time to
resolve.
Note.
◦ This step pauses the orchestration process so it waits for the compliance screening service to finish
screening.
◦ The values for attributes Task, Service, and Exit Criteria are required. Other attribute values are optional.
845
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
◦ Compliance screening is a long-running task, so you can do compliance screening only through a long-
running task.
7. In the Process Details area, click Status Conditions > Orchestration Process Status Values, then add values.
The exit criteria is DOO_PASSED for the Wait for Trade Compliance Screening step in this example.
8. Optional. To pause fulfillment while waiting for compliance review, or while doing more review and approval,
add a pause step after the Wait step.
You can also create a new constraint. For example, create a constraint that rejects a sales order with status Failed but
that doesn't reject an order with status Under Review.
In this example, you create a processing constraint that rejects each sales order that doesn't pass trade compliance
screening.
This topic includes example values. You might use different values, depending on your business requirements.
846
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
2. If you enabled trade compliance screening to occur only during order fulfillment, then disable any constraint
that references the trade compliance status.
Disable DOO_GTM_EXCEPTION
1. In the Setup and Maintenance work area, go to the task.
◦ Offering: Order Management
◦ Functional Area: Orders
◦ Task: Manage Processing Constraints
2. On the Manage Processing Constraints page, locate predefined constraint DOO_GTM_EXCEPTION.
3. Make sure the Enabled option doesn't contain a check mark.
The sales order will pass submit validation and Order Management will send the sales order to order fulfillment
even if it doesn't pass compliance screening.
Attribute Value
Description Creates a new constraint that prevents a sales order that doesn't pass trade compliance
screening from moving to order fulfillment.
TML is an abbreviation for trade management line. You can use any value.
3. In the Details area, click Actions > Add Row, then set values.
Attribute Value
847
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
Attribute Value
If you create a new constraint for trade compliance screening, then you must include the text
GTM as part of the constraint name.
Display Name Reject Sales Orders that Contain Trade Compliance Exceptions
3. In the Conditions tab, click Actions > Add Row, then set values.
Attribute Value
Group Number 1
Scope Any
848
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
Attribute Value
Message You can't submit the order line because it doesn't pass trade compliance screening.
4. Click Save.
Assume you must add the Chemical and Biological Weapons trade control type.
This topic includes example values. You might use different values, depending on your business requirements.
The Manage Fulfillment Line Exceptions page only displays the View Details link next to a red or yellow trade
compliance status.
5. Examine the predefined lookup that displays the trade control type.
849
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
For example, a fulfillment line might reference a trade control, such as Anti-Terrorism, and details about the
control, such as Atomic Energy Act.
Attribute Value
4. In the search results, click the row that contains the value.
Attribute Value
5. In the Lookup Codes section, click Actions > New, then enter values.
Attribute Value
850
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
Attribute Value
Display Sequence 1
6. Click Save.
Related Topics
• Manage Sales Orders That Require Trade Compliance Screening
• Manage Lookups in Order Management
In this example, you will set up variable coverage as an extended warranty for the Sentinel Desktop computer.
This topic includes example values. You might use different values, depending on your business requirements.
851
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
Administer Parameters
Administer the feature and parameter that affect coverage and subscription.
Coverage Start Date To set the start date of the coverage to the date when. . .
◦ You ship the covered item, set the parameter to Shipment Date.
◦ You deliver the covered item, set the parameter to Delivery Date. You can use this
setting only if you integrate with Transportation Management and you set up the
integration so it sends the Actual Delivery Date to Order Management.
Assemble-to-Order
Order Management ships only the configured item and not the configure options. Order
Management updates the shipment date and delivery date only on the parent configured
item and not the child configure options. If you enable coverage on a child configure option,
then Order Management creates a relationship between the option and the coverage, and
Order Management sets the Contract Start Date of the coverage for the child line to the
shipment date or delivery date of the parent configured item.
If you set the Ship Model Complete attribute to Yes on the configuration model in the
Product Information Management work area, then Order Management doesn't ship the
model but does ship the configure options that the user selects. If you enable coverage
for the model, then Order Management sets the Contract Start Date of the model to the
Contract Start Date of the shippable configure options.
Order Management applies the same behavior for a kit, except a kit has included items
instead of configure options.
852
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
Attribute Value
Number of Items 1
Template You can choose any value. For this example, choose Finished Goods.
Attribute Value
5. Click Specifications, then, under Item Organization, click Sales and Order Management.
6. Set the value.
Attribute Value
◦ Subscription. An item that provides a product or service that recurs, and that includes
a duration and period. For example, a one year subscription to a magazine, a 90 day
subscription for cell phone service, and a six month subscription for software usage
are each an example of a subscription.
◦ Empty.
853
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
Attribute Value
You must enable contract coverage so a coverage item can cover the covered item.
Attribute Value
Number of Items 1
Template You can choose any value. For this example, choose Finished Goods.
Attribute Value
4. Click Specifications, then, under Item Organization, click Sales and Order Management.
5. Set the value.
854
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
Attribute Value
◦ Extended Warranty
◦ Software Maintenance
◦ Preventive Maintenance
Value Description
Fixed The Order Management work area will default the values that it displays for Duration and
Period to the values you set, then make them read-only.
Variable Works the same as Fixed, except the Order Entry Specialist can edit Duration and Period.
Open Ended Allows the Order Entry Specialist to edit Duration and Period, but doesn't display a default
value for these attributes. The Order Entry Specialist must set them.
You can't set the Enable Contract Coverage attribute because this attribute allows a coverage item to cover the
item you're defining. However, a coverage item can't cover another coverage item. For example, you can't create
a 1 Year Sentinel Desktop Warranty that covers a 5 Year Sentinel Desktop Warranty.
8. Set the values, click Save and Close, then sign out.
Attribute Value
Duration 5
Note: Its strongly recommended that you set these values. Order Management displays them in fields that
aren't labeled on the catalog line. If you don't set them, then the fields will be empty, and your users might
not understand how to use them.
855
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
You must set up a charge for each of these durations. For details, see the Manage Pricing for Covered Items section in
the Oracle SCM Cloud, Administering Pricing book.
Attribute Value
If you.
◦ Don't enter a value for Service Duration, then Pricing won't calculate a value for the Duration Extended
Amount attribute.
◦ Enter a value for Service Duration, then Pricing will calculate a value for the Duration Extended Amount
attribute.
If the Service Duration Type is Open Ended for the coverage item in the Product Information Management work
area.
◦ The Search Results area won't display a value for Service Duration Period or Service Duration, and won't
allow you to edit these attributes.
◦ And if Pricing prices the sales order instead of your source system pricing it, then the Order Entry
Specialist must enter a value for Service Duration Period.
6. In the Associated Items column, click Manage Covered Item.
7. On the Manage Covered Items page, in search results, click Add Row, set values, then click Create Charge.
856
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
8. In the Charge area, set values, then click Save and Close.
Attribute Value
Calculation Amount 20
9. In the search results, click Add Row, set values, then click Create Charge.
10. In the Charge area, set values, then click Save and Close.
Attribute Value
Calculation Amount 10
11. Click Save and Close again, then sign out of Pricing.
Specify Charges for Each Duration
857
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
• Week
• Day
• Hours
• Minutes
Note.
• Order Management renders pricing details only for each charge that you specify. For example, if you don't
specify a charge for Month, and if your user sets Duration to Month, then the order line for the coverage item
won't display price details, Order Management will display an error message, and the user can't submit the
sales order.
• If you set up a coverage item in the Product Information Management work area, but don't set up pricing for it
in the Pricing Administration work area, then your user might add the coverage item but not be able to submit
the sales order because of a pricing error.
Caution: If you set up a coverage item in Product Information Management, but incorrectly set up pricing for it in
Pricing Administration, then your user might add the coverage item and successfully submit it without error, but the
pricing values on the order line might not be correct, resulting in overcharging or undercharging the billing.
YEAR Year 1
MONTH Month 1
DAY Day 1
QUARTER Month 3
WEEK Day 7
YEAR Month 12
Make sure you use these values. These values will accommodate most coverages and subscriptions in a typical
Order Management implementation.
3. Make sure the Active attribute for each row contains a check mark, then click Save and Close.
858
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
Field Value
Field Value
4. Wait for the search to finish, then verify that the catalog line displays these values.
Attribute Value
Duration 5
Period Year
These are the default values you set up in Product Information Management.
5. Click Select Covered Item, choose the order line to cover, then click Add.
6. Click View > Columns, then click Period.
7. Verify that these values display on the coverage line, by default.
8. Change the quantity on the covered line from 1 to 2, then verify that the coverage line displays these values.
859
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
11. Change the Period to Month, then verify that the coverage line displays these values.
1 50 50 50 1 Month
12. Change the Period to Day, verify that the coverage line doesn't display price details, click Actions > Reprice
Order, then notice the error message.
Order Management will display an error for any charge you don't set up. Recall that you didn't create a charge
for Day.
Related Topics
• Coverages and Subscriptions in Sales Orders
• Item Classes
• Create One Invoice for Sales Orders with Items That Can and Can't Ship
Attribute Value
Number of Items 1
860
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
Attribute Value
Duration 5
Attribute Value
Number of Items 1
861
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
Set Up Pricing
1. Sign out, and then sign into Oracle Fusion Pricing.
2. Set up pricing for the fixed coverage item on the Corporate Segment Price List.
Attribute Value
Calculation Amount 20
Order Management doesn't allow your user to change the Duration or Period for a fixed coverage item, so you
only need to set up a charge for one period.
3. Add the open-ended coverage item to the Corporate Segment Price List.
Attribute Value
862
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
Attribute Value
Calculation Amount 20
Attribute Value
Calculation Amount 5
863
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
Attribute Value
Calculation Amount 10
Attribute Value
Calculation Amount 7
864
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
Field Value
Field Value
4. Wait for the search to finish, then notice that the catalog line displays 5 Year as a read-only value.
5. Click Select Covered Item, choose the order line to cover, then click Add.
6. Verify that you can't edit the Duration or Period.
7. On the catalog line, search for the item.
Field Value
8. Wait for the search to finish, then notice that the catalog line displays two empty fields, and that you must set
them before you continue. If you don't, then Order Management displays an error.
An open-ended coverage item is similar to a variable coverage item, except Order Management displays the
default values for Duration and Period on the catalog line for a variable coverage item, and doesn't display any
values for an open-ended coverage item. The Order Entry Specialist must set these values for an open-ended
coverage item.
9. Set values on the catalog line.
Attribute Value
Duration 1
Period Day
10. Click Select Covered Item, choose the order line to cover, then click Add.
11. Verify that the coverage order line for the open-ended coverage doesn't contain prices. You didn't set up a
charge for Day, so no pricing will display, and you can't submit the sales order.
12. Set Period to Year, then verify that these values display on the coverage line.
865
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
13. Set Period to Month, and then verify that the following values display on the coverage line.
1 50 50 50 1 Year
14. Set Period to Week, then verify that these values display on the coverage line.
1 35 35 35 1 Year
15. Set Duration to 2, then verify that these values display on the coverage line.
1 35 35 70 1 Year
Related Topics
• Coverages and Subscriptions in Sales Orders
• Coverages and Subscriptions in Sales Orders
866
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
• Make sure the orchestration process uses the same steps, in the same sequence, and at the same time for the
covered item and for the coverage item.
• Make sure processing for the covered item and coverage item remain synchronized, and make sure processing
for the covered item doesn't get too far ahead or behind processing for the coverage item.
• Order management assigns the same orchestration process number to the covered item and to the coverage
item.
867
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
Do it.
Note.
◦ A red step means the step doesn't apply to the item so the orchestration process skips the step. For
example, you don't schedule, reserve, or ship a warranty, so those steps don't run for the warranty.
◦ The covered item and the coverage item move together through the same steps, at the same time.
◦ If a step applies to the covered item but not the coverage item, then the coverage item will be in a Not
Started status, and remain in this status until it reaches a step that applies to the covered item and the
coverage item.
868
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
In this example, the Warranty for Computer coverage item is in the Not Started status all the way to the
Invoice step because the Invoice step is the first step in the process that applies to the covered item and
the coverage item.
2. Set up an assignment rule to make sure Order Management uses the same orchestration process for the
covered item and for the coverage item.
You set up the rule one time during setup. The orchestration process instance that runs in the runtime
environment is different for each sales order or fulfillment line.
◦ You don't ship a coverage item, such as a warranty, so you set up an expression that prevents the
shipping step from processing the coverage item. Add a line selection criteria that specifies to process
only shippable lines. Add the criteria to a Scheduling task or Shipping task. Predefined orchestration
processes already use this line selection criteria.
◦ The Contracts step doesn't need to run for a covered item, so add a line selection criteria that specifies to
run this step for each line only when the Sales Product Type specifies a coverage item.
For details about how to set up an expression, see the Select Fulfillment Lines for Orchestration Process Steps
topic.
This orchestration process is only for illustration purposes. You might need a different set up for your assignment rules
and expressions.
Do it.
869
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
Here's an example that illustrates how you can use a pause task to make sure the coverage item and covered
item go to billing at the same time.
Note.
◦ Orchestration process instance x can process the covered item independently of the coverage item.
◦ Orchestration process instance y can process the coverage item independently of the covered item.
◦The coverage item will proceed directly to the pause task, then wait until the covered item finishes the
Install Base step.
◦ The Install Base step finishes, the orchestration process releases the pause on the coverage item, and
then the covered item and coverage item move together to the Invoice task.
2. Add a pause task.
◦ If your orchestration process includes an invoice step, then make sure you do the billing step for the
covered item and the coverage item at the same time.
870
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
Fulfillment for the covered item is almost always behind fulfillment for the coverage item because the
covered item goes through shipping but the coverage item doesn't. So, to do billing at the same time,
add a pause step immediately before the invoice step in the orchestration process that processes the
coverage item. This way, fulfillment for the coverage item pauses while it waits for fulfillment for the
covered item to get to the billing step.
◦ The pause task makes sure the orchestration process instance that processes the coverage item doesn't
get too far out in front of the instance that processes the covered item. For example, the Contracts step
must not process the coverage item until after the covered item ships and the Install Base step runs.
◦ You can set the pause exit criteria to a condition, such as Shipped Quantity is greater than zero.
◦ Order Management doesn't allow updates to the order line once billing starts. Adding a pause task makes
sure that the orchestration can apply any actions you do on the covered item to coverage item, such as
update, split, or cancel.
• Assume you set the quantity on the covered item and the coverage item to 5, then submit the sales
order.
• Assume the coverage item proceeds immediately to billing.
• You create an order revision, revise the quantity on the covered item to 4, and submit it.
• The revision goes through fulfillment and proceeds to billing. However, the quantity for the
coverage item is 5, its already in billing, so now the quantities for the coverage item and the
covered item don't match, causing an error in the billing step. Pausing the coverage prevents this
problem.
◦ For details, see the Pause Orchestration Processes topic.
871
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
• If the fulfillment line contains a coverage item, and if the fulfillment line that the coverage item covers is
shippable but hasn't yet shipped
872
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
The pause continues until actualShipDate contains a date, which indicates that the covered item has shipped and the
orchestration process can proceed to the billing step.
For details about the code you see in this rule, see the Pause Orchestration Processes Until Events Occur topic.
Related Topics
• Guidelines for Assigning Orchestration Processes
• Select Fulfillment Lines for Orchestration Process Steps
• Overview of Pausing Orchestration Processes
• Coverages and Subscriptions in Sales Orders
873
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
Assume you must set up an annual subscription for Visions Magazine at a rate of $5 for each week.
Do the set up described in the Set Up Coverage for Sales Orders topic, but with these differences.
Attribute Value
Number of Items 1
Description Subscription for Visions Magazine, a weekly publication for trade professionals.
Pricing typically must reference a primary UOM that it can measure numerically, such as
number of weeks, number of users, or number of hosted environments. If you can't use a
predefined UOM, then you must create a new one.
You can use Fixed, Variable, or Open-Ended. Use Variable in most situations because it lets
you suggest a default value, but also provides the Order Entry Specialist the flexibility to
adjust or negotiate price for each customer.
If you use Open Ended, then renewal isn't required and the subscription continues until the
Order Entry Specialist ends it. For example, assume your customer buys a subscription to an
electrical utility that must continue indefinitely until the customer actively ends it.
Duration 52
2. Use the Pricing Administration work area to set up pricing for the subscription on the Corporate Segment Price
List.
874
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
Attribute Value
Service Duration 52
Attribute Value
Base Price 5
Calculation Amount 20
4. Sign out of Pricing Administration, and then sign into Order Management.
5. Add the Subscription to Visions Magazine item to the sales order, then verify that the order line displays these
values.
Attribute UOM Your Price Amount Amount Duration Period Billing Number
for Total Frequency of Billing
Duration Periods
Related Topics
• Coverages and Subscriptions in Sales Orders
875
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
Attribute Value
1. Use the Product Information Management work area to set up the agreement.
876
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
Attribute Value
Number of Items 1
Duration 3
Attribute Value
Number of Items 1
877
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
Attribute Value
Duration 3
3. Use the Pricing Administration work area to set up pricing for the agreement on the Corporate Segment Price
List.
Attribute Value
Attribute Value
5. Set up pricing for the subscription on the Corporate Segment Price List.
878
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
Attribute Value
Attribute Value
9. Search for the Vision Cloud Agreement item on the catalog line, click Select Covered Item, associate it with the
Vision Cloud Subscriptions order line, click Add, then verify that the Vision Cloud Agreement order line displays
these values.
879
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
Related Topics
• Coverages and Subscriptions in Sales Orders
Attribute Value
It creates a relationship between the covered item and the coverage item.
◦ At the same time. This subline can reside in the same source order.
◦ At some later time. This subline can reside in a closed order line from another sales
order that you already imported.
880
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
Attribute Value
This Id identifies the coverage for the root parent of a configured item.
The import uses these attributes to establish a relationship between the coverage item and the covered item.
The import process you use must map each of these attributes in the import payload of the source order to an
attribute in a sales order in Order Management.
3. Make sure your source order includes a value for the Number of Billing Periods attribute for the coverage item.
4. Make sure your source order includes values for coverage item attributes, depending on whether the source
order contains price details.
Oracle Fusion Pricing won't price the Oracle Fusion Pricing will price the item.
item.
Fixed Make sure the Duration and Period in the source order match the values you set for Duration
and Period in Product Information Management.
Open Ended If you import a source order that includes a coverage item, and if the coverage item doesn't
include price details, then make sure the import includes values for Duration and Period.
881
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
7. Make sure the value of the coverage quantity equals the value of the covered quantity.
8. Make sure the value of the coverage UOM equals the value of the covered UOM.
9. If the coverage item covers a covered item that Order Management already submitted to order fulfillment, then
make sure the status of the covered item is Closed.
10. Examine your import payload. Make sure the document references that identify the coverage line map to only a
single covered line.
One coverage line can cover only one covered line. A coverage line must not cover more than one covered line.
• If you import the start time stamp, duration, and period, then Order Management uses these values to
automatically calculate the end time stamp for you. Order Management will set the end of day to 23:59:59, UTC
(Coordinated Universal Time).
• If you import the start time stamp and the end time stamp, then Order Management uses these values to
automatically calculate the duration and period.
882
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
For example, use a REST API payload to import the contract duration, start time stamp, and end time stamp.
• A duration of 2
• Period of 0zE
• Contract start time stamp of 2019-12-13T19:51:49+05:30
• No value for the end time stamp
Note.
883
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
Technology Attributes
• Freeze Price
• Freeze Shipping Charges
• Freeze Tax
. . .then make sure the input payload includes coverage for each configure option that you enable for contract coverage.
If you set the Enable Contract Coverage attribute to Y on the Edit Item page in the Product Information Management
work area, then the configure option is enabled for contract coverage.
• If the source order doesn't contain a coverage for each configure option, then reject the source order.
• If the coverage quantity and the UOM for each configure option don't match the line quantity and UOM for the
covered item, then reject the source order.
Make sure it does these validations for each configure option that's enabled for contract coverage.
For details about pricing, see the Overview of Pricing Covered Items topic.
• Freeze Price
• Freeze Shipping Charges
• Freeze Tax
884
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
Note.
• The source order must include coverage only for the configured item that's the root parent, and not for each
configure option.
• If you enable the configure option for contract coverage, then your import process must create a coverage line
for each configure option. Each configure option can be an option class or option item.
• If the input payload contains a coverage for the root parent and also for one or more configure options, then
your import must reject the source order.
Note these points when you return a covered item, depending on whether the source order contains price details.
If Oracle Fusion Pricing doesn't price If Oracle Fusion Pricing prices the item, then the import payload can specify to return the
the item, then you can return the covered item and the coverage lines.
coverage item that covers the covered
item.
Make sure your import payload includes the return line for the covered item. Oracle Fusion
Applications will create the return lines for the coverage lines.
Make sure your import payload
includes these details.
885
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
If your import payload returns only the coverage item, then note these points.
• The quantity for the coverage line must equal the total returnable quantity of the covered line. Your import
payload can't return only part of the returnable quantity.
• The coverage return UOM in the import payload must equal the covered line UOM.
• If the source order contains price details, then the import payload must include the return charges.
Note.
Only the start date. Order Management uses the duration and period on the fulfillment line to calculate the
contract end date.
Contract start date and contract end If you set Service Duration Type to Variable when you set up the coverage, and if you import
date. the contract start date and the contract end date, then Order Management recalculates the
duration on the fulfillment line. However, the revised duration doesn't result in a price change
on the fulfillment line.
For details about Service Duration Type, see the Set Up Coverage for Sales Orders topic.
Only the contract end date. Order Management ignores the request and doesn't update any dates because it requires the
contract start date.
If you use FulfillmentResponseService to update contract dates, then make sure you specify the same contract dates
in any subsequent updates you make to other attributes on the coverage line. If you don't specify contract dates in
subsequent updates, then Order Management uses the Coverage Start Date order management parameter and the
actual shipment date or actual delivery date to determine how to set values for the contract dates. For details, see the
Manage Order Management Parameters topic.
Splitting Lines
886
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
• Only the coverage line. Order Management automatically processes the coverage line when it splits the covered
line.
For details about using FulfillmentResponseService, see the Connect Order Management to Your Fulfillment System
topic.
Consider an example.
"shipToCustomer": [
{
"PartyId": 1006,
"SideId": 1036,
}
],
"lines": {
{
"SourceTransactionLineId": "CPQ_LINE_ID_001",
"SourceTransactionLineNumber": "CPQ_LINE_NUM_001",
"SourceTransactionScheduleId": "CPQ_SCH_ID_001",
"SourceScheduleNumber": "CPQ_SCH_NUM_001",
"ProductNumber": "CPQ_SCH_NUM_001",
"InvoicingRule": "CPQ_SCH_NUM_001",
"BillingTransactionTypeName": "CPQ_SCH_NUM_001",
"PaymentTermsCode": "CPQ_SCH_NUM_001",
"TransactionLineType": "Buy",
"OrderedUOM": "Each",
"PurchasingUOMCode": "Ea",
"OrderedQuantity": 1,
"ServiceDuration": 1,
"ServiceDurationPeriodName": "YEAR",
"ContractStartDateTime": "2020-10-01",
"ContractStartEndDateTime ": "2021-09-30",
"SubscriptionProfileName": "Subs_Profile",
"ExternalPriceBookName": "CPQ_Price_List",
"billingPlans": [
{
"BillingNumberOfPeriods": 12,
"BillingPlanTypeCode": "PERIODIC",
"PeriodicityCode": "MONTH",
}
]
''charges" : [
{
"SourceChargeId": "C1-OT",
"ApplyTo": "Price",
"PriceType": "One_time",
Here we have "PeriodicityCode": "MONTH" in the billingPlans entity, which should work fine. But "PeriodicityCode": "ONE
TIME" would fail.
Related Topics
• Overview of Importing Orders into Order Management
• Manage Order Management Parameters
• Connect Order Management to Your Fulfillment System
887
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
Shipment Tolerances
Guidelines for Setting Up Shipment Tolerances
Use these guidelines to help you prepare for and set up shipment tolerances
How it Works
1. Order Management creates and sends a shipment request to Oracle Fusion Shipping. The request includes
shipment tolerances.
2. Shipping enforces the tolerances, ships the line, then sends a reply to Order Management.
888
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
3. Order Management evaluates the fulfillment line to determine whether to proceed to the next orchestration
process step, or to split the line.
4. Order Management sends the sales order to Receivables.
5. Receivables invoices the transaction.
What Shipping Does
• Shipping uses each shipment advice to indicate whether it completely fulfilled the order line, or whether ship
releases are still pending for the order line.
• If the shipment advice indicates that pending releases remain open for the order line, then Order Management
splits the line so it can fulfill the remaining open quantity.
• If shipping ships the order line below the minimum tolerance, then it doesn't allow the Shipping Manager to
close the order line. The Order Entry Specialist must cancel the line in the Order Management work area.
• Shipping sends the ordered quantity that it actually shipped to Order Management.
• Shipping confirms the shipment, sets the FinalShipmentFlag attribute to Y, then sends the value to Order
Management.
Receivables invoices the transaction according to the quantity that Order Management sends.
• Undershipment. Order Management sends the actual, fulfilled quantity to receivables.
• Overshipment. Order Management sends the ordered quantity or fulfilled quantity depending on the value of
the Quantity to Invoice for Overshipment order management parameter.
Points to Consider
• You can add tolerances to an order line on the Create Order page in the Order Management work area, through
File-Based Data Import (FBDI), Electronic Data Interchange (EDI), a web service, or REST API.
• If your tax authority requires you to create a tax invoice before you ship the sales order, then consider how
setting the Quantity to Invoice for Overshipment parameter affects your tax compliance requirements.
• If you decrease the order quantity, or if you change the tolerance behavior in a way that results in the shipped
quantity meeting the tolerance behavior, then you must create another shipment to close the fulfillment line.
• Implementing tolerances doesn't affect your integration with Transportation Management Cloud or
Global Trade Management. If a problem occurs with one of these integration, you might need to manually
troubleshoot it.
889
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
• You can't use an order management extension or transformation rule to change the tolerance on a line that
already exists. However, you can use an extensible flexfield and an extension to manually change the shipment
tolerance.
• If you apply a tolerance, then you can't reprice a sales order after you submit it to fulfillment.
Back-to-Back Flows
Order Management sets tolerances on the order line during a back-to-back flow in the same way it sets them for a
regular order line. Shipping fulfills an overshipment or undershipment during back-to-back in the same way it fulfills a
regular order line.
Limitations
You can't opt out of the Manage Shipment Tolerances for Sales Orders feature after you submit a sales order that
includes a shipment tolerance value that isn't empty or zero. At this point, you're committed to using the feature. You
also can't revert application behavior at this point.
890
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
891
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
If the Over Fulfllment Tolerance attribute on the fulfillment line is equal to 28, then prevent the user from
modifying the line.
892
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
Parameter Description
Default Value for Overshipment Set the default value that you want Order Management to use as a percent for overshipment
Tolerance tolerance on the order line.
893
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
Parameter Description
• You can enter a value with up to three decimal places, such as 10.463.
• If you don't specify a value, then Order Management uses 0, by default.
• If you use a defaulting rule or order management extension to set the value, then the
rule or extension overrides the value you set for the parameter.
Default Value for Undershipment Set the default value that you want Order Management to use as a percent for undershipment
Tolerance tolerance on the order line.
Use the same formatting requirements described for Default Value for Overshipment
Tolerance, except don't exceed the value 99 for Default Value for Undershipment Tolerance.
Quantity to Invoice for Overshipment Set the quantity to invoice when fulfillment ships more than the order line quantity.
• Shipped quantity. Invoice the actual shipped quantity. This is the default value.
• Ordered quantity. Invoice the order line quantity.
Assume the ordered quantity on an order line is 100 tons of steel with each ton priced at $800.
You over ship 103 tons for the order line. If you set Quantity to Invoice for Overshipment to.
• Shipped quantity. The invoice will contain 103 tons with a total line value of $82,400.
• Ordered quantity. The invoice will contain 100 tons with a total line value of $80,000.
Note.
• If shipped quantity is equal to or less than ordered quantity, then Order Management
bills for shipped quantity. If you under ship, then Order Management bills for shipped
quantity and you can't bill for ordered quantity.
• If Order Management splits the line into more than one line, or if shipping splits the line
into more than one shipment, then Order Management splits the original fulfillment
line. It also evaluates whether the sum of the shipped quantity across split fulfillment
lines exceeds the sum of the ordered quantity across the same set of split fulfillment
lines when it sends each split fulfillment line to Receivables. Its possible that Receivables
will only recognize that the last split fulfillment line over shipped.
• A change that you make to this parameter takes effect only on fulfillment lines that
Order Management hasn't sent to Receivables when you save your change. Receivables
will use the old parameter value for fulfillment lines that Order Management already
sent to Receivables.
Source for Shipment Tolerance Values Set the source that provides default values for shipment tolerances.
• Shipment tolerance parameter. Use the values you set in the order management
parameters.
• Item validation organization. Use the values you set in the Product Information
Management work area.
894
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
Parameter Description
If you specify item validation organization, and if you don't specify tolerances for the
item in Product Information Management, then Order Management uses the values
you specify for the Default Value for Overshipment Tolerance and Default Value for
Undershipment Tolerance parameters.
• None. Set the default values for shipment tolerances to zero.
Any change you make to this parameter takes effect only on new sales orders that you create
and submit after you save your changes to the parameter.
You can set values differently for each business unit on each parameter. Click Add Row, then set the Business Unit
attribute. For example, when you set the Source for Shipment Tolerance Values, to set the source only for sales orders
that reference the Vision China business unit, click Add Row, then set the Business Unit attribute to Vision China in the
new row.
If the business unit on the sales order is Vision China, then use your set up in Product
Information Management.
If the business unit on the sales order is Vision Japan, then use your set up on the parameters.
If the business unit isn't Vision China or Vision Japan, then set the default values for shipment
tolerances to zero.
In this example, set up an overshipment tolerance of 10%, and an undershipment tolerance of 10% for the AS54888
item.
895
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
2. On the Product Information Management page, click Tasks > Manage Items.
Attribute Value
Note.
Trouble Shoot
I don't see the Over Fulfillment They come predefined as hidden. On the order lines tab, click View > Columns, then make sure
Tolerance or Over Fulfillment each of them contains a check mark. If they don't display in the menu when you click View >
Tolerance attributes on the order Columns, then make sure you enable the tolerances opt-in feature.
line on the sales order in the Order
Management work area.
I don't see the order management Make sure you enable the tolerances opt-in feature.
parameters that I use to set up
tolerances, such as Default Value for
Overshipment Tolerance, Quantity to
Invoice for Overshipment, or Source
for Shipment Tolerance Values.
896
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
Create Order
You set the parameter values.
Parameter Value
Parameter Value
You don't set any values for item AS10000 in Product Information Management.
The Order Entry Specialist creates a new sales order in the Order Management work area and adds three items. Order
Management displays a separate order line for each item.
AS54888 10 50
AS10000 5 25
The Order Entry Specialist clicks Submit, and Order Management creates sales order 12345.
Copy Order
Continuing from the create order example, assume you change the parameter values.
897
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
Parameter Value
Order Management creates a new sales order that contains the same lines as order 12345, gets your updated parameter
values, and displays your updated tolerances on the order lines.
AS54888 0 30
AS10000 0 30
You set the Source for Shipment Tolerance Values to Shipment Tolerance Parameter, so Order Management doesn't get
any tolerance values from Product Information Management. It gets them from the parameters for each item.
Revise Order
Instead of copying sales order 12345, assume the Order Entry Specialist clicks Actions > Create Revision, then creates a
new order line for the AS20000.
Order Management creates a new sales order that contains the same lines as order 12345, and displays your updated
tolerances on the order lines.
AS54888 10 50
AS10000 5 25
AS20000 0 30
Order Management doesn't revise tolerances for order lines that it copies during a revision, but it does get the latest
values from the parameters for new lines that the user adds.
Assume the Order Entry Specialist changes the quantity for the AS10000. Order Management continues to use 0 and
30 for the tolerances. It doesn't update tolerances when the user changes quantity.
898
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
The under tolerance for the AS54888 is 10%, and the over tolerance is 50%. The Shipping Manager is the user for
the shipment application. Shipping doesn't allow the Shipping Manager to ship less than 13 because 10% of 15 is 1.5.
Shipping rounds up to the nearest whole number, so the calculation is 15 minus 2. Shipping doesn't allow the user to
ship more than 23 because 50% of 15 is 7.5, so the calculation is 15 plus 8.
Order Management sends sales order 12345 to shipping. Shipping splits the AS54888 order line into more than one
delivery, over ships the line, then closes it.
The AS54888 line is in status Awaiting Shipping. The Shipping Manager creates and ships three deliveries with
quantities of 12, 2, and 1. Some time later, the Shipping Manager adds a quantity of 3 to the second delivery. Shipping
fulfills the second delivery, cancels the third delivery, sets the FinalShipmentFlag attribute to Y, then sends the attribute
to Order Management.
The Shipping Manager examines the customer order and notices it includes two lines for the AS54888. One line
includes an ordered quantity of 7 and a shipped quantity of 12. The other line includes an ordered quantity of 3 and a
shipped quantity of 3. Both lines are awaiting billing.
Here's a summary.
3 1 - Canceled - - -
Shipping might split a fulfillment line to help meet the requested delivery date. It uses a formula.
• The ordered quantity on the original fulfillment line equals the requested quantity on the shipment.
• Shipping splits the fulfillment line.
899
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
• The ordered quantity on the new, split fulfillment line equals the total ordered quantity minus the requested
quantity on the shipment.
• When the ordered quantity on the fulfillment line equals the requested quantity on the shipment, there are no
more splits.
Fulfillment Line Ordered Quantity Over Tolerance Under Tolerance Shipped Quantity Status
A truck load limit or transportation planning recommendation sometimes requires a split. There's only a quantity of
8 on hand, so the shipping clerk manually splits the shipment, creates shipment S1, splits the fulfillment line into two
shipment lines, and ships SL1. Shipping receives confirmation that the customer received SL1, so it cancels SL2 because
the quantity of 8 on SL1 falls within the under tolerance.
S1 SL1 8 8 Shipped
- SL2 2 0 Canceled
where
Fulfillment Line Ordered Quantity Over Tolerance Under Tolerance Shipped Quantity Status
What if only 5 are on hand? Shipping ships 5 and puts 5 more on backorder.
900
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
S1 SL1 5 5 5 Shipped
- SL2 5 - - Backordered
If shipping can't fulfill SL2 before the customer receives SL1, then it splits the fulfillment line, places the 5 it hasn't
shipped on FL2, and sends the results to Order Management.
Fulfillment Line Ordered Quantity Over Tolerance Under Tolerance Shipped Quantity Status
FL2 5 - - - Backordered
Fulfillment Line Ordered Quantity Over Tolerance Under Tolerance Shipped Quantity Status
Shipping communicates with Global Order Promising and finds it has a quantity of 12 on hand, so it creates shipment S1
and ships the entire quantity.
S1 SL1 10 12 Shipped
where
901
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
Fulfillment Line Ordered Quantity Over Tolerance Under Tolerance Shipped Quantity Status
Fulfillment Line Ordered Quantity Over Tolerance Under Tolerance Shipped Quantity Status
Shipping communicates with Global Order Promising and finds it has a quantity of 6 on hand at warehouse A, 2 more
at warehouse B, and 3 more at warehouse C, so it creates three separate shipments, S1, S2, and S3, ships S1, and sends a
request to release inventory to warehouses B and C.
Fulfillment Line Ordered Quantity Over Tolerance Under Tolerance Shipped Quantity Status
Some time later, shipping ships S2 and updates the status for S2 to Shipped.
902
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
Shipping splits FL2 into FL2 and FL3, and sets the status for FL3 to Awaiting Shipping.
Fulfillment Line Ordered Quantity Over Tolerance Under Tolerance Shipped Quantity Status
Some time later, shipping ships S3 and updates its status to Shipped, but S3 could only ship a quantity of 1, so shipping
creates another shipment, S4.
Fulfillment Line Ordered Quantity Over Tolerance Under Tolerance Shipped Quantity Status
903
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
Fulfillment Line Ordered Quantity Over Tolerance Under Tolerance Shipped Quantity Status
Fulfillment Line Ordered Quantity Over Tolerance Under Tolerance Shipped Quantity Status
The total shipped quantity for the fulfilled sales order is 12, which is below the maximum over quantity of 13.
Accounting
Track Items as Assets in Order Management
Specify how to track an item as an asset in Order Management.
1. Go to the Product Information Management work area.
904
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
2. On the Product Information Management page, click Tasks > Manage Items.
3. Locate the item you must modify, then open it for editing.
4. On the Edit Item page, click Specifications > Service.
5. Set the value.
Attribute Value
◦ Full Lifecycle
◦ Customer Asset
6. Click Sales and Order Management, then set the value, or leave it empty.
Attribute Value
◦ Goods
◦ Software
If Sales Product Type contains one of these values, then Oracle Fusion Installed Base ignores the item even if
you set Enable Asset Tracking to Customer Asset or Full Lifecycle.
◦ Included Warranty
◦ Extended Warranty
◦ Service Level Agreement
◦ Software Maintenance
◦ Preventive Maintenance
◦ Installation
◦ Training
◦ Subscription
◦ One Time Service
7. Optional. Task type DOO_AssetManagement allows Order Management to send a request to Oracle Fusion
Installed Base to create or update an asset. You can set up your own task that DOO_AssetManagement
references, then reference your task from various steps in different orchestration processes that you create. For
details about task types, see the Task Types topic.
905
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
Attribute Value
◦ In the DOO_AssetManagement Details area, click Tasks > Actions > Add Row, set values, then click Save
and Close.
Attribute Value
Code Create_Vision_Asset
Name Create_Vision_Asset
If you sell covered items and coverage items, and if you have a step that calls the DOO_Subscription task, then
you must set up the orchestration process so it runs the DOO_AssetManagement task to send the covered
item to Oracle Installed Base before it runs the DOO_Subscription task to send the coverage item to Oracle
Subscription Management.
8. Create an orchestration process or revise the copy of an existing one.
Attribute Value
Add this step after the shipment step and before the invoicing step. For example, if you copy, then modify
the copy of predefined orchestration process DOO_OrderFulfillmentGenericProcess, then add this step
immediately before the Create Invoice step.
◦ If you created your own task type earlier in this procedure, then set the value.
906
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
Attribute Value
Related Topics
• Orchestration Processes
• Monitor Order Fulfillment
• Fulfillment Tasks
• Order Management updates the selling profit center every time a downstream system updates the warehouse.
• If the user changes the warehouse in the Order Management work area, then Order Management doesn't
update the selling profit center.
• Order Management prices the order line each time the value in the Selling Profit Center attribute on the order
line changes.
• Order Management communicates the selling profit center to downstream applications, such as Shipping,
Costing, Sales Financial Orchestration, Tax, and Receivables.
• You can reference the selling profit center in the Order Information Service, an order management extension, or
interface mapping.
Order Management will set the value of the Selling Profit Center attribute on the order line to the value that you
specify in this parameter. It sets the attribute value when the Order Entry Specialist adds an order line to a sales
order.
907
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
Order Management Set the Selling Profit Center attribute on the order line to the same value that the Business
Unit attribute on the order header contains.
Shipping Organization Set the Selling Profit Center attribute on the order line to the business unit that the shipping
inventory organization references.
◦ Normal shipment.
◦ Drop shipment.
◦ back-to-back shipment.
Related Topics
• Opt Into Features in Order Management
• Manage Order Management Parameters
Tax
Apply Tax According to Customer Site
Set up tax so Order Management can add tax to a sales order according to your customer's physical site. This is the way
you set up the default tax that Order Management applies on a sales order for most customers.
908
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
Note.
• A tax regime, such as the United States, contains tax jurisdictions, such as the Arizona Department of Revenue.
• The tax jurisdiction assess a tax on your sales according to its tax rate, and depending on your customer's
address.
• For example, if the tax rate in the Arizona tax jurisdiction is 5%, and if the net price on the sales order is $100,
then the tax is $5.
You have a wide range of choices when setting up tax, depending on your supply chain's tax requirements. For example,
you can specify tax according to the tax jurisdiction that applies at the ship-to site, the bill-to site, or a range of other
locations.
Here's the flow that you use to set up the example in this topic.
909
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
Task Description
1. Manage Tax Regimes Create a tax regime named USA_TAX_REGIME for the United States.
2. Manage Taxes Create a tax named STATE1 at the state level for Arizona.
3. Create Tax Jurisdiction Create a tax jurisdiction for the state of Arizona.
910
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
Task Description
4. Create Tax Rate Create the 5% tax rate to apply for the STATE1 tax.
You create a relationship between your customer's site and the tax regime.
For background details about how to set up tax, see the Administering Tax Reporting book on Oracle Help Center.
For other technical details, including lots of helpful screen prints, see FAQ-Order Management Tax Best Practices and
General Questions (Doc ID 2619517.1) on My Oracle Support.
Attribute Value
911
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
Attribute Value
Tax Precision 2
Enable this option so the Order Entry Specialist can override inclusive tax on the order line.
4. In the Configuration Options and Service Subscriptions area, on the Configuration Options tab, set values, then
click Save and Close > Done.
Attribute Value
Configuration for Taxes and Rules Common Configuration with Party Overrides
◦ Offering: Financials
912
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
Attribute Value
Tax STATE1
Tax Precision 2
Attribute Value
Allow override and entry of inclusive Make sure each of these options contain a check mark. They allow Order Management to
tax lines modify tax at run time.
913
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
Attribute Value
Attribute Value
You're setting tax according to the tax rate in the tax jurisdiction of the ship-to address. If
Order Management can't find the ship-to address at run time, then it will use the tax rate
that the tax jurisdiction applies at the bill-to address.
Attribute Value
ST means state.
914
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
Attribute Value
AZ means Arizona.
◦ Offering: Financials
◦ Functional Area: Transaction Tax
◦ Task: Manage Tax Statuses
2. On the Manage Tax Statuses page, click Actions > Create.
3. On the Create Tax Status page, set values, then click Save and Close > Done.
Attribute Value
Tax STATE1
915
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
Attribute Value
Tax STATE1
Geography Name AZ
4. Click Save.
You must click save before you do the next step.
5. On the Associated Jurisdiction Tax Rate Periods tab, click Create.
6. On the Create Tax Rate page, set values.
Attribute Value
916
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
Attribute Value
Procure to Pay
Expenses
7. In the Rate Periods area, set values, then click Save and Close.
Attribute Value
Rate Percentage 5
8. On the Edit Tax Jurisdiction page, notice that the Associated Jurisdiction Tax Rate Periods contains the STD-
DEFAULT rate you just created, then click Save and Close > Done.
Create the Standard Tax Rate
1. On the setup page, open the task.
◦ Offering: Financials
◦ Functional Area: Transaction Tax
◦ Task: Manage Tax Rates and Tax Recovery Rates
2. On the Manage Tax Rates and Tax Recovery Rates page, click Actions > Create.
3. On the Create Tax Rate page, set values.
Attribute Value
Tax STATE1
917
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
Attribute Value
Procure to Pay
Expenses
4. In the Rate Periods area, set values, then click Save and Close > Done.
Attribute Value
Rate Percentage 10
918
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
Try it.
◦ Offering: Financials
◦ Functional Area: Customers
◦ Task: Manage Customers
919
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
Attribute Value
3. In the search results, in the Sites area, click Actions > Create.
4. On the Create Account Site page, set values.
Attribute Value
City TEMPE
State AZ
5. In the Address Purposes area, click Actions > Add Row, set values, then click Save and Close > Done.
Attribute Value
Purpose Ship To
◦ Offering: Financials
◦ Functional Area: Enterprise Profile
◦ Task: Manage Geographies
2. On the Manage Geographies page, search for the value.
920
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
Attribute Value
3. In the search results, click the row that has United States in the Country Name column, then click Actions >
Manage Geography Validation.
4. On the Manage Geography Validation page, in the Geography Mapping and Validation area, verify the values
for the State.
Collect Data
Don't use the Plan Inputs task that's available in the Setup and Maintenance work area. Use the Plan Inputs
work area instead.
2. In the Plan Inputs work area, click Tasks > Collect Planning Data.
3. In the Collect Planning Data dialog, set your source system, then move reference entities to selected entities.
◦ Customer
◦ Geographies
◦ Organizations
4. Click Submit.
For details, see the Collect Planning Data for Order Management topic.
Attribute Value
921
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
Attribute Value
Item AS54888
Quantity 1
Amount 2,500
Attribute Value
Discount 0.00
Shipping 0.00
5. Change the ship-to address to any other value, then click Actions > Reprice Order.
6. Click the total at the top of the sales order, then verify that the tax rate is 10%, which is the STD rate you set up
to apply when the ship-to address isn't 2164 Broadway, Tempe, AZ, 85282.
Attribute Value
Discount 0.00
922
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
Attribute Value
Shipping 0.00
Related Topics
• Overview of Collecting Promising Data for Order Management
Assume you already set up tax so Order Management applies it according to the customer site.
• You set up tax for site 1036 of your Computer Service and Rentals customer.
• The tax jurisdiction in Tempe charges a 5% tax.
• Tax is STATE1 at the state level for Arizona.
• Tax jurisdiction is for the state of Arizona.
• Tax rate is 5%.
For details, see the Apply Tax According to Customer Site topic. You will reuse some of the objects that you already set
up in that topic, such as the tax rate.
923
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
Attribute Value
3. In the search results, in the Organization Name column, click Computer Service and Rentals.
4. On the Edit Customer page, click Tax Profile, set the value, then click Save and Close.
Attribute Value
5. On the Manage Customers page, in the Sites area, in the Site Number column, click 1036.
6. On the Edit Site page, click Tax Profile, set the value, then click Save and Close > Done.
Attribute Value
3. In the search results, click the value in the Party Number column.
4. On the Third-Party Tax Profile page, verify the value, then click Done.
Attribute Value
5. On the Manage Party Tax Profiles page, set Search For to Third-Party Site Tax Profiles, then search for the
value.
924
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
Attribute Value
6. On the Third-Party Site Tax Profile page, in the search results, in the Party Site Number column, click 1036.
Assume 1036 is the site for the Arizona location.
7. On the Third-Party Site Tax Profile page, verify the value, then click Done > Done.
Attribute Value
Attribute Value
3. In the search results, set the values, then click Save and Close.
Attribute Value
925
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
1. Use the set up you just made to apply tax according to the customer you choose on the sales order.
2. If the tax set up according to customer isn't available, then apply tax according to the customer site.
3. If the tax set up for the customer site isn't available, then apply tax according to the item you add to the order
line. Use the set up in the Product Information Management work area to apply the tax.
Attribute Value
Attribute Value
Item AS54888
Quantity 1
Amount 2,500
Attribute Value
Discount 0.00
Shipping 0.00
926
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
Attribute Value
Attribute Value
Attribute Value
Item AS54888
Quantity 1
Amount 2,500
Attribute Value
Discount 0.00
Shipping 0.00
927
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
Attribute Value
You will reuse a number of objects from that topic, such as US_TAX_REGIME, the 5% tax rate, and the STATE1
tax.
3. Go to the Setup and Maintenance work area, then open the task.
◦ Offering: Financials
◦ Functional Area: Transaction Tax
◦ Task: Manage Tax Formulas
4. On the Manage Taxable Basis Formulas page, click Create.
5. On the Create Taxable Basis Formula page, set values, and then click Save and Close > Done.
Attribute Value
928
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
Attribute Value
Tax STATE1
Attribute Value
4. In the Associate Tax Determining Factors area, set values, then click Save and Close > Done.
Attribute Value
This value specifies that you will use the input from a transaction to set the tax rate. A sales
order is a type of transaction.
929
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
◦ Offering: Financials
◦ Functional Area: Transaction Tax
◦ Task: Manage Tax Condition Sets
2. On the Manage Tax Condition Sets page, click Create.
3. On the Create Tax Condition Sets page, set values.
Attribute Value
4. In the Tax Condition Set Details area, set values, then click Save and Close > Done.
Attribute Value
Operator Equal To
◦ Offering: Financials
◦ Functional Area: Transaction Tax
◦ Task: Manage Tax Rules
2. On the Manage Tax Rules page, click Actions > Create.
3. On the Create Determine Tax Applicability Rule page, set values.
930
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
Attribute Value
Tax STATE1
4. In the Tax Determining Factor Set area, in the Code attribute, set the value, then click Next.
Attribute Value
Code TAX_BEFORE_DISCOUNT
5. On the Create Determine Tax Applicability Rule page, in the Tax Condition Set area, set values, then click Save
and Next.
Attribute Value
Result Applicable
6. On the Edit Determine Tax Applicability Rule page, in the Rule Status and Order area, add a check mark to the
Enabled attribute, then click Submit > Done.
Attribute Value
931
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
Attribute Value
Attribute Value
Item AS54888
Quantity 1
Amount 2,500
Attribute Value
Discount 250.00
Shipping 0.00
125 is 5% of 2500.
Related Topics
• Manage Discount Lists
932
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
At run time, Order Management calculates the discount first, and then applies the tax depending on your tax setup.
Assume you set up pricing so it calculates a 10% discount, and you set up tax to apply a 5% tax according to customer
site. For details, see the Apply Tax According to Customer Site topic.
Attribute Value
Discount 250.00
Shipping 0.00
112.50 is 5% of 2,250.
Related Topics
• Manage Discount Lists
933
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
Assume you currently use a Tax Classification Code named A-RATE. You want to continue to use A-RATE but change its
percentage from 6 to 6.5.
Try it.
1. Go to the Setup and Maintenance work area, then go to the task.
◦ Offering: Financials
◦ Functional Area: Transaction Tax
◦ Task: Manage Tax Rates and Tax Recovery Rates
2. On the Manage Tax Rates and Tax Recovery Rates page, search for the value.
Attribute Value
Tax A-TAX
To get the values you need to search on, click Actions > Export to Excel. In Excel, locate your tax classification
code in the Tax Rate Code column, then use values in the row that contains your tax classification code.
3. In the search results, click the value.
Attribute Value
4. On the Tax Rate page, in the Rate Periods area, notice the values.
Attribute Value
Rate Percentage 6
where
◦ 31 is the day
◦ 01 is the month
◦ 20 is the year
934
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
This is the rate that's currently in effect. You will change it to 6.5.
5. Click Edit.
6. On the Edit Tax Rate page, in the Rate Periods area, set the values.
Attribute Value
Rate Percentage 6
Attribute Value
6 31/01/20/ 8/10/20
935
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
Classification Code to 4%, then Order Management ignores any other tax that you have set up for the sales order, such
as according to the customer site, and applies a 4% tax instead.
You use different tasks in the Setup and Maintenance work area.
- Task Value
1 Manage Tax Determining Factor Sets Create a set of tax determining factors.
A tax determining factor is a value that
contributes to determining tax. The Tax
936
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
- Task Value
2 Manage Tax Rates and Tax Recovery Rates Create the tax rate you will apply when the
Order Entry Specialist sets the value for
the Tax Classification Code attribute.
937
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
An Order Entry Specialist creates a sales order in the Order Management work area, adds an order line, and sets a value
in the Tax Classification Code attribute. The adjustment is an input from a transaction, the determining factor is the Tax
Classification Code attribute, and the value is 6% Tax Rate, so the condition evaluates to true, and Order Management
applies the 6% rate to sales order total.
Why would I want the Order Entry Specialist to set the tax rate? The Order Entry Specialist works directly with your
customer and might have more accurate details. For example, assume in the year 2019 you set up tax according the site
where your Computer Service and Rentals resides in Arizona at 5%. However, the Order Entry Specialist finds out while
talking with Computer Service and Rentals when placing a sales order that the tax authority in Arizona raised the tax
rate to 6% in 2020. The Order Entry Specialist can use the Tax Classification Code to adjust the tax.
938
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
Assume you already set up the US_TAX_REGIME tax regime, the STATE1 tax, and the STANDARD tax status code when
you set up tax for the customer site. For details, see the Apply Tax According to Customer Site topic.
◦ Offering: Financials
◦ Functional Area: Transaction Tax
◦ Task: Manage Tax Determining Factor Sets
2. On the Manage Tax Determining Factor Sets page, click Create.
3. On the Create Tax Determining Factor Set page, set values.
Attribute Value
4. In the Associate Tax Determining Factors area, set values, then click Save and Close > Done.
Attribute Value
You can choose from a wide variety of classes, such as geography, party, inventory,
transaction, and so on.
Transaction Input Factor specifies that you will use the input from a transaction to set the tax
rate. A sales order is a type of transaction.
939
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
Attribute Value
Here you're specifying the name of the attribute in the sales order that the Order Entry
Specialist will use to adjust the tax rate.
Attribute Value
Tax STATE1
Procure to Pay
Expenses
4. In the Rate Periods area, set values, then click Save and Close > Done.
Attribute Value
Rate Percentage 6
940
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
Attribute Value
◦ Offering: Financials
◦ Functional Area: Transaction Tax
◦ Task: Manage Tax Condition Sets
2. On the Manage Tax Condition Sets page, click Create.
3. On the Create Tax Condition Sets page, set values.
Attribute Value
4. In the Tax Condition Set Details area, set values, then click Save and Close > Done.
Attribute Value
Operator Equal To
◦ Offering: Financials
◦ Functional Area: Transaction Tax
◦ Task: Manage Tax Rules
941
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
Attribute Value
Tax STATE1
4. In the Tax Determining Factor Set area, in the Code attribute, set the value, then click Next.
Attribute Value
5. On the Create Determine Tax Applicability Rule Override Tax Classification page, in the Tax Condition Set area,
set values, then click Save and Next.
Attribute Value
Result Applicable
6. On the Edit Determine Tax Applicability Rule page, in the Rule Status and Order area, add a check mark to the
Enabled attribute, then click Submit > Done.
Collect Data
1. Go to the Plan Inputs work area.
Don't use the Plan Inputs task that's available in the Setup and Maintenance work area. Use the Plan Inputs
work area instead.
2. In the Plan Inputs work area, click Tasks > Collect Planning Data.
942
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
3. In the Collect Planning Data dialog, set your source system, then move reference entities to selected entities.
◦ Customer
◦ Geographies
◦ Organizations
4. Click Submit.
For details, see the Collect Planning Data for Order Management topic.
Attribute Value
Attribute Value
Item AS54888
Quantity 1
Amount 2,500
Attribute Value
Discount 0.00
943
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
Attribute Value
Shipping 0.00
5. Click the Actions down arrow on the order line, then click Edit Tax Determinants.
6. Set the Tax Classification Code to 6% Tax Rate.
7. On the order header, click Actions > Reprice Order.
8. Click the total at the top of the sales order, then verify that the tax rate is 6%.
Attribute Value
Discount 0.00
Shipping 0.00
Related Topics
• Tax Determining Factor Sets and Condition Sets
• Overview of Collecting Promising Data for Order Management
944
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
Attribute Value
Attribute Value
Item AS54888
Quantity 1
Amount 2,500
Attribute Value
Discount 0.00
945
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
Attribute Value
Shipping 0.00
125 is 5% of 2,500.
You use two browsers in this example. One to manage the sales order as the Order Entry Specialist and another
to manage the item in inventory as an administrator.
2. Sign into Oracle Fusion Applications as the whse_mgr_all_inv_orgs user.
You can sign in with any user who has a job role that provides access to the Inventory Management work area.
For details, see the Inventory Manager (Job Role) chapter in the Security Reference for Manufacturing and
Supply Chain Materials Management book on Oracle Help Center.
3. Go to the Inventory Management work area, and click Tasks.
4. Set Show Tasks to Shipments, then click Create Pick Wave.
5. On the Create Pick Wave page, set the value, then click Release Now.
Attribute Value
Order 526715
946
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
Attribute Value
Order 526715
Attribute Value
Order 526715
6. In the search results, click the link in the Pick Slip column.
7. On the Confirm Pick Slip page, click Show More, then note the value for the shipment.
Attribute Value
Picked Quantity 1
Manage Shipment
Attribute Value
Shipment 2381778
3. On the Edit Shipment page, set the value, then click Ship Confirm.
Attribute Value
Shipped Quantity 1
947
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
Attribute Value
4. In the Lines area, verify that the Line Status attribute equals Interfaced.
You must sign as a user who as the order administrator job role to run the scheduled process.
2. Go to the Scheduled Processes work area.
3. On the Overview page, click Schedule New Process.
4. Run the Import AutoInvoice scheduled process.
Parameter Value
Business Unit Choose the business unit that you set on the sales order, such as Vision Operations.
Attribute Value
948
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
Attribute Value
Tax 125
This is the value of the tax on the invoice. Notice that this attribute contains the same value
that the sales order contains for the tax.
Continuing our example, let's say you need to change the value of the tax invoice from 125 to 130.
1. When you're on the Edit Transaction page, in the General Information area, click the pencil in the Tax attribute.
2. In the dialog that displays, click Actions > Add Row.
3. Choose a tax rate or override the tax rate and manually enter your own tax amount.
For example, choose a tax rate, change the value in the Tax Amount attribute to 130, then click Save and Close.
Receivables will change tax on the invoice from 125 to 130 but Order Management won't change the tax amount
on the sales order.
4. On the Edit Transaction page, click Save and Close.
949
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
Attribute Value
4. In the Associate Tax Determining Factors area, set values, then click Save and Close > Done.
Attribute Value
◦ Offering: Financials
◦ Functional Area: Transaction Tax
◦ Task: Manage Tax Condition Sets
2. On the Manage Tax Condition Sets page, click Create.
3. On the Create Tax Condition Sets page, set values.
Attribute Value
4. In the Tax Condition Set Details area, set values, then click Save and Close > Done.
950
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
Attribute Value
Operator Equal To
◦ Offering: Financials
◦ Functional Area: Transaction Tax
◦ Task: Manage Tax Rules
2. On the Manage Tax Rules page, click Actions > Create.
3. On the Create Determine Tax Applicability Rule page, set values.
Attribute Value
Tax STATE1
4. In the Tax Determining Factor Set area, in the Code attribute, set the value, then click Next.
Attribute Value
5. On the Create Determine Tax Applicability Rule page, in the Tax Condition Set area, set values, then click Save
and Next.
951
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
Attribute Value
6. On the Edit Determine Tax Applicability Rule page, in the Rule Status and Order area, add a check mark to the
Enabled attribute, then click Submit > Done.
Attribute Value
Attribute Value
Item AS54888
Quantity 1
Amount 2,500
The tax line should contain a value of 0 or there should be no tax line at all.
952
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
Attribute Value
Discount 0.00
Shipping 0.00
Try this.
Attribute Value
If the Service Subscriptions tab contains a record that's similar to these values, then Vision Operations
subscribes to the order-to-cash flow.
Attribute Value
953
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
Attribute Value
If Vision Operations Then Make Sure the Use Legal Entity Tax Subscription Option
Related Topics
• Use SQL to Query Order Management Data
954
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
Trouble Shoot
My sales order doesn't include any A variety of incorrect setups might cause this problem. Here are some set ups you can
tax. examine.
• Make sure you set up the tax profile. For details, see the Set Up Tax Profile for Legal
Entity topic.
• Make sure you set up a tax to apply, by default. Most implementations apply tax
according to customer site. For details, see the Apply Tax According to Customer Site
topic.
Tax Determinants
Troubleshoot problems with tax determinants. To set them, you create a sales order in the Order Management work
area, add an order line, click the Actions down arrow on the order line, then click Edit Tax Determinants.
Trouble Shoot
1. Go to the Product Information Management work area, click Tasks > Manage Items,
The Product Type attribute in the search for, then open your item for editing.
Edit Tax Determinants dialog has a
2. Click Specifications > Inventory, then set the Inventory Item attribute to Yes. If the
value that doesn't match the item.
item is a service, such as 3 Year Warranty, but the Product Type attribute in the Order
For example, the item is the AS54888
Management work area displays Goods, then set the Inventory Item attribute to No.
Desktop Computer, which is a Goods,
but the Product Type attribute
contains Services.
I set the Tax Classification Code to Assume you set the Business Unit to Vision Operations on the sales order. Try this.
a different value and click OK, but
the exclusive tax on the sales order 1. Enable the feature.
doesn't change.
◦ Go to the Setup and Maintenance work area, then choose Financials next to
Setup.
◦ Click Change Feature Opt In.
955
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
Trouble Shoot
◦ On the Opt In Financials page, in the Financials row, click the pencil in the
Features column.
◦ On the Edit Features page, on the Tax Calculation on Receipt Accounting
Distributions row, add a check mark to the Enable option, then click Done >
Done.
2. On the Setup Financials page, go to the task.
◦ Offering: Financials
3. On the Configuration Owner Transaction Tax Options page, search the Configuration
Owner attribute for Vision Operations.
4. In the search results, in the row that has Application Name equal to Tax and Event
Class equal to Purchase Transaction, set the Regime Determination Set to Standard Tax
Classification Codes.
For details, see the Configure Tax Calculation and Accounting topic.
I see that the Tax Classification Code Order Management uses different lookups for the Tax Classification Code. It uses.
attribute contains a value, then
submit the order. • ZX_OUTPUT_CLASSIFICATIONS for sales orders
• ZX_INPUT_CLASSIFICATIONS for return orders
Sometime later, I create a return
for the order, but now the Tax Try this.
Classification Code is empty.
1. Go to the Setup and Maintenance work area, then go to the task.
◦ Offering: Financials
2.On the Manage Tax Lookup Codes page, search the Lookup Type attribute for
ZX_OUTPUT_CLASSIFICATIONS.
3. In the Financials Generic Lookup Type area, examine the lookup codes.
4. Search the Lookup Type attribute for ZX_INPUT_CLASSIFICATIONS for return orders.
5. In the Financials Generic Lookup Type area, make sure the lookup codes contain the
same values that you examined for ZX_OUTPUT_CLASSIFICATIONS. If they don't, add
them.
956
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
Related Topics
• Configure Tax Calculation and Accounting
More
Create Direct Links to Order Management Pages
Create a direct link from your application or an Oracle Fusion Application to a page in the Order Management work area.
For example, assume you have a legacy application named VisionSCM that your field support team uses during
maintenance calls. Your service team is on site at your Computer Service and Rentals customer to service the AS9000
Server Array, and needs to get quickly from VisionSCM to the sales order in the Order Management work area so they
957
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
can view order details while they're servicing the equipment. The service team also needs to send an email to a parts
supplier where having a direct link in the email would expedite getting the correct part.
where
Code Description
host The name of the server that hosts your implementation of Order Management Cloud.
958
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
Code Description
For example, assume the Vision Operations organization uses a server named visionServer.
port The port on your server that you use to host your implementation of Order Management
Cloud.
action The action to take when doing the direct link. Use one of these values.
• VIEW
• FULFILLMENT_VIEW
• CREATE
VIEW&objKey A combination that identifies the type of view you're linking to and a value that uniquely
identifies that object.
• HeaderId
• OrderNumber
• SourceTransactionNumber
• SourceTransactionId
• SourceTransactionSystem
• ChangeVersionNumber
• DraftOrderFlag
The value for objKey uniquely identifies the object you're linking to.
https://visionServer:7011/fndSetup/faces/deeplink?
objType=SALES_ORDER&action=VIEW&objKey=HeaderId=300100181471495
959
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
https://visionServer:7011/fndSetup/faces/deeplink?
objType=SALES_ORDER&action=VIEW&objKey=OrderNumber=519810
If OrderNumber isn't unique, then use SourceOrderSystem to identify the source order.
SourceTransactionNumber Link to the sales order that you imported for source transaction 507252 from the GPR source
system.
https://visionServer:7011/fndSetup/faces/deeplink?
objType=SALES_ORDER&action=VIEW&objKey=SourceTransactionNumber=507252;SourceTransa
SourceTransactionId Link to the sales order that you imported for source transaction Id 300100177124844 from the
GPR source system.
https://visionServer:7011/fndSetup/faces/deeplink?
objType=SALES_ORDER&action=VIEW&objKey=SourceTransactionId=300100177124844;SourceT
ChangeVersionNumber Link to version 2 of the sales order that you imported for source transaction Id
300100177124844 from the GPR source system.
https://visionServer:7011/fndSetup/faces/deeplink?
objType=SALES_ORDER&action=VIEW&objKey=SourceTransactionId=300100177124844;SourceT
http:// visionServer:7011/fscmUI/faces/deeplink?
objType=SALES_ORDER&action=VIEW&objKey=OrderNumber=504121;DraftOrderFlag=true
• If you already submitted the sales order to fulfillment, then the link displays the sales order in the same view
that you see when you click Tasks > Manage Orders in the Order Management work area.
• If the sales order is in Draft status, then the link displays the draft order.
960
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
https://visionServer:7011/fndSetup/faces/deeplink?
objType=SALES_ORDER&action=FULFILLMENT_VIEW&objKey=HeaderId=300100181471495
https://visionServer:7011/fndSetup/faces/deeplink?
objType=SALES_ORDER&action=FULFILLMENT_VIEW&objKey=OrderNumber=519810
If OrderNumber isn't unique, then use SourceOrderSystem to identify the source order.
SourceTransactionNumber Link to the sales order that you imported for source transaction 507252 from the GPR source
system.
https://visionServer:7011/fndSetup/faces/deeplink?
objType=SALES_ORDER&action=FULFILLMENT_VIEW&objKey=SourceTransactionNumber=507252;
SourceTransactionId Link to the sales order that you imported for source transaction Id 300100177124844 from the
GPR source system.
https://visionServer:7011/fndSetup/faces/deeplink?
objType=SALES_ORDER&action=FULFILLMENT_VIEW&objKey=SourceTransactionId=30010017712
The link displays the sales order in the same view that you see when you access the sales order through Tasks > Manage
Fulfillment Lines in the Order Management work area.
For example.
https://visionServer:80/fndSetup/faces/deeplink?objType=SALES_ORDER&action=CREATE
The link displays the same Create Order page that you see when you click Create Order in the Order Management work
area.
The direct link feature displays a return icon above the order total. You click it to return to the application that called the
direct link.
Assume you call a direct link from VisionSCM. The visionServer server hosts VisionSCM on port 7011.
961
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
VisionSCM must include the returnApp parameter and returnAppParams parameter in the deeplink URL so the return icon
knows how to get back to VisionSCM. Here's your format.
https://server:port/fndSetup/faces/deeplink?
objType=SALES_ORDER&action=VIEW&objKey=OrderNumber=519810&returnApp=applicationName&returnAppParams=parameterName1=V
% parameterName2=Value%parameterName3=Value
where
Code Description
returnApp Identifies the name of the application that called the direct link.
returnAppParams List of parameters that you can include in the call. You must use a % (percent symbol) to
separate each parameter and its value.
where
Code Description
returnAppParams Sets the value of parameter abc to 123 and the value of parameter 26xyz to 456.
962
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
You must add the calling application in the Setup and Maintenance work area. For example.
Try it.
963
Oracle SCM Cloud Chapter 4
Implementing Order Management Set Up Features
Attribute Value
964
Oracle SCM Cloud Chapter 5
Implementing Order Management Import and Transform
Import
965
Oracle SCM Cloud Chapter 5
Implementing Order Management Import and Transform
Overview
Overview of Importing Orders into Order Management
Use the Order Import Template, a web service, or REST API to import orders from your source system into Order
Management Cloud.
Note.
• Use the Order Import Template to reduce errors and simplify order import. This template contains a structure
that the Oracle database requires. It includes a tab for each database table, and it displays tabs in a specific
966
Oracle SCM Cloud Chapter 5
Implementing Order Management Import and Transform
sequence. Columns on each tab represent table columns that Oracle requires, and the template specifies the
data type that Oracle requires for each database column.
◦ Learn how to use Order Import Template. See the Guidelines for Importing Orders into Order
Management topic.
◦ Get a copy of Order Import Template and get details about tables that the template references. See the
Sales Orders topic in the File-Based Data Import for Oracle Supply Chain Management Cloud book on
Oracle Help Center.
◦ For more details, see Master Note - Importing Data using FBDI (Doc ID 2665940.1) on My Oracle Support.
• Use a web service to create an integration that imports source orders. See the Guidelines for Using Web Services
to Integrate Order Management topic.
• Use the salesOrdersForOrderHub REST API to import your source orders.
Its recommended that you use file-based data import (FBDI) instead of web services or REST API to import a large
number of source orders. FBDI is more resilient and is easier to retry imports that fail without having to resend the
source order from your source system.
Consider an example.
If you must use a web service or REST API to import your source orders, then include only one source order in each
payload request.
REST API only supports the synchronous operation, so if you include more than one source order in each payload, and if
the request runs for more than about 5 minutes, then you might encounter a time out error that you can't recover from.
If you must use the Order Import web service, then use the asynchronous operation. Don't use the synchronous
operation.
Related Topics
• Data Security
• Guidelines for Using Web Services to Integrate Order Management
967
Oracle SCM Cloud Chapter 5
Implementing Order Management Import and Transform
Privilege Description
HZ_ENTER_TRADING_COMMUNITY_PERSON_PRIV
Enter Trading Community Person
HZ_UPDATE_TRADING_COMMUNITY_PERSON_PRIV
Update Trading Community Person
HZ_ENTER_TRADING_COMMUNITY_ORGANIZATION_INFORMATION_PRIV
Enter Trading Community Organization Information
HZ_UPDATE_TRADING_COMMUNITY_ORGANIZATION_PRIV
Update Trading Community Organization
For details about how to add a privilege, see the Data Security topic.
If you're using.
• REST API to do the import, then set the SubmittedFlag attribute to false in the Sales Orders For Order Hub REST
API resource. False is the default value in REST API.
• A web service to do the import, then set the SubmittedFlag attribute to N in your web service payload.
In some instances its important to import your sales order in draft status to avoid a problem in downstream fulfillment.
For example, assume you import a sales order and need to modify the quantity to avoid having the order get stuck in
awaiting shipping status because your inventory levels are fluctuating. You can import it as a draft, modify the quantity
in the Order Management work area so it meets your downstream fulfillment requirements, then submit it
If you use FBDI, REST API, or a web service to import a draft sales order, then do another import that changes the
draft, then Order Management assigns a new order number to the draft. You must use the new order number in any
subsequent updates or processing. For example, assume you use FBDI to import source order 57486, and Order
Management saves 57486 as a draft. You then use FBDI to import a change to a date attribute on order 57486. Order
Management will create a new order number, such as 57490, then save your change in 57490. You can't use order 57486
anymore. You must use order 57490.
Import a Revision
If you import a draft order, modify it in the Order Management work area, submit it, then import a revision of the order
in a subsequent import, then the imported revision must include the current attribute values. If you want to change
attribute values, then the imported revision must include the new values.
968
Oracle SCM Cloud Chapter 5
Implementing Order Management Import and Transform
For example, assume you set up an order management extension that sets the default value for the Shipping Method
attribute. You import a value of Air for Shipping Method, you change the Shipping Method to Rail in the Order
Management work area, submit the order, then import an order revision in a subsequent import. If you want to keep
Rail, then your subsequent import must include a value of Rail for Shipping Method. If the subsequent import doesn't
include any value for Shipping Method, then Order Management will set Shipping Method to some other value,
depending on your pretransformation rule.
RevisionSourceOrderSystem Attribute
You can use the RevisionSourceOrderSystem attribute to identify the source system that sends a revision of the sales
order. You can use RevisionSourceOrderSystem in a processing constraint to control the changes that you allow when
you import a revision from the source system.
RevisionSourceOrderSystem doesn't affect any other processing that Order Management does when you create a draft
of the revision or submit it. For example, Order Management doesn't create a new revision according to how you set
RevisionSourceOrderSystem.
Assume you.
1. Import revision 1 for order 45768, with a quantity of 10 on line 1, and RevisionSourceOrderSystem in the import
payload for this order contains EastSystem.
2. Import revision 2 for order 45768 from source system EastSystem, RevisionSourceOrderSystem in the import
payload contains EastSystem, the import adds line 2 with a quantity of 5, and you keep it in draft status.
3. Import an update for revision 1 from another system, WestSystem, RevisionSourceOrderSystem in the import
payload contains WestSystem, the import updates the quantity on line 1 to 7, the quantity on line 2 to 5, and
you submit the order. Order Management will submit this update and overwrite the revision 2 that it received
from EastSystem. The submitted order will contain a quantity of 7 on line 1 and a quantity of 5 on line 2. Order
Management won't create a third revision.
◦ Click Click for Rule In the Line Selection Criteria column on the Create Invoice step.
◦ In the Line-Selection Criteria Set dialog, in the If area, change the first condition to.
If 1 is 2
1 will never equal 2, so this condition instructs the orchestration process to skip invoicing for the order
line and immediately close the order line.
◦ Delete all the other conditions in the If area.
4. Release and deploy your new orchestration process.
5. Use the Manage Process Assignment Rules for Sales Orders task to create an assignment rule that assigns your
new orchestration process according to your requirement. Assume you use the status value Closed in your
import payload to indicate a closed line. Here's your rule.
969
Oracle SCM Cloud Chapter 5
Implementing Order Management Import and Transform
If Status Code (Order Fulfill Line) is equal to Closed, then Process Name is set to Immediately Close
Imported Sales Orders
For details, see the Overview of Using Business Rules With Order Management topic.
6. Import your sales orders.
Your custom orchestration process will immediately close the sales orders that meet your criteria.
Related Topics
• How Order Management Transforms Source Orders Into Sales Orders
• Data Security
970
Oracle SCM Cloud Chapter 5
Implementing Order Management Import and Transform
Note.
• Create a CSV file, such as MySourceOrders.csv. To make sure you include the same structure that the template
uses, its recommended that you open the template file, save it as a CSV file, structure your data so it mirrors the
CSV file, and then copy your source data into the CSV file
971
Oracle SCM Cloud Chapter 5
Implementing Order Management Import and Transform
• Include the same table names and sequence them in the same sequential order. The tab sequence that the
template uses determines sequential order.
• Include the same columns in each table, and arrange columns in the same sequential order inside each table.
• Use the same data type for each column.
Example
View an example of the CSV structure.
Related Topics
• How Order Management Transforms Source Orders Into Sales Orders
• Data Security
972
Oracle SCM Cloud Chapter 5
Implementing Order Management Import and Transform
Enter your data so it reflects the structure of the Oracle database. The Order Import Template uses a separate
spreadsheet in an Excel workbook to represent each interface table.
Order Import Template includes a tab for each of these interface tables. The _INT suffix indicates its an interface table.
You must include data in each required table.
973
Oracle SCM Cloud Chapter 5
Implementing Order Management Import and Transform
DOO_ORDER_CHARGES_INT Charges for the sales order. Required only if you don't calculate pricing
in Oracle Fusion.
DOO_ORDER_CHARGE_COMPS_INT Charge components for the sales order. Required only if you don't calculate pricing
in Oracle Fusion.
Example
974
Oracle SCM Cloud Chapter 5
Implementing Order Management Import and Transform
Here's an example where the columns and values on the DOO_ORDER_CHARGES_INT worksheet reflect data from the
Manage Pricing Charge Definitions page in the Setup and Maintenance work area.
For example.
975
Oracle SCM Cloud Chapter 5
Implementing Order Management Import and Transform
976
Oracle SCM Cloud Chapter 5
Implementing Order Management Import and Transform
Note.
• Order Import Template uses an asterisk ( * ) to indicate required columns. For example, the Source Transaction
Schedule Identifier column on the DOO_ORDER_LINES_ALL_INT tab is required.
• The template uses an asterisk ( * ) to indicate each required column.
• The template uses a double asterisk ( ** ) to indicate the color group requires a value in at least one of these
columns. For example, if a color group includes columns **a, **b, and c, then you must include a value in a or b,
or a and b.
• Required columns aren't always contiguous. Carefully examine column headings in each spreadsheet to make
sure you include data for each required column.
• To locate required headings on each spreadsheet, press CTRL + F, enter ~* (a tilde and an asterisk), and then
click Find All.
The DOO_ORDER_LINES_ALL_INT sheet contains these columns and uses them only for rows that references a
return order. The sheet includes an instructional note immediately above each conditional color group.
977
Oracle SCM Cloud Chapter 5
Implementing Order Management Import and Transform
For details, see the topic about Oracle data types in Oracle Server Concepts Manual at https://docs.oracle.com/cd/
A57673_01/DOC/server/doc/SCN73/ch6.htm.
Note
• You must use a comma (,) for the thousands separator and a period (.) for the decimal separator in number
columns. For example, use 1,500.25. Don't use 1500,25.
• Use a whole number when required. If a column must use a whole number, then the control file that validates
data in this column includes only whole numbers. If it doesn't, then the import fails.
• You must use format YYYY/MM/DD HH:MM:SS for each date field. For example, 1/15/2019 10:10:10 AM is January 15,
year 2019, 10 hours, 10 minutes, and 10 seconds after 00:00:00 AM.
978
Oracle SCM Cloud Chapter 5
Implementing Order Management Import and Transform
• Read the descriptive text in the spreadsheet for help with columns that require an internal identifier.
• The template includes more than one column that specifies details for internal identifiers. It uses the Identifier
suffix to identify these columns, such as Source Transaction Identifier or Buying Party Identifier.
• If your source data includes an identifier column that doesn't require setup in Product Information
Management, Trading Community Architecture, or data collection, then you can use the implementation pages
in your implementation project to get the identifier and other attributes that you must map for the internal
identifier.
Related Topics
• How Order Management Transforms Source Orders Into Sales Orders
• Data Security
979
Oracle SCM Cloud Chapter 5
Implementing Order Management Import and Transform
Note.
• Use the Load Interface File for Import scheduled process to upload your data to the server.
Use the Import Sales Orders scheduled process to import data into Order Management.
980
Oracle SCM Cloud Chapter 5
Implementing Order Management Import and Transform
◦ Specify parameters as necessary. For example, filter according to source system, customer, and time
frame.
Related Topics
• How Order Management Transforms Source Orders Into Sales Orders
• Data Security
981
Oracle SCM Cloud Chapter 5
Implementing Order Management Import and Transform
Procedures
Import Orders into Order Management
Use files to import source orders from a source system into Order Management Cloud.
Note.
982
Oracle SCM Cloud Chapter 5
Implementing Order Management Import and Transform
Use the template to help make sure your converted data uses the same structure that the Oracle database requires.
This topic describes one recommended way to convert your source data. The details of your conversion might require a
different way.
If you can't use Order Import Template for some reason, and if you aren't familiar with doing data conversion, then
consult Oracle resources about how to use an open interface when importing data. For details about other ways to
import your data, such as through a web service, see the Use Web Services to Integrate with Order Management topic.
◦ Go to the File-Based Data Import for Oracle Supply Chain Management Cloud book on Oracle Help
Center at https://docs.oracle.com/pls/topic/lookup?ctx=fa-latest&id=OEFSC.
◦ Expand Order Management, then click Import Sales Orders.
◦ In the Import Sales Orders area, click SourceSalesOrderImportTemplate.xlsm.
2. Use a spreadsheet editor that can read a CSV file, such as Microsoft Excel, to open Order Import Template, and
then familiarize yourself with the structure that it uses.
3. Use a data manipulation tool to structure your source data so it mirrors the structure that the Order Import
Template contains, and then save this data to a CSV file.
You can use SQL (Structured Query Language), ODI (Oracle Data Integrator), or some other tool to convert your
source data into a CSV file.
◦ Use a spreadsheet editor that can read a CSV file, such as Excel, to open Order Import Template.
◦
Delete the example data from Order Import Template. This template comes with example data
that helps you determine the type of data that you must include. For example, row four of tab
DOO_ORDER_HEADERS_ALL_INT includes example data. Make sure you delete all example data from all
tables in the spreadsheet, even from tables you don't need.
2. Copy and paste your source data into each of the tables in Order Import Template.
◦ Use a spreadsheet editor to open the CSV file that contains your source data.
◦ Copy your order line data to the clipboard.
◦ In the Order Import Template, click the DOO_ORDER_LINES_ALL_INT tab.
◦ Click cell A5, then paste your data.
◦ Examine the results to make sure you correctly pasted the data. For example, make sure the Product
Description column contains VARCHAR data, and that the Ordered Quantity column contains NUMBER
data.
983
Oracle SCM Cloud Chapter 5
Implementing Order Management Import and Transform
◦ Continue copying data for each table until you finish copying all your source data into Order Import
Template.
Tip: Save your work after each copy.
◦ Click the Create CSV tab, then click Generate CSV File.
If Generate CSV File isn't active, then click Developer in the menu bar, then click Macros. In the Macro
dialog, choose GenCSV, then click Run.
◦ Wait for the macro in Excel to finish.
When the macro finishes, Excel displays a dialog that allows you to save a .zip file.
◦ In the save dialog, choose a location to save your .zip file, then click Save.
The macro creates a .zip file that includes a separate file for each table that the template contains.
◦ Optional. In subsequent save dialog boxes, save each individual CSV file.
If you must import data for an individual table, then save the data as an individual CSV file. Otherwise,
click Cancel.
Attribute Value
Parameter Description
984
Oracle SCM Cloud Chapter 5
Implementing Order Management Import and Transform
7. Click Submit.
8. In the Confirmation dialog, note the value of attribute Process ID, then click OK > Close.
9. Click Actions > Refresh.
10. Use the Process ID that you noted earlier to locate your scheduled process, then make sure the Status attribute
for this process displays Succeeded.
The Succeeded status indicates that the scheduled process successfully uploaded your source data. If the
upload fails on any row, then the status displays Error. If the search results doesn't display your process, then
click Refresh until it does.
11. Correct errors, if necessary.
◦ If the scheduled process ends in an error, then click the Error status in the search results for your
scheduled process and examine the log and output files to get details about data that caused the error.
◦ Use Excel to open the Order Import Template that contains your source data, and then correct the source
data that causes the error.
◦ In the Order Import Template, click Generate CSV File, then run the scheduled process again.
Repeat this step until the scheduled process successfully uploads your source data.
Parameter Description
Batch Name As an option, enter a value that you can use to identify the batch of sales orders that you're
importing.
◦ Yes. Delete each sales order that you successfully import from the interface tables.
Enter the value that you set in the Source Transaction System column on the
DOO_ORDER_LINES_ALL_INT tab of the Order Import Template.
Enter the value that you set in the Source Transaction Identifier column on the
DOO_ORDER_LINES_ALL_INT tab of the Order Import Template.
985
Oracle SCM Cloud Chapter 5
Implementing Order Management Import and Transform
Select the value that you set in the Buying Party Name column on the
DOO_ORDER_HEADERS_ALL_INT tab of the Order Import Template.
Select the value that you set in the Buying Party Identifier column on the
DOO_ORDER_HEADERS_ALL_INT tab of the Order Import Template.
Ordered Date Within the Following For sales orders according to the Ordered Date attribute.
Number of Days Ago
For example, if today is January 15, and if you set this parameter to 5, then the import will
only import sales orders that have an Ordered Date that occurs between January 11 and
January 15.
Order Interface Status If Order Management fails to import a source order, then it sets the status for the order to
an error status. Use this parameter to specify whether to process the order in a subsequent
import.
◦ Error. Import orders that are in error status. Ignore all other orders.
◦ No status. Import orders that have no status. Ignore all other orders.
The Succeeded status indicates that the scheduled process successfully imported your source data. If the
import fails on any row, then the status displays Error.
3. Verify your import.
986
Oracle SCM Cloud Chapter 5
Implementing Order Management Import and Transform
◦ Navigate to work area Order Management and query for one or more of the orders you imported.
◦ Make sure the work area displays the sales order, and that the order data is identical to the source data.
Related Topics
• How Order-to-Cash Works with Order Capture Systems
◦ Go to https://docs.oracle.com/en/cloud/index.html?ctx=fa-latest&id=OEFSC.
◦ Click Cloud Applications Documentation.
◦ Click Order Management.
◦ On the Oracle Supply Chain Management Cloud page, under File-Based Data Import for Oracle Supply
Chain Management Cloud, click HTML.
◦ On the File-Based Data Import for Oracle Supply Chain Management Cloud page, expand Order
Management, then click Import Sales Orders.
◦ In the File Links area, click SourceSalesOrderImportTemplate.xlsm.
This file contains example data that you can use for this example.
2. In the file you downloaded, click Generate CSV File, then save the output file as SourceSalesOrderImport.zip.
3. Run the Load Interface File For Import scheduled process.
4. Run the Import Sales Order scheduled process.
5. Go to the Order Management work area, use a fulfillment view to open a sales order that the example file
contains, then verify your imported data.
Examine the values in the Source Order, Ordered Date, Source Order System, and Status attributes. Make sure
they match the example data you imported.
987
Oracle SCM Cloud Chapter 5
Implementing Order Management Import and Transform
Here's an example.
Your data might or might not match the data in this screen print, depending on the example data that's
available in SourceSalesOrderImportTemplate.xlsm.
988
Oracle SCM Cloud Chapter 5
Implementing Order Management Import and Transform
DOO_ORDER_HEADERS_ALL_INT
Attribute Value
SourceTransactionIdentifier PMC_IMP_161208
SourceTransactionSystem OPS
SourceTransactionNumber PMC_IMP_161208
SourceTransactionRevisionNumber 1
BuyingPartyIdentifier 300000001469001
BuyingPartyType ORGANIZATION
TransactionalCurrencyCode USD
TransactionalCurrencyName US Dollar
BatchName 10810
PartialShipAllowedFlag N
FreezePriceFlag N
FreezeShippingChargeFlag N
FreezeTaxFlag N
989
Oracle SCM Cloud Chapter 5
Implementing Order Management Import and Transform
Attribute Value
CreateCustomerInformationFlag N
DOO_ORDER_LINES_ALL_INT
Attribute Value
SourceTransactionIdentifier PMC_IMP_161208
SourceTransactionSystem OPS
SourceTransactionLineIdentifier 1
SourceTransactionScheduleIdentifier 1011
SourceTransactionScheduleNumber 11
SourceTransactionLineNumber 1
ProductNumber AS54888
OrderedQuantity 3
OrderedUOMCode zzy
OrderedUOM Ea
RequestedFulfillmentOrganizationCode DOOCSPS1
SubstitutionAllowedFlag N
RequestedShipDate 2016/12/09
PaymentTerm 30 Net
TransactionCategoryCode ORDER
990
Oracle SCM Cloud Chapter 5
Implementing Order Management Import and Transform
Attribute Value
PartialShipAllowedFlag N
ContractStartDate 2014/09/26
ContractEndDate 2019/09/26
DOO_ORDER_ADDRESSES_INT
SourceTransactionLineIdentifier 1 1
State AZ CO
991
Oracle SCM Cloud Chapter 5
Implementing Order Management Import and Transform
Related Topics
• How Order Management Transforms Source Orders Into Sales Orders
992
Oracle SCM Cloud Chapter 5
Implementing Order Management Import and Transform
r65tf1HeY6qAqF/ynTqMagHfNDaEeuFFww1MuM67fJrCdizrDBjKY4S1nERgrFvGYsu2/
pVm9YKbulyRbMNtxrbJcEAkTd0EZEeUoeE7uZ8l1sru7Thx386twx4/
p7dV87qMupf86jDVxbza6LYF6a6JeKWhop7SLZsHjsiPQy8j7VYAoW1Nj1SUjjD4TRTlb8hiCm+XnH9cffTTo/
FP0Og4u8PFn45k9dp2XJOv4BUW7b9cKslMO3TY8nvloCHROogTAlypB20e98zlQFg8tVzVKwYWPBu1d7c9q56OzEneG5ksV/
AZQSwMEFAAAAAgAdLBaSaddoJiUAQAAcQQAABoAAABORVcgRVJST1IvSU5WX1Jlc3BvbnNlLnR4dKVUwU6DQBC9m/
gPG86WQT1JthxqMGrUmlaNnsx2GSnNskt2t7T9e4EWSltqNF4I+2bevNk3DBRl7ocyR6EyJMtUSOMXUN
+ZWpv5AIZPMWXGLSJGscxVOobyBXDDASc4PSGEVIVukUWooYUMVLRaH2vkhs2FbaAS/
SoRriIMyvgYdY6awhY9yDVWJzIO7gfD3sWV53k+eZW4zJBbjAguOWY2UZJwNo
+n1iczljNXMBm7T3MhnlUiLeqwTjsjqYn7soj4pHxulAuNUqOtHaFliWhDJWqlqXpOOIZaK/2IxrC49rKINl5WSOEg4wJdrlJg0ReYnAOWPAPOhrM
cLzzuH98WFcjaSXSGOZ5OjsNVT3VFlX2UOhOXenpuuW/2Lorwyl0K7erW2wmHZiV8E4fAtHdy8fn
+FoNBxR2Al2c9cDIYVfvl1l2HeOzKLDon/K1/TGm2vBjHliKQYz9pM5FI7QDm8I2yt2RI
+U2Xxds4ly7yfqr7IUjji4swew1xSFvb2m0Fr99aH
+xQTfUEsBAh8ACgAAAAAAfLBaSQAAAAAAAAAAAAAAAAoAJAAAAAAAAAAQAAAAAAAAAE5FVyBFUlJPUi8KACAAAAAAAAEAGAAqIGJSsy/
SASogYlKzL9IBIGmkTLMv0gFQSwECHwAUAAAACABqsFpJ46UaP4sCAAC8BgAAGQAkAAAAAAAAACAAAAAoAAAATkVXIEVSUk9SL0lOVl9SZXF1ZXN0
SAVBLAQIfABQAAAAIAHSwWkmnXaCYlAEAAHEEAAAaACQAAAAAAAAAIAAAAOoCAABORVcgRVJST1IvSU5WX1Jlc3BvbnNlLnR4dAoAIAAAAAAAAQAY
SAVBLBQYAAAAAAwADADMBAAC2BAAAAAA=</erp:Content>
<erp:FileName>E:\WIP\errors.zip</erp:FileName>
<!--Optional:-->
<erp:ContentType>zip</erp:ContentType>
<!--Optional:-->
<erp:DocumentTitle>PCTitle002</erp:DocumentTitle>
<!--Optional:-->
<erp:DocumentAuthor>Diane Cho</erp:DocumentAuthor>
<!--Optional:-->
<erp:DocumentSecurityGroup>FAFusionImportExport</erp:DocumentSecurityGroup>
<!--Optional:-->
<erp:DocumentAccount>scm$/sourceSalesOrder$/import$</erp:DocumentAccount>
<!--Optional:-->
<erp:DocumentName>PCName002</erp:DocumentName>
<!--Optional:-->
<erp:DocumentId>002</erp:DocumentId>
</typ:document>
</typ:uploadFileToUcm>
</soapenv:Body>
</soapenv:Envelope>
Note.
Code Value
UsernameToken Add this token while you're creating the payload in SOAP UI.
erp:content Insert the BASE64 content that you encoded earlier in this procedure into erp:content.
erp:content stores the details of the file that you're importing in BASE64. This BASE64
content represents the sales order data that you created through file-based data import.
993
Oracle SCM Cloud Chapter 5
Implementing Order Management Import and Transform
Code Value
FileName If your upload fails, examine the errors.zip file. It contains details about why the upload
failed.
DocumentAuthor Enter your name. You can use it later when you verify the upload. For this example, assume
your name is Diane Cho.
erp:DocumentAccount Use scm$/sourceSalesOrder$/import$ because it identifies the account you use when
you run the scheduled process that imports sales orders later in this procedure.
For more details about the attributes in this payload, see the Document Information topic at https://
docs.oracle.com/en/cloud/saas/financials/20c/oeswf/business-object-services.html#documentinformation-
d13711e127813.
5. Use this URL to access the WSDL for the service.
https://servername/fscmService/ErpIntegrationService?WSDL
For details, see the uploadFileToUcm section in the ERP Integration Service topic at https://docs.oracle.com/
en/cloud/saas/financials/20c/oeswf/business-object-services.html#erpintegrationservice-d13711e35944.
7. Notice the document Id that the submit returns. You use it when you verify the scheduled process.
8. Verify the import.
◦ Sign into Oracle Fusion Applications, then go to the File Import and Export work area.
◦ On the Overview page, enter Diane Cho in the Owner attribute, then click Search.
◦ Examine the search results and verify that it contains the errors.zip file and the sourceSalesOrder file.
The sourceSalesOrder file is now on the server. You will reference next when you run the scheduled
process.
994
Oracle SCM Cloud Chapter 5
Implementing Order Management Import and Transform
Here's an example payload you can use when you use the submitESSJobRequest operation in your SOAP UI
call.
Note.
◦ typ:paramList>72 identifies the import process you use with the uploadFiletoUcm operation. The value
72 indicates that you imported a sales order. To determine this value, see How to Find Payload Parameter
for Load Interface File For Import Web Service (or any ESS Process)? (Doc ID 2071025.1) on My Oracle
Support.
◦ <typ:paramList>24131 identifies the file you import when you use with the uploadFiletoUcm operation.
2. Use the getESSJobStatus operation in your SOAP UI call to get the status of your scheduled process.
995
Oracle SCM Cloud Chapter 5
Implementing Order Management Import and Transform
</wsse:UsernameToken>
</wsse:Security>
</soapenv:Header>
<soapenv:Body>
<typ:getESSJobStatus>
<typ:requestId>55562</typ:requestId>
</typ:getESSJobStatus>
</soapenv:Body>
</soapenv:Envelope>
typ:requestId>55562 identifies the scheduled process that runs when you submit the submitESSJobRequest
operation.
Here are some other web services you can also use.
• Communicate status details or order details to the source system that requests it.
Get Order Details
• Get details about the entire sales order or a set of order lines.
• Get details about a sales order that starts in an integrated source system.
You can specify a source system so the query limits results to only this system. If you don't
specify a source system, then the service might return order numbers from more than one
source system.
Apply a Hold Route a request for a hold from your source system to a hold task. Process more than one hold
in a request, each hold for one sales order, or more than one order line in the sales order.
Release a Hold Route a request to release a hold from our source system to the hold task.
Check Availability Send a request to Order Management to determine the quantity that's available on a date in
the source system. Order Management sends a reply to the source system that includes these
details.
996
Oracle SCM Cloud Chapter 5
Implementing Order Management Import and Transform
Assume you use Integration Cloud Service to integrate your implementation. The original order line contains a quantity
of 100. Global Order Promising analyzes the supply chain and determines the best way to fulfill your order is to split the
order into two fulfillment lines, where line 1.1 contains a quantity of 75 and line 1.2 contains a quantity of 25. Promising
sends the request to Integration Cloud Service, who then calls the Order Import web service to make the change in
Order Management Cloud, and Order Management successfully splits the line.
The supply chain is constantly changing. The next day, Global Order Promising analyzes the supply chain again and
determines to use a quantity of 60 on line 1.1 and 40 on line 2.2. So you now must change the quantity on line 1.1 from 75
to 60, and the quantity on line 1.2 from 60 to 40.
But you encounter a null pointer error because the import can't locate the fulfillment lines.
You use the Order Import service again to change the values but this time specify different source lines so they match
the fulfillment lines.
The import updates the quantity on line 1 to 60, cancels line 1.2, and creates a new line 2 with a quantity of 40.
Some time later, you receive a request to update only fulfillment line 1.1. You use the Order Import service to successfully
update line 1.1, but the import automatically cancels line 2.
You can only do these kinds of updates to split fulfillment lines in the Order Management work area. You can't use the
Order Import service to do them.
Related Topics
• How Order Management Transforms Source Orders Into Sales Orders
• Web Services You Can Use to Integrate Order Management
• Example Web Service Payloads That Integrate Order Management
997
Oracle SCM Cloud Chapter 5
Implementing Order Management Import and Transform
Option Description
Create one configuration package. This package contains the offerings that include the inventory organizations, and that also
contains the Order Management offering.
Create more than one configuration Use a separate configuration package for the offering that includes the inventory
package. organizations, and use another package for the Order Management offering.
Scenario
You can create a relationship between the AS54888 and DESK-COMP-10 when you import.
• The customer item relationship sets up a relationship between the customer item that you import, and the item
in inventory that you use to fulfill the customer item.
• Order Management uses the customer item and sold-to customer details to identify the inventory item to use
during order import.
• If you set up more than one customer item relationship for a customer item, then Order Management uses the
customer item relationship that has the lowest rank.
998
Oracle SCM Cloud Chapter 5
Implementing Order Management Import and Transform
If you don't sign in with this role, then the Product Information Management work area won't display your
product details and you won't be able to do this procedure. For details, see the Job Roles and Duty Roles That
You Use to Implement Order Management topic.
2. Go to the Product Information Management work area, then click Tasks > Manage Trading Partner Items.
3. On the Manage Trading Partner Items page, click Create Trading Partner Item (the plus icon).
4. In the Create Trading Partner area, set the values.
Attribute Value
Type Customer
Status Active
Start Date Set the time frame when you want Order Management to use this partner item.
End Date The import validates these dates. If the dates in your import don't match the dates that you
set on the Create Trading Partner Items page, then the import will fail.
Attribute Value
Set it to the inventory organization that maintains inventory for the AS54888.
Item AS54888
Rank 1
◦ Enter a value. If you don't enter a value, then Order Management can't identify the
inventory item to use during order import, and your import will fail.
◦ Make sure the value that you enter is unique across the customer item relationships
that you set up for this customer item.
For example, if you set up a rank of 5 for AS54888, and a rank of 5 for AS54600, then
the import will fail because Order Management can't determine which customer item
relationship takes precedence.
999
Oracle SCM Cloud Chapter 5
Implementing Order Management Import and Transform
Attribute Value
Item AS54600
Rank 2
Attribute Value
Note: Make sure you include a value in all other required attributes.
Attribute Value
If you're importing through a web service or REST API, set values in the payload.
Attribute Value
ProductNumber AS54888
1000
Oracle SCM Cloud Chapter 5
Implementing Order Management Import and Transform
Attribute Value
CustomerItemId DESK-COMP-10
Related Topics
• Job Roles and Duty Roles That You Use to Implement Order Management
• Bill-to Customer
1001
Oracle SCM Cloud Chapter 5
Implementing Order Management Import and Transform
• Bill-to Account
Attribute Value
Customer Name Name of customer you're importing, such as Computer Service and Rentals.
Use this attribute only when Address Use Type contains BILL_TO.
Account Site Identifier Value that uniquely identifies the account, such as 300000001469016.
1002
Oracle SCM Cloud Chapter 5
Implementing Order Management Import and Transform
Attribute Value
Use this attribute only when Address Use Type contains BILL_TO.
• Ship-to Customer
• Ship-to Address
1003
Oracle SCM Cloud Chapter 5
Implementing Order Management Import and Transform
Attribute Value
Party Name Name of the party you're importing, such as Computer Service and Rentals.
Use this attribute only when Address Use Type contains SHIP_TO.
Party Site Identifier Value that uniquely identifies the party site address, such as 300000001469004.
Use this attribute only when Address Use Type contains SHIP_TO.
• Bill-to Customer
1004
Oracle SCM Cloud Chapter 5
Implementing Order Management Import and Transform
• Bill-to Address
Set the same values that you use to populate order header attributes, except set this attribute.
Attribute Description
Source Transaction Line Identifier Value that uniquely identifies the transaction line in the source system, such as 1.
1005
Oracle SCM Cloud Chapter 5
Implementing Order Management Import and Transform
Note.
• Make sure you set Source Transaction Line Identifier on DOO_ORDER_LINES_ALL_INT and on
DOO_ORDER_ADDRESSES_INT to the same value.
• The import uses Source Transaction Line Identifier to create a relationship between the address on
DOO_ORDER_ADDRESSES_INT with the order line on DOO_ORDER_LINES_ALL_INT.
Set a value for Source Transaction Line Identifier only if your Ship-to Address on the order line must be different than
the Ship-to Address on the order header.
If the Ship-to Address is the same for the order header and all order lines, then leave these attributes empty on the
DOO_ORDER_ADDRESSES_INT tab.
You set the Address Use Type attribute to BILL_TO or SHIP_TO, and the template uses these values to determine which
row to use when it populates the Bill_to and Ship_to attributes on the order header. For example, if you set Address Use
Type to SHIP_TO on row 5 of DOO_ORDER_ADDRESSES_INT, and if the Address Line1 attribute on row 5 contains 123
Main Street, then the import sets the Ship-to Address address on the order header to 123 Main Street, and it cascades
this value from the order header to the Ship-to Address on all order lines.
If you import a sales order and find that attributes on the order header are empty, its possible that you set values for
Source Transaction Line Identifier and Source Transaction Schedule Identifier on DOO_ORDER_ADDRESSES_INT but
not for Address Use Type and other attributes that the import uses to populate values on the order header, such as
Party Site Identifier and Address Line1.
• Ship-to Customer
• Ship-to Address
1006
Oracle SCM Cloud Chapter 5
Implementing Order Management Import and Transform
1007
Oracle SCM Cloud Chapter 5
Implementing Order Management Import and Transform
1008
Oracle SCM Cloud Chapter 5
Implementing Order Management Import and Transform
hzl.ADDRESS2 ,
hzl.ADDRESS3 ,
hzl.ADDRESS4 ,
hzl.CITY ,
hzl.POSTAL_CODE ,
hzl.STATE ,
hzl.COUNTRY
FROM fusion.HZ_PARTIES HZP ,
fusion.HZ_PARTY_SITES hzps ,
fusion.HZ_CUST_ACCOUNTS HZA ,
fusion.HZ_CUST_ACCT_SITES_ALL hzcasa,
fusion.HZ_CUST_SITE_USES_ALL hzcsua ,
fusion.hz_locations HZL
WHERE hzP.party_id = HZA.party_id (+)
AND hza.CUST_ACCOUNT_ID = hzcasa.CUST_ACCOUNT_ID (+)
AND hzcasa.party_site_id = hzps.party_site_id (+)
AND hzcasa.cust_acct_site_id = hzcsua.cust_acct_site_id (+)
AND hzps.location_id = hzl.location_id (+)
-- and (
-- hzcasa.start_Date <= sysdate
-- OR hzcasa.start_Date IS NULL
-- )
-- AND
-- (
-- hzcasa.end_date >= sysdate
-- OR hzcasa.end_date IS NULL
-- )
AND upper(hzP.party_name) LIKE upper('%GOO%IND%')
ORDER BY hzp.party_number ,
hza.account_number,
hzl.LOCATION_ID
Note.
In your SQL, replace the placeholder with a value from your order import template.
1009
Oracle SCM Cloud Chapter 5
Implementing Order Management Import and Transform
Related Topics
• Use SQL to Query Order Management Data
• How Order-to-Cash Works with Order Capture Systems
Sales Orders for Order Hub SourceSalesOrderImportTemplate Through File-Based Data Import
Resource in REST API
If you import a shipping method through REST API or FBDI, you must make sure the method is valid.
• If you include a value for one of the three attributes, then you must include a value for all of them. For
example, if you include a value for ShippingCarrierId, then you must include a value for ShippingMode and
ShippingServiceLevel.
• The WSH_MODE_OF_TRANSPORT lookup type must contain the value you import for ShippingMode.
• The WSH_SERVICE_LEVELS lookup type must contain the value you import for ShippingServiceLevel.
The combination of ShippingCarrierId, ShippingMode, and ShippingServiceLevel must be valid with each other. Here's
an easy way to identify valid combinations that you can import.
1. Go to the Order Management work area, then create a sales order.
2. In the Order Lines area, click Shipment Details.
3. On the Shipment Details tab, in the Shipping Method attribute, click down arrow > Search.
4. In the Select Shipping Method dialog, leave the attributes in the Search area empty and click Search.
5. Choose a set of values from the search results and use them in your REST API payload or FBDI template.
Here are some example results.
Airborne Parcel 2nd day air Airborne Parcel 2nd day air
1010
Oracle SCM Cloud Chapter 5
Implementing Order Management Import and Transform
◦ On the Manage Carriers Lookups page, search Lookup Type for WSH_MODE_OF_TRANSPORT.
◦ In the search results, examine the values in the Lookup Meaning column.
Example results include Air, Less than Truckload, Ocean, Parcel, Rail, Truckload, and so on. Set the
ShippingMode attribute in your import payload to one of these values.
If you don't see the lookup code you need, then click Actions > New in the Lookup Codes area, and add
it.
3. Identify the service levels you can use.
◦ On the Manage Carriers Lookups page, search Lookup Type for WSH_SERVICE_LEVELS.
◦ In the search results, examine the values in the Lookup Meaning column.
Example results include Door-to-door, Express, FedEx 2day, and so on. Set the ShippingServiceLevel
attribute in your import payload to one of these values.
If you don't see the lookup code you need, then click Actions > New in the Lookup Codes area, and add
it.
1011
Oracle SCM Cloud Chapter 5
Implementing Order Management Import and Transform
Troubleshoot
If you import a shipping method that isn't valid, then the communication with Global Order Promising might fail. You
will notice when the Order Entry Specialist attempts to submit a sales order but receives an error, similar to. . .
You can't submit the sales order because the combination of the mode of transport, service level, and
carrier that determines the shipping method on the order header isn't valid.
Trouble Shoot
Make sure your set ups don't modify the mappings that msc_xref_mapping references.
The msc_xref_mapping entity in the
Order Orchestration and Planning
Data Repository maps values for
the shipping method. For example,
assume you see Airborne Parcel 2nd
day air in the Order Management
work area, but msc_xref_mapping
maps the alphanumeric value to
a numeric value, so the repository
stores only the numeric value.
1012
Oracle SCM Cloud Chapter 5
Implementing Order Management Import and Transform
Use the DocumentReferenceType attribute to identify the original order line you're returning.
DocumentReferenceType Description
ORIGINAL_SALES_ORDER Identify the original order line in the source system from a channel, such as a legacy order
capture system.
ORIGINAL_ORCHESTRATION_ORDER Identify the original sales order line in Order Management Cloud.
Use ORIGINAL_SALES_ORDER
Use ORIGINAL_SALES_ORDER in the DocumentReference section to specify details about the source order you
originally created in your source system.
1013
Oracle SCM Cloud Chapter 5
Implementing Order Management Import and Transform
Note.
• Provide values that uniquely identify the source order line. For instance, you can provide identifiers for the
source order and source order line to uniquely identify the source order line. You can also provide other values,
such as source order number and source order line number, to uniquely identify the source order line.
• Include values for DocumentNumber or DocumentIdentifier, or DocumentNumber and DocumentIdentifier.
• Include values for DocumentLineNumber or DocumentLineIdentifier, or DocumentLineNumber and
DocumentLineIdentifier.
Use ORIGINAL_ORCHESTRATION_ORDER
Add another DocumentReference section, and use ORIGINAL_ORCHESTRATION_ORDER to identify details about the
order you originally created in Order Management Cloud.
LineNumber
DocumentLineNumber
DocumentSubLineNumber
1014
Oracle SCM Cloud Chapter 5
Implementing Order Management Import and Transform
Example Payload
Here's an example payload. It uses ORIGINAL_SALES_ORDER and ORIGINAL_ORCHESTRATION_ORDER. You use the
DocumentReference section to specify details about the original sales order. Use the Order Information Service to get
the values you need for your payload. For details, see the Web Services You Can Use to Integrate Order Management
topic.
<ns2:DocumentReference>
<ns2:DocumentReferenceType>ORIGINAL_SALES_ORDER</ns2:DocumentReferenceType>
<ns2:DocumentIdentifier>CS_SO_1234445555565656</ns2:DocumentIdentifier>
<ns2:DocumentAdditionalIdentifier>LEG</ns2:DocumentAdditionalIdentifier>
<ns2:DocumentNumber>CS_SO_122_0034</ns2:DocumentNumber>
<ns2:DocumentAdditionalNumber/>
<ns2:DocumentLineIdentifier>101</ns2:DocumentLineIdentifier>
<ns2:DocumentAdditionalLineIdentifier/>
<ns2:DocumentLineNumber/>
<ns2:DocumentAdditionalLineNumber/>
<ns2:DocumentAdditionalSubLineIdentifier/>
<ns2:DocumentSubLineNumber/>
<ns2:DocumentAdditionalSubLineNumber/>
</ns2:DocumentReference>
<ns2:DocumentReference>
<ns2:DocumentReferenceType>ORIGINAL_ORCHESTRATION_ORDER</ns2:DocumentReferenceType>
<ns2:DocumentIdentifier>300100177488708</ns2:DocumentIdentifier>
<ns2:DocumentAdditionalIdentifier>GPR</ns2:DocumentAdditionalIdentifier>
<ns2:DocumentNumber>45098</ns2:DocumentNumber>
<ns2:DocumentAdditionalNumber/>
<ns2:DocumentLineIdentifier>300100177488711</ns2:DocumentLineIdentifier>
<ns2:DocumentSubLineIdentifier>300100177495497</ns2:DocumentSubLineIdentifier>
<ns2:DocumentAdditionalLineIdentifier/>
<ns2:DocumentLineNumber>1</ns2:DocumentLineNumber>
<ns2:DocumentAdditionalLineNumber/>
<ns2:DocumentSubLineNumber>2</ns2:DocumentSubLineNumber>
<ns2:DocumentAdditionalSubLineNumber/>
</ns2:DocumentReference>
Here's the entire payload. It returns a quantity of 1 Each for item AS92888.
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<ns1:createOrders xmlns:ns1="http://xmlns.oracle.com/apps/scm/fom/importOrders/orderImportService/types/">
<ns1:request xmlns:ns2="http://xmlns.oracle.com/apps/scm/fom/importOrders/orderImportService/">
<ns2:BatchName>Test001</ns2:BatchName>
<ns2:Order>
<ns2:SourceTransactionIdentifier>ppar_mar22_12</ns2:SourceTransactionIdentifier>
<ns2:SourceTransactionSystem>GPR</ns2:SourceTransactionSystem>
1015
Oracle SCM Cloud Chapter 5
Implementing Order Management Import and Transform
<ns2:SourceTransactionNumber>ppar_mar22_12</ns2:SourceTransactionNumber>
<ns2:BuyingPartyId>1006</ns2:BuyingPartyId>
<ns2:BuyingPartyContactId>1560</ns2:BuyingPartyContactId>
<ns2:TransactionalCurrencyCode>USD</ns2:TransactionalCurrencyCode>
<ns2:TransactionOn>2018-01-01T06:08:52.0340</ns2:TransactionOn>
<ns2:RequestingBusinessUnitIdentifier>204</ns2:RequestingBusinessUnitIdentifier>
<ns2:RequestingLegalUnitIdentifier>204</ns2:RequestingLegalUnitIdentifier>
<ns2:FreezePriceFlag>true</ns2:FreezePriceFlag>
<ns2:FreezeShippingChargeFlag>true</ns2:FreezeShippingChargeFlag>
<ns2:FreezeTaxFlag>true</ns2:FreezeTaxFlag>
<ns2:ShipToPartyIdentifier>1006</ns2:ShipToPartyIdentifier>
<ns2:ShipToPartySiteIdentifier>1036</ns2:ShipToPartySiteIdentifier>
<ns2:ShipToPartyContactIdentifier>1560</ns2:ShipToPartyContactIdentifier>
<ns2:BillToCustomerIdentifier>1006</ns2:BillToCustomerIdentifier>
<ns2:BillToCustomerName>1006</ns2:BillToCustomerName>
<ns2:BillToAccountSiteUseIdentifier>1025</ns2:BillToAccountSiteUseIdentifier>
<ns2:BillToAccountContactIdentifier>4820</ns2:BillToAccountContactIdentifier>
<ns2:Line>
<ns2:SourceTransactionLineIdentifier>101</ns2:SourceTransactionLineIdentifier>
<ns2:SourceTransactionScheduleIdentifier>101</ns2:SourceTransactionScheduleIdentifier>
<ns2:SourceTransactionLineNumber>1</ns2:SourceTransactionLineNumber>
<ns2:SourceTransactionScheduleNumber>1</ns2:SourceTransactionScheduleNumber>
<ns2:ProductNumber>AS92888</ns2:ProductNumber>
<ns2:OrderedQuantity>1</ns2:OrderedQuantity>
<!--ns2:OrderedUOMCode>BX1</ns2:OrderedUOMCode-->
<ns2:OrderedUOM>Each</ns2:OrderedUOM>
<ns2:RequestedFulfillmentOrganizationIdentifier>207</ns2:RequestedFulfillmentOrganizationIdentifier>
<ns2:RequestingBusinessUnitIdentifier>204</ns2:RequestingBusinessUnitIdentifier>
<ns2:RequestedShipDate>2018-01-01T06:08:52.0340</ns2:RequestedShipDate>
<ns2:PaymentTermsCode>4</ns2:PaymentTermsCode>
<ns2:TransactionCategoryCode>RETURN</ns2:TransactionCategoryCode>
<ns2:ShipToPartyIdentifier>1006</ns2:ShipToPartyIdentifier>
<ns2:ScheduleShipDate>2018-11-20T06:08:52.0340</ns2:ScheduleShipDate>
<ns2:ScheduleArrivalDate>2018-11-20T06:08:52.0340</ns2:ScheduleArrivalDate>
<ns2:ShipToPartySiteIdentifier>1036</ns2:ShipToPartySiteIdentifier>
<ns2:BillToCustomerIdentifier>1006</ns2:BillToCustomerIdentifier>
<ns2:BillToCustomerName>1006</ns2:BillToCustomerName>
<ns2:BillToAccountSiteUseIdentifier>1025</ns2:BillToAccountSiteUseIdentifier>
<ns2:BillToAccountContactIdentifier>4820</ns2:BillToAccountContactIdentifier>
<ns2:InventoryOrganizationIdentifier>204</ns2:InventoryOrganizationIdentifier>
<ns2:ShippingInstructions>BM Ship Instructions- Ship it in a day</ns2:ShippingInstructions>
<ns2:UnitListPrice currencyCode="USD">105</ns2:UnitListPrice>
<ns2:PartialShipAllowedFlag>FALSE</ns2:PartialShipAllowedFlag>
<ns2:FOBPoint>DEST</ns2:FOBPoint>
<ns2:OrderCharge>
<ns2:ChargeDefinitionCode>QP_SALE_PRICE</ns2:ChargeDefinitionCode>
<ns2:ChargeSubtypeCode>ORA_PRICE</ns2:ChargeSubtypeCode>
<ns2:PriceTypeCode>ONE_TIME</ns2:PriceTypeCode>
<ns2:PricedQuantity>1</ns2:PricedQuantity>
<ns2:PricedQuantityUOM>Each</ns2:PricedQuantityUOM>
<ns2:PricedQuantityUOMCode/>
<ns2:PrimaryFlag>true</ns2:PrimaryFlag>
<ns2:ApplyTo>PRICE</ns2:ApplyTo>
<ns2:RollupFlag>false</ns2:RollupFlag>
<ns2:SourceChargeIdentifier>SC1</ns2:SourceChargeIdentifier>
<ns2:ChargeCurrencyCode>USD</ns2:ChargeCurrencyCode>
<ns2:ChargeTypeCode>ORA_SALE</ns2:ChargeTypeCode>
<ns2:ChargeCurrencyCode/>
<ns2:SequenceNumber>1</ns2:SequenceNumber>
<ns2:PricePeriodicityCode/>
<ns2:GsaUnitPrice/>
<ns2:OrderChargeComponent>
<ns2:ChargeCurrencyCode>USD</ns2:ChargeCurrencyCode>
<ns2:HeaderCurrencyCode>USD</ns2:HeaderCurrencyCode>
<ns2:HeaderCurrencyExtendedAmount>-100</ns2:HeaderCurrencyExtendedAmount>
<ns2:PriceElementCode>QP_LIST_PRICE</ns2:PriceElementCode>
1016
Oracle SCM Cloud Chapter 5
Implementing Order Management Import and Transform
<ns2:SequenceNumber>1</ns2:SequenceNumber>
<ns2:PriceElementUsageCode>LIST_PRICE</ns2:PriceElementUsageCode>
<ns2:ChargeCurrencyUnitPrice>-10</ns2:ChargeCurrencyUnitPrice>
<ns2:HeaderCurrencyUnitPrice>-10</ns2:HeaderCurrencyUnitPrice>
<ns2:RollupFlag>false</ns2:RollupFlag>
<ns2:SourceParentChargeComponentId/>
<ns2:SourceChargeIdentifier>SC1</ns2:SourceChargeIdentifier>
<ns2:SourceChargeComponentIdentifier>SCC2</ns2:SourceChargeComponentIdentifier>
<ns2:ChargeCurrencyExtendedAmount>-100</ns2:ChargeCurrencyExtendedAmount>
</ns2:OrderChargeComponent>
<ns2:OrderChargeComponent>
<ns2:ChargeCurrencyCode>USD</ns2:ChargeCurrencyCode>
<ns2:HeaderCurrencyCode>USD</ns2:HeaderCurrencyCode>
<ns2:HeaderCurrencyExtendedAmount>-90</ns2:HeaderCurrencyExtendedAmount>
<ns2:ChargeCurrencyExtendedAmount>-90</ns2:ChargeCurrencyExtendedAmount>
<ns2:PriceElementCode>QP_NET_PRICE</ns2:PriceElementCode>
<ns2:SequenceNumber>2</ns2:SequenceNumber>
<ns2:PriceElementUsageCode>NET_PRICE</ns2:PriceElementUsageCode>
<ns2:ChargeCurrencyUnitPrice>-9</ns2:ChargeCurrencyUnitPrice>
<ns2:HeaderCurrencyUnitPrice>-9</ns2:HeaderCurrencyUnitPrice>
<ns2:RollupFlag>false</ns2:RollupFlag>
<ns2:SourceParentChargeComponentId/>
<ns2:SourceChargeIdentifier>SC1</ns2:SourceChargeIdentifier>
<ns2:SourceChargeComponentIdentifier>SCC1</ns2:SourceChargeComponentIdentifier>
</ns2:OrderChargeComponent>
</ns2:OrderCharge>
<ns2:DocumentReference>
<ns2:DocumentReferenceType>ORIGINAL_SALES_ORDER</ns2:DocumentReferenceType>
<ns2:DocumentIdentifier>CS_SO_1234445555565656</ns2:DocumentIdentifier>
<ns2:DocumentAdditionalIdentifier>LEG</ns2:DocumentAdditionalIdentifier>
<ns2:DocumentNumber>CS_SO_122_0034</ns2:DocumentNumber>
<ns2:DocumentAdditionalNumber/>
<ns2:DocumentLineIdentifier>101</ns2:DocumentLineIdentifier>
<ns2:DocumentAdditionalLineIdentifier/>
<ns2:DocumentLineNumber/>
<ns2:DocumentAdditionalLineNumber/>
<ns2:DocumentAdditionalSubLineIdentifier/>
<ns2:DocumentSubLineNumber/>
<ns2:DocumentAdditionalSubLineNumber/>
</ns2:DocumentReference>
<ns2:DocumentReference>
<ns2:DocumentReferenceType>ORIGINAL_ORCHESTRATION_ORDER</ns2:DocumentReferenceType>
<ns2:DocumentIdentifier>300100177488708</ns2:DocumentIdentifier>
<ns2:DocumentAdditionalIdentifier>GPR</ns2:DocumentAdditionalIdentifier>
<ns2:DocumentNumber>45098</ns2:DocumentNumber>
<ns2:DocumentAdditionalNumber/>
<ns2:DocumentLineIdentifier>300100177488711</ns2:DocumentLineIdentifier>
<ns2:DocumentSubLineIdentifier>300100177495497</ns2:DocumentSubLineIdentifier>
<ns2:DocumentAdditionalLineIdentifier/>
<ns2:DocumentLineNumber>1</ns2:DocumentLineNumber>
<ns2:DocumentAdditionalLineNumber/>
<ns2:DocumentSubLineNumber>2</ns2:DocumentSubLineNumber>
<ns2:DocumentAdditionalSubLineNumber/>
</ns2:DocumentReference>
</ns2:Line>
<ns2:OrderPreferences>
<!--Optional:-->
<ns2:CreateCustomerInformationFlag>false</ns2:CreateCustomerInformationFlag>
<!--Optional:-->
<ns2:SubmitFlag>true</ns2:SubmitFlag>
</ns2:OrderPreferences>
</ns2:Order>
</ns1:request>
1017
Oracle SCM Cloud Chapter 5
Implementing Order Management Import and Transform
</ns1:createOrders>
</soap:Body>
</soap:Envelope>
Related Topics
• Web Services You Can Use to Integrate Order Management
Here's an example.
<soap:Envelope
xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">>
<ns1:createOrders
xmlns:ns1="http://xmlns.oracle.com/apps/scm/fom/importOrders/orderImportService/types/">
<ns1:request
xmlns:ns2="http://xmlns.oracle.com/apps/scm/fom/importOrders/orderImportService/">
<ns2:BatchName ></ns2:BatchName>
<ns2:Order>
<ns2:SourceTransactionNumber>ORDER_CANCEL_12</ns2:SourceTransactionNumber>
<ns2:SourceTransactionSystem>LEG</ns2:SourceTransactionSystem>
<ns2:SourceTransactionIdentifier>ORDER_CANCEL_12</ns2:SourceTransactionIdentifier>
<ns2:CustomerPONumber></ns2:CustomerPONumber>
<ns2:BuyingPartyName>Computer Service and Rentals</ns2:BuyingPartyName>
<ns2:TransactionalCurrencyCode>USD</ns2:TransactionalCurrencyCode>
<ns2:TransactionOn>2017-12-06T19:27:11</ns2:TransactionOn>
<ns2:TransactionTypeCode></ns2:TransactionTypeCode>
<ns2:RequestingBusinessUnitIdentifier>204</ns2:RequestingBusinessUnitIdentifier>
<ns2:RequestingLegalUnit>204</ns2:RequestingLegalUnit>
<ns2:BillToCustomerName>Computer Service and Rentals</ns2:BillToCustomerName>
<ns2:ShipToPartyName>Computer Service and Rentals</ns2:ShipToPartyName>
<ns2:ShipToPartySiteIdentifier>1036</ns2:ShipToPartySiteIdentifier>
<ns2:BillToAccountSiteUseIdentifier>1025</ns2:BillToAccountSiteUseIdentifier>
<ns2:PartialShipAllowedFlag>false</ns2:PartialShipAllowedFlag>
<ns2:FreezeShippingChargeFlag>true</ns2:FreezeShippingChargeFlag>
<ns2:FreezeTaxFlag>true</ns2:FreezeTaxFlag>
<ns2:Line>
<ns2:SourceTransactionLineIdentifier>1001</ns2:SourceTransactionLineIdentifier>
<ns2:SourceTransactionScheduleIdentifier>1001</ns2:SourceTransactionScheduleIdentifier>
<ns2:SourceTransactionLineNumber>1</ns2:SourceTransactionLineNumber>
<ns2:SourceTransactionScheduleNumber>1</ns2:SourceTransactionScheduleNumber>
<ns2:ProductNumber>AS54888</ns2:ProductNumber>
1018
Oracle SCM Cloud Chapter 5
Implementing Order Management Import and Transform
<ns2:OrderedQuantity>6</ns2:OrderedQuantity>
<ns2:OrderedUOMCode>Ea</ns2:OrderedUOMCode>
<ns2:RequestedFulfillmentOrganizationIdentifier>204</ns2:RequestedFulfillmentOrganizationIdentifier>
<ns2:RequestingBusinessUnitIdentifier>204</ns2:RequestingBusinessUnitIdentifier>
<ns2:ParentLineReference></ns2:ParentLineReference>
<ns2:RootParentLineReference></ns2:RootParentLineReference>
<ns2:ShippingInstructions></ns2:ShippingInstructions>
<ns2:PackingInstructions></ns2:PackingInstructions>
<ns2:RequestedShipDate>2017-12-06T00:00:00</ns2:RequestedShipDate>
<ns2:PaymentTerms>30 Net</ns2:PaymentTerms>
<ns2:TransactionCategoryCode>ORDER</ns2:TransactionCategoryCode>
<ns2:InventoryOrganizationIdentifier>204</ns2:InventoryOrganizationIdentifier>
<ns2:ShipToPartyName>Computer Associates International</ns2:ShipToPartyName>
<ns2:ShipToPartyContactName>Jimmy Anderson</ns2:ShipToPartyContactName>
<ns2:ShipToAddress1>102, CityView</ns2:ShipToAddress1>
<ns2:ShipToCity>CHATTANOOGA</ns2:ShipToCity>
<ns2:ShipToPostalCode>37401</ns2:ShipToPostalCode>
<ns2:ShipToState>TN</ns2:ShipToState>
<ns2:ShipToCountry>US</ns2:ShipToCountry>
<ns2:ShipToPartyType>ORGANIZATION</ns2:ShipToPartyType>
<ns2:ShipToPartyType>ORGANIZATION</ns2:ShipToPartyType>
<ns2:BillToCustomerName>Computer Associates International</ns2:BillToCustomerName>
<ns2:BillToAccountContactName>Jimmy Anderson</ns2:BillToAccountContactName>
<ns2:BillToAddress1>102, CityView</ns2:BillToAddress1>
<ns2:BillToCity>CHATTANOOGA</ns2:BillToCity>
<ns2:BillToPostalCode>37401</ns2:BillToPostalCode>
<ns2:BillToState>TN</ns2:BillToState>
<ns2:BillToCountry>US</ns2:BillToCountry>
<ns2:BillToPartyType>ORGANIZATION</ns2:BillToPartyType>
<ns2:BillToPartyType>ORGANIZATION</ns2:BillToPartyType>
<ns2:BillToPartyType>ORGANIZATION</ns2:BillToPartyType>
<ns2:PartialShipAllowedFlag>false</ns2:PartialShipAllowedFlag>
<ns2:UnitListPrice>150.0</ns2:UnitListPrice>
<ns2:UnitSellingPrice>150.0</ns2:UnitSellingPrice>
<ns2:ContractStartDate>2016-11-22</ns2:ContractStartDate>
<ns2:ExtendedAmount>150.0</ns2:ExtendedAmount>
<ns2:TaxExempt>S</ns2:TaxExempt>
<ns2:OrigSysDocumentReference>ORIGSYS</ns2:OrigSysDocumentReference>
<ns2:OrigSysDocumentLineReference>ORIGSYSLINE</ns2:OrigSysDocumentLineReference>
<ns2:OrderCharge>
<ns2:ChargeDefinitionCode>QP_SALE_PRICE</ns2:ChargeDefinitionCode>
<ns2:ChargeSubtypeCode>ORA_PRICE</ns2:ChargeSubtypeCode>
<ns2:PriceTypeCode>ONE_TIME</ns2:PriceTypeCode>
<ns2:PricedQuantity>10</ns2:PricedQuantity>
<ns2:PricedQuantityUOMCode>Ea</ns2:PricedQuantityUOMCode>
<ns2:PrimaryFlag>true</ns2:PrimaryFlag>
<ns2:ApplyTo>PRICE</ns2:ApplyTo>
<ns2:RollupFlag>false</ns2:RollupFlag>
<ns2:SourceChargeIdentifier>SC2</ns2:SourceChargeIdentifier>
<ns2:ChargeTypeCode>ORA_SALE</ns2:ChargeTypeCode>
<ns2:ChargeCurrencyCode>USD</ns2:ChargeCurrencyCode>
<ns2:SequenceNumber>2</ns2:SequenceNumber>
<ns2:PricePeriodicityCode></ns2:PricePeriodicityCode>
<ns2:GsaUnitPrice></ns2:GsaUnitPrice>
<ns2:OrderChargeComponent>
<ns2:ChargeCurrencyCode>USD</ns2:ChargeCurrencyCode>
<ns2:HeaderCurrencyCode>USD</ns2:HeaderCurrencyCode>
<ns2:HeaderCurrencyExtendedAmount>150.0</ns2:HeaderCurrencyExtendedAmount>
<ns2:PriceElementCode>QP_LIST_PRICE</ns2:PriceElementCode>
<ns2:SequenceNumber>4</ns2:SequenceNumber>
<ns2:PriceElementUsageCode>LIST_PRICE</ns2:PriceElementUsageCode>
<ns2:ChargeCurrencyUnitPrice>150.0</ns2:ChargeCurrencyUnitPrice>
<ns2:HeaderCurrencyUnitPrice>150.0</ns2:HeaderCurrencyUnitPrice>
<ns2:RollupFlag>false</ns2:RollupFlag>
<ns2:SourceParentChargeComponentId></ns2:SourceParentChargeComponentId>
<ns2:SourceChargeIdentifier>SC2</ns2:SourceChargeIdentifier>
1019
Oracle SCM Cloud Chapter 5
Implementing Order Management Import and Transform
<ns2:SourceChargeComponentIdentifier>SCC3</ns2:SourceChargeComponentIdentifier>
<ns2:ChargeCurrencyExtendedAmount>150.0</ns2:ChargeCurrencyExtendedAmount>
</ns2:OrderChargeComponent>
<ns2:OrderChargeComponent>
<ns2:ChargeCurrencyCode>USD</ns2:ChargeCurrencyCode>
<ns2:HeaderCurrencyCode>USD</ns2:HeaderCurrencyCode>
<ns2:HeaderCurrencyExtendedAmount>150.0</ns2:HeaderCurrencyExtendedAmount>
<ns2:PriceElementCode>QP_NET_PRICE</ns2:PriceElementCode>
<ns2:SequenceNumber>3</ns2:SequenceNumber>
<ns2:PriceElementUsageCode>NET_PRICE</ns2:PriceElementUsageCode>
<ns2:ChargeCurrencyUnitPrice>150.0</ns2:ChargeCurrencyUnitPrice>
<ns2:HeaderCurrencyUnitPrice>150.0</ns2:HeaderCurrencyUnitPrice>
<ns2:RollupFlag>false</ns2:RollupFlag>
<ns2:SourceParentChargeComponentId></ns2:SourceParentChargeComponentId>
<ns2:SourceChargeIdentifier>SC2</ns2:SourceChargeIdentifier>
<ns2:SourceChargeComponentIdentifier>SCC1</ns2:SourceChargeComponentIdentifier>
<ns2:ChargeCurrencyExtendedAmount>150.0</ns2:ChargeCurrencyExtendedAmount>
</ns2:OrderChargeComponent>
</ns2:OrderCharge>
</ns2:Line>
</ns2:Order>
</ns1:request>
</ns1:createOrders>
</soap:Body>
</soap:Envelope>
Related Topics
• How Order Management Transforms Source Orders Into Sales Orders
Import Pricing
Guidelines for Importing Pricing Data
Use guidelines to help you import pricing data.
For example.
"items": [
{
"Item": "Zoom Voice",
"ItemLevelCode": "ITEM",
"LineTypeCode": "ORA_BUY",
"PricingUOM": "Each",
"ratePlans": [
{
"RatePlanName": "Rate_Plan_01012021",
"RatePlanDescription": "Rate Plan for Zoom Voice",
"Currency": "US Dollar",
"StartDate": "2021-01-01",
"EndDate": "2022-12-31",
"ratePlanCharges": [
{
"PricingChargeDefinition": "Call Usage Charge",
"PricingChargeDefinitionCode": "QP_CALL_USAGE_CHARGE",
"CalculationMethodCode": "PRICE",
"UsageUOMCode": "MNS",
1020
Oracle SCM Cloud Chapter 5
Implementing Order Management Import and Transform
"BasePrice": 1.00,
"StartDate": "2021-01-01",
"EndDate": "2021-12-31"
},
where
• Attributes in the ratePlanCharges entity define the usage charge, such as "PricingChargeDefinition": "Call
Usage Charge"
You can't use the Pricing Administration work area, file based data import, or ADF desktop integration to create a usage
charge.
For details about using REST API, see the REST API for Oracle Supply Chain Management Cloud book on Oracle Help
Center.
1021
Oracle SCM Cloud Chapter 5
Implementing Order Management Import and Transform
"ServiceDuration": null,
"ItemLevelCode": "ITEM",
"ItemLevel": "Item",
"charges": [
{
"PricingChargeDefinition": "Sale Price",
"PricingChargeDefinitionCode": "QP_SALE_PRICE",
"PricePeriodicity": null,
"PricePeriodicityCode": null,
"CalculationMethod": "Price",
"CalculationMethodCode": "PRICE",
"CalculationType": null,
"CalculationTypeCode": null,
"AllowManualAdjustment": "Y",
"BasePrice": 10,
"CostCalculationAmount": null,
"StartDate": "2000-04-06T22:30:00+00:00",
"EndDate": null,
"ChargeLineNumber": 1,
"MatrixId": null
}
]
}
],
"accessSets": [
{
"AccessSetName": "Common Set",
"AccessSetCode": "COMMON",
"AccessSetId": 0,
"AccessSetDescription": null
}
]
}
Notice that your request includes "Status": "Approved", and "StatusCode": "APPROVED", but the response
includes "Status": "Approved", and "StatusCode": "IN_PROGRESS". The POST action can set StatusCode to
IN_PROGRESS but not APPROVED. Next, you will send a PATCH request to set StatusCode to APPROVED.
2. Approve the price list. Use a PATCH action with the priceLists resource.
https://servername/fscmRestApi/resources/version/priceLists/PriceListId
1022
Oracle SCM Cloud Chapter 5
Implementing Order Management Import and Transform
https://servername/fscmRestApi/resources/version/priceLists/300000081320934
{
"Status": "Approved",
"StatusCode": "APPROVED"
}
Related Topics
• How Order Management Transforms Source Orders Into Sales Orders
• Import Price Lists
• Attributes You Can Use with Web Services
• Set Up Coverage for Sales Orders
The term freeze means Pricing Administration won't recalculate charges. For example, if you set Freeze Price to.
Here's how Pricing Administration maps these attributes to attributes on the header entity of the pricing service data
object.
FreezePricing CalculatePricingChargesFlag
FreezeShippingCharge CalculateShippingChargesFlag
FreezeTax CalculateTaxFlag
Pricing will use values in the import payload to determine price, shipping charges, and tax. The attributes you use
depend on how you import price data. For details, see these topics.
1023
Oracle SCM Cloud Chapter 5
Implementing Order Management Import and Transform
Order Management copies a coverage that covers an included item differently depending on whether you freeze price,
shipping charges, and tax.
Order Management doesn't copy a Order Management copies each coverage that covers an included item to the new sales order.
coverage that covers an included item
to the new order.
For details about coverages, see the Set Up Coverage for Sales Orders topic.
Related Topics
• How Order Management Transforms Source Orders Into Sales Orders
• Import Price Lists
• Attributes You Can Use with Web Services
• Set Up Coverage for Sales Orders
1024
Oracle SCM Cloud Chapter 5
Implementing Order Management Import and Transform
• Get example payloads. Go to My Oracle Support, search for Document ID 2051639.1 (Technical Reference for
Order Management Cloud), download the Payloads and Other Example Files attachment, then examine the
examples that include or don't include tax in net price.
Note.
◦ Add the code starting right after the line that contains PriceElementCode up to and including
PriceElementUsageCode>INCLUSIVE_TAX.
◦ Set ChargeCurrencyUnitPrice to -1 (negative 1).
◦ Set HeaderCurrencyUnitPrice to -1 (negative 1).
2. Add the charge component where you specify the tax to include in net price. For example.
<ns2:ChargeComponent>
1025
Oracle SCM Cloud Chapter 5
Implementing Order Management Import and Transform
<ns2:ChargeCurrencyCode>USD</ns2:ChargeCurrencyCode>
<ns2:HeaderCurrencyCode>USD</ns2:HeaderCurrencyCode>
<ns2:HeaderCurrencyExtendedAmount>80</ns2:HeaderCurrencyExtendedAmount>
<ns2:PriceElementCode>QP_NET_PRICE_EXC_INCLUSIVE_TAX</ns2:PriceElementCode>
<ns2:SequenceNumber>5</ns2:SequenceNumber>
<ns2:PriceElementUsageCode>NET_PRICE_TAX_EXCLUDED</ns2:PriceElementUsageCode>
<ns2:ChargeCurrencyUnitPrice>8</ns2:ChargeCurrencyUnitPrice>
<ns2:HeaderCurrencyUnitPrice>8</ns2:HeaderCurrencyUnitPrice>
<ns2:RollupFlag>false</ns2:RollupFlag>
<ns2:SourceParentChargeComponentId></ns2:SourceParentChargeComponentId>
<ns2:SourceChargeIdentifier>SC1</ns2:SourceChargeIdentifier>
<ns2:SourceChargeComponentIdentifier>SCC5</ns2:SourceChargeComponentIdentifier>
<ns2:ChargeCurrencyExtendedAmount>80</ns2:ChargeCurrencyExtendedAmount>
</ns2:ChargeComponent>
Note.
◦ Set PriceElementCode to QP_NET_PRICE_EXC_INCLUSIVE_TAX.
◦ Set PriceElementUsageCode to NET_PRICE_TAX_EXCLUDED.
Note.
◦ Set PriceElementCode to QP_EXCLUSIVE_TAX.
◦ Set PriceElementUsageCode to EXCLUSIVE_TAX.
2. Add the charge component where you specify the tax to include in net price. For example.
<ns2:ChargeComponent>
<ns2:ChargeCurrencyCode>USD</ns2:ChargeCurrencyCode>
<ns2:HeaderCurrencyCode>USD</ns2:HeaderCurrencyCode>
<ns2:HeaderCurrencyExtendedAmount>100</ns2:HeaderCurrencyExtendedAmount>
<ns2:PriceElementCode>QP_NET_PRICE_PLUS_TAX</ns2:PriceElementCode>
<ns2:SequenceNumber>5</ns2:SequenceNumber>
<ns2:PriceElementUsageCode>NET_PRICE_PLUS_TAX</ns2:PriceElementUsageCode>
<ns2:ChargeCurrencyUnitPrice>10</ns2:ChargeCurrencyUnitPrice>
<ns2:HeaderCurrencyUnitPrice>10</ns2:HeaderCurrencyUnitPrice>
<ns2:RollupFlag>false</ns2:RollupFlag>
<ns2:SourceParentChargeComponentId></ns2:SourceParentChargeComponentId>
<ns2:SourceChargeIdentifier>SC1</ns2:SourceChargeIdentifier>
<ns2:SourceChargeComponentIdentifier>SCC5</ns2:SourceChargeComponentIdentifier>
<ns2:ChargeCurrencyExtendedAmount>100</ns2:ChargeCurrencyExtendedAmount>
1026
Oracle SCM Cloud Chapter 5
Implementing Order Management Import and Transform
<ns2:ChargeComponent>
Note.
Don't Include Tax in Net Price Pay Now equals tax plus Net Price.
Related Topics
• How Order Management Transforms Source Orders Into Sales Orders
• Import Price Lists
• Attributes You Can Use with Web Services
• Set Up Coverage for Sales Orders
1027
Oracle SCM Cloud Chapter 5
Implementing Order Management Import and Transform
Assume.
• Current price for the item is 130.
• Shipping charges at runtime are price multiplied by 20%.
• Tax calculated at runtime is total net price plus shipping multiplied by 10%.
Values That You Can Use for Freeze Attributes with Unreferenced Returns
Here are the values you can use when your import includes a sales order line or a return line that doesn't reference the
original sales order.
1028
Oracle SCM Cloud Chapter 5
Implementing Order Management Import and Transform
Values That You Can't Use for Freeze Attributes with Unreferenced Returns
Here are the values that you can't use when your import includes a sales order line or a return line that doesn't reference
the original sales order.
1029
Oracle SCM Cloud Chapter 5
Implementing Order Management Import and Transform
Related Topics
• How Order Management Transforms Source Orders Into Sales Orders
• Import Price Lists
• Attributes You Can Use with Web Services
• Set Up Coverage for Sales Orders
Transform
Overview
Overview of Transformation Rules
Write a business rule that populates order attributes before Order Management transforms a source order, while it
transforms a source order, and after it transforms a source order.
A source system is a system in your implementation that captures the details of a sales order. The source orders
that your source system captures probably use attributes, structures, and data that are different from what Order
Management uses. If you use more than one source system, then the details across source systems might be different.
Order Management uses a specific structure in sales orders so it can fulfill each of them consistently and effectively.
Transformation rules transform each source order into a structure that Order Management can use, such as the
1030
Oracle SCM Cloud Chapter 5
Implementing Order Management Import and Transform
arrangement of attributes on the order header, order lines, and fulfillment lines, and the relationships between header,
order lines, and fulfillment lines.
1031
Oracle SCM Cloud Chapter 5
Implementing Order Management Import and Transform
Create a sales order or copy a sales Pretransformation rules run each time that you.
order.
• Modify an attribute that contains customer details.
• Modify the order type.
• Add an order line.
Create a sales order and click Submit. Transformation rules and posttransformation rules run one time after you click Submit.
Copy a sales order and click Submit. Transformation rules and posttransformation rules don't run after you click Submit.
Create a referenced return. Transformation rules and posttransformation rules run only on new order lines that you add to
the return. They don't run on order lines that already exist on a referenced return.
Create an unreferenced return and Transformation rules and posttransformation rules run one time after you click Submit..
click Submit.
If you import a source order through a SOAP web service, then Order Management runs rules in a sequence. You can't
modify this sequence.
1. Pretransformation rules.
2. Transformation rules.
3. Posttransformation rules.
Related Topics
• How Order Management Transforms Source Orders Into Sales Orders
1032
Oracle SCM Cloud Chapter 5
Implementing Order Management Import and Transform
Pretransformation Rules
Use a pretransformation rule to populate an order attribute or set its default value before Order Management
transforms the source order
Populate an attribute on a fulfillment Assume your sales order includes the Request Date attribute, and you must display it on
line. fulfillment lines, but only for the AS54888 desktop computer. Here's your rule.
• If the item is AS54888 desktop computer, then display the Request Date attribute on the
fulfillment line.
Populate an attribute so you can use Assume your sales order includes the AS54888, you must convert its size from centimeters to
it in a transformation rule. inches, then display it on the fulfillment line. Here's your rule.
• If the item is a AS54888, then convert the Size attribute and display it on the fulfillment
line.
Order Management runs pretransformation rules each time the Order Entry Specialist modifies the sales order.
For details about how to use a pretransformation rule to set default values, see the Set Default Values for Attributes on
Sales Orders topic.
Also, pretransformation and posttransformation rules might not run when you create a sales order through a web
service, REST API, or file-based data import.
If you must set the transaction type before you transform, and if you must set it when an event occurs that doesn't start
a pretransformation rule, or if you create a sales order through a web service, REST API, or file-based data import, then
don't use a transformation rule to set the attribute values. Use an order management extension instead. For details,
see the Set the Billing Transaction Type According to Order Type subtopic in the Examples of Order Management
Extensions for Order Headers topic.
If you're returning a sales order, then you must set the transaction type to Credit Memo.
Related Topics
• How Order Management Transforms Source Orders Into Sales Orders
• Use Groups to Manage and Control Sales Orders
• Manage Pretransformation Rules
1033
Oracle SCM Cloud Chapter 5
Implementing Order Management Import and Transform
Transformation Rules
Use a transformation rule to transform an item, such as the AS54888 Desktop Computer. Order Management uses item
relationships, item structures, transactional attributes, and business rules to transform a sales representation of the
item in the source order to a fulfillment representation of the item on fulfillment lines.
• You use the Manage Product Transformation Rules page in the Setup and Maintenance work area to write
the transformation rule. You can also use the Product Information Management work area to set up item
relationships, item structures, and transactional attributes.
• You can't use a transformation rule to add a product model to a sales order.
• An order line that a transformation rule creates gets most attributes from the line that the rule uses to create
the new line. You can't edit, revise, or price an order line that a transformation rule creates.
For example, assume you sell a laptop computer that ships to different geographical regions. Each
region requires a different electrical adapter, such as 110 volts or 240 volts. You create a rule that uses the
geographical region where you ship the item to determine the adapter to include in the sales order. You create
a transformation rule that transforms the source order to a sales order that includes order line a and order line
b, then adds the adapter to order line b. Assume the Ship To address on order line a is 550 Vision Way. The rule
sets Ship To address on order line b to 550 Vision Way. You can't change this value on order line b.
The Create Order page and the Edit Order page in the Order Management work area don't display an order line
that a transformation rule creates because transformation adds the line only after your user clicks Submit. You
can view the new line in a fulfillment view, such as View Order. If you create an order revision, you can also view
the new line on the Create Revision or Edit Revision page.
Product-to-Product Transformation
Transform a single item to one or more items according to item structure, item relationship, and the transformation rule.
You can write a rule that transforms an item to another item, and that creates individual fulfillment lines.
Assume your source order includes a laptop that comes with an accessory package that includes more than one item,
such as a docking station, mouse, and so on. You write a product-to-product transformation rule that transforms the
1034
Oracle SCM Cloud Chapter 5
Implementing Order Management Import and Transform
source order into a sales order that includes individual fulfillment lines for the laptop and each item in the accessory
package.
1035
Oracle SCM Cloud Chapter 5
Implementing Order Management Import and Transform
Product-to-Attribute Transformation
Transform the item in a source order according to the attributes of another item.
Assume you sell the Window item. You can write a rule that uses attributes in the source order. . .
• Width
• Height
• Pane
• Glass
. . .to get the number for an item that uses the same dimensions, but that uses double-pane, tempered glass.
The transformed order includes the item number for the combination of attributes.
1036
Oracle SCM Cloud Chapter 5
Implementing Order Management Import and Transform
Attribute-to-Product Transformation
Use attributes to transform an attribute to an item number. Add the transformation to an item that already exists or
replace the item in the source order.
Assume you sell an MP3 player that includes the Color attribute and Size attribute, and that you must use a combination
of them to reference an item number. You can create a rule that transforms Color and Size of item Mini Plus to item
VIS481A.
Attribute-to-Attribute Transformation
Transform the value of an order line attribute in a source order to a different order line attribute in a sales order.
1037
Oracle SCM Cloud Chapter 5
Implementing Order Management Import and Transform
Assume your company resides in Europe, you receive orders from an office in the United States that measures the item
size in inches, but you must display the size in centimeters. Create a rule that transforms the width and height from
inches on the source order to centimeters on the sales order.
Context-to-Product Transformation
Use the context of the source order to determine the item in the sales order.
Assume you sell laptop computers that ship to different geographical regions. Each region requires a different electrical
adapter, such as 110 volts or 240 volts. Create a rule that uses the geographical region where you ship the item to
1038
Oracle SCM Cloud Chapter 5
Implementing Order Management Import and Transform
determine the adapter to include in the sales order, transforms the source order to a sales order that includes two order
lines, and then adds the adapter to one of these lines.
Context-to-Attribute Transformation
Transform the source order context to an attribute.
Assume you ship some laptop computers to domestic locations in the USA and others to international locations in
other countries. The destination requires different packaging. So you create a Domestic Packaging flexfield to store
1039
Oracle SCM Cloud Chapter 5
Implementing Order Management Import and Transform
the details. Assume an attribute in the source order includes the domestic address, so the context is domestic, and the
transformation rule sets the Domestic Packaging attribute to Yes.
Related Topics
• How Order Management Transforms Source Orders Into Sales Orders
• Use Groups to Manage and Control Sales Orders
• Manage Pretransformation Rules
1040
Oracle SCM Cloud Chapter 5
Implementing Order Management Import and Transform
Posttransformation Rule
Use a posttransformation rule to populate an order attribute after Order Management transforms the item.
Populate order lines so they reference Create a rule that transforms the source order into a sales order that includes two lines.
different warehouses.
• Order line 1 for the laptop computer
• Order line 2 for an AC adapter
Write a rule that populates order line 2 so it sets the Warehouse attribute to a value that's
different from the warehouse that supplies the laptop computer on line 1.
Populate an order with a new Assume your source order uses the MM/DD/YYYY format for requested date. Your staff finds
attribute. it useful to also know the day of the week because delivery costs more on Saturday or Sunday.
You write a rule that populates the day of the week in the new sales order.
Related Topics
• How Order Management Transforms Source Orders Into Sales Orders
• Use Groups to Manage and Control Sales Orders
• Manage Pretransformation Rules
Procedures
Set Up Transformation
Set up transformation so Order Management Cloud can correctly transform each source order.
1. Use the Product Information Management work area.
For example, assume a fulfillment line includes a nonconfigured item, the Order Entry Specialist
examines availability for the item, then Order Management displays more than one option. If you don't
set up each item substitution rule correctly, then the Order Entry Specialist might select an option that
uses an incorrect substitution, such as a kit.
2. Create your transformation rules.
Related Topics
• How Order Management Transforms Source Orders Into Sales Orders
1041
Oracle SCM Cloud Chapter 5
Implementing Order Management Import and Transform
Assume you use priority shipping for each sales order that includes a Green Server. You need a rule.
You will create a bucket set that contains the values you will select when you create your transformation rule, then
create the rule.
Its strongly recommended that you get details about decision tables, bucket sets, and how to use them. For details, see
the Overview of Using Business Rules With Order Management topic.
1042
Oracle SCM Cloud Chapter 5
Implementing Order Management Import and Transform
Do it.
Attribute Value
1043
Oracle SCM Cloud Chapter 5
Implementing Order Management Import and Transform
Attribute Value
Description List of IDs and aliases for server items to select in a product transformation rule.
5. Click Add Bucket, then, in the Bucket Values list, in the Bucket 1 row, set values.
Attribute Value
Value 300000047394016L
This number identifies the item ID that the database contains. The letter L indicates a long
value.
Alias "AS85005"
6. Click Add Bucket, then, in the Bucket Values list, in the Bucket 2 row, set values.
Attribute Value
Value 300000047393961L
Alias "AS85004"
1044
Oracle SCM Cloud Chapter 5
Implementing Order Management Import and Transform
Do it.
The Condition Browser dialog displays objects from the OrderTransformationRules dictionary. You can use
the FulfillLineVO object in this dictionary to specify transformation according to the value of a fulfillment line
attribute, such as InventoryItemId.
In this example, you use toString to get the value of InventoryItemId as a string so you can compare it in the
rule.
• If InventoryItemId is AS85005
Do it.
1045
Oracle SCM Cloud Chapter 5
Implementing Order Management Import and Transform
For example.
2. Click Local List of Values > Server IDs, which is the bucket set you created earlier.
3. In row OrderTransformationRules.FulfillLineVO.InventoryItemId.toString(), double-click the cell in column R1,
single-click the cell in column R1, then add a check mark to AS85005.
At run time, order fulfillment will recognize that ShipClassOfService is Expedited, then expedite the shipment.
Do it.
1. Immediately above the decision table, click Add > Add Action > Modify.
2. In the Action Editor dialog, in the Target list, click OrderTransformationRules.FulfillLineVO.
3. In the Arguments list, locate the ShipClassOfService argument, set the value, then click OK. You might need to
scroll or page down through the Arguments list.
Property Value
The Parameterized property makes the object available to the business rule as a parameter.
4. In the decision table, in the ShipClassOfService row, double-click the cell in column R1, then enter "Expedited".
You must include the double quotation marks.
5. Click Save.
Related Topics
• Use Visual Information Builder
• Manage Pretransformation Rules
1046
Oracle SCM Cloud Chapter 5
Implementing Order Management Import and Transform
• If fulfillment line a requests to add inventory item x, and if fulfillment line b requests to delete inventory item x,
then delete fulfillment lines a and b.
Statement Description
Third IF statement If the inventory item in fulfillment line 1 is the same as the inventory item in fulfillment line 2.
Fourth IF statement If the fulfillment line ID of fulfillment line 1 is different from the fulfillment ID of fulfillment line
2.
1047
Oracle SCM Cloud Chapter 5
Implementing Order Management Import and Transform
This topic uses Advanced Mode. Its strongly recommended you familiarize yourself with this mode and creating
business rules. For details, see the Overview of Using Business Rules With Order Management topic.
1048
Oracle SCM Cloud Chapter 5
Implementing Order Management Import and Transform
Attribute Value
Do it.
1049
Oracle SCM Cloud Chapter 5
Implementing Order Management Import and Transform
Do it.
Click Save.
Do it.
Click Save.
1050
Oracle SCM Cloud Chapter 5
Implementing Order Management Import and Transform
Do it.
1. Click Add Pattern.
2. In the window below And, enter FulfillLine.
3. In the field to the right of Is A, click the down arrow, then click OrderTransformationRules.FulfillLineVO.
4. Click Add Test > Simple Test, then click Left Value.
5. In the Condition Browser, expand FulfillLine, then click InventoryItemId > OK.
6. Click Is > Isn't.
7. Click Right Value.
8. In the Condition Browser, expand FulfillLine2, click InventoryItemId > OK.
Click Save.
Do it.
1. In the Then area, click Add Action > Assert New.
2. Click Select a Target, then click OrderTransformationRules.DeleteOrderLine.
3. Click Edit Properties.
4. In the Properties dialog, enter values, then click OK
Name Value
fulfillmentLineId fulfillmentLineId
viewRowImpl fulfillmentLineId
1051
Oracle SCM Cloud Chapter 5
Implementing Order Management Import and Transform
Click Save.
◦ Do an SQL.
For details, see the Use SQL to Query Order Management Data topic.
◦ In the query result, locate the row that contains AS54888 in the ITEM_NUMBER column. Assume the
query returns these values.
ITEM_NUMBER INVENTORY_ITEM_ID
AS54888 300000001688530L
AS9000 300000003387164L
1052
Oracle SCM Cloud Chapter 5
Implementing Order Management Import and Transform
Try it.
1053
Oracle SCM Cloud Chapter 5
Implementing Order Management Import and Transform
Code Description
OrderTransformationRules.FulfillLineVO.InventoryItemId
FulfillLineVO is a virtual object that contains runtime values of the attributes on the
is 300000001688530L fulfillment line. Order Management populates FulfillLineVO when you create the sales order.
This statement says to get the value of the InventoryItemId attribute. This attribute is in the
FulfillLineVO virtual object (VO), and the OrderTransformationRules dictionary contains
FulfillLineVO.
OrderTransformationRules.FulfillLineVO.OrderedQty
Get the value of the OrderedQty attribute.
is same or more than 5
If the OrderedQty attribute contains a value of 5 or greater, then proceed to the Then
statement in this rule. If it doesn't, then exit the rule.
Code Description
newItemId: 300000003387164L Add the 300000003387164L item, which is the Vision Router, to the order line.
You use Assert New to add a new object, such as a new order line.
viewRowImpl:OrderTransformationRules.FulfillLineVO.viewRowImpl
Use viewRowImpl:FLine.ViewRowImpl to specify the row that contains the runtime value.
Code Description
For details about how to create a business rule, see the Overview of Using Business Rules With Order
Management topic.
1054
Oracle SCM Cloud Chapter 5
Implementing Order Management Import and Transform
Attribute Value
Item AS54888
Quantity 5 or more
3. Click Submit.
4. Verify that Order Management added a new order line.
Attribute Value
Quantity 1
Your Price 0
Related Topics
• Overview of Using Business Rules With Order Management
• Manage Pretransformation Rules
• Use SQL to Query Order Management Data
1055
Oracle SCM Cloud Chapter 5
Implementing Order Management Import and Transform
1056
Oracle SCM Cloud Chapter 6
Implementing Order Management Orchestrate Fulfillment
6 Orchestrate Fulfillment
Overview
1057
Oracle SCM Cloud Chapter 6
Implementing Order Management Orchestrate Fulfillment
Orchestration Processes
Set up an orchestration process so it meets fulfillment requirements for your sales order.
An orchestration process is a sequence of steps that automate fulfilling your sales order's fulfillment lines across
fulfillment systems. For example, here's the predefined ShipOrderGenericProcess orchestration process.
Note.
1058
Oracle SCM Cloud Chapter 6
Implementing Order Management Orchestrate Fulfillment
Step 100, Schedule Create Scheduling Create a schedule that the process can
use to fulfill the fulfillment line. It makes
sure fulfillment meets the delivery dates
that the sales order specifies.
Step 200, Create Reservation Create Inventory Reservation Reserve inventory for the item on the
fulfillment line so no other order can use
the inventory.
Step 300, Create Shipment Request Create Shipping Create a shipping plan that makes sure
the carrier delivers the item on time.
Step 400, Wait for Shipment Advice Wait for Shipment Wait to receive confirmation that the
carrier delivered the item.
Step 500, Create Invoice Create Billing Lines Create billing lines that we can send to
accounts receivable.
Step 600, Wait for Invoice Wait for Billing Wait to receive confirmation from
accounts receivable that billing is done.
• The orchestration process does each step sequentially, starting with step 100 and ending with step 600.
• You use the Setup and Maintenance work area to create and manage your orchestration process.
• To see how an orchestration process works in context, and to get an overview of how task services interact with
the fulfillment system, see the How Order-to-Cash Works in Order Management topic.
1059
Oracle SCM Cloud Chapter 6
Implementing Order Management Orchestrate Fulfillment
Set up Steps
You do almost all your set up on the steps.
Note.
• Dependencies. If your process includes a branch, then set dependencies that affect branching.
• Planning. Specify how to plan fulfillment for the fulfillment line.
◦ Set the default lead-time that the process needs to do the step.
◦ Create a business rule that uses conditions to set lead-time.
◦ Specify the status you expect from the fulfillment system during planning.
◦ Specify the step that determines whether fulfillment is done.
• Change Management. Specify how to manage change that occurs in the fulfillment system.
◦ Specify the task service to use for update messages or cancel messages that the fulfillment system sends
to you.
◦ Create a business rule that uses conditions to specify what to do when a change occurs.
1060
Oracle SCM Cloud Chapter 6
Implementing Order Management Orchestrate Fulfillment
• Specify dependency, planning, and change management for each step. For example, click Planning to scroll to
the part of the row that contains planning attributes.
Set Up Statuses
Note.
1061
Oracle SCM Cloud Chapter 6
Implementing Order Management Orchestrate Fulfillment
For example, fulfillment system x might use SCHEDULED, and system y might use FULFILLMENT_SCHEDULED.
Add values to handle both systems.
• You can also set statuses for fulfillment lines.
Related Topics
• Fix Errors in All Sales Orders
• How Order-to-Cash Works in Order Management
1. Identify the steps your business process needs to fulfill the sales order.
2. Set up your orchestration process so it includes these steps.
You identify the sequence of calls your orchestration process must make to task services. Here's the pseudocode.
1. Plant Acknowledgment.
2. Assemble.
3. Wait for status to equal COMPLETE.
4. Ship.
5. Wait for status to equal SHIPPED.
6. Call Customer.
7. Wait for Call Customer to equal COMPLETE.
8. Test for these conditions.
◦ Wait for the status for High Value Invoice to equal BILLED.
◦ Invoice.
◦ Wait for the status to equal BILLED.
9. End the condition.
1062
Oracle SCM Cloud Chapter 6
Implementing Order Management Orchestrate Fulfillment
You add the default lead time to each orchestration process step. If a step gets delayed during fulfillment, then a
process runs in the background that replans the orchestration process and resets the expected completion dates.
Set a Status
Assume you have an important customer who requires that you notify their receiving clerk one day before the shipping
system ships the item. You set up an orchestration process class for the orchestration process. You determine the class
must include statuses.
• SHIPPED
• RESERVED
• READY TO SHIP
• SHIPPED
• INVOICED
You use the Orchestration Process Status tab to define a status condition.
• If the status of the Create Shipment step is PRESHIP READY, then use the READY TO SHIP status to indicate the
orchestration process status.
Your users can use the Order Management work area to determine whether the orchestration process status is READY
TO SHIP.
Related Topics
• Order Management Statuses
1063
Oracle SCM Cloud Chapter 6
Implementing Order Management Orchestrate Fulfillment
Each predefined process comes already set up to work with Order Management and is ready to use with little or no
modification.
• Schedule
ShipOrderGenericProcess
• Reservation
• Shipment
• Invoice
• Return Receipt
ReturnOrderGenericProcess
• Invoice
Use it for various fulfillment requirements, such as back-to-back shipments, drop ship, and so
on.
Set up business rules that determine How Order Management Processes Change
how the orchestration process
handles changes to sales orders.
1064
Oracle SCM Cloud Chapter 6
Implementing Order Management Orchestrate Fulfillment
Set up the schedule that uses Guidelines for Setting Up Orchestration Process Steps
process planning to display the
completion date of each task and the
orchestration process.
• Set and help meet the completion date for each orchestration process step and task in an orchestration process.
• Specify how to use the transformation rules that an orchestration process references to transform each source
order, including planning for each step after it receives a source order from an order capture system.
• Use order management parameter Enable Orchestration Process Planning and Calculate Jeopardy. For details,
see the Manage Order Management Parameters topic.
• Replan completion dates when a change occurs to the sales order at any point in the orchestration process.
• Replan immediately after each orchestration process step finishes.
• Replan according to an event, such as every time the orchestration process receives an update from your order
capture system. To control replanning, use the Plan Orchestration Processes scheduled process to schedule an
update at regular intervals according to the frequency that your deployment requires.
For example, if your orchestration process requires planning data that's current, then set up the scheduled
process to run the orchestration process and update the planning data one time each day. For an example that
uses a scheduled process, see the Fix Errors in More Than One Sales Order topic.
1065
Oracle SCM Cloud Chapter 6
Implementing Order Management Orchestrate Fulfillment
Enable the Replan Instantly option when you set up your orchestration process. It replans the orchestration process
immediately after the process finishes the orchestration process step, then displays the revised order data according to
the results of the replanning.
• Use Replan Instantly only for high priority sales orders, or with sales orders that include a jeopardy threshold of
less than one day.
• For performance reasons, don't use Replan Instantly with an orchestration process step that's long or complex.
• If you don't enable Replan Instantly, then Order Management updates planning data only during the scheduled
replanning.
You must cancel the orders you already imported, modify the orchestration process definition or create a new one, then
reimport your sales orders.
Migrate
If you use your implementation project to migrate an orchestration process instance from a development environment
to a production environment, then don't modify the process name in either environment. Modifying the name might
prevent Order Management Cloud from updating references to other data in the orchestration process. For details
about using an implementation project, see the Guidelines for Setting Up Order-to-Cash topic.
• To set up an orchestration process step, you open the Edit Orchestration Process Definition page, then use the
Step Definition list in the Process Details area.
• You can't update an order line after Order Management interfaces the line to billing, so don't add a scheduling,
reservation, or shipping step after a billing step.
1066
Oracle SCM Cloud Chapter 6
Implementing Order Management Orchestrate Fulfillment
Attribute Description
Step Type Set the behavior for the orchestration process step.
Task Type Each task type includes services you can use to communicate with a fulfillment system, such as
a billing system. Here are the predefined task types you can use.
• Schedule
• Reservation
• Shipment
• Invoice
• Return
Task Specify the task to run. A task can include more than one step. For example, the Ship task calls
the Create Shipment service. It also calls the Wait for Shipment service to wait for different
status values to occur in the fulfillment system updates.
Manual Specify whether to wait for user input. If you specify a manual task, then the orchestration
process waits until the user manually finishes the task in the Order Management work area.
For example, set the Schedule task as a manual task so your users can manually schedule all
fulfillment lines at the end of the day.
Exit Criteria Specify the task status that determines when to exit a wait step. For example, if the status of a
shipment task changes to Shipped, then exit the wait step.
If your task includes more than one wait step, then make sure these steps don't use the same
exit criteria.
Use the Manage Task Status Conditions page to make sure only the last step or wait step uses
the exit criterion.
1067
Oracle SCM Cloud Chapter 6
Implementing Order Management Orchestrate Fulfillment
Attribute Description
If you set up more than one wait step for a task, then make sure you set the exit criteria for
each wait step that occurs before the final wait step to Mark as Complete. For example.
• Assume you set up wait step x, wait step y, and wait step z on the same task, and that
wait step z occurs last.
• Make sure you set the exit criteria for step x and step y to Mark as Complete.
• If the fulfillment system doesn't reply to step x or step y, but instead replies only to step
z, then the flow can continue without waiting for step x and step y to finish.
• If you don't set Mark as Complete for x and y, then the orchestration process might
remain at x or y and never proceed to the next task.
• Make sure you specify the value Canceled as an exit criteria status to exit the wait task in
your orchestration process.
Line Selection Criteria Add a business rule that selects fulfillment lines. The orchestration process step will then
process only these fulfillment lines.
• The rule populates the result with the fulfillment line Ids that identify the fulfillment
lines to select.
• The rule runs for each fulfillment line that the orchestration process is processing.
• If the rule doesn't select any fulfillment line, then the orchestration process skips the
step.
An orchestration process might not require all of the order lines or fulfillment lines when it calls
the fulfillment task service. For example, assume the item on an order line is a warranty. You
typically don't ship a warranty, so you can create a business rule that specifies not to ship items
that don't ship.
For details, see the Select Fulfillment Lines for Orchestration Process Steps topic.
Pause Rule Specify when to pause processing before calling the next step, or when to resume processing.
For details, see the Pause Orchestration Processes topic.
Set Up Branching
An orchestration process branch is a path in an orchestration process that the process runs when the flow meets a
condition.
You can set up an orchestration process so its linear, where steps occur in a sequence with no branching, or so it
contains a branch where flow travels along different paths depending on a condition.
The technique you use depends in part on the complexity you need. For example, you can create several simple,
linear orchestration processes, then use an assignment rule to choose one. Or, you can combine these orchestration
processes into a single orchestration process that uses branching conditions. A more complex set up might require
assignment rules and branching conditions.
For an example that uses branching, see the Add Branches to Orchestration Processes topic.
1068
Oracle SCM Cloud Chapter 6
Implementing Order Management Orchestrate Fulfillment
Attribute Description
Branching Condition Specify the criteria that the condition must meet to run the steps in a branch.
• Add the condition on the first step of the branch, which is the first step immediately
after the conditional step.
• If you don't add a check mark to the Otherwise option on the conditional step, then you
must include a branching condition.
Evaluation Sequence Specify the sequence that the orchestration process uses when it evaluates each branch
condition.
Set the Evaluation Sequence only if your orchestration process uses branching. If it doesn't use
branching, then you can't set the sequence.
Otherwise If you add a check mark to the Otherwise option on the conditional step, and if the branching
condition does meet the criteria you specify for the branch, then the orchestration process
runs the branch that doesn't meet the branching condition.
Set Up Planning
Attribute Description
Planning Default Branch Specify the default path that the orchestration process uses for planning. The process uses this
setting only if it includes one or more conditional branches.
Fulfillment Completion Step Add a check mark to this attribute to indicate that the fulfillment lines are fulfilled when this
step finishes.
• The orchestration process uses this setting when it does planning to make sure it meets
the request date.
• The last step that occurs in chronological order in the process isn't necessarily the
Fulfillment Completion Step. For example, to indicate the completion date, the
orchestration process might use the requested ship date as the last step instead of
using the shipped date.
Default Lead Time Specify the duration that the orchestration process needs to do the step.
• The process uses lead-time to plan and to predict the completion date.
The lead-time is the amount of time the process needs to finish the step, including wait
steps and pause steps.
• If you don't specify a lead-time expression for the step, then the process uses the value
you set for Default Lead Time.
• If actual completion dates are available, then the process uses actual dates instead of
estimated dates.
1069
Oracle SCM Cloud Chapter 6
Implementing Order Management Orchestrate Fulfillment
Attribute Description
• The Gantt chart in the Order Management work area displays the planned orchestration
process. Order Management uses the number of days that are past the lead time when it
calculates jeopardy.
Lead Time UOM The unit of measure for the lead-time, such as days, hours, or minutes.
Lead-Time Expression A lead-time expression is a business rule that determines the amount of time you expect the
step needs to finish.
• Use it to calculate planning for the orchestration process. For example, an item that uses
complex packing might require a longer lead-time for shipping.
• The rule populates the result with a numeric value that represents the lead time.
• You must use BigDecimal with your lead-time expression.
Here's an example expression that determines the difference between the current date and the
scheduled ship date.
BigDecimal.valueOf((DooSeededOrchestrationRules.DOOHeader/
childFLines.scheduleShipDate.time-CurrentDate.date.timeInMillis)/
(1000*60*60*24))
where
For details, see the Set Up Lead-Times for Orchestration Process Steps topic.
Attribute Description
Hold on wait Sends a message to the fulfillment system for each active step when the orchestration process
receives a change order.
1070
Oracle SCM Cloud Chapter 6
Implementing Order Management Orchestrate Fulfillment
Attribute Description
Use Transactional Item Attributes If you enable transactional item attributes, then the step examines the transactional item
attributes to help it determine the differences that exists between the change order and the
previous version of the order.
Use Flexfield Attributes If you enable flexfield attributes, then the step examines them to help it determine the
differences that exists between the change order and the previous version of the order.
Compensation Pattern Specify the set of rules that determine how to handle each step that ran before Order
Management received the change order.
For example, assume a change order requests a change from carpet to tiles.
• The orchestration process must cancel a number of the previous steps that it ran.
• If it already scheduled carpet for shipping, then the process must cancel the steps that
scheduled the shipping.
• Order Management creates a different set of fulfillment lines for tiles when it processes
the change order, so it must use a different orchestration process because a tile order
requires more time to fulfill and it uses a different contractor.
• Order Management must cancel most of the previous steps, but it doesn't cancel the
Measure step because the room dimensions are still accurate.
If you don't specify a compensation pattern, then Order Management might process a step
as an update, depending on the context of the operation. It might rerun some steps. If Order
Management can't compensate a step for some reason, then it bypasses the step, then
compensates the next step that it encounters.
• Works through the orchestration process from beginning to end, starting with the first step in chronological
order, and ending with step Last Fulfillment Completion.
• Doesn't use the last step that occurs in chronological order to identify the completion date.
• Incorporates lead times in the dates that it calculates. You can set up these lead times.
• Displays the replanned schedule after it finishes the calculation.
1. Sets the Required Fulfillment Date to the date that your source system provides.
2. If the source system doesn't provide a date, then Order Management sets Required Fulfillment Date to
Requested Ship Date.
3. If Requested Ship Date doesn't contain a value, then Order Management sets Required Fulfillment Date to
Requested Arrival Date.
4. If Requested Arrival Date doesn't contain a value, then Order Management sets Required Fulfillment Date to
Order Date.
1071
Oracle SCM Cloud Chapter 6
Implementing Order Management Orchestrate Fulfillment
5. If Order Date doesn't contain a value, then Order Management sets Required Fulfillment Date to System Date.
The operating system of the computer that runs Order Management contains the system date.
Order Management exits this sequence as soon as it successfully sets the date. For example, if your source system
provides a date, then it does only step 1, and doesn't do steps 2 through 5.
Keep this sequence in mind when you set up your integration and orchestration process.
Improve Performance
The way you set up your orchestration processes and orchestration process steps can directly affect performance in
your environment. Here are some tips.
• Remove each step that you don't need. Each step eats up resources and increases processing time. For
example, if you use the predefined ShipOrderGenericProcess and don't need to do invoicing, then delete the
Create Invoice and Wait for Invoice steps. Don't use line-selection criteria to skip steps you don't need because
that approach increases processing time and might lead to a step that remains in a Not Started status for a long
time, or a process that seems to take forever to finish.
• Use a separate orchestration process to accomplish each goal. Don't use one large, monolithic process that
has a lot of branches and skipped steps to do all your processing. Instead, use several processes with fewer
branches.
Some predefined orchestration processes come with a rule on the first step. For example, the first step of
ReturnOrderGenericProcess is named Create Receiving Advice, and it comes with a line-selection criteria named
Receiving.
Assume you need to create a custom process that's similar to ReturnOrderGenericProcess, except your first step must
send a transportation request. You still need the Receiving line-selection criteria but you need it on the second step, not
the first.
1. In the Setup and Maintenance work area, go to the task.
Attribute Value
1072
Oracle SCM Cloud Chapter 6
Implementing Order Management Orchestrate Fulfillment
4. In the Process Details area, in the first row, Create Receiving Advice, set the value.
Attribute Value
5. Click the first row, then click Actions > Add Row.
The page adds a new step, 200, right after step 100.
6. Set values for step 200. You are duplicating step 100, so set these values.
Attribute Value
7. Click Save.
8. Copy the rule in step 100.
◦ On step 100, in the Line-Selection Criteria column, click Click for Rule.
◦ In the Line-Selection Criteria dialog, notice the rule named Receiving, click Expand, click Show
Advanced Settings, then set the values.
Attribute Value
You must set these values. If you don't, your copy will fail validation.
1073
Oracle SCM Cloud Chapter 6
Implementing Order Management Orchestrate Fulfillment
◦Add a check mark in the option that's right next to Receiving, click the down arrow next to the scissors,
click Copy, then click Cancel.
9. Paste the rule into step 200.
◦ On step 200, in the Line-Selection Criteria column, click Click for Rule.
◦ In the Line-Selection Criteria dialog, click Paste.
◦ Click Validate, then verify that the Message contains No validation errors/warnings found!.
◦ Click Save.
10. On step 100, set the value.
Attribute Value
Create
1074
Oracle SCM Cloud Chapter 6
Implementing Order Management Orchestrate Fulfillment
1075
Oracle SCM Cloud Chapter 6
Implementing Order Management Orchestrate Fulfillment
This topic includes example values. You might use different values, depending on your business requirements.
1. Do tasks in the Setup and Maintenance work area that allow you to set up an orchestration process.
2. Create the task types that the orchestration process requires. Also define the tasks and services that these task
types reference.
3. Create the status codes that the orchestration process requires and specify how the task types, fulfillment lines,
and your orchestration process will use them.
4. Create the orchestration subprocesses that the orchestration process will reference.
5. Create the status catalogs that the orchestration process will use for status conditions. Create catalogs for one
of these applications.
Attribute Value
The set up page automatically adds the CustomDOO_ prefix. You must use this prefix for any
orchestration process you create.
Enter any value. Don't include spaces. The value you that enter will display throughout the
Setup and Maintenance work area and the Order Management work area.
An orchestration process class contains a set of statuses that you can assign to the
orchestration process.
1076
Oracle SCM Cloud Chapter 6
Implementing Order Management Orchestrate Fulfillment
Attribute Value
Select a class that includes the statuses you need for the orchestration process.
Note.
◦ A set is a collection of business units. Use it to organize business units and control the
business units that can access an orchestration process.
◦ Select the set that allows the business unit to access the orchestration process.
◦ Use the predefined Common Set to provide access to many business units.
◦ You must add your business unit to the set you specify.
Attribute Description
Step Name Enter text that describes the purpose of the step. For this example, enter Schedule
Product.
Step Type Select a value that indicates the type of processing that this step does.
For example, if this step must do conditional branching, then choose Conditional. This
example calls a service, so select Service.
Task Type Select the group of services that Order Management uses to do a fulfillment task. For this
example, select Schedule.
Task Select the task that this step must perform. For this example, select Schedule.
Service Identify the service that this step must call. For this example, select Create Scheduling.
Attribute Value
1077
Oracle SCM Cloud Chapter 6
Implementing Order Management Orchestrate Fulfillment
Attribute Value
Task Reserve
Tip: To maintain the correct sequence when you add each step, click the step that you most recently
added, then click Add Row. To make sure you don't lose any work, click Save after you add each step.
4. Repeat steps 1 and 2. Use these values.
Attribute Value
Task Ship
Attribute Value
Task Ship
Note that you also specify the exit criteria in this step.
1078
Oracle SCM Cloud Chapter 6
Implementing Order Management Orchestrate Fulfillment
Attribute Value
Task Invoice
Attribute Value
Task Invoice
1079
Oracle SCM Cloud Chapter 6
Implementing Order Management Orchestrate Fulfillment
For a demonstration that creates a business rule, see Creating Business Rules: Demo.
1080
Oracle SCM Cloud Chapter 6
Implementing Order Management Orchestrate Fulfillment
For details about how to create CallCustomerWhenLargeInvoice, see the Add Branches to Orchestration
Processes topic.
4. On the Edit Orchestration Process Definitions page, in the Process Details area, in the Step Definition list, click
Planning.
5. In the Ship Product row, set the value.
Attribute Value
If you write a rule for an orchestration process that orchestrates more than one fulfillment line, then use
Advanced Mode. However, this example treats all fulfillment lines in the same way, so Advanced Mode isn't
required. To use Advanced Mode, you would click Show Advanced Settings, add a check mark to Advanced
Mode, then edit the rule.
8. In the If area, click Left Value.
9. In the Condition Browser, expand DOOSeededOrchestrationRules > DOOFline, click
InventoryOrganizationId, then click OK.
DOOFline is an abbreviation for Distributed Order Orchestration Fulfillment line. Oracle replaced the name
Distributed Order Orchestration with the name Order Management in an earlier release. Some rules still use the
old name.
10. In the Right Value attribute, enter 1234440.
1081
Oracle SCM Cloud Chapter 6
Implementing Order Management Orchestrate Fulfillment
Attribute Value
Value BigDecimal.valueOf(2)
Tip: In some attributes, you can copy the value from one attribute to another instead of using the drop-
down list. For example, you can copy DooSeededOrchestrationRules.DOOFLine.inventoryOrganizationId
from Left Value of the first rule, then paste it into Left Value of the second rule.
4. Click the down arrow for the operator, then click isn't.
5. In the Right Value attribute, enter 1234440.
Attribute Value
Value BigDecimal.valueOf(4)
Related Topics
• Overview of Using Business Rules With Order Management
In this example, you create a line selection rule that makes sure Order Management doesn't attempt to ship a
nonshippable item.
1082
Oracle SCM Cloud Chapter 6
Implementing Order Management Orchestrate Fulfillment
Assume you sell digital video recorders. The sales order includes more than one fulfillment line for each items.
• Digital video recorder
• Remote control
• Instruction manual
• Extended warranty
Your customers can purchase the extended warranty as a contract online, but its not a shippable item, so Order
Management must not attempt to send it to the fulfillment system during the Shipment task. So, you create a rule.
• If Order Management can't ship the item, then don't attempt to ship it.
where
• DooSeededOrchestrationRules is a dictionary that contains a set of predefined functions, variables, objects,
and other data you can use to define behavior for an orchestration process.
• DOOFLine contains fulfillment line attributes, such as orderedQty, customerPONumber, creationDate, and so
on. You can reference these attributes and use their values in your rule.
• shippableFlag is a fulfillment line attribute.
• Y is one possible value of shippableFlag.
1083
Oracle SCM Cloud Chapter 6
Implementing Order Management Orchestrate Fulfillment
This example includes a business rule that requires you to use a dictionary, fact, and other objects. Its strongly
recommended that you familiarize yourself with these objects before you proceed. For details, see the Business Rules
chapter in the Implementing Order Management book.
where
• Assert New adds the result into the Result fact of the DooSeededOrchestrationRules dictionary.
• resultObjKey is a property of Result. It specifies the fulfillment line to examine.
• DooSeededOrchestrationRules.DOOFLine.fulfillLineId specifies to use the value of the fulfillLineId attribute in
the DOOFLine fact of DooSeededOrchestrationRules.
1084
Oracle SCM Cloud Chapter 6
Implementing Order Management Orchestrate Fulfillment
1085
Oracle SCM Cloud Chapter 6
Implementing Order Management Orchestrate Fulfillment
Try it.
You can't modify the predefined process, so you create a duplicate and modify it instead. Notice the process
name.
(CopyOf)CustomDOO_ShipOrderGenericProcess
100 Schedule
4. On the step 100 row, in the Line Selection Criteria column, click Click for Rule.
5. In the Line Selection Criteria dialog, click Expand, then notice the predefined rule. Locate the last condition,
immediately above the THEN area.
6. On the row you just located, click the down arrow at the far right of the row, then click Simple Test.
7. In the new row, enter "ORDER", change is to equals ignore case, then enter
DooSeededOrchestrationRules.DOOHeader/childFLines.categoryCode.
Deploy
Deploy Orchestration Processes
Release and deploy an orchestration process that you create so its available throughout Order Management.
If you use one of these predefined orchestration processes, then you must deploy it, but its not necessary to release it.
• ShipOrderGenericProcess
• ReturnOrderGenericProcess
1086
Oracle SCM Cloud Chapter 6
Implementing Order Management Orchestrate Fulfillment
1. Validates orchestration process logic to make sure it correctly created the process.
A valid orchestration process might include warning messages, but these messages don't
stop the release from proceeding.
Finds errors. Order Management stops the release and displays an error icon next to the orchestration
process name. It keeps these errors until the next time it runs the validation.
You must resolve errors before you can continue the release.
1087
Oracle SCM Cloud Chapter 6
Implementing Order Management Orchestrate Fulfillment
If you can't access the Manage Orchestration Process Definition page to deploy the orchestration process for some
reason, then you can use Oracle Middleware to deploy it. For details, see the Use Oracle Middleware to Deploy
Orchestration Processes topic.
1088
Oracle SCM Cloud Chapter 6
Implementing Order Management Orchestrate Fulfillment
<searchReplace>
<search>http://localhost_am:port</search>
<replace>http://actualDOOADFserver:port</replace>
</searchReplace>
<searchReplace>
<search>http://localhost_soa:port</search>
<replace>http://actualDOOSOAserver:port</replace>
</searchReplace>
</attribute>
</binding>
</reference>
</composite>
</SOAConfigPlan>
Note.
• Replace each host name with the Oracle Application Development Framework (ADF) server.
• Replace each port with the port that your organization uses for Order Management and the server and port that
Supply Chain Management uses for SOA. Use the external-facing URLs of the servers.
The JAR file resides in a Deploy folder. The Deploy folder resides in a folder that uses the name of the orchestration
process you downloaded.
For details about how to deploy an SOA composite application, see Oracle Fusion Middleware Administrator's Guide for
Oracle SOA Suite and Oracle Business Process Management Suite.
Example of a Subprocess
Assume you use different steps to process different sales orders, depending on the item. However, all orders use these
billing steps.
• Create invoice.
• Wait for invoice.
• Send request to activity system that notifies customer of payment receipt.
• Send request to activity system that creates coupons.
1089
Oracle SCM Cloud Chapter 6
Implementing Order Management Orchestrate Fulfillment
So, you create an orchestration subprocess that includes these steps, and then add it to each orchestration process you
use.
Assume you sell commercial computer systems, and you need a business rule.
• If the sales order is valued at $50,000.00 or more, then make sure a representative calls the customer before
sending the invoice for the order.
1090
Oracle SCM Cloud Chapter 6
Implementing Order Management Orchestrate Fulfillment
Here's the flow that you will create for this example.
Note.
• Each step in the flow includes the step number, task name, task type, and service name.
• The Conditional Node indicates that an orchestration process is about to branch. The first step of the branch
contains the condition.
• If the flow.
◦ Meets the condition. The orchestration process runs the steps on the branch that notifies the
representative.
◦ Doesn't meet the condition. The orchestration process runs the steps on the branch that don't notify
the representative.
1091
Oracle SCM Cloud Chapter 6
Implementing Order Management Orchestrate Fulfillment
• Order Management adds an empty default branch when it runs the orchestration process. If the orchestration
process includes only one branch, then it isn't necessary to set an Otherwise condition.
This example uses a rule that processes only one fulfillment line. You use an advanced rule to write a rule for an
orchestration process that processes more than one fulfillment line. For details about how to do this, see the Overview
of Using Business Rules With Order Management topic.
1. Create the routing rules that enable the send. For details, see the Create Routing Rules That Send Notifications
topic.
2. Create the connector that you referenced in the routing rules in step 1.
3. Use the Manage Web Service Details page to create the connector.
Attribute Value
For details about how to set up an orchestration process, see the Setting Up Orchestration Processes topic.
1092
Oracle SCM Cloud Chapter 6
Implementing Order Management Orchestrate Fulfillment
1. Add a step.
Attribute Value
Task Schedule
1093
Oracle SCM Cloud Chapter 6
Implementing Order Management Orchestrate Fulfillment
Tip: To maintain the correct sequence when you add each step, click the step you most recently added,
then click Add Row.
Attribute Value
Task Reserve
Attribute Value
Task Ship
Attribute Value
Task Ship
1094
Oracle SCM Cloud Chapter 6
Implementing Order Management Orchestrate Fulfillment
Attribute Value
Attribute Value
Task Activity
Evaluation Sequence 1
Attribute Value
Task Activity
Attribute Value
1095
Oracle SCM Cloud Chapter 6
Implementing Order Management Orchestrate Fulfillment
Attribute Value
Task Invoice
Attribute Value
Task Invoice
10. In the Step Definition list, click the Conditional Node step, then add another step. This step creates the
Otherwise branch.
Attribute Value
Each task name that you use with a task type must be unique. You used the Invoice task with
the Invoice task type earlier in this procedure, so you must create a new task name.
To do this, In the Task attribute, click the Search down arrow, then click Create. In the Create
Task Name dialog, enter values.
◦ Code: 1
◦ Name: Otherwise_Create_Invoice
1096
Oracle SCM Cloud Chapter 6
Implementing Order Management Orchestrate Fulfillment
Attribute Value
Evaluation Sequence 2
11. In the Step Definition list, click the Otherwise Step - Create Invoice step, then add another step. This step
creates the Wait for Invoice Step on the Otherwise branch.
Attribute Value
12. In the Step Definition list, click the Wait for Invoice step, then add another step. This step merges the branch
back to the main flow.
Attribute Value
1097
Oracle SCM Cloud Chapter 6
Implementing Order Management Orchestrate Fulfillment
Do it.
1. In the Step Definition list, in the Phone Customer step, in the Branching Condition column, click Click for Rule.
2. In the Branching Condition Rules dialog, click Add Rule, then click Expand.
3. Delete the value Rule 1 , and then enter Condition for invoices valued at more than 50000 dollars.
4. Click Left Value.
5. In the Condition Browser dialog, expand DooSeededOrchestrationRules > DOOFLine, click
extendedAmount, then click OK.
where
Code Description
DooSeededOrchestrationRules A dictionary that includes predefined rule sets, facts, functions, variables, bucket sets, links,
and functions that you can use to orchestrate fulfillment.
DOO Means distributed order orchestration, which is an earlier name for order orchestration.
1098
Oracle SCM Cloud Chapter 6
Implementing Order Management Orchestrate Fulfillment
Code Description
extendedAmount A fulfillment line attribute that stores the total value of the sales order.
• ( resultObj:DooSeededOrchestrationRules.Boolean.TRUE )
where
Code Description
resultObj A variable in the DooSeededOrchestrationRules dictionary. You use it to store the result of the
business rule.
Do it.
1099
Oracle SCM Cloud Chapter 6
Implementing Order Management Orchestrate Fulfillment
For example.
7. Click OK.
8. In the Branching Condition Rules dialog, click Save.
9. On the Edit Orchestration Process Definition page, click Save.
◦ In the header of the Edit Orchestration Process Definition page, click Actions, then click Generate
Process Diagram.
◦ Make sure the diagram includes the same steps and logic that the diagram at the beginning of this topic
displays.
2. Test the nonbranching flow.
◦ In the Order Management work area, create a sales order that's valued at less than $50,000.00.
◦ Verify that Order Management ships the item without requesting that the user call the customer.
3. Test the branching flow.
1100
Oracle SCM Cloud Chapter 6
Implementing Order Management Orchestrate Fulfillment
Assume your customer purchases a laptop computer that includes a service contract, and your business flow requires
that the fulfillment system ship the laptop in a truck at the same time that it sends the service contract through email.
You can use parallel processing to ship the laptop and send the email at the same time.
This orchestration process includes branches that run in parallel with one another.
• Step 300 begins the parallel branching.
• Steps 400 and 500 run in one branch at the same time that steps 600 and 700 run in a parallel branch.
• The Create Invoice and the Wait for Billing steps occur after step 800. The illustration doesn't include these final
steps.
The orchestration process plans the flow after it finishes each task. However, if a task requires several days to finish,
then planning data might not be current because the orchestration process can't replan the branch while it waits for
1101
Oracle SCM Cloud Chapter 6
Implementing Order Management Orchestrate Fulfillment
a long-running task to finish. For details about how to use the Plan Orchestration Processes scheduled process to
schedule an update that occurs at regular intervals, see the Orchestration Processes topic.
Note.
• Use parallel processing when more than one long-running task must run at the same time. For example, to
send simultaneous requests to two different fulfillment systems that typically require elapsed time to reply.
• Don't use parallel processing when the reply from a task request occurs almost immediately.
• You can set up parallel processing so more than one task can run at the same time.
• You can filter the fulfillment lines of a group so the tasks for some lines in the group run at the same time as
tasks for the other lines.
• You can create a parallel process that doesn't filter lines in a branch so that more than one task is active for each
line.
• Order Management doesn't allow you or a fulfillment system user to split a task that resides in a parallel branch.
Assign
Guidelines for Assigning Orchestration Processes
Create an assignment rule that assigns an orchestration process to one or more fulfillment lines of a sales order.
• Assign the orchestration process according to your unique requirements.
• Order Management Cloud doesn't create different versions of an assignment rule so the changes that you
release take effect immediately. You can save rules without releasing them.
• Use the Otherwise logic to assign an orchestration process that will apply by default. Use it for each
orchestration group.
• Create an assignment rule that references data from a different product model. For details, see the Use
Business Rules to Get Data from Different Product Models topic.
• You don't need to specify a version or effective date for an assignment rule because the orchestration process
controls them.
• Use the rules editor to help you filter the attributes that you can use in your assignment rule. For details, see the
Use Tools and Environments to Create Business Rules topic.
Note.
• You must set up your orchestration processes before you create your assignment rule.
• Order Management can't reassign an existing order line to a different orchestration process when you revise a
sales order. For details, see the Fix Problems That Occur When Assigning Orchestration Processes topic.
1102
Oracle SCM Cloud Chapter 6
Implementing Order Management Orchestrate Fulfillment
• If a group of fulfillment lines are part of a shipment set, then you can't assign different orchestration processes
to different lines in the set. For example, if fulfillment line w and fulfillment line x are part of a shipment set,
then you can't assign line w to process y and line x to process z.
Order Management assigns the first line that it encounters in the set to an orchestration process, and then
assigns all subsequent lines in the set to the same orchestration process. If you create an assignment rule that
attempts to assign a subsequent line in the set to a different orchestration process, then Order Management
will ignore that rule. Order Management uses this configuration to make sure it can schedule, reserve, and ship
the lines together.
• Don't create an assignment rule that assigns a fulfillment line to an orchestration process when you revise a
sales order. If you need to reassign a fulfillment line to an orchestration process that's different from the one
that the fulfillment line currently uses, then you must cancel the sales order or the order line and create a new
one.
Examples
Item Each sales order for the AS54888 Desktop Computer must use the same processing steps.
You write an assignment rule that assigns an orchestration process named AS54888 Desktop
Computer Process to each order line that includes the AS54888 in the Item attribute of the
order line.
Customer Customer Computer Service and Rentals requires an inspection step for each sales order.
You write an assignment rule that assigns an orchestration process named Computer Service
and Rentals Process to each order line that includes Computer Service and Rentals in the
Customer attribute of the order header.
Destination Each sales order that the fulfillment system must ship to a country that resides outside of your
current location requires different handling, such as completing customs forms.
You write an assignment rule that assigns an orchestration process named International Orders
Process to each order line that includes a foreign country in the Ship-To Address attribute of
the order header.
• You create an orchestration group as a shipment set, configured item, or set of order lines.
• Your assignment rule processes each orchestration group at run time, so you must add a test that links each
fulfillment line with the group. The predefined assignment rules already include this test.
1103
Oracle SCM Cloud Chapter 6
Implementing Order Management Orchestrate Fulfillment
CreateSTDGroups Assign the orchestration process when the fulfillment line has an item that isn't configured or
that's configured but that the user has finished configuring.
AddSTDLines Add a fulfillment line when you assign an orchestration process according to lines that have
items that aren't configured or that are finished items.
CreateShipSets Assign an orchestration process according to fulfillment lines that have a shipment set.
AddShipSetLines Add a fulfillment line when you assign an orchestration process according to lines that have a
shipment set.
CreateModels Assign an orchestration process according to fulfillment lines that have a configured item.
To view the predefined AssignProcess rule on the Manage Orchestration Process Assignment Rules, set the View
attribute to AssignProcess.
If you create your own rule, then consider the predefined rules when you set priority. If you want Order Management
to apply your custom rule first, then set the priority higher on your custom rule than the value that's on the predefined
rule.
Related Topics
• Return Sales Orders
• Use Tools and Environments to Create Business Rules
1104
Oracle SCM Cloud Chapter 6
Implementing Order Management Orchestrate Fulfillment
Process_Small_Orders For quantity under 100. Expedite shipping and don't measure the impact on inventory.
Process_Medium_Orders For quantity 100 to 999. Use regular shipping and measure the impact on inventory only at the
distributor, not the warehouse.
Process_Large_Orders For quantity over 1,000. Use bulk freight. Measure the impact on inventory at the warehouse
and the distributor, and call the customer to confirm the order before you ship it.
1105
Oracle SCM Cloud Chapter 6
Implementing Order Management Orchestrate Fulfillment
This topic includes example values. You might use different values, depending on your business requirements.
Attribute Value
1106
Oracle SCM Cloud Chapter 6
Implementing Order Management Orchestrate Fulfillment
Note:
If you didn't deploy your orchestration process, then the search won't find it.
◦ Click the row in the search results.
◦ Click OK.
◦ In the Create Action dialog, click OK.
Related Topics
• Use Visual Information Builder
• Manage Assignment Rules for Orchestration Processes
Pause
1107
Oracle SCM Cloud Chapter 6
Implementing Order Management Orchestrate Fulfillment
Overview
Overview of Pausing Orchestration Processes
Use a pause task to temporarily stop an orchestration process from running so it can wait to meet a condition.
When it meets the condition, the orchestration process releases the pause task, then proceeds to the next orchestration
process step. You can specify a pause task to wait between tasks, or specify when to release the pause and begin the
next orchestration process step.
1108
Oracle SCM Cloud Chapter 6
Implementing Order Management Orchestrate Fulfillment
Note.
1. You add a step that references a pause task in an orchestration process. You can add a pause task step at
any point in the orchestration process. This example includes a simple three step orchestration process. For
example, assume the orchestration process successfully scheduled fulfillment, and now must wait to confirm
payment before shipping the item to your customer.
2. You set up a rule that pauses the orchestration process to wait for an event to occur, time to elapse, or for a
dependency to resolve.
3. You set up a release rule that releases the pause task so the orchestration process can continue to the next
step. Here's how you release a pause task.
◦ Release it automatically when the timer expires, when the flow meets the release condition, or when the
flow doesn't meet any of the conditions.
◦ Allow a user to release it manually in the Order Management work area.
◦ Use a scheduled process that releases it automatically according to a regularly scheduled interval.
◦ Use a web service that informs the orchestration process when to release.
Examples
Pause Until An Event Occurs
Assume you provide a layaway program that allows your customer to reserve an item, then pay for it in installments.
Use a pause task to pause the orchestration process. When the customer pays in full, the orchestration process calls the
Release Paused Tasks service, releases the pause task, then ships the item to the customer.
In another example, assume you must release each sales order to shipping only if inventory is available at the fulfillment
location. Use a pause task that pauses the orchestration process until the inventory is available. When the inventory is
available, the web service calls Release Paused Tasks, releases the pause task, then ships the item to the customer.
If you set up a rule that waits for an event to occur, then you typically use a web service to resume the pause task. In this
context, event means something that occurs outside of Order Management Cloud. Its not synonymous with a business
event. For details, see the Pause Orchestration Processes Until an Event Occurs topic.
Assume you prefer not to overload the warehouse with shipment requests that aren't due for delivery for two weeks.
You can pause the orchestration process to wait to send the shipment request to the warehouse until two days before
the scheduled shipment date occurs.
In another example, assume you sell a video game up to seven days before the release date of the game.
• You estimate it requires seven days to schedule and process the sales order before it ships. Use this lead time
so you can ship the game as soon as its available.
• You set up a pause task that pauses the orchestration process before the schedule step occurs, and continues
to pause until the publisher releases the game.
• You set up a rule that releases the pause task according to an extensible flexfield that includes a value of the
release date minus seven days. The orchestration process releases the pause task, schedules the sales order,
then resumes processing.
For details, see the Pause Orchestration Processes Until Time Elapses topic.
1109
Oracle SCM Cloud Chapter 6
Implementing Order Management Orchestrate Fulfillment
• A customer requests to receive a shipment that includes coffee, paper cups, sugar, and creamer at the same
time. One fulfillment line fulfills each item. For example, fulfillment line x fulfills the coffee, fulfillment line y
fulfills the cups, and so on. You can use a pause task that pauses each order line until the orchestration process
finishes scheduling each of these lines. The orchestration process periodically evaluates the sales order. It
finishes scheduling all lines, then ships them to the customer at the same time.
• A customer must receive invoices for all fulfillment lines of a sales order at the same time, regardless of when
the orchestration process ships each of these lines. You can use a pause task that pauses the orchestration
process until it ships all items. It then sends the invoices for all lines to the customer at the same time.
• Your company policy requires people in your organization to review and approve each sales order where the
scheduled date occurs after the requested date. You can use a pause task to pause the orchestration process
until these folks finish review and approval.
For details, see the Pause Orchestration Processes Until a Dependency Resolves topic.
Attribute Value
• Y. Evaluate the condition every time the orchestration process finishes a step. If the
reevaluateFlag condition doesn't evaluate to true, then release the pause task.
For example, assume the orchestration process is processing more than one fulfillment
line in a sales order, and that you must evaluate the condition after it processes each
line. You can use reevaluateFlag to evaluate each line.
For another example, assume you must print pictures for customers and then frame
them. You set up a flow that includes a parallel task that prints the picture. You promise
same day shipping, so you periodically examine whether the picture printed so you can
frame it as soon as possible.
• N. Don't evaluate the condition every time the orchestration process finishes a task.
If the IF statement is True, then the orchestration process remains paused until you
explicitly release the pause task.
sacType Specify the action to take when your If statement evaluates to True.
1110
Oracle SCM Cloud Chapter 6
Implementing Order Management Orchestrate Fulfillment
Related Topics
• Manage Order Management Parameters
• Manage Order Attributes That Identify Change
1111
Oracle SCM Cloud Chapter 6
Implementing Order Management Orchestrate Fulfillment
Note.
• Use the Edit Orchestration Process Definition page in the Setup and Maintenance work area.
• Add a pause step. Set values.
Attribute Value
Task Pause
• Click the link in the Pause Rule column to set up your release rule. Prior to Release 13C, the link was labeled
Start After Condition.
You typically use line-selection criteria to filter fulfillment lines that the orchestration process step processes.
However, line-selection criteria isn't available for a pause task because the pause task examines every
fulfillment line in the sales order, by default.
If you set up your pause task so the evaluation interval is too short, then the orchestration process might evaluate the
pause condition an excessive number of times and degrade performance. Assume you.
• Create a pause step that pauses the orchestration process until Scheduled Ship Date occurs.
• Set reevaluateFlag to Y.
• Evaluate the condition one time every five minutes.
Assume five days typically elapse between the time the pause step runs and when Scheduled Ship Date occurs. On
average, the orchestration process will evaluate the condition 1,440 times.
• 12 times for each hour, multiplied by 24 hours, multiplied by five days, equals 1,440
This processing consumes a lot of resources, can affect performance, and might result in memory problems that can
cause your runtime environment to fail. So, set up your pause step so it evaluates the condition less frequently. In this
example, the evaluation could probably occur one time every two hours without affecting the orchestration process in a
negative way.
Use the Number of Times to Retry Pause order management parameter to control the maximum number of times
the orchestration process evaluates the condition before it temporarily pauses the pause task and displays an error
message informing your users to click Recover to manually recover the pause. For details, see the Manage Order
Management Parameters topic.
Use the Recover Errors scheduled process to evaluate the conditions again. For example.
1. Set up Recover Errors so it runs on the pause task.
2. Set Number of Times to Retry Pause to 10.
1112
Oracle SCM Cloud Chapter 6
Implementing Order Management Orchestrate Fulfillment
Note.
• If your pause task doesn't reference an extensible flexfield, then disable the Use Flexfield Attributes option to
instruct the orchestration process to skip the pause step when the value in an extensible flexfield changes.
• If you don't need to run your pause task when revising a sales order, then write a compensation pattern.
Assume you write a pause step that waits for payment. The Order Entry Specialist manually indicates that the
customer sent payment, and the pause ends. Some time later, the Order Entry Specialist revises the sales order
in a way that doesn't affect the payment amount, such as modifying the ship-to address.
It isn't necessary to pause to wait for payment after the revision, so you can write a compensation pattern that
skips pause on the payment step.
• The orchestration process uses the attributes that you specify on the Order Attributes That Identify Change
page to determine when to compensate when revising a sales order. Use it to make sure your pause task runs
only if the revision that the Order Entry Specialist makes affects an attribute that your pause task references.
For details, see the Manage Order Attributes That Identify Change topic.
1113
Oracle SCM Cloud Chapter 6
Implementing Order Management Orchestrate Fulfillment
If you set up more than one rule that runs as a set of rules on the same start after condition, then you must set the
release rule to the highest priority of all rules in the set.
1114
Oracle SCM Cloud Chapter 6
Implementing Order Management Orchestrate Fulfillment
Note.
• Order Management runs the rule with the highest priority first.
• Set Priority to Highest on the rule where you use Assign New to make sure the rule runs first. It also makes sure
that this rule creates the object that stores the result of the start-after condition (SAC). Other rules might set
the value for the start-after condition.
• If you only have one rule in your rule set, then you don't need to worry about setting priority.
•
• If you don't set the priority correctly, you might encounter a null pointer error when the rules run.
1115
Oracle SCM Cloud Chapter 6
Implementing Order Management Orchestrate Fulfillment
• Don't use the If statement on the release rule to define the condition that your business logic requires. Instead,
set up your conditional logic on the pause rule.
• The rule editor requires that you set up a condition on the release rule so it passes validation, so set up a
condition that's always true.
• Use Assign New. Assign New creates a new instance of SacResult so you can assign values to it while the rules
in your rule set run.
• The release rule is optional starting with Release 19A. If no rule satisfies the condition, then orchestration
automatically releases the pause.
Its recommended that you include these assignments as the first two actions in your Then statement.
assign new DooSeededOrchestrationRules.SacResult SAC = new DooSeededOrchestrationRules.SacResult()
assign Header.sacResult = SAC
If you don't include these assignments, and if you don't create a release rule, then at least one of the rules in your rule
set must use the Assign New action to create the SAC object.
1116
Oracle SCM Cloud Chapter 6
Implementing Order Management Orchestrate Fulfillment
Note.
Attribute Description
sacType Required
1117
Oracle SCM Cloud Chapter 6
Implementing Order Management Orchestrate Fulfillment
Attribute Description
sacEventName Optional, depending on the type of pause. For example, if the rule pauses according to a
dependency to resolve, then you must include sacEventName.
ReevaluateFlag
For details, see the Overview of Pausing Orchestration Processes topic.
waitDateTime
You typically use a release rule to release a pause. However, you can also use a web service, scheduled process, or the
Order Management work area to release the pause.
1118
Oracle SCM Cloud Chapter 6
Implementing Order Management Orchestrate Fulfillment
Assume you need to send all order lines together to invoicing, but you need to control when to send them instead of
using a rule to automatically release them.
Note.
1119
Oracle SCM Cloud Chapter 6
Implementing Order Management Orchestrate Fulfillment
Code Description
Header is a Declare the Header variable, then store attributes of the order header that the orchestration
DOOSeededOrchestrationRules.DOOHeader
process is currently processing into this variable.
Assign new Create a new variable named SAC and set it to the SacResult type in the
DooSeededOrchestrationRules.SacResult
DooSeededOrchestrationRules method.
SAC = new
DooSeededOrchestrationRules.SacResult()
Assign Header.sacResult = Set the value of the sacResult object on the order header to the value that SAC contains.
SAC
Assign Specify the event you use to identify the event that's tracking the pause. In this example,
Header.sacResult.eventName = assume you named it Waiting for Manual Release.
"Waiting for Manual Release"
1120
Oracle SCM Cloud Chapter 6
Implementing Order Management Orchestrate Fulfillment
If you manually release a pause or release it through a web service or scheduled process, then don't include a condition
or default release rule. Here's an example where you send shippable and nonshippable lines together to invoicing, and
you want to control when to send these lines.
You can specify your own eventName, such as Waiting for manual release. The Order Management work area will
display this name. You can also specify it on the scheduled process that you use to release the pause.
1121
Oracle SCM Cloud Chapter 6
Implementing Order Management Orchestrate Fulfillment
Header.sacResult SAC
Header.sacResult.sacType DooSeededOrchestrationRules.SacResult.SAC_TYPE_IMMEDIATE
DooSeededOrchestrationRules.SacResult.SAC_TYPE_EVENT
DooSeededOrchestrationRules.SacResult.SAC_TYPE_TIMER
Header.sacResult.eventName DooSeededOrchestrationRules.SacResult.SAC_SYSTEM_EVENT_IPC_PAUSE
You can reference the name of any event that you set up.
1122
Oracle SCM Cloud Chapter 6
Implementing Order Management Orchestrate Fulfillment
Related Topics
• Manage Order Management Parameters
• Manage Order Attributes That Identify Change
• Use Business Rules in Orchestration Processes
SAC_TYPE_TIMER or Let the condition evaluate and release the process, or use one of the set ups described in this
SAC_SYSTEM_EVENT_IPC_PAUSE topic.
SAC_TYPE_EVENT You must use one of the set ups described in this topic.
Note: You must release a paused orchestration process. If you don't, then the orchestration process will remain in a
paused state, which might result in failed sales orders, failed order fulfillment, and so on.
You need these privileges to run the Release Pause Tasks scheduled process. For details, see the Job Roles and
Duty Rules That You Use to Implement Order Management topic.
2. Go to the Scheduled Processes work area.
3. On the Scheduled Processes page, click Schedule New Process.
4. In the Schedule New Process dialog, set the value, and then click OK.
Attribute Value
This scheduled process releases a pause task that's waiting for a business event to finish.
1123
Oracle SCM Cloud Chapter 6
Implementing Order Management Orchestrate Fulfillment
5. Use one of the parameters to specify the orchestration process you must resume, such as Item, Customer, Task
Name, and so on.
For example, if you set up a pause task on an orchestration process that's waiting for the Gold Preorders event,
then set the event parameter to Gold Preorders.
You can also set the Manual Release Type parameter.
Value Description
Tasks That Exceed Maximum Retries Use this value for most situations.
Tasks That Can't Establish Wait Release a pause task that fails to release because of some problem that's internal to Order
Management. Set this value only in consultation with Oracle Support.
6. Click Submit.
For an example that uses this scheduled process, see the Pause Orchestration Processes Until an Event Occurs topic.
You can use some of the same parameters that you use with the Release Pause Tasks scheduled process.
• BuyingPartyName
• BuyingPartyNumber
• EventName
• FromOrderDate
• FromPauseWaitUntilDate
• FromScheduledShipDate
• FulfillLineNumber
• FulfillmentOrganizationCode
• FulfillmentOrganizationName
• FulfillOrgId
1124
Oracle SCM Cloud Chapter 6
Implementing Order Management Orchestrate Fulfillment
• InventoryItemId
• LineNumber
• ManualReleaseType
• ManualReleaseTypeName
• OrderNumber
• PausedTaskName
• PauseTaskId
• ProductNumber
• SoldToCustomerId
• SourceOrderNumber
• SourceOrderSystem
• TaskInstanceId
• ToOrderDate
• ToPauseWaitUntilDate
• ToScheduledShipDate
Here's an example payload that releases pauses where the name of the pause task is PauseAfterReservation1. Look at
the step in your orchestration process definition that has the pause task to determine the name of the pause task that
you need to release.
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:dood="http://
xmlns.oracle.com/apps/scm/doo/decomposition/receiveTransform/receiveSalesOrder/
DooDecompReceiveOrderExternalComposite">
<soapenv:Header/>
<soapenv:Body>
<dood:ReleasePausedEventTasksRequest>
<dood:SourceSystem>OPS</dood:SourceSystem>
<dood:PausedTaskName>PauseAfterReservation1</dood:PausedTaskName>
</dood:ReleasePausedEventTasksRequest>
</soapenv:Body>
</soapenv:Envelope>
You can release a pause for a single order line. Here's a payload that releases the pause task on order line 1 of sales
order 506608.
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:dood="http://
xmlns.oracle.com/apps/scm/doo/decomposition/receiveTransform/receiveSalesOrder/
DooDecompReceiveOrderExternalComposite">
<soapenv:Header/>
<soapenv:Body>
<dood:ReleasePausedEventTasksRequest>
<dood:SourceSystem>OPS</dood:SourceSystem>
<dood:OrderNumber>506608</dood:OrderNumber>
<dood:LineNumber>1</dood:LineNumber>
</dood:ReleasePausedEventTasksRequest>
</soapenv:Body>
</soapenv:Envelope>
Related Topics
• Operations and Attributes You Can Use with the Receive Order Request Service
• Job Roles and Duty Roles That You Use to Implement Order Management
• Resume Paused Sales Orders
1125
Oracle SCM Cloud Chapter 6
Implementing Order Management Orchestrate Fulfillment
Note.
For example, Header.getAdjustedDate(null, 1) specifies to get the current system date, and then wait for
current system date plus one day before releasing the pause.
1126
Oracle SCM Cloud Chapter 6
Implementing Order Management Orchestrate Fulfillment
Use dateTime for the first parameter in the function. For example, to wait until two days before the schedule
ship date, use Header.getAdjustedDate(FLine.ScheduleShipDate,-2).
• reevaluateFlag evaluates the conditions in the IF part of the rule to determine whether the condition changed.
Set reevaluateFlag to Y only if you must periodically evaluate your rule. If you set it to Y, then carefully consider
the interval you use for waitDateTime. For example, if you set getAdjustedDate to refresh every minute, then
reevaluateFlag will cause the rule to run the IF statement every minute until it evaluates the condition in the IF
statement to True.
For details about using dates, see the Guidelines for Pausing Orchestration Processes topic.
1127
Oracle SCM Cloud Chapter 6
Implementing Order Management Orchestrate Fulfillment
Note.
Fline.requestShipDate.date If the requestShipDate is less than the scheduleShipDate on the fulfillment line, then continue
less than to pause.
Fline.scheduleShipDate.date
1128
Oracle SCM Cloud Chapter 6
Implementing Order Management Orchestrate Fulfillment
Fline.requestArrivalDate.date If the requestArrivalDate is less than the scheduleArrivalDate on the fulfillment line, then
less than continue to pause.
Fline.scheduleArrivalDate.date
You can also add a condition to handle the situation where the warehouse is in a different time zone, which might result
in the schedule ship date occurring one day later than the requested ship date.
Related Topics
• Overview of Using Business Rules With Order Management
• Before 1:10:10 PM. Pause all fulfillment lines until 1:10:10 PM of the current day, then release them.
• On or after 1:10:10 PM. Pause all fulfillment lines until 1:10:10 PM of the next day, then release them.
1129
Oracle SCM Cloud Chapter 6
Implementing Order Management Orchestrate Fulfillment
Note.
Code Description
Header is a Declare the Header variable, then store attributes of the order header that the orchestration
DOOSeededOrchestrationRules.DOOHeader
process is currently processing into this variable.
1130
Oracle SCM Cloud Chapter 6
Implementing Order Management Orchestrate Fulfillment
Code Description
currentdate is a Declare the currentdate variable, then store the current time stamp from the Oracle server
DOOSeededOrchestrationRules.Timestamp
into this variable.
Assign new Create a new variable named SAC and set it to the SacResult type in the
DooSeededOrchestrationRules.SacResult
DooSeededOrchestrationRules method.
SAC = new
DooSeededOrchestrationRules.SacResult()
Assign Header.sacResult = Set the value of the sacResult object on the order header to the value that SAC contains.
SAC
Assign new Declare the cdate variable and set its value to the current system time stamp of the Oracle
DooSeededOrchestrationRules.Timestamp
server.
cdate = Header.current_date
Assign cdate.hours = 13 Set the hours of the cdate variable to 1PM in the time zone of the Oracle server.
Assign Store the value of the cdate variable in the waitDateTime parameter of the sacResult object on
Header.sacResult.waitDateTime the order header.
= cdate
If cdate.before(currentdate) If the value in the cdate attribute occurs before the value of the currentdate attribute.
is true
The getAdjustedDate function adds the value of the second parameter as the number of days
to the first parameter, which is cdate.
Assign Store the value of the cdate variable in the waitDateTime parameter of the sacResult object on
Header.sacResult.waitDateTime the order header.
= cdate
1131
Oracle SCM Cloud Chapter 6
Implementing Order Management Orchestrate Fulfillment
If cdate.before(currentdate) cdate contains 13:10:10 and currentdate contains 12:00:00, so the condition evaluates to
is true false.
The rule doesn't proceed to the Then clause of this If statement. Instead, the rule pauses all
fulfillment lines until 13:10:10 PM of the current day, then releases them.
1132
Oracle SCM Cloud Chapter 6
Implementing Order Management Orchestrate Fulfillment
If cdate.before(currentdate) cdate contains 13:10:10 and currentdate contains 14:00:00, so the condition evaluates to
is true True.
Related Topics
• Overview of Using Business Rules With Order Management
Rule Description
Pause Until Quote Expires Pause task that expires on the date and time that the expire quote segment specifies. This
segment resides in the Quote context of an extensible flexfield. If Pause Until Quote Expires
expires, then it will override Pause for 90 Days.
1133
Oracle SCM Cloud Chapter 6
Implementing Order Management Orchestrate Fulfillment
First Rule
Here's the first rule.
Note.
Code Description
Priority equals High Make sure you run this rule before you run any other rule.
1134
Oracle SCM Cloud Chapter 6
Implementing Order Management Orchestrate Fulfillment
Code Description
Header is a Declare the Header variable, then load values into Header from the DOOHeader object of the
DooSeededOrchestrationRules.DOOHeader
DooSeededOrchestrationRules method. DOOHeader contains order header attributes and their
and values.
This If statement doesn't include conditional logic because we must run the rule in all
conditions.
DooSeededOrchestrationRules.SacResult
Create a new instance of the SAC variable, set it to the SacResult type in the
SAC new DooSeededOrchestrationRules method.
DooSeededOrchestrationRules.SacResult()
header.sacResult = SAC Set the value of the sacResult object on the order header to the value that SAC contains.
header.sacResult.waitDateTime Get the current date, add 90 days to it, and store the result in the waitDateTime parameter of
= the sacResult object on the order header. The rule won't release the pause until waitDateTime
header.GetAdjustedDate(null,90) occurs.
GetAdjustedDate Function
Here are the parameters that you can use with the GetAdjustedDate function.
• First parameter. A date, a date variable, or leave it empty for current date.
• Second parameter. Number of days. Use a whole number or a fraction, such as 0.5 for 12 hours.
GetAdjustedDate adds the number of days to the first parameter, then returns the result as date and time.
Format Example
1135
Oracle SCM Cloud Chapter 6
Implementing Order Management Orchestrate Fulfillment
Second Rule
Here's the If statement for the second rule.
Note.
Code Description
Priority equals Medium Make sure you run this rule after you run the Pause for 90 Days rule.
1136
Oracle SCM Cloud Chapter 6
Implementing Order Management Orchestrate Fulfillment
Code Description
If equals True If all conditions in the If statement are true, then override the Pause for 90 Days rule.
Header is a Declare the Header variable, then load values into Header from the DOOHeader object of the
DooSeededOrchestrationRules.DOOHeader
DooSeededOrchestrationRules method.
and
Fline is a Declare the Fline (fulfillment line) variable, then load values into Fline from the DOOFline object
DooSeededOrchestrationRules.DOOFline
of the DooSeededOrchestrationRules method.
and
DOOFline (Distributed Order Orchestration Fulfillment Line) contains fulfillment line attributes
and their values.
header.childFLines Declare the fline variable into the rules language (RL) dictionary, then set the value of fline to
RL.contains fline the value that childFLines contains.
This condition makes sure that the fline variable contains a child fulfillment line of the parent
sales order that the orchestration process instance is processing. It also makes sure you
correctly declare the variable into the dictionary.
flineEFF is a Declare the flineEFF variable, then store the value of object FlexContext into this variable.
DOOSeededOrchestrationRules.FlexContext
flineEFF isn't null Proceed to the next AND only if the flineEFF variable contains a value.
fline.flexContexts contains Proceed to the next AND only if flineEFF references an extensible flexfield on the fulfillment
flineEFF line.
flineEFF.context isn't null Proceed to the next AND only if the context contains a value.
flineEFF.context equals Proceed to the next AND only if context equals the string Quote.
ignore case "Quote"
flineEFF.getFlexAttributeDateValue("quoteexpiration")
Proceed to the THEN statement only if the Order Entry Specialist enters a value in the flexfield.
isn't null
1137
Oracle SCM Cloud Chapter 6
Implementing Order Management Orchestrate Fulfillment
Note.
Code Description
This rule doesn't evaluate according to a timer. Instead, it waits until the quote expiration date
occurs, so reevaluate isn't necessary.
If the user submits a revision that includes a new value for the date, then the rule reevaluates
the date and time, and sets this new time as part of compensation.
header.sacResult.waitDateTime Set the waitDateTime variable of the sacResult rule set on the order header to the value that
= the Order Entry Specialist entered into the flexfield.
flineEFF.getFlexAttributeDateValue("quoteexpiration")
For details about using business rules with extensible flexfields, see the Overview of Setting Up Extensible Flexfields in
Order Management topic.
1138
Oracle SCM Cloud Chapter 6
Implementing Order Management Orchestrate Fulfillment
Related Topics
• Overview of Using Business Rules With Order Management
1139
Oracle SCM Cloud Chapter 6
Implementing Order Management Orchestrate Fulfillment
Attribute Value
1140
Oracle SCM Cloud Chapter 6
Implementing Order Management Orchestrate Fulfillment
Follow the instructions in section Define the Orchestration Process Steps of topic Pause Orchestration
Processes Until an Event Occurs.
Create If Statement
Create the If statement that determines whether the source system is Legacy.
1141
Oracle SCM Cloud Chapter 6
Implementing Order Management Orchestrate Fulfillment
◦ Set values.
Attribute Value
Description If source system is Legacy, then release pause on ShipDate minus two.
◦ Immediately under the left field that contains the value Line, click down arrow > Simple Test.
◦ Click Left Value.
◦ In the Condition Browser, expand Header.
Notice that the list displays order header attributes that you can use to specify which attribute to
examine. For this example, this If statement creates a filter that causes the rule to only consider source
orders where the Source Order System attribute contains a value of LEG, where LEG is an abbreviation for
the term legacy.
◦ Click sourceOrderSystem > OK.
◦ In the Right Value attribute, enter "LEG".
1142
Oracle SCM Cloud Chapter 6
Implementing Order Management Orchestrate Fulfillment
1143
Oracle SCM Cloud Chapter 6
Implementing Order Management Orchestrate Fulfillment
This value calculates the number of milliseconds so the pause task ends two days before the
orchestration process schedules the order lines for shipping.
For example.
1144
Oracle SCM Cloud Chapter 6
Implementing Order Management Orchestrate Fulfillment
◦ Make sure the Properties dialog includes the value in the time property.
◦ Click OK.
4. Pause the orchestration process.
( reevaluateFlag:"N", sacType:DooSeededOrchestrationRules.SacResult.SAC_TYPE_TIMER,
waitDateTime:DateTime )
A pause type of TIMER causes the orchestration process to pause until time elapses.
◦ In the Properties dialog, in the waitDateTime row, click Value.
1145
Oracle SCM Cloud Chapter 6
Implementing Order Management Orchestrate Fulfillment
Related Topics
• Overview of Using Business Rules With Order Management
1146
Oracle SCM Cloud Chapter 6
Implementing Order Management Orchestrate Fulfillment
Note.
• Assume the application sets paymentTermId to 1 when it requires the orchestration process to pause and makes
sure you received payment from your customer.
• Most orchestration processes process one fulfillment line at a time when they pause according to time or an
event. If you pause according to time or event, then, to filter fulfillment lines, use one of these codes.
Code Description
Header.childFLines Reference the fulfillment line that the orchestration process is processing.
Header.allFLinesInTheOrder References all fulfillment lines in the sales order that the orchestration process is processing.
1147
Oracle SCM Cloud Chapter 6
Implementing Order Management Orchestrate Fulfillment
• Use isn't null. If your rule examines an attribute that doesn't contain a value, then your rule might fail with
results you can't predict.
• Use Assign. If you use Assert New, then the rule creates more than one instance, and it might fail with results
you can't predict.
• If you use Assign New for a rule in a pause rule set, then you must set priority for the Assign New rule to
Highest, and make sure no other rule in the set is Highest.
If a sales order includes a large number of fulfillment lines, and if you must pause according to a dependency, then
don't use SAC_SYSTEM_EVENT_IPC_PAUSE. Instead, set up a rule that uses SAC_TYPE_TIMER, and that examines all
fulfillment lines but only after some time elapses. Specify an appropriate interval. For example, if you determine that
1148
Oracle SCM Cloud Chapter 6
Implementing Order Management Orchestrate Fulfillment
most fulfillment lines on a large sales order ship within six hours, and you only need to invoice one time every 12 hours,
then use an interval of eight hours.
• Use this set up in an orchestration process that does billing for your coverages where one orchestration process
instance processes the covered item and another instance processes the coverage item.
1149
Oracle SCM Cloud Chapter 6
Implementing Order Management Orchestrate Fulfillment
• Add this pause task on an orchestration process step before the step that does the invoicing task.
• This rule automatically releases the pause for the coverage item when fulfillment ships the covered item.
1150
Oracle SCM Cloud Chapter 6
Implementing Order Management Orchestrate Fulfillment
1 Schedule Schedule
1151
Oracle SCM Cloud Chapter 6
Implementing Order Management Orchestrate Fulfillment
2 Reservation Reserve
6 Invoice Invoice
1152
Oracle SCM Cloud Chapter 6
Implementing Order Management Orchestrate Fulfillment
Note.
Code Description
At least one Use this test to determine whether at least one fulfillment line in the sales order hasn't
shipped. It asks the question.
• Is there any order line in the sales order that's still on the Wait for Delivery task?
If an order line is still doing the Wait for Delivery task, then it means there's at least one order
line that Shipping hasn't delivered, and we must continue to pause before proceeding to the
next orchestration process step.
1153
Oracle SCM Cloud Chapter 6
Implementing Order Management Orchestrate Fulfillment
Code Description
Wait for Delivery is an example value. You can use whatever type of pause you need while
waiting for an action to happen, then move to the next the pause while you wait for billing.
taskInstance is a Declare the taskInstance variable, then store attributes of the task instance that the
DOOSeededOrchestrationRules.DOOTaskInstance
orchestration process is currently processing into this variable.
DOOTaskInstance gets all the task instances for all instances of the orchestration process that
are currently running for all order lines on the sales order.
For example, if three task instances are currently running for three order lines, then
DOOTaskInstance gets all three task instances.
taskInstance.taskName equals taskName identifies the value that you enter for the Task Name attribute on the orchestration
ignore case "Wait for process step. In this example, you entered Wait for Delivery as the Task Name on step 4.
Delivery"
Step 4 is the pause step that determines whether any order lines are still waiting for delivery.
taskInstance.actualCompletionDate
Examine the value of the actualCompletionDate attribute in the taskInstance variable. If
is null it doesn't contain a value, then it means Shipping hasn't delivered the item, and we must
continue to pause.
Header is a Declare the Header variable, then store attributes of the order header that the orchestration
DOOSeededOrchestrationRules.DOOHeader
process is currently processing into this variable.
Assign Pause the orchestration process until an interprocess communication event occurs.
Header.sacResult.sacType =
DooSeededOrchestrationRules.SacResult.SAC_TYPE_EVENT
Assign Use an interprocess communication (IPC) to pause according to an event across orchestration
Header.sacResult.eventName = processes. Use it to revaluate the pause every time any task finishes for any line in the sales
DooSeededOrchestrationRules.SacResult.SAC_SYSTEM_EVENT_IPC_PAUSE
order.
• Pause the nonshippable lines in a sales order until Shipping finishes shipping all shippable lines in the order.
• Automatically release the pause for the nonshippable lines, then proceed to the next step in the orchestration
process.
1154
Oracle SCM Cloud Chapter 6
Implementing Order Management Orchestrate Fulfillment
A subsequent step in the orchestration process can now send all order lines of the sales order to invoicing
together.
Add your pause task after the shipping task and before the invoicing task in your orchestration process. For example,
orchestration waits until Shipping ships all shippable lines so it can send all lines in the sales order - shippable lines and
nonshippable lines - before proceeding to invoicing.
Note.
1155
Oracle SCM Cloud Chapter 6
Implementing Order Management Orchestrate Fulfillment
Code Description
At least one Use this test to determine whether at least one fulfillment line in the sales order hasn't
shipped. It asks the question.
• Is there any shippable line in the sales order that has an actual ship date that's empty?
If the actual ship date is empty, it means there's at least one shippable line that hasn't shipped,
and we must continue to pause before proceeding to the next orchestration process step.
As an alternative, use There is no case where to pause nonshippable lines until Shipping
ships at least one shippable line.
FLine is a Declare the FLine variable, then store attributes of the fulfillment line that the orchestration
DOOSeededOrchestrationRules.DOOFLine
process is currently processing into this variable.
header.allFLinesInTheOrder Declare allFLinesInTheOrder into the rules language (RL) dictionary, then set the value of
RL.contains FLine allFLinesInTheOrder to the value that FLine contains.
This condition makes sure allFLinesInTheOrder references a fulfillment line that the
orchestration process is processing. It also makes sure you correctly declare the variable into
the dictionary.
You use it to examine all lines in the sales order, not only the line the current orchestration
process instance is processing.
FLine.shippableFlag is "Y" We are only looking at fulfillment lines that are shippable.
FLine.actualShipDate is null Skip lines that don't have an actual ship date.
Assign Pause the orchestration process until an interprocess communication event occurs.
Header.sacResult.sacType =
DooSeededOrchestrationRules.SacResult.SAC_TYPE_EVENT
Assign Use an interprocess communication (IPC) to pause according to an event across orchestration
Header.sacResult.eventName = processes. Use it to revaluate the pause every time any task finishes for any line in the sales
DooSeededOrchestrationRules.SacResult.SAC_SYSTEM_EVENT_IPC_PAUSE
order.
Pause Nonshippable Lines Until Shipping Ships At Least One Shippable Line
Here's what the rule does.
• Pause nonshippable lines until Shipping ships at least one of the shippable lines in the sales order.
• Send all nonshippable lines to invoicing as soon Shipping ships the first shippable line.
1156
Oracle SCM Cloud Chapter 6
Implementing Order Management Orchestrate Fulfillment
• If the sales order doesn't have any shippable lines, then proceed immediately to the next orchestration process
step. There's no need to pause if no line are shippable.
1157
Oracle SCM Cloud Chapter 6
Implementing Order Management Orchestrate Fulfillment
Note.
Code Description
At least one Use this test to determine whether at least one fulfillment line in the sales order is shippable.
ShippableFLine is a Declare the ShippableFLine variable, then store attributes of the fulfillment line that the
DOOSeededOrchestrationRules.DOOFLine
orchestration process is currently processing into this variable.
header.allFLinesInTheOrder Declare allFLinesInTheOrder into the rules language (RL) dictionary, then set the value of
RL.contains ShippableFLine allFLinesInTheOrder to the value that ShippableFLine contains.
This condition makes sure allFLinesInTheOrder references a fulfillment line that the
orchestration process is processing. It also makes sure you correctly declare the variable into
the dictionary.
You use it to examine all lines in the sales order, not only the line the current orchestration
process instance is processing.
None If none of the lines are shippable, proceed immediately to next orchestration process step.
You create a separate variable, NotShippableFLine, for the None clause so its independent of
the ShippableFLine variable from the At Lease One clause.
Header.allFLinesInTheOrder Make sure allFLinesInTheOrder references a fulfillment line that the orchestration process is
RL.contains processing.
NotShippableFLine
1158
Oracle SCM Cloud Chapter 6
Implementing Order Management Orchestrate Fulfillment
Code Description
Examine all lines in the sales order, not only the line the current orchestration process instance
is processing.
To account for the condition, you add the pause task on an orchestration step that happens after a step that does a
shipping task and before a step that does an invoicing task.
• Pause nonshippable lines until Inventory Management receives at least one shippable line in the sales orders.
• Automatically release the paused, nonshippable lines, then proceed to the next orchestration process step.
1159
Oracle SCM Cloud Chapter 6
Implementing Order Management Orchestrate Fulfillment
The orchestration process can now send the nonshippable lines and the shippable lines on the order to
invoicing together.
Note.
Code Description
At least one Use this test to determine whether at least one fulfillment line in the sales order is shippable.
1160
Oracle SCM Cloud Chapter 6
Implementing Order Management Orchestrate Fulfillment
Code Description
FLineS is a Declare the FLineS variable, then store attributes of the fulfillment line that the orchestration
DOOSeededOrchestrationRules.DOOFLine
process is currently processing into this variable.
You can use whatever name you like for the variable. We're using FLineS to distinguish it from
the FLine variable that use in other examples in this topic.
header.allFLinesInTheOrder Declare allFLinesInTheOrder into the rules language (RL) dictionary, then set the value of
RL.contains FLineS FLineS to the value that FLineS contains.
This condition makes sure allFLinesInTheOrder references a fulfillment line that the
orchestration process is processing. It also makes sure you correctly declare the variable into
the dictionary.
You use it to examine all lines in the sales order, not only the line the current orchestration
process instance is processing.
FLineS.shippableFlag is "Y" We are only looking at fulfillment lines that are shippable.
None If none of the lines are shippable, proceed immediately to the next orchestration process step.
You create a separate variable, FLine, for the None clause so its independent of the FLineS
variable from the At Lease One clause.
Header.allFLinesInTheOrder Make sure allFLinesInTheOrder references a fulfillment line that the orchestration process is
RL.contains FLine processing.
Examine all lines in the sales order, not only the line the current orchestration process instance
is processing.
FLine.actualShipDate isn't Skip lines that don't have an actual ship date.
null
FLine.shippableFlag is "Y" We are only looking at fulfillment lines that are shippable.
1161
Oracle SCM Cloud Chapter 6
Implementing Order Management Orchestrate Fulfillment
• Pause nonshippable lines until Inventory Management receives all shippable lines in the sales orders.
• Wait for Inventory Management to receive all shippable lines.
• Automatically release the paused, nonshippable lines, then proceed to the next orchestration process step.
The orchestration process can now send the nonshippable lines and the return lines on the order to invoicing
together.
1162
Oracle SCM Cloud Chapter 6
Implementing Order Management Orchestrate Fulfillment
Note.
Code Description
At least one Use this test to determine whether at least one fulfillment line in the sales order is shippable
and whether fulfillment has successfully returned the line.
FLine is a Declare the FLine variable, then store attributes of the fulfillment line that the orchestration
DOOSeededOrchestrationRules.DOOFLine
process is currently processing into this variable.
header.allFLinesInTheOrder Declare allFLinesInTheOrder into the rules language (RL) dictionary, then set the value of
RL.contains ShippableFLine allFLinesInTheOrder to the value that FLine contains.
FLine.shippableFlag is "Y" We are only looking at fulfillment lines that are shippable.
FLine.rmaDeliveredQty is rmaDeliveredQty is the quantity on the return line that fulfillment has delivered to inventory.
null If it has no value or is zero, then it means fulfillment hasn't successfully returned the line into
inventory.
FLine.rmaDeliveredQty is 0
FLine.orderedQty isn't 0 Fulfillment sets orderedQty to zero when it cancels the line. This condition makes sure we only
consider lines that aren't canceled.
FLine.CategoryCode is Only consider return lines. Skip lines that aren't return lines.
"RETURN"
Pause Shipped Lines of a Kit Until Shipping Ships All of the Lines
Assume you order a kit that has a quantity of more than one, such as 10. All of the lines aren't available in inventory, so
fulfillment splits some lines and ships part of the kit while it waits for the factory to replenish inventory. You don't want
to send the shipped lines to invoicing by themselves. You need to wait until fulfillment ships all of the quantity for the
kit.
1163
Oracle SCM Cloud Chapter 6
Implementing Order Management Orchestrate Fulfillment
• Pause the shipped lines until fulfillment successfully fulfills all lines for the kit.
• Automatically release the paused lines, then proceed to the next orchestration process step.
The orchestration process can now send all lines for the kit to invoicing together.
1164
Oracle SCM Cloud Chapter 6
Implementing Order Management Orchestrate Fulfillment
Note.
Code Description
FLine is a Declare the FLine variable, then store attributes of the fulfillment lines that the orchestration
DOOSeededOrchestrationRules.DOOFLine
process is currently processing into this variable.
header.childFLines Declare the childFLines attribute into the rules language (RL) dictionary, then set the value of
RL.contains FLine childFLines to the value that FLine contains.
FLine.itemSubTypeCode Only get fulfillment lines that are part of a kit. Skip all other lines.
contains "KIT"
At least one Use this test to determine whether fulfillment split at least one fulfillment line in the kit.
allFLines is a Declare the allFLines variable, then store attributes of the fulfillment line that the orchestration
DOOSeededOrchestrationRules.DOOFLine
process is currently processing into this variable. We will cycle through all the lines.
header.allFLinesInTheOrder Declare allFLinesInTheOrder into the rules language (RL) dictionary, then set the value of
RL.contains allFLines allFLinesInTheOrder to the value that allFLines contains.
allFLines.fulfillLineId If fulfillment ships part of a kit, then it splits the lines in the kit, ships some lines and doesn't
isn't FLine.fulfillLineId ship others. Let's see whether fulfillment split the lines in the kit.
If the fulfillLineId attribute in the allFLines attribute doesn't equal the fulfillLineId attribute
in the FLine variable, and if the lineId attribute in the allFLines attribute does equal the lineId
attribute in the FLine variable, then we can see that fulfillment didn't split the line that we are
currently examining.
1165
Oracle SCM Cloud Chapter 6
Implementing Order Management Orchestrate Fulfillment
Code Description
How do we know? The fulfillLineId identifies the fulfillment line that contains the kit.
Fulfillment must maintain the relationship between the kit's fulfillment line and new lines that
it creates when it splits a kit. So fulfillment assigns the lineId of each new line that it creates to
the value of the fulfillLineId.
FLine.orderedQty isn't 0 Fulfillment sets orderedQty to zero when it cancels the line. This condition makes sure we only
consider lines that aren't canceled.
• Automatically releases the pause for the nonshippable lines that are part of a group as soon as Shipping
finishes shipping the shippable lines.
• Uses an extensible flexfield to allow the Order Entry Specialist to specify which lines are part of the group.
You can use the same Then statement that you use in the Pause Nonshippable Lines Until Shipping Ships Shippable
Lines example, but the If statement is different. Add the pause task so it happens between the shipping task and
invoicing task in your orchestration process.
1166
Oracle SCM Cloud Chapter 6
Implementing Order Management Orchestrate Fulfillment
Note.
Code Description
currentFline is a Declare the currentFline variable, then store attributes of the fulfillment line that the
DOOSeededOrchestrationRules.DOOFLine
orchestration process is currently processing into this variable.
1167
Oracle SCM Cloud Chapter 6
Implementing Order Management Orchestrate Fulfillment
Code Description
header.childFLines Declare currentFline into the rules language (RL) dictionary, then set the value of currentFline
RL.contains currentFline to the value that childFLines contains.
This condition makes sure currentFline references a fulfillment line that the orchestration
process is processing. It also makes sure you correctly declare the variable into the dictionary.
header.allFLinesInTheOrder Declare the allFlines variable into the rules language dictionary, and set the value of allFlines to
RL.contains allFlines the value that allFLinesInTheOrder contains.
This condition makes sure you correctly declare the variable into the dictionary.
currentFline.flexContexts Declare currentFlineEFF into the rules language dictionary, and set the value of
RL.contains currentFlineEFF currentFlineEFF to the value that flexContexts contains.
This condition makes sure you correctly declare the variable into the dictionary.
flexContexts is a list of context rows for the extensible flexfield. FlexContext is a type of row or
variable.
1168
Oracle SCM Cloud Chapter 6
Implementing Order Management Orchestrate Fulfillment
Note that the FulfillLineContext1 extensible flexfield context and the FL1AttributeChar1 segment are one group.
1169
Oracle SCM Cloud Chapter 6
Implementing Order Management Orchestrate Fulfillment
Assume the sales order contains 10 fulfillment lines and you must group them into two sets of five lines each. You can
use.
• FulfillLineContext1 and FL1AttributeChar1 to set up GROUP1 so it contains the first five lines
• FulfillLineContext2 and FL1AttributeChar2 to set up GROUP2 so it contains the last five lines
Code Description
allFlineEFF is a Declare the allFlineEFF variable, and store the value of object FlexContext into this variable.
DOOSeededOrchestrationRules.FlexContext
FLATTR = "FL1AttributeChar1" Declare variable FLATTR (flexfield attribute), and set it to FL1AttributeChar1.
You reference the FL1AttributeChar1 extensible flexfield attribute in more than one location in
this rule. For efficiency, and to avoid problems because of typographical errors, you can declare
FLATTR one time, set it to FL1AttributeChar1, and then reference FLATTR instead of declaring
FL1AttributeChar1 more than one time.
currentFline.fulfillLineId Proceed to the next AND only if the fulfillLineId attribute in the currentFline variable and the
isn't fulfillLineId attribute in the allFlines variable doesn't reference the same fulfillment line.
allFlines.fulfillLineId
equals ignore case specifies to ignore the case sensitivity of the FulfillLineContext1 string.
This condition avoids the situation where your deployment might use some other case for this
attribute.
currentFlineEFF.getFlexAttributeValue.
Use the getFlexAttributeValue method to get the value of the FL1AttributeChar1 attribute from
(FLATTR) isn't null the extensible flexfield on the current fulfillment line.
currentFlineEFF.getFlexAttributeValue.
Use the getFlexAttributeValue method to get the value of the FL1AttributeChar1 attribute from
(FLATTR) isn't null the extensible flexfield on the current fulfillment line.
1170
Oracle SCM Cloud Chapter 6
Implementing Order Management Orchestrate Fulfillment
Code Description
allFlineEFF.getFlexAttributeValue.
Get the value of the FL1AttributeChar1 attribute from allFlineEFF.
(FLATTR) isn't null
currentFlineEFF.getFlexAttributeValue.
Proceed to the next AND only if the extensible flexfield attribute contains the same value on
(FLATTR) is the current line and on all lines.
allFlineEFF.getFlexAttributeValue.
(FLATTR)
This condition makes sure these fulfillment lines are part of the same group.
Related Topics
• Manage Order Management Parameters
• Manage Order Attributes That Identify Change
• Use Business Rules in Orchestration Processes
1171
Oracle SCM Cloud Chapter 6
Implementing Order Management Orchestrate Fulfillment
Attribute Value
Try it.
1172
Oracle SCM Cloud Chapter 6
Implementing Order Management Orchestrate Fulfillment
Attribute Value
Task Schedule
◦ Create Reservation
◦ Create Shipment
◦ Wait for Shipment Advice
◦ Create Invoice
◦ Wait for Invoice
Note.
For example, for the Create Reservation step, set these values.
Attribute Value
Task Reserve
◦Make sure you set the Exit Criteria attribute for each wait step. For example, set Exit Criteria for the Wait
for Shipment Advice step to Shipped.
4. Add the pause step. Click the Create Reservation step, click Add Row, set values in the new row, then click Save.
Attribute Value
1173
Oracle SCM Cloud Chapter 6
Implementing Order Management Orchestrate Fulfillment
Attribute Value
Task Pause
where
• DOOFLine is a function in the DooSeededOrchestrationRules dictionary.
• DOO is an abbreviation for distributed order orchestration, which is an earlier name for order orchestration.
• FLine is an abbreviation for fulfillment line.
• demandClassCode is a fulfillment line attribute. This attribute stores the customer class, such as Gold, Silver, or
Bronze.
• isn't determines whether demandClassCode contains Gold.
• For details about these values, see the Guidelines for Pausing Orchestration Processes topic.
1174
Oracle SCM Cloud Chapter 6
Implementing Order Management Orchestrate Fulfillment
◦ On the Pause step, in the Pause Rule column, click Click for Rule.
◦ In the Start After Condition dialog, click Add Rule, then replace Rule 1 with Pause for Gold Customers.
◦ On the test you just added, to the far right, click the down arrow, then click Simple Test.
◦ On the new line that displays, click Left Value.
◦ In the Condition Browser, expand FLine.
Notice that each value under FLine references a fulfillment line attribute.
◦ Click demandClassCode, then click OK
◦ Change Is to Isn't.
◦ Click Right Value.
◦ In the Condition Browser, click null, then click OK.
5. Determine whether the customer is Gold.
◦ On the test you just added, to the far right, click the down arrow, then click Simple Test.
◦ On the new line that displays, click Left Value.
◦ In the Condition Browser, expand FLine.
◦ Click demandClassCode, then click OK.
◦ In the Right Value window, enter "Gold".
1175
Oracle SCM Cloud Chapter 6
Implementing Order Management Orchestrate Fulfillment
For brevity, this screen print doesn't include the entire value for the event.
( eventName:"Gold Preorders",
reevaluateFlag:"N",sacType:DooSeededOrchestrationRules.SacResult.SAC_TYPE_EVENT )
where
◦ eventName is a variable that you can use to help track the status of the pause task. The Order
Management work area uses the text you enter wherever it displays status details, such as in the Gantt
1176
Oracle SCM Cloud Chapter 6
Implementing Order Management Orchestrate Fulfillment
chart on tab Orchestration Plan of page Orchestration Process that the user can access from page
Manage Orchestration Process. This example specifies to use event Gold Preorders.
◦ reevaluateFlag:"N" specifies not to evaluate this rule again.
◦ A pause type of EVENT causes the orchestration process to pause until an event occurs.
◦ An attribute on a scheduled process references this event, but you can also use it with a web service. You
can also use other parameters to release a pause task. This event isn't related to the events that the event
framework in Oracle Middleware uses.
◦ You must include double quotation marks ( " " ).
4. Click Save.
1177
Oracle SCM Cloud Chapter 6
Implementing Order Management Orchestrate Fulfillment
Try it.
1. On the Pause step, in the Pause Rule column, click Click for Rule.
2. In the Pause Rule Set dialog, in the check box to the left of Pause for Gold Customers, add a check mark.
3. Click Cut > Paste.
4. Scroll down to the bottom of the dialog and notice the rule that the paste added.
5. Make these changes to this new rule.
1178
Oracle SCM Cloud Chapter 6
Implementing Order Management Orchestrate Fulfillment
Pause for Gold Customers Skip Customers Who Are Not Gold
Start after condition IMMEDIATE ends the pause task and allows the orchestration process to
continue to the next step.
6. Click Save.
7. On the Edit Orchestration Process Definition page, click Save.
1179
Oracle SCM Cloud Chapter 6
Implementing Order Management Orchestrate Fulfillment
Note.
• The Pause step references the pause task. The Pause step resides between the Shipping step and the Invoicing
step in the orchestration process.
• If no fulfillment line meets any condition in the IF statement, then all fulfillment lines have shipped, the rule
releases the pause, and the flow continues to the next orchestration process step.
1180
Oracle SCM Cloud Chapter 6
Implementing Order Management Orchestrate Fulfillment
Note.
Code Description
Header is a Declare the Header variable, then load values into Header from object DOOHeader of method
DooSeededOrchestrationRules.DOOHeader
DooSeededOrchestrationRules.
At least one Ask a question. Does the sales order include at least one fulfillment line that order fulfillment
hasn't shipped, and that order fulfillment can ship?
Fline is a Declare variable Fline (fulfillment line), then load values into Fline from object DOOFline of
DooSeededOrchestrationRules.DOOFline
method DooSeededOrchestrationRules.
and
DOOFline (Distributed Order Orchestration Fulfillment Line) contains fulfillment line attributes
and their values.
Header.allFLinesinTheOrder Examine all fulfillment lines in the sales order, including lines that the orchestration process
isn't currently processing.
A dependency might exist between the fulfillment line that the orchestration process is
currently processing, and other fulfillment lines in the sales order, so you must inspect all of
them.
Fline.shippableFlag is "Y" If the shippableFlag attribute on the fulfillment line is Y, then proceed.
Make sure each fulfillment line is shippable. Some items can't ship, such as a subscription. If a
fulfillment line contains a subscription, then shippableFlag is N for the line, the rule ignores the
line, and moves to the next line.
Fline.actualShipDate is null If the actualShipDate attribute on the fulfillment line doesn't contain a value, then it indicates
the fulfillment line hasn't shipped, and the rule must pause the orchestration process.
Fline.orderedQty more than 0 If the orderedQty attribute on the fulfillment line is 0, then it indicates the fulfillment line is a
canceled line, the rule ignores the line, and moves to the next line.
The rule evaluates this type of pause each time a task finishes for each fulfillment line.
reevaluateFlag = Y Evaluate the condition each time an orchestration process step finishes.
In this example, the Shipping step ships the fulfillment lines, so the rule must evaluate after the
Shipping step finishes for each fulfillment line to determine whether order fulfillment shipped
all fulfillment lines.
1181
Oracle SCM Cloud Chapter 6
Implementing Order Management Orchestrate Fulfillment
Related Topics
• Manage Order Management Parameters
• Manage Order Attributes That Identify Change
• Use Business Rules in Orchestration Processes
Assume that the orchestration process must get the books from different warehouses.
• Fulfillment line 1 gets 80 books from the Seattle warehouse
• Fulfillment line 2 gets 400 books from the Denver warehouse
• Fulfillment line 3 gets 120 books from the Chicago warehouse
You set up an orchestration process that processes the fulfillment lines, pauses until fulfillment shipped all lines,
resumes processing, then sends the lines to billing.
◦ Schedule
◦ Reserve
◦ Ship
◦ Wait for Shipment
◦ Pause
◦ Invoice
◦ Wait for Billing
1182
Oracle SCM Cloud Chapter 6
Implementing Order Management Orchestrate Fulfillment
Note.
Code Description
DooSeededOrchestrationRules A dictionary that contains predefined rules you can use in your business rule.
DOOHeader An object in the DooSeededOrchestrationRules dictionary that stores details about the sales
order header.
Assign New Assign DOOHeader as a new object in the DooSeededOrchestrationRules dictionary. This
assignment makes the object available throughout your rule.
SacResult A rule set in the DooSeededOrchestrationRules dictionary. It contains events and variables you
can use to specify how to handle the result of a start after condition.
SAC A value you can set for SacResult. sac is an abbreviation for start after condition.
sacType A property of SacResult. sacType stores the value that the rule uses to determine whether to
pause the orchestration process or release it.
SAC_TYPE_IMMEDIATE A value of sacType. If sacType contains IMMEDIATE, then the rule will immediately release the
pause task.
1183
Oracle SCM Cloud Chapter 6
Implementing Order Management Orchestrate Fulfillment
Code Description
1. On the Pause step, in the Pause Rule column, click Add Rule.
In the Start After Condition dialog, click Add Rule > Expand > Show Advanced Settings, then set values.
Attribute Value
Description Default rule that pauses orchestration process until a dependency resolves.
Priority Highest
If you remove the test, then the rule always applies the actions that the Then area contains.
5. In the Then area, click Add Action, then click Assign New.
6. Click Select a Target, then click DooSeededOrchestrationRules.SacResult.
7. In the field to the left of the equal sign (=), enter SAC.
8. In the field to the right of the equal sign (=), click Expression Value.
9. In the Condition Browser dialog, expand DooSeededOrchestrationRules, expand SacResult, click New, then
click OK.
10. Click Add Action > Assign.
11. Click Select a Target, then click Header.sacResult.
12. In the field to the right of the equal sign (=), enter SAC.
13. Click Add Action > Assign.
14. Click Select a Target, then click Header.sacResult.sacType.
15. In the field to the right of the equal sign (=), click Expression Value.
16. In the Condition Browser dialog, expand DooSeededOrchestrationRules, expand SacResult, click
SAC_TYPE_IMMEDIATE, and then click OK.
17. Click Validate, then click Save.
1184
Oracle SCM Cloud Chapter 6
Implementing Order Management Orchestrate Fulfillment
It states that if the actual ship date isn't null on all fulfillment lines, then release the pause task.
1185
Oracle SCM Cloud Chapter 6
Implementing Order Management Orchestrate Fulfillment
where
Code Description
At least one Pause all shipped lines even if the fulfillment system shipped all lines except one line.
FLine is a OrderHeader/ Coordinate across more than one orchestration process when more than one orchestration
allFLinesIntheOrder process processes the fulfillment lines for the sales order.
FLine.actualShipDate is null Determine whether any of the fulfillment lines haven't shipped.
1. On the Pause step, in the Pause Rule column, click Add Rule.
In the Start After Condition dialog, collapse the rule you just created.
2. click Add Rule > Expand > Show Advanced Settings, then set values.
1186
Oracle SCM Cloud Chapter 6
Implementing Order Management Orchestrate Fulfillment
Attribute Value
Priority Medium
For details about these properties, see the Overview of Pausing Orchestration Processes topic.
1187
Oracle SCM Cloud Chapter 6
Implementing Order Management Orchestrate Fulfillment
This step sets up the rule to evaluate fulfillment lines until the flow ships all of them, and then to release them.
Interprocess communication (IPC) implements a pause according to an event.
5. Click the down arrow next to Add Action, then click Assign.
6. Click Select a Target, then click OrderHeader.sacResult.reevaluateFlag.
7. In the field to the right of the equal sign (=), enter "Y".
Hold
Guidelines for Setting Up Holds on Sales Orders
Use these guidelines to help set up a sales order hold.
Type Description
Generic Hold that you apply on any step of an orchestration process. It doesn't apply a hold for a
specific task. You enable Hold All Services when you create the hold code.
Service Hold that you apply on a specific task type and service, such as the Create Billing Lines service
of the Invoice task type. You specify the service when you create the hold code.
System Hold that Order Management automatically applies and releases. Here are some examples.
1188
Oracle SCM Cloud Chapter 6
Implementing Order Management Orchestrate Fulfillment
Note.
• Use the Setup and Maintenance work area to manage hold codes, orchestration processes, and task types.
• Use the hold code to specify the task to hold, such as creating the invoice.
• Specify the service, or specify the task type.
• Set the attributes.
1189
Oracle SCM Cloud Chapter 6
Implementing Order Management Orchestrate Fulfillment
Attribute Description
Applicable Roles Use the Applicable Roles tab to specify who can apply and release the hold, such as the
Order Manager. Note that you can't specify a role for applying a system hold, but you can
specify a role to release a DOO_CreditCheck hold.
Set As an option, use the Set attribute of the hold code to specify the business unit where Order
Management applies the hold. You can also use Set to create a set of hold codes and apply
them all to the same business unit.
Hold Tasks In Progress Order Management automatically enables the Hold Tasks In Progress option when the user
applies it on the Order page in the Order Management work area or when you import a hold.
Disable this option only if you haven't set up your fulfillment system to correctly interpret it.
End Date Don't set the End Date attribute for a predefined, system hold code, such as
HOLD_FOR_CHANGE_REQUEST.
Order Management uses these codes internally. If you set the end date on one, you might
introduce errors in your implementation. Examine the description to determine whether a
predefined hold code is a system hold code. The description usually identifies system holds.
For example, here's the description for HOLD_FOR_CHANGE_REQUEST.
If you set the End Date for a hold code, then you can't apply the hold after the end date
occurs, but you can release the hold after the end date occurs.
If You Don't Enable the Hold All If You Enable the Hold All Services Option
Services Option
The service you specify affects The task type you specify affects each orchestration process step that references the task
each orchestration process step that type.
references the service.
Assume you.
Assume you.
• Add a check mark to Hold All Services for the HOLD CREATE SHIP hold.
• Don't add a check mark to • You leave the Services tab empty.
Hold All Services for the HOLD
CREATE SHIP hold.
• On the services tab, you Your hold affects step 300 and step 400 because these steps reference the Shipment task type.
specify the Create Billing Lines
service. Use this option when you don't any part of the task to run. Let's say you're shipping a highly
flammable, dangerous item. Before shipping, you place a hold to verify the carrier is licensed
Your hold affects only step to handle hazardous material. Enable the Hold All Services option on the shipping task type to
300 of orchestration process make sure no part of shipping runs.
ShipOrderGenericProcess because
step 300 is the only step that
1190
Oracle SCM Cloud Chapter 6
Implementing Order Management Orchestrate Fulfillment
If You Don't Enable the Hold All If You Enable the Hold All Services Option
Services Option
Points to Consider
• Order Management comes with a number of predefined hold codes that hold a variety of task types and
services. Add your own hold code only if the predefined ones don't meet your needs.
• If you don't see the task type and service you need on the Services tab, then use the Manage Task Types page
to specify the tasks and services that you can choose for the hold. You must set the Hold Enabled option to
make the service display on the Services tab. You can't enable some services for hold, such as Billing Response
or Wait for Billing. For details, see the Set Up Task Types for Holds topic.
• Your downstream fulfillment systems can't finish the task until you release the hold.
• Order Management ignores a hold that you apply on a pause task. The pause task will resume according to its
own conditions.
• For a configured item, make sure you apply the hold on the configured item. Don't apply a hold on a configure
option. For details, see the Sales Order Hold topic.
• Save time. You can migrate your hold setups. For details, see the Copy Setups Between Instances of Order
Management topic.
• An orchestration process that references a service that does a Wait operation is a wait step. To determine which
services do a wait operation, go to the Manage Task Types page in the Setup and Maintenance work area,
click the row that includes your task type of interest, such as Shipment, then, in the Details area, examine the
services. Look for services that do a Wait operation.
• If you create a hold code for a long-running task, such as a shipping or invoicing task, then set it up so Order
Management applies it on a wait step.
Using this approach will help to avoid a concurrency problem that happens when the user revises a sales order
while a long-running task is running. Placing the hold on a wait step helps to make sure any actions that were in
process finish before the user can revise the order.
• Apply the hold on the Wait for Shipment service for a shipment task, and the Wait for Billing service for an
invoice task. Each of these services do a wait operation.
1191
Oracle SCM Cloud Chapter 6
Implementing Order Management Orchestrate Fulfillment
If I Apply Hold Here Can I Release it on Create Can I Release It in Fulfillment Can I Release It Through
Order or Revise Order Page View in Order Management Web Service
in Order Management Work Work Area
Area
Create Order or Revise Order Yes Yes Yes, but only if you applied the
Page in Order Management hold on the order header or
Work Area order line.
Fulfillment View Yes, but only if you applied the Yes Yes, but only if you applied the
hold on the order header or hold on the order header.
fulfillment line.
Web Service Yes, but only if you applied the Yes Yes
hold on the order header.
What I Need to Do Job Role You Need to Do It Formal Name of Job Role
Apply, release, or view a hold on a sales Order Entry Specialist or Order Manager ORA_DOO_ORDER_ENTRY_SPECIALIST_JOB
order, order line, or fulfillment line on the ORA_DOO_ORDER_MANAGER_JOB
Create Order page, Revise Order page, or
in a fulfillment view.
1192
Oracle SCM Cloud Chapter 6
Implementing Order Management Orchestrate Fulfillment
What I Need to Do Job Role You Need to Do It Formal Name of Job Role
Apply or release a hold through a web Create your own role. Add privileges to your role.
service.
• DOO_MANAGE_ORDER_ORCHESTRATION_DECO
• DOO_MANAGE_ORDER_ORCHESTRATION_ORDE
Here's an example payload that applies the DOO_SHIP_ALL hold on order line 101 for source order 20156 that you
import from source system LEG.
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope>
<soapenv:Header/>
<soapenv:Body>
<dood:RequestHoldProcessRequest>
<!-1 or more repetitions:-->
<dood:ApplyHoldRequestParams>
<dood:SourceOrderSystem>LEG</dood:SourceOrderSystem>
<!--Optional:-->
<dood:SourceOrderId>20156</dood:SourceOrderId>
<!--Optional:-->
<dood:SourceLineId>101</dood:SourceLineId>
<!--Optional:-->
<dood:SourceHoldCode>DOO_SHIP_ALL</dood:SourceHoldCode>
<!--Optional:-->
<dood:HoldComments>Hold Shipping</dood:HoldComments>
<!--Optional:-->
<dood:SourceOrderNumber></dood:SourceOrderNumber>
<!--Optional:-->
<dood:SourceOrderLineNumber></dood:SourceOrderLineNumber>
<!--Optional:-->
<dood:HoldName></dood:HoldName>
<!--Optional:-->
<dood:AppliedBy>?</dood:AppliedBy>
</dood:ApplyHoldRequestParams>
</dood:RequestHoldProcessRequest>
</soapenv:Body>
</soapenv:Envelope>
1193
Oracle SCM Cloud Chapter 6
Implementing Order Management Orchestrate Fulfillment
<!--Optional:-->
<dood:SourceOrderNumber>?</dood:SourceOrderNumber>
<!--Optional:-->
<dood:SourceOrderLineNumber>?</dood:SourceOrderLineNumber>
<!--Optional:-->
<dood:HoldName>?</dood:HoldName>
<!--Optional:-->
<dood:HoldReleaseReasonName>?</dood:HoldReleaseReasonName>
<!--Optional:-->
<dood:ReleasedBy>?</dood:ReleasedBy>
</dood:ReleaseHoldRequestParams>
</dood:ReleaseHoldProcessRequest>
</soapenv:Body>
</soapenv:Envelope>
Note.
• Use the ReceiveOrderRequestService web service. For details, see the Web Services You Can Use to Integrate
Order Management topic.
• To apply a hold on the order header, include a value for SourceOrderId but not for SourceLineId. The hold will
apply to the header and all lines in the order.
• To apply or release a hold on the order line, you must include a value for SourceOrderId and for SourceLineId.
• Apply or release a hold on more than one sales order. Use the same soapenv:Header and soapenv:Body, and
include a separate RequestHoldProcessRequest section or ReleaseHoldProcessRequest section for each sales
order. For example.
<soapenv:header> ..... </soapenv:header>
<soapenv:body>
<RequestHoldProcessRequest>
<SalesOrderNumber>1234</SalesOrderNumber>
<SalesOrderSystem>GPR</SalesOrderSystem>
</RequestHoldProcessRequest>
<RequestHoldProcessRequest>
<SalesOrderNumber>2345</SalesOrderNumber>
<SalesOrderSystem>GPR</SalesOrderSystem>
</RequestHoldProcessRequest>
</soapenv:body>
• The web service imports the order with the Hold Tasks In Progress option as enabled when applying or
releasing a hold.
• You can use the web service to apply or release a hold on a sales order that's in Draft status.
• You can use the web service to apply or release a hold on the order header or order line, but you can't use it to
apply or release a hold on a fulfillment line. To apply or release a hold on a fulfillment line, go to a fulfillment
view in the Order Management work area, then use the Apply Hold action or the Release Hold action. For
details, see the Use Holds to Temporarily Stop Processing topic.
• You can't include RequestHoldProcessRequest and ReleaseHoldProcessRequest in the same soapenv:Body.
• You can't enable a hold on a service that uses a Wait, Apply Hold, Release Hold, or Inbound operation. For
example, the Wait for Shipment task places the orchestration process in a wait state that's effectively the
same as a hold, so its not necessary to place a hold when the process is already waiting. If you must hold the
orchestration process, then add the hold to the step immediately before the Apply Hold, Release Hold, or
Inbound operation step.
Shipment Set
If you apply or release a hold on any source line that's part of a shipment set, then Order Management applies or
releases the hold on all lines that are part of the set.
1194
Oracle SCM Cloud Chapter 6
Implementing Order Management Orchestrate Fulfillment
If you apply a hold on a line that's part of a shipment set, then Order Management queries the database to determine
whether other lines in the same shipment set exist on the sales order. If it doesn't find any other lines in the set, then it
applies the hold only on the line that you specify in the payload. The same behavior applies when you release a hold.
Assume shipment set n includes lines x, y, and z. If your import applies a hold on line x, then Order Management applies
the same hold on lines y and z. Order Management applies the hold on lines y and z even if you don't include them in
your payloads.
Related Topics
• Sales Order Hold
• Web Services You Can Use to Integrate Order Management
• Copy Setups Between Instances of Order Management
• Use Holds to Temporarily Stop Processing
1195
Oracle SCM Cloud Chapter 6
Implementing Order Management Orchestrate Fulfillment
You can set up a hold code only for a hold that starts in Order Management. You can't use it for a hold that starts in
some other application.
This topic includes example values. You might use different values, depending on your business requirements.
Attribute Value
Code hold_item_issue
Description This hold allows us to investigate a problem that occurred with the item.
This value specifies to apply a hold on all services. Fulfillment tasks determine whether
Order Management attaches a hold code to the fulfillment line, or to the sales order for one
or more fulfillment tasks that the orchestration process references.
Set COMMON
1196
Oracle SCM Cloud Chapter 6
Implementing Order Management Orchestrate Fulfillment
Attribute Value
You can use the Set value to specify the business unit set that Order Management uses with
a hold code. You can assign a hold code to a single business unit, or you can assign more
than one hold code to sets of business units. These sets can share hold codes.
4. Optional. Specify each service where Order Management must apply the hold.
For example, do these steps to apply the hold only for the Shipment service.
◦ Make sure the Hold All Services option doesn't contain a check mark.
◦ In the Hold to Investigate Item: Services area, click Actions > Select and Add.
◦ In the Select and Add: Services dialog, leave all attributes empty, then click Search.
◦ Click a row that displays Shipment in the Task Type column.
◦ For this example, you must apply the hold to all services, so click Cancel, then add a check mark to
option Hold All Services.
5. Click Save.
Order Management might place a sales order on hold for a variety of reasons. Your business requirements might
demand that a person who possesses the correct knowledge or authority to release a hold. Controlling holds according
to job role helps you improve security by limiting functionality according to role. It also helps you decrease order
processing time and reduce downstream problems that might be related to a hold that nobody releases.
1197
Oracle SCM Cloud Chapter 6
Implementing Order Management Orchestrate Fulfillment
For example, allow role x to apply and release hold 1, and to apply hold 2 but not release hold 2.
Assume you must allow the Order Manager job role to apply and release a hold, and allow the Order Entry Specialist job
role to apply a hold but not release it.
Try it.
1. In the Details area, click Applicable Roles, then, in the Apply Hold area and in the Release Hold area, make sure
the Selected Roles option is black.
2. Click Actions > Select and Add.
3. In the Search dialog, search for Order Manager, then click Apply > OK.
4. Click Actions > Select and Add.
5. In the Search dialog, search for Order Entry Specialist, then click Apply > OK.
6. In the Details area, set options for the roles.
Order Entry Specialist Contains a check mark. Doesn't contain a check mark.
If none of the predefined job roles meet your needs, then create your own job role.
1198
Oracle SCM Cloud Chapter 6
Implementing Order Management Orchestrate Fulfillment
Assume users in the Vision Services department of Vision Corporation receive service calls from customers
who are inquiring about the status of a sales order, such as what item the customer ordered, and expected
delivery date. The user must view the sales order, but not edit it. Assume you already created a user named
order_entry_specialist_vision_services to meet this requirement.
For details about job roles, see the Assign Job Roles in Order Management topic.
Attribute Value
1199
Oracle SCM Cloud Chapter 6
Implementing Order Management Orchestrate Fulfillment
◦
On the Scheduled Processes page, click Actions > Refresh. Continue to refresh until the status of your
scheduled process is Succeeded.
5. Synchronize users and roles.
For details about this task, see book SCM Cloud: Implementing Common Features for Oracle SCM Cloud.
◦ On the page that displays, click Submit.
6. Use the Manage Hold Definitions page to add your new job role to the hold code.
1200
Oracle SCM Cloud Chapter 6
Implementing Order Management Orchestrate Fulfillment
Try it.
1201
Oracle SCM Cloud Chapter 6
Implementing Order Management Orchestrate Fulfillment
Attribute Value
3. In the DOO_HLD_RELEASE_REASON: Lookup Codes area, click Actions > New then set values.
Attribute Value
Display Sequence 1
Attribute Value
Attribute Value
This is the name of the hold that you created earlier in this topic.
1202
Oracle SCM Cloud Chapter 6
Implementing Order Management Orchestrate Fulfillment
7. In the Order Lines area, to verify that Order Management placed a hold on the order line, make sure it displays
the On Hold icon.
8. Click the arrow next to Apply Hold, then click Release Hold.
9. In the Release Hold dialog, set values, then click Save and Close. You defined these values earlier in this topic.
Attribute Value
10. Sign out of Order Management, then sign back in with the Order Entry Specialist role.
11. Repeat the steps described above, but verify that Order Management doesn't display Release Hold when you
click the arrow next to Apply Hold.
Related Topics
• Sales Order Hold
• Set Up User Roles and Privileges in Order Management
• Job Roles and Duty Roles That You Use to Implement Order Management
1203
Oracle SCM Cloud Chapter 6
Implementing Order Management Orchestrate Fulfillment
Note.
• Apply or release a hold regardless of the channel where you applied it.
• Apply hold n in fulfillment system x, then release it in fulfillment system y.
• Use web services to communicate changes through Order Management to your fulfillment systems.
1204
Oracle SCM Cloud Chapter 6
Implementing Order Management Orchestrate Fulfillment
Here's an example web service payload that uses the SourceHoldCode attribute to apply and release a hold.
Note.
• The top line in the image is truncated. Here's the full line.
• Release a hold regardless of the channel that applied the hold. For example, assume fulfillment system
x is a channel, fulfillment system y is a channel, and the Order Management work area is a channel.
Assume fulfillment system x uses a web service to apply hold on sales order 759674. You can use the Order
Management work area to release the hold on sales order 759674.
• Use a web service to release a hold on a sales order header that the Order Management work area applied.
• Use a web service to apply a hold on a fulfillment line.
• Use the Order Management work area to manually release a hold that a web service automatically placed.
• Use the Order Management work area to manually apply a hold on a Draft sales order.
1205
Oracle SCM Cloud Chapter 6
Implementing Order Management Orchestrate Fulfillment
• Use the Order Lines tab in a fulfillment view in the Order Management work area to apply a hold on a fulfillment
line. The Order page that you access from the Manage Orders page is an example of a fulfillment view.
• Release a hold on a fulfillment line only from the Order Lines tab in a fulfillment view in the Order Management
work area.
• You can't use a web service to release a hold on a fulfillment line.
• You can't use a web service to apply a hold on a fulfillment line when the web service integrates with an order
capture system. Most order capture systems focus on inputs to sales order, such as customer and item. They
don't integrate directly with a fulfillment system, so they don't provide or manage the details that a fulfillment
line hold requires.
Related Topics
• Sales Order Hold
• Guidelines for Using Web Services to Integrate Order Management
1206
Oracle SCM Cloud Chapter 6
Implementing Order Management Orchestrate Fulfillment
1207
Oracle SCM Cloud Chapter 6
Implementing Order Management Orchestrate Fulfillment
Assume you create your own task type named My Shipment. You want to allow the Order Entry Specialist to place the
sales order on hold when the order reaches the orchestration process step that references the My Shipment task type.
Attribute Value
Description My Shipment
3. Click the row that contains My Shipment in the Task Type column.
4. Click Services.
Notice that the Manage Task Types page automatically adds a create service and enables it for holds.
For example.
Hold My Shipping Hold My Shipping Apply hold Doesn't contain a check mark.
Release Hold on My Shipping Release Hold on My Shipping Release hold Doesn't contain a check mark.
Related Topics
• How Data Flows Through Order Management
• Actions You Can Set When Routing Requests to Fulfillment Systems
1208
Oracle SCM Cloud Chapter 6
Implementing Order Management Orchestrate Fulfillment
Fulfillment Task
Fulfillment Tasks
Use a task type to specify the type of fulfillment task that the orchestration process step does, such as schedule a
fulfillment line for shipment, ship it, or confirm delivery.
A task type is group of services that Order Management uses to do a fulfillment task. It represents a common
business function that processes a sales order from the time your user creates the sales order to the time that Order
Management sends the order to your order fulfillment system.
1209
Oracle SCM Cloud Chapter 6
Implementing Order Management Orchestrate Fulfillment
Here are some typical task types, the services they call, and the sequence you use to run them. This example starts with
reservation.
Note.
1210
Oracle SCM Cloud Chapter 6
Implementing Order Management Orchestrate Fulfillment
• A typical sequence is to use services to reserve inventory for your item, schedule it for shipping, ship it, then
invoice it.
You can.
• Use a task to represent the services that the task type references. For example, if you create a Ship Goods task
that references services from the Shipment task type, then the Order Management work area displays Ship
Goods when a Shipment service runs, regardless of whether it calls the Create Shipment service or the Update
Shipment service. The Order Management work area doesn't display the service. It displays only the task.
• Create a new task type.
• Add more than one task to your new task type, such as ShipGoods or ShipWidgets.
• Add a predefined service to your new task type.
• Edit the service names of an activity or task type you create.
You can't.
• Modify the name of a task type after you create it because other objects in your setup might reference the
name.
• Modify or delete a predefined task type.
• Edit or delete a predefined service.
Invoice Communicate with your billing system to create an invoice for the fulfillment line.
1211
Oracle SCM Cloud Chapter 6
Implementing Order Management Orchestrate Fulfillment
FulfillOrder Integrate between Order Management and an Enterprise Resource Planning (ERP) system.
Note that fulfillment tasks can run more than one fulfillment action through a single request,
such as shipment and invoice.
Pause Temporarily pause processing to wait until a date to occur, an event to occur, or a dependency
to resolve before proceeding to the next orchestration process step.
Use the pause task to coordinate processing across more than one fulfillment line in one sales
order.
Activity Communicate with your fulfillment system to manage a human activity, such as install the
AS54888 Desktop Computer.
DOO_Procurement Source and ship the item when you procure the item from an organization that resides outside
of your typical supply chain.
DOO_Supply Communicate with Oracle Fusion Supply Chain Orchestration so you can use more complex
logic when you source the item.
DOO_Subscription For future use only. Don't reference the DOO_Subscription task type in any of your
orchestration processes. If you're importing data into Order Management Cloud, then don't
import an orchestration process that uses the DOO_Subscription task type.
Use the Manage Task Types page in the Setup and Maintenance work area to get the complete list of task types and the
services you can use with each task type.
1212
Oracle SCM Cloud Chapter 6
Implementing Order Management Orchestrate Fulfillment
Note.
• Use the Manage Task Types page to create your own task type.
• Add services to your task type.
• For example, the Schedule task type includes services.
◦ Create Scheduling
1213
Oracle SCM Cloud Chapter 6
Implementing Order Management Orchestrate Fulfillment
◦ Update Scheduling
◦ Cancel Scheduling
Task Services
Use different task services to fulfill different types of fulfillment requests.
Note.
1214
Oracle SCM Cloud Chapter 6
Implementing Order Management Orchestrate Fulfillment
Activity Services
Activity services send an activity request to your fulfillment system. The fulfillment system creates and fulfills the
activity, then sends replies and updates to the activity service. The activity service interprets these replies and updates.
An activity is an event that occurs outside of Order Management Cloud. For example, an orchestration process might
include an activity task type to set up a network router.
• An activity contains the details needed to finish the task.
• Your users can do an activity as part of finishing order fulfillment. Order Management can assign an activity to
one of your users.
• Each activity includes attributes, such as subject, activity type, earliest start date, due date, scheduled duration,
actual duration, percent complete, and assignee.
• Order Management can associate an activity with one or more fulfillment lines.
• The activity service doesn't typically immediately fulfill an activity task, so a wait service allows the
orchestration process to wait for the activity to finish.
• Order Management doesn't support partial fulfillment. An activity step must finish before the orchestration
process can proceed to the next orchestration process step.
Note.
Send request to fulfillment system. Send a Create Activity request to the fulfillment system that creates the activity.
If the service receives a change order, then it changes or cancels the activity, as necessary.
If Order Management applies a hold on a sales order, then the activity service sends a request
to the fulfillment system to hold the activity that's currently in progress.
Receive activity status update. You can schedule an orchestration process that periodically gets the updated activity status.
• An activity is a predefined task type. You can also create a new activity task type, and
Modify activity. use an extensible flexfield to modify an activity.
• You can enable an activity default in a task type or orchestration process step. Default
the activity type so you can categorize activities, then your fulfillment system can run
business logic and do validation according to the activity type.
1215
Oracle SCM Cloud Chapter 6
Implementing Order Management Orchestrate Fulfillment
• If you don't set the default value for the task type or the orchestration process step, then
Order Management sets the subject of the activity to the name of the step.
• You can use some fulfillment systems to create an activity template that supports a
human task. To use the template, you can specify the activity template for a task type
or an orchestration process step that creates the activity according to the predefined
template when you define the task type and the orchestration process.
Service Description
Reserve services Send a reservation request to the part of your fulfillment system that manages inventory. A
reservation reserves the supply for a sales order so no other sales order or inventory system
can use the supply.
Schedule services Send a scheduling request to order promising. For example, to schedule a sales order, remove
the schedule from a sales order, or determine whether the item is available.
• Scheduling applies to fulfillment lines that are waiting for manual scheduling and
fulfillment lines that fail scheduling in the automated or manual process.
• Scheduling works only for fulfillment lines that aren't scheduled. Order Management
doesn't allow automatic rescheduling from the Order Management work area.
Hold services Send a hold request to the fulfillment system. For example, the Hold Shipping service can
send a hold request from Order Management to the part of your fulfillment system that does
shipping.
Shipment Services
Shipment services send a shipment request to the part of your fulfillment system that does shipping.
Send shipment request to fulfillment If Order Management receives a change order, then the shipment service changes or cancels
system. the shipment request, if necessary.
If someone applies a shipping hold, and if the Hold on Running Task option is enabled, and
if the task that's running is a Shipping task, then the shipment service sends a request to the
shipping system to hold the shipment request that its currently processing.
Consolidate fulfillment lines. Consolidate the fulfillment lines of a shipment set or a configured item, then send all the lines
of the shipment set or the configured item as a group to the shipping system.
1216
Oracle SCM Cloud Chapter 6
Implementing Order Management Orchestrate Fulfillment
Receive fulfillment line details and The shipping system might send fulfillment line details to Order Management when a status
status updates from the shipping update occurs, including before it confirms the shipment. These details might include freight
system and update business objects cost, tracking number, way bill number, and so on.
in Order Management.
Order Management interprets the update it gets from the shipping system, then uses one of
these predefined values to update status.
• Picked
• Packed
• Shipped
• Backordered
Note.
• The shipment service continues to interpret the updates it receives from the shipping
system even after the shipping system ships fulfillment lines. It sends details about
these updates to Order Management.
• If the shipping system uses more than one currency to represent cost, then the
shipment service converts them before it sends the update to Order Management.
• If the shipping system uses a unit of measure to represent shipping that's different from
the unit of measure that Order Management uses in the sales order, then the shipment
service converts the unit of measure back to the unit of measure that the sales order
uses, then communicates the shipped quantity to Order Management.
Split a fulfillment line, shipment set, If only part of a fulfillment line ships, then the shipment service splits the line into.
or configured item when only part of
a shipment ships. • One fulfillment line that includes the quantity that shipped
• Another fulfillment line that includes the quantity that didn't ship
• Shipment set. The shipment service removes the lines that didn't ship from the
shipment set.
• Configured item. The shipment service splits the configured item into a shipped item
and an item that hasn't shipped.
Invoice Services
Invoice services send a request to the part of your fulfillment system that does billing and interprets the replies it
receives from this system.
• The billing system creates the invoice and the credit transactions.
• Order Management doesn't allow you to modify a fulfillment line after the invoice service sends the request.
• If you use a source system that resides outside of Order Management, then the source system must provide
most of the data that the billing system requires to finish billing. Order Management stores these details, then
routes the billing request to the billing system.
1217
Oracle SCM Cloud Chapter 6
Implementing Order Management Orchestrate Fulfillment
Send fulfillment line details from the The Create Billing Lines service sends billing details from the sales order or the return order
fulfillment system. each time the fulfillment line is eligible for billing. For example, it sends unit list price, unit
selling price, discounts, charges, tax attributes, sales credits, and fulfillment details.
• An invoice service sends charges that occur in the order header with the first fulfillment
line that Order Management fulfills for the sales order.
• If the fulfillment line doesn't include payment details or sales credits, then the invoice
service sends these details from the order header.
• The invoice service sends prepayment details from the order header for all fulfillment
lines.
• Order Management doesn't support discounts that occur in the order header.
Return lines The invoice service sends the reference to the original sales order line, the return reason,
received quantity, and delivered quantity.
Shipment set or configured item The invoice service sends the fulfillment lines that the shipment set or the configured item
contains together. If the fulfillment system fulfills only some lines in the shipment set or
configured item, then the invoice service sends only the fulfilled lines.
Note: A change order from Order Management can't update an invoice. A change to an invoice is typically a credit
from a return order or prepayment. Its not typically a cancel.
The billing system processes the data that it receives, then sends details to the invoice service.
• Invoice details
• Credit memo details
• Billing amount
• Billing date
• Invoice date or credit memo date
• Number
• Status
• Legal entity details
Return Services
Return services send a request to the part of your fulfillment system that does receiving and interprets the reply and
update that it receives from the receiving system.
• The return service creates a change receipt advice or a cancel receipt advice when Order Management receives
a return request.
• The request might include one or more attribute updates, such as to increase the receipt quantity.
• If Order Management receives a request to change the original copy of the sales order that the customer
returned, then the return service sends a request to the fulfillment system that creates the receipt advice.
1218
Oracle SCM Cloud Chapter 6
Implementing Order Management Orchestrate Fulfillment
• If Order Management receives a request to cancel the original copy of the sales order line that the customer
returned, then the return service cancels the receipt advice. Order Management typically allows cancel until the
fulfillment system receives the returned items.
• If the ordered quantity is greater than the delivered quantity on the receipt advice, and if the customer doesn't
require the ordered quantity, then the return service can request to cancel the remaining quantity.
Return services can process a partial receipt, such as the return of only some items of a configured item.
If the customer returns only part of the return, then the return service splits the fulfillment line into two lines.
• One line includes a status of Delivered for the items the customer returned
• One line includes the items the customer didn't return
If the customer returns only part of the original order, and if the return includes a configured item or kit, then the return
service splits the fulfillment line into two orchestration groups.
• One group includes the fulfillment lines that the customer returned
• One group includes the fulfillment lines that the customer didn't return or that aren't returnable
The receiving system that starts the event might send a status update for the return. For example, if the receiving dock
receives the item, then the receiving system might send a status update that starts an event that creates the receipt
advice. Here are the events in the receiving system that might start a status update in Order Management.
• Receive the item on the receiving dock when the receipt is created.
• Deliver the item into inventory.
• Return the item to a customer.
• Correct the sales order after a receipt transaction occurs. For example, a customer can't return a deliver
transaction.
Fulfill order services can send a request that modifies a sales order that resides in Order Management, and that the
fulfillment system uses.
• Create.
• Update.
• Place hold.
• Release hold.
• Update status.
• Cancel.
• Send an update to the fulfillment system each time Order Management accepts a change order that affects
fulfillment.
1219
Oracle SCM Cloud Chapter 6
Implementing Order Management Orchestrate Fulfillment
• Receive interim and final status updates from the fulfillment system. Fulfill order services don't immediately
send a reply. They send the reply when the fulfillment activity runs.
For more details, see the Parameters You Can Use When Routing Requests to Fulfillment Systems topic.
Related Topics
• How Data Flows Through Order Management
• Actions You Can Set When Routing Requests to Fulfillment Systems
Attribute Value
Notice that the page adds services in the Services list. The page copies the value you enter in the Task Type
attribute, appends it with the type of service, such as Create, then inserts the value in the Code column of the
service. For example.
Code Name
Note.
1220
Oracle SCM Cloud Chapter 6
Implementing Order Management Orchestrate Fulfillment
For example, assume you create a new task type, set the Task Type attribute to Pause_for_Backorder,
tab out of the attribute, the page adds service Pause_for_Backorder Create, you change the Task
Type attribute to Pause_for_Backorder_During_Drop_Ship, but the Code attribute in the service is still
Pause_for_Backorder Create. Its recommended that you change the Code column in the services lists to
Pause_for_Backorder_During_Drop_Ship Create before you click Save.
2. Assign a status code to the task type.
Order Management sets a default value for some system status codes, such as Pending, Change Pending,
Cancel, or Canceled. The status code that each task type references also controls the values for the exit criteria
on a wait step that uses the task type, and the value of the task status in the next orchestration process step.
You can create a new status code, or you can assign a status code that already exists.
3. Click Save.
4. Connect Order Management to the fulfillment system that will do the tasks and services that your new task
type references.
5. Reference your new task type when you create the orchestration process step.
1221
Oracle SCM Cloud Chapter 6
Implementing Order Management Orchestrate Fulfillment
Change management Use change management on an orchestration process step that references your new task type.
Specify the attributes for the task type on the Manage Order Attributes That Identify Change
page.
Make sure your task type references the Update service and the Cancel service, and the
connectors that these services require.
Hold code To apply a hold to your new service, create hold codes for it. Hold All applies to your new
service and to services that already exist.
Jeopardy threshold To include a jeopardy score for your new task, set up a jeopardy threshold for it.
Processing constraint Create a processing constraint that controls when to use your new task. For example, use a
processing constraint that specifies the attributes that are required in the outbound request or
on the inbound reply.
If you use one of them, then the template task uses a complete data set to communicate Order
Management attributes.
Register error messages If your fulfillment system sends error messages to Order Management and you prefer to
process and display them in Order Management, then you must register them.
Maintaining data integrity makes sure the task type you create displays correctly throughout the Order Management
work area. Order Management also makes sure functionality works correctly with your new task type.
• Status update
• Wait step
• Forward planning
• Jeopardy
• Hold processing
• Split processing
1222
Oracle SCM Cloud Chapter 6
Implementing Order Management Orchestrate Fulfillment
• Change management
• Error recovery
Related Topics
• Manage Connector Details Between Order Management and Your Fulfillment System
1223
Oracle SCM Cloud Chapter 6
Implementing Order Management Orchestrate Fulfillment
Reserve supply for a sales order so no other demand can use the supply. Demand includes other fulfillment lines in your
sales order, fulfillment lines in other sales orders, transfer orders, work orders, and so on.
You use the Create Inventory Reservations fulfillment task to reserve supply. Here's what it does.
• Uses your inventory system to reserve physical supply that currently exists in the warehouse.
• Doesn't reserve future supply, such as supply that's scheduled to be built.
• Reserves supply for each fulfillment line.
• Reserves the entire quantity on the fulfillment line.
1224
Oracle SCM Cloud Chapter 6
Implementing Order Management Orchestrate Fulfillment
◦ If the entire quantity isn't available in inventory, then the reservation task doesn't reserve any quantity.
For example, if the quantity on fulfillment line x for item AS54888 is 4, and if there's only a quantity of 3
in inventory, then the reservation task doesn't reserve any quantity.
• Reserves only from inventory that's currently available. It doesn't reserve according to date. It reserves from
current inventory even if your sales order includes a scheduled ship date that occurs in the future.
• Automatically reserves each item where you set the Reservable attribute and the Back-to-Back Enabled
attribute to Yes for the item in Product Information Management.
• Reserves items that aren't configured and items that are configured.
• Reserves all items in each assemble-to-order model, pick-to-order model, kit, or ship set together. It doesn't
reserve individual items or only some items in each model, kit, or ship set.
Assume you sell a desktop computer as a model, and the model includes the CPU, memory, hard drive, monitor,
keyboard, and mouse. If inventory has everything in stock except the memory, then the task doesn't reserve
anything.
1225
Oracle SCM Cloud Chapter 6
Implementing Order Management Orchestrate Fulfillment
Use DOO_OrderFulfillmentGenericProcess or create a copy of it, then add an optional pause step.
Note.
• Use the pause step to pause the orchestration process until the shipment is almost ready to ship.
• The reservation step will provide a more accurate picture of supply that's available because it's closer to the ship
date.
• Waiting to reserve supply can also reduce the cost of holding inventory until it's time to ship.
1226
Oracle SCM Cloud Chapter 6
Implementing Order Management Orchestrate Fulfillment
If you.
• Enable the Manual Attribute on any step in the orchestration process. Order Management enables the
Reserve action on the Management Fulfillment Lines page and waits for the user to manually reserve the
fulfillment line.
• Don't enable it on any step.. Order Management disables the Reserve action and the process doesn't wait for
the user to manually reserve the fulfillment line.
The step details in the graphic might be a little hard to read. Here are the same details.
Step Step Name Step Type Task Type Task Service Manual
Attribute Value
Reservable Yes
Attribute Value
1227
Oracle SCM Cloud Chapter 6
Implementing Order Management Orchestrate Fulfillment
There's a trade off between using Global Order Promising or the reservation service in Order Management. If there isn't
enough supply to fulfill the line by the request date, and if you set the Allow Partial Shipments of Lines attribute on the
line to Yes, then.
• The scheduling service in Global Order Promising will split the line into two lines. The second line will contain a
future date.
• The reservation service in Order Management never splits the line, so it fails.
If you use Global Order Promising to schedule your fulfillment lines, then consider removing the reserve step from your
orchestration process. If you must keep the reserve step, or if you don't use Global Order Promising, then.
• Enable the Manual property on the step so the user must click a button when close to the request date.
• Only send lines to the reservation step that you can fulfill with the inventory that you have on hand. Or use a
pause step to pause lines that you can't fulfill from on-hand inventory. The pause delays the reservation until
nearer the request date.
Another option is to remove the reserve step and let shipping handle reserving inventory.
There isn't enough quantity in inventory to fulfill the item in Los Angeles, but the Denver Manufacturing business unit
does have enough quantity. You can set up some rules that allow you to use Denver's inventory to fulfill Los Angeles'
sales order.
1228
Oracle SCM Cloud Chapter 6
Implementing Order Management Orchestrate Fulfillment
Try it.
1. Use the Purchasing work area to create and approve a purchase request that Los Angeles can use to fulfill the
quantity of 100.
2. Use the Manage Supply Execution Document Creation Rules task to set up a rule that uses the purchase order
to create supply for Los Angeles. For details about how, see the Set Up Rules That Create Supply topic.
3. Use the Manage Supply Order Enrichment Rules task to transform the transfer order into a sales order. For
details, see the Guidelines for Setting Up Rules for Supply Orders topic.
At run time, Denver reviews and approves the purchase order, Order Management uses the purchase order as input
when it automatically creates a sales order for Denver, Denver ships the item, Order Management closes the transfer
order, and Los Angeles receives the purchase order.
Related Topics
• Set Up Rules That Create Supply
• Guidelines for Setting Up Rules for Supply Orders
Attribute Value
1229
Oracle SCM Cloud Chapter 6
Implementing Order Management Orchestrate Fulfillment
Attribute Value
Name OrderFulfillmentGenericProcess
Attribute Value
5. Leave the other values in the header area at their current values.
6. In the Process Details area, click Status Conditions.
7. In the Edit Status Rule Set column, click the Edit Status Rule Set button.
8. On the Edit Status Rule Set page, delete the rows, then click Save and Close.
100 Scheduled
2020 Unscheduled
9. On the Edit Orchestration Process Definition page, click Orchestration Process Status Values, then delete the
rows.
100 Scheduled
1230
Oracle SCM Cloud Chapter 6
Implementing Order Management Orchestrate Fulfillment
10. Click Step Definition, delete the row, then click Save.
100 Schedule
1231
Oracle SCM Cloud Chapter 6
Implementing Order Management Orchestrate Fulfillment
Code Description
PostTransformationRules A dictionary that you use to access and store data for your posttransformation rule.
1232
Oracle SCM Cloud Chapter 6
Implementing Order Management Orchestrate Fulfillment
Code Description
FulfillLineVO A view object that contains attributes. VO is an abbreviation for view object.
FLine.RequestShipDate Store the value of the RequestShipDate attribute in the FLine variable.
FLine.RequestShipDate isn't null Proceed to the Then statement only if RequestShipDate contains a value.
If RequestShipDate doesn't contain a value, then you can't use it to set the value for
ScheduleShipDate.
Code Description
FLine.ScheduleShipDate = Set the value of the ScheduleShipDate attribute in the FLine variable to the value that the
FLine.RequestShipDate RequestShipDate attribute contains in the FLine variable.
Try it.
Attribute Value
3. Click Expand, click Show Advanced Settings, set the values, then click Save.
1233
Oracle SCM Cloud Chapter 6
Implementing Order Management Orchestrate Fulfillment
Attribute Value
If FLine is a PostTransformationRules.FulfillLineVO
5. In the area below the statement you just created, click Left Value.
6. In the Condition Browser dialog, expand FLine, click RequestShipDate, then click OK.
7. Set Is, to Isn't, then enter null after Isn't.
Create a Then Statement that sets the value of the overrideScheduleDateFlag attribute to Y.
Make sure you enclose the Y with double quotation marks ('' ").
Create Another Then Statement
Create a Then Statement that sets the value of the ScheduleShipDate attribute to the value of the RequestShipDate on
the fulfillment line.
◦ Warehouse
◦ Shipping Method
If you're importing, make sure these attributes contain a value in your import payload.
2. Click Submit.
1234
Oracle SCM Cloud Chapter 6
Implementing Order Management Orchestrate Fulfillment
Drop Ship
If you want to skip Global Order Promising in a drop shipment, then set the value of the ship date or arrival date,
depending on the value of the Buyer Managed Transportation option on the purchase order.
Enabled on the purchase order Requested Ship Date on the fulfillment line
Not enabled on the purchase order Requested Arrival Date on the fulfillment line
1. Sign in with a privilege that you can use to access purchase orders.
2. Go to the Purchase Orders work area.
3. Search for your purchase order, then open it.
4. On the Terms tab, examine the Buyer Managed Transportation attribute.
Related Topics
• Overview of Using Business Rules With Order Management
1235
Oracle SCM Cloud Chapter 6
Implementing Order Management Orchestrate Fulfillment
1236
Oracle SCM Cloud Chapter 7
Implementing Order Management Use Business Rules
Overview
Overview of Using Business Rules With Order Management
Set up a business rule in Order Management Cloud to implement a dynamic decision at run time that automates a
company policy, does a calculation, or does some processing.
A business rule is a statement that describes how to implement a business policy or make a business decision. It can
implement logic.
Here are some business requirements you can meet with a business rule.
A business rule keeps rule logic separate from the underlying application code, which allows a business analyst to
modify rule logic without using programming code and without interrupting your business process.
• If the sales order is valued at $50,000 or more, then make sure a representative calls the customer before
sending an invoice.
1237
Oracle SCM Cloud Chapter 7
Implementing Order Management Use Business Rules
Here are the types of business rules you can use and where you can use them.
Note.
Transform a sales order. Order Management transforms each source order that you create in Order Management or
that it receives from a source system so it can optimize order fulfillment. You can write a rule
• Pretransformation to. . .
• Product Transformation
• Populate order attributes before transformation.
• Posttransformation
• Transform a source order.
1238
Oracle SCM Cloud Chapter 7
Implementing Order Management Use Business Rules
For example.
• Populate an attribute on a fulfillment line. If the item is a widget, then populate the
Request Date attribute on the fulfillment line.
• Convert a measurement. If the item is a widget, then convert the value in the Size
attribute from centimeters to inches in the fulfillment line.
• Create fulfillment lines from one item. For example, if the item is a laptop that includes
a docking station, then transform the item into one fulfillment line for the laptop and
another fulfillment line for the docking station.
Process Assignment Assign the orchestration process that Order Management runs to process fulfillment lines.
For example.
• If the ordered quantity is large, then assign the sales order to an orchestration process
that optimizes scheduling and delivery for large orders.
• If the customer is Important, then assign the sales order to an orchestration process that
expedites delivery.
• If the ship-to address in the order header resides outside of your country, then assign
the sales order to an orchestration process that handles international fulfillment, such as
checking for trade compliance.
Process a sales order. Set up a rule that affects processing, such as branch in an orchestration process, do a complex
calculation that determines planning lead time, or manage a change that occurs to the sales
• Start After Condition order.
• Branching Condition
• Lead Time Expression For example.
• Line Selection Criteria
• If an invoice exceeds $100,000, then make sure a representative phones the customer.
• If the status of the Create Shipment orchestration process step is Shipped, then send a
Process a change order.
notification to your customer that the sales order is on its way.
• Compensation Pattern • If the sales order includes a shippable item, such as a laptop, and an item that isn't
shippable, such as a warranty for the laptop, then make sure the orchestration process
• Cost of Change
doesn't attempt to ship the warranty.
Routing Rule Set up a rule that routes a fulfillment request to a fulfillment system according to an attribute
on the sales order, fulfillment line, or orchestration process.
For example.
• If product type is Goods, and if task type is Invoice, then route the request to fulfillment
system ABCInvoicingSystem.
• If item is 2TX Server, then route the service request to fulfillment system Big Server.
For details, see the Overview of Connecting Order Management to Your Fulfillment System
topic.
1239
Oracle SCM Cloud Chapter 7
Implementing Order Management Use Business Rules
For background details about creating Oracle Business Rules, see Designing Business Rules with Oracle Business
Process Management on Oracle Help Center.
Starting with release 13B, its strongly recommended that you use only Visual Information Builder for routing,
pretransformation, and assignment rules.
Editor for Oracle Business Rules Editor for Visual Information Builder
Manage External Interface Routing Manage External Integration Routing Rules for Sales Orders
Rules
Manage Orchestration Process Manage Process Assignment Rules for Sales Orders
Assignment Rules
Page Topic
Manage Orchestration Process See these topics for rules that you set up on an orchestration process.
Definitions
• Set Up Lead-Times for Orchestration Process Steps
1240
Oracle SCM Cloud Chapter 7
Implementing Order Management Use Business Rules
Page Topic
For details about using business rules with extensible flexfields, see the Overview of Setting Up Extensible Flexfields in
Order Management topic.
Line Selection Criteria Select Fulfillment Lines for Orchestration Process Steps
1241
Oracle SCM Cloud Chapter 7
Implementing Order Management Use Business Rules
You use the Manage Orchestration Process Definitions page to set these attributes. For details, see the Guidelines for
Setting Up Orchestration Process Steps topic.
1242
Oracle SCM Cloud Chapter 7
Implementing Order Management Use Business Rules
Note.
1. An event occurs that causes Order Management to run the rule. The event depends on the context where you
write the rule. For example, if you set up a rule.
◦ On a step in an orchestration process. The rule runs when the process reaches the step.
◦ On the external interface. The rule runs when a task in the external interface references the rule.
2. If the If statement is true according to the facts, then Order Management activates the rule.
For example.
1243
Oracle SCM Cloud Chapter 7
Implementing Order Management Use Business Rules
where
• Item is a fact.
• Green Server is a fact.
3. The rule references the dictionary to get the objects it needs at run time.
For example, you create variables and declare objects when you set up the rule. You store these objects in the
dictionary.
4. The rule does the action.
where
• If the sales order is valued at $50,000.00 or more, then make sure a representative calls the customer before
sending an invoice.
1244
Oracle SCM Cloud Chapter 7
Implementing Order Management Use Business Rules
Note.
1. Left Value of the If statement. Specifies the object the rule compares in the If statement.
DooSeededOrchestrationRules.DOOFLine.extendedAmount
where
◦ DooSeededOrchestrationRules is the name of a dictionary. A dictionary is an XML file that contains rules
organized in rule sets, facts, functions, variables, bucket sets, links, the data model, and so on.
◦ DOOFLine is an object in the dictionary.
• DOO is an abbreviation for distributed order orchestration, which is a name Order Management
used in earlier releases. It means the same as order orchestration.
• extendedAmount is a fulfillment line attribute. It contains the total value of the sales order.
• FLine is an alias for fulfillment line.
• DOOFLine contains the data model for the fulfillment line in order orchestration. For example,
DOOFLine contains the fulfillment line attributes, such as orderedQty, customerPONumber,
creationDate, and so on. You can reference these attributes and use their values in your rule.
1245
Oracle SCM Cloud Chapter 7
Implementing Order Management Use Business Rules
2. Right Value of the If statement. Specifies the value the rule uses to determine whether the If statement is
true. The example contains a literal value of 50000. You can also reference an object from the dictionary. If you
reference an object, then the rule uses the value that the object contains at run time to make the comparison.
3. Action. Specifies how to add your target to the dictionary. You can specify a variety of actions. Assert New
means to add a new fact to the dictionary.
A fact is transactional data that the rule uses, such as the items on a sales order.
◦ An object stores this data. You reference the object when you create a rule.
◦ Order Management provides a hierarchy of facts according to the transactional data for the sales order in
each dictionary.
◦ Each object instance corresponds to a single fact.
◦ You must assert each fact before you can use it in a rule. Assert makes the fact available so you can
reference it elsewhere in the rule, such as in the properties of the Target.
4. Target. Specifies the object that the rule modifies when the If statement evaluates to true. In this example,
if extendedAmount is more than 50000, then the rule will assert the Result object as a fact into the
DooSeededOrchestrationRules dictionary.
5. Edit Properties. Specifies the properties of the target. If the rule evaluates the If statement to true, then the
rule modifies the values of the properties of the target according to how set up these values. Here's the code
that this example uses for the properties.
( resultObj:DooSeededOrchestrationRules.Boolean.TRUE )
where
The Then statement sets the resultObj property of the Result fact to TRUE. This example is a branching
condition, so the orchestration process examines the value of resultObj at run time. If it contains TRUE, then
the process runs the branch that makes sure a representative phones the customer.
Guidelines
1246
Oracle SCM Cloud Chapter 7
Implementing Order Management Use Business Rules
Note.
• Create all your rules in the same instance of Order Management. Don't create some rules in one instance, and
then some other rules in another instance or environment.
1247
Oracle SCM Cloud Chapter 7
Implementing Order Management Use Business Rules
• Some rule dictionaries are available in jDeveloper. However, don't use jDeveloper because problems might
occur during patching, instantiating objects, and migrating. Instead, use the Setup and Maintenance work area
to set up your rules.
Use the work area to migrate setup data from one environment to another environment. You can create rules
for orchestration processes only through the Manage Orchestration Process Definitions page in the Setup and
Maintenance work area. Migration migrates rules that you create when you set up an orchestration process.
1248
Oracle SCM Cloud Chapter 7
Implementing Order Management Use Business Rules
you don't need to research whether you can use an attribute or fact in the logic that you set up. Automatic fill refines the
search result each time you enter another character.
Its strongly recommended that you use automatic fill or the drop down list and dialog in Oracle Business Rules when
you set values. Don't enter a value directly in a field unless you're entering a literal string. Oracle Business Rules
dynamically modifies the values that are available in fields depending on the values that you set while you're creating
the rule. If you enter a value directly in an field, its possible that the rule will fail validation even if the value that you
enter is exactly the same value that the rules editor populates when you use automatic fill or the dialog.
If you declare a variable in one field, but don't see it available in another field, then click Save in the rule builder dialog.
1249
Oracle SCM Cloud Chapter 7
Implementing Order Management Use Business Rules
If you enter a literal string in a field and get a validation error when you click Validate, then remove all content from the
field, click Expression Value, enter you value in the Condition Browser, then click OK.
The tree displays the hierarchy of the objects that you can add to the rule. For example, the Manage External Interface
Routing Rules page displays the hierarchy of attributes that you can add.
1250
Oracle SCM Cloud Chapter 7
Implementing Order Management Use Business Rules
◦ Order Header
◦ Order Fulfill Line
• Each entity includes attributes. For example, here are some attributes in the Order Fulfill Line entity.
◦ Business Unit
◦ Item
◦ Ordered Quantity
◦ And many others
• To add an attribute to your rule, click the attribute, drag, then drop it onto the rule.
For example, drag the Item attribute onto the If statement of your rule.
You can use the tree to set up a wide range of conditional logic that meets your business requirements. If you prefer not
to use the tree, you can search directly in the If statement or Then statement for the entity, attribute, values, and so on.
1251
Oracle SCM Cloud Chapter 7
Implementing Order Management Use Business Rules
1252
Oracle SCM Cloud Chapter 7
Implementing Order Management Use Business Rules
Note.
• In the Setup and Maintenance work area, click Actions > Export > Create New Export.
• Export the business objects that you need to run your business rule. For example.
◦ Orchestration Transformation Rules
◦ Order Approval Rules.
◦ External integration Routing Rules
◦ Orchestration Process Assignment Rules
1253
Oracle SCM Cloud Chapter 7
Implementing Order Management Use Business Rules
For example, assume you write rule x that assigns a fulfillment line with item type of server to one process, and
you write rule y that assigns server item ABC to another process. A conflict might occur. You must revise rule x
so it doesn't specify server item ABC. Oracle Business Rules provide details about potential conflicts after you
save the rule.
• If your rule compares one data object to another data object of the same type, then use advanced mode and
create two variables, one variable to represent each data object.
You must specify that variable one is not the same as variable two. Set up this test.
If you don't set up this test, then Oracle Business Rules will use variable1 and variable 2 to represent the same
object instance when it determines the rule to apply.
• Make sure each rule evaluates to a single result. For example, if you write two rules for a fulfillment task, then
make sure only one rule evaluates to true. Assume you write two rules.
These rules look different but they each evaluate to true when Task Type equals Shipment and Customer equals
GOLD. To avoid this problem, write If, Then, Else rules in Visual Information Builder to make sure your rules are
mutually exclusive.
1254
Oracle SCM Cloud Chapter 7
Implementing Order Management Use Business Rules
Note.
1. Notice the entity. You enter the attribute, such as Order Type, and then the entity that contains the attribute,
such as Order Header, displays immediately under the attribute.
Most attributes on the order header are different from attributes on the order line. For example, the order
header includes the Order Type attribute but the order line doesn't. However, the order header and the order
line contain similar or identical attributes. For example, the order header and the order line each include
attribute Shipping Instruction. If your rule must reference Shipping Instruction on the order header, then make
sure you use the order header entity.
2. Is in the List. Use Is in the List to examine the list of values that the attribute references instead of writing an
OR condition. For example, the list of values for Order Type includes Mixed Orders and Standard Orders. If you
don't use Is in the List, then it might be necessary to write a series of OR conditions. For example.
1255
Oracle SCM Cloud Chapter 7
Implementing Order Management Use Business Rules
If Order Type equals Mixed Orders, or If Order Type equals Standard Orders
3. Add the description. Description for the IF statement is optional. However, you can use it to quickly scan your
rule logic without having to drill down into the rule to determine the purpose of the statement. You can also add
a description for the Then clause.
4. Make sure the object isn't empty.
Note: If your rule depends on a value, and if the rule references an attribute that doesn't contain a value,
then it might fail with unpredictable results, such as a null pointer error. For example.
Manage Process Assignment Rules for Sales OrdersView row with key oracle.jbo.Key[null ] is not
found in __DimensionVO__For__Reference__For_DCL__
or
Attempted to invoke method "longValue" in class "java.lang.Long" on a null object
reference. at line 29 column 13 in /Ruleset(PreTransformationRS)/Rule(HQVMISubinvDefault)/
Pattern(v0_HeaderVO)/Test[8]
Avoid this problem. Make sure the value of any attribute that your rule references isn't empty.
Use rule logic in Visual Information Builder to simplify creating and managing your rule.
1256
Oracle SCM Cloud Chapter 7
Implementing Order Management Use Business Rules
Note.
◦ Put all your logic in one rule instead of spreading it across more than one rule.
◦ Write one rule that includes more than one IF_THEN_ELSE statement instead of writing more than one
rule.
◦ Add an IF THEN ELSE structure.
◦ Nest your rules, such as adding another IF after an ELSE.
2. To look for values that aren't in the list, write a rule that looks for values in the list, then add a False condition.
Use False directly in the IF statement to implement a NOT condition rather than adding another rule.
1257
Oracle SCM Cloud Chapter 7
Implementing Order Management Use Business Rules
The priority determines the sequence that Order Management uses when it applies the rule. Assume you set priority
to Medium for rule x and to High for rule y. Assume the conditions in the If statements in rules x and y evaluate to true.
Order Management will apply rule y on the orchestration process first, and then will apply rule x.
For details, see the Guidelines for Pausing Orchestration Processes topic.
1258
Oracle SCM Cloud Chapter 7
Implementing Order Management Use Business Rules
A rule set is a group of rules that run together to achieve a business objective. For example, assume you create a pause
rule and a release rule on a pause task. The pause rule and release rule together constitute one rule set. Oracle Business
Rules runs all the rules in a rule set. To avoid logic problems, make sure no two rules can be true at the same time, or
false at the same time.
Create If Statements
• Use an If Then format that uses natural language when you first begin writing your rule. For example.
1259
Oracle SCM Cloud Chapter 7
Implementing Order Management Use Business Rules
If the item type is server, then add extra packing to the shipping instructions.
• Remove dependencies where the result of one rule changes the If statement of another rule in a way that
causes infinite looping.
• Consider the outcome under a variety of data inputs. The If Then statement is the most common statement.
You can also use If Then Else in advanced mode.
• Add the equivalent of an Else clause so your rule can handle the situation where no condition is met. To avoid
an interruption in processing, this is particularly important when your rule assigns an orchestration process or
routes processing to a fulfillment task.
• Use a bucket set to simplify If logic in the decision table. Use parameters on actions to provide different values
for the same attribute in each rule.
• Use a decision table when you require more than one rule that uses the same set of If statements and Then
statements.
For Each Case Each Repeat for each of the row that satisfies
the conditions of the If statement.
There is a case where At least one At least one of the rows satisfies the
conditions of the If statement.
There is no case where None None of the rows satisfies the conditions
of the If statement.
Related Topics
• Guidelines for Pausing Orchestration Processes
1260
Oracle SCM Cloud Chapter 7
Implementing Order Management Use Business Rules
Transformation Rule
Note.
Here's some code that adds a new fulfillment line for item 12345678.
This code deletes the fulfillment line that references item 12345678.
1261
Oracle SCM Cloud Chapter 7
Implementing Order Management Use Business Rules
This example code modifies the ShippingInstructions attribute. It sets the contents of the attribute to the text
Sales credits are 17.
• Make sure you use each rule only to do work for its intended design. For example, use a product transformation
rule only to transform an item. Don't use it to implement some other functionality.
• If the order header and the order line contain the same attribute, such as the Freight Terms attribute, and if you
need to transform the value on the line, then use a posttransformation rule. Don't use a pretransformation rule.
Order Management cascades values from the header to the line when you click Submit, so it will replace the
value that you set with a pretransformation rule with the value from the header. But a posttransformation rule
runs after you click Submit and after Order Management cascades values.
1262
Oracle SCM Cloud Chapter 7
Implementing Order Management Use Business Rules
Note.
• Use parameters, such as Maximum Lines to Aggregate, to aggregate the lines you send to your fulfillment
system.
• For details about how to set attributes, see the Actions You Can Set in Routing Rules topic.
• Run several tests and measure the results. Optimize values for each parameter after each test.
• Don't create a routing rule that depends on a pause task and that sets the connector. For example, if you use
Visual Information Builder, don't create a rule that's similar to.
If Task Type is equal to pause, then set connector name to Fusion-Reservation.
1263
Oracle SCM Cloud Chapter 7
Implementing Order Management Use Business Rules
If you use Oracle Business Rules, don't create a rule that's similar to.
Compensation Pattern
Note.
1264
Oracle SCM Cloud Chapter 7
Implementing Order Management Use Business Rules
• Don't use this rule to set the default value for any other attribute.
Note.
• Use Advanced Mode.
• Use the Assign action.
• Assign a numeric value, such as 10 to costOfChange. For example.
assign Header.mRuleDecision.costOfChange = 10
1265
Oracle SCM Cloud Chapter 7
Implementing Order Management Use Business Rules
• Don't use this rule to set the default value for any other attribute.
1266
Oracle SCM Cloud Chapter 7
Implementing Order Management Use Business Rules
Note.
• Use Advanced Mode.
• Use the Assign action.
• Assign a datetime value. For example.
assign Header.mRuleDecision.leadTime = (Fline.scheduleShipDate.time - CurrentDate.date.timeInMillis)/
(1000*60*60*24)
• Don't use this rule to set the default value for any other attribute.
Line-Selection Rule
Note.
• Use Advanced Mode.
• Use the Assert action.
1267
Oracle SCM Cloud Chapter 7
Implementing Order Management Use Business Rules
• Don't use this rule to set the default value for any other attribute.
Note.
1268
Oracle SCM Cloud Chapter 7
Implementing Order Management Use Business Rules
• Don't use this rule to set the default value for any other attribute.
Pause Tasks
Set up a pause task on an orchestration process. For details, see the Guidelines for Pausing Orchestration Processes
topic.
Related Topics
• Guidelines for Setting Up Orchestration Process Steps
1269
Oracle SCM Cloud Chapter 7
Implementing Order Management Use Business Rules
1. The condition references an attribute that resides in an entity, such as the Customer attribute in the order
header entity.
1270
Oracle SCM Cloud Chapter 7
Implementing Order Management Use Business Rules
If the Customer attribute in the Order Header entity equals Computer Service and Rentals
Set the Latest Acceptable Ship Date attribute in the Order Fulfill Line entity to the same value that
the Latest Acceptable Ship Date attribute in the Order Header entity contains.
3. Order Management applies the rule at run time. Here's the pseudocode.
The Customer attribute in the Order Header entity equals Computer Service and Rentals, and the Latest
Acceptable Ship Date attribute in the Order Header entity contains 1/1/21 6:58 PM, so set the Latest
Acceptable Ship Date attribute in the Order Fulfill Line entity to 1/1/21 6:58 PM.
General Guidelines
Note.
• Identify the attributes that you will reference in the rule. For example, Item Type and Shipping Instructions
are each an attribute on the fulfillment line. For details about Order Management tables that these attributes
reference, see Distributed Order Orchestration chapter in the Tables and Views for Oracle Supply Chain
Management Cloud book at https://docs.oracle.com/en/cloud/saas/supply-chain-management/20c/oedsc/
distributed-order-orchestration.html#distributed-order-orchestration.
• Add a default, catch all rule that can handle the situation where you must set an attribute value.
• Make sure your rule can handle an attribute that doesn't contain a value, even for attributes that normally do
contain a value.
Note: If the attribute doesn't contain a value, and if your rule does a calculation that requires a value, then
it might create an error or result in a null pointer exception at runtime.
For example, an Order Entry Specialist might or might not set the value for an extensible flexfield because
adding a value is optional. If your rule references an extensible flexfield, and if this flexfield doesn't contain a
value at run time, then write your rule so it populates the flexfield with a default value that your rule can use
during calculations.
• You can reference a variety of attributes and entities.
1271
Oracle SCM Cloud Chapter 7
Implementing Order Management Use Business Rules
Apply guidelines when you reference an extensible flexfield in Visual Information Builder.
Apply guidelines when you reference an extensible flexfield in Oracle Business Rules.
1272
Oracle SCM Cloud Chapter 7
Implementing Order Management Use Business Rules
Note.
• Use isn't null to make sure the value of any attribute or object, such as the segment or context, that your rule
references isn't empty. If your rule references an empty attribute, but depends on a value, then it might fail with
unpredictable results.
• Reference the context code, such as HeaderEFF.context.
• Reference the segment name, such as HeaderEFF.getFlexAttributeDateValue("_CompleteCompliancedate").
• If you reference a value set, then Oracle Business Rules uses the VALUE column, by default. If the value set.
◦ Contains a value for ID. The editor uses the ID, and you must write the rule so it uses the ID.
◦ Doesn't contain a value for ID. The editor uses the value.
For example, if you write a rule that references a payment term, then you must make sure the value set includes
a value for ID, and your rule must reference the ID.
• How to identify the context code and segment name, see the Identify Flexfield Contexts and Category Codes
for Your Business Rules topic.
• Extensible flexfields, see the Overview of Using Extensible Flexfields in Order Management topic.
1273
Oracle SCM Cloud Chapter 7
Implementing Order Management Use Business Rules
Note.
• Order Promising uses the Scheduled Ship Date attribute on the sales order only if you set the Override
Schedule attribute to Yes. If you create a rule that references Scheduled Ship Date, then make sure you override
the schedule.
• Specify the warehouse, or specify the supplier and supplier site. It isn't necessary to specify scheduled arrival
date.
• If you don't make these settings, then Order Promising ignores the scheduled ship date that the rule sets.
1274
Oracle SCM Cloud Chapter 7
Implementing Order Management Use Business Rules
Note.
◦ Item Definition
◦ Item Category
◦ Related Item
1275
Oracle SCM Cloud Chapter 7
Implementing Order Management Use Business Rules
• These entities are children of the Order Fulfill Line entity, grandchildren of Order Line, and great grandchildren
of Order Header.
• You can reference an item attribute in Visual Information Builder or Oracle Business Rules.
• Don't reference an item attribute that ends with suffix _OBSOLETE in the attribute name.
Related Topics
• Overview of Using Extensible Flexfields in Order Management
• Overview of Setting Up Extensible Flexfields in Order Management
• Identify Flexfield Contexts and Category Codes for Your Business Rules
Note.
• Business rules that you add to an orchestration process are part of the orchestration process definition. You
use the Functional Setup Manager to export these definitions from one environment and to import them into
another environment.
• In most situations, an upgrade or patch won't affect your rules, with these exceptions.
◦ The upgrade or patch might overwrite modifications you make to a predefined rule or decision table.
◦ The upgrade or patch might change rule behavior, and this change might affect the behavior of your
business rules.
Assume you create rule in Oracle If Business Unit 203 or FulfillOrdID 207 doesn't exist in your target environment, then
Business Rules. the migration will fail. To avoid this error, make sure these entities exist in your target
environment.
1276
Oracle SCM Cloud Chapter 7
Implementing Order Management Use Business Rules
If Business Unit
equals "203", then set
FulfillOrdID to "207"
Assume you create a rule in Visual If Business Unit Vision Operations or Warehouse Singapore Distribution doesn't exist in your
Information Builder. target environment, then the migration will fail. To avoid this error, make sure these entities
exist in your target environment.
3. Make sure each rule operation that uses Starts with or Contains includes the full attribute value or ID value.
4. For each attribute that your rule references in the source environment, make sure you also set up each of these
attributes in the target environment.
For example, if a rule in your source environment references the Primary Salesperson attribute, then make sure
the target environment also includes Primary Salesperson.
5. Make sure none of the rules you're about to migrate contain errors.
Migration deletes all rules in the target environment before it does the migration, including rules you don't set
up in the source. For example, if the target includes rules x, y, and z, and if the source includes rules x and y,
then the migration deletes rules x, y, and z from the target, then copies rules x and y from the source to the
target. If the target depends on rule z, then copy rule z to the source before you do the migration.
7. Make sure you release each rule you must migrate.
If you create a business rule in the source environment but don't release it, then the migration won't migrate the
rule. Migration only migrates rules you save and release.
8. If your rule references an extensible flexfield, then make sure you set up each of flexfield in the same way in the
source environment and in the target environment.
The Manage Configuration Packages page doesn't examine your extensible flexfield setup. You must manually
examine your setup.
9. Migrate your rules.
1277
Oracle SCM Cloud Chapter 7
Implementing Order Management Use Business Rules
The Setup and Maintenance work area exports business rules from your source environment and
imports them into your target environment.
Related Topics
• Export Setup Data Using Implementation Project
• Copy Setups Between Instances of Order Management
The page you access depends on the set up you must do. For this example, you modify an orchestration
process definition, so open Manage Orchestration Process Definitions.
3. Access the rule editor.
You access the rule editor in different ways, depending on the page you use. For this example, you click Add
to Rule in the Pause Rule column on the step of an orchestration process. For an example, see the Pause
Orchestration Processes Until Events Occur topic.
1278
Oracle SCM Cloud Chapter 7
Implementing Order Management Use Business Rules
Do it.
1. Click the magnifying glass (Left Value) to access the Condition Browser.
The Condition Browser displays objects that come predefined in the dictionary. It also displays objects that you
assert into the dictionary while you create your rule.
The browser filters the items it displays according to where you access it. This behavior helps make sure you
only choose objects that make sense in the context where you access the browser. For example, here's the
dictionaries that the browser displays when you create a start-after condition.
1279
Oracle SCM Cloud Chapter 7
Implementing Order Management Use Business Rules
The browser displays the objects that this dictionary contains, including facts, variables, and so on.
You usually use only some of the objects that are available in the dictionary. For example, here are the objects
you typically use in the DooSeededOrchestrationRules dictionary.
◦ Result
◦ Date
◦ Timestamp
◦ DOOHeader
◦ SacResult
◦ DOOFLine
1280
Oracle SCM Cloud Chapter 7
Implementing Order Management Use Business Rules
where
1281
Oracle SCM Cloud Chapter 7
Implementing Order Management Use Business Rules
DOO Abbreviation for distributed order orchestration, which is an earlier name for order
orchestration.
billToCustomerId Fulfillment line attribute. This attribute stores an identification number for the customer. Its
the same number that displays in the Order Management work area.
A sales order uses the demandClassCode attribute to allow you to classify the customer. Assume your rule must
examine the value of demandClassCode, so scroll down, click demandClassCode, then click OK.
1282
Oracle SCM Cloud Chapter 7
Implementing Order Management Use Business Rules
4. Click Right Value (the magnifying glass) to access the Condition Browser.
The Right Value window specifies the value that the If statement uses to determine whether its True. Similar
to Left Value, you can expand DooSeededOrchestrationRules to access objects in the dictionary. You can also
specify a string.
For this example, enter "GOLD" in the window, then click OK. You must enclose the string with double quotation
marks.
1283
Oracle SCM Cloud Chapter 7
Implementing Order Management Use Business Rules
1284
Oracle SCM Cloud Chapter 7
Implementing Order Management Use Business Rules
Choose an action. For this example, you will assert the Then statement as a new fact into the dictionary.
Action Description
You can also reassert an object. A reassert updates the dictionary so it reflects the new state
of the object whether or not you changed the object.
Reassert doesn't create a fact. If your rule requires more than one fact for a fact type, then
you must assert each of these facts as a separate object.
1285
Oracle SCM Cloud Chapter 7
Implementing Order Management Use Business Rules
Action Description
Modify Modify a data value that's associated with a matched fact in the dictionary.
Other Actions Advanced mode displays more actions, but you don't use most of them. For details, see How
to Use Advanced Mode Action Forms in Oracle Fusion Middleware User's Guide for Oracle
Business Rules.
The target specifies the object this rule will modify if it evaluates to true.
1286
Oracle SCM Cloud Chapter 7
Implementing Order Management Use Business Rules
For this example, select object SacResult, where sac means start after condition. The rule will modify this
value.
If you click Edit Properties, the rules editor gets the properties of the object that you selected as the target, then
displays them in the Properties dialog. In this example, it displays the properties of SacResult.
1287
Oracle SCM Cloud Chapter 7
Implementing Order Management Use Business Rules
4. In the reevaluateFlag row, in the Value column, enter "N". You must include the double quotation marks.
Each target contains a different set of properties, so you must set them differently depending on your business
requirements. In this example, reevaluateFlag specifies to evaluate the result of the start after condition again
after the rule runs. You don't want this reevaluation, so set reevaluateFlag to N.
5. In the Value column, click Value (the magnifying glass).
Use the sacType property to specify the action to take when the If statement evaluates to true. In this example,
you must pause the orchestration process while it waits for an event to occur. The EVENT pause type causes
the orchestration process to pause, so you set sacType. For details about setting properties for the start after
condition, see the Use Holds to Pause Orchestration Processes topic.
1288
Oracle SCM Cloud Chapter 7
Implementing Order Management Use Business Rules
6. In the Condition Browser, expand DooSeededOrchestrationRules > SacResult, click SAC_TYPE_EVENT, then
click OK.
1289
Oracle SCM Cloud Chapter 7
Implementing Order Management Use Business Rules
7. Verify that the Properties dialog displays your settings, then click OK.
Notice that the Then area displays a string representation of the properties you set. Use this string to quickly
assess the action the rule will do. Here's the complete business rule.
Related Topics
• Use Case to Pause for an Event
• Use Holds to Stop Orchestration Processes
1290
Oracle SCM Cloud Chapter 7
Implementing Order Management Use Business Rules
Here are the attributes that are available in the rule header when you use Advanced Mode.
Attribute Description
Priority Determines when to run each rule when you create a set of rules.
1291
Oracle SCM Cloud Chapter 7
Implementing Order Management Use Business Rules
Attribute Description
If Active doesn't contain a check mark, then Order Management doesn't include it during
validation, even if Order Management previously released it as an active rule.
For examples that use Advanced Mode, see the Get Data from Product Information Management topic.
• The business rule uses the data model from Order Management to identify each fact it must use.
• A fact doesn't include data that resides outside of Order Management.
• Use facts for transformation, process assignment, and external interface routing according to business
components in Oracle Application Development Framework (ADF), specifically view objects (VO) that expose the
data model.
• View objects provide a hierarchical view of transactional data, such as a sales order. However, each business
rule converts them into rule language (RL) facts. Facts in rule language don't include a hierarchy. You don't need
to manage rule language facts, but this conversion might affect how you create your rule.
• If the fact is a business component in Application Development Framework, and if your rule uses more than
one object type, then you must make sure your rule reestablishes the view object (VO) hierarchy. Reestablishing
the hierarchy makes sure each rule performs at an optimal level.
Property Description
ViewRowImpl References a row in a view object. You use ViewRowImpl to access a row in a database table.
You typically specify this property in the result. Its required in a transformation rule. Its optional
for other business rules.
The Business Components for Java framework instantiates an object of ViewRowImpl for each
record that the view object query returns for the row.
key_values References the oracle.rules.sdk2.decisionpoint.KeyChain object. You can use this property to
get the set of key values for this row and the parent rows of this row. This property is optional.
You can use Advanced Mode with an explicit join to reestablish the hierarchy. You can also use Tree Mode to more
clearly represent the hierarchy in the rule editor.
1292
Oracle SCM Cloud Chapter 7
Implementing Order Management Use Business Rules
If you use only Advanced Mode, If you use Advanced Mode and Tree Mode, then you can select objects in the existing
and if the If statements and Then hierarchy, such as Header, Line, and FulfillLine.
statements in your rule will process a
public view object on the sales order,
then your rule must make sure it If you use an extensible flexfield, then you might need to create more joins.
joins each public view object so it
accurately represents the sales order
hierarchy. For example.
Note.
• If you use Tree Mode, then also use Advanced Mode because Advanced Mode helps you to maintain the
hierarchy.
• If you use only Advanced Mode to maintain the object hierarchy, then you must explicitly specify the hierarchy.
For an example, see the Get Data from Product Information Management topic.
• If you use Tree Mode to set the root of an object hierarchy, then the rules editor displays objects only at the root
level or below the root level while you create the rule. This filtering helps to make sure you correctly maintain
the object hierarchy.
• Tree Mode uses the forward slash (/) to indicate hierarchy.
For an example that uses Tree Mode to maintain the object hierarchy and that uses the forward slash, see the Use
Extensible Flexfields in Line-Selection Rules topic.
Related Topics
• Use Extensible Flexfields in Line-Selection Rules
• Get Data from Product Information Management
See these topics for examples that use a decision table and bucket set.
• Create Transformation Rules
• Assign Orchestration Processes
For background details about decision tables, see Working with Decision Tables in Oracle Fusion Middleware User's
Guide for Oracle Business Rules.
1293
Oracle SCM Cloud Chapter 7
Implementing Order Management Use Business Rules
Here's an example that uses a decision table. It labels each If statement as a Condition and each Then statement as an
Action.
A bucket set is a container you can use to hold the overall range of values that a group of buckets defines. Use it to
constrain the values that the If statement and the facts in a decision table will consider.
1294
Oracle SCM Cloud Chapter 7
Implementing Order Management Use Business Rules
Assume you create a Colors bucket set that includes string values of red and purple. You can write a rule for each color.
You can also write one rule for blue and another rule for purple.
In another example, assume you create a Numbers bucket set that uses integers instead of strings. You can then create
buckets in the Numbers bucket set. Here's the buckets.
• Less than 1
• 1 to 10
• Greater than 10
1295
Oracle SCM Cloud Chapter 7
Implementing Order Management Use Business Rules
You can create a bucket set that specifies aliases for data that might be difficult to recognize, such as identification
numbers. You can use the toString() function in the If statement to convert the value from the Long data type to a String
alias, such as a product code. In this set up, the bucket set maps each identification number to the product code.
Here's an example bucket set that chunks ranges of values into a large, a medium, and a small bucket.
Way Description
Create a local list of values or a list of Create the bucket set in the decision table.
ranges.
Manually create a global bucket set. Create the bucket set in a product transformation rule, then select bucket set values from a list
of values for each decision table that the rule page displays.
The list of values only includes values that match the data type you're setting up. For example,
assume you set up one bucket set that includes numeric values, another bucket set that
includes text values, then add an If statement that examines numeric data. The list of values in
the If statement will display values only from the bucket set that contains numeric data.
Automatically create a global bucket Use the Generate Bucket Sets scheduled process to create a bucket set from transactional data.
set.
1296
Oracle SCM Cloud Chapter 7
Implementing Order Management Use Business Rules
ORAAccountingRules ORAInvoicingRules
ORACurrencies ORAShipmentPriority
ORADemandClasses ORAFreightTerms
ORAFOB ORAReceiptMethods
ORAModeOfTransport ORAConversionType
ORAPaymentTerms ORACarrier
ORASalesCreditTypes ORASupplier
ORAServiceLevel ORASupplierSite
ORATaxClassificationCodes ORAReturnReason
ORATaxExemptionReason ORACancelReason
ORAUOM ORAReturnReason
1297
Oracle SCM Cloud Chapter 7
Implementing Order Management Use Business Rules
• To avoid data type and object hierarchy problems, you can't use a business rule to do date arithmetic with a
fact. However, you can create a rule that does date arithmetic in an orchestration process.
• A date attribute use the time stamp data type.
Here's an example that uses an If statement to set up fline as the alias for the fulfillment line. It compares the time of
the scheduled ship date to the current date, and uses milliseconds in the comparison conversion.
If fline.scheduleShipDate.time>=CurrentDate.date.timeInMillis
In another example, here's some code that calculates the scheduled arrival date to occur three days after the current
date.
If fline.scheduleArivalDate.time>= CurrentDate.date.timeInMillis+3*24*60*60*1000
where
• 3 is the number of days.
• 24 is the number of hours in one day.
• 60 is the number of minutes in one hour.
1298
Oracle SCM Cloud Chapter 7
Implementing Order Management Use Business Rules
Here's a dialog that sets up a business rule for the line selection criteria in an orchestration process.
Note.
DooSeededOrchestrationRules.Result(DooSeededOrchestrationRules.DOOFLine.fulfillLin
If you use this kind of calculation in the THEN clause, then make sure your rule doesn't modify or overwrite the original
value. You might need to assign a temporary attribute to hold the calculation before your rule populates the result
object.
1299
Oracle SCM Cloud Chapter 7
Implementing Order Management Use Business Rules
Here's an example of a lead time expression in a business rule on an orchestration process. fline represents the
fulfillment line object and DateTime is the temporary attribute.
Action Code
Modify DateTime(time:DateTime.time-(2*24*60*60*1000))
Function Example
compareTo(Object|Timestamp| If fline.RequestArrivalDate.compareTo(fline.ScheduleArrivalDate) is -1
java.util.Date)
Note.
• Use these functions for each attribute that's a Timestamp data type, including a temporary attribute that you
declare with the Timestamp object.
• You can manually enter the function after you select the attribute. You can also open the Expression Builder,
click the Functions tab, then open the folder next to the date attribute.
• The format for each function, except compareTo, is true or false, and this format doesn't require quotation
marks.
• Here's the format that compareTo uses.
◦ -1. The object to the left of compareTo occurs before the object to the right of compareTo.
◦ 0. The object to the left of compareTo occurs at the same time as the object to the right of compareTo.
1300
Oracle SCM Cloud Chapter 7
Implementing Order Management Use Business Rules
◦ 1. The object to the left of compareTo occurs after the object to the right of compareTo.
Manage Errors
Each business rule validates your syntax when you save your rule. It displays errors in the error pane at the bottom of
the page or dialog.
For example.
Manage Conflicts
Each business rule provides conflict management for your decision tables.
• The business rule displays conflicts between the If statement and the Then statement.
• You can use the exclamation point (!) on the tool bar to toggle visibility of the conflict.
1301
Oracle SCM Cloud Chapter 7
Implementing Order Management Use Business Rules
• The business rule identifies each rule that the conflict affects, including rules that depend on a conflicted rule.
For example, if rule A is conflicted, and if Rule B depends on Rule A, then Rule B also displays as conflicted.
• An icon on the decision table toolbar identifies a missing set up in your business rule. For example, if you add
bucket set elements but don't use them in your rule, then the page displays an icon.
• The page might display the rules you must add to correct the set up. You can select a rule to add it to your set
up, but you aren't required to select them. Instead, you can create a different rule to correct the set up.
This feature is useful when you create a bucket set that includes a large number of values. Each bucket set
allows you to choose Otherwise when it isn't necessary to individually specify each selection.
Here's an example where a new rule is in conflict with three other rules.
Attribute Description
• attrName(String)
• attrValue(Object)
1302
Oracle SCM Cloud Chapter 7
Implementing Order Management Use Business Rules
Attribute Description
• viewRowImpl(oracle.jbo.server.ViewRowImpl)
Note.
• If you don't use the list of values to set attrName(), then you must enclose the attribute
that you provide with quotation marks.
• The name of the attribute is the required data type, not the value of the attribute at run
time.
• Make sure your rule populates the ModifyEntity arguments when your rule uses them to
do an action.
• ModifyEntity behavior is different from the Modify action you use on menus on the
Manage Product Transformation Rules page.
• newItemId(Long)
• viewRowImpl(oracle.jbo.server.ViewRowImpl)
Arguments.
• fulfillmentLineId(Long)
• viewRowImpl(oracle.jbo.server.ViewRowImpl)
For example.
Note that viewRowImpl(oracle.jbo.server.ViewRowImpl) represents the current object instance. For example, a fulfillment
line record.
These functions work at the attribute level. You can find them on the Functions tab of the Expression Builder dialog as
the first entries under each object.
You can also use predefined date functions on each date attribute.
1303
Oracle SCM Cloud Chapter 7
Implementing Order Management Use Business Rules
Function Description
getAdjustedDate(Timestamp, Double) Add or subtract the value of argument Double (in days) from the Timestamp argument,
depending on the sign, and then return the result in the Timestamp argument.
subtractFromDate(Timestamp, Subtract the value of the second Timestamp argument from the first Timestamp argument.
Timestamp)
If the second Timestamp argument is empty, then subtractFromDate subtracts the current date
from the first Timestamp argument.
Function Description
hasChanges() Determine whether extensible flexfield values in the change order are different from values
that the previous version of the sales order contains.
Use getAttribute on the order header, fulfillment line, orchestration process, or task.
You can also use these functions. You must prefix the attribute name with an underscore (_), and you must enclose the
attribute name in quotation marks.
Function Description
attributeChanged(String) Determine whether the value of an attribute in the change order is different from the value that
the previous version of the sales order contains.
1304
Oracle SCM Cloud Chapter 7
Implementing Order Management Use Business Rules
Function Description
getFlexAttributeValue(String) Get the value of an extensible flexfield attribute of data type String.
getFlexAttributeDateValue(String) Gets the value of an extensible flexfield attribute of data type Date in time stamp format.
getFlexAttributeNumValue(String) Get the value of an extensible flexfield attribute of data type Number.
For details about using a business rule with an extensible flexfield, see the Use Extensible Flexfields with Order
Management topic.
1305
Oracle SCM Cloud Chapter 7
Implementing Order Management Use Business Rules
1306
Oracle SCM Cloud Chapter 7
Implementing Order Management Use Business Rules
• If task type is shipment, then set the connector to Connect to Oracle Fusion Shipping System
Do it.
Limitations
• You can't use a decision table. If you created a rule in an earlier version of Order Management that uses a
decision table, and if you prefer to use Visual Information Builder to replace this rule, then use the IF-THEN-
ELSE structure in Visual Information Builder to replace the decision table. For an example, see the Manage
Process Assignment Rules topic.
• Don't use Visual Information Builder and Oracle Business Rules at the same time in the same implementation.
Use Visual Information Builder or Oracle Business Rules for all your rules.
• You can't create a global variable for use in a rule.
• You can't create collections of objects in conditions.
• Don't reference an object that includes the text _Obsolete when you create your rule. _Obsolete indicates that
business rules might no longer support the object in the current or future release.
1307
Oracle SCM Cloud Chapter 7
Implementing Order Management Use Business Rules
• If the task type is Compliance Check, and if the compliance value is less than 100, then set the connector to
ComplianceCheckConnector, and set the interface type to SDO.
1308
Oracle SCM Cloud Chapter 7
Implementing Order Management Use Business Rules
Attribute Value
1309
Oracle SCM Cloud Chapter 7
Implementing Order Management Use Business Rules
Related Topics
• Route Requests from Order Management to Fulfillment Systems
1310
Oracle SCM Cloud Chapter 7
Implementing Order Management Use Business Rules
For example.
1311
Oracle SCM Cloud Chapter 7
Implementing Order Management Use Business Rules
Attribute Value
1312
Oracle SCM Cloud Chapter 7
Implementing Order Management Use Business Rules
Notice that the Active indicator for the Pretransformation Default Rule for Warehouse rule is green.
4. Click Publish.
Order Management publishes each of the rules that are active on the Manage Pretransformation Defaulting
Rules page.
• If the source system is a legacy system, and if the quantity is more than 1,000, and then use carrier Fedex, else
use carrier UPS.
In your shipping environment, assume you typically use Fedex (Federal Express) to deliver small to medium size
packages, and you use UPS (United Parcel Service) to deliver large packages.
1313
Oracle SCM Cloud Chapter 7
Implementing Order Management Use Business Rules
You can add the OR, ELSE, THEN, and AND conditions to meet your business requirements.
Related Topics
• Overview of Transformation Rules
• How Order Management Transforms Source Orders Into Sales Orders
• How Order Management Transforms Order Lines Into Fulfillment Lines
1314
Oracle SCM Cloud Chapter 7
Implementing Order Management Use Business Rules
1315
Oracle SCM Cloud Chapter 7
Implementing Order Management Use Business Rules
Part One
Create the Routing Rule and First IF Condition
1. In the Setup and Maintenance work area, go to the task.
◦ Offering: Order Management
◦ Functional Area: Orders
◦ Task: Manage Process Assignment Rules for Sales Orders
2. On the Manage Orchestration Process Assignment Rules page, click Create New Rule.
3. Change the rule name.
1316
Oracle SCM Cloud Chapter 7
Implementing Order Management Use Business Rules
8. Click Save.
Create the Second IF
1. Below the IF area, click ELSE > IF.
2. Name the If statement so it describes the meaning of the condition.
1317
Oracle SCM Cloud Chapter 7
Implementing Order Management Use Business Rules
3. Click New Action (the dashed circle in the DO area), then click Perform an Action.
4. In the Create Action dialog, enter process name, wait a moment, click Process Name (Order Fulfill Line), then
click Search.
5. In the Search dialog, enter DOO_, then click Search.
6. In the ProcessName area, click DOO_OrderFulfillmentGenericProcess, then click OK.
7. In the Create Action dialog, click OK.
Notice that the DO area displays text.
8. Click Save.
Create the Third IF
Returns for different types of fulfillment lines might require Order Management to use different fulfillment processing.
In this example, you set up the rule to consider only returns for credit.
• If Line Type isn't empty, and if Line type is equal to Return for credit
Do it.
1. In the area to the right of condition IF category = RETURN, click THEN > IF.
2. Name the IF so it describes the meaning of the action.
1318
Oracle SCM Cloud Chapter 7
Implementing Order Management Use Business Rules
◦ In the upper right corner of the Line Type is Blank area, click Select (the circle with the solid line), then
wait for it to display a blue check mark.
◦ In the upper left corner of the page, next to the trash can, click Group.
Notice that the IF Line Type = Credit Only area now displays the This Condition is True area around the
Line Type is Blank area. This grouping is equivalent to adding parenthesis inside your statement.
In this example, you group Line Type is Blank to test whether this statement is true or false. To group a
set of statements, you select each statement, then click Group.
◦ Click true.
Notice that true changes to false. In this example, when you run the rule, you must make sure the line
type is blank condition is false because you want Order Management to assign the orchestration process
only if the line type contains a value.
6. In the IF line type = credit only area, click the AND that resides outside of the this condition is false area.
7. In the Create Condition dialog, enter line type, wait a moment, then click Line Type (Order Fulfill Line).
8. Set the condition to is equal to Return for credit, then click OK.
Notice that the IF area now displays text.
◦ Line type is equal to Return for credit
9. Click Save.
Part Two
Create the DO That Assigns the Orchestration Process When Receiving Returns for Credit
1. In the area to the right of condition IF line type = credit only, click THEN > DO.
2. Name the DO so it describes the meaning of the action.
◦ In the DO area, click Enter Description.
◦ In the Enter Description dialog, enter Set process to BillOnly, then click OK.
3. Click New Action (the dashed circle in the DO area).
1319
Oracle SCM Cloud Chapter 7
Implementing Order Management Use Business Rules
4. In the Create Action dialog, enter process name, wait a moment, click Process Name (Order Fulfill Line), then
click Search.
5. In the Search dialog, enter %Bill%, then click Search.
The percentage symbols (%) are wildcards that search for all values before and after the text Bill. This search
returns orchestration process names that contain the text Bill.
6. In the ProcessName area, click DOO_BillOnlyGenericProcess, then click OK.
7. In the Create Action dialog, click OK.
Create the DO That Assigns the Orchestration Process for All Other Returns
1. Immediately below the IF line type = credit only condition , click ELSE > DO
2. Name the DO so it describes the meaning of the action.
8. Click Save.
Create the DO That Assigns the Orchestration Process for All Other Sales Orders
Assign the orchestration process to use for the sales orders that don't meet the other IF conditions.
1. Immediately below the IF category = RETURN condition, click ELSE > DO.
2. Name the DO so it describes the meaning of the action.
8. Click Save.
1320
Oracle SCM Cloud Chapter 7
Implementing Order Management Use Business Rules
1. On the Manage Orchestration Process Assignment Rules page, notice that the Active indicator for the Default
Process Assignment Rule rule is grey.
2. Right-click Default Process Assignment Rule, then click Actions > Edit.
3. In the Default Process Assignment Rule dialog, add a check mark to option Activate Rule, then click Save and
Close.
Notice that the Active indicator for the Default Process Assignment Rule rule is green.
4. Click Publish.
Order Management publishes each of the rules that are active on the Manage Orchestration Process
Assignment Rules page.
Related Topics
• Guidelines for Assigning Orchestration Processes
1321
Oracle SCM Cloud Chapter 7
Implementing Order Management Use Business Rules
1322
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
Application Behavior
Use Order Profiles to Control Order Management Behavior
Manage predefined profile values to control behavior in Order Management Cloud.
Most profiles include predefined values so you don't need to set them up unless you need different values to meet your
deployment requirements.
Aggregate According to Number of Order Enable this option to aggregate order lines Only for a single site
Lines That Changed according to the number of order lines
that changed.
Aggregator Hold Timeout Period in Aggregation applies a hold on the Only for a single site
Minutes purchase order in Procurement to prevent
other processes from updating the order
during aggregation.
1323
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
Currency Conversion Type Specify the value to use when converting Single site and for each user
a currency in the Order Management work
area. This value is a conversion type.
Display Currency Specify the currency to display in the Only for a single site
Order Management work area.
Hours to Wait Before Allowing Date Specify the number of hours to wait before Only for a single site
Changes on Fulfillment Lines allowing the Order Entry Specialist to
update attributes on the fulfillment line for
a drop shipment.
1324
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
Required Overview Status Filter Specify the default customer to use Only for a single site
when filtering the summary of status
data on the Overview page of the Order
Management work area.
Respond Immediately on Start of Specify when the Sales Order for Order Only for a single site
Submission Request Hub REST API sends a response to each
request that it receives.
Retain Sales Order Number During Import See the Retain Sales Order Number During -
Import topic.
Send Fulfillment Details for Drop This option comes predefined with the Only for a single site
Shipments to Accounts Receivable Site level disabled. If you enable it, then
Order Management will send fulfillment
details for drop shipments to Accounts
Receivable. It will send the waybill number,
bill of lading, and so on.
Skip Availability When Searching for Item Improve performance when the user Only for a single site
searches for an item on the catalog line.
If you set this option to Yes, then Order
Management doesn't send a request to
Global Order Promising to determine
whether the item is available. If you don't
use Global Order Promising, then set this
option to Yes.
Skip Pricing Totals and Pricing Validation Improve performance. Don't validate the Only for a single site
price and don't calculate the total price of
the sales order when the user clicks Add
on the catalog line. Order Management
will calculate the sales order total only
1325
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
User Request Waiting Period in Seconds Specify the number of seconds to wait Only for a single site
after an action finishes. This time allows
each asynchronous web service to finish
before displaying a confirmation message
or a warning message in the Order
Management work area. The default value
is 5.
The Where You Can Use It column describes whether you can use the attribute for a single site in your implementation,
and for each user.
• And if the promised ship date or promised arrival date changes in Oracle Procurement.
• Or if the work order dates change in Oracle Manufacturing.
• Or if the requested date changes in Oracle Inventory.
. . . then Order Management will use Global Order Promising to calculate the corresponding scheduled ship date or
scheduled arrival date for sales orders in Order Management.
Note.
• Order Management doesn't send the revised scheduled ship date or scheduled arrival date to Oracle Fusion
Procurement, so the dates on the sales order in Order Management won't match the dates on the purchase
order in Procurement.
• Order Management doesn't support date changes that occur in Procurement for a shipment set, configured
item, kit, splitting the schedule, or reducing quantity. You must not make these changes in Procurement.
• You can use this feature only with orchestration processes that use Global Order Promising.
• You can use this option only for a single site.
• If the buyer manages transportation, then Order Management maps the Requested Delivery Date on the
purchase order to the Scheduled Arrival Date on the sales order. Order Management and Global Order
Promising ignore the value in Requested Delivery Date when recalculating the Scheduled Arrival Date.
1326
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
Note.
Assume you set the transit lead time Assume you set the transit lead time to 3 days in Global Order Promising.
to 5 days in Global Order Promising.
1327
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
The buyer can revise the Promised The buyer can revise the Promised Delivery Date, but can't revise the Promised Ship Date in
Ship Date in Procurement. Procurement.
Global Order Promising updates the Global Order Promising updates the Scheduled Ship Date.
Scheduled Arrival Date.
Related Topics
• Integrate Order Management with Source Systems
1328
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
Product transformation Use the order type as part of a pretransformation, transformation, or posttransformation rule.
For example.
• Write a rule that sets the default value for the order type according to the value of some
other attribute on the order header.
For example, assume your company writes a contract to fulfill sales orders from
Customer y over all other customers. You can write a rule if Customer is Y, then
set Order Type to Top Priority, then use an external interface routing rule that
routes the sales order to a fulfillment system that prioritizes shipment speed over other
factors, such as cost.
• Write a rule that uses the value of the order type to determine the default value to
display for an attribute on the order header or order line.
Order Management runs each pretransformation rule when the user creates or revises a sales
order in the Order Management work area. For example, when the user sets or updates the
Business Unit, Customer, or Order Type, or adds an order line. To avoid overwriting these
selections, you can write a pretransformation rule so it sets a value only if the attribute is
empty.
Process assignment Write a rule that uses the order type to assign an orchestration process.
For example, if Order Type is Government - Department of the Interior, then set up an
orchestration process that fulfills order lines according to Department of the Interior
procurement requirements.
External interface routing Write a rule that uses the order type to determine which fulfillment system will fulfill the sales
order.
For example, if Order Type is Emergency, then route the sales order to a fulfillment system that
prioritizes shipment speed over other factors.
Use the order type in the condition or result of a processing constraint. For example, prevent Order Management from
updating an attribute according to the value of some other attribute. You can also use the order type to prevent Order
Management from submitting a sales order. For example.
1329
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
This topic includes example values. You might use different values, depending on your business requirements.
Attribute Value
Order Management uses the ORA_DOO_ORDER_TYPES lookup for attribute Order Type, but doesn't come
predefined with values for this lookup. If you don't add any values, then Order Management still displays the
Order Type attribute but it won't contain any values.
3. In the Lookup Codes area, click Actions > New to add each lookup code.
Related Topics
• Use Visual Information Builder
• Guidelines for Assigning Orchestration Processes
• Route Requests from Order Management to Fulfillment Systems
1330
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
1331
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
In this example, you create a sandbox named My Sandbox, expose the Primary Salesperson attribute, then modify the
display name so it says My Primary Salesperson.
Attribute Value
Name My Sandbox
Oracle Page Composer displays, which is a page editor you can use to modify the visual layout that the
Order Management work area uses. You can tell you're in Page Composer because it displays a section
across the top of the page. The section includes tabs, such as Add Content, Select, and Structure.
To modify an attribute in another work area, go to that work area, then go to the page in the work area
that displays the attribute you must modify.
For details about how to use Page Composer, see the Guidelines for Page Modification topic.
3. Expose the attribute.
◦ Click Select.
◦ Click in the lower portion of the order header, for example, below the Customer attribute, then click Edit
Parent Component.
◦ In the Component Properties dialog, click Children, then notice the list of attributes that display.
Each attribute that doesn't contain a check mark is hidden. You can add a check mark to unhide the
attribute.
1332
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
◦ Add a check mark next to Primary Salesperson, then click Apply > OK.
4. Verify values in the sandbox.
◦ Verify that the order header displays the Primary Salesperson attribute.
◦ In the Order Lines area, click View > Columns, and notice you can display the attribute.
◦ In the upper-right corner, click Close.
◦ On the Order page, click Done.
◦
Notice that you can now display the Primary Salesperson attribute on the Manage Orders page.
• In the Search area, click Add Fields.
• In the Search Results, click View, then click Columns, and notice you can display the Primary
Salesperson attribute.
5. Modify the display name.
◦ Navigate back to the order page.
◦ In the order header, click Primary Salesperson, then click Edit Component.
◦ In the Component Properties dialog, next to Label, click Edit > Override, then click OK.
◦ In the order header, click Primary Salesperson, then click Edit Component.
◦ In the Component Properties dialog, in the text window next to Label, enter My before the text Primary
Salesperson, then click OK.
◦ Verify that the order header now displays My Primary Salesperson.
6. Publish.
◦ At the top-right corner, click My Sandbox > Publish.
◦ On the Sandbox Detail page, click Publish.
◦ In the dialog, click Continue to Publish.
You are no longer in the sandbox. You're now back in Order Management.
◦ Repeat the verification you did earlier in the sandbox, but this time use the Order Management work area
outside of the sand box.
Related Topics
• Create and Activate Sandboxes
• Guidelines for Using Page Composer
1333
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
Note.
◦ Order Management doesn't allow you to add a new line and cancel a line in the same shipment set during
the same revision, so it displays the error message.
◦ The predefined DOO_ORCHC_SHIPSET_ADD_CANCEL message defines the message text.
1334
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
Try it.
You open a second browser window so you can toggle between your design time set up in the Setup and
Maintenance work area and run time rendering in the Order Management work area.
◦ In the Setup and Maintenance work area, click Tasks > Search.
1335
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
Attribute Value
You can also search for Distributed Order Orchestration to examine messages that
Order Management displays primarily during order fulfillment or during interactions
with a web service.
Refine your search. Remove the value from the Application attribute and enter a value in Message Name,
such as DOO_ORCHC_SHIPSET_ADD_CANCEL.
If you don't know the name, then remove the value from the Application attribute and enter a value in the
Module attribute.
Decomposition Preparing a source order for Order Management during order import.
Process Order Order Management starts to process fulfillment. There's usually missing data, attribute
values aren't correct, there's a problem in communicating with other applications
during fulfillment, and so on.
Common Order Management encounters any one of a wide variety of problems. The problem
isn't specific to Order Management. It might occur with other Oracle Fusion
applications. For example, communication with a web service fails, you attempt to use
an application programming interface that Oracle Fusion doesn't support, and so on.
Search is additive. For example, if you set Module to Common and Message Name to
DOO_ORCHC_SHIPSET_ADD_CANCEL, then the search doesn't return anything because
DOO_ORCHC_SHIPSET_ADD_CANCEL isn't in the Common module.
Use a wildcard. For example, enter DOO_% in Message Name to return all messages that start with
DOO_. Here are some abbreviations you might find useful.
1336
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
FOM_% Order Management Cloud. FOM is an abbreviation for Oracle Fusion Order
Management
◦ In the search results, click the line that includes DOO_ORCHC_SHIPSET_ADD_CANCEL in the Message
Name column, then click Actions > Edit.
◦ On the Edit Message page, add your text at the end of the User Details attribute. For example.
Instead, revise the sales order, cancel lines in the shipment set, then submit the order. Wait
for order management to process the revision. Revise the order again, add lines, then submit the
order. Hi there. I am Diane Cho, your order administrator. Please contact me if you need help
with shipping.
Note.
• Don't modify the Message Number. Order Management uses it to uniquely identify the message.
• Examine the Translation Notes. They might contain details that describe when and why a message
displays. Use them to help troubleshoot errors or warnings.
• In general, don't modify predefined text in the Short Text attribute. Each message describes
an error or warning condition. Its important to keep the predefined Short Text to support these
conditions.
• Short Text has a 160 character limit.
• In general, don't modify predefined text in the User Details attribute. If you want to add text, add it
immediately after the predefined text.
◦ Click Save.
3. Test your set up.
1337
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
Create a new message only if you can't find a predefined message that meets your needs.
2. Click Actions > New, then set values.
Attribute Value
Use a format that helps you identify your message and distinguish it from predefined
messages that Order Management and other Oracle Applications display.
application_text_description
where
application. Abbreviation that identifies the application. Use FOM for Oracle Fusion
◦ Order Management, which is an earlier name for Order Management Cloud, orDOO
for Distributed Order Orchestration.
◦ text_description. Describe the purpose of the message. Use underscores to improve
readability.
Here are the modules you typically use when you set Application to Order Management.
◦ Manage Orders
◦ Import Orders
Here are the modules you typically use when you set Application to Distributed Order
Orchestration.
◦ Task Layer
◦ Decomposition
◦ Process Order
◦ Orchestration
1338
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
Attribute Value
Enter any number from 10,000,000 to 10,999,999. The Order Entry Specialist can use this
number when they contact the help desk.
At runtime, the message displays the message name, number, and application abbreviation.
For example.
fom_examine_quantity-fom-10000001
Quantity {QUANTITY} that you entered on the order line exceeds 100.
You can order this quantity, but make sure it is correct before you
submit the sales order.
You use one set of curly brackets ( {} ) to enclose a token. A token is a placeholder for variable
content, such as text or a number. Order Management replaces the token with a value at
run time. In this example, it replaces {QUANTITY} with the number that the Order Entry
Specialist enters in the Quantity attribute on the order line.
Category Product
Severity Low
3. In the Message Tokens area, click Actions > New, then set values.
Attribute Value
Description Number that the Order Entry Specialist enters in the Quantity attribute on the order line.
4. Click Save and Close, and then click Save and Close again.
1339
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
You can use the Substitute Item action or the Check Availability action in a fulfillment view of the Order Management
work area to substitute an item. You can also use Global Order Promising to substitute an item. This topic describes how
to use Global Order Promising.
Note.
• You use the Product Information Management work area to specify the item to substitute at design time.
• At run time, the Order Entry Specialist creates a sales order in the Order Management work area and clicks
Submit.
• Fulfillment fulfills the item.
◦ The scheduling fulfillment task in your orchestration process calls Global Order Promising.
1340
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
◦ Global Order Promising communicates with Inventory Management to determine whether the item is out
of stock.
◦ If its out of stock, and if the Allow Item Substitution attribute on the sales order is Yes, and if Global
Order Promising determines that the substitute item is available, then Global Order Promising sends a
recommendation to Order Management to use it, and Order Management uses the substitute to fulfill the
order line.
Guidelines
• You can use Visual Information Builder to create a pretransformation rule that sets the default value for Allow
Item Substitution to No.
If Order Type is equal to Mixed Orders, then Allow Item Substution is set to No
• If the AS54888 Computer isn't available in inventory, then substitute it with the CN92777 Computer.
Attribute Value
Item AS54888
1341
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
Attribute Value
Type Substitute
Collect Data
1. Go to the Plan Inputs work area, then click Tasks > Collect Planning Data.
2. In the Collect Planning Data dialog, set values.
Attribute Value
3. Move the Item Substitution Relationships reference entity to the Selected Entities window, then click Submit.
4. In the Status dialog, notice the process number. For this example, assume its 50465.
5. Go to the Scheduled Processes work area.
6. On the Overview page, locate 50465 in the Process ID column. Monitor the process until the Status column
displays Succeeded.
7. Refresh the Order Promising server.
◦ Go to the Scheduled Processes work area, then click Action > Schedule New Process.
◦ In the Schedule New Process dialog, set the value.
Attribute Value
For details, see the Collect Planning Data for Order Management topic.
1342
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
Attribute Value
3. Search for the AS54888 on the catalog line, notice that the line displays Out of Stock, then click Add.
4. Notice that the order line contains the AS54888, then click Submit.
5. Click Actions > Switch to Fulfillment View.
6. Verify that Order Management replaced AS54888 with CN92777.
Related Topics
• Specify Supply Details for Sales Orders
• Use Visual Information Builder
• Overview of Collecting Promising Data for Order Management
Order Status
Overview
Orchestration Process Status
An orchestration process status indicates the status of an orchestration process throughout Order Management Cloud.
The value Started is an example status. It indicates that Order Management started the orchestration process.
Order Management finishes the fulfillment tasks of an orchestration process sequentially according to each
orchestration process step when it processes an order.
Order Management comes predefined to use a default set of statuses for fulfillment tasks. You can also set up statuses
and sequences. For example, you can set up an orchestration process that uses a set of statuses and rule logic for
textbooks for a college, and set up another orchestration process that uses a different set of statuses and rule logic for
textbooks for a primary school.
• You must specify the status that Order Management assigns to an orchestration process at each orchestration
process step. For example, if the Schedule School Books task includes a status of Unsourced, then you must
specify the status that Order Management assigns to the orchestration process for this step.
• You must specify a status that indicates when a task done. You can select only a status that you set up to
indicate that a task is done.
• If you modify the name of the default status, then Order Management displays the modified name throughout
the Order Management work area.
• If you don't set up statuses for an orchestration process, then Order Management uses the predefined statuses,
by default.
1343
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
Order Management evaluates the status conditions that you create sequentially at run time. The condition that
evaluates to true, and that includes the highest sequence number, determines the orchestration process status.
Related Topics
• Set Up Orchestration Processes
• Order Management Statuses
Tab Description
Status Codes Specify the display name that Order Management displays in the Order Management work
area.
Fulfillment Lines Create the status values that users can select for a fulfillment line in an orchestration process.
Task Types Assign a status code to a task type. If a system outside of Order Management Cloud provides
the status, then assign this status to the fulfillment task that references this system. For
example, if a shipping system provides the status, then assign the code to the Shipping task
type.
Orchestration Process Classes Assign the status code to fulfillment lines or orchestration processes where Order
Management must use the status.
For example, you can use an orchestration process class to control the status codes that an
administrator can choose when creating a status condition for an orchestration process. You
must use the Manage Status Values page to set the status values and to make them available
when you create a status condition.
Related Topics
• Order Management Statuses
1344
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
Set Ups
Manage Task Status Conditions
Order Management Cloud fulfills each fulfillment task one step at a time when it processes a sales order, and it uses a
predefined set of sequential statuses to track the progress of each task. You can use the Manage Task Status Conditions
page to manage the status conditions that determine the status of these tasks according to task type.
1. On the Manage Task Status Conditions page, in the task list, click the task type that you must manage.
For example, to manage the status conditions when Order Management processes a return, click the row that
contains Return in the Type column.
2. In the Status Conditions list, modify or add new conditions as necessary.
Attribute Description
Internal Status Value Displays a status that Order Management receives from a fulfillment system through a
fulfillment task. For details, see the Task Types topic.
Display Status Value Specifies the value that Order Management displays.
For example, assume your fulfillment system sends a status of Invoiced for a task, but your
company uses Billed. You can set Display Status Value to Billed to display Billed throughout
the Order Management work area.
Mark as Complete If this option contains a check mark, then Order Management considers the task to be done
when it reaches the condition.
For example, assume you click the Return row in the task list on the Manage Task Status
Conditions page, then, in the Status Conditions area, you add a check mark to Mark as
Complete for the Canceled status condition and for the Delivered status condition. In this
example, Order Management considers the task to be done when the task reaches the
Canceled status or the Delivered status.
Related Topics
• Task Services
This topic includes example values. You might use different values, depending on your business requirements.
1345
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
Attribute Value
Code Standard_Class
Name Standard_Class
4. Click Save.
5. In the Status Values area, click Actions > Add Row, then add the value.
Attribute Value
Related Topics
• Order Management Statuses
• Set Up Orchestration Processes
Fulfillment Line
Fulfillment Line Status
Specify the status that your orchestration process assigns to a fulfillment line.
For example, you can specify that if the Schedule School Books task includes a status of Pending Scheduling, then set
the fulfillment line status to Unscheduled.
• The orchestration process step runs fulfillment tasks when it processes the fulfillment line.
1346
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
• The fulfillment line status displays throughout the Order Management work area.
• You can specify different sets of statuses and rules for different items that the fulfillment line references. For
example, specify one set of status conditions for a hard cover book, and another set of status conditions for a
paperback book.
• If you don't create conditions, then Order Management uses the status rule set that it assigns to the default
category.
You might need different fulfillment lines to use different sets of statuses. For example, a fulfillment line you ship, such
as a computer, might need statuses that are different from a fulfillment line you don't ship, such as a warranty.
• Use a category to make sure Order Management applies the same set of status conditions to specific sets of
fulfillment lines. It applies the same status conditions to all fulfillment lines that reference the item that resides
in the category.
• Use catalogs and categories in more than one orchestration process.
• Select the status catalog when you set up your orchestration process.
You can only select a catalog that meets these requirements.
◦ The item exists in only one category in the catalog.
◦ The category contains items or subcategories.
◦ The category doesn't contain items and subcategories.
◦ Order Management controls the catalog only for the master, and not for each organization.
• Use the Product Information Management work area to set up the status catalog.
Note.
• You can use a single status rule set with more than one category. If a parent category and a child category each
reference a different status rule set, then Order Management uses the status rule set that the child references.
Use this feature so you can create an All category to handle all items in one orchestration process. Use it to add
a subcategory for a subset of items that must use a different status rule set.
• If you migrate an orchestration process between environments, such as from a development environment to
a production environment, then don't modify the status rule set name in either environment. Modifying the
name might prevent Order Management from updating references to other data in the orchestration process.
1347
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
Here's an example.
Note.
• You use the Sequence attribute in the Orchestration Process Status Values area on the Status Conditions tab of
the Create Orchestration Process Definition page.
• You set the sequence of the status conditions so they match the logical progress of the status. For example,
Sequence 150 for status Awaiting Shipping occurs before Sequence 160, status Shipped. If Awaiting Shipping
and Shipped each evaluate to true, then the orchestration process sets the status to Shipped because 160 is
higher than 150.
Related Topics
• Order Management Statuses
1348
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
Attribute Value
Code SCHED_GOODS
The Order Management work area will display the value you enter.
4. In the Create Status Code dialog, enter values, then click Save and Close.
Attribute Value
Code SCHED_CLOTHING
1. On the Manage Status Values page, click Fulfillment Lines > Actions > Select and Add.
2. In the Select and Add dialog, in the Status Code attribute, enter SCHED_GOODS, then click Search.
3. Click SCHED_GOODS > OK.
4. Click Actions > Select and Add.
5. In the Select and Add dialog, in the Status Code attribute, enter SCHED_CLOTHING, then click Search.
6. Click SCHED_CLOTHING > OK.
7. Click Save and Close.
You can now set the status value for the fulfillment line in the orchestration process to SCHED_GOODS or
SCHED_CLOTHING.
Related Topics
• Order Management Statuses
1349
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
Status Condition
Add Status Conditions to Orchestration Processes
Add status conditions that specify when to set the status of an orchestration process.
Assume you need an orchestration process that fulfills sales orders for company t-shirts, and you must specify the
statuses that the process uses throughout the order life cycle according to the status of the fulfillment task.
• If the status of the Schedule task is Scheduled, then set the orchestration process status to Scheduled.
You typically add more than one status condition to an orchestration process. For brevity, you will add only one in this
topic.
This topic includes example values. You might use different values, depending on your business requirements.
For details about how to create this process, see the Add Branches to Orchestration Processes topic.
3. On the Edit Orchestration Process Definitions page, set the value.
Attribute Value
You must set up Standard_Class before you can select it. For details, see the Set Up
Orchestration Process Classes topic.
4. Click Save.
1350
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
Attribute Value
Sequence 1
Related Topics
• Add Branches to Orchestration Processes
Assume you must set up orchestration processes that can handle sales orders for different types of t-shirts. You could
use the same orchestration process for different types of merchandise, but you prefer to define statuses for each type of
clothing separately because each clothing type requires a different status. To do this, you select the status catalog, then
add the status conditions for a single category of items in the orchestration process.
You typically create more than one status condition for each fulfillment line. For brevity, in this topic you create only one
status condition for the default category and another status condition for the item.
This topic includes example values. You might use different values, depending on your business requirements.
1351
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
Attribute Value
Attribute Value
Code LargeOrders
1352
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
◦ On the Edit Status Rule Set page, in the Expression column, click the icon.
◦ In the Expression Builder dialog, click CallCustomerWhenLargeInvoice - Schedule, then click Insert
Into Expression. Make sure you don't expand CallCustomerWhenLargeInvoice - Schedule.
Notice that the dialog added a value of "Schedule" in the Expression window of the Expression Builder.
◦ In the Expression window, click anywhere after "Schedule", then enter an equal sign (=).
◦ Expand CallCustomerWhenLargeInvoice - Schedule, click SCHEDULED, then click Insert Into
Expression.
◦ Notice that the Expression window contains "Schedule"="SCHEDULED", then click OK.
10. On the Edit Status Rule Set page, add a check mark to Notify External Systems, then click Save and Close.
Notify External Systems allows Order Management to communicate the status to an external system that
resides outside of Order Management. For details, see the Send Notifications from Order Management Cloud to
External Systems topic.
Attribute Value
Code Shirts
Name Shirts
Related Topics
• Add Branches to Orchestration Processes
• Order Management Statuses
Order Values
1353
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
Order Numbers
Set Up Sequences for Sales Order Numbers
Set up the starting value for your sales order numbers.
In this example, you set up Order Management so it uses 1,000 as the order number for the first order that your users
create on January 1, 2019.
1354
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
This topic includes example values. You might use different values, depending on your business requirements.
1. In the Setup and Maintenance work area, click Tasks > Search, search for, then open Manage Document
Sequences.
2. On the Manage Document Sequences page, search for the value.
Attribute Value
3. In the search results, click Expand, set values, then click Save and Close.
Attribute Value
Display Ignore this attribute. Don't set it. Its for internal use only.
End Date Leave empty. Order Management will continue to increment the sales order number in
perpetuity.
Note.
• Order Management uses the predefined ORA_FOM_DOC_SEQUENCE_AUTO number sequence to create order
numbers, starting with the value you set in Initial Value.
• Each order number is unique.
• The order number is permanent. Order Management doesn't change the order number even if the user
modifies an order attribute.
• If you import orders from a source system through a web service, REST API, a file, or any other way, and if you
set the DOO_RT_USE_ORDER_NUMBER order profile to Y, then Order Management uses order numbers from
your source system and ignores ORA_FOM_DOC_SEQUENCE_AUTO.
• You can't.
◦ Use your own number sequence, except for order numbers you import.
◦ Specify sequence according to determinant type.
◦ Specify gapless or manual sequencing.
Related Topics
• Document Sequences
• Guidelines for Managing Document Sequences
1355
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
Retain Sales Order Number Choose one. Single site and for each user
If you set Retain Sales Order Number to N, then Order Management doesn't use the source order number as the order
number during or after transformation.
• Order Management will assign a new order number for the source order and display the new number
throughout the Order Management work area after transformation and during order fulfillment.
• If the source order number in the source order that you import from the source system isn't unique in the
source system, then you must set this option to N.
For example, if source system A contains two source orders that each use order number 12345, then set this
option to N. If source system A contains one source order that uses order number 12345, and if source system B
contains one source order that uses order number 12345, then set this option to Y or N. This set up is necessary
to avoid an error during order import because Order Management requires a unique order number for each
sales order in the same source system.
• Order Management creates a unique number for each sales order that you create in the Order Management
work area, and each of these orders use Oracle Fusion Order Orchestration and Planning (OPS) as the source
system.
If you use OPS as your source system, and you if set Retain Sales Order Number to Y, then a conflict might
occur between order numbers. For example, your source system might create a source order with order number
543865, and an order that you create in the Order Management work area might also use order number
543865. You must make sure these order numbers are unique. For example, use a value for your source order
number that isn't numeric, or add a prefix or suffix to the number, such as src_543865.
• The default value is N.
• For details about how to set up a profile option, see the Use Order Profiles to Control Order Management
Behavior topic.
1356
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
Order Management uses the RA_INTERFACE_LINES_ALL table to integrate with Accounts Receivable.
Order Management uses the ORDER_NUMBER column and SOURCE_ORDER_NUMBER column on the
DOO_HEADERS_ALL table to populate columns in RA_INTERFACE_LINES_ALL.
INTERFACE_LINE_ATTRIBUTE1 SOURCE_ORDER_NUMBER
INTERFACE_LINE_ATTRIBUTE3 ORDER_NUMBER
SALES_ORDER SOURCE_ORDER_NUMBER
Order Management sets the ORDER_NUMBER and SOURCE_ORDER_NUMBER in the DOO_HEADERS table to the same
value that it uses in the Order Management work area.
However, if the values that you import are different than what Order Management uses, then you have two choices to
make sure you use the same order number in Order Management and in Accounts Receivable.
• Set the Retain Sales Order Number profile to Y, and Order Management will set ORDER_NUMBER to the same
value that SOURCE_ORDER_NUMBER contains.
• Use a document sequence to set the value in ORDER_NUMBER. For details, see the Set Up Sequences for Sales
Order Numbers topic.
Here's some SQL you can use to identify the line numbers that Order Management assigned to an order line and the
fulfillment line.
SELECT dha.header_id ,
dha.order_number ,
dha.source_order_number ,
dha.submitted_flag,
dla.line_number ,
dla.SOURCE_LINE_NUMBER ,
dla.SOURCE_LINE_ID,
dla. DISPLAY_LINE_NUMBER ,
dfla.SOURCE_LINE_NUMBER ,
dfla.fulfill_line_number
FROM fusion.doo_headers_All dha,
1357
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
fusion.doo_lines_all dla ,
Fusion.doo_fulfill_lines_all dfla
WHERE dha.source_order_number in ('&SOURCE_ORDER1','&SOURCE_ORDER2')
AND dla.header_id = dha.header_id
AND dfla.line_id = dla.line_id
--and submitted_flag = 'Y'
order by dha.SOURCE_ORDER_NUMBER , dla.LINE_NUMBER
Related Topics
• Integrate Order Management with Source Systems
Attribute Values
Control Decimal Precision
Use the Quantity Decimal Precision profile to control decimal precision for attributes that store numeric values.
For example, to control decimal precision on the order line quantity that the Order Entry Specialist sets on the Create
Order page, or to control decimal precision during order import.
Precision is the total number of digits that a number contains, where scale specifies the number of digits that exist to
the right of the decimal point.
You can't modify precision but you can modify scale. For example, if you set the scale to 3 in the Quantity Decimal
Precision profile, and if the Order Entry Specialist enters 17.3468 for the quantity, then the profile will round 17.3468 to
17.347..
Quantity for some items is typically a whole number. For example, most companies sell a desktop computer as a whole
item. Don't use Quantity Decimal Precision to allow only a whole number in the quantity. Instead, you can set the
Indivisible attribute to Yes in the Product Information Management work area when you set up the item.
Attribute Value
1358
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
5. In the search results, in the Profile Values area, set the value, click Save and Close > Done.
Attribute Value
Profile Value 3
You can set decimal precision only at the Site level. You can't set it for each item or for each unit of measure.
6. In the Navigator, click Order Management.
7. On the Overview page, click Create Order.
8. On the Create Order page, in the Select Item window, enter Diamond, then click Search.
9. On the catalog search line, in the quantity window to the left of Gram, set the value to 17.3468, then click Add.
10. Verify that the Create Order page displays a message that it rounded your value to 17.347.
Related Topics
• Manage Rounding Rules
1359
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
Note.
• A list of values is a user interface element that allows your users to choose the value for an attribute. For
example, the user can use a drop down list of values to set the value for the Order Type attribute on the order
header.
• Use the Manage Order Lookups page in the Setup and Maintenance work area to set up the lookup. Set these
attributes.
1360
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
Attribute Description
For example, use lookup type ORA_DOO_ORDER_TYPES to allow the user to choose from a
list of values for the Order Type attribute on the order header.
Lookup Code Specify an abbreviation that represents the meaning. Each code uses one value that the user
can choose in the list of values.
For example, a table in the Oracle database or a web service payload might contain a value of
STD_DS for a standard drop ship sales order. You can set Meaning to the more user-friendly
value Drop-ship Order.
For details about how a web service payload contains coded values, see the Attributes in
Request Payloads That Integrate Order Management topic.
Display Sequence Specify the sequence of the lookup codes in the list of values.
For example, if Sequence is 1 for Standard Orders, 2 for Drop-ship Orders, and 3 for Mixed
Orders, then the list of value displays values in this sequence.
◦ Standard Orders
◦ Drop-ship Orders
◦ Mixed Orders
Related Topics
• Attributes You Can Use with Web Services
1361
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
If the Item attribute contains AS54888, then set the Accounting Rule attribute to Immediate, and the
Invoicing Rule to Arrears Invoice.
Try it.
Attribute Value
1362
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
Item (Order Fulfill Line) indicates that you're referencing the Item attribute on the fulfillment line of the
sales order.
◦ Click Search.
◦ In the Search dialog, search for AS54888, click AS54888 in the search results, then click OK.
◦ In the Create Condition dialog, click OK.
IF item = AS54888
4. Click Then > Do.
5. Create the action for the Accounting Rule attribute.
Attribute Value
Name %
The search result displays all the values that you can use for the attribute you entered, Accounting Rule.
◦ In the search results, click the row that contains 12 Months Fixed, then click OK.
◦ In the Create Action dialog, notice the value.
◦ Click OK.
At run time, if the Item attribute on the order line contains AS54888, then Order Management will set the
Accounting Rule attribute to 12 Months Fixed.
6. Repeat step 5 but this time create an action for the Invoicing Rule attribute.
1363
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
Attribute Value
Related Topics
• Guidelines for Assigning Orchestration Processes
• Overview of Using Business Rules With Order Management
• Manage Pretransformation Rules
Assume that if the order type is Standard orders, then you must set the default value for the legal entity, and you must
do it after you transform the source order.
◦ Do an SQL.
For details, see the Use SQL to Query Order Management Data topic.
1364
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
Try it.
Code Description
Get values for attributes of the order header that the orchestration process is currently
processing from the header virtual object (VO), then store them in the Header variable.
Header.OrderTypeCode is Proceed to the Then statement only if the order type on the order header is Standard Orders.
"Standard Orders"
Make sure you enclose the order type in double quotation marks (" ").
1365
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
Code Description
Assign Header.LegalEntityId = Order Management uses the LegalEntityId attribute to identify the legal entity.
300000001563073
For details about how to create a business rule, see the Overview of Using Business Rules With Order
Management topic.
Attribute Value
Related Topics
• Overview of Using Business Rules With Order Management
• Manage Pretransformation Rules
• Import Shipping Method
• Use SQL to Query Order Management Data
1366
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
Assume you have an agreement with a drop ship supplier where the supplier needs 3 days lead-time to before they
begin processing sales orders that include the AS54888 item for your Computer Service and Rentals customer. To
reflect this requirement, you create a pretransformation rule that moves the Ordered Date out by 3 days.
1367
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
Attribute Value
Name Set the Requested Ship Date for Drop Ship Orders
1368
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
The rules editor adds a row that you can use to do math according to the context of the attribute. For example,
you're modify a date attribute that's measured in days, so the editor lets you add or subtract days.
5. In the next line that displays, set the sign to + (plus) and enter the value 3 in the window.
6. Click OK.
7. Publish and release your rule.
Attribute Value
2. Notice that the Ordered Date on the order head defaults to the current date. Assume the current date is 9/01/20
10:02 PM.
3. Add the AS54888 item to an order line, then click Submit.
4. Notice that the Ordered Date on the order header is now the current date plus 3 days. In this example, verify
that Ordered Date contains 9/04/20 10:02 PM.
Related Topics
• Guidelines for Assigning Orchestration Processes
• Overview of Using Business Rules With Order Management
• Manage Pretransformation Rules
Assume you have a product line that includes a variety of desktop computers. For example, it includes the CN92777
Desktop Computer, which is a configured item. The CN92777 includes a CPU, monitor, keyboard, and mouse. You want
to ship all these components together.
• Use the Standard Order Models order type to indicate that the sales order includes only a configured item.
• Ship all order lines together.
1369
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
• Set the name of the shipment set on each fulfillment line to the order number.
1. If the order type is Standard Order Models, then do the actions in the rule.
2. You typically set the Ship Lines Together attribute on the order header to Yes as the way to make sure Order
Management ships lines together. The name of this attribute in the business rule is Shipset, so in your action
you set Shipset to Yes on the order header.
3. The Source Order attribute in the business rule contains the order number on the order header, so this rule sets
the name of the shipment set to the order number. In this example, the order number is 521417.
1370
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
Related Topics
• Guidelines for Assigning Orchestration Processes
• Overview of Using Business Rules With Order Management
1371
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
1372
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
If the Set Accounting Rule to Immediate flexfield contains Yes, then change the value of the Accounting Rule
attribute to Immediate.
1. You edit the predefined Fulfillment Line Information extensible flexfield. This flexfield displays when you click
Actions > Edit Additional Information on the order line.
2. You create a flexfield context with a display name of Account Rule.
3. You create a flexfield segment with a display name of Set Accounting Rule to Immediate.
4. You create a business rule that determines whether the flexfield segment contains the text Yes.
5. Order Management runs the business rule when you click Submit.
6. If the flexfield segment contains Yes, then the rule sets the Accounting Rule attribute to Immediate.
1373
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
Try it.
1. Go to the Setup and Maintenance work area, then go to the task.
◦ Offering: Order Management
◦ Functional Area: Orders
◦ Task: Manage Order Extensible Flexfields
2. Open the Fulfillment Line Information extensible flexfield for editing.
3. Click Manage Contexts, then add a new one.
Attribute Value
Code Accounting_Rule
Attribute Value
Attribute Value
Code Accounting_Rule_Segment
1374
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
Attribute Value
Description Segment of the extensible flexfield that allows the user to specify whether to set the
Accounting Rule attribute to Immediate.
Instruction Help Text Enter the text Yes, and the sales order will set the Accounting Rule attribute to Immediate.
Attribute Value
Code DOO_FULFILL_LINES_ADD_INFO
Attribute Value
Display Name
FulfillLineEFFInfo
Code FulfillLineEFFInfo
8. Deploy the Fulfillment Line Information flexfield. For details, see the Deploy Extensible Flexfields topic.
1375
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
1376
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
1. Create an If statement, then add your variables. The orchestration process uses virtual objects to read data
from the sales order into these variables at run time.
2. You use the HeaderVO virtual object (VO) to reader header data into the rule, such as values for the Customer
attribute and the Contact attribute.
3. You use the LineVO virtual object to read order line data into the rule, such as the values for the Item attribute
and the Quantity attribute.
This set up can get complex. For details about the code and what it means, including the hierarchy and virtual objects,
see the Patterns for Extensible Flexfields in Business Rules topic.
1377
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
For an example that explains how to create the rule, including stepwise details for establishing a hierarchy and all this
other fancy stuff you need to do, see the Use Extensible Flexfields in Transformation Rules topic.
Code Description
Get values for attributes of the order header that the orchestration process is currently
processing from the Header virtual object (VO), then store them in the Header variable.
Get values for attributes of the order line that the orchestration process is currently processing
from the Line virtual object (VO), then store them in the Line variable.
Header.OrderLine contains Declare the OrderLine variable, then place it under the Header variable.
Line
Copy the contents of the Line variable into the OrderLine variable.
Get values for attributes of the order line that the orchestration process is currently processing
from the FulfillLine virtual object (VO), then store them in the Fline variable.
Line.OrderFulfillLine Declare the OrderFulfillLine variable, then place it under the Header Line.
contains Fline
Copy the contents of the Fline variable into the OrderFulfillLine variable.
This code finishes the hierarchy for your flexfield, which is.
Header
Line
Fline
Get values for attributes of the fulfillment line that the orchestration process is currently
processing from the j_FulfillLineEffDooFulfillLinesAddInfoprivateVO virtual object (VO), then
store them in the flineEFFCat variable.
1378
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
Code Description
Fline.FulfillLineEffCategories Use the FulfillLineEffCategories property to identify the flineEFFCat variable as a flexfield
is flineEFFCat category.
To establish a hierarchy, this code places the flineEFFCat variable under the Fline variable.
flineEFFCat isn't null Avoid a null pointer exception. Make sure the flineEFFCat variable contains a value.
The business rule gets this virtual object from the order line that the orchestration process is
currently processing.
The business rule uses the pattern FulfillLineEffBxxxprivateVO to store details for your context
code, where xxx identifies the context code that you created earlier in this procedure in the
Setup and Maintenance work area. Namely, Accounting_Rule.
flineEFFCat.FulfillLineEffBAccounting_RuleprivateVO
Place the flineEffSgmt variable under the flineEFFCat variable.
RL.contains flineEffSgmt
This code establishes a hierarchy between the context code and the context segment.
flineEFFCat
flineEffSgmt
flineEffSgmt.Accounting_Rule_Segment
Examine the value of the Accounting_Rule_Segment attribute in the flineEffSgmt variable.
is "Yes"
Recall that Accounting_Rule_Segment is the value that you entered for the Code attribute
when you created the context segment earlier in this procedure in the Setup and Maintenance
work area.
flineEffSgmt.Accounting_Rule_Segment
Avoid a null pointer exception. Make sure the flineEffSgmt variable contains a value.
isn't null
Code Description
1379
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
Code Description
Get values for attributes on the fulfillment line that the orchestration process is currently
processing from the j_FulfillLineEffDooFulfillLinesAddInfoprivateVO virtual object (VO), then
store them in the flineEFFCat variable.
Fline.FulfillLineEffCategories Use the FulfillLineEffCategories property to identify the flineEFFCat variable as a flexfield
is flineEFFCat category.
To establish a hierarchy, place the flineEFFCat variable under the Fline variable.
flineEFFCat isn't null Avoid a null pointer exception. Make sure the flineEFFCat variable contains a value.
Code Description
The business rule gets this virtual object from the order line that the orchestration process is
currently processing.
The business rule uses the pattern FulfillLineEffBxxxprivateVO to store details for your context
code, where xxx identifies the context code that you created earlier in this procedure in the
Setup and Maintenance work area. Namely, Accounting_Rule.
flineEFFCat.FulfillLineEffBAccounting_RuleprivateVO
Place the flineEffSgmt variable under the flineEFFCat variable.
RL.contains flineEffSgmt
This code establishes a hierarchy between the context code and the context segment.
flineEFFCat
flineEffSgmt
flineEffSgmt.Accounting_Rule_Segment
Examine the value of the Accounting_Rule_Segment attribute in the flineEffSgmt variable.
is "Yes"
Recall that Accounting_Rule_Segment is the value that you entered for the Code attribute
when you created the context segment earlier in this procedure in the Setup and Maintenance
work area.
1380
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
Code Description
flineEffSgmt.Accounting_Rule_Segment
Avoid a null pointer exception. Make sure the flineEffSgmt variable contains a value.
isn't null
Code Description
Assign The AccountingRuleId has a set of numeric values. Each value represents an accounting rule.
Fline.AccountingRuleId = 11 The value 11 represents Immediate.
Related Topics
• Overview of Setting Up Extensible Flexfields in Order Management
• Set Up Extensible Flexfields in Order Management
• Deploy Extensible Flexfields
• Patterns for Extensible Flexfields in Business Rules
• Use Extensible Flexfields in Transformation Rules
1381
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
1382
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
Attribute Value
To Currency USD
Oracle Fusion Applications come with a number of predefined conversion rates. Search for the one you need.
Create a new one only if you can't find a predefined rate that meets your needs.
4. Examine the search results.
1383
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
This example illustrates how Oracle Fusion automatically adjusts the conversion to match the daily rate, which
might change each day in reply to market conditions. Notice that the range changed from 0.748816 to 0.815302
on 1/6/21.
You can also change the daily rate to meet your needs.
For details, see the Manage Currency Conversion Lists topic.
5. Collect data.
If your deployment depends on the daily rate, and if you don't use a currency conversion list, then you must
collect the Currencies entity at least one time each day so Order Management can use the current rate. Set up
collections so it collects the Currencies entity automatically each day. For details, see the Collect Planning Data
for Order Management topic.
Attribute Value
This value is an earlier name for Order Management Cloud. Oracle Fusion still uses it for
Order Management.
Attribute Value
Notice that Corporate is the same value that you examined in the Rate Type attribute on the
Currency Rates Manager page.
1384
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
Attribute Value
Attribute Value
Notice that US Dollar is the same value that you examined in the To Currency attribute on the
Currency Rates Manager page.
Attribute Value
Item AS54888
Quantity 10
Price 5010.00
Attribute Value
50,100.00 equals the Quantity of 10 multiplied by the Selling Price of 5010.00 each.
1385
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
Attribute Value
37,515.68 equals the Quantity of 10, multiplied by the Selling Price of 5010.00 each,
multiplied by the currency conversion rate of 0.748816.
Related Topics
• Job Roles and Duty Roles That You Use to Implement Order Management
• Manage Currency Conversion Lists
• Collect Planning Data for Order Management
1386
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
You create a rule that references the hazardousMaterialFlag attribute in Product Information Management.
For details about how to create a business rule, see the Overview of Using Business Rules in Order Management topic.
Do it.
1387
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
Attribute Value
The phrase Item Definition indicates that the attribute resides on an item definition in Product
Information Management.
◦ Set the operator to Is Equal To.
◦ Enter Y, then click OK.
3. Create the Do statement.
The phrase Order Fulfill Line indicates that the orchestration process you set will process order fulfillment
lines.
4. Search for your orchestration process.
For this example, assume you already created and deployed this orchestration process. If you didn't
deploy, then Search won't find it.
◦ Click the row in the search results.
◦ Click OK.
◦ In the Create Action dialog, click OK.
5. Activate and publish your rule.
Related Topics
• Guidelines for Assigning Orchestration Processes
• Overview of Using Business Rules With Order Management
1388
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
Get Values from Product Information Management and Use Them to Set Values on
Sales Orders
Create a business rule that gets a value for your item from the Product Information Management work area, then use it
to set the default value for an attribute on the sales order.
Here's an example of how it works.
1. Use the Product Information Management work area to set values for the attributes you need to reference.
1389
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
2. Use the Setup and Maintenance work area to create a business rule that gets the values from Product
Information Management and uses them to set default values for attributes on the sales order in the Order
Management work area.
3. At run time, use the Order Management work area to create the sales order and Order Management
automatically sets the attribute values.
Here's the example pretransformation rule you will create.
If the Order Entry Specialist adds the AS54888 item to an order line, then set the default value for the
Accounting Rule attribute on the order line to the same value that the Accounting Rule attribute contains for
the item in Product Information Management, and set the value for the Invoicing Rule on the order line to the
same value that the Invoicing Rule attribute contains for the item in Product Information Management.
This topic includes example values. You might use different values, depending on your business requirements.
1390
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
Do it.
1. Sign into Oracle Fusion Applications with a user role you can use to administer Product Information
Management.
If you don't sign in with this user role, then the Product Information Management work area won't display your
product details and you can't do this procedure.
2. Go to the Product Information Management work area.
3. Click Tasks > Manage Items, then search for the value.
Attribute Value
Item AS54888
1391
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
Attribute Value
7. Collect data. For details, see the Collect Planning Data for Order Management topic.
1392
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
1393
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
Attribute Value
Item (Order Fulfill Line) indicates that you're referencing the Item attribute on the fulfillment line of the
sales order.
◦ Click Search.
◦ In the Search dialog, search for AS54888, click AS54888 in the search results, then click OK.
◦ In the Create Condition dialog, click OK.
IF item = AS54888
5. Create the Then statement.
Accounting Rule (Item Definition) indicates that you're referencing the Accounting Rule attribute of the
item in the Product Information Management work area.
Set the Accounting Rule attribute on the fulfillment line of the sales order to the value that the
Accounting Rule attribute contains for the item in the Product Information Management work area
◦ Click OK.
1394
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
◦ Click Attribute.
◦ In the window that contains the text Attribute, enter Invoicing Rule, then click Invoicing Rule (Item
Definition).
Invoicing Rule (Item Definition) indicates that you're referencing the Invoicing Rule attribute of the item
in the Product Information Management work area.
Set the Invoicing Rule attribute on the fulfillment line of the sales order to the value that the
Invoicing Rule attribute contains for the item in the Product Information Management work area
◦ Click OK.
7. Activate and publish your rule. For details about how, see the Manage Pretransformation Rules topic.
Attribute Value
6. Go to the Product Information Management work area and change the value of the Accounting Rule to
Immediate.
7. Collect data.
8. Create another sales order and verify that Accounting Rule defaults to Immediate.
Related Topics
• Guidelines for Assigning Orchestration Processes
• Overview of Using Business Rules With Order Management
• Manage Pretransformation Rules
Constraints
1395
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
Processing Constraints
Create a processing constraint to control the modifications that you can make on a sales order.
A processing constraint is a rule that controls who can change a sales order, what can change in the sales order, and
when the change can occur. For example.
• If an Order Entry Specialist attempts to submit or modify a sales order, order line, or fulfillment line, and if a
processing constraint doesn't allow the submit or change, then Order Management rejects it and displays a
message.
• If a source system attempts to submit or modify a sales order, then Order Management rejects it and sends a
return message.
• Order Management also uses predefined processing constraints to make sure each fulfillment request includes
the attributes that it needs to process the request.
Examples
Reject a change when the sales order Assume an orchestration process achieves the shipping stage for a sales order, and a user
is shipping. submits a change.
Create a constraint that rejects the change after the orchestration process has achieved the
shipment step.
Reject each sales order that doesn't Assume your company doesn't deliver items to an address that doesn't include a ship-to
include required attributes. contact.
Create a constraint that rejects the sale order when it doesn't include a ship-to contact.
Reject a change that requires Assume your company doesn't allow the Order Entry Specialist to submit a change if the
approval. transaction value exceeds $10,000, and if a manager hasn't approved the change.
Create a processing constraint that rejects a change when all of these conditions are true.
1396
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
Part Description
Role The job role that the constraint doesn't allow to make the change.
For example, you can constrain an Order Entry Specialist from changing a sales order when the
orchestration process proceeds beyond a step that you specify.
Action The action that the constraint doesn't allow. You can constrain the user from doing these
actions.
• Create
• Validate
• Update
• Split
• Submit
• Cancel
• Delete
Condition The condition that the constraint evaluates to determine whether to apply the constraint.
For example, you can create a condition that applies a constraint when Order Management
submits a sales order.
How It Works
A processing constraint applies this logic.
• If the validation rule set is true, and if the user attempts an action on the record set that the processing
constraint prevents, then constrain the operation and display a message.
1397
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
Consider an example.
1398
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
Another Example
Consider the predefined Shipping Method on Order Header Isn't Valid processing constraint.
If This Applicable Role Attempts to Do On This Constraint And If This Validation Reject the Change
This Constrained Entity Rule Set is True and Display This
Operation Message
All Submit Order Header Shipping Method on You can't submit the
Order Header Isn't sales order because
Valid the combination of
the mode of transport,
service level, and
carrier that determines
the shipping method
on the order header
isn't valid.
The Shipping Method on Order Header Isn't Valid rule set looks at the mode of transport, service level, and carrier
on the order header. If one of these attributes contains a value, then all of them must contain a value. If one of them
contains a value but not all of them do, then the rule set evaluates to true and the processing constraint prevents the
submit.
Object Description
In this example, a predefined validation rule set named Order is Closed examines the Open
attribute on the order header to determine whether the value is N.
1399
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
Object Description
Note.
• Use the validation rule set to restrict the validation that the constraint does to lines that
meet the condition that you specify, such as lines that are billed.
• The validation rule set prevents the constraint from examining all lines, which might
degrade performance.
• Create the validation rule set before you create the constraint.
• You can't modify or delete a predefined validation rule set, but you can create a new
one.
• You can apply a processing constraint when the condition is true or isn't true.
• You can't enter a value that contains a ~ (tilde) when you create a validation rule
set because Order Management uses the tilde as a delimiter when it evaluates the
constraint rule at run time.
You might also encounter this problem at run time with some order attributes. For
example, a shipping instruction might contain a tilde.
Record set A set of records that Order Management groups according to common attribute values so it
can evaluate a constraint.
For example, to evaluate all sales orders for a customer, specify to evaluate one of these
entities when you create the record set.
• Order header
• order line
• Order fulfillment line
You can then select an attribute to refine the record set. For example, to evaluate all sales
orders for a customer, select the Order Header entity, then select the Sold-to Customer
attribute.
A validation rule set and a record set work together to create the conditions where the
constraint constrains the action.
You must create your validation rule set and record set first, then create the constraint.
Constraint entity The business object or orchestration process that the constraint constrains.
For example, an order header, or an attribute of an order header, such Latest Acceptable Ship
Date.
Constraint package A set of triggers that Order Management applies to a table in an Oracle database. A
background process sets triggers when you create a constraint package.
• Use the Manage Processing Constraints page or run the Generate Constraint Packages
scheduled process.
1400
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
Object Description
• Create or modify a record set or a validation rule set that's of a table type.
You don't need to create a constraint package for a validation that isn't a table type.
Constraint Name
Here are the text strings that you can use in the constraint name.
PAYMENT Payment.
PRICING Pricing.
Constraint name doesn't include Screen for all types during order validation.
GTM, PAYMENT, or PRICING
The text style in the text string isn't case-sensitive. For example, use GTM, Gtm, gtm, gtM, and so on.
You can place the text string anywhere in the constraint name.
More
Note.
• If you set up a constraint that doesn't include a condition, then the constraint is always true. For example, the
predefined processing constraint that prevents the Order Entry Specialist from deleting a sales order prevents
deletion in all situations.
• You can use a constraint with an extensible flexfield.
• You can write a constraint for a sales credit. For example, write a constraint that prevents the user from
updating the sales credit if Order Management already shipped the order line. You can't write a a validation rule
set that constrains a sales credit. For example, you can't write a constraint that prevents the user from updating
the warehouse if the sales credit empty.
• For details about how to use a constraint to manage change, including how to set up AND and OR conditions,
see the Guidelines for Managing Change That Occurs During Order Fulfillment topic.
1401
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
Constraint Entities
A constraint entity is the view or orchestration process that a processing constraint constrains.
View Constrain change according to the value of an attribute that a user can view in the Order
Management work area.
Here are the types of view constraint entities you can choose.
For example, if you set Order Header as the constraint entity, then the constraint constrains
changes according to the order header.
Use a predefined view constraint entity, but you can't create a new one.
The Attribute Details list on the Manage Constraint Entities page displays when you choose a
view constraint entity. Use it to choose the attributes to constrain.
Process Constrain an action from occurring at some point in an orchestration process, such as updating
an attribute or deleting a table entity, according to a combination of orchestration process,
task, and service.
For example, the Update Shipping task layer service references the OrderOnlyProcess
constraint entity. Here's what OrderOnlyProcess specifies.
• Considers the current position of the transaction in the orchestration process flow.
• Can validate required attributes for a fulfillment request, such as a Create Shipment
request, Update Shipment request, or Create Reservation request.
You can use a predefined process constraint entity or create a new one.
1402
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
This topic includes example values. You might use different values, depending on your business requirements.
Attribute Value
Description A record set created on fulfillment lines that belong to the same customer.
3. In the Fulfillment Lines That Belong to Same Customer area, click Actions > Add Row, then set the value.
Attribute Value
For example.
1403
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
The concurrent request to generate constraints validation packages was submitted. Request ID: 10650.
Attribute Value
Description The validation rule set for lines with status Awaiting Shipment.
3. In the Shipment Validation Rule Set area, click Actions > Add Row, then set values.
Attribute Value
If you enter your own attribute, then you must enclose the string with double quotation
marks (" ").
1404
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
Attribute Value
3. In the Shipping Constraint area, in the Conditions list, click Actions > Add Row, then set values.
Attribute Value
Group Number 1
Message You can't update the fulfillment line because its in the shipping stage.
4. In the Shipping Constraint area, click Applicable Roles, make sure All Roles is enabled, then click Save.
1405
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
The Manage Constraint Entities page displays view constraint entities and process constraint entities. Order
Management can constrain changes to any process constraint entity, so it isn't necessary to enable them for
constraint.
3. In the Search Results, click the constraint entity that displays the attribute you must constrain.
For example, to constrain changes to Latest Acceptable Ship Date on the order header, in the Display Name
column, click Order Header.
4. In the Attribute Details list, in the row that contains Latest Acceptable Ship Date in the Attribute column, add a
check mark to the Constraint Enabled option.
• Use the Manage Constraint Entities page to enable an extensible flexfield so you can use it on the Manage
Processing Constraints page.
• Extensible flexfields aren't available on the Attributes menu of the Record Sets tab.
• You must enable an extensible flexfield before you can use it.
• A processing constraint prevents changes to the order line after Order Management closes the line. If you
set up an extensible flexfield on the order line, and if you don't constrain the extensible flexfield, then the
constraint doesn't prevent the user from changing the value in the extensible flexfield.
1406
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
This topic uses example values. You might use different values, depending on your business requirements.
Attribute Value
4. In the Details area, click Actions > Add Row, set values, then click Save.
1407
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
Attribute Value
Value String N
Order Management activates the validation rule set so you can use it in your constraint.
If you add more than one line in the Details area of a validation rule set, then Order Management evaluates them
together.
If you select two context and segment attributes, then the attributes must use the same context value. The context is
mutually exclusive. Consider this example.
Context Segment
Dealer Information ID
Warranty Information ID
You can't simultaneously select segment ID for the Dealer Information context and for the Warranty Information
context.
Attribute Value
1408
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
Attribute Value
2. In the Details area, click Actions > Add Row, set values, then click Save.
Attribute Value
Scope Any
Related Topics
• Overview of Using Extensible Flexfields in Order Management
• Deploy Extensible Flexfields
Assume you created the CARRIER_UPDATE_NOT_ALLOWED constraint at some earlier point, and now must modify it.
Here are its current values.
1409
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
Attribute Value
If the status says Processing, then wait for it to finish. If the status says Ready for Download, then click Ready
for Download.
8. On the Export Setup Data to CSV File Results page, click Actions > Download > CSV File Package.
9. In the dialog that displays, choose the option to save as a file, then click OK.
10. Use your browser to access the download location. It depends on your browser. For example, in Firefox, click the
down arrow on the top banner.
11. Notice that the download creates a single .zip file that contains several .csv files. Extract these files to a folder of
your choice.
Attribute Value
ORA_DOO_CONSTRAINT_SETUP.ConstraintName
CARRIER_UPDATE_NOT_ALLOWED
RoleCommonName ORDER_ENTRY_SPECIALIST
1410
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
Attribute Value
ORA_DOO_CONSTRAINT_SETUP.ConstraintName
sru_shippingmeth
RoleCommonName ORDER_MANAGER
Attribute Value
8. Expand the Business Objects area, then click the arrow in the Go to Task column.
9. On the Manage Processing Constraints page, verify that you can see the role you added.
Note
• The export doesn't export predefined processing constraints. It only exports constraints that you create. So,
if the Predefined option on the Manage Processing Constraints page contains a check mark, then you can't
modify any part of the constraint.
• The Manage Processing Constraints task in the Setup and Maintenance work area manages the relationships
for you, such as between the constraint, conditions, rule set, record set, and so on. If you import or export, then
you must manage these relationships manually in the .csv files.
• Import and export the entire package of .csv files as a single .zip file. This will help maintain relationships
between files. Don't import and export individual .csv files or a subset of them.
• Only import data that exists in Oracle Fusion applications. For example, if you import a role named MY_ROLE,
then make sure MY_ROLE exists in Oracle Fusion applications and that its active. If necessary, use the Security
Console to add the role and make it active, or don't include the role in your import file. If you include the role,
then make sure it matches the value of the RoleCommonName attribute from the Security Console.
1411
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
File Description
ASM_SETUP_CSV_METADATA.xml Contains the metadata for the virtual object that the download creates. You must not modify
this file.
DOO_CHANGE_CONSTRAINT_DEF.csv Contains all the record sets that you create or reference from your constraints.
ORA_DOO_CONSTRAINT_ASSIGN.csv Creates a relationship between each constraint on the Constraints tab and the roles in the
Constrained Roles area of the Constraints tab.
ORA_DOO_CONSTRAINT_CONDITION.csv Creates a relationship between each constraint on the Constraints tab of the Manage
Processing Constraints page, such as Constraint Name, and data on the Conditions tab, such
as Group Number, Message, Enabled, and so on.
ORA_DOO_CONSTRAINT_EXCLUSION.csv Creates a relationship between each constraint on the Constraints tab and the roles in the
Excluded Roles area of the Constraints tab.
ORA_DOO_CONSTRAINT_RECORD_SET_COLUMN.csv
Contains a record set that you use for a conditional constraint.
ORA_DOO_CONSTRAINT_SETUP.csv Contains details for each constraint from the Constraints tab of the Manage Processing
Constraints page, such as the Constraint Name, Constrained Operation, Enabled, On Operation
Action, Applicable Roles, and so on.
It also contains other attributes that you can't set on the Manage Processing Constraints page,
such as the effective dates.
The .csv file contains these columns but the Manage Processing Constraints page doesn't.
Remove these columns from the .csv file.
ORA_DOO_CONSTRAINT_VALIDATION_TEMPLATE.csv
Creates a relationship between the constraints and the validation rule sets.
Contains details from the Validation Rule Sets tab of the Manage Processing Constraints page,
such as the Short Name, Validation Type, and so on.
ORA_DOO_CONSTRAINT_VALIDATION_TEMPLATE_COLUMN.csv
Creates a relationship between constraints on the Constraints tab and data in the Details area
of the Validation Rule Sets tab, such as Attribute Name, Validation Operation, and Value String.
Related Topics
• Overview of Using Extensible Flexfields in Order Management
• Deploy Extensible Flexfields
Shipping
1412
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
• If the source order header includes PMC, then set the default value for Scheduled Ship Date to the current date.
Note.
1413
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
The orchestration process uses shipping attributes when it orchestrates shipment during fulfillment.
• Carrier
• Method of Transport
• Service Level
INSTANCE CODE ENTITY NAME ATTRIBUTE NAME SOURCE VALUE TARGET VALUE
LEG WSH_MODE_OF_TRANSPORT
LOOKUP_CODE AIR 39
1414
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
Next, get details about the service level and mode of transport. Query according to the lookup codes from the result of
your first query.
SELECT
lookup_code
, lookup_type
, meaning
, enabled_flag
, start_date_Active
, end_date_Active
FROM
MSC_SR_LOOKUP_VALUES_vl
WHERE LOOKUP_CODE IN (15,39)
order by
lookup_code;
39 WSH_MODE_OF_TRANSPORT
Air Y 01-JAN-59 Not applicable
Next, get details about the carrier. Query according to the lookup code for the carrier from the result of your first query.
SELECT
tp_id
, partner_name
, party_id
FROM FUSION.MSC_GLOBAL_TRADING_PARTNERS
where tp_id = 32512;
Related Topics
• Overview of Using Business Rules With Order Management
• Use Visual Information Builder
• Use SQL to Query Order Management Data
1415
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
For details about the shipping method, see the Import Shipping Method topic.
Attribute Value
2. On the catalog line, search for, then add the AS54888 item.
3. Click Shipment Details > General, then set values.
Attribute Value
4. Click Save, then notice the order number. In this example, assume its 521495.
5. Do an SQL.
SELECT SOLD_TO_PARTY_ID ,
source_order_number ,
order_number ,
CARRIER_ID ,
SHIP_MODE_OF_TRANSPORT,
SHIP_CLASS_OF_SERVICE
FROM doo_headers_all
& ORDER_NUMBER='521495'
ORDER BY creation_Date DESC;
For details, see the Use SQL to Query Order Management Data topic.
Attribute Value
SHIP_MODE_OF_TRANSPORT 119
SHIP_CLASS_OF_SERVICE 145
1416
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
Attribute Value
CARRIER_ID 43061
SOLD_TO_PARTY_ID 300000001469001
1417
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
At run time, if you create a sales order and set the Customer attribute to Computer Service and Rentals, then the
posttransformation rule uses the Assign actions that you specify to set the Shipping Method attribute to USPS Air
Express.
Try it.
Use two browsers. One for end-user tasks and the other for administrative tasks. This way, you can toggle back
and forth during setup and testing.
2. Go to the Setup and Maintenance work area, then go to the task.
Code Description
Get values for attributes of the order header that the orchestration process is currently
processing from the header virtual object (VO), then store them in the Header variable.
Header.SoldToPartyId isn't Make sure the value of the SoldToPartyId attribute on the order header contains a value.
null
Header.SoldToPartyId is Make sure the value of the SoldToPartyId attribute on the order header contains the value
300000001469001 300000001469001.
This value identifies the Computer Service and Rentals customer that you identified when
you ran the SQL.
Note.
◦ Add a check mark to the Advanced Mode option when you create the rule.
◦ Add the two conditions.
◦ Add a check mark to the square box on each condition, then, above Header.SoldToPartyId, click
Surround, and verify that the rule adds a pair of parentheses ( ) that surrounds the conditions.
This set up makes sure the rule evaluates the conditions with AND logic. If both conditions evaluate
to true, then the rule will assign the values that you specify in the Then section. If you don't add the
parentheses, then the rule evaluates the conditions with OR logic, which you don't want.
5. In the Then area, add three Assign actions.
1418
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
Code Description
Header.ShipModeOfTransport Set the mode of transport to the value you identified from the SQL query. In this example, 119
= 119 means Air.
Header.ShipClassOfService = Set the mode of transport to the value you identified from the SQL query. In this example,
145 145 Express.
Header.CarrierId = 43061 Set the mode of transport to the value you identified from the SQL query. In this example,
43061 means USPS.
Attribute Value
2. Click Shipment Details > General, then verify that Order Management automatically set the value.
Attribute Value
Related Topics
• Overview of Using Business Rules With Order Management
• Manage Pretransformation Rules
• Import Shipping Method
• Use SQL to Query Order Management Data
1419
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
For details, see the Use SQL to Query Order Management Data topic.
◦ In the query result, locate the row that contains Vision Operations in the BU_NAME column. Assume the
query returns these values.
BU_NAME ORGANIZATION_ID
1420
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
ORDER BY haotl.NAME,
◦ In the query result, locate the row that contains M5 - Denver Manufacturing in the ORGANIZATION_CODE
column. Assume the query returns these values.
ORGANIZATION_CODE ORGANIZATION_ID
1421
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
Note.
• To create the And logic in the If area, add the Header.SourceOrderId is 300000001616323 test, then to the right of
Header is a PosttransformationRules.HeaderVO, click Add Pattern.
• At run time, if you create a sales order and set the Business Unit attribute on the order header to Vision
Operations, then the posttransformation rule uses the Assign action that you specify to set the Warehouse
attribute to M5 - Denver Manufacturing.
Try it.
1. Open another browser.
1422
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
Use two browsers. One for end-user tasks and the other for administrative tasks. This way, you can toggle back
and forth during setup and testing.
2. Go to the Setup and Maintenance work area, then go to the task.
Code Description
Get values for attributes of the order header that the orchestration process is currently
processing from the header virtual object (VO), then store them in the Header variable.
Header.SourceOrgId is Make sure the value of the SourceOrgId attribute on the order header contains
300000001616323 300000001616323.
This value identifies the Vision Operations business unit that you identified when you ran the
SQL.
Order Management uses the SourceOrgId attribute to identify the business unit.
Code Description
Header.FulfillOrgId = Order Management uses the FulfillOrgId attribute to identify the warehouse.
300000001621783
This value identifies the M5 - Denver Manufacturing warehouse that you identified when you
ran the SQL.
For details about how to create a business rule, see the Overview of Using Business Rules With Order
Management topic.
1423
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
Attribute Value
2. Click Shipment Details > Supply, then verify that Order Management automatically set the value.
Attribute Value
Related Topics
• Overview of Using Business Rules With Order Management
• Manage Pretransformation Rules
• Import Shipping Method
• Use SQL to Query Order Management Data
See instructions on the worksheet for format requirements. For details about how to use the worksheet, see the
Guidelines for Importing Orders into Order Management topic.
Assume you generally require 3 days to finish shipping for an item, so you set the PromiseArrivalDate so it happens 3
days after RequestedShipDate.
<ns2:Line>
<ns2:RequestedShipDate>2021-04-26T09:42:00</ns2:PromiseArrivalDate>
<ns2:PromiseShipDate>2021-04-26T09:42:00</Ns2:PromiseShipDate>
<ns2:PromiseArrivalDate>2021-04-29T09:42:00</ns2:PromiseArrivalDate>
For details, see the Web Services You Can Use to Integrate Order Management topic.
1424
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
For an example that uses the createOrders operation, see the Import Returns When Original Order Lines Are Split topic.
You use the Setup and Maintenance work area to create a pretransformation rule. Order Management runs the rule on
each standard sales order at run time.
1425
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
They say.
• Set the Promised Arrival Date on the fulfillment line to the value that the Requested Ship Date attribute on the
fulfillment line contains, plus 3 days.
• Set the Promised Ship Date on the fulfillment line to the value that the Requested Ship Date attribute on the
fulfillment line contains.
Try it.
1426
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
Attribute Value
Attribute Value
1427
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
◦ Verify that the Promised Arrival Date happens 3 days after Requested Ship Date.
◦ Verify that the Promised Ship Date equals the Requested Ship Date.
Related Topics
• Overview of Using Business Rules With Order Management
• Import Different Kinds of Data
• Web Services You Can Use to Integrate Order Management
• Import Returns When Original Order Lines Are Split
Assume you must set the value of the ScheduleShipDate attribute to the value that the RequestShipDate attribute
contains when you create an order revision.
1428
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
1429
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
Try it.
1430
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
Code Description
Get values for attributes of the order header that the orchestration process is currently
processing from the header virtual object (VO), then store them in the Header variable.
Get values for attributes of the order line that the orchestration process is currently
processing from the line virtual object (VO), then store them in the line variable.
header.OrderLine isn't null Make sure the order line contains a value.
header.OrderLine Declare the OrderLine variable into the rules language (RL) dictionary, then set the value of
RL.contains line OrderLine to the value that the line variable contains.
This condition makes sure the OrderLine variable references the fulfillment line that the
orchestration process is currently processing. It also makes sure you correctly declare the
variable into the dictionary.
You use it to examine all lines in the sales order, not only the line that the current
orchestration process instance is processing.
Get values for attributes of the fulfillment line that the orchestration process is currently
processing from the virtual object (VO) for the fulfillment line, then store them in the fline
variable.
line.OrderFulfillLine Make sure the line.OrderFulfillLine fact contains data from the fline variable.
RL.contains fline
header.ChangeVersionNumber Proceed to the Then statement only if you're revising the sales order.
isn't 1
If the ChangeVersionNumber attribute on the order header equals 1, then the sales order
isn't a revision.
1431
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
Code Description
fline.ScheduleShipDate = Set the value of the ScheduleShipDate attribute in the fline variable to the value that the
fline.RequestShipDate RequestShipDate attribute contains in the fline variable.
For details about how to create a business rule, see the Overview of Using Business Rules With Order
Management topic.
Attribute Value
1432
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
For example.
Related Topics
• Overview of Using Business Rules With Order Management
• Manage Pretransformation Rules
• Import Shipping Method
• Use SQL to Query Order Management Data
1433
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
1434
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
<ns2:ScheduleShipDateTime>2016-12-20T10:10:10</ns2:ScheduleShipDateTime>
<ns2:ScheduleArrivalDateTime>2016-12-20T10:10:10</ns2:ScheduleArrivalDateTime>
<ns2:ShippingCarrier>DHL</ns2:ShippingCarrier>
<ns2:ShippingServiceLevel>2nd day air</ns2:ShippingServiceLevel>
<ns2:ShippingMode>Air</ns2:ShippingMode>
<ns2:ShipSetName>SS1</ns2:ShipSetName>
Note.
• Use the ShipSetName attribute to specify the shipment set. Include the attribute in the Line hierarchy. This
example sets the name to SS1, and its part of the hierarchy for source transaction line 101. It adds line 101 to
shipment set SS1.
• Set ShipSetName to the same value in each line that you need in the set. Assume your set includes lines 101
and 102. Set ShipSetName in line 102 to SS1.
• Make sure each line that's part of the shipment set uses the same value for attributes that affect the set, such
as Warehouse. For a list of these attributes, see the Ship Order Lines in Shipment Sets topic.
• To get the complete payload for this example, go to White Papers for Order Management
Cloud (Doc ID 2051639.1) at https://support.oracle.com/epmos/faces/DocumentDisplay?
_afrLoop=472607338634463&id=2051639.1. Download the Payloads and Other Files That Support
Implementation attachment. Open the attachment then open source_order_with_shipment_set.txt.
Related Topics
• Cancel Order Lines That Remain in the Same Status
• Ship Order Lines in Shipment Sets
Delays
Jeopardy Priority
Jeopardy indicates the severity of a delay of a task in an orchestration process. You can modify the predefined range of
jeopardy scores for a jeopardy priority to control how Order Management calculates and displays jeopardy.
For example, you can set a minimum score of 0, and a maximum score of 100 for the Low jeopardy priority.
Note.
• You can use jeopardy on planned dates or on actual dates. This set up allows an order manager to become
aware that a jeopardy condition might exist before it actually occurs, and to take action to fix the condition and
reduce jeopardy.
• You can't add or delete a jeopardy priority.
• You can't modify the value of a predefined jeopardy priority, such as Low.
To get details about jeopardy and how it works, see the Jeopardy Score topic.
Related Topics
• Jeopardy Score
1435
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
Jeopardy Threshold
Set up a jeopardy threshold to measure and monitor an orchestration process.
Set up a set of ranges for each fulfillment task of an orchestration process, then assign a score that indicates the
severity of the delay. Order Management uses your set up in the jeopardy attributes that it displays in the Order
Management work area. These attributes help your users to quickly determine the severity of the delay, then take
appropriate action.
You can set up a jeopardy threshold for any combination of these attributes.
• Task type
• Task name
• Process name
• Process version
If you leave these attributes at their default setting of All, then Order Management applies jeopardy threshold to all
fulfillment tasks.
If you apply a jeopardy threshold, then you must first set up the orchestration process, fulfillment task, and task type
that the threshold will reference so you can select these objects when you apply the threshold.
Related Topics
• Jeopardy Score
This topic includes example values. You might use different values, depending on your business requirements.
1436
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
LOW 10 199
Don't.
◦ Overlap scores across priorities. For example, don't set up a Low priority of 10 to 210, and a Medium
priority of 200 to 400. An overlap exists between 200 and 210.
◦ Set up priorities that intersect at the same value. If you set up two priorities that intersect at the same
value, then Order Management assigns the intersecting value to the lower priority.
For example, if you set up Low priority of 10 to 200, and Medium priority of 200 to 400, then Order
Management considers a score of 200 as Low priority.
For this example, search for Orchestration_Process_1. For details about how to create this process, see the
Pause Orchestration Processes Until an Event Occurs topic.
3. On the Step Definition tab, set the Default Lead Time attribute, and set the Lead Time UOM attribute to Days.
Set them for each step.
Schedule Goods 2
Ship Goods 4
1437
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
Prepare Documentation 1
Invoice Goods 3
Attribute Value
Code Enter any text that Order Management can use as an abbreviation for the threshold. Order
Management uses this text as a code to identify the threshold throughout the Order
Management work area, such as in lists.
Process Name Choose the name of the orchestration process where Order Management must apply the
jeopardy threshold.
For details about how to create this process, see the Pause Orchestration Processes Until an
Event Occurs topic.
1438
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
Attribute Value
4. Set the threshold for the Low range of the jeopardy priority. Click Actions > Add Row, then set values.
Attribute Value
Maximum Delay 2
Jeopardy Score Enter a value that resides in the Low range of the jeopardy priority that you modified above,
such as 100.
5. Set the threshold for range Medium of the jeopardy priority. Click Actions > Add Row, then set values.
Attribute Value
Maximum Delay 5
Jeopardy Score Enter a value that resides in the Medium range of the jeopardy priority that you modified
above, such as 300.
6. Set the threshold for the High range of the jeopardy priority. Click Actions > Add Row, then set values.
Attribute Value
Maximum Delay 8
Jeopardy Score Enter a value that resides in the High range of the jeopardy priority that you modified above,
such as 500.
1439
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
Attribute Value
Related Topics
• Orchestration Processes
• Use Case to Pause for an Event
• Guidelines for Setting Up Orchestration Process Steps
Change Orders
Overview
Overview of Managing Change That Occurs During Order Fulfillment
Order Management Cloud comes predefined to process change, but you can modify the set up to meet your needs.
A change order is a change that affects a sales order during order fulfillment. It can come from a variety of sources,
such as from a user through an order capture system, a user who uses the Order Management work area, or from
change orders you import. For example, you might need to make changes to a sales order after you submit it to order
fulfillment.
• Order Entry Specialist uses the Create Order Revision action to revise a sales order or makes changes in
fulfillment views. Order Management doesn't apply order management extensions when the user makes a
change in a fulfillment view. For details, see the Revise Sales Orders That You Already Submitted topic.
• You import change from a channel.
1440
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
A processing constraint is a rule that controls who can change a sales order, what can change in the sales order,
and when the change can occur.
1441
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
Entity Description
Order Header Determine whether a processing constraint on header prevents change, and whether the
sales order is closed.
◦ If a constraint doesn't allow change, or if the order is closed, then reject the entire
change and exit this sequence.
◦ Evaluating order header before evaluating order lines prevents Order Management
from unnecessarily processing a closed sales order.
◦ Order Management evaluates attributes when the user creates the revision, and also
when the user submits the revision to make sure other fulfillment changes didn't
occur that might affect the order.
Fulfillment Line Determine whether constraints on the fulfillment line allow change.
◦ If a constraint doesn't allow change on any fulfillment line, then reject the entire
change and exit this sequence.
◦ Some constraints on a fulfillment line don't allow some changes, by default, such as
updating an order line if fulfillment line status is Shipped.
Order Management does the transformations you set up, such as transforming an attribute value in the source
order to a value that your fulfillment system can understand. For details, see the Transformation Rules topic.
If you create an order management extension that affects a change order, then Order Management finishes
transformation, then runs the extension.
4. Delta?. The delta is the difference between an attribute value in the original sales order and the new value for
the attribute in the change order. For example.
Condition Description
• Uses values you specify on the Order Attributes That Identify Change page.
• Examines predefined attributes that affect the task. You can't specify to examine or not examine
these predefined attributes.
• Examines attributes you add that affect the task. You can specify to examine or not examine
attributes you add.
◦ Identifies orchestration process steps that reference these attributes.
1442
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
◦ Analyzes the state of each step. The orchestration process records the state every time it runs a task.
Order Management compares the change order to the existing sales order to determine whether the
value of the attribute changed.
◦ Uses these state details to determine the processing needed to incorporate the change.
In this example, assume the user changed the quantity, and you specified Quantity as a change attribute, so
Order Management starts compensation.
5. Hold Current Task. If a delta exists, then hold the task that's currently running.
A change order requests to change a sales order that an orchestration process is already processing in order
fulfillment. The orchestration process runs various tasks during order fulfillment, such as schedule, reserve,
ship, or invoice.
For example, assume the orchestration process sent a request to the shipping system to ship the item, is
currently waiting for the shipping system to send a reply, and sets the status to Awaiting Shipping. The change
order might affect shipping, so Order Management sends a request to the shipping system to temporarily stop
processing the task.
Stopping the task allows Order Management to finish the change and prevent the shipping system from
shipping the sales order without the changes that the change order requests.
If the fulfillment system can't accommodate the change, then it replies with a rejection, and the sequence ends.
For example, if the fulfillment system already shipped the sales order, then its too late to accommodate the
change. Instead, the Order Entry Specialist must create a return order to make the requested changes.
6. Merge. Merge the change order into the sales order that the orchestration process is currently processing.
7. Compensate.
Compensate
A compensation pattern is a rule that you set up on an orchestration process step that specifies adjustments to make
when an order changes.
For example.
1443
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
1. Check for Delta. Determine whether a delta exists that affects the current task. For example, if the current task
is reservation, and if a delta exists for the Quantity attribute, then the delta affects the reservation task because
the orchestration process must adjust the reserved quantity so it reflects the change order.
If the delta determines that an attribute requires compensation, then the orchestration process uses the
compensation pattern that the step references to compensate the step.
2. Compensate. Here's what Order Management does.
You can set up a business rule that determines the action to take according to the compensation pattern.
Most orchestration process steps don't include a compensation pattern, and they use Update, by default. In this
example, Order Management compensates some steps.
1444
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
Schedule Cancels the Schedule step, then creates a new instance of this step. Order Promising
determines availability. Order Management replans fulfillment, then assigns a revised date to
each orchestration process step.
Create Reservation Assume the orchestration process in this example includes a pattern for the Create
Reservation step.
◦ If Demand Class Code isn't Gold, then cancel the Create Reservation step, then create
a new instance of this step.
This rule instructs Order Management to release supply and create a new reservation for
all customers except Gold customers. Order Management also updates Create Reservation
according to the new dates, and updates the reserved quantity.
Create Shipment Request Updates the Create Shipment Request step with new dates and new item.
The compensating services run, and then finish. These services use FIFO (first in, first out) sequence to
compensate the sales order, according to the orchestration process sequence, by default. If Order Management
must cancel the entire sales order, then it uses LIFO (last in, first out).
◦
Can accommodate the change. Order Management uses the original orchestration process to continue
processing.
◦ Can't accommodate the change. Order Management cancels the original orchestration process, then
starts a new one that can accommodate the change.
3. Send Update. Compensation finishes. Processing for the orchestration process is now at the same step it was
on when Order Management received the change order.
Order Management sends an update message to your fulfillment system to update the original message with
the changed order that includes the changed attributes. For example.
Values Description
Values after compensation sends Quantity is 2 and Arrival Date is August 18, 2018
an Update Inventory message for
the change order that includes the
changed attributes.
1445
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
You create the ShipOrderGenericProcess orchestration process. Here are the set ups you use.
Set Up Value
• Ordered Quantity
• Demand Class Code
• Requested Ship Date
1 Schedule Schedule
Each step references a task type, and each task type references order attributes that Order Management uses to
determine whether to compensate the sales order. In this example, the Schedule step and the Shipment step each
reference a task type that references the Ordered Quantity attribute.
1446
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
For example, if the user increases Quantity on the sales order, then Order Management must schedule and ship more
supply.
• Assume the Order Entry Specialist submits a sales order for the AS54888 Desktop Computer with a quantity of
1.
• One day later, the Order Entry Specialist clicks Create Revision, changes Quantity to 2, then clicks Submit.
Order Management compensates the Schedule step and the Shipment step.
1447
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
Note.
• A channel can include an order capture system, fulfillment system, the Order Management work area, and so
on.
• Order Management cross-references, transforms, validates, and orchestrates the change in a way that's similar
to how it does this work for a new sales order. If rules that control how to process a change exist, then Order
Management applies them. You can use setup options to modify how Order Management does this processing.
1448
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
• Use the same Excel template that you use to import sales orders to import change orders. For details, see the
Import Orders into Order Management topic.
• Use the same web service that you use to create a sales order to import a change order. For details, see the Use
Web Services to Import Orders topic.
• Use only one channel to make changes. For example, use Create Order Revision to make changes, or use a
web service, or use file-based import. Don't use Create Order Revision and web services and file-based import.
Using different channels causes confusion when attempting to identify the source of the change.
• Some implementations price the order in a channel, then send it to Order Management.
◦ You can't change pricing that your channel uses to pricing that Oracle Pricing Administration uses.
◦ You can't change pricing that Oracle Pricing Administration uses to pricing that your channel uses.
• Order Management submits the change orders it receives through a web service to order fulfillment. You can't
submit a change order through a web service and keep it in Draft status. Order Management only keeps a sales
order in Draft if an error occurs in the change order.
• Order Management doesn't update a sales order that's in Draft status.
• If you use Create Order Revision in the Order Management work area, and must revise the order again, then use
Create Order Revision again. Don't use a web service or file-based import to revise the order again.
• If you change only one line in a sales order, then it isn't necessary to import all order lines.
• To cancel the order line, import a quantity of 0.
• Order Management sets the attribute value to empty for each order line attribute that the channel doesn't send.
For example, if the original order includes a value for Shipping Method, and if the channel sends a change
request that doesn't include Shipping Method, then Order Management sets Shipping Method to empty.
• If the channel revises only the order header, then Order Management revises the header but not the order lines.
• The channel must include a value for each required attribute.
• To cancel an order line, the channel must explicitly request the cancel. Order Management doesn't implicitly
cancel order lines when it revises a sales order.
1449
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
1450
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
Feature Description
Cost of Change Rule A rule you set up on an orchestration process that specifies the business cost your
organization will incur as a result of processing the change.
Change Mode An option you set on an orchestration process. It determines when Order Management records
the state of the process. It compares these states during order compensation.
Choose a value.
• Advanced. Process change. Record the state of the orchestration process at each
orchestration process step.
• Simple. Process change only on the step that receives change. Record the state of the
orchestration process when it starts and at the step where the orchestration process
receives the change.
• None. Don't allow change. Don't record the state of the orchestration process.
Use Flexfield Attributes An option you set on an orchestration process or orchestration process step that specifies
whether to examine flexfield attributes when compensating the sales order.
If you enable this option, then Order Management examines flexfield attributes that the item
references to determine whether it must compensate the orchestration process.
For example, assume you create flexfield Color. Assume the user changes the value of Color
from Red to Blue. You can use Color during compensation to allow your fulfillment system to
reschedule the order line so it ships a blue item instead of a red one.
Order Management disables Use Flexfield Attributes and Use Transactional Item Attributes
on each predefined orchestration process, by default. You can't enable these options
on a predefined orchestration process. However, you can create a copy of a predefined
orchestration process, and then enable them on the copy.
Use Transactional Item Attributes An option you set on an orchestration process or orchestration process step that specifies
whether to examine transactional attributes when compensating a sales order. For details, see
the Transactional Attributes topic.
Enable the Use Flexfields Attributes option and the Use Transactional Item Attributes option
only if you will send these attributes to your fulfillment system during compensation.
Use Dynamic Attributes An option you set that specifies whether to examine dynamic attributes when compensating a
sales order.
Compensation Pattern A rule you set up on an orchestration process step that specifies the adjustment to make to the
sales order when the order changes.
For example, if Order Management receives a change order that specifies to ship an item from
a different warehouse during the Create Shipment step, then it runs the Cancel service and the
Create service again.
If you don't specify a compensation pattern, then Order Management uses the predefined
compensation pattern, by default. A predefined pattern uses Update, Cancel, or Create.
1451
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
Feature Description
Task Type An attribute you set on an orchestration process step. The task type that you select determines
the attributes that Order Management uses when it determines whether it must compensate
the sales order for this step.
Order Management comes predefined to use a set of attributes for each predefined task type.
You can't modify the predefined set up, but you can add more attributes. Order Management
doesn't add these attributes to a new task type you add, and it doesn't evaluate this task until
you add these attributes. To add them, you must click Add All.
Reserve Supply
If you reserve or schedule an order line according to future supply, then consider whether your orchestration process
needs the reserve or schedule step. For example, the reservation step examines supply that's currently available, and
then reserves it to make sure your fulfillment system can fulfill the item. If you don't need to reserve supply, then don't
include the reservation step. If you do need to reserve, then consider making the reservation step a manual step, for
example, so the user must click a button, such as Reserve.
You can also add a pause step before the reserve or schedule step. The pause task can pause the orchestration process
until the shipment is almost ready to ship, such as 12 hours before scheduled shipment. When the reservation step runs,
it will provide a more accurate picture of supply that's available because its closer to the ship date. Waiting to reserve
supply in this way can also reduce the cost of holding inventory until its time to ship.
1452
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
Note.
• Set up a rule that measures the cost of change. If its too high, reject the change.
• In the header area of the orchestration process, next to Cost of Change Rule, click Click for Rule.
• Use Advanced Mode.
• Use the Assign action.
• Assign a numeric value to Header.mRuleDecision.costOfChange. For example.
Header.mRuleDecision.costOfChange = 10
Set Up Compensation
1453
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
Note.
• Use a compensation rule only to compensate change. If you must also set values for other attributes, then use a
posttransformation rule.
• In the steps area of the orchestration process, in the step you must compensate, in column Compensation
Pattern, click Click for Rule.
• Use Advanced Mode.
• In the IF statement.
1454
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
• For example.
For a list of attributes you can specify, see topic Reference for Entities and Attributes You Can Use When
Integrating Order Management.
• In the THEN statement.
header.mRuleDecision.compensationPattern = "CANCEL_CREATE"
◦ Assign a value.
Value Description
UPDATE Update the current fulfillment request with the latest attribute value.
Each orchestration process comes predefined to use UPDATE, by default. If you don't
specify a compensation pattern, and if the orchestration process detects a change,
then it will send an update request to the fulfillment system.
UPDATE_CREATE Update the current fulfillment request with the latest attribute value, and also create a
new request.
CANCEL_CREATE Cancel the current fulfillment request, and then create a new request that includes the
latest attribute value.
CANCEL_UPDATE Cancel the current fulfillment request, and then update another fulfillment request with
the latest attribute value.
CANCEL_UPDATE_CREATE Cancel the current fulfillment request, update another fulfillment request with the
latest attribute value, and then create a new request that includes the latest attribute
value.
These values determine what request the orchestration process sends to the fulfillment system.
Constrain Change
Use a processing constraint.
• Disallow change that you know your fulfillment system can't accommodate, such as changing the supplier for
an item that requires significant lead time for the supplier to produce.
• Make sure a channel doesn't make a change that your fulfillment system can't accommodate.
1455
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
• Make sure the user includes required attributes. For example, assume you add your own numeric attribute x for
invoicing, and invoicing requires attribute x to calculate the invoice. You can use a constraint to make sure the
user adds a value for x, and that the value is numeric.
• If a constraint doesn't meet your business requirement, then set up an order management extension. Use an
extension to validate, then display a message or warning.
Note.
1456
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
• Use the same value in the Group Number attribute to create an AND condition across constraints. For example,
if you set Group Number to 10 for condition x, and Group Number to 10 for condition y, and if conditions x and y
both evaluate to True, then Order Management applies the constraint.
• Use different values in Group Number to create an OR condition. For example, if you set Group Number to 10
for condition x, and Group Number to 20 for condition y, and if condition x or y evaluates to True, then Order
Management applies the constraint.
• Use the Applicable Roles tab to specify the user roles that can or can't edit an attribute according to the
constraint.
• Use the Manage Processing Constraints page in the Setup and Maintenance work area.
• For details, see the Manage Processing Constraints topic.
For example.
1457
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
Attribute Value
1458
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
Attribute Value
1459
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
Note.
• The user creates a revision, clicks Submit, and then the orchestration process starts.
• The orchestration process reaches a step that uses the Shipment task type, then examines the Manage Order
Attributes That Identify Change page in the Setup and Maintenance work area to determine whether to process
the change.
1460
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
• For details, see the Manage Order Attributes That Identify Change topic.
For example.
Note.
• Set the Task Type attribute to a value, such as Schedule, Reservation, Shipment, and so on, to determine when
to examine the change.
• Specify an entity to determine where the attribute resides.
1461
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
◦ Order Header
Other Guidelines
Order Management doesn't run pretransformation rules when you use Create Order Revision. If you must set the
default attribute value on a new order line that the user adds when using Create Order Revision, then create a
posttransformation rule that sets the default value.
Your users can use the fulfillment view to change a large number of fulfillment lines. If you set up a number of business
rules that must run for each change, and if the user submits a large set of changes, then you might encounter degraded
performance. You must test how many fulfillment line updates your environment can accommodate, then limit updates
from the fulfillment view according to the optimal.
This topic includes example values. You might use different values, depending on your business requirements.
◦ The orchestration process step examines each attribute in this list to determine whether to compensate
the sales order when it receives a change order. If the list includes the attributes that your step requires to
identify change, then set the Task Type attribute on the step to this task type, then go to the next step in
this procedure.
For this example, the list does include Ordered Quantity, so set Task Type to Shipment.
If the Predefined column in the Attributes list includes a check mark, then you can't remove this attribute.
◦ If the Attributes list doesn't include the attributes your step needs to identify change, then do these steps.
1462
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
Subject Line Restart the Oracle Server for Order Management Cloud
Body Can you do a Full FA Bounce on the Oracle server to pick up changes that we've made in the
Manage Order Attributes That Identify Change task.
If you don't restart the server, then Order Management won't consider any of the attributes that you add or
remove in this procedure when it processes the sales order.
Here are some set ups you can do on the Manage Order Attributes That Identify Change page.
Set Up Description
Add an attribute to all tasks that the Click Actions > Edit All.
Task Type list displays.
On the Create Order Attributes That Identify Change page, add attributes, as necessary.
If you create a new task type, and if you don't use this page to add at least one attribute to the
task type, then Order Management won't examine any attributes when it identifies change.
If the source system requests a determination for cost of change, then Order Management calculates the value, then
returns it to the source system so the customer service representative can choose whether to proceed with the change.
The source system can request the value before it submits the sales order. Order Management also calculates the cost
after it compensates the sales order.
You use a business rule to assign the cost of change to an orchestration process. If you choose not to use values for the
cost of change, then Order Management uses a value of zero to calculate cost.
1463
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
Assume you need a business rule that measures the cost of change your company will incur when a customer requests
a change. If fulfillment line status is.
This example includes a simple business rule you can use with an orchestration process that includes only one line.
You use advanced rules to write a rule that includes more than one line. For details, see the Overview of Using Business
Rules With Order Management topic.
1464
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
where
Object Description
DooSeededOrchestrationRules Dictionary that contains rule sets, facts, functions, variables and so on for order orchestration.
1465
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
Object Description
DOOFLine is an abbreviation for distributed order orchestration (DOO) fulfillment line (FLine).
The phrase distributed order orchestration is an earlier name for Order Management Cloud.
The entire value isn't visible in the screen capture. Here's the full value.
DooSeededOrchestrationRules.DOOFLine.statusCode
Result Fact in DooSeededOrchestrationRules. You use it to store the results of the business rule you're
defining.
Attribute Value
Description This rule measures the cost to change a sales order when the fulfillment line status is
Scheduled. It sets the cost of change to 5.
1466
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
Attribute Value
Value 5
5. Click Collapse.
1467
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
1. Click Add Rule > Expand > Show Advanced Settings, then set values.
Attribute Value
1468
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
Attribute Value
Description This rule measures the cost to change a sales order when fulfillment line status is Shipped. It
sets the cost of change to 50.
Related Topics
• Set Up Orchestration Processes
For example, assume the compensation pattern for a Create Shipment step is Redo, and that the step calls the Cancel
service and the Create service. If Order Management receives a change order that includes a new warehouse for the
step, then it runs Cancel and Create again.
Assume you need a compensation pattern that pauses the orchestration process until compliance check finishes.
• If compliance details change, then pause the orchestration process until compliance is done.
1469
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
where
Code Description
DooSeededOrchestrationRules Dictionary that contains a set of predefined business rules for an orchestration process. You
use it to store objects and their values.
1470
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
Code Description
DOO means distributed order orchestration, which is a term that Order Management used for
order orchestration in earlier releases.
DOOHeader Object in DooSeededOrchestrationRules. It contains attributes for the sales order header and
their values.
headerEFF Extensible flexfield on the order header. For this example, assume you defined an extensible
flexfield that stores details about the compliance check.
For details about flexfields, see the Overview of Setting Up Extensible Flexfields in Order
Management topic.
DooSeededOrchestrationRules.FlexContexts
Establishes FlexContexts in the dictionary.
FlexContext Object that stores the value for the extensible flexfield.
mRuleDecision.CompensationPattern
CompensationPattern is a property of object mRuleDecision. CompensationPattern stores the
string UPDATE, which is the value that this rule uses to end the condition.
Code Description
header is a Declare header as a temporary variable that stores the value from object DOOHeader of
DooSeededOrchestrationRules.DOOHeader
dictionary DooSeededOrchestrationRules.
Proceed to the next AND statement only after you declare header.
headerEFF is a Declare headerEFF as a temporary variable that stores the value from object FlexContext of
DooSeededOrchestrationRules.FlexContext
DooSeededOrchestrationRules.
Proceed to the next AND statement only after you declare headerEFF.
headerEFF isn't null Proceed to the next AND statement only if the extensible flexfield on the sales order header
contains a value.
This set up uses headerEFF to store the value of the extensible flexfield that stores attribute
Compliance Details on the order header. If the value of Compliance Details is empty, then it
indicates compliance isn't required, compensation isn't required, and the orchestration process
continues to the next orchestration process step.
1471
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
Code Description
header.flexContexts Declare headerEFF into the rules language (RL) dictionary, and set the value of headerEFF to
RL.contains headerEFF the value that flexContexts contains.
This condition makes sure you correctly declare the variable into the dictionary.
Do this test on each of your variables to make sure the declaration is correct. If you don't do
the test, and if the declaration isn't correct, then the rule might fail in a subsequent step.
headerEFF.context isn't null Make sure a context is defined for the order header. Proceed to the next AND statement only if
context contains a value.
headerEFF.context Get the context and segments for Compliance Details for this variable.
equals ignore case
"ComplianceDetails"
Proceed to the next AND statement only if context contains the string ComplianceDetails.
Ignore case sensitivity when examining.
if context contains some other value, then it indicates that no other process requested a
compliance check.
headerEFF.attributeChanged("_ComplianceInfo")
Make sure attribute ComplianceInfo of the extensible flexfield changed. You use
is true attributeChanged to determine whether the value for ComplianceInfo is different in this
revision.
This example includes a simple rule that processes only one line. Use an advanced rule to process more than one line.
For details, see the Overview of Using Business Rules With Order Management topic.
Create If Statement
You will create a statement.
• If compliance details changed
Do it.
1. Create the rule.
1472
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
Attribute Value
Description If compliance details changed, then pause the orchestration process until compliance is
done.
Priority Medium
1473
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
◦ In the window to the left of Is, click Left Value, expand header, then click flexContexts > OK.
◦ Change Is to RL.contains.
◦ In the field to the right of RL.contains, click Right Value > headerEFF > OK.
6. Make sure context contains a value.
headerEFF.attributeChanged()
Insert "_ComplianceInfo" between the parentheses, then click OK. For example.
headerEFF.attributeChanged("_ComplianceInfo")
1474
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
Order Management sets the compliance completion date when compliance check is done. If the date is empty, then it
indicates compliance check isn't done, and the rule doesn't release the pause task. For example.
• If CompleteCompliancedate is empty, then compliance check isn't done. Assign a business event to indicate we
must wait.
1475
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
then
assign header.sacResult.sacType = DooSeededOrchestrationRules.SacResult.SAC_TYPE_EVENT
assign header.sacResult.eventName = "Awaiting Compliance Check Completion"
assign header.sacResult.reevaluateFlag = "N"
You can create a rule that pauses until compliance completion date is later than order header date. For example.
• If CompleteCompliancedate occurs after order header date, then compliance check is done. Prepare to release
the pause task.
To prepare to release the pause task, you set waitDateTime to the compliance date. For details about waitDateTime and
sacResults, see the Guidelines for Pausing Orchestration Processes topic.
1476
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
then
assign header.sacResult.sacType = DooSeededOrchestrationRules.SacResult.SAC_TYPE_TIMER
assign header.sacResult.waitDateTime = headerEFF.getFlexAttributeDateValue("_CompleteCompliancedate")
It uses the values that these rules set for SacResult to determine when to release the pause task.
1477
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
then
assign new DooSeededOrchestrationRules.sacResult SAC = new DooSeededOrchestrationRules.sacResult()
assign header.sacResult = SAC
assign header.sacResult.sacType = DooSeededOrchestrationRules.SacResult.SAC_TYPE_IMMEDIATE
assign header.sacResult.reevaluateFlag = "N"
You add this rule in the Pause Rule column on the same step where you added the compensation pattern.
1478
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
• If the requested ship date is less than or equal to the current date plus three days, then cancel and redo the
Ship Product step.
1479
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
If
DooSeededOrchestrationRules.DOOFLine.requestShipDate same or less than CurrentDate.date.timeInMillis
+3*24*60*60*1000
Then
assert new DooSeededOrchestrationRules.Result (resultObj."CANCEL_CREATE")
where
Code Description
DOO means distributed order orchestration, which is term that Order Management used for
order orchestration in earlier releases.
DOOFLine Object in DooSeededOrchestrationRules. It contains fulfillment line attributes and their values.
time Property of the toLocateString function. This function references the requestShipDate
attribute.
CurrentDate.date.timeInMillis Equation that specifies to use the date that occurs three days after the current date.
+3*24*60*60*1000
Result Object in DooSeededOrchestrationRules that you use to store the result of the If statement.
It stores CANCEL_CREATE, which is the value that this rule uses to end the condition.
1. Create If statement.
2. Create Then statement.
This topic includes example values. You might use different values, depending on your business requirements.
Create If Statement
You will create a statement.
• If the requested ship date is less than or equal to the current date plus three days
Do it.
1480
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
For details about how to create CallCustomerWhenLargeInvoice, see the Add Branches to Orchestration
Processes topic.
3. On the Edit Orchestration Process Definitions page, in the Process Details area, in the Step Definition list, click
Change Management.
4. In the Ship Item row, in the Compensation Pattern column, click Click for Rule.
5. In the Compensation Pattern dialog, click Add Rule > Expand, then set the value.
Attribute Value
6. In the If area, click Left Value, expand DOOSeededOrchestrationRules > DOOFline > requestShipDate, then
click time > OK.
7. In the Is list, click Is > Same or Less Than.
8. Click Right Value.
9. In the Condition Browser, expand CurrentDate > Date > Time, then click timeInMillis.
CurrentDate.date.timeInMillis+3*24*60*60*1000
The time function for most business rules work in milliseconds, so you must convert time to milliseconds. The
calculation 3*24*60*60*1000 calculates the total number of milliseconds that three days contains, where.
1481
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
Attribute Value
Value "CANCEL_CREATE"
5. Click OK.
6. Click Validate, make sure the Validation Log that displays doesn't contain any errors, then click Save.
7. On the Edit Orchestration Process Definition page, click Save.
Note.
• If you need different behavior, then you can write a compensation rule according to an item change. Note that
business rules call the Update service for an item change.
• Change management can only identify change to an extensible flexfield. However, you can write a
compensation rule that examines the extensible flexfield segment so it can determine whether to do
compensation.
• If the sales order is at the await shipping step, and if the Order Entry Specialist substituted the item, then
cancel the existing request to ship, create a new request, schedule, reserve, and then send the new request to
shipping.
Each shipping step and reservation step on a predefined orchestration process that integrates with shipping already use
this logic. You add this logic only if you set up your own orchestration process.
1. Use the Manage Orchestration Process Definitions page to open and edit the orchestration process you must
modify.
2. In the row that ships the item, in the Compensation Pattern column, click Click for Rule, then add the rule.
Here's the code to use.
Root: DooSeededOrchestrationRules.DOOHeader
If
header is a DooSeededOrchestrationRules.DOOHeader
and At least one
fline is a header/childFlines
and fline.attributeChanged(DooSeededOrchestrationRules.IFLine.INVENTORYITEMID) is true
then
assign header.mRuleDecision.compensationPattern = "CANCEL_CREATE"
1482
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
Notify Systems
Overview of Sending Notifications from Order Management to Other Systems
Use a business event to send a notification to a system that resides outside of Order Management Cloud when a change
occurs, such as when details in a sales order or fulfillment line change.
You can send the notification to an upstream system, such as an order capture system,, or to a downstream system,
such as a fulfillment system or billing system.
1483
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
A business event is something that occurs that's significant enough that requires in Order Management to take an
action. Here are some examples.
1484
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
Note.
1. Order Management monitors conditions that occur during order fulfillment according to the trigger points you
specify.
For example, if you enable the Notify External System option for the Shipped status value on a status rule set,
then Order Management communicates the business event each time it sets a fulfillment line status to Shipped,
and it sends the business event to the endpoint URL of the connector you set up for the Fulfillment Line Status
Update business event. For details about this option, see the Add Status Conditions to Fulfillment Lines topic.
2. You use the Manage Business Event Trigger Points page in the Setup and Maintenance work area to specify
the trigger point. If Order Management determines a trigger point occurred, then it uses the Connector Name
1485
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
attribute on the Manage Business Event Trigger Points page to identify the connector to use to communicate to
the external system.
3. The connector communicates with the external system. You use the connector to specify the URL that locate
the external system and the security credentials that your external system requires to communicate data. For
example, the fulfillment line status is Shipped, so you notify your invoicing system that the order is ready to
invoice.
4. As an option, you can use the Notify Frequency parameter to specify how frequently Order Management sends
notifications. For details, see the Manage Order Management Parameters topic.
You can also use a web service to communicate details about the event.
• You must associate a connector with the business event you specify. For details, see the Send Notifications
from Order Management Cloud to External Systems topic.
• The business events that this page displays aren't active, by default, except for business events that monitor
closing a fulfillment line.
• A modification you make on this page takes effect immediately.
• The settings you make affect only one instance of Order Management.
• You can't add or delete the business events that this page displays.
• Set up only the business event trigger points you need. Each trigger point might affect system performance.
Change Order Compensation Send a notification when Order Management finishes processing a change order. If the change
Complete order results in an error, then this business event reports the error.
Fulfillment Line Status Update Send a notification when Order Management changes the status value of a fulfillment line.
Fulfillment Line Closed Send a notification when Order Management closes a fulfillment line. Some applications, such
as Cost Management, can use these details to do downstream processing on the fulfillment
line.
Hold Send a notification when a user applies a hold, or when the order capture system or fulfillment
system applies a hold on an entity.
• Order
• Order line
• Fulfillment line
1486
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
Note.
• If a hold doesn't go into effect immediately, for example, if the hold applies to a future
task, then Order Management communicates the business event when the hold goes
into effect, not when the request to add the hold occurs.
• If change management releases or applies a hold, then Order Management doesn't
communicate the business event.
Jeopardy Send a notification when process planning changes a jeopardy priority value, such as High,
Medium, or Low. You can specify the value to notify.
Order Attribute Update Send a notification when Order Management changes a fulfillment line attribute during order
fulfillment. You can choose each attribute from the set of attributes that the task references.
• Each attribute that the Order Update - Attributes That Trigger Events area displays
can trigger a business event. These attributes are predefined. You can also set up an
extensible flexfield that modifies these attributes.
If you set up an extensible flexfield, then Order Management displays it in the Select and
Add - Attributes That Trigger Events dialog. If you select one or more segments, and
then click OK or Apply, then Order Management displays the segments that you select in
the Order Attribute Update - Attributes That Trigger Events area.
• If Order Management updates more than one attribute of the Order Attribute Update
business event at the same time, then it sends only one notification. This notification
includes details about the attributes it updated.
• The status values in the Order Header Status Update - Status Values That Trigger Events
area start the Order Header Status Update business event. These values are predefined.
You can't add status values in this area.
Order Header Status Update Send a notification when Order Management cancels, partially closes, or closes a sales order.
You can specify the status value to notify.
Split Send a notification when a partial shipment occurs or when an integrated system splits a
fulfillment line.
Related Topics
• Deploy Extensible Flexfields
For background details about how to do the set up, see these topics.
• Guidelines for Integrating Order Management
• Overview of Using Integration Cloud Service with Order Management
1487
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
Attribute Value
Target System Select the external 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 you deploy on the
external system. Order Management will call this web service, and the web service must
accept the event payload that Order Management sends.
User Name Enter the user name that the external system requires.
At run time, if the sales order reaches the trigger point you specify, then Order Management calls the web
service you choose in the Connector URL attribute. The web service then sends details of the business event to
the external system. For example, to send a notification when a fulfillment line closes, choose the Fulfillment
Line Closed trigger point.
3. 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.
4. Set values.
1488
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
Attribute Value
Connector Name Select the connector you added earlier in this topic.
◦ Contains a check mark. Send a notification about each sales order even if the
external system that receives the notification doesn't have any knowledge about the
sales order.
◦ Doesn't contain a check mark. If the external 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 occurs
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.
You can associate the same connector with more than one business event, as necessary.
6. Optional. Repeat step 2 through 5 for each trigger point you must administer.
7. Click Save and Close.
Related Topics
• Manage Order Management Parameters
• Guidelines for Integrating Order Management
• Overview of Using Business Events with Order Management
Return Orders
1489
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
Attribute Description
1490
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
Attribute Description
Use web services to integrate Order Management with another system in your deployment.
• GetOrderDetails
• OrderInformationService
• OrderFulfillmentResponseService
For details, see the Overview of Using Integration Cloud Service with Order Management topic.
Use the DOO_ORDER_DOC_REFERENCES_INT worksheet in the order import template to identify the original order and
the item you're returning. For details, see the Overview of Importing Orders into Order Management topic.
It verifies the accounting and invoicing rules between the referenced return line and the original order line. You
don't need it.
2. Write an order management extension that nullifies the accounting and invoicing rule for referenced return
lines.
◦ Remove the rule only after Order Management sends the line to your billing system.
◦ If you use Oracle Fusion Receivables, then use Manage AutoInvoice Lines to remove the values.
1491
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
If you have a process assignment rule that assigns an order line where the Category attribute on the line contains
Order but the orchestration process processes returns, then its recommended that you modify it so it assigns the
orchestration process only when the Category attribute on the fulfillment line equals Return Goods. For example, add an
if statement to your rule in Visual Information Builder.
If the Category attribute on the fulfillment line is Return Goods.
If you have this assignment rule in Oracle Business Rules, an order management extension, or web service, then use the
categoryCode attribute instead of the Category attribute, and test for the value Return instead of Return Goods.
If the categoryCode attribute on the fulfillment line is Return.
<!Send the Line Document Reference only for a return line. This entity references the original order line
for the item you're returning.-->
<ns2:DocumentReference>
<ns2:DocumentReferenceType>ORIGINAL_SALES_ORDER</ns2:DocumentReferenceType>
1492
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
1493
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
<ns0:TransactionalCurrencyCode>USD</ns0:TransactionalCurrencyCode>
<ns0:ConversionRate xsi:nil="true"/>
<ns0:ConversionTypeCode xsi:nil="true"/>
<ns0:ConversionDate xsi:nil="true"/>
<ns0:StatusCode>OPEN</ns0:StatusCode>
<ns0:PartialShipAllowedFlag>N</ns0:PartialShipAllowedFlag>
<ns0:OpenFlag>Y</ns0:OpenFlag>
<ns0:CanceledFlag>N</ns0:CanceledFlag>
<ns0:ChangeVersionNumber>1</ns0:ChangeVersionNumber>
<ns0:IsEditable>Y</ns0:IsEditable>
<ns0:OnHold>N</ns0:OnHold>
<ns0:CostOfChange>0</ns0:CostOfChange>
<ns0:SoldToCustomerIdCrossRef xsi:nil="true"/>
<ns0:SoldToContactIdCrossRef xsi:nil="true"/>
<ns0:ConversionTypeCodeCrossRef xsi:nil="true"/>
<ns0:TransactionalCurrencyCodeCrossRef>USD</ns0:TransactionalCurrencyCodeCrossRef>
<ns0:SoldToPartyId>1006</ns0:SoldToPartyId>
<ns0:ObjectVersionNumber>5</ns0:ObjectVersionNumber>
<ns0:SoldToPartyContactId>1560</ns0:SoldToPartyContactId>
<ns0:SoldToPartyIdCrossRef>1006</ns0:SoldToPartyIdCrossRef>
<ns0:SoldToPartyContactIdCrossRef>1560</ns0:SoldToPartyContactIdCrossRef>
<ns0:CancelReasonCode xsi:nil="true"/>
<ns0:Comments xsi:nil="true"/>
<ns0:RequestCancelDate xsi:nil="true"/>
<ns0:CancelReasonCodeCrossRef xsi:nil="true"/>
<ns0:SoldToPartyNumber>1006</ns0:SoldToPartyNumber>
<ns0:SoldToCustomerAccountNumber xsi:nil="true"/>
<ns0:AllowCurrencyOverrideFlag>Y</ns0:AllowCurrencyOverrideFlag>
<ns0:AppliedCurrencyCode>USD</ns0:AppliedCurrencyCode>
<ns0:CarrierId xsi:nil="true"/>
<ns0:DemandClassCode xsi:nil="true"/>
<ns0:EarliestAcceptArrivalDate xsi:nil="true"/>
<ns0:EarliestAcceptableShipDate xsi:nil="true"/>
<ns0:FobPointCode xsi:nil="true"/>
<ns0:FreezePriceFlag>N</ns0:FreezePriceFlag>
<ns0:FreezeShippingChargeFlag>Y</ns0:FreezeShippingChargeFlag>
<ns0:FreezeTaxFlag>Y</ns0:FreezeTaxFlag>
<ns0:FreightTermsCode xsi:nil="true"/>
<ns0:FulfillOrgId xsi:nil="true"/>
<ns0:LatestAcceptArrivalDate xsi:nil="true"/>
<ns0:LatestAcceptableShipDate xsi:nil="true"/>
<ns0:ModifiedFlag>N</ns0:ModifiedFlag>
<ns0:PackingInstructions xsi:nil="true"/>
<ns0:PaymentTermId xsi:nil="true"/>
<ns0:PricedOn xsi:nil="true"/>
<ns0:PricingSegmentCode>CORPORATE_SEGMENT</ns0:PricingSegmentCode>
<ns0:PricingSegmentExplanation>The applicable pricing segment for this transaction is Pricing
Segment=Corporate Segment Precedence=1 because Revenue Potential=Medium Customer Size=Medium Cost To
Serve=Medium Customer Value=Medium Customer Rating=Medium</ns0:PricingSegmentExplanation>
<ns0:PricingStrategyExplanation>The applicable pricing strategy for this transaction is Pricing
Strategy=Corporate Pricing Strategy because Channel Method=null Transaction Type=null Pricing
Segment=Corporate Segment</ns0:PricingStrategyExplanation>
<ns0:PricingStrategyId>300100071623888</ns0:PricingStrategyId>
<ns0:ReferenceHeaderId xsi:nil="true"/>
<ns0:RequestArrivalDate xsi:nil="true"/>
<ns0:RequestShipDate xsi:nil="true"/>
<ns0:SegmentExplanationMsgName xsi:nil="true"/>
<ns0:ShipClassOfService xsi:nil="true"/>
<ns0:ShipModeOfTransport xsi:nil="true"/>
<ns0:ShipmentPriorityCode xsi:nil="true"/>
<ns0:ShippingInstructions xsi:nil="true"/>
<ns0:ShipsetFlag xsi:nil="true"/>
<ns0:SoldToPartyContactPointId xsi:nil="true"/>
<ns0:StrategyExplanationMsgName xsi:nil="true"/>
<ns0:SubmittedFlag>Y</ns0:SubmittedFlag>
<ns0:SubstituteAllowedFlag xsi:nil="true"/>
1494
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
<ns0:SupplierId xsi:nil="true"/>
<ns0:SupplierSiteId xsi:nil="true"/>
<ns0:SoldToPartyName>Computer Service and Rentals</ns0:SoldToPartyName>
<ns0:SoldToPartyPersonFirstName xsi:nil="true"/>
<ns0:SoldToPartyPersonLastName xsi:nil="true"/>
<ns0:SoldToPartyPersonMiddleName xsi:nil="true"/>
<ns0:SoldToPartyPersonNameSuffix xsi:nil="true"/>
<ns0:SoldToPartyPersonTitle xsi:nil="true"/>
<ns0:SoldToPartyContactName>Piere Legrand</ns0:SoldToPartyContactName>
<ns0:SoldToPartyContactNumber>CONTACT-1560</ns0:SoldToPartyContactNumber>
<ns0:SoldToPartyContactFirstName>Piere</ns0:SoldToPartyContactFirstName>
<ns0:SoldToPartyContactLastName>Legrand</ns0:SoldToPartyContactLastName>
<ns0:SoldToPartyContactMiddleName xsi:nil="true"/>
<ns0:SoldToPartyContactNameSuffix xsi:nil="true"/>
<ns0:SoldToPartyContactTitle xsi:nil="true"/>
<ns0:TransactionalCurrencyName>US Dollar</ns0:TransactionalCurrencyName>
<ns0:LegalEntity xsi:nil="true"/>
<ns0:SoldToPartyType>ORGANIZATION</ns0:SoldToPartyType>
<ns0:SoldToPartyLastUpdateDate>2017-07-26T17:51:22.683Z</ns0:SoldToPartyLastUpdateDate>
<ns0:RequestingBusinessUnitIdentifier xsi:nil="true"/>
<ns0:RequestingBusinessUnitName xsi:nil="true"/>
<ns0:CancelReason xsi:nil="true"/>
<ns0:OrgName>Vision Operations</ns0:OrgName>
<ns0:PreCreditCheckedFlag>N</ns0:PreCreditCheckedFlag>
<ns0:SalesChannelCode xsi:nil="true"/>
<ns0:SalespersonIdentifier xsi:nil="true"/>
<ns0:Salesperson xsi:nil="true"/>
<ns0:SalesChannel xsi:nil="true"/>
<ns0:SubmittedBy>SCMOPERATIONS</ns0:SubmittedBy>
<ns0:SubmittedDate>2018-08-03T05:40:40.842Z</ns0:SubmittedDate>
<ns0:OrderLine>
<ns0:HeaderId>300100138387475</ns0:HeaderId>
<ns0:LineId>300100138387476</ns0:LineId>
<ns0:LineNumber>1</ns0:LineNumber>
<ns0:StatusCode>OPEN</ns0:StatusCode>
<ns0:OwnerId xsi:nil="true"/>
<ns0:SourceLineNumber>1</ns0:SourceLineNumber>
<ns0:SourceLineId>101</ns0:SourceLineId>
<ns0:SourceOrderId>bdanthal_aug03_urr_001</ns0:SourceOrderId>
<ns0:SourceScheduleId>101</ns0:SourceScheduleId>
<ns0:SourceOrderNumber>bdanthal_aug03_urr_001</ns0:SourceOrderNumber>
<ns0:SourceOrderSystem>LEG</ns0:SourceOrderSystem>
<ns0:SourceScheduleNumber>1</ns0:SourceScheduleNumber>
<ns0:ItemTypeCode>4</ns0:ItemTypeCode>
<ns0:OrderedUom>Ea</ns0:OrderedUom>
<ns0:SourceOrgId>204</ns0:SourceOrgId>
<ns0:OrgId>204</ns0:OrgId>
<ns0:LineTypeCode>ORA_RETURN</ns0:LineTypeCode>
<ns0:OpenFlag>Y</ns0:OpenFlag>
<ns0:CanceledFlag>N</ns0:CanceledFlag>
<ns0:ParentLineId xsi:nil="true"/>
<ns0:OrigSysDocumentLineRef xsi:nil="true"/>
<ns0:RootParentLineId xsi:nil="true"/>
<ns0:ActualShipDate xsi:nil="true"/>
<ns0:CanceledQty xsi:nil="true"/>
<ns0:ExtendedAmount>0</ns0:ExtendedAmount>
<ns0:FulfilledQty xsi:nil="true"/>
<ns0:FulfillmentDate xsi:nil="true"/>
<ns0:InventoryItemId>300100125547361</ns0:InventoryItemId>
<ns0:OrderedQty>3</ns0:OrderedQty>
<ns0:OrigSysDocumentRef xsi:nil="true"/>
<ns0:RmaDeliveredQty xsi:nil="true"/>
<ns0:ScheduleShipDate>2015-07-15T00:00:00.0Z</ns0:ScheduleShipDate>
<ns0:ShippedQty xsi:nil="true"/>
<ns0:UnitListPrice>0</ns0:UnitListPrice>
<ns0:UnitSellingPrice>0</ns0:UnitSellingPrice>
1495
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
<ns0:DeltaType xsi:nil="true"/>
<ns0:ReferenceLineId xsi:nil="true"/>
<ns0:OnHold>N</ns0:OnHold>
<ns0:CategoryCode>RETURN</ns0:CategoryCode>
<ns0:InventoryOrganizationId>204</ns0:InventoryOrganizationId>
<ns0:TransformFromLineId xsi:nil="true"/>
<ns0:DisplayLineNumber>1</ns0:DisplayLineNumber>
<ns0:OrderFulfillLine>
<ns0:FulfillLineId>300100138387477</ns0:FulfillLineId>
<ns0:ReferenceFlineId xsi:nil="true"/>
<ns0:FulfillLineNumber>1</ns0:FulfillLineNumber>
<ns0:OriginalFlineId xsi:nil="true"/>
<ns0:LineId>300100138387476</ns0:LineId>
<ns0:HeaderId>300100138387475</ns0:HeaderId>
<ns0:StatusCode>NOT_STARTED</ns0:StatusCode>
<ns0:OwnerId xsi:nil="true"/>
<ns0:SourceLineId>101</ns0:SourceLineId>
<ns0:SourceLineNumber>1</ns0:SourceLineNumber>
<ns0:SourceOrderId>bdanthal_aug03_urr_001</ns0:SourceOrderId>
<ns0:SourceOrderNumber>bdanthal_aug03_urr_001</ns0:SourceOrderNumber>
<ns0:SourceOrderSystem>LEG</ns0:SourceOrderSystem>
<ns0:SourceScheduleId>101</ns0:SourceScheduleId>
<ns0:SourceScheduleNumber>1</ns0:SourceScheduleNumber>
<ns0:InventoryItemId>300100125547361</ns0:InventoryItemId>
<ns0:ItemTypeCode>4</ns0:ItemTypeCode>
<ns0:ItemTypeName xsi:nil="true"/>
<ns0:FulfillOrgId>204</ns0:FulfillOrgId>
<ns0:OrderedQty>3</ns0:OrderedQty>
<ns0:OrderedUom>Ea</ns0:OrderedUom>
<ns0:RmaDeliveredQty xsi:nil="true"/>
<ns0:FulfilledQty xsi:nil="true"/>
<ns0:ShippedQty xsi:nil="true"/>
<ns0:ReservedQty xsi:nil="true"/>
<ns0:ReservableFlag>Y</ns0:ReservableFlag>
<ns0:ShippableFlag>N</ns0:ShippableFlag>
<ns0:InvoiceableItemFlag>Y</ns0:InvoiceableItemFlag>
<ns0:InvoiceEnabledFlag>Y</ns0:InvoiceEnabledFlag>
<ns0:BillToContactId>4820</ns0:BillToContactId>
<ns0:BillToCustomerId>1006</ns0:BillToCustomerId>
<ns0:BillToSiteUseId>1025</ns0:BillToSiteUseId>
<ns0:SourceOrgId>204</ns0:SourceOrgId>
<ns0:OrgId>204</ns0:OrgId>
<ns0:RequestArrivalDate xsi:nil="true"/>
<ns0:RequestShipDate>2015-01-15T10:10:10.0Z</ns0:RequestShipDate>
<ns0:ScheduleArrivalDate>2015-07-15T00:00:00.0Z</ns0:ScheduleArrivalDate>
<ns0:ScheduleShipDate>2015-07-15T00:00:00.0Z</ns0:ScheduleShipDate>
<ns0:PromiseArrivalDate xsi:nil="true"/>
<ns0:PromiseShipDate xsi:nil="true"/>
<ns0:ActualShipDate xsi:nil="true"/>
<ns0:FulfillmentDate xsi:nil="true"/>
<ns0:CustomerItemId xsi:nil="true"/>
<ns0:CustomerPoLineNumber xsi:nil="true"/>
<ns0:CustomerPoNumber xsi:nil="true"/>
<ns0:DemandClassCode xsi:nil="true"/>
<ns0:ExtendedAmount>0</ns0:ExtendedAmount>
<ns0:FobPointCode xsi:nil="true"/>
<ns0:CarrierId xsi:nil="true"/>
<ns0:InvoicingRuleId xsi:nil="true"/>
<ns0:ExemptionCertificateNumber xsi:nil="true"/>
<ns0:AccountingRuleId xsi:nil="true"/>
<ns0:LineTypeCode>ORA_RETURN</ns0:LineTypeCode>
<ns0:CategoryCode>RETURN</ns0:CategoryCode>
<ns0:OpenFlag>Y</ns0:OpenFlag>
<ns0:CanceledFlag>N</ns0:CanceledFlag>
<ns0:OverrideScheduleDateFlag>N</ns0:OverrideScheduleDateFlag>
<ns0:OriginalInventoryItemId xsi:nil="true"/>
1496
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
<ns0:GopReferenceId xsi:nil="true"/>
<ns0:PackingInstructions xsi:nil="true"/>
<ns0:ParentFulfillLineId xsi:nil="true"/>
<ns0:PaymentTermId xsi:nil="true"/>
<ns0:RequestType xsi:nil="true"/>
<ns0:ReturnReasonCode xsi:nil="true"/>
<ns0:OrigSysDocumentRef xsi:nil="true"/>
<ns0:OrigSysDocumentLineRef xsi:nil="true"/>
<ns0:RootParentFulfillLineId xsi:nil="true"/>
<ns0:ShipClassOfService xsi:nil="true"/>
<ns0:ShipModeOfTransport xsi:nil="true"/>
<ns0:ShipToContactId xsi:nil="true"/>
<ns0:ShipToCustomerId xsi:nil="true"/>
<ns0:ShipToSiteUseId xsi:nil="true"/>
<ns0:FulfillToleranceAbove xsi:nil="true"/>
<ns0:FulfillToleranceBelow xsi:nil="true"/>
<ns0:ShipmentPriorityCode xsi:nil="true"/>
<ns0:ShippingInstructions xsi:nil="true"/>
<ns0:ShipSetName xsi:nil="true"/>
<ns0:SplitFromFlineId xsi:nil="true"/>
<ns0:PartialShipAllowedFlag>N</ns0:PartialShipAllowedFlag>
<ns0:SubstituteAllowedFlag>N</ns0:SubstituteAllowedFlag>
<ns0:SubstituteReasonCode xsi:nil="true"/>
<ns0:TaxExemptFlag>S</ns0:TaxExemptFlag>
<ns0:TaxClassificationCode>765</ns0:TaxClassificationCode>
<ns0:TaxExemptionReasonCode xsi:nil="true"/>
<ns0:UnitListPrice>0</ns0:UnitListPrice>
<ns0:UnitSellingPrice>0</ns0:UnitSellingPrice>
<ns0:LatestAcceptableShipDate xsi:nil="true"/>
<ns0:LatestAcceptableArrivalDate xsi:nil="true"/>
<ns0:EarliestAcceptableShipDate xsi:nil="true"/>
<ns0:CanceledQty xsi:nil="true"/>
<ns0:ReturnableFlag>Y</ns0:ReturnableFlag>
<ns0:DeltaType xsi:nil="true"/>
<ns0:OnHold>N</ns0:OnHold>
<ns0:Description>Extended Warranty1</ns0:Description>
<ns0:LongDescription xsi:nil="true"/>
<ns0:InventoryItemId1>300100125547361</ns0:InventoryItemId1>
<ns0:OrganizationId>204</ns0:OrganizationId>
<ns0:ItemNumber>cov_open</ns0:ItemNumber>
<ns0:ActualCompletionDate xsi:nil="true"/>
<ns0:EstimateFulfillmentCost xsi:nil="true"/>
<ns0:EstimateMargin xsi:nil="true"/>
<ns0:FulfillInstanceId xsi:nil="true"/>
<ns0:FulfillmentSplitRefId xsi:nil="true"/>
<ns0:InventoryOrganizationId>204</ns0:InventoryOrganizationId>
<ns0:RemnantFlag xsi:nil="true"/>
<ns0:ReservationId xsi:nil="true"/>
<ns0:StatusRulesetId xsi:nil="true"/>
<ns0:InventoryItemIdCrossRef>LEGCOV_OPEN</ns0:InventoryItemIdCrossRef>
<ns0:ShipToCustomerIdCrossRef xsi:nil="true"/>
<ns0:ShipToContactIdCrossRef xsi:nil="true"/>
<ns0:ShipToSiteUseIdCrossRef xsi:nil="true"/>
<ns0:BillToCustomerIdCrossRef>1006</ns0:BillToCustomerIdCrossRef>
<ns0:BillToContactIdCrossRef>4820</ns0:BillToContactIdCrossRef>
<ns0:BillToSiteUseIdCrossRef>1025</ns0:BillToSiteUseIdCrossRef>
<ns0:InvoicingRuleIdCrossRef xsi:nil="true"/>
<ns0:AccountingRuleIdCrossRef xsi:nil="true"/>
<ns0:OrderedUomCrossRef>Ea</ns0:OrderedUomCrossRef>
<ns0:ShipClassOfServiceCrossRef xsi:nil="true"/>
<ns0:ShipModeOfTransportCrossRef xsi:nil="true"/>
<ns0:ShipmentPriorityCodeCrossRef xsi:nil="true"/>
<ns0:TaxClassificationCodeCrossRef>VAT20</ns0:TaxClassificationCodeCrossRef>
<ns0:TaxExemptionReasonCodeCrossRef xsi:nil="true"/>
<ns0:DemandClassCodeCrossRef xsi:nil="true"/>
<ns0:FobPointCodeCrossRef xsi:nil="true"/>
1497
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
<ns0:FreightTermsCodeCrossRef xsi:nil="true"/>
<ns0:ReturnReasonCodeCrossRef xsi:nil="true"/>
<ns0:CarrierIdCrossRef xsi:nil="true"/>
<ns0:PaymentTermIdCrossRef xsi:nil="true"/>
<ns0:FreightTermsCode xsi:nil="true"/>
<ns0:SchedulingReasonCode xsi:nil="true"/>
<ns0:ObjectVersionNumber>4</ns0:ObjectVersionNumber>
<ns0:SchedulingReason/>
<ns0:LookupCode/>
<ns0:LookupType/>
<ns0:SubInventory xsi:nil="true"/>
<ns0:ShipToPartyId>1006</ns0:ShipToPartyId>
<ns0:ShipToPartySiteId>1036</ns0:ShipToPartySiteId>
<ns0:ShipToPartyContactId xsi:nil="true"/>
<ns0:ShipToPartyIdCrossRef>1006</ns0:ShipToPartyIdCrossRef>
<ns0:ShipToPartySiteIdCrossRef>1036</ns0:ShipToPartySiteIdCrossRef>
<ns0:ShipToPartyContactIdCrossRef xsi:nil="true"/>
<ns0:CancelReasonCode xsi:nil="true"/>
<ns0:Comments xsi:nil="true"/>
<ns0:RequestCancelDate xsi:nil="true"/>
<ns0:CancelReasonCodeCrossRef xsi:nil="true"/>
<ns0:ShipToPartyNumber>1006</ns0:ShipToPartyNumber>
<ns0:ShipToPartySiteNumber>1036</ns0:ShipToPartySiteNumber>
<ns0:ShipToCustomerAccountNumber xsi:nil="true"/>
<ns0:ShipToLocationCode xsi:nil="true"/>
<ns0:BillToCustomerAccountNumber>1006</ns0:BillToCustomerAccountNumber>
<ns0:BillToLocationCode xsi:nil="true"/>
<ns0:FulfillmentOrgCode>V1</ns0:FulfillmentOrgCode>
<ns0:AssessableValue>5</ns0:AssessableValue>
<ns0:DefaultTaxationCountry>US</ns0:DefaultTaxationCountry>
<ns0:DocumentSubType xsi:nil="true"/>
<ns0:FinalDischargeLocationId xsi:nil="true"/>
<ns0:FirstPtyRegId>35647</ns0:FirstPtyRegId>
<ns0:ProductCategory xsi:nil="true"/>
<ns0:ProductType>GOODS</ns0:ProductType>
<ns0:TaxInvoiceDate xsi:nil="true"/>
<ns0:TaxInvoiceNumber xsi:nil="true"/>
<ns0:ThirdPtyRegId xsi:nil="true"/>
<ns0:TrxBusinessCategory>SALES_TRANSACTION</ns0:TrxBusinessCategory>
<ns0:UserDefinedFiscClass xsi:nil="true"/>
<ns0:IntendedUseClassifId xsi:nil="true"/>
<ns0:ProdFcCategId xsi:nil="true"/>
<ns0:DestinationOrgId xsi:nil="true"/>
<ns0:DestinationLocationId xsi:nil="true"/>
<ns0:ConfigInventoryItemId xsi:nil="true"/>
<ns0:ConfigItemReference xsi:nil="true"/>
<ns0:ItemSubTypeCode>STANDARD</ns0:ItemSubTypeCode>
<ns0:ItemSubTypeName>Standard</ns0:ItemSubTypeName>
<ns0:ConfigInventoryItemNumber xsi:nil="true"/>
<ns0:SupplierId xsi:nil="true"/>
<ns0:SupplierSiteId xsi:nil="true"/>
<ns0:PurchasingUom xsi:nil="true"/>
<ns0:ShippedUom xsi:nil="true"/>
<ns0:RequisitionBuId xsi:nil="true"/>
<ns0:RequisitionInventoryOrgId xsi:nil="true"/>
<ns0:BuyerId xsi:nil="true"/>
<ns0:AppliedPriceListId xsi:nil="true"/>
<ns0:BillToContactPointId xsi:nil="true"/>
<ns0:ChangeEligibleFlag>Y</ns0:ChangeEligibleFlag>
<ns0:ComponentIdPath xsi:nil="true"/>
<ns0:ConfigCreationDate xsi:nil="true"/>
<ns0:ConfigHeaderId xsi:nil="true"/>
<ns0:ConfigRevisionNumber xsi:nil="true"/>
<ns0:ConfiguratorPath xsi:nil="true"/>
<ns0:ContractEndDate>2018-03-05</ns0:ContractEndDate>
<ns0:ContractStartDate>2018-03-01</ns0:ContractStartDate>
1498
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
<ns0:CustomerPoScheduleNumber xsi:nil="true"/>
<ns0:ModifiedFlag>Y</ns0:ModifiedFlag>
<ns0:PrefOverriddenBitset xsi:nil="true"/>
<ns0:PricedOn>2018-08-03T05:40:28.015Z</ns0:PricedOn>
<ns0:PurchasingEnabledFlag>N</ns0:PurchasingEnabledFlag>
<ns0:QuantityPerModel xsi:nil="true"/>
<ns0:RequiredFulfillmentDate>2015-01-15T10:10:10.0Z</ns0:RequiredFulfillmentDate>
<ns0:ShipToContactPointId xsi:nil="true"/>
<ns0:ShowInSales xsi:nil="true"/>
<ns0:SupplyStatusCode xsi:nil="true"/>
<ns0:UnitQuantity xsi:nil="true"/>
<ns0:ValidConfigurationFlag xsi:nil="true"/>
<ns0:ShipToPartyName>Computer Service and Rentals</ns0:ShipToPartyName>
<ns0:ShipToPartyPersonFirstName xsi:nil="true"/>
<ns0:ShipToPartyPersonLastName xsi:nil="true"/>
<ns0:ShipToPartyPersonMiddleName xsi:nil="true"/>
<ns0:ShipToPartyPersonNameSuffix xsi:nil="true"/>
<ns0:ShipToPartyPersonTitle xsi:nil="true"/>
<ns0:ShipToAddress1>2164 Broadway</ns0:ShipToAddress1>
<ns0:ShipToAddress2 xsi:nil="true"/>
<ns0:ShipToAddress3 xsi:nil="true"/>
<ns0:ShipToAddress4 xsi:nil="true"/>
<ns0:ShipToCity>Tempe</ns0:ShipToCity>
<ns0:ShipToProvince xsi:nil="true"/>
<ns0:ShipToPostalCode>85282</ns0:ShipToPostalCode>
<ns0:ShipToState>AZ</ns0:ShipToState>
<ns0:ShipToCounty>Maricopa</ns0:ShipToCounty>
<ns0:ShipToCountry>US</ns0:ShipToCountry>
<ns0:ShipToPartyContactNumber xsi:nil="true"/>
<ns0:ShipToPartyContactName xsi:nil="true"/>
<ns0:ShipToContactFirstName xsi:nil="true"/>
<ns0:ShipToContactLastName xsi:nil="true"/>
<ns0:ShipToContactMiddleName xsi:nil="true"/>
<ns0:ShipToContactNameSuffix xsi:nil="true"/>
<ns0:ShipToContactTitle xsi:nil="true"/>
<ns0:BillToCustomerName>Computer Service and Rentals</ns0:BillToCustomerName>
<ns0:BillToCustomerNumber>1006</ns0:BillToCustomerNumber>
<ns0:BillToAccountPersonFirstName xsi:nil="true"/>
<ns0:BillToAccountPersonLastName xsi:nil="true"/>
<ns0:BillToAccountPersonMiddleName xsi:nil="true"/>
<ns0:BillToAccountPersonNameSuffix xsi:nil="true"/>
<ns0:BillToAccountPersonTitle xsi:nil="true"/>
<ns0:BillToAddress1>301 Summit Hill Drive</ns0:BillToAddress1>
<ns0:BillToAddress2 xsi:nil="true"/>
<ns0:BillToAddress3 xsi:nil="true"/>
<ns0:BillToAddress4 xsi:nil="true"/>
<ns0:BillToCity>CHATTANOOGA</ns0:BillToCity>
<ns0:BillToProvince xsi:nil="true"/>
<ns0:BillToPostalCode>37401</ns0:BillToPostalCode>
<ns0:BillToState>TN</ns0:BillToState>
<ns0:BillToCounty>Hamilton</ns0:BillToCounty>
<ns0:BillToCountry>US</ns0:BillToCountry>
<ns0:BillToAccountContactNumber>CONTACT-1560</ns0:BillToAccountContactNumber>
<ns0:BillToAccountContactName>Piere Legrand</ns0:BillToAccountContactName>
<ns0:BillToContactFirstName>Piere</ns0:BillToContactFirstName>
<ns0:BillToContactLastName>Legrand</ns0:BillToContactLastName>
<ns0:BillToContactMiddleName xsi:nil="true"/>
<ns0:BillToContactNameSuffix xsi:nil="true"/>
<ns0:BillToContactTitle xsi:nil="true"/>
<ns0:BillToPartyType>ORGANIZATION</ns0:BillToPartyType>
<ns0:ShipClassOfServiceName xsi:nil="true"/>
<ns0:FreightTerms xsi:nil="true"/>
<ns0:ShipModeOfTransportName xsi:nil="true"/>
<ns0:OrderedUomName>Each</ns0:OrderedUomName>
<ns0:CarrierName xsi:nil="true"/>
<ns0:LineTypeName>Return for credit and return the item</ns0:LineTypeName>
1499
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
<ns0:FulfillOrgLocationId>204</ns0:FulfillOrgLocationId>
<ns0:FulfillOrgAddress1>90 Fifth Avenue</ns0:FulfillOrgAddress1>
<ns0:FulfillOrgAddress2 xsi:nil="true"/>
<ns0:FulfillOrgAddress3 xsi:nil="true"/>
<ns0:FulfillOrgAddress4 xsi:nil="true"/>
<ns0:FulfillOrgCity>New York</ns0:FulfillOrgCity>
<ns0:FulfillOrgPostalCode>10022-3422</ns0:FulfillOrgPostalCode>
<ns0:FulfillOrgState>NY</ns0:FulfillOrgState>
<ns0:FulfillOrgProvince xsi:nil="true"/>
<ns0:FulfillOrgCounty>New York</ns0:FulfillOrgCounty>
<ns0:FulfillOrgCountry>US</ns0:FulfillOrgCountry>
<ns0:FulfillmentOrgName>Vision Operations</ns0:FulfillmentOrgName>
<ns0:SupplierIdCrossRef xsi:nil="true"/>
<ns0:SupplierNumber xsi:nil="true"/>
<ns0:SupplierName xsi:nil="true"/>
<ns0:SupplierSiteIdCrossRef xsi:nil="true"/>
<ns0:SupplierAddressLine1 xsi:nil="true"/>
<ns0:SupplierAddressLine2 xsi:nil="true"/>
<ns0:SupplierAddressLine3 xsi:nil="true"/>
<ns0:SupplierAddressLine4 xsi:nil="true"/>
<ns0:SupplierCity xsi:nil="true"/>
<ns0:SupplierPostalCode xsi:nil="true"/>
<ns0:SupplierState xsi:nil="true"/>
<ns0:SupplierProvince xsi:nil="true"/>
<ns0:SupplierCounty xsi:nil="true"/>
<ns0:SupplierCountry xsi:nil="true"/>
<ns0:ShipToPartyType>ORGANIZATION</ns0:ShipToPartyType>
<ns0:TransportationPlannedFlag>N</ns0:TransportationPlannedFlag>
<ns0:TransportationPlanningStatus>Not Applicable</ns0:TransportationPlanningStatus>
<ns0:CancelReason xsi:nil="true"/>
<ns0:SubstitutionReason xsi:nil="true"/>
<ns0:CustomerProductNumber xsi:nil="true"/>
<ns0:CustomerProductDescription xsi:nil="true"/>
<ns0:InvoicingRule xsi:nil="true"/>
<ns0:AccountingRule xsi:nil="true"/>
<ns0:DemandClass xsi:nil="true"/>
<ns0:PaymentTerms xsi:nil="true"/>
<ns0:ReturnReason xsi:nil="true"/>
<ns0:ShippingPriority xsi:nil="true"/>
<ns0:InventoryOrganization>V1</ns0:InventoryOrganization>
<ns0:InventoryOrganizationName>Vision Operations</ns0:InventoryOrganizationName>
<ns0:SubInventoryName xsi:nil="true"/>
<ns0:TaxClassification>VAT20</ns0:TaxClassification>
<ns0:TaxExemptionReason xsi:nil="true"/>
<ns0:FOBPoint xsi:nil="true"/>
<ns0:FulfillmentSplitReferenceLineNumber xsi:nil="true"/>
<ns0:ConfiguredInventoryItemDescription xsi:nil="true"/>
<ns0:BuyerName xsi:nil="true"/>
<ns0:BuyerFirstName xsi:nil="true"/>
<ns0:BuyerMiddleName xsi:nil="true"/>
<ns0:BuyerLastName xsi:nil="true"/>
<ns0:ShipToPartyLastUpdateDate>2017-07-26T17:51:22.683Z</ns0:ShipToPartyLastUpdateDate>
<ns0:ShipToPartySiteLastUpdateDate>1998-06-16T17:13:50.0Z</ns0:ShipToPartySiteLastUpdateDate>
<ns0:BillToPartyLastUpdateDate>2017-07-26T17:51:22.683Z</ns0:BillToPartyLastUpdateDate>
<ns0:BillToPartySiteLastUpdateDate>2004-09-09T10:46:39.0Z</ns0:BillToPartySiteLastUpdateDate>
<ns0:OrderedQuantityInPrimaryUOM xsi:nil="true"/>
<ns0:PrimaryUOMCode xsi:nil="true"/>
<ns0:PrimaryUOM xsi:nil="true"/>
<ns0:ShipmentPriority xsi:nil="true"/>
<ns0:FinalDischargeLocationAddressLine1 xsi:nil="true"/>
<ns0:FinalDischargeLocationAddressLine2 xsi:nil="true"/>
<ns0:FinalDischargeLocationAddressLine3 xsi:nil="true"/>
<ns0:FinalDischargeLocationAddressLine4 xsi:nil="true"/>
<ns0:FinalDischargeLocationAddressCity xsi:nil="true"/>
<ns0:FinalDischargeLocationAddressState xsi:nil="true"/>
<ns0:FinalDischargeLocationAddressPostalCode xsi:nil="true"/>
1500
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
<ns0:FinalDischargeLocationAddressProvince xsi:nil="true"/>
<ns0:FinalDischargeLocationAddressCounty xsi:nil="true"/>
<ns0:FinalDischargeLocationAddressCountry xsi:nil="true"/>
<ns0:DefaultTaxationCountryShortName>United States</ns0:DefaultTaxationCountryShortName>
<ns0:FirstPartyTaxRegistration>4567890</ns0:FirstPartyTaxRegistration>
<ns0:ThirdPartyTaxRegistration xsi:nil="true"/>
<ns0:DocumentSubTypeName xsi:nil="true"/>
<ns0:ProductTypeName>Goods</ns0:ProductTypeName>
<ns0:TransactionLineType xsi:nil="true"/>
<ns0:ProductCategoryName xsi:nil="true"/>
<ns0:TransactionBusinessCategoryName xsi:nil="true"/>
<ns0:IntendedUseClassificationName xsi:nil="true"/>
<ns0:UserDefinedFiscClassName xsi:nil="true"/>
<ns0:ProductFiscalCategoryName xsi:nil="true"/>
<ns0:DestinationShippingOrganizationName xsi:nil="true"/>
<ns0:DestinationShippingOrganizationCode xsi:nil="true"/>
<ns0:DestinationShippingAddressLine1 xsi:nil="true"/>
<ns0:DestinationShippingAddressLine2 xsi:nil="true"/>
<ns0:DestinationShippingAddressLine3 xsi:nil="true"/>
<ns0:DestinationShippingAddressLine4 xsi:nil="true"/>
<ns0:DestinationShippingAddressCity xsi:nil="true"/>
<ns0:DestinationShippingAddressPostalCode xsi:nil="true"/>
<ns0:DestinationShippingAddressState xsi:nil="true"/>
<ns0:DestinationShippingAddressProvince xsi:nil="true"/>
<ns0:DestinationShippingAddressCounty xsi:nil="true"/>
<ns0:DestinationShippingAddressCountry xsi:nil="true"/>
<ns0:JeopardyPriority>HIGH</ns0:JeopardyPriority>
<ns0:CreditChkAuthExpDate xsi:nil="true"/>
<ns0:CreditChkAuthCode xsi:nil="true"/>
<ns0:BillToPartyIdentifier>1006</ns0:BillToPartyIdentifier>
<ns0:BillToPartySiteIdentifier>1034</ns0:BillToPartySiteIdentifier>
<ns0:BillToPartyContactIdentifier>1560</ns0:BillToPartyContactIdentifier>
<ns0:ActionTypeCode>ORA_ADD</ns0:ActionTypeCode>
<ns0:ServiceDuration>2</ns0:ServiceDuration>
<ns0:ServiceDurationPeriodCode>YR</ns0:ServiceDurationPeriodCode>
<ns0:ServiceDurationPeriodName xsi:nil="true"/>
<ns0:SalespersonIdentifier xsi:nil="true"/>
<ns0:Salesperson xsi:nil="true"/>
<ns0:UnreferencedReturnFlag>Y</ns0:UnreferencedReturnFlag>
<ns0:CoveredProductIdentifier>300100090628362</ns0:CoveredProductIdentifier>
<ns0:CoveredProductNumber>OAL_KIT</ns0:CoveredProductNumber>
<ns0:CoveredProductDescription>OAL KIT Item</ns0:CoveredProductDescription>
<ns0:CoveredCustomerProductId xsi:nil="true"/>
<ns0:CoveredCustomerProductNumber xsi:nil="true"/>
<ns0:CoveredCustomerProductDescription xsi:nil="true"/>
<ns0:CancellationEffectiveDate>2018-03-07T10:10:10.0Z</ns0:CancellationEffectiveDate>
<ns0:CoveredProductSrcsysReference>OAL_KIT_SPOKE_ITEM_1</ns0:CoveredProductSrcsysReference>
<ns0:SupplierSiteCode xsi:nil="true"/>
<ns0:ContractStartDateTime>2018-03-01T00:00:00.0Z</ns0:ContractStartDateTime>
<ns0:ContractEndDateTime>2018-03-05T00:00:00.0Z</ns0:ContractEndDateTime>
<ns0:FulfillLineEffCategories xsi:type="ns15:j_FulfillLineEffDooFulfillLinesAddInfoprivate"
xmlns:ns14="http://xmlns.your_server.com/apps/scm/doo/processOrder/flex/fulfillLineContextsB/"
xmlns:ns15="http://xmlns.your_server.com/apps/scm/doo/processOrder/flex/fulfillLineCategories/">
<ns3:Category>DOO_FULFILL_LINES_ADD_INFO</ns3:Category>
<ns3:FulfillLineId>300100138387477</ns3:FulfillLineId>
</ns0:FulfillLineEffCategories>
<ns0:OrderDocumentReference>
<ns0:CreatedBy>SCMOPERATIONS</ns0:CreatedBy>
<ns0:CreationDate>2018-08-03T05:40:18.402Z</ns0:CreationDate>
<ns0:DocAltUserKey xsi:nil="true"/>
<ns0:DocContextId xsi:nil="true"/>
<ns0:DocId>300100090628362</ns0:DocId>
<ns0:DocLineAltUserKey xsi:nil="true"/>
<ns0:DocLineContextId xsi:nil="true"/>
<ns0:DocLineId xsi:nil="true"/>
<ns0:DocLineUserKey xsi:nil="true"/>
1501
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
<ns0:DocRefType>COVERED_ITEM_FOR_ADHOC_RTN</ns0:DocRefType>
<ns0:DocSublineAltUserKey xsi:nil="true"/>
<ns0:DocSublineContextId xsi:nil="true"/>
<ns0:DocSublineId xsi:nil="true"/>
<ns0:DocSublineUserKey xsi:nil="true"/>
<ns0:DocSystemRefId>300100138387481</ns0:DocSystemRefId>
<ns0:DocUserKey>OAL_KIT</ns0:DocUserKey>
<ns0:FulfillLineId>300100138387477</ns0:FulfillLineId>
<ns0:HeaderId>300100138387475</ns0:HeaderId>
<ns0:LastUpdateDate>2018-08-03T05:40:26.953Z</ns0:LastUpdateDate>
<ns0:LastUpdateLogin>72822FC9F7FE2923E0534E08F20A027A</ns0:LastUpdateLogin>
<ns0:LastUpdatedBy>SCMOPERATIONS</ns0:LastUpdatedBy>
<ns0:LineId>300100138387476</ns0:LineId>
<ns0:ObjectVersionNumber>1</ns0:ObjectVersionNumber>
<ns0:OwnerTableId xsi:nil="true"/>
<ns0:OwnerTableName xsi:nil="true"/>
</ns0:OrderDocumentReference>
<ns0:OrderCharge>
<ns0:ChargeAppliesTo>PRICE</ns0:ChargeAppliesTo>
<ns0:ChargeCurrencyCode>USD</ns0:ChargeCurrencyCode>
<ns0:ChargeDefinitionCode>QP_SALE_PRICE</ns0:ChargeDefinitionCode>
<ns0:ChargeSubtypeCode>ORA_PRICE</ns0:ChargeSubtypeCode>
<ns0:ChargeTypeCode>ORA_SALE</ns0:ChargeTypeCode>
<ns0:GsaUnitPrice xsi:nil="true"/>
<ns0:OrderChargeId>300100138387478</ns0:OrderChargeId>
<ns0:ParentEntityCode>LINE</ns0:ParentEntityCode>
<ns0:ParentEntityId>300100138387477</ns0:ParentEntityId>
<ns0:PricePeriodicityCode xsi:nil="true"/>
<ns0:PriceTypeCode>ONE_TIME</ns0:PriceTypeCode>
<ns0:PricedQuantity>3</ns0:PricedQuantity>
<ns0:PricedQuantityUomCode>YR</ns0:PricedQuantityUomCode>
<ns0:PrimaryFlag>Y</ns0:PrimaryFlag>
<ns0:RollupFlag>N</ns0:RollupFlag>
<ns0:SequenceNumber>1</ns0:SequenceNumber>
<ns0:SourceChargeId>SC1</ns0:SourceChargeId>
<ns0:ReferenceOrderChargeId xsi:nil="true"/>
<ns0:AvgUnitSellingPrice xsi:nil="true"/>
<ns0:ChargeDefinition>Sale Price</ns0:ChargeDefinition>
<ns0:ChargeSubtype>Price</ns0:ChargeSubtype>
<ns0:PriceType>One time</ns0:PriceType>
<ns0:PricedQuantityUOM>Year</ns0:PricedQuantityUOM>
<ns0:ChargeType>Sale</ns0:ChargeType>
<ns0:ChargeCurrencyName>US Dollar</ns0:ChargeCurrencyName>
<ns0:OrderChargeComponent>
<ns0:ChargeCurrencyCode>USD</ns0:ChargeCurrencyCode>
<ns0:ChargeCurrencyExtAmount>0</ns0:ChargeCurrencyExtAmount>
<ns0:ChargeCurrencyUnitPrice>0</ns0:ChargeCurrencyUnitPrice>
<ns0:HeaderCurrencyCode>USD</ns0:HeaderCurrencyCode>
<ns0:HeaderCurrencyExtAmount>0</ns0:HeaderCurrencyExtAmount>
<ns0:HeaderCurrencyUnitPrice>0</ns0:HeaderCurrencyUnitPrice>
<ns0:OrderChargeComponentId>300100138387485</ns0:OrderChargeComponentId>
<ns0:OrderChargeId>300100138387478</ns0:OrderChargeId>
<ns0:ParentChargeComponentId xsi:nil="true"/>
<ns0:PercentOfComparisonElement xsi:nil="true"/>
<ns0:PriceElementCode>QP_BASE_LIST_PRICE</ns0:PriceElementCode>
<ns0:PriceElementUsageCode xsi:nil="true"/>
<ns0:RollupFlag>N</ns0:RollupFlag>
<ns0:SequenceNumber>1000</ns0:SequenceNumber>
<ns0:SourceChargeComponentId>300100138387485</ns0:SourceChargeComponentId>
<ns0:SourceChargeId>300100138387478</ns0:SourceChargeId>
<ns0:SourceParentChargeCompId xsi:nil="true"/>
<ns0:PricingSourceId xsi:nil="true"/>
<ns0:PricingSourceTypeCode>RETURN</ns0:PricingSourceTypeCode>
<ns0:Explanation xsi:nil="true"/>
<ns0:ExplanationMessageName xsi:nil="true"/>
<ns0:TaxIncludedFlag>N</ns0:TaxIncludedFlag>
1502
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
<ns0:ReferenceOrderChargeCompId xsi:nil="true"/>
<ns0:ChargeCurrencyName>US Dollar</ns0:ChargeCurrencyName>
<ns0:HeaderCurrencyName>US Dollar</ns0:HeaderCurrencyName>
<ns0:PriceElement>Base List Price</ns0:PriceElement>
<ns0:PriceElementUsage xsi:nil="true"/>
<ns0:ChargeCurrencyDurationExtendedAmount>0</ns0:ChargeCurrencyDurationExtendedAmount>
<ns0:HeaderCurrencyDurationExtendedAmount>0</ns0:HeaderCurrencyDurationExtendedAmount>
</ns0:OrderChargeComponent>
<ns0:OrderChargeComponent>
<ns0:ChargeCurrencyCode>USD</ns0:ChargeCurrencyCode>
<ns0:ChargeCurrencyExtAmount>0</ns0:ChargeCurrencyExtAmount>
<ns0:ChargeCurrencyUnitPrice>0</ns0:ChargeCurrencyUnitPrice>
<ns0:HeaderCurrencyCode>USD</ns0:HeaderCurrencyCode>
<ns0:HeaderCurrencyExtAmount>0</ns0:HeaderCurrencyExtAmount>
<ns0:HeaderCurrencyUnitPrice>0</ns0:HeaderCurrencyUnitPrice>
<ns0:OrderChargeComponentId>300100138387486</ns0:OrderChargeComponentId>
<ns0:OrderChargeId>300100138387478</ns0:OrderChargeId>
<ns0:ParentChargeComponentId xsi:nil="true"/>
<ns0:PercentOfComparisonElement xsi:nil="true"/>
<ns0:PriceElementCode>QP_LIST_PRICE</ns0:PriceElementCode>
<ns0:PriceElementUsageCode>LIST_PRICE</ns0:PriceElementUsageCode>
<ns0:RollupFlag>N</ns0:RollupFlag>
<ns0:SequenceNumber>1001</ns0:SequenceNumber>
<ns0:SourceChargeComponentId>300100138387486</ns0:SourceChargeComponentId>
<ns0:SourceChargeId>300100138387478</ns0:SourceChargeId>
<ns0:SourceParentChargeCompId xsi:nil="true"/>
<ns0:PricingSourceId xsi:nil="true"/>
<ns0:PricingSourceTypeCode>RETURN</ns0:PricingSourceTypeCode>
<ns0:Explanation xsi:nil="true"/>
<ns0:ExplanationMessageName xsi:nil="true"/>
<ns0:TaxIncludedFlag>N</ns0:TaxIncludedFlag>
<ns0:ReferenceOrderChargeCompId xsi:nil="true"/>
<ns0:ChargeCurrencyName>US Dollar</ns0:ChargeCurrencyName>
<ns0:HeaderCurrencyName>US Dollar</ns0:HeaderCurrencyName>
<ns0:PriceElement>List Price</ns0:PriceElement>
<ns0:PriceElementUsage>List price</ns0:PriceElementUsage>
<ns0:ChargeCurrencyDurationExtendedAmount>0</ns0:ChargeCurrencyDurationExtendedAmount>
<ns0:HeaderCurrencyDurationExtendedAmount>0</ns0:HeaderCurrencyDurationExtendedAmount>
</ns0:OrderChargeComponent>
<ns0:OrderChargeComponent>
<ns0:ChargeCurrencyCode>USD</ns0:ChargeCurrencyCode>
<ns0:ChargeCurrencyExtAmount>0</ns0:ChargeCurrencyExtAmount>
<ns0:ChargeCurrencyUnitPrice>0</ns0:ChargeCurrencyUnitPrice>
<ns0:HeaderCurrencyCode>USD</ns0:HeaderCurrencyCode>
<ns0:HeaderCurrencyExtAmount>0</ns0:HeaderCurrencyExtAmount>
<ns0:HeaderCurrencyUnitPrice>0</ns0:HeaderCurrencyUnitPrice>
<ns0:OrderChargeComponentId>300100138387480</ns0:OrderChargeComponentId>
<ns0:OrderChargeId>300100138387478</ns0:OrderChargeId>
<ns0:ParentChargeComponentId xsi:nil="true"/>
<ns0:PercentOfComparisonElement xsi:nil="true"/>
<ns0:PriceElementCode>QP_NET_PRICE</ns0:PriceElementCode>
<ns0:PriceElementUsageCode>NET_PRICE</ns0:PriceElementUsageCode>
<ns0:RollupFlag>N</ns0:RollupFlag>
<ns0:SequenceNumber>1002</ns0:SequenceNumber>
<ns0:SourceChargeComponentId>SCC1</ns0:SourceChargeComponentId>
<ns0:SourceChargeId>SC1</ns0:SourceChargeId>
<ns0:SourceParentChargeCompId xsi:nil="true"/>
<ns0:PricingSourceId xsi:nil="true"/>
<ns0:PricingSourceTypeCode xsi:nil="true"/>
<ns0:Explanation xsi:nil="true"/>
<ns0:ExplanationMessageName xsi:nil="true"/>
<ns0:TaxIncludedFlag>N</ns0:TaxIncludedFlag>
<ns0:ReferenceOrderChargeCompId xsi:nil="true"/>
<ns0:ChargeCurrencyName>US Dollar</ns0:ChargeCurrencyName>
<ns0:HeaderCurrencyName>US Dollar</ns0:HeaderCurrencyName>
<ns0:PriceElement>Your Price</ns0:PriceElement>
1503
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
<ns0:PriceElementUsage>Net price</ns0:PriceElementUsage>
<ns0:ChargeCurrencyDurationExtendedAmount>0</ns0:ChargeCurrencyDurationExtendedAmount>
<ns0:HeaderCurrencyDurationExtendedAmount>0</ns0:HeaderCurrencyDurationExtendedAmount>
</ns0:OrderChargeComponent>
<ns0:OrderChargeComponent>
<ns0:ChargeCurrencyCode>USD</ns0:ChargeCurrencyCode>
<ns0:ChargeCurrencyExtAmount>0</ns0:ChargeCurrencyExtAmount>
<ns0:ChargeCurrencyUnitPrice>0</ns0:ChargeCurrencyUnitPrice>
<ns0:HeaderCurrencyCode>USD</ns0:HeaderCurrencyCode>
<ns0:HeaderCurrencyExtAmount>0</ns0:HeaderCurrencyExtAmount>
<ns0:HeaderCurrencyUnitPrice>0</ns0:HeaderCurrencyUnitPrice>
<ns0:OrderChargeComponentId>300100138387487</ns0:OrderChargeComponentId>
<ns0:OrderChargeId>300100138387478</ns0:OrderChargeId>
<ns0:ParentChargeComponentId xsi:nil="true"/>
<ns0:PercentOfComparisonElement xsi:nil="true"/>
<ns0:PriceElementCode>QP_MARGIN</ns0:PriceElementCode>
<ns0:PriceElementUsageCode xsi:nil="true"/>
<ns0:RollupFlag>N</ns0:RollupFlag>
<ns0:SequenceNumber>1003</ns0:SequenceNumber>
<ns0:SourceChargeComponentId>300100138387487</ns0:SourceChargeComponentId>
<ns0:SourceChargeId>300100138387478</ns0:SourceChargeId>
<ns0:SourceParentChargeCompId xsi:nil="true"/>
<ns0:PricingSourceId xsi:nil="true"/>
<ns0:PricingSourceTypeCode xsi:nil="true"/>
<ns0:Explanation xsi:nil="true"/>
<ns0:ExplanationMessageName xsi:nil="true"/>
<ns0:TaxIncludedFlag>N</ns0:TaxIncludedFlag>
<ns0:ReferenceOrderChargeCompId xsi:nil="true"/>
<ns0:ChargeCurrencyName>US Dollar</ns0:ChargeCurrencyName>
<ns0:HeaderCurrencyName>US Dollar</ns0:HeaderCurrencyName>
<ns0:PriceElement>Margin</ns0:PriceElement>
<ns0:PriceElementUsage xsi:nil="true"/>
<ns0:ChargeCurrencyDurationExtendedAmount>0</ns0:ChargeCurrencyDurationExtendedAmount>
<ns0:HeaderCurrencyDurationExtendedAmount>0</ns0:HeaderCurrencyDurationExtendedAmount>
</ns0:OrderChargeComponent>
</ns0:OrderCharge>
</ns0:OrderFulfillLine>
<ns0:LineEffCategories xsi:type="ns17:j_LineEffDooLinesAddInfoprivate" xmlns:ns16="http://
xmlns.your_server.com/apps/scm/doo/processOrder/flex/lineContextsB/" xmlns:ns17="http://
xmlns.your_server.com/apps/scm/doo/processOrder/flex/lineCategories/">
<ns3:Category>DOO_LINES_ADD_INFO</ns3:Category>
<ns3:LineId>300100138387476</ns3:LineId>
</ns0:LineEffCategories>
</ns0:OrderLine>
<ns0:HeaderEffCategories xsi:type="ns19:j_HeaderEffDooHeadersAddInfoprivate" xmlns:ns18="http://
xmlns.your_server.com/apps/scm/doo/processOrder/flex/headerContextsB/" xmlns:ns19="http://
xmlns.your_server.com/apps/scm/doo/processOrder/flex/headerCategories/">
<ns3:Category>DOO_HEADERS_ADD_INFO</ns3:Category>
<ns3:HeaderId>300100138387475</ns3:HeaderId>
</ns0:HeaderEffCategories>
<ns0:OrderTotals>
<ns0:CurrencyCode>USD</ns0:CurrencyCode>
<ns0:DisplayName xsi:nil="true"/>
<ns0:EstimatedFlag>N</ns0:EstimatedFlag>
<ns0:HeaderId>300100138387475</ns0:HeaderId>
<ns0:OrderTotalId>300100138387505</ns0:OrderTotalId>
<ns0:PrimaryFlag>N</ns0:PrimaryFlag>
<ns0:TotalAmount>0</ns0:TotalAmount>
<ns0:TotalCode>QP_TOTAL_NET_PRICE</ns0:TotalCode>
<ns0:TotalGroup>2.3.0</ns0:TotalGroup>
</ns0:OrderTotals>
<ns0:OrderTotals>
<ns0:CurrencyCode>USD</ns0:CurrencyCode>
<ns0:DisplayName xsi:nil="true"/>
<ns0:EstimatedFlag>N</ns0:EstimatedFlag>
<ns0:HeaderId>300100138387475</ns0:HeaderId>
1504
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
<ns0:OrderTotalId>300100138387506</ns0:OrderTotalId>
<ns0:PrimaryFlag>N</ns0:PrimaryFlag>
<ns0:TotalAmount>0</ns0:TotalAmount>
<ns0:TotalCode>QP_TOTAL_DISCOUNT</ns0:TotalCode>
<ns0:TotalGroup>1.2.0</ns0:TotalGroup>
</ns0:OrderTotals>
<ns0:OrderTotals>
<ns0:CurrencyCode>USD</ns0:CurrencyCode>
<ns0:DisplayName xsi:nil="true"/>
<ns0:EstimatedFlag>N</ns0:EstimatedFlag>
<ns0:HeaderId>300100138387475</ns0:HeaderId>
<ns0:OrderTotalId>300100138387500</ns0:OrderTotalId>
<ns0:PrimaryFlag>N</ns0:PrimaryFlag>
<ns0:TotalAmount>0</ns0:TotalAmount>
<ns0:TotalCode>QP_TOTAL_CREDIT</ns0:TotalCode>
<ns0:TotalGroup>2.6.0</ns0:TotalGroup>
<ns0:OrderTotalComponents>
<ns0:OrderChargeComponentId>300100138387480</ns0:OrderChargeComponentId>
<ns0:OrderTotalComponentId>300100138387501</ns0:OrderTotalComponentId>
<ns0:OrderTotalId>300100138387500</ns0:OrderTotalId>
</ns0:OrderTotalComponents>
</ns0:OrderTotals>
<ns0:OrderTotals>
<ns0:CurrencyCode>USD</ns0:CurrencyCode>
<ns0:DisplayName xsi:nil="true"/>
<ns0:EstimatedFlag>N</ns0:EstimatedFlag>
<ns0:HeaderId>300100138387475</ns0:HeaderId>
<ns0:OrderTotalId>300100138387502</ns0:OrderTotalId>
<ns0:PrimaryFlag>Y</ns0:PrimaryFlag>
<ns0:TotalAmount>0</ns0:TotalAmount>
<ns0:TotalCode>QP_TOTAL_PAY_NOW</ns0:TotalCode>
<ns0:TotalGroup>3.7.1</ns0:TotalGroup>
<ns0:OrderTotalComponents>
<ns0:OrderChargeComponentId>300100138387480</ns0:OrderChargeComponentId>
<ns0:OrderTotalComponentId>300100138387503</ns0:OrderTotalComponentId>
<ns0:OrderTotalId>300100138387502</ns0:OrderTotalId>
</ns0:OrderTotalComponents>
</ns0:OrderTotals>
<ns0:OrderTotals>
<ns0:CurrencyCode>USD</ns0:CurrencyCode>
<ns0:DisplayName xsi:nil="true"/>
<ns0:EstimatedFlag>N</ns0:EstimatedFlag>
<ns0:HeaderId>300100138387475</ns0:HeaderId>
<ns0:OrderTotalId>300100138387507</ns0:OrderTotalId>
<ns0:PrimaryFlag>N</ns0:PrimaryFlag>
<ns0:TotalAmount>0</ns0:TotalAmount>
<ns0:TotalCode>QP_TOTAL_SHIP_CHARGE</ns0:TotalCode>
<ns0:TotalGroup>2.4.0</ns0:TotalGroup>
</ns0:OrderTotals>
<ns0:OrderTotals>
<ns0:CurrencyCode>USD</ns0:CurrencyCode>
<ns0:DisplayName xsi:nil="true"/>
<ns0:EstimatedFlag>N</ns0:EstimatedFlag>
<ns0:HeaderId>300100138387475</ns0:HeaderId>
<ns0:OrderTotalId>300100138387508</ns0:OrderTotalId>
<ns0:PrimaryFlag>N</ns0:PrimaryFlag>
<ns0:TotalAmount>0</ns0:TotalAmount>
<ns0:TotalCode>QP_TOTAL_TAX</ns0:TotalCode>
<ns0:TotalGroup>2.5.0</ns0:TotalGroup>
</ns0:OrderTotals>
<ns0:OrderTotals>
<ns0:CurrencyCode>USD</ns0:CurrencyCode>
<ns0:DisplayName xsi:nil="true"/>
<ns0:EstimatedFlag>N</ns0:EstimatedFlag>
<ns0:HeaderId>300100138387475</ns0:HeaderId>
<ns0:OrderTotalId>300100138387504</ns0:OrderTotalId>
1505
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
<ns0:PrimaryFlag>N</ns0:PrimaryFlag>
<ns0:TotalAmount>0</ns0:TotalAmount>
<ns0:TotalCode>QP_TOTAL_LIST_PRICE</ns0:TotalCode>
<ns0:TotalGroup>1.1.0</ns0:TotalGroup>
</ns0:OrderTotals>
</ns0:Value>
</ns2:result>
</ns0:getOrderDetailsResponse>
</env:Body>
</env:Envelope>
Related Topics
• Return Items Without Original Sales Order
• Opt Into Features in Order Management
• Example Web Service Payloads That Integrate Order Management
1506
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
Assume you need to add a reason that the Order Entry Specialist can choose to indicate that the customer feels the
description that you have for the item on your website isn't accurate.
1. Create lookup.
2. Collect data.
1507
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
Create Lookup
1. In the Setup and Maintenance work area, go to the task.
Attribute Value
3. In the Lookup Codes area, click Actions > New then set values.
Attribute Value
Display Sequence 1
Collect Data
1. Go to the Plan Inputs work area.
Don't use the Plan Inputs task that's available in the Setup and Maintenance work area. Use the Plan Inputs
work area instead.
2. In the Plan Inputs work area, click Tasks > Collect Planning Data.
1508
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
3. In the Collect Planning Data dialog, set your source system, then move reference entities to selected entities.
For details, see the Collect Planning Data for Order Management topic.
Attribute Value
Open No
Status Closed
You can only return a sales order that isn't open and that's closed, or an order line that Order Management has
shipped but not closed.
3. In the search results, in the Order column, click the sales order you must return.
4. On the Order page, in the Order Lines area, choose the order line you must return, then click Return.
5. In the Return Items dialog, verify that you can set the value.
Attribute Value
Related Topics
• Overview of Collecting Promising Data for Order Management
1509
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
• Order import template. The template is SourceSalesOrderImportTemplate.xlsm. Many of the return attributes
are on tab DOO_ORDER_LINES_ALL_INT.
• Web service in Oracle Application Development Framework (ADF).
1510
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
Required Attributes
Here are the attributes that your import must include.
Attribute Description
Attribute that identifies the item. Choose from the group. For example, Product Number.
Ordered Quantity Make sure quantity is greater than 0 for a new source order. You can use 0 for a revise order.
• Allows decimals. Make sure the number of digits after the decimal point doesn't exceed
the maximum number of digits allowed according to profile Quantity Decimal Precision.
For details, see the Control Decimal Precision topic.
• Doesn't allow decimals. Make sure the source order doesn't include decimal values.
Ordered UOM Make sure the unit of measure is appropriate for the item.
For example, Quart is appropriate for a liquid, but Amperage isn't because amperage measures
electrical current.
If the item returns a coverage, then make sure the unit of measure is appropriate for the
covered item.
Return Type Identifies type of order line. Use a value from the Return Order Line Types lookup.
If you use the order import template, then use the Transaction Line Type Code attribute in
column AB of tab DOO_ORDER_LINES_ALL_INT.
Return Location If Return Type is Return for credit and return the item, then the import requires
Return Location.
If you use the order import template, then use the Requested Fulfillment Organization
Identifier attribute in column N of tab DOO_ORDER_LINES_ALL_INT.
Return Reason If you use the order import template, then use the Return Reason attribute in column DJ and
DK of tab DOO_ORDER_LINES_ALL_INT.
Coverage
If you cancel a coverage, then include the Covered Item attribute, the Source System Reference for Covered Product
attribute, and at least one of these attributes.
1511
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
Cancel a Service
A service can be a coverage and subscription. For details, see the Import Source Orders That Include Coverage or
Subscriptions topic.
Here are the attributes you can use when you cancel a service.
Attribute Description
For details about these types, see the Set Up Coverage for Sales Orders topic.
Note.
• If your source system already priced the source order, and if source order includes Duration, then you must also
include the extended amount for duration.
• If the import includes a coverage, then you must also include the covered item.
Not Allowed
Make sure your import doesn't . . .
• Include a configured item.
• Include recurring billing. The source order must specify one time billing.
• Modify a return item and its covered item or add or remove the original sales order revision.
Related Topics
• Return Items Without Original Sales Order
1512
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
An unreferenced return is a sales order that includes a return line that doesn't reference the sales order that your
customer used to purchase the item.
Examples
Your Customer Returns a Whole Bunch of Orders
Vision Corporation is a wholesaler who sold 8,000 items in 475 sales orders to retailer Fantastic Laptops.
One year later, Fantastic Laptops returns 50 items in a large container. To simplify order entry, billing, and through
agreement with Fantastic Laptops, Vision Corporation credits all items at the same price. The Order Entry Specialist
uses the Order Management work area to create a single unreferenced return order for all the returned items. This
approach allows the Order Entry Specialist to complete the return without having to spend many hours looking up the
original sales order for each item.
First Software maintains over 50 outlets in a fast-paced environment. They sell to an established set of clients, and
maintain a contractual, working relationship with each client. Each outlet receives return items that they sold, and also
returns items that other outlets sold. However, personnel who work at the outlets don't have time to look up the original
sales order for each return.
First Software trusts their clients and don't feel its necessary to confirm the original sales order. At the end of the week,
one person at each location enters all returns they received into a single return order that doesn't reference any of the
original sales orders.
Computer Service and Rentals is a new company who sells laptops in a retail marketplace. They are interested in gaining
market share, so they accept items that their customer purchased from a competitor as part of a promotion to sell new
laptops. Computer Service and Rentals enters these items as unreferenced returns, then sells them later as refurbished.
Green Corporation sells magazine subscriptions. Customers call the call center to cancel subscriptions. Green
Corporation recently upgraded to Order Management, but didn't migrate order data from their legacy system to Order
Management.
The Order Entry Specialist creates an unreferenced return to cancel the subscription and credit the remaining part of the
subscription that the customer already paid but didn't use. The Order Entry Specialist sets details on the order line, such
as item, quantity, return type, and then uses attribute Duration and attribute Period to specify details about the return.
Order Management calculates the price when the Order Entry Specialist adds the return to the order.
Computer Service and Rentals is a retailer who sells directly to the public. Their customer returns an item but doesn't
have the original receipt, and the item doesn't include a serial number or other marking that the Order Entry Specialist
can use to look up the item when creating the return. The Order Entry Specialist uses the Add Unreferenced Return
Lines action to add the item.
1513
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
Small Inc.is a retailer who sells the Long Life Tea Set, which is a pick-to-order, configured item that includes configure
options, such as steeping pot, pouring vessel, and set of tea cups. Customers return items but no longer have the
receipt, and the item doesn't include an identifying marking that the Order Entry Specialist can use to look up the
item when creating the return. The Order Management work area doesn't allow the Order Entry Specialist to return a
configured item. Instead, the Order Entry Specialist creates a return line for each configure option.
If you have an unreferenced return, and if you're returning a configured item that's.
• pick-to-order. You can return one or more individual configure options or the entire item.
• assemble-to-order. You can't return any configure option. You can't return the entire item.
How It Works
1514
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
• Fills in attributes on the order header, then, in the Order Lines area, clicks Add Unreferenced Return Lines.
• Adds unreferenced return lines, then clicks Add to add them to the sales order.
• Uses attribute values from the order header to set default values for attributes on return lines.
• Runs pretransformation rules to set the default values.
• Prices the return according to current system date.
• Sets Billing Frequency to One Time Billing and credits the entire amount as a single credit.
• Adds included item for each kit according to the product structure you set up in the Product Information
Management work area.
Set Up
1515
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
If you're upgrading, then here's what it does, depending on whether you extended pricing algorithms.
• Determines whether the return line does or doesn't include a reference to the original sales order.
• Calculates price like it normally calculates a sales order line, then adds a negative sign.
• Calculates price according to the pricing set up that exists on the return date or cancel date. For example, it
applies the discounts and charges that existed on the item as of the return date or cancel date.
• Calculates a one time charge or recurring charge.
• Calculates the pricing adjustment and discount.
• If Pricing can't determine the charge, then it applies a zero charge.
• Allows the Order Entry Specialist to manually adjust the price as an override on the return line.
• Prices the cancel for a coverage or subscription, including pricing only part of the coverage or subscription
period.
1516
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
For example.
Note.
• Pricing determines that the list price for the AS54888 item is $2500.00 according to the price that exists on the
date and time when the user added the order line.
• Pricing applies the negative sign to get -2500.00.
• The user overrides the price to -$2000.00. For example, assume your company policy requires that you reduce
the refund by $500 when the customer returns the AS54888 without the original sales order.
1517
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
1518
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
Get a Report
In the Reports and Analytics work area, expand the Order Management - Fulfillment Lines Real Time subject area,
expand Fulfillment Lines General Details, then notice the attributes you can use for a fulfillment line. To create a report
that includes unreferenced return lines, add a filter.
For details, see the Use Reports and Analytics with Order Management topic.
Related Topics
• Return Items Without Original Sales Order
• Opt Into Features in Order Management
1519
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
• If the return doesn't reference the original sales order, then don't allow the user to modify Cancellation Effective
Date.
1520
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
For details about processing constraints, see the Set Up Processing Constraints topic.
Use an order management extension to implement a more specialized constraint. For example, if its been 15 days or
more since Order Management sent the sales order to invoicing, then write an extension that prevents the user from
creating a return material authorization. Use the On Save extension point. For details, see the Overview of Creating
Extensions That Modify Order Management topic.
This topic includes example values. You might use different values, depending on your business requirements.
1521
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
Try it.
◦ On the Manage Processing Constraints page, click Validation Rule Set, then add a rule set.
Attribute Value
Attribute Value
Description If the return doesn't reference the original sales order, then don't allow user to modify
date.
◦ In the Details area, click Actions > Add Row, set values, then click Save.
Attribute Value
◦ Click Generate Packages, notice the Confirmation dialog displays your request ID, then wait a few
minutes for the request to finish.
For example.
The concurrent request to generate constraints validation packages was submitted. Request ID:
10650.
◦ Click Constraints > Actions > Add Row, then set values.
1522
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
Attribute Value
Attribute Value
Group Number 1
Scope Any
Message You must not modify Cancellation Effective Date when you return a sales order without
the original order because Order Management uses this date to price the return.
Attribute Value
1523
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
Attribute Value
2. In the Order Lines area, click Actions > Create Unreferenced Return Lines, then set values.
Attribute Value
Item Add a subscription that uses a fixed Service Duration Type. For details about this type, see
the Set Up Coverage for Sales Orders topic.
For this example, assume your implementation includes fixed subscription QP_SUBS_ITEM7-
FIXED.
Return Quantity 1
UOM Each
3. Click Submit.
4. If the order line status is Not Started, then wait a moment, and click Refresh. Repeat until status is Awaiting
Receiving.
5. Click Actions > Create Revision.
6. On the order line, modify the value in Cancellation Effective Date, then click Submit.
Related Topics
• Return Items Without Original Sales Order
• Overview of Creating Order Management Extensions
1524
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
Note.
1. You create a lookup that allows your users to specify whether its a return without credit.
1525
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
2. The user searches for and views a closed sales order, clicks Return in the Order Lines area, then uses the Return
Items dialog to set Return Type.
3. You create an assignment rule.
Attribute Value
4. In the Lookup Codes area, click Actions > New, set values, then click Save and Close.
Attribute Value
1526
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
Attribute Value
3. In the search results, click the row that includes ReturnOrderGenericProcess in the Name column, then click
Actions > Duplicate.
4. On the Edit Orchestration Process Definition page, set values, then click Save.
Attribute Value
Process Display Name Return Sales Order Without Creating Credit Memo
5. In the Process Details area, click Status Conditions > Fulfillment Line Status Values, then click Edit Status
Rule Set.
6. On the Edit Status Rule Set page, delete rows that contain the following values in the Status Value column, then
click Save and Close.
◦ Awaiting Billing
◦ Billed
◦ Partially Received
7. In the Process Details area, click Orchestration Process Status Values, then delete rows that contain the
following values in the Status Value column.
◦ Awaiting Billing
◦ Billed
◦ Partially Received
8. In the Process Details area, click Step Definition, then delete rows that contain the following values in the Step
Name column.
1527
Oracle SCM Cloud Chapter 8
Implementing Order Management Process Sales Orders
9. Click Save, then deploy the orchestration process. For details, see the Deploy Orchestration Processes topic.
For details about how to create an assignment rule, see the Overview of Using Business Rules topic.
Related Topics
• Return Items Without Original Sales Order
• Overview of Using Business Rules With Order Management
• Deploy Orchestration Processes
• Orchestration Processes
1528
Oracle SCM Cloud Chapter 9
Implementing Order Management Configure-to-Order
9 Configure-to-Order
Overview
Overview of Configure-to-Order
Use configure-to-order to allow your customer to choose options for each component of a configured item.
For example, order a laptop computer with a 1 terabyte hard drive. The computer is an example of a configured item.
The hard drive is an example of a configure option. 1 terabyte and 500 megabytes are each values your customer can
choose for the option. A configured item can include more than one configure option. A laptop computer can include
other options, such as memory, the display, color of the chassis, and so on.
1529
Oracle SCM Cloud Chapter 9
Implementing Order Management Configure-to-Order
1530
Oracle SCM Cloud Chapter 9
Implementing Order Management Configure-to-Order
Concept Description
Configuration model A structure that defines the options your user can choose for each component. You can also
specify that a component is required. You define the model during set up. You don't order or
build the model at run time.
Configure option Child of an object class. The hard drive, monitor, and mouse are each an example of a
configure option. Your user can choose the value for a configure option from a list of available
options.
Configured item An item that includes one or more configure options that your user chooses. A desktop
computer where you choose the hard drive, monitor, and mouse is an example of a configured
item. A configured item is the result of the choices that your user makes at run time when
configuring the item.
Required component Component in the model that the user can't choose. For example, you usually can't choose the
cooling fan when you order a laptop computer.
Note.
• You create the model, classes, options, and structure in the Product Information Management work area at
design time.
• A user chooses options in the Order Management work area in a sales order at run time.
1531
Oracle SCM Cloud Chapter 9
Implementing Order Management Configure-to-Order
Example
Here's an example of a configuration model.
Note.
• The model, each option class, and each option are separate items that you create in the Product Information
Management work area. For example, CTO_474000 is the item name for the model, CTO_474100 is the name of
the screen option class, and CTO_474101 is the name of the 14" screen option.
• The processor and battery are required components in this model. You can't order a laptop without them.
• The screen option class is required. You can't order a laptop without a screen, but you can order a 14" screen or
15.6" screen.
1532
Oracle SCM Cloud Chapter 9
Implementing Order Management Configure-to-Order
• The camera option class is optional. You can order a laptop without a camera. If you add a camera, then you can
add a front camera, rear camera, or front and rear camera.
• Your user chooses the options at run time.
You use the Product Information Management work area to create the structure. For example.
Types of Configurations
Configuration Description
Assemble-to-order (ATO) Item that isn't yet manufactured and isn't ready to ship. You make it or procure it according to
the options that your user sets.
• A warehouse usually doesn't stock every possible set of options your user might set.
Instead, the warehouse receives the work order, then.
• Uses a drop-ship flow or back-to-back flow to purchase the configured item from a
supplier.
• Uses a back-to-back flow to manufacture the item according to the work order.
Pick-to-order (PTO) Item where you already manufactured the components, or you must make or purchase them.
1533
Oracle SCM Cloud Chapter 9
Implementing Order Management Configure-to-Order
Simple Example
Here's an example that includes a few configure options..
1534
Oracle SCM Cloud Chapter 9
Implementing Order Management Configure-to-Order
You go to the Order Management work area, create a sales order, search for a configuration model on the catalog line,
then click Configure and Add. Use the Configure page to set configure options. For details, see the Add Configured
Items to Order Lines topic.
Complex Example
Add complexity to your model. Assume you sell a kitchen stove top with oven. You need to provide a variety of
configure options, such as gas, electric, convection, commercial, residential, type of finish, and so on. For this sales
order, your customer needs large commercial gas burners for the stove top, a convection gas main oven, a convection
gas warning oven, a griddle with commercial burners, large knobs, and stainless steel finish.
Note.
• This configuration includes a parent model. The parent references child models.
• Deluxe Viking Stove is the parent model.
1535
Oracle SCM Cloud Chapter 9
Implementing Order Management Configure-to-Order
• Viking Stove Burner ATO and Oven ATO are each a child model.
• Burner Knobs is an option class.
• Large Knobs and Small Knobs are each a configure option in the Burner Knobs class.
• Finish is an option class.
• Midnight Black Finish, Stainless Steel Finish, and Winter White Finish are each a configure option in the Finish
class.
• In this example, the user has chosen options.
This model includes two different types of ovens. The main oven and a warming oven. The user can choose the type of
oven and the type of warmer.
1536
Oracle SCM Cloud Chapter 9
Implementing Order Management Configure-to-Order
Note.
• The Oven ATO model is a child of the parent Deluxe Viking Stove model.
Note that VIK12 is an abbreviation for Deluxe Viking Stove. You can specify it.
• Oven Type is an option class in the Oven ATO model.
• Gas, Gas with Convection, and Electric Oven are each an option in the Oven Type class.
• Warming Oven is an option class in the Oven ATO model.
• Gas, Gas with Convection, and Electric Oven are each an option in the Warming Oven class.
1537
Oracle SCM Cloud Chapter 9
Implementing Order Management Configure-to-Order
Note.
• Burner Style ATO is a child model of the Viking Stove Burner ATO model and a grandchild of the parent Deluxe
Viking Stove model.
• In this example, the user can choose two options for the Commercial Burners class.
◦ The Large Commercial option specifies to use large commercial burners for the stove top.
◦ The Griddle option specifies to include a griddle burner for the griddle part of the stove top. Commercial
stove tops often include more than one burn area. One area includes an open flame and another area
includes a flat, steel griddle. This model illustrates how you can set up your configuration to meet
specialized customer requirements.
1538
Oracle SCM Cloud Chapter 9
Implementing Order Management Configure-to-Order
◦ You can continue to add child, grandchild, great grandchild models and so on to meet your specific
hierarchical requirements.
For details about this example model, see the Overview of Using Web Services with Configure-to-Order topic.
More Examples
Here are some more examples.
For example.
• Use a transaction attribute to add content at run-time, such as the weight of the item.
• Add detail, such as display a second dialog that includes choices for accessories.
1539
Oracle SCM Cloud Chapter 9
Implementing Order Management Configure-to-Order
Here's an example where you choose options for a car, such as color, seat trim, seats, and so on.
Related Topics
• Add Configured Items to Order Lines
1540
Oracle SCM Cloud Chapter 9
Implementing Order Management Configure-to-Order
1541
Oracle SCM Cloud Chapter 9
Implementing Order Management Configure-to-Order
Note.
1. Your user creates a sales order in the Order Management work area, searches the catalog line for the
zCZ_AT6751010- Vision Slimline 5001 item, clicks Configure and Add, uses the Configure dialog to set configure
options, clicks Finish, then submits the order.
2. Order Management sends a request to Supply Orchestration. The request includes details about the configured
item, including options that the user chooses.
If its an assemble-to-order request, or a pick-to-order request with at least one assemble-to-order component,
then Supply Orchestration examines the request to determine whether it already processed the configured item
during a prior request.
1542
Oracle SCM Cloud Chapter 9
Implementing Order Management Configure-to-Order
Hasn't already processed the Supply Orchestration sends a request to Product Information Management to create a new
configured item during a prior one, and Product Information Management creates it.
request.
Product Information Management stores the configuration in a single record with a unique
name. Order Management stores the record identifier in the Configuration Item attribute on
the order line.
For example.
◦ Assume the user adds the Vision Slimline 5001 to an order line. It includes configure
options for the screen and CPU. The user sets the screen to 10" and CPU to 2.5GHz.
Supply Orchestration searches it records and finds that no other order line has ever
requested this configuration, so it sends a request to create it.
◦ Some time later, the user adds another Slimline and sets the screen to 10" and CPU to
2.5GHz. Supply Orchestration finds the exact same configuration and uses it.
◦ Some time later, the user adds another order line that contains the Slimline, but this
time sets the screen to 8" and CPU to 2.5GHz. Supply Orchestration doesn't find the
exact same configuration, so it sends a request to create it.
Supply Orchestration sends a request to create a new configuration even if only one option is
different from configurations it already created.
This feature works the same across users, order lines, and orders.
Already processed the configured Supply Orchestration sends the Configuration Item attribute to Order Management.
item with the same configure
options in a previous request.
1543
Oracle SCM Cloud Chapter 9
Implementing Order Management Configure-to-Order
Note.
◦ A search for zCZ_AT6751010 returns the model and each instance of the model.
◦ zCZ_AT6751010 is the configuration model you create. Product Information Management doesn't update
it.
1544
Oracle SCM Cloud Chapter 9
Implementing Order Management Configure-to-Order
◦ Supply Orchestration sent a request to Product Information Management to create the other two
instances when your user ordered them in Order Management.
• zCZ_AT6751010*1088 is a unique instance of zCZ_AT6751010. It contains specific values that your
user chooses, such as a 10" screen and 2.5GHz CPU.
• zCZ_AT6751010*1089 is another unique instance of zCZ_AT6751010. It contains an 8" screen and
2.5GHz CPU.
Product Information Management stores the item as a nonconfigured item with no structure. It doesn't
store the structure of the configured item instance. It does this to avoid storing duplicate structural
elements in tables. Supply Orchestration stores the choices your user makes for each configure option
and the structure in the match repository that Supply Orchestration uses. If you enable transaction
attributes on your item, then Supply Orchestration also stores them in the match repository.
3. The flow continues. It uses the same steps that a make flow uses for an item that isn't configured. For details,
see the How Supply Orchestration Works topic.
Points to Consider
• Configure-to-order primarily supports the make flow and the buy flow. It also supports the transfer flow and
drop ship flow. For example, if your customer returns a configured item, then its available for transfer or ship
from stock.
• Supply Orchestration sends a request to Product Information Management to create the configured item for
assemble-to-order when the user clicks Submit in the Order Management work area.
• The configure-to-order flow creates the configured item in Product Information Management on demand,
when you need it. If the configuration already exists, then the flow reuses it instead of creating a new record.
Inventory creates the physical item just-in-time, only when you need it, then ships it. Inventory doesn't stock
the item before you need it. Inventory creates another instance of the physical item for each shipment.
• Configure-to-order also supports drop ship where you source and ship from a supplier. Supply Orchestration
doesn't manage supply for drop ship, but it does manage creating the configured item in a drop ship flow.
• To support the make flow, configure-to-order uses the work definition to create a work order at run time.
The model can be valid in Product Information Management but the flow can still fail in manufacturing. For
example, if the work order in manufacturing fails to assign even one option or option class to an operation step,
then the work definition isn't valid, Promising won't provide a recommendation, and the flow will fail.
• Use the View Configured Item Structure page or a web service to get details about each configure option. For
details, see the View Structures of Configured Items topic.
• You can't disable matching because it makes sure your flow is efficient.
◦ You can add a transactional item attribute for configuration matching that implements specificity in your
configuration. You can add it to an item class at any level of your model.
◦ The Match Configuration attribute on the Specifications tab on the Edit Item page in Product Information
Management applies to Oracle E-Business Suite. It has no effect on Oracle Cloud applications.
◦ At run time, you can't cancel a configure option in a pick-to-order item or kit when the shipment is out of
proportion. Assume configured item A includes configure option B and configure option C. 1 unit of item
A includes 1 unit of option B, and 1 unit of option C, so the proportion is 1-1-1 (1 unit of A equals 1 unit of B
and 1 unit of C). Assume you order 10 units of item A, so the ordered proportion is now 10-10-10. Assume
you ship 8 units of B and 2 units of C. The proportion in the shipment is 10-8-2, and its out of proportion.
If the shipment is out of proportion, then you can't cancel the remaining quantity that hasn't shipped.
Child Components
1545
Oracle SCM Cloud Chapter 9
Implementing Order Management Configure-to-Order
Configure-to-order supports each item or assemble-to-order model as a child component in a pick-to-order model. The
back-to-back flow can stock each component separately, in different locations.
• It isn't necessary to source all child components in a pick-to-order model from the same business-to-business
flow.
• You can ship some children in a typical Order Management shipment as long as you ship them together with
the business-to-business items.
• If you use the same date, then you can ship all children in a business-to-business flow or none in the business-
to-business flow.
• You can drop ship all children from the same supplier.
Main Setup
1546
Oracle SCM Cloud Chapter 9
Implementing Order Management Configure-to-Order
Overview
Guidelines for Setting Up Configuration Models
Follow guidelines to help your setup go smoothly.
Note.
1547
Oracle SCM Cloud Chapter 9
Implementing Order Management Configure-to-Order
2. Use the Setup and Maintenance work area to manage the item class.
3. Use the Product Information Management work area.
For example, if you set Optional to Yes for the Hard Drive component, and if the user doesn't choose an option
for the hard drive, such as 1TB or 2TB, then configure-to-order uses the default value that you set for the hard
drive.
• If you use a transaction attribute, then, to create a new configured item at run time, set the scope to
Configuration Matching in the item class for your transaction attribute. You must set the scope for each
1548
Oracle SCM Cloud Chapter 9
Implementing Order Management Configure-to-Order
transaction attribute that's unique in your assemble-to-order model. If you don't do this, then Order
Management will save the value, but Supply Orchestration won't save it or send it to manufacturing.
Note.
• Click Tasks > Create Item in the Product Information Management work area to create the model, each class,
and each option.
• Click Specifications > Manufacturing.
◦ Set Build In WIP to Yes for an assemble-to-order model and each option. It instructs manufacturing to
build the item.
1549
Oracle SCM Cloud Chapter 9
Implementing Order Management Configure-to-Order
◦ Set Shippable to Yes for an assemble-to-order model model and each of its options. Set it to No for a
pick-to-order model and each of its options. Pick-to-order is already built, for example, with a return or
transfer order.
◦ Set Shippable and Build In WIP to No for any option class. You don't build or ship the class. You build and
ship the option in the class.
• Click Specifications > Sales and Order Management.
◦ Set Back to Back Enabled to Yes for an assemble-to-order model for all Inventory organizations.
◦ Set Shippable to Yes for an assemble-to-order model model. Set it to No for a pick-to-order model and
each of its option classes and options.
• Promise an assemble-to-order item, pick-to-order item, or a hybrid that includes an assemble-to-order item
inside a pick-to-order item.
• Consider lead times for the model, option class, and option when determining the lead time for the configured
item. You can do supply chain availability but not lead-time promising when you use an available-to-promise
rule in a business-to-business flow. You can set some values, but don't mix rule types.
• Exclude sourcing on each option and option class.
• Create a supply recommendation at run time for each configured item in a back-to-back flow.
• Promise each configured item in a drop ship flow.
1550
Oracle SCM Cloud Chapter 9
Implementing Order Management Configure-to-Order
• Make sure Supply Planning is available for each component. Planning plans each component, including child
models.
Note.
• Go to the Plan Inputs work area, then click Tasks > Collect Planning Data.
• Collect your configured item on a schedule, such as at the end of each day, so the flow can include them in
the on-hand quantity. For example, the return orders you receive throughout the day might increase on-hand
quantity.
• Collect items, item structures, and work definitions for your new model. Promising won't provide a make
recommendation if you don't collect the work definition.
1551
Oracle SCM Cloud Chapter 9
Implementing Order Management Configure-to-Order
• Collect on-hand inventory for each configure option. If even one component isn't in stock, then Promising won't
display availability for your model.
• You must collect each new configured item.
• Refresh the repository after you collect.
Consider resource capacity and availability for each configured item that you manufacture.
If Then
Note.
• You can use an available-to-promise rule to promise according to fixed and variable lead times for an attribute
on the option.
• Oracle Manufacturing Cloud supports assignments at any level in the model.
If you use the Configurator Models work area, then follow these guidelines.
• If you must display a transaction attribute at run time, then import your model into the Configurator Models
work area.
• If you revise a model, update the item class, add it to an unreleased workspace, then release the workspace into
the Configurator Models work area.
1552
Oracle SCM Cloud Chapter 9
Implementing Order Management Configure-to-Order
For details, see the How You Create and Maintain Configurator Models topic.
• File-base data import. Use the same template you use when you import a sales order that includes only one
order line.
• Web service. Use the same web service you use when you import a sales order that includes only one order
line.
• Make sure your import includes child lines for the configure options and that it establishes a relationship
between the child and parent configured item.
For details, see the How You Create and Maintain Configurator Models topic.
Import a Revision
Assume you use your own application to set up a configuration model and to create the bill of materials that Oracle
Fusion uses to build the model, and you use that list to import the order lines that contain your configured item and its
components. If at some later point you import a revision for the model, then you must make sure the sequence that you
use in the revision is identical to the sequence you used in the original import.
Assume you import a configuration model for a desktop computer, it has 3 components, and you import this sequence
and hierarchy.
Desktop Computer
4K Monitor
HD Monitor
You also have a rule that says depending on the value of the Desktop Computer, if user doesn't select 4K Monitor, then
add the HD Monitor to the configured item.
Some time later, you import a revision for Desktop Computer. If your revision doesn't import Desktop Computer, 4K
Monitor, and HD Monitor in the same sequence that you used in the original import, then the configuration might fail.
For example, if your revision imports 4K Monitor before it imports Desktop Computer, then the rule might fail because
the rule logic depends on the value of Desktop Computer before it can proceed to make the decision about HD Monitor.
If your application integrates with Oracle Fusion Configurator and you used it to set up the configuration model,
then don't import the entire list of components from the model when your send your revision. Instead, import only
the configuration header and revision number, and the import will communicate with Oracle Fusion Configurator to
recreate the component list.
Troubleshoot
You set up a configuration model in two phases.
1. Create the model, options, classes, and hierarchy in Product Information Management.
2. Send details about the model to your downstream systems.
1553
Oracle SCM Cloud Chapter 9
Implementing Order Management Configure-to-Order
Use the Manage Configured Item Exceptions page to examine most errors that occur in this step. Correct the
error and resubmit, or ignore it.
Other Guidelines
Use two browser applications during set up. Opening a second browser application allows you toggle between work
areas without having to close a work area, go through the Navigator, then open another work area. For example, you
can keep the Product Information Management work area open in browser x, open the Work Definition work area in
1554
Oracle SCM Cloud Chapter 9
Implementing Order Management Configure-to-Order
browser y, then toggle between x and y as necessary if you find you need to modify your set up in Product Information
Management.
Related Topics
• Create and Maintain Configurator Models
• Overview of Phantom Explosion in Work Orders
1555
Oracle SCM Cloud Chapter 9
Implementing Order Management Configure-to-Order
Details
Visualize the Hierarchy for Your Configuration Model
Use a graphics program or pen and paper to visualize the hierarchy.
Assume you must set up configuration model CTO_474000, Build My Laptop, in a make flow that uses assemble-to-
order.
Note.
• Come up with a meaningful name for your model, such as Build My Laptop.
• Identify the classes in your model that you will allow your customer to choose. For example, you can often
choose from different screen sizes, memory, and hard drives when you buy a laptop, but you usually can't
specify the voltage for the hard drive.
1556
Oracle SCM Cloud Chapter 9
Implementing Order Management Configure-to-Order
• Identify the options you will provide in each class, such as a 14" screen and a 15.6" screen.
• Design a number nomenclature that uniquely identifies the model, each class, and each option. For example,
CTO_474000 identifies the model, where CTO means configure-to-order, and 474000 identifies the model.
Each class and each option use CTO_474xxx to identify that they're part of CTO_474000. For example.
◦ The Screen class uses CTO_474100 to identify that its part of CTO_474000.
◦ The 14" option uses CTO_474101 to identify that its part of the CTO_474100.
• Determine the price you plan to charge for the model and each option.
Related Topics
• Item Classes
For now, you will do the minimum setup you need to get started when you create your own class.
1. In the Navigator, click Setup and Maintenance, click Tasks > Search, search for, then open Manage Item
Classes.
2. On the Manage Item Classes page, in the search results, click Actions > Create.
3. In the Create Item Class dialog, set values, then click Save and Add Details.
Attribute Value
4. On the Edit Item Class page, verify the options, then click Save and Close.
Attribute Value
Related Topics
• Item Classes
1557
Oracle SCM Cloud Chapter 9
Implementing Order Management Configure-to-Order
1558
Oracle SCM Cloud Chapter 9
Implementing Order Management Configure-to-Order
Attribute Value
Organization V1
Number of Items 9
This is a nifty feature you can use to add more than one item to the same class.
As an alternative, use the ATO Item template for configure options and the ATO Option Class
template for option classes. If you use them, verify each value that the template sets.
4. On the Create Multiple Items page, don't click Save. Instead, set values.
1559
Oracle SCM Cloud Chapter 9
Implementing Order Management Configure-to-Order
Attribute Value
1560
Oracle SCM Cloud Chapter 9
Implementing Order Management Configure-to-Order
◦ Click the row that contains CTO_474101 in the Name column, click Specifications > Sales and Order
Management, then set the value.
Attribute Value
1561
Oracle SCM Cloud Chapter 9
Implementing Order Management Configure-to-Order
Attribute Value
Specify whether your user can use a decimal quantity for the item. If Yes, then your
user can use only a whole number for the quantity, such as 1, 2, or 3, and can't use a
decimal, such as 1.4.
In this example, each item is indivisible. For example, you can't order a fraction of a
screen, memory, or hard drive.
◦ Click Associations, click Actions > Select and Add, search for an inventory organization, click Apply,
then click Done.
Attribute Value
Organization M1
You must specify an inventory organization. If you don't, you can't create a work
definition for your item.
You use the option class to group options but you don't actually ship the class. You do ship the option. So, you
set some values differently for the option class than you do for the option.
◦ Set values for the screen. Click the row that contains CTO_474100 in the Name column, click
Specifications, click Manufacturing under Item Organization, then set values.
Attribute Value
Pick Components No
Build in WIP No
1562
Oracle SCM Cloud Chapter 9
Implementing Order Management Configure-to-Order
The class is a phantom. You don't pick, assemble, or build it. You do pick, assemble, and build the option.
◦ Click Sales and Order Management, then set the value.
Attribute Value
Shippable No
Attribute Value
Name CTO_474100
Note: Product Information Management creates a new version of each item when you associate the
item with an inventory organization, then appends the name of the organization, such as M1, to the
name of the item. The search results display the V1 and M1 versions in separate rows, but doesn't
display V1 or M1. It displays only the name. Make sure you click the M1 version. Its usually the second
row.
1563
Oracle SCM Cloud Chapter 9
Implementing Order Management Configure-to-Order
◦ On the Edit Item page, click Structures, then click Actions > Create from Common.
Don't use Actions > Create. If you do, you will be creating a separate structure. Instead, click Create from
Common to use the structure you created for the V1 version.
◦ In the Create New Item Structure from Common dialog, set values, then click OK.
Attribute Value
Item CTO_474100
◦ On the Edit Item Structure page, click Actions > Select and Add.
1564
Oracle SCM Cloud Chapter 9
Implementing Order Management Configure-to-Order
Attribute Value
Item CTO_474101
◦ In the search results, click the row, then click Edit and Add.
◦ In the Edit Multiple Components dialog, set the values, then click OK.
Attribute Value
Note.
Minimum Quantity 1
Specify the minimum quantity the user can set for this option. A laptop computer must
have one and only one screen, so set the minimum quantity to 1 and the maximum
quantity to 1.
Maximum Quantity 1
Specify whether to create a separate flow for each instance of the item on the order
line. If the quantity of the component is greater than one, and if Instantiability is Yes,
then use a separate instance for each assemble-to-order flow.
For example, assume you add an order line for the CTO_474000 with a quantity of 12,
and Instantiability is.
• Enabled. Create 12 separate flows and set the quantity on each flow to 1. Enable
Instantiability when each item requires a slight variation that the flow must fulfill.
For example, the item is a personal computer that includes two hard drives, and
you must serialize each drive. For another example, the item is a cell phone and
you must provision a unique telephone number for each phone.
1565
Oracle SCM Cloud Chapter 9
Implementing Order Management Configure-to-Order
Attribute Value
• Not enabled. Create one flow and set the quantity on the flow to 12.
Attribute Value
Organization V1
Number of Items 1
Move ATO Model from the available list to the selected list.
Attribute Value
Name CTO_474000
1566
Oracle SCM Cloud Chapter 9
Implementing Order Management Configure-to-Order
Attribute Value
4. Click Specifications, then set values. Use these values for an assemble-to-order flow.
Attribute Value
Autocreated Configuration No
Pick Components No
If you were setting up a pick-to-order flow, you would use different values.
Attribute Value
Assemble to Order No
Build in WIP No
Attribute Value
1567
Oracle SCM Cloud Chapter 9
Implementing Order Management Configure-to-Order
Attribute Value
Customer Orders Enabled If you set these attributes to No, the flow will fail in Order Management.
This attribute allows Supply Orchestration to procure the item in a back-to-back flow, such as
buy or make.
◦ Set to No for pick-to-order. You can enable the configure options for back-to-back in a
pick-to-order flow, but not the model.
Shippable Yes
Note.
◦ Set to Yes for an assemble-to-order model. Order Management views the model as
the item. The configured item is an attribute on the model. So you must make the
model is shippable.
◦ Set to No for a pick-to-order model. Each item in the pick-to-order model is shippable,
but the pick-to-order model only represents the collection of items to ship. It isn't
shippable.
Note.
◦ Set to Yes for pick-to-order because Order Management only supports shipping all
pick-to-order items together from the same warehouse.
Invoiced Yes
If you set this attribute to No, then the flow won't send any details to Accounts Receivable.
Attribute Value
If you set it to MPS Planning or MRP Planning, then the model, option classes, options, and
components display in Planning Central.
For details, see the Item MRP and MPS Planning Specifications topic.
1568
Oracle SCM Cloud Chapter 9
Implementing Order Management Configure-to-Order
Attribute Value
Use this value if you intend to forecast the model. For details, see the Forecast an Assemble-
to-Order Item topic.
Attribute Value
Purchasable Yes
Set to Yes for the model, each option class, and each option.
Purchasing uses this value as the default purchase price in the purchase order. It applies only
when you create a blanket purchase agreement with your supplier. It has nothing to do with
set ups you make in the Pricing Administration work area.
Set a value for the model and each option, but not the option classes.
For details, see the Create Purchase Orders for Configured Items topic.
8. Add a structure.
Attribute Value
Name Primary
◦ Click Save.
◦ On the Edit Item page, on the Structures tab, in the Item Structures list, in the Name column, click
Primary.
◦ On the Edit Item Structure page, click Actions > Select and Add.
◦ In the Select and Add dialog, search for the value.
1569
Oracle SCM Cloud Chapter 9
Implementing Order Management Configure-to-Order
Attribute Value
Item CTO_474100
◦ Click the row that contains CTO_474100 in the search results, then click OK.
◦ On the Edit Item Structure page, click the row that contains CTO_474000 in the Item column.
2. Repeat step 2 to add the memory class, CTO_474200.
3. Repeat step 2 to add the hard drive class, CTO_474300.
4. Click Done, then click Save.
5. Add a picture of your model.
◦ On the Edit Item page, in the large empty area under the page name, under the text No items to display,
next to the text None, click the plus sign.
◦ In the Attachments dialog, click Browse to locate a file that contains an image of your model, click OK,
then click Save.
Attribute Value
Organization M1
◦ On the Manage Items page, open the CTO_474000 (M1) version of your model for editing.
You add the structure from the V1 version you created earlier. In this example, the V1 version is the master
organization. This way, you use a single structure for all classes and options in the configured item,
1570
Oracle SCM Cloud Chapter 9
Implementing Order Management Configure-to-Order
which helps manage and maintain the item. For example, if you update the structure in V1, then Product
Information Management updates the structures that reference V1.
Don't use Actions > Create. If you do, you will be creating a separate structure for the M1 version.
For details about master organizations, see the Item Organizations topic.
◦ In the Create New Item Structure from Common dialog, set values, then click OK.
Attribute Value
Item CTO_474000
Attribute Value
Attribute Value
Item CTO_474000
3. Wait for the search results to display, then verify that the catalog line displays the Configure and Add button.
1571
Oracle SCM Cloud Chapter 9
Implementing Order Management Configure-to-Order
Note.
• Verify that the hierarchy on the Configure page reflects the hierarchy you set up in Product Information
Management.
• Verify that you can choose one, and only one configure option in each class.
• Notice there's no pricing. You set it up in the Set Up Pricing for Configuration Models topic.
Related Topics
• Inventory Organizations
• Item MRP and MPS Planning Specifications
1572
Oracle SCM Cloud Chapter 9
Implementing Order Management Configure-to-Order
• Item Organizations
Note.
• You use the Edit Item Class page in the Setup and Maintenance work area to specify the number at design time.
• Order Management displays the number in the Configuration Item attribute on the sales order at run time.
1573
Oracle SCM Cloud Chapter 9
Implementing Order Management Configure-to-Order
Let's say you need to add a suffix to the item name for each unique configuration of item CTO_474000. You need to
start the suffix with the number 100, increment it by 1 each time a user orders the item, and use a hyphen (-) to separate
the suffix from the name. For example, here's the name that the flow creates the first time the user adds the item.
CTO_474000-100
where
Here's the name for the next time a user adds the item.
CTO_474000-101
The number is unique across order lines, sales orders, and users.
This topic assumes you already created the CTO_474000. For details, see the Create Configuration Model topic.
3. On the Edit Item page, note the value in the Item Class attribute.
Attribute Value
This means you, the administrator, defines numbering. Not the end-user who creates the
sales order.
1574
Oracle SCM Cloud Chapter 9
Implementing Order Management Configure-to-Order
Attribute Value
Attribute Value
Increment By 1
Delimiter Hyphen
Specify the character that separates the starting number from the prefix or the suffix.
1575
Oracle SCM Cloud Chapter 9
Implementing Order Management Configure-to-Order
• In the Item column of the Review Dispatch List in the Inventory Management work area.
You use the Pricing Administration work area to set up pricing for the configuration model that you create in the
Product Information Management work area.
For details about price lists, see the Manage Price Lists topic.
1576
Oracle SCM Cloud Chapter 9
Implementing Order Management Configure-to-Order
◦ On the Edit Price List page, in the Search Results area, click Actions > Add Row, then search for the item.
Attribute Value
Item CTO_474000
◦ Wait for the search results to display the description, then set Pricing UOM to Each.
◦ Click Create Charge, scroll down, set values, then click Save.
Attribute Value
Here's the pricing you set up when you visualized the hierarchy in the Set Up Configure-to-Order topic.
Use the same values for each attribute except for Base Price.
CTO_474201 8 GB Memory 5
CTO_474202 12 GB Memory 10
1577
Oracle SCM Cloud Chapter 9
Implementing Order Management Configure-to-Order
1578
Oracle SCM Cloud Chapter 9
Implementing Order Management Configure-to-Order
1. Use another browser to sign into Order Management, create a sales order, then search for CTO_474000 on the
catalog line.
Notice that your design time set up on the Edit Price List page in Pricing Administration displays on the order
line of the sales order in Order Management at run time.
2. Verify that the catalog line in Order Management displays the base price you set for the CTO_474000 in Pricing
Administration, which is $100.
3. Click Configure and Add, then verify that each item contains the pricing you set up in Pricing Administration.
1579
Oracle SCM Cloud Chapter 9
Implementing Order Management Configure-to-Order
Notice that your design time set up on the Edit Price List page in Pricing Administration displays on the
Configure page of the sales order in Order Management at run time.
For example, verify that the price for the 15.6" screen is $300.
4. Click Finish and Review, verify the summary displays the correct pricing for your choices and calculates the
correct total, then click OK.
5. Click Submit to send your sales order to order fulfillment.
Related Topics
• Manage Price Lists
1580
Oracle SCM Cloud Chapter 9
Implementing Order Management Configure-to-Order
Global Order Promising uses the category when it runs the available-to-promise rule for your model. The category helps
Promising to recognize the configured item.
• You must assign at least one catalog that the Catalog for Sourcing Assignments profile in Promising contains.
Supply Orchestration sends a request to Product Information Management to create the configured item, then
copies the catalog to the item when Product Information Management creates the item.
1581
Oracle SCM Cloud Chapter 9
Implementing Order Management Configure-to-Order
• In this example, Global Order Promising uses the predefined GOP_Category (Global Order Promising) to assign
the configured item to the rule.
• Make sure you assign each component in your model to an available-to-promise rule or associate it with a
catalog that you assign to an available-to-promise rule.
• If you don't set up the catalog and category correctly, the flow will usually create the configured item, but other
downstream processing might fail, such as scheduling. For details, see the Troubleshooting Configure-to-Order
topic.
• The Product Information Management work area might automatically add catalogs and categories to your
model depending on how you set up the work area. It might still be necessary to add a catalog to support your
configure-to-order flow.
For details, see the Relationship Between Categories and Catalogs topic.
Try it.
1. Identify the category you must use.
◦ In the Navigator, click Global Order Promising.
◦ Click Tasks > Manage Planning Profile Options.
◦ On the Manage Planning Profile Options page, search for the value.
Attribute Value
◦ In the search results, in the Profile Values area, note the value.
Attribute Value
This attribute identifies the catalog that Promising uses when assigning an assignment
set. You specify this value in the Catalog attribute on your model in Product
Information Management.
If you change the Profile Value, then you must specify your value on the model. For
example, if you set Profile Value to my_value, then you must set the Catalog attribute
on your model to my_value.
GOP_Catalog is an example. You can add a catalog in the Profile Values list and use it
instead of GOP_Catalog.
1582
Oracle SCM Cloud Chapter 9
Implementing Order Management Configure-to-Order
Attribute Value
Catalog GOP_Catalog
Category GOP_Category
3. Collect data and refresh the server. See the Collect Planning Data for Configured Items topic.
Here are the catalogs that the flow copies to the configured item.
◦ Inventory
◦ Purchasing
◦ Planning
◦ Cost
◦ Order Entry
◦ Product Line Accounting
◦ Asset Management
◦ Distributed Order Orchestration
◦ Order Capture
◦ Pricing
◦ Configurator
◦ Supply Chain Financial Flow Orchestration
Related Topics
• Relationship Between Categories and Catalogs
Do the work described in the Collect Planning Data for Order Management topic. Make sure you include entities when
you run the Collect Planning Data task.
1583
Oracle SCM Cloud Chapter 9
Implementing Order Management Configure-to-Order
Attribute Value
Item Structures
Work Definitions
Attribute Value
On Hand Promising uses this entity to get the inventory that's in stock for the model. If all components
in the configured item aren't in stock, then Promising won't find availability for the model.
For example, assume the schedule requires you to build the item within five days to meet the
delivery date. Promising examines the build schedule for each component, the current backlog
of purchase orders for component x, and determines component x isn't available for your order
until the sixth day.
Purchase Orders and Requisitions Add these entities so Global Order Promising can get availability across the entire supply chain.
Transfer Orders
Don't use templates that the dialog displays, such as Dynamic Data for Supply Planning. The templates don't apply for
configure-to-order.
Related Topics
• Overview of Collecting Promising Data for Order Management
1584
Oracle SCM Cloud Chapter 9
Implementing Order Management Configure-to-Order
This section describes how to set up rules for a configured item. For more details about rules, see the How Order
Promising Rules Work Together topic.
Assume you must create an available-to-promise rule for the CTO_474000 model. For details about this model, see the
Create Your Configuration Model topic.
Try it.
1. Go to the Global Order Promising work area, then click Tasks > Manage ATP Rules.
2. On the Manage ATP Rules page, click Actions > Create, then set values.
Attribute Value
◦ Supply Chain Availability Search. Consider supply for the configuration components
in your model when promising availability.
Choose this value for most configured items.
You must use this value for a back-to-back flow.
◦ Lead Time Based. Use this value when the supply chain for your item is reliable and
predictable.
◦ Infinite Availability Based. Use when your item is always available.
If you source the item through a back-to-back flow, then you must enable this option.
Enabling produces the planning recommendation that the flow needs to create the supply
order.
User Defined Fence in Days Specify the point in time when the flow can consider that the configured item is always
available.
To make sure processing for an advance order is timely, set your time fence to a lead time
that exceeds your typical lead time.
For this example, enable all attributes in the Supply Types area and Demand Types area. Global Order Promising
will consider each type you chose when it analyzes your supply chain.
1585
Oracle SCM Cloud Chapter 9
Implementing Order Management Configure-to-Order
Item CTO_474000
Item CTO_474101
Item CTO_474102
Item CTO_474201
Item CTO_474202
Item CTO_474301
Item CTO_474302
Item CTO_474100
Item CTO_474200
Item CTO_474300
Note.
◦ You must assign a rule to the model, each option class, and each configure option in your model at some
hierarchical level.
◦ You typically assign at the Item level.
◦ You typically use the same rule for model, classes, and options. You can use different rules, but using the
same rule simplifies set up, maintenance, and troubleshooting.
4. Click Actions > Add Row, then set values.
Category GOP_Category
1586
Oracle SCM Cloud Chapter 9
Implementing Order Management Configure-to-Order
Note.
◦ This step assigns your rule at the Category level so the same rule can recognize each instance of your
configured item that Product Information Management creates at run time, such as CTO_474000-100
and CTO_474000-101.
◦ Supply Orchestration associates the configured item that it creates at run time with the same category
you set for the configuration model in Product Information Management at design time. Downstream
processes also use the same catalog at run time.
Related Topics
• How Order Promising Rules Work Together
• Set Up Promising Rules and Sourcing Rules for Order Management
Try it.
1. Go to the Global Order Promising work area, then click Tasks > Manage Sourcing Rules.
2. On the Manage Sourcing Rules page, Click Actions > Create, then set values.
Attribute Value
Set to.
◦ Global when you must specify where to fulfill and ship the sales orders. You don't
specify an organization to create supply. Instead, you specify a transfer or buy source.
Use buy for a drop ship supplier.
◦ Local when you must specify how to create supply and the organization that creates it.
3. In the Sourcing Rule Effective Dates area, click Actions > Add Row, then set the start date.
4. In the Effective Start Date area, Click Actions > Add Row, then set values.
Attribute Value
Type Make At
1587
Oracle SCM Cloud Chapter 9
Implementing Order Management Configure-to-Order
Attribute Value
Set to Make At or Buy From for an assemble-to-order model, such as the Build My Laptop
model.
You typically make an assemble-to-order item instead of keeping it in inventory. So, you
usually don't use Transfer From for the model.
Use Transfer From for a made-to-stock item, such as a component. For example, you don't
stock the laptop, but you probably would stock screens for the laptop.
Global Order Promising enables Make At only when you set assignment type to Local.
Supplier If you create a global rule for a Buy From sourcing type, then you must specify values for
these attributes.
Supplier Site
If your supply chain includes more than one supplier, then create a separate sourcing rule for
each supplier. Add a separate row for each supplier.
Supplier Site Source System
If you add more than one row, then you can allocate demand across sources. For example,
if you add a row for Vision Manufacturing and set allocation to 70%, add another row for
Vision Distribution and set allocation to 30%, then Promising will use Vision Manufacturing
to promise 70% of the orders.
Rank 1
If you add more than one row, then you can specify the rank order to use for sources. For
example, if you add a row for Vision Manufacturing and set Rank to 1, add another row
for Vision Distribution and set Rank to 2, then Promising will use Vision Manufacturing to
promise the order first. If Promising determines that Vision Manufacturing can't fulfill the
order, then Promising will consider Vision Distribution.
Shipping Method Global Order Promising disables Shipping Method for a local rule. You can't edit it. Leave it
empty for a global rule.
If you set a value for a global rule, you might get an error.
Don't set shipping method in this context because it specifies where supply originates, not
how to ship it to the customer.
Exclude for Options and Option Exclude options and option classes when promising a sales order. Exclude them for a Make
Classes At or Buy From sourcing type.
1588
Oracle SCM Cloud Chapter 9
Implementing Order Management Configure-to-Order
Attribute Value
For example, exclude an item from planning when you know your source can't make it
because it includes toxic chemicals that the source isn't authorized to handle, or your
company limits production to only one specific site.
For another example, assume you know Seattle Manufacturing created a large oversupply
of the CTO_474100 screen option class from a prior marketing campaign. You already
know supply is available. To improve planning performance, you decide to exclude it from
planning.
Attribute Value
Catalog GOP_Catalog
Use the same catalog you use for your model in Product Information Management and
in your available-to-promise rule.
Attribute Value
Note.
◦ Promising fulfills your sales order only from the source that you assign to the
assignment set.
◦ Assign at least one sourcing rule at the global level so Global Order Promising can
use it to identify a ship-from location. If you don't, then your users must specify the
warehouse in every sales order.
◦ You must use the same ship-from and source in a configure-to-order make flow.
Item CTO_474000
Assign your model. In this example, CTO_474000 is the Build My Laptop model.
1589
Oracle SCM Cloud Chapter 9
Implementing Order Management Configure-to-Order
Attribute Value
1590
Oracle SCM Cloud Chapter 9
Implementing Order Management Configure-to-Order
For example, assume you create three different sourcing rules and assign them differently according to item,
organization, and customer.
1. Assign the CTO_474000 Build My Laptop item, which is the model, to Sourcing rule for Build My Laptop.
2. Assign the CTO_474000 to Sourcing rule for Build My Laptop only if the customer is Computer Service and
Rentals.
3. Assign the CTO_474300 Hard Drive, which is an option class, to the Hard Drives sourcing rule, which is a rule
you set up that's optimized to source hard drives.
4. Assign the CTO_474100 Screen, which is an option class, to the Monitor sourcing rule, which is a rule you set up
that's optimized to source monitors. Source the CTO_474100 only from D1 Denver Manufacturing when running
the sourcing rule.
If you add more than one assignment, then Global Order Promising considers the sourcing rule you set for the most
detailed assignment level first. Here's a list of assignment levels you can use, listed from least detailed to most detailed.
For example, Region is more detailed than Global. If you add a global assignment and a regional assignment, then
planning runs the regional assignment first, then the global assignment.
• Global
• Region
• Demand class
• Customer
• Customer and customer site
• Category
• Category and region
• Item
• Category and demand class
• Category and customer
• Category and customer site
• Item and region
• Item and demand class
• Item and customer
• Item and customer site
Trouble Shoot
I can't find an item when creating a The Work Definition work area only recognizes items that you associate with an inventory
work definition. organization. Make sure you add an inventory organization on the Associations tab in Product
Information Management for the model, each option class, and each configure option.
1591
Oracle SCM Cloud Chapter 9
Implementing Order Management Configure-to-Order
Trouble Shoot
◦ CTO_474300 is an
option class (hard drive)
• CTO_474301 is a
configure option
(1TB hard drive)
ITEM='CTO_474000'.'CTO_474300'.'CTO_474301'
I encounter an error when I use the Use the Associations tab in Product Information Management to add your inventory
Create Work Definition dialog. organization, open the new version that Product Information Management creates, then use
the Structures tab to add your structure to the new version.
An error occurs when I create an This error sometimes occurs if you navigate away from the rule editor and come back to it, or
applicability rule. add and remove rule text several times.
Attribute RuleText in RuleEO Click Cancel on the Edit Work Definition Details page, reopen the work definition, then add
is required. your rule.
1592
Oracle SCM Cloud Chapter 9
Implementing Order Management Configure-to-Order
Trouble Shoot
The Manage ATP Rules page doesn't Collect data and refresh the repository. See the Collect Planning Data for Configured Items
contain my item. topic.
I receive a warning when I use the In the Collect Planning Data dialog, change the Collection Type to Automatic Selection to let
Plan Inputs page to collect data. the server choose the data to collect. You can use Net Change the next time you collect data.
Global Order Promising keeps This problem typically occurs in a test environment where your flow isn't finished yet or
giving available-to-promise Promising isn't refreshed. Promising identifies on-hand quantities for the item and uses them
recommendations. to source supply until you exhaust the quantities.
I test my make or buy setup, but Examine and correct your inventory quantities, run collections, then run the Refresh and Start
Promising keeps giving available-to- the Order Promising Engine scheduled process.
promise recommendations.
I add an extensible flexfield to the Write a processing constraint on each extensible flexfield so the constraint prevents Order
parent of my configuration model. Management from updating the child flexfields during a revision.
I also add an extensible flexfield to
each child.
1593
Oracle SCM Cloud Chapter 9
Implementing Order Management Configure-to-Order
Trouble Shoot
Trouble Shoot
The Configuration page in the Order Make sure you set the Optional attribute to Yes for each class that contains an option, and for
Management work area doesn't each option. For the option, you must set this attribute on the child structure. You can't set it
display the configure options. from the parent structure.
The Order Management work area The Configurator Models work area doesn't come predefined to include transactional
doesn't display the transaction attributes. You must import the model so Order Management can populate them at run time.
attribute.
Try this.
1. Go to the Configurator Models work area, click Tasks > Manage Snapshots, click
Actions > Import Model Item, then import your model.
2. Take action depending on whether your model is new or revised.
◦ Revised.
• Update the item class.
• Add it and the model to an unreleased workspace.
• Release the workspace.
An exception occurs after i click For details on how to fix this problem, see the Manage Exceptions for Configured Items topic.
Submit.
1594
Oracle SCM Cloud Chapter 9
Implementing Order Management Configure-to-Order
Trouble Shoot
An assemble-to-order flow doesn't Different problems might cause this problem. They're similar to problems that occur in back-to-
create a supply order. back fulfillment with an item that isn't configured.
Do the fix, then release the planning recommendations to create the supply order.
The flow creates a purchase If a blanket purchase agreement exists with the supplier, and if the flow sends a purchase
requisition but doesn't create a requisition, then it normally creates the purchase order.
purchase order.
Try this.
1. Sign into the purchasing application and examine the state of the requisition. If an error
message indicates that pricing is missing, then a setup problem might exist in the item
definition.
2. Go to the Product Information Management work area, then click Tasks > Manage
Items.
3. Search for and open you item, then examine the item structure. Make sure the
Specifications area for each component includes a price.
4. In Purchasing, make sure an approver approved the blanket purchase agreement. If not,
correct errors and resubmit it.
• You must create a sourcing rule, assignment set, and available-to-promise rule for an
I set up a pick-to-order model that assemble-to-order model so the flow can do a supply chain search.
includes pick components and a child
• You don't need a sourcing rule for components that you keep on hand, but you must set
assemble-to-order component.
the ship date for the order schedule for them to Infinite.
• To schedule the work order on a specific ship date, you must maintain on-hand
I successfully assign a Make At or Buy inventory for the components or set up a sourcing rule.
From sourcing rule for each of my • If you get the components through your own purchase order process or manually, and
options. I set the lead time for each if Global Order Promising must schedule the order in a specific period that isn't infinite,
item in the model to 0 days or empty then you must create a separate sourcing rule for your components and use infinite
at the organization level. availability in your available-to-promise rule.
1595
Oracle SCM Cloud Chapter 9
Implementing Order Management Configure-to-Order
Trouble Shoot
Global Order Promising doesn't make Promising is only aware of on-hand quantities that you collect and refresh.
a recommendation.
To collect on-hand quantities from your warehouse, run the scheduled process Refresh and
Inventory contains the on-hand Start the Order Promising Engine.
quantities for the configured item,
but Global Order Promising doesn't
make an available-to-promise
recommendation.
I create a sales order that includes a You set the User Item Type when you create the configuration model in Product Information
configuration model, click Submit, Management. Its possible you chose a type that isn't enabled. For details, see the Create Your
then encounter an error. Configuration Model topic.
Exception Messages
Here's an example exception message.
The text Bad response: 503 Service Temporarily Unavailable indicates that the web service isn't available. Its possible
something is restarting, such as the server, a component or system that the service calls, or the service itself. Wait a few
minutes, then click Resubmit.
If the message describes a setup problem, then fix the setup, then Resubmit.
For details, see the Manage Exceptions for Configured Items topic.
1596
Oracle SCM Cloud Chapter 9
Implementing Order Management Configure-to-Order
Getting Help
It might be necessary to contact Oracle Support. If you do, here's an article on My Oracle Support that can help you
prepare.
• SRDC - Configure to Order : Data Collection for Configure to Order (Doc ID 2141338.1)
Related Topics
• Manage Exceptions for Configured Items
• Troubleshoot Order Management Cloud
Other Setups
Work Definitions
Guidelines for Creating Work Definitions for Configured Items
Assemble-to-order in a make flow creates the work order for the configured item dynamically at run time according to
the primary work definition that you set up at design time.
Here's what Oracle Manufacturing Cloud does.
1. Receives a request to create a work order for a configured item:
2. Uses the work definition that you set up to create a work order.
Note.
• Manufacturing uses the assemble-to-order (ATO) model as the ordered item when it creates the customer
order. The item includes configure options that your user sets at run time.
• You must set up a work definition for the assemble-to-order model.
• You must set the structure name of the model to Primary in Product Information Management. If the name isn't
Primary, then you can't create a work definition for the model.
• Manufacturing currently supports work definitions for an assemble-to-order model only for discrete
manufacturing.
Specify Operations
• You can assign the component of a model and a manufacturing resource to each operation.
• You can assign an option class, which will assign all of its components.
• You can apply an item to an operation only if the item is a component in the model.
1597
Oracle SCM Cloud Chapter 9
Implementing Order Management Configure-to-Order
To specify that the operation depends on the configure option, open your work definition for editing. On the Edit Work
Definition Details page, click your operation, click Actions > Edit, then, in the Edit Operation dialog, set the Option
Dependent attribute.
Value Description
Contains a check mark. The work order for the configured item includes the operation if.
• Your user chooses the configure option that the flow assigns to the operation.
or
• The flow meets the criteria you set up in the applicability rule for the operation.
Doesn't contain a check mark. The operation is required. The work order for the configured item always includes a required
operation.
You can assign each component to an operation from any level of the item structure.
• You can expand an option class to view the configure options that the class contains.
• You can expand a phantom to view the configure options that phantom contains.
• If you assign the parent, then you can't assign its children.
• If you already assigned the children, you can assign the parent, but the work definition will delete the child
assignments.
• You can choose to assign the option class or the options.
• For a phantom that isn't an assemble-to-order item, you can choose to assign the parent phantom or the
components.
• If you assign an option class to an operation that depends on an option, and if the user selects at least one
option in the class, then the work order for the configured item includes the operation that you specify in the
work definition.
• You can't expand a child assemble-to-order model.
• You must assign the entire quantity for the component to the operation.
◦ You can't update or split the quantity to more than one operation.
◦ You can't inverse the quantity, unit of measure, or yield.
◦ You can't assign an item that isn't part of the model structure.
1598
Oracle SCM Cloud Chapter 9
Implementing Order Management Configure-to-Order
Set Up Phantoms
A phantom is an item that you physically build but don't stock. If you specify an item as a phantom, and if your user
chooses the item, then manufacturing stores it as part of the structure.
• If you set the supply type for the component to Phantom in Product Information Management, then you can
expand the phantom and view its components in the work definition.
• You can keep expanding until you encounter a component that isn't a phantom.
• You can't expand a child model even if its supply type is Phantom.
• Manufacturing replaces each phantom with its physical counterpart at the next level of the hierarchy when
configure-to-order creates the work order.
For details, see the Overview of Phantom Explosion in Work Orders topic.
Transaction Attribute
1599
Oracle SCM Cloud Chapter 9
Implementing Order Management Configure-to-Order
internal name(translated value). The work definition uses the value of the internal name to evaluate the rule. It
doesn't use the translated value.
Operators
Keywords
where
Use double quotation marks to
enclose each transaction attribute • Finish is the name of the transaction attribute.
name and value. • Matte is the value of the transaction attribute.
Operators
• Equal to • Equal to
• Not equal to • Not equal to
• Less than • STARTSWITH
• Less than or equal to • ENDSWITH
• Greater Than • CONTAINS
• Greater than or equal to • DOESNOTCONTAIN
1600
Oracle SCM Cloud Chapter 9
Implementing Order Management Configure-to-Order
Verify Assignments
Make sure you assign each component in your work definition. If you don't, the flow will fail to create the work order for
the configured item.
Go to the Edit Work Definition Details page, then click Actions > Export Operation Item Assignments. The export
saves the entire model structure to Microsoft Excel.
Examine the status in Excel. If the status of your configuration model is.
• Complete. You assigned all the required operations.
• Incomplete. Identify which part of the hierarchy you must assign, then assign it.
Implicit You assigned the parent and the child inherited the parent assignment.
Modify Attributes
The work definition gets values for attributes from the model you create in the Product Information Management work
area.
• Basis
• Quantity
• Inverse Quantity
• UOM
• Item Yield
• Planning Percent
• Optional
• Supply Type
You can't modify any of these attributes in the work definition except for Supply Type.
Related Topics
• Create and Maintain Configurator Models
• Overview of Phantom Explosion in Work Orders
• How You Create an Assemble to Order (ATO) Model Work Definition
1601
Oracle SCM Cloud Chapter 9
Implementing Order Management Configure-to-Order
For example, specify assemble, test, and pack operations for the CTO_474000 model.
This example assumes you already set up the work centers and you create your own supply. You don't get supply from a
supplier.
Try it.
◦ On the Overview page, click Tasks > Manage Work Definition Names.
1602
Oracle SCM Cloud Chapter 9
Implementing Order Management Configure-to-Order
◦ On the Manage Work Definition Names page, click Add Row, set values, then click Save and Close.
Attribute Value
Type Standard
1603
Oracle SCM Cloud Chapter 9
Implementing Order Management Configure-to-Order
Attribute Value
Item CTO_474000
Production Priority 1
Attribute Value
Sequence 10
Name Assemble
Attribute Value
Sequence 20
Name Test
◦ Click Add Row, set values, then click Save and Edit.
1604
Oracle SCM Cloud Chapter 9
Implementing Order Management Configure-to-Order
Attribute Value
Sequence 30
Name Pack
Use this attribute to specify that the last step in the sequence is done.
You must specify Count Point on the last step. You can also specify it on other steps to
indicate activities that must finish for them.
1605
Oracle SCM Cloud Chapter 9
Implementing Order Management Configure-to-Order
Try it.
1. On the Edit Work Definition Details page, in the area that displays the item structure, click Resources.
2. Add resources to your first operation.
Each work center has resources that do the operation. Your work center might use resources that are
different than this example uses. For details about how to create a work center and it's resources, see the
How You Manage Work Centers topic.
1606
Oracle SCM Cloud Chapter 9
Implementing Order Management Configure-to-Order
◦ In the Assign Operation Resource dialog, set values, then click OK.
Attribute Value
Units Assigned 1
Basis Variable
This attribute determines whether you need more resources as the quantity increases
when you assemble the item. You typically need more resources to assemble a laptop
as quantity increases, so set it to Variable.
Usage 1
Inverse Usage 1
Scheduled No
Specify priority when you use the same sequence number for more than one resource.
In general, don't use the same sequence number for more than one resource. Instead,
sequence them consecutively so it isn't necessary to specify a principal.
Activity Setup
For details about these attributes, see the Edit Operation Resources section in the How You Edit Work
Definitions topic.
◦ Click the Final Assembly Labor resource, drag it and drop it onto the Assemble operation, set values in
the dialog, then click OK.
3. Repeat step 2 for the Test operation.
4. Repeat step 2 for the Pack operation.
Your set up should like something like this.
1607
Oracle SCM Cloud Chapter 9
Implementing Order Management Configure-to-Order
1608
Oracle SCM Cloud Chapter 9
Implementing Order Management Configure-to-Order
Assume you must do a performance test that depends on a configure option your user sets in Order Management. You
can create two different operations.
• Do the 1 Terabyte Hard Drive Test operation only if the user chooses the 1 terabyte hard drive.
• Do the 2 Terabyte Hard Drive Test operation only if the user chooses the 2 terabyte hard drive.
Try it.
1. In the Navigator, click Work Definition.
2. Create a work definition for the CTO_474000 item.
1609
Oracle SCM Cloud Chapter 9
Implementing Order Management Configure-to-Order
Attribute Value
◦ On the Edit Work Definition Details page, click the Test 1 TB Hard Drive operation, then click Actions >
Edit.
◦ In the Edit Operation dialog, add a check mark to Option Dependent.
◦ Next to Applicability Rule, click Add.
◦ In the Applicability Rule dialog, in the Item Structure area, click the CTO_474300 Hard Drive component.
◦ Drag and drop the CTO_474301 1 TB Hard Drive option onto the Rule Text area.
ITEM='CTO_474000'.'CTO_474300'.'CTO_474301'
CTO_474000 is the model, CTO_474300 is the option class for the hard drive, and CTO_474301 is the 1 TB
hard drive.
ITEM='model'.'option class'.'option'
Related Topics
• How You Edit Work Definitions
• Overview of Work Definitions
• How You Manage Work Centers
1610
Oracle SCM Cloud Chapter 9
Implementing Order Management Configure-to-Order
Forecast
Forecast an Assemble-to-Order Item
Set up a forecast according to your organization for an assemble-to-order item.
• Use the Planning Central work area to set up the forecast.
• Create a statistical forecast for an assemble-to-order item. Use shipment history and booking history to do the
forecast.
• Consume the forecast for your model. Each sales order that contains your configured item consumes the
forecast.
• Explode the forecast that remains after the model is done consuming. Generate a production forecast for your
option classes and options.
Planning Central displays the forecast for the options, option classes, and child models as a production forecast.
It indicates the forecast that remains after planning consumes the forecast for the model that your sales orders
needs to fulfill the configured item.
Planning uses the planning percent you set on the class and option to forecast demand. You specify the percent
when you set up the structure for the item in the Product Information Management work area.
• Create supply for your forecast according to organization. Set up a planning sourcing rule that sources
components and subassemblies.
• Planning uses the fixed and variable lead times you set up on the model to offset the production forecast it
creates for the options.
1611
Oracle SCM Cloud Chapter 9
Implementing Order Management Configure-to-Order
Here's an example.
Assume you need organization M1 to manufacture an assemble-to-order model that includes a hierarchy.
• Built-in Option
1612
Oracle SCM Cloud Chapter 9
Implementing Order Management Configure-to-Order
• External Option
The configured item in the sales order consumes part of the forecast. Planning explodes what's left over according to
your set up. Assume 1,000 units are available to explode after the sales order consumes the configured item.
Object Math
Camera Class The model consumes one unit of the camera class for each laptop. You expect 100% of your
customers will want a camera. So planning calculates the production forecast at 1,000.
Dual Camera Option The dual camera option needs two cameras for each laptop, so the model consumes two units.
1613
Oracle SCM Cloud Chapter 9
Implementing Order Management Configure-to-Order
Object Math
You expect 60% of your customers will choose this option. Planning calculates the forecast at
1,200.
Single Camera Option The single camera option needs only one camera for each laptop, so the model consumes one
unit.
You expect 40% of your customers will choose this option. Planning calculates the forecast at
400.
Speaker Class The model consumes one unit of the speaker class for each laptop. Assume the speaker class
allows your user to choose high-fidelity speakers, either built-in or external. You expect 80% of
your customers will want high-fidelity speakers. Planning calculates the forecast at 800.
80% multiplied by 1,000 units that are available to explode equals 800.
Built-in Option You need only one set of built-in speakers for each laptop, so the model consumes 1 unit of the
built-in option.
You expect 70% of your customers will choose this option. Planning calculates the forecast at
560.
External Option You need only one set of external speakers for each laptop, so the model consumes 1 unit of
the external option.
You expect 30% of your customers will choose this option, but you set the Production Forecast
to None for this option. So planning doesn't calculate a forecast.
Assume you set the fixed lead time for the model to 5 days and the variable lead time to 0. Here's how planning
explodes the forecast that's due on day 15.
1614
Oracle SCM Cloud Chapter 9
Implementing Order Management Configure-to-Order
For background details, see the Forecasting for CTO Products topic.
Related Topics
• Forecasting for CTO Products
1615
Oracle SCM Cloud Chapter 9
Implementing Order Management Configure-to-Order
Note.
• The sum of the values you set for configure options in a single class must equal 100%.
• The Planning Central work area uses the value you set when it forecasts demand.
You will modify the CTO_474000 model. For details about how to set it up, see the Set Up Configure-to-Order topic.
Try it.
◦ In the Product Information Management work area, click Tasks > Manage Items.
◦ On the Manage Items page, search for the CTO_474000 (M1) configuration model, and open it for
editing.
◦ On the Edit Item page, click Structures, then click Primary.
◦ On the Edit Item Structure page, click View, then make sure Component Details contains a check mark.
◦ Expand the Build My Laptop model, then click the CTO_474100 screen option.
◦ On the Edit Item CTO_474100 page, click Structures.
◦ In the Name column, click Primary.
2. Set the value for the 14" screen.
◦ On the Edit Item Structure CTO_474100 - Primary page, expand the CTO_474100 screen model, click the
row that contains 14 Inch Laptop Screen in the description column, then click Actions > Edit.
◦ In the Edit Components Dialog, set the value, then click OK.
Attribute Value
Planning Percent 70
3. Repeat step 2 but set the value for the 15.6" screen.
Attribute Value
Planning Percent 30
4. Click Done.
5. On the Edit Item CTO_474100 page, click Save and Close.
6. On the Edit Item Structure: CTO_474000 - Primary page, expand the screen option, then verify your values.
1616
Oracle SCM Cloud Chapter 9
Implementing Order Management Configure-to-Order
Related Topics
• Forecasting for CTO Products
You use an item class to organize your transaction attributes. For example, create an item class named Auto Repair
Services, then add transaction attribute Transmission Service to it. Add other relevant transaction attributes to the
same class. For example, add transaction attribute Transmission Serial Number to capture the serial number of the
transmission you repair.
Note.
For details about how to add an attribute that allows your user to add details to a sales order while the user creates the
sales order, see the Overview of Using Extensible Flexfields in Order Management topic.
1617
Oracle SCM Cloud Chapter 9
Implementing Order Management Configure-to-Order
If you use Order Management Cloud, then you must add a check mark to each of these application scopes. They enable
downstream work areas and applications to use your transaction item as part of a configure-to-order flow.
Scope Description
Configuration Matching Enable Supply Orchestration to examine the match repository to see if there's a match.
1618
Oracle SCM Cloud Chapter 9
Implementing Order Management Configure-to-Order
Scope Description
If your flow uses the transaction attribute to create a unique configured item, then you must
add a check mark to Configuration Matching. If you do, Supply Orchestration will examine the
match repository. If it doesn't find a match, it will create a new configuration for each unique
attribute value, then save the configuration.
Pricing Use the values you set in the Pricing Administration work area to price the item.
Order Capture Capture the sales order that your user creates in the Order Management work area or that you
import.
Distributed Order Orchestration Use the orchestration part of Order Management Cloud, particularly the orchestration process.
Manufacturing Execution Enable manufacturing to add your configured item to the work order.
Your user must also select an option that your model uses as a transaction attribute when the user configures the
assemble-to-order item on the sales order in Order Management.
1619
Oracle SCM Cloud Chapter 9
Implementing Order Management Configure-to-Order
Attribute Value
Attribute Value
Module Orchestration
4. In the Lookup Codes area, use Actions > New three times to add three codes. Make sure Enabled contains a
check mark for each code.
MAGENTA 1 Magenta
BLACK 2 Black
BLUE 3 Blue
Attribute Value
1620
Oracle SCM Cloud Chapter 9
Implementing Order Management Configure-to-Order
Attribute Value
3. Set values.
Attribute Value
Setup varies for different types of value sets. For details, see the Value Sets topic.
For this example, assume you set up your item in a class named ATO Models.
4. On the Edit Item Class page, click Transactional Attributes.
5. Click Actions > Create.
6. In the Create Transactional Attribute dialog, set values.
1621
Oracle SCM Cloud Chapter 9
Implementing Order Management Configure-to-Order
Attribute Value
Application Scope For this example, add a check mark to each choice.
◦ Configurator
◦ Order Capture
◦ Pricing
◦ Configuration Matching
Note.
◦ Lid Color is the value set you created earlier in this topic.
◦ The value set is optional, but recommended. It constrains the values that the
transaction attribute can contain. For example, constrain values that your customer
can set or enter for the attribute at run time according to data type or length, or
provide a pick list that your customer uses to set the value.
◦ Make sure the values are valid with the model you set up for the item in the
Configurator work area. For example, if you use the attribute to allow the user to
choose black or purple for the lid, then make sure values in the value set also include
Black and Purple.
1622
Oracle SCM Cloud Chapter 9
Implementing Order Management Configure-to-Order
Attribute Value
You used the M1 organization when you set up the CTO_474000 in Product Information
Management, so, for this example, you create a workspace for M1.
◦ On the Manage Workspaces page, search for your new work space, then click it in the search results.
3. Add your model to the workspace.
◦ On the Workspace page, in the Workspace Participants area, click Actions > Select and Add > Models.
◦ In the Select and Add dialog search for CTO_474000, click it in the search result, add a check mark to
Include Updated Item Snapshots For Models, then click Apply > OK.
You add the configuration model. You don't add an option class, configure option, component, or child
model.
4. Click Release.
If you update a model that you already added to a workspace, then do this instead of the steps above.
If you add a transaction attribute to a model that you already added to a workspace, then you must import
the model into the configurator and release the workspace. The import makes the attribute visible in Order
Management so the user can select it at run time.
If some time later you change the attribute, then you must create a new workspace, add your model, add an
updated snapshot for the item class, then release the new workspace.
For details, see the Importing Items topic and Releasing Workspaces topic.
1623
Oracle SCM Cloud Chapter 9
Implementing Order Management Configure-to-Order
The buy flow works the same as the make flow except.
1624
Oracle SCM Cloud Chapter 9
Implementing Order Management Configure-to-Order
• Your supplier uses a purchase order to supply the item instead of creating the work order in Inventory
Management and making the item.
• During the buy flow, if a blanket purchase agreement.
◦ Exists. Supply Orchestration automatically converts the purchase requisition (PR) to a purchase order
(PO).
◦ Doesn't exist. You must manually do the conversion. For example, you must find the purchase request,
then create a document to generate the purchase order. For details, see the Use the Purchase Orders
Work Area topic.
Configure-to-order uses the Configure-to-Order Blanket Purchase Agreement template to create a relationship between
a component and the parent. Use the template to set up pricing for the model instead of for each component.
For details about the make flow, see the How Configure-to-Order Works topic.
1625
Oracle SCM Cloud Chapter 9
Implementing Order Management Configure-to-Order
• Computer World is your supply. They will supply configuration model CTO_474000 and its configure options.
• You negotiated pricing with your supplier that's 50% of the base price. The base price is the price you charge
your customers.
1626
Oracle SCM Cloud Chapter 9
Implementing Order Management Configure-to-Order
CTO_474202 12 GB Memory 10 5
For details about setting up base price, see the Set Up Pricing for Configuration Models topic.
Note.
◦ You must enable the Configuration Ordering Enabled option on the style you use.
◦ You can't combine an assemble-to-order item and an item that isn't configured on the same blanket
purchase agreement. Instead, create two agreements that cover all the components of a pick-to-
order model. Use the configure-to-order template for your assemble-to-order model. Create another
agreement for your item that isn't configured.
◦ The agreement stores price for the assemble-to-order model and uses configure options to procure
the configured item. The agreement contains only the models and options, so the flow calculates the
purchase price of the configured item each time it procures the item outside of Oracle Fusion.
◦ You must add each configure option to the agreement.
◦ Don't add option classes to the agreement. The configure options in each class contain pricing, not the
class.
◦ Don't add required items to the agreement. Each required item comes priced as part of the model.
◦ If necessary, use the Revision attribute on each line to specify the revision of each item.
1627
Oracle SCM Cloud Chapter 9
Implementing Order Management Configure-to-Order
For details about how to set up the CTO_474000, see the Create Your Configuration Model topic.
3. On the Edit Item page, click Specifications.
4. In the Item Organization area, click Purchasing, then set the value.
Attribute Value
5. Click Categories, then verify that the Catalog column contains a row for the Purchasing catalog. If it doesn't,
then click Actions > Add Row, and add it.
Attribute Value
Catalog Purchasing
Category Miscellaneous_1
6. Click Save.
7. Repeat this procedure for each of your option classes and configure options.
If you don't sign in with these privileges, then the work areas you use in this procedure don't display.
2. Set up your document style.
Use the document style to control the look and feel of the application so it matches the usage of the purchasing
document.
You can typically use the predefined Configure to Order Blanket Purchase Agreement style. Do this step only if
you can't find a predefined style that meets your needs.
• Offering: Procurement
• Functional Area: Procurement Foundation
• Task: Manage Document Styles
◦ On the Manage Document Styles page, click Actions > Create.
◦ On the Create Document Style page, set values, then click Save and Close.
1628
Oracle SCM Cloud Chapter 9
Implementing Order Management Configure-to-Order
Attribute Value
Instructs the Purchase Agreements work area to display the Parent Item attribute and
Top Model attribute.
Display Name in the Blanket Blanket Purchase Agreement for Configure-to-Order Item
Purchase Agreement area
Attribute Value
Supplier Site Choose the address where your supplier ships the item from.
◦ In the Lines area, click Actions > Add Row, set values, then click Save.
Attribute Value
Line 1
Type Goods
1629
Oracle SCM Cloud Chapter 9
Implementing Order Management Configure-to-Order
Attribute Value
Item CTO_474000
Specify the number or code you use to identify the parent of the item you're adding on
this line.
If you add a configure option, then specify the option class that contains the option.
You are adding the model, which doesn't have a parent, so leave it empty.
Specify the number or code that you use to identify the configuration model. You are
adding the model, so leave it empty.
Price 50
Note.
• Enter the purchase price for the item you're adding on the line. It's the price you
negotiated with Computer World, your supplier.
• You can enter zero or a negative value to reflect a discount for an agreement that
you use to price and source a configured item.
• If you provide a price for a configure option, then the flow applies the price only
if your customer chooses the option when ordering the configured item.
1630
Oracle SCM Cloud Chapter 9
Implementing Order Management Configure-to-Order
1631
Oracle SCM Cloud Chapter 9
Implementing Order Management Configure-to-Order
6. At the top of the page, click View PDF, then open it.
1632
Oracle SCM Cloud Chapter 9
Implementing Order Management Configure-to-Order
7. Examine the output. Make sure it contains your model, options, and pricing. The buy flow sends this document
to your supplier at run time.
For brevity, this screen print includes only the model and one option. The actual document includes a cover
letter and another page that has the rest of the options.
8. Click Save, then sign out.
Don't click Submit. Submit sends the agreement to approval. If you clicked Submit, then query the document on
the Manage Agreements page and cancel it.
1633
Oracle SCM Cloud Chapter 9
Implementing Order Management Configure-to-Order
Attribute Value
1634
Oracle SCM Cloud Chapter 9
Implementing Order Management Configure-to-Order
You use the Product Information Management work area to set up a configured item. You can't use it to view how
the user sets configuration options because the work area doesn't store the bill of materials for the configured item.
Fulfillment uses values that the user sets at run time to create the bill of materials. You can use the View Configured
Item Structure page to examine the configured item the user set up without accessing the sales order.
Use the Item attribute in the Search area to search for the configured item, then use the Item Structure Details area to
drill down to the configured item and configure options.
• For details, see the Overview of Using Web Services with Configure-to-Order topic.
• You must make sure the required components and configure options for each configured item are the same
across organizations.
1635
Oracle SCM Cloud Chapter 9
Implementing Order Management Configure-to-Order
The flow also supports an advanced shipment notice (ASN) that it receives from your supplier or during an internal
material transfer from a shipping organization.
1636
Oracle SCM Cloud Chapter 9
Implementing Order Management Configure-to-Order
Assume.
• You finished the setup described in the Create Your Configuration Model topic.
• Manufacturing finished the work order. Inventory contains the configured item and Shipping contains shipment
lines for the configured item.
• You set up the pick release process for the organization so it automatically pick confirms and creates the
shipment.
Next, put on your Shipping Manager hat (pretend you're the Shipping Manager). You receive an urgent request to fulfill
a configured item, so you manually pick release and ship confirm it.
You will navigate to the Shipments work area and use it to search for shipments and shipment lines. You can also click
graphs that display the outstanding and completed work for the current day. This is where you determine the work
activities to do and drill into an activity.
1637
Oracle SCM Cloud Chapter 9
Implementing Order Management Configure-to-Order
Attribute Value
1638
Oracle SCM Cloud Chapter 9
Implementing Order Management Configure-to-Order
1639
Oracle SCM Cloud Chapter 9
Implementing Order Management Configure-to-Order
Note.
• It isn't necessary to do any more set up to get and display the invoice.
• A web service in Supply Orchestration gets details for this sales view when you ship confirm the sales order.
• You can view the model and options for the configured item on the commercial invoice and the packing slip.
• The invoice displays the quantity for each component in the configured item assuming that the configured item
quantity is one.
• You don't have to do any special document setup for configured items.
1640
Oracle SCM Cloud Chapter 9
Implementing Order Management Configure-to-Order
1641
Oracle SCM Cloud Chapter 9
Implementing Order Management Configure-to-Order
A bill-of-material (BOM) is a structure you use to store lists of items that you associate with a parent item. The structure
stores details that describe how to relate each item to the parent. You arrange child items in the structure hierarchically
so they reflect the composition of the parent item. For example, a laptop computer is the parent, and the hard drive,
screen, and memory are each a child item.
A structure explosion is the act of breaking apart each assembly or subassembly into its component parts. You explode
to improve order fulfillment efficiency.
Example
Assume you have a bill-of-materials for parent item CTO_474000, Build My Laptop.
CTO_474201 8 GB Memory
CTO_474202 12 GB Memory
CTO_474100 Screen
CTO_474200 Memory
1642
Oracle SCM Cloud Chapter 9
Implementing Order Management Configure-to-Order
You need to explode this bill of materials so you can pick each item separately, then assemble them into the parent
CTO_474000. You pick items separately so you can more quickly fulfill them item.
For another example, assume you need to pick a newer part for an item from inventory instead of an older part. For
example, you sell laptop computers to college students. You manufacture a mouse pad every week, and the pad is an
included part in a kit. As part of a promotion, you stamp the name and logo of a popular music group on the pad. You
stamp the pad each week with the group that's currently #1 on the Worldwide Music Singles Chart. The chart changes
every week, but some groups return to the #1 spot several times in subsequent weeks with the same song or a different
song, so you keep older pads in stock in case they return to the #1 spot. You use the Configuration Models work area to
change the mouse pad, item CTO_474400, in parent model CTO_474000, Build My Laptop.
Use order management parameter Configuration Effective Date for Exploding Included Items to control which model to
explode.
Note.
• The Product Information Management work area stores a different version each time you revise the model. The
sales order uses the Configuration Effective Date parameter to determine which model to use.
• Fulfillment skips closed or canceled lines. Instead, it copies child items from the original model.
• This parameter doesn't affect the current explosion behavior when the user creates the sales order.
• Use this parameter only for a bill-of-material explosion.
• Don't change the validation behavior for configured items.
• You also use the Configuration Effective Date parameter to control behavior.
• For details about the attributes in an explosion, see the Item Structure Explosion section in Oracle Supply
Chain Management Cloud SOAP Web Services for SCM On Oracle Help Center at https://docs.oracle.com/en/
cloud/saas/supply-chain-management/19c/oessc/business-object-services.html#itemstructureexplosion-
d24777e193193.
Split Lines
1643
Oracle SCM Cloud Chapter 9
Implementing Order Management Configure-to-Order
You can split a fulfillment line so you can use a new item. You can specify whether to use the date when fulfillment
creates the configuration for the bill-of-material structure, or the date when it creates the parent.
When you submit a revision or pick-to-order model you don't want to explode the existing kit and add new included
items to it. Instead, you only want to explode the new kit.
You can use only one open item when you split the quantity where you reduce the quantity and add a new line for the
split quantity. Assume the original quantity on line 1 is 10. You split line 1 into line 1 and line 2. You reduce the quantity on
line 1 to 7 and set the quantity on line 2 to 3.
If you set the Configuration Effective Date order management parameter to Ordered Date, then fulfillment uses the
same included item.
Assume you change the bill of materials for the kit and need to explode on the date when you make the change. If you
set Configuration Effective Date for Exploding Included Items to Parent Creation Date, then fulfillment explodes the new
line according to the date you make change instead of the date that Configuration Effective Date specifies.
Kit Example
Assume you create sales order 58697 on June 12 that includes the Movie Basket kit. The kit includes one fulfillment line,
and the line includes two items, Popcorn and Ice Cream.
Line Number Item Item Type Ordered Ordered Date Creation Date Configuration
Quantity of Fulfillment Effective Date
Line
Assume you use the Configuration Models work area on June 15 to change the model for the kit. You replace Ice Cream
with Big Drink.
On June 20, you revise order 58697. You add a new fulfillment line that includes another Movie Basket kit.
Next, assume you set the Configuration Effective Date parameter to Ordered Date.
Line Number Item Item Type Ordered Ordered Date Creation Date Configuration
Quantity of Fulfillment Effective Date
Line
1644
Oracle SCM Cloud Chapter 9
Implementing Order Management Configure-to-Order
Line Number Item Item Type Ordered Ordered Date Creation Date Configuration
Quantity of Fulfillment Effective Date
Line
The sales order uses the Configuration Effective Date of June 12 for fulfillment line 1 and fulfillment line 2. The Ordered
Date is June 12, so the order doesn't use the new configuration you revised in the model. It continues to use Ice Cream
instead of Big Drink.
Assume you set parameter Configuration Effective Date for Exploding Included Items to Parent Creation Date.
Line Number Item Item Type Ordered Ordered Date Creation Date Configuration
Quantity of Fulfillment Effective Date
Line
The sales order uses a Configuration Effective Date of June 12 for fulfillment line 1. The Movie Basket in fulfillment line 2
is the parent, you created it on June 20, so the sales order uses a Configuration Effective Date of June 20 for fulfillment
line 2. You replaced Ice Cream with Big Drink in the configuration model on June 15, so the sales order includes Big Drink
instead of Ice Cream on line 2.
1645
Oracle SCM Cloud Chapter 9
Implementing Order Management Configure-to-Order
Pick-to-Order Example
Assume you create sales order 53867 on June 12 that includes the My Phone pick-to-order model, and it includes one
fulfillment line.
Line Number Item Item Type Ordered Ordered Date Creation Date Configuration
Quantity of Fulfillment Effective Date
Line
Assume you use the Configuration Models work area on June 15 to change the model. You replace Charger with
Wireless Charger.
On June 20, you revise order 53867. You add a new fulfillment line that includes another My Phone model.
Assume you set the Configuration Effective Date parameter to Current Date.
Line Number Item Item Type Ordered Ordered Date Creation Date Configuration
Quantity of Fulfillment Effective Date
Line
The Current Date is the date that when you click Revise or Submit.
1646
Oracle SCM Cloud Chapter 9
Implementing Order Management Configure-to-Order
The sales order uses the Current Date of June 20 for the Configuration Effective Date for line 1 and line 2. So, the sales
order uses the new configuration you revised in the model on June 15. It uses Wireless Charger instead of Charger on
both lines.
Line Number Item Item Type Ordered Ordered Date Creation Date Configuration
Quantity of Fulfillment Effective Date
Line
The sales order uses the Parent Creation Date. The My Phone is the parent for line 1. You created line 1 on June 12, so the
sales order uses the model that existed on June 12 for line 1. That model uses Charger, not Wireless Charger.
The My Phone is the parent for line 2. You created line 2 on June 20, so the sales order uses the model that exists on
June 20 for line 2. That model uses Wireless Charger, not Charger.
Split Example
Assume you set the Configuration Effective Date parameter to Current Date.
1647
Oracle SCM Cloud Chapter 9
Implementing Order Management Configure-to-Order
Line Number Item Item Type Ordered Ordered Date Creation Date Configuration
Quantity of Fulfillment Effective Date
Line
Assume.
• You add line 1 on June 8. It includes the DVD item, which is a standard item.
• You use the Configuration Models work area on June 10 to change the model. You replace Ice Cream with
Chocolates.
• You add line 2 on June 12. It includes the Movie Basket item, which is a kit that includes two items. The sales
order uses the model that exists as of the Current Date, which is June 12. The current date is the date you revise
or submit the sales order. You updated the model on June 10, so the order includes Chocolates.
Assume you use the Configuration Models work area on June 15 to change the model. You replace Chocolates with Big
Drink.
On June 20, you revise the sales order. You split line 2 into two lines, lines 2.1 and 2.2.
1648
Oracle SCM Cloud Chapter 9
Implementing Order Management Configure-to-Order
The order uses the Configuration Effective Date parameter to determine which model to use. In this example, you set
Configuration Effective Date to Current Date. The current date is the date that you revise or submit the order, which
is June 20, so the order uses the model that exists as of June 20 to identify the items it must include. On June 15, you
updated the model to use Big Drink instead of Chocolates, so the order includes Big Drink on lines 2.1 and 2.2.
Assume you use the Configuration Models work area on June 24 to change the model. You replace Big Drink with Little
Drink.
On June 25, you revise the sales order again. You split line 2.1 into two lines, lines 2.2 and 2.3.
1649
Oracle SCM Cloud Chapter 9
Implementing Order Management Configure-to-Order
The order uses the Configuration Effective Date parameter to determine which model to use. In this example, you set
Configuration Effective Date to Current Date. The current date is the date that you revise or submit the order, which
is June 20, so the order uses the model that exists as of June 20 to identify the items it must include. On June 15, you
updated the model to use Big Drink instead of Chocolates, so the order includes Big Drink on lines 2.1 and 2.2.
Assume you.
• Set the Configuration Effective Date to Current Date.
• Set the Configuration Effective Date for Exploding Included Items to Parent Creation Date.
• Use the Configuration Models work area on June 10 to change the model. You replace Ice Cream with
Chocolates.
Here's what happens to sales order 79639 when you split line 2.
1650
Oracle SCM Cloud Chapter 9
Implementing Order Management Configure-to-Order
You set Configuration Effective Date to Current Date. The current date is June 20. It's the date you revise or submit
the order. So the order uses the model that exists as of June 20 to identify the items it must include. On June 10, you
updated the model to use Chocolates instead of Ice Cream, so the order includes Chocolates on lines 2.1 and 2.2.
Assume you use the Configuration Models work area on June 24 to change the model. You replace Ice Cream with
Chocolates.
On June 25, you revise the sales order again. You split line 2.1 into two lines, lines 2.2 and 2.2.
Here's what happens to sales order 79639 when you split line 2.
1651
Oracle SCM Cloud Chapter 9
Implementing Order Management Configure-to-Order
You set Configuration Effective Date to Current Date. The current date is June 25, so the order uses the model that exists
as of June 25 to identify the items it must include. On June 24, you updated the model to use Chocolates instead of Ice
Cream, so the order includes Chocolates on lines 2.1, 2.2, and 2.3.
Related Topics
• Manage Order Management Parameters
Web Services
Overview of Using Web Services with Configure-to-Order
Use web service ConfiguredItemService to create, read, update, or delete a configured item.
Get and view the options your user selects for the model and the configured item structure, including the model
reference and description, selected options and description, and transaction attributes that the selected options
reference.
1652
Oracle SCM Cloud Chapter 9
Implementing Order Management Configure-to-Order
Example
Here's an example of an assemble-to-order model for the VIK12 Viking Stove. For an introduction to this model, see the
Examples of Using Configure-to-Order topic.
1653
Oracle SCM Cloud Chapter 9
Implementing Order Management Configure-to-Order
• FINOC, an option class for the finish. It contains options your user can choose to specify the type of finish, such
as stainless steel.
• CLK, a phantom for the clock assembly. It includes options your user can choose to specify the display and type
of control. A phantom is an item that you physically build but don't stock. In this example, you assemble the
clock on demand. You don't build it in anticipation of demand and stock it.
• Option class OVTY specifies the oven type. It contains options Gas, Gas Convection, and Electric. Gas
Convection and Electric aren't configure options.
• Option class WRM specifies options for the warming oven.
1654
Oracle SCM Cloud Chapter 9
Implementing Order Management Configure-to-Order
Note.
• BRN1 is a complex child model that includes its own assemble-to-order model.
• FTOC is an option class your user uses to choose the fuel type, such as electric, propane, or gas.
• BSOC is an assemble-to-order model that specifies the style as residential or commercial.
• BSOC is a child of BRN1 and a grandchild of VIK12.
• RES and COM each contain options and phantoms.
• RES contains BRSS and GRD, which are items you stock. It also contains BRLG, a phantom you don't stock. You
don't stock BRLG and COMLG because your market research indicates customers don't order these options
very often, its costly to keep in inventory, so you build it on demand.
1655
Oracle SCM Cloud Chapter 9
Implementing Order Management Configure-to-Order
• COMLG is a phantom of COM. It contains its own phantom COMLG, and COMLG contains a phantom, COM-
BRN. Customers use the CM-BRN-BS to choose the type of base and COM-BRN_VAL to choose the type of
value to use when building COM-BRN.
Here's an example configured item, VIK12-100, that your customer ordered. It includes only the options the customer
chose.
Note.
• STVU is the stove unit base. Its required. The work order includes STVU but VIK12-100 doesn't.
• An oven can use only one type of fuel, burner style, oven type, and warming oven. So each of these
components includes only the one option you customer chooses.
1656
Oracle SCM Cloud Chapter 9
Implementing Order Management Configure-to-Order
• The customer didn't want the clock, didn't choose CLK, so its not in VIK12-100.
• The customer chose COM, the commercial burner, and GRD, the griddle for the commercial burner. The
customer also chose COMLG, the large commercial burner.
Operations You Can Use with Web Services for Configured Items
Use operations with the ConfiguredItemService web service to create, read, update, or delete a configured item.
Operation Value
findCtoSalesStructure Get the set of options, option classes, and transaction attributes you user selects at run time.
findCtoItemStructure Get the entire structure of the configured item that your user selects at run time. It includes
child configured items, options, required components, phantoms, substitutions and
transaction attributes.
Here's the payload that the findCtoSalesStructure operation returns for the VIK12-100 configured item. For details about
this item, see the Overview of Using Web Services with Configure-to-Order topic.
1657
Oracle SCM Cloud Chapter 9
Implementing Order Management Configure-to-Order
The payload includes each of the child assemble-to-order items. Assume BRN-11, BSOC-2, and OVOC-30 are the child
configured items.
Here's the payload that the findCtoItemStructure operation returns for the VIK12-100 configured item.
LINE_ID SUB_ITEM_TYPE
ITEM_NUMBER
INVENTORY_ITEM_ID
PARENT_LINE_ID
CONFIG QTY UOM WIP_SUPPLY_TYPE
RootPhantomItemId
ITEM_NUMBER
1658
Oracle SCM Cloud Chapter 9
Implementing Order Management Configure-to-Order
LINE_ID SUB_ITEM_TYPE
ITEM_NUMBER
INVENTORY_ITEM_ID
PARENT_LINE_ID
CONFIG QTY UOM WIP_SUPPLY_TYPE
RootPhantomItemId
ITEM_NUMBER
Transaction Attributes
The web service also returns transaction attributes when it returns the item.
1659
Oracle SCM Cloud Chapter 9
Implementing Order Management Configure-to-Order
7 FINISH Black - -
Details for the configured item are already available in the repository, so it isn't necessary to bring data into the
repository as part of findCtoItemStructure.
◦ true. Refresh data that already exists in the repository before getting it.
◦ false. Save only the missing structure details in the repository. Don't refresh data that already exists in
the repository. The default value is false.
Use deleteConfigStrucure to delete structure details of the configured item from the repository.
• findCtoSalesStructure
• findCtoItemStructure
• refreshConfigStructure
• deleteConfigStrucure
You must use at least one of parameter. If you don't, the web service will raise an error.
1660
Oracle SCM Cloud Chapter 9
Implementing Order Management Configure-to-Order
For example, to refresh data for the VIK12-100, set ConfigItemNumber to VIK12-100.
• Model definition exists in Product Information Management for each item that the import payload contains.
◦ Configuration node
◦ Each item
◦ Primary UOM for each item
• Import payload includes a value for attribute ProductNumber for each order line.
• Import payload includes a quantity for each order line.
• The Product Information Management work area allows a decimal quantity for each decimal quantity that the
import payload contains.
• Import payload doesn't include more than one root model instance.
• Import payload doesn't specify an item more than one time, and that Order Management can resolve this item
according to a model in Product Information Management.
• If the import payload includes an optional model reference, then the payload explicitly states the full input path
to this model reference.
1661
Oracle SCM Cloud Chapter 9
Implementing Order Management Configure-to-Order
• M1
◦ SI1
◦ SI2
◦ SI5
• M1
◦ SI1
◦ OC1
◦ SI5
• SI2
• SI5
• M2
◦ OC2
• SI4
• SI5
createConfigForModelLine will modify the structure from the import payload to this structure.
• M1
◦ SI1
◦ OC1
• SI2
◦ M2
• OC2
◦ SI5
1662
Oracle SCM Cloud Chapter 9
Implementing Order Management Configure-to-Order
If the import payload specifies the unit quantity and the ordered quantity, and if the unit quantity for the configuration
line multiplied by the ordered quantity for the immediate parent line.
• Equals the ordered quantity for the configuration line. createConfigForModelLine can successfully process
the line.
• Doesn't equal the ordered quantity for the configuration line. createConfigForModelLine creates an error
and order import fails.
If the import payload specifies a value in the Quantity Per Model attribute, then createConfigForModelLine ignores it
and calculates the unit quantity and ordered quantity according to the quantities that the import payload specifies for
all configuration lines.
• 1 findCriteria. Structure that contains the entire object and attribute filter criteria.
◦ 1.1 fetchStart and fetchSize. Required. Specify the number of rows in the result set, and specify which
row to start with.
• fetchStart. Row to use as the starting point. The default is 0. If you set the value to 0, then the
result set begins with the first row of the data set. If you set the value to 99, then the result set
begins with the 100th row of the data set.
Caution: If you use findCtoItemStructure, and if you set fetchStart to any value other than
0, then you must use refreshConfigStructure before you use findCtoItemStructure. The web
service assumes the configured item is available in the explosion repository and gets records
beginning with the starting point. Using refreshConfigStructure makes sure the starting point
contains a value.
• fetchSize. Maximum number of rows to get. If you set fetchSize to -1 (negative one), then the
search gets all rows that it finds, starting with the row that fetchStart specifies.
If fetchSize is greater than the number of remaining rows, then the search returns only the
remaining rows. The predefined maximum fetchSize is 500. You can't exceed it in a single query.
If you set fetchSize to a value greater than 500 or to -1, and if more than 500 records match your
search criteria, then the web service creates an exception.
◦ 1.2 filter. Structure that contains runtime search conditions. The view criteria restricts data that your
query returns to the rows that match the filters you specify. If no view criteria exists, then the web service
doesn't apply filters when it processes your request.
Think of view criteria as a collection of one or more query-by-example (QBE) rows that define a data filter
for a view object. The web service converts view criteria to an SQL WHERE clause.
• 1.2.1 conjunction. Specify how to evaluate search conditions in relation to each other. For example,
And, Or, Not, AndNot, and OrNot.
If you don't specify a value, then the web service uses AND. Behavior is similar to how Oracle
Application Development Framework works when a conjunction exists between view criteria and
the previous view criteria.
1663
Oracle SCM Cloud Chapter 9
Implementing Order Management Configure-to-Order
1.2.2.2.3 Attributes
Include the case sensitive name of the attribute to filter on. The root node of a child object is an attribute of the parent
object.
Here are the attributes you can use. You must use at least one of them. If you don't, the web service will raise an error.
1664
Oracle SCM Cloud Chapter 9
Implementing Order Management Configure-to-Order
1.2.2.2.4 Operators
Note.
• Use one of =, >=, <=, >, <,<>, ISBLANK, ISNOTBLANK, CONTAINS, STARTSWITH, AFTER, ONORAFTER, BEFORE,
ONORBEFORE, BETWEEN, or NOTBETWEEN.
• Some operators won't work for all attribute types, such as String, Integer, Date, and so on.
• You typically use numeric operators , such as = or < , for a String attribute.
• Each text operator is case sensitive. For example, ISBLANK is a text operator and is case sensitive.
Here are the operators you can use to search a required attribute when you use findCtoItemStructure. If you use any
other operator, the web service will create an error.
Attribute Operator
ConfigItemId =
ConfigItemNumber =
BaseModelId =
BaseModelItemNumber =
CreationDate BETWEEN
1665
Oracle SCM Cloud Chapter 9
Implementing Order Management Configure-to-Order
You can use any operator on an attribute that isn't required when you use findCtoSalesStructure or
findCtoItemStructure.
http://hostname:port/ctoUtilitiesPublicService/ConfiguredItemService
Use SQL
1666
Oracle SCM Cloud Chapter 9
Implementing Order Management Configure-to-Order
For example.
3. Use SQL to query the table to get details about the response.
SELECT * FROM CTO_ITEM_STRUCTURE WHERE <CONDITION>
1667
Oracle SCM Cloud Chapter 9
Implementing Order Management Configure-to-Order
For example.
select CONFIG_ITEM_ID,
extractvalue(ITEM_STRUCTURE,'/ CtoItemStructureRow /ConfigItemId ')CONFIG_ITEM_ID,
extractvalue(ITEM_STRUCTURE,'/ CtoItemStructureRow /ConfigItemNumber ')CONFIG_ITEM_NUMBER,
extractvalue(ITEM_STRUCTURE,'/ CtoItemStructureRow /BaseModelId ')BASE_MODEL_ID,
extractvalue(ITEM_STRUCTURE,'/ CtoItemStructureRow /BaseModelItemNumber ')BASE_MODEL_ITEM_NUMBER,
extractvalue(ITEM_STRUCTURE,'/ CtoItemStructureRow /InventoryItemId ') INVENTORY_ITEM_ID,
extractvalue(ITEM_STRUCTURE,'/ CtoItemStructureRow /InventoryItemNumber ')INVENTORY_ITEM_NUMBER,
extractvalue(ITEM_STRUCTURE,'/ CtoItemStructureRow /LineId ')LINE_ID,
extractvalue(ITEM_STRUCTURE,'/ CtoItemStructureRow /ParentLineId ')PARENT_LINE_ID,
extractvalue(ITEM_STRUCTURE,'/ CtoItemStructureRow /SubItemType ') SUB_ITEM_TYPE,
extractvalue(ITEM_STRUCTURE,'/ CtoItemStructureRow /OptionalComponent') OPTIONAL_COMPONENT,
extractvalue(ITEM_STRUCTURE,'/ CtoItemStructureRow /ComponentHierarchy ')COMPONENT_HEIRARCHY from
CTO_ITEM_STRUCTURE where CONFIG_ITEM_ID =<CONFIGURED ITEM ID>
Here's some XSLT code you can use to format the response. Use this code with your favorite XML tool.
< xsl: stylesheet version = "1.0"
xmlns: xsl = "http://www.w3.org/1999/XSL/Transform"
xmlns: ns0 = "http://xmlns.oracle.com/apps/scm/cto/matchRepository/utilities/configItemStructureSer
vice / types / "
xmlns: ns2 = "http://xmlns.oracle.com/apps/scm/cto/matchRepository/utilities/configItemStructureSer vice/
types/"
xmlns: ns1 = "http://xmlns.oracle.com/apps/scm/cto/matchRepository/utilities/configItemStructureSer
vice / "
xmlns: env = "http://schemas.xmlsoap.org/soap/envelope/"
xmlns: wsa = "http://www.w3.org/2005/08/addressing"
xmlns: typ = "http://xmlns.oracle.com/apps/scm/cto/matchRepository/utilities/configItemStructureService/
types/ " >
<
xsl: output method = "xml"
indent = "yes"
version = "1.0"
encoding = "UTF-8" / >
<
xsl: template match = "*" >
<
xsl: element name = "{local-name()}" >
<
xsl: if test = "not(not(text()) and not(node()))" >
<
1668
Oracle SCM Cloud Chapter 9
Implementing Order Management Configure-to-Order
<
xsl: apply - templates select = "node()" / >
<
xsl: if test = "../ns2:result[(./ns1:ParentLineId = $LineId and ./ns1:OrganizationId =
$OrganizationId and concat($ComponentItemHierarchy, '-', . / ns1: InventoryItemId) =
. / ns1: ComponentItemHierarchy)]
">
<
xsl: apply - templates select = "../ns2:result[(./ns1:ParentLineId = $LineId and
. / ns1: OrganizationId = $OrganizationId)]
" /> <
/ xsl : if > <
/ xsl : element > <
xsl: variable name = "nl"
select = "'
'" / >
<
xsl: value - of select = "$nl"
disable - output - escaping = "no" / >
<
/ xsl : template > <
/ xsl : stylesheet >
1669
Oracle SCM Cloud Chapter 9
Implementing Order Management Configure-to-Order
Use this XSLT code only to format the output of the findCtoItemStructure operation.
As an alternative, here's some example code you can use to programmatically format the response.
String xml = "input.xml ; // input XML file location
String xslt = "transformations.xsl"; // XSLT file location
String output = "formatted.xml"; //output XML file location
TransformerFactory tf = TransformerFactory.newInstance();
Transformer tr = tf.newTransformer(new StreamSource(new File(xslt)));
tr.transform(new StreamSource(new File(xml)),
fc.setFilter(vc);
int fetchCounter = 0;
List < CtoItemStructure > opList = new ArrayList < CtoItemStructure > ;
List
for storing all the output records List < CtoItemStructure > opTempList = null;
List
for storing the result of one service call
while (opTempList == null || opTempList.size() == 500) {
fc.setFetchStart(fetchCounter);
fc.setFetchSize(500);
opTempList = ctoConfigItemService.findCtoItemStructure(fc, null);
opList.addAll(opTempList);
items of result list from the service call be will be added to the final list fetchCounter = fetchCounter +
500;
}
1670
Oracle SCM Cloud Chapter 9
Implementing Order Management Configure-to-Order
ViewCriteria vc = obj.createViewCriteria();
ViewCriteriaItem vci = obj.createViewCriteriaItem();
vci.setAttribute("CreationDate");
vci.getValue().add("2017-12-09");
vci.getValue().add("2019-12-09");
vci.setOperator("BETWEEN");
vci.setConjunction(Conjunction.AND);
vcr.getItem().add(vci);
}
//End of making the first call
//Get the item structure for configured items that the first call returned
ViewCriteriaRow configVcr = obj.createViewCriteriaRow();
ViewCriteria configVc = obj.createViewCriteria();
ViewCriteriaItem configVci = null;
for (CtoItemStructure itemStructRow: configItemList) //For loop to iterate through the list of configured
items
{
if (itemStructRow.getSubItemType().getValue().intValue() == 1) // if it is a config item create condition
based on config item id
{
configVci = obj.createViewCriteriaItem();
configVci.setAttribute("ConfigItemId");
configVci.getValue().add(itemStructRow.getConfigItemId().getValue());
configVci.setOperator("=");
configVci.setConjunction(Conjunction.OR);
1671
Oracle SCM Cloud Chapter 9
Implementing Order Management Configure-to-Order
configVcr.getItem().add(configVci);
}
}
configVc.getGroup().add(configVcr);
//Make the second call
FindCriteria configFc = obj.createFindCriteria(); configFc.setFilter(configVc);
counter = 0;
List < CtoItemStructure > opList = new ArrayList < CtoItemStructure > (); //List for storing the final
output opTempList=null;
while (opTempList == null || opTempList.size() == 500) {
configFc.setFetchStart(counter);
configFc.setFetchSize(500);
opTempList = ctoConfigItemService.findCtoItemStructure(configFc, null);
counter = counter + 500;
opList.addAll(opTempList);
}
//End of making the second call
//End of get the item structure for configured items that the first call returned
Here's an example of the response you receive for the entire structure.
< ns0: findCtoItemStructureResponse xmlns: ns0 = "http://xmlns.oracle.com/apps/scm/cto/matchRepository/
utilities/configItemStructureService/ty
pes / "> <
ns2: result
xmlns: ns2 = "http://xmlns.oracle.com/apps/scm/cto/matchRepository/utilities/configItemStructureService/ty
pes/"
xmlns: ns1 = "http://xmlns.oracle.com/apps/scm/cto/matchRepository/utilities/configItemStructureService/"
xmlns: ns0 = "http://xmlns.oracle.com/adf/svc/types/"
xmlns: xsi = "http://www.w3.org/2001/XMLSchema-instance"
xsi: type = "ns1:CtoItemStructure" >
<
ns1: ConfigItemId > 300100071637243 < /ns1:ConfigItemId> <
ns1: ConfigItemNumber > DOS - BAT - CTO * 101 * < /ns1:ConfigItemNumber> <
ns1: BaseModelId > 100100035462338 < /ns1:BaseModelId> <
ns1: BaseModelItemNumber > DOS - BAT - CTO < /ns1:BaseModelItemNumber> <
ns1: InventoryItemId > 300100071637243 < /ns1:InventoryItemId> <
ns1: InventoryItemNumber > DOS - BAT - CTO * 101 * < /ns1:InventoryItemNumber> <
ns1: ParentInventoryItemId > 300100071637243 < /ns1:ParentInventoryItemId> <
ns1: ParentInventoryItemNumber > DOS - BAT - CTO * 101 * < /ns1:ParentInventoryItemNumber> <
ns1: HeaderId > 300100071637281 < /ns1:HeaderId> <
ns1: LineId > 300100071637284 < /ns1:LineId> <
ns1: ParentLineId xsi: nil = "true" / >
<
ns1: SubItemType > 1 < /ns1:SubItemType> <
ns1: UnitQuantity xmlns: tns = "http://xmlns.oracle.com/adf/svc/errors/"
unitCode = "Ea" > 1 < /ns1:UnitQuantity> <
ns1: UnitUOM > Ea < /ns1:UnitUOM> <
ns1: CreationDate > 2018 - 12 - 02 T10: 59: 08.119 + 05: 30 < /ns1:CreationDate> <
ns1: RevisionId xsi: nil = "true" / >
<
ns1: EffectivityDate > 2018 - 12 - 02 T10: 59: 08.119 + 05: 30 < /ns1:EffectivityDate> <
ns1: DisableDate xsi: nil = "true" / >
<
ns1: OrganizationId > 204 < /ns1:OrganizationId> <
ns1: OrganizationCode > V1 < /ns1:OrganizationCode> <
ns1: BillSequenceId > 300100046112964 < /ns1:BillSequenceId> <
ns1: ComponentSequenceId xsi: nil = "true" / >
<
ns1: ComponentType > 1 < /ns1:ComponentType> <
ns1: WIPSupplyType xsi: nil = "true" / >
<
ns1: OptionalComponent > Y < /ns1:OptionalComponent> <
ns1: SubstituteComponent > N < /ns1:SubstituteComponent> <
ns1: ComponentYieldFactor xsi: nil = "true" / >
1672
Oracle SCM Cloud Chapter 9
Implementing Order Management Configure-to-Order
<
ns1: PlanningFactor xsi: nil = "true" / >
<
ns1: RoundingDirection xsi: nil = "true" / >
<
ns1: BasisType xsi: nil = "true" / >
<
ns1: CheckATP xsi: nil = "true" / >
<
ns1: ComponentHierarchy > 300100046112964 < /ns1:ComponentHierarchy> <
ns1: ComponentItemHierarchy > 300100071637243 < /ns1:ComponentItemHierarchy> <
ns1: ItemClassId > 100000011369001 < /ns1:ItemClassId> <
ns1: RootPhantomItemId > < /ns1:RootPhantomItemId> <
/ns2:result> <
ns2: result >. . .< /ns2:result> <
ns2: result >. . .< /ns2:result>. . .<
/ns0:findCtoItemStructureResponse>
Here's an example of the response you receive for the structure according to configure options your user sets in the
sales order.
< ns2: result xsi: type = "ns1:CtoSalesStructure"
xmlns: ns2 = "http://xmlns.oracle.com/apps/scm/cto/matchRepository/utilities/configItemStructureService/
types /
" xmlns:ns1="
http: //xmlns.oracle.com/apps/scm/cto/matchRepository/utilities/configItemStructureService/"
xmlns:ns0="http://xmlns.oracle.com/adf/svc/types/" xmlns:xsi="http://www.w3.org/2001/XMLSchema- instance">
<
ns1: ConfigItemId > 300100090366280 < /ns1:ConfigItemId> <
ns1: ConfigItemNumber > BSOC * 220 * < /ns1:ConfigItemNumber> <
ns1: BaseModelId > 300100032201662 < /ns1:BaseModelId> <
ns1: BaseModelItemNumber > BSOC < /ns1:BaseModelItemNumber> <
ns1: InventoryItemId > 300100032201442 < /ns1:InventoryItemId> <
ns1: InventoryItemNumber > STD - Burner < /ns1:InventoryItemNumber> <
ns1: ParentInventoryItemId > 300100090366280 < /ns1:ParentInventoryItemId> <
ns1: ParentInventoryItemNumber > BSOC * 220 * < /ns1:ParentInventoryItemNumber> <
ns1: HeaderId > 300100090366310 < /ns1:HeaderId> <
ns1: LineId > 300100090366315 < /ns1:LineId> <
ns1: ParentLineId > 300100090366312 < /ns1:ParentLineId> <
ns1: SubItemType > 2 < /ns1:SubItemType> <
ns1: UnitQuantity unitCode = "Ea"
xmlns: tns = "http://xmlns.oracle.com/adf/svc/errors/" > 1 < /ns1:UnitQuantity> <
ns1: UnitUOM > Ea < /ns1:UnitUOM> <
ns1: ItemHierarchy > /300100090366280/
300100032201442 < /ns1:ItemHierarchy> <
ns1: CreationDate > 2018 - 10 - 05 T06: 49: 45.836 - 07: 00 < /ns1:CreationDate> <
ns1: RootHeaderId > 300100090366310 < /ns1:RootHeaderId> <
ns1: CtoTransactionAttr >
<
ns1: LineId > 300100090366315 < /ns1:LineId> <
ns1: TimestampAttributeValue xsi: nil = "true" / >
<
ns1: NumberAttributeValue > 0 < /ns1:NumberAttributeValue> <
ns1: DateAttributeValue xsi: nil = "true" / >
<
ns1: CharacterAttributeValue xsi: nil = "true" / >
<
ns1: AttributeName > Number < /ns1:AttributeName> <
/ns1:CtoTransactionAttr> <
/ns2:result>
1673
Oracle SCM Cloud Chapter 9
Implementing Order Management Configure-to-Order
Basic Queries
Query on Simple Condition
Use findCtoItemStructure to get the entire structure for each configured item created between 09-Dec-2018
and 09-Dec-2019 where the configuration model is VIK12. Don't include the InventoryItemId attribute or the
ParentInventoryItemId attribute in the response.
<ns1: findCtoItemStructurexmlns:ns1="http://xmlns.oracle.com/apps/scm/cto/matchRepository/utilities/
configItemStr uctureService/types/">
<ns1:findCriteria xmlns:ns2="http://xmlns.oracle.com/adf/svc/types/">
<ns2:fetchStart>0</ns2:fetchStart>
<ns2:fetchSize>-1</ns2:fetchSize>
<ns2:filter>
<ns2:conjunction>And</ns2:conjunction>
<ns2:group>
<ns2:conjunction>And</ns2:conjunction>
<ns2:upperCaseCompare></ns2:upperCaseCompare>
<ns2:item>
<ns2:conjunction>And</ns2:conjunction>
1674
Oracle SCM Cloud Chapter 9
Implementing Order Management Configure-to-Order
<ns2:upperCaseCompare></ns2:upperCaseCompare>
<ns2:attribute>CreationDate</ns2:attribute>
<ns2:operator>between</ns2:operator>
<ns2:value>2018-10-9</ns2:value> -- Use format YYYY-MM-DD.
<ns2:value>2019-12-09</ns2:value>
</ns2:item>
<ns2:item>
<ns2:conjunction>And</ns2:conjunction>
<ns2:upperCaseCompare></ns2:upperCaseCompare>
<ns2:attribute> BaseModelItemNumber </ns2:attribute>
<ns2:operator>CONTAINS</ns2:operator>
<ns2:value>VIK12</ns2:value>
</ns2:item>
</ns2:group>
</ns2:filter>
<ns2:findAttribute>InventoryItemId</ns2:findAttribute> --List of attributes to include or not include in
response.
<ns2:findAttribute>ParentInventoryItemId</ns2:findAttribute>
<ns2:excludeAttribute>true</ns2:excludeAttribute> --true means don't include in response.
</ns1:findCriteria>
</ns1: findCtoItemStructure>
Use findCtoItemStructure to get the entire structure for each configured item created between 09-Dec-2018 and 09-
Dec-2019 where the configuration model is VIK12. Use RefreshStructure to refresh the explosion repository.
<ns1: findCtoItemStructurexmlns:ns1="http://xmlns.oracle.com/apps/scm/cto/matchRepository/utilities/
configItemStructureService/types/">
<ns1:findCriteria xmlns:ns2="http://xmlns.oracle.com/adf/svc/types/">
<ns2:fetchStart>0</ns2:fetchStart>
<ns2:fetchSize>-1</ns2:fetchSize>
<ns2:filter>
<ns2:conjunction>And</ns2:conjunction>
<ns2:group>
<ns2:conjunction>And</ns2:conjunction>
<ns2:upperCaseCompare></ns2:upperCaseCompare>
<ns2:item>
<ns2:conjunction>And</ns2:conjunction>
<ns2:upperCaseCompare></ns2:upperCaseCompare>
<ns2:attribute>CreationDate</ns2:attribute>
<ns2:operator>between</ns2:operator>
<ns2:value>2018-10-09</ns2:value> -- Use format YYYY-MM-DD.
<ns2:value>2019-12-09</ns2:value>
</ns2:item>
<ns2:item>
<ns2:conjunction>And</ns2:conjunction>
<ns2:upperCaseCompare></ns2:upperCaseCompare>
<ns2:attribute> BaseModelItemNumber </ns2:attribute>
<ns2:operator>CONTAINS</ns2:operator>
<ns2:value>VIK12</ns2:value>
</ns2:item>
<ns2:item>
<ns2:conjunction>And</ns2:conjunction>
<ns2:upperCaseCompare></ns2:upperCaseCompare>
<ns2:attribute> RefreshStructure </ns2:attribute>
<ns2:operator>=</ns2:operator>
<ns2:value>true</ns2:value> -- Use true or false with RefreshStructure.
</ns2:item>
</ns2:group>
</ns2:filter>
</ns1:findCriteria>
</ns1: findCtoItemStructure>
1675
Oracle SCM Cloud Chapter 9
Implementing Order Management Configure-to-Order
If the web service response for a configured item structure includes more than 500 rows, then you must call the service
one time for each set of 500 rows. For example, if the structure contains 1550 rows, then you make four calls.
• First call gets rows 0 through 499
• Second call gets rows 500 through 999
• Third call gets rows 1,000 through 1,499
• Fourth call gets rows 1,500 through 1,550
You must not set the start value to a value greater than 0 in the first call. The start value for the second call is greater
than zero, so the web service doesn't refresh the repository. Setting the start value to 0 in the first call makes sure the
web service refreshes the entire structure.
1676
Oracle SCM Cloud Chapter 9
Implementing Order Management Configure-to-Order
<ns2:group>
<ns2:conjunction>And</ns2:conjunction>
<ns2:upperCaseCompare />
<ns2:item>
<ns2:conjunction>And</ns2:conjunction>
<ns2:upperCaseCompare />
<ns2:attribute>CreationDate</ns2:attribute>
<ns2:operator>BETWEEN</ns2:operator>
<ns2:value>2018-12-09</ns2:value>
<ns2:value>2019-12-09</ns2:value>
</ns2:item>
</ns2:group>
</ns2:filter>
<ns2:excludeAttribute />
</ns1:findCriteria>
<ns1:findControl xmlns:ns2="http://xmlns.oracle.com/adf/svc/types/">
<ns2:retrieveAllTranslations />
</ns1:findControl>
</ns1:findCtoItemStructure>
Using findCtoItemStructure to get a large structure might take a lot of time because it must first refresh the explosion
repository to get structure details, and then query the data. To avoid this problem, make two calls.
Add subsequent calls to get the structure. See the Get Large Structures section, above.
Other Queries
Group Your Conditions
In this example, use findCtoItemStructure to get the entire structure of each configured item created between 09-
Dec-2018 and 09-Dec-2019 for configuration model VIK12. Use the OR conjunction to group your conditions.
<?xml version="1.0" encoding="UTF-8"?>
<ns1:findCtoItemStructure xmlns:ns1="http://xmlns.oracle.com/apps/scm/cto/matchRepository/utilities/
configItemStructureService/types/">
<ns1:findCriteria xmlns:ns2="http://xmlns.oracle.com/adf/svc/types/">
<ns2:fetchStart>0</ns2:fetchStart>
<ns2:fetchSize>500</ns2:fetchSize>
<ns2:filter>
<ns2:conjunction>And</ns2:conjunction>
<ns2:group>
<ns2:conjunction>And</ns2:conjunction>
<ns2:upperCaseCompare />
<ns2:item>
1677
Oracle SCM Cloud Chapter 9
Implementing Order Management Configure-to-Order
<ns2:conjunction>And</ns2:conjunction>
<ns2:upperCaseCompare />
<ns2:attribute>CreationDate</ns2:attribute>
<ns2:operator>BETWEEN</ns2:operator>
<ns2:value>2018-12-09</ns2:value>
<ns2:value>2019-12-09</ns2:value>
</ns2:item>
</ns2:group>
<ns2:group>
<ns2:conjunction>Or</ns2:conjunction>
--Group with the OR condition.
<ns2:upperCaseCompare />
<ns2:item>
<ns2:conjunction>And</ns2:conjunction>
<ns2:upperCaseCompare />
<ns2:attribute>BaseModelItemNumber</ns2:attribute>
<ns2:operator>=</ns2:operator>
<ns2:value>VIK12</ns2:value>
</ns2:item>
</ns2:group>
</ns2:filter>
<ns2:excludeAttribute />
</ns1:findCriteria>
<ns1:findControl xmlns:ns2="http://xmlns.oracle.com/adf/svc/types/">
<ns2:retrieveAllTranslations />
</ns1:findControl>
</ns1:findCtoItemStructure>
Use findCtoItemStructure to get the entire structure of the VIK12-100 configured item. Filter the result so it only includes
details for transactional attribute names that start with MFG_Transactional_Attributes, and that contain the value Black.
<ns1:findCtoItemStructure xmlns:ns1="http://xmlns.oracle.com/apps/scm/cto/matchRepository/utilities/
configItemStructureService/types/"
>
<ns1:findCtoItemStructure>
<ns1:findCriteria>
<ns2:fetchStart>0</ns2:fetchStart>
<ns2:fetchSize>-1</ns2:fetchSize>
<ns2:filter>
<ns2:conjunction>And</ns2:conjunction>
<ns2:group>
<ns2:conjunction>And</ns2:conjunction>
<ns2:upperCaseCompare>false</ns2:upperCaseCompare>
<ns2:item>
<ns2:conjunction>And</ns2:conjunction>
<ns2:upperCaseCompare>false</ns2:upperCaseCompare>
<ns2:attribute>ConfigItemNumber</ns2:attribute>
<ns2:operator>=</ns2:operator>
<ns2:value>VIK12*100</ns2:value>
</ns2:item>
</ns2:group>
</ns2:filter>
<ns2:childFindCriteria> -- This is the structure for adding conditions based on TIA
<ns2:fetchStart>0</ns2:fetchStart>
<ns2:fetchSize>-1</ns2:fetchSize>
<ns2:filter>
<ns2:conjunction>And</ns2:conjunction>
<ns2:group>
<ns2:conjunction>And</ns2:conjunction>
<ns2:upperCaseCompare>false</ns2:upperCaseCompare>
<ns2:item>
<ns2:conjunction>And</ns2:conjunction>
<ns2:upperCaseCompare>false</ns2:upperCaseCompare>
1678
Oracle SCM Cloud Chapter 9
Implementing Order Management Configure-to-Order
<ns2:attribute>AttributeName</ns2:attribute>
<ns2:operator>STARTSWITH</ns2:operator>
<ns2:value>MFG_Transactional_Attributes</ns2:value>
</ns2:item>
<ns2:item>
<ns2:conjunction>And</ns2:conjunction>
<ns2:upperCaseCompare>false</ns2:upperCaseCompare>
<ns2:attribute>CharacterAttributeValue</ns2:attribute>
<ns2:operator>=</ns2:operator>
<ns2:value>Black</ns2:value>
</ns2:item>
</ns2:group>
</ns2:filter>
<ns2:childFindCriteria/>
<ns2:childAttrName>CtoTransactionAttr</ns2:childAttrName> -- This value is fixed and needs to be passed if
we want filter based on the TIA
</ns2:childFindCriteria>
</ns1:findCriteria>
<ns1:findControl>
<ns2:retrieveAllTranslations>false</ns2:retrieveAllTranslations>
</ns1:findControl>
</ns1:findCtoItemStructure>
Get the entire item structure for configured items created between 09-DEC-2018 and 09-DEC-2019, and where the value
of transaction attribute SCO_color is Black.
1679
Oracle SCM Cloud Chapter 9
Implementing Order Management Configure-to-Order
<ns2:conjunction>And</ns2:conjunction>
<ns2:upperCaseCompare>false</ns2:upperCaseCompare>
<ns2:attribute>AttributeName</ns2:attribute>
<ns2:operator>=</ns2:operator>
<ns2:value>SCO_Color</ns2:value>
</ns2:item>
<ns2:item>
<ns2:conjunction>And</ns2:conjunction>
<ns2:upperCaseCompare>false</ns2:upperCaseCompare>
<ns2:attribute>CharacterAttributeValue</ns2:attribute>
<ns2:operator>=</ns2:operator>
<ns2:value>Black</ns2:value>
</ns2:item>
</ns2:group>
</ns2:nested>
</ns2:item>
</ns2:group>
</ns2:filter>
<ns2:excludeAttribute />
</ns1:findCriteria>
</ns1:findCtoItemStructure>
Here's a payload that removes the structure of all configured items that include VIK12 as the item number.
<?xml version="1.0" encoding="UTF-8"?>
<ns1:deleteConfigStructure xmlns:ns1="http://xmlns.oracle.com/apps/scm/cto/matchRepository/utilities/
configItemStructureService/types/">
<ns1:configList xmlns:ns2="http://xmlns.oracle.com/apps/scm/cto/matchRepository/utilities/
configItemStructureService/">
<ns2:BaseModelItemNumber>VIK12</ns2:BaseModelItemNumber>
1680
Oracle SCM Cloud Chapter 9
Implementing Order Management Configure-to-Order
</ns1:configList>
</ns1:deleteConfigStructure>
1681
Oracle SCM Cloud Chapter 9
Implementing Order Management Configure-to-Order
1. Assemble-to-order item.
2. Option class.
4. Configure option.
1682
Oracle SCM Cloud Chapter 9
Implementing Order Management Configure-to-Order
1. Assembled component.
1683
Oracle SCM Cloud Chapter 9
Implementing Order Management Configure-to-Order
1. Run rule.
Transaction Attribute
Here are the attributes that the response contains when your payload includes a transaction attribute.
1684
Oracle SCM Cloud Chapter 9
Implementing Order Management Configure-to-Order
1685
Oracle SCM Cloud Chapter 9
Implementing Order Management Configure-to-Order
1686
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
10 Extend
Extensions
Overview
Overview of Creating Order Management Extensions
Write your own Groovy script that modifies your Order Management deployment, implements your own functionality,
and specifies the extension point that determines when to run this script.
An order management extension is a Groovy script you write that meets your specific business requirements. An
extension point is an event that you specify to determine when to run the script.
You can use a flexfield to modify the data model, or Page Composer to modify the user interface, but you can't use
them to programmatically modify logic or modify your order management deployment. Instead, you can create an order
management extension.
1687
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
Here is some Groovy script in an example extension named Update Order Submit Date. It uses attribute
_H1AttributeDateTime so it can set the value of an extensible flexfield to the date and time when Order Management
submitted the sales order.
Get data Create an order management extension to get data from different sources.
1688
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
• Use a web service to get data from a source that resides outside of Order Management
Cloud.
Implement your own logic Use Groovy to write your own logic when you code your extension. Your code can validate the
sales order. If validation fails, then your code can stop the flow and create a message.
For details about Groovy, see website Groovy Programming Language at www.groovy-lang.org.
Raise error messages and warnings Create an extension that raises an error message or warning.
Set the default value for sales order Use Groovy to write your own logic that sets default values before you save the sales order or
attributes or extensible flexfields submit it to order fulfillment.
Get values for return lines from the A return order doesn't include values from the original order on some order line attributes. For
original sales order. example, the return line doesn't include the original value for the sales credit or purchase order
number. You can use an extension to get the value from the original line order.
Example Actions
Action Description
• Reassign the warehouse for pick-to-order. Set up an item that determines whether the
Submit a sales order sales order references a pick-to-order or a hardware model.
• Stop support lines that reference an incorrect accounting rule. Set up item entities and
accounting rule entities.
• Make sure only one contract is Active or Signed for a booking. Set up entities for the
installed base, contracts, or order management.
• Assign a sales representative. Set up sales compensation rules.
• Update the accounting rule for a model for included items.
• Update the quote status for each sales order from a store front that a third-party partner
maintains.
• Verify the purchase order number that the Order Entry Specialist enters on the sales
order equals a purchase order in Oracle Fusion Procurement.
• Assign the Salesperson according to a sales compensation rule that you create in some
application outside of Oracle Fusion, then use a web service to call the application.
• During order import, copy attachments from a purchase-to-order kit to each item that
the kit contains.
• Set the default value for order preferences in each sales order. Get these values from the
customer master.
Save or validate a sales order Write a validation on an imported source order that rejects the import or prevents the Order
Entry Specialist from saving the order without fixing the problem.
1689
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
Part Description
Function A Groovy function, similar to a Java function, such as getAttr. Use a function only in the
extension where you set it up. You can't define a function in one extension, and then use it in
another extension.
• Your extension code can only call a web service that you set up on the Manage Web
Service Definitions page.
• You must manually create the request payload in your code.
• Your code must parse and interpret the response payload.
• You must write your code so it works only for a synchronous interaction. You can't write
code for an asynchronous interaction.
Message A message you send to Order Management and that can display in the Order Management
work area.
1690
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
Note.
1. Something occurs that triggers the On Save extension point.
◦ An Order Entry Specialist does an action in the Order Management work area that causes Order
Management Cloud to automatically save the sales order. Here are some example actions.
• Validate
• Save
1691
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
If an order management extension that runs during On Save raises a validation failure, then Order Management stops
running the extension and moves control to the next extension that you specify to run during On Save. If the validation
failure includes at least one error message, and if Order Management has already run each of the On Save extensions,
then it aborts the save for the sales order.
Order Management handles each message that the extension raises differently depending on how its saving the sales
order.
• An Order Entry Specialist is saving a sales order in the Order Management work area. Order Management
displays the message in a dialog. This user must correct the validation error and attempt to save the sales order
again.
• A service is saving a source order during order import. Order Management returns the message in a response.
The channel that's importing the source order must fix it, then import it again.
Order Management doesn't save the message in the messaging framework because it might not have saved the sales
order and the change that caused the validation to fail.
1692
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
• If the validation failure includes at least one error message, then Order Management aborts the submit for the
sales order, returns the order status to Draft, then logs the error and warning messages.
• If the Order Entry Specialist is saving a sales order in the Order Management work area, and if the validation
failure includes at least one error message, then Order Management displays a dialog that includes the
message.
• If all messages are warnings, then Order Management submits the sales order to order fulfillment and doesn't
display a dialog in the Order Management work area. The user can view the warning message after Order
Management submits the sales order to order fulfillment.
• Order Management calls the extension when the extension point occurs. It makes this call as the last step
before it sends the sales order to order fulfillment.
• The extension can modify values only on header flexfields and fulfillment line flexfields. If the extension
attempts to modify any other attribute, then Order Management logs a runtime error and aborts all extensions
that its running for this extension point.
Guidelines
Determine Data Requirements and Consider Runtime Behavior
Determine the type of data you need and how you will access it. Then determine the runtime behavior your need.
Data from a sales order in Order To read data, use methodgetAttribute. Each method can read or write only to the
Management Cloud. sales order that the Order Entry Specialist
is currently entering in work area Order
To write data, use the setAttribute method. Management. They don't read or write to
some other version of the current sales
order, or to some other sales order in
Order Management.
Data from an Oracle Fusion Application Public View Object (PVO). The Oracle Fusion Application must share
outside of Order Management, such as their data through a public view object.
the customer master, the item master The public view object you need might not
in Oracle Fusion Procurement or Oracle For details, see the Use Extensions be available, or it might not provide access
Fusion Receivables, and so on. to Access Data Outside of Order to the attribute that you require. It might
Management topic. be necessary to submit a request to get
access to the data you need.
1693
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
Data from a system that resides outside of Web service. You can use only a synchronous web
an Oracle Fusion Application service. You can't use an asynchronous
web service.
Consider the data you can access. For a complete list, see the Attributes You Can Use With Order Management
Extensions topic.
Do a read operation on this data at Do a write operation on this data during the On Save or the On Start of Submission Request
any of the extension points. extension points.
1694
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
Note.
• Order Management runs each extension in sequential order, and it only extensions where the Active attribute
contains a check mark run. Assume you create extensions x, y, and z. Extension x runs first, then extension y. If
you make z active, then Order Management runs extension x, and then z, and then y.
1695
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
• Order Management runs each active extension until it finishes unless an error or warning occurs. If an error or
warning occurs, then Order Management doesn't run any more extensions. For example, assume x, y, and z are
active, x finishes, but z ends in error. Order Management won't run extension y.
• Each variable is local to each extension. You can't share them across extensions. For example, assume you
require variable A in extensions x and y. If you define variable A in x, then you can't use A in y. Instead, you must
write logic in y that references A in x.
Related Topics
• Manage Connector Details Between Order Management and Your Fulfillment System
1696
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
Overview
Note.
1. Use an IF. Avoid writing code that runs in every condition in your development environment. Instead, use an IF
statement so your code runs only in your specific use case.
Assume you write a statement that runs every time the extension point occurs, without conditional logic, but
the extension contains an error. The extension might cause every sales order in your development environment
to fail in every situation, regardless of the condition you must test. This situation might negatively affect other
developers, and also make it more difficult for you to manage each of your own extensions.
For example, assume you write an extension that manipulates attribute shipInstructions. You can add this
statement as the first statement in your extension so your code runs only for your use case.
1697
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
If the statement evaluates to true, then no more logic in your extension runs. Instead, the flow exits your
extension.
Remove the IF after you test your extension and are ready to deploy into production.
2. Check for empty values. Avoid a null pointer exception. Use an IF statement that makes sure each attribute
you reference contains a value. If it doesn't, then return flow out of the extension.
3. Add comments. Add detailed comments that document each part of your code so you know exactly the logic
that each statement implements. Comments help others to understand the intent of your code, and also help
you to troubleshoot large complex code, or code that you haven't examined for a long period of time.
• Consider all factors that impact the order line, such as configured items, kits, or ship sets.
• Take advantage of Groovy constructs, such as simplified array usage and initializing maps.
Use implicit variables with each extension. You don't need to define them.
Header Represents the order header object. Use the Header variable to access order header attributes
and child entity rows.
Context Context object that allows each extension to access context details, such as the name of the
extension that's running, the event code, and so on. The context object also provides access to
utility and helper methods, such as logging.
For example.
1698
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
Action Code
For example.
Code Description
header.setAttribute("ShippingInstructions",
Set the value of the ShippingInstructions attribute to Use only next-day air.
"Use only next-day air.");
def lines = Return a set of lines. You can iterate over the iterator to access individual lines.
header.getAttribute("Lines");
Code Description
def lines = Call the getAttribute method on the order header to access the row set iterator for the order
header.getAttribute("Lines"); lines.
1699
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
Code Description
while( lines.hasNext() ) { Determine whether the lines row set includes a next row, and loop until the row set doesn't
contain any more rows.
• On the first loop through the while, move from line 1 to line 2.
• On the second loop through the while, move from line 2 to line 3.
• And so on.
line.SetAttribute("BillingTransactionTypeIdentifier,
Set the value of the billing transaction type on the order line to 12345L.
12345L");
For brevity, this example hard codes the value 12345L. In most situations, its more likely you
would define a variable or some other logic rather than hard code the value.
while( lines.hasNext() ) {
def line = lines.next();
line.SetAttribute("BillingTransactionTypeIdentifier, 12345L");
}
Code Description
def lines = Use method getAttribute on the order header to access the row set iterator for the order lines.
header.getAttribute("Lines");
while( lines.hasNext() ) { Determine whether the lines row set includes a next row, and loop until the row set doesn't
contain any more rows.
def charges = Get the row set for the order charges on the order line.
line.getAttribute("OrderCharges");
1700
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
Code Description
def charge = charges.next(); Get the next order charge from the row set.
def chargeComps = Get the row set for the charge components of the child entity.
charge.getAttribute("ChargeComponents");
while( chargeCompo.hasNext() ) Loop through the charge components for the current charge.
{
def currency = Get the value of attribute ChargeCurrencyCode from the current charge component row.
chargeComp.getAttribute("ChargeCurrencyCode");
1701
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
This example references ORA_FOM_ORDER_ENTRY_SPECIALIST_JOB, which is the role code for job role Order Entry
Specialist.
Note.
1. Use the Security Console to get details about the job roles and role code that your extension must reference.
For details, see topic Security Console: Overview.
2. Use method isUserInRole.
3. In the first parameter for isUserInRole, reference the role code that the security console defines.
1702
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
Manipulate Attachments
Use an order management extension to create, read, update, or delete an attachment. Use a text or XML attachment
file. Don't use a binary file.
Note.
1. Use get methods to get attachment details from an attachment that already exists, such as getText to get all
the text that the attachment contains, use getPklValue to get the sales order or order line that references the
attachment, getFileName to get the name of the attachment file name, and so on. Here's some of the methods
you can use.
◦ getText
◦ getPklValue
1703
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
◦ getEntityName
◦ getDataTypeCode
◦ getTitle
◦ getDescription
◦ getFileName
◦ getUrl
◦ getCategoryName
2. Use the createAttachment method to create an attachment, and use set methods to specify how to create it.
You can specify a new attachment file of type File, Text, or URL. For example, use setFileName to specify the
name of the attachment file. Here are some of the methods you can use.
◦ setDataTypeCode
◦ setTitle
◦ setDescription
◦ setFileName
◦ setFileContentType
◦ setFileContent
3. Use the deleteAttachment method to delete an attachment. In this example, the code uses a for statement to
iterate through all the attachments that a sales order contains and deletes all of them.
Related Topics
• Manage Connector Details Between Order Management and Your Fulfillment System
• Filter out order lines that are canceled, closed, on backorder, or that Order Management has sent to billing
when you create a business rule that modifies a value on a fulfillment line that's still in progress.
• Filter out order lines you already fulfilled. For example, filter out lines you already shipped for outbound lines or
lines you already received and delivered for return lines.
• Filter so you only process changes that you make to billing attributes, for example, on the Billing tab of the
order line, and only if you haven't sent the order line to billing. For example, only modify Accounting Rule,
Payment Terms, Receivable Transaction Type, and so on. Don't modify any other attributes.
• Avoid the NullPointerException error. If your logic depends on using an attribute value as part of a calculation,
then filter out lines that include an attribute that doesn't contain a value.
• Filter according to line category code. For example, to process only order lines, not return lines, filter the
categoryCode attribute on the fulfillment line according to ORDER. To process only returns, filter it according to
the value RETURN.
• If you use an order management extension, pretransformation rule, or posttransformation rule to set the
default values for attributes, then filter out fulfillment lines that reference the original return when you populate
the value for the Accounting Rule attribute and Invoicing Rule attribute.
1704
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
while( lines.hasNext() ) {
def line = lines.next();
Long referenceFlineId = line.getAttribute("ReferenceFulfillmentLineIdentifier");
if (runningLine.getAttribute("FulfillLineStatusCode") == "CLOSED" ||
runningLine.getAttribute("FulfillLineCanceledFlag") == "Y" || //Line is cancelled.
runningLine.getAttribute("FulfillLineShippedQty") != null || //Line is shipped.
runningLine.getAttribute("FulfillLineInvoiceInterfacedFlag") == "Y" ){ //Line is interfaced to invoicing.
// This line isn't valid for setting default values.
continue;
}
}
else {
// This sales order doesn't have a revision.
//Its ok to set the default value for attributes.
}
//Put your defaulting logic here.
//line.setAttribute(<attribute name>, <value>);
}
1705
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
def vc = flinePVO.createViewCriteria();
def rowset = flinePVO.findByViewCriteriaWithBindVars(vc, -1, new String [0], new String [0]);
if (rowset.hasNext()) {
def fline = rowset.first();
return fline;
}
}
1706
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
The line-selection criteria filters out lines that can't ship so Order Management only sends shippable lines to the
fulfillment system that processes shippable lines, such as the shipping system or Global Order Promising.
Note.
• Use the Manage Orchestration Process Definitions task in the Setup and Maintenance work area.
• Use the line-selection criteria to add the rule.
• Add the rule to each orchestration process step that shippable affects, as necessary. For example, if the item is
a warranty, then it isn't shippable. To filter out the line that isn't shippable, you probably want to add the rule to
each step that references a schedule, reserve, or ship task, such as the Schedule step, the Create Reservation
step, Create Shipment Request step, and so on.
1707
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
• The entire If statement isn't visible in the screen capture. Here are the entire statements.
◦ DooSeededOrchestrationRules.DOOFLine.categoryCode is "ORDER"
◦ DooSeededOrchestrationRules.DOOFLine.shippableFlag is "Y"
• You can't use Visual Information Builder to select fulfillment lines. You must edit the orchestration process and
use Oracle Business Rules.
• If the nonKitModelFlag attribute contains Y on a line-selection criteria, and if the order line contains a
configuration model, and if the model contains a kit, then the rule will select the line and process it.
If DooSeededOrchestrationRules.DOOFLine.nonKitModelFlag is Y
◦ nonKitModelFlag is a temporary attribute. Its data exists only in active, working memory, so you can't
access it later in downstream fulfillment.
Write a pretransformation rule where you set the value for an attribute, but only after you filter lines. For example.
• If the order line isn't closed, canceled, shipped, or already sent to billing, then set the default value for the
requested ship date attribute.
For details about how to create a posttransformation rule, see the Transformation Rules topic.
1708
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
Note.
• Use the Manage Processing Constraints task in the Setup and Maintenance work area.
• Set the Entity attribute to Order Fulfillment Line.
• Use the Details area to add your filters.
Assume you don't want your users to modify a fulfillment line value, such as Ship-to Site, if the line is closed or
canceled, or if it already shipped or already invoiced.
1709
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
You can also create a constraint that prevents the user from submitting a sales order that doesn't include payment
terms for lines that meet a specific criteria. For example, the line isn't a return line, or the line is for an internal transfer.
For details, see the Control Payment Terms section in topic Guidelines for Controlling Customer Details in Order
Management.
Related Topics
• Processing Constraints
• Orchestration Processes
• Select Fulfillment Lines for Orchestration Process Steps
If an error occurs at runtime, then Order Management handles the error in the same way it handles any other error. It
displays the cause of failure, extension name, and event name. It displays these details in the Order Management work
area and in the log files. It can handle these runtime errors.
1710
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
Note.
• After you finish testing and are ready to deploy your extension to production, modify your debugging logic to
write to a log file instead of commenting your test code. Writing to the log file can be helpful for future possible
troubleshooting. If you write data to the log file in a production environment, then you must contact Oracle
Support or a customer administrator to get view access to the log files that include application diagnostic data.
• Use the log files to evaluate performance. For example, if you write a lot of extension code, then examine and
monitor performance to make sure your code doesn't impact performance in a negative way.
For example, extension code typically performs a significant amount of validation immediately after the Order
Entry Specialist clicks Submit. If Order Management requires a long amount of time to finish the submit, such
as five minutes, then it might be necessary to look closely at your code to determine whether it contains some
logic you can streamline.
1711
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
Inspect Payloads When You Use Web Services or Public View Objects
It might be difficult to examine the response from a web service or from the view criteria of a public view object. Use the
setAttribute method during development to get values for the attributes that your code references, display them in the
Order Management work area, then examine these values to verify your code returns the values you expect.
For example, assume your extension references shipping instructions. You can use this code to write the contents of
ShippingInstructions into the response from the web service.
header.setAttribute("ShippingInstructions", response.getSoapBody().getTextContext());
You can write the same data into the response from a public view object.
Make sure you convert your test code to log files or comment it ( // ) before you deploy to production.
1712
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
You can also write a message to achieve a similar result. However, a message stops or pauses processing. Use a payload
so processing can continue without interruption, and so you can view attribute values in the context of how they display
in the Order Management work area, such as the Shipping Instructions attribute on the order line.
You can then write your code so it displays these contents in the Shipping Instructions attribute in the Order
Management work area, then examine this display output to determine the values of various attributes and variables
that exist at various points in your code.
1713
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
When you're ready to deploy to production, modify void debug. For example, assume you use this code to write your
debug contents.
void debug(def msg)
{String si = header.getAttribute("ShippingInstructions");
header.setAttribute("ShippingInstructions", si + ", " + msg.toString());
Modify this code so it writes to the log. You replace header.setAttribute with logger.logFine. For example.
void debug(def msg)
{String si = header.getAttribute("ShippingInstructions");
logger.logFine("ShippingInstructions", si + ", " + msg.toString());
Use this approach so you can change only a single line in your code, which is useful if you have 10s of lines that call
debug. You can also comment each line that calls the debug method, but commenting runs the risk of missing lines that
call debug, or accidentally commenting a line that doesn't call debug but that's critical to your code logic.
// invoke the Check Check service using web service connector name 'CreditCheckService'. The connector is
set up using task 'Manage External Interface Web Service Details'. Since this is an external service that
is secured
// using message protection policy, we have registered the the https (external) URL of the service
def response = context.invokeSoapService("CreditCheckService", payLoad);
// print a debug message. This appends the entire response to the shipping instuctions attribute.
// Note: debug statements like these should be disabled in extensions on production instance as they can
cause performance issues.
debug(response.getSoapBody().getTextContent());
// The response XML sent by the Credit Check service contains an element named 'Response'. A YES value
indicates that credit check passed. Let us extract the contents of Response tag. The following XML API will
return all nodes (tags)
// with name 'Response' in a NodeList element. We are expecting only one such element in our XML response
def nodeList = response.getSoapBody().getElementsByTagNameNS("*", "Response");
1714
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
// Get the first element with name 'Response' (we are expecting only one), and gets its text content
String ccResponse = nodeList.item(0).getTextContent();
debug(ccResponse);
/**
* Appends passed in msg to the Shipping Instructions attribute. This method has been implemented only for
debugging purposes.
*/
void debug(def msg) {
String si = header.getAttribute("ShippingInstructions");
header.setAttribute("ShippingInstructions", si + ", " + msg.toString());
}
Related Topics
• Manage Connector Details Between Order Management and Your Fulfillment System
1715
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
External
Guidelines for Calling Web Services in Order Management Extensions
Apply these guidelines when your extension calls a web service.
Note.
1. Use the invokeSoapService method in your extension to call the web service.
You can call an Oracle Fusion web service or some other service that resides outside of Oracle Fusion. You can
call only a SOAP service. You can't call a REST service.
2. Set up the connector.
1716
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
Note: You must use the Manage Connector Details page to set up a connector for the web service that you
reference in your extension.
Attribute Value
Connector Name Use the exact same name that you use in the extension. For example.
invokeSoapService("FundsCapturePaymentMethod")
Connector URL Enter the URL that locates the web service address that you deploy on the external system.
User Name Enter the user name you use to sign into the web service.
Password Enter the password you use to sign into the web service.
For details about how to set up a connector, see the Manage Connector Details Between Order Management
and Your Fulfillment System topic.
1717
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
Note.
1. Define the payload. This example uses String payLoad to hard code the payload as a string. You can also use
other techniques to meet your requirements, such as defining variables in the payload.
2. Reference your payload definition in a parameter of the invokeSoapService method. This example references
string payLoad.
3. Use the getSoapBody method to handle the response that the web service sends in reply to your request. Your
extension can receive the response, parse it, then extract the details it requires from the response.
4. Define your payload so it includes only the main content. Don't include envelope or body details.
invokeSoapService expects only the main content. It will add envelope and body details.
1718
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
org.w3c.dom.Element and org.w3c.dom.Node. Use the methods that are available on these interfaces to extract details
from a web service response.
This example order management extension uses methods from these interfaces to extract data from the response.
import oracle.apps.scm.doo.common.extensions.ValidationException;
import oracle.apps.scm.doo.common.extensions.Message;
// invoke the Check Check service using web service connector name 'CreditCheckService'. The connector is
set up using task 'Manage External Interface Web Service Details'. Since this is an external service that
is secured
// using message protection policy, we have registered the the https (external) URL of the service
def response = context.invokeSoapService("CreditCheckService", payLoad);
// print a debug message. This appends the entire response to the shipping instuctions attribute.
// Note: debug statements like these should be disabled in extensions on production instance as they can
cause performance issues.
debug(response.getSoapBody().getTextContent());
// The response XML sent by the Credit Check service contains an element named 'Response'. A YES value
indicates that credit check passed. Let us extract the contents of Response tag. The following XML API will
return all nodes (tags)
// with name 'Response' in a NodeList element. We are expecting only one such element in our XML response
def nodeList = response.getSoapBody().getElementsByTagNameNS("*", "Response");
// Get the first element with name 'Response' (we are expecting only one), and gets its text content
String ccResponse = nodeList.item(0).getTextContent();
debug(ccResponse);
1719
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
/**
* Appends passed in msg to the Shipping Instructions attribute. This method has been implemented only for
debugging purposes.
*/
void debug(def msg) {
String si = header.getAttribute("ShippingInstructions");
header.setAttribute("ShippingInstructions", si + ", " + msg.toString());
}
Related Topics
• Manage Connector Details Between Order Management and Your Fulfillment System
Attribute Value
For details, see the Manage Connector Details Between Order Management and Your Fulfillment System topic.
2. Go to the Manage Order Management Extensions page and create a new extension.
3. Set up the call.
1720
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
Code Description
def lines = Get the row set for the order lines.
header.getAttribute("Lines");
while( lines.hasNext() ) Determine whether more lines exist that we must process.
def line = lines.next(); Get the item number that the line specifies.
def itemNumber =
line.getAttribute("ProductNumber");
allocateSalesCredits(line); Call the method that allocates sales credits for this line.
Code Description
void Get the handle that you use to call the web service.
allocateSalesCredits(def
line, String itemNumber) {
def serviceInvoker =
context.getServiceInvoker();
def poNumber = Get the value of attribute Purchase Order Number for the customer from the order header.
header.getAttribute("CustomerPONumber");
String payLoad = Concatenate the strings so you can prepare the payload. As an option, you can also use an
"<ns1:GetSalesCreditAllocation XML API to concatenate the string.
xmlns:ns1=\"http://
www.your_company.com/
SalesCreditWS/\">" +
"<ns1:poNumber>" + poNumber
+ "</ns1:poNumber>" +
"<ns1:itemNumber>"
+ itemNumber + "</
ns1:itemNumber>" +
1721
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
Code Description
"</
ns1:GetSalesCreditAllocation>";
def responseBody = Use the interface name of the web service and the request payload to call the web service.
serviceInvoker.invokeSoapService("SalesCreditAllocationService",
payLoad).getSoapBody();
You must specify the interface name in the Connector Name attribute on the Manage External
Interface Web Service Details page. For this example, you specify SalesCreditAllocationService
as the connector name.
def salesPerson = //; Extract the salesperson name from the response payload.
def percent = // Extract the percent allocation from the response payload.
def salesCredits = Get the row set for the sales credit from the current line.
line.getAttribute("SalesCredits");
sc.setAttribute("SalesCreditTypeCode",
Set the sales credit type. In this example, assume that 1 equals Revenue credits.
1L);
salesCredits.insertRow(salesCredit);
Insert the new row in the row set.
1722
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
Code Description
boolean For brevity, this example doesn't include details about how to implement this method. The
itemOfInterest(String logic you use is specific to your business requirement.
itemNumber) {
if condition condition is code you write. It decides whether the item number is of interest.
return true;
else
return false
Complete Code
Here's the code for this example.
//get the lines row set.
def lines = header.getAttribute("Lines");
/**
* Call a web service that gets sales credit allocation for the order line.
* @param line identifies the line where you allocate sales credit.
* @param itemNumber is the number of the item that the line specifies.
*/
void allocateSalesCredits(def line, String itemNumber) {
//get a handle for the method that calls the web service.
def serviceInvoker = context.getServiceInvoker();
//get the customer attribute for the purchase order number from the order header.
def poNumber = header.getAttribute("CustomerPONumber");
1723
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
//XML APIs
"<ns1:itemNumber>" + itemNumber + "</ns1:itemNumber>" +
"</ns1:GetSalesCreditAllocation>";
def responseBody =
//use the web service name and the constructed payload to call the service.
serviceInvoker.invokeSoapService("SalesCreditAllocationService",
payLoad).getSoapBody();
//get the row set for the sales credit for the current line.
def salesCredits = line.getAttribute("SalesCredits");
//set the sales credit type. This code assumes your implementation uses the value 1 for revenue credits.
sc.setAttribute("SalesCreditTypeCode", 1L);
//set a unique identifier in case more than one SalesCredit exists. For example, 5768342869.
salesperson.setAttribute("SourceTransactionSalesCreditIdentifier',5768342869);
/**
*Return a boolean that indicates whether the item is of interest.
*/
boolean itemOfInterest(String itemNumber) {
while( lines.hasNext() ) {
def line = lines.next();
def itemNumber = line.getAttribute("ProductNumber");
if( itemOfInterest(itemNumber) ) {
allocateSalesCredits(line);
}
1724
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
}
void allocateSalesCredits(def line, String itemNumber) {
def serviceInvoker = context.getServiceInvoker();
def poNumber = header.getAttribute("CustomerPONumber");
xmlns:ns1=\"http://your.address/SalesCreditWS/\">" +
serviceInvoker.invokeSoapService("SalesCreditAllocationService",
payLoad).getSoapBody();
def salesPerson = //;
def percent = //
def salesCredits = line.getAttribute("SalesCredits");
def salesCredit = salesCredits.createRow();
sc.setAttribute("Salesperson", salesPerson);
sc.setAttribute("Percent", new BigDecimal(percent));
sc.setAttribute("SalesCreditTypeCode", 1L);
salesperson.setAttribute("SourceTransactionSalesCreditIdentifier',5768342869);
salesCredits.insertRow(salesCredit);
}
boolean itemOfInterest(String itemNumber) {
1725
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
Note.
• Use the getViewObject method.
• Most of the view objects you need are in the oracle.apps.scm path. In some cases you might need to go
outside of oracle.apps.scm. For example, use oracle.apps.prc to access purchase order data from Oracle Fusion
Purchasing.
• For example, you can use a public view object to look up an item category in Product
Information Management or a purchase order in Oracle Fusion Purchasing. This example uses
1726
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
FulfillLinePVO
Item ItemPVO
ItemCategoryPVO
Customer PartyPVO
PartySitePVO
LocationPVO
CustomerAccountSitePVO
CustomerAccountSiteUsePVO
Receivable TransactionTypePVO
1727
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
Code It
Note.
Code Description
Object getItem(Long itemId, Define a local object that your code can call. This object will contain data from the public view
Long orgId) { object.
def itemPVO = Create an instance of the public view object for the item, then store it in the itemPVO variable.
context.getViewObject("context")
Use this format.
def itemPVO =
context.getViewObject("oracle.apps.scm.productModel.items.publicView.ItemPVO")
1728
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
Code Description
where
def vc = Define the variable that will store details for the public view object.
itemPVO.createViewCriteria();
• vc. Variable that stores details for the view criteria object.
View criteria is a filter that determines the data that the public view object returns.
• itemPVO. Name of the public view object that contains the data you must get and filter.
• createViewCriteria. Method that creates the view criteria object. It defines vc as a
list that contains one or more rows.
vcrow.setAttribute("InventoryItemId",
Populate variable vcrow with data from the public view object.
itemId);
• setAttribute. Method that sets the value for the attribute in the row.
• InventoryItemId. Attribute in the public view object. This example gets the value that
uniquely identifies the item in inventory.
• itemId. Variable that the extension code defines. This code gets the value of attribute
InventoryItemId on the order line from the public view object, then stores it in itemId.
vcrow.setAttribute("OrganizationId",
Populate variable vcrow with data from the public view object.
orgId);
• setAttribute. Method that sets the value for the attribute in the row.
• OrganizationId. Attribute in the public view object. This example gets the value that
uniquely identifies the organization that ordered the item.
• orgId. Variable that the extension code defines. This code gets the value of the
OrganizationId attribute on the order header from the public view object, then stores it
in orgId.
def rowset = Get the iterator that contains the number of rows that meet the criteria and store it in local
itemPVO.findByViewCriteria(vc, variable rowset.
-1);
• rowset. Variable that stores the iterator.
• findByViewCriteria. Method that searches the public view object according to
criteria that you define.
• vc. Contains the data that the public view object returns.
• -1. Return all rows that match the view criteria.
You can also use a positive integer to get a subset of rows. For example, use vc, 3 to
get the first three rows that match the criteria. If only two rows match the criteria, then
the method returns only these two rows.
1729
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
Code Description
return item The item variable can now access all attributes in ItemPVO. return returns variable item so
you can reference item from your extension to get details from ItemPVO.
1730
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
Note.
1. Go to the Manage Customer Account Site Descriptive Flexfields page, locate the descriptive flexfield that you
must access, click Download Flexfield Archive, then examine the structure that it uses.
2. Reference the publicFlex public view object to reference the descriptive flexfield. In this example, you reference
publicFlex for custAccountSite.
1731
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
oracle.apps.cdm.foundation.parties.publicFlex.custAccountSite.view.CustAccountSiteInformationVO
3. Use the structure you examined when you downloaded the archive to help determine how to specify the view
criteria.
Here's the entire code.
def siteFlexPVO = context.getViewObject
("oracle.apps.cdm.foundation.parties.publicFlex.
custAccountSite.view.CustAccountSiteInformationVO");
def vc = siteFlexPVO.createViewCriteria();
def vcrow = vc.createViewCriteriaRow();
vc.add(vcrow);
def rowset = siteFlexPVO.findByViewCriteriaWithBindVars
(vc, -1, new String [0], new String [0]);
def custDFF = rowset.first();
String values = custDFF.getAttribute("Salesperson")
Get Data From Sales Orders That Aren't the Current Sales Order
You can use HeaderPVO to access order header data and FulfillLinePVO to access order line or fulfillment line data. For
example, if the Order Entry Specialist sets the purchase order number on a sales order, then make sure some other sales
order doesn't already use this purchase order number. Do this validation when the Order Entry Specialist submits the
sales order.
1732
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
order from version 2 of sales order x. Use a public view object to get data from a version that isn't the current
version.
Table Documentation
DOO_HEADERS_ALL https://docs.oracle.com/en/cloud/saas/supply-chain-management/20c/oedsc/distributed-
order-orchestration.html#dooheadersall-9617
DOO_LINES_ALL https://docs.oracle.com/en/cloud/saas/supply-chain-management/20c/oedsc/distributed-
order-orchestration.html#doolinesall-8298
DOO_FULFILL_LINES_ALL https://docs.oracle.com/en/cloud/saas/supply-chain-management/20c/oedsc/distributed-
order-orchestration.html#doofulfilllinesall-17668
Assume you're creating a sales order report and need to include freight charges on the report. You have a sales order
that's in Awaiting Shipping status or Awaiting Billing status. You view the order in a fulfillment view. The Your Price
column on the fulfillment line contains a value for the Sale Price attribute but the Freight attribute is empty. Its also
empty in Oracle Fusion Shipping.
You use SQL to examine the DOO_LINES_ALL table and the DOO_FULLFILL_LINES_ALL table, but no luck there either.
1733
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
You can use the documentation to identify the table and column that has the freight charge.
Try it.
Distributed Order Orchestration is an earlier name for Order Management. They mean the same thing.
3. Place your cursor at the end of the URL in the URL window, right after the text #distributed-order-
orchestration, then press CTRL+F.
4. Type in the word freight, the press ENTER.
The search returns all results starting at the beginning of the Distributed Order Orchestration chapter.
5. Click the down arrow until find what you're looking for.
1734
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
In this example, keep clicking until you see the DOO_ORDER_CHARGES link in the table of contents turn green,
and that the CHARGE_SUBTYPE_CODE column contains a relevant description.
Subtype of a given charge type. Examples could include, within Shipping Related Charges: Freight Charge,
Shipping Insurance, within Special Charges: Suspend Charge, Resumption Charge)
You might see CHARGE_SUBTYPE_CODE in other tables, such as DOO_FS_CHARGES_INT, but in most cases
you use the DOO_ORDER_CHARGES table.
6. Run an SQL to get the freight charge.
Related Topics
• Manage Connector Details Between Order Management and Your Fulfillment System
Code Description
def itemPVO = Create an instance of the public view object for the item. You must specify the entire name of
context.getViewObject("oracle.apps.scm.productModel.items.publicView.ItemPVO");
the public view object.
This code uses each public view object as a row iterator, so the methods on the RowIterator
interface are also available on each public view object. You can use the RowSetIterator method
to access a method that gets the rows that the view object query returns, and to navigate the
row set for the public view object. For details, see the ViewObject method in the Methods You
Can Use with Order Management Extensions topic.
FulfillLinePVO
Item ItemPVO
ItemCategoryPVO
1735
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
Customer PartyPVO
PartySitePVO
LocationPVO
CustomerAccountSitePVO
CustomerAccountSiteUsePVO
Receivable TransactionTypePVO
To get a complete list of the public view objects you can use, the attributes they contain, and to help determine the view
object you need, see Public View Objects in Oracle Applications Cloud (Document ID 2386411.1) on My Oracle Support.
An order management extension can create a view criteria object that adds filtering logic to the public view object
before it gets data from these objects. A view criteria object is a filter that you create and apply programmatically to a
view object. Order Management converts each of these filters into a WHERE clause when your extension runs the query
that you define in the public view object.
You use the view criteria row object to create a view criteria object. The view criteria object contains the attribute
names and attribute values that become part of the WHERE clause.
This topic includes example values. You might use different values, depending on your business requirements.
1736
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
Code Description
def lines = Get the row set for the order lines.
header.getAttribute("Lines");
def line = lines.next(); Get the next line and assign it to the variable line.
def inventoryItemId = Get the inventory item Id for the item from the order line that the Order Entry Specialist
line.getAttribute("ProductIdentifier");
selected.
def orgId = Get the organization for the item from the order line that the Order Entry Specialist selected.
line.getAttribute("InventoryOrganizationIdentifier");
def item = Get the item. Use the item Id and the organization Id to call the getItem method.
getItem(inventoryItemId,
orgId);
def packShipInstruction Get the row for the extensible flexfield context named PackShipInstruction.
= line.
getOrCreateContextRow("PackShipInstruction");
packShipInstruction.setAttribute("_ShippingInstruction",
Set the Shipping Instruction context segment.
"Hazardous Handling
Required.");
Code Description
Object getItem(Long itemId, Create an instance of the public view object for the item.
Long orgId) {
def itemPVO =
context.getViewObject("oracle.apps.
scm.productModel.items.publicView.ItemPVO");
1737
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
Code Description
vcrow.setAttribute("InventoryItemId",
Set the inventory item attribute so you can include it in the filter condition, and set the value
itemId); that you will use to compare to this attribute.
vcrow.setAttribute("OrganizationId",
Set the organization attribute so you can include it in the filter condition, and set the value
orgId); that you will use to compare to this attribute.
def rowset = Define the view criteria that filters the rows when you query the public view object.
itemPVO.findByViewCriteria(vc,
-1);
def item = rowset.first(); Get the first item row that meets the condition.
1738
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
• Use a descriptive flexfield to store the value for the Freight Term Code attribute.
• Use an order management extension to get the value of the flexfield, then set the Freight Term attribute on the
sales order.
You can get the value from the flexfield during testing. You notice that Order Management stores the value of the
Freight Term Code as a number, but you need the meaning too. The WSH_FREIGHT_CHARGE_TERMS lookup stores the
meaning.
You get the meaning, then use String vFreightTermsMeaning = lookupRow.getAttribute('Meaning'); to store it in a
string, which you can then display in an attribute on the order header or the order line.
Try it.
1. Go to the Public View Objects in Oracle Applications Cloud (Doc ID 2386411.1) article on My Oracle Support.
2. Download and open the XLS file for your release, such as Update 20A.
3. In Microsoft Excel, open the POVs and Attributes worksheet.
4. Click the Data tab, then click Filter.
5. Click the Filter icon in row 1 of Column A.
1739
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
There are over 600,000 public view objects, so you need to filter for only the ones you need.
Most of the view objects you need are in the oracle.apps.scm path. Scroll through the search results in the Filter
dialog so you can get an idea of the data you can access.
In this example you need to get a value from shipping, so enter oracle.apps.scm.shipping in the search window,
add a check mark to the Select All Search Results option, then click OK.
For other examples, you might need to search and select values that start with a different value, depending on
your requirements.
1740
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
In some cases you might need to go outside of oracle.apps.scm. For example, use oracle.apps.prc to access
purchase order data from Oracle Fusion Purchasing.
7. Search for text that likely contains the data you need.
You're looking for data in WSH_FREIGHT_CHARGE_TERMS, which is a type of lookup, so click the Filter icon in
row 1 of Column B., then enter LookupType.
8. Notice the results.
Path Attribute
oracle.apps.scm.shipping.carriers.publicView.CarrierModeOfTransportPVO
LookupType
oracle.apps.scm.shipping.carriers.publicView.CarrierServiceLevelPVO
LookupType
oracle.apps.scm.shipping.carriers.publicView.TransitTimeModeOfTransportPVO
LookupType
oracle.apps.scm.shipping.carriers.publicView.TransitTimeServiceLevelPVO
LookupType
oracle.apps.scm.shipping.common.publicView.analytics.WSHLookupsPVO
LookupType
oracle.apps.scm.shipping.common.publicView.ShippingLookupPVO
LookupType
oracle.apps.scm.shipping.shipConfirm.deliveries.publicView.SrLookupPVO
LookupType
Most of the paths reference specific kinds of data, such as mode of transport or transit time. You need the more
generic lookup, which is in oracle.apps.scm.shipping.common.publicView.ShippingLookupPVO.
9. Reference the public view object in your extension.
1741
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
vcrow.setAttribute('LookupType', 'WSH_FREIGHT_CHARGE_TERMS' );
vcrow.setAttribute('LookupCode', <CODE> );
vc.add(vcrow);
def rowset = lookupPVO.findByViewCriteriaWithBindVars(vc, -1, new String [0], new String [0]);
def lookupRow = rowset.first();
String vFreightTermsMeaning = lookupRow.getAttribute('Meaning');
where
Code Description
vcrow.setAttribute('LookupCode',Set the value of the LookupCode attribute. Replace CODE with the value of the lookup code.
<CODE> );
def rowset = Create the string where you will store the value of the meaning.
lookupPVO.findByViewCriteriaWithBindVars(vc,
-1, new String [0], new
String [0]);
def lookupRow = Get the value of the Meaning attribute, then store it in the string.
rowset.first();
String
vFreightTermsMeaning =
lookupRow.getAttribute('Meaning');
1742
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
Messages
Guidelines for Using Messages in Order Management Extensions
Use an extension to define a message.
Note.
1. messageType. Define the messageType as WARNING or ERROR. The Order Management work area uses a
different icon for each type.
1743
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
2. Lookup. Use the Manage Order Lookups page in the Setup and Maintenance work area to categorize your
messages, then reference them from your code.
Use predefined lookups or create your own. Categorizing helps the Order Entry Specialist search for messages
and view them in analytic charts.
Use Error to improve search and display because errors display in work area Order Management in attribute
Error Type.
In this example, assume you define the Meaning as Customer Relationship Mismatch.
3. Header or line. Indicate where the error occurs. Use one of these values.
◦ header. Apply the message to an error that occurs on the order header.
◦ line. Apply the message to an error that occurs on an order line.
The example in the screen print uses line. This example includes code (not visible, for brevity) above
throw new ValidationException that defines line as a variable, uses it to iterate through all the lines in the
sales order, then saves the order line number where the error occurs, such as line 3. At run time, Order
Management displays an icon on line 3 that the Order Entry Specialist can click to examine message
details.
4. Manage Messages. Use the Manage Messages page in the Setup and Maintenance work area.
1744
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
For details, see the Define Error Messages When Using Order Management Extensions topic.
1745
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
Specialist to examine all errors together, correct them, then resubmit the sales order instead of correcting x, submit,
correct y, submit, correct z, and submit.
For example.
If the revenue percentage is less than 30% for the sales credit, then the extension creates a message and stores it in
a local list. The extension processes all sales credits. If the local list contains any messages after it finishes processing
sales credits, then the extension displays them in a dialog in the Order Management work area.
Here is the code that this example uses to examine each sales credit.
Code Description
import Import the ValidationException method so your code can use it.
oracle.apps.scm.doo.common.extensions.ValidationException;
import Import the Message method so your code can use it.
oracle.apps.scm.doo.common.extensions.Message;
def salesCredits = Define a local variable named salesCredits, use the getAttribute method to get the value of the
header.getAttribute("SalesCredits");
SalesCredits attribute from the order header, then set the value of this variable to the value that
getAttribute returns.
1746
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
Code Description
getAttrbute("SalesCredits") returns an iterator you can use to access sales credits rows. For
example, the code references salesCredits later in this topic to get SalesCreditTypeCode,
Percent, and Salesperson.
The while loop Iterate through each sales credit until it finishes processing all of them.
Examine attributes SalesCreditTypeCode, Percent, and Salesperson for each sales credit.
def percent = Define a local variable named percent, use method getAttribute to get the value of attribute
salesCredit.getAttribute("Percent")
Percent from local variable salesCredit, then set this variable to the value that getAttribute
returns.
if ( percent < 30 ) If the condition is True, then create a message, and add it to the local msgs list. Messages
accumulate in the msgs list until the extension finishes processing all sales credits.
• SALESPERSON. def tokens sets the value of this token to the value that method
getAttribute gets for attribute Salesperson from local variable salesCredit.
• PERCENT. def tokens sets the value of this token to the value of variable percent
that the while loop defines.
Message msg = new Message Define a local variable named msg and add it to local array Message. msg stores each message
that the code adds to list object msgs.
1747
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
Code Description
msgs.add(msg); Add the contents of local variable msg, which contains a single message, to local list variable
msgs, which is an array that includes all messages that the code creates in this scenario.
if( !msgs.isEmpty() ) { If local list msgs isn't empty, then run method ValidationException. Display all the messages
throw new that local list msgs contains.
ValidationException(msgs);
}
Perform this check after the while loop finishes processing all sales credits.
1748
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
Note.
• Sales orders entered in the Order Management work area. The Warning dialog in work area Order
Management allows the Order Entry Specialist to examine the warning, then submit the sales order or cancel.
• Source orders imported from a source system. Order processing stops only if an error occurs. If only
warnings occur, then you can view the messages but the import submits the sales order to order fulfillment. It
doesn't allow user intervention.
1749
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
Related Topics
• Manage Connector Details Between Order Management and Your Fulfillment System
If Order Management creates a validation exception, then your extension code must send a message that describes the
cause of the failure. You must do one of.
• Add the message text to your extension. You must specify Distributed Order Orchestration as the application
for the message. Order Management will display this text in the Order Management work area without
modification.
• Add the name of an Oracle Fusion message and message parameters in your extension. Order
Management will get the message from the Oracle Fusion message repository, populate any message tokens
that the message references, display the message in the Order Management work area, then add it to the
message log. You can use the Manage Messages page to create a message. For details, see the Create
Messages in Order Management topic.
This topic frequently mentions ValidationException. For details, see the ValidationException method in the Methods You
Can Use with Order Management Extensions topic.
Code Description
def salesCredits = Get the row set for the sales credits that the order header references.
header.getAttribute("SalesCredits");
if( "1".equals(salesCredit.getAttribute("SalesCreditTypeCode")) )
Determine whether the sales credit is a revenue percent.
if( percent < 30 ) { If percent is less than 30, then create a validation error.
1750
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
Code Description
throw new Create the exception, and then stop the execution.
ValidationException("SALES_CREDIT_TOO_LOW_MSG",
tokens);
Here's a variation that creates a validation exception that hard codes the message text. You replace def tokens and throw
new with this code.
String messageText = "The " + percent + "% sales credit for salesperson " + salesperson + " is less than the
required minimum, which is 30%.";
throw new ValidationException(messageText);
For example, if percent equals 20, and if salesperson equals Diane Cho, then here's the text that displays at run time.
The 20% sales credit for salesperson Diane Cho is less than the required minimum, which is 30%.
Here's a variation that creates a validation exception that references a request function that you define instead of the
default function that comes predefined with Order Management. You replace def tokens and throw new with this code.
def tokens = [SALESPERSON: salesCredit.getAttribute("Salesperson"), PERCENT: percent];
throw new ValidationException("ORA_CUSTOM_REQ_FUNCTION", "SALES_CREDIT_TOO_LOW_MSG", tokens);
An extension can create one or more instances of a Message object before calling ValidationException. Use this
capability to report all sales credit rows that fail the requirement, and to control how you code your extension.
Here's an example that uses the Message object and provides detailed error reporting. It reports all sales credit rows
that fail validation.
1751
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
Code Description
import Import the ValidationException class so you can construct a ValidationMessage object.
oracle.apps.scm.doo.common.extensions.ValidationException;
import Import the Message class so you can construct a Message object.
oracle.apps.scm.doo.common.extensions.Message;
def salesCredits = Get the row set for the sales credits that the order header references.
header.getAttribute("SalesCredits");
List<Message> msgs = new Determine whether more sales credit rows exist that we must process.
ArrayList<Message>();
while( salesCredits.hasNext() )
if( "1".equals(salesCredit.getAttribute("SalesCreditTypeCode")) )
Determine whether the sales credit is a revenue percent.
{
if( percent < 30 ) { If percent is less than 30, then create a validation error.
if( !msgs.isEmpty() ) { If the msgs list isn't empty, then at least one sales credit row is in error.
1752
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
while( salesCredits.hasNext() ) {
def salesCredit = salesCredits.next();
if( "1".equals(salesCredit.getAttribute("SalesCreditTypeCode")) ) {
def percent = salesCredit.getAttribute("Percent");
if( percent < 30 ) {
def tokens = [SALESPERSON: salesCredit.getAttribute("Salesperson"), PERCENT: percent];
Message msg = new Message(Message.MessageType.ERROR, "SALES_CREDIT_TOO_LOW_MSG", tokens);
msgs.add(msg);
}
}
}
if( !msgs.isEmpty() ) {
throw new ValidationException(msgs);
}
For details about how to set log levels, see java.util.logging.Level on the Java Platform, Standard Edition 7 API
Specification website at https://docs.oracle.com/javase/7/docs/api/java/util/logging/Level.html.
This topic includes example values. You might use different values, depending on your business requirements.
Code Description
def logger = Get the logger object from the context. The first few lines have been left out of the example.
context.getLogger();
def item = Get the item. Use item Id and organization Id when calling the getItem method.
getItem(inventoryItemId,
orgId);
1753
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
Code Description
logger.logFinest("Found Log at the finest level. Note that the string format provides the first argument and the
line with hazardous item subsequent arguments provide the parameters.
%s, %s", inventoryItemId,
orgId);
def packShipInstruction Get the row for the extensible flexfield context named PackShipInstruction.
= line.
getOrCreateContextRow("PackShipInstruction");
packShipInstruction.setAttribute("_ShippingInstruction",
Set the context segment for Shipping Instruction.
"Hazardous Handling
Required.");
Code Description
Object getItem(Long itemId, Create an instance of a public view object named Item. Specify to log at the FINER level.
Long orgId, def logger) {
logger.logFiner("Entering
method getItem");
def itemPVO =
context.getViewObject("oracle.apps.scm.productModel.items.publicView.ItemPVO");
vcrow.setAttribute("InventoryItemId",
Set the inventory item attribute to include in the filter condition and the value to use when
itemId); comparing against this attribute.
vcrow.setAttribute("OrganizationId",
Set the organization attribute to include in the filter condition and the value to use when
orgId); comparing against this attribute.
def rowset = Specify the view criteria to filter rows and query the view object.
itemPVO.findByViewCriteria(vc,
-1);
def item = rowset.first(); Get the first item row that matches the condition.
1754
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
Code Description
Examples
Use Extensions to Update the Order Submit Date
Create an extension that uses an extensible flexfield to update the order submit date.
This topic includes example values. You might use different values, depending on your business requirements.
Attribute Value
Name H1AttributeDateTime1
Context HeaderContext1
1755
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
For details about how to create an extensible flexfield, see the Set Up Extensible Flexfields in Order
Management topic.
2. In the Setup and Maintenance work area, go to the task.
The Use Existing option creates a reference to an extension that already exists. It doesn't create a copy. For
example, assume an extension named My_Extension already exists on the On Save extension point. Assume
you set Use Existing to My_Extension when you create an extension on the On Start of Submission Request
extension point. If you modify My_Extension from On Start of Submission Request at any point in the future,
then Order Management will automatically update My_Extension for On Save with your modification. If
you modify My_Extension for On Save, then Order Management will update My_Extension for On Start of
Submission Request.
6. On the Create Extension page, on the On Start of Submission Request tab, enter values.
Attribute Value
Description This extension sets the value of an extensible flexfield to the date and time when Order
Management submitted the sales order.
// Make sure the extension runs only for your test sales order. If multiple developers use your test
environment, then this condition makes sure the code updates only your sales order. You must remove
this condition in a production environment.
def poNumber = header.getAttribute("CustomerPONumber");
if( !"UpdateOrderSubmissionDate".equals(poNumber) ) return;
// Get the current time, and then create an instance of java.sql.Date, and set it to the current time.
long currentTime = new Date().getTime();
def date = new java.sql.Date(currentTime);
// Set the date on the attribute named _H1AttributeDateTime1 to the current date. Use flexfieldContext
to identify the flexfield context where _H1AttributeDateTime1 resides, which is HeaderContext1.
flexfieldContext.setAttribute("_H1AttributeDateTime1", date);
1756
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
Attribute Value
Attribute Value
04/01/17 6:25 PM
This topic includes example values. You might use different values, depending on your business requirements.
1. In the Setup and Maintenance work area, go to the task.
◦ Offering: Order Management
◦ Functional Area: Orders
◦ Task: Manage Order Management Extensions
2. On the Manage Order Management Extensions page, on the On Start of Submission Request tab, create a new
extension.
Attribute Value
Description Make sure a relationship exists between the sold-to customer and the ship-to customer, and
between the sold-to customer and the bill-to customer. If one of these relationships doesn't
exist, then create an error and stop the sales order from proceeding.
1757
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
import oracle.apps.scm.doo.common.extensions.ValidationException;
import oracle.apps.scom.doo.comm.extensions.Message;
// Make sure the extension runs only for your test sales order. If multiple developers use your test
environment, then this condition makes sure the code updates only your sales order. You must remove
this condition in a production environment.
def poNumber = header.getAttribute("CustomerPONumber" );
if(poNumber == null) return;
if( !poNumber.startsWith("MatchRelationship") ) return;
boolean relationExists=false;
//if the relationship exists, then further validation is not necessary, so save the sales order, and
then exit.
if (header.getAttribute("BuyingPartyName")==header.getAttribute("BillToCustomerName"))
relationExists=true;
//determine what relationship currently exists between the bill-to customer and the sold-to customer.
//reference the view object that stores the relationship. In this example, the
CustomerAccountRelationship view object stores this relationship.
def CustPVO =
context.getViewObject("oracle.apps.cdm.foundation.parties.publicView.customerAccounts.CustomerAccountRelationshi
//Read through the row set. If a row exists that contains a relationship, then you have determined that
a relationship exists between sold-to and bill-to, so save the sales order, and then exit.
while (rowSet.hasNext()) {
def row = rowSet.next();
def billtorelation=row.getAttribute("CustAccountId")
if (billtorelation == billTo)
{
relationExists=true;
}
}
//Create an exception when a relationship does not exist and display an error message.
//header.setAttribute("ShippingInstructions", header.getAttribute("ShippingInstructions") + ", "
relationExists)
if( !relationExists) {
throw new ValidationException("The order submit failed because the bill-to customer is not related to
the sold-to customer.");
}
This example is only for demonstration purposes in a development environment. It hard codes the message
to display in the Order Management work area in the English language as The order submit failed because
the bill-to customer is not related to the sold-to customer. To avoid problems with translation to other
languages, don't code the message in a production environment.
Instead, here's some code you can use to reference a message from the messaging framework.
1758
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
where
◦ lookup_code determines where and how to display the message in the Order Management work area.
For example, you can reference more than one lookup code to display messages in different pie slices on
the infolets in the Order Management work area, according to lookup code.
◦ message name identifies the name of the message that exists in the messaging framework.
◦ token_values specifies a list of the values to use in the tokens that the message contains. If the message
doesn't contain any tokens, then use null.
For example, here's some code that displays the contents of the FOM_CMN_INV_BILL_TO message.
For details about using lookup_code, see the ValidationException method in the Methods You Can Use with
Order Management Extensions topic.
Attribute Value
2. Verify that the error dialog displays the message you coded.
Computer Service and Rentals is the sold-to customer, Business World Inc is the bill-to customer, they don't
match, so Order Management displays an error.
3. Set the value, then click Submit.
Attribute Value
4. Verify that Order Management submits the sales order and sets the status to Processing.
Computer Service and Rentals is the sold-to customer and the bill-to customer, they match, so Order
Management processes the sales order.
1759
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
It calls a public view object to get data from Oracle Fusion Procurement.
For demonstration purposes, this example hard codes some values, such as HW INTERNAL. Your environment will likely
require different variable values.
This topic includes example values. You might use different values, depending on your business requirements.
Attribute Value
Description Determine whether a purchase order exists for the purchase order number that the Order
Entry Specialist enters in the Purchase Order attribute.
//Import classes for validation exceptions and messages from Oracle Trading Community Architecture.
import oracle.apps.scm.doo.common.extensions.ValidationException;
//If a matching row does not exist, then the purchase order that the user entered does not exist. Create
a validation error and stop the sales order submit.
if( !poExists ) {
throw new ValidationException("ORA_MANAGE_EXTENSIONS", "DOO_EXT_HW_INTERNAL_PO_REQD", null);
1760
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
}
}
This topic includes example values. You might use different values, depending on your business requirements.
1. Create the extensible flexfield.
◦ Add it to the Fulfillment Line Information flexfield. Use these values.
Attribute Value
Name CancelLine
Context ProductObsoleteContext
Attribute Value
Name CancelLine
Code CancelLine
1761
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
For details about how to create an extensible flexfield, see the Set Up Extensible Flexfields in Order
Management topic.
2. Create your extension.
Attribute Value
Description This extension examines the value of an extensible flexfield on an order line to
determine whether to cancel the line.
import oracle.apps.scm.doo.common.extensions.ValidationException;
if(lines == null)
return;
while(lines.hasNext()){
if(context == null)
throw new ValidationException("Context ProductObsoleteContext was null");
if("Y".equals(cancelLineEffVal)){
line.setAttribute("OrderedQuantity",0);
}
1762
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
◦ Go to the Order Management work area and create a new sales order.
Attribute Value
Attribute Value
1763
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
// Go through all the order lines. We're interested in return lines. As soon as we find a return line, we
will use the document
// reference on the line to try to locate the original order.
def lines=header.getAttribute(""Lines"");
while (lines.hasNext()) {
def line=lines.next();
// Get the line type specified on the line. A line type code of ORA_RETURN means its a return line.
String lineTypeCode=line.getAttribute(""TransactionLineTypeCode"");
if (""ORA_RETURN""==lineTypeCode) {
// We have a return line. Now let's find the original order.
// We will go through the document references on this line to locate the document reference
// that identifies the original order.
def docRefs=line.getAttribute(""DocumentReferences"");
while (docRefs.hasNext()) {
def docRef=docRefs.next();
String docRefType=docRef.getAttribute(""DocumentReferenceType"");
if (""ORIGINAL_ORCHESTRATION_ORDER""==docRefType) {
// We found the document reference that points to the original order.
// The DocumentIdentifier attribute is the header id of the original order.
Long headerId=new Long(docRef.getAttribute(""DocumentIdentifier""));
// Call the getOrderType method to get the order type of the original order using a PVO
String orderTypeCode=getOrderType(headerId);
// If order type isn't null, set it on the current order, else raise a validation exception.
if (orderTypeCode !=null) {
header.setAttribute(""TransactionTypeCode"", orderTypeCode);
break;
}
else {
throw new ValidationException(""Order type isn't specified on the original order."");
}
}
}
}
}
/**
* Returns the order type of the indicated order.
*/
String getOrderType(Long headerId) {
debug(""finding order by headerId: ""+ headerId);
def vo=context.getViewObject(""oracle.apps.scm.doo.publicView.analytics.HeaderPVO"");
1764
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
return originalHeader.getAttribute(""OrderTypeCode"");
}
if ("ORIGINAL_ORCHESTRATION_ORDER" == docRefType) {
// We found the document reference that points to the original order.
// The DocumentSubLineIdentifier attribute is the fulfillline id of the original order fulfillment line.
lineId = new Long(docRef.getAttribute("DocumentSubLineIdentifier"));
if (headerId == 0) {
// The DocumentIdentifier attribute is the header id of the original order header.
headerId = new Long(docRef.getAttribute("DocumentIdentifier"));
}
}
}
if (lineId != 0) {
// throw new ValidationException(lineId.toString());
def oLine = getLine(lineId);
1765
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
}
}
def Object getLine(Long lineId) {
def vo = context.getViewObject("oracle.apps.scm.doo.publicView.analytics.FulfillLinePVO");
Object[] rows = vo.findByKey(lineId, 1);
def originalFLine = rows[0];
return originalFLine;
}
1766
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
import oracle.apps.scm.doo.common.extensions.ValidationException;
import oracle.apps.scm.doo.common.extensions.Message;
//Case statement which tests order type and calls function to get billing transaction type
switch (orderTypeCode) {
case ["AUTO RETURN - SHIP", "AUTO RETURN - SHIP", "AUTO RETURN - MXT SHIP", "Mosoi_test"]:
billingTxnTypeId = getBillingTxnTypeId("MOTO_INVOICE");
//msg = new Message(Message.MessageType.WARNING, "First Case " + billingTxnTypeId );
break;
case ["UnreferencedRMA"]:
billingTxnTypeId = getBillingTxnTypeId("Invoice");
//msg = new Message(Message.MessageType.WARNING, "Second Case " + billingTxnTypeId );
break;
default:
billingTxnTypeId = null;
//msg = new Message(Message.MessageType.WARNING, "Default " + billingTxnTypeId );
break;
}
//Only return Billing Transaction Type for the - Common Set - to be changed as required
vcrow.setAttribute("Name", billingTxnTypeName);
vcrow.setAttribute("SetName", "Common Set");
1767
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
return txnTypeId;
}
List < Message > messages = new ArrayList < Message > ();
//messages.add(new Message( Message.MessageType.ERROR, "HeaderId: " + header.getAttribute("HeaderId")));
1768
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
import oracle.apps.scm.doo.common.extensions.Message;
import oracle.apps.scm.doo.common.extensions.Attachment;
import oracle.jbo.domain.BlobDomain;
Set an attribute to the current date and time. Use an extensible flexfield on the order header.
import oracle.apps.scm.doo.common.extensions.ValidationException;
def poNumber = header.getAttribute("CustomerPONumber");
//throw new ValidationException("An order with the Purchase Order Number " + poNumber + " already exists.");
//throw new ValidationException("An order with the Purchase Order Number " + now + " already exists.");
def complianceDetails = header.getOrCreateContextRow("ComplianceDetails");
complianceDetails.setAttribute("compliancedatetime", now);
If the HazardousMaterialFlag attribute equals Y, then set value for attributes that use extensible flexfields on the order
header and order lines.
import oracle.apps.scm.doo.common.extensions.ValidationException;
def poNumber = header.getAttribute("CustomerPONumber");
if (!poNumber.startsWith("SetEFFAttributeOnSave")) return;
1769
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
if ("Y".equals(hazardous)) {
//get tow for fulfill line context PackShipInstruction
def packShipInstruction = line.getOrCreateContextRow("PackShipInstruction");
packShipInstruction.setAttribute("shippinginstruction", "Hazardous Handling Required.");
}
}
return item;
Set the default value to use for the payment term on the order header.
import oracle.apps.scm.doo.common.extensions.ValidationException;
import oracle.apps.scm.doo.common.extensions.Message;
List < Message > messages = new ArrayList < Message > ();
def logger = context.getLogger();
def HeaderPayTerm = header.getAttribute("PaymentTerm");
def PName = header.getAttribute("BillToCustomerName");
def AId = header.getAttribute("BillToCustomerIdentifier");
1770
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
//A test should be created for each Business Unit SET ID Assignment Set combination using the following SQL:
//SELECT haotl.NAME ,
//haotl.organization_id,
//fsa.SET_ID
//FROM fusion.FND_SETID_ASSIGNMENTS fsa,
//fusion.HR_ORGANIZATION_UNITS_F_TL haotl
//WHERE reference_group_name LIKE 'HZ_CUSTOMER_ACCOUNT_SITE'
//AND determinant_value = haotl.organization_id
//AND haotl.NAME LIKE '&Business_Unit_Name%'
//AND haotl.LANGUAGE = USERENV('LANG')
//
if (300000017871360. equals(VARBusinessUnitIdentifier)) {
VARBusinesseUnitSetId = 300000000002582;
}
1771
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
if ((VARBusinesseUnitSetId).equals(RETShipToSetId)) {} else {
//The validation error below can be amended to match your business requirements. The example provided shows
information on the SET IDs returned
Throw new ValidationException("BU Set Id does not match Customer Ship to SET ID - BU Set ID is " +
VARBusinesseUnitSetId + " Ship to Set ID is :" + RETShipToSetId)
}
Prevent Order Management from creating a duplicate of the purchase order number on the order header.
import oracle.apps.scm.doo.common.extensions.ValidationException;
//get the Customer PO Number, order number and the buying party id from the order header of the order being
saved
String customerPONumber = header.getAttribute("CustomerPONumber");
String buyingPartyIdentifier = header.getAttribute("BuyingPartyIdentifier");
String OrderNumber = header.getAttribute("OrderNumber");
//Find one row using the specified view criteria. Even if we find one row, we know that we already have an
order with the same PO Number and Bill to Site ID
def rowset = vo.findByViewCriteria(vc, 1);
if (rowset.hasNext()) {
//An Order has been found for the Bill to Site and the order number entered
//Now test to check if the order currently worked on has been previously save or if this is a revision
def vcSameOrder = vo.createViewCriteria();
def vcSameOrderrow = vc.createViewCriteriaRow();
vcSameOrderrow.setAttribute("CustomerPoNumber", customerPONumber);
vcSameOrderrow.setAttribute("SoldToPartyId", buyingPartyIdentifier);
vcSameOrderrow.setAttribute("OrderNumber", OrderNumber);
vcSameOrder.add(vcSameOrderrow);
def rowsetSameOrder = vo.findByViewCriteria(vcSameOrder, 1);
if (rowsetSameOrder.hasNext()) {
//An Order has been found. this has the same order number and PO number as the order being worked on. this
is a valid case. The order found is a revision or a previously saved order.
header.setAttribute("CustomerPONumber", customerPONumber);
} else
//The order found is for a different order number
//Set the customerPO number to the upper case value
1772
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
{
throw new ValidationException("An order with the Purchase Order Number for this Customer already exists " +
customerPONumber + " already Exists");
}
} else
//No Order found for the bill to site id an po Number - the order can be saved
//Set the customerPO number to the upper case value
{
header.setAttribute("CustomerPONumber", customerPONumber);
}
1. Set the Fulfillment Organization and Shipping Instructions on the Order Line
If the item is shippable, then set the fulfillment organization for the order line and shipping instructions on the line to
the default shipping organization that the item references.
import oracle.apps.scm.doo.common.extensions.ValidationException;
import oracle.apps.scm.doo.common.extensions.Message;
if (!poNumber.startsWith("DefaultShippingOrg")) return;
if ("Y".equals(shippable)) {
Long defaultOrgId = item.getAttribute("DefaultShippingOrg");
//msg = new Message(Message.MessageType.WARNING, "default: " + inventoryItemId + " - " + orgId + " - " +
shippable+ " - " + defaultOrgId);
//throw new ValidationException(msg);
line.setAttribute("FulfillmentOrganizationIdentifier", defaultOrgId);
line.setAttribute("FulfillmentOrganizationIdentifier", 1234);
line.setAttribute("ShippingInstructions", "Ship From Org :" + 999);
}
}
1773
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
vcrow.setAttribute("InventoryItemId", itemId);
vcrow.setAttribute("OrganizationId", orgId);
vc.add(vcrow);
return item;
If the item is hazardous, then set the packing instructions on the order line.
def poNumber = header.getAttribute("CustomerPONumber");
if (!poNumber.startsWith("HazardousMaterial")) return;
if ("Y".equals(hazardous)) {
//get row for fulfill line context PackShipInstruction
line.setAttribute("PackingInstructions", "Hazardous Handling Required.");
}
}
return item;
List < Message > messages = new ArrayList < Message > ();
//messages.add(new Message( Message.MessageType.ERROR, "HeaderId: " + header.getAttribute("HeaderId")));
def lines = header.getAttribute("Lines");
1774
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
while (lines.hasNext()) {
line.createAttachment(newAttachment1);
}
/*delete all header attachments
//messages.add(new Message( Message.MessageType.ERROR, "Delete all header attachments"));
def attachments1 = header.getAttachments();
for (int i; i< attachments1.size(); ++i) {
def attachment1 = attachments1[i];
//header.deleteAttachment(attachment1);
}*/
List < Message > messages = new ArrayList < Message > ();
//messages.add(new Message( Message.MessageType.ERROR, "HeaderId: " + header.getAttribute("HeaderId")));
def lines = header.getAttribute("Lines");
while (lines.hasNext()) {
1775
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
Use the server time to determine whether fulfillment can ship the item according to the order entry date. If it doesn't,
display a warning.
import oracle.apps.scm.doo.common.extensions.ValidationException;
import oracle.apps.scm.doo.common.extensions.Message;
//If cusomer is not PMC - Snow Enterprise then we do not want to check for the order date
if( customer != "PMC - Snow Enterprise" ) return;
//Initialize the variable indicating that the order is past cut off time to false
boolean orderAfterCutOffTime = false;
//Initialize calendar object. By default calendar has the current system time. We want to setup the calendar
to be in Eastern Stardard Time
Calendar now = new GregorianCalendar(TimeZone.getTimeZone("EST"));
//The following commented out code line is just for debugging purposes. It prints out the customer, and hour
of day values in the shipping instructions attribute which is visible in the UI.
//This is an easy way to inspect variable values and debug code
header.setAttribute("ShippingInstructions", customer + ", " + now.get(Calendar.HOUR_OF_DAY) + ", " +
now.get(Calendar.MINUTE));
CutOffHour = 10
CurrentHour = now.get(Calendar.HOUR_OF_DAY)
//We will iterate through the lines in the order to check if any of the lines has ship from organization set
to "Vision Operations". In order to save CPU cycles, we run this code
//to iterate through lines only if the order is past the cut-off time
if( orderAfterCutOffTime ) {
//get the lines iterator
count = 0
1776
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
Copy extensible flexfield data from the original order to a return order that includes a return material authorization.
import oracle.apps.scm.doo.common.extensions.ValidationException;
import oracle.apps.scm.doo.common.extensions.Message;
import java.util.logging.Level;
//Following lines are for applying this extension only to specific cases
String poNumber = header.getAttribute("CustomerPONumber");
if (poNumber == null) return;
if (poNumber != "PMC TEST") return;
Long lineId = 0;
Long headerId = 0;
//get the category code specified on the line. A category code of RETURN means it is a return line
String categoryCode = line.getAttribute("TransactionCategoryCode");
//we have a return line. Now let's find the original line
//we will go through the document references on this line to locate the document reference
//that identifies the original order line.
if (headerId == 0) {
//The DocumentIdentifier attribute is the header id of the original order header
headerId = new Long(docRef.getAttribute("DocumentIdentifier"));
}
}
}
/*
1777
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
if (lineId != 0) {
if (headerId != 0) {
//get to the first row of the context for the original header
def contextRow = context.first();
//Define the context variable that you want to copy value to - header is the header of the return oorder
which is currently being worked on
def complianceDetails = header.getOrCreateContextRow("PMC Pricing");
complianceDetails.setAttribute("partyid", complInfo);
/* The following SQL will be useful in identifying the correct values to set
select
fdsb.context_code
,fdsb.segment_code
,fdsb.SEGMENT_IDENTIFIER
from
fnd_df_segments_tl fdst,
fnd_df_segments_b fdsb
where
fdst.APPLICATION_ID = fdsb.APPLICATION_ID and
fdst.ENTERPRISE_ID = fdsb.ENTERPRISE_ID and
1778
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
*/
}
}
def vo = context.getViewObject("oracle.apps.scm.doo.publicView.analytics.FulfillLinePVO");
return originalFLine;
}
List < Message > messages = new ArrayList < Message > ();
messages.add(new Message(Message.MessageType.ERROR, "HeaderId: " + header.getAttribute("HeaderId")));
messages.add(new Message(Message.MessageType.ERROR, "Pre-submit"));
1779
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
1780
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
if (!"TestTIAOnSave_run_extension".equals(header.getAttribute("CustomerPONumber"))) return;
List < Message > messages = new ArrayList < Message > ();
/*messages.add(new Message( Message.MessageType.ERROR, "Enter TIA On Save"));
messages.add(new Message( Message.MessageType.ERROR, "CustomerPONumber: " + poNumber));
messages.add(new Message( Message.MessageType.ERROR, "HeaderId: " + headerId));*/
1781
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
//tia.setAttribute("CharacterValue", "Purple");
//messages.add(new Message( Message.MessageType.ERROR, "After setting CharacterValue to Purple,
CharacterValue: " + tia.getAttribute("CharacterValue")));
1782
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
if (!"OrderTaxDetails_run_extension".equals(header.getAttribute("CustomerPONumber"))) return;
List < Message > messages = new ArrayList < Message > ();
1783
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
import oracle.apps.scm.doo.common.extensions.Message;
import oracle.apps.scm.doo.common.extensions.Person;
List < Message > messages = new ArrayList < Message > ();
//Test DOO:::DOO_CX_ATTRIB_NO_DATA
//Expected message: A value could not be assigned to attribute {ATTRIBUTE}, while running extension
{EXTENSION}, during event {EVENT}, because no data was found.
//Acutally got: An error occurred when running extension UnexpectedExceptionOnSave,
during event On Save: oracle.jbo.JboException: JBO-29000: Unexpected exception caught:
oracle.apps.scm.doo.common.extensions.NoDataFoundException, msg=No data was found using the provided
parameters.
def person = new Person("First Name", "Last Name");
header.setBillToAccount(person);
//}
If your billing application already authorized payment, then run this extension to prevent the user from editing payment
attributes when revising a sales order. Run it on the On End of Submission Request extension point.
import oracle.apps.scm.doo.common.extensions.ValidationException;
import oracle.apps.scm.doo.common.extensions.Message;
1784
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
if (!"PreAuthExtension".equals(header.getAttribute("CustomerPONumber"))) return;
String messageText = "The request to revise the sales order failed because the billing application already
authorizedpayment for the order. ";
List < Message > messages = new ArrayList < Message > ();
if (paymentRows.hasNext()) {
def paymentRow = paymentRows.next();
isPreAuth = ("Y".equals(paymentRow.getAttribute("AuthorizedInSourceFlag")));
}
if (isPreAuth) {
//Check OrderTotal
if(null != header.getAttribute("ReferenceHeaderId")) {
def origTotal = getPayNowTotalByHeaderId(header.getAttribute("ReferenceHeaderId"));
def newTotal = getPayNowTotalByHeaderRow(header);
if(newTotal > origTotal ) {
messages.add(new Message(Message.MessageType.ERROR, messageText + "The total for the sales total is greater
than the original order. The original total is :" + origTotal));
ValidationException ex = new ValidationException(messages);
throw ex;
}
}
def lines = header.getAttribute("Lines");
while (lines.hasNext()) {
def line = lines.next();
def refFulfillLineId = line.getAttribute("ReferenceFulfillmentLineIdentifier");
if (line.getAttribute("ModifiedFlag").equals("Y")) {
//Line is modified - compare the bill to with that of the base row.
def refLine = getRefLine(refFulfillLineId);
if (null != refLine && !
refLine.getAttribute("FulfillLineBillToCustomerId").equals(line.getAttribute("BillToCustomerIdentifier"))
||
!
refLine.getAttribute("FulfillLineBillToSiteUseId").equals(line.getAttribute("BillToAccountSiteUseIdentifier")))
{
messages.add(new Message(Message.MessageType.ERROR, "You can't modify billing details for source
transaction SourceTransactionLineNumber " + line.getAttribute("SourceTransactionLineNumber")". Discard
your revision, create a new one, don't modify any attributes on the Billing and Payment Details tab, don't
modify bill-to details on the order line, then submit your sales order."));
ValidationException ex = new ValidationException(messages);
throw ex;
}
}
}
}
1785
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
Many of these examples test a value for the purchase order number on the order header. This test isolates the extension
and prevents it from affecting other developers who might also be running test code. For details about this technique,
see the Guidelines for Creating Extensions That Modify Order Management topic.
Some snippets include methods that you can use with an extensible flexfield, such as getOrCreateContextRow. For
details about them, see the Guidelines for Setting Up Extensible Flexfields in Order Management topic.
Order Headers
Use an order management extension to manage order headers.
• Get Pricing Details for Order Header
• Get Attachments from Order Headers
• Prevent Order Management from Deleting the Order Header
• Validate Sales Credits for Salesperson from Order Header
1786
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
List < Message > messages = new ArrayList < Message > ();
List < Message > messages = new ArrayList < Message > ();
//messages.add(new Message( Message.MessageType.ERROR, "HeaderId: " + header.getAttribute("HeaderId")));
1787
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
Get the sales credit percent, then validate that Order Management allocates a percent greater than x to each
salesperson.
import oracle.apps.scm.doo.common.extensions.ValidationException;
def salesCredits = header.getAttribute("SalesCredits"); //Get the row set for sales credits that are
specified on the order header.
while (salesCredits.hasNext()) {
def salesCredit = salesCredits.next();
if ("1".equals(salesCredit.getAttribute("SalesCreditTypeCode"))) {
//we are dealing with revenue percent
def percent = salesCredit.getAttribute("Percent");
Order Lines
Use an order management extension to manage order lines.
• Get Manual Price Adjustments from Order Lines
• Get Fulfillment Line Attributes
• Get Attachments from Order Lines
• Prevent Updates on Order Lines
• Prevent Updates on Order Lines That Are on Backorder
• Skip Order Lines That Are Fulfilled, Closed, or Canceled
• Update the ModifiedFlag Attribute for Closed Order Lines
• Manipulate Dates on Order Lines
• Remove the System Date from the Contract Start Date on the Order Line
1788
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
• Set the Default Value for the Unit of Measure on the Order Line
• Get the Rate for a Unit of Measure
List < Message > messages = new ArrayList < Message > ();
while (MPAS.hasNext()) {
def mpa = MPAS.next();
messages.add(new Message(Message.MessageType.ERROR, "AdjustmentElementBasis is " +
mpa.getAttribute("AdjustmentElementBasis")));
messages.add(new Message(Message.MessageType.ERROR, "AdjustmentTypeCode is " +
mpa.getAttribute("AdjustmentTypeCode")));
messages.add(new Message(Message.MessageType.ERROR, "ChargeDefinitionCode is " +
mpa.getAttribute("ChargeDefinitionCode")));
messages.add(new Message(Message.MessageType.ERROR, "ChargeRollupFlag is " +
mpa.getAttribute("ChargeRollupFlag")));
}
}
1789
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
List < Message > messages = new ArrayList < Message > ();
1790
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
List < Message > messages = new ArrayList < Message > ();
//messages.add(new Message( Message.MessageType.ERROR, "Enter Attachment On Save"));
//messages.add(new Message( Message.MessageType.ERROR, "CustomerPONumber: " + poNumber));
Long headerId = header.getAttribute("HeaderId");
messages.add(new Message(Message.MessageType.ERROR, "HeaderId: " + headerId));
while (lines.hasNext()) {
1791
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
Prevent Order Management from updating order lines that it has fulfilled, canceled, closed, backordered, or split. This
extension doesn't prevent updates to lines that Order Management has canceled.
import oracle.apps.scm.doo.common.extensions.ValidationException;
import oracle.apps.scm.doo.common.extensions.Message;
/*
def poNumber = header.getAttribute("OrderNumber");
if (poNumber == null || !poNumber.equals("520956"))
return;
*/
def reference = header.getAttribute("ReferenceHeaderId");
if(reference != null){
def lines = header.getAttribute("Lines");
if (!lines.hasNext()){
throw new ValidationException("We need more time to process the order.");
}
rowset1.reset();
while (rowset1.hasNext()) {
if (splitFlinesSet == null) {
splitFlinesSet = new TreeSet<Long>();
}
def line1 = rowset1.next();
splitFlinesSet.add(line1.getAttribute("FulfillLineId"));
}
if (splitFlinesSet == null) {
return;
}
while (lines.hasNext()) {
def line = lines.next();
Long fLineId = line.getAttribute("FulfillmentLineIdentifier");
if (!(splitFlinesSet.contains(fLineId))) {
continue;
}
if('Y'.equals(line.getAttribute("ModifiedFlag")) &&
line.getAttribute("ReferenceFulfillmentLineIdentifier") != null && !(0 ==
line.getAttribute("OrderedQuantity")) ){
1792
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
if (orderType.equals("DOMESTIC")) {
BillingTransactionTypeId_New = 300000034980382;
}
if (orderType.equals("EXPORT")) {
BillingTransactionTypeId_New = 300000034980386;
}
if (orderType.equals("DOMESTICPPD")) {
BillingTransactionTypeId_New = 300000039619347;
}
if (orderType.equals("CONSIGN")) {
BillingTransactionTypeId_New = 300000034980380;
}
if (orderType.equals("EXPORTC")) {
BillingTransactionTypeId_New = 300000034988180;
}
if (orderType.equals("EXPORTD")) {
BillingTransactionTypeId_New = 300000034988182;
}
if (orderType.equals("EXPORTF")) {
BillingTransactionTypeId_New = 300000034989759;
}
if (orderType.equals("HWIPARTNER")) {
BillingTransactionTypeId_New = 300000084209774;
}
if (orderType.equals("HWIPARTNERC")) {
BillingTransactionTypeId_New = 300000036925861;
}
if (orderType.equals("HWIPARTNERD")) {
BillingTransactionTypeId_New = 300000036925863;
}
if (orderType.equals("HWIPARTNERF")) {
BillingTransactionTypeId_New = 300000036925870;
}
1793
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
if (orderType.equals("RETURN")) {
BillingTransactionTypeId_New = 300000034980378;
}
if (orderType.equals("VAS")) {
BillingTransactionTypeId_New = 300000034980370;
}
if (BillingTransactionTypeId_Current != BillingTransactionTypeId_New) {
line.setAttribute("BillingTransactionTypeIdentifier", BillingTransactionTypeId_New);
}
}//Condition skipping lines of particular status codes
}//Back order line check condition
}
/*Method that determines whether the line is shipped or backordered. If the line shipped, the method returns
true. If the line is backordered, the method returns false.
*/
def readFlineStatus(Long lineId) {
if (!lines.hasNext()) {
throw new ValidationException("In readFlineStatus failing to read lines");
}
while (lines.hasNext()) {
if (lineId.equals(eachLineId)) {
while (flineDetails.hasNext()) {
def eachFlineDetails = flineDetails.next();
def status = eachFlineDetails.getAttribute("Status");
if ("BACKORDERED".equals(status) || "SHIPPED".equals(status)) {
return false;
}
}
}
}
return true;
}
Skip Order Lines According to Status and Set the Requested Ship Date
Skip order lines that are in Fulfilled, Closed, or Canceled status, and set the Requested Ship Date on the order line to the
same value that the RequestShipDate attribute contains on the order header.
import oracle.apps.scm.doo.common.extensions.ValidationException;
import oracle.apps.scm.doo.common.extensions.Message;
/* Exclude orchestration processes that you have set up where the statuses are equivalent to SHIPPED or
FULFILLED.*/
Set excludeStatusesSet = ["CANCELED", "CLOSED", "SHIPPED", "BACKORDERED", "AWAIT_BILLING", "BILLED" ];
/*
def poNumber = header.getAttribute("CustomerPONumber");
if (poNumber == null || !poNumber.equals("CSR_2720"))
1794
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
return;
*/
def requestedDate = header.getAttribute("RequestShipDate");
def lines = header.getAttribute("Lines");
while (lines.hasNext()) {
def line = lines.next();
def statusCode = line.getAttribute("StatusCode");
if (statusCode != null && excludeStatusesSet.contains(statusCode)) {
continue;
}
/*
def comments = line.getAttribute("Comments");
if (comments == null)
comments = "TEST:";
line.setAttribute("Comments", comments + header.getAttribute("ChangeVersionNumber"));
*/
/*set the RequestedShipDate attribute on the order line to the value of the requestedDate variable.
requestedDate contains the value of the RequestShipDate order header attribute.
line.setAttribute("RequestedShipDate",requestedDate);
line.setAttribute("ScheduleShipDate",requestedDate);
}
//line.setAttribute("RequestedArrivalDate",date);
line.setAttribute("ScheduleShipDate",date);
1795
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
}
}
Remove the System Date from the Contract Start Date on the Order Line
Order Management sets the Contract Start Date attribute to the system date when you copy a sales order. Use this
extension to remove the system date from the Contract Start Date.
def lines = header.getAttribute("Lines");
while( lines.hasNext() ) {
def line = lines.next();
def VARTotalContractAmount = line.getAttribute("TotalContractAmount");
def refFlineId=line.getAttribute("ReferenceFulfillmentLineIdentifier");
if( VARTotalContractAmount == null && refFlineId==null) {
line.setAttribute("ContractStartDate1",null);
}
Set the Default Value for the Unit of Measure on the Order Line
import oracle.apps.scm.doo.common.extensions.ValidationException;
//If you use the Order Management work area to create the sales order, then don't run this extension.
if (headerId == sourceOrderId)
return;
//If its an order revision, then don't run this extension. Remove this condition to run the extension for
revisions.
if (reference != null)
return;
1796
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
Make sure the purchase order isn't on hold when you revise a sales order in a drop ship flow.
import oracle.apps.scm.doo.common.extensions.ValidationException;
import oracle.apps.scm.doo.common.extensions.Message;
List < Message > messages = new ArrayList < Message > ();
def headerPVO =
context.getViewObject("oracle.apps.scm.doo.processOrder.publicModel.partyMerge.view.HeaderPVO");
1797
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
def vc = headerPVO.createViewCriteria();
def vcrow = vc.createViewCriteriaRow();
vcrow.setAttribute("SourceOrderNumber", header.getAttribute("SourceTransactionNumber"));
vcrow.setAttribute("SourceOrderSystem", header.getAttribute("SourceTransactionSystem"));
vcrow.setAttribute("StatusCode", "OPEN");
if (headerPRow != null)
headerId = headerPRow.getAttribute("HeaderId");
else {
//ValidationException ex = new ValidationException(messages);
//throw ex;
return;
}
while (lines.hasNext()) {
def line = lines.next();
def linePVO =
context.getViewObject("oracle.apps.scm.doo.processOrder.publicModel.partyMerge.view.FulfillLinePVO");
if (linePRow != null)
flineId = linePRow.getAttribute("FulfillLineId");
else
continue;
def docRefPVO =
context.getViewObject("oracle.apps.scm.doo.common.pricing.integration.publicView.DocumentReferencePVO");
if (drPRow != null)
poHeaderId = drPRow.getAttribute("DocId");
else
continue;
1798
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
if (poPRow != null) {
if ("Y".equals(poPRow.getAttribute("FrozenFlag")) || "ON
HOLD".equals(poPRow.getAttribute("DocumentStatus")))
throw new ValidationException("PO is frozen. OM Change cannot be submitted");
if (pvPRow != null)
messages.add(new Message(Message.MessageType.ERROR, "PO Change is in progress. OM Change cannot be
submitted"));
} else
continue;
}
def po = header.getAttribute("CustomerPONumber");
def reference = header.getAttribute("ReferenceHeaderId");
previousLinesMap = [:];
if (reference == null)
return;
while (rowset1.hasNext()) {
def originalFLine=rowset1.next();
previousLinesMap.put(originalFLine.getAttribute("FulfillLineSourceLineId"),originalFLine);
}
}
1799
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
Make Sure the Business Unit on the Return Order Matches the Business Unit on the Original Order
import oracle.apps.scm.doo.common.extensions.ValidationException;
/*
def poNumber = header.getAttribute("CustomerPONumber");
if (poNumber == null || !("VS_BU_TEST".equals(poNumber))) {
return;
}
*/
def vo = context.getViewObject("oracle.apps.scm.doo.publicView.analytics.HeaderPVO");
def vc = vo.createViewCriteria();
1800
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
Shipping
Use an order management extension to manage shipping.
• Validate Ship-to, Bill-to, and Sold-to Attributes
• Set the Default Value for Ship-To Address According to Business Unit
• Cascade the Shipping Method from the Order Header to Order Lines
• Populate Shipping Instructions on Order Lines
Get values for the Ship-to, Bill-to, and Sold-to attributes from the order header. Compare them to the customer account
details and validate that they're all for the same customer.
import oracle.apps.scm.doo.common.extensions.ValidationException;
import oracle.apps.scm.doo.common.extensions.Message;
List < Message > messages = new ArrayList < Message > ();
if (header.getAttribute("BuyingPartyName") == header.getAttribute("BillToCustomerName"))
relationExists = true;
def CustPVO =
context.getViewObject("oracle.apps.cdm.foundation.parties.publicView.customerAccounts.CustomerAccountRelationshipPV
def vc = CustPVO.createViewCriteria();
def vcrow = vc.createViewCriteriaRow();
vcrow.setAttribute("RelatedCustAccountId", soldTo);
def rowSet = CustPVO.findByViewCriteria(vc, -1);
while (rowSet.hasNext()) {
def row = rowSet.next();
def billtorelation = row.getAttribute("CustAccountId");
if (billtorelation == billTo) {
relationExists = true;
}
}
1801
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
/*
if( !relationExists) {
Set the Default Value for Ship-To Address According to Business Unit
import oracle.apps.scm.doo.common.extensions.ValidationException;
import oracle.apps.scm.doo.common.extensions.Message;
if(!messages.isEmpty()) {
ValidationException ex = new ValidationException(messages);
throw ex;
}
vcrow.setAttribute("PartySiteId", partySiteId);
vcrow.setAttribute("SiteUseType", "SHIP_TO");
def rowset = PartySiteUsePVO.findByViewCriteria(vc, -1);
if(rowset.hasNext()){
1802
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
Cascade the Shipping Method from the Order Header to Order Lines
import oracle.apps.scm.doo.common.extensions.ValidationException;
import oracle.apps.scm.doo.common.extensions.Message;
def poNumber = header.getAttribute("CustomerPONumber");
List<Message> messages = new ArrayList<Message>();
Run this extension when the original order doesn't contain shipping instructions and you're revising the order.
import oracle.apps.scm.doo.common.extensions.ValidationException;
def poNumber = header.getAttribute("CustomerPONumber");
def orderNumber = header.getAttribute("SourceTransactionNumber");
return originalFLine;
1803
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
if(!(getPartySiteUssage(partySiteId)))
throw new ValidationException("siteUssage is not shipto");
}
vcrow.setAttribute("PartySiteId", partySiteId);
vcrow.setAttribute("SiteUseType", "SHIP_TO");
def rowset = PartySiteUsePVO.findByViewCriteria(vc, -1);
if(rowset.hasNext())
return true;
else
return false;
Set the Default Value of the Payment Term According to CustAccountId and Date Range
List < Message > messages = new ArrayList < Message > ();
1804
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
List < Message > messages = new ArrayList < Message > ();
while (payments.hasNext()) {
def payment = payments.next();
1805
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
def lines = header.getAttribute("Lines");// Get the lines for the row set.
return txnTypeId;
}
1806
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
If Order Management already sent the order line to accounts receivable, then don't allow Order Management to update
the billing transaction type on the order line.
import oracle.apps.scm.doo.common.extensions.ValidationException;
import oracle.apps.scm.doo.common.extensions.Message;
def po = header.getAttribute("CustomerPONumber");
if (po == null || !"VS_TEST".equals(po))
return;
previousLinesMap = [:];
IsBillingTrxTypeIdUpdateable(reference);
if(previousLinesMap.size() == 0) {
return;
}
line = lines.next();
refFlineId = line.getAttribute("ReferenceFulfillmentLineIdentifier");
def vo = context.getViewObject("oracle.apps.scm.doo.publicView.analytics.FulfillLinePVO");
def vc = vo.createViewCriteria();
def vcrow = vc.createViewCriteriaRow();
vcrow.setAttribute("FulfillLineHeaderId", referenceHeaderId);
rowset = vo.findByViewCriteria(vc, -1);
line = rowset.next();
if (statusesSet.contains(line.getAttribute("FulfillLineStatusCode"))) {
previousLinesMap.put(line.getAttribute("FulfillLineId"), line.getAttribute("FulfillLineBillingTrxTypeId"));
1807
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
continue;
}
fldItr = line.getAttribute("FulfillLineDetail");
while(fldItr.hasNext()) {
fld = fldItr.next();
if("Invoice".equals(fld.getAttribute("FulfillLineDetailTaskType"))) {
previousLinesMap.put(line.getAttribute("FulfillLineId"), line.getAttribute("FulfillLineBillingTrxTypeId"));
break;
}
}
}
}
List < Message > messages = new ArrayList < Message > ();
def logger = context.getLogger();
while (lines.hasNext()) {
1808
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
termId = profile.getAttribute("CustProfileStandardTerms");
header.setAttribute("ShippingInstructions", "TERM=" + termId);
logger.logSevere("Term Id from CustomerFinancialProfilesPVO : ", termId);
}
else {
vc1 = custProfilePVO.createViewCriteria();
vcrow1 = vc1.createViewCriteriaRow();
vcrow1.setAttribute("CustProfileCustAccountId", custActId);
vcrow1.setAttribute("CustProfileSiteUseId", "is null");
vcrow1.setAttribute("CustProfileStandardTerms", "> -1");
termId = profile.getAttribute("CustProfileStandardTerms");
header.setAttribute("ShippingInstructions", "TERM=" + termId);
logger.logSevere("Term Id from CustomerFinancialProfilesPVO : ", termId);
}
else {
header.setAttribute("ShippingInstructions", termId);
throw new ValidationException("No Payment Term found for the BillToCustomer 2 :: "+siteUseId);
}
}
return termId;
}
Set the Default Value for the Payment Term Before You Submit the Sales Order
//preSubmit_PAYMENT_TERM_DEFAULTING//
import oracle.apps.scm.doo.common.extensions.ValidationException;
import oracle.apps.scm.doo.common.extensions.Message;
1809
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
def custActId =
line.getAttribute("BillToCustomerIdentifier");
def siteUseId =
line.getAttribute("BillToAccountSiteUseIdentifier");
def linePayTerm =
line.getAttribute("PaymentTermCode");
def linetransactioncode =
line.getAttribute("TransactionCategoryCode");
if (termId != null){
header.setAttribute("PaymentTerm", termName);
line.setAttribute("PaymentTerm", termName);
}
}
}
Set the Default Value of the Payment Term According to CustAccountId and Date Range
import oracle.apps.scm.doo.common.extensions.ValidationException;
import oracle.apps.scm.doo.common.extensions.Message;
List < Message > messages = new ArrayList < Message > ();
def logger = context.getLogger();
1810
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
while (lines.hasNext()) {
termId = profile.getAttribute("CustomerProfileStandardTerms");
//header.setAttribute("ShippingInstructions", "TERM=" + termId);
logger.logSevere("Term Id from CustomerFinancialProfilesPVO : ", termId);
} else {
vc1 = custProfilePVO.createViewCriteria();
vcrow1 = vc1.createViewCriteriaRow();
vcrow1.setAttribute("CustomerProfileCustAccountId", custActId);
vcrow1.setAttribute("CustomerProfileSiteUseId", "is null");
vcrow1.setAttribute("CustomerProfileStandardTerms", "> -1");
vcrow1.setAttribute("CustomerProfileEffectiveEndDate", ">= "+sqlDate);
vcrow1.setAttribute("CustomerProfileEffectiveStartDate", " <= "+sqlDate);
1811
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
if (profile != null) {
termId = profile.getAttribute("CustomerProfileStandardTerms");
//header.setAttribute("ShippingInstructions", "TERM=" + termId);
logger.logSevere("Term Id from CustomerFinancialProfilesPVO : ", termId);
} else {
//header.setAttribute("ShippingInstructions", termId);
throw new ValidationException("No Payment Term found for the BillToCustomer 2 :: " + siteUseId);
}
}
return termId;
}
Extensible Flexfields
Use an order management extension to manage extensible flexfields.
• Take Action According to the Value of an Extensible Flexfield
• Copy Extensible Flexfield Values to Data Values
• Copy Extensible Flexfield Values from the Original Fulfillment Line During a Return Order
• Use an Extensible Flexfield to Update Ship-To Addresses
}
}
1812
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
throw new ValidationException("We need more time to get the document reference.");
}
while(docRefs.hasNext()) {
def docRef = docRefs.next();
String docRefType = docRef.getAttribute("DocumentReferenceType");
if(!'COPY_REF_ORDER'.equals(docRefType))continue;
def cntxRow = header.getOrCreateContextRow("HeaderContext1");
cntxRow.setAttribute("_H1AttributeChar2",docRef.getAttribute("DocumentNumber"));
}
}
Copy Extensible Flexfield Values from the Original Fulfillment Line During a Return Order
import oracle.apps.scm.doo.common.extensions.ValidationException;
import oracle.apps.scm.doo.common.extensions.Message;
import java.util.logging.Level;
Long lineId = 0;
Long headerId = 0;
def lines = header.getAttribute("Lines");
while( lines.hasNext() ) {
def line = lines.next();
if(headerId == 0) {
// The DocumentIdentifier attribute identifies the header of the original order.
headerId = new Long(docRef.getAttribute("DocumentIdentifier"));
if (headerId !=0){
def voRow = getContextHeaderRow(headerId, "HeaderBIEffBComplianceDetailsBIVO");
def complianceInfo = voRow.getAttribute("_ComplianceInfo");
1813
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
}
else{
throw new ValidationException("We couldn't find a value.");
def vo = context.getViewObject("oracle.apps.scm.doo.publicView.analytics.FulfillLinePVO");
return originalFLine;
}
/**
* Returns a row for the context on the order header.
* @param contextVOName identifies the name of the context for the virtual object. To get this value, use
the context code or look it up in the extensible flexfield archive.
* under oracle/apps/publicFlex/scm/doo/headerContextsB/analytics/view
*/
Object getContextVORow(Long headerId, String contextVOName) {
def contextVO = context.getViewObject("oracle.apps.publicFlex.scm.doo.fulfillLineContextsB.analytics.view."
+ contextVOName);
def vc = contextVO.createViewCriteria();
def vcrow = vc.createViewCriteriaRow();
vcrow.setAttribute("FulfillLineId", headerId);
def rowset = contextVO.findByViewCriteria(vc, -1);
def effRow = rowset.first();
return effRow;
}
If the customer relationship type is Single, then set the value of the Ship-To Address according to the value of an
extensible flexfield.
import oracle.apps.scm.doo.common.extensions.ValidationException;
import oracle.apps.scm.doo.common.extensions.Message;
List < Message > messages = new ArrayList < Message > ();
1814
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
def po = header.getAttribute("CustomerPONumber");
//Condition that specifies when to call the extension. You can can also use an extensible flexfield on the
order header.
if (!"TEST_MDF".equals(po))
return;
def line2AddrMap = [: ];
def lines = header.getAttribute("Lines");
if (!lines.hasNext()) {
throw new ValidationException("Order Management hasn't saved the order line details. Save the sales order,
then try again.");
}
while (lines.hasNext()) {
def line = lines.next();
def lineNo = line.getAttribute("DisplayLineNumber");
line2AddrMap.put(lineNo, line.getAttribute("ShipToPartySiteIdentifier"));
}
lines.reset();
while (lines.hasNext()) {
def line = lines.next();
def context = line.getOrCreateContextRow("FulfillLineContext1"); //Add your own extensible flexfield
context that identifies the address for the ship-to line that you must copy.
def copyFromLineNo = context.getAttribute("_FL1AttributeChar1"); //Update this value with the display line
number of the source line.
if (copyFromLineNo != null && !copyFromLineNo.isEmpty()) {
line.setAttribute("ShipToPartySiteIdentifier", line2AddrMap.get(copyFromLineNo));
}
}
if (!messages.isEmpty()) {
ValidationException ex = new ValidationException(messages);
throw ex;
}
Other Areas
Use an order management extension to manage other areas.
• Get Details for Related Sales Orders
• Call the Web Service That Does Credit Check
• Pseudocode That Cascades an Attribute Value from the Top Parent of a Configuration Model to All Child Lines
Get details about the relationship between the sales order and other related sales orders, such as the original order of a
copied order or a return order.
import oracle.apps.scm.doo.common.extensions.ValidationException;
import oracle.apps.scm.doo.common.extensions.Message;
List < Message > messages = new ArrayList < Message > ();
messages.add(new Message(Message.MessageType.ERROR, "HeaderId: " + header.getAttribute("HeaderId")));
1815
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
1816
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
//Use the CreditCheckService web service connector to call the Check Credit service. Use the Manage External
Interface Web Service Details task to set up the connector. This is a secured external service,
//so we're using a message protection policy. We use the external https URL of the service to register it.
def response = context.invokeSoapService("CreditCheckService", payLoad);
1817
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
//Print a debug message. Append the entire response to the shipping instructions attribute.
//Make sure you disable debug statements like this one in your production instance because they can cause
performance problems.
debug(response.getSoapBody().getTextContent());
//The response XML that the Credit Check service sends contains an element named Response. A YES value in
the response means credit check passed. So, we extract the contents of the Response tag. The following XML
API returns all tags
//that include the name Response in a NodeList element. We are expecting only one element in our XML
response.
def nodeList = response.getSoapBody().getElementsByTagNameNS("*", "Response");
//Get the first element that contains the name Response. We are expecting only one response. Then get its
text content
String ccResponse = nodeList.item(0).getTextContent();
debug(ccResponse);
/**
* Append the message that we received into the Shipping Instructions attribute. Use this method only for
debugging purposes.
*/
void debug(def msg) {
String si = header.getAttribute("ShippingInstructions");
header.setAttribute("ShippingInstructions", si + ", " + msg.toString());
}
Pseudocode That Cascades an Attribute Value from the Top Parent of a Configuration Model to All Child Lines
import oracle.apps.scm.doo.common.extensions.ValidationException;
1818
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
//Iterate through all lines. Set the child lines's contract start date and end date to the parent's contract
start date and end date.
void updateChildLines(def rootfline){
def lines=header.getAttribute("Lines");
def flineId=rootfline.getAttribute("FulfillmentLineIdentifier");
def parentstartdate=rootfline.getAttribute("ContractStartDate1");
def parentenddate=rootfline.getAttribute("ContractEndDate1");
while( lines.hasNext() ) {
def line=lines.next();
def rootFlineId=line.getAttribute("RootParentLineReference");
if(flineId==rootFlineId){
line.setAttribute("ContractStartDate1",parentstartdate);
line.setAttribute("ContractEndDate1",parentenddate);
}
}
}
Reference
Methods You Can Use with Order Management Extensions
Get details about the methods you can use with your order management extension.
where
1819
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
Parameter Description
public String String. Name of the order management extension that's currently running.
getExtensionName()
public String getEventCode() String. Abbreviation that identifies the event that triggered the extension.
public Logger getLogger() Logger. Logger where the extension can write logs.
public ServiceInvoker Returns a service that you can use to call a web service from the code in your order
getServiceInvoker() management extension.
public String getUserName() Returns the name of the user currently signed in.
where
public String getLanguage() Returns an abbreviation that identifies the language that the user is using in the current
session.
public Date getCurrentDate() Returns the current system date in an instance of java.sql.Date.
Logger Method
The Logger method returns the message log.
Format Description
where
1820
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
Format Description
public void logFine(String Saves message to the log at the fine level.
message)
where
• messageFormat. Format of the message. The command uses this format to create the
message string. It passes the format and argumentsto String.format().
• arguments. Arguments that replace the tokens in the format string.
public void logFiner(String Saves message to the log at the finer level.
message)
where
• messageFormat. Format of the message. The command uses this format to create the
message string. It passes the format and argumentsto String.format().
• arguments. Arguments that replace the tokens in the format string.
public void logFinest(String Saves message to the log at the finest level.
message)
where
public void logFinest(String Saves message to the log at the finest level.
message)
where
• messageFormat. Format of the message. The command uses this format to create the
message string. It passes the format and argumentsto String.format().
• arguments. Arguments that replace the tokens in the format string.
1821
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
Format Description
• messageFormat. Format of the message. The command uses this format to create the
message string. It passes the format and argumentsto String.format().
• arguments. Arguments that replace the tokens in the format string.
Message Method
The Message method uses a message type and message text to create a message for the sales order. It uses the
ORA_MANAGE_EXTENSIONS request function to log messages, by default.
Here's the format to use to display a literal message that uses the default message category and no tokens.
Message(MessageType type, String text)
where
Here's the format to use to specify the message name and message token parameters.
Message(MessageType type, String name, Map<String, Object> parameters)
where
Here's the values that attributes for this message must use on the Manage Messages page.
Attribute Value
1822
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
• parameters. A map that contains message tokens and token values. The Message method uses this map to
populate tokens with values. These tokens are part of the message.
Here's some example code that displays the contents of a message named DOO_CUST_RELATIONSHIP_WARNING.
Message(MessageType Message.MessageType.WARNING, String "DOO_CUST_RELATIONSHIP_WARNING", Map<String, Object>
messageParams)
You can use the Request function, message name, and message token parameters to create a message for the sales
order or the order line. The Message method will log the message with the request function that you specify.
where
• Object line. Identifies the order line to reference when logging the message.
For details about the other parameters, see the Map Tokens for the Message Repository section in this topic.
where
• DEMO_REQFUNC is a value in lookup DOO_MSG_REQUEST_FUNCTION.
Parameter Description
hasNext() Returns a Boolean value that indicates whether another row exists after the current row.
If no more rows exist after the current row, then this parameter returns a null value.
1823
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
Parameter Description
hasPrevious() Returns a Boolean value that indicates whether another row exists before the current row.
If no more rows exist before the current row, then this parameter returns a null value.
createRow() Creates a new row. If the entity doesn't support creating a new row, then this parameter returns
an error message when your extension calls this method.
insertRow(Row row) Inserts the row into the current iterator, where row specifies the row number to insert.
Use this method to add a new row to the iterator after you create the iterator.
ValidationException can get the error message text from the Oracle Fusion message repository, populate token values,
and then display the message in the Order Management work area.
where
• name. Name of the message that you specify on the Manage Messages page.
• parameters. A map that contains message tokens and token values. ValidationException uses this map to
populate tokens with values in the message.
Here's the format to use with ValidationException to create the map that parameters specifies.
ValidationException(java.lang.String requestFunction, java.lang.String name,
java.util.Map<java.lang.String,java.lang.Object> parameters)
where
• requestFunction. Lookup code of the request function to log the message against. You use the Order
Management lookup named Request Function to define a request function. If this parameter passes an empty
value, then ValidationException defaults the request function to ORA_MANAGE_EXTENSIONS.
1824
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
• name. Name of the message that you specify on the Manage Messages page. You must specify Distributed
Order Orchestration as the application for this message when you use the Manage Messages page.
• parameters. A map that contains message tokens and token values. ValidationException uses this map to
populate tokens with values in the message.
ValidationException can use a list of message objects to create a validation exception. It can accommodate a validation
error that includes more than one message.
where
• messages. A list of message objects. For details about how to create a message object, see the Message
Method section in this topic.
MANAGE_HOLD Hold.
XFORM_ORDER Order transformation. Location that Order Management uses to store an incoming source
order before it transforms it to a sales order.
1825
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
ORA_VALD_CONFIG Configuration.
ORA_VALD_PRICING Pricing.
ORA_VALD_PAYMENT Payment.
ORA_MANAGE_EXTENSIONS Default type for messages that the extensions framework logs.
You can specify one of these lookup codes or add new ones to the lookup.
where
A view criterion is a list of row criterion for the WHERE clause in a view object. Each row criterion is an array that
contains criterion for each attribute.
Here's the format to use to find rows according to the view criterion that you provide and return them in an iterator.
RowIterator findByViewCriteria(ViewCriteria viewCriteria, int numberOfRows)
1826
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
where
• viewCriteria. Name of the view criteria to use to find rows.
• numberOfRows. Number of rows to return. Use one of.
For example, here's some code that gets all rows and stores them in a local variable named vc.
def rowset = itemPVO.findByViewCriteria(vc, -1);
where
• variableNames. Array of variable names to use with the view criteria.
• variableValues. Array of variable values to use with the view criteria.
Here's the format to use to find rows according to the name of the view criteria.
RowIterator findByViewCriteriaWithBindVars(String viewCriteriaName, int maxNumOfRows, String[]
variableNames, Object[] variableValues)
where
• viewCriteriaName. Name of the view criteria to use to find the rows.
Entities and Attributes You Can Use With Order Management Extensions
Get details about entities and attributes you can use with your order management extensions.
• An extension can read from or write to the identifier attributes of a sales order, such as
BillToCustomerIdentifier.
1827
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
Entity Value to Use in Parent Read During All Write During Write During End
Code Events Save or Start of Submission
of Submission Request
Request
1828
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
Entity Value to Use in Parent Read During All Write During Write During End
Code Events Save or Start of Submission
of Submission Request
Request
Use methods getOrCreateContextRow("context code") and getAttribute("API name") with these attributes, where
context code is the name of the context code of the extensible flexfield and API name is the name of the API (application
programming interface) you use to call the method.
Entity Value to Use in Parent Read During All Write During Write During End
Code Events Save or Start of Submission
of Submission Request
Request
List of Attributes
Here's the list of attributes you can use in an order management extension. To get them in an Excel file, click Download
Files at this end of this topic.
Attribute Updatable
AgreementHeaderId Yes
AgreementNumber Yes
AllowCurrencyOverrideFlag No
AppliedCurrencyCode No
AppliedCurrencyName No
1829
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
Attribute Updatable
BillToAccountContactIdentifier Yes
BillToAccountContactName Yes
BillToAccountContactNumber Yes
BillToAccountDescription No
BillToAccountPersonFirstName No
BillToAccountPersonLastName No
BillToAccountPersonMiddleName No
BillToAccountPersonNameSuffix No
BillToAccountPersonTitle No
BillToAddress1 No
BillToAddress2 No
BillToAddress3 No
BillToAddress4 No
BillToCity No
BillToContactFirstName No
BillToContactLastName No
BillToContactMiddleName No
BillToContactNameSuffix No
BillToContactTitle No
BillToCountry No
1830
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
Attribute Updatable
BillToCounty No
BillToCustomerIdentifier Yes
BillToCustomerName Yes
BillToCustomerNumber Yes
BillToCustomerSiteIdentifier Yes
BillToPartyType Yes
BillToPostalCode No
BillToProvince No
BillToState No
BusinessUnitIdentifier Yes
BusinessUnitName Yes
BuyingPartyContactFirstName No
BuyingPartyContactId Yes
BuyingPartyContactLastName No
BuyingPartyContactMiddleName No
BuyingPartyContactName Yes
BuyingPartyContactNameSuffix No
BuyingPartyContactNumber Yes
BuyingPartyContactTitle No
BuyingPartyIdentifier Yes
1831
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
Attribute Updatable
BuyingPartyName Yes
BuyingPartyNumber Yes
BuyingPartyPersonFirstName No
BuyingPartyPersonLastName No
BuyingPartyPersonMiddleName No
BuyingPartyPersonNameSuffix No
BuyingPartyPersonTitle No
BuyingPartyType Yes
CancelReason Yes
CancelReasonCode Yes
CarrierId Yes
CarrierName Yes
ChangeVersionNumber No
Comments Yes
CurrencyConversionDate Yes
CurrencyConversionRate Yes
CurrencyConversionTypeCode Yes
CustomerPONumber Yes
DemandClass Yes
DemandClassCode Yes
1832
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
Attribute Updatable
EarliestAcceptableShipDate Yes
EarliestAcceptArrivalDate Yes
EarliestAcceptArrivalDateTransient Yes
FOBPoint Yes
FOBPointCode Yes
FreezePriceFlag Yes
FreezeShippingChargeFlag Yes
FreezeTaxFlag Yes
FreightTerms Yes
FreightTermsCode Yes
FulfillmentOrganizationCode Yes
FulfillmentOrganizationIdentifier Yes
FulfillmentOrganizationName Yes
HeaderId No
LatestAcceptableShipDate Yes
LatestAcceptArrivalDate Yes
OrderNumber No
OrigSysDocumentRef Yes
PackingInstructions Yes
PartialShipAllowedFlag Yes
1833
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
Attribute Updatable
PaymentTerm Yes
PaymentTermCode Yes
PreCreditCheckedFlag Yes
PreferredBillToContactPointIdentifier Yes
PreferredShipToContactPointIdentifier Yes
PreferredSoldToContactPointIdentifier Yes
PricedOn No
PricingSegmentCode No
PricingSegmentExplanation No
PricingStrategy No
PricingStrategyExplanation No
PricingStrategyIdentifier No
ReferenceHeaderId No
RequestArrivalDate Yes
RequestCancelDate Yes
RequestingBusinessUnit No
RequestingBusinessUnitIdentifier Yes
RequestingLegalUnit Yes
RequestingLegalUnitIdentifier Yes
RequestShipDate Yes
1834
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
Attribute Updatable
RevisionSourceOrderSystem Yes
SalesChannel Yes
SalesChannelCode Yes
Salesperson Yes
SalespersonIdentifier Yes
SegmentExplanationMessage No
SegmentExplanationMsgName No
ShipClassOfService Yes
ShipClassOfServiceCode Yes
ShipmentPriority Yes
ShipmentPriorityCode Yes
ShipModeOfTransport Yes
ShipModeOfTransportCode Yes
ShippingInstructions Yes
ShipsetFlag Yes
ShipToAddress1 No
ShipToAddress2 No
ShipToAddress3 No
ShipToAddress4 No
ShipToCity No
1835
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
Attribute Updatable
ShipToContactFirstName No
ShipToContactLastName No
ShipToContactMiddleName No
ShipToContactNameSuffix No
ShipToContactTitle No
ShipToCountry No
ShipToCounty No
ShipToPartyContactIdentifier Yes
ShipToPartyContactName Yes
ShipToPartyContactNumber No
ShipToPartyIdentifier Yes
ShipToPartyName Yes
ShipToPartyNumber Yes
ShipToPartyPersonFirstName No
ShipToPartyPersonLastName No
ShipToPartyPersonMiddleName No
ShipToPartyPersonNameSuffix No
ShipToPartyPersonTitle No
ShipToPartySiteIdentifier Yes
ShipToPartyType Yes
1836
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
Attribute Updatable
ShipToPostalCode No
ShipToProvince No
ShipToState No
SoldToPartyContactPointId Yes
SourceTransactionIdentifier No
SourceTransactionNumber No
SourceTransactionRevisionNumber No
SourceTransactionSystem No
StatusCode No
StrategyExplanationMessage No
StrategyExplanationMsgName No
SubmittedBy Yes
SubmittedDate Yes
SubmittedFlag No
SubstituteAllowedFlag Yes
SupplierAddressCity No
SupplierAddressCountry No
SupplierAddressCounty No
SupplierAddressLine1 No
SupplierAddressLine2 No
1837
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
Attribute Updatable
SupplierAddressLine3 No
SupplierAddressLine4 No
SupplierAddressPostalCode No
SupplierAddressProvince No
SupplierAddressState No
SupplierCode Yes
SupplierName Yes
SupplierNumber Yes
SupplierSiteIdentifier Yes
TradeComplianceResult Yes
TradeComplianceResultCode No
TransactionalCurrencyCode Yes
TransactionalCurrencyName Yes
TransactionDocumentTypeCode Yes
TransactionOn Yes
TransactionType No
TransactionTypeCode Yes
Lines No
SalesCredits No
OrderTotals No
1838
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
Attribute Updatable
Payments No
DocumentReferences No
Attribute Updatable
AccountingRule Yes
AccountingRuleCode Yes
ActionType Yes
ActionTypeCode Yes
AssessableValue Yes
AssetGroupNumber Yes
AssetTrackedFlag Yes
BillingTransactionTypeIdentifier Yes
BillToAccountContactIdentifier Yes
BillToAccountContactName Yes
BillToAccountContactNumber Yes
BillToAccountPersonFirstName No
BillToAccountPersonLastName No
BillToAccountPersonMiddleName No
BillToAccountPersonNameSuffix No
BillToAccountPersonTitle No
1839
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
Attribute Updatable
BillToAccountSiteUseIdentifier Yes
BillToAddress1 No
BillToAddress2 No
BillToAddress3 No
BillToAddress4 No
BillToCity No
BillToContactFirstName No
BillToContactLastName No
BillToContactMiddleName No
BillToContactNameSuffix No
BillToContactTitle No
BillToCounty No
BillToCustomerIdentifier Yes
BillToCustomerName Yes
BillToCustomerNumber Yes
BillToPartyType Yes
BillToPostalCode No
BillToProvince No
BillToState No
BillingTransactionTypeIdentifier Yes
1840
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
Attribute Updatable
BusinessUnitIdentifier Yes
BusinessUnitName Yes
CancelReason Yes
CancelReasonCode Yes
Comments Yes
ComponentIdPath Yes
ConfigHeaderId Yes
ConfigRevisionNumber Yes
ConfiguratorPath Yes
ContractEndDate Yes
ContractStartDate Yes
ContractEndDate1 Yes
ContractStartDate1 Yes
CreditCheckAuthorizationCode Yes
CreditCheckAuthorizationExpiryDate Yes
CustomerPOLineNumber Yes
CustomerPONumber Yes
CustomerPOScheduleNumber Yes
CustomerProductDescription Yes
CustomerProductIdentifier Yes
1841
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
Attribute Updatable
CustomerProductNumber Yes
DefaultTaxationCountry Yes
DefaultTaxationCountryShortName Yes
DemandClass Yes
DemandClassCode Yes
DestinationShippingAddressCity No
DestinationShippingAddressCountry No
DestinationShippingAddressCounty No
DestinationShippingAddressLine1 No
DestinationShippingAddressLine2 No
DestinationShippingAddressLine3 No
DestinationShippingAddressLine4 No
DestinationShippingAddressPostalCode No
DestinationShippingAddressProvince No
DestinationShippingAddressState No
DestinationShippingLocationIdentifier Yes
DestinationShippingOrganizationCode Yes
DestinationShippingOrganizationIdentifierYes
DestinationShippingOrganizationName Yes
DisplayLineNumber No
1842
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
Attribute Updatable
DocumentSubType Yes
DocumentSubTypeName Yes
EarliestAcceptableShipDate Yes
ExtendedAmount Yes
FinalDischargeLocationAddressCity No
FinalDischargeLocationAddressCountry No
FinalDischargeLocationAddressCounty No
FinalDischargeLocationAddressLine1 No
FinalDischargeLocationAddressLine2 No
FinalDischargeLocationAddressLine3 No
FinalDischargeLocationAddressLine4 No
FinalDischargeLocationAddressPostalCodeNo
FinalDischargeLocationAddressProvince No
FinalDischargeLocationAddressState No
FinalDischargeLocationIdentifier Yes
FirstPartyTaxRegistration Yes
FirstPartyTaxRegistrationNumber Yes
FOBPoint Yes
FOBPointCode Yes
FreightTerms Yes
1843
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
Attribute Updatable
FreightTermsCode Yes
FulfillInstanceId Yes
FulfillmentLineIdentifier No
FulfillmentOrganizationCode Yes
FulfillmentOrganizationIdentifier Yes
FulfillmentOrganizationName Yes
HeaderId No
IntendedUseClassificationIdentifier Yes
IntendedUseClassificationName Yes
InventoryOrganization No
InventoryOrganizationIdentifier No
InvoicingRule Yes
InvoicingRuleCode Yes
IsValidConfiguration Yes
ItemSubTypeCode No
LatestAcceptableArrivalDate Yes
LatestAcceptableShipDate Yes
LineAgreementNumber Yes
LineId No
LineNumber No
1844
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
Attribute Updatable
LineType No
ModifiedFlag Yes
OrderedQuantity Yes
OrderedUOM Yes
OrderedUOMCode Yes
OriginalProductDescription Yes
OriginalProductIdentifier Yes
OriginalProductNumber Yes
PackingInstructions Yes
ParentLineReference Yes
PartialShipAllowedFlag Yes
PaymentTerm Yes
PaymentTermCode Yes
PreferredBillToContactPointIdentifier Yes
PreferredShipToContactPointIdentifier Yes
ProductCategory Yes
ProductCategoryName Yes
ProductDescription Yes
ProductFiscalCategoryIdentifier Yes
ProductFiscalCategoryName Yes
1845
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
Attribute Updatable
ProductIdentifier Yes
ProductNumber Yes
ProductType Yes
ProductTypeName Yes
ProjectRecordIndicator Yes
PromiseArrivalDate Yes
PromiseShipDate Yes
QuantityPerModel Yes
ReferenceFulfillmentLineIdentifier No
RequestCancelDate Yes
RequestedArrivalDate Yes
RequestedShipDate Yes
RequestingBusinessUnitIdentifier Yes
RequestingBusinessUnitName Yes
RequiredFulfillmentDate Yes
ReturnReason Yes
ReturnReasonCode Yes
RootParentLineReference Yes
Salesperson Yes
SalespersonIdentifier Yes
1846
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
Attribute Updatable
SalesProductType Yes
SalesProductTypeCode Yes
ScheduleArrivalDate Yes
ScheduleShipDate Yes
ServiceCancelDate Yes
ServiceDuration Yes
ServiceDurationPeriod Yes
ServiceDurationPeriodCode Yes
ShipmentPriority Yes
ShipmentPriorityCode Yes
ShippableFlag Yes
ShippingCarrier Yes
ShippingCarrierCode Yes
ShippingInstructions Yes
ShippingMode Yes
ShippingModeCode Yes
ShippingServiceLevel Yes
ShippingServiceLevelCode Yes
ShipSetName Yes
ShipToAddress1 No
1847
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
Attribute Updatable
ShipToAddress2 No
ShipToAddress3 No
ShipToAddress4 No
ShipToCity No
ShipToContactFirstName No
ShipToContactId Yes
ShipToContactLastName No
ShipToContactMiddleName No
ShipToContactNameSuffix No
ShipToContactTitle No
ShipToCounty No
ShipToPartyContactIdentifier Yes
ShipToPartyContactName Yes
ShipToPartyContactNumber Yes
ShipToPartyIdentifier Yes
ShipToPartyName Yes
ShipToPartyNumber Yes
ShipToPartyPersonFirstName No
ShipToPartyPersonLastName No
ShipToPartyPersonMiddleName No
1848
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
Attribute Updatable
ShipToPartyPersonNameSuffix No
ShipToPartyPersonTitle No
ShipToPartySiteIdentifier Yes
ShipToPartyType Yes
ShipToPostalCode No
ShipToProvince No
ShipToRequestRegion Yes
ShipToState Yes
SourceTransactionIdentifier No
SourceTransactionLineIdentifier No
SourceTransactionLineNumber No
SourceTransactionNumber No
SourceTransactionRevisionNumber No
SourceTransactionScheduleIdentifier No
SourceTransactionScheduleNumber No
SourceTransactionSystem No
StatusCode No
SubInventoryCode Yes
SubInventoryIdentifier Yes
SubstitutionAllowedFlag Yes
1849
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
Attribute Updatable
SubstitutionReason Yes
SubstitutionReasonCode Yes
SupplierAddressCity No
SupplierAddressCountry No
SupplierAddressCounty No
SupplierAddressLine1 No
SupplierAddressLine2 No
SupplierAddressLine3 No
SupplierAddressLine4 No
SupplierAddressPostalCode No
SupplierAddressProvince No
SupplierAddressState No
SupplierCode Yes
SupplierName Yes
SupplierNumber Yes
SupplierSiteIdentifier Yes
SupplyStatusCode Yes
TaxClassification Yes
TaxClassificationCode Yes
TaxExemptFlag Yes
1850
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
Attribute Updatable
TaxExemptionCertificateNumber Yes
TaxExemptReason Yes
TaxExemptReasonCode Yes
TaxInvoiceNumber Yes
ThirdPartyTaxRegistration Yes
ThirdPartyTaxRegistrationNumber Yes
TotalContractAmount Yes
TotalContractQuantity Yes
TransactionBusinessCategory Yes
TransactionBusinessCategoryName Yes
TransactionCategoryCode Yes
TransactionLineType Yes
TransactionLineTypeCode Yes
UnitListPrice Yes
UnitQuantity Yes
UnitSellingPrice Yes
UnreferencedReturnFlag No
UserDefinedFiscClass Yes
UserDefinedFiscClassName Yes
TransactionAttributes No
1851
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
Attribute Updatable
SalesCredits No
OrderCharges No
ManualPriceAdjustments No
Payments No
DocumentReferences No
BillingPlans No
FulfillLineDetails No
LotSerial No
Projects No
Attribute Updatable
ApplyTo No
AverageUnitSellingPrice No
CanAdjustFlag No
ChargeCurrencyCode No
ChargeCurrencyName No
ChargeDefinition No
ChargeDefinitionCode No
ChargeSubtype No
ChargeSubtypeCode No
1852
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
Attribute Updatable
ChargeType No
ChargeTypeCode No
GSAUnitPrice No
OrderChargeId No
ParentEntityId No
PricedQuantity No
PricedQuantityUOM No
PricedQuantityUomCode No
PricePeriodicityCode No
PriceType No
PriceTypeCode No
PrimaryFlag No
RollupFlag No
SequenceNumber No
SourceChargeIdentifier No
OrderChargeComponents No
Attribute Updatable
ChargeCurrencyCode No
ChargeCurrencyDurationExtendedAmountNo
1853
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
Attribute Updatable
ChargeCurrencyExtendedAmount No
ChargeCurrencyName No
ChargeCurrencyUnitPrice No
Explanation No
HeaderCurrencyCode No
HeaderCurrencyDurationExtendedAmountNo
HeaderCurrencyExtendedAmount No
HeaderCurrencyName No
HeaderCurrencyUnitPrice No
OrderChargeComponentId No
OrderChargeId No
PercentOfComparisonElement No
PriceElement No
PriceElementCode No
PriceElementUsage No
PriceElementUsageCode No
RollupFlag No
SequenceNumber No
SourceChargeComponentId No
SourceChargeId No
1854
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
Attribute Updatable
SourceMpaId No
SourceParentChargeComponentId No
TaxIncludedFlag No
OrderTaxDetails No
Attribute Updatable
CurrencyCode No
DisplayName No
EstimatedFlag No
OrderTotalId No
PrimaryFlag No
TotalAmount No
TotalCode No
TotalGroup No
Attribute Updatable
HeaderCurrencyTaxableUnitAmount No
HeaderCurrencyTaxUnitAmount No
OrderChargeComponentId No
1855
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
Attribute Updatable
OrderTaxDetailId No
TaxExemptionCertificateNumber No
TaxExemptReason No
TaxExemptReasonCode No
TaxIncludedFlag No
TaxRate No
TaxRateIdentifier No
Attribute Updatable
BillingNumberOfPeriods No
BillingPeriodEndDate No
BillingPeriodNumber No
BillingPeriodStartDate No
BillingPlanId No
BillingPlanTypeCode No
BillingTrxDate No
CancellationEffectiveDate No
NetBillingAmountPERPeriod No
OverridePeriod No
OverridePeriodAmount No
1856
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
Attribute Updatable
OverridePeriodQuantity No
PeriodicityCode No
PeriodicityName No
SourceBillingPlanId No
Attribute Updatable
Percent Yes
SalesCreditIdentifier No
SalesCreditType Yes
SalesCreditTypeCode Yes
Salesperson Yes
SalespersonIdentifier Yes
SourceTransactionSalesCreditIdentifier Yes
Attribute Updatable
CharacterValue Yes
DateValue Yes
NumberValue Yes
SourceTransactionLineAttributeIdentifier Yes
1857
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
Attribute Updatable
TimestampValue Yes
TransactionAttributeCode Yes
TransactionAttributeIdentifier Yes
TransactionAttributeName Yes
TransactionAttrId No
Attribute Updatable
ItemRevisionNumber No
LocatorIdentifier No
LotNumber No
LotSerialId No
SerialNumberFrom No
SerialNumberTo No
SourceTransactionLotIdentifier No
Payment Attributes
Attribute Updatable
AuthorizationStatus No
InstrumentAssignmentIdentifier No
PaymentMethod No
1858
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
Attribute Updatable
PaymentMethodCode No
PaymentSetIdentifier No
PaymentTransactionIdentifier No
PaymentType No
PaymentTypeCode No
SourceTransactionPaymentIdentifier No
Attribute Updatable
DocumentAdditionaldentifier Yes
DocumentAdditionalLineIdentifier Yes
DocumentAdditionalLineNumber Yes
DocumentAdditionalNumber Yes
DocumentAdditionalSubLineIdentifier Yes
DocumentAdditionalSubLineNumber Yes
DocumentIdentifier Yes
DocumentLineIdentifier Yes
DocumentLineNumber Yes
DocumentNumber Yes
DocumentReferenceType Yes
DocumentSubLineIdentifier Yes
1859
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
Attribute Updatable
DocumentSubLineNumber Yes
DocumentSystemReferenceIdentifier No
OwnerTableId Yes
OwnerTableName Yes
TaskType Yes
Attribute Updatable
AdjustmentAmount No
AdjustmentElementBasis No
AdjustmentElementBasisCode No
AdjustmentType No
AdjustmentTypeCode No
ChargeDefinition No
ChargeDefinitionCode No
ChargeRollupFlag No
Comments No
ManualPriceAdjustmentId No
ParentEntityCode No
ParentEntityId No
PricePeriodicityCode No
1860
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
Attribute Updatable
Reason No
ReasonCode No
SequenceNumber No
SourceManualPriceAdjustmentIdentifier No
ValidationStatusCode No
Attribute Updatable
ActualDeliveryDate No
AvailabilityShipDate No
BillingTransactionAmount No
BillingTransactionDate No
BillingTransactionNumber No
BillOfLadingNumber No
CustomerTrxLineIdentifier No
DeliveryName No
ExceptionFlag No
FulfillLineDetailId No
FulfillLineId No
Quantity No
RMAReceiptDate No
1861
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
Attribute Updatable
RMAReceiptLineNumber No
RMAReceiptNumber No
RMAReceiptTransactionIdentifier No
Status No
StatusAsOfDate No
TaskType No
TrackingNumber No
TradeComplianceCode No
TradeComplianceExplanation No
TradeComplianceName No
TradeComplianceResultCode No
TradeComplianceResultName No
TradeComplianceTypeCode No
TradeComplianceTypeName No
WaybillNumber No
Project Attributes
Attribute Updatable
ContractId Yes
ContractNumber Yes
DooOrderPrjId No
1862
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
Attribute Updatable
ExpenditureItemDate Yes
ExpenditureOrganization Yes
ExpenditureType Yes
ExpenditureTypeId Yes
FundingSource Yes
OrganizationId Yes
ParentEntityCode No
ParentEntityId No
ProjectId Yes
ProjectNumber Yes
ReferenceProjectId No
ReservedAttribute1 Yes
TaskId Yes
TaskNumber Yes
Related Topics
• Download Files
Flexfields
1863
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
Overview
Overview of Using Extensible Flexfields in Order Management
Set up an extensible flexfield so you can add your own attribute to Order Management Cloud.
An extensible flexfield is a field you can use to capture details in a sales order that are unique to your business
requirements. Each sales order in Order Management comes predefined with a lot of attributes, but you might need one
that's specific to your needs.
You can use the details in an extensible flexfield to determine process automation, send and receive details when
communicating with systems outside of Order Management, or provide the criteria to use in a complex business rule.
For example.
• Capture consumer details in an extensible flexfield, then use them to add free samples to a shipment.
• Capture customer loyalty details in an extensible flexfield, then determine whether to call the customer or
upgrade shipping priority.
• Receive a sales order request that includes unique build specifications from your customer, store them in
an extensible flexfield, and then route the sales order to different manufacturing facilities according to the
specifications.
• Select and ship a bottle of wine according to your customer dining preferences. Store these preferences in an
extensible flexfield.
• Store the user ID of the order entry clerk who submitted a source order from a source system.
• Track source orders that include warning messages from a source system.
• Store the original schedule date and the new schedule date on the order line so you can track and report
scheduling throughout the fulfillment lifecycle.
Note.
• An extensible flexfield supports a one-to-many relationship between one entity and one or more attributes. You
can use it to add more than one context sensitive segment.
• You can set up an extensible flexfield for a fulfillment line, or on some other object that supports an extensible
flexfield.
• If you add an extensible flexfield to a fulfillment line, and if you use the Update or Close Sales Orders scheduled
process to close the order line that the fulfillment line references at run time, then the Order Entry Specialist.
◦ Can't update the value in the extensible flexfield on the fulfillment line.
◦ Can revise the sales order and update the value in the extensible flexfield on the fulfillment line, but
Order Management won't use the revised value when it processes the revision.
◦ Can update an extensible flexfield on the order header regardless of the status of the sales order or order
line.
1864
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
Example Description
Get details from a source system. Get source order details from one or more source systems. A source order is an order that you
import into Order Management from a source system, such as from an upstream channel.
A source order contains a set of attributes. If you need details or attributes that the source
order doesn't contain, then you can use an extensible flexfield to get them, then use these
details during order fulfillment.
You can use the same extensible flexfield attributes to receive details from each source system,
or use different extensible flexfield attributes according to the unique requirements of each
source system.
Send details to a fulfillment system. Order Management sends a fulfillment request that includes a predefined set of attributes to a
fulfillment system. You can use an extensible flexfield to send details that these attributes don't
include, but that the fulfillment system needs to finish the fulfillment request.
Integrate with systems outside of For details, see the Overview of Using Flexfields to Integrate Order Management with Other
Order Management. Oracle Applications topic.
Receive details from a fulfillment A fulfillment system might send attributes that provide a business value, and that the Order
system. Entry Specialist must view in Order Management or in the source system. In some situations,
Order Management might also use these details in the next set of tasks that it runs in an
orchestration process. You can use an extensible flexfield to receive these attributes.
Write a business rule. Use an extensible flexfield attribute with a business rule.
• Transformation rule. Write a rule that references an extensible flexfield to add order
details, delete unnecessary details, or modify details. Use an extensible flexfield to
determine the transformations to do.
• External interface routing rule.
• Assignment rule.
For details, see the Overview of Using Business Rules With Order Management topic.
Manage change. Use an extensible flexfield as an order attribute to store details about a change that occurred.
For example, use an extensible flexfield as input to calculate the cost of change and to select a
compensation pattern when Order management receives a change order.
Display attributes in the Order Allow the Order Entry Specialist to search for sales orders in the Order Management work area
Management work area. according to the value of an extensible flexfield.
Note that the Order Entry Specialist can read but not edit an extensible flexfield attribute.
1865
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
Example Description
Assign an orchestration process. Use the value of an extensible flexfield in an assignment rule to automatically assign an
orchestration process during order fulfillment to fulfill each sales order and each order line.
Set up an orchestration process. Create a business rule that uses an extensible flexfield to determine branching and the tasks to
run in an orchestration process.
Select the fulfillment lines to process. Use an extensible flexfield to determine whether a task in an orchestration process will process
the fulfillment line or ignore it during order fulfillment.
Calculate the lead time that an Use an extensible flexfield to calculate lead time according to your data. For example, create an
orchestration process step requires. extensible flexfield named Engraving that includes a Yes or No value, then set up conditions.
• If the item is a silver cup, and if engraving is yes, then set lead time to 3 days.
• If the item is a silver cup, and if engraving is no, then set lead time to 1 day.
For details, see the Set Up Jeopardy and Lead Time to Manage Delay topic.
• Header
• Order line
• Fulfillment line
• Fulfillment line detail
• Price adjustment
• Sales credit
• Payment
• Lot serial
• Activity
Receive Fulfill Order Orchestration For data that flows into Order Management. It uses this composite.
Task Response Service
• DooTaskFulfillOrderResponseInterfaceComposite
1866
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
Request Fulfill Order Orchestration For data that flows out of Order Management. It uses this composite.
Task Service
• DooTaskFulfillOrderRequestInterfaceComposite
Related Topics
• Overview of Flexfields
1867
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
Note.
1. Order Management Entity. The top-level object in the hierarchy. You can specify an entity.
1868
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
◦Fulfillment Line Detail Information. Store details that the fulfillment system provides that you don't
typically store on the fulfillment line.
2. Extensible Flexfield. Each extensible flexfield includes categories, contexts, and segments.
3. Extensible Flexfield Category. Organize your data into a category according to attributes that contain similar
business data. Specify where to display the extensible flexfield in the Order Management work area, such as on
the order header or order line. You can use only one category for each entity.
4. Extensible Flexfield Context. Specify how to display the attribute. For example.
1869
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
Note.
Here's an example that displays an extensible flexfield in the Order Management work area.
1870
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
Note.
1. Additional Information. A dialog that displays when you click Actions > Edit Additional Information on the
sales order header in the Order Management work area.
2. Manage Order Extensible Flexfields. The setup page you use in the Setup and Maintenance work area to
define an extensible flexfield.
3. Additional Header Information. Specifies the data to display and how to display it in Additional Information.
4. Pages tab. You use the Pages tab to define each area where your extensible flexfield displays. In this example,
the Pages tab defines one area named Compliance Info and another area named HeaderEFFDetails. The
example displays HeaderEFFDetails in the dialog. You can define one or more area, and you can define one
more contexts in each area.
1871
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
In this example, the Pages tab defines HeaderContext1 and HeaderContext2. However, for brevity, the screen
capture displays only HeaderContext1. The Sequence specifies the sequence to use when displaying these
contexts in the area, with 1 displaying at the top, 2 below 1, 3 below 2, and so on.
5. Sequence and Display Name for page. Defines the name for each category that displays in the dialog.
Sequence specifies the sequence to display the pages in the dialog. In the example, the Sequence is
10 for Compliance Info and 20 for HeaderEFFDetails, so the dialog displays Compliance Info first, then
HeaderEFFDetails.
6. Sequence and Display Name for context. Defines the name for each context that displays in the dialog. For
example, HeaderContext1 organizes similar business data into a concise area of the dialog.
7. Context Sensitive Segment. Specifies one ore more segments that display details for each attribute. The
Sequence specifies the sequence to use when displaying these segments in the area. You can define the
following segments in each context.
◦ 20 character segments. You can use up to 150 characters for each character segment.
◦ 10 number segments.
◦ Five date segments.
◦ Five date and time segments.
1872
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
The Additional Information dialog displays each extensible flexfield you create that references the
DOO_HEADERS_ADD_INFO flexfield category. For example, HeaderEFFDetails is an extensible flexfield.
4. Click Cancel.
5. In the Order Lines area, search for an item, then click Add.
6. On the order line, click the down arrow, then click Edit Additional Information.
7. Click Submit, then copy the sales order number, such as 57025.
8. On the Overview page, click Tasks > Manage Fulfillment Lines.
9. On the Manage Fulfillment Lines page, search for your sales order.
10. In the Search Results, scroll to the far right, then click Additional Information.
1873
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
The Additional Information dialog displays the extensible flexfield you create that references the
DOO_FULFILL_LINE_DTLS_ADD_INFO flexfield category. For example, Pack Ship Instruction is an extensible
flexfield.
1874
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
11. In the Fulfillment Line Details area, in the Attributes area, click General, scroll down, click Additional
Information, then notice the dialog that displays.
Another Example
Here's an Additional Information dialog that displays each extensible flexfield that references the
DOO_FULFILL_LINES_ADD_INFO flexfield category. For example, FulfillLineEFFInfo is an extensible flexfield.
Order Management displays each extensible flexfield in an Additional Information dialog. Here's an example that
displays the View Additional Information menu item on each order line on the Order Lines tab.
1875
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
In this example, View Additional Information allows the Order Entry Specialist to access the Source Line Info extensible
flexfield.
1876
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
You do some or all of this set up, depending on your business requirements. It might be necessary to also do some of
this flow when you update your extensible flexfield definition.
1. Manage Extensible Flexfields. Use the Manage Extensible Flexfields page in the Setup and Maintenance work
area to define your extensible flexfield. Click Deploy Flexfield to make it available throughout the architecture
and to other set up pages.
2. Order Management Work Area. Test your extensible flexfield. Depending on your setup, you create a
new sales order, search for a sales order, use a fulfillment view, and so on. For example, use the Additional
Information dialog when you create a new sales order to make sure your extensible flexfield displays and works
as expected.
1877
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
3. Manage Order Management Extensions. Use the Manage Order Management Extensions page in the Setup
and Maintenance work area to add your extensible flexfield to an order management extension.
4. Schedule New Process. Use the Publish Extensible Flexfield Attributes scheduled process to make your
extensible flexfield available to various parts of Order Management, other set ups in Oracle Fusion Applications,
and integrations. This scheduled process updates the rule dictionaries in business rules, constraints, business
events, Integration Cloud Service, and the service mappings that you use for an internal integration.
5. Various Set Ups. Here's where you can use your extensible flexfield.
Set Up Description
◦ Pretransformation
◦ Transformation
◦ Posttransformation
◦ Routing
◦ Assignment
◦ Branching Expression
◦ Compensation Pattern
◦ Cost of Change
Business Event Use an extensible flexfield to help determine when to raise a business event, and the actions
to take when you raise it.
Constraint Use an extensible flexfield to constraint a sales order attribute. Use a constraint to constrain
an extensible flexfield.
Integration Cloud Service Use an extensible flexfield with Integration Cloud Service to help achieve and manage an
integration between Order Management and a technology or application.
◦ Order Import
◦ Transportation Management
Integration with an Oracle Fusion Use a service mapping to integrate with an Oracle Fusion Application.
Application
◦ Shipping
◦ Accounts Receivables
◦ Purchasing
1878
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
Set Up Description
◦ Receiving
6. Web Service. If you use one of these web services, then manually update your extensible flexfield definition in
the web service payload.
◦ CreateOrder
◦ FulfillOrderService
◦ FulfillmentResponseService
7. Schedule New Process. Use scheduled process Import Oracle Fusion Data Extensions for Transactional
Business Intelligence to make your extensible flexfield is available in area Subject Areas of Oracle Transactional
Business Intelligence.
Related Topics
• Overview of Importing Orders into Order Management
1879
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
Note.
• New segments you create. To simplify setup and maintenance, use the same value for the Code attribute and
the API Name attribute. You use API Name throughout the setup, such as during integration setup, with web
services, business rules, business intelligence, and so on. You can't modify Code or API Name after you create
the segment.
• Segments that already exist. Don't modify API Name. Extensible flexfield logic examines API Name. If its
empty, then the logic uses the value in Code, so it isn't necessary to define API Name. If you do modify API
Name, then your flexfield might fail with unexpected results at run time.
1880
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
• Enter a unique code, name, and description for each segment. The Order Management work area doesn't
display these values, so use whatever nomenclature is most helpful to you during setup and maintenance.
• Don't include spaces in the Code attribute. Spaces will cause a run time error.
Make sure the name for each segment or context you create uses the correct nomenclature.
Character Description
. Period
- Hyphen
_ Underscore
, Comma
: Colon
/ Forward slash
If you encounter an invalid alias error when you run the Publish Extensible Flexfield Attributes scheduled process, then
make sure your contexts and segments use the correct nomenclature.
1881
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
Note.
• Include an If statement that makes sure each context and segment that your extension references exists and
contains a value. If you don't check for missing objects and empty values, then your extension might fail with
unpredictable results.
• Use the getOrCreateContextRow method to create or update a value in an extensible flexfield. If the object
doesn't exist, then this method creates it, so it isn't necessary to determine whether the object exists before you
use this method to do an update.Use getContextRow to only get a row.
• Use Context Code when you reference an extensible flexfield context.
• Use API Name when you reference an extensible flexfield segment. If you don't specify API Name when you set
up the extensible flexfield, then use Segment Code but with underscores ( _ ) instead of spaces ( ).
• Your Groovy code must traverse the context and the segment to get all data from the extensible flexfield.
Here's an example that uses a while statement to traverse all data.
def complianceDetails = header.getOrCreateContextRow("ComplianceDetails");
1882
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
if( "Y".equals(hazardous) ) {
// get details for fulfill line context PackShipInstruction
Assume you set up an extensible flexfield named Sample Requested. Here's the values it can contain.
• Complimentary
• Charge
• No Sample
You can then set up a rule that populates price details for the sample lines according to whether the value is
Complimentary or Charge.
Make sure you run the defaulting rule during one of these types of transformations when you process the
transformation rule. You can't default an attribute value into an extensible flexfield.
Pretransformation Use an extensible flexfield when some other transformation logic requires the default attribute
value.
For example, if you must use the defaulted attribute value to determine whether to add a free
sample item during transformation, then define a pretransformation rule that sets the default
value.
Posttransformation Use Posttransformation when transformation must occur before you run your defaulting rule.
For example, if you plan to add an item during transformation, and you also plan to use an
extensible flexfield attribute on the order header to determine the defaulted value to set for the
new fulfillment line.
1883
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
For guidelines that describe how to use an extensible flexfield in a business rule, see the Guidelines for Creating
Business Rules topic.
Note.
• Identify your requirements for change management. For example, determine whether the orchestration
process must compensate when an extensible flexfield value changes, and the action to take during
compensation, such as scheduling, calling Accounts Receivables, and so on.
1884
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
◦ Any extensible flexfield. Enable the Use Flexfield Attributes option on the header of the orchestration
process definition.
◦ A specific extensible flexfield. Enable the Use Flexfield Attributes option in the Change Management
area of the orchestration process definition. Add it to the orchestration process step that references the
extensible flexfield. Also define a compensation pattern on this step.
Use the compensation pattern to specify the action to perform, such as Cancel, Create, Update, and so
on, depending on the value that changes. You can configure your set up to send an update when a single
value changes and to skip sending an update when other values change. This approach provides more
detailed control regarding the compensation you do.
pseudocode:
If segment3 changes, then cancel task x, and then recreate task x.
If segment4 changes, then do nothing.
If segment5 changes, then call an update service.
For a detailed code example, see the Compensate Sales Orders That Change topic.
◦ To ignore changes to all extensible flexfield values, make sure Use Flexfield Attributes for each step in the
Change Management area isn't enabled.
Change management ignores each change that the Order Entry Specialist makes to an extensible flexfield value that
you set up on the sales order header.
Apply guidelines when you use the order import template to import data for an extensible flexfield.
• Assign the Table Column attribute of each segment so it references the correct column in the order import
template.
• Add a comment in Excel to document your set up.
• Use the DOO_ORDER_HDRS_ALL_EFF_B_INT worksheet to capture extensible flexfield details for order
headers.
• Use the DOO_ORDER_LINES_ALL_EFF_B_INT worksheet to capture extensible flexfield details for fulfillment
lines.
• Use columns, such as ATTRIBUTE_CHAR1, to capture details for each attribute.
• Don't modify worksheet names or column names. Instead, add a comment.
You can't add an extensible flexfield on an order line entity. You can add one only on the order header entity or the
fulfillment line entity. The template uses the phrase DOO_ORDER_LINES, but it uses details that you add on the
DOO_ORDER_LINES_ALL_EFF_B_INT worksheet to interact with extensible flexfields on the fulfillment line, not on the
order line.
For details, see the Import Orders into Order Management topic.
1885
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
This example illustrates how to set up the Compliance Info segment that references the ATTRIBUTE_CHAR1 column.
Add extensible flexfield details to the payload that Order Management uses to communicate with the web service.
• Get an example payload from the Example Web Service Payloads That Integrate Order Management topic. A
range of examples are available, such returns, coverage, configurations, and so on. These payloads include
most of the sales order data that you require.
• If you create your own payload, then create it according to the WSDL definition that the payload requires. For
details, see the Use Your Own Payload to Import Extensible Flexfields topic.
• Run the Publish Extensible Flexfield Attributes scheduled process.
1886
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
• Copy extensible flexfield data from the log file that the scheduled process creates into the XSD file that contains
your payload. Copy this data onto each object that requires extensible flexfield data. This approach helps to
keep your channel system synchronized with the set up in Order Management.
• Use the ADF import service. Don't use the SOA import service.
Here's an example payload that copies one section of code from the log file into the XSD file.
For details, see the Overview of Using Web Services to Integrate Order Management topic.
1887
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
Use an extensible flexfield when you integrate with some other Oracle Fusion Application, such as Pricing, Receivables,
Shipping, Receiving, or Purchasing. You set up a service mapping that's similar to a service mapping that you set up for
Oracle Fusion Pricing. You use an extensible flexfield to store values that the service mapping requires.
Note.
• Copy the name of the view object from the log file. The service mapping uses the view object to get data from
your extensible flexfield. Use the log file that the Publish Extensible Flexfield Attributes scheduled process
creates.
• Use the _Custom suffix when you define each new entity.
1888
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
• Use an integration algorithm to implement complex logic. For example, assume you must concatenate an item
with the coverage that covers the item, add quantity, then store the results in a descriptive flexfield for Accounts
Receivable. You would use an integration algorithm to implement this requirement.
Note.
• The Order Entry Specialist can use the Sales Order report when creating or viewing a sales order.
1889
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
<?context/segment?>
where
◦ context. Name of the extensible flexfield context.
◦ / (forward slash). You must use the forward slash between context and segment.
◦ segment. Name of the extensible flexfield segment.
◦ You must use a set of question marks ( ?? ) to enclose context/segment.
◦ You must use a set of angle brackets ( < > ) to enclose the question marks.
For example, assume you set up an extensible flexfield that uses Context1 to store details about trade
compliance, and SegmentA to store the compliance description. Here's the code you use.
<?Context1/SegmentA?>
Modify Analytics
1890
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
Oracle Transaction Business Intelligence (OTBI) provides analytic reporting. You can display extensible flexfield data in
OTBI.
Note.
• Enable the BI Enabled option when you set up your extensible flexfield.
• Run scheduled process Import Oracle Fusion Data Extensions for Transactional Business Intelligence. This
process updates OTBI so it displays your extensible flexfields in area Subject Areas in OTBI.
• Add your extensible flexfields from Subject Areas into a report in OTBI.
• Here's the format that OTBI uses.
Category_Context
1891
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
For example.
Additional Fulfillment Line Information_Additional Details1
where
◦ Additional Fulfillment Line Information is the category
◦ Additional Details1 is the context
Related Topics
• Overview of Importing Orders into Order Management
Set Up
Set Up Extensible Flexfields in Order Management
Set up an extensible flexfield in Order Management Cloud.
In this example, set up an extensible flexfield so the Order Entry Specialist can view sales order status from the source
order.
1892
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
This topic includes example values. You might use different values, depending on your business requirements.
Attribute Value
For details, see the Job Roles and Duty Roles That You Use to Implement Order Management topic.
2. In the Navigator, click Setup and Maintenance.
3. In the Setup and Maintenance work area, go to the task.
◦ Offering: Order Management
◦ Functional Area: Orders
◦ Task: Manage Order Extensible Flexfields
4. On the Manage Order Extensible Flexfields page, enter the value, then click Search.
Attribute Value
Attribute Value
Code SourceLineInfo
1893
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
Attribute Value
Add a check mark to the Translatable option only if you must translate the text in the context
to another language.
You must use Single Row for any extensible flexfield that you use in Order Management.
Values for some attributes, such as Code, automatically populate. In general, don't modify the predefined
values.
10. On the Context Usages tab, click Actions > Create, set the value, then click Save.
Attribute Value
Attribute Value
Name Status
Code Status
The Create Segment page automatically sets the value for API Name. In this example, it sets
the value to status, and uses lower case for the first letter. You must use the same value for
API Name that the XML uses when it creates the sales order.
1894
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
Attribute Value
You can use choose any column. Choose a column you aren't already using to store some
other value.
To view the values that are available, click the down arrow, then click Search. In the Search
and Select dialog, remove any values that display in the Name attribute, then click Search.
Prompt Status
Attribute Value
Code SourceLineInfo
1895
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
Attribute Value
Attribute Value
Name SourceLineInfo
6. In the search results, click the row that contains SourceLineInfo in the Name column, then click Apply > OK.
7. On the Edit Extensible Flexfield page, click Save and Close.
Column Value
extensible_flexfield_example_payload.xml includes code that's part of the payload that Order Management creates for
the sales order when it submits a sales order that includes an extensible flexfield. It includes the XML that defines the
namespace. Click the Download Files link in the Related Topics section at the end of this topic to access this file.
• Context Code determines SourceLineInfo.
1896
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
Attribute Value
SOURCE_ORDER_NUMBER PMC-170113-001
ORDER_NUMBER 48030
FULFILL_LINE_NUMBER 1
CONTEXT_CODE SourceLineInfo
ATTRIBUTE_CHAR1 FRAUD_HOLD
◦ On the Manage Extensible Flexfield page, click Actions > Download Flexfield Archive.
◦ Wait for the dialog to display 100%, then click Download.
◦ In the Opening dialog, click OK.
◦ Save the file to a folder of your choice.
1897
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
Related Topics
• Download Files
• How to Include EFF Attributes in the Order Creation Payload - Invoking Web Service
• Flexfield Segment Properties
• Job Roles and Duty Roles That You Use to Implement Order Management
Attribute Value
Status Succeeded
1898
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
3. The context determines the attributes that display according to criteria you specify. A context is part of a
hierarchy of attributes.
◦ Entity and entity category represent the top level of the hierarchy.
◦ Contexts represent the middle levels.
◦ Attributes represent the lowest level.
4. Use the Pages tab in the Categories Details area to define pages and to associate contexts to Order
Management pages.
5. Use the Manage Order Extensible Flexfields page to deploy each of your extensible flexfields.
6. Sign out of Order Management, then sign back in to Order Management.
If you create a new segment, create a new context, change the default on a segment, and so on, then you must
do this step so Order Management can update your changes throughout the Order Management work area.
Headers DOO_HEADERS_ADD_INFO
Lines DOO_LINES_ADD_INFO
FulfillLines DOO_FULFILL_LINES_ADD_INFO
Payments DOO_PAYMENTS_ADD_INFO
PriceAdjustments DOO_PRICE_ADJUSTMENTS_ADD_INFO
SalesCredits DOO_SALES_CREDITS_ADD_INFO
OrchestrationTaskActivity DOO_ACTIVITIES_ADD_INFO
FulfillLineDetails DOO_FULFILL_LINE_DTLS_ADD_INFO
LotSerialNumber DOO_LOT_SERIAL_NUM_ADD_INFO
The Category Hierarchy and Preconfigured Context Values aren't available for these extensible flexfields.
1899
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
where
• You change ADD_CONTEXT_HERE to the context code.
• You change ADD_SEGMENT_HERE to the segment.
1900
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
• You add extensible flexfields details as the last line of the order line details, immediately before </
ns2:OrchestrationOrderRequestLine>.
For example.
<ns2:AdditionalFulfillmentLineInformationCategories
xsi:type="ns12:j_FulfillLineEffDooFulfillLinesAddInfoprivate"
xmlns:ns12=http://xmlns.oracle.com/apps/scm/doo/processOrder/flex/fulfillLineCategories/
xmlns:ns22=http://xmlns.oracle.com/apps/scm/doo/processOrder/flex/fulfillLineContextsB/
xmlns:ns8="http://xmlns.oracle.com/apps/scm/doo/processOrder/model/">
<ns8:Category>DOO_FULFILL_LINES_ADD_INFO</ns8:Category>
<ns8:SourceTransactionLineIdentifier>1</ns8:SourceTransactionLineIdentifier>
<ns8:SourceTransactionScheduleIdentifier>1</ns8:SourceTransactionScheduleIdentifier>
<ns12:FulfillLineEffBPCTESTAUGprivateVO>
<ns8:ContextCode>PCTESTAUG</ns8:ContextCode>
<ns22:pctestaugseg1>Working</pctestaugseg1>
</ns12:FulfillLineEffBPCTESTAUGprivateVO>
</ns2:AdditionalFulfillmentLineInformationCategories>
</ns2:OrchestrationOrderRequestLine>
where
Notice the value for the FulfillLineEffBPCTESTAUGprivateVO virtual object. You will verify it later.
2. Use ReceiveOrderRequestService to import the payload. For details, see the Overview of Using Web Services to
Integrate Order Management topic.
Attribute Value
1901
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
◦ On the Overview tab, in the Definition Parts area, click the link next to
J_FulfillLineEFFDooFulfillLinesAdd.
1902
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
This value must match the value you included earlier in your import payload. For example,
<ns12:FulfillLineEffBPCTESTAUGprivateVO>.
3. Verify the context code.
Attribute Value
1903
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
Attribute Value
Code PCTESTAUG
◦ Verify the search results display your context, then click Actions > Edit.
◦ On the Edit Context page, verify the context contains the values you imported.
On the header.
Attribute Value
Code PCTESTAUG
Note this value. You will use it later when you verify the segment.
Attribute Value
Name PCTESTAUGSEG1
Code PCTESTAUGSEG1
On the Context usages tab, make sure a row exists that contains this value.
Attribute Value
1904
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
For example.
If you prefer not to use the Manage Order Extensible Flexfields page, then as an alternative, run a SQL query
against the Oracle database.
select
fdct.application_ID,
fdct.descriptive_flexfield_code,
fdct.context_code,
fdcb.context_identifier,
fdcb.enabled_flag,
fdct.description
1905
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
from
fnd_df_contexts_TL fdct,
fnd_df_contexts_B fdcb
where
fdct.context_code = fdcb.context_code and
fdct.application_id = fdcb.application_id and
fdct.language = 'US' and
fdct.descriptive_flexfield_code = 'DOO_FULFILL_LINES_ADD_INFO';
APPLICATION_ID DESCRIPTIVE_FLEXFIELD_CODE
CONTEXT_CODE CONTEXT_IDENTIFIER ENABLED_FLAG
10008 DOO_FULFILL_LINES_ADD_INFO
LinePrcOverride Lineprcoverride Y
10008 DOO_FULFILL_LINES_ADD_INFO
Accounting_Rule AccountingRule N
10008 DOO_FULFILL_LINES_ADD_INFO
PCTESTAUG Pctestaug Y
1906
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
Pctestaug is the value of attribute API Name you noted earlier on the Edit Context page.
1907
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
<attribute>EffLineId</attribute>
</key>
</xsd:appinfo>
</xsd:annotation>
<xsd:complexContent>
<xsd:extension base="ns0:FulfillLineEff">
<xsd:sequence>
<xsd:element name="pctestaugseg1" type="xsd:string" minOccurs="0" nillable="true"></xsd:element>
</xsd:sequence>
</xsd:extension>
</xsd:complexContent>
</xsd:complexType>
<xsd:element name="pctestaug" type="Pctestaug"></xsd:element>
</xsd:schema>
This value must match the value you included earlier in your import payload.
If you prefer not to use SoapUI to verify the flexfield segment, then as an alternative, run a SQL query against
the Oracle database.
select
fdst.DESCRIPTIVE_FLEXFIELD_CODE,
fdst.CONTEXT_CODE,
fdst.SEGMENT_CODE,
fdst.NAME,
fdsb.SEGMENT_IDENTIFIER,
fdsb.COLUMN_NAME,
fdsb.SEQUENCE_NUMBER
from
fnd_df_segments_tl fdst,
fnd_df_segments_b fdsb
where
fdst.APPLICATION_ID = fdsb.APPLICATION_ID and
fdst.ENTERPRISE_ID = fdsb.ENTERPRISE_ID and
fdst.DESCRIPTIVE_FLEXFIELD_CODE = fdsb.DESCRIPTIVE_FLEXFIELD_CODE and
fdst.CONTEXT_CODE = fdsb.CONTEXT_CODE and
fdst.SEGMENT_CODE = fdst.SEGMENT_CODE and
fdst.language = 'US' and
fdst.descriptive_flexfield_code = 'DOO_FULFILL_LINES_ADD_INFO'
order by
fdst.CONTEXT_CODE,
fdsb.SEQUENCE_NUMBER;
DESCRIPTIVE_FLEXFIELD_CODE
CONTEXT_CODE SEGMENT_CODE NAME SEGMENT_IDENTIFIERCOLUMN_NAME
DOO_FULFILL_LINES_ADD_INFO
Accounting_Rule PC 1 pc1 PC 1 ATTRIBUTE_CHAR1
DOO_FULFILL_LINES_ADD_INFO
LinePrcOverride SalePrcOverrideVal SalePrcOverrideVal saleprcoverrideval ATTRIBUTE_NUMBER1
DOO_FULFILL_LINES_ADD_INFO
PCTESTAUG PCTESTAUGSEG1 PCTESTAUGSEG1 pctestaugseg1 ATTRIBUTE_CHAR7
1908
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
The pctestaugseg1 value in the SEGMENT_IDENTIFIER column must match the value in <ns22:pctestaugseg1>
from your import payload.
Related Topics
• Use SQL to Query Order Management Data
• Example Web Service Payloads That Integrate Order Management
• Guidelines for Using Web Services to Integrate Order Management
Attribute Value
3. In the search results, click the row that contains Fulfillment Line Information in the Name column, then click
Actions > Download Flexfield Archive.
4. In the Confirmation dialog, click Download, then save the .zip file to any folder.
The file manager for your operating system opens. For example, if you're using Microsoft Windows, then
Windows Explorer opens.
5. In your file manager, double-click 10008_DOO_FULFILL_LINES_ADD_INFO.zip, then expand it to the view
folder.
For example.
C:\downloads\10008_DOO_FULFILL_LINES_ADD_INFO.zip\oracle\apps\scm\doo\processOrder\flex
\fulfillLineContextsB\view
The FulfillLineEffBSourceLineInfoprivateVO.xml file contains the extensible flexfield segment that you must
reference.
6. Use an xml editor to open FulfillLineEffBSourceLineInfoprivateVO.xml.
7. Identify the values that you will need in your web service payload.
◦ Search for the attribute name.
<ViewAttribute Name="status" EntityUsage="FulfillLineEffEO" EntityAttrName="status"
AliasName="status">
1909
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
xsi:type="ns12:j_FulfillLineEffDooFulfillLinesAddInfoprivate"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:ns12="http://xmlns.oracle.com/apps/scm/doo/processOrder/flex/fulfillLineCategories/"
xmlns:ns22="http://xmlns.oracle.com/apps/scm/doo/processOrder/flex/fulfillLineContextsB/"
xmlns:ns8="http://xmlns.oracle.com/apps/scm/doo/processOrder/model/">
<ns8:Category>DOO_FULFILL_LINES_ADD_INFO</ns8:Category>
<ns8:SourceTransactionLineIdentifier>1</ns8:SourceTransactionLineIdentifier>
<ns8:SourceTransactionScheduleIdentifier>1</ns8:SourceTransactionScheduleIdentifier>
<ns8:SourceTransactionLineNumber>1</ns8:SourceTransactionLineNumber>
<ns8:SourceTransactionScheduleNumber>1</ns8:SourceTransactionScheduleNumber>
<ns12:FulfillLineEffBSourceLineInfoprivateVO>
<ns8:ContextCode>SourceLineInfo</ns8:ContextCode>
<ns22:status>Working</ns22:status>
</ns12:FulfillLineEffBSourceLineInfoprivateVO>
</mod:AdditionalFulfillmentLineInformationCategories>
where
◦ ContextCode contains the value you found for the context code in
FulfillLineEffBSourceLineInfoprivateVO.xml.
◦ status contains the value you found for the attribute in FulfillLineEffBSourceLineInfoprivateVO.xml
In later releases, its recommended that you use Order Import Service instead of Receive Order Request Service. For
details, see the Web Services You Can Use to Integrate Order Management topic.
Use the ProcessOrderRequest operation. You can also use the ProcessOrderRequestSync operation to get a response in
SOAP UI for testing purposes.
As an alternative to examining the .zip file, you can get the attribute name and context code in the output file when you
run the Publish Extensible Flexfield Attributes scheduled process. For details, see the Set Up Extensible Flexfields in
Order Management topic.
Assume you need a flexfield that your users can use to store a value that identifies the bill-to customer.
• Edit the Header Information extensible flexfield instead of Fulfillment Line Information.
• Add a context named PMC Header and segment named customerBillToId to the Header Information extensible
flexfield.
• Download and open 10008_DOO_HEADERS_ADD_INFO.zip.
• Navigate to oracle/apps/scm/doo/processOrder/flex/headerContextsB/view in the .zip file.
• Open the HeaderEffBPMC__HeaderprivateVO.xml file.
• Identify the context code. Search for the value.
<Property Name="FND_ACFF_EFF_CONTEXT_CODE" Value="PMC Header"/>
For example.
<mod:AdditionalHeaderInformationCategories
xsi:type="ns12:j_HeaderEffDooHeadersAddInfoprivate"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
1910
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
xmlns:ns3="http://xmlns.oracle.com/apps/scm/doo/processOrder/service/"
xmlns:ns12="http://xmlns.oracle.com/apps/scm/doo/processOrder/flex/headerCategories/"
xmlns:ns22="http://xmlns.oracle.com/apps/scm/doo/processOrder/flex/headerContextsB/"
xmlns:ns8="http://xmlns.oracle.com/apps/scm/doo/processOrder/model/">
<ns8:Category>DOO_HEADERS_ADD_INFO</ns8:Category>
<ns12:HeaderEffBPMC__HeaderprivateVO>
<ns8:ContextCode>PMC Header</ns8:ContextCode>
<ns22:specialHandlingInstructions>West Coast Packers</ns22:specialHandlingInstructions>
</ns12:HeaderEffBPMC__HeaderprivateVO>
</mod:AdditionalHeaderInformationCategories>
1911
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
<mod:BillToAccountSiteUseIdentifier>300000075240957</mod:BillToAccountSiteUseIdentifier>
<mod:ShippingInstructions>Handle with care</mod:ShippingInstructions>
<mod:PackingInstructions>Pack with shockproof material</mod:PackingInstructions>
<mod:RequestedShipDate>2020-04-07T10:10:10</mod:RequestedShipDate>
<mod:PaymentTerms>NG_IMMEDIATE</mod:PaymentTerms>
<mod:TransactionCategoryCode>ORDER</mod:TransactionCategoryCode>
<mod:PartialShipAllowedFlag>false</mod:PartialShipAllowedFlag>
<mod:OrigSysDocumentReference>ORIGSYS</mod:OrigSysDocumentReference>
<mod:OrigSysDocumentLineReference>ORIGSYSLINE</mod:OrigSysDocumentLineReference>
<mod:AdditionalFulfillmentLineInformationCategories
xsi:type="ns12:j_FulfillLineEffDooFulfillLinesAddInfoprivate" xmlns:xsi="http://www.w3.org/2001/
XMLSchema-instance" xmlns:ns12="http://xmlns.oracle.com/apps/scm/doo/processOrder/flex/
fulfillLineCategories/" xmlns:ns22="http://xmlns.oracle.com/apps/scm/doo/processOrder/flex/
fulfillLineContextsB/" xmlns:ns8="http://xmlns.oracle.com/apps/scm/doo/processOrder/model/">
<ns8:Category>DOO_FULFILL_LINES_ADD_INFO</ns8:Category>
<ns8:SourceTransactionLineIdentifier>1</ns8:SourceTransactionLineIdentifier>
<ns8:SourceTransactionScheduleIdentifier>1</ns8:SourceTransactionScheduleIdentifier>
<ns8:SourceTransactionLineNumber>1</ns8:SourceTransactionLineNumber>
<ns8:SourceTransactionScheduleNumber>1</ns8:SourceTransactionScheduleNumber>
<ns12:FulfillLineEffBSourceLineInfoprivateVO>
<ns8:ContextCode>SourceLineInfo</ns8:ContextCode>
<ns22:status>Working</ns22:status>
</ns12:FulfillLineEffBSourceLineInfoprivateVO>
</mod:AdditionalFulfillmentLineInformationCategories>
</mod:OrchestrationOrderRequestLine>
<mod:OrderProcessingPreferences>
<mod:CreateCustomerInformationFlag>true</mod:CreateCustomerInformationFlag>
<mod:SubmitFlag>true</mod:SubmitFlag>
</mod:OrderProcessingPreferences>
</dood:OrchestrationOrderRequest>
</dood:process>
</soapenv:Body>
</soapenv:Envelope>
Related Topics
• Use SQL to Query Order Management Data
• Example Web Service Payloads That Integrate Order Management
• Guidelines for Using Web Services to Integrate Order Management
1912
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
<ns2:AdditionalFulfillLineInformationCategories
xsi:type="ns12:j_FulfillLineEffDooFulfillLinesAddInfoprivate"
xmlns:ns12="http://xmlns.oracle.com/apps/scm/doo/processOrder/flex/fulfillLineCategories/"
xmlns:ns22="http://xmlns.oracle.com/apps/scm/doo/processOrder/flex/fulfillLineContextsB/"
xmlns:ns8="http://xmlns.oracle.com/apps/scm/doo/processOrder/model/"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<ns8:Category>DOO_FULFILL_LINES_ADD_INFO</ns8:Category>
<!-- Nodes below repeats for each of the context that you want to update -->
<!-- The node itself contains the name of the virtual object for the context-->
<!-- To get these details, run the Publish Extensible Flexfields scheduled process-->
<!-- This example assumes you are updating two contexts -->
<ns12:FulfillLineEffBPackShipInstructionprivateVO>
<ns8:ContextCode>PackShipInstruction</ns8:ContextCode>
<ns22:_PackingInstruction>NKResponsePack</ns22:_PackingInstruction>
<ns22:_ShippingInstruction>NKResponseShip</ns22:_ShippingInstruction>
<ns22:_ShippingCost>31</ns22:_ShippingCost>
<ns22:_NeedbyDate>2016-04-21</ns22:_NeedbyDate>
<ns22:_PickDate>2016-04-21T12:12:12</ns22:_PickDate>
</ns12:FulfillLineEffBPackShipInstructionprivateVO>
<ns12:FulfillLineEffBFulfillLineContext1privateVO>
<ns8:ContextCode>FulfillLineContext1</ns8:ContextCode>
<ns22:_FL1AttributeChar1>FLC1-Resp</ns22:_FL1AttributeChar1>
<ns22:_FL1AttributeChar2>FLC2-Resp</ns22:_FL1AttributeChar2>
<ns22:_FL1AttributeNum1>620</ns22:_FL1AttributeNum1>
<ns22:_FL1AttributeDate1>2016-03-13</ns22:_FL1AttributeDate1>
<ns22:_FL1AttributeDateTime1>2016-03-13T12:12:12</ns22:_FL1AttributeDateTime1>
</ns12:FulfillLineEffBFulfillLineContext1privateVO>
</ns2:AdditionalFulfillLineInformationCategories>
</ns1:FLine>
</ns1:FulfillmentRequest>
</soap:Body>
</soap:Envelope>
where
Related Topics
• Guidelines for Integrating Order Management
Use Rich Text Files to Print Extensible Flexfield Data in Order Headers
Use an RTF file (Rich Text File) to print extensible flexfield data in the order header.
1. Download, then install the BI Publisher for Microsoft Word plugin so you can edit the RTF layout. Select a
version that's compatible with your version of Microsoft, such as Oracle BI Publisher Desktop 11.1.1.9.0 for 32 bit
Office on Windows.
1913
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
1914
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
3. Set the BI Publisher related properties in the RTF template. See the BI Publisher documentation for details.
1915
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
To view an example rtf file, click Download Files in the Related Links section at the end of this topic, then open
sales_order_report_with_extensible_flexfield.rtf.
1916
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
5. Examine the example XML payload that represents a sales order that you send to BIP to create the report.
1917
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
1918
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
Related Topics
• Download Files
Business Rules
Use Extensible Flexfields in Transformation Rules
Use a transformation rule to add or change data in a fulfillment line. The rule determines information to add or change
according to details that already exist in the fulfillment order.
You will create a rule.
• If Preferred customer places a sales order that includes AS54888 Desktop Computer on or before 01/01/2019
12:00 AM, then set Shipment Priority to High Priority, and add a free printer to the shipment.
1919
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
Create a rule that references an extensible flexfield that stores loyalty details.
For details about how to create a business rule, see the Overview of Using Business Rules With Order Management
topic.
This topic includes example values. You might use different values, depending on your business requirements.
1920
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
Do it.
Attribute Value
1921
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
Attribute Value
Description If loyal customer places a sales order that includes AS54888 Desktop Computer on or
before promotion date, then add a free printer to the sales order.
◦ Click And.
◦ In the Create Condition dialog, enter item, wait a moment, then click Item (Item Definition).
1922
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
◦ Click And.
◦ In the Create Condition dialog, enter ordered, wait a moment, then click Ordered Date (Order Header).
◦ Set the operator to is before.
◦ Click Select Date and Time, set it to 01/01/2019 12:00 AM, then click OK > OK.
5. Create the Do statement.
◦ Click Then > Do > New Action > Set a Value, then click .
◦ In the Create Action dialog, enter ship, wait a moment, then click Shipment Priority (Order Header).
◦ Click Search.
◦ In the Search dialog, click Advanced > Search, then notice the dialog displays values you can set for this
attribute.
This functionality helps make sure you specify a value that Order Management can use and understand
for the attribute. For example, Shipment Priority can contain only alphabetic data.
◦ In the Meaning list, click High Priority > OK > OK > Save and Close.
6. Activate and publish your rule.
1923
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
3. To the right of View TransformationDT, click down arrow > Expand > Add Rule > Show Advanced Settings,
then set values.
Attribute Value
Description If loyal customer places a sales order that includes AS54888 Desktop Computer, on or before
promotion date, then add a free printer to the sales order.
Priority Medium
1924
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
Attribute Value
header is a OrderTransformationRules.HeaderVO
line is a OrderTransformationRules.LineVO
fline is a OrderTransformationRules.FulfillLineVO
headerEFFcat is a OrderTransformationRules.j_HeaderEffDooHeadersAdd
headerEFFCtxt is a OrderTransformationRules.headerEFFcat.HeaderEffBLo
For example, here's the rule that creates the first pattern, and the cursor is positioned to begin creating the
second pattern.
1925
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
1926
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
headerEFFcat headerEFFcat.HeaderEffBLoyalty_5FStatusprivateVO
contains headerEFFCtxt
1927
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
To create a test, click Add Test (green icon underneath the pattern), then click Simple Test.
Create the test criteria that identifies AS54888 Desktop Computer. If you include optional attributes, then make sure
you include a NOT NULL check for each optional attribute to avoid the NullPointerExceptions runtime error.
Create tests.
1928
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
Create them in the same way you created tests when you defined the hierarchy. You must include the double quotation
marks ( " ) as part of the value, where indicated. For example.
1929
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
Create the action that adds a fulfillment line for the free printer.
1. In the Then area, click Add Action > Assert New.
2. You must add a new fulfillment line, so enter AddNew > OrderTransformationRules.AddNewOrderLine.
3. In the Then area, click Edit Properties.
4. In the Properties dialog, set values, then click OK.
Name Value
newItemId 4954L
1930
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
Name Value
viewRowImpl fline.viewRowImpl
1931
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
Do it.
1. On the Manage Posttransformation Defaulting Rules page, click Add > Add Rule.
2. Click Expand > Show Advanced Settings, then set values.
1932
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
Attribute Value
Priority Medium
PostTransformationRules.FulfillLineVO.InventoryItemId is 4954L
Attribute Value
attrName "PackingInstructions"
viewRowImpl PostTransformationRules.FulfillLineVO.ViewRowImpl
Related Topics
• Overview of Using Business Rules With Order Management
• How Order Management Transforms Source Orders Into Sales Orders
1933
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
Here's the rule you create. For details, see the Overview of Using Business Rules With Order Management topic.
1934
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
orderFulfillLine
where
1935
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
Do it.
1. In the Navigator, click Setup and Maintenance.
2. In the Setup and Maintenance work area, go to the task.
1936
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
3. On the Manage Product Transformation Rules page, in the View list, click IF/THEN Rules.
4. Click Expand > Show Advanced Settings.
5. Create a rule.
Attribute Value
Priority Medium
Attribute Value
Root DooSeededOrchestrationRules.DOOHeader
7. Create IF statements.
◦ header is a OrderTransformationRules.HeaderVO
◦ line is a header/OrderLine
◦ fline is a header/OrderLine/OrderFulfillLine
◦ flineEFFCtgry is a OrderTransformationRules.j_FulfillLineEffDooFulfillLinesAddInfoprivateVO
◦ flineEFFCnts is a OrderTransformationRules.FulfillLineEffBProductInfoprivate
8. Create tests.
Make sure you include a hierarchy test when you create extensible flexfield variables. The extensible flexfield in this
example is ProductInfo. It contains the segment _CoverageProduct that you will use as a condition in the decision table.
1937
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
Note.
• Create a condition that examines the _CoverageProduct extensible flexfield segment and fline.ItemTypeCode
attribute.
• The actions modify the fline.InventoryItemId attribute to transform one product to another product, and also
modify the fline.ReservableFlag attribute.
• A business rule can't modify the value of an extensible flexfield.
• The ModifyEntity function modifies attribute values.
Related Topics
• Pricing Algorithm
• Service Mapping
• How Service Mappings, Pricing Algorithms, and Matrixes Work Together
• Use Extensible Flexfields to Integrate Order Management with Other Oracle Applications
An item attribute typically determines the orchestration process that runs and how to run orchestration process steps.
If no predefined attributes meet your requirements, then you can create your own extensible flexfield, use it to capture
important details about the item, then use it to select the fulfillment steps that run. You can write an assignment rule
that uses extensible flexfield data as part of the selection criteria.
Assume.
• You sell an item in your own country and to several other countries throughout the world.
• The item includes details that are protected through international trade agreements.
1938
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
• If you ship the item to a location that's outside of your own country, then the trade agreements require you to
consider it an export and screen it for trade compliance.
• You do a needs analysis and determine to create the Trade Compliance Details extensible flexfield and add it to
the order header so the Order Entry Specialist can enter the value Export to indicate whether the sales order is
an export.
You will create an assignment rule that references the extensible flexfield.
• If the Trade Compliance Details extensible flexfield contains the value Export, then assign the fulfillment line to
the Screen_Exports_for_Trade_Compliance orchestration process.
1939
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
This topic includes example values. You might use different values, depending on your business requirements.
1. Set up the extensible flexfield and the orchestration process. Make sure you publish the extensible flexfield. If
you don't publish, it won't show up the Manage Orchestration Process Assignment Rules page.
For details, see the Use Extensible Flexfields in Order Management topic.
2. Create the assignment rule.
Attribute Value
1940
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
◦ Click Compliance Info, drag it, then drop it into the IF area.
The phrase Order Fulfill Line indicates that the orchestration process you set will process order fulfillment
lines.
1941
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
Related Topics
• Overview of Using Business Rules With Order Management
Object Description
• Root: DooSeededOrchestrationRules.DOOHeader
• header is a DooSeededOrchestrationRules.DOOHeader
• fline is a header/childFLines
• flineEFF is a header/childFLines/flexContexts
• flineEFF.context.equalsIgnoreCase("Item_Information") is
DooSeededOrchestrationRules.Boolean.TRUE
• flineEFF.getFlexAttributeValue("_Reward_Item") isn't null
Note.
• The equalsIgnoreCase function is optional if you know the absolute case of the
argument.
• The getFlexAttributeValue() function on the flexContexts object looks up the extensible
flexfield value.
1942
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
Object Description
• DooSeededOrchestrationRules.Result (resultObjKey:FLine.fulfillLineId)
where
This example uses Tree Mode to maintain the hierarchy rather than explicitly creating the hierarchy. The forward slash
(/) specifies the hierarchy. For example.
• header/childFLines/flexContexts
In this example, you will define line selection criteria in an orchestration process to specify which orchestration process
steps to run for each fulfillment line. You define this criterion according to the value that an extensible flexfield contains.
You create a rule.
• If the Export Compliance status is Not Passed for an order line, then do a manual examination. Send other
order lines directly to shipping.
1943
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
You will use an extensible flexfield to store the value of the compliance status.
1944
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
This topic includes example values. You might use different values, depending on your business requirements.
1945
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
Attribute Value
Task DOO_TradeCompliance
5. In the row you just added, in the Line-Selection Criteria column, click Click for Rule.
6. In the Line-Selection Criteria dialog, click Add Rule > Show Advanced Settings, then set values.
Attribute Value
Description If the Export Compliance status is Not Passed for an order line, then perform a manual
examination.
Priority Medium
Use tree mode so you can include an extensible flexfield in the root hierarchy of an
orchestration rule.
1946
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
Attribute Value
Root DooSeededOrchestrationRules.DOOHeader
where
• Order Header is the root
• childFLines is a child of Order Header
• flexContexts is a child of childFLines and a grandchild of Order Header
This example uses Tree Mode to maintain the hierarchy rather than explicitly creating the hierarchy. Each forward slash
(/) specifies a hierarchy level.
header/childFLines/flexContexts
where
• header is the root. The root makes sure the rule processes data only in the child object that references the root.
• childFLines is the child. The child makes sure the rule processes data only in the grandchild object that
references the child.
• flexContexts is the grandchild.
1947
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
Attribute Value
Attribute Value
3. Under the field that contains header, add a check mark to the option that chooses the test, click Cut > Cut.
For example.
The hierarchy includes the extensible flexfield variables, so its not necessary to include tests when you define
the hierarchy.
4. Click Add Pattern.
5. In the field to the left of Is A, enter the value.
Attribute Value
1948
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
Attribute Value
Attribute Value
Attribute Value
This text will select lines only where the flexfield context is Compliance.
FLineEFF.context.equalsIgnoreCase("Compliance")
Is DooSeededOrchestrationRules.Boolean.TRUE
You will add the test criteria that identifies fulfillment lines that proceed through compliance testing. If the
attributes you reference are optional, then you include null value checks to avoid a null pointer exception at run
time.
2. Click Left Value.
3. In the Condition Browser, click Expression Builder.
4. In the Expression Builder, click Functions, expand FLineEFF > Context, click equalsIgnoreCase(String), then
click Insert Into Expression.
1949
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
For example.
To navigate the tree structure, expand the folders until you can view the functions of the context object.
FlineEFF is the pattern you declared earlier.
The context you expand is a fact in the FlineEFF pattern. It includes functions you can use to perform a variety
of calculations. Therefore, the expression you create includes the pattern, fact, and function.
5. In the window near the top of the dialog, replace the word String with the context for your extensible flexfield
condition. In this example, replace String with Compliance.
1950
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
For example.
1951
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
For example.
• If the value of the flexfield attribute named Compliance Status is Not Passed
1952
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
flineEFF.getFlexAttributeValue("_Compliance_Status")
Is "Not Passed "
1. In the test you just added, immediately to the right of the Right Value magnifying glass, click the down arrow,
then click Simple Test.
2. Click Left Value.
3. In the Condition Browser, click Expression Builder.
4. In the Expression Builder, click Functions, click FlineEFF.getFlexAttributeValue(String), then click Insert Into
Expression.
1953
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
For example.
5. In the window near the top of the dialog, replace the word String with the name of the flexfield attribute.
You must use an underscore to prefix the attribute name in a function. The attribute name is
Compliance_Status, so you use _Compliance_Status.
1954
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
For example.
FLineEFF.context.equalsIgnoreCase("Compliance")
Is DooSeededOrchestrationRules.Boolean.TRUE
flineEFF.getFlexAttributeValue("_Compliance_Status")
is "Not Passed"
where
1955
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
7. Click OK
8. In the Line-Selection Criteria dialog, click Save.
9. On the Edit Orchestration Process Definition page, click Save.
Related Topics
• Overview of Using Business Rules With Order Management
1956
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
Use tree mode to include an extensible flexfield in the root hierarchy of an orchestration rule. The hierarchy
includes extensible flexfield variables so it isn't necessary to add more tests when you define the hierarchy.
6. Define IF statements.
◦ header is a DOOSeededOrchestrationRules.DOOHeader
◦ fline is a header/childFlines
◦ flineEFF is a header/childFLines/flexContexts
where
1957
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
For example.
7. Create an expression that looks up the extensible flexfield value in the tests.
◦ flineEFF.context.equalsIgnoreCase("ProductInfo")
1958
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
For example.
8. Create tests.
Code Description
flineEFF.context.equalsIgnoreCase("ProductInfo")
Make sure the item isn't a coverage item.
is DooSeededOrchestration
Rules.Boolean.TRUE
1959
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
Code Description
flineEFF.getFlexAttributeValue("CoverageProduct")
Make sure the value in the flexfield isn't empty.
isn't null
For example.
9. Create an action.
This action creates the result to use for the fulfillment line that satisfies the If statement.
In the Condition Browser, select the attribute. This attribute sets resultObjKey to the run-time value of the
fulfillLineId.
1960
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
For example.
Related Topics
• Overview of Using Business Rules With Order Management
For example.
• Assume a customer with a Platinum loyalty status receives a follow up phone call about their order, and that
you defined an extensible flexfield named Loyalty that allows the Order Entry Specialist to store the loyalty
status.
• On the change order, assume you define another extensible flexfield named Customer Satisfaction that allows
the Order Entry Specialist to capture the level of customer satisfaction.
1961
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
• If Order Management already sent a request to the fulfillment system that schedules a follow up phone call, but
the Order Entry Specialist hasn't made the phone call, then the compensation pattern for customer satisfaction
might be Cancel, meaning don't call the customer.
• If the compensation pattern for customer satisfaction isn't Cancel, then the rule can continue with the
scheduled phone call.
You use an extensible flexfield in a change management rule the same way you use it in a line-selection rule. For details,
see the Use Extensible Flexfields In Line-Selection Rules topic.
Related Topics
• Compensate Sales Orders That Change
Identify Flexfield Contexts and Category Codes for Your Business Rules
Identify the flexfield contexts and category codes that you specify in an Oracle Business Rule.
In this example, assume you need to reference context code FND_ACFF_EFF_CONTEXT_CODE in your business rule.
The file manager for your operating system opens. For example, if you're using Microsoft Windows, then
Windows Explorer opens.
5. In your file manager, navigate to the folder in the .zip file that contains the xml you must examine.
. . .\file_name.zip\oracle\apps\scm\doo\processOrder\flex\fulfillLineContextsB\view
where
For example.
C:\Users\your_name\AppData\Local\Temp\10008_DOO_FULFILL_LINES_ADD_INFO.zip\oracle\apps\scm\doo
\processOrder\flex\fulfillLineContextsB\view
6. Use an XML editor to open the xml file that contains the context you must examine.
1962
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
◦ FulfillLineEffBFulfillLineContext1privateVO.xml
◦ FulfillLineEffBPackShipInstructionprivateVO.xml
For example.
Notice that the value is FulfillLineContext1. Use it when you set up your rule in Oracle Business Rules. For
example, here's the code you use in your rule.
8. Search for the ViewAttribute tag that contains the segment name you need.
ViewAttribute Name="_FL1AttributeChar1"
Notice that the value is FL1AttributeChar1. Use it when you set up your rule in Oracle Business Rules. For
example, here's the code you use in your rule.
HeaderEFF.getFlexAttributeDateValue("_CompleteCompliancedate")
or
FLineEFF. getFlexAttributeValue("_FL1AttributeChar1")
For details about this example, see the Reference Extensible Flexfields subtopic in the Guidelines for Creating
Business Rules topic.
Related Topics
• Use Business Rules in Orchestration Processes
1963
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
Pretransformation PreTransformationRules
Posttransformation PostTransformationRules
Transformation OrderTransformationRules
Routing DOOExternalInterfaceLayer
Assignment AssignLaunchRules
Rule Patterns and Hierarchies You Can Use With Extensible Flexfields
Patterns and Hierarchies for Extensible Flexfields That Display on Order Headers
Pattern Description
header is a dictionary.fact
For example.
header is a OrderTransformationRules.HeaderVO
where
1964
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
Pattern Description
my_header_extensible_flexfield_category
Here's the format.
header is a dictionary.j_HeaderEffDooHeadersAddInfoprivateVO
header is a dictionary.HeaderEffContextNameprivateVO
Note.
• dictionary identifies the name of the dictionary that your rule references.
• DOO_HEADERS_ADD_INFO is the category for an order header.
• ContextName identifies the name of the context.
Rule Patterns and Hierarchies for Extensible Flexfields That Display on Order Lines
Use rule patterns when your extensible flexfield displays on the order line or the fulfillment line.
Pattern Description
fline is a dictionary.FulfillLineVO
For example.
fline is a AssignLaunchRules.FulfillLineVO
where
1965
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
Pattern Description
For example.
FlineEFFdfaip is a
AssignLaunchRules.j_FulfillLineEffDooFulfilllinesAddInfoprivateVO
where.
For example.
• FlineEFFpsi is a AssignLaunchRules.FulfillLineEffBPackShipInstructionprivateVO
where
where
• dictionary identifies the name of the dictionary that your rule references.
• DOO_FULFILL_LINES_ADD_INFO is the category for each order line or fulfillment line.
• ContextName identifies the name of the context.
Rule Patterns and Hierarchies for Extensible Flexfields That Display on the General Tab of the Fulfillment Line
1966
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
Use patterns when your extensible flexfield displays on the General tab of the fulfillment line.
Pattern Description
my_fline_details is a dictionary.FulfillLineDetailVO
my_fline_details_extensible_flexfield_category
Here's the format.
my_fline_details_extensible_flexfield_category is a dictionary.
j_FulfillLineDetailEffDooFulfillLineDetailsAddInfoprivateVO
my_fline_details_extensible_flexfield_context
Here's the format.
my_fline_details_extensible_flexfield_context is a dictionary.
FulfillLineDetailEffBContextNameprivateVO
where
• dictionary identifies the name of the dictionary that your rule references.
• DOO_FULFILL_LINE_DTLS_ADD_INFO is the category for each fulfillment line detail.
• ContextName identifies the name of the context.
1967
Oracle SCM Cloud Chapter 10
Implementing Order Management Extend
1968
Oracle SCM Cloud Chapter 11
Implementing Order Management Email, Reports, Attachments, Social Media
Email
Administer Email Messaging in Order Management
Set up Order Management to send an email message when a business event occurs, such as when the sales order status
changes to Shipped.
Assume you must format the email that Order Management sends when the sales order status changes to Shipped.
Do it.
1. In the Navigator, click Setup and Maintenance.
2. In the Setup and Maintenance work area, go to the task.
◦ Offering: Order Management
◦ Functional Area: Orders
◦ Task: Manage Business Event Trigger Points
3. Optional. Send an email notification when the sales order goes into hold.
◦ On the Manage Business Event Trigger Points page, click the Hold row, then make sure the Active option
in this row contains a check mark.
◦ In the Details area, add a check mark to the Send Email Notification option.
1969
Oracle SCM Cloud Chapter 11
Implementing Order Management Email, Reports, Attachments, Social Media
4. Optional. Send an email notification when the order header status updates.
◦ On the Manage Business Event Trigger Points page, click the Order Header Status Update row, then
make sure the Active option in this row contains a check mark.
◦ In the Details area, add a check mark to the Raise Event option and the Send Email Notification option
for each Status Value, as necessary.
For example, to send an email notification when the order status changes to Closed, add a check mark to
the options in the Closed row.
The Send Email Notification option depends on the event, so you must make sure you add a check mark
to each option.
◦ Repeat this step for other status values, as necessary.
Administer Email Messaging for Status Updates on Fulfillment Lines
Administering Order Management to send an email notification when the status updates on a fulfillment line requires
that you modify the orchestration process definition.
1. On the Manage Business Event Trigger Points page, click the Fulfillment Line Status Update row, then make
sure the Active option in this row contains a check mark.
2. Click Save and Close.
3. On the Setup page, search for, then open Manage Orchestration Process Definitions.
4. On the Manage Orchestration Process Definitions page, search for ShipOrderGenericProcess.
Each orchestration process controls the status value for each fulfillment line, so you must modify the
orchestration process that controls the status value. In this example, you modify the orchestration process that
controls the shipping status value.
5. In the Search Results, click the row that contains ShipOrderGenericProcess, then click Actions > Edit.
6. In the Process Details area, click Status Conditions > Fulfillment Line Status Values > Edit Status Rule Set.
7. On the Edit Status Rule Set page, add a check mark to the Notify External System option and the Send Email
Notification option for each Status Value where you must send a notification.
For example, to send an email notification when the fulfillment line status changes to Shipped, add a check
mark to the options in the Shipped row.
The Send Email Notification option depends on the Notify External Systems event, so you must make sure you
add a check mark to each option.
8. Repeat step 7 for other status value, as necessary.
Order Management will send an email message when each fulfillment line that references this orchestration
process definition reaches the status that you specify in steps 7 and 8. Order Management sends this email to
the customer contact and to the ship-to contact that the sales order references.
9. Repeat steps 4 through 8 for each orchestration process definition in your deployment that updates status
values.
Guidelines
If your message includes party data, such as the Ship-to Contact, then make sure you set up the contact on the
customer account. For details, see the Overview of Displaying Customer Details on Sales Orders topic.
Make sure the attribute that you're using as part of the message contains a value on the sales order. For example, if
you're sending a message to the Ship-to Contact for order 768496, then make sure the Ship-to Contact on order 768496
contains a value.
1970
Oracle SCM Cloud Chapter 11
Implementing Order Management Email, Reports, Attachments, Social Media
Related Topics
• Overview of Displaying Customer Details on Sales Orders
Note.
• Use Oracle BI Publisher to modify format, such as add your company name and logo, or modify the template
message text.
• Use the From Address for Email Messages order management parameter to specify the value that Order
Management displays in the email From address. For details, see the Manage Order Management Parameters
topic.
In this example, modify the email template that Order Management uses for a status update.
1. In the Navigator, click Reports and Analytics.
For details, see book Oracle SCM Cloud Creating and Administering Analytics and Reports on My Oracle
Support.
2. On the Reports and Analytics page, click All Folders > Shared Folders.
3. Click Supply Chain Management > Order Management > Fulfillment Alerts.
Notice that the work area displays several templates, such as Hold Notification, Sales Order Line Status Update,
and Sales Order Status Update Notification.
4. Click Sales Order Status Update Notification.
5. On the Fulfillment Alerts page, click Actions > Edit Report.
6. Under SalesOrderStatusUpdateNotificationLayout, click Edit.
1971
Oracle SCM Cloud Chapter 11
Implementing Order Management Email, Reports, Attachments, Social Media
Related Topics
• Manage Order Management Parameters
• Oracle SCM Cloud Creating and Administering Analytics and Reports
Reports
Use Reports and Analytics with Order Management
Use the Reports and Analytics work area to get detailed reports for some aspects of Order Management.
Create a report that includes various types of data.
1972
Oracle SCM Cloud Chapter 11
Implementing Order Management Email, Reports, Attachments, Social Media
Try it.
1. In the Navigator, click Reports and Analytics.
For details, see the Reports and Analytics Work Area and Panel Tab topic.
2. On the Reports and Analytics page, click All Folders > Shared Folders.
3. Click Supply Chain Management > Order Orchestration > Transactional Analysis Samples > Past Due
Fulfillment Lines, then click the Past Due Fulfillment Lines link.
4. Wait for the report to build, then examine the report output.
1973
Oracle SCM Cloud Chapter 11
Implementing Order Management Email, Reports, Attachments, Social Media
5. Modify search parameters to filter the report, then notice the results.
For example, set Bill-to Customer Name to a value and click Apply.
1974
Oracle SCM Cloud Chapter 11
Implementing Order Management Email, Reports, Attachments, Social Media
10. On the Catalog page, under My Real Time Fulfillment Report, click Open, then examine the report output.
Limitations
If you use a web service to create a data model, then you can't burst the report. To burst means to separate data into
sections, create a separate document for each section, then deliver each document to one or more destinations. For
details, see the Deliver Content topic.
Related Topics
• Overview of Transactional Business Intelligence
• How to Create Folders
• Deliver Content
1975
Oracle SCM Cloud Chapter 11
Implementing Order Management Email, Reports, Attachments, Social Media
Note.
1976
Oracle SCM Cloud Chapter 11
Implementing Order Management Email, Reports, Attachments, Social Media
Try it.
◦ Where to sign in, see the How You Access and Modify Report Components topic.
◦Different types of publishers and browser requirements, see the Overview of Transactional Business
Intelligence topic.
3. In the Navigator, click Reports and Analytics.
Some implementations might take you directly to Oracle BI Publisher Enterprise instead of the Navigator. If that
happens, skip to the step where you click Catalog.
4. On the Reports and Analytics page, click Browse Catalog.
On the new tab, make sure the page displays Oracle BI Publisher Enterprise in the upper left corner. If it displays
Oracle Transactional Business Intelligence or Oracle Business Intelligence, then sign out, and sign into the
correct instance of Oracle Fusion Applications. Ask your reports administrator for details.
5. Click Catalog.
6. On the Catalog page, in the Folders area, expand Shared Folders > Supply Chain Management > Order
Management > Sales Orders.
7. In the list area to the right of the Folders area, in the Sales Order Report row, click More > Customize.
The publisher opens the report for editing. For details about using this action, see the How You Modify Copies
of Predefined Reports topic.
8. On the Sales Order Report page, click Save Report.
The publisher creates a copy of the report in the Shared Folders/Custom/Supply Chain Management/Order
Management/Sales Orders folder. You will use this copy later.
9. Click Edit.
10. In the dialog that displays, choose the Open with Microsoft Word option, then click OK.
1977
Oracle SCM Cloud Chapter 11
Implementing Order Management Email, Reports, Attachments, Social Media
Note.
1978
Oracle SCM Cloud Chapter 11
Implementing Order Management Email, Reports, Attachments, Social Media
◦
You can add labels and attributes to the predefined template. For example, you can add the Order Date
label and the OrderedDate attribute.
12. Modify your report.
◦ Change the Contact label. Click the Contact label, and start typing.
◦ To move the SoldToContactPoint attribute down one line, place your cursor at the beginning of
SoldToContactPoint, then press the Enter key.
◦ Click Save.
Don't edit the attribute text. The attribute text reflects the data model text and it helps you to see the
relationship between the model and your template.
13. Upload your changes.
Attribute Value
Browse to the .rtf file that you saved on your computer. For this example, its C:\
SalesOrderReport.rtf.
Locale English
1979
Oracle SCM Cloud Chapter 11
Implementing Order Management Email, Reports, Attachments, Social Media
1. In Oracle BI Publisher Enterprise, navigate to Shared Folders > Supply Chain Management > Order
Management > Sales Orders > Data Model.
2. In the list area to the right of the Folders area, in the row that contains Sales Order Report Data Model, click
Edit.
3. In the Data Model area, click Properties.
4. In the Properties area, click SalesOrderReportDm.xml, then save the file to the same location where you saved
your report template.
Attribute Value
1980
Oracle SCM Cloud Chapter 11
Implementing Order Management Email, Reports, Attachments, Social Media
Try it.
Examine the screen print earlier in this topic to see where to add it. Place your cursor after the Contact label,
enter a few carriage returns, then start typing in the label.
3. Position your cursor at the end of the SoldToContactPoint attribute, then enter a few carriage returns until the
cursor aligns with the label.
4. In the Word ribbon, click the BI Publisher tab, then click Sample XML.
1981
Oracle SCM Cloud Chapter 11
Implementing Order Management Email, Reports, Attachments, Social Media
5. In the dialog that displays, choose _Supply Chain Management_Order Management_Sales Orders_Data
Models_SalesOrderReportDm.xml, then click Open.
6. Click the BI Publisher tab then, in the Insert area, click Field.
The Field dialog displays the attributes from your data model.
7. In the Field dialog, click OrderedDate, then click Insert.
8. Click File > Save, then save the file as SalesOrderReport_1.rtf.
You create a new file to avoid an overwrite conflict when you upload the template.
Upload Your Template
1. Go back to Oracle BI Publisher Enterprise in your browser.
2. Click Catalog.
3. On the Catalog page, in the Folders area, expand Shared Folders > Custom > Supply Chain Management >
Order Management, then click Sales Orders.
4. In the row that contains the sales order report you created earlier in this procedure, click Edit.
5. On the Sales Order Report page, click Add New Layout.
6. In the Upload or Generate Layout area, click Upload.
7. In the Upload Template File dialog, set values, then click Upload.
Attribute Value
Locate the SalesOrderReport.rtf file on your local computer. Its the one you edited in
Microsoft Word.
Locale English
1982
Oracle SCM Cloud Chapter 11
Implementing Order Management Email, Reports, Attachments, Social Media
◦ On the Create Order page, click Actions > Create Document > View.
◦ In the Document dialog, set Template to one of the layouts you created in BI Publisher.
• My Sales Order Report
• My Layout for Sales Order Report
◦ Verify that the report includes the changes you made in Microsoft Word, such as the Ordered Date.
Related Topics
• How You Access and Modify Report Components
• Overview of Transactional Business Intelligence
• How You Modify Copies of Predefined Reports
Attachments
Overview of Integrating Attachments in Order Management
Integrate Order Management Cloud so it can receive an attachment as part of a source order from a source system, then
send it to your order fulfillment system.
• Your users can use the Order Management work area add an attachment to a sales order, such as a document
that includes requirements for manufacturing, a memo that includes guidelines for negotiating a price, or a
URL to a page that includes item installation instructions.
• Order Management can attachments to your fulfillment system.
• Order Management can receive an attachment from a source system and include it as part of a sales order.
• Order Management can't receive an attachment from a fulfillment system.
• Order Management can't send an attachment to an order capture system.
You can map attachment attributes from a source order that resides on your source system, to the enterprise business
message (EBM) in Order Management. Order Management then uses the connector to send the attachment to your order
fulfillment system.
How it Works
Here's how Order Management processes an attachment it receives from your source system.
1. Uses an enterprise business object (EBO) to get each attachment from the source order.
2. Cross-references each value from the source system to a value that Oracle Fusion Applications use. This
approach provides a single representation of the attachment in the source system and in Oracle Fusion
Applications.
3. Converts the source order to a sales order, then.
◦ Adds attachments from the source order header to the sales order header
◦
Adds attachments from source order lines to sales order lines
The sales order includes fulfillment details according to order attributes and product transformation
rules. For details about how Order Management does the mapping, see the Overview of Importing
Orders into Order Management topic.
4. Sends a fulfillment request to your fulfillment system.
1983
Oracle SCM Cloud Chapter 11
Implementing Order Management Email, Reports, Attachments, Social Media
If the source system sends a change to an attachment or a source order, such as adding or deleting an attachment
or modifying an existing attachment, and if Order Management already imported the source order, then Order
Management updates the sales order so it reflects the change. Order Management can't send an attachment to the
source system, so it isn't necessary to map attachment attributes to a format that the source system understands when
you transform the response that the web service sends to the source system.
1984
Oracle SCM Cloud Chapter 11
Implementing Order Management Email, Reports, Attachments, Social Media
Section Description
1985
Oracle SCM Cloud Chapter 11
Implementing Order Management Email, Reports, Attachments, Social Media
Attribute Description
Document Content Document Content depends on the value of the Type attribute.
1986
Oracle SCM Cloud Chapter 11
Implementing Order Management Email, Reports, Attachments, Social Media
Order Management sends a fulfillment request to your fulfillment system to do order fulfillment tasks.
• The order fulfillment system can access the attachment through the Orchestration Order Attachments Service
web service.
• The GetAttachment method of this web service gets the attachments that the order header or fulfillment line
references.
• The order fulfillment system uses GetAttachment to get attachments and map attachment attributes through
the connector to the fulfillment system.
Parameter Description
SourceTableName Name of the database table for the entity that the attachment references.
SourcePK1Value First value that identifies the entity that the attachment references.
SourcePK2Value Second value that identifies the entity that the attachment references.
Use these values for each parameter except for SourcePK2Value. You don't use either value for SourcePK2Value.
The GetAttachment method returns the OrchestrationAttachmentSDOs as output, which contains attachment details.
1987
Oracle SCM Cloud Chapter 11
Implementing Order Management Email, Reports, Attachments, Social Media
Here are some topics you can use to get details about the service path, abstract WSDL URL, and so on.
• Attachment Categories
• Attachment Information for Order and Order Lines
• Attachment Interface
• Attachment SDO
• Item Attachments
• Order Attachments
• Shipment Advice Attachment SDO
• Trading Partner Item Attachments
1988
Oracle SCM Cloud Chapter 11
Implementing Order Management Email, Reports, Attachments, Social Media
These topics are in the Service Data Objects section of book SOAP Web Services for Oracle Supply Chain Management
Cloud on Oracle Help Center.
For background details about attachments, see the Manage Attachments for Order Lines topic.
Related Topics
• Manage Attachments on Order Lines
• Manage Attachments on Order Lines
This step transforms the order management message, including attachment attributes, into a format that the
order fulfillment system can process. Note that Order Management doesn't accept attachments from the order
fulfillment system, so it isn't necessary to map attachments from the order fulfillment system message into a
format that Order Management can use in the response from the order fulfillment system.
3. Allow Order Management to send sales order attachments to your fulfillment system. Call the AttachmentsAM
web service and use it to select and send attachments according to the type of fulfillment request and the
attachment category.
4. Call the SalesOrderOrchestrationService web service.
Specify the mapping in the request body to SalesOrderOrchestrationService. For example, here's a request that
get the attachments that one fulfillment line references.
<soap:Body>
<ns1:getAttachment xmlns:ns1="http://xmlns.oracle.com/apps/scm/doo/common/attachments/model/types/">
<ns1:dooGetParameters xmlns:ns2="http://xmlns.oracle.com/apps/scm/doo/common/attachments/model/">
<ns2:sourceEntityName>DOO_FULFILL_LINES_ALL</ns2:sourceEntityName>
<ns2:sourcePK1Value>100000045762 </ns2:sourcePK1Value>
<ns2:sourceTableName>DOO_FULFILL_LINES_ALL</ns2:sourceTableName>
</ns1:dooGetParameters>
</ns1:getAttachment>
</soap:Body>
5. Make a call in the connector to the order fulfillment system to get the attachments that each fulfillment line
references and the corresponding order header.
Social
Administer Social Conversations in Order Management
Enable Oracle Social Network in Order Management Cloud to allow your user community to engage in social
conversations about sales orders.
1. Sign in with a privilege you can use to manage social objects.
1989
Oracle SCM Cloud Chapter 11
Implementing Order Management Email, Reports, Attachments, Social Media
Option Description
Manual Create social conversations only for conversations that the Order Entry Specialist manually
starts for each sales order. To improve performance, choose Manual for most deployments.
Order Management will stamp each attribute and the value for each attribute that you enable into the social
conversation thread. It will also stamp the current attribute value every time the conversation updates.
The term stamp means to impress a snapshot of data onto an object. For example, a sales order might contain
a set of attribute values that exist on a specific date, such as quantity equals four and color equals blue on
October 9, 2019. These values might change at some point, such as during order fulfillment. A stamp impresses
the values of this sales order from a specific point in time onto an object, such as a social conversation, so it
provides an audit trail that you can use to communicate the values of attributes that existed in an historical
context.
1990
Oracle SCM Cloud Chapter 12
Implementing Order Management Maintain and Troubleshoot
Article Description
Master Note - Order Promising and Fix problems with promising, availability, collections, and so on.
Collections (Doc ID 2649499.1)
Master Note - Transforming Data on Fix problems with transformation that aren't already described in the Transformation Rules
Sales Orders Using Transformation topic.
Rules (Doc ID 2675921.1)
Master Note - Importing Data using Fix problems with import that aren't already described in the Import section of the
FBDI (Doc ID 2665940.1) Implementing Order Management book.
Master Note - Applying and Releasing Fix problems with applying and releasing holds on sales orders.
Holds (Doc ID 2000460.1)
Master Note - Shipping Set Up, Issues Fix problems that occur with shipping in downstream fulfillment.
and Usage. (Doc ID 2731251.1)
Order Management - Common Errors Take action depending on the error you encounter.
Raised (Doc ID 2260134.1)
Progress Fulfillment Lines Where Learn how to fix lines that are stuck in the Awaiting Billing status.
Status is - Awaiting Billing (Doc ID
2322271.1)
Progress Fulfillment Lines Where the Learn how to unlock lines that are locked, depending on whether the status is Not Started,
Line is Locked (Doc ID 2317580.1) Scheduled, Reserved, Shipped, or Awaiting Billing.
1991
Oracle SCM Cloud Chapter 12
Implementing Order Management Maintain and Troubleshoot
• Verify the data format and values you must use during order import or with a web service.
• Troubleshoot problems that occur during upgrades or other administrative set up.
• Save data into a data management tool of your choice so you can analyze it.
You create a data model in Oracle Business Intelligence and use it to query the Order Management database.
Assume you must query the database to get a list of users so you can identify the users who are active and the ones
who aren't.
For details about how to use this work area, see the Use Reports and Analytics with Order Management topic.
3. On the Reports and Analytics page, click Browse Catalog.
1992
Oracle SCM Cloud Chapter 12
Implementing Order Management Maintain and Troubleshoot
◦ In the Create area, under Published Reporting, click More > Data Model.
You use a data model to set up the SQL you use to query the Oracle database. You can reuse the data
model for different SQL queries. It isn't necessary to create and save a separate data model for each SQL
query.
◦ On the Diagram tab, click New Data Set > SQL Query.
◦ In the New Data Set - SQL Query dialog, set values.
Attribute Value
Name My SQL
1993
Oracle SCM Cloud Chapter 12
Implementing Order Management Maintain and Troubleshoot
Attribute Value
You can enter some other query. For example, to get all order headers, enter. . .
1994
Oracle SCM Cloud Chapter 12
Implementing Order Management Maintain and Troubleshoot
For example.
◦ Click OK.
1995
Oracle SCM Cloud Chapter 12
Implementing Order Management Maintain and Troubleshoot
The Diagram tab displays the attributes that your SQL defined.
1996
Oracle SCM Cloud Chapter 12
Implementing Order Management Maintain and Troubleshoot
◦ Click View Data, set Rows to 200, click View, click Table View, then examine the output.
6. In the upper-right corner, click Save, then save the output in My Folders.
Create Report
1. On the Data tab, click Save as Sample Data > OK.
2. In the upper-right corner, click Create Report.
1997
Oracle SCM Cloud Chapter 12
Implementing Order Management Maintain and Troubleshoot
3. Click Next.
4. On the Select Layout step, enable the Landscape option, enable the Table option, then click Next.
5. On the Create Table step, adjust the layout to fit your needs, then click Next.
1998
Oracle SCM Cloud Chapter 12
Implementing Order Management Maintain and Troubleshoot
For example, drag and drop columns from the data source to the table.
6. On the Save Report step, enable the View Report option, then click Finish.
1999
Oracle SCM Cloud Chapter 12
Implementing Order Management Maintain and Troubleshoot
7. Save the report, name it, such as SQLReport, then examine the results on the report output that displays.
Add a Field
You can't extend the predefined data model for Order Management. Instead, you can replace a field in the report output
with the one you need.
Order Management uses the term item to describe the product your customer buys. The AS54888 Computer is
an example of an item. The predefined data model uses the INVENTORY_ITEM_ID column to store the value that
2000
Oracle SCM Cloud Chapter 12
Implementing Order Management Maintain and Troubleshoot
identifies the item. In this example, you replace INVENTORY_ITEM_ID with ITEM_NUMBER so your report output is
more consistent with this usage.
1. Do steps 1 through 5 from earlier in this topic, except use these values in the New Data Set - SQL Query dialog.
Attribute Value
2001
Oracle SCM Cloud Chapter 12
Implementing Order Management Maintain and Troubleshoot
Attribute Value
5. Click View Data, set Rows to 200, click View, click Table View, then examine the output.
Sales Orders in Not Started Status or Processing Status and There Are No Exceptions
This problem typically occurs when the SOA server becomes unstable or overloaded and the SOA transactions time
out. Use a query to identify sales orders that remain in Not Started Status or Processing Status but that don't have any
exceptions.
SELECT f.last_update_date,
h.source_order_number,
l.display_line_number,
f.fulfill_line_number,
f.status_code,
f.fulfill_line_id
FROM doo_headers_all h,
doo_fulfill_lines_all f,
doo_lines_all l
WHERE h.header_id =l.header_id
AND h.submitted_flag='Y'
AND l.line_id =f.line_id
AND f.open_flag ='Y'
AND f.creation_date>= sysdate -- Use the date range to meet your needs
AND f.status_code IN ('NOT_STARTED') -- Get orders only in NOT_STARTED status
AND NOT EXISTS
(SELECT OrchestrationGroupEO.TRANSACTION_ENTITY_ID
FROM DOO_WAIT_TASK_DETAILS WaitTaskDetailsEO,
DOO_ORCHESTRATION_GROUPS OrchestrationGroupEO
WHERE WaitTaskDetailsEO.GROUP_ID = OrchestrationGroupEO.GROUP_ID
AND WaitTaskDetailsEO.STATUS_CODE='Active'
AND OrchestrationGroupEO.STATUS ='ACTIVE'
AND TRANSACTION_ENTITY_NAME ='DOO_ORDER_FLINES_V'
AND transaction_entity_id =f.fulfill_line_id
2002
Oracle SCM Cloud Chapter 12
Implementing Order Management Maintain and Troubleshoot
)
ORDER BY f.source_order_number;
Use the Force Unlock action to recover these sales orders. For details, see the Unlock Draft Sales Orders topic.
Find the reservations that have finished for an item or list of items in your sales order.
SELECT iop.organization_code org ,
ir.reservation_id ,
dfa.header_id ,
dfa.source_order_number ,
ir.back_to_back_flag ,
ir.staged_flag ,
esi.item_number ,
ir.reservation_quantity ,
ir.creation_date
FROM inv_reservations ir ,
inv_org_parameters iop ,
egp_system_items_b esi ,
doo_fulfill_lines_all dfa
WHERE iop.organization_id =ir.organization_id
AND esi.inventory_item_id =ir.inventory_item_id
AND esi. organization_id =ir.organization_id
AND ir.source_fulfillment_line_id=dfa.fulfill_line_id
AND dfa.inventory_item_id =ir.inventory_item_id
AND ir.demand_source_type_id ='2' /*Data in Order Management comes predefined to use a
demand_source_type_id of 2 for the sales order.*/
ORDER BY dfa.source_order_number;
Related Topics
• Use Reports and Analytics with Order Management
• Unlock Draft Sales Orders
2003
Oracle SCM Cloud Chapter 12
Implementing Order Management Maintain and Troubleshoot
1. Go to the Order Management work area, then click Tasks > Manage Order Orchestration Messages.
2. On the Manage Order Orchestration Messages page, set values, then click Search.
2004
Oracle SCM Cloud Chapter 12
Implementing Order Management Maintain and Troubleshoot
Attribute Value
Related Topics
• Overview of Importing Orders into Order Management
• How Order-to-Cash Works with Order Capture Systems
• Overview of Importing Orders into Order Management
2005
Oracle SCM Cloud Chapter 12
Implementing Order Management Maintain and Troubleshoot
Note.
2006
Oracle SCM Cloud Chapter 12
Implementing Order Management Maintain and Troubleshoot
• Get results from a range of diagnostic tests. For example, run the Order Orchestration test to determine
whether.
◦ A shipment set in the sales order includes a line that can't ship, such as a warranty.
◦ Order fulfillment is locked because of a force cancel action.
◦ A hold failure occurred.
• Get processing details about the sales order, such as which fulfillment tasks have run and their statuses.
•
Assume you must troubleshoot sales order 385081 that you created in the Order Management work area.
Try it.
For details, see the Application Diagnostics Administrator chapter in Security Reference for Common Features
at https://docs.oracle.com/en/cloud/saas/applications-common/19d/oacsm/application-diagnostics-
administrator-job-role.html#application-diagnostics-administrator-job-role.
2. In the upper-right corner, click down arrow > Run Diagnostics Tests.
3. On the Diagnostic Dashboard page, in the Search for Tests area, enter the value, then click Search.
Attribute Value
4. In the search results, in the row that contains Order Orchestration Details in the Test Name attribute, add a
check mark to the box that's left of the test name, then click Add to Run.
In the Choose Tests to Run and Supply Inputs area, notice that the page added a row.
Order Orchestration No Icon you can click Required Input Values Order Orchestration
Details Are Missing Details
Attribute Value
8. In the search results, click that row that contains your sales order, then click OK > OK.
In the Choose Tests to Run and Supply Inputs area, notice the value.
2007
Oracle SCM Cloud Chapter 12
Implementing Order Management Maintain and Troubleshoot
Attribute Value
9. In the Test Run Submitted dialog, notice the text, then click OK.
Tests Run "TestRun_958693F85A9E4A19E0535EBFF20A3CA7" has been submitted
Attribute Value
Run By Displays the user you used to sign in, such as DIAG_ADMIN.
The refresh displays all tests that diagnostics has run in the last 24 hours.
2. In the Run / Test / Step Name column, expand the folder, expand the child Order Orchestration Details
folder, then notice the hierarchy that displays.
TestRun_958693F85A9E4A19E0535EBFF20A3CA7
Order Orchestration Details
Diagnostics_Engine_Log
Order Orchestration Data
Attribute Value
4. In the row that contains TestRun_958693F85A9E4A19E0535EBFF20A3CA7, in the Report column, click the icon.
The tool displays an HTML page that includes a report summary.
5. Close the report.
6. In the Diagnostic Test Run Status area, in the row that contains Order Orchestration Details, in the Report
column, click the icon.
The tool displays an HTML page that includes a report summary.
2008
Oracle SCM Cloud Chapter 12
Implementing Order Management Maintain and Troubleshoot
Use the analysis area of the report to get details about the current state of the sales order.
Suggested Recovery
Suggested Recovery
Suggested Recovery
Suggested Recovery
Suggested Recovery
2009
Oracle SCM Cloud Chapter 12
Implementing Order Management Maintain and Troubleshoot
Suggested Recovery
Group Id
Suggested Recovery
Diagnosis Area
Use the Order Diagnosis area of the report to identify problems that occurred.
Fulfillment lines with null delta types. Sales order doesn't have a null delta type.
Shipment set in this order contains Shipment set doesn't have a mix of shippable lines and nonshippable lines.
shippable and nonshippable lines.
Order fulfillment is locked because of There are no problems related to a forced cancellation.
force cancel.
Double orchestration exists for There are no problems related to a double orchestration.
fulfillment lines in the sales order.
This order has pending action All user request are done and no more changes are allowed.
requests.
No active wait record exists for this There are no problems related to waits.
order.
This order has hold failures. There are no apply hold failures.
2010
Oracle SCM Cloud Chapter 12
Implementing Order Management Maintain and Troubleshoot
Use the Processing Details area to get details about the processing that Order Management has done for the sales
order, such as order line details, orchestration process details, orchestration process steps that have run and their
statuses, fulfillment task details, pending actions, holds applied, error messages, and so on.
Details are extensive. Here's some example data from part of the Step Instances section.
2011
Oracle SCM Cloud Chapter 12
Implementing Order Management Maintain and Troubleshoot
DOO_PROCESS_STEP_ID STEP_NUMBER_NAME
TASK_NAME STEP_INSTANCE_ID
TASK_INSTANCE_ID
GROUP_ID STEP_ACTIVE STEP_STATUS
INSTANCE_ID
300100087585425
213 [1300] Invoice 300100087585434
300100087585430
300100087585407
ACTIVE NOT_STARTED
Create
Invoice
300100087585425
214 [1400] Invoice 300100087585435
300100087585430
300100087585407
ACTIVE NOT_STARTED
Wait for
Invoice
300100087585425
208 [800] Procure 300100087585436
300100087585431
300100087585407
ACTIVE NOT_STARTED
Wait for
Procurement
300100087585425
209 [900] Reserve 300100087585437
300100087585428
300100087585407
INACTIVE NOT_STARTED
Create
Reservation
300100087585425
210 [1000] Ship 300100087585438
300100087585429
300100087585407
INACTIVE NOT_STARTED
Create
Shipment
Request
300100087585425
211 [1100] Ship 300100087585439
300100087585429
300100087585407
INACTIVE NOT_STARTED
Wait for
Shipment
Advice
300100087585425
204 [400] Pause 300100087585440
300100087585426
300100087585407
INACTIVE NOT_STARTED
Pause
300100087585425
205 [500] Ship Back- 300100087585441
300100087585433
300100087585407
INACTIVE NOT_STARTED
Create to-Back
Back Goods
to Back
Shipment
Request
300100087585425
206 [600] Wait Ship Back- 300100087585442
300100087585433
300100087585407
INACTIVE NOT_STARTED
for Back to-Back
to Back Goods
Shipment
Advice
300100087585425
201 [100] Schedule 300100087585444
300100087585427
300100087585407
ACTIVE COMPLETED
Schedule
300100087585425
203 [300] Supply 300100087585445
300100087585432
300100087585407
INACTIVE NOT_STARTED
Request Orchestration
Supply
2012
Oracle SCM Cloud Chapter 12
Implementing Order Management Maintain and Troubleshoot
DOO_PROCESS_STEP_ID STEP_NUMBER_NAME
TASK_NAME STEP_INSTANCE_ID
TASK_INSTANCE_ID
GROUP_ID STEP_ACTIVE STEP_STATUS
INSTANCE_ID
300100087585446
213 [1300] Invoice 300100087585455
300100087585451
300100087585413
ACTIVE NOT_STARTED
Create
Invoice
300100087585446
214 [1400] Invoice 300100087585456
300100087585451
300100087585413
ACTIVE NOT_STARTED
Wait for
Invoice
300100087585446
208 [800] Procure 300100087585457
300100087585452
300100087585413
ACTIVE NOT_STARTED
Wait for
Procurement
300100087585446
209 [900] Reserve 300100087585458
300100087585449
300100087585413
INACTIVE NOT_STARTED
Create
Reservation
300100087585446
210 [1000] Ship 300100087585459
300100087585450
300100087585413
INACTIVE NOT_STARTED
Create
Shipment
Request
300100087585446
211 [1100] Ship 300100087585460
300100087585450
300100087585413
INACTIVE NOT_STARTED
Wait for
Shipment
Advice
300100087585446
204 [400] Pause 300100087585461
300100087585447
300100087585413
INACTIVE NOT_STARTED
Pause
300100087585446
205 [500] Ship Back- 300100087585462
300100087585454
300100087585413
INACTIVE NOT_STARTED
Create to-Back
Back Goods
to Back
Shipment
Request
300100087585446
206 [600] Wait Ship Back- 300100087585463
300100087585454
300100087585413
INACTIVE NOT_STARTED
for Back to-Back
to Back Goods
Shipment
Advice
300100087585446
201 [100] Schedule 300100087585465
300100087585448
300100087585413
ACTIVE COMPLETED
Schedule
300100087585446
203 [300] Supply 300100087585466
300100087585453
300100087585413
INACTIVE NOT_STARTED
Request Orchestration
Supply
2013
Oracle SCM Cloud Chapter 12
Implementing Order Management Maintain and Troubleshoot
DOO_PROCESS_STEP_ID STEP_NUMBER_NAME
TASK_NAME STEP_INSTANCE_ID
TASK_INSTANCE_ID
GROUP_ID STEP_ACTIVE STEP_STATUS
INSTANCE_ID
300100087585467
213 [1300] Invoice 300100087585476
300100087585472
300100087585419
ACTIVE NOT_STARTED
Create
Invoice
300100087585467
214 [1400] Invoice 300100087585477
300100087585472
300100087585419
ACTIVE NOT_STARTED
Wait for
Invoice
300100087585467
208 [800] Procure 300100087585478
300100087585473
300100087585419
ACTIVE NOT_STARTED
Wait for
Procurement
300100087585467
209 [900] Reserve 300100087585479
300100087585470
300100087585419
INACTIVE NOT_STARTED
Create
Reservation
300100087585467
210 [1000] Ship 300100087585480
300100087585471
300100087585419
INACTIVE NOT_STARTED
Create
Shipment
Request
300100087585467
211 [1100] Ship 300100087585481
300100087585471
300100087585419
INACTIVE NOT_STARTED
Wait for
Shipment
Advice
300100087585467
204 [400] Pause 300100087585482
300100087585468
300100087585419
INACTIVE NOT_STARTED
Pause
300100087585467
205 [500] Ship Back- 300100087585483
300100087585475
300100087585419
INACTIVE NOT_STARTED
Create to-Back
Back Goods
to Back
Shipment
Request
300100087585467
206 [600] Wait Ship Back- 300100087585484
300100087585475
300100087585419
INACTIVE NOT_STARTED
for Back to-Back
to Back Goods
Shipment
Advice
300100087585467
201 [100] Schedule 300100087585486
300100087585469
300100087585419
ACTIVE COMPLETED
Schedule
300100087585467
203 [300] Supply 300100087585487
300100087585474
300100087585419
INACTIVE NOT_STARTED
Request Orchestration
Supply
2014
Oracle SCM Cloud Chapter 12
Implementing Order Management Maintain and Troubleshoot
Attribute Value
2. In the Select column, add a check mark mark, then click Add to Run.
3. In the Choose Tests to Run and Supply Inputs area, in the Input Status column, click the icon.
4. In the Input Parameters dialog, set the date range, then click OK.
5. Click Run.
6. In the Diagnostic Test Run Status area, click View > Refresh, then examine the values.
7. Refresh the view until Execution Status displays Completed.
8. In the Order Management Health Check row, click the icon in the Report column.
Your browser displays the report in a separate tab.
9. Examine the results. For example.
◦ Pending recovery for the order
◦ Changes to sales order not successfully processed
◦ Order lines locked by fulfillment tasks
◦ Order lines locked by shipping tasks
◦ Order lines that encountered problems while waiting for error recovery
◦ Order lines that are at the Await Billing status even after being billed
◦ Order lines that are missing references
◦ Recover actions not available in Order Management work area but line has an error
◦ Unstable sales orders
◦ Performance of Order Management
Details
Troubleshoot Order Management Cloud
Fix problems that occur in your Order Management set ups.
Some solutions use SQL to query the Order Management database. For details about how to query, see the Use SQL to
Query Order Management Data topic.
Setup
2015
Oracle SCM Cloud Chapter 12
Implementing Order Management Maintain and Troubleshoot
Trouble Shoot
I use the Manage Hold Codes page Use the Manage Task Types page to specify the tasks and services that you can choose for the
in the Setup and Maintenance work hold. You must set the Hold Enabled option to make the service display on the Services tab. For
area. When attempting to add a details, see the Set Up Task Types for Holds topic.
service on the Services tab, the
Select and Add: Services dialog
doesn't display the service I need.
For example, it displays the Create
Shipping service but not the Update
Shipping service.
I go to the Manage Order Lookups The purpose of the Lookup Code attribute is to provide a quick way to scan all the codes. Use
page in the Setup and Maintenance the Meaning or Description attributes to provide more detail.
work area, but I can't add a lookup
code that's longer than 30 characters.
The same situation applies for other objects, such as the validation rule set in a processing
constraint. Most of these objects include a code or short name, but also a description that you
I need more characters to accurately can use to elaborate.
describe the code.
I use the ImportSalesOrder web If you use Global Order Promising to schedule your sales order, then create a business rule that
service to import values for the sets the Override Schedule attribute to Yes. This attribute instructs Global Order Promising not
Scheduled Ship Date and Scheduled to schedule the dates but instead to use whatever dates you already have.
Arrival Date attributes of each sales
order.
For an example rule, see the Set the Default Value for Scheduled Ship Date topic.
The Category area of the Edit Run the Publish Extensible Flexfield Attributes scheduled process. For details, see the Publish
Extensible Flexfield page doesn't the Extensible Flexfield subtopic in the Set Up Extensible Flexfields in Order Management
have any rows, so I can't edit the topic.
category or category details, such as
associated contexts and pages.
I go to the Manage Administrator Go to the Plan Inputs work area and do the Collect Planning Data task.
Profile Values page in the Setup and
Maintenance work area, then search • Set Source System to OPS.
the Profile Display Name attribute for • Set Collection type to Targeted
Display Currency.
• Move the Currencies reference entity to the Selected Entities list.
2016
Oracle SCM Cloud Chapter 12
Implementing Order Management Maintain and Troubleshoot
Trouble Shoot
select
*
from
msc_currencies_tl
For details, see the Use SQL to Query Order Management Data topic.
I encounter an error. Deploy your extensible flexfields. For details, see the Deploy Extensible Flexfields topic.
I encounter an error. You need the Manage Order Approval Rules privilege and the BPM Workflow System Admin
Role privilege. You have two choices.
Fail to load task • Sign in with the Order Orchestration Administration job role. It includes the privileges
definition. :: you need.
oracle.apps.fnd.applcore.visualInformationBuilder.businessRules.publicCommonApprovals.task.TaskLoaderException :
Exception thrown in • Create a new role, assign the privileges to it, then run the Retrieve Latest LDAP Changes
getSAXSource ::java.lang.NullPointerException :
scheduled process.
null
Order Entry
Trouble Shoot
• Make sure enough stock is available in inventory to reserve and finish the transaction.
I create a sales order in the Order See the Oracle SCM Cloud Using Inventory Management book on Oracle Help Center.
Management work area. I search
• Make sure you correctly set up your sourcing rules and ATP rules. Here are some
for, then add an item on the catalog
resources.
line, but the line displays an error
message. ◦ Configure Global Order Promising section in the Quick Start for Implementing
Order-to-Cash topic.
No data was retrieved ◦ Defining a Basic Item Sourcing Rule and ATP Rule (Document 2207137.1) on My
Oracle Support.
2017
Oracle SCM Cloud Chapter 12
Implementing Order Management Maintain and Troubleshoot
Trouble Shoot
• Make sure you collected on-hand availability. See article Collecting On Hand Inventory
Levels for Scheduling purposes (Document 2207161.1) on My Oracle Support.
I click Additional Information on Remove the space from the Code attribute, deploy, then publish the extensible flexfield. For
the order header or order line details, see the Guidelines for Setting Up Extensible Flexfields in Order Management topic.
when creating a sales order in the
Order Management work area, then
encounter an error that's similar to. . .
ADF_FACES-60097:For more
information, please see
the server's error log for
an entry beginning with:
ADF_FACES-60096:Server
exception during PPR
One of my users encounters an error Wait for the server to come back online. If the problem persists after the server is available,
while creating a sales order. then deploy the orchestration process. For details, see the Deploy Orchestration Process topic.
Orchestration process
300000001288069 for order
was not started because
it is not deployed or the
server is unavailable.
Order Management creates a new Use the Order Fulfillment Response Service instead of OrderImportService or REST API. Order
sales order revision every time we Fulfillment Response Service doesn't create a revision.
update an attribute.
For details about Order Fulfillment Response Service, see the Web Services You Can Use to
We use OrderImportService or the Integrate Order Management topic.
Sales Order for Order Hub REST API
to import source orders into Order
Management.
2018
Oracle SCM Cloud Chapter 12
Implementing Order Management Maintain and Troubleshoot
Trouble Shoot
I add my business unit to the If you add your business unit to the Coverage Start Date order management parameter, then
Coverage Start Date order order management uses it to calculate coverage dates.
management parameter.
If you prefer to manually enter the date on the order line, then remove your business unit from
Next, I create a sales order, add a the Coverage Start Date order management parameter.
coverage item, set the Contract Start
Date for the item, then click Submit,
but Order Management changes the
Contract Start Date in the fulfillment
view.
I create and submit a sales order, Its possible that you have a routing rule on a pause task, which Order Management doesn't
but the order lines remain in the Not support.
Started status. This happens on every
order I create. I also encounter an 1. Go to the Setup and Maintenance work area and the search for the page that you use
error. to manage routing rules. Its either Manage External Interface Routing Rules or Manage
External Integration Routing Rules for Sales Orders. For details, see the Overview of
Using Business Rules With Order Management topic.
Task 300000090474951
2. Look for a rule that depends on a pause task and that sets the connector. For example, if
for orchestration process
you use Visual Information Builder, look for a rule that's similar to.
300000090474941 failed. Use the
appropriate Order Orchestration
work area action to recover this task. If Task Type is equal to pause, then set connector name to Fusion-
(DOO-2685501) Reservation.
If you use Oracle Business Rules, look for a rule that's similar to.
I try to recover the sales order or
revise the order but the problem
persists. If header.Task Type is "Pause", then Set Connector Name ( "Fusion-
Reservation" )
3. Deactivate the rule. Remove the check mark from the Active option.
4. Go to the Order Management work area and use the Recover action on your sales order.
Return Orders
Trouble Shoot
I encounter an error when I attempt to Assume you must return item AS54888.
create a return for a closed order line.
1. Sign in with a privilege you can use to access Product Information Management.
2. In the Navigator, click Product Management > Product Information Management.
This error might occur because
the setup in Product Information 3. On the Overview page, click Tasks > Manage Items.
Management doesn't allow you to 4. On the Manage Items page, search for item AS54888, then open it for editing.
return the item. 5. On the Edit Item page, click Specifications > Sales and Order Management.
6. Set the Returnable attribute to Yes, then click Save and Close.
As an option, run SQL on the Oracle database to confirm the value of the Returnable attribute
on the item and the fulfillment line.
SELECT dfla.source_order_number ,
dfla.inventory_item_id ,
2019
Oracle SCM Cloud Chapter 12
Implementing Order Management Maintain and Troubleshoot
Trouble Shoot
dfla.status_code ,
dfla.returnable_flag "Fline Return Flag",
esib.Item_number ,
esib.Returnable_flag "Item Return Flag"
FROM doo_fulfill_lines_all dfla,
egp_system_items_b esib
WHERE source_order_number = '&SOURCE_ORDER_NUMBER'
AND esib.inventory_organization_id = dfla.inventory_organization_id
AND esib.inventory_item_id = dfla.inventory_item_idWord' to retain
layout.]
I create a sales order in the Order Promote your pricing algorithms. For details, see the Promote Pricing Algorithms Into the
Management work area. Current Release topic.
My return line is stuck in the Awaiting Run the Send Receipt Confirmation scheduled process.
Receiving status.
As an option, set the Source Document Number parameter to the number that identifies
the source order that contains the return line. For example, if the source order number is
14052903, then set Source Document Number to 14052903.
I encounter an error. If you adjust price on a referenced return line for an outbound line that has recurring billing,
and if the unit price on the return line is different from the unit price on the original line, then
you must set the CancelReasonCode attribute to ORA_PRICE_CHANGE in your import payload.
Order management didn't If you use any other value, then you'll get this error message.
create a sales order for
source order AFH879, source
order line 7, source order
schedule 4, billing plan 3.
If the price on the return
order is different from
the price on the original
order, then you must set
the cancel reason to Price
Change and resubmit the
order.
Features
2020
Oracle SCM Cloud Chapter 12
Implementing Order Management Maintain and Troubleshoot
Transportation Management
Trouble Shoot
Order Management sends a request Use error recovery to retry the task.
to Transportation Management, but
the web service between Integration
Cloud Service and Transportation Don't retry the call through Integration Cloud Service because Order Management can't accept
Management isn't up and running, an update from Transportation Management while the task is in error.
so the Order Management work
area displays an error icon on the
fulfillment line.
Transportation Management sends Manually resend the request from Transportation Management.
an update to Order Management,
but Order Management rejects
the update because the fulfillment
line isn't on a wait step in the
orchestration process, or the
orchestration process is already
processing another request.
Sales Agreements
Trouble Shoot
I set the Customer attribute on Make sure you set up a sales agreement for the customer and that its active.
the order header, but no sales
agreements are available in the Sales
Agreement attribute on the order
header when you create a sales order.
The sales agreements that are Examine your sales agreement set up. Order Management includes sales agreements on the.
available on the order header are
different from the ones that are • Order header that you set up for the customer and are active.
available on the order line. • Order line that you set up for the customer, are active, and that you specified for the
item on the order line.
Error Messages
Message Solution
Pricing did not apply a Make sure you correctly set up the adjustment basis on the pricing term for the sales
sales agreement adjustment agreement.
for charge Sale Price
because it cannot find
adjustment basis 100010.
2021
Oracle SCM Cloud Chapter 12
Implementing Order Management Maintain and Troubleshoot
Message Solution
Pricing did not apply a tier Make sure you correctly set up the adjustment basis on the pricing term that adjusts price
adjustment on the sales according to tiers for the sales agreement.
agreement for charge Sale
Price because it cannot find
adjustment basis 100010.
Pricing did not apply a tier Make sure you correctly set up the tier basis on the pricing term that adjusts price according
adjustment for the sales to tiers for the sales agreement. Make sure you correctly set up the price element on the tier
agreement to charge Sale basis.
Price because it cannot find
tier basis 100010.
For example, you can't use the QP_NET_PRICE price element as the tier basis for a pricing term
that references a sales agreement.
Get Details
Here's the SQL you can use to get details about sales agreements that you can set on the order header.
SELECT h.CONTRACT_ID, h.ID, h.MAJOR_VERSION, h.VERSION_TYPE,h.CONTRACT_NUMBER, h.CONTRACT_NUMBER_MODIFIER,
h.COGNOMEN CONTRACT_NAME, h.SHORT_DESCRIPTION, h.DESCRIPTION,h.STS_CODE, h.ORG_ID, h.INV_ORGANIZATION_ID,
h.CURRENCY_CODE,h.START_DATE, h.END_DATE,
p.OBJECT1_ID1 PRIMARY_PARTY_ID, p.RLE_CODE FROM OKC_K_HEADERS_VL h, OKC_CONTRACT_TYPES_VL t,
OKC_K_PARTY_ROLES_VL p
where h.CONTRACT_TYPE_ID=t.CONTRACT_TYPE_ID and h.BUY_OR_SELL='S' and t.CONTRACT_CLASS='AGREEMENT'
AND t.INTENT='S' and t.LINE_CLASS='SALES_AGREEMENT' AND h.ID=p.DNZ_CHR_ID(+) AND
h.MAJOR_VERSION=p.MAJOR_VERSION(+) AND p.PRIMARY_YN(+)='Y'
and h.STS_CODE='ACTIVE' and h.VERSION_TYPE in ('C','A') and h.TEMPLATE_YN='N' and h.ORG_ID=<BuId> and
h.CURRENCY_CODE=<CurrencyCode>
and p.OBJECT1_ID1=<PartyId> and <PricingDate> BETWEEN h.START_DATE AND Nvl(h.END_DATE,<PricingDate>)
Here's the SQL you can use to gets details about sales agreements that you can set on the order line.
SELECT h.CONTRACT_ID, h.ID CHR_ID, l.MAJOR_VERSION, l.VERSION_TYPE, h.CONTRACT_NUMBER,
h.CONTRACT_NUMBER_MODIFIER, h.COGNOMEN CONTRACT_NAME, h.SHORT_DESCRIPTION CONTRACT_SHORT_DESCRIPTION,
h.DESCRIPTION CONTRACT_DESCRIPTION,l.STS_CODE, h.ORG_ID, h.INV_ORGANIZATION_ID,
l.CURRENCY_CODE,l.START_DATE, l.END_DATE, l.UOM_CODE,l.ID LINE_ID, l.LINE_NUMBER, l.ITEM_NAME,
l.ITEM_DESCRIPTION,
l.OBJECT1_ID1 ITEM_ID, l.OBJECT1_ID2 ITEM_INV_ORG_ID, p.OBJECT1_ID1 PRIMARY_PARTY_ID, p.RLE_CODE
FROM OKC_K_HEADERS_VL h, OKC_CONTRACT_TYPES_VL t, OKC_K_PARTY_ROLES_VL p, OKC_K_LINES_VL l
where h.CONTRACT_TYPE_ID=t.CONTRACT_TYPE_ID and h.BUY_OR_SELL='S' and t.CONTRACT_CLASS='AGREEMENT' AND
t.INTENT='S' and t.LINE_CLASS='SALES_AGREEMENT' AND h.ID=l.DNZ_CHR_ID AND h.MAJOR_VERSION=l.MAJOR_VERSION
and l.SOURCE_CODE_CLASS='SALES_AGREEMENT' and l.STS_CODE='ACTIVE' AND h.ID=p.DNZ_CHR_ID(+) AND
h.MAJOR_VERSION=p.MAJOR_VERSION(+) AND p.PRIMARY_YN(+)='Y'
-- and h.STS_CODE='ACTIVE' and h.VERSION_TYPE in ('C','A') and h.TEMPLATE_YN='N' and h.ORG_ID=<BuId>
and h.CURRENCY_CODE=<CurrencyCode> and l.OBJECT1_ID1=<ItemId> and l.OBJECT1_ID2=<InvOrgId> and
l.UOM_CODE=<UomCode>
and <PricingDate> BETWEEN l.START_DATE AND Nvl(l.END_DATE,<PricingDate>)
2022
Oracle SCM Cloud Chapter 12
Implementing Order Management Maintain and Troubleshoot
<FROM_SYSTEM>AR</FROM_SYSTEM>
<TO_SYSTEM>STORE</TO_SYSTEM>
<PAYLOAD>
<PARAMETERLIST>
<!-- core mandatory attributes -->
<PARAMETER>
<NAME>GEC_SET_ID</NAME>
<VALUE>46777</VALUE>
</PARAMETER>
<PARAMETER>
<NAME>TRANSACTION_ID</NAME>
<VALUE>36787503</VALUE>
</PARAMETER>
</PARAMETERLIST>
</PAYLOAD>
</ORACLE_INTEGRATION_MESSAGE>
I have to parse this response in an order management extension. I attempt to import the XmlSlurper library to do the
parse but the order management extension displays an error.
To fix this problem, see the Extract Details section in the Troubleshoot Problems with Web Services topic.
We deploy Order Management in a language that isn't English, such as Japanese. I set the SetName attribute to
Common Set in an extension.
vcrow.setAttribute("SetName", "Common Set");
This problem occurs because Common Set might not be available for your language. Instead, you can set the SetCode
attribute to COMMON.
vcrow.setAttribute("SetCode", "COMMON");
For an example of this usage, see the //Function to get Billing Transaction Type code in subtopic Set the Billing
Transaction Type According to Order Type, in topic Code Examples and Snippets for Order Management Extensions.
My order management extension doesn't run when use I the Order Management work area to cancel a sales order, but it
does run if I use REST API to cancel the order.
This problem happens because you can run an order management extension when you cancel a sales order only
through REST API. You can't run an order management extension when you cancel the sales order in the Order
Management work area.
Performance
2023
Oracle SCM Cloud Chapter 12
Implementing Order Management Maintain and Troubleshoot
Trouble Shoot
Performance decreases each time Make sure the attribute value that you transform in a pretransformation rule is empty before
I add an order line to a sales order you set the value. For details, see the Manage Pretransformation Rules topic.
that I create or edit in the Order
Management work area. For example,
I add 25 order lines.
Related Topics
• Overview of Importing Orders into Order Management
• Set Up User Roles and Privileges in Order Management
• Troubleshoot Problems with Configure-to-Order
No Matching Row
No Matching Row
Assume you use a web service to import a sales order. The payload includes. . .
<ns2:ProductNumber>BIGSTORE1111</ns2:ProductNumber>
<ns2:InventoryOrganizationIdentifier>300000001384059</ns2:InventoryOrganizationIdentifier>
2024
Oracle SCM Cloud Chapter 12
Implementing Order Management Maintain and Troubleshoot
The No Matching Row error typically occurs because the Oracle database doesn't contain the same value that your
import contains. In this example, your import inventory item isn't defined in the Oracle database or isn't associated with
the Inventory Organization that the web service payload specifies.
Run another query to get the inventory item that's associated with the inventory organization.
SELECT
ItemPEO.INVENTORY_ITEM_ID,
ItemPEO.ORGANIZATION_ID,
HOUTL.NAME,
ItemPEO.ITEM_NUMBER,
ItemPEO.INVENTORY_ITEM_STATUS_CODE
FROM EGP_SYSTEM_ITEMS_B ItemPEO,
HR_ORGANIZATION_UNITS_F_TL HOUTL
where
HOUTL.ORGANIZATION_ID = ItemPEO.ORGANIZATION_ID and
ItemPEO.ITEM_NUMBER = 'BIGSTORE1111';
2025
Oracle SCM Cloud Chapter 12
Implementing Order Management Maintain and Troubleshoot
This problem occurs because the inventory organization in your import payload isn't defined in the Oracle database.
To fix this problem, first get the list of inventory organizations that the Oracle database currently contains. Run this SQL.
SELECT HOU.ORGANIZATION_ID,
HOUTL.NAME,
HOUCL.CLASSIFICATION_CODE
FROM HR_ALL_ORGANIZATION_UNITS_F HOU,
HR_ORGANIZATION_UNITS_F_TL HOUTL,
HR_ORG_UNIT_CLASSIFICATIONS_F HOUCL
WHERE
HOU.ORGANIZATION_ID=HOUTL.ORGANIZATION_ID AND
HOU.ORGANIZATION_ID =HOUCL.ORGANIZATION_ID AND
HOUCL.CLASSIFICATION_CODE = 'INV'
ORDER BY
HOUTL.NAME;
2026
Oracle SCM Cloud Chapter 12
Implementing Order Management Maintain and Troubleshoot
Next, get details for BIGSTORE1111, which is the inventory organization that your import payload specifies.
SELECT
ItemPEO.INVENTORY_ITEM_ID,
ItemPEO.ORGANIZATION_ID,
HOUTL.NAME,
ItemPEO.ITEM_NUMBER,
ItemPEO.INVENTORY_ITEM_STATUS_CODE
FROM EGP_SYSTEM_ITEMS_B ItemPEO,
HR_ORGANIZATION_UNITS_F_TL HOUTL
where
HOUTL.ORGANIZATION_ID = ItemPEO.ORGANIZATION_ID and
ItemPEO.ITEM_NUMBER = 'BIGSTORE1111';
Attribute Values
Attribute ORG_ID Isn't Valid
Assume you use enterprise business message ProcessSalesOrderFulfillmentEBM to create a sales order and encounter
this error.
Error Message: {http://xmlns.oracle.com/apps/scm/doo/decomposition/receiveTransform/transformSalesOrder/
DooDecompTransformSalesOrderComposite}ProcessSalesOrderFulfillmentResponseEBM
Fault ID default/DooDecompTransformSalesOrderComposite!11.1.5.0.0*soa_7289e448-8b78-408f-af5c-116da7e1d9d2/
DecompositionProcess/70017-BpThw8-BpSeq55.49-2
Fault Time Sep 16, 2013 11:24:34 AM
Non Recoverable Business Fault :1 env:Server Attribute ORG_ID has invalid value 300000000562209 for service
ProcessOrderValidation.
2027
Oracle SCM Cloud Chapter 12
Implementing Order Management Maintain and Troubleshoot
This error occurs because the payload specifies value 300000000562209 for attribute ORG_ID, but the
Order Management database doesn't contain this value. The payload also doesn't correctly specify attribute
BusinessUnitReference and attribute BusinessUnitIdentification.
Assume you're attempting to create a sales order for Chicago Distribution Center, which is in USA2 Business Unit, and
attribute BU_ID for this business unit contains 300000001130053. To fix the problem, you must define these attributes.
Add this code to you payload.
<corecom:BusinessUnitReference>
<corecom:BusinessUnitIdentification>
<!-- BUSINESS UNIT ID-->
2028
Oracle SCM Cloud Chapter 12
Implementing Order Management Maintain and Troubleshoot
<corecom:AlternateObjectKey>
<corecom:ID>300000001130053</corecom:ID>
</corecom:AlternateObjectKey>
</corecom:BusinessUnitIdentification>
</corecom:BusinessUnitReference>
You send a request payload that uses the GetOrderDetails operation of web service OrderInformationService to get
order details. . .
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:typ="http://
xmlns.oracle.com/apps/scm/doo/decomposition/orderDetailServices/orderInformationService/
types/" xmlns:ord="http://xmlns.oracle.com/apps/scm/doo/decomposition/orderDetailServices/
orderInformationService/">
<soapenv:Header/>
<soapenv:Body>
<typ:GetOrderDetails>
<!--Zero or more repetitions:-->
<typ:Order>
<!--Optional:-->
<ord:SourceTransactionIdentifier></ord:SourceTransactionIdentifier>
<!--Optional:-->
<ord:SourceTransactionSystem>OPS</ord:SourceTransactionSystem>
<!--Optional:-->
<ord:SourceTransactionNumber>21018</ord:SourceTransactionNumber>
<!--Optional:-->
<ord:SourceTransactionRevision></ord:SourceTransactionRevision>
<!--Optional:-->
<ord:IncludeHeaderAndLineAttributesOnly></ord:IncludeHeaderAndLineAttributesOnly>
</typ:Order>
</typ:GetOrderDetails>
</soapenv:Body>
</soapenv:Envelope>
You use the same user role and password that you use to successfully query and create sales orders in the Order
Management work area, but you receive an error response. . .
<env:Envelope xmlns:env="http://schemas.xmlsoap.org/soap/envelope/">
<env:Header/>
<env:Body>
<env:Fault>
<faultcode>env:Server</faultcode>
<faultstring>access denied (oracle.wsm.security.WSFunctionPermission http://server:port/apps/scm/doo/
decomposition/orderDetailServices/orderInformationService/OrderInformationService#GetOrderDetails invoke)</
faultstring>
</env:Fault>
</env:Body>
</env:Envelope>
This problem occurs because you must use the Manage Order Details Web Service privilege to access
OrderInformationService, but the user role that you used when you signed into Oracle Fusion Applications doesn't have
this privilege.
To fix the problem, assign privilege Manage Order Details Web Service
(DOO_MANAGE_ORDER_DETAILS_WEB_SERVICE_PRIV) to your user role. For details, see the Manage User Roles and
Privileges in Order Management topic.
2029
Oracle SCM Cloud Chapter 12
Implementing Order Management Maintain and Troubleshoot
You try to release a credit check hold through a web service, but the service returns a failed status. For example, the
payload fails even when I use different reason codes.
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:dood="http://xmlns.oracle.com/apps/scm/doo/decomposition/orderDetailServ
ices/DooDecompOrderDetailSvcComposite">
<soapenv:Header/>
<soapenv:Body>
<dood:ReleaseHoldProcessRequest>
<!--1 or more repetitions:-->
<dood:ReleaseHoldRequestParams>
<dood:SourceOrderSystem>OPS</dood:SourceOrderSystem>
<dood:SourceOrderId>300000005191106</dood:SourceOrderId>
<dood:SourceLineId>300000005191107</dood:SourceLineId>
<dood:SourceHoldCode>SR_TEST</dood:SourceHoldCode>
<dood:HoldReleaseReasonCode>ORA_CREDIT_CHK_FAIL_RESOLVED</dood:HoldReleaseReasonCode>
<dood:HoldReleaseComments>NewTest</dood:HoldReleaseComments>
</dood:ReleaseHoldRequestParams>
</dood:ReleaseHoldProcessRequest>
</soapenv:Body>
</soapenv:Envelope>
You can't release a credit check hold through a web service. You can release it only in the Order Management work area.
Sign into Order Management with a privilege you can use to release the hold, then release it. For details, see the Allow
Users to Close Case Folders topic.
Performance Problems
I use OrderFulfillmentResponseService to set up an integration with Integration Cloud Service so we can update the
status on the fulfillment line. It works fine until we have a lot of sales orders to process. When we have thousands of
order lines to update we expect the update to finish in about 10 to 15 minutes, but it actually takes over two hours.
The integration processes requests in parallel whether you set the Invocation Mode attribute on the connector to
Asynchronous Service or Synchronous. For example, if you have 1,000 requests, the integration will process them all at
the same time. It doesn't put them in a queue. Also, serviceOrderFulfillmentResponseService doesn't limit volume. For
example, it doesn't put limits on the number of web service calls that it can send in one minute.
This problem usually happens because the server that you use to host Integration Cloud Service isn't optimized to
handle a high volume of transactions. To fix this problem, work with the person who administers the server that hosts
Integration Cloud Service and see if you can optimize it to handle more transactions, such as adding the number of
threads the server can process at the same time.
You send a payload to web service ReceiveOrderRequest to request to create a sales order.
<ns1:OrchestrationOrderRequest xmlns:ns2="http://xmlns.oracle.com/apps/scm/doo/decomposition/
receiveTransform/receiveSalesOrder/model/">
<ns2:SourceTransactionIdentifier>PMC-070716-013</ns2:SourceTransactionIdentifier>
<ns2:SourceTransactionNumber>PMC-070716-013</ns2:SourceTransactionNumber>
<ns2:BuyingPartyName>JAH CUSTOMER SHARED</ns2:BuyingPartyName>
<ns2:BuyingPartyContactName>Peter Pan</ns2:BuyingPartyContactName>
<ns2:TransactionalCurrencyCode>USD</ns2:TransactionalCurrencyCode>
<ns2:TransactionOn>2016-07-06T02:12:01</ns2:TransactionOn>
<ns2:RequestingBusinessUnitIdentifier>US_W_888_BU</ns2:RequestingBusinessUnitIdentifier>
<ns2:PartialShipAllowedFlag>false</ns2:PartialShipAllowedFlag>
2030
Oracle SCM Cloud Chapter 12
Implementing Order Management Maintain and Troubleshoot
<ns2:OrchestrationOrderRequestLine>
The request seems to run successfully but the Order Management work area doesn't display the sales order. You run a
flow trace in Oracle Enterprise Manager, which displays. . . .
<bpelFault><faultType>0</faultType><selectionFailure xmlns="http://docs.xyz.org/wsbpel/2.0/process/
executable"></selectionFailure></bpelFault>
. . .and. . .
Exception is thrown because the from-spec at line 1,616 is evaluated to be empty
. . .and. . .
AssignEILAMServiceInput (faulted)
<details>
<from-spec>
<from>$inputVariable.payload/client:OrchestrationOrderRequest/ns4:SourceTransactionSystem</from>
</from-spec>
<variable>
<message>inputVariable</message>
</variable>
<fault>
<bpelFault>
<faultType>0</faultType>
<selectionFailure/>
</bpelFault>
</fault>
</details>
2031
Oracle SCM Cloud Chapter 12
Implementing Order Management Maintain and Troubleshoot
For example.
The problem occurs because your request payload doesn't specify the source system. To fix it, add attribute
SourceTransactionSystem to your payload.
<ns2:SourceTransactionSystem>ORA_BM_CPQ</ns2:SourceTransactionSystem>
For example.
<ns1:OrchestrationOrderRequest xmlns:ns2="http://xmlns.oracle.com/apps/scm/doo/decomposition/
receiveTransform/receiveSalesOrder/model/">
<ns2:SourceTransactionIdentifier>PMC-070716-013</ns2:SourceTransactionIdentifier>
<ns2:SourceTransactionNumber>PMC-070716-013</ns2:SourceTransactionNumber>
2032
Oracle SCM Cloud Chapter 12
Implementing Order Management Maintain and Troubleshoot
<ns2:SourceTransactionSystem>ORA_BM_CPQ</ns2:SourceTransactionSystem>
For an example that uses flow trace, see the Route Requests from Order Management to Fulfillment Systems topic.
We use the Order Import web service and Receive Order service to import source orders. I need the header details and
order line details for holds that Order Management applies as a result of the import. I need to know whether Order
Management applies the hold and, if not, why not.
The response from Order Import provides details in the callback for each asynchronous operation. Examine the
elements in the response.
ord:ReturnStatus?</ord:ReturnStatus>
<!--Optional:-->
ord:MessageName?</ord:MessageName>
<!--Optional:-->
ord:MessageText?</ord:MessageText>
These elements indicate whether the service successfully processed the sales order or, if not, the errors it encountered
and error text.
The RequestHold operation and Release Pause Tasks operation are asynchronous. You must implement the callback to
receive a response from them.
Related Topics
• Overview of Importing Orders into Order Management
• Set Up User Roles and Privileges in Order Management
• Filter out order lines that are canceled, closed, on backorder, or that Order Management has sent to billing
when you create a business rule that modifies a value on a fulfillment line that's still in progress.
• Filter out order lines you already fulfilled. For example, filter out lines you already shipped for outbound lines or
lines you already received and delivered for return lines.
• Filter so you only process changes that you make to billing attributes, for example, on the Billing tab of the
order line, and only if you haven't sent the order line to billing. For example, only modify Accounting Rule,
Payment Terms, Receivable Transaction Type, and so on. Don't modify any other attributes.
2033
Oracle SCM Cloud Chapter 12
Implementing Order Management Maintain and Troubleshoot
• Avoid the NullPointerException error. If your logic depends on using an attribute value as part of a calculation,
then filter out lines that include an attribute that doesn't contain a value.
• Filter according to line category code. For example, to process only order lines, not return lines, filter the
categoryCode attribute on the fulfillment line according to ORDER. To process only returns, filter it according to
the value RETURN.
• If you use an order management extension, pretransformation rule, or posttransformation rule to set the
default values for attributes, then filter out fulfillment lines that reference the original return when you populate
the value for the Accounting Rule attribute and Invoicing Rule attribute.
while( lines.hasNext() ) {
def line = lines.next();
Long referenceFlineId = line.getAttribute("ReferenceFulfillmentLineIdentifier");
if (runningLine.getAttribute("FulfillLineStatusCode") == "CLOSED" ||
runningLine.getAttribute("FulfillLineCanceledFlag") == "Y" || //Line is cancelled.
runningLine.getAttribute("FulfillLineShippedQty") != null || //Line is shipped.
runningLine.getAttribute("FulfillLineInvoiceInterfacedFlag") == "Y" ){ //Line is interfaced to invoicing.
// This line isn't valid for setting default values.
continue;
}
}
else {
// This sales order doesn't have a revision.
//Its ok to set the default value for attributes.
2034
Oracle SCM Cloud Chapter 12
Implementing Order Management Maintain and Troubleshoot
}
//Put your defaulting logic here.
//line.setAttribute(<attribute name>, <value>);
}
def rowset = flinePVO.findByViewCriteriaWithBindVars(vc, -1, new String [0], new String [0]);
if (rowset.hasNext()) {
def fline = rowset.first();
return fline;
}
}
2035
Oracle SCM Cloud Chapter 12
Implementing Order Management Maintain and Troubleshoot
The line-selection criteria filters out lines that can't ship so Order Management only sends shippable lines to the
fulfillment system that processes shippable lines, such as the shipping system or Global Order Promising.
Note.
• Use the Manage Orchestration Process Definitions task in the Setup and Maintenance work area.
• Use the line-selection criteria to add the rule.
• Add the rule to each orchestration process step that shippable affects, as necessary. For example, if the item is
a warranty, then it isn't shippable. To filter out the line that isn't shippable, you probably want to add the rule to
each step that references a schedule, reserve, or ship task, such as the Schedule step, the Create Reservation
step, Create Shipment Request step, and so on.
2036
Oracle SCM Cloud Chapter 12
Implementing Order Management Maintain and Troubleshoot
• The entire If statement isn't visible in the screen capture. Here are the entire statements.
◦ DooSeededOrchestrationRules.DOOFLine.categoryCode is "ORDER"
◦ DooSeededOrchestrationRules.DOOFLine.shippableFlag is "Y"
• You can't use Visual Information Builder to select fulfillment lines. You must edit the orchestration process and
use Oracle Business Rules.
• If the nonKitModelFlag attribute contains Y on a line-selection criteria, and if the order line contains a
configuration model, and if the model contains a kit, then the rule will select the line and process it.
If DooSeededOrchestrationRules.DOOFLine.nonKitModelFlag is Y
◦ nonKitModelFlag is a temporary attribute. Its data exists only in active, working memory, so you can't
access it later in downstream fulfillment.
Write a pretransformation rule where you set the value for an attribute, but only after you filter lines. For example.
• If the order line isn't closed, canceled, shipped, or already sent to billing, then set the default value for the
requested ship date attribute.
For details about how to create a posttransformation rule, see the Transformation Rules topic.
2037
Oracle SCM Cloud Chapter 12
Implementing Order Management Maintain and Troubleshoot
Note.
• Use the Manage Processing Constraints task in the Setup and Maintenance work area.
• Set the Entity attribute to Order Fulfillment Line.
• Use the Details area to add your filters.
Assume you don't want your users to modify a fulfillment line value, such as Ship-to Site, if the line is closed or
canceled, or if it already shipped or already invoiced.
2038
Oracle SCM Cloud Chapter 12
Implementing Order Management Maintain and Troubleshoot
You can also create a constraint that prevents the user from submitting a sales order that doesn't include payment
terms for lines that meet a specific criteria. For example, the line isn't a return line, or the line is for an internal transfer.
For details, see the Control Payment Terms section in topic Guidelines for Controlling Customer Details in Order
Management.
Related Topics
• Overview of Creating Order Management Extensions
• Processing Constraints
• Orchestration Processes
• Select Fulfillment Lines for Orchestration Process Steps
• Another Example of Using Extensible Flexfields In Line-Selection Rules
Upstream
Fix Connection Problems with Source Systems
Troubleshoot an error message that indicates Order Management Cloud can't connect to a source system, such as
Oracle Configure, Price, and Quote Cloud.
1. In the Navigator, click Order Management.
2. On the Overview page, click Tasks > Manage Order Orchestration Messages.
3. On the Manage Order Orchestration Messages page, set the Order Orchestration Function attribute to Send
Event Notification, then click Search.
4. Examine the results.
◦ Make sure the search results displays an entry that includes the same URL you specified in the Connector
URL attribute of page Manage Connector Details. For details about this attribute, see the Integrate Order
Management with Source Systems topic.
◦ Make sure the URL correctly identifies the connector that resides on the source system. To do this, sign
into your source system, then examine the connector services that are running.
◦ Wait a minute for the log to refresh, requery the Order Orchestration Messages page, then examine
the search results again to determine whether the connection successfully restarted. A network error
or some other problem might cause the connection to momentarily fail. If the connection restarted
successfully, then the list will include details about the events that are associated with the connector URL.
2039
Oracle SCM Cloud Chapter 12
Implementing Order Management Maintain and Troubleshoot
Error Messages
Problem Solution
I encounter an error message. If your order import includes a coverage item, and if your import data already defines pricing
for the item before you do the import, then make sure the extended amount for the charge
components on the coverage line contains a value.
Order management did
not import source order
TEST_NOV21_02 because of the Make sure the Duration Header Total attribute on the DOO_ORDER_CHARGE_COMPS_INT tab
following error: An order of the order import template contains a value for each coverage line.
was not created due to an
unknown error. Check the
run time user interface for
processing status. Number
of orders that did not pass
validation: 1. Some of these
orders may be available
in the order entry user
interface.
I encounter an error message. Set the RollupFlag attribute to N on the DOO_ORDER_CHARGES_INT tab of the order import
template.
Order xxx will not be
imported due to the
following error:
An order was not created due
to an unknown error. null.
Request Id: 1018270
Batch Name: SOF1
Source System: OPS
Order Number: null
Allow Auto Purge: Y
Number of orders that were
imported: 0.
Check the run time user
interface for processing
status.
I import a sales order, but then Disable the DOO_IMPORTED_DRAFT_HEADER_UPDATE processing constraint.
encounter an error when I use the
2040
Oracle SCM Cloud Chapter 12
Implementing Order Management Maintain and Troubleshoot
Problem Solution
A sales order was not Party Identifier Party Number Party Name Customer Identifier Customer Number Customer
created because source Name
order does not include
a value for required
attribute ShipToPartyName. Party Contact Identifier Party Contact Number Party Contact Name
Provide a value for this
attribute, and then submit
the source order again.
I encounter an error message while If you import an order revision, then you must include the Source Transaction Line Identifier
importing an order revision. and Source Transaction Schedule Identifier on the DOO_ORDER_ADDRESSES_INT tab of your
import worksheet.
Order management didn't
import source order
3502701192-10 because
of the following error:
A sales order was not
created because source
order 3502701192-10
doesn't include a value
for required attribute
BILL_TO_CUSTOMER_ID, on
source order line 1, with
source order schedule 1.
Provide a value for this
attribute, and then submit
the source order again.
2041
Oracle SCM Cloud Chapter 12
Implementing Order Management Maintain and Troubleshoot
I import a sales order and submit it. Order Management ships the order, but it gets stuck in Shipped status and I
encounter an error that indicates the value of an attribute can't contain more than 30 characters. I attempt to use a
recover action, but recover doesn't fix the problem.
This problem typically happens because Accounts Receivable in Oracle Fusion Applications requires that the value for
some attributes not exceed 30 characters. It's possible that the value for an attribute in your import payload exceeds 30
characters. Have a look at them.
• SourceTransactionNumber
• SourceTransactionScheduleNumber
• SourceTransactionLineIdentifier
If you don't use Oracle Fusion Receivables to invoice your sales orders, and if your value must exceed 30 characters,
then disable a constraint.
If you import a source order that has values that exceed 30 characters, and if SOURCE ATTRIBUTE LENGTH
VALIDATION is enabled, then Order Management sets the order status to Draft and displays an error message
in the Order Management work area. You must discard the draft, fix the character limit or disable the constraint,
then reimport the source order.
There Are Gaps in My Order Lines
For example, I import a return order that has two referenced return lines, line 1 and line 2. Some time later, I import a
revision to this return. The revision adds another line to the return, but the Manage Orders page displays this line as line
number 4. I expected it to display line 3, not 4.
2042
Oracle SCM Cloud Chapter 12
Implementing Order Management Maintain and Troubleshoot
SOURCE_ORDER_NUMBER
HEADER_ID SOURCE_LINE_NUMBER
FULFILL_LINE_ID FULFILL_LINE_NUMBER
LINE_NUMBER DISPLAY_LINE_NUMBER
Notice that SOURCE_LINE_NUMBER has a gap between 5 and 8, and LINE_NUMBER has a gap between 3 and 6, and
7 and 9. Its possible that you used SOURCE_LINE_NUMBER or LINE_NUMBER in your import payload. Some import
technologies, such as OrderInformationService, include these attributes in their response payload but you must not use
them in your import payload when you import a revision or return.
If you're importing a revision or return and you don't want a gap in the order line number or fulfillment line number,
then include a value for FULFILL_LINE_ID but not SOURCE_LINE_NUMBER in your payload. The Order Management
work area will use the DISPLAY_LINE_NUMBER as the value to display on the Manage Orders page and other fulfillment
views.
If you must import binary data, then you must convert your binary data to text before you do the import, and you must
use the base64 encoding scheme when do the conversion.
This import failed because the ampersand ( & ) in the Data tag isn't in base64 encoding.
Problem Solution
I encounter an error message. Include details for one or more party attributes.
• Party Identifier
A sales order was not
created because source • Party Number
order does not include • Party Name
a value for required • Party Contact Identifier
2043
Oracle SCM Cloud Chapter 12
Implementing Order Management Maintain and Troubleshoot
Problem Solution
Scheduled Processes
Assume you run the Import Sales Orders scheduled process, it finishes running and reports status Error.
2044
Oracle SCM Cloud Chapter 12
Implementing Order Management Maintain and Troubleshoot
For example.
Note.
1. On the Scheduled Processes page, in Search Results, click the row that's in error.
2. In the Log and Output area, next to Attachment, click the link.
3. Open the attachment and examine the error message.
For example.
Request Id: 65735
Batch Name: 10810
Source System: null
Order Number: null
Allow Auto Purge: Y
Order PMC_IMP_161208_002 will not be imported due to the following error: An order was not created because
no matching row for attribute ProductNumber with the value AS54888777 was found for the source order with
2045
Oracle SCM Cloud Chapter 12
Implementing Order Management Maintain and Troubleshoot
the following details: source order PMC_IMP_161208_002, source order line 1, source order schedule 11.
Check the attribute value, and resubmit the order..
Number of orders that were imported: 0. Check the run time user interface for processing status.
Number of orders that did not pass validation: 1. Some of these orders may be available in the order entry
user interface.
Overall Result : ERROR
This error occur because data in your order import template isn't correct. For example, ProductNumber contains
AS54888777 but the Oracle database contains AS54888. Use SQL to query the Oracle database and identify the correct
data to import.
This error occur because the SOLD_TO_PARTY_ID attribute contains 300,000,001,469,001,777 but the Oracle database
contains 300000001469001. Use SQL to query the Oracle database and identify the correct data to import.
Configured Items
You might encounter an error where your import can't find part of a configured item, such as a configuration node. For
example, you encounter an error.
Cannot find a matching configuration node for item 12345
A configuration node is part of a configured item. A configure option is an example of a configuration node. This error
might occur even if the node exists in the structure of a configured item that includes an instance type of Optional
Single Instance. The order import process does a search that validates and creates the structure that it includes in the
sales order even if a node, such as Option Classes, is missing in the order import data that defines the structure.
However, if the root of the configured item contains a reference model that you set up as Optional Single Instance, or
if its part of an option class, and if the order import data doesn't include the absolute path to the node, then the search
won't find the node.
To avoid this problem, use the Product Information Management work area to modify the instance type of the structure
from Optional Single Instance to Required Single Instance. Your modification won't affect functional behavior. You must
also set order management parameter Use Configurator for Order Import Validation to Yes.
For example, assume the order import data includes M1, M1.M2, M1.M2.SI2, and the Product Information Management
includes this structure for a configured item.
M1
|_M2 (Optional Single Instance)
|_OC1
|_SI2
The order import search won't find the complete structure, it will create an error during order import, and it will add an
entry in the Order Import log that's similar to this entry.
2046
Oracle SCM Cloud Chapter 12
Implementing Order Management Maintain and Troubleshoot
The order import process failed for source order source_order_identifier for the following reason: Cannot
find a matching configuration node for item item_number on order line number order_line_number.
where
This entry indicates that the search couldn't find a matching configure option in the Optional Single Instance node.
For another example, assume the order import data includes M1, M1.M2, M1.M2.SI1, and the Product Information
Management contains this structure.
M1
|_OC1
|_M2 (Optional Single Instance)
|_SI1
The order import search will fail in the same way it failed in the first example.
Cross-References
Can't Find a Cross-Reference Value for an Attribute
You might also encounter this error in the response to your import payload.
<bpelFault>
<faultType>1</faultType>
<processResponse xmlns="http://xmlns.oracle.com/apps/scm/doo/decomposition/receiveTransform/
receiveSalesOrder/DooDecompReceiveOrderComposite">
<part name="payload">
<processResponse xmlns:client="http://xmlns.oracle.com/apps/scm/doo/decomposition/receiveTransform/
receiveSalesOrder/DooDecompReceiveOrderComposite" xmlns="http://xmlns.oracle.com/apps/scm/doo/decomposition/
receiveTransform/receiveSalesOrder/DooDecompReceiveOrderComposite">
<client:OrchestrationOrderResponse>
<ns4:SourceTransactionNumber xmlns:ns4="http://xmlns.oracle.com/apps/scm/doo/decomposition/receiveTransform/
receiveSalesOrder/model/">HITECH0001</ns4:SourceTransactionNumber>
<ns4:SourceTransactionIdentifier xmlns:ns4="http://xmlns.oracle.com/apps/scm/doo/decomposition/
receiveTransform/receiveSalesOrder/model/">36466323</ns4:SourceTransactionIdentifier>
<ns4:SourceTransactionSystem xmlns:ns4="http://xmlns.oracle.com/apps/scm/doo/decomposition/receiveTransform/
receiveSalesOrder/model/">ORA_BM_CPQ</ns4:SourceTransactionSystem>
<ns4:ReturnStatus xmlns:ns4="http://xmlns.oracle.com/apps/scm/doo/decomposition/receiveTransform/
receiveSalesOrder/model/">ERROR</ns4:ReturnStatus>
<ns4:MessageName xmlns:ns4="http://xmlns.oracle.com/apps/scm/doo/decomposition/receiveTransform/
receiveSalesOrder/model/">env:Server</ns4:MessageName>
<ns4:MessageDescription xmlns:ns4="http://xmlns.oracle.com/apps/scm/doo/decomposition/receiveTransform/
receiveSalesOrder/model/">A cross-referenced value was not found for attribute CURRENCY_CODE in source
system ORA_BM_CPQ.</ns4:MessageDescription>
</client:OrchestrationOrderResponse>
</processResponse>
</part>
</processResponse>
</bpelFault>
2047
Oracle SCM Cloud Chapter 12
Implementing Order Management Maintain and Troubleshoot
This problem occurs because the source system, such as CPQ, doesn't require cross references but the Enable Data
Cross-Reference option is enabled on the Manage Planning Source Systems page in the Setup and Maintenance work
area.
• You didn't collect data from the source system for Global Order Promising.
• Your import payload doesn't include the correct UOM code.
2048
Oracle SCM Cloud Chapter 12
Implementing Order Management Maintain and Troubleshoot
First, in the Setup and Maintenance work area, open the Review Collected Order Reference Data page, click Units of
Measure, then search for the unit of measure that your import payload references. If you can't find it, then you must
collect data. For details, see the Quick Start to Implement Order-to-Cash topic.
This SQL determines whether the inventory and data collection tables contain the UOM you're importing.
Next, run SQL to get the unit of measure that the UOM code references.
SELECT uom_code,
uom_class,
base_uom_flag,
unit_of_Measure,
description
FROM inv_units_of_measure_B iuomb,
inv_units_of_measure_tl iuomtl
WHERE iuomb.unit_of_measure_id = iuomtl.unit_of_measure_id
and iuomtl.language = 'US'
ORDER BY UOM_code;
AbC 1 Y EA EACH
Modify your input payload so it uses the UOM_CODE that the query returns. For example, replace. . .
<ns2:OrderedQuantity>1</ns2:OrderedQuantity>
<ns2:OrderedUOMCode>EA</ns2:OrderedUOMCode>
. . . with. . .
<ns2:OrderedQuantity>1</ns2:OrderedQuantity>
<ns2:OrderedUOMCode>AbC</ns2:OrderedUOMCode>
2049
Oracle SCM Cloud Chapter 12
Implementing Order Management Maintain and Troubleshoot
As an alternative, modify your input payload or so it uses the OrderedUOM attribute instead of OrderedUOMCode, and
references the value from UNIT_OF_MEASURE instead UOM_CODE.
<ns2:OrderedQuantity>1</ns2:OrderedQuantity>
<ns2:OrderedUOM>EA</ns2:OrderedUOM>
Other Problems
Problem Solution
I use OrderImportService to import Manage Customers doesn't support managing contact and contact email for each account.
customer data, including the Contact
attribute and the ContactEmail
attribute. I use the Customer Data
Management page and verify that the
import successfully imported contact
and contact email. I prefer to manage
the contact and contact email
for each account on the Manage
Customers page, but can't view these
attributes on this page.
It takes a long time to create the CSV Try this on the computer you're using when you create the CSV file.
file when I do file-based data import.
• Install the latest version of Microsoft Visual C++ Redistributable Packages.
• Disable hardware acceleration in Excel.
For example, every day I import over
300 sales orders from my source • Disable Excel add-ins that you don't need.
system into Order Management. I
can load the header details in the
first worksheet with no problems,
but after I after import about 1,900
lines from the second worksheet,
DOO_ORDER_LINES_ALL_INT, the
server performance declines to 15 to
20 seconds delay for each line.
I import a referenced return order, Make sure the business unit on the order line that you import is the same as the business unit
submit it, but Receivables doesn't on the original order line.
create a credit memo for the return.
I use the Source Transaction Source Transaction Line Identifier and the line number don't store the same data.
Line Identifier attribute on the
DOO_ORDER_LINES_ALL_INT
worksheet when I import through Source Transaction Line Identifier identifies a transaction line in your source system.
file-based data import, then notice LINE_NUMBER stores a number for the order line in Order Management.
that I have sales orders where source
line numbers are 20, 21, and 22, but Order Management automatically creates the line number and stores it in the LINE_NUMBER
the line numbers are 1, 2, and 3. Is column of the DOO_LINES_ALL table in the Oracle database. Order Management does this to
there way to make the line numbers make sure each line number is unique in the sales order. You can't modify this value.
use the same values that I set in
Source Transaction Line Identifier?
2050
Oracle SCM Cloud Chapter 12
Implementing Order Management Maintain and Troubleshoot
Problem Solution
The import reports only one error at This is expected behavior. The import stops at the first error it encounters so you can fix that
a time. error. Sometimes an error on one line affects an error on another line. So its important to fix
each error before continuing to the next error.
Related Topics
• Overview of Importing Orders into Order Management
• Set Up User Roles and Privileges in Order Management
Assume you run the ProcessOrderRequest operation on the ReceiveOrderRequestService web service at https://
server:port/soa-infra/services/default/DooDecompReceiveOrderExternalComposite/ReceiveOrderRequestService.
And the order line section of the payload includes this code.
<ns2:OrchestrationOrderRequestLine>
<ns2:BillToCustomerName>ZZZZZZZZZZ</ns2:BillToCustomerName>
<ns2:BillToCustomerIdentifier>8888888888</ns2:BillToCustomerIdentifier>
<ns2:BillToAccountSiteUseIdentifier>9999999999</ns2:BillToAccountSiteUseIdentifier>
Run an SQL query to determine whether these values are correct. For details, see the Use SQL to Query Order
Management Data topic.
BuyingPartyName PARTY_NAME
BuyingPartyId PARTY_ID
2051
Oracle SCM Cloud Chapter 12
Implementing Order Management Maintain and Troubleshoot
BillToCustomerName PARTY_NAME
BillToCustomerIdentifier CUST_ACCOUNT_ID
BillToAccountSiteUseIdentifier ORIG_SYSTEM_REFERENCE
Or this error.
2052
Oracle SCM Cloud Chapter 12
Implementing Order Management Maintain and Troubleshoot
An order was not created because a value was not provided for the required attribute BILL_TO_SITE_USE_ID
in the source order with the following details: source order XXXXXXXXX, source order line 1, source order
schedule 1. Provide a value for BILL_TO_SITE_USE_ID, and resubmit the order.
Then run SQL to identify the correct data you should use.
SELECT accounts.party_id ,
accounts.account_name ,
accounts.account_number ,
party_sites.party_site_name ,
sites.cust_acct_site_id ,
sites.cust_account_id ,
site_uses.site_use_code ,
site_uses.primary_flag ,
site_uses.site_use_id ,
site_uses.location ,
locations.ADDRESS1 || ' ' || locations.ADDRESS2 || ' ' || locations.ADDRESS3 || ' ' || locations.ADDRESS4
|| ' ' || locations.CITY || ' ' || locations.POSTAL_CODE || ' ' || locations.STATE ||
' ' || locations.country ,
territory.territory_short_name
FROM fusion.hz_cust_accounts accounts ,
fusion.hz_cust_acct_sites_all sites ,
fusion.hz_party_sites party_sites ,
fusion.hz_cust_site_uses_all site_uses ,
fusion.hz_locations locations ,
fusion.fnd_territories_vl territory
WHERE sites.cust_account_id = accounts.cust_account_id
AND party_sites.party_site_id = sites.party_site_id
AND site_uses.cust_acct_site_id = sites.cust_acct_site_id
AND locations.location_id = party_sites.location_id
-- AND site_uses.site_use_code = 'BILL_TO'
-- AND site_uses.primary_flag = 'Y'
AND site_uses.STATUS = 'A'
AND accounts.STATUS = 'A'
AND sites.STATUS = 'A'
AND locations.COUNTRY = territory.territory_code
AND EXISTS
(
SELECT 1
FROM fusion.fnd_setid_assignments
WHERE set_id = sites.set_id
AND reference_group_name = 'HZ_CUSTOMER_ACCOUNT_SITE'
AND determinant_type = 'BU'
)
and upper(accounts.account_name ) like upper('&CUSTOMER_NAME%')
2053
Oracle SCM Cloud Chapter 12
Implementing Order Management Maintain and Troubleshoot
BuyingPartyId 300000001469001
BillToCustomerIdentifier 300000001469002
BillToAccountSiteUseIdentifier 300000001469016
Related Topics
• Overview of Importing Orders into Order Management
• How Order-to-Cash Works with Order Capture Systems
• Overview of Importing Orders into Order Management
2054
Oracle SCM Cloud Chapter 12
Implementing Order Management Maintain and Troubleshoot
Downstream
Troubleshoot Problems in Downstream Fulfillment
Fix problems in your Order Management implementation that occur in downstream fulfillment.
Trouble Shoot
I encounter an error. This error occurs when the user doesn't set the payment term on the order header or order
line, and the customer account setup doesn't set the payment term.
I encounter an error when I run This error happens when you set the value instead of the Id during set up. Try this.
the Import AutoInvoice scheduled
process. 1. Sign in with a job role that you can use to access the Project Financial Management
offering.
2. In the Setup and Maintenance work area, open the task.
You must enter a value in
either the Original System ◦ Offering: Project Financial Management
Bill-to Customer Reference
column or the Bill-to ◦ Functional Area: Project Billing Base
Customer Account Number
column. ◦ Task: Manage Transaction Sources
3. On the Manage Transaction Sources page, in the Name attribute, search for, then open
Distributed Order Orchestration.
4. On the Edit Transaction Source page, in the Customer area, set the option to Id for these
attributes.
◦ Bill-to Customer
◦ Bill-to Address
2055
Oracle SCM Cloud Chapter 12
Implementing Order Management Maintain and Troubleshoot
Trouble Shoot
◦ Bill-to Contact
For details about the scheduled process, see the Guidelines for Implementing Order-to-Cash
topic.
If the problem persists, you might need to delete data in the interface table that Accounts
Receivables uses. First, get approval from Oracle Fusion Product Management to delete this
data. Next, create the AR_AUTOINV_ALLOW_DELETE_UPDATE lookup, then use it to delete
2056
Oracle SCM Cloud Chapter 12
Implementing Order Management Maintain and Troubleshoot
Trouble Shoot
the data. Note that you will only delete data in the interface table. You won't delete any data in
Order Management.
I encounter an error message. Set the Requested Ship Date on the sales order so there's enough time to schedule, ship, and
deliver the item.
I have an item that I normally ship, This problem happens because the fulfillment line in Order Management gets attribute values
such as the AS54888 Desktop for the item from the master organization in the Product Information Management work area.
Computer, but I have a unique need It doesn't get attribute values from the inventory organization in the Inventory Management
to invoice the item but not actually work area.
ship it.
To fix the problem, create a process assignment rule that assigns the item to an orchestration
I enable attributes for my item. process that doesn't ship but that does do billing. For example.
The price on my order line in Order Create a rounding rule so that Pricing rounds the value before Order Management sends it to
Management is different than the Accounts Receivable. For details, see the Manage Rounding Rules topic.
price on the invoice in Accounts
Receivable. Its frequently off by a
dollar or less.
2057
Oracle SCM Cloud Chapter 12
Implementing Order Management Maintain and Troubleshoot
Trouble Shoot
If you create a rounding rule for this purpose, and if you import your sales order, then you
must set the Freeze Price attribute to N in your import payload. If its Y, then the prices are
frozen and Pricing won't apply the rounding rule. For details about freezing price, see the
Freeze Price on Sales Orders topic.
I create a sales order and submit it. If the Supply Type attribute on the line for the supply order is.
Supply Orchestration creates the
supply order and reserves the item in • ATP. Promising examines the on-hand inventory and uses it to schedule the order line.
inventory. You can use the Supply Chain Orchestration work area to reserve inventory and pick the
item.
• Buy. Wait until the purchase order is finished, then use Supply Chain Orchestration to
Assume today is January 1, 2021.
reserve inventory and pick the item.
Global Order Promising examines
your supply chain, determines
that it can't fulfill the item until For details, see the Manage Your Supply Process topic.
January 7, and communicates these
details to Order Management. Order
Management sets the Scheduled Ship
Date attribute on the fulfillment line
to January 7, and changes the Status
attribute on the order line to Waiting.
This problem happens when you don't set up a value that Order Management can use as the default for the conversion
rate type. Order Management uses the conversion rate type when it converts a foreign currency transaction to the
ledger currency.
1. Go to the Setup and Maintenance work area, click Tasks > Search, then search for and open the Manage
Administrator Profile Values task.
2. On the Manage Administrator Profile Values page, search the Profile Option Code attribute for
AR_DEFAULT_EXCHANGE_RATE_TYPE.
3. In the Profile Values area, add a value. Make sure you set the Profile Level attribute to Site.
2058
Oracle SCM Cloud Chapter 12
Implementing Order Management Maintain and Troubleshoot
If you're using an order management extension to do the conversion, then use this extension code instead of setting the
profile value.
import oracle.apps.scm.doo.common.extensions.ValidationException;
import oracle.apps.scm.doo.common.extensions.Message;
def headerCurrCode=header.getAttribute("TransactionalCurrencyCode");
if(!headerCurrCode.equalsIgnoreCase(ledgerCurrCode) &&
header.getAttribute("CurrencyConversionTypeCode")==null){
String messageText = "Currency Conversion Type must be specified on the Order Header when the Sales Order
Currency and the Currency associated to the Selling Business Unit is not the same";
List messages = new ArrayList();
messages.add(new Message(Message.MessageType.ERROR, messageText));
ValidationException ex = new ValidationException(messages);
throw ex;
}
Attribute Value
Item AS54888
2059
Oracle SCM Cloud Chapter 12
Implementing Order Management Maintain and Troubleshoot
Attribute Value
Quantity 100
You go to a fulfillment view in the Order Management work area, and see that there's an error on the fulfillment line.
A reservation was not created because the reservation quantity is greater than the available-to-reserve
quantity.
Several problems might cause this error. Here are some corrections you can try.
Go to the Order Management work area, open your sales order, then use the Warehouse attribute on the fulfillment line
to change the warehouse.
Assume set up an infinite available-to-promise rule to schedule the order line. However, at run time there's no on-hand
quantity in the sourcing warehouse.
Order Promising doesn't track actual supply when you use an infinite available-to-promise rule. It assumes that supply is
always available. To fix this problem, you can remove the infinite available-to-promise rule.
Assume you create a sourcing rule but didn't set the From Quantity or Less Than Quantity attributes. You might have
set these values in the Order Promising work area or during order import.
Attribute Value
From Quantity 0
These values will work for most implementations, but you can use different ones to meet your requirements.
For details, see the How You Define Quantity-Based Sourcing for Multiple Sources topic.
If you import the sourcing rule, then set values in your import payload instead of using the work area.
2060
Oracle SCM Cloud Chapter 12
Implementing Order Management Maintain and Troubleshoot
Attribute Value
FROM_QTY 0
TO_QTY 9999999
6. Go to the Scheduled Processes work area, then run the Refresh and Start the Order Promising Server scheduled
process.
Modify the Orchestration Process
You can remove the reservation step from you orchestration process and avoid the error message. The sales order will
go to the Awaiting Shipping status even though there isn't any on-hand quantity available. If you remove the step, then
you must manually reserve inventory for each sales order.
Related Topics
• Overview of Importing Orders into Order Management
• Set Up User Roles and Privileges in Order Management
• Troubleshoot Problems with Configure-to-Order
• The request to submit failed because you can't use attribute ITEM ID with value 1000990 as a configure
option for configured item AS54888.
• Order management can't schedule the fulfillment line because item AS54888 isn't associated with
organization M1.
• Scheduling failed for the item because supply isn't available before the latest acceptable date occurs.
• You can't use an attribute with a value as a configure option for a configured item.
• The item passed to order promising was not found in any organization. Verify the item definition.
2061
Oracle SCM Cloud Chapter 12
Implementing Order Management Maintain and Troubleshoot
For details, see the Set Up Promising and Sourcing Rules for Order Management topic.
Related Topics
• Set Up Promising Rules and Sourcing Rules for Order Management
• Overview of Collecting Promising Data for Order Management
• Collect Source System Data
You might also encounter an error message in the Inventory Management work area when you use the Manage Pending
Transactions page. You click a link for an error transaction, click the Edit icon, make your corrections, Click Add All to
Process Schedule, and encounter the error.
At least one of the selected transactions was not added to the process schedule. (INV-2415775) Details: The
transaction was not added because it was not ready for processing, was already in the process schedule, was
locked, was not in confirmed status, or was updated by another user. The On-hand quantity is not affected
for the quantity shipped.
Assume shipment 4028 shipped the sales order but the order status remains at Awaiting Shipping.
1. Sign into Oracle Fusion Applications with a job role that you can use to manage shipments, such as Shipping
Agent. For details, see the Job Roles and Duty Roles That You Use to Implement Order Management topic.
2. Go to the Scheduled Process work area, then run the Send Shipment Advice scheduled process.
Parameter Value
To Shipment The list of values for the From Shipment and To Shipment parameters list the shipments that
Shipping has successfully shipped. If you need details for.
◦ One shipment. Set From Shipment and To Shipment to the same value.
◦ More than one shipment. Set From Shipment to the first shipment you need and set
To Shipment to the last shipment you need. The scheduled process will sequentially
process shipments in the range that you specify. For example, if you set From
2062
Oracle SCM Cloud Chapter 12
Implementing Order Management Maintain and Troubleshoot
Parameter Value
Shipment to 4028 and To Shipment 4030, then the scheduled process will process
shipments 4028, then 4029, then 4030.
◦ Shipment Advice. Send only the shipment advice. Order Management usually
automatically sends the shipment advice after the ship confirm finishes, but you
can use this setting to send it manually if there's a problem. Use it in a normal pick
and ship flow where you ship the item from inventory that you already have in your
warehouse. Don't use it with a drop shipment.
◦ ASN. Send only the advance shipment notice.
◦ Both. Send the shipment advice and the advance shipment notice. Using Both
increases processing on the Oracle server, so Use Both only when you must update
the shipment advice and the ASN.
For this example, assume Vision Operations (V1) is your inventory organization that fulfills the shipment.
2063
Oracle SCM Cloud Chapter 12
Implementing Order Management Maintain and Troubleshoot
Option Value
2064
Oracle SCM Cloud Chapter 12
Implementing Order Management Maintain and Troubleshoot
4. Go to the Scheduled Processes work area, then run the Manage Shipment Interface scheduled process.
Parameter Value
Mode All
To Shipment 4028
2065
Oracle SCM Cloud Chapter 12
Implementing Order Management Maintain and Troubleshoot
Parameter Value
5. Run the Send Shipment Advice scheduled process. See the section earlier in this topic for details.
Modify Options on the Shipment
For details, see the Use SQL to Query Order Management Data topic.
2. Do you receive an error like this?
A cross-referenced value was not found for attribute ShippingCarrierCode in source system OPS.
Attribute Value
2066
Oracle SCM Cloud Chapter 12
Implementing Order Management Maintain and Troubleshoot
Attribute Value
◦ Run the Refresh and Start the Order Promising Server scheduled process.
For details, see the Collect Planning Data for Order Management topic.
4. Run the Send Shipment Advice scheduled process.
5. If the status on the order line is Backordered, then run the Send Intermediate Shipment Status Update
scheduled process. Set it to run periodically on a schedule so that it eventually updates the line after the line
proceeds out of Backordered status.
You can't manually set the status to Partially Closed. The Update or Close Sales Orders scheduled process does that for
you automatically when it finds a sales order that has at least one line that's closed but all lines aren't closed.
If you have a sales order that's in Partially Closed status and you want it to be closed, try running Update or Close Sales
Orders manually. It could be that changes have occurred since the last time Update or Close Sales Orders ran according
to its automatic schedule. For details, see the Update or Close Fulfillment Lines That Remain Open topic.
Related Topics
• Set Up User Roles and Privileges in Order Management
• Collect Planning Data for Order Management
If the Update or Close Sales Orders scheduled process hasn't run since Order Management closed the fulfillment line,
then Order Management might display sales orders and order lines as open even if it closed all the fulfillment lines that
these orders and lines reference. You can run the scheduled process to fix this problem.
• Its recommended that you set up the scheduled process so it runs automatically according to a schedule, such
as every 12 hours.
• The scheduled process also updates the status on the order header.
• The scheduled process also updates the SHIPPED_QUANTITY, SCHEDULE_SHIP_DATE, and
ACTUAL_SHIP_DATE columns in the DOO_LINES_ALL table. If you don't run the process, then the status on the
2067
Oracle SCM Cloud Chapter 12
Implementing Order Management Maintain and Troubleshoot
order line might display as Closed in the Order Management work area but as Open in DOO_LINES_ALL, or the
Scheduled Ship Date on the line might contain a value in the work area but not in DOO_LINES_ALL.
• If you don't run the scheduled process, then the data that you use in various integrations, such as reports and
analytics, might not reflect the latest changes that you see in the Order Management work area.
The scheduled process updates the order status depending on the order line status.
All lines in the order are in the Sets the order status to Canceled.
Canceled status.
At least one line in order is in the Sets the order status to Closed.
Closed status and all other lines are in
the Canceled or Closed status.
The scheduled process gets attribute values from the fulfillment line and uses them to update attributes on the order
line.
These attribute names are slightly different in your business rules and web service payloads.
ShippedQty SumShippedQty
RmaDeliveredQty SumRmaDeliveredQty
FulfilledQty SumFulfilledQty
2068
Oracle SCM Cloud Chapter 12
Implementing Order Management Maintain and Troubleshoot
ActualShipDate MaxActualShipDate
ScheduleShipDate MaxScheduleShipDate
FulfillmentDate MaxFulfillmentDate
Try It
Assume you administer a call center that's open 9 AM to 5 PM, and you must process all order headers that Order
Management creates during the open hours. You also must run the process every day for the 2021 fiscal year, and run
the process after the call center closes.
◦ Go to the Order Management work area, search for, and open your sales order.
◦ On the Overview page, click Actions > Switch to Fulfillment View.
◦ Click the Fulfillment Lines tab.
◦ In the Fulfillment Line Details area, on the General tab, verify that the Status attribute contains Closed.
◦ Click the value in the Orchestration Process Number attribute, such as 300100541247223.
◦On the Orchestration Process page, in the Orchestration Plan area, verify that the last row in the Task
Progress column contains a green check mark.
2. In the Navigator, under the Tools section, click Scheduled Processes.
3. On the Scheduled Process page, click Actions > Schedule New Process.
4. In the Schedule New Process dialog, click the down arrow, click Search, then search for the value.
Parameter Value
Parameter Value
2069
Oracle SCM Cloud Chapter 12
Implementing Order Management Maintain and Troubleshoot
Parameter Value
If you don't enter a start date, end date, or interval hours, then you must enter an entity ID.
You can run a query to get the entity ID.
Start Date and End Date Use Start Date and End Date to specify the time period to consider when updating or closing
the entity.
◦ Start Date. Specify the earliest time and date when Order Management created the
entity.
◦ End Date. Specify the latest time and date when Order Management created the
entity.
For example, if you set Header as the entity, and if you set.
◦ Noon yesterday as the Start Date, and 4 PM yesterday as the End Date, then the
scheduled process updates all order headers that Order Management created
yesterday on or after Noon and on or before 4 PM.
◦ Noon yesterday as the Start Date but don't specify the End Date, then the scheduled
process updates all order headers that Order Management created on or after Noon
yesterday up to the current time.
◦ Noon yesterday as the End Date but don't specify the Start Date, then the scheduled
process updates all order headers that Order Management created on or before Noon
yesterday.
If you enter interval hours, then don't enter a start date or end date.
Interval Hours Period of time in hours to count backward from the time when the process starts. The
scheduled processes uses this interval to identify the entities it processes.
For example, if you enter 8 for interval hours, and if you enter Header, and if you leave
all other attributes empty, then the scheduled process processes all entities that Order
Management created in the eight hours immediately before you click Submit.
For this example, enter 10 in the Interval. The call center is open 9 to 5, which is 8 hours.
You will set the scheduled process to start at 5:30 so the Order Entry Specialists can finish
creating any sales orders that they're currently adding. Using 10 as the interval will pick up
these sales orders, and also any sales orders created after 7:30 AM.
2070
Oracle SCM Cloud Chapter 12
Implementing Order Management Maintain and Troubleshoot
Attribute Value
Frequency Daily
Every 1 Day
9. Click Submit.
2071
Oracle SCM Cloud Chapter 12
Implementing Order Management Maintain and Troubleshoot
doo_headers_all
WHERE
creation_date BETWEEN :currstartdate AND :currenddate
)
=========
HeaderWithCompletedProcessInstancesVO
---------------------
SELECT DISTINCT
headers.header_id,
headers.creation_date
FROM
doo_process_instances pi,
doo_orchestration_groups og,
doo_headers_all headers
WHERE
og.doo_process_instance_id = pi.doo_process_instance_id
AND og.status = 'ACTIVE'
AND og.header_id = headers.header_id
AND headers.open_flag = 'Y'
AND pi.process_active IN (
'COMPLETED',
'INACTIVE'
)
UNION
SELECT DISTINCT
headers.header_id,
headers.creation_date
FROM
doo_lines_all lines,
doo_headers_all headers
WHERE
headers.open_flag = 'Y'
AND headers.header_id = lines.header_id
AND lines.canceled_flag = 'Y';
Assume you use Oracle Fusion Order Orchestration and Planning as your destination system. Assume Vision
Manufacturing is the source system that contains inventory for the AS54888 item.
1. Go to the Plan Inputs work area, then click Tasks > Maintain Supply Network Model.
2. On the Maintain Supply Network Model page, search for the value.
2072
Oracle SCM Cloud Chapter 12
Implementing Order Management Maintain and Troubleshoot
Attribute Value
If you can find Vision Manufacturing, then you already collected it. skip the rest of these steps and go to the
next remedy in this topic.
3. If you can't find Vision Manufacturing, then you must collect it.
Attribute Value
Attribute Value
Don't use the Plan Inputs task that's available in the Setup and Maintenance work area. Use the Plan
Inputs work area instead.
◦ Click Tasks > Collect Planning Data.
◦ In the Collect Planning Data dialog, set the value.
Attribute Value
Assume you set up your source system to use OPS as an abbreviation for Oracle Fusion
Order Orchestration And Planning.
2073
Oracle SCM Cloud Chapter 12
Implementing Order Management Maintain and Troubleshoot
◦ Move the Calendars entity and the Organizations entity to the Selected Entities window, then click
Submit.
◦ Refresh the server. For details, see the Refresh the Order Promising Server for Order Management topic.
4. Create a sales order and see if you can pick the warehouse on the order line.
Attribute Value
3. In the search results, click the row that has your organization, then click Manage Organization Parameters.
4. On the Manage Inventory Organization Parameters page, verify the value.
Attribute Value
5. Create a sales order and see if you can pick the warehouse on the order line.
For details about workday patterns, see the Examples of Managing Workday Patterns topic.
2. On the Manage Workday Patterns page, in the search results, click the name of your work day. For this example,
assume you use the 7 Day 7 Shift work day.
3. In the Edit Time Workday Pattern dialog, make sure the Length in Days attribute contains 7. If it isn't 7,
collections will fail.
2074
Oracle SCM Cloud Chapter 12
Implementing Order Management Maintain and Troubleshoot
◦ In the Edit Time Workday Pattern dialog, set the value, then click Save and Close.
Attribute Value
The Length in Days attribute is ready only, so you will obsolete the existing work day
and create a new one.
◦ On the Work Workday Patterns page, in the search results, click 7 Day 7 Shift OBSOLETE, then click
Actions > Duplicate Workday Pattern.
◦ In the Duplicate Workday Pattern dialog, set the values, then click Save and Close.
Attribute Value
Length in Days 7
Attribute Value
This action adds your new work day pattern to the schedule that you use for the
inventory organization.
◦ In the Edit Duration Schedule dialog, in the Workday Patterns area, click the row that has 7 Day 7 Shift
OBSOLETE, then click Actions > Delete.
◦ Click Save and Close > Done.
◦Go to the Plan Inputs work area, then use the Collect Planning Data task to collect the Calendars entity
and the Organizations entity.
5. Create a sales order and see if you can pick the warehouse on the order line.
2075
Oracle SCM Cloud Chapter 12
Implementing Order Management Maintain and Troubleshoot
Related Topics
• Refresh the Order Promising Server for Order Management
• Examples of Managing Workday Patterns
• Critical Choices for Setting Up Plant Parameters
2076
Oracle SCM Cloud Chapter 12
Implementing Order Management Maintain and Troubleshoot
Its strongly recommended that you periodically run the scheduled process.
Try it.
Attribute Value
4. Click the line in the search results, then click OK > OK.
Parameter Value
For example, if the current system date is January 6, 2021, and if you set this parameter to
5, then the scheduled process deletes data for user actions that finished before January 2,
2021.
In general, five days of data is typically a sufficient amount of data to keep, but you can
adjust the value depending on your business needs.
Attribute Value
Frequency Daily
Every 1 Day
Its recommended that you schedule this process to run one time each day.
7. Click Notification, then choose someone who can monitor the results, such as an order administrator.
8. Click Submit.
2077
Oracle SCM Cloud Chapter 12
Implementing Order Management Maintain and Troubleshoot
2078
Oracle SCM Cloud Glossary
Implementing Order Management
Glossary
action
The kind of access, such as view or edit, named in a security policy.
activity
An event that occurs outside of Order Management Cloud. For example, an orchestration process might include an
activity task type to configure a network router. An activity contains the details needed to finish the task. A user can do
an activity as part of finishingorder fulfillment. Order Management can assign an activity to a user.
approval rule
A statement that specifies an IF THEN condition. The condition determines how and when to route a sales order
through sales order approval. For example, if the order total is greater than $10,000, then get approval from an order
manager.
assemble-to-order (ATO)
An item that warehouse personnel assemble to meet the requirements of a configured item. Warehouse personnel pick
configure options from inventory then assemble them. For example, the Sentinel Laptop Computer is a configured item
that includes configure options, such as hard drive, memory, and processor. Warehouse personnel pick the hard drive,
memory, and processor from inventory shelves, then assemble them into a finished, functioning laptop.
assignment rule
A rule that assigns an orchestration process to fulfillment lines.
attribute
The property of a sales order, order line, fulfillment line, or orchestration process. Customer and Ship-To Address
are each an example of an attribute of a sales order. Quantity is an example of an attribute of an order line. Actual
Start Date is an example of an attribute of an orchestration process. Jeopardy Score is an example of an attribute of a
fulfillment line.
back-to-back fulfillment
A business flow where supply is reserved against a particular sales order until shipping. You create supply for a back-to-
back order using one or more of the following: make, buy, transfer, and reservation of on-hand supply.
2079
Oracle SCM Cloud Glossary
Implementing Order Management
contain delivery dates, individual delivery quantities, or amounts. Complete details necessary to supplier fulfillment are
specified subsequently in purchase orders issued against the agreement.
bucket set
A container that holds the overall range of values that a group of buckets defines.
business event
An occurrence in an application or system that might be significant to objects in some other application or system.
Applying a hold on a sales order is an example of a business event.
business object
A resource in an enterprise database, such as an invoice or purchase order.
business rule
A statement that describes how to implement a business policy or make a business decision. For example, a business
rule can enforce a spending policy, constrain a process so it meets a regulatory requirement, calculate a discount or
premium, provide an offer according to customer value, and so on.
business unit
A unit of an enterprise that performs one or many business functions that can be rolled up in a management hierarchy.
catalog line
Area in the Order Lines tab on the Create Order page in order management that you can use to search for an item
before adding it as an order line.
compensation pattern
A rule that you can set on an orchestration process step that specifies the adjustments to make when an order changes.
Undo, Redo, Update, Cancel, and None are each an example of a compensation pattern. For example, assume the
compensation pattern for a Create Shipment step is Redo, and that this step calls the Cancel service and the Create
service. If Order Management receives a change order that includes a new warehouse for the step, then it runs the
Cancel service and the Create service again.
2080
Oracle SCM Cloud Glossary
Implementing Order Management
configuration model
A hierarchical structure that specifies how to represent a configured item. A desktop computer that includes a monitor,
keyboard, mouse, and external speakers is an example of a configuration model. In this example, the desktop computer
is the parent item, and the peripherals are the child configure options.
Configurator
A feature you can use to configure a configured item. Use the Configurator to choose configure options for an item
from a list of available options. It uses constraints to make sure the items you choose fit together correctly. It reduces
configuration errors, which in turn reduces change order processing and rework that's required during order fulfillment.
configure option
A child component of a configured item. A desktop computer is an example of a configured item. The hard drive,
monitor, and mouse are each an example of a configure option. You can choose the value for a configure option from
a list of available options. For example, you can choose the 1TB Hard Drive, or the 2TB Hard Drive. Each of them is an
option of the Hard Drive configure option.
configured item
An item that includes one or more configure options that you can configure. A desktop computer where you choose
the hard drive, monitor, and mouse is an example of a configured item. The hard drive, monitor, and mouse are each an
example of a configure option.
connector
A web service that receives a message from order management, transforms the message into a format that your
fulfillment system can understand, then calls the fulfillment system. The connector can also transform the web service
response into an order management message.
cost of change
A numeric value that measures how much a change impacts an orchestration process. For example, the monetary cost
to a company, or the difficulty that's associated with incorporating the change.
coverage
An agreement that adds value to an item by providing support, service, repair, replacement, and so on. Extended
warranty, service level agreement, and software maintenance are each an example of a coverage.
coverage item
An item that adds value by providing coverage for another item. For example, a six month warranty is a coverage item
for a laptop computer, and the laptop computer is the covered item. Extended Warranty, Service Level Agreement,
Software Maintenance, and Subscription are each an example of a coverage.
covered item
An item that a coverage item covers. For example, a six month warranty is a coverage item for a laptop computer, and
the laptop computer is the covered item.
2081
Oracle SCM Cloud Glossary
Implementing Order Management
credit check
Calculation that determines whether credit that's currently available for the customer account is equal to or greater than
the transaction amount.
cross-reference
A reference that relates business data between an order capture system, order fulfillment system, and order
management. For example, an item cross-reference can create a relationship between an item, such as Widget A, that
resides in a source system, and a representation of the same item in order management. The cross-reference helps to
manage the representation of data across systems.
customer
A customer is someone with whom you have a selling relationship. The selling relationship can result from the purchase
of products and services, or from the negotiation of terms and conditions that provide the basis for future purchases.
customer item
Number that your customer uses to represent an item when they need to use a number that's different from what
Oracle Fusion uses. Your customers might use different numbers to identify the same item. Assume you sell an
item that has the number AS54888. Your Computer Service and Rentals customer uses their own part number to
brand the AS54888. They use part number DESK-COMP-10. You also sell the AS54888 to another customer, ABC
Telecommunications, but they use the value 2021-BIG-DESKTOP to brand the AS54888. DESK-COMP-10 and 2021-BIG-
DESKTOP are each an example of a customer item.
data model
The metadata that determines where data for a report comes from and how that data is retrieved.
decision table
A set of IF statements displayed as a table. You can use a decision table when you set up a rule that includes more than
one IF statement.
descriptive flexfield
Expandable fields used for capturing additional descriptive information or attributes about an entity, such as a customer
case. You may configure information collection and storage based on the context.
drop ship
To take the title of a product, but not actually handle, stock, or deliver it, such as when one supplier ships directly to
another or to the buyer's customer.
drop shipment
A type of shipment where the supplier ships directly to your customer. The shipper for a drop shipment that occurs
outside of your organization is usually a 3rd party supplier. The shipper for a drop shipment that occurs inside of your
organization is another business unit.
2082
Oracle SCM Cloud Glossary
Implementing Order Management
duty role
A group of function and data privileges representing one duty of a job. Duty roles are specific to applications, stored in
the policy store, and shared within an application instance.
explicit wait
Wait that orchestration applies on an order line for a long-running task. An explicit wait is a planned and expected part
of processing, such as waiting for your fulfillment system to reply with the expected delivery date.
extensible flexfield
Expandable fields that you can use to capture multiple sets of information in a context or in multiple contexts. Some
extensible flexfields let you group contexts into categories.
extension point
An event that you specify to determine when to run an order management extension.
external order
Sales order you use to sell an item from your organization to some other organization that resides outside of your
organization. For example, to sell an item from Vision Operations, an organization that manufacturers computers and
sells to retail stores, to your Computer Service and Rentals customer, a retailer that sells computers directly to the public.
flexfield
A flexible data field that you can configure such that it contains one or more segments or stores additional information.
Each segment has a value and a meaning.
flexfield segment
An extensible data field that represents an attribute and captures a value corresponding to a predefined, single
extension column in the database. A segment appears globally or based on a context of other captured information.
fulfillment line
A request to fulfill an item. A fulfillment line contains details about the request, such as customer, sales order number,
item, quantity, scheduled ship date, actual ship date, shipping method, and so on. To improve fulfillment, you can
schedule a fulfillment line, reserve product for it, substitute an item for it, change the warehouse, change the shipping
method, change the demand class, and so on.
2083
Oracle SCM Cloud Glossary
Implementing Order Management
fulfillment system
A system that resides downstream of order management that's responsible for fulfilling a sales order. For example, a
fulfillment system is responsible for shipping physical goods to your customer, such as shipping a laptop computer from
a warehouse to a customer location.
fulfillment task
A type of task that order management does to fulfill a sales order. Schedule and Ship are each an example of a
fulfillment task. Order management might use more than one orchestration process step to finish a single fulfillment
task.
global segment
A flexfield segment that you can use anywhere in the hierarchy of the flexfield. Assume you have a flexfield that
includes category 1 and category 2. Category 1 includes segment A, and segment A isn't in a context. Category 1 also
includes context X, and context X includes segment B. Category 2 includes segment C and segment D. You set up your
flexfield so segment A is a global segment and segment B is a context segment. The flexfield displays global segment A
in any context. The flexfield displays segment B only in context X.
hold code
An object in Order Management that you can use to control what services the hold can stop from running, and who can
apply the hold. Order Management comes predefined with a set of hold codes that you can use, but you can also add
your own.
implicit wait
Wait that orchestration applies on an order line when a functional or technical problem occurs during order processing.
An implicit wait allows the user to use a recover action to attempt to recover the order.
import file
Flat file you use as an interface between your source system and order management. You copy source orders into the
file, then use a scheduled process to import orders from the import file into order management.
infolet
An interactive element in the Order Management work area that provides a graphic summary of your sales orders.
For example, the Overview page displays a bar chart that illustrates the number of orders that are in error, grouped
according to how long they have been in error.
integration algorithm
Set of rules that uses conditional logic, variables, functions, and code to manipulate data in a service data object (SDO).
An integration algorithm manages an integration between order management and some other application.
2084
Oracle SCM Cloud Glossary
Implementing Order Management
interface table
Database table that stores data during data transfer between applications or between databases that reside inside and
outside of an Oracle Fusion application.
internal identifier
Value that order management uses to create a reference between a lookup that you specify for an item, customer, or
reference data, to details from the Product Information Management work area, Trading Community Architecture, or
data collection. The data resides in the Order Orchestration and Planning Repository. For example, if your sales order
uses payment terms, then you must set up the value in Oracle, and then set up collections processing.
internal order
Sales order you use to transfer an item from one part of your organization to another part of the same organization.
For example, to transfer an item from Computer Service and Rentals - Warehouse A, to Computer Service and Rentals
- Warehouse B. For another example, to transfer an item from Computer Service and Rentals - Korea Manufacturing, to
Computer Service and Rentals - USA Distribution Center.
inventory organization
A logical or physical entity in the enterprise that tracks inventory transactions and balances, stores definitions of items,
and manufactures or distributes products.
inventory organization
Organization that you use to fulfill an item. For example, assume Vision Manufacturing makes the AS54888 Desktop
Computer and stores the finished item in inventory. Vision Manufacturing is the inventory organization, so Order
Management uses inventory from Vision Manufacturing to fulfill order lines that contain the AS54888.
inventory transaction
A transaction that moves an item into, within, or out of Oracle Fusion Inventory Management.
item
A product you add to a sales order. Order management displays items in the Item column when you add an order line
to a sales order. For example, items for a company that sells hardware might include nuts, bolts, and screws. Items for
a company that sells computers might include hard drives, computer monitors, and desktop computers. Items for a
wireless service provider might include service plans, international calling services, and instant messaging services.
Items for an insurance company might include fire insurance.
item organization
Item definition where inventory balances are not stored and movement of inventory is not tracked in the applications.
Item attributes that carry financial and accounting information are hidden.
2085
Oracle SCM Cloud Glossary
Implementing Order Management
jeopardy
Level of risk that the delay of an orchestration process task causes. For example, Low, Medium, or High.
jeopardy priority
Value that describes the level of risk that's associated with delaying a fulfillment task. For example, Low, Medium, or
High.
jeopardy score
Numeric ranking that indicates the severity of a delay in finishing a fulfillment task.
jeopardy threshold
Range of time that a task is delayed.
job role
Sign in that allows each user to access the application features that the user needs to do a job in the application, and to
access the data that these features reference. Order Entry Specialist, Order Manager, Order Administrator, and Supply
Chain Application Administrator are each an example of a job role in order management.
kit
A configured item that includes one or more configure options. The Order Entry Specialist can use the Order
Management work area to modify configure options for a configured item, but not for a kit.
lead-time
Amount of time that order management needs to finish an orchestration process step, including wait steps and pause
steps.
lead-time expression
Business rule that determines the amount of time you expect an orchestration process step needs to finish. Use it to
calculate planning for an orchestration process. For example, an item that requires complex packing might need a
longer lead-time for shipping.
2086
Oracle SCM Cloud Glossary
Implementing Order Management
long-running task
Type of task that includes a wait step, such as a shipping step, receiving step, and so on.
lookup
Value that an Oracle application displays in a list of values. This list typically allows the user to choose a single value,
such as in a drop-down list. The application uses various logic to search for the lookup values that it displays.
offering
Grouping of setup tasks that support specific business functions, such as Sales, Service, and Product Management.
Oracle BI Publisher
An Oracle application that performs the following formatting tasks for Oracle Fusion Payments: 1) formats extracted
data into a message, such as a settlement batch or payment file, that can be understood by the payment system, 2)
supports remittance advice formatting and delivery.
orchestration planning
The process of orchestrating and planning the fulfillment of a sales order. For example, planning dates, planning
shipments, and so on. Replanning is the process of updating an orchestration plan for a sales order to accommodate
a change that occurs to this sales order or in the fulfillment environment. For example, when a customer changes the
quantity of an existing sales order.
orchestration process
A process that includes a sequence of steps. These steps process one or more fulfillment lines during order fulfillment.
An orchestration process coordinates the orchestration of physical goods and activities in a single order, and it
automates order orchestration across fulfillment systems. It contains the instructions that describe how to process an
order, such as the steps and services to use, step dependencies, conditional branching, lead-time information, how to
handle change orders, and the status values to use. It describes how to schedule, reserve, ship, return, and invoice a
sales order.
2087
Oracle SCM Cloud Glossary
Implementing Order Management
is the run time representation of this definition. It includes temporary data and transactional data that orchestration
requires to process a specific sales order or fulfillment line.
orchestration subprocess
Set of sequential steps. Its an orchestration process that another orchestration process references.
order compensation
The process of modifying a sales order so it accurately reflects changes that have occurred to the order. For example,
assume order management receives a change order that requests to ship an item from a different warehouse. Order
management adjusts the order so it uses the different warehouse, updates delivery dates so the dates accurately reflect
the time needed to ship the item from the different warehouse, and so on.
order fulfillment
Part of the order management lifecycle that fulfills a sales order. Order fulfillment typically begins right after the
user clicks Submit in order management. Order management then schedules, ships, and bills the sales order. Order
management communicates with downstream fulfillment systems to finish fulfillment.
order header
Attributes of a sales order that apply to the entire order, such as Customer, Contact, Purchase Order, Business Unit, and
Sales Credits. The attributes that display above the Order Lines area and above the catalog line on the Create Order
page constitute the order header.
order line
Line on a sales order that specifies details about an item, such as item number, quantity, shipping details, billing details,
and so on. Order management transforms an order line into a fulfillment line when the Order Entry Specialist clicks
Submit.
order orchestration
Order management feature that uses an automated sequence of fulfillment steps to process a sales order through one
or more order fulfillment systems.
2088
Oracle SCM Cloud Glossary
Implementing Order Management
order validation
Process that order management does to make sure a sales order meets a set of criteria. For example, to make sure the
sales order includes details for each required attribute.
order-to-cash
Front-to-back flow of details that order management uses to process a sales order through various systems and
applications, from order entry to order fulfillment.
pause task
A task that temporarily stops an orchestration process from running so it can wait for a condition to be met.
performance obligation
A promise in a contract to fulfill the item on the order line.
pick-to-order (PTO)
An item where warehouse personnel pick configure options from inventory to meet the requirements of a configured
item, but don't assemble them. For example, the Long Life Tea Set is a configured item that includes configure options,
such as steeping pot, pouring vessel, and set of tea cups. Your customer can choose from a variety of choices for each
option when they place their order, but no assembly is required to fulfill the configured item.
predefined
An object, integration, or configuration that comes already defined with an Oracle application and is ready to use with
little or no modification.
privilege
A grant of access to functions and data; a single, real world action on a single business object.
processing constraint
Rule that controls who can change a sales order, what can change in the sales order, and when the change can occur.
2089
Oracle SCM Cloud Glossary
Implementing Order Management
requisition
Document generated for a department or an individual to notify the purchasing department of goods or services it is
ordering, their quantity, and the expected delivery time frame.
role
Controls access to application functions and data.
root parent
The item that resides at the top of the hierarchy of an object. For example, if a configured item includes a top level
for computer, a mid level for chassis, and a bottom level for graphics card, then the computer is the root parent of the
configuration, and the chassis is the parent of the graphics card.
routing rule
A rule that determines how to route data through a system or application. It typically uses an IF-THEN structure that
specifies a condition and an action to take depending on the result of the condition. For example, an external interface
routing rule can specify how to route a fulfillment request to a fulfillment system depending on the current state of the
fulfillment environment, such as available inventory, transit time, and so on.
sales order
A contractual document between a sales organization and your customer. You create a sales order in the Order
Management work area. Order management also transforms a source order it receives from a source system into a sales
order that it can submit to order fulfillment.
scheduled process
A program that you run to process data and, in some cases, generate output as a report.
2090
Oracle SCM Cloud Glossary
Implementing Order Management
service mapping
A pricing entity that specifies a group of entities and attributes that a service can retrieve and update. You can use it to
model entities and attributes in a declarative environment without having to write software code. The service mapping
allows an application, such as order management, to price an item without having to get the pricing schema that pricing
uses.
set
Classified and grouped reference data that organizational entities share.
shipment set
A set of order lines that order management ships together as one group. All of these lines ship and arrive on the same
date, although they might be spread across more than one package, depending on packing requirements.
shipment tolerance
The percent of variation between the quantity your customer orders and the quantity you ship. It includes over
shipment and under shipment. Over shipment means you ship more quantity than the customer orders. Under
shipment means you ship less.
shippable item
An item that order management can physically ship to the customer. Order management typically fulfills a shippable
item from a warehouse, and uses a carrier to physically move the item through the supply chain. A parcel service that
uses a truck to transport the item from one location to another location, such as from a warehouse to a residence, is
an example of a carrier. A laptop computer is an example of a shippable item. A warranty for a laptop computer is an
example of a nonshippable item. Other examples of nonshippable items include a subscription to an online magazine,
or a video that your customer can only stream from the cloud.
source data
Data that you import from an external system into order management.
source order
An order that you import into order management from a source system. Order management transforms a source order
to a sales order when you import it.
source system
System where the sales order was created. Order Management Cloud and an order capture system are each an example
of a source system. A source system provides business application information to an Oracle application. Oracle can use
this information to extract fulfillment data and planning data into data files.
2091
Oracle SCM Cloud Glossary
Implementing Order Management
sourcing rule
A specification of the means by which organizations can replenish items.
stamp
To impress a snapshot of data onto an object. For example, a sales order might contain a set of attribute values that
exist on a specific date, such as quantity equals four and color equals blue on October 9, 2019. These values might
change at some point, such as during order fulfillment. A stamp impresses the values of the sales order from a specific
point in time onto an object, such as a social conversation, so it provides an audit trail that you can use to communicate
attribute values that exist in an historical context.
standard item
An item that isn't configured, and that isn't a kit or model. For example, the mouse pad that you use with your computer
is a standard item. Its likely that the computer isn't a standard item because you typically can configure a computer,
such as choosing different amounts of memory for it or choosing the size of hard drive that you want.
start-after condition
A condition on a pause task in an orchestration process step that specifies when to pause processing before calling the
next step, or when to resume processing.
status condition
A rule that determines when a sales order reaches a status. Here's an example of a status condition: If the Schedule task
status equals Scheduled, then set the orchestration process status to Scheduled.
subscriber
A system or application that subscribes to a web service or business event. For example, a source system can subscribe
to a business event that sends notifications about changes to sales orders. If a change occurs, then the web service
sends details about the event to the source system in the web service payload. This configuration is similar to a
subscription service that regularly sends details to subscribers, or that sends details when an event occurs.
subscription
An item that provides a product or service that recurs. For example, a one year subscription to a magazine, a 90
day subscription for cell phone service, and a six month subscription for software usage are each an example of
a subscription. A subscription might or might not bill the customer on a recurring basis. Fulfillment does recur
periodically. For example, a weekly magazine fulfills one time each week.
task type
A group of services that order management uses to do a fulfillment task. It represents a common business function that
order management uses so it can process a sales order from the time a user creates it to the time order management
sends the sales order to an order fulfillment system. Shipment is an example of a task type. Its a set of services that
communicates with a shipping fulfillment system to ship the items that the fulfillment line references.
2092
Oracle SCM Cloud Glossary
Implementing Order Management
tax jurisdiction
Government authority that imposes a tax. In the United States, the jurisdiction typically resides at the city, county,
state, or federal levels. For example, the Office of the Treasurer and Tax Collector is the tax jurisdiction for the City and
County of San Francisco. The California Department of Tax and Fee Administration is the tax jurisdiction for the state of
California. The Internal Revenue Service is the tax jurisdiction for the United States.
tax regime
The set of tax rules that determines the treatment of one or more taxes administered by a tax authority.
temporary attribute
An attribute that exists only for a short amount of time and that doesn't persist. For example, you might create an order
management extension that uses a temporary variable to store the result of a calculation, and then use the result in a
subsequent line of code in the extension. Order Management doesn't store the value of a temporary attribute in the
Oracle database, so you can use a temporary attribute only while its data is in active memory. Some developers use the
word transient for this kind of data, such as transient attribute.
trade compliance
A set of rules that makes sure trade between countries or regions occurs according to the approved laws and guidelines
that the countries or regions use.
transformation rule
A rule that transforms a source order that resides in your source system to a sales order that resides in order
management.
2093
Oracle SCM Cloud Glossary
Implementing Order Management
virtual object
Object that Order Management uses to temporarily store the data that it gets from a runtime environment.
2094