Glossary

Field

Definition

admin user

The default user login delivered with Locate. This user has full authority to Locate screens. You cannot delete this user.

If this user is flagged as inactive, a user ID of SYSTEM rather than ADMIN is listed in scheduled product import notification emails and in order line history when these activities take place automatically.

attribute

Key metrics for product locations. Possible attributes are Daily Sell Through Quantity, Sell Quantity/Multiple, Minimum Sell Quantity, Shrink Rate %, and Sales Velocity.

Probability rules can use any of the first four attributes as part of their calculations. For example, you might want to set up a probability rule that specifies to reduce the available quantity displayed in locate items search results by the daily sell-through quantity for a location in an offline system. You can also use the Sales Velocity attribute as a search criterion for assigning retail pickup or delivery orders to fulfilling locations.

available to promise quantity

The available quantity from the product location minus the reserved quantity and any stc_fulfilled_quantity (calculated only for Store Connect locations, and displayed on the Product Location screen as the Fulfilled Quantity).

brand

A retail brand associated with an organization to identify the organization to customers receiving drop shipments. The brand logo prints on the pack slip and pullsheet when the vendor generates these PDF documents.

Each organization using the Supplier Direct Fulfillment module must have at least one brand.

calculation

A mathematical expression that you can include in a probability rule. For example, you might include a calculation such as Next PO Quantity Minus [-] Daily Sell Through in a probability rule.

Created how? You can create and work with calculations at the Calculations window. See that window for more information.

carrier

A ship via that your vendors use to deliver drop ship orders to customers or that a store associate can use to confirm shipment of delivery orders in Store Connect. Required for all sales orders and purchase orders.

category

See location category.

CreateDSOrder

The message submitted by the retailer to create a new purchase order in Locate and assign the purchase order to a vendor.

CreateDSVendor

The message submitted by the retailer to create a new vendor in Locate, or to update an existing vendor.

CSV file

A comma-separated file.

Order Broker: 

         Proximity upload: You need to upload a postal code file in this format and use the Proximity Uploads screen to populate or update the proximity location table. See Proximity upload process overview for more information.

Supplier Direct Fulfillment:

         Pack slip: When the vendor uses the Vendor Portal to generate pack slips for purchase orders, the vendor can generate a CSV file containing the pack slip information, either instead of or in addition to a PDF file.

         Shipment upload: The vendor can use a CSV file to confirm shipments of purchase orders.

         Invoice upload: The vendor can use a CSV file to create invoices.

default Store Connect system

The system that is available for order processing through the Store Connect module. There can be only one Store Connect default system in an organization. Defined by the Store Connect Default flag at the System screen. This flag controls whether:

         you can assign store associate user profiles to the locations associated with the system, so they can log in and process orders through the Store Connect screens

         to include the locations for the system in the settings you set up through the Store Connect Preferences screen, such as the schedule to update assigned orders from New Order to Polled status

         to generate an email notification to the store when new orders are polled

         to generate pickup-ready notification emails for pickup orders or shipment notification emails for shipped delivery orders

         the Inventory Export tab is available at the System screen, so you can run the Store Connect Inventory Export to the system, and whether to include each product location in the export

         to track the Fulfilled Quantity for each product location, and reduce this quantity when you run the inventory export

default system

The primary system for a organization. Products in Locate can have relationships with every integrated system, but they are defined by the default system. You should load the Locate database with the default system’s products first, and then create system products for each additional integrated system.

Created how? A default system is identified by the Default flag at the Systems screen. You set this flag by selecting the Organization Default checkbox at the System screen.

For more information: See Data Hierarchy for an overview of the relationships among Locate elements, including systems.

default unfulfillable location

The location where the Order Broker assigns an order if it is unable to find an actual location to fulfill the order or line. The Order Broker uses the Order Broker Settings at the Preferences screen to determine which locations to select to fulfill an order or line, and the Search Retries setting at this screen to determine the number of times to reassign an order or its individual lines after rejection by a fulfilling location.

default vendor system

The system within an organization that is associated with any vendors. Locate identifies the default vendor system by the Vendor Default flag.

Required to create vendors: You cannot create a vendor for an organization until you create the default vendor system. This system should not represent an actual system that integrates with Locate.

No additional information required: It is not necessary to specify any additional information for the default vendor system besides entering the Name and selecting the Vendor Default flag.

