# Amazon Common Errors

When working with Amazon listings in LitCommerce, you may come across errors returned by Amazon during the listing or update process.

This article provides general guidance on how to resolve them.

## <mark style="color:$primary;">**Error resulting from incomplete required fields**</mark>

### <mark style="color:$info;">**Please provide at least one of the two fields: ASIN or GTIN**</mark>

<figure><img src="/files/LeAMkCZmo6B60nqSq2Wr" alt=""><figcaption></figcaption></figure>

This error occurs if the required information, either an ASIN or GTIN, is not provided during the listing process. When listing on Amazon through LitCommerce, you will fall into one of two cases:

* Create an offer using an existing ASIN from the Amazon catalog.
* Create brand-new ASINs on Amazon with GTIN Exemption.

Depending on your selected case, enter an ASIN to the listing or provide us with proof of approved GTIN Exemption to proceed. More details on the process can be found [HERE](https://litcommerce.gitbook.io/litcommerce-helpdesk/marketplace-integration/supported-platforms/amazon/how-to-list-products-on-amazon).

### <mark style="color:$info;">**Missing variant theme**</mark>

<figure><img src="/files/CtEqJwOQOXi8mM4m3izx" alt=""><figcaption></figcaption></figure>

You may encounter this error when trying to publish a variant listing without mapping the Variant Theme. Variant Theme is required for listings with variations, as it helps Amazon define how variations are grouped and displayed on the marketplace.

Refer to [this section](https://litcommerce.gitbook.io/litcommerce-helpdesk/marketplace-integration/supported-platforms/amazon/how-to-list-products-on-amazon#variant-theme) for a clearer understanding of the field and how to map it.

### <mark style="color:$info;">**\[Field] is required but not supplied**</mark>

<figure><img src="/files/bbOfRIJRe6BmOvPee4oH" alt=""><figcaption></figcaption></figure>

There are two scenarios in which this error may appear:

<details>

<summary><strong>1- List products on Amazon</strong></summary>

You may still encounter this error even after completing all the standard required fields. This happens because Amazon may require additional fields for specific products.

To resolve, follow the error message and locate the missing fields under each tab to fill in their values.

<figure><img src="/files/ADcXam8lNQWSv9VXP5GU" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
**Most fields required by Amazon can be located in the `Select Additional Fields` button under the Listing Details tab.**
{% endhint %}

<figure><img src="/files/LajsPxVeZfSnZoH2mRZl" alt=""><figcaption></figcaption></figure>

After ensuring all necessary fields are filled out, click `Save & Publish` to send the updated data to Amazon.

<figure><img src="/files/yCuOHq2RThFpLgzNMa1q" alt=""><figcaption></figcaption></figure>

</details>

<details>

<summary><strong>2- Imported Amazon listings</strong></summary>

Listings imported from Amazon may lack certain information due to the Amazon API limits.

When you manually trigger an update from LitCommerce using the `Save & Publish` or `Update to Amazon` button, Amazon will detect the missing data and return an error message.

This error does not affect the automatic sync process. If you are only using LitCommerce for syncing, simply ignore it.

However, if you are using LitCommerce to manually update listing data, be sure to complete the required fields as indicated in the error message to clear the issue.

</details>

## <mark style="color:$primary;">**Error caused by conflicts with existing Amazon data**</mark>

### <mark style="color:$info;">**You cannot change the product type of an existing ASIN**</mark>

<figure><img src="/files/kpAkhIwN8eY2J0Temze1" alt=""><figcaption></figcaption></figure>

This error occurs when publishing a listing using an existing ASIN, but the provided Product Type does not match the one associated with that ASIN. This mismatch may lead to Amazon policy violations.

Note that your listing must exactly match key listing details (such as title, description, product type, and more) with the selected ASIN.

To correct this error, go to the Listing Details tab (within the listing details page) or open the Listing Details Template and update the Product Type to match the ASIN. Once updated, click `Save & Publish` to resubmit the listing with the corrected data.

<figure><img src="/files/q8Use0J3DgACaicT3vy8" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
**Changing the Product Type will require re-entering data in the associated fields. Make sure to double-check the information during the process.**
{% endhint %}

If you are unable to locate the appropriate Product Type, [contact us](https://litcommerce.com/contact-us/) for assistance.

### <mark style="color:$info;">**The Listing data provided is different from what's already in the Amazon catalogue**</mark>

<figure><img src="/files/8es40reP85z3ofy3lDQe" alt=""><figcaption></figcaption></figure>

This error occurs when publishing your listing using an existing ASIN, but the provided listing details are different from the information associated with that ASIN.

To fix this, review the error message and update your listing details to align with the selected ASIN. Once the data is accurate, simply click `Save & Publish` to republish and clear the error.

## <mark style="color:$primary;">**Error due to Amazon API limitation**</mark>

### <mark style="color:$info;">**Due to Amazon API Limits, you can only publish once every 5 minutes to Amazon**</mark>

<figure><img src="/files/0vCabnb790a5MfJhI3ei" alt=""><figcaption></figcaption></figure>

The Amazon API has certain limitations during the publishing process. As noted in the error message, only one publish action is allowed every 5 minutes. However, you can publish up to 100 listings at a time in a single action.

{% hint style="success" %}
**Adjust the number of Rows per page up to 100 at the bottom-right of the LitCommerce Amazon channel interface.**
{% endhint %}

<figure><img src="/files/A8ESGS3rwzzJF2FWCHPn" alt=""><figcaption></figcaption></figure>

To bulk publish, select the listings, click on `Select Action`, and then `Publish to Amazon`.

<figure><img src="/files/jKjnXVv3ol6uRfFthDOC" alt=""><figcaption></figcaption></figure>

### <mark style="color:$info;">**Listing has not been completely configured**</mark>

<figure><img src="/files/f5qs952x9ekrfs4UNEUK" alt=""><figcaption></figcaption></figure>

This error appears because Amazon has not yet fully processed the listing data sent from LitCommerce when publishing products. It typically means your listing is in progress and will become Active shortly.

To clear the error, simply click `Save & Publish` or `Publish to Amazon` to trigger an update.

If you have any questions, let us know via the Chat Box in the bottom-right corner of our Help Center.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.litcommerce.com/marketplace-integration/supported-platforms/amazon/amazon-common-errors.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.