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.

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. The value 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. These issues 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. 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.

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.

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

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
recommendation-more-help
dd168ac6-a357-4bc5-ae6f-a7e463fa4dfb