Only one default per organization: There can be only one default vendor system for an organization. If you select the Vendor Default flag for an additional system, the flag is cleared for the current default vendor system.

Automatically creates vendor location type: When you create the default vendor system, Locate automatically creates a the DS Vendor location type. This location type is also required to create vendors. You should not delete this location type.

delivery order

An order to be shipped to the customer from one or more locations selected by the Order Broker or specified in the submit order message. See Delivery Order for more information.

discovery messages

The discovery web services provide a means to request a listing of systems or locations from Locate. See the Operations Guide for more information.

DS Vendor location type

The location type identifying drop ship vendors. Locate automatically creates this location type when you create the default vendor system for your organization. This location type is required for you to create drop ship vendors.

Identifying the DS Vendor location type: Locate creates this location type with:

         Type = DS Vendor

         Name = Drop Ship Vendors

         Category = Drop Ship Vendor

Important:                               You should not delete this location type.

fulfilling location

When you use the Order Broker, this is the location (warehouse or store):

         pickup or ship-to-store order: where the customer is picking up the order

         delivery order: that is shipping the order or lines to the customer

         retail pickup order: that is transferring the inventory the originating location

Note:             An integrated system might use the term “fulfilling location” differently. For example, CWSerenade uses this term to designate the location that originates a ship-to-store order rather than the location where the customer picks it up.

fulfillments message

A message sent to the Order Broker from a location or system, requesting information on any orders or lines assigned to the location, or locations associated with the system, for fulfillment. See The Order Broker for an overview.

getDSChanges

The message submitted by the retailer to request a listing of purchase order activity since the last getDSChanges request was processed. The response message includes information on activities such as status changes and shipments. Part of the Supplier Direct Fulfillment module.

getDSInvoices

The message submitted by the retailer to request details on any invoices posted by the vendor since the last getDSInvoices request was processed. Part of the Supplier Direct Fulfillment module.

getDSOrders

The message submitted by an integrated vendor to request new purchase orders. Typically triggered by the launchDSOrders (nudge) message from Locate. See Vendor Integration for background, and see the Vendor Integration Guide for details.

getDSShipConfirm

The message submitted by an integrated vendor to confirm shipment of a purchase order. See Vendor Integration for background, and see the Vendor Integration Guide for details.

grouping shipment locations

The Group Shipment Locations setting at the Preferences screen controls how the locate items response works for delivery or retail pickup requests:

         If the Group Shipment Locations preference is unselected, the response message lists locations where the available quantity should be able to fulfill the order.

         If the Group Shipment Locations preference is selected, the Order Broker uses the same logic as when the preference is unselected; however, the response does not include details on each location that can fulfill the order. Instead, the response just includes the virtual (non-existent) location, indicating that the order can be fulfilled through the Order Broker.

For more information: See Selecting a Location for a Delivery or Retail Pickup Order for a discussion.

import ID

A unique ID number assigned by Locate to identify a product and product location import. See Importing Items/Products, Inventory, and Attributes into the Locate Database for an overview. Part of the Order Broker module.

import process

A process using a direct database connection to import new or updated products and product locations from an integrated system into Locate for the Order Broker. In order to use the full import process, and be able to select the Extract and Import option at the System Import Schedule screen, you need to:

         flag a system as online at the System screen, and provide the Database Information to connect to the system’s database

         use the System Import Schedule screen to schedule regular imports of new or updated products and product locations, or to run the import on demand

For more information: See Importing Items/Products, Inventory, and Attributes into the Locate Database for a discussion.

IN PROCESS location

The temporary virtual location where the Order Broker assigns retail pickup or delivery orders at initial creation before selecting an actual fulfilling location, if no fulfilling location is specified in the submit order request. Used only if the Acknowledge Order Before Brokering preference is selected.

integrated vendor

A vendor who uses XML and JSON messages, rather than Vendor Portal screens, to receive purchase orders and confirm shipments. See Vendor Integration for an overview, and the Vendor Integration Guide for details.

inventory inquiry

A request for product availability sent by Locate to an online system, in order to respond to a locate items request.

For more information: See The Order Broker for a process overview.

inventory level type

