Drop Ship Vendor (DSV) Order Management API Overview

The Walmart Order Management API help 1P suppliers stay up to date on order fulfillment.

Walmart 1P suppliers may experience two different order flows:

• Drop Ship Vendor (DSV): Customer Order: When a customer places an online order with Walmart, the system creates a sales order which is used to generate one or more purchase orders. The purchase order is then assigned to a drop ship vendor (DSV) supplier to fulfill directly to the customer.
• Walmart Corporate Order: (Not currently available through API): When a Walmart merchant places an order from the supplier, a purchase order will be generated and sent to a supplier to fulfill to Walmart, whether a distribution center (DC), fulfillment center (FC), store, or other.

Order Object

A Walmart order object represents a purchase order and consists of a group of one or more line items. Every individually unique item has a line number. This is only applicable for drop ship vendor (DSV) customer orders.

Note: The order has no inherent status, but the line items do. Extract the Order Management XML schema definitions (XSDs) at the following link: OrderManagement.zip

Statuses Available for Drop Ship Vendor (DSV) Purchases Order

Overall Purchase Order Status

Drop ship vendor (DSV) purchases orders do not have a status assigned to them at the purchase order level. All statuses are individually assigned at the purchase order line level.

Purchase Order Line Item Status

The valid statuses for a drop ship vendor (DSV) purchase order line item are:

• Created: The purchase order for the line items are created and have been released from the Walmart Order Management System (OMS) to drop ship vendors (DSV) for processing. The order must be acknowledged before shipping.
• Acknowledged: The line item content has been acknowledged by the assigned drop ship vendor (DSV).
• Shipped: The items of that line of the purchase order have been shipped.
• Cancelled: The line item has been cancelled. Drop ship vendors (DSV) cannot fulfill the purchase order.

Drop Ship Vendor (DSV) Order Charge Types

The values that support 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 Coordinated Universal Time (UTC) shipDateTime.

Drop Ship Vendor (DSV) Order Workflow

To successfully fulfill and/or refund orders properly, Walmart follows an order management workflow. See the flow diagram below for details on the order and refund process.