Actions on Orders

This chapter covers the following topics:

Commitment Processing

Sales Order Line Pricing Tab, Commitment field

Apply commitments to outbound order lines by selecting or defaulting the Commitment within the Commitment field (hidden by default) within the Sales Order Lines, Pricing Tab. The LOV for the commitment field lists all valid commitments for the given order line based on:

The LOV displays the commitment number and the corresponding commitment balance stored in Oracle Receivables. You can select any commitment belonging to the Sold To customer (entered for the order) and any related customers even if the Bill To flag is not enabled. The LOV displays when the relation type is ALL.

Note: The commitment balance shown within the LOV does not reflect the real-time balance of the commitment (value does not take into account uninvoiced order lines).

Sales Order Line Pricing Tab, Commitment Amount Applied field

Commitment balance checking is a process of calculating the real-time commitment balances which includes all invoiced and uninvoiced orders. Oracle Order Management calculates the Commitment Amount Applied and displays this amount within the hidden field Commitment Amount Applied. The Commitment Amount Applied value is the lesser of the following two amounts:

If you set the OM: Commitment Sequencing profile option to yes, then the application applies partial commitment to a sale order line. You can update the Commitment Amount Applied field even after booking. For example, when a new shipping charge is applied during Ship Confirmation, the application updates the Commitment Amount Applied if there is sufficient deposit balance.

The Commitment Amount Applied is then interfaced to Oracle Receivables for the actual deposit adjustment when the order is sent to be invoiced.

Tax and Freight

Oracle Order Management will include taxes and charges in the Commitment Amount Applied if the Oracle Receivables Customer Transaction Type is defined to include tax and freight amounts when calculating and applying the commitment adjustment.

You determine whether to include tax and freight by selecting the value Lines, Tax and Freight within the Allocation Basis field, Oracle Receivables Transaction Types window, Deposit Tab.

When interfacing Commitments to Oracle Receivables:

For order line charges that are applied during shipping. the amount is not included in the Commitment Amount Applied captured at order entry. Charges amounts are still interfaced to Oracle Receivables, and the difference between the total amount on the invoice and the amount of the Commitment Amount Applied will be treated as an open invoice.

Note: When a commitment is entered or modified, the tax for the order line is re-calculated. The Oracle Receivables transaction type of the commitment (Deposit or Guarantee) is then passed to the Receivables tax engine.

Viewing Order and Return Information

The Order Organizer window displays information on status, shipping, work order, Purchasing (for sales orders), and invoicing for orders, returns, and internal sales orders and lines. You can use the Order Organizer window to view information about all lines of an order, including quantity and date shipped, freight carrier, and waybill number.

You can also use the Order Organizer window to view the current work flow status of an order, return, or internal sales order, or sales order lines.

Invoice and payment information can also be viewed for each order, if available.

Prerequisites

You must have entered an order or return. The results displayed will depend upon the current processing positioning of the order or line within it's respective workflow. For example you will not see invoice data unless a line or order has completed in Receivables and an invoice generated.

To view additional order information:

  1. Navigate to the Find Orders window and query the order or return you want to view. You can also choose to query an order within the Sales Order window.

    See: Querying Orders.

    • While within the Sales Order Main or Others window, place the cursor within any field.

    • While within the Order Organizer, place you cursor on line containing the order you wish to view additional information for

  2. Click Actions and select Additional Order Information or use the mouse right click feature, select Additional Order Information, and then select the appropriate entity you wish to view additional information on.

    Additional Order Information Window

    the picture is described in the document text

  3. Choose from the following tabbed regions to display the details you are interested in:

    • Holds: Displays hold history information for the order, hold until date for a hold, including the hold reason and the Hold Release region.

    • Deliveries: Displays delivery information for the order. For additional details surrounding this tab, see Oracle Shipping Execution, Viewing the Status of a Delivery Line

    • Invoices /Credit Memos: Displays invoicing information for the order. Select Invoice Details to view additional details via the Oracle Receivables Transactions form

    • Quantity History: Displays quantity change history information for the order as well as any comments entered when the quantity change was recorded

      Note: Quantity History details are displayed only any order lines have cancelled quantities.

To view additional line information:

  1. Navigate to the Find Orders window for the Order Organizer and enter the data necessary to retrieve the order or return lines you want to view or query an order directly from within the Sales Order window and then navigate to the Lines Tab.

    See: Querying Orders.

    • While within the Sales Order Lines window, place the cursor within any field for the order line which you want additional line information displayed.

    • While within the Order Organizer, place you cursor on the order line you wish to view additional information.

  2. Click Actions and select Additional Line Information or use the mouse right click feature, select Additional Line Information, and then select the appropriate entity you wish to view additional information on.

  3. Choose from the following tabbed regions:

    • Holds: Displays hold history information for the order, hold until date for a hold, including the hold reason and the Hold Release region.

    • Returns: Displays return information for the line.

    • Deliveries: displays delivery information for the line.

    • Invoices /Credit Memos: Displays invoicing information for the order. Select the Invoice Details to view additional receivables details via the Oracle Receivables Transactions window. The invoice Details button is disabled unless an invoice has been generated for the order line.

    • Internal Requisition: Displays internal requisitions information for the line.

    • Drop Ship: Displays drop shipment information for the order line. Click Purchasing to view additional purchasing details via the Oracle Purchasing Purchase Order window. The Purchasing button is disabled for internally sourced lines until the requisition has been created for the drop shipped order.

      Note: Requisition details will be displayed in the Drop Ship tab until the corresponding purchase order is AutoCreated. Once the purchase order has been created, the Requisition details are replaced with the purchase order details.

    • Quantity History: displays quantity history information for cancelled order line quantities.

Additional Details

View Shipping Status

The Oracle Shipping Execution View Shipping Status window displays comprehensive shipping status delivery details available for orders and lines which have been interfaced to Oracle Shipping Execution. The window also displays the next step details required to complete the shipping process.

You can view the shipping status of delivery lines for either sales orders or sales order lines by navigating to either the Sales Order or Order Organizer windows, and, from the Actions button List of Values, select View Shipping Status.

The following Shipping delivery status details are displayed within the View Shipping Status window:

Viewing Cycle Status and Approval History

You can view cycle status and approval history for orders and order lines upgraded from previous releases of Oracle Order Entry.

You can view order header or order line cycle status actions and approval history details from either the Sales Order Organizer or the Sales Order windows by first performing a query for orders or lines. Once the data for your query has been returned, you can then view Cycle Status and Approval History for the appropriate entity (order header or order line).

For example, if you wish to view cycle status and approval history for upgraded order headers, then query and select an order header, click Action, and from the pop up LOV, select View Cycle Status and Approval History. If you wish to view cycle status and approval history for upgraded order lines, query and select an order line, click Action, and from the pop up LOV, select View Cycle Status and Approval History.

To view Cycle Status and Approval History for upgraded orders:

  1. Navigate to either the Sales Order Organizer or Sales Orders window and enter your query criteria. Once your data has been returned, place your cursor on the order or line you wish to view cycle status and approval history details for.

  2. Click Actions, and from the pop up LOV, select View Cycle Status and Approval History.

    Cycle Status Window

    the picture is described in the document text

  3. The Cycle Status window displays the following details for either upgraded order headers or order lines, dependent upon your entry point to the window.

Line

When viewing cycle action details for an order, Order Management displays the line number only if you are viewing order line cycle status details.

Item

When viewing cycle action details for an order, Order Management displays the item only if you are viewing order line cycle status details.

Cycle Action

When viewing cycle action details for an order or line, Order Management displays each cycle action that occurred for an upgraded order or line.

Result

When viewing cycle action details for an order or line, Order Management displays cycle action result for an upgraded order or line.

Level

When viewing cycle action details for an order or line, Order Management displays the entity level the cycle action was performed against.

Date

When viewing cycle action details for an order or line, Order Management displays the date that the cycle action was performed.

Approval

If a check box appears for a particular order/line cycle action, then this particular action was an approval action, and you may view approval history details by selecting the line with your cursor and then the Approval History button.

Note: The Approval History button is only enabled for approval cycle actions.

Order Approval History Window

the picture is described in the document text

The Approval History (order header) window displays the following details for upgraded orders and their associated cycle actions where an approval was required.

Order Number

When viewing cycle action approval details for an order, Order Management displays the order number.

Date

When viewing cycle action approval details for an order, Order Management displays the approval action date for the order you are viewing.

Name

When viewing cycle action approval details for an order, Order Management displays the cycle action name associated with the approval action for the order you are viewing.

Result

When viewing cycle action approval details for an order, Order Management displays the cycle action result for the order you are viewing.

Order Type

When viewing cycle action approval details for an order, Order Management displays the order type for the order you are viewing.

Order Category

When viewing cycle action approval details for an order, Order Management displays the order category for the order you are viewing.

Customer

When viewing cycle action approval details for an order, Order Management displays the customer name for the order you are viewing.

Customer number

When viewing cycle action approval details for an order, Order Management displays the customer number for the order you are viewing.

Comments

When viewing cycle action approval details for an order, Order Management displays any comments recorded at the time the cycle action approval occurred for the order you are viewing.

Approver

To view Cycle Status and Approval History for upgraded orders lines:

  1. If you wish to view cycle status and approval history for upgraded order lines, navigate to either the Sales Order Organizer or Sales Order window, and enter your query criteria. Once your data has been retrieved, with your cursor, select a specific order line, click Actions, and from the pop up LOV, select View Cycle Status and Approval History.

  2. For information on the Cycle Status window, refer to the Cycle Status window information in the previous section.

    Line Approval History Window

    the picture is described in the document text

    The Approval History for order lines window displays the following details for upgraded lines and its associated cycle actions where an approval was required.

Order Number

When viewing cycle action approval details for an order line, Order Management displays the order number for the order you are viewing.

Line

When viewing cycle action approval details for an order line, Order Management displays the order line number for the line you are viewing.

Date

When viewing cycle action approval details for an order line, Order Management displays the date the approval action was performed for the order line details you are viewing.

Name

When viewing cycle action approval details for an order line, Order Management displays the cycle action name associated with the approval action for the order line you are viewing.

Result

When viewing cycle action approval details for an order line, Order Management displays the cycle action result for the order line you are viewing.

Order Type

When viewing cycle action approval details for an order line, Order Management displays the order type for the order line you are viewing.

Category

When viewing cycle action approval details for an order line, Order Management displays the order category for the order line you are viewing.

Customer

When viewing cycle action approval details for an order line, Order Management displays the customer name for the order line you are viewing.

Customer number

When viewing cycle action approval details for an order line, Order Management displays the customer number for the order line you are viewing.

Item

When viewing cycle action approval details for an order line, Order Management displays the order line item and description for the order line you are viewing.

Quantity

When viewing cycle action approval details for an order line, Order Management displays both the Unit of Measure and the quantity for the order line you are viewing.

Line Total

When viewing cycle action approval details for an order line, Order Management displays line total for the order line you are viewing.

Comments

When viewing cycle action approval details for an order line, Order Management displays any comments recorded at the time the cycle action approval occurred for the order line you are viewing.

Approver

Applying Sales Credits

You can apply sales credits for an order, line, shipment schedule, or return. Sales credits can be defined as Revenue (Quota) Sales Credits and Non-Revenue Sales Credits.Sales credit information for a model line defaults to each option line. You can assign sales credits to salespersons other than the salesperson for the order. You must enter revenue credits totaling 0 or 100 in this window by the time you book the order.

Prerequisites

To apply a sales credit:

  1. Navigate to the Sales Orders window and query the order you want to apply the sales credit.

  2. Click Actions.

  3. Select Sales Credits from the Actions list of values.

  4. Select the Salesperson.

  5. Select the sales Credit Type.

    Certain sales credit types apply towards revenue credit. Order Management defaults the primary revenue sales credit type for the salesperson entered in Main tabbed region.

  6. Define the percentage of sales credit for the salesperson. Order Management maintains a running total of the sales credit percentages in the Revenue Total and Non Revenue Total fields.

  7. Save your work.

Sales Credits

A single sales order/line may have many salespersons who receive credit for the order either quota or non-quota. (quota to be <=100%, non-quota can be any %). Given this fact the same rules may apply as with update salesperson. A salesperson may be granted permission to amend within a single sales group or even outside of that sales group with the sales manager having overriding permissions. For additional details on this feature, please refer to the section on Applying Sales Credits

Entering Sales Credits for Returns