The Type for a probability location assignment. The inventory level type provides a means to apply rules differently based on how recently you received an inventory update for the product location. Possible types are:

         On-line only: The product location is within an online system, and you have received an inventory inquiry response for the product location.

         Off-line only: You have not received an inventory update within the time period specified at the Preferences screen. Even if the product location is within an online system, it is considered off-line for the purposes of probability rule evaluation if you have not received an inventory inquiry response (if, for example, the location is having communication difficulties, or if the process responsible for inventory inquiry requests and responses is not running).

         Both: Evaluate the rule for the product location, regardless of whether the product location is processing inventory inquiry responses.

Used by the Order Broker module.

invoice status

Possible invoice statuses are:

         Approved = The invoice was approved, either automatically or by you, but has not yet posted to the originating system.

         Held = The vendor has submitted the invoice, and the invoice includes at least one line that is out-of-balance because the vendor changed the unit price by more than the Unit Cost Threshold specified for the vendor: for example, you set a threshold of 10%, and the vendor changed the unit price by 15%. The invoice remains in Held status until the you either approve or reject it.

         New = The vendor selected the Update and Save for Changes option when creating the invoice, and has not yet submitted the invoice to you for posting.

         Posted = The invoice has been posted to the originating system, such as CWDirect or CWSerenade, for payment processing.

         Rejected = The vendor submitted an invoice that includes an out-of-balance line, and you rejected it. The vendor can change the invoice so that it no longer contains an out-of-balance line, or can delete the invoice.

Used by the Supplier Direct Fulfillment module.

launchDSOrders

The nudge message that Locate sends to an integrated vendor indicating to request one or more new purchase orders through the getDSOrders message. See Vendor Integration for background, and see the Vendor Integration Guide for details.

LDAP authentication

LDAP authentication in Locate enables a user to enter his or her standard network password to log in, rather than a separate password that is specific to Locate. See Domain Configuration for LDAP Authentication for more information. Not available for a vendor user.

line status

Order Broker: See Order and Line Statuses for possible Order Broker statuses.

Drop Ship: Possible purchase order line statuses are:

         Cancelled: You have cancelled the line

         Held: The vendor has held the line(s) on the purchase order from processing. When a line on a purchase order is on hold, it is not eligible for pack slip generation; or, if a pack slip has already been generated, the line is not eligible for shipment confirmation.

         In Process: The vendor has generated a pack slip that includes the line.

         New Order: The vendor has not yet generated a pack slip for the line.

         Shipped: The vendor has confirmed shipment of the line.

For more information: See order status.

locate items

A request to the Order Broker inquiring whether there are any locations that should be able to fulfill a delivery, retail pickup, or pickup order for one or more items, and the Order Broker’s response message indicating the availability of the item(s).

Locate receives the request and determines the availability information to include in the response by:

         for product locations in online systems: sends an inventory inquiry

         for product locations in offline systems: checks the current available quantity and purchase order information in the Locate database

Locate sends the availability information to the requesting system in the locate items response. See The Order Broker for an overview.

locate-config.properties file

A configuration file that provides basic information on how Locate works. See the Operations Guide for more information.

location

A place where a product is sold or stocked. A location can be a warehouse or store where you keep actual inventory. It can also be a virtual location such as a web storefront or a vendor. Locations are defined within an organization both by the system to which they belong and their location type. You use the Locations screen to work with locations.

Locate stores information on a location, including address, phone number, and hours of operation. These fields are informational only; however, the name and address information for the location that is displayed in the locate items response is derived from your entries at the Location screen.

Created how? You must create each location within Locate in order to integrate its inventory for locate items searches.

Sort order: The sort at the Preferences and Probability Location screens is in alphanumeric order within each organization. In other words, organizations are listed alphanumerically by name, as are location types within an organization, and locations within a location type. Since the sort is alphanumeric, numeric codes are listed before alphabetical codes; for example, location 123 is listed before location ABC.

Location code requirements: The location code is alphanumeric, can be 1 to 10 positions long, and must be unique within an organization and system. For example, you can have two locations with a code of 10 in the same organization, as long as each is associated with a different system.

For more information: See Data Hierarchy for an overview of the relationships among Locate elements, including locations.

location category

Indicates whether each location type is a store (S), warehouse (W), or vendor (V). Each location type must be assigned to one of these categories.

Created how? The 3 location categories are delivered with Locate and cannot be changed.

Locate does not evaluate locations differently based on their category; the category is informational only.

location type

Describes one or more locations within an organization. Each location type indicates the location category (store, warehouse, or vendor), and can also provide additional information, such as “East Coast Stores” or “Outlet Stores.”

