Walmart Marketplace Integration

Scottsdale Mint sells precious metals products on Walmart Marketplace in addition to the direct-to-consumer Scottsdale Mint website. The WordPress WooCommerce site integrates with Walmart Marketplace for product listing management and order fulfillment.

---

Integration Plugin

• Plugin: Walmart integration plugin (specific plugin name in composer.json or as an installed plugin)
• Purpose: Sync WooCommerce product catalog to Walmart Marketplace; import Walmart orders into WooCommerce

---

What the Integration Does

Product Catalog → Walmart

1. WooCommerce products are mapped to Walmart product specifications
2. Product data is submitted to Walmart's Item API:
   • Product name, SKU, description
   • Price (live, from WooCommerce — updated when pricing pipeline runs)
   • Inventory availability
   • Images
   • Product category and attributes (metal type, weight, purity)
3. Walmart reviews and approves new product listings (can take 24–72 hours)
4. Published products appear on Walmart.com for sale

Walmart Orders → WooCommerce

1. Customer places an order on Walmart.com
2. The integration plugin polls Walmart's Order API periodically
3. New Walmart orders are imported as WooCommerce orders with:
   • Source: walmart
   • Walmart Order ID in order meta
   • Customer shipping address from Walmart
   • Products with quantities and Walmart-dictated prices
4. WooCommerce fulfillment workflow takes over:
   • Orders pushed to ShipStation
   • FedEx labels generated
   • Tracking sent back to Walmart

---

Patches Applied

Several patches address Walmart integration issues:

Patch File	Description
0001-Dev-fix-local-walmart-plugin-path.patch	Fixes plugin path resolution in local/dev environment
0001-Walmart-patch-missing-required-properties.patch	Adds required Walmart product fields that were missing from the plugin
0001-Fix-Walmart-Patch-missing-required-properties-for-Pr.patch	Follow-up fix for product property mapping
0001-Dev-Walmart-patch-missing-required-properties.patch	Dev-specific variant of the above

These patches are applied automatically by Composer via cweagans/composer-patches.

---

Required Product Fields (Walmart)

For Walmart listing approval, all products must include:

Field	WooCommerce Meta	Required
Product Name	post_title	Yes
Short Description	post_excerpt	Yes
Main Image	WC product image	Yes (min 2000×2000 px)
SKU	_sku	Yes
Price	_price	Yes
Category	WC category	Yes
Brand	_brand or ACF field	Yes (Scottsdale Mint)
Metal Type	_metal_type	Yes (for precious metals category)
Weight (troy oz)	_metal_weight_troy_oz	Yes
UPC/GTIN	_global_unique_id	Required by Walmart

---

Pricing on Walmart

Walmart prices are updated whenever the WooCommerce price is updated via the pricing pipeline. The integration hooks into:

add_action( 'woocommerce_product_set_price', [ $this, 'sync_price_to_walmart' ], 20, 2 );

This means Walmart prices update in near-real-time alongside the WooCommerce prices.

---

Order Import Schedule

Walmart orders are imported via a scheduled event:

• Frequency: Every 15 minutes (via WordPress cron or Ymir cron)
• Batch size: Up to 200 orders per import run

---

Walmart Seller Center

Non-technical operations (account setup, pricing rules, promotions, dispute resolution) are managed in the Walmart Seller Center:

• Product listing status
• Order management
• Returns and refunds
• Advertising campaigns

---

Troubleshooting

Issue	Action
Products not appearing on Walmart	Check Walmart Seller Center for listing errors; re-submit items with corrected data
Walmart orders not importing	Check WP cron is running; verify Walmart API credentials are valid
Price mismatch	Check if price update hook is firing; inspect Walmart feed via Seller Center
Missing required field error	Review patches applied; verify all required WooCommerce product fields are populated