Before you can start submitting product feeds to an Amazon marketplace connected to your X-Cart store, you need to configure the marketplace settings. To access the settings of a connected marketplace in your store, locate the marketplace/account you require on the Amazon marketplaces list and click on the settings button (Gear icon) opposite its name.

You will be redirected to the marketplace settings page.

At the top of the page, a slider control is provided; the slider state indicates whether the marketplace is currently "On" or "Off" and also allows you to change this status.

The page comprises three tabs:

The General Info tab provides technical info about the marketplace connection.

This includes a Merchant ID, a Marketplace ID, an indication of the Refresh Token status, and the expected Token expiration date. There is also the Reconnect Marketplace button that allows you to reset the marketplace connection.

Amazon employs Access Tokens and Refresh Tokens to securely manage access to its services. An Access Token is a short-term credential, generally valid for around an hour, that enables your application to make authenticated requests to Amazon's APIs and services, acting as a temporary pass. On the other hand, a Refresh Token, which has a significantly longer lifespan, is used to obtain a new Access Token once the current one expires, ensuring uninterrupted access to Amazon's services without the need for manual re-authentication.

You don't need to manually update your Access Tokens; they will be automatically refreshed as long as you possess a valid Refresh Token. However, it's important to note that Refresh Tokens expire after one year. Once expired, you'll notice that your Refresh Token is marked as inactive in the General Info tab, indicating the need for renewal. To continue seamless service interaction, you must renew your Refresh Token and then reconnect the marketplace by clicking the Reconnect Marketplace button.

The Data Mapping tab allows you to configure the data mapping rules for your store's Amazon integration at the marketplace level .

Basically, you need to configure two layers of mapping rules: category mapping rules and product field mapping rules.

Category mapping rules in X-Cart's Amazon integration are essentially guidelines or instructions that dictate how products from specific categories within your X-Cart store should be assigned to corresponding categories on Amazon's marketplace. These rules help ensure that products are accurately categorized and listed on Amazon, aligning with the categories and organization structure of both platforms. Essentially, they define which X-Cart store categories should be represented in which Amazon categories.

Because of how the Amazon category tree works, we must also take into account Amazon's product type-based classification. Compared to a category, a product type represents a higher-level classification that encompasses multiple categories.

Every product you intend to list on Amazon ultimately needs to have a correctly specified product type. This ensures that the product will be placed in a relevant Amazon category, increasing the likelihood of potential buyers finding it. Additionally, the product type dictates which fields in the catalog need to be filled out for a specific product. When a product is correctly assigned to a specific product type, it enables you to provide accurate product details, attributes, and specifications, meeting the requirements for publication in a specific category and ensuring potential buyers can get all the necessary product information.

Because the catalog fields associated with different product types on Amazon are likely to be different from the ones used by X-Cart, you need to map the fields

So let's see how to configure your Amazon integration mapping rules.

At this step, we specify the categories in our X-Cart store's catalog from which we want to submit products to Amazon and define how these categories should be translated to Amazon product types and categories.

Initially, no categories are mapped. To configure a mapping rule:

Be sure to configure mapping rules for every category in your catalog from which you are going to sell products on the selected marketplace. Be sure to save your changes by clicking the Save changes button.

For the sake of example, let us map one more category:

At this step, we map X-Cart product fields to Amazon product type fields. Once the Save changes button has been clicked at the end of the previous step, X-Cart requests Amazon's fields for the product types we have selected for our products.

The process may take a while to complete. Once finished, the page will provide a list of fields from Amazon that now need to be mapped.

The fields are presented in a single list without division by product types. (Some fields are used for more than one product type, so there is no need to configure fields separately for each type).

To configure a mapping rule:

For example, we need to map the Amazon product field "Brand Name." We click within the X-Cart product field selector opposite it and search using the word "brand". As a result, we find the X-Cart field "Brand". We click on the field name, and it is entered into the selector field.

Be sure to map all the required fields on the list. (The fields that are required for all the product types are marked with asterisks.) The more fields you will map, the more detailed information you will provide to Amazon when listing products there.

For convenience, the ability to filter the list of fields is provided. For example, you can easily find all fields with a name containing the word "name".

Furthermore, you can refine the filtering query by specifying additional options (Required, Mapped, Not mapped, All fields).

Once you are done configuring the field mapping rules, be sure to save your changes by clicking Save changes.

For the sake of example, we have mapped three fields:

If necessary, you can refine the mapping rules at the level of individual categories and products.

The Import & Export Options tab provides the general settings defining how the export of products from the X-Cart store to Amazon through feeds and the import of orders from Amazon to the X-Cart store should happen.

Related pages: