Order Orchestration Preference Overrides

Purpose: Use this screen to work with overrides to the Order Orchestration Settings for your organization, set up at the Preferences screen. These preference settings control the ranking of fulfilling or sourcing locations for order assignment, or the sort order of fulfilling or sourcing locations returned in the locate items message.

Example: You can have the Routing Engine rank locations for a pickup request based first on proximity, while it ranks locations for a delivery request based first on available quantity.

Criteria that you can override:

  • If weighted brokering is not enabled: If the Use Weighted Brokering Rules setting at the Preferences screen is not selected at the Preferences screen, the settings you can override are the Order Orchestration criteria of Proximity, On Hand Count, Location Priority, Last Order Assigned, and Sales Velocity. The Routing Engine uses these criteria when selecting the fulfilling or sourcing location for an order or responding to a locate items or product availability request.
  • If weighted brokering is enabled: If the Use Weighted Brokering Rules setting at the Preferences screen is selected, the settings you can override are the Order Orchestration criteria of Labor Cost, Gross Margin, Proximity, On Hand Count, Sales Velocity, and Priority. The Routing Engine uses these criteria when selecting the fulfilling or sourcing location for an order or responding to a locate items or product availability request.

For more information: See the Fulfillment Tab at the Preferences screen for background.

Inherit from Preferences? This screen displays all possible overrides, which are created automatically when you create and set preferences for systems that can originate orders; however, each is set, by default, to inherit the settings from the Preferences screen. Changing an override is optional, and unless you make a change, the Routing Engine uses the default preference settings. If you do change an override, you can change it back to the default settings at any time.

Types of overrides: There is a separate override available for each combination of order type, originating system, and express carrier setting:

  • order type or search type of Delivery, Pickup or Ship For Pickup
  • Indicates how the order should be fulfilled: shipped directly to the customer (delivery order), picked up at a specified location (pickup order), or transferred from a sourcing location to a pickup location (ship-for-pickup order)
  • Based on:
    • the order type specified in the SubmitOrder request for a new order
    • the order type assigned to an existing delivery or ship-for-pickup order that is rejected by the fulfilling, sourcing, or pickup location, so that the Routing Engine searches for another location
    • the fulfillment type specified for a locate items or product availability request
  • originating system:
    • This is the system that originally submits the order; or, in the case of the locate items message, this is the system submitting the search request.
    • The Routing Engine always uses the override setting for the originating system when routing an order, even if the order has been rejected, and it is finding another fulfilling location (“reshopping” the order).

      Note:

      There is no override available for the default vendor system, since this system never originates orders, locate items requests, or product availability requests to the Routing Engine.
  • Express carrier:
    • Based on the Express setting for the carrier on a delivery or ship-for-pickup order.
    • If there is no carrier specified in the SubmitOrder message for a delivery or ship-for-pickup order, the Routing Engine uses the override setting based on the Express setting for the Default Carrier specified at the Preferences screen. The default carrier’s setting also applies for locate items and product availability requests with fulfillment types of DELIVERY or SHIPFORPICKUP.

      Note:

      The option to condition by express carrier does not apply to a pickup order.

Summary of possible combinations per system: For each system in the organization that can submit sales orders, the following override combinations are created automatically with the settings inherited from the Preferences screen:

  • Delivery, Express carrier
  • Delivery, not Express carrier
  • Pickup
  • Ship-for-pickup, Express carrier
  • Ship-for-pickup, not Express carrier

Pickup location preferences: When the Routing Engine receives a web service request searching for locations that could fulfill a pickup order:

  • If Use Weighted Brokering Rules is unselected: The LocateItems response uses Standard Brokering rules from the Preferences screen, while the Product Availability response lists the locations in order of proximity.
  • If Use Weighted Brokering Rules is selected: Both the LocateItems response and the Product Availability response list the locations in order of proximity.

Note:

