Edit Location

Purpose: Use the Edit Location screen to work with a location, including the address, telephone numbers, and other related information such as the store rank and hours.

Location relationships: See Data Hierarchy for an overview of the Order Broker organization, system, and location hierarchy. Also, see the Locations screen for more information on how locations are created in Order Broker.

Location address: It is important that the location address be accurate, since the location address is used as the ship-to address for ship-for-pickup orders.

Updated how? The location information displayed at this screen can be updated by:

a periodic refresh from an external system (such as product import processing from Order Management System, or an import from OCDS); see Importing Locations through File Storage API or OCDS Imports
entry at this screen

How to display this screen: Click the edit icon () for a location at the Locations screen.

Note:

Only users with Locations authority can display this screen. See the Role Wizard for more information.
If the Edit Location screen was already open in another tab when you clicked the edit icon, you advance to this screen with the previously-selected location displayed.
When you create or update locations through an import, entries you make at this screen may be overwritten the next time the import runs.

Updating a location

Update any of the fields described below and click Save, or click Cancel to return to the Locations screen without making any changes.

Note:

Any changes you make at this screen can be overwritten the next time you import location information, as described in Importing Locations through File Storage API.
If you use proximity locator, when you change the address for a location, Order Broker determines its new latitude and longitude using either the Oracle Maps Cloud Service or the proximity location table, depending on your configuration, and updates this information for the location record.

Required, optional fields: The Name is always required. All of the remaining information on this screen is optional, although the screen displays a warning message before you can create a location without a State/Province, Country, and Postal Code, because these fields are required to use the proximity locator. The remaining fields are optional, however:

If you use the proximity locator in your organization, you should always enter a valid address, regardless of whether the location is subject to proximity locator searching (for example, a warehouse).
Canadian postal codes should be entered with a space: for example, L5R 4H1 rather than L5R4H1.
locateitems response: the name and address information for the location that is displayed in the locate items response is derived from your entries at this screen.
ADSI integration in Store Connect: The name and address may also be submitted to ADSI when the store associate ships an item, based on the setting of the Shipping Label Return Address specified at the Store Connect Preferences screen. The return address location must include:
- contact name and company name
- street address line 1
- U.S. city, state/province, and postal code
- phone number of 10 positions, plus any formatting (for example, (508) 555-1111). The store location phone number is used if there is not a day or evening phone number for the order shipping address
submit order request for a pickup order: If a submit order request for a pickup order originates from a location without an address that includes a valid postal code, Order Broker returns an error indicating that the location does not have sufficient inventory of the requested item.

Fields at this screen

Field	Description
Informational fields:
Organization	See organization. The organization code and name are displayed, separated by a hyphen (-).
Type	See location type. The location type code and name are displayed, separated by a hyphen (-).
Location	See location. The location code only is displayed.
System	See system. The system code and name are displayed, separated by a hyphen (-).
Location detail fields: Note: Most of the fields on this screen are optional and informational only. The exceptions are the Name field, which is always required, and the Country and Postal code, which are required if Use Proximity Locator is selected for the organization at the Preferences screen. The name and address information for the location that is included in the locate items response is derived from your entries at this screen.
Name	Location names can be 1 to 40 positions in length, and do not need to be the same as the name or description of the location in the integrated system, such as Order Management System or Xstore. Required.
Rank	Your entry can be up to 10 positions. Informational.
Region	Your entry can be up to 20 positions. Informational.
Contact Name	Your entry can be up to 40 positions. Informational.
Store Hours	Your entry can be up to 60 positions. Informational.
Emails	The email address must be formatted as user@host.com (or other valid suffix such as .org). Order Broker does not validate that your entry represents an existing email address. Separate multiple email addresses with a semicolon (;). Your entry can be up to 245 positions total. New Store Connect order? Used for the new order notification email if this is a Store Connect location and the Send New Order Notifications flag is selected at the Email tab of the Store Connect Preferences screen. See: contents: New Order Notification to Store Connect Location email setup information: Store Connect Email Notifications Summary Turn off email notifications? To turn off email notifications to a store location, delete the email address(es) specified here.
Telephones
Telephone	Your entry can be up to 20 positions.
Extension	Your entry can be up to 10 positions.
Fax	Your entry can be up to 20 positions.
Address
Address	Your entry in each of the four fields can be up to 50 positions.
City	Your entry can be up to 35 positions.
State/Province	Your entry can be up to 3 positions. Required to use the proximity locator, although you can create a location without completing this field. Should be a valid ISO code.
Postal Code	The ZIP or postal code for the location. Your entry can be up to 10 positions. Required to use the proximity locator, although you can create a location without completing this field. Note: Canadian postal codes should be entered with a space: for example, L5R 4H1 rather than L5R4H1. If a submit order request for a pickup order originates from a location without an address that includes a valid postal code, Order Broker returns an error indicating that the location does not have sufficient inventory of the requested item.
Country	Your entry can be up to 3 positions. Required to use the proximity locator, although you can create a location without completing this field. Should be a valid ISO code.
Attributes
Labor Cost	Used to “shop” an order for fulfillment or sourcing as part of the weighted brokering method (see Submit Order Request for Delivery Order (Weighted Brokering) for background) when determining the cost to pick, pack, and ship an order. Your entry can be a maximum of 19 positions, including up to 15 positions before the decimal and 4 positions after. It can also be 0 (0.000), but cannot be a negative number, and should not include a currency symbol. Optional. You can also update the labor cost through the Location Bulk Updates wizard.
Gift Wrap	Select this flag to indicate that the location supports gift wrap; otherwise, leave it unselected. It defaults to unselected. Used when? If the Use Attribute Rules flag is selected for the organization at the Preferences screen, locations are filtered based on this setting when the LocateItems request, SubmitOrder request, or ProductAvailability request indicates that the item requires gift wrap, or if the order line is rejected and reshopped. For a ship-for-pickup order, it is the pickup location that needs to support gift wrapping rather than the sourcing location. See Enable Ship-For-Pickup? for background. Note: This field is not updated through the location import, but it is updated through the LocationUpdate request message.
Geocode If you use proximity locator and the location has a postal code, Order Broker determines a location’s latitude and longitude using either the Oracle Maps Cloud Service or the proximity location table, depending on your configuration, and saves this information as part of the location record.
Latitude	The location’s latitude. Set automatically when you create or update a location if you use proximity locator. See Proximity Locator Searching for an overview. Display-only.
Longitude	The location’s latitude. Set automatically when you create or update a location if you use proximity locator. See Proximity Locator Searching for an overview. Display-only.
Days Open The Auto Cancel Unclaimed Pickup Orders job uses the Days Open settings to determine when to cancel an unclaimed pickup or ship-for-pickup order. Only days that are selected here are included in the calculation. See Auto-Cancel Unclaimed Orders for a discussion and setup information.
Days Open for Auto-Cancel	Use these fields to indicate which days of the week should be included to determine when a pickup or ship-for-pickup order is eligible for automatic cancellation. If a day is not selected, it is not included in the calculation. All days of the week are available for selection. Updating these fields: All days of the week are selected by default when you create a new location through the New Location screen, the LocationUpdate request message, or the Importing Locations through File Storage API process. You can change the settings at this screen, or through the Location Bulk Updates wizard. If you change a location’s Days Open for Auto Cancel settings, this does not affect the Pickup By Date that has already been assigned to any order lines for the location. Updating an existing location through the Importing Locations through File Storage API process does not update the Days Open for Auto-Cancel.