If the order flow for your return includes the Invoicing Activity and if you use a reference source for a return line, you can populate the Credit Invoice field. In this case, Oracle Receivables creates an applied credit memo, and the sales credits from your original invoices are reduced accordingly, regardless of the sales credits you enter on the return. If you create an on-account credit from a return, sales credits are reduced according to the sales credit information you enter on the return.

Prerequisites

See: Oracle Receivables User's Guide

To apply sales credits for a return:

  1. Navigate to the Order Organizer window.

  2. Enter header and detail information for a new return, or query an existing return.

  3. Select a return line.

  4. Click Actions and select Sales Credits.

  5. Select the Salesperson.

  6. Define the percentage of sales credit for the salesperson.

    Order Management maintains a running total of the sales credit percentages in the Revenue Total and Non Revenue Total fields.

  7. Choose OK to save your work.

See

Overview of Returns

Multi-Select

Order Management provides you with the ability to select several order headers and apply common sales credits in one operation.

To apply Sales credits to multiple Order Headers

  1. Navigate to the Order Organizer window and query the order headers for which you want to apply same sales credits.

  2. Multi-select the orders by holding down the Ctrl key.

  3. Click Actions and select sales credits.

  4. Add additional sales credits or replace existing sales credits as necessary.

  5. Choose OK.

Required Fields for Entering Returns

When entering a return order, the required fields are identical to when you create a sales order. Please refer to the section entitled Required Fields for Entering Orders. A table indicates required fields for orders.

You can provide defaulting information for many of these order return fields by:

See

Copying Orders

Overview of Returns

Order Import

Required Fields for Entering Orders

Projected Sales Revenue Reporting by Sales Group

Applying Attachments

After you define your document category and additional rules and their assignments, you can have the rule-based attachment applied automatically or manually.

Prerequisites

To apply a manual attachment to order or return:

  1. Navigate to the Sales Orders window.

  2. Click Attachments on the Menu bar.

    Attachments Window

    the picture is described in the document text

  3. In the Main tab region, select the category of the attachment that you want to apply.

  4. (Optional). Enter a description for the attachment.

  5. To enable future updates to the attachment, deselect the May Be Changed check box.

  6. Click Source tab and enter the file location or URL for the attachment.

  7. Save your work.

To apply automatic attachments on an order or return:

Note: Ensure that the profile option OM: Apply Automatic Attachments is set to Yes so that the system will automatically apply the attachment.

  1. In the Sales Orders window, click Actions and select Apply Automatic Attachments from the list of values.

    Attachments are applied based on the additional rules that you specified.

  2. Enter the header and line information for your order or return.

    When you save your work, the system automatically applies attachments based on the additional rules that you specified.

When the automatic attachment addition rule is enabled at the header level or the line level on a sales order, and there is a change to an attribute value, then the application takes the following steps:

To view or modify an attachment on an order or return:

  1. In the Sales Orders window, click Attachments (paperclip icon) on the Menu bar.

  2. You can view and or modify your attachment.

Order Changes

Order Management provides you with the ability to automate the process of changing various types of orders and track quantity changes made to orders during the order flow.

Note: System and processing constraints can prevent specific changes to an order depending on the flow status. For example, if an order has already been invoiced, most changes are prevented.

Workflow

Order Management handles the order processing, scheduling, booking, and shipping by means of workflow activities. A header workflow process starts at the time an order is entered and committed to Order Management. A line workflow begins at the time the line is entered into the system. When you enter an order change that does not meet the processing constraints, Order Management provides the ability to send a notification to the authorized responsibility. See: Using Oracle Workflow in Oracle Order Management.

Note: The processing of a workflow that has started will not be held at any time when a notification is sent. If an order change failed a constraint evaluation, your changes will not be committed and the workflow continues processing. However, if you want to prevent further processing of the workflow until the change is made, you need to apply a pending change hold on the order after sending out the notification. The authorized user responsibility needs to release the hold to allow the order flow to continue.

Workflow Monitor and Workflow Status

You have the ability to view the status of the order workflow in the Workflow Monitor and Workflow Status windows. The Workflow Monitor provides a graphical representation of the order flow. The Workflow Status displays the process flow in a tabular format listing different workflow activity statuses. The Workflow Status provides you with the advanced options to view specific processes. You can view all the open notifications from the same window. Select Workflow Status from the Tools menu in the Sales Orders window. Your designated internet browser opens a separate window for you to view the results.

Configurations

Based on your processing constraints, Order Management enables you to prevent order changes to your configuration items. For example, if an order entry clerk wants to make a change to a scheduled ship date for the ATO model line after a WIP job is open, a message displays notifying the clerk that the order change cannot be made without the approval of the authorized personnel such as a WIP Manager. The message identifies which responsibilities are authorized to make the change. The appropriate personnel can then send a notification to the WIP Manager to process the order change.

Note: If you are trying to apply changes to an order placed on hold, Order Management accepts the change based on your processing constraints.

Mass Changes

Order Management enables you to make mass changes to orders using the Order Organizer and Quick Order Organizer. You can multi-select orders or lines and perform a mass change. After the change has been made you can identify any changes that failed from the error messages window. You can then send a notification to the appropriate personnel alerting them of the failed changes.

See: Overview of Mass Changes

Cancellations

Cancellations at the order and line levels such as a decrease in quantity are based on your processing constraints. Order Management also validates the cancellation based on the user responsibility.

Notifications

See: Oracle Order Management Implementation Manual, Overview of Processing Constraints.

You can send a notification at any time, even without an error message displaying. You can send a notification in the Notification window in the Sales Orders window or organizer, by using free form text.

In addition, Order Management can send an approval notification for failed processing constraints from the Sales Orders and Messages windows. The Notification window displays all of the user responsibilities for you to select.

Processing Constraints

When you attempt to make changes to an order, Order Management validates the changes against processing constraints enabled. In addition, Order Management validates the order changes based on your user responsibility.

Note: If the order change is invalid, Order Management will not apply the order changes.

You can set up your processing constraints for Insert, Update and Delete for each order or line based on a specific user responsibility.

Constraints for changing order lines after line has been interfaced to Oracle Shipping Execution

Once an order line has been pick confirmed, Order Management processing constraints no longer enable certain order line attributes to be updated and certain Order Management order line functions to be performed.

For example, you can no longer perform the functions of cancellation, deletion, or splitting of order lines if the line has been previously pick confirmed.

By default, these processing constraints are enabled and have not been identified as seeded; some processing constraints can be disabled. If disabled for the Customer PO Number and Customer PO Line Number, you can update the values of these fields even if the order has been ship confirmed. However updating the values of Customer PO Number and Customer PO Line Number fields can be done until the Invoice Interface stage.

Shipping Exceptions that may occur as a result of disabling Order Management processing constraints for shipping order lines

Order Management supports the flexibility of removing some or all the Order Management processing constraints for picking and shipping order lines. If you remove any or all of these constraints, Oracle Shipping Execution may enable order line attribute changes between the time items are shipped and the ship confirmation data has been updated within the application database. Your business practices may require changes to order lines after the Oracle Shipping Execution deliveries have been pick confirmed, staged, or up to an including the ship confirmation stage.

Note: Cancellation will not be allowed on a staged/picked configuration line.

If you choose to alter Order Management processing constraints for shipping order lines, you should adopt a two step ship-confirm process that will close delivery lines and the perform the Ship Confirm process. For more information on processing constraints for shipping order lines, see Oracle Shipping Execution, Change Order Management. If you disable Order Management processing constraints for shipping order lines, any shipping exceptions that occur must be handled manually.

For example, an pick confirmed order line with a order quantity of 10 has been physically staged and shipped, but the associated delivery line is not closed. After staging occurred, the order quantity was reduced in Order Management to 8, but you had previously physically shipped 10. When you try and ship confirm the order line, (which attempts to close the associated delivery line), a quantity mismatch of 2 will occur, and the ship confirm process will complete with an exception; you will manually have to determine how to handle the exception (quantity adjustment of 2).

The following table lists details for the Order Management operation UPDATE and associated order line attributes that processing constraints are enabled by default; you cannot perform the operation in operation UPDATE for the attributes listed in column B.

Details for the Order Management Operation UPDATE
Column A:
Order Management Operation		 Column B:
Non updateable order line attribute after Pick Confirm
UPDATE Authorize to Ship
UPDATE Customer
UPDATE Customer PO **
UPDATE Customer PO Line number **
UPDATE Deliver To Contact
UPDATE Deliver To Org
UPDATE FOB Point
UPDATE Freight Carrier
UPDATE Freight Terms
UPDATE Item Type
UPDATE Ordered Quantity UOM
UPDATE Ordered Quantity
UPDATE Packing Instructions
UPDATE Request Date
UPDATE Schedule Arrival Date
UPDATE Schedule Ship Date'
UPDATE Ship To
UPDATE Ship To Contact
UPDATE Shipment Priority
UPDATE Shipment Instructions
UPDATE Subinventory
UPDATE Warehouse

** - If the seeded processing constraint is disabled, you can update the values of the Customer PO and Customer PO Line Number fields, provided the line is not Invoice Interfaced.

For example, you cannot perform an order line update to the Customer field if an order line has been pick confirmed in due to the existing, enabled processing constraint disallowing the operation UPDATE of attribute Customer after a line has been pick confirmed.

The following table lists details for Order Management operations and the current order line status which are limited by processing constraints that are enabled by default; you cannot perform an operation listed in column A for the associated order line status listed in column B.

Details for OM Operations and Current Order Line Status
Column A:
Order Management Operation		 Column B:
Current Order line status
CANCEL Not allowed if pick confirmed
DELETE Not allowed if pick confirmed
SPLIT Not allowed if pick confirmed
SPLIT Not allowed for internal order lines.

For example, you cannot Cancel an order line if the order line has been pick confirmed due to the existing, enabled processing constraint disallowing the operation CANCEL after a line has been pick confirmed.

Note: Oracle Release Management also utilizes processing constraints in Table B to limit order quantity changes.

See

Oracle Order Management Implementation Manual, Overview of Processing Constraints.

Oracle Order Management Implementation Manual, Defining Processing Constraints, Order Management Processing Constraints Appendix.

Oracle Shipping Execution User's Guide.

Oracle Release Management User's Guide

To apply changes to an order or return:

  1. Navigate to the Order Organizer and query the order or return you want to apply changes.

  2. Choose the Open Order to open your order in the Sales Orders window.

  3. Enter your changes to the order or return for either the order header or order line attributes you choose.

  4. Save your work.

  5. If you receive an error message and wish to notify someone else, click Actions and select Notification from the list of values.

    Notification Window

    the picture is described in the document text

    Note: If there are multiple errors, the Multiple Error Message window displays. Click Notify to send a notification to the appropriate user responsibility.

  6. Select or accept the appropriate user responsibility to approve the order change.

  7. Enter any additional comments in the Message Text field.

  8. Click Send.

    Special considerations for order line changes to Subinventories include the following:

    • Changing the value of Subinventory for a reserved line will automatically cancel the existing reservation, and generate a new reservation for the new subinventory.

    • If an order line associated with a subinventory is split either by the user or the system, the new order line will retain the original subinventory information.

      Note: If the warehouse or the Ship To for the order line is changed during a split, the subinventory field will be NULL for the new split line generated.

Repricing a Line

Before you book an order, you choose items and a price list for the order. If you modify a price list or discount after applying either to an item on your order, use Price Line from the Action menu while in the Line Items tabbed region to update your order lines.

When you use Price Line, the pricing engine executes the LINE event. The seeded LINE event contains the phases List Line Base Price and List Line Adjustment. If you change a price list line or a line level modifier, Price Line reevaluates your base price and line level adjustment. However, since the LINE event does not include the phase Header Level Adjustment, Price Line does not reevaluate header level modifiers.

If you add the Ship Entered event to the List Line Adjustment phase (Phase 10), then whenever pricing is called for the Ship event, the application reprices automatically.

To update the price for an order line:

  1. Navigate to the item you want to reprice in the Sales Orders.

  2. Select the Line Items tabbed region.

  3. Click Actions, and then select Price Line from the list of values.

    Order Management recalculates and displays the item's new Selling and Extended Prices, based on current list price and automatic discount information.

    Note: If you have applied a manual Order- or line-level discount to an order and subsequently redefine the discount, you must remove it from the order, then re-apply it.

Overview of Mass Changes

