--- updatedAt: 2026-08-03T17:43:27.000Z --- # Get Inbound Shipment errors

Migrate to Global APIs: New sellers and approved Solution Providers should use Global APIs. Existing users must migrate to avoid disruption and access new capabilities coming to your market. Explore Global Marketplace migration resources.


After Sellers request to create an Inbound Order, WFS may return error responses with error codes. Type of errors: - SKUs not in WFS catalog: Sellers need to make sure all SKUs have already been converted and added to the WFS catalog- Missing required information; - Invalid Product ID (incorrect number of digits); - Duplicated Inbound Order ID: Inbound Order ID has already been used before- Duplicated Product IDsMost of these errors can be prevented with a robust API integration that does not allow the mistakes to be made. Seller should update the request based on the error message and re-submit the request.Please note, once the Inbound Order is created successfully after the re-submission, historical errors under the same Inbound Order ID will be removed and no longer accessible. [block:html] { "html": "\n \n" } [/block] # OpenAPI definition ```json { "openapi": "3.0.1", "info": { "version": "1.0", "title": "Fulfillment Management", "description": "With Walmart Fulfillment Services, you can focus on sales while we 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, "explorer-enabled": true }, "servers": [ { "url": "https://marketplace.walmartapis.com", "description": "Production URL" } ], "paths": { "/v3/ca/fulfillment/inbound-shipment-errors": { "get": { "tags": [ "Fulfillment" ], "summary": "Get Inbound Shipment errors", "description": "

Migrate to Global APIs: New sellers and approved Solution Providers should use Global APIs. Existing users must migrate to avoid disruption and access new capabilities coming to your market. Explore Global Marketplace migration resources.


