Order management API overview

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 online 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 spec

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:

  • 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 already has been acknowledged.
  • Shipped: The items included in the purchase order has been shipped.
  • Cancelled: The line order has been cancelled. Sellers cannot fulfill the purchase order.

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 supports UTC shipDateTime.

Order fulfillment workflow

To successfully fulfill or refund orders properly, Walmart follows this workflow.