Merchant Stores (Source) Configuration

This solution enhances the native Inventory Management capabilities by extending stock sources with operations-oriented features for merchants.

  • Add geographic coordinates for the store location
  • Designate the source as a Store Pickup Location and specify available shipping capabilities (Ship to Store, Ship from Store)
  • Specify available pickup options (in-store or curbside), customized pickup instructions, and other information to communicate pickup details and instructions to customers

The terms source and merchant store location are used interchangeably. All records are inventory sources, but sources can also be merchant store locations, depending on the configuration settings.

Manage Merchant Stores configuration from the Admin: Stores > Inventory > Sources > Edit Source.

NOTE

During the setup process, it might be necessary to flush the cache after you create sources or update existing sources.

General

Field Description Scope Required
Latitude
Base Attribute: latitude		 Latitudinal coordinate of the merchant store location. This required information is used in location search and map placement on the storefront experience. The value must match the exact address of the store to pass validation. Global Yes
Longitude
Base Attribute: Longitude		 Longitudinal coordinate of the merchant store location. This required information is used in location search and map placement on the storefront experience. The value must match the exact address of the store to pass validation. Global Yes
Use as Pickup Location
Base Attribute: is_pickup_location_active		 Designate the source as an available Store Pickup location. This setting determines whether the source is synchronized and displayed to visitors. Global No
Enable Ship to Store
Extension Attribute: allow_ship_to_store		 Configure ship-to-store capabilities at the source level. For more information, see the [General Configuration](/docs/commerce-merchant-services/store-fulfillment/store-configuration/enable-general.html?lang=en) option, Enable Ship To Store
Latitude
Base Attribute: latitude		 Latitudinal coordinate of the merchant store location. This required information is used in location search and map placement on the storefront experience. The value must match the exact address of the store to pass validation. Global Yes
Longitude
Base Attribute: Longitude		 Longitudinal coordinate of the merchant store location. This required information is used in location search and map placement on the storefront experience. The value must match the exact address of the store to pass validation. Global Yes
Use as Pickup Location
Base Attribute: is_pickup_location_active		 Designate the source as an available Store Pickup location. This setting determines whether the source is synchronized and displayed to visitors. Global No
Enable Ship to Store
Extension Attribute: allow_ship_to_store		 Configure ship-to-store capabilities at the source level. For more information, see the [General Configuration](/docs/commerce-merchant-services/store-fulfillment/store-configuration/enable-general.html?lang=en) option, Enable Ship To Store. Global No
Enable Ship From Store
Extension Attribute: use_as_shipping_source		 Configure ship-from-store capabilities at the source level. For more information, see the [General Configuration](/docs/commerce-merchant-services/store-fulfillment/store-configuration/enable-general.html?lang=en) option, Enable Ship From Store. Global No
Global No
Enable Ship From Store
Extension Attribute: use_as_shipping_source		 Configure ship-from-store capabilities at the source level. For more information, see the [General Configuration](/docs/commerce-merchant-services/store-fulfillment/store-configuration/enable-general.html?lang=en) option, Enable Ship From Store. Global No
Field Description Scope Required
Latitude
Base Attribute: latitude		 Latitudinal coordinate of the merchant store location. This required information is used in location search and map placement on the storefront experience. The value must match the exact address of the store to pass validation. Global Yes
Longitude
Base Attribute: Longitude		 Longitudinal coordinate of the merchant store location. This required information is used in location search and map placement on the storefront experience. The value must match the exact address of the store to pass validation. Global Yes
Use as Pickup Location
Base Attribute:is_pickup_location_active		 Designate the source as an available Store Pickup location. This setting determines whether the source is synchronized and displayed to visitors. Global No
Enable Ship to Store
Extension Attribute: allow_ship_to_store		 Configure ship-to-store capabilities at the source level. For more information, see the General Configuration option, Enable Ship To Store. Global No
Enable Ship From Store
Extension Attribute: use_as_shipping_source		 Configure ship-from-store capabilities at the source level. For more information, see the General Configuration option, Enable Ship From Store Global No

Pickup Location configuration

Field Description Scope Required
Allow In-Store Pickup
Extension Attribute: store_pickup_enabled		 One of two pickup options. In-Store Pickup refers to the ability to allow a customer to enter the merchant store location to retrieve their order.

When enabled, this option might be presented to the customer during checkout.

