Store Service and Sales Configuration

Configure Store Fulfillment from the Commerce Admin to enable the extension, specify extension settings, configure the security settings for Store Assist app users, and set options for delivery methods.

IMPORTANT

The Store Fulfillment service configuration applies only after you connect your Adobe Commerce instance and the Store Fulfillment app. See Connect Store Fulfillment.

Manage 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.

    Admin Store services configuration for Store Fulfillment

  • Configure delivery methods by selecting Store > Configuration > Sales > Delivery Methods > In-Store Pickup.

    Admin Store sales configuration for Store Fulfillment

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
NOTE

The Search Radius setting is used only if you have configured the store location and mapping setup for Adobe Commerce.

Enable 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

Field Description Scope Required
Environment Select either Sandbox or Production

Selecting Sandbox enables communication with fulfillment services in a test environment.

Selecting Production enables communication with fulfillment services in a live environment.

You are given a set of credentials for each environment and can manage both sets in the same installation.

Save the credentials before validating the connection.		 Global Yes
API Server URL The URL to the Walmart Store Fulfillment API endpoint. This must be the fully qualified URL that is provided during the onboarding process. Store Fulfillment customers receive both a Sandbox and Production URL. When adding the values, ensure that you copy and paste the full URL, including trailing slash "/". Global Yes
Token Auth Server URL The URL to the Walmart Store Fulfillment Authentication endpoint. The value must be the fully qualified URL that is provided during the onboarding process. You receive both a Sandbox and Production URL. When adding the values, ensure that you copy and paste the full URL, including trailing slash "/". Global Yes
Merchant Id Your unique merchant (tenant) ID provided during the onboarding process. This ID is used to route orders to ensure that your merchant stores receive them. Global Yes
Consumer Id The unique integration ID provided during the onboarding process. This ID is used to authenticate all communication between Adobe Commerce and store fulfillment services Global Yes
Consumer Secret The unique integration key provided during the onboarding process. This key is used to authenticate all communication between Adobe Commerce and store fulfillment service. Global Yes

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.

TIP

For Adobe Commerce on-premises installations, ask your system administrator to set up log rotation for the var/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

All logged data can be found in the file: 
var/log/walmart-bopis.log
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

Field Description Scope Required
Retry Critical Error Specifies the retry attempts for a record synchronization operation after a critical error occurs.

Critical errors occur anytime the integration fails to get a positive response from the fulfillment service. This can occur when the service is down or when there is an error in the order data being sent.

When the retry threshold is reached, the item remains in a queue but is not processed again. View all items with errors from System > Tools > Store Fulfillment Queue Management in the Admin. To troubleshoot consistently failing items, contact your Account Manager.		 Global No
Enable Error Notification Email Enable error notifications to receive an email when the Retry Critical Error Threshold is reached for an order. The notification includes any available details about the error. Global No
Send Error Notification Email To A comma-delimited list of recipient email addresses for error notifications. Global No
Order Sync Exception Email Template Specifies the email template used to notify recipients about order synchronization errors. A default template is provided. It does not support customization. Store View No

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. If this is your 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. You might need to add the appropriate attribute to the Adobe Commerce product attribute set if the attribute is not currently included in the database.		 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 might need to adjust this 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 that location's Out of Stock Threshold, are not offered with in-store pickup options.

This is a global setting that can be adjusted 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.

This is a global setting. You can also 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
    This is the most common delivery scenario 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.

NOTE

For additional information about configuring in-store delivery options, see In-Store Delivery in the Adobe Commerce User Guide.

Delivery 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 4

Ships 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.

This is a global setting that applies 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.

This is a global setting that applies 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 is a global setting and 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 is a global setting that 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

Stock Availability Titles configuration

Field Description Scope Required
In-Stock When a customer is using the retail store locator, inventory availability for the current items is shown for each location.

You can customize the in-stock status label here.		 Store View No
Out-of-Stock When a customer is using the retail store locator, inventory availability for any current items is shown for each location. Store View No
Partially In-Stock When a customer is using the retail store locator, inventory availability for any current items ia shown for each location.

You can customize the partially in-stock status label here.		 Store View No

On this page