Created how? You must create each location type at the Location Types screen.

Location type requirements: The location type code can be 1 to 10 positions long and must be unique within the organization.

Display in drop-down boxes: The location type code and the location type name are displayed, separated by a hyphen (-).

For more information: See Data Hierarchy for an overview of the relationships among Locate elements, including location types.

master style

Indicates a basic product type. For example, the master style for a green shirt, size large, identifies the shirt itself; the color and size might represent styles in a POS system such as Xstore, and represent SKU’s in an order management and fulfillment system such as CWSerenade. A master style can be defined at both the product and the system product levels.

Master style requirements: The master style can be 1 to 35 positions in length.

The master style is informational only. Normally, you would never change the master style for a product in Locate.

CWSerenade integration: The master style for CWSerenade items is the base item number; the master style is populated only for SKU’d items and is set at both the product and system product levels, assuming that CWSerenade is the default system.

nudge

A message that Locate sends to an integrated vendor’s system to trigger the system to send Locate a message requesting new purchase orders. A nudge is generated through:

         Selecting the generation of new purchase orders at the Get Purchase Orders screen in the Vendor Portal, or

         Scheduling periodic nudges through the PO Schedule Interval set up under the Preferences tab of the New Vendor or Edit Vendor screen. The vendor can also set up the schedule in the Vendor Configuration screen in the Vendor Portal.

offline inventory

The inventory information (Available Quantity, Next PO date, and Next PO Quantity) currently stored in Locate for a product location. Locate uses the offline inventory information in merchandise locator responses for product locations in:

         an offline system: always

         an online system: if Locate cannot receive an update from the system, and the No Offline Response Action setting at the Preference screen is set to Use offline.

Used by the Order Broker module.

offline system

An offline system is one which Locate does not query interactively for current inventory levels when it receives a locate items request; instead, it relies on the available quantity stored in the Locate database (offline inventory) to calculate the Available to Promise quantity. Typically, inventory levels in the Locate database are updated daily, or whenever scheduled by your systems administrator.

Specified how? An offline system is identified by the Online flag being blank at the Systems screen. You clear this flag by clearing the Online checkbox at the System screen. Locate does not clear the direct database connection information, if any, so that you can easily change an online system to an offline system and back again.

online system

An online system is one which Locate queries interactively for current inventory levels when it receives a locate items request.

Specified how? An online system is identified by the Online flag at the Systems screen. You set this flag by selecting the Online checkbox at the System screen. You must also provide the database connection information for Locate to use when requesting product and product location updates.

If no response received: When Locate cannot obtain an interactive inventory update, it uses the available quantity stored in the Locate database (offline inventory) to calculate the Available to Promise quantity, if the No Offline Response Action setting at the Preference screen is set to Use offline. The available quantity is updated either through a recent online inventory inquiry, or through the most recent inventory download or product location import from the system. Typically, inventory levels in the Locate database are updated daily, or whenever scheduled by your systems administrator. See Import Process Overview and Uploading Product Attributes for more information.

If Locate is not able to obtain an interactive inventory update, and uses the offline inventory information as a result, it considers the product location offline for the purposes of evaluating it for a probability rule.

Direct database connection: Complete the Database Information fields at the System screen.

on premises

Describes the option of having Locate installed on one or more servers within your network, vs. having Locate hosted for you in the cloud. Certain options, such as viewing log files, are available only when Locate is installed on premises.

Order Broker

The Locate module to:

         select the best location(s) to fulfill a delivery or retail pickup order, either automatically based on criteria that you set for the enterprise, or by providing a list of possible locations

         help the customer select a location for a pickup or ship-to-store order

         determine whether inventory is available in the enterprise to fulfill a delivery or retail pickup order

         create orders across the enterprise

         notify locations about orders assigned to each location for shipment, transfer, or pickup

         track order status

         provide information on current order status upon request

See The Order Broker for an overview.

order number

Order Broker: The number identifying an Order Broker order in the originating system. From the order id passed in the submit order message. The Order Broker uses both this order number and the request ID to track each order. The order number is alphanumeric and cannot exceed 30 positions.

Supplier Direct Fulfillment: The number identifying the sales order that originated a drop ship purchase order assigned to a vendor for fulfillment.

order status

Order Broker: See Order and Line Statuses.

