← All disapproval codes
critical SPEC_VERSION_MISMATCH

Spec Version Outdated or Mismatched

What this means

Your feed references a Walmart spec version that is deprecated or doesn't match the API endpoint. Walmart rejects the feed before processing any items.

Why this happens

Walmart publishes versioned spec files (4.0, 4.2, 4.3, 4.4, etc.) and retires older versions on a published schedule. Feeds submitted under retired specs fail at the file level. The mismatch also occurs when the schemaVersion in the payload differs from the spec version of the URL endpoint, or when item-level specs were updated mid-cycle.

How to fix it

  1. Check current accepted spec versions in Walmart's developer portal
  2. Update your integration to the latest stable spec version
  3. Regenerate XSDs or JSON schemas from the new spec
  4. Update schemaVersion field in the payload header
  5. Resubmit and confirm successful ingestion

Common pitfalls