Store Service and Sales Configuration
Enable Store Fulfillment extension from the Commerce Admin by configuring extension settings, the security settings for Store Assist app users, and the delivery method options.
IMPORTANTManage Store Fulfillment services settings
Manage settings for Store Fulfillment services from the Commerce Admin Store Configuration menu.
-
Enable the extension, configure global settings, and specify security options for Store Assist app user connections and accounts by selecting Stores > Configuration > Services > Store Fulfillment by Walmart Commerce Technologies.
-
Configure delivery methods by selecting Store > Configuration > Sales > Delivery Methods > In-Store Pickup.
Basic settings
| Field | Description | Scope | Required |
|---|---|---|---|
| Price | The price you charge the customer for in-store pickup. Defaults to zero. | Website | No |
| Search Radius | The radius, in kilometers, to use when a shopper searches for a store pickup location in the storefront checkout. The search results return only stores located within the specified search radius. | Website | No |
| Displayed error message | Message that displays when a customer selects in-store pickup for an item that is not available for in-store pickup. You can customize the default text if needed. | Store View | No |
NOTEEnable the Store Fulfillment solution
Enable the Store Fulfillment solution to add the in-store and curbside pickup capabilities to the shopping and checkout experiences in your Adobe Commerce storefront.
| Field | Description | Scope | Required |
|---|---|---|---|
| Enabled | Enable or disable the solution. When enabled, configure and use Store Fulfillment capabilities and establish the connection between your Adobe Commerce store and Store Fulfillment services. When disabled, all Store Fulfillment features are disabled, and there is no communication between Adobe Commerce and Store Fulfillment services. Order information cannot be processed or received. | Website | Yes |
Add Account credentials
After you configure the Account Credentials, select Validate Credentials to verify and establish a connection to the store fulfillment service for the first time.
Configure logging
Logs for store fulfillment services are available in the log file var/log/walmart-bopis.log.
Ask the system administrator to configure your environments to allow exception handling so that API-related exceptions can be captured through the firewall or cache.
Because the application log file can grow quickly, enable logging for the application only for a short time when needed–for example when troubleshooting store fulfillment issues for a Commerce order. This configuration prevents response time issues in production environments caused by large log files.
TIPvar/log/walmart-bopis.log file to minimize the size. For Adobe Commerce on-premises installations, see Log rotation in the Adobe Commerce Installation Guide. For Adobe Commerce on cloud infrastructure projects, see View and manage logs.| Field | Description | Scope | Required |
|---|---|---|---|
| Debug Mode |
Debug Mode is used to increase the logged activity within the integration. When disabled, no debug information is logged. When enabled, all debug information is logged | Global | No |
Manage Order synchronization
Configure the settings to manage error handling for order synchronization, catalog attributes to use for barcode scanning during order picking, and configure order batch sizes for the store fulfillment queue.
You can view details about order synchronization operations from the Store Fulfillment Queue Management dashboard in the Admin (
System > Tools > Store Fulfillment Queue).
Synchronization Error Management
Order Synchronization
| Field | Description | Scope | Required |
|---|---|---|---|
| Barcode Source | The catalog attribute that stores the scannable code for corresponding items in your merchant locations. If you have only one existing merchant location, it is likely that you use UPC codes, while your e-commerce channel identifies products by SKU. In this scenario, select the catalog attribute that contains the UPC code. This setting ensures that orders sent to your stores list items with the correct identifier so that store associates can accurately scan items during the picking process. If you are unsure, check with your fulfillment associates in the Shipping and Picking department to determine which attribute should be sent. If the attribute is not currently included in the database, you can add the attribute to the Adobe Commerce product attribute set. | Website | Yes |
| Barcode Type | The catalog attribute that stores the barcode source for corresponding items in your merchant locations. This setting ensures that orders sent to your stores list items with correct identifier so that store associates can accurately scan items during the picking process. The options include - SKU, UPC, GTIN, UPCA, EAN13, UPCE0, DISA, UAB, CODABAR, Price Embedded UPC. If you are unsure, select the option that most closely resembles the values contained in your Barcode Source attribute. Store associates can still match items manually from their pick list. | Website | Yes |
| Max Number of Items | The maximum number of items to send from the store fulfillment queue at one time. BOPIS orders are sent to the fulfillment service in batches, at regular intervals. This setting allows you to control the size of the batch. The default value is 100 items. Depending on your order volume and capacity, you can adjust the maximum value up or down. | Global | No |
Enable Store Fulfillment shipping options
Configure the Store Fulfillment shipping options that determine the availability of in-store pickup and home delivery options for your Adobe Commerce stores.
Ship To Store
| Field | Description | Scope | Required |
|---|---|---|---|
| Enable Ship To Store | The ship-to-store setting is based on your existing ship-to-store capabilities. If you use Inventory Management, or if you can accept and fulfill orders at merchant locations with no inventory via store-to-store inventory transfers, set this option to `Yes`. If you cannot support the ship-to-store option or do not wish to offer it, set to `No`. When disabled, items in your catalog with zero inventory for a merchant store, or items that are below the Out of Stock Threshold for that location, are not offered with in-store pickup options. You can adjust the value of this setting per merchant location. | Global | No |
Ship From Store
| Field | Description | Scope | Required |
|---|---|---|---|
| Enable Ship From Store | Enables or disables the Home Delivery option in your merchant stores. When enabled, your merchant store locations are considered in aggregate with other assigned sources in the stock associated to your website. In standard Inventory Management services, the Ship from Store is option is inherent and cannot be disabled. With the Store Fulfillment solution, you can turn it on or off. You can adjust this setting per merchant location and product. | Global | No |
Manage Store Fulfillment App use accounts and permissions
Configure the settings for the Store Fulfillment App user account and password security and two-factor authentication.
App Security
| Field | Description | Scope | Required |
|---|---|---|---|
| User Session Lifetime | The timeframe, in seconds, that a store associate user session remains active before automatic logout. Valid values range from 60 to 31536000. | Global | No |
| Maximum Login Failures to Lockout Account | Specifies the number of failed login attempts allowed before a store associate is locked out of their account. To disable account lockout, set the value to 0. | Global | No |
| Lockout Time (minutes) | Number of minutes to lock an account after login failure. | Global | No |
| Force Password Change | Yes: Require the user to change their password after account setup. No: Recommends that user change password after account setup. | Global | No |
| Password Lifetime | The number of days that a password remains valid before a required password change. Leave empty to disable this option. | Global | No |
Delivery Methods
Store Fulfillment works by extending the native Adobe Commerce In-Store Delivery capabilities. After you install the extension, you can configure in-store delivery methods using the following extended settings that are added to the Admin.
-
In-store pick up—Offer options for in-store delivery during the checkout process
These settings configure the most common delivery scenarios for BOPIS orders. -
Curbside pick up–Offer options for customers to park at a store location and have their order delivered to them by a store associate.
Configure these settings from the Admin by selecting Stores > Configuration > Sales > Delivery Methods > In-Store Pickup.
NOTEDelivery Methods configuration
With the in-store delivery method, the customer can select a source to be used as a pickup location during the checkout.
| Field | Description | Scope | Required |
|---|---|---|---|
| Enable In-Store Pickup | Enable or disable the in-store pickup option available during checkout for customers that choose store pickup. When in-store pickup is disabled, the option is not displayed. This global setting applies to all retail store locations. When enabled, you can selectively disable it at the retail store location. | Website | No |
| Enable Curbside Pickup | Enable or disable the curbside pick up option during the checkout process for customers that choose store pickup. This global setting applies to all retail store locations. When enabled, you can selectively disable it at the retail store location. | Website | No |
Delivery Method Title configuration
| Field | Description | Scope | Required |
|---|---|---|---|
| Home Delivery Title | Specifies the title to display for the Home Delivery option in the product, cart, and checkout areas. Home delivery refers to the standard shipping capabilities of Adobe Commerce—from a warehouse, by a carrier, or direct to the customer-provided shipping address. This label does not affect the shipping method labels for the selected shipping carrier. | Store View | No |
| Home Delivery Description | An optional description that displays whenever the Home Delivery Title is shown to customers. Most often, the description is a static message to communicate your delivery promises. Some examples:Same-day shipping on orders by 4Ships within 2 business days | Store View | No |
| Store Pickup Title | When a customer is presented with delivery options and in-store pickup is available, this label is shown. You can customize this label, which displays in the product, cart, and checkout areas. | Store View | No |
| Store Pickup Description | Wherever the Store Pickup Title is shown, you can optionally include a description. This static message helps improve customer communications related to the store pickup experience. Some examples:Get it today for free!Ready for pickup in an hour! | Store View | No |
| In-Store Pickup Title | When In-Store Pickup is enabled, this title is shown to customers as the Store Pickup delivery option. You can customize its label. | Store View | No |
| Curbside Pickup Title | When Curbside Pickup is enabled, the option is shown to customers as a type of Store Pickup delivery option. You can customize its label here. | Store View | No |
| In-Store Pickup Instructions | When an order is ready for pickup at your retail stores, the customer is notified by e-mail. If the customer selected In-Store Pickup during checkout, you can customize the pickup instructions here. These instructions are set globally and apply to all retail store locations. You can also customize the instructions at the retail store location level. | Store View | No |
| Curbside Pickup Instructions | Specifies customized order pickup instructions to include in customer email notifications for curbside pickup orders. These instructions are set globally and apply to all retail store locations. You can also customize the instructions at the retail store location level. | Store View | No |
| Estimated Pickup Lead Time | The number of minutes required before an order is received, fulfilled, and ready to be picked up. This information is shown to the customer when selecting a retail store location for Store Pickup delivery option. This setting applies to all retail store locations. You can also customize the lead time at the retail store location level. | Store View | No |
| Estimated Pickup Time Label | Displays the estimated time until an order is available for customer pickup. This information is shown to customers when they select a retail store location for the In-Store Pickup delivery option. When customizing this label, you can use the code %1 to insert your Estimated Pickup Lead Time. For example:Ready for Pickup in %1 minutes.This setting applies to all retail store locations. You can also customize the lead time at the retail store location level. | Store View | No |
| Pickup Time Disclaimer | The content displayed on the product page in the tooltip that lists store hours, holidays, unexpected closures, and so on | Store View | No |