Drop Ship: Possible purchase order statuses are:

         Cancelled: You have cancelled the purchase order.

         Complete (multi-line purchase orders only): The purchase order includes more than one line, and the line statuses include a combination of Cancelled and Shipped; there are no remaining open lines.

         Held: The vendor has held the line(s) on the purchase order from processing. When a line on a purchase order is on hold, it is not eligible for pack slip generation; or, if a pack slip has already been generated, the line is not eligible for shipment confirmation.

         In Process: The vendor has generated pack slips for the purchase order.

         New Order: The vendor has not yet generated pack slips for the purchase order.

         Open (multi-line purchase orders only): The purchase order includes more than one line, and the line statuses include at least one line that is Held, In Process, or New Order.

         Shipped: The vendor has confirmed shipment of the purchase order.

For more information: See line status.

order type

The type of order, based on the fulfillment_type in the SubmitOrder message. Possible order types are:

         delivery order

         pickup order

         retail pickup order

         ship-to-store order

Used by the Order Broker module.

OrderUpdate message

A request to the Order Broker to reset the Under Review flag for an order. If this flag is selected, the fulfilling location should not complete fulfillment of the order.

organization

The highest level of the Locate data hierarchy, an organization includes the systems and products that can integrate with each other for the purposes of locate items searches, as well as the locations where products are sold or stocked. If there is more than one organization within Locate, searches do not cross from one organization to another.

Created how? You must create the organization at the Organizations and Preferences screen as the first step in setting up data in Locate.

Organization requirements: The organization code can be 1 to 10 positions long and must be unique within Locate.

Display in drop-down boxes: The organization code and the organization name are displayed, separated by a hyphen (-).

Display on screens: The organization code and the organization name are displayed, separated by a space.

Default: On screens where the organization is available for searching or creating new records, this field defaults from the organization associated with the Default Shipping System from your user profile, but you can override this default.

Note:  You must complete the Preferences screen for an organization before you can select it.

For more information: See Data Hierarchy for an overview of the relationships among Locate elements, including organizations.

originating location

The location (store or warehouse) that requested that an order be shipped, transferred, or prepared for pickup through the Order Broker.

Note:             An integrated system might use a different term for this location. For example, in CWSerenade the location where a ship-to-store order originates is designated as the fulfilling location, because it transfers the merchandise to the location where a customer will pick it up.

out-of-balance

An invoice detail line is out-of-balance if the vendor changes the unit price from the original purchase order unit price by more than the Unit Cost Threshold you specify for the vendor: for example, you set a threshold of 10%, and the vendor changes the unit price by 15%. Any change to unit price, either higher or lower than the original unit price, triggers out-of-balance evaluation. When the vendor submits the invoice, it does not post automatically to the originating system; instead, it remains in Held status until you either approve or reject it.

The out-of-balance icon (out_of_balance.png) at the Detail tab of the Invoice screen indicates if the invoice detail line is currently out-of-balance.

Used by the Supplier Direct Fulfillment module.

pack slip

The packing document that the vendor generates for drop ship purchase orders. Depending on the vendor’s preference settings, the pack slip can be in PDF format, CSV format, both, or neither.

Used by the Supplier Direct Fulfillment module.

partial status update

An order line status update that specifies a unit quantity lower than the total quantity currently on the order line. For example, if the customer ordered 5 units and now wants only 4 units, the system might send a status update canceling 1 unit. Supported only if the Allow Partial Updates preference is selected for the organization. See Updating Order Status at the Line or Unit Level for an overview.

Used by the Order Broker module.

pickup order

An order to be picked up by the customer at a specified location, without requiring the Order Broker to facilitate transferring the inventory to that location. See Pickup Order for more information.

polled order

An order or order line for which the assigned fulfilling location has been notified. Order lines flagged as polled are no longer be included in the fulfillments response message. The Order Broker flags an order line as polled automatically if the fulfilling location’s system’s Require Status Update flag is unselected. Otherwise, if the Require Status Update flag is selected, the assigned fulfilling location must send a status update of either polled (any order type) or accepted (pickup, retail pickup, or delivery orders only).

Note:             Flagging an order or line as polled does not necessarily change the order or line status to polled. For example, the Order Broker does not apply this status to a ship-to-store order if its current status is picked or intransit; and for other order types, setting the status to accepted also serves to flag the order or line as polled.

See Require Status Update for Assigned Orders? for a discussion.

Used by the Order Broker module.