Because the Standard Brokering Rules never apply to searches for pickup orders when Use Weighted Brokering Rules is selected, the Browse Order Orchestration Preference Override window does not display any preference rules for a pickup order type. Although you can work with the Standard Brokering Rules at the Edit Order Orchestration Preference Override screen, these settings are never used if you use weighted brokering.

Vendor system? Since the default vendor system cannot submit sales orders or search for product availability, it does not have preference overrides.

Store Connect system? Typically, overrides set for the Store Connect system are not used, since Store Connect does not create orders.

Used for the Routing Engine module.

How to display this screen: Select Preference Override from the Home Screen or from the Locations Menu. You must complete the Preferences screen for an organization before you can work with overrides.

Note:

  • Available if Use Routing Engine is selected at the Tenant screen.
  • You can work with preference overrides only if you have completed the Preferences screen for the organization.
  • When you create an organization, you need to first select Save at the Preferences screen in order to create the override combinations to display at this screen. Saving preferences is required before you can submit locate items requests and orders to the Routing Engine.
  • Only users with Order Orchestration Preference Overrides authority can display this screen. See Roles for more information.

Options at this screen

Option Procedure
search for a preference override for an order type, originating system, and express carrier setting combination

Your Default Organization, defined through the Users screen, is selected by default, and the overrides associated with that organization are displayed. Use any combination of the fields at the top of the screen to restrict the search results to matching overrides:

  • Optionally, select a different organization from the Organization drop-down box to restrict your results to this organization.

    Note:

    You can also select a blank organization to remove this field from your selection criteria.
  • Optionally, select an Order Type to restrict your results to overrides for that order type. You can select an order type of Pickup, Delivery, or Ship For Pickup.
  • Optionally, select an Originating System to restrict your results to overrides for that system. You can set up overrides for any system for the selected organization, provided it is not the default vendor system, since this system cannot originate sales orders.
  • Click Search.
change the settings for an override based on order type, originating system, and express carrier setting combination, or change the combination back to inherit the settings from the Preferences screen

Select the edit icon (Illustrates the edit icon.) to advance to the Edit Order Orchestration Preference Override screen.

Note: You cannot delete the override settings. Leave the settings flagged to inherit the default in order to have the combination using the same sort criteria as those specified at the Preferences screen.

review the settings for an override based on order type, originating system, and express carrier setting combination

Highlight an override by clicking it in order to open the Browse Order Orchestration Preference Override window.

Fields at this screen

Field Description
Search/new fields:
Organization

See organization. From the Default Organization defined through the Users screen, but you can override it.

Order Type

Optionally, select an order type and click Search to display overrides that match your selection. Possible order types are:

  • Pickup
  • Delivery
  • Ship For Pickup

To determine the order type, the Routing Engine uses:

  • SubmitOrder requests: the transaction_type_id
  • LocateItems requests and ProductAvailability requests: the fulfillment_type
  • “reshopping” a rejected order: the order type of the rejected order
Originating System

Optionally, select an originating system and click Search to display overrides that match your selection. Each system in the selected organization is available for selection, excluding any system flagged as the vendor default.

Results fields:
Organization

See organization.

Order Type

Indicates the order type that is subject to the override. Possible order types are:

  • Delivery
  • Pickup
  • Ship For Pickup

To determine the order type, the Routing Engine uses:

  • SubmitOrder requests: the transaction_type_id
  • LocateItems requests or ProductAvailability requests: the fulfillment_type
  • “reshopping” a rejected order: the order type of the rejected order
Originating System

Indicates the system that originates the order, locate items request, or product availability request that is subject to the override. The vendor default system is not displayed, since it cannot originate sales orders.

Express Carrier

A green check (Illustrates the green check icon.) indicates that delivery,and ship-for-pickup orders are subject to the override only if the Express setting is selected. The Routing Engine determines the Express setting for a request by:

  • Submit order requests: the ship_via, if specified in the request; otherwise, the setting of the Default Carrier specified at the Preferences screen
  • Locate items requests and product availability requests: the setting of the Default Carrier specified at the Preferences screen
  • “Reshopping” a rejected order: the setting of the carrier on the rejected order