Oracle Order Management provides you with the ability to multi-select several orders or returns, order lines or return lines and apply changes in one single transaction. Multi-select the orders you want to apply the mass change and choose the Mass Change option from the Tools menu. In the Order and Line Mass Change windows you can multi-select orders and:

Note: The mass change windows cannot be used for single order lines or return lines.

If you have access to multiple Operating Units, then you can perform Mass Change on Order or Lines across Operating Units.

Applying Mass Changes

Prerequisites

To make mass changes, select multiple orders or order lines in the Order Organizer or Quick Order Organizer windows.

Important: If any line in a group (shipset or arrival set or model) fails when you update an attribute using Mass Change, then all the lines in that group fail and the mass update does not take place for lines in that group only.

If the line is not in the group (shipset or arrival set or model), then failure of this line would not affect any other line in the mass change.

You cannot make mass updates on the tax exemption information for multiple orders that belong to different customers. Additionally, you cannot update the tax classification codes for orders that belong to different operating units.

To apply a mass change at the order header level:

  1. Navigate to the Order Organizer (or Quick Order Organizer) and query the orders or returns for which you want to apply a mass change.

  2. Select multiple orders or returns you want to apply the mass change in the Order Organizer Summary Information View.

  3. Select Mass Change from the Tools menu.

    Order Mass Change Window

    the picture is described in the document text

  4. Enter new values for order header attributes in the Main, Pricing, Shipping, and Addresses tabbed regions.

  5. Click OK.

The Tools menu of the Order Mass Change window contains the following options only: Debug and Change Reason.

Note: You cannot edit the Order Source field in the Mass Change window.

In the Mass Change window, you can update attributes that are not operating unit-specific, and on orders or lines of different operating units.

The following fields are operating unit-specific and are disabled when you select orders that belong to different operating units. You cannot use these fields as a criterion for mass change.

To apply mass change at the order line level:

  1. Navigate to the Order Organizer orQuick Order Organizer window. Query the order or return you want to apply a mass change.

  2. Click Lines tab in the Order Organizer window. If you select Quick Order Organizer window, then click Open Order and click Line Items tab.

  3. In the Line Items tab region, select the multiple lines to change.

  4. Select Mass Change from the Tools menu.

  5. Enter new values for line level attributes in the Main, Pricing, Shipping, Addresses, Returns, Services, and Others tabbed regions.

    You can perform mass change on the following fields:

    • Arrival Set

    • Fulfilment Set

    • Intermediate Ship To

    • Intermediate Ship To Location

    • Intermediate Ship To Contact

    • Ship Set

    • Subinventory

  6. Click OK.

Note: Mass Change functionality is supported in Quick Sales Orders and Quick Order Organizer windows. Mass Change functionality enables you to select multiple order lines and schedule them in Override ATP mode. Use the folder-enabled Override ATP check box available in the Shipping tab to use the Override ATP functionality in the Mass Change window.

The profile option OM: Sales Order Form: Cascade Header Changes to Line is also applicable to the mass change functionality. If you change a value at the order header level for multiple orders and if the field value can be cascaded to the order lines, then depending on the value of the profile option OM: Sales Order Form: Cascade Header Changes to Line the value will be updated on the open order lines.

For example, to change the payment term for a particular customer, select the order headers that you want to update. Then use Mass Change to update the Payment Term field.

If the value of the profile option OM: Sales Order Form: Cascade Header Changes to Line is set to Automatic, the changes made to the header (mass or individual) will be cascaded to the lines automatically. For example, payment terms are updated in the order lines and for the order headers that you selected and updated.

If the value of the profile option OM: Sales Order Form: Cascade Header Changes to Line is set to AskMe, then you are prompted to cascade updates from the header to the lines or not. The message displayed is: Do you want to cascade the header changes to lines for successful records?

If the value of the profile option is set to Manual, then automatic cascading does not take place from the header to the lines during a mass change. You then need to manually make the updates to the order line.

Note: You must ensure that the field that you are updating for mass changes can be cascaded, that is, it should be enabled in the lookup OM: Header to Line Cascade Attributes.

For information on the profile option OM: Sales Order Form: Cascade Header Changes to Line and the lookup OM: Header to Line Cascade Attributes, see Oracle Order Management Implementation Manual.

For every successfully updated header, cascading occurs for either all or none of the lines. If there is an update failure for one line, then the cascade processing will fail for the other lines. For example, if there is a processing constraint in place at the line level that restricts update and that attribute is updated at the header, which subsequently fails for the line, cascading will fail for all other lines.

Copying Orders

You can create a new order, quote or return by copying information from an existing order or return. Order Management provides the ability to copy an order or return at any phase in the order life flow including entering, booking, shipping, closed, and cancelled.

Note: When copying lines to a new order or return, the lines will be copied over with the original ordered quantity.

Multi-Select

The copy orders feature enables you to multi-select multiple order or return records. In addition, Order Management enables you to copy order lines from within an order or across orders to a new order or append them to an existing order.

Creation of Return Material Authorizations

If a customer returns items against an order, you can copy the order lines from the original order to create a return rather than creating a new RMA.

Copying Orders Across Operating Units

The Operating Unit LOV enables you to copy orders across operating units. By default, the operating unit of the source order is displayed in the Operating Unit LOV and if you do not change the value of the LOV, the copied order is created in the same operating unit as the source order. The Operating Unit LOV displays all the operating units that the user has access to. If you select a different operating unit, then all fields/boxes are cleared. Operating Unit sensitive fields such as Change Order Type To, Add Lines To, Get Header Level Info From, Change Line Type To, the existing order and quote lists display the data corresponding to the value in the operating unit field.

When you copy across operating units (customer sites), the copied order has the following default values from the source order: Item, Warehouse, Price List, Ship-To, Bill-To, Order Type.

If the validation fails for a mandatory field such as Order Type or Customer Location, or if the value of a non-mandatory field that fails validation cannot be cleared, then the copy fails, and the error messages display in the Process Messages window.

In a situation where the original sales order is in one operating unit and the RMA with it's reference is in another operating unit, the copy is not carried out. The following error message appears: The sales order line you are referencing cannot be returned.

Validation

Copy Orders ensures the same validation for your orders and lines as the Sales Order workbench. If any validation errors occur, Order Management displays the messages in the Messages window.

Note: You cannot copy or interface an order line having a price list with a currency code different from the existing or newly created order header's currency code. An error message will be displayed in the Process Messages window

Invalid Attributes

Order Management's copy orders feature supports creation of orders and order lines even when some of their attributes are invalid. This feature is to facilitate copying of outdated orders and order lines. The application will attempt to default invalid attributes.

Note: If the application cannot default a valid attribute then it is set to Null. If this occurs for a required attribute, and an attribute cannot be defaulted in, then the order or order line is not created. If any validation errors occur, Order Management displays the messages in the Process Messages window.

Attributes that you can change during copy

Order Management enables you to change the following attributes of the copied to order:

Multiple Order Copy

The box No of Copies enables you to specify how many copies you want for the original order. If you specify a number greater than 1, the box Display New Order After Copy is disabled, that is, you can open only one order after copying. You can specify 99 copies as the maximum number of copies in the No of Copies box.

Append Lines

You can copy lines from an existing order and append the lines to another order. In such a situation, you can default the header information from the current original order or specify a new order number that the header information should be defaulted from. The default value of the Get Header Level Info From field is the current order number that you are copying, you can change it if you wish to specify another order to copy the header information from.

Copy Lines

You can select a number of lines from an order and copy the lines to a new order. If you choose to copy the header level information from another source you need to select an order, from the Order Information tabbed region, in the Sales Orders window.

Copy User Defined Attributes

If you have created user defined attributes in your original order, the copy functionality will make the user defined attributes available in the copied order. By default the User Defined Attributes check box is checked. Select the check box to copy the copied order header and lines in the Copy Header and Copy Lines tabs of the Copy window.

When you copy lines, the field values get copied to the new lines. To specifically copy UDA field values, select the Copy Lines: User Defined Attributes check box. This ensures that the UDA columns also get copied along with the other column values to new lines.

Copying Sets

If you have created a Ship, Arrival, or Fulfillment set in your original order, the Copy functionality will make that set available in the copied order. The sets will be copied from the original order provided the following boxes in the Copy Lines tab are selected: Ship/Arrival Sets and Fulfillment Sets. By default these boxes Ship/Arrival Sets and Fulfillment Sets are unchecked. If you select either or both of them, the sets from the original order will be copied to the new order(s). However if the Line Set field is null or blank, the value specified in the defaulting rule is used to populate the Line Set field in the copied order.

Copying lines to an existing order (Add Lines to: Existing Order) creates the line set if a set with same set name doesn't already exist, otherwise the line is added to the existing set in the same order.

the picture is described in the document text

Configurations

You can copy configuration information from one order to another. To copy all lines of a configuration, select all of the lines, then launch the Copy Orders window. If you select only the config item line, then it will be copied as an ATO item. An option line is copied as a standard item if you select the option line without selecting the model line. If you select a class line without selecting the model line the copy operation will fail. The included item lines will be copied over as standard items if you select the included item lines without selecting its parent line. Order Management supports this feature to facilitate the creation of order lines for spares.

The Copy functionality is used to create RMA against a Configuration with class and options. The item type on all RMA lines will be set to Standard. Such an RMA Order then cannot be copied back to Standard Order.

Note: You cannot copy an order which contains a solution based model for which one or more of the components have been cancelled. This is currently not supported, and you may receive the following error: Item &ITEM is selected more than once in this Configuration.

Service Lines

Order Management enables you to copy a product line and its service. You cannot copy a service line by itself.

Pricing

The Pricing tab enables you to specify whether the new order or order line is copied at the original pricing or is repriced. To reprice, you can specify the pricing date. If you choose to reprice the order or order line, manual discounts and charges are removed and automatic discounts and charges are recalculated. If you choose to retain original pricing, all discounts and charges are retained and the Calculate Price Flag is set to Freeze Price for order lines and Partial Price for return lines. If you choose partial pricing, then the Calculate Price Flag sets to Partial Price for all the lines.

If you copy from order header, and choose to retain Original Price or Price Partial , the promotion adjustments will be retained on the copied order.

If you select the lines to copy from the Lines tab of the sales order, then the promotion adjustments (if any) are retained on the copied lines only if:

To retain the original price on RMA lines, when you create it using the Copy functionality or with reference to an existing sales order line, specify a price adjustment modifier in the OM: Price Adjustment Modifier for reference RMA profile. See: Order Management Profile Option Descriptions and Settings, Oracle Order Management Implementation Manual

Note: When the destination order type while copying an order is RMA, Oracle Order Management will set the Calculate Price Flag to P for the copied order lines even if the you specify At Original Price within the Pricing Options tab copy window.

Header Level Information

You can copy the header information without having to copy any lines. If you click Copy on the Sales Orders window at the header level, you have the option of copying all or none of the order lines. The header information for the new order will come from the order number specified in the Get Header Info From field. The order number defaults from the current order, however you can change it so specify that you want the order header information to be copied from another order.

Line Level Information

You can specify whether to copy all lines from a given order. For example, if a customer requests the same exact order twice within the same month, you can create a new order with the same order line information and re-price the order. If you click Copy on the Sales Orders window at the header level, you have the option of copying all or none of the order lines.

Access to Copied Order

You can maintain the copied order or order line when the original order is duplicated, without opening another window. Once you have copied an order, you can access the order using the Today's Orders node in the Order Organizer tree.

Alternatively, you can select the Display New Order After Copy box and the newly copied order will open in the Sales Orders window. Please note that if you have selected multiple copies, then the Display New Order After Copy box is disabled; you can display a newly created order if it is a single copy only. The value of the box is also dependent on the profile option OM: Display New Order After Copy. If the value of the profile option is set to Yes, then the box is checked by default. If the value of the profile option is set to No, then the box is unchecked by default.

Major Features Supported by Copy Function

Copy Orders at Any Stage

You can to copy an order at any stage in its life cycle, including but not limited to:

The copied orders/lines will start at the beginning of their assigned flows, similar to when orders/lines are created via the Sales Orders window. Or for negotiation including but not limited to:

Using Copy Orders to Create Returns

You can use the Copy Orders function to create Returns with reference. This can be done by selecting the order/lines and then specifying a Return Line type and a Return Reason code while copying. When creating returns for configurations, you only copy the model line. The system will automatically explode all the classes, options, and included items from the original reference line. To return individual components of PTO configurations, select the specific lines and copy them as return lines.

Copying Quotes at any Stage

