H1

Order refund

(HTTP 400)
Request content is invalid

This error occurs when you send an order refund request that exceeds the original amount paid for that order. Since refunds are cumulative, this could be due to a partial refund processed on that order earlier.

1. Fetch the order details by calling the getAnOrder A
2. Check the refund amount and ensure that it is not greater than the allowable amount.
3. Refer to the refund section of the order to see if any partial refund has been processed earlier and correct the refund amount accordingly.
4. Raise the refund request with the full details.

H2

Order cancellation

(HTTP 400)
Request content is invalid

This error occurs when you try to cancel an order that is already shipped or canceled. Orders that are already shipped can't be canceled.

1. Fetch the order details by calling the getAnOrder API.
2. Check for the order status and ensure that the order is not shipped or canceled.

H3

Order shipment failure

(HTTP 400)
Request content is invalid

This error occurs when a shipment notification is received for orders that are already shipped or canceled. Orders are auto-canceled if they are not shipped within 10 days. 

1. Fetch the order details by calling the getAnOrder API.
2. Check the order status if it is already shipped/canceled.
3. Ensure that you are sending a shipment notification for orders created within the last 10 days.

H4

Item operations: update price or inventory 

(HTTP 400)
Request content is invalid

• URL
• Header
• Payload / Feed file
• Content Type

1. Check for all the required parameters for the operation and ensure that the API call is made with correct details and parameters.
2. Refer to the API documentation at https://developer.walmart.com/#/apicenter/marketPlace/latest.

H5

Any operation

(HTTP 401)
Unauthorized

• The signature and timestamp must be regenerated for every call you make to the API, even if it is for the same endpoint.
• Digital signatures are valid for only 15 minutes and must be regenerated once they expire.

1. Ensure a new digital signature is created for every API call.
2. Ensure that you use the correct Private Key when you create the signature.
   **Note: Errors are commonly encountered if you copy a Private Key and pick up a spurious space or other character. **
3. Retry with the correct signature.
4. Refer to the Authentication section of the API documentation at https://developer.walmart.com/#/apicenter/marketPlace/latest.

H6

Item update

(HTTP 404)
Requested URL could not be found.

This occurs when you try to update an item that was not ingested successfully. It can occur either when an item is still in the process of ingestion, or if there was an error in the ingestion.

This frequently occurs when you try to update price and/or inventory shortly after an initial ingestion.

1. Check for the item's status.
2. If the item is not present, ingest the item again and then repeat your operation.
3. If the status of the item is "InProgress", and has been in this status for more than an hour, contact Walmart Partner Support.

H7

Any operation

(HTTP 405)
Method not allowed

This error occurs for API calls where the request method is not valid for a particular endpoint. For example, an API call to "Get all orders": GET https://marketplace.walmartapis.com/v2/orders{nextCursor} using DELETE method will return an error.

1. Check the HTTP request section of the API and ensure that the API call is made with the correct method.
2. Refer to the API documentation at https://developer.walmart.com/#/apicenter/marketPlace/latest.

H8

Using POST create/update request for item, inventory or price

(HTTP 423)
Resource is locked

This error occurs for API POST calls when creating or updating an item, inventory or price. For example, a call to https://marketplace.walmartapis.com/v2/feeds?feedType=item with the POST method may return an error.

1. The client is experiencing high volumes of incoming requests. Retry sending it again in one hour.
2. Refer to the API documentation at https://developer.walmart.com/#/apicenter/marketPlace/latest.

H9

Any operation

(HTTP 500)
Internal server error

This error occurs when an incorrect content type is specified while making an API call, or a payload is included that is inconsistent with the content type.

A common example of this error is in the bulk create/update Items API call, where the content type is multipart/form-data and the payload must be an attachment. 

1. Check that the API call is made with the correct content type and payload.
2. Refer to the API documentation at https://developer.walmart.com/#/apicenter/marketPlace/latest.

H10

Item create / update

(HTTP 500)
System encountered internal error.

This error occurs due to internal system issues, such as the inability to connect to any of the underlying systems, internal system data issues (duplicate data), etc.

1. Try to ingest the item again.
2. If the problem persists, contact Walmart Partner Support.

H11

Any operation

(HTTP 503) 
Service unavailable

The GMP Gateway is unavailable.