This setting does not apply to pickup orders.

Inherit from Preferences

A green check (Illustrates the green check icon.) indicates the Routing Engine is currently set to use the default settings from the Preferences screen rather than an override.

Edit

Select the edit icon (Illustrates the edit icon.) next to an override to advance to the Edit Order Orchestration Preference Override screen.

Edit Order Orchestration Preference Override

Purpose: Use the Edit Order Orchestration Preference Override screen to review or update preference overrides that apply to an order type and originating system. In the case of a delivery or ship-for-pickup order, the Routing Engine also uses the override only if the Express setting is consistent with the carrier on the order.

For more information: See the Order Orchestration Preference Overrides screen for a discussion.

Used for the Routing Engine module.

How to display this screen: Click the edit icon (Illustrates the edit icon.) for an override at the Order Orchestration Preference Overrides screen.

  • Available if Use Routing Engine is selected at the Tenant screen.
  • Only users with Order Orchestration Preferences Overrides authority can display this screen. See Roles for more information.
  • If Use Weighted Brokering Rules is selected at the Preferences screen, the Weighted Percentages are displayed; otherwise, the fields from the Standard Brokering tab at the Preferences screen are displayed.
  • If the Edit Order Orchestration Preference Override screen was already open in another tab when you clicked the edit icon, you advance to this screen with the previously-selected override displayed.

Pickup location preferences: When the Routing Engine receives a web service request searching for locations that could fulfill a pickup order:

  • If Use Weighted Brokering Rules is unselected: The LocateItems response uses Standard Brokering rules from the Preferences screen, while the Product Availability response lists the locations in order of proximity.
  • If Use Weighted Brokering Rules is selected: Both the LocateItems response and the Product Availability response list the locations in order of proximity.

Note:

Because the Standard Brokering Rules never apply to searches for pickup orders when Use Weighted Brokering Rules is selected, the Browse Order Orchestration Preference Override window does not display any preference rules for a pickup order type. Although you can work with the Standard Brokering Rules at the Edit Order Orchestration Preference Override screen, these settings are never used if you use weighted brokering

Updating override settings

To set up an override from the default Preference settings:

  1. Unselect the Inherit from Order Orchestration Preferences flag to make the remaining fields enterable.
  2. Edit the preference settings. See the Fulfillment Tab at the Preferences screen for background.
  3. Select Save when you are done.

Set back to inheriting defaults: To change the override to go back to the default preference settings, select the Inherit from Order Orchestration Preferences flag and select Save.

Fields at this screen

Field Description
Informational fields:
Organization

The organization associated with the originating system. Display-only. The organization code and name are displayed, separated by a hyphen (-).

Originating System

The system originating the order or the product search request subject to the override. Display-only. The system code and description are displayed, separated by a hyphen (-).

  • This is the system that originally submits the order; or, in the case of a locate items or product availability request message, this is the system submitting the request.
  • The Routing Engine always uses the override setting for the originating system when routing an order, even if the order has been rejected, and it is finding another fulfilling or sourcing location (“reshopping” the order).
Order Type

The order type subject to the override. Possible order types are:

  • If ship-for-pickup is not enabled:

    • Pickup: customer picks up the order at a specified location

    • Delivery: order ships directly to the customer

    • Ship For Pickup: merchandise is transferred from a sourcing location to a pickup location, and the sourcing location and pickup location can both be different from the placed (originating) location

The Routing Engine determines the order type for an override based on:

  • the order type specified in the submit order request for a new order
  • the order type assigned to an existing delivery or ship-for-pickup order that is rejected, so that the Routing Engine searches for another location
  • the fulfillment type specified for a locate items request or product availability request
Express Carrier