Quotes can be copied to either quote or orders just like any sales order.

Copying a Specific Transaction Version

You can select any specific version of a transaction (Quote Header or Order Header) while doing a single source copy.

Prevent Copying Quotes to RMA

If the source or destination is Quote then you will not be able to change the line type to specify an RMA line type. Also Order Type cannot be changed to one with Category of RETURN. Allowed Order Categories are MIXED and ORDER.

Assigning a sign (positive or negative) to numbers during Copy

When an order is copied to a Mixed Order Type and line type as Return (Approval), the line and header charges also get copied. The charges for the lines are copied with the negative sign and the header charges are copied with the positive sign. The charges must have Include on Returns flag checked.

If an order is copied to a return or vice-versa, the sign of the numbers gets reversed.

For all other combinations, the sign of the numbers is not changed, the sign remains as it was in the original order. The different scenarios in which the sign of the numbers is unchanged during a copy are:

User Procedures

To copy orders in the Sales Orders window:

  1. Navigate to the Sales Orders window, and query an order.

  2. Select the order or multi-select the orders (if you are using Order Organizer) to copy. Click Action and choose Copy. The Copy Orders window appears. Specify an Order Type to change it and click OK. This will perform the copy, close the window and you can open the new order if the Display New Order After Copy box is selected during the copy. Otherwise the original order is displayed and you need to query the newly copied order.

    If the Source is a single order and has multiple versions then the selected version will be displayed in the Source Version Number field. You can select any available version of the source.

    To exclude child entities (Lines, Sales Credits, Notes, Descriptive Flex, or Holds) or re-price navigate to the Copy Header/Line and Pricing Options tabs and deselect options as desired.

    The newly copied Order/Orders will be available via the 'Today's Orders' node in the Order Organizer tree in the Sales Order Pad.

To add all lines from an order/orders to an existing order:

  1. Navigate to the Sales Orders window, and query an order.

  2. Select the order or multi-select the orders to copy. Click Action and choose Copy. The Copy Orders window appears. Select Add Lines to Existing Order button and specify the existing order to append to. Click OK. The header information for the new order will come from the order number specified in the Get Header Info From field.

    To exclude child entities (Sales Credits, Notes, Descriptive Flex) or re-price navigate to the Copy Line and Pricing Alternative tabs and deselect options as desired. The Copy Header and Copy Quote tabs will not be available for this operation.

To copy a line/lines to a new order:

  1. Navigate to the Sales Orders window, and query an order.

  2. Select the order or multi-select the orders to copy. Click Action and choose Copy. The Copy Orders window appears. Select the Create New Order Radio button. Specify the Order Type that the new order should have. Specify the Order Number to get the header level information from and click OK. This will perform the copy, close the window. The header information for the new order comes from the order number specified in the Get Header Info From field.

    To exclude child entities (Sales Credits, Notes, Descriptive Flex) or re-price navigate to the Copy Header/Line and Pricing Options tabs and deselect options as desired.

    The newly copied Orders will be available via the 'Today's Orders' node in the Order Organizer tree in the Sales Order Pad.

To copy quote(s) to quote(s):

  1. Navigate to the Sales Orders window, and query a quote.

  2. Once you are on the Quote Header or multi-select the quotes to copy. Click Action and choose Copy. The Copy window appears. Select the Radio button Create New Quote. The field Order Number will be disabled and Quote Number will be enabled (If only one quote was selected). The header information for the new order will come from the order number specified in the Get Header Info From field. Specify an Order Type if you wish to change the Order Type and click OK. This will perform the copy, close the window and the cursor will be placed on the original quote. You will need to query for the new quote to display it in the window.

    If the Source is a Single Quote and has multiple versions then the selected version will be displayed in the Source Version Number field. You can select any available version of the source.

    You can choose the Copy Quote tab and specify to retain the Expiration Date from the source quotes. To retain the Quote Name check for Quote Name. To not retain the Expiration Date or Quote Name specify them in the provided fields. If left blank and the check box is unchecked, Expiration Date and Quote Name will be cleared.

    To exclude child entities (Lines, Sales Credits, Notes, Descriptive Flex, Holds) or re-price navigate to the Copy Header/Line and Pricing Options tabs and deselect options as desired.

To copy order(s) to quote(s):

  1. Navigate to the Sales Orders window, and query an order.

  2. Select the order or multi-select the orders to copy. Click Action and choose Copy. The Copy Orders window appears. Select the button Create New Quote. The field Order Number will be disabled and Quote Number will be enabled (If only one order was selected). The header information for the new order will come from the order number specified in the Get Header Info From field. Specify an Order Type to change (specify an Order Type which is Quote Enabled) and click OK. This will perform the copy, close the window and the cursor will be placed on the original Quote. To view the newly copied quote, you need to query for it in the Quotes window.

    If the Source is a Single Order and has multiple versions then the selected version will be displayed in the Source Version Number field. User can select any available version of the source. The Copy Quote tab will be disabled.

    To exclude child entities (Lines, Sales Credits, Notes, Descriptive Flex, Holds) or re-price navigate to the Copy Header/Line and Pricing Options tabs and deselect options as desired.

To copy quote(s) to order(s):

  1. Navigate to the Sales Orders window, and query a quote.

  2. Select the Quote Header or multi-select the quotes to copy. Click Action and choose Copy. The Copy Orders window appears. Select the button Create New Order. The field Order Number will be enabled (If only one quote was selected) and Quote Number will be disabled. The header information for the new order will come from the order number specified in the Get Header Info From field. Specify an Order Type to change and click OK. This will perform the copy.

    If the Source is a single quote and has multiple versions then the selected version will be displayed in the Source Version Number field. You can select any available version of the source. The Copy Quote tab will be disabled.

    To exclude child entities (Lines, Sales Credits, Notes, Descriptive Flex, Holds) or re-price navigate to the Copy Header/Line and Pricing Options tabs and deselect options as desired.

To copy multi selected quotes and orders to orders:

  1. Navigate to the Sales Orders or Order Organizer window, and query multiple quotes and orders. Please ensure that these quotes and orders belong to the same operating unit.

  2. Select the Quote Header or multi-select the quotes to copy. Click Action and choose Copy. The Copy Orders window appears. Select the button Create New Order. The header information for the new order will come from the order number specified in the Get Header Info From field. Specify an Order Type to change and click OK. This will perform the copy, close the window. This will Create a New Order/Orders. The Copy Quote tab will be disabled.

    To exclude child entities (Lines, Sales Credits, Notes, Descriptive Flex, Holds) or re-price navigate to the Copy Header/Line and Pricing Options tabs and deselect options as desired.

To copy multi selected quotes and orders to quotes:

  1. Navigate to the Sales Orders window, and query multiple quotes and orders. Please ensure that these quotes and orders belong to the same operating unit.

  2. Select the Quote Header or multi-select the quotes to copy. Click Action and choose Copy. The Copy Orders window appears. Select the button Create New Quote. The header information for the new order will come from the order number specified in the Get Header Info From field. Specify an Order Type to change (Specify the one which is quote enabled) and click OK. This will perform the copy, close the window. This will Create a New Order/Orders. The Copy Quote tab will be disabled.

    To exclude child entities (Lines, Sales Credits, Notes, Descriptive Flex, Holds) or re-price navigate to the Copy Header/Line and Pricing Options tabs and deselect options as desired.

To add all lines from quotes/orders to an existing quote:

  1. Navigate to the Sales Orders window, and query an order.

  2. Select the Quote Header or multi-select the quotes to copy. Click Action and choose Copy. The Copy Orders window appears. Select the Add Lines to Existing Quote Radio button and specify the existing quote to append to. The header information for the new order will come from the order number specified in the Get Header Info From field. Click OK.

    To exclude child entities (Sales Credits, Notes, Descriptive Flex) or re-price navigate to the Copy Line and Pricing Alternative tabs and deselect options as desired. Copy Header and Copy Quote tabs will not be available for this operation.

To Copy a line/lines to a new quote:

  1. Navigate to the Sales Orders window, and query an order.

  2. Select the line or multi-select the lines to Copy, click Action and choose Copy. Select the Create New Quote Radio button. Specify the Order Type that the new Order should have. Specify either the Quote Number or Order Number to get the header level information from and click OK. This will perform the copy, close the window. The Header information for the new Quote will come from the order number specified.

    To exclude child entities (Sales Credits, Notes, Descriptive Flex) or re-price navigate to the Copy Header/Line and Pricing Options tabs and deselect options as desired.

    To include the Quote Name, Expiration Date or to specify the version number of the selected quote, go to the Copy Quote tab (Provided the header level info is selected from a quote).

To setup a constraint to prevent COPY of QUOTE to an order:

  1. Navigate to the Processing Constraint window and query the entity Order Header.

  2. Go to the Constraints tab and select Operation as CREATE, keep the Attribute BLANK, select user action as Not Allowed. Select Applies To Sales Order.

  3. Go to the Conditions Tab and select the Validation Entity = Order Header, Record Set as Order, Validation Template as Copied From Quote.

  4. Save the constraint and generate the constraint packages.

To copy a Sales Agreement (SA):

The action to copy is available from both Tools and the right mouse click on the Sales Agreements window. The same option will be available on the Version History window so that any version can be used in COPY.

Once the copy is successful the system will automatically take you to the new Sales Agreement.

You can use copy to create a new agreement from any of the existing ones. You can pick any version of the SA (Sales Agreement) for copy.

The transaction type on the source sales agreement will decide the initial phase of the copied agreement. The new SA will have new sales agreement number and starts either in draft (if a negotiation flow is associated) or in entered state (for a non-negotiation type).

Messages

  1. Message Name: OE_CPY_HDR_SOURCE_PROMPT

    Message Text: Get Order Level Information from...

    Description Conditionally visible prompt for source of order header information.

  2. Message Name: OE_CPY_ORDER_TYPE_MISSING

    Message Text: Please specify the New Order Type, you want to Copy to.

  3. Message Name: OE_CPY_ORDER_TYPE_REQUIRED

    Message Text: You have chosen to copy selected lines to a New Order. Please choose an Order to copy Header Information from or choose an Order Type.

    Description: Message issued when Order Type is not specified.

  4. Message Name: OE_CPY_APPEND_ORDER_MISSING

    Message Text: You have chosen to append Lines to an existing Order. Please select an existing Order Number.

    Description: Message issued when Append to Order is missing.

  5. Message Name: OE_CPY_APPEND_ORDER_MISSING

    Message Text: You have chosen to append Lines to an existing Order. Please select an existing Order Number.

    Description: Message issued when the Order Type and Source Order are missing during an Append.

  6. Message Name: OE_CPY_APPEND_LINE

    Message Text: Copy Successful.

    Description: Message issued when lines are copied to an existing order.

  7. Message Name: OE_CPY_COPY_FAILED

    Message Text: Copy Failed.

    Description: Message issued when Append or Copy Failed.

  8. Message Name: OE_CPY_NEW_ORDER

    Message Text: Copied Order is [ORDER].

    Description: Message issued when a new order is created.

    Messages (Quotes)

  9. Message Name: OE_CPY_NEW_QUOTE_HEADER

    Message Text: Quote Header has been created successfully for the Quote & QUOTE.

    Description: Message issued when the quote header is copied successfully.

  10. Message Name: OE_QUOTE_CPY_LINES_FAILED

    Message Text: Unable to copy lines for the Quote &QUOTE.

    Description: Message issued when the quote header is copied successfully.

  11. Message Name: OE_CPY_NEW_QUOTE_SUCCESS

    Message Text: Copy succeeded. The new quote number is & ORDER.

    Description: Message issued when the quote is copied successfully.

  12. Message Name: OE_QUOTE_CPY_COPY_PARTIAL

    Message Text: Copy partially succeeded for the Quote & QUOTE.

    Description: Message issued when the quote is copied with partial success.

Maintain Line Number

Order Management retains line number sequences under certain conditions when copying lines from a source order.

Overview of Maintain Line Number

Conditions apply when line sequences are copied from a source document. When a copy action is performed and lines are appended to an existing order then only the line sequence will be maintained. If there are additional lines added to the order as a result of pricing, the line will be assigned a new line number. Other conditions are:

Split Line Sequences

RMA

Copy Line Failures

When a copied line fails, the line numbers of the copied lines that are passed will be re-sequenced.

Entities and Attributes

You can specify the entities that you wish to copy to the new order or order line including:

The following attributes can be copied (optional):

Copy Orders at Any Stage

