Walmart Updates Cross-Border Label API Rules
Walmart added error examples and required-field rules for the Ship with Walmart shipping API. Missing an HS code, country of origin, or product URL may trigger LH-4022.
What are the key facts?
- 1Walmart updated the Order Management API shipping-interface documentation on September 21, 2026
- 2The update added error examples for cross-border and overseas shipping
- 3Missing an HS code, country of origin, or product URL may trigger LH-4022
- 4The error may prevent order creation or shipping-label generation
- 5The change affects overseas sellers processing orders in batches through APIs or software
What happened?
Walmart’s developer documentation was updated on September 21, 2026, to revise the shipping interface instructions for the Order Management API, focusing on error examples for cross-border trade (CBT) and overseas shipping using Ship with Walmart labels. If a product is missing required information such as an HS code, country of origin, or product URL, the interface returns error code LH-4022, and the order may not be created or the shipping label may not be generated successfully. The change primarily affects sellers in China, Hong Kong, Japan, Europe, and other overseas markets that process orders in batches through the Walmart API, ERP systems, third-party software, or self-built systems. Sellers who manually use Seller Center may not directly see an API error, but their product data must still meet the same requirements. Sellers should check SKU-level HS codes, countries of origin, product links, and cross-border shipping fields, and update their API error-handling logic. Otherwise, they may face shipment delays, failed label generation, or weaker fulfillment metrics. The update does not announce new fees, but it affects the shippability of cross-border orders and the completeness of customs-clearance information.
What does this mean for cross-border sellers?
Cross-border sellers using the Walmart API, ERP systems, third-party software, or self-built systems for batch fulfillment may trigger LH-4022 when SKUs lack an HS code, country of origin, or product URL. This can prevent order creation or shipping-label generation. Manual sellers should also review product data to protect order shippability, customs documentation completeness, and fulfillment performance.
What should sellers do now?
- 1For stores using the Walmart API, ERP systems, third-party software, or self-built systems for batch fulfillment, export cross-border SKUs one by one, complete the HS Code, Country of Origin, product URL, and cross-border shipping fields, and retain a field checklist as the pre-launch verification record.HS duty estimate
- 2Add an LH-4022 error branch to the order-creation and label-generation workflows, and run interface regression tests for CBT and overseas-shipping orders. Completion requires that orders can be created, shipping labels can be generated, and error logs can identify missing fields.