Indicates whether an order needs to use an express carrier to be subject to the override. Display-only. Possible settings are:

  • Y:

    • Orders that specify an express carrier are subject to the override if they match the Order Type (delivery or ship-for-pickup orders only)

    • If the Default Carrier specified at the Preferences screen has the express carrier selected and the order matches the Order Type, this carrier’s setting applies, so that delivery or ship-for-pickup order requests that do not specify a carrier are subject to the override, as well as locate items requests with delivery or ship-for-pickup transaction types

  • N:

    • Orders that do not specify an express carrier are subject to the override if they match the Order Type (delivery or ship-for-pickup orders)

    • If the Default Carrier specified at the Preferences screen does not have the express carrier selected and the order matches the Order Type, this carrier’s setting applies, so that delivery or ship-for-pickup order requests that do not specify a carrier are subject to the override, as well as locate items requests with delivery or ship-for-pickup order transaction types

      Note:

      The Express Carrier flag is always set to N when the Order Type is Pickup.
Order Orchestration Preference Override
Inherit from Organization and Preferences

Possible settings:

  • Selected (default): the Order Orchestration settings specified at the Preferences screen apply to this originating system, order type, express carrier type combination, and the current settings are displayed below
  • Unselected: the override settings specified at this screen apply to this originating system, order type, and express carrier type combination

For more information: For a discussion on the following fields, see the Standard Brokering Tab in the Preferences help topic.

Note:

The following fields, which control standard brokering, are displayed only if Use Weighted Brokering Rules is not selected at the Preferences screen; otherwise, the fields from the Weighted Brokering Tab are displayed.
Proximity

See Proximity.

On Hand Count

See On Hand Count.

Location Priority

See Location Priority.

Last Order Assigned

See Last Order Assigned.

Sales Velocity Rank

See Sales Velocity Rank.

Weighted Percentages

Displayed only for delivery or ship-for-pickup orders, and only if Use Weighted Brokering Rules is selected at the Preferences screen.

Labor Cost

See Labor Cost.

Gross Margin

See Gross Margin.

Proximity

See Proximity.

On Hand Count

See On Hand Count.

Sales Velocity

See Sales Velocity.

Priority

See Priority.

Total Weights

See Total Weights.

Browse Order Orchestration Preference Override

Purpose: Use the Browse Order Orchestration Preference Override window to review the Order Orchestration criteria overrides that apply to a particular order type and express carrier setting for an originating system.

Used for the Routing Engine module.

How to display this window: Click to highlight an Order Orchestration preference override at the Order Orchestration Preference Overrides screen.

Used for the Routing Engine module.

Note:

  • Available if Use Routing Engine is selected at the Tenant screen.
  • You can work with preference overrides only if you have completed the Preferences screen for the organization.
  • When you create an organization, you need to first select Save at the Preferences screen in order to create the override combinations to display at this window.
  • If Use Weighted Brokering Rules is selected at the Preferences screen, the Weighted Percentages are displayed; otherwise, the fields from the Standard Brokering tab at the Preferences screen are displayed.
  • Only users with Order Orchestration Preference Overrides authority can display this window. See Roles for more information.

Pickup location preferences: When the Routing Engine receives a web service request searching for locations that could fulfill a pickup order:

  • If Use Weighted Brokering Rules is unselected: The LocateItems response uses Standard Brokering rules from thePreferences screen, while the Product Availability response lists the locations in order of proximity.
  • If Use Weighted Brokering Rules is selected: Both the LocateItems response and the Product Availability response list the locations in order of proximity.

Note:

Because the Standard Brokering Rules never apply to searches for pickup orders when Use Weighted Brokering Rules is selected, the Browse Order Orchestration Preferences window does not display any preference rules for a pickup order type. Although you can work with the Standard Brokering Rules at the Edit Order Orchestration Preference Override screen, these settings are never used if you use weighted brokering.

Options at this window

Option Procedure
review the next order type, originating system, and express carrier setting combination subject to Preference overrides

Click the next icon (Illustrates the next icon.) to display the next combination subject to Preference overrides.