You can copy an order at any stage in the order flow including, but not limited to, entered, booked, shipped, closed, and cancelled.

Note: You can determine whether to include/exclude fully cancelled lines when using the copy feature. If fully cancelled lines are included, the lines are copied over with the original ordered quantity.

The copied orders or order lines start at the beginning of their assigned workflow. Order lines cannot be added to closed orders.

Internal Orders

You can create requisitions (with same number) in two different operating units.

Returns

You can use the copy orders feature to create returns by Reference orders. Select the orders or order lines, return order type, return line type, and return reason code.

When creating returns for configurations, you need to copy the model line. Select the specific order lines and copy them as return lines to return individual components of PTO configurations.

Note: Order and line sales credits will always be copied to return orders and lines.

Visibility of Source Order or Line Information on the Copied Order or Line

For a copied order, the order number of the original order will be visible in the Others tab on the Order Header tab. For a copied line, the order number and the line quadruplet (line, shipment, option & service line number) of the original line will be visible in the Others tab of the Lines tab.

The Copy Orders window is available from the Sales Order Workbench, from both the Order Information and the Line Items tab. It is also available from the Order Organizer where it can be accessed by pressing Actions.

To copy an order or orders:

  1. Navigate to the Sales Order window to copy a single order, or the Order Organizer window (to perform either single or multiple order copies) and query the order or return you want to copy.

  2. Click Actions and select Copy from the list of values.

    the picture is described in the document text

The Copy window contains 4 tabs, with each tab containing the following information:

Quick Copy Tab

Copy Header Tab

Include:

Copy Lines Tab

Copy Complete Configuration - This check box enables you to specify whether you want to COPY a complete Configuration for a Line Level COPY.

For line level copy, the default value of this check box will be un-checked.

If checked COPY will try to copy the complete configuration provided you have selected the Top Model Line for COPY. If some of the child lines are also selected along with the top model line, then we will still copy the complete configuration (with the exception of Included Items and Config Items).

If unchecked, there is no change in the COPY behavior.

This check box will be disabled for order level COPY as we always copy the Complete Configuration for order level copy.

A new system parameter controls the default value of this new check box "Copy Complete Configuration." The name of the system parameter is "Default value for Action - Copy Complete Configuration."

This parameter can be set to Yes or No at operating unit level.

Pricing Options Tab

Line Pricing options:

When a sales order containing order level discounts is copied using the Pricing option Price Partial to later add freight charges:

  1. Header level adjustments appear as line adjustments in the lines of the copied order. That is, from order lines Lines > View Adjustments, we see the modifier applied but the Level is seen as LINE instead of ORDER

  2. Header level adjustments don't appear in the View Adjustments in the header of the copied order

    • When an order is copied and the item is changed on the order, the value of the Calculate Price Flag for the new order line is set dependent upon the value of the profile option OM: Item Change Honors Frozen Price.

    • If the Copied order to be created is enabled for an Order Type of Return, when Copy order is performed, the Process Order API will set the Calculate Price Flag to P, irrespective of what is selected within the Pricing Options tab.

  1. Specify an Order Type to change it.

  2. To include or exclude child entities (lines, sales credits, notes, descriptive flex, and holds) or to re-price, navigate to the copy header, copy line and pricing options tabs and deselect options as desired.

  3. Choose OK.

This will perform the Copy, close the window and the cursor will be placed on the new Order that was created provided there are no errors during the Copy.

The newly copied order or orders are available through in the Order Organizer tree in the Sales Order window.

Note: If the Copy Order function encounters any errors during order copy, Order Management will display the Process Messages window. If you wish to save the information you were attempting to copy, click Continue to save your copy order, or the Cancel button to rollback your changes.

Note: When you receive the message, Copy Order Successful, you must click Continue. If you do not, the order line information you were attempting to copy will not be copied.

To Append a Line or Lines to an Existing Order:

  1. Navigate to the Order Organizer window and query the line or lines you want to copy.

  2. Click Actions and select Copy from the list of values.

  3. Select Add Lines To.

  4. Specify the Existing Order you want to append.

  5. To include or exclude child entities (sales credits, notes, or descriptive flex) or to re-price, navigate to the Advanced Order/Line and Pricing Options tabs, and deselect options as desired.

  6. Choose OK.

    Note: If you are using the COPY feature to: add lines to existing orders/quotes, create Order/Quote using get header level info from an existing Quote/Order, and you are encountering performance issue with the LOV for Order Number/Quote Number on COPY window, define a custom index (functional index) on the columns: to_char(order_number), and to_char(quote_number).

Using the Pricing Options

With the Pricing Options tab, you can choose to retain original pricing or reprice. When copying only header information from an order, you cannot choose to retain original pricing. When you choose to reprice, the pricing date will default to the current date.

See: Oracle Order Management Implementation Manual, Order Management Profile Options.

Overview of Holds

Oracle Order Management enables you to hold an order, return, order line, or return line from continuing to progress through its workflow by utilizing the holds feature. Holds can be applied manually or automatically based on a set of criteria you define, such as a credit check hold.

You can define as many different holds as you need to manage your business. You can also select multiple orders, returns, order lines, or return lines from the Order Organizer and apply or release holds.

Apply Holds window

the picture is described in the document text

Credit Checking

Oracle Order Management performs an automatic credit check on your customers, based on credit rules and credit limits you define. You can set credit limits for a total of all the customer's orders and of individual order amounts; assign tolerance percentages; and exclude certain customers, types of orders, or payment terms from credit checking entirely. You can also place a customer's account on hold so that no new sales orders can be progressed for that customer.

Note: For a line level credit check and hold, the credit management request will not be displayed and can be viewed on the Process Messages window.

Oracle Order Management evaluates orders and lines for credit checking in the following order:

If credit check failure occurs at any one or more levels of credit checking, then the application applies a hold on the order or line. Additionally, if you have installed OCM, then Order Management submits a credit management review and passes the reasons of credit check failure as messages to OCM. These messages enable the credit manager or analyst reviewing the case folder to determine the exact reason for the credit check failure. Order Management proceeds with credit check evaluation for all levels one by one even if one level fails and creates one case folder in OCM for any one or more cases of credit check validation failure.

For updated orders, the credit check process honors manually released holds as long as the increase in order amount is less than a specified tolerance limit. Additionally, for these updated orders, if you change the bill to site of an order keeping the site within the same customer and have not defined credit limits for the selected site, then the credit checking process does not redo credit checking. See: Defining Credit Check Rules, Oracle Order Management Implementation Manual

You can specify the recipient of the credit check hold notification by setting the applicable user or a role as the value of the OM: Credit Check Notification Recipient profile option. See: Profile Options and Order Management Profile Option Descriptions and Settings in Oracle Order Management Implementation Guide. If no value is specified for the profile option, then the application notifies the user who created the order.

During credit checking, a difference in the exposure or outstanding balance calculation process is based on the Include Tax andInclude Freight and Special Charges check boxes of the credit check rule. The difference is as follows:

Hold Sources

Hold sources enable you to apply a particular hold to a group of existing orders, returns, or their lines, and to new orders or lines meeting your hold criteria. Hold sources are valuable when you want to hold all current and future orders for criteria such as:

For example, you create a hold source to hold an unreleased item. Once the item is available, you remove the hold source for the item, and all holds on individual order lines are released. A hold source can:

See Holds Information section in the Order Inquiry chapter for more information.

You can open the Create Hold Sources window from the Tools menu. The Operating Unit field on the Criteria tab of the Hold Sources window will default from the Sales Order window (if it is set) or from your default operating unit. The list of values show all operating units that you have access to. You must enter the operating unit before you can specify hold source criteria. Clearing or changing the Operating Unit field will clear the hold source criteria.

The Applicable Also To region consists of the All Operating Units box and the Operating Unit LOVs. You can define a hold source for all operating units you have access to or for specified operating units. By default, the Operating Unit field is populated based on your default operating unit. You can specify that the hold source that you created is also available in all operating units or specified operating units.

To view or update a hold until date, query the hold in the Hold Sources window. You can update the hold until date for all hold sources except those that correspond to the system holds like:

Create Customer or Site Based Hold Sources from the AR Customer Form

When you select the Credit Hold check box on a profile attached to a customer, it will create a Global Customer based hold source and put all orders for that customer in all Operating Units on hold. Deselecting the check box will release that hold source and release all orders put on hold based on that hold source.

A hold source will be created in every OU where that customer has a site defined and every OU that has an order for that customer. Every time a new site is defined for that customer (in an OU where there were no sites previously defined) Oracle Accounts Receivable will call Oracle Order Management to create a hold source in that OU.

When you select the Credit Hold check box on a profile attached to a customer site or address, the application will create a Site based Hold Source in the operating unit that the site is defined in. This will also put all lines using that site on hold. You can release such hold sources only by deselecting the Credit Hold check box on the Customer or Site profile. You can release the individual orders or lines on hold from Oracle Order Management.

Additionally, the Apply Credit Hold Based On system parameter enables you to select the customer level where the credit hold is to be applied. The application can place orders on credit hold at order level based on Sold To Customer of the order when you set the system parameter to Sold To Customer or if you have not provided any value (default behavior). The value Header Level Bill To Customer places the order on credit hold if you have selected the Credit Hold check box for the Bill To Customer of the order. The value Line Level Bill To Customer places the order lines on credit hold if you have selected the Credit Hold check box for the Bill To Customer of the order line. This provides the flexibility of putting all the order lines belonging to multiple Bill To Sites but under same Bill To Customer on credit hold without having to select the Credit Hold check box for each site.

List of Criteria that you can use in a Hold Source
First Hold Criteria Second Hold Criteria (Dependant on First Hold Criteria) Hold Level
WAREHOUSE - LINE
  Line Type LINE
  Shipping Method Code LINE
  Deliver To Site LINE
  Source Type Code LINE
ITEM Shipping Method Code LINE
  Deliver To Site LINE
  Price List LINE
  Project Number LINE
  Source Type Code LINE
  Line Type LINE
SALES AGREEMENT Price List LINE
  Payment Term LINE
  Shipping Method Code LINE
  Deliver To Site LINE
  Line Type LINE
TOP MODEL Option Item LINE
PROJECT NUMBER Task Number LINE
CUSTOMER Source Type Code LINE
  Bill To Site LINE
  Ship To Site LINE
  Deliver To Site LINE
  Price List LINE
  Line Type LINE
  Payment Terms LINE
  BLANK ORDER
  Order Type ORDER
  Payment Type ORDER
  Transaction Currency Code ORDER
PRICE LIST Transaction Currency Code ORDER
ORDER TYPE Transaction Currency Code ORDER
  Line Type LINE
CREATION DATE Created By LINE
SALES CHANNEL CODE - ORDER
PAYMENT TYPE CODE   ORDER/LINE
SHIPPING METHOD CODE   LINE

Custom Hook

The custom hook API OE_HOLDS_HOOK.CUSTOM_HOLDS enables you to get the handle to all the header and line level attributes for an order. You can write custom logic to identify the criteria, either by using any attributes related to header or line OR their own custom logic. You can assign the hold details that must be applied (as an out parameter, that is detailed in the custom hook API). 

You must create the hold using the Holds definition window in Oracle Order Management Setup, and then the corresponding hold details are used to initialise in the custom hook. Therefore, the custom hook API does not create a new hold on the fly, however, it applies a valid hold defined in Hold definition, provided the conditions in custom hook are met. If a custom hook hold gets applied on a sales order header, the following message appears: Hold applied against order based on Custom Hook. If a custom hook hold gets applied on a sales order line, the following message appears: Custom Hook hold applied against line <<Sales Order Line Number>>. For example: Custom Hook hold applied against line 2.1.

Additionally, when you view the custom hook holds in Actions, Additional Order (or Line) Information in the Sales Order window (Holds tab), the Name field is displayed with the hold name applied from the custom hook API; then Criteria field is displayed as Order, and Value field is displayed as Sales Order Number; and then the Criteria field is displayed as Custom Hook. The corresponding hold comment is displayed in the Hold Comment field as passed from the custom Hook, if any. The custom hook API OE_HOLDS_HOOK. CUSTOM_HOLDS has the handle of all  sales order header and line attributes via p_old_header_rec/p_header_rec and p_old_line_rec/p_line_rec respectively. 

When you create or update a sales order header, all the header attributes are available in p_header_rec/ p_old_header_rec. When you create or update a sales order line, all the line (and header) attributes are available in p_line_rec/ p_old_line_rec andp_header_rec  (same as p_old_header_rec). 