1. This is an intermittent issue. Wait a short period of time and then try again.
2. If the problem persists for longer than three hours, contact Walmart Partner Support.

H12

Order shipment failure 

(HTTP 500.456)
Request content is invalid

This error occurs when shipment notification is received for orders with "Quantity Overshipped: Some or All Line(s)/Quantity cannot be Shipped due to invalid Lines or Quantity more than allowed."

1. Fetch the order details by calling the getAnOrder API.
2. Check the line numbers for the order and quantity.
3. Check the order status if it is already shipped/canceled.
4. Ensure that you are sending shipment notification within 30 days of order created date with proper line numbers.

N1

Item create / update feed

Data Error for a specific item

This error occurs when the XML feed contains invalid or missing mandatory information for individual items. The error is returned at an individual item level.

1. Refer to the API documentation at https://developer.walmart.com/#/apicenter/marketPlace/latest.
2. Check the Feeds section to download the latest XSD files from the XSD directory.
3. Ensure that the XML used in the API call complies with the XSD file.
   ** Note: XML refers to both the contents of a payload file or the body of the request. **

N2

Item ingestion

Data Error for a specific item:
The GTIN's length should be less than 14. The current GTIN length is 26.

This error description is generated when your item encounters a specific data corruption condition.

1. Contact Walmart Partner Support, include the error message, SKU(s) affected and the Feed ID.
2. Resubmit the item after Walmart Partner Support has cleansed the data.

N3

Item ingestion

Data Error for a specific item:
SKU provided does not match Walmart records for this given item.

This error description is generated when you ingest an item that has a different SKU, but the same GTIN or UPC as an item that you have already ingested.

1. Check that the UPC or GTIN have not been ingested with an item with a different SKU.
2. If the UPC or GTIN has not been previously ingested and you are still getting this error, please contact Walmart Partner Support.

N4

Item update

Data Error for a specific item:
ERR_PDI_0034

This error message is generated when an item is ingested with invalid data. All the mandatory information should be provided while calling the API. A common example of invalid data is Shipping/Billable Weight set to 0.

1. Check the Feeds section to download the latest XSD files from the XSD directory.
2. Ensure that the XML used in the API call complies with the XSD file.
   ** Note: XML refers to both the contents of a payload file or the body of the request. **
3. Refer to the API documentation at https://developer.walmart.com/#/apicenter/marketPlace/latest.

N5

Item create / update

Data Error for entire file:
ERR_PDI_0001

Malformed data. Verify the data file to ensure it is formatted properly.

This error message is generated when there are special characters / malformed data in the Feed File of the item ingestion or item update operations. The entire file is not processed in this scenario. 

1. Check the Feeds section to download the latest XSD files from the XSD directory.
2. Ensure that the Feed File is in the correct format and there are no special characters in the Feed File. 
3. Resubmit the correct Feed File. 
4. Refer to the API documentation at  https://developer.walmart.com/#/apicenter/marketPlace/latest.

N6

Item create / update

Data Error:
ERR_PDI_0034

The length of the UPC should be 12 or 13. The current UPC length is 13.

This error message is generated during the item create / update operations when the UPC for any specific item is not 12 digits. 

The UPC for any item should be strictly 12 digits as a standard.

A 13-digit UPC code is not accepted by the system.

1. Check the item Feed File for any item that has been assigned a UPC which is not 12 digits. 
2. Correct the UPC code and ensure that all the items are coded with 12-digit UPC codes.
3. Resubmit the items with the correct feed. 
4. If the problem persists, contact Walmart Partner Support.

N7

Item create / update

Data Error:
ERR_EXT_DATA_0101116

This item has a significantly different title or price from Walmart's existing listings with the same Product ID (i.e., GTIN, UPC, etc.).

This error message is generated during the item create / update operations when the information you've provided for this item does not match the information we currently have for this item.

We compare items using the Product Identifier, and we expect your title and price to be similar to our existing information.

1. Check to make sure that you have entered the correct Product ID, title and price for the item. Correct any errors in the Product ID, title or price and resubmit the items with the correct feed.
2. If you do not have any errors, you can look up the existing item on Walmart.com using the Item ID (found in the Item Report). Take the Item ID and put it at the end of the URL https://www.walmart.com/ip/ to see the existing listing.
3. If you believe your item is correct and our current listing is incorrect, contact Walmart Partner Support.