The Walmart Order Management APIs help Sellers to manage customer’s Sales Orders and to stay up-to-date on orders fulfillment, which orders to fulfill, and when to fulfill them.
When a customer places an on-line order with Walmart, it creates a Sales Order and this Sales Order is used to generate the Purchase Order. The Sales Order may contain one or more Purchase Orders that may be assigned to different Sellers. Every unique item that is ordered in a Purchase Order has a line number.
Order Management XML schemas
All XSD files are available in the Order Management zip file: Mexico-Order-XSD-v2.zip
The Order Object
A Walmart order object represents a purchase order and consists of a group of one or more line items that a customer ordered.
Note: The order has no inherit status, but the line items do.
The valid statuses for a line item are:
- OnHold: This is the status an order drops into Seller Center, when either a Payment has not been completed and/or Fraud check is active.In this status the Seller has read-only access to the Order and no action is expected from them.Once the payment is complete/fraud check is released, order will move into ‘Ordered Status’.
- Created: This is the default status when an order drops into Seller Center, when Payment has been completed/ Fraud check is released/passed.
- Acknowledged: Seller marks an order as acknowledged.At this point, we would generate shipping labels with Carrier Hub and display it for download. Seller cannot update status to ‘Shipped’ , until after the labels have been downloaded.
- Shipped: The items included in the purchase order has been shipped.
- Delivered: Order moves to this status when Vulcan updates the tracking details.
- Cancelled: Order moves to this status when the seller moves it into this state by selecting one of the preset reasons.
The values that supports Walmart Charge Types are:
- PRODUCT: The product charges for the specified line item in Purchase Order.
- SHIPPING: The shipping charges for the specified Purchase Order line item. Walmart only support UTC shipDateTime.
WFS Orders
You can use the WFS APIs to track WFS orders.
Walmart fulfilled orders do not have a purchase order. They are referenced by the Customer Order itself and are view only.
The valid statuses for a WFS line item are:
- Created: This is the default status when an order drops into Seller Center, when Payment has been completed/ Fraud check is released/passed.
- SentForFulfillment: The order is confirmed is and waiting to be shipped.
- Shipped: The items included in the order has been shipped.
- Delivered: Order moves to this status when carrier updates the tracking details.
- Cancelled: Order moves to this status when customer cancels the order.
Order fulfillment workflow
To successfully fulfill or refund orders properly, Walmart follows a workflow.