probability rule

You can set up rules that indicate any adjustments to make to the Available to Promise quantity, next PO date, or next PO quantity for a product location when you display this information in merchandise locator search results; or, you can set up a rule indicating not to include a product location in search results at all under certain conditions. Probability rules let you build additional intelligence into merchandise locator searches by accounting for predictable patterns in inventory activity.

Setting up rules: See the Probability Rule Wizard for information on defining and assigning probability rules, including sample rules and an overview of rule hierarchy.

Used by the Order Broker module.

probable quantity

A quantity, stored in the product_location table, based on the available to promise quantity after applying any assigned ecommerce probability rule. The probable quantity is available for your ecommerce system to retrieve in order to provide more accurate availability information on the web storefront, but this quantity is not returned in any messages to integrated systems or displayed on any screens.

The probable quantity is updated through the ecommerce inventory import. See the Ecommerce tab of the System screen for background.

product

A single inventory item that you sell in systems integrated with Locate. For example, you sell a pen as AB100 in CWSerenade company 1. You sell the same pen as 345789123 in Xstore. Because your CWSerenade company is your default system, the product is identified as AB100, and each of the related items in Xstore and other integrated systems is a system product, but all are related to the main product.

Created how? Products are created in Locate when you use the product import process, download items, or export products from your default system. You can also create new products at the Products screen. Whenever you create a product, Locate also creates a system product for the default system.

Product code requirements: The product code can be 1 to 35 positions long, and must be unique within a organization.

Display on screens: The product code and the product name are separated by a space.

For more information: See Data Hierarchy for an overview of the relationships among Locate elements, including products.

Used by the Order Broker module.

product availability search

The Product Availability search message is similar to the locate items search, except that the Product Availability search:

         can include more than one transaction type (pickup, retail pickup, and delivery) in a single request, and each type can include its own search range distance

         does not include product location details for retail pickup and delivery searches; instead, it indicates:

         if the entire requested quantity can be satisfied; otherwise,

         if a partial quantity of the requested items can be satisfied, the maximum available quantity of each item

         for a pickup request, always returns each item location that could partially fulfill the requested quantities of all requested items

For more information: See Using Product Availability Search.

Used by the Order Broker module.

product location

A record of a product within a location where it is stocked or sold. For example, an item warehouse record in CWSerenade corresponds to a product location.

Locate stores availability information for the product location, including the available quantity and the date and expected quantity of any open purchase orders.

Note:             A system product must first exist for the product and system owning the selected location before you can create a product location. For example, if product AB123 does not exist in CWSerenade company 10, then you cannot create a product location for AB123 in company 10’s warehouse 1.

Available quantity updated when? For an offline system, the available quantity is updated only when you run the product import process or perform an inventory download from the system. For an online system, Locate also updates the available quantity, next PO date, and PO quantity for the product location when it receives a response to an inventory inquiry. Typically, inventory levels in the Locate database are updated daily, or whenever scheduled by your systems administrator.

Created how? Typically, you create product locations through integrations with external systems. For example, product locations might be created as part of the product import process.

For more information: See Data Hierarchy for an overview of the relationships among Locate elements, including product locations.

Used by the Order Broker module.

proximity location table

The table that stores either U.S. zip codes or Canadian postal codes and the longitudes and latitudes of each. This information is required in order to perform proximity locator searches in Locate.

For more information: See Proximity Uploads for more information on creating or updating the data in the proximity location table.

Used by the Order Broker module.

proximity locator

Provides the ability to search for a product location based on its distance from the customer’s location. For example, the customer wants a certain product and would like to know if it is available within 25 miles from his home. If proximity locator searching is enabled, Locate can find any product locations within this distance from the customer.

How is proximity calculated? Proximity locator searches are based on the longitude and latitude at the center of each zip or postal code based on the density of population within the zip or postal code. The distances indicated in the search results are not exact driving distances. For example, if the customer’s location is zip code 01701 and the specified product is available at a store location in zip code 01760, the indicated distance of 4.49 indicates the difference in longitude and latitude from the population center of 01701 to 01760; it does not indicate the actual driving distance from the customer’s home. See Proximity Locator Searching for more information.

Used by the Order Broker module.

request ID

A unique number assigned by the Order Broker to identify an order. See The Order Broker for an overview.

requested location