review the previous order type, originating system, and express carrier setting subject to Preference overrides

Click the previous icon (Illustrates the previous icon.) next to display the previous subject to Preference overrides.

edit the current order type, originating system, and express carrier setting’s Preference overrides

Select Edit to advance to the Edit Order Orchestration Preference Override screen.

Fields at this window

Note:

All fields at this window are display-only.
Field Description
Informational fields:
Organization

The organization associated with the originating system. The organization code and name are displayed, separated by a hyphen (-).

Originating System

The system originating the order or the product search request subject to the override. The system code and description are displayed, separated by a hyphen (-).

  • This is the system that originally submits the order; or, in the case of a locate items or product availability request message, this is the system submitting the request.
  • The Routing Engine always uses the override setting for the originating system when routing an order, even if the order has been rejected, and it is finding another fulfilling or sourcing location (“reshopping” the order).
Order Type

The order type subject to the override. Possible order types are:

  • If ship-for-pickup is not enabled:
  • Pickup: customer picks up the order at a specified location
  • Delivery: order ships directly to the customer
  • Ship For Pickup: merchandise is transferred from a sourcing location to a pickup location, and the sourcing location and pickup location can both be different from the placed (originating) location

The Routing Engine determines the order type for an override based on:

  1. the order type specified in the submit order request for a new order
  2. the order type assigned to an existing delivery or ship-for-pickup order that is rejected, so that the Routing Engine searches for another location
  3. the fulfillment type specified for a a locate items request or product availability request
Express Carrier

Indicates whether an order needs to use an express carrier to be subject to the override. Possible settings are:

  • Y:
  • Orders that specify an express carrier are subject to the override if they match the Order Type (delivery or ship-for-pickup orders only)
  • If the Default Carrier specified at the Preferences screen has the express carrier selected and the order matches the Order Type, this carrier’s setting applies, so that delivery and ship-for-pickup order requests that do not specify a carrier are subject to the override, as well as locate items requests with delivery or ship-for-pickup transaction types
  • N:
  • Orders that do not specify an express carrier are subject to the override if they match the Order Type (delivery or ship-for-pickup orders only)
  • If the Default Carrier specified at the Preferences screen does not have the express carrier selected and the order matches the Order Type, this carrier’s setting applies, so that delivery or ship-for-pickup order requests that do not specify a carrier are subject to the override, as well as locate items requests with delivery or ship-for-pickup transaction types

Note: The Express Carrier flag is always set to N when the Order Type is Pickup.

Order Orchestration Preference Override
Inherit from Organization and Preferences

Possible settings:

  • Selected (default): the Order Orchestration settings specified at the Preferences screen apply to this originating system, order type, express carrier type combination, and the current settings are displayed below
  • Unselected: the override settings specified at this screen apply to this originating system, order type, and express carrier type combination
 

For more information: For a discussion on the following fields, see the Standard Brokering Tab in the Preferences help topic.

  • The following fields, which control standard brokering, are displayed only if Use Weighted Brokering Rules is not selected at the Preferences screen; otherwise, the Weighted Percentages are displayed.
  • If Use Weighted Brokering Rules is selected, both the LocateItems response and the Product Availability response list the locations in order of proximity. Because the Standard Brokering Rules never apply to searches for pickup orders when you use weighted brokering, no preference rules are displayed for a pickup order type.
Proximity

See Proximity.

On Hand Count

See On Hand Count.

Location Priority

See Location Priority.

Last Order Assigned

See Last Order Assigned.

Sales Velocity Rank

See Sales Velocity Rank.

Weighted Percentages

Displayed only for delivery or ship-for-pickup orders, and only if Use Weighted Brokering Rules is selected at the Preferences screen.

Labor Cost

See Labor Cost.

Gross Margin

See Gross Margin.

Proximity

See Proximity.

On Hand Count

See On Hand Count.

Sales Velocity

See Sales Velocity.

Priority

See Priority.

Total Weights

See Total Weights.