Walmart Marketplace is a vital online channel, empowering third-party sellers to tap into millions of U.S. customers. It offers access to Walmart’s vast customer base, competitive pricing tools, and fulfillment options like Walmart Fulfillment Services (WFS) for expedited shipping. This guide details the Flxpoint integration with Walmart, covering how to publish listings with validated data, sync inventory and pricing, import and manage orders, and sync shipment details. It also includes best practices for setup, such as batch publishing, category mapping per Walmart’s taxonomy, and ensuring shipping configurations, to streamline operations and maximize success on the platform.
How to Connect
Step 1: Log into your Flxpoint account and navigate to the Connections section, then select Sales Channels.
Step 2: Click on Add Channel to start your Walmart integration.
Step 3: In the popup, select Walmart as your channel, enter a channel name, and click Continue.
Step 4: Obtain your Walmart API credentials.
Log in to the Walmart Developer Portal.
Click Add New Key for a Solution Provider.
Select Flxpoint from the dropdown and click Next.
Provide access permissions as shown in the video tutorial, then click Submit.
Required Permissions:
Feeds: View Only
Content: Full Access
Inventory: Full Access
Price: Full Access
Lag Management: Full Access
Orders: Full Access
Returns: Full Access
Fulfillment: Full Access
Settings, Rules, and Admin: Full Access
Shipping: Full Access
Reports: View Only
Note down your Client ID and Client Secret.
Step 5: Enter your Walmart authentication details in Flxpoint.
In the Environment field, select either Sandbox or Production.
Enter your Client Secret and Client ID obtained from Step 4.
If applicable, specify the Consumer Channel Type (required for Walmart Canada).
Enter the Country Code (e.g., US for the United States).
Click Continue to authenticate your Walmart account.
Troubleshooting: If authentication fails, verify your Client ID and Client Secret, and ensure the correct environment is selected.
Step 6: Configure your Walmart integration settings.
Publish Listings: Enable to create and publish products to Walmart. Ensure required fields like Weight, Brand, and UPC are populated, and map categories using Walmart’s Category Mapping Guide.
Sync Listings: Enable to sync pricing and inventory data with Walmart, setting the linking identifier (e.g., UPC).
Get Orders: Enable to import orders from Walmart, selecting order statuses and time range for import.
Sync Orders: Enable to sync order and shipment data with Walmart, including order status updates.
Step 7: Click Continue to finalize the setup. Your Walmart channel is now connected.
A confirmation message will appear: “Success! Your connection to Walmart was created successfully and your selected operations have been configured.”
Step 8: Manage your Walmart integration.
In the Channels > Walmart section, you’ll see the status as Active with options to Run Sync, View Logs, Adjust Schedule, or Edit Integration Settings.
Tip: Use the Integration Settings to fine-tune operations like publishing, syncing listings, or managing orders.
For support, contact support@flxpoint.com (available 24/7 via email).
×
Listing Operations
Import Listings
Not Supported
Sync & Link Listings
Supported | Walmart - Sync & Link Listings
Introduction to Walmart Sync & Link Listings Integration
This guide helps you set up the Sync & Link Listings integration for Walmart on Flxpoint. It ensures that changes in price, quantity, or status of your listings are updated on Walmart, maintaining accurate and up-to-date listings across platforms. Let’s get started!
Purpose of This Integration
This integration keeps your Walmart listings in sync with your Flxpoint catalog data, ensuring consistency:
- Updates price and quantity on Walmart listings based on your Flxpoint catalog.
- Links Flxpoint products to existing Walmart listings using UPC or SKU.
- Supports delisting products to manage availability.
It simplifies maintaining accurate listings on Walmart directly from Flxpoint.
How the Integration Works
The integration follows these steps:
1. Linking: For existing listings, Flxpoint uses GET on the endpoint
items?nextCursor=*
to retrieve SKU and UPC data. 2. Price/Quantity Sync: Updates price and quantity by submitting to
feeds?feedType=INVENTORY
for inventory and feeds?feedType=PRICE
for pricing. 3. Acknowledgement: Receives an Acknowledgement ID after each feed submission.
4. Processing Report: Downloads the feed processing report to check for errors; if no errors, marks inventory/price as synced.
5. Delisting: To delist, hits the endpoint
items/{sku}
with a single SKU per call to remove the listing. 6. Execution: Runs manually via "Run Sync" or on a schedule via "Adjust Schedule."
Configuration Options
Customize how your listings are synced with these settings:
- Enable Sync Listings: Turn on to synchronize pricing and quantity with Walmart.
- Linking Identifier: Choose UPC or SKU to link Flxpoint products to Walmart listings.
- Fulfillment Lag Time: Specify the number of days between order and shipment (required for Walmart Canada).
- Auto Delist When Out of Stock: Enable to automatically delist products that are out of stock.
Setup Instructions
Follow these steps to configure the Sync & Link Listings integration:
1. Enable Sync Listings: Go to the Walmart channel settings, find "Sync Listings," and toggle it on.
2. Configure Linking Identifier: Select UPC or SKU as the identifier to link Flxpoint products to Walmart listings.
3. Set Fulfillment Lag Time: Provide the lag time for Walmart Canada (number of days between order and shipment).
4. Enable Auto Delist: Toggle on "Auto Delist When Out of Stock" to automatically delist out-of-stock products.
5. Create a Mapping Template: Use "Manage Mapping" to define which fields to sync (see below).
6. Run the Integration: Start manually with "Run Sync" or schedule via "Adjust Schedule."
Mapping Template Details
The mapping template controls which data fields are synced from Flxpoint to Walmart. You can enable or disable fields to customize the syncing process.
Interface Overview
- The mapping screen is labeled “Flxpoint → Walmart” under “Sync Listings.”
- Buttons: Cancel and Save Mapping.
- Columns: Left (Flxpoint fields), Right (Walmart fields).
Mapping Options
- Enable: Sync the field (e.g., enable “List Price”).
- Disable: Ignore the field (e.g., disable “SKU” if not needed).
Available Fields
- Walmart Variant: List Price (maps to Walmart Variant: Item Price), Quantity (maps to Walmart Variant: Quantity), SKU (maps to Walmart Variant: SKU).
Limitations
Be aware of the following limitations:
- Hiding: Not supported. Walmart does not support hiding products; use delisting instead.
- Unhiding: Not supported. Walmart does not allow unhiding previously delisted products; you must relist them manually.
Troubleshooting
If you encounter issues:
- Sync Not Updating: Check the mapping template to ensure fields like price and quantity are enabled.
- Delisting Not Working: Verify the SKU is correct and the product exists on Walmart. Note: Auto-delisted items need to be republished to become listed again.
- Auto-Delist Not Triggering: Ensure the "Auto Delist When Out of Stock" option is enabled and the product’s quantity is zero. Use override job to un-retire if needed.
- Sync Not Running: Confirm the sync schedule or run manually with "Run Sync."
Conclusion
With this integration, you can efficiently sync and link listings between Flxpoint and Walmart, ensuring your pricing, quantity, and status are always up-to-date while managing availability with the auto-delist feature.
Publish Listings
Supported | Walmart - Publish Listings
Introduction to Walmart Publish Listings Integration
This guide helps you set up the Publish Listings integration for Walmart on Flxpoint. It enables you to create and publish channel listings directly from your Flxpoint catalog to Walmart, streamlining product listing management. Let’s dive in!
Purpose of This Integration
This integration allows you to push your Flxpoint catalog data to Walmart as listings, simplifying the process of getting your products live on the channel:
- Creates new listings on Walmart using product data from your Flxpoint catalog.
- Maps Flxpoint product fields to Walmart fields for accurate listing details.
- Updates inventory and shipping templates for seamless operations.
It simplifies publishing and managing listings on Walmart directly from Flxpoint.
How the Integration Works
The integration follows these steps:
1. Authentication: Uses basic auth for secure access.
2. Feed Submission: Submits product feed to the endpoint
feeds?feedType=MP_ITEM
for the US or feeds?feedType=item
for Canada, using JSON for the US and XML for Canada. 3. Acknowledgement: Receives an Acknowledgement ID after posting the feed.
4. Processing Report: Downloads the feed processing report from
feeds/{ackID}
to check for errors. 5. Listing Confirmation: Marks products as listed if no errors are found in the report and saves the SKU as the external listing ID.
6. Inventory Update: Updates inventory using the endpoint
feeds?feedType=inventory
, retrieves a new Acknowledgement ID, and marks inventory as synced if no errors occur. 7. Shipping Template Update: If a shipping template is configured, updates it via
feeds?feedType=SKU_TEMPLATE_MAP
. 8. Execution: Processes products in batches of 1000 and runs manually via "Run Sync" or on a schedule via "Adjust Schedule."
Configuration Options
Customize how your listings are published with these settings:
- Enable Publish Listings: Turn on to create and publish listings to Walmart.
- Shipping Template ID: Provide a Walmart shipping template ID (optional, defaults to account settings).
- Fulfillment ID: Specify a Walmart fulfillment ID (optional).
- Listing End Date: Set the duration for listings (default is 1 year, up to 5 years or 1825 days).
- Fulfillment Lag Time: Define the number of days between order and shipment (specific to Walmart Canada).
- Tax Code: Set the Walmart tax code (recommended: 2038710 for general products).
- Shipping Cost: Optionally set a uniform shipping cost for all products (overridden by the shipping template if configured).
- Remove Free Shipping: Toggle to disable free shipping if needed.
- Ship Method and Region: Select the shipping method and region for the listings.
- Product ID Overrides: Enable SKU or UPC overrides to update existing Walmart listings (do not enable both).
Setup Instructions
Follow these steps to configure the Publish Listings integration:
1. Configure Connection: In Flxpoint, set up Walmart channel with credentials:
- Seller ID: Your unique Walmart Seller ID (e.g., test_seller_12345).
- Consumer ID: Your Consumer ID (e.g., test.consumer.id_67890).
- Private Key: Your Private Key (e.g., myFakePassword123).
- Market: Set to US.
- Endpoint: Use
wa1martapis.com/v3/
. - Feeds: Enable Inventory Feed, Listing Feed, and Order Import.
2. Enable Publish Listings: Go to the Walmart channel settings, find "Publish Listings," and toggle it on.
3. Configure Shipping Templates: In Walmart, navigate to Settings > Shipping Profile > Seller Fulfillment > Shipping Templates to set up templates defining shipping regions, lead times, and costs. Note the Template ID, Fulfillment ID, and Tax Code (recommended: 2038710). Input these in Flxpoint under "Publish Listings" settings.
4. Input Settings: Provide the necessary details in Flxpoint:
- Shipping Template ID: Enter the Template ID from Walmart (optional).
- Fulfillment ID: Enter the Fulfillment ID from Walmart (optional).
- Listing End Date: Set the listing duration (default: 1 year, max: 5 years).
- Fulfillment Lag Time: Specify the lag time for Walmart Canada.
- Tax Code: Use 2038710 or a custom code as needed.
5. Create a Mapping Template: Use "Manage Mapping" to define which fields to publish (see below).
6. Run the Integration: Start manually with "Run Sync" or schedule via "Adjust Schedule." Use "View Logs" to monitor progress.
Mapping Template Details
The mapping template controls which data fields are published from Flxpoint to Walmart. You can enable or disable fields to customize the publishing process.
Interface Overview
- The mapping screen is labeled “Flxpoint → Walmart” under “Publish Listings.”
- Buttons: Cancel and Save Mapping.
- Columns: Left (Flxpoint fields), Right (Walmart fields).
Mapping Options
- Enable: Publish the field (e.g., enable “UPC”).
- Disable: Ignore the field (e.g., disable “MPN”).
Available Fields
- Walmart Variant: Brand (maps to Walmart Variant: manufacturer), MainCategory (maps to Walmart Variant: MainCategory), SubCategory (maps to Walmart Variant: SubCategory), Description (maps to Walmart Variant: Description), Shipping Cost (maps to Walmart Variant: Shipping Cost), Images (maps to Walmart Variant: Images), Item Condition (maps to Walmart Variant: Item Condition), Item Price (maps to Walmart Variant: Item Price), MPN (maps to Walmart Variant: MPN), Quantity (maps to Walmart Variant: Quantity), SKU (maps to Walmart Variant: SKU), Title (maps to Walmart Variant: Title), UPC (maps to Walmart Variant: UPC), Weight (maps to Walmart Variant: Weight).
Required Fields
To publish a new product on Walmart, ensure these fields are provided:
- GTIN or UPC: Must be valid (at least 12 characters).
- Product Image: High-quality image matching Walmart’s standards.
- Product Description: Clear, concise, and compliant with Walmart guidelines.
- Product Brand: Correct brand name as registered with Walmart.
- Shipping Weight: Mandatory for all products; must not be empty.
- Product Category: Must align with Walmart’s taxonomy (View Categories).
Supported Features
- Generic Pricing & Currency, Weights & Dimensions, Images, Categories, Overwriting Supported.
- Unsupported: Custom Fields, Variations (e.g., multiple options).
Limitations
Be aware of the following limitations:
- The system does not create brand-new listings for products that do not already exist in Walmart’s database.
- Default “Listing End Date” is set to 1 year from publication (can be updated to a maximum of 5 years or 1825 days).
Troubleshooting
If you encounter issues:
- Product Not Uploading to Store: Check eligibility conditions:
- Item condition must be New or Refurbished.
- Subcategory must match Walmart’s taxonomy; confirm mappings for main/subcategory if using a "Pro" Walmart account.
- Required headers (Weight, Country Code, UPC/GTIN, Image, Manufacturer, Description) must not be empty. Use high-quality images and clear descriptions.
- Fields Not Publishing: Verify the field is enabled in the mapping template (e.g., List Price, Quantity).
- Sync Not Running: Confirm the sync schedule or run manually with "Run Sync." Use "View Logs" to diagnose issues.
- Shipping Issues: Ensure the shipping template is correctly configured in Walmart’s settings with Tax Code 2038710 and shipping text (Value, Two Day).
Conclusion
With this integration, you can efficiently publish listings from your Flxpoint catalog to Walmart, ensuring your products are accurately listed on the channel with minimal effort.
Order Operations
Get Orders
Supported | Walmart - Get Orders
Introduction to Walmart Get Orders Integration
This guide helps you set up the Get Orders integration for Walmart on Flxpoint. It enables you to import new orders from Walmart into your Flxpoint system, ensuring seamless order management. Let’s get started!
Purpose of This Integration
This integration retrieves new orders from Walmart that have not yet been imported, streamlining order processing:
- Imports orders based on specified statuses and date ranges.
- Sends acknowledgments for imported orders if needed.
- Maps Walmart order data to Flxpoint for accurate order fulfillment.
It simplifies the process of managing Walmart orders directly within Flxpoint.
How the Integration Works
The integration follows these steps:
1. Order Retrieval: Orders are downloaded using the GET method on the endpoint
orders?createdStartDate=&status=
, with start date and order status as parameters. 2. Fulfillment Type: Filters orders by fulfillment type (Seller/WFS/3PL) as specified in settings.
3. Acknowledgment: Sends an acknowledgment after order download via the endpoint
orders/{orderId}/acknowledge
if the order status is updated as Acknowledged. 4. Execution: Runs manually via "Run Sync" or on a schedule via "Adjust Schedule."
Configuration Options
Customize how orders are imported with these settings:
- Enable Get Orders: Turn on to import orders from Walmart.
- Order Statuses: Select statuses to import (Created, Acknowledged, Shipped, Delivered, Cancelled).
- Fetch Orders for the Last X Days: Set the date range for fetching orders (default: 5 days, options up to 60 days).
- Fulfillment Type: Choose the fulfillment type (Seller Fulfilled, WFS Fulfilled, 3PL Fulfilled).
- Personal Identifying Information Retention: Set the duration to retain personal data (Indefinitely, 30/60/90 days after shipment).
Setup Instructions
Follow these steps to configure the Get Orders integration:
1. Configure Shipping Mapping: Ensure Walmart’s shipping mapping is set up in Settings > Shipping Profile > Seller Fulfillment > Shipping Templates to define shipping methods (e.g., Value, Standard, Two-Day).
2. Enable Two-Day Shipping (Optional): If offering two-day shipping, apply and get approval from Walmart prior to enabling it on product sales.
3. Enable Get Orders: Go to the Walmart channel settings, find "Get Orders," and toggle it on.
4. Configure Settings: Set the following:
- Order Statuses: Select the statuses to import (e.g., Created, Acknowledged).
- Fetch Orders for the Last X Days: Choose a date range (e.g., 5-60 days).
- Fulfillment Type: Select the appropriate type (e.g., Seller Fulfilled).
- Personal Identifying Information Retention: Set the retention period (e.g., Indefinitely, 30/60/90 days post-shipment).
5. Create a Mapping Template: Use "Manage Mapping" to define which order fields to import (see below).
6. Run the Integration: Start manually with "Run Sync" or schedule via "Adjust Schedule."
Mapping Template Details
The mapping template controls which order data fields are imported from Walmart to Flxpoint. You can enable or disable fields to customize the import process.
Interface Overview
- The mapping screen is labeled “Walmart → Flxpoint” under “Get Orders.”
- Buttons: Cancel and Save Mapping.
- Columns: Left (Walmart fields), Right (Flxpoint fields).
Mapping Options
- Enable: Import the field (e.g., enable “Item Price”).
- Disable: Ignore the field (e.g., disable “Address 2”).
Available Fields
- Walmart Order: Item Price (maps to Order Line Item: Price), Quantity (maps to Order Line Item: Quantity), SKU (maps to Order Line Item: SKU), Title (maps to Order Line Item: Title), Address 1 (maps to Shipping/Billing Address: Address Line 1), Address 2 (maps to Shipping/Billing Address: Address Line 2), Shipping Method (maps to Order: Channel Shipping Text), City (maps to Shipping/Billing Address: City), Country Code (maps to Shipping/Billing Address: Country Code), Order Date (maps to Channel Invoice: Created On, Order: Ordered On), Ship Name (maps to Shipping/Billing Address: Full Name), Total Price (maps to Order: Order Total, Channel Invoice: Total), Phone (maps to Shipping/Billing Address: Phone), Postal Code (maps to Shipping/Billing Address: Postal Code), Shipping Total (maps to Channel Invoice: Shipping Cost), State (maps to Shipping/Billing Address: State), Total Tax (maps to Channel Invoice: Tax Cost).
Limitations
Be aware of the following limitations:
- Custom Fields: Not supported. Custom fields are not imported.
- PII Restrictions: Personal identifying information is redacted after the retention period set in the configuration.
- Digital Items/Donations: Not supported. Orders involving digital items or donations are not imported.
Troubleshooting
If you encounter issues:
- Orders Not Importing:
- Check Order Status: Ensure the order status on Walmart matches the selected statuses in Flxpoint (e.g., if set to "Created," orders marked "Completed" won’t import).
- Check Date Range: Verify the order’s creation date falls within the "Fetch Orders for the Last X Days" setting (e.g., if set to 7 days, a 10-day-old order won’t import). Adjust to 5-60 days as needed.
- Shipping Issues: Confirm that Walmart’s shipping mapping is properly configured to support the selected fulfillment type and shipping methods (e.g., Value, Standard, Two-Day).
- Sync Not Running: Verify the sync schedule or run manually with "Run Sync."
Conclusion
With this integration, you can efficiently import and manage Walmart orders in Flxpoint, ensuring accurate order processing and fulfillment while adhering to Walmart’s shipping and fulfillment requirements.
Sync Orders
Supported | Walmart - Sync Orders
Introduction to Walmart Sync Orders Integration
This guide helps you set up the Sync Orders integration for Walmart on Flxpoint. It ensures that order data, such as shipment details, is synchronized between Flxpoint and Walmart, keeping your order status up-to-date. Let’s get started!
Purpose of This Integration
This integration synchronizes order data between Flxpoint and Walmart, ensuring consistency:
- Updates Walmart with shipment details (carrier, method, tracking number, URL) from Flxpoint.
- Automatically updates the order status to Shipped on Walmart once fully shipped.
- Maps Flxpoint shipment fields to Walmart for accurate tracking information.
It simplifies the process of keeping order data in sync on Walmart directly from Flxpoint.
How the Integration Works
The integration follows these steps:
1. Shipment Update: Posts shipment details using the endpoint
orders/{orderId}/shipping
. 2. Eligibility Check: Only fully shipped orders are eligible for syncing.
3. Status Update: Automatically updates the order status to Shipped on Walmart after syncing.
4. Execution: Runs manually via "Run Sync" or on a schedule via "Adjust Schedule."
Configuration Options
Customize how orders are synced with these settings:
- Enable Sync Orders: Turn on to synchronize order data with Walmart.
- Additional Settings: Currently, there are no additional settings to configure for this operation.
Setup Instructions
Follow these steps to configure the Sync Orders integration:
1. Enable Sync Orders: Go to the Walmart channel settings, find "Sync Orders," and toggle it on.
2. Create a Mapping Template: Use "Manage Mapping" to define which shipment fields to sync (see below).
3. Run the Integration: Start manually with "Run Sync" or schedule via "Adjust Schedule."
Mapping Template Details
The mapping template controls which shipment data fields are synced from Flxpoint to Walmart. You can enable or disable fields to customize the syncing process.
Interface Overview
- The mapping screen is labeled “Flxpoint → Walmart” under “Sync Orders.”
- Buttons: Cancel and Save Mapping.
- Columns: Left (Flxpoint fields), Right (Walmart fields).
Mapping Options
- Enable: Sync the field (e.g., enable “Carrier”).
- Disable: Ignore the field (e.g., disable “Tracking URL”).
Available Fields
- Walmart Fulfillment: Carrier (maps to Walmart Fulfillment: Carrier Name), Method (maps to Walmart Fulfillment: Shipping Method), Tracking Number (maps to Walmart Fulfillment: Tracking Number), Tracking URL (maps to Walmart Fulfillment: Tracking URL).
Limitations
Be aware of the following limitations:
- Eligibility: Only fully shipped orders are eligible for syncing.
- Platform Notify Customer Flow: Not supported. Walmart does not support notifying customers via this flow.
- Partial Order Shipments: Not supported. Only fully shipped orders can be synced.
- Partial Order Item Shipments: Not supported. All items in the order must be shipped.
- Post-Shipment Status Updates: Not supported. Only the Shipped status is updated automatically.
- Manual Order Item Limitations: Not supported. Manual updates to individual items are not synced.
Troubleshooting
If you encounter issues:
- Order Not Syncing: Ensure the order is fully shipped, as only fully shipped orders are eligible for syncing.
- Fields Not Syncing: Check the mapping template to confirm the fields (e.g., Carrier, Tracking Number) are enabled.
- Sync Not Running: Verify the sync schedule or run manually with "Run Sync."
Conclusion
With this integration, you can efficiently sync order shipment details from Flxpoint to Walmart, ensuring accurate tracking information and order status updates with minimal effort.