A location specified in the locate items request message if the customer is interested in requesting availability information for that store location only. When the request message specifies a requested location, the Order Broker:

         ignores the distance specified in the request and does not exclude the requested location based on proximity

         always returns the actual location in the response message, rather than the virtual location, regardless of the setting of the Group Shipment Locations flag on the Preferences screen, and regardless of whether the location would otherwise be excluded because you are using zone fulfillment or because the location is within the same system and the Disallow shopping within same system flag is selected for the system

         always returns a response even if the Available to Promise quantity is less than the requested quantity

reserved quantity

The quantity on all order lines assigned to this product location that are in a status indicating the inventory is reserved and should not be assigned to new orders or listed in the LocateItems response message. See Calculating the Available to Promise Quantity for an overview.

Used by the Order Broker module.

retail pickup order

An order that the customer will pick up at the originating location, requiring that the merchandise be sourced from one or more different locations. You can use the Order Broker to select one or more locations to transfer the inventory to the originating location, or select locations manually. See Retail Pickup Order for more information.

retailer

The system that submits drop ship purchase orders to vendors through the Supplier Direct Fulfillment module in Locate.

retailer user

A user who has access to Locate screens in order to work with either the Order Broker or the Supplier Direct Fulfillment module, or both.

sales velocity

A numeric ranking you can use to indicate how well a product sells in a particular location. You can use the sales velocity ranks assigned to product locations as part of the Order Broker criteria for selecting fulfilling locations for orders. Numeric, 2 positions with an optional 2-position decimal. See the Order Broker Settings at the Preferences screen for more information.

setDSAcknowledge

The message submitted by an integrated vendor to confirm receipt of a batch of purchase orders. If the Require Acknowledgement flag is selected for an integrated vendor, the acknowledgement is required to change the status of the purchase orders from New Order to In Process and generate the pack slip. See Vendor Integration for background, and see the Vendor Integration Guide for details.

SetDSAddressChange

The request message sent from an external system, such as CWDirect or CWSerenade, to change the address on a drop ship purchase order. The request specifies whether to change just the shipping address, or both the shipping address and the sold-to address. Address changes are:

         applied automatically if the purchase order or item is in New Order status

         submitted to the vendor for review if the purchase order or line is in Held or In Process status

         rejected automatically if the purchase order or line is in Shipped or Canceled status

setDSCancel

The request message sent from an external system, such as CWDirect or CWSerenade, to cancel a line on a purchase order. Cancellations are:

         applied automatically if the line is in New Order status

         submitted to the vendor for review if the line is in Held or In Process status

         rejected automatically if the line is in Shipped or Canceled status

setDSCostChange

The request message sent from an external system, such as CWDirect or CWSerenade, to change the cost on a purchase order. Cost changes are:

         applied automatically if the line is in New Order status

         rejected automatically if the line is in Shipped or Canceled status

ship-to-store order

An order that the customer will pick up at a specified location, requiring that the Order Broker facilitate transferring the merchandise to the selected location from the originating location. See Ship-to-Store Order for more information.

Note:  When the current status of a ship-to-store order is picked or intransit, the Order Broker does not change the order’s status when it is polled by the assigned fulfilling location.

splitting orders

If the Allow Split Order preference is selected, the Order Broker assigns the lines on a delivery or retail pickup order to multiple fulfilling locations if it cannot find a single location that could fulfill the entire order. This setting also affects the locations returned in the locate items response message, and requires that status updates apply at the line level rather than the order level. See Selecting a Location for a Delivery or Retail Pickup Order for more information.

splitting lines

If the Allow Split Line preference is selected, the Order Broker assigns a single order line to multiple fulfilling locations if it cannot find a single location to fulfill the entire line. This setting is available only if the Allow Split Order preference is also selected. See Selecting a Location for a Delivery or Retail Pickup Order for more information.

status inquiry

A message sent to the Order Broker requesting the current status of an Order Broker order. See The Order Broker for an overview.

status update

A message sent to the Order Broker to update the status of an Order Broker order. See The Order Broker for an overview.

store associate user

A separate user login for Store Connect, providing access to orders assigned to Store Connect locations. Authority for store associate users is controlled by a separate set of roles. See Store Associate User Profiles and the Role Wizard for more information.

Store Connect

The Locate module that provides a suite of screens that a store associate can use to work with orders, assigned to the store location through the Order Broker.