This option also overrides the global configuration to Enable In-store Pickup that was configured on the Delivery Method for In-store Pickup		 Global No
In-Store Pickup Instructions
Extension Attribute: store_pickup_instructions		 A customizable message delivered to the customer in the Order Ready For Pickup in Store email notification. Global No
Allow Curbside
Extension Attribute: curbside_enabled		 One of two pickup options. Curbside delivery allows a customer to park their vehicle in a designated spot at the merchant store location. In this scenario, the order is delivered to the customer by a store associate.

When enabled, this option may be presented to the customer during checkout. Also, the customer might be asked to describe their vehicle and parking spot during the Check-In process.

This option also overrides the global configuration to Enable Curbside Pickup that was configured on the Delivery Method for In-store Pickup		 Global No
Curbside Instructions
Extension Attribute: curbside_instructions		 A customizable message delivered to the customer in the Order Ready For Pickup in Store email notification. Global No
Estimated Pickup Lead Time
Extension Attribute: pickup_lead_time		 The number of minutes required before an order is received, picked, and ready to be picked up.

This information is used display estimated times for order pickup to customers on the website.

Setting this option overrides the global configuration for Estimated Pickup Lead Time configured for the Delivery Method in the In-store Pickup configuration.		 Global No
Estimated Pickup Time Label
Extension Attribute: pickup_time_label		 Label that displays the number of minutes until an order is ready to be picked up.

When customizing this label, you can use the code %1 to insert your Estimated Pickup Lead Time.

Setting this option overrides the global configuration for Estimated Pickup Time Label configured for the Delivery Method in the In-store Pickup.		 Global No

Opening Hours

Field Description Scope Required
Location Timezone
Extension Attribute: timezone		 The timezone of the merchant store location. For each day, set the opening and closing times.

These settings are used to optimize estimated pickup times, and in fulfillment service reporting.		 Global Yes
Opening Hours
Internal Attribute: inventory_source_opening_hours_dynamic_rows		 The operating hours for the merchant store location.

This information can be used to optimize estimated pickup times, and in fulfillment service reporting.		 Global Yes

Configure Check-in Experience interface options

Field Description Scope Required
Use Parking Spots
Extension Attribute: parking_spots_enabled		 Specify whether the merchant store location has designation parking spots for curbside pickup.

When enabled, you can configure available parking spots.		 Global No
Is Parking Spot a Mandatory Field?
Extension Attribute: parking_spot_mandatory		 Specify whether parking spot identification is required for customers during shopping experience.

If enabled, the customer is prompted to specify their parking spot upon arrival. If disabled, the customer can skip this input.		 Global No
Parking Spots List
Internal Attribute: inventory_source_parking_spot_dynamic_rows		 The available parking spots available at this merchant store location for curbside pickup. Use the provided interface to name each spot.

You do not need to name every parking spot, only the spots designated for curbside. For example, you may have rows A-G of parking available, but only the first 8 spots of row A are designated for curbside pickup. In this scenario, you might define 8 spots; ex: A1, A2, A3, and so on.		 Global No
Allow “Other” Parking Spot Field
Extension Attribute: custom_parking_spot_enabled		 When enabled, this setting allows the customer to describe their parking spot during Check-In. Global No
Use Car Color
Extension Attribute: use_car_color		 Specify whether to support collection of vehicle color from the customer during Check-In.

The available selections for Car Color are configured in the Admin system settings for the Check-in Experience.		 Global No
Is Car Color a Mandatory Field?
Extension Attribute: car_color_mandatory		 Specify whether vehicle color identification is required for customers during Check-In.

If enabled, the customer is prompted to specify the color of their vehicle upon arrival. If disabled, the customer can skip this input.		 Global No
Use Car Make
Extension Attribute: use_car_make		 Specify whether to support collection of vehicle make from the customer during Check-In.

The available selections for Car Make are configured in the Admin system settings for the Check-in Experience.		 Global No
Is Car Make a Mandatory Field?
Extension Attribute: car_make_mandatory		 Specify whether vehicle make identification is required for customers during Check-In.

If enabled, the customer is prompted to specify the make of their vehicle upon arrival. If disabled, the customer can skip this input.		 Global No
Use Additional Information
Extension Attribute: use_additional_information		 Specify whether to support collection of additional information from the customer during Check-In. Global No
Is Additional Information a Mandatory Field?
Extension Attribute: additional_information_mandatory		 Specify whether additional information is required for customers during Check-In.

If enabled, the customer is prompted to enter additional information upon arrival. If disabled, the customer can skip this input.		 Global No

On this page