You can write your required condition based on the sales order header or sales order line entity. When writing each condition for an entity, you can utilise any available attributes. This is different from the Hold Source window, where a maximum of two attributes can be used. 

While assigning the Hold details when the custom logic is met, Hold Until Date is one of the optional value that can be assigned. In such cases, when hold until date becomes a past date earlier than the current date, such holds returned by the custom hook are ignored without displaying any message, and will not get applied on the corresponding entity, that is, sales order header or line. This is similar to the existing behavior on Hold Source created using the Create Hold Source window.

Hold Release

Oracle Order Management automatically releases holds when you supply a hold expiration date. Once the date is reached, the order can proceed along its workflow. Releasing a hold source releases all the orders, returns, and lines to which that hold source applied.

Note: You must set up and run the Release Expired Holds concurrent program on a regular basis to take advantage of the expiration date based release of holds.

If you can edit the sales order and or have a view-only access to sales orders but with the requisite authorization, then you can release orders that have been put on credit check hold.

Hold Security

Oracle Order Management enables you to control which responsibilities are able to define, apply, and remove holds.

Through the Oracle Order Management responsibilities and associated menus, you control who has the authority to define new holds or update existing ones. For each individual hold you define, you can also define which responsibilities have the authority to apply or release the hold. For example, you may have a quality hold that can be applied by any responsibility, but can be removed only by a Quality Assurance Supervisor responsibility.

Activity-Specific Holds

Oracle Order Management enables you to specify the activity that the hold prevents. For example, if your policy is not to commit raw materials to an order that has been placed on credit check hold, you would prevent the scheduling of the order line. There are two types of activity specific holds: Line Invoicing activity specific hold, where the workflow uses header level invoicing. All the lines will be placed on hold as the activity will be 'On Hold'. Header Invoicing activity specific hold is applied on the order, where the workflow uses line level invoicing. All the lines will be placed on hold as the hold is at order level.

Note: Header invoicing activity specific hold can be applied only at the order level. Similarly, Line Invoicing activity specific hold can be applied only at the line level.

Multiple Holds

Order Order Management enables you to apply as many different holds as you need on a single order, return, order line, or return line. If there are two or more holds on an order or order line, order processing will continue only after all holds are removed.

Sequential Display of Holds

When you query multiple holds in the Sales Orders window,Quick Sales Orders window, and Order Organizer window or in the HTML User Interface, the application sorts and displays the holds on the following basis:

  1. Unreleased or released holds

  2. Applied date and released date

  3. Line ID

Sequential Display of Holds at Header and Line Level

  1. Header Level:

    • Unreleased holds: On a sales order header, for both header-level and line-level holds, the application displays the unreleased header-level holds in descending order of applied date followed by the line-level unreleased holds by applied date. If multiple line level holds have the same applied date, then they are displayed in ascending order by line ID.

    • Released holds: Released holds follow the unreleased holds in the descending order by released date. Header-level released holds are displayed in descending order by released date.

      Then the application displays line-level released holds in descending order by release date. If multiple holds have the same released date, then the application displays them in ascending order by line ID.

  2. Line Level

    • If a sales order line has multiple holds, then the application displays the unreleased holds for that line in descending order by applied date, followed by the released holds for that line in descending order by released date.

Tracking and Viewing Holds

Oracle Order Management maintains a complete audit trail of holds applied or removed so you can track who applied or removed each hold, the date it was applied or removed, and why.

All holds sources can be viewed in the Order Organizer window and Sales Orders window. Use the Additional Order Information window or the Additional Line Information to see the status of your hold sources and how the hold affects the order's workflow. You can see the name of the hold, the level (such as customer, site, or item), the hold-until date, the release date, and who released the hold. If you are viewing a line, you see the holds for the line; if you are viewing an order, you see the holds for the order and for all of the lines.

In the Additional Order Information window and the Additional Line Information window, you can view the hold details such as the applied date, applied by, released date, released by, and release reason.

You can use the Outstanding Holds Report to review all active holds for a particular customer or item and evaluate the effect on customer service and revenue. You can also use the Hold Source Activity Report to review holds placed and removed for a particular hold source during a specified time period.

Select Additional Order Information from the Actions button and select Holds.

the picture is described in the document text

General Services Administration (GSA) Violation Hold

The GSA hold ensures that a specific group of customers always receives the best pricing. For example, in the United States, this customer group usually consists of government customers that purchase products from a list of pre-qualified suppliers. An order with the same discount level for any other customer outside the group is automatically placed on hold for further review.

Automatically Apply Order Holds

You can check orders for conformance with certain business metrics and automatically place holds against the order if they are violated. Business metrics include (but are not limited to):

The credit check failure hold and GSA violation hold are standard holds in Oracle Order Management. These holds are automatically applied if the order satisfies certain business rules.

Configurations

Lines that are part of an ATO Model, a Ship Together Model, or Included Item line will be shown as On Hold in the column Cascaded Hold in the lines and line summary blocks of the Sales Order Pad/Order Organizer.

The pick release does not release any part of a configuration if any order line within the configuration is on hold, unless the Ship Model Complete item attribute (for an order line item within the configuration) is set to No.

If Oracle Configurator is installed, then when you modify a configuration within a booked order, Oracle Configurator validates the new configuration and places the Configurator Validation Hold on invalid configurations to prevent further processing.

Configuration on Hold

the picture is described in the document text

Automatically Release Order Holds

You can automatically review the business metrics (or criteria) that caused the hold to be applied at activities in the order workflow. The appropriate holds should be released if the order or order line no longer violates the given business metric.

Note: Credit check failure hold and GSA violation hold are automatically released if the order or order line is updated and no longer violates the business rule due to which the hold was applied.

Returns

You can apply holds to returns similar to holds for orders. By placing the Check Holds activity in workflow corresponding to return processes, this stops the return processing if there are any holds on that specific return. Activity-specific holds can also be defined for activities used in returns workflow.

Approvals

You can use holds to prevent an approval notification from being sent. The Check Holds activity can be placed before the approval notification in the workflow and until the check holds activity is completed with a result of No Holds, the notification will not be sent.

Combination of Entities

You can apply a hold on a given item from being sold to a specific customer. This feature supports the various export requirements such as Table of Denial Orders and export licenses.

Oracle Order Management Implementation Manual, Defining Holds.

Applying Holds

Choosing Options Using the Oracle Configurator.

Applying Holds

Oracle Order Management provides you with the ability to apply holds to orders, returns, and lines in the Sales Orders window. In addition, you can apply holds for existing or future single or multiple orders, returns, and lines.

You can apply holds to orders, returns, order lines, return lines, or options. You can create hold sources to hold new orders automatically for a customer or to hold new lines for an item or customer site. You can set the hold source to be a specific order or return. A hold source is the combination of a parameter (for example, customer), value (ACME Inc.), and hold name that you specify. You can specify hold sources that use a combination of two parameters.

You can apply your holds to be effective immediately and universally. If you want to apply your hold specifically to certain orders, returns, order lines, or return lines, navigate to the Order Organizer window to indicate them individually.

Once you have created a hold source, you can release it from the Sales Orders window or Order Organizer.

Prerequisites

Define your holds. See: Oracle Order Management Implementation Manual, Defining Holds.

Workflow Activities based Holds

The following workflow activities can be put on hold provided their status is not completed:

Header Level:

Line Level:

The Ship-Line activity hold is not applied to the order line, if the order line has a Bill Only transaction type. However, the hold can be applied by the user manually.

The system checks for the transaction type of the order line, and verifies if the Bill Only checkbox is selected in the transaction type. If the transaction type is Bill Only, the hold will not be applied on the order line. Otherwise, if the transaction type is not Bill Only, the hold will be applied on the order line.

When you apply workflow item and workflow activity based hold on a single record, and the activity is already complete, the, following message is displayed:

Hold on workflow activity &WF_ACT is not applicable to this record.

When you select the Hold Existing Order Lines box in the Apply Holds window and apply a workflow item and workflow activity based hold on multiple records, where none of them are eligible for being on hold, the following message is displayed:

Hold on workflow activity &WF_ACT is not applicable to any of the selected records.

When you select the Hold Existing Order Lines box, and apply a workflow item and workflow activity based hold on multiple records, where some, but not all the records are eligible for being on hold, the following message is displayed:

Some of the selected records were not placed on workflow activity &WF_ACT hold due to ineligibility.

To view orders that are on hold:

You can use the Order Organizer Find Window to find orders or lines on hold, by specifying criteria in the Holds Information Tab.

To apply a hold to a single existing order or return:

  1. Navigate to the Sales Orders window and query the order or return you want to apply the hold.

  2. Click Actions and select Apply Hold.

  3. In the Apply Holds window, select the Hold Name in the Hold Name tabbed region.

  4. Optionally, define the Hold Until Date; that is, the date when the hold is released automatically.

  5. Optionally, enter a Hold Comment.

  6. Click Apply Holds.

    Apply Holds tab

    the picture is described in the document text

To apply a hold to multiple orders or returns:

  1. Navigate to the Order Organizer window and query the orders or returns or lines you want to apply the holds. If you have access to multiple Operating Units you can select transactions across them by leaving the Operating Unit field blank.

  2. Multi-select all orders and returns you want to apply the hold.

  3. Click Actions and select Apply Hold.

  4. In the Apply Holds window, select the Hold Name in the Hold Name tabbed region.

  5. Optionally, define the Hold Until Date; that is, the date when the hold is released automatically.

  6. Optionally, enter a Hold Comment.

  7. Click Apply Holds.

To apply a hold to a specific order line or return line:

  1. Navigate to the Sales Orders window and query the order or return line you want to apply the hold.

  2. Navigate to the Line Items tabbed region and select the order or return line you want to apply the hold.

  3. Click Actions and select Apply Hold.

  4. In the Apply Holds window, select the Hold Name in the Hold Name tabbed region.

  5. Optionally, define the Hold Until Date; that is, the date when the hold is released automatically.

  6. Optionally, enter a Hold Comment.

  7. Click Apply Holds.

To apply a hold to multiple order lines or return lines:

  1. Navigate to the Order Organizer window and query the order or return you want to apply the hold.

  2. Navigate to the Line tabbed region.

  3. Multi-select the lines you want to apply the hold.

  4. Click Actions and select Apply Hold.

  5. In the Apply Holds window, select the Hold Name in the Hold Name tabbed region.

  6. Optionally, define the Hold Until Date; that is, the date when the hold is released automatically.

  7. Optionally, enter a Hold Comment.

  8. Click Apply Holds.

See:

Oracle Order Management Implementation Manual.

Please refer to the Releasing Holdssection in this chapter.

Honor Holds at Repricing

Oracle Order Management provides holds on orders or order lines that are used by companies to minimize risks from their customers. These risks can include:

Overview of Honor Holds at Repricing

Ability to Create/setup a Hold to Hold Re-price Activity

You can place the reprice line workflow function any place (after booking, usually after shipping or fulfillment) in their order line workflow. This is a feature used by customers who have long lead times between order entry and shipping and customers who want to finalize their price list or discounts after an order line is entered.

You can define a reprice line workflow activity specific hold and apply it to the order lines you choose. After the pricing setup is finalized, you can release the hold and progress the order line.

Please note that when a hold is applied on the reprice activity, no messages are displayed to the user. Instead, the flow status will be displayed as Awaiting Reprice - On reprice line hold, this indicates that the line is on REPRICE LINE hold as it honors only REPRICE_LINE activity specific holds.

Note: For the orders that have the existing reprice line sub process, it will continue to use the original workflow definition. Therefore it would not honor holds. Repricing activity will not honor a generic hold. Repricing at shipment only honors repricing at shipment activity specific holds, not generic holds.

Workflows

Workflow branches include; complete, not eligible, on hold, and incomplete (which means errors). A new branch, when the result is On Hold, contains Reprice Eligible branch.

Using the Workflow Monitor for new orders that use the new workflow definition, you can see that the order is on hold. This is consistent with other Order Management workflow sub processes that recognize holds.

In the reprice line sub process, when the reprice function has a result of On Hold, it will branch to the Reprice - Eligible function so that it will appear in the Progress Order window.

Reprice Window

the picture is described in the document text

Honor Holds Procedures

