There are several reasons why a product may not integrate correctly between Amazon and your VTEX store, and each one generates a notification about the nature of the error. You can find the error message in the VTEX Admin if you go to the Marketplace > Connections > Products module, or if you search for it in the search bar. On the Products page, filter by Amazon as the marketplace and click the product to view the message.

After fixing the error, you must manually reprocess the inventory integration for that SKU. You can do that from the same place where you view the error by clicking Actions > Reprocess.

In this article, we cover the following errors:

• Errors in the Amazon category and attribute mapping spreadsheet
• Errors related to missing mandatory attributes on Amazon
• Errors related to divergence between VTEX and Amazon catalogs (offer matching)
• Errors related to Amazon tokens and permissions
• Errors related to the configuration of the Amazon integration
• Errors when submitting the VTEX global category
• Inactive SKU warning

The VTEX global category for this SKU was not completed or was completed incorrectly in the mapping spreadsheet

This error occurs when the global category is not configured or was configured incorrectly. Amazon uses the global category from the VTEX platform to map products. That is why it is important that the equivalence between the VTEX global category and the Amazon general categories is done correctly.

To fix this error, configure the global category of your product.

Specification (X) from the mapping spreadsheet was not found in the product or SKU specification in your VTEX catalog

This error occurs when the spreadsheet contains a specification that does not exist in the VTEX catalog. To fix this error, you need to add a product or SKU specification. To view the values supported by Amazon, open the Amazon mandatory attribute spreadsheet and check the VALID VALUES tab.

Value (X) from the mapping spreadsheet is not an attribute/specification value supported by Amazon

This error occurs when specification X is not supported by Amazon. You need to add a specification that is supported by Amazon. To view the values supported by Amazon, open the Amazon mandatory attribute spreadsheet and check the VALID VALUES tab.

The VTEX global category ID for this product was not found in the mapping spreadsheet

This error occurs when the global category is not configured or was configured incorrectly. To fix this error, configure the global category of your product.

The "Material" or "Department" specification value from the spreadsheet is not an attribute/specification supported by Amazon

For both of these errors, the VTEX global category of the product selected by the seller requires the Department or Material attributes as mandatory in the product, and completing the mapping spreadsheet. Add the attribute to the product and complete it in the spreadsheet as shown in the example below:

• The category and attribute mapping spreadsheet was not uploaded

  This error occurred because the Amazon mapping spreadsheet was not uploaded. You need to complete the Amazon mapping spreadsheet and upload it once it is completed.

• The value of specification (X) from the spreadsheet does not exist in the VTEX product specification

  In this error, the attribute in question has not been added to the SKU in the VTEX catalog. You need to add the attribute and redo the mapping of the submitted product.

• The minimum age unit from the mapping spreadsheet is different from the value expected by Amazon.

  The minimum age unit is different from the value requested by Amazon. Amazon supports years or months as units. Resubmit the mapping using the values accepted by Amazon.

• Amazon does not accept the SKU variation from the mapping spreadsheet

  This error occurs when the VariationTheme column of the Amazon mapping spreadsheet contains a value that is not supported by Amazon Check the supported values and add a valid value to the mapping spreadsheet.

• The "SizeMap" attribute value from the mapping spreadsheet is not an attribute/specification value supported by Amazon

  You added an incorrect value for the SizeMap attribute. To view the values supported by Amazon, open the Amazon mandatory attribute spreadsheet and check the VALID VALUES tab.

• The "TargetGender" specification value from the spreadsheet is not an attribute/specification value supported by Amazon

  You added an incorrect value for the TargetGender specification. To view the values supported by Amazon, open the Amazon mandatory attribute spreadsheet and check the VALID VALUES tab.

• The color and size attributes for this SKU were not found in the mapping spreadsheet

  You did not add a value for the Color and Size specifications that are mandatory for the category of the product you want to submit. Check the Amazon mandatory attribute spreadsheet to see the values supported by Amazon and add a valid value to the mapping spreadsheet.

