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
📋 Phase 1: Start & Create Channel
+
Open Sales Channels and click +
You’ll see the channel selector. Search and choose Walmart.
Name the channel & select processes
Suggested name: Walmart. Choose what you need and click Save & Next:
- Publish Listings – send product data from Flxpoint to Walmart.
- Sync Listings – bring listing changes from Walmart into Flxpoint.
- Get Orders – import Walmart orders into Flxpoint.
- Sync Orders – send shipment/tracking updates back to Walmart.
Intro page
Review the brief intro and click Save & Next.
🔐 Phase 2: Confirm Integration & Get Walmart Credentials
+
Tip: you’ll need API keys from your Walmart Developer account to connect.
Confirm integration type
Ensure Walmart is selected, then continue.
How to obtain Client ID & Client Secret
From your organization’s Walmart Developer Center:
- Sign in at developer.walmart.com.
- Go to API Keys → Add New Key for a Solution Provider.
- Select Flxpoint as the Solution Provider.
-
Common permissions:
- Content, Inventory, Price, Orders, Returns, Fulfillment – Full Access
- Settings/Rules/Admin, Shipping – Full Access
- Feeds/Reports – View (as needed)
- Copy your Client ID and Client Secret.
- Walmart Canada: note your Consumer Channel Type value.
Don’t see API Keys? Ask your Walmart account admin to grant access or create the keys for you.
🧭 Phase 3: Wizard Configuration Pages (Set Now or Later)
+
After entering your credentials, the wizard guides you through key configuration pages. You can complete them now (recommended) or skip and finish them later from the channel page.
Listing Management pages
- Pricing & Quantity Rules — set markups/markdowns and stock buffers used when publishing to Walmart.
- Link Settings — link existing Walmart listings to your products to avoid duplicates.
- Sync Settings — decide what data pulls from Walmart into Flxpoint (status/price/quantity if applicable).
- Publish Settings — choose which product fields Flxpoint sends to Walmart.
Order Fulfillment pages
- Order Settings — routing preferences, timing windows, cancellations.
- Shipping Mappings — map Walmart shipping services to your carriers/service levels.
- Get Orders — enable order import and set the cadence.
- Sync Orders — enable sending shipment confirmations/tracking back to Walmart.
New to this? If unsure, configure basics now (Pricing/Quantity, Shipping Mappings), then test with a small set of items before scaling.
✅ Phase 4: After the Wizard — What You’ll See & How to Use It
+
Where you land: your Walmart channel page with a left menu (Integrations, Invoicing, Pricing/Quantity, Listing Status, In-Store, Shipping Mappings, Settings, Admin). The center shows operations you can configure/run.
Core operations (you’ll use these most)
-
Import Listings — What: pull existing Walmart listings into Flxpoint (creates/updates products/listings).
When: already live on Walmart and want Flxpoint to mirror them.
Tip: great first run for established catalogs. -
Publish Listings — What: push product data from Flxpoint to Walmart.
When: launching or updating products.
Tip: confirm Pricing & Quantity rules first. -
Get Orders — What: import new Walmart orders into Flxpoint.
When: ready to process orders here.
Tip: set Order Settings and Shipping Mappings beforehand. -
Sync Orders — What: send shipment/tracking back to Walmart.
When: after fulfillment.
Tip: make sure carrier/service mappings are correct.
Custom Export Operation (extra)
What: export listing data to CSV/XLSX for audits, offline edits, or sharing.
When: you need a snapshot outside the system.
Tip: choose only needed columns (SKU, Title, Price, Quantity, Status) to keep files small.
When: you need a snapshot outside the system.
Tip: choose only needed columns (SKU, Title, Price, Quantity, Status) to keep files small.
Other sections you’ll likely touch
- Pricing / Quantity — markups and buffers used by Publish.
- Listing Status — readiness/errors before Publish.
- Shipping Mappings — service-level mapping.
- Invoicing — invoice preferences if applicable.
- Settings — channel-specific defaults.
- Admin — advanced/admin tools.
Quick first-run checklist: Pricing & Quantity ✔️ | Shipping Mappings ✔️ | Test with 1–2 items/orders ✔️
Listing Operations
Import Listings
Not Supported
Sync & Link Listings
Supported
Introduction
Sync Listings keeps your Walmart price/quantity/SKU in sync with your Flxpoint listings. You’ll (1) connect Walmart, (2) choose a few settings (like Auto Delist and Fulfillment Lag Time), (3) define how we link your listings using “Linking Priority,” and (4) pick a mapping template. When a step is finished, you’ll see a check mark.
-
1Connect Walmart:
Choose Walmart as the Integration Type, select (or create) your Connection,
then click Save and Proceed.
Where do I get the keys? In Walmart Seller Center → API Keys, generate a Client ID and Secret. Paste them in Flxpoint when creating the Walmart connection.
-
2Configure Settings:
- Auto Delist when product is out of stock — If enabled, we call Walmart’s delist endpoint when quantity hits 0 so shoppers can’t buy sold-out items.
-
Fulfillment Lag Time — The number of days between order and ship.
Walmart Canada requires this.
Example: If you ship the next business day, set this to
1. - Linking Priority — Tells Flxpoint how to match each Flxpoint listing to its Walmart listing (e.g., Listing Variant → SKU ↔ Walmart Variant → SKU). We try the rows from top to bottom until a match is found.
- 3Define a Mapping Template: Select your Sync Listings template (e.g., Sync Listings 1) so we know which fields to send to Walmart (Price, Quantity, SKU). Click Save and Proceed.
- 4Automate (optional): Turn on a schedule (e.g., Every Day and Every Hour) and click Update.
What you’ll see
- Three wizard steps on the page: Connect an Integration, Configure Settings, Define a Mapping Template — each shows a check mark when completed.
- In Configure Settings, a tooltip explains Linking Priority (“we try mappings top to bottom”).
- On the Configure screen, the Automate area lets you enable a schedule.
Template Index
| Template | Use Case | What it Covers | Availability |
|---|---|---|---|
| Sync Listings 1 | Keep Walmart price/qty in sync | Maps List Price → Item Price, Quantity → Quantity, SKU → SKU. | Available |
Field Mapping (Sync Listings 1)
Friendly view of how your Flxpoint listing fields flow to Walmart.
| Flxpoint Field (From) | Walmart Variant Field (To) | Type | Required? | Notes for You |
|---|---|---|---|---|
| Listing Variant → List Price | Item Price | Number | Yes | Use rules if you need pricing adjustments or rounding. |
| Listing Variant → Quantity | Quantity | Number | Yes | Reflects available stock. |
| Listing Variant → SKU | SKU | Text | Yes | Primary match key for Linking Priority. |
Linking Priority (Link Listings): Add rows like Listing Variant → SKU ↔ Walmart Variant → SKU.
Drag to re-order. We try row #1, then #2, and so on until a match is found.
Rules You Can Use
| Rule | Type | Input | When it Helps | What it Does |
|---|---|---|---|---|
| Markup price by % | Number | Price | Create your Walmart selling price from cost or list price | Applies a percentage increase and can round to 0.99. |
| Clamp min/max quantity | Number | Quantity | Prevent over-listing or under-listing | Forces the sent qty within your safe range (e.g., 1–50). |
| When SKU starts with … then set value | String | SKU | Account for vendor prefixes | Outputs a different field or flag when the pattern matches. |
Create your own rule: Go to Mapping Utilities → Mapping Rules, click Create New Rule,
choose the rule type (String/Number/Conditional), and configure your logic.
Sets, Lists & Builders
| Utility | Availability | How You Might Use It |
|---|---|---|
| Mapping Sets | Optional — available | Combine multiple inputs (e.g., base price + fee) into one output. |
| Lists | Optional — available | Keep reusable value lists (approved brands, restricted SKUs). |
| Builders | Optional — available | Create custom outputs if your Walmart workflow needs them. |
Quick Checks
- Walmart connection shows on Step 1 and is saved.
- Fulfillment Lag Time is set (required for Walmart Canada).
- Linking Priority includes at least one reliable pair (usually SKU ↔ SKU).
- A Sync Listings mapping template (e.g., Sync Listings 1) is selected.
- If you need automation, enable a schedule and click Update.
Operation Details (What’s included)
| Feature | Availability | What to Expect |
|---|---|---|
| Hiding | Not supported | Use Delist instead to remove items from sale. |
| Delisting | Supported | Auto Delist and manual Delist both call the same Walmart endpoint. |
| Re-listing after Auto Delist | Supported | Publish the item again. If Walmart marked it “retired,” run the override job to un-retire before publishing. |
| Inventory Tracking Configs | Not supported | Direct inventory tracking configs aren’t part of this operation. |
| Custom Fields | Not supported | Standard price/qty/SKU only for Sync Listings. |
Tip: Start with SKU ↔ SKU for Linking Priority. Only add extra rows (UPC, GTIN) if you truly need fallback matches.
Scheduling
Schedules run in UTC by default. You’ll receive a notification when a process completes.
Publish Listings
Introduction
Walmart — Publish Listings creates new Walmart product listings from your Flxpoint data. You’ll (1) connect Walmart, (2) set a few options like ship region/method, tax code, fulfillment lag time and optional template IDs, and (3) choose a Publish Listings mapping template that sends Description, GTIN/UPC, Title, Weight, Price, Categories and more. Finished steps show a check mark in the wizard.
- 1Connect Walmart: Pick your Walmart connection and click Save and Proceed.
-
2Configure Settings:
- Ship Region & Ship Method — choose where/how you ship.
- Remove Free Shipping & Shipping Cost — set a uniform cost (mapping can override).
- Tax Code — a Walmart tax code for all products (mapping can override).
- Fulfillment Lag Time — required for Walmart Canada; days between order and ship.
- Listing End Date — optional expiration in days.
- Fulfillment ID & Shipping Template ID — optional Walmart IDs you may pass per product.
- Advanced — enable Product ID Override or Product SKU Override if you need to update an existing Walmart association (don’t enable both at once).
- 3Select a Mapping Template: Choose Publish Listings 1 and map your fields (see examples below). Then run manually or set a schedule.
What you’ll see
- Wizard steps: Connect an Integration, Configure Settings, Define a Mapping Template.
- Tooltips explain fields like Tax Code, Fulfillment Lag Time, and template IDs.
Template Index
| Template | Use Case | What it Covers | Availability |
|---|---|---|---|
| Publish Listings 1 | Create new Walmart items | Required category aspects + Variant fields (Description, GTIN/UPC/EAN, Images, Item Price, Quantity, Title, Weight, Manufacturer/Brand, SKU, Category fields, etc.). | Available |
Common Field Mappings (Publish Listings 1)
A friendly snapshot of how Flxpoint fields flow into Walmart for publishing.
| Flxpoint Field (From) | Walmart Field (To) | Type | Required? | Notes |
|---|---|---|---|---|
| Listing Parent → Description | Description | Text | Yes | Use parent or variant description. |
| Listing Variant → GTIN / UPC / EAN | GTIN / UPC / EAN | Text | Yes (one valid identifier) | Ensure valid length; you can prefix leading zeros with a rule. |
| Listing Parent → Brand | Manufacturer / Brand | Text | Yes | Brand/manufacturer on Walmart. |
| Listing Variant → Weight | Weight | Number | Yes | Weight is mandatory to publish. |
| Listing Variant → List Price | Item Price | Number | Yes | Your selling price on Walmart. |
| Listing Parent → Category (Walmart) | Category/Aspects | Text | Yes | Sub-category must match Walmart taxonomy. |
| Listing Variant → SKU | SKU | Text | Yes | Primary item identifier. |
| Images (Parent/Variant) | Images | List | Yes | Provide at least one valid image URL. |
Rules You Can Use
| Rule | Type | When it Helps | What it Does |
|---|---|---|---|
| UPC padding | String/Number | UPC is 11 digits | Prefixes a 0 to make a valid 12-digit UPC. |
| Price rounding | Number | Consistent endings | Rounds Item Price to .99. |
| Min/Max price guard | Number | Respect MAP | Prevents Item Price from falling below your MAP floor (see note below). |
About MAP / MSRP: The Publish Listings template sends Item Price. Separate MAP/MSRP attributes aren’t exposed as direct mappings here.
To respect MAP/MSRP you can:
- Use a pricing rule to set/guard Item Price so it never drops below your MAP (or to seed MSRP as a reference price if needed).
- Or use Walmart’s Repricer in Seller Center. We send Item Price; the repricer then adjusts on Walmart’s side. (Our feed doesn’t push MAP/MSRP fields directly.)
Sets, Lists & Builders
| Utility | Availability | How You Might Use It |
|---|---|---|
| Mapping Sets | Optional — available | Compose Item Price from base + fees. |
| Lists | Optional — available | Keep valid category labels or restricted brands. |
| Builders | Optional — available | Create a custom output if your category needs extra structure. |
Quick Checks
- Walmart connection saved on Step 1.
- Weight, valid identifier (GTIN/UPC/EAN), images, manufacturer/brand, description and Walmart category are present.
- Fulfillment Lag Time set (required for Canada).
- If using template IDs, provide Fulfillment ID and/or Shipping Template ID as needed.
MAP / MSRP — What’s supported?
There is no direct field in the mapping template to send MAP/MSRP as separate attributes. To honor MAP/MSRP:
- Price Rules in Flxpoint: set Item Price equal to your MAP when present, or block prices below MAP.
- Walmart Repricer: configure the repricer in Seller Center; our feed provides the base Item Price and Walmart applies adjustments.
Troubleshooting
-
Product not uploading
- Condition must be New or Refurbished.
- Sub-category must match Walmart taxonomy.
- Required fields can’t be empty: Weight, Country Code, UPC/GTIN, Image, Manufacturer, Description, Category.
- Fields not publishing — verify mappings are enabled in your template (Description, GTIN/UPC/EAN, Category, Item Price, Weight).
- Delays — new listings can take up to 24 hours to appear after feed submission.
Operation Details
| Feature | Availability | Notes |
|---|---|---|
| Custom Fields | Not supported | — |
| Attributes / Tags | Not supported | — |
| Variations / Options | Not supported | Publish is for single-variant offers (use category aspects where required). |
| Generic Pricing (& Currency) | Supported | Sends Item Price from your template/rules. |
| Client Pricing (& Currency) | Not supported | — |
| Quantity | Supported | Sent when required by category. |
| Multiple Warehouses | Not supported | — |
| Weights & Dimensions | Supported | Weight is mandatory to publish. |
| Images | Supported | Provide valid URLs. |
| Categories | Supported | Must match Walmart taxonomy. |
| Overwriting Supported | Supported | UPC/ID or SKU association can be updated via overrides (don’t enable both simultaneously). |
| Offerings vs Creation | Supported | New product can be created; requires valid UPC/GTIN to match catalog. |
| HTML Descriptions | Supported | Basic HTML allowed by Walmart spec. |
| Limitations | — | To update shipping on product, provide FULFILLMENT ID with the SHIPPING TEMPLATE ID when required. |
Order Operations
Get Orders
Introduction
Walmart — Get Orders brings new Walmart orders into Flxpoint. You’ll (1) connect Walmart, (2) choose what to import (Fulfilled By, date range, statuses, and how long to keep PII), and (3) select a Get Orders mapping template so addresses, items, totals, and timestamps land in the right places. When a step is finished you’ll see a check mark in the wizard.
- 1Connect Walmart: Pick your Walmart connection and click Save and Proceed.
-
2Choose Settings:
- Fulfilled By — default is SellerFulfilled. You can also select WFS Fulfilled and/or 3PL Fulfilled.
- Fetch Orders for the Last X Days — how far back to pull (e.g., 5, 10, up to 60 days).
- Order Status — import only the states you care about (Created, Acknowledged, Shipped, Delivered, Cancelled).
- Advanced → PII Retention — how long to keep personal data before Flxpoint redacts it (e.g., Indefinitely, 30/60/90 days after shipment).
- 3Select a Mapping Template: Choose Get Orders 1. You can run on-demand or schedule every few minutes.
What you’ll see
- Wizard steps: Connect an Integration, Configure Settings, Define a Mapping Template.
- Tooltips in the UI explain Fulfilled By, Order Status, and PII Retention.
Template Index
| Template | Use Case | What it Covers | Availability |
|---|---|---|---|
| Get Orders 1 | Import Walmart orders | Billing/Shipping addresses, order invoice fields (totals, taxes, shipping), order meta (IDs, dates, shipping method), and line items (SKU, qty, item price). | Available |
Common Field Mappings (Get Orders 1)
A quick look at how Walmart order fields flow into Flxpoint.
| From Walmart | To Flxpoint | Type | Required? | Notes |
|---|---|---|---|---|
| Order/Shipping/Billing → Walmart Customer Order ID | Order → Order ID | Text | Yes | Primary order identifier. |
| Order/Shipping/Billing → Order Date | Order → Date Created | Date | Yes | Also used for Ordered On. |
| Order/Shipping/Billing → Shipping Method | Order → Channel Shipping Text | Text | No | Map to your shipping names (Value, Standard, Two Day, etc.). |
| Order/Shipping/Billing → Total Price / Total tax / Shipping Total | Invoice → Total / Tax / Shipping Cost | Number | No | Totals shown on the order invoice. |
| Addresses (Address1/2, City, State, Postal, Country Code, Phone, Ship Name) | Billing & Shipping Address fields | Text | No | PII retention applies after your configured window. |
| Order Item → SKU / Quantity / Item Price / Title | Order Line Item → SKU / Quantity / Price / Title | Mixed | SKU & Quantity required | Item-level data. |
Rules You Can Use
| Rule | Type | When it Helps | What it Does |
|---|---|---|---|
| Normalize shipping names | String | Match Walmart names to your internal names | Maps “Standard Shipping” → “Standard”, “Value” → “Economy”, etc. |
| Fallback phone/email | String | Missing contact | Sets a placeholder if Walmart omits a value (use sparingly). |
| Currency/tag set | String/Number | Multi-market | Annotates orders with USD/CAD tags based on connection settings. |
Sets, Lists & Builders
| Utility | Availability | How You Might Use It |
|---|---|---|
| Mapping Sets | Optional — available | Compose a display “Ship To” from first+last+company. |
| Lists | Optional — available | Whitelist valid shipping service names. |
| Builders | Optional — available | Custom order payload if your OMS needs a specific structure. |
Quick Checks
- Connection saved on Step 1.
- Statuses in Step 2 match what you expect to import (e.g., Created + Acknowledged).
- Date lookback covers the orders you want (5–60 days).
- PII Retention window set appropriately for your policy.
Common issues & tips
- Orders not importing: If you only select Created, Shipped orders won’t load. Expand statuses as needed.
- Too few orders: Increase the “Last X Days” window (e.g., from 5 → 30).
- Two Day service: Requires Walmart approval. Make sure the service exists in Seller Center and is mapped to your internal name.
- Acknowledgement: After download we can mark orders as Acknowledged to keep state aligned.
Operation Details
| Feature | Availability | What to Expect |
|---|---|---|
| Order & Payment Statuses | Supported | Invoice info is available with the order. |
| Order Acknowledgement | Supported | We send an acknowledgement after the order is downloaded and set to Acknowledged. |
| Order Receipt / Invoice (& Currency) | Supported | Currency is USD or CAD per market selected in connection settings. |
| Shipping Selection | Supported | Value, Standard, Standard Shipping, Two Day (if approved), etc., as configured on Walmart. |
| Custom Fields | Not supported | — |
| PII Restrictions | Supported | Personal data is redacted after your configured retention period. |
| Digital Items / Donations | Not supported | — |
| Weight & Dimensions | Supported | Pulled when present for shipping use-cases. |
| Limitations | — | Make sure shipping services exist in both Walmart and your mappings. |
Sync Orders
Introduction
Walmart — Sync Orders pushes shipment updates from Flxpoint to Walmart. When your order is fully shipped, we send carrier, method, and tracking back to Walmart so the marketplace reflects accurate fulfillment status. Use this after Get Orders has created the order in Flxpoint and your warehouse has shipped it.
- 1Connect Walmart: Pick your Walmart connection and click Save and Proceed.
-
2Confirm Requirements:
- Orders must be fully shipped (partial shipments aren’t supported).
- Have carrier, shipping method, and tracking number on the shipment.
- 3Select a Mapping Template: Choose Sync Orders 1 and map your Shipment fields to Walmart Fulfillment fields (see snapshot below).
- 4Run or Schedule: Trigger on demand or schedule (e.g., hourly).
What you’ll see
- Wizard steps: Connect an Integration, Configure Settings, Define a Mapping Template.
- Mapping rows like Shipment → Carrier ➜ Carrier Name, Shipment → Tracking Number ➜ Tracking Number, etc.
Template Index
| Template | Use Case | What it Covers | Availability |
|---|---|---|---|
| Sync Orders 1 | Send shipment updates to Walmart | Carrier, Method, Tracking Number/URL, optional Intent-to-Cancel Override & Ship From Country. | Available |
Common Field Mappings (Sync Orders 1)
How Flxpoint shipment fields flow into Walmart fulfillment.
| From Flxpoint (Shipment) | To Walmart Fulfillment | Type | Required? | Notes |
|---|---|---|---|---|
| Carrier | Carrier Name | Text | Yes | e.g., UPS, FedEx, USPS. |
| Method | Shipping Method | Text | No | e.g., Ground, Standard. |
| Tracking Number | Tracking Number | Text | Yes | Primary tracking identifier. |
| Tracking URL | Tracking URL | URL | No | Direct link to the carrier’s tracking page. |
| (Optional) — | Intent to Cancel Override | Boolean | No | US-specific; only map if your workflow requires it. |
| (Optional) — | Ship From Country | Text | No | “US”, “CA”, etc., when needed. |
Rules You Can Use
| Rule | Type | When it Helps | What it Does |
|---|---|---|---|
| Carrier name normalization | String | Standardize inputs | Maps “United Parcel Service” → “UPS”, “FedEx Ground” → “FedEx”. |
| Tracking URL builder | String | You only have carrier + number | Constructs a URL like https://www.ups.com/track?loc=en_US&tracknum=<tracking>. |
Sets, Lists & Builders
| Utility | Availability | How You Might Use It |
|---|---|---|
| Mapping Sets | Optional — available | Assemble a display string like “Carrier – Method”. |
| Lists | Optional — available | Whitelist of allowed carrier names. |
| Builders | Optional — available | Advanced shaping if your OMS requires a custom payload. |
Quick Checks
- Order is fully shipped (partial shipments are not supported).
- Carrier + Tracking Number are present on the shipment.
- Mapping template sends the correct fields (Carrier, Method, Tracking No./URL).
Common issues & tips
- No update on Walmart: Verify the order is fully shipped and the tracking number is non-empty.
- Carrier rejected: Normalize carrier names to Walmart-accepted values (see Rules).
- Multiple partials needed: Not supported—wait until all items are shipped, then sync.
Operation Details
| Feature | Availability | What to Expect |
|---|---|---|
| Platform “Notify Customer” Flow | Not supported | Notifications are handled by Walmart after we update shipment. |
| Partial Order Shipments | Not supported | Sync only when the order is fully shipped. |
| Partial Order Item Shipments | Not supported | Line-level partials aren’t sent. |
| Post Shipment Status Updates | Not supported | We submit shipment once; ongoing status polling isn’t included. |
| Manual Order Item Limitations | Not supported | Manual per-item overrides aren’t available in this flow. |
| Limitations | — | Only fully shipped orders are eligible for sync. |
Troubleshooting Flashcards
Offer shows “Unpublished”
ListingsOffer exists but the item isn’t live on Walmart.com.
- Publish state doesn’t match your expectation.
- Often caused by missing attributes, wrong category, or no images.
Item vs OfferPublish
Fix
- Confirm correct category and required attributes (brand, description, key specs, etc.).
- Add at least one valid image (HTTPS, public, ≥ 500px).
- Re-send Item (content) then Offer (price/inventory).
- Check “Publish Status” in the Item feed/report.
“Invalid Shipping Template ID”
OffersThe shipping template ID/name doesn’t match Walmart.
- Offer is rejected with a template error.
- Or the offer goes live under “Best Rate” unintentionally.
ShippingTemplate
Fix
- Verify the exact Shipping Template Name/ID in Seller Center.
- Map the exact value (case/spacing sensitive).
- Re-send the Offer after correcting the mapping.
Price not updating
PricingFeed looks OK but site price doesn’t change.
- Offer accepted but PDP shows old price.
- Rules or rounding not applying as expected.
OfferRules
Fix
- Confirm mapping to price and currency in Offers feed.
- Check active price rules (margins, rounding, floors).
- Consider Walmart/competitor undercut effects.
- Re-send Offer and verify the feed response.
Inventory not changing
InventoryWalmart qty remains the same after runs.
- Offer not receiving qty or feed is empty.
- Conflicts from multiple sources/jobs updating qty.
QtyOffer
Fix
- Ensure SKU/partnerItemId exactly matches Walmart.
- Only one operation should “own” qty updates (avoid duplicates).
- Review filters/exclusions; send qty ≥ 0 (no negatives).
- Re-send Offer and check inventory feed report.
“Missing required attribute”
ItemsRejected due to attributes/category.
- Feed flags missing fields or invalid option values.
- Common in stricter categories with specific specs.
CategoriesSpecs
Fix
- Choose the correct Walmart category (avoid overly “Generic” if a specific one exists).
- Complete all required attributes; use allowed lists/values.
- Avoid unsupported HTML/special chars in titles.
- Re-send Item feed and review the error report.
Images not appearing
AssetsItem is live without images or with placeholders.
- URL is not publicly accessible or not HTTPS.
- Dimensions/quality too low.
ImagesCDN
Fix
- Use public HTTPS URLs that don’t expire quickly.
- Recommended ≥ 1000 px on the longest side; avoid borders/watermarks.
- Include a main image and, if possible, additional angles.
- Re-send Item feed after fixing the URLs.
Carrier/tracking errors
ShipmentsWalmart rejects the shipment update.
- Unsupported carrier name or missing tracking number.
- Order already cancelled or outside update window.
TrackingCarrier
Fix
- Use a standardized carrier name Walmart accepts (e.g., UPS, FedEx, USPS, DHL, Other).
- Include trackingNumber and ship date.
- If the carrier isn’t listed, use “Other” with a valid tracking URL.
- Retry the update and verify API response.
Late ACK / auto-cancel
OrdersOrder cancels because acknowledgement wasn’t on time.
- ACK window exceeded.
- Jobs paused or filters excluding new orders.
SLAAuto-ack
Tips
- Keep the “Acknowledgements” job active and frequent (several runs per day).
- Avoid filters that block new orders.
- Set alerts if the ACK queue grows.
Feed stuck “IN_PROGRESS”
FeedsFeed doesn’t finish or returns no report.
- Traffic spikes or very large batches.
- Items with blocking errors.
MonitorBatch
Fix
- Split into smaller batches (by category/brand).
- Find the latest feedId and download the error report.
- Fix blocking items and retry only those SKUs.
Cancel request rejected
CancellationsCancel attempt fails with Walmart error.
- Order already shipped or out of cancel window.
- Reason code not valid for current order state.
Reason CodeWindow
Fix
- Use an allowed reason code (e.g., OUT_OF_STOCK, CUSTOMER_REQUEST, etc.).
- Cancel before shipment confirmation; if already shipped, process a return.
- Retry with the correct reason and log the response.
Invalid Lag Time
FulfillmentOffer fails due to prep/handling time.
- Value out of range or not allowed by template.
- Mismatch vs. your real SLA to ship.
SLAsOffer
Fix
- Set fulfillmentLagTime within the accepted range (e.g., typically 0–3 days).
- Align with your shipping template and real operational times.
- Re-send Offer and validate result.
Duplicate SKU / wrong partner SKU
DataIdentifier conflict across Items/Offers.
- Feed ignores rows due to SKU collisions.
- SKU changes break the Walmart linkage.
SKUsLinking
Fix
- Keep partnerItemId/SKU stable and matching existing Walmart records.
- If SKU changed, re-link mappings or recreate the listing under the new identifier.
- Deduplicate at your source before sending the feed.