After Sellers request to create an Inbound Order, WFS may return error responses with error codes. Type of errors: - \tSKUs not in WFS catalog: Sellers need to make sure all SKUs have already been converted and added to the WFS catalog- \tMissing required information; - \tInvalid Product ID (incorrect number of digits); - \tDuplicated Inbound Order ID: Inbound Order ID has already been used before- \tDuplicated Product IDsMost of these errors can be prevented with a robust API integration that does not allow the mistakes to be made. Seller should update the request based on the error message and re-submit the request.Please note, once the Inbound Order is created successfully after the re-submission, historical errors under the same Inbound Order ID will be removed and no longer accessible.", "externalDocs": { "description": "View Guide", "url": "/doc/ca/ca-mp/ca-mp-fulfillment/#17919" }, "operationId": "getInboundOrderErrors", "parameters": [ { "name": "offset", "in": "query", "description": "offset is the number of records you wish to skip before selecting records.", "required": false, "schema": { "type": "string", "default": "0" } }, { "name": "limit", "in": "query", "description": "The number of Purchase Orders to be returned.", "required": false, "schema": { "type": "string", "default": "10" } }, { "name": "inboundOrderId", "in": "query", "description": "Unique ID identifying inbound shipment request.", "required": false, "schema": { "type": "string" } }, { "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" }, { "name": "WM_SEC.TIMESTAMP", "in": "header", "description": "The Epoch timestamp", "required": true, "schema": { "type": "string" }, "example": "1443748249449" }, { "name": "WM_SEC.AUTH_SIGNATURE", "in": "header", "description": "The vendor's digital signature, generated by running the JAR file or custom generation code", "required": true, "schema": { "type": "string" }, "example": "9fg3TPeRt0WSGbXNGGj4kSQ9L6PMBX.....9Zj5aDyg=" }, { "name": "WM_CONSUMER.ID", "in": "header", "description": "A unique ID required to access the API", "required": true, "schema": { "type": "string" }, "example": "Get the Consumer ID from Developer Center after logging in" }, { "name": "Accept", "in": "header", "description": "Accept Header", "required": true, "schema": { "type": "string" }, "example": "application/json" } ], "responses": { "200": { "description": "Successful Operation", "content": { "application/json": { "schema": { "type": "object", "properties": { "headers": { "type": "object", "properties": { "totalCount": { "type": "integer", "description": "total number of POs for provided GET request.", "format": "int32" }, "limit": { "type": "integer", "description": "provided limit value in the request", "format": "int32" }, "offset": { "type": "integer", "description": "provided offset value in the request.", "format": "int32" } } }, "payload": { "type": "array", "description": "response payload", "items": { "type": "object", "properties": { "inboundOrderId": { "type": "string", "description": "Unique ID identifying inbound shipment requests" }, "createdDate": { "type": "string", "description": "created date for the request", "format": "date-time" }, "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": { "type": "array", "description": "inbound shipment request line items", "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:\"BAG\", \"LABEL\", \"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" } }, "errors": { "type": "array", "description": "Error in inbound shipment creation", "items": { "required": [ "code" ], "type": "object", "properties": { "code": { "type": "string" }, "field": { "type": "string" }, "description": { "type": "string" }, "info": { "type": "string" }, "severity": { "type": "string", "enum": [ "INFO", "WARN", "ERROR" ] }, "category": { "type": "string", "enum": [ "APPLICATION", "SYSTEM", "REQUEST", "DATA" ] }, "causes": { "type": "array", "xml": { "wrapped": true }, "items": { "type": "object", "properties": { "code": { "type": "string" }, "field": { "type": "string" }, "type": { "type": "string" }, "description": { "type": "string" } }, "xml": { "name": "Cause" } } } }, "xml": { "name": "Error" } } } }, "description": "response payload" } } } }, "example": { "status": "OK", "header": { "headerAttributes": { "limit": 10, "offset": 0, "totalCount": 5 } }, "payload": [ { "inboundOrderId": "2024AKSMAR22", "createdDate": "2024-03-19T13:08:17.293Z", "returnAddress": { "addressLine1": "1st Street", "addressLine2": "123", "city": "Ontario", "stateCode": "ON", "countryCode": "CA", "postalCode": "K1A0B1" }, "orderItems": [ { "nonSortItem": false, "index": 0, "volume": 0, "divisionId": "0", "supDeptId": "0", "depId": "0", "categoryId": "0", "invAssignmentPriority": 0, "itemPrice": 0, "productType": "GTIN", "sku": "sku_fr_ca_07960540548628", "itemDesc": "Violin and Viola", "itemQty": 20, "vendorPackQty": 5, "innerPackQty": 4, "expectedDeliveryDate": "2027-10-08T00:00:00.000Z" } ], "errors": [ { "code": "400.WSAAS.100", "field": "orderItems[0].productId", "description": "Bad Request", "info": "productId cannot be null/empty", "severity": "ERROR", "category": "REQUEST" }, { "code": "400.WSAAS.100", "field": "orderItems[0].productId", "description": "productId with productType GTIN should be 14 digit", "info": "productId with productType GTIN should be 14 digit:null", "severity": "ERROR", "category": "REQUEST" } ] }, { "inboundOrderId": "2024AKSMAR22", "createdDate": "2024-03-19T12:44:34.823Z", "returnAddress": { "addressLine1": "1st Street", "addressLine2": "123", "city": "Ontario", "stateCode": "ON", "countryCode": "CA", "postalCode": "K1A0B1" }, "orderItems": [ { "nonSortItem": false, "index": 0, "volume": 0, "divisionId": "0", "supDeptId": "0", "depId": "0", "categoryId": "0", "invAssignmentPriority": 0, "itemPrice": 0, "productType": "GTIN", "sku": "sku_fr_ca_07960540548628", "itemDesc": "Violin and Viola", "itemQty": 20, "vendorPackQty": 5, "innerPackQty": 4, "expectedDeliveryDate": "2027-10-08T00:00:00.000Z" } ], "errors": [ { "code": "400.WSAAS.100", "field": "orderItems[0].productId", "description": "Bad Request", "info": "productId cannot be null/empty", "severity": "ERROR", "category": "REQUEST" }, { "code": "400.WSAAS.100", "field": "orderItems[0].productId", "description": "productId with productType GTIN should be 14 digit", "info": "productId with productType GTIN should be 14 digit:null", "severity": "ERROR", "category": "REQUEST" } ] }, { "inboundOrderId": "411-1657540052206", "createdDate": "2022-07-11T11:48:10.660Z", "returnAddress": { "addressLine1": "24 EAGLEVIEW WAY ", "city": "GEORGETOWN", "stateCode": "ON", "countryCode": "CA", "postalCode": "l7g6n3" }, "orderItems": [ { "nonSortItem": false, "index": 0, "volume": 0, "divisionId": "0", "supDeptId": "0", "depId": "0", "categoryId": "0", "invAssignmentPriority": 0, "itemPrice": 0, "productId": "06570511435294", "productType": "GTIN", "sku": "SKU-06570511435294", "itemDesc": "Lip Gloss", "itemQty": 200, "vendorPackQty": 200, "innerPackQty": 1, "expectedDeliveryDate": "2022-07-13T11:47:00.000Z" } ], "errors": [ { "code": "400.WSAAS.100", "field": "returnAddress.postalCode", "description": "postalCode is invalid .enter valid postalCode", "info": "postalCode is invalid .enter valid postalCode", "severity": "ERROR", "category": "REQUEST" } ] }, { "inboundOrderId": "411-1657539821827", "createdDate": "2022-07-11T11:44:43.760Z", "returnAddress": { "addressLine1": "24 eagleview way ", "city": "georgetown", "stateCode": "ON", "countryCode": "CA", "postalCode": "l7g6n3" }, "orderItems": [ { "nonSortItem": false, "index": 0, "volume": 0, "divisionId": "0", "supDeptId": "0", "depId": "0", "categoryId": "0", "invAssignmentPriority": 0, "itemPrice": 0, "productId": "06570511435911", "productType": "GTIN", "sku": "SKU-06570511435911", "itemDesc": "Dell Computer", "itemQty": 50, "vendorPackQty": 50, "innerPackQty": 1, "expectedDeliveryDate": "2022-07-12T11:42:00.000Z" } ], "errors": [ { "code": "400.WSAAS.100", "field": "returnAddress.postalCode", "description": "postalCode is invalid .enter valid postalCode", "info": "postalCode is invalid .enter valid postalCode", "severity": "ERROR", "category": "REQUEST" } ] }, { "inboundOrderId": "411-1657539766448", "createdDate": "2022-07-11T11:43:41.680Z", "returnAddress": { "addressLine1": "24 eagleview way ", "city": "georgetown", "stateCode": "ON", "countryCode": "CA", "postalCode": "l7g6n3" }, "orderItems": [ { "nonSortItem": false, "index": 0, "volume": 0, "divisionId": "0", "supDeptId": "0", "depId": "0", "categoryId": "0", "invAssignmentPriority": 0, "itemPrice": 0, "productId": "06570511435706", "productType": "GTIN", "sku": "SKU-06570511435706", "itemDesc": "Dell Computer", "itemQty": 10, "vendorPackQty": 10, "innerPackQty": 1, "expectedDeliveryDate": "2022-07-12T11:42:00.000Z" } ], "errors": [ { "code": "400.WSAAS.100", "field": "returnAddress.postalCode", "description": "postalCode is invalid .enter valid postalCode", "info": "postalCode is invalid .enter valid postalCode", "severity": "ERROR", "category": "REQUEST" } ] } ] } } } } } } } } } ```