To release a hold and progress the order:

  1. Navigate to the Order Organizer window.

  2. Query order lines that have the specific hold applied.

  3. Go to Actions > Release Holds to release this hold.

    Order Organizer Window - Actions Release Holds

    the picture is described in the document text

  4. Enter the Reason and Comments for releasing the hold.

    Release Holds Window

    the picture is described in the document text

  5. Click Release.

  6. Go to Actions > Progress Order to retry the reprice line workflow activity.

  7. Choose from the Eligible Activities and click OK.

    Note: If you copied the ‘reprice - line' process to put in your own workflow, you will need to change your sub-process or create a new workflow process to use the new reprice function.

Releasing Holds

Oracle Order Management provides you with the ability to release holds on orders, returns and lines and release hold sources. In addition, you can release holds for existing or future, single or multiple orders, returns, and lines.

You can release holds on specific orders, returns, or lines; release a hold source that holds many orders or lines; and view information about holds that you have already released. If a hold was defined with specific hold authorizations, you must be logged in as one of the responsibilities permitted to remove this hold. To release orders that have been put on credit check hold, you must have the ability to edit the sales order or have view-only access to sales orders with requisite release authorization.

After you release all order and order line or return and return line holds, that order or return becomes available for any subsequent workflow steps. If you release a hold source, the hold is automatically released for all appropriate orders, returns, or their lines. You can choose to progress the workflow or not, with the help of the Progress Workflow box on the Holds definition window and on the Release Holds window.

Holds can also be automatically released by submitting the Release Expired Hold concurrent program on or after the date that the hold source expires. This date is defined in the Hold Until Date field in the Release Hold Sources window. The Release Expired Hold concurrent program will release all holds by comparing the Hold Until Date to the current system date (timestamp is ignored).

Use the Find Orders window to select the orders, returns, lines, or hold sources to release. When you click Find, Order Management queries all the orders, returns, or lines that match your criteria and that are or have been on hold. When you click Hold Sources, Order Management queries hold sources that were created using the criteria you specify.

Progressing Workflow after releasing a Hold

Workflow Activity holds are based on activities that are also defined within the workflow. When a workflow activity hold is applied on a sales order/line, the corresponding workflow for the entity stays in a Blocked state until the hold is released. You can take one of the three actions at this point during the hold release:

The Progress Workflow on Release checkbox in the Holds definition window (Setup > Orders > Holds) enables you to automatically progress the workflow to the next activity when the hold is released. A similar checkbox is also available in the Release Holds window – Progress Workflow – and its value is defaulted from the value of the Progress Workflow on Release checkbox in the Holds definition window. By selecting or unselecting the Progress Workflow checkbox in the Release Holds window, you can override the setting defined in the Holds definition window. More details on the inter-relationship between the two can be found in the table below:

Holds with Progress Workflow
Holds definition window check box Release Holds window check box Single Line on Hold Multiple Lines on Hold
Checked Unchecked Do not progress the workflow Do not progress the workflow
Unchecked Checked Progress the workflow if eligible Complete the block activity and defer further workflow processing (if eligible).

When multiple lines are released together, it could have a significant impact on performance if they are progressed So the activities of the released lines are completed and further workflow processing is deferred so that the concurrent program Workflow Background Process can progress the lines together.

The workflow is eligible for processing via hold release when it satisfies the following conditions:

the picture is described in the document text

Note: This functionality is also applicable to custom activities, and not only seeded activities.

To view or release a hold source:

  1. Navigate to the Find Orders window in the Order Organizer.

  2. Enter search criteria, including the hold criteria and value or the name of the hold.

  3. Click Hold Sources to query the hold sources that meet your search criteria.

  4. Multi-select the orders or lines that you want to release.

  5. Select the Reason for the release.

To release a single existing order or return:

  1. Navigate to the Sales Orders window and query the order or return you want to release the hold.

  2. Click Actions and select Release Holds.

  3. Multi-select the holds that you want to release.

  4. Select the release Reason for the hold.

  5. Optionally, enter a Comment.

  6. Click the Release.

  7. Save your work.

To release a specific order line or return line:

  1. Navigate to the Sales Orders window and query the order or return line you want to release.

  2. Navigate to the Line Items tabbed region and select the order or return line you want to release.

  3. Click Actions and select Release Holds.

  4. Multi-select the holds that you want to release.

  5. Enter the Release name.

  6. Select the Reason for the release.

  7. Optionally, enter a Comment.

  8. Click Release.

  9. Save your work.

To release multiple orders or returns:

  1. Navigate to the Orders Organizer window and query the order or return you want to release.

  2. Multi-select all orders and returns you want to release.

  3. Click Actions and select Release Holds.

  4. Multi-select the holds that you want to release.

  5. Enter the Release name.

  6. Select the Reason for the release.

  7. Optionally, enter a Comment.

  8. Click Release.

  9. Save your work.

To release multiple order lines or return lines:

  1. Navigate to the Orders Organizer window and query the orders or returns or line you want to apply the holds. If you have access to multiple Operating Units you can select transactions across them by leaving the Operating Unit field blank.

  2. Navigate to the Line Items tabbed region.

  3. Multi-select the lines you want to release.

  4. Click Actions and select Release Holds.

  5. Enter the Release name.

  6. Select the Reason for the release.

  7. Optionally, enter a Comment.

  8. Click Release.

  9. Save your work.

To release multiple order lines or return lines for Expired Holds:

  1. Navigate to the Concurrent Request window.

  2. Enter or select Release Expired Hold in the Name field

  3. Click Submit.

See

Oracle Order Management Implementation Manual, Defining Holds.

Process Messages

Order Management provides the ability to view context information for all messages generated by Order Management to indicate which message corresponds to which record or transaction. This feature provides you with further detail of the messages you receive during order entry. The process message feature:

To query messages:

  1. Navigate to the Find Message window.

    Find Message Window

    the picture is described in the document text

  2. Select the Message Source.

    The message source determines which database the message resides.

  3. Enter the Request ID range for the message you want to query.

  4. Enter the Order Number range of the message you want to query.

  5. Enter the Request Date range of the messages you want to query.

  6. Select the Program Name of the message you want to query.

  7. Select the Workflow Activity for the message that has a workflow activity specified.

    The workflow activity refers to the actual stage of the order.

  8. Select the Order Type of the message you want to query.

  9. Select the Attribute. The default value is Null.

  10. Select the Customer Name or Number.

  11. Select the Requester.

  12. Click Find.

    Process Messages Window

    the picture is described in the document text

  13. Click Delete All to delete all queried messages.

    Note: The Request Date shown is the date the order or line was requested, not the Creation Date of the message. The Creation Date of a particular message can only be seen in Sql*Plus or by using the Examine utility (available from the Toolbar menu: Help, Diagnostics, Examine) within the Block multi_message in Process Messages window.

Sales Order Cancellation

Overview

Oracle Order Management provides the features you need to cancel sales orders, returns, internal orders, and service orders. The order cancellation feature of Order Management enables you to specify who has the authority to perform a cancellation request.

You can cancel entire orders or returns, or individual lines. A cancellation within Order Management is considered any reduction that occurs to existing order line quantity when an enabled processing constraint is invoked by an Order Management function during order processing. Therefore, any Order Management processing constraints you wish to use to control order quantity decrements must use the CANCEL operation.

If you choose to cancel sales orders or reduce existing order quantities, then Order Management attempts to perform the cancellation based upon the existing enabled Order Management processing constraints or user defined processing constraints. However, there can be certain points in order processing after which it is not logical or possible to cancel an order or line. For instance, you cannot cancel an order or line after it has been invoiced.

Order Management enables you to decide after which point lines can be cancelled, or after which point cancellation of lines needs to be prevented. You can define the cancellation point by enabling a constraint on operation Cancel, with "Require Reason and Require History" user action and a particular template such as "Entered" or "Booked". The particular template that you specify stands as the point after which reduction in quantity is considered cancellation and Order Management requires a reason for the change. However, if quantity is reduced before the line reaches the applicable cancellation point, then the application treats it as a mere reduction in quantity and not a cancellation.

Ensure that you define the cancellation point. Order Management provides "Booked" as the predefined cancellation point. The application treats attempts at both partial and complete cancellation prior to booking as changes of quantity and does not perform a cancellation. After booking, the application cancels the order or line and requires a reason at the time of cancellation.

Note: When you choose to cancel the remaining lines, an attempt is made to cancel all lines that are unfulfilled and unshipped on the order, however if one line fails to cancel then it would fail the entire operation. This is not intended to cancel lines that are cancellable.

Processing

Your processing constraints for orders and returns determine whether you can:

You can cancel:

Cancelling Partially:

Cancelling Completely:

You can cancel using:

You can require a reason for the cancellations based on the status of the order or line. For example, you may want to capture the reason for the cancellation if the line has been scheduled and may not require a reason if the line is booked. Reasons are defined in Quick Codes.

As long as an order is not subject to other restrictions that keep it from being cancelled, you can cancel an order:

An order or line cancelled will have a status of Cancelled, and a workflow status of Closed.

Processing Constraints

Use processing constraints against the CANCEL operation to:

To place the minimum restrictions on the cancellation process:

To record history for the cancellation, create processing constraints that require recording of history. The order processing includes the cancelled quantity in the history notation.

In addition to your processing constraints, there are system defined rules (system constraints) which forbid cancellation in certain instances. Oracle Order Management honors processing constraints which are stricter than the system constraints and ignores processing constraints which conflict with the system constraints: The system constraints forbid cancellation if:

Restrictions on canceling orders and lines

You can define processing constraints for cancellations. Depending on how you set up constraints, the system may or may not have a cancellation concept.

To set up a system without cancellation, define a system constraint that says cancel is not enabled after the line is shipped, and there are no user constraints. Decrementing is not allowed after the line is shipped, and all decrements in quantity before shipping will be treated as decrements, not cancellations. The reason for the change is recorded when provided by the user but it is not required for proper processing.

To use cancellation, you can define a system constraint that says cancel is not enabled after the line is shipped, and a user constraint that says cancellation requires a reason if the line is booked. Then, cancellation is not enabled if this line is picked. In this case:

Warning: You can prevent some responsibilities from cancelling, and you can enable some responsibilities to cancel if a reason is provided. This requires setting up two constraints.

Oracle Release Management (RLM) utilizes the processing constraints setup in Order Management (OM). Following two constraints are required for preventing order quantity update on pick released lines.

A request for decrease of order quantity on pick released lines will generate an exception message during demand processing. The order quantity will not be decreased. The request for increase in Order Quantity would insert a new order line with the incremental quantity.

If the CANCEL constraint is not setup, a quantity increase would result into insertion of a new delivery line but a quantity decrease would actually reduce the quantity on the pick released line.

The following processes describe enabling and disabling cancellation by responsibility.

To enable a responsibility to cancel when a reason is provided:

  1. Navigate to the Processing Constraints window in Oracle Order Management.

  2. Select the entity to be constrained.

  3. Select the operation to be constrained.

  4. Select the action to be taken if this constraint occurs.

  5. Enter the constraining conditions.

  6. Enter the responsibility constrained from performing this operation.

  7. Save the constraint.

    To prevent a responsibility from cancelling:

    Navigate to the Processing Constraints window in Oracle Order Management.

    1. Select the entity to be constrained.

    2. Select the operation to be constrained.

    3. Enter the constraining conditions.

    4. Select the responsibilities authorized to perform this operation.

    5. Save the constraint.

Cancelling Orders

Oracle Order Management Implementation Manual, Overview of Processing Constraints.

Oracle Order Management Implementation Manual, Defining Processing Constraint, Order Management Processing Constraints Listing Appendix.

Special Considerations for the Cancel function

Configurations

You can cancel:

You cannot cancel:

If you use either Oracle Configurator or the Order Management Options window to create configurations:

Included Item Partial Cancellation

Included items are automatically cancelled when you cancel the kit or model with which they are associated. If you have shipped some included items before their corresponding kit, class, or model and you attempt to cancel the kit, class, or model, Oracle Order Management automatically cancels the remaining included items. However, if you have shipped some required-for-revenue included items, your cancel quantity allowed on the included items' parent may be restricted to allow you only to cancel a parent quantity that includes whole ratios of any remaining required-for-revenue included items.

Returns

You cannot cancel the received quantity of a return line. Since return processing splits a partially received line, you can cancel the unreceived quantity portion of a line.

For returns of pick-to-order items, cancelling the model does not cancel the complete configuration because the return configuration is in individual return lines. To cancel a complete configuration, cancel the model line, option class lines, option item lines and included item lines.

Internal Sales Orders

Service Orders

