--- updatedAt: 2026-06-29T21:10:45.000Z --- # Fetch Inbound Preview The new Fetch Inbound Preview API allows you to preview the shipment destinations for Inventory Transfer Services, self-distribution, or single destination shipments. When using Inventory Transfer Services, this API provides a detailed breakdown of projected ITS fees and compares available destination options. [block:html] { "html": "\n \n" } [/block] # OpenAPI definition ```json { "openapi": "3.0.1", "info": { "title": "Fulfillment Management", "version": "1.0", "description": "With Walmart Fulfillment Services, you can focus on sales while Walmart expertly take care of fast shipping, seamless returns, and customer service. Simply send your inventory to Walmart fulfillment centers, where we will store your products securely and prepare them swiftly for shipping when an order is placed." }, "x-readme": { "samples-languages": [ "shell" ], "proxy-enabled": false }, "servers": [ { "url": "https://marketplace.walmartapis.com", "description": "Production URL" }, { "url": "https://sandbox.walmartapis.com", "description": "Sandbox URL" } ], "security": [ { "accessToken": [] } ], "paths": { "/v3/fulfillment/inbound-preview": { "post": { "tags": [ "Fulfillment" ], "summary": "Fetch Inbound Preview", "description": "The new Fetch Inbound Preview API allows you to preview the shipment destinations for Inventory Transfer Services, self-distribution, or single destination shipments. \n\nWhen using Inventory Transfer Services, this API provides a detailed breakdown of projected ITS fees and compares available destination options.", "externalDocs": { "description": "View Guide", "url": "/doc/us/mp/us-mp-fulfillment/#12930" }, "operationId": "inboundPreview", "parameters": [ { "in": "header", "name": "Authorization", "description": "Basic authorization header. Base 64 encodes the Client ID and Client Secret retrieved in step two of the integration steps.", "required": true, "schema": { "type": "string" }, "example": "Basic YzcyOTFjNmItNzI5MC00...." }, { "in": "header", "name": "WM_CONSUMER.CHANNEL.TYPE", "description": "A unique ID to track the consumer request by channel. Use the Consumer Channel Type received during onboarding", "required": false, "schema": { "type": "string" } }, { "in": "header", "name": "WM_QOS.CORRELATION_ID", "description": "A unique ID which identifies each API call and used to track and debug issues; use a random generated GUID for this ID", "required": true, "schema": { "type": "string" }, "example": "b3261d2d-028a-4ef7-8602-633c23200af6" }, { "in": "header", "name": "WM_SVC.NAME", "description": "Walmart Service Name", "required": true, "schema": { "type": "string" }, "example": "Walmart Service Name" } ], "requestBody": { "description": "Request fields", "content": { "application/json": { "schema": { "required": [ "header", "payload" ], "type": "object", "properties": { "header": { "required": [ "headerAttributes" ], "type": "object", "properties": { "headerAttributes": { "required": [ "buId", "martId" ], "type": "object", "properties": { "buId": { "type": "string", "description": "Business unit identifier and must be 0 for US market.", "xml": { "wrapped": true } }, "martId": { "type": "string", "description": "Market identifier and must be 0 for US market.", "xml": { "wrapped": true } } }, "description": "Multi Tenant header attributes" } }, "description": "Request Multi Tenant Header Wrapper" }, "payload": { "required": [ "inboundOrderId", "orderItems", "returnAddress" ], "type": "object", "properties": { "inboundOrderId": { "maxLength": 50, "minLength": 0, "type": "string", "description": "Unique identifier used for shipments" }, "returnAddress": { "required": [ "addressLine1", "city", "countryCode", "postalCode", "stateCode" ], "type": "object", "properties": { "addressLine1": { "type": "string", "description": "Address details" }, "addressLine2": { "type": "string", "description": "Address details continuation" }, "city": { "type": "string", "description": "City name" }, "stateCode": { "type": "string", "description": "State Code" }, "countryCode": { "type": "string", "description": "Country code" }, "postalCode": { "type": "string", "description": "Zip code" } }, "description": "return address of seller" }, "orderItems": { "maxItems": 5000, "minItems": 1, "type": "array", "description": "List of Order Items", "xml": { "wrapped": true }, "items": { "required": [ "expectedDeliveryDate", "innerPackQty", "itemDesc", "itemQty", "productId", "productType", "sku", "vendorPackQty" ], "type": "object", "properties": { "productId": { "type": "string", "description": "Unique ID identifying product" }, "productType": { "type": "string", "description": "Supported product types are GTIN" }, "sku": { "type": "string", "description": "Seller Item ID" }, "itemDesc": { "type": "string", "description": "Item description" }, "itemQty": { "minimum": 1, "type": "integer", "description": "Total number of sellable units", "format": "int32" }, "vendorPackQty": { "minimum": 1, "type": "integer", "description": "Total number of cases", "format": "int32" }, "innerPackQty": { "minimum": 1, "type": "integer", "description": "Total number of sellable units per case", "format": "int32" }, "expectedDeliveryDate": { "type": "string", "description": "expected delivery date for shipment", "format": "date-time" }, "addOnServices": { "type": "array", "description": "Indicate whether add-on services (e.g. item labeling or poly bagging) are needed", "xml": { "wrapped": true }, "items": { "type": "object", "properties": { "serviceType": { "type": "string", "description": "Enum: \"LABEL\", \"BAG\", \"TAPE\", \"WRAP\"" } }, "description": "Indicate whether add-on services (e.g. item labeling or poly bagging) are needed" } }, "itemNbr": { "type": "integer", "format": "int32" }, "dimensions": { "type": "array", "items": { "type": "number", "format": "float" } }, "itemWeightQty": { "type": "number", "format": "float" }, "nonSortItem": { "type": "boolean" }, "shipNode": { "type": "string" } }, "description": "inbound shipment request line items" } } }, "description": "Request Payload" } } }, "example": { "header": { "headerAttributes": { "buId": "0", "martId": "0" } }, "payload": { "inboundOrderId": "WFS_P132398111-ITS1011", "returnAddress": { "addressLine1": "860 W California Ave", "addressLine2": "", "city": "Sunnyvale", "stateCode": "CA", "countryCode": "US", "postalCode": "94086" }, "orderItems": [ { "productId": "06484856148873", "productType": "GTIN", "sku": "SKU-06476211912694", "itemDesc": "tennis ball", "itemQty": 5, "vendorPackQty": 5, "innerPackQty": 1, "expectedDeliveryDate": "2023-05-25T15:33:33-07:00", "addOnServices": [ { "serviceType": "LABEL" } ] } ] } } } }, "required": true }, "responses": { "200": { "description": "Successful operation", "content": { "application/json": { "schema": { "type": "object", "properties": { "status": { "type": "string", "description": "Response status." }, "payload": { "type": "array", "description": "Response payload.", "items": { "type": "object", "properties": { "inboundOrderId": { "type": "string", "description": "Unique shipment identifier" }, "previews": { "type": "array", "description": "List of preview responses", "items": { "type": "object", "properties": { "previewType": { "type": "string", "description": "Use \"inbound\" if you are using WFS Inventory Transfer Service (ITS). Use \"selfMirroring\" if you are not using ITS and shipping directly to Walmart fulfillment centers." }, "preview": { "type": "array", "description": "Preview", "items": { "type": "object", "properties": { "shipNode": { "type": "string", "description": "Ship Node" }, "isSortable": { "type": "boolean", "description": "Flag indicating if the dimensions of the item make it sortable" }, "isNonSortable": { "type": "boolean", "description": "Flag indicating if the dimensions of the item make it non-sortable" }, "nodeType": { "type": "string", "description": "Node Type: FC/ICC" }, "shipToAddress": { "type": "object", "properties": { "fcName": { "type": "string", "description": "Facility name" }, "addressLine1": { "type": "string", "description": "Address details " }, "addressLine2": { "type": "string", "description": "Address details continuation" }, "city": { "type": "string", "description": "City name" }, "stateCode": { "type": "string", "description": "State code" }, "countryCode": { "type": "string", "description": "Country code" }, "postalCode": { "type": "string", "description": "Zip code" } }, "description": "The address to which sellers need to inbound items" }, "totalNetTransferCharge": { "type": "number", "description": "Total charge if you are using ITS." }, "currencyUnit": { "type": "string", "description": "Currency in which transfer charge is estimated" }, "shipmentItems": { "type": "array", "description": "Shipment items", "items": { "type": "object", "properties": { "vendorSku": { "type": "string", "description": "Vendor SKU" }, "productType": { "type": "string", "description": "Product type: GTIN/UPC/EAN" }, "productId": { "type": "string", "description": "Unique product identifier" }, "itemQty": { "type": "integer", "description": "Item quantity", "format": "int32" }, "netTransferCharge": { "type": "number", "description": "Total charge if you are using ITS." }, "currencyUnit": { "type": "string", "description": "Currency in which transfer charge is estimated" } }, "description": "Shipment items" } } }, "description": "Preview" } } }, "description": "List of preview responses" } } }, "description": "Response payload." } } } }, "example": { "status": "OK", "payload": [ { "inboundOrderId": "WFS_P132398111-ITS1011", "previews": [ { "previewType": "inbound", "preview": [ { "shipNode": "4093", "isSortable": true, "isNonSortable": false, "nodeType": "ICC", "shipToAddress": { "fcName": "LAX2T", "addressLine1": "6720 Kimball Ave", "city": "Chino", "stateCode": "CA", "countryCode": "US", "postalCode": "91708" }, "totalNetTransferCharge": 1.25, "currencyUnit": "USD", "shipmentItems": [ { "vendorSku": "SKU-06476211912694", "productType": "GTIN", "productId": "06484856148873", "itemQty": 5, "netTransferCharge": 1.25, "currencyUnit": "USD" } ] } ] }, { "previewType": "selfMirroring", "preview": [ { "shipNode": "7441", "isSortable": true, "isNonSortable": false, "nodeType": "FC", "shipToAddress": { "fcName": "ORD1s", "addressLine1": "3501 Brandon Road", "city": "Joliet", "stateCode": "IL", "countryCode": "US", "postalCode": "60436" }, "shipmentItems": [ { "vendorSku": "SKU-06476211912694", "productType": "GTIN", "productId": "06484856148873", "itemQty": 4 } ] }, { "shipNode": "8103", "isSortable": true, "isNonSortable": false, "nodeType": "FC", "shipToAddress": { "fcName": "LAX1", "addressLine1": "6750 Kimball Avenue", "city": "Chino", "stateCode": "CA", "countryCode": "US", "postalCode": "91708" }, "shipmentItems": [ { "vendorSku": "SKU-06476211912694", "productType": "GTIN", "productId": "06484856148873", "itemQty": 1 } ] } ] } ] } ] } } } } } } } }, "components": { "securitySchemes": { "accessToken": { "type": "apiKey", "in": "header", "name": "WM_SEC.ACCESS_TOKEN", "description": "An access token required for authenticating API requests. Obtain the token from `POST /v3/token` using the `client_credentials` grant type." } } } } ```