• The SKU does not have a value for the "author" attribute or the mapping spreadsheet does not contain a value for it

  You did not add the mandatory Author attribute to the product you want to submit. To view the values supported by Amazon, open the Amazon mandatory attribute spreadsheet, check the VALID VALUES tab, and add a product specification for this attribute.

• The "Size" attribute value from the mapping spreadsheet is not an attribute/specification value supported by Amazon

  You did not add the Size specification value correctly. To view the values supported by Amazon, open the Amazon mandatory attribute spreadsheet and check the VALID VALUES tab.

• The "Color" attribute value from the mapping spreadsheet is not an attribute/specification value supported by Amazon

  You did not add the Color specification value correctly. To view the values supported by Amazon, open the Amazon mandatory attribute spreadsheet and check the VALID VALUES tab.

• The SKU does not have a value for the "Color" attribute or the mapping spreadsheet does not contain a value for it

  The Color attribute is required for the category of the product you are submitting to Amazon and the SKU does not have it, or it was not added to the mapping spreadsheet. You need to add a SKU specification for the Color attribute and/or redo themapping for the submitted product.

• The "TargetGender" product specification is mandatory for integrating this product with Amazon

  The TargetGender product specification is mandatory for the category of the product you are submitting. Amazon may call it Department or TargetGender depending on the category. Add the TargetGender product specification and redo the mapping.

• The SKU already exists in the Amazon catalog and is ready for matching between VTEX and Amazon. However, the value of attribute (X) for this SKU on VTEX is different from the value it has on Amazon. It has value (X) on VTEX and value (Y) on Amazon.

  This error occurs when there are differences between attribute values (details of SKU characteristics) in the Amazon and VTEX catalogs. To fix this error, you need to edit the attribute value on VTEX to make it match the attribute value on Amazon.

• SKU XXXXX, Missing AttributesX. SKU XXXXX doesn't match any ASINs. Make sure that all standard product ids (such as UPC, ISBN, EAN, or JAN codes) are correct.

This error occurs when a SKU in your feed does not match any ASIN in Amazon's catalog, and the product attribute data is not sufficient to create an ASIN. To resolve it, make sure you are submitting the information correctly according to the values required Amazon mandatory attribute spreadsheet.

• The token entered in the Amazon configuration form on VTEX expired or does not have permission to access the flow

  This error occurred because the serial number of the MWS authorization token expired. Contact Amazon to fix this problem, and reconfigure the Amazon integration.

• Your account does not have permission on Amazon MWS

  Missing permissions on Amazon MWS. To fix this error, you need to contact Amazon through Amazon Seller Central. You can see more information about accounts in the Amazon documentation under Managing your AWS account. To learn more about the security policy for Amazon seller accounts, read Security in AWS Account Management.

• The value of the "Shipping type name" field in the configuration of the Amazon integration on VTEX is different from the value it has on Amazon Seller Central

  This error occurs when there is no equivalence between the value entered for the Shipping type name field in the Configuring the Amazon integration step on VTEX and the value it has on Amazon Seller Central. Check the Amazon Seller Central documentation to clarify questions and fix the problem.

• The value of the "SELLER ID" field in the configuration of the Amazon integration on VTEX is different from the value it has on Amazon Seller Central

  This error occurs when there is no equivalence between the value entered for the Seller ID field in the Configuring the Amazon integration step on VTEX and the value it has on Amazon Seller Central. Keep in mind that during the integration configuration, the Seller ID value you are asked to enter is the one from Amazon. Check the Amazon Seller Central documentation to clarify questions and fix the problem.

• The VTEX global category (X) for this SKU is not configured correctly in the integration

  This error occurs when the global category that was selected in the mapping does not exist on Amazon. Check the product global category mapping and make sure that the selected category is linked with Amazon.

• The SKU you tried to submit is inactive on VTEX

  The SKU is not active on VTEX. Only active SKUs can be integrated. Sometimes this error is generated by old collections linked to the Amazon trade policy that contain inactive SKUs. Check the SKU status on the Admin through the PRODUCTS > Catalog > Products and SKUs module and activate the SKU if needed.