Order management API overview

The Walmart Order Management API helps sellers to manage their customer sales orders and stay up-to-date on the order fulfillment process. Use the Order APIs to issue refunds, ship orders, acknowledge orders, cancel orders, and get all released orders.

When a customer places an order on Walmart.com, the Walmart system creates a Sales Order that sellers use to generate the Purchase Order. A Sales Order can contain one or more Purchase Orders from multiple sellers. Every unique item that is ordered in a Purchase Order has a line number.

Phone number and email address are for carrier use only. Per Walmart Marketplace’s Customer Care Policy, unsolicited text messages, emails, or telephone calls to customers are prohibited and may result in account suspension.

Order management XML schemas

All XSD files are available in the Order Management zip file: OrderManagementV3.zip
The zip file contains all V3 XSD files. 

Order object structure

Each purchase order contains one or more order lines; each line item represents a unique item that a customer orders. Line items inherit their structure from the purchase order, however purchase orders do not inherit status.

Line item statuses

The valid statuses for a line item are:

• Created: The Purchase Orders for the line items are created and have been released from the Walmart Order Management System to the seller for processing. You will need to acknowledge this order before shipping.
• Acknowledged: The Purchase Order has been acknowledged by the assigned sellers, including all of its order line items. If it is in this state by default, it has already been acknowledged.
• Shipped: The items included in the purchase order have been shipped.
• Canceled: The line order has been cancelled. Sellers cannot fulfill the Purchase Order.
• Delivered: The line order has been delivered. Purchase order lines that are delivered to customers have status=Delivered. 

Charge Types

Walmart supports these charge types:

• PRODUCT: The product charges for the specified line item in the Purchase Order.
• SHIPPING: The shipping charges for the specified Purchase Order line item. Walmart only supports the UTC shipDateTime. 

Order process

To get a view of the entire workflow from the customer order to order delivery, see the Order Process diagram. It shows all system checks, seller API calls, and notifications sent to customers at the different stages of the order process. 

Order refund process

The Refund Process diagram illustrates all steps from the customer, seller, and Walmart system processes to issue a customer refund.