Set up items for WFS
When you sell on Walmart Marketplace, you have two fulfillment options: seller-fulfilled and Walmart-fulfilled. Seller-fulfilled means you manage inventory, shipping and customer service yourself. Walmart-fulfilled means you send items to our fulfillment centers, where we take care of storage, packing, shipping, returns and customer support on your behalf. You must be enrolled in Walmart Fulfillment Services (WFS) to use this option.
All items must be Walmart Fulfillment Services (WFS) eligible before you can create an inbound order (IO) to the WFS fulfillment network. This section details the steps you have to follow to set up items for WFS.
Step 1: Make item WFS eligible
If you have not yet created your items, you can use the WFS Item spec to both set up and convert items for WFS items in one setup process.
- The WFS Item JSON specification is available in the Marketplace Items guide under Item spec versions. Use the
Create new items for WFSitem spec. - To create new WFS eligible items in one process, use the latest full spec for both Walmart and WFS. To learn more about Item Spec and how to set up items, refer to Get item setup requirements.
- To learn more about how to create an item, refer to Create a new item (Full item setup) in the Items guide.
GTIN exemption review during WFS item setup
For MP_WFS_ITEM feeds, if you need a GTIN exemption or already have an approved exemption, use CUSTOM as the Product ID during item setup. Keep the Product ID type set to GTIN.
"productIdentifiers": { "productId": "CUSTOM", "productIdType": "GTIN"
}Do not use CUSTOM as the default Product ID for all WFS item setup requests.
Walmart can automatically approve or deny the GTIN exemption request, or send it for manual review.
- If Walmart approves the exemption automatically, item setup succeeds.
- If Walmart denies the exemption, item setup fails. You can appeal the decision or submit the item again using
CUSTOMas the Product ID to initiate a new GTIN exemption request. Follow the guidance provided before resubmitting. - If the exemption requires manual review, the feed can reach
PROCESSEDwhile the item-levelingestionStatusremainsINPROGRESS. Check the GTIN Exemption Dashboard in Seller Center or use the GTIN Exemption Status API for the final decision. If Walmart approves the exemption after manual review, wait four hours, then resubmit the item to complete setup.
Step 2: Restrict item sale by geographic location
When setting up or converting items for WFS, you must specify sales restrictions by geographic location (state or ZIP code).
- If there are no restrictions, set the Restriction Type to
None. - For more details about the
StateRestrictionsattribute and its usage, refer to Restrict item sale by state or zip code.
Step 3: Ensure required attributes are complete
The first 148 lines of the JSON spec are all required. Most required attributes are explicitly marked required in the spec file.
The TradeItem object includes four optional attribute groups. You must provide at least one of them.
Trade item required attributes
In the TradeItem object, at least one of these attributes is required: each, inner pack, case, or pallet.
This example excerpt identifies the four TradeItem attribute groups, showing only the names of the attributes. The entire section of the attribute is required, so nested details are omitted for brevity.
"TradeItem": { "$schema": "http://json-schema.org/draft-04/schema#", "type": "object", "properties": { . . . "each": { . . . "innerPack": { . . . "case": { . . . "pallet": {
Step 4: Create an inbound purchase order
Once all items are WFS eligible, you can create an inbound purchase order.
Download and extract the Inbound Purchase Order JSON Schema: InboundPurchaseOrderSchema.zip.
The InboundPurchaseOrderSchema.zip contains the JSON Schema definitions for creating WFS inbound purchase orders. It specifies the payload structure, required fields, data types, and validation rules for purchase order metadata, ship-to facility details, shipments, and shipment item lines (SKU and quantities), including enumerations and date/time formats used for validation.
Updated 7 days ago