When cancelling service orders and lines:

Drop Shipments

If you cancel a drop shipment line for which you have not shipped the entire quantity, the order processing splits the line. The first line contains the quantity shipped and the second line contains the non-shipped quantity in backorder. You can cancel the second line.

While cancelling multiple drop ship lines, the application does not cancel any of the lines if cancellation of all the related purchase orders fails. However, if any such purchase order is cancelled successfully, then the application cancels all the selected drop ship lines. In this case, Order Management delinks, from itself, the purchase orders that cannot be cancelled.

Cancelling Orders

Oracle Order Management Implementation Manual, Defining Order Management QuickCodes

Cancelling Orders

You can cancel sales orders, order lines, returns, and return lines. Order Management automatically adjusts reservations for cancelled lines.

If you want to cancel an entire order, you need to do so before any of the order lines are shipped, or invoiced. If you want to cancel an entire return, you need to do so before you run RMA Interface or Invoicing Activity on any of the return lines.

If you do not have permission to cancel, contact someone who has permission to cancel and notify them of your request.

Prerequisites

To cancel an entire order or return:

  1. Navigate to the Order Organizer window and query the order or return you want to apply the cancellation to.

    If you wish to cancel a group of orders or returns, use the multi select features of the mouse or the corresponding keyboard short cut keys to multi select the orders or returns you wish to cancel.

  2. Click Actions.

  3. Select Cancel.

    Cancel Order(s) Window

    the picture is described in the document text

  4. Select the reason why you are cancelling the order.

  5. You must enter a reason if you want to cancel the entire order or return.

  6. Optionally, enter any Comments

  7. Select OK.

    Selecting the OK button performs the order or return cancellation and saves your changes. This step is irreversible.

  8. Acknowledge messages.

  9. Requery the order to verify the changes.

To cancel an order line or return line:

  1. To cancel the lines on one order, do one of the following:

    • Navigate to the Sales Orders form, query the order, move to the Line Items tabbed region, and select a line or multi-select the lines to cancel

    • Navigate to the Order Organizer, query the order, move to the Lines tabbed region, and select a line or multi-select lines to cancel

      To cancel multiple orders, navigate to the Order Organizer, query the orders, move to the Lines tabbed region, and multi-select the lines to cancel.

  2. Click Actions.

  3. Select Cancel.

    Note: If you try to cancel a quantity for a line that would violate your processing constraints, you get a message telling you which processing constraint is preventing you from cancelling that line.

  4. Select the Reason why you are cancelling the line.

  5. Optionally, enter any Comments.

  6. Select OK to cancel the order line or return line.

    Warning: Choosing OK performs the cancellation and saves your changes. This step is irreversible.

To cancel order or return lines by reducing the quantity:

  1. Navigate to the Sales Order window, query the order, and move to the Line Items tabbed region, and select the line to cancel.

  2. In Qty, enter zero.

  3. In Reason, select the cancellation reason.

  4. Click OK.

  5. Acknowledge messages.

  6. Requery the orders to verify the changes.

To mass cancel order and return lines:

  1. Navigate to the Order Organizer window, query the lines, and multi-select them.

  2. Navigate to the Line Mass Change window

  3. In Qty Ordered, enter zero.

  4. In Change Reason, select the cancellation reason.

  5. Select OK.

  6. Acknowledge messages.

  7. Requery the orders to verify the changes.

See

Cancelling Orders

Oracle Order Management Implementation Manual, Defining Order Management QuickCodes

Oracle Order Management Implementation Manual, Defining Processing Constraints.

Function Security for Orders and Returns

Use function security to control user access to functions in the Order Organizer and Sales Orders window. Your system administrator customizes a responsibility at your site by including or excluding functions and menus in the Responsibilities window.

The form functions listed below are available by default, but may be excluded from menus tied to restricted responsibilities:

If you exclude both Sales Orders, Order Organizer, and Order Organizer View from a responsibility, that responsibility's users can neither access the Sales Orders window by selecting from the Navigator menu nor query orders from the Orders Organizer. If you exclude all three functions, you should also remove the Orders, Returns menu item from the Navigator.

Additionally, utilizing standard form functional security, you can restrict actions that a users can perform in the Sales Order window by adding or removing these functions from the menu associated with a responsibility. Below lists the following actions that can be restricted using this feature.

Apply Holds

Authorize Payment

Book Order

Calculate Tax

Cancel Orders

Charges

Configurations (Link, Delink, Match & Reserve)

Copy Orders

Gross Margin

Mass Change

Send Notifications

Price Orders

Progress Order

Release Holds

Sales Credits

Schedule Orders

Function Security Example

Your company employs some individuals whose tasks include viewing orders and returns. They do not enter orders or returns.

  1. Navigate to the Responsibilities window.

  2. Query an existing responsibility whose functionality you want to limit, or define a new one.

  3. In the Function and Menu Exclusions block, choose Function as the type of exclusion rule to apply against the responsibility.

  4. Select Sales Orders and Order Organizer as the name of the function.

  5. Save your work.

  6. Assign users to the responsibility.

    See: Oracle E-Business Suite System Administrator's Guide Documentation Set

Close Orders

Closing orders that are complete enhances performance, since many programs, windows and report queries retrieve open orders only. Orders marked as closed are not selected, increasing system speed and efficiency. Closed orders are excluded from many of the standard reports available in Order Management, so you can limit your reporting to the active orders you want. You can, however, view the configuration options for the closed orders in View Only mode.

Close lines and close orders are implemented using workflow. Order Management provides seeded close line and close order workflow sub-processes to close the order header and line, respectively. These processes, when included in the order header or line workflow, closes the status of the eligible order or lines. After an order is closed, no lines can be added.

The order header close order process checks at the end of every month to view all the lines associated with it are closed. It closes the order header if it finds that all the lines are closed.

Warning: Be sure to include the standard sub-processes of close line and close order at the end of all the line and order flows to ensure that the orders and returns close once all prerequisites have been met.

During order line and order header closure phases, the application raises the business event oracle.apps.ont.oip.statuschange.update if profile OM: Raise Status Change Business Event is set to Yes.

Close Order Lines

An order line is eligible to close when it completes all of the line-level activities within the workflow process. Order lines can close independently of each other. No changes can be made to order information after the order line is closed.

Holds Effect on Eligible Lines

The Close Order and Close Line workflow activities will close order or lines if only generic holds are present. If orders or lines have activity specific holds present, they will not be closed by the workflow activity.

Spreadsheet Upload using Desktop Integration Framework (WebADI)

Using Web ADI, users can upload spreadsheets to create or update orders and quotes. This functionality also enables users to create new lines for existing orders and quotes, or update existing lines for orders and quotes. The Upload from Spreadsheet action is available in the following windows:

When the Upload from Spreadsheet action is clicked, the Create Document page appears. Users can select the document type they want to create using the Primary Parameters and Content Parameters regions.

The Primary Parameters region enables users to select from the following mandatory and optional parameters:

If users select the Upload from Spreadsheet action for an order, the displayed Excel spreadsheet shows the order and all line details.  If users select the Upload from Spreadsheet action for an order line, the displayed Excel spreadsheet shows the order and the selected line details. 

If no order or line is selected for the action, the spreadsheet displays blank content. Users can enter input data manually, that will create a new order. Note that multiple selection of orders or lines cannot be done.

After the changes to the spreadsheet, users click the Upload button in the Oracle tab to transfer the data from the Excel spreadsheet to the tables. The Spreadsheet Upload concurrent program is submitted, which submits a child Order Import concurrent program. The child Order Import concurrent program  validates the data, and then creates or updates the order.

For more information on the profile option OM: Price Adjustment Modifier for Spreadsheet Order Lines, see: Order Management Profile Option Descriptions and Settings, Oracle Order Management Implementation Manual.

Entering User Defined Attributes

Oracle Order Management enables you to record additional information at order and line levels using user defined attributes (UDA). Recording user defined attributes triggers a change-attribute business events.

Use the User Defined Attributes page at order header and line levels to enter the UDA information that you have set up.

Click Actions, and then click User Defined Attributes.

See Setting Up User-Defined Attributes, Oracle Order Management Implementation Manual for information about how to set up user defined attributes.

Using the User Defined Attributes Corrections Page

Oracle Order Management provides the User Defined Attributes Corrections page to create, view, update, and delete user defined attributes (UDA) interface data for sales order header and line entities. You can also use this page to validate UDA data before running the Import User Defined Attributes concurrent process and to correct errors or unprocessed data before running the concurrent process again. See: Validating and Correcting Errors.

To access the User Defined Attributes Corrections page:

  1. Navigate to the User Defined Attributes Corrections page using the Order Management Super User responsibility.

  2. Click Orders*Returns.

  3. Click Import Orders.

  4. Click UDA Corrections to open the User Defined Attributes Corrections page.

This page has the following tabs:

Using the Order Header Extensions Page

Use the Order Header Extensions page to view, create, update, and delete the user defined attributes interface details for order header entities.

The Order Headers tab has a search and results table regions. To search for and filter the data, use the criteria described in the following table:

Order Header Search Criteria
Field Description
Operating Unit ID This is an independent list of values. By default, this value is set to the Operating Unit ID based on the user's organization context. You can change the default value.
Data Set ID Enter text to search.
Order Source ID This is an independent list of values.
Order Reference This is a dependent list of values based on the values that you select in the Operating Unit ID and Order Source ID fields.
Sold to Org ID This is a dependent list of values based on the values that you select in the Order Source ID and Order Reference fields.
Operation Code This is a list of values with the options: Create, Delete, Sync, and Update.
Error Flag This is list of values with the options Yes and No.

The result table displays the UDA details for the order header entity interface information based on the search criteria.

Using the Order Line Extensions Page

Use the Order Line Extensions page to view, create, update, and delete order line user defined attributes interface details.

The Order Lines tab has a search region and results table region. To search for and filter the data, use the criteria described in the following table:

Order Line Search Criteria
Field Description
Operating Unit ID This is an independent list of values. By default, this value is set to the Operating Unit ID based on the user's organization context. You can change the default value.
Data Set ID Enter text to search.
Order Source ID This is an independent list of values.
Order Reference This is a dependent list of values based on the values that you select in the Operating Unit ID and Order Source ID fields.
Order Line Reference This is a dependent list of values based on the values that you select in the Operating Unit ID, Order Source ID, and Order Reference fields.
Sold to Org ID This is a dependent list of values based on the values that you select in the Order Source ID, Order Reference, and Order Line Reference fields.
Operation Code This is a list of values with the options: Create, Delete, Sync, and Update.
Error Flag This is list of values with the options Yes and No.

The result table displays the UDA details for the order line entity interface information based on the search criteria.

Validating and Correcting Errors

To process the data from the interface tables, run the Import User Defined Attributes program. If the import process has errors, then the results table displays the unprocessed records. You can view and correct these records using the User Defined Attributes Corrections page.

If a processed record has errors, then the Error Flag column in the results table displays Yes. Click the Yes link to view the error message. You can then correct the unprocessed or error record, and submit the Import User Defined Attributes program again to reprocess the data until there are no errors.

Related Topics

Correcting User Defined Attributes Interface Data

Correcting User Defined Attributes Interface Data

Use the User Defined Attributes Corrections page to create, read, update, and delete sales order header and line entity user defined attributes (UDA) interface data.

To correct user defined attributes interface data

  1. Login using the Oracle Order Management Super User responsibility.

  2. Click Order*Returns, and then click Import Orders.

  3. Click UDA Corrections to open User Defined Attributes Corrections page.

  4. Enter search criteria to find details of the sales order header and line entity UDA interface data from the interface tables.

  5. Run the Import User Defined Attributes concurrent program to process the data. The process validates and imports the UDAs.

  6. Search for the sales order header or the line entity.

  7. Enter Yes in the Error Flag field to find records with errors.

  8. In the results table, click the Yes link in the Error Flag column to view error details for each record.

  9. Correct the record and save.

  10. Run the concurrent program again to reprocess the data. If the process finishes without any errors, the data gets cleared from the interface tables.

Related Topics

Using the User Defined Attributes Corrections Page

Viewing Approval Notifications

You can use the View Notification Details action to view the approval notifications.

To view notification details

  1. Navigate to the Sales Orders window.

  2. Select the applicable sales order.

  3. Click Actions, and then select View Notification Details.

    An individual notification displays for an order with a single approval.

    The Worklist Approval page appears with a list of approval notifications for an order that has multiple approvals.