You can assign store associate users to any locations associated with the system flagged as the Store Connect Default, and the associates can use the Store Connect screens to work with orders assigned to these locations.

submit order message

A message sent to the Order Broker requesting creation of an order. See The Order Broker for an overview.

Supplier Direct Fulfillment

The Locate module that enables the retailer and the vendor to communicate about fulfilling drop ship purchase orders.

system

An external database or business entity which integrates with Locate. For example, a system is an Xstore database or a CWSerenade or CWDirect company.

Created how? You must create each system at the Systems screen.

System code requirements: The system code can be 1 to 10 positions long, and must be unique within Locate.

Display in drop-down boxes: The system code and the system name are displayed, separated by a hyphen (-).

For more information: See Data Hierarchy for an overview of the relationships among Locate elements, including systems.

system product

An identification of a product within a particular system that is integrated with Locate.

Created how? A system product is created for a product when you download items or import products from an external system, such as CWSerenade, Xstore, Store21, or Tradewind. You can work with system products at the System Products screen.

System product code requirements: The system product code can be from 1 to 35 positions long. System products need to be unique within a system, but the same system product code can be assigned across multiple systems. For example, you cannot have more than one system product for AB123 in system 2, but you can have system product AB123 in systems 2, 3, and 4.

For more information: See Data Hierarchy for an overview of the relationships among Locate elements, including systems.

Used by the Order Broker module.

tenant

Use the Tenant screen to review or work with attributes of your business in Locate at a level higher than the organization, such as specifying which modules to use, and the timeout interval for the user interface. Tenant-level settings apply to all your organizations in Locate, regardless of whether the application runs on premises or is hosted.

type

See location type.

vendor

The external organization that fulfills drop ship purchase orders for the retailer. Each purchase order processed through the Supplier Direct Fulfillment module is associated with a vendor.

vendor default system

A vendor default system is required before you can create any vendors to fulfill drop ship orders. An organization can have only one vendor default system.

It is not necessary to specify any additional information for the vendor default system besides the organization, name, and this flag.

vendor item

The vendor’s item code. The CreateDSOrder message specifies the vendor item code for each item on a purchase order, and Locate creates the vendor item record automatically if it does not already exist.

Used for the Supplier Direct Fulfillment module.

Vendor Portal

The external website that a vendor can use to review, print, report shipments on, and create invoices for drop ship purchase orders through the Supplier Direct Fulfillment module. Each vendor user has access to screens in the vendor portal listing information related only to that purchase orders for the associated vendor.

vendor preferences

Preference settings specific to a vendor, including:

         pack slip generation output, such as whether to generate pack slips in PDF or CSV format, and whether the pack slip PDF should be graphical or nongraphical

         email addresses to receive notifications on purchase order activity

A vendor user can also modify these settings with the required authority.

See the Preferences tab at the New Vendor or Edit Vendor screen for more information.

vendor user

A separate user login to the vendor portal, providing access to the purchase orders for the associated vendor. Authority for vendor users is controlled by a separate set of roles. See the Role Wizard for more information.

virtual location

The location that the Order Broker uses in the locate items response message to indicate that it can fulfill an order. The Order Broker returns the virtual location in the response message only if you use the Group Shipment Locations option, indicating that requesting systems do not need to know which locations would be able to ship an order for the requested item(s), only that the order can be shipped (delivery order) or transferred (retail pickup order).

The locate items response message lists the virtual location, rather than details on actual locations, if:

         the Group Shipment Locations flag at the Preferences screen is selected

         the Order Broker receives a LocateItems request message with the fulfillment_type set to DELIVERY or RETAILPICKUP

         the Order Broker has found at least one location that should be able to fulfill each line on an order for the requested item(s) in the specified quantity(ies), or that is flagged as Backorder Available

You do not need to create the virtual location in Locate.

web service

A programming component made available by a web server to perform specific programming tasks. For example, there is a discovery web service to supply an external system with the systems and locations set up in Locate for an organization.

zone fulfillment

An option to restrict location selection for retail pickup or delivery orders based on the shipping address for an order, or based on the requesting location in a locate items request. You can set up zones to include addresses based on country, state or province, or zip code prefix range. Also, you can specify one or more primary store or warehouse locations to fulfill orders within the zone, as well as one or more alternate locations to use if the merchandise is not available within the primary locations.

For more information: See Using Zones for Fulfillment.

Used by the Order Broker module.

 

________________________________