--- updatedAt: 2026-06-29T21:10:45.000Z --- # Create Inbound Shipment Once you’ve converted items to WFS, you are ready to start shipping items inbound to Walmart. To do this, you will submit an Inbound shipment request. The Inbound shipment details when you expect to ship product, as well as the items and quantities which will be shipped. Each shipment you send in to WFS should have a corresponding Inbound shipment . In this case, a shipment would be considered a direct truckload, LTL shipment, or set of items shipped via parcel on a given day. [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-shipments": { "post": { "tags": [ "Fulfillment" ], "summary": "Create Inbound Shipment", "description": "Once you’ve converted items to WFS, you are ready to start shipping items inbound to Walmart. To do this, you will submit an Inbound shipment request. The Inbound shipment details when you expect to ship product, as well as the items and quantities which will be shipped.\n\nEach shipment you send in to WFS should have a corresponding Inbound shipment . In this case, a shipment would be considered a direct truckload, LTL shipment, or set of items shipped via parcel on a given day.", "externalDocs": { "description": "View Guide", "url": "/doc/us/mp/us-mp-fulfillment/#2901" }, "operationId": "createShipment", "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": [ "inboundOrderId", "returnAddress" ], "type": "object", "properties": { "inboundOrderId": { "maxLength": 100, "minLength": 0, "type": "string", "description": "Unique ID identifying inbound shipment request" }, "inboundServices": { "type": "object", "properties": { "inventoryTransferService": { "type": "string", "description": "ITS Flag" } }, "description": "Requested inbound services such as ITS" }, "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": "inbound shipment request line 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" } }, "shippingSummary": { "type": "object", "description": "A summary of the shipment.", "properties": { "boxes": { "type": "array", "description": "A list of box configurations that are included.", "items": { "type": "object", "properties": { "totalNoOfUnits": { "type": "integer", "format": "int32", "description": "Total number of units that are packed." }, "noOfBoxes": { "type": "integer", "format": "int32", "description": "The number of boxes that are in the packing configuration.", "minimum": 1 }, "weight": { "type": "number", "format": "float", "description": "The weight of each box." }, "longestSide": { "type": "number", "format": "float", "description": "The longest side dimension of the box." }, "medianSide": { "type": "number", "format": "float", "description": "The median side dimension of the box." }, "shortestSide": { "type": "number", "format": "float", "description": "The shortest side dimension of the box." }, "weightUnit": { "type": "string", "description": "The unit of weight measurement." }, "lengthUnit": { "type": "string", "description": "The unit of length measurement." }, "items": { "minimum": 1, "type": "array", "description": "The list of items that are packed in the box.", "items": { "type": "object", "properties": { "productId": { "type": "string", "description": "The product identifier of the packed item." }, "productType": { "type": "string", "description": "The type of product identifier used for the packed item." }, "sku": { "type": "string", "description": "The seller-defined SKU for the packed item." }, "gtin": { "type": "string", "description": "The Global Trade Item Number (GTIN) for the packed item." }, "unitsPerBox": { "minimum": 1, "type": "integer", "format": "int32", "description": "The number of units of an item packed in each box." } } } } } } } } } } }, "example": { "inboundOrderId": "8778881015027", "inboundServices": { "inventoryTransferService": "Y" }, "returnAddress": { "addressLine1": "860 W California Ave", "addressLine2": "", "city": "Sunnyvale", "stateCode": "CA", "countryCode": "USA", "postalCode": "94086" }, "orderItems": [ { "productId": "00894147009695", "productType": "GTIN", "sku": "WILL-SL969", "itemDesc": "Blue jeans", "itemQty": 10, "vendorPackQty": 10, "innerPackQty": 1, "expectedDeliveryDate": "2020-11-21T00:00:00.000Z", "addOnServices": [ { "serviceType": "LABEL" } ] } ] } } }, "required": true }, "responses": { "200": { "headers": { "X-Current-Token-Count": { "$ref": "#/components/headers/X-Current-Token-Count" }, "X-Next-Replenishment-Time": { "$ref": "#/components/headers/X-Next-Replenishment-Time" } }, "description": "Successful operation", "content": { "application/json": { "schema": { "type": "object", "properties": { "status": { "type": "string" }, "payload": { "type": "array", "description": "response payload", "items": { "type": "object", "properties": { "shipmentId": { "type": "string", "description": "Unique ID identifying each shipment" }, "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" }, "shipmentItems": { "type": "array", "description": "The items which needs to be send in the shipment", "items": { "type": "object", "properties": { "vendorSku": { "type": "string", "description": "Seller Item ID" }, "itemQty": { "type": "integer", "description": "Total number of sellable units", "format": "int32" } }, "description": "The items which needs to be send in the shipment" } }, "expectedDeliveryDate": { "type": "string", "description": "expected delivery date for inbounding shipment. Can be different from provided in the rquest based on network capacity", "format": "date-time" } }, "description": "response payload" } } } }, "example": { "status": "OK", "payload": [ { "shipmentId": "0000966GDM", "shipToAddress": { "addressLine1": "120 Velocity Way.", "city": "Shepherdsville", "stateCode": "KY", "countryCode": "US", "postalCode": "40165" }, "shipmentItems": [ { "vendorSku": "WILL-SL969", "itemQty": 10 } ], "expectedDeliveryDate": "2020-11-21T00:00:00.000Z" } ] } } } }, "400": { "description": "Bad request. The inbound shipment request is malformed or contains invalid parameters.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" }, "example": { "status": "FAIL", "errors": [ { "code": "400.WFS.100", "field": "inboundOrderId", "description": "`inboundOrderId` must not be null", "info": "inboundOrderId : must not be null", "severity": "ERROR", "category": "REQUEST", "causes": [] } ] } } } }, "500": { "description": "Internal Server Error. an unexpected error occurred while processing the inbound shipment.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" }, "example": { "status": 500, "errors": [ { "code": "500.WFS.100", "field": null, "description": "An unexpected error occurred.", "info": "An unexpected error occurred.", "causes": [] } ] } } } } } } } }, "components": { "headers": { "X-Current-Token-Count": { "description": "The number of API call tokens remaining in the current rate limit window.", "schema": { "type": "integer" }, "example": 0 }, "X-Next-Replenishment-Time": { "description": "The time (in epoch milliseconds) when the next batch of tokens will be replenished. Wait until this time before retrying.", "schema": { "type": "integer", "format": "int64" }, "example": 1719500400000 } }, "schemas": { "ProblemDetails": { "type": "object", "description": "A Problem Details object as defined by RFC 9457 (https://www.rfc-editor.org/rfc/rfc9457). The 'errors' member is a Walmart-specific extension.", "properties": { "type": { "type": "string", "format": "uri-reference", "description": "A URI reference that identifies the problem type. When absent, defaults to 'about:blank'.", "default": "about:blank", "example": "about:blank" }, "title": { "type": "string", "description": "A short, human-readable summary of the problem type. Should not change from occurrence to occurrence except for localization.", "example": "Bad Request" }, "status": { "type": "integer", "format": "int32", "minimum": 100, "maximum": 599, "description": "The HTTP status code generated by the origin server for this occurrence of the problem.", "example": 400 }, "detail": { "type": "string", "description": "A human-readable explanation specific to this occurrence of the problem.", "example": "Seller ID not recognized." }, "instance": { "type": "string", "format": "uri-reference", "description": "A URI reference that identifies the specific occurrence of the problem.", "example": "/v3/fulfillment/orders-fulfillments/status" }, "errors": { "type": "array", "description": "A Walmart-specific extension. A list of field-level or domain-specific errors providing additional context.", "items": { "type": "object", "properties": { "code": { "type": "string", "description": "A Walmart-specific error code.", "example": "400.WFS.100" }, "field": { "type": "string", "nullable": true, "description": "The request field that caused the error.", "example": "inboundOrderId" }, "description": { "type": "string", "description": "Description of the error.", "example": "inboundOrderId is required." }, "info": { "type": "string", "description": "Additional information.", "example": "Provides a unique `inboundOrderId` between 1 and 100 characters." }, "causes": { "type": "array", "description": "The root causes of the error.", "items": { "type": "string" } } } } } } } }, "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." } } } } ```