3. Configuration

Before saving the Amazon configuration pages, you must create a MWS account.

M W S mean Marketplace Web Service

In order to create an Amazon account, go to the relevant path according to your country :

Country Link
USA https://developer.amazonservices.com
FR https://developer.amazonservices.fr
DE https://developer.amazonservices.de
ES https://developer.amazonservices.es
IT https://developer.amazonservices.it
EN https://developer.amazonservices.co.uk

If you have for instance a French seller account, then go to : https://developer.amazonservices.fr/


Click on the inscription button, next you will be asked to put your amazon seller central credentials.


In this screen, select the first radio button and click on next.

You can see your MWS credentials in the displayed page, save this information in a text file as you will need it later on during the configuration.

Now let’s move on to the point “3. Account configuration”


1. Accounts activation & configuration

On the Magento admin section

See also

Go to : Sales > Market Place > Configuration > Manage accounts


Here you can see a folder named “amazon” which represent the amazon dedicated market place and sub folder “my account” represent the created seller account associated to the market place. Finally the link “Amazon.com” showing the amazon seller’s space per country.


Amazon … … … … … .( the amazon magento extension )

     | my account … … … .( the seller account name )

          | Amazon.com … …( the account per country )

          | Amazon.fr

          | Amazon.de

1. Global configuration

When selecting the menu Sales > Market place > Configuration > Manage accounts

you will be redirected on the main configuration page for Amazon extension.

See image location details


No folder or link has been selected

Here the different available section:

Installed Versions


List marketplace extension installed with version and locality.


Field Value
Barcode attribute Select the magento attribute which will contain the barcode
Manufacturer attribute Do the same for manufacturer
Brand attribute The same for brand
Customer tax class ID Select customer tax class ID to use for tax calculation


Barcode : if you do not get any attribute for barcodes, you must create one with Scope = global, Unique value = yes and Type = text


Both attributes “Manufacturer” and “Brand” can be the same even though your Magento has got two different attributes (one for the brand and one for the manufacturer).


Field Value
Category depth for association Put a value to set the number of crawled category level after the root
Root category Choose the root category for the products to add to the market place


category level must be the same as your category architecture level after the root.



Here under “root catalog” you can see “Furniture” and “Electronics” at the same level. (The first level).

Then there is 2 sub categories for “Furniture” and 2 others for “Electronics”. (The Second level).

Finally there is a last level under “Cameras”. (The third level).

So the final value for option “category depth for association” will be 3.


Field Value
Generate invoices If set to yes, this will create invoice once the Amazon order will be imported
Order state Choose the order state for imported orders
Default payment method Select the default payment method to apply on the imported order


Order state : most of time order state is “pending” , “processing” or “on hold”


Default payment method : the extension add a new payment method named “MarketPlacePaymentMethod” you can save it or use another custom payment method.


Field Value
Email bug report Put the email address to receive the debug information
Display tool tab If set to yes you will be able to run some action to emulate the cron process
Display stack trace error in toll tab If set to yes, you will be able to see the full message in “log” tab


  • display tool tab : the available link and action for this tab are under section 4 “Tools tab”


Field Value
Max Put a numeric value from 1 to 999


All the configuration page are used for every websites and stores. Which mean if you want to separate product description, price or stock you must edit the product page on Amazon.com after product submission.

2. Amazon main configuration

The main configuration is under the first folder :


Here the account with credential MWS seller account are already created.

If it’s the first time you install the extension, you will just get the first folder “Amazon (0)” with nothing under it.



Order Range: Defined in days since when orders must to be imported from Amazon


Field Value
Product condition attribute To defined if you use a specific attribute for product condition
Product condition default value Default value send
Product condition note attribute To defined if you use a specific attribute for product condition note
Product condition note default value Default value send
Stock attribute To defined if you use a specific attribute to send your product stock quantity to amazon instead of magento stock quantity
Description attribute To defined if you use a specific attribute for product description
Image source To defined to choose the image will send for your product (image of configurable product or simple product)
Bullet points attribute To defined if you use a specific attribute for Bullet points

Category & Browse nodes

Options Description
Categories Choose the Amazon categories for your products
Browse node attribute Select the attribute to fill the browse node id when submitting a product
Browse nodes Choose the Amazon Browse nodes used by default for categories


The categories option is mandatory. It will allow our extension to match Amazon categories with your Magento categories. Example : you want to sell shoes and clothing, so select with crtl + click the categories “shoes” + “clothing”


Option Description
Max to export Limit of products sent in each Stock & Price update feed. This should be equals to around a tenth of the total number of already added products.
Log last request ? Enable or disable the log of all Amazon queries (logs are displayed in the “Logs” tab of the extension)
Sleep time after feeds To use only if you experience “throttled request” errrors
Import order type Choose the way orders will be imported (Available modes : Report or Xml). We advise to keep it on “Report”.


All the configuration page are used for every websites and stores. Which mean if you want to separate product description, price or stock you must edit the product page on Amazon.com after product submission.

3. Account configuration

Now you can create a new account, click on the button “Add new”


Click on the Amazon link, and filled all informations.



Field Descriptions
Account name Put the seller amazon account name
Active Set the account activation yes/no
Is adult product Set the product type adult yes/no
Barcode type Choose a barcode type (EAN, UPC, ASINS)

Barcode type is the standard which you will use when sending the barcode from Magento to Amazon :

  • EAN = barcode with standard EAN13
  • UPC = barcode with UPC standard
  • ASIN = Amazon Standard Identification Numbers (ASINs) are unique blocks of 10 letters and/or numbers that identify items.

Find more help on official amazon about the barcode here : http://www.amazon.com/gp/seller/asin-upc-isbn-info.html

Or read section FAQ about how to choose barcode type: http://documentation.boostmyshop.com/amazon/8_faq.html#how-to-choose-barcode-and-barcode-type


Create the MWS account if not already done: http://documentation.boostmyshop.com/amazon/3_configuration.html

Field Value
merchant id put your merchant id from MWS account
access key do the same for access key
secret key the same for secret key

Our extension allows to use multiples Amazon accounts, each account allow to sell products on different countries.

There are 3 sellers accounts types :

  • US ( United State, Canada)
  • European (France, Germany, Italy, Spain, United Kingdom)
  • Japan (China, Japan)

4. Country configuration

After having saved the MWS Amazon Seller Credential, you should get a new folder named “my account” and a new link for the market place country. ( ex: “amazon.com” )


This is the only configuration which can be different because of multiple countries. (the currency may be different).


Field Description
Active yes/no : enable or not the account for this country
Barcode required Select no only if you have a UPC/EAN exemption from Amazon
Reset update Reset all updates for synchronized products


Active : if set to “No” you won’t be able to push your products from Magento to Amazon

Sheduled tasks

Field Value
Enable product update Enable the auto process for products update
Enable order importation Enable auto order importation from Amazon to Magento
Enable trackings export Enable the auto sending for order tracking from Magento to Amazon
Enable product creation Enable the auto product submission if the products are located at “product pending response” tab


Field Value
Price attribute If you want to use an other price attribute than the Magento native, select it. Or leave empty
Is price attribute including tax? Yes/No define the actual price (does it contain tax?)
Price coef Put the price coefficient as fixed value or leave empty to disable
Currency Choose the currency to use
Margin min Set a minimum value for the product margin, leave empty to disable

Here an example of price with coef :

Price including tax  = 100 €

Coefficient = 1.1

Final Price = 110 €

calculation is : Price * Coefficient


Margin min : use this field to set the exported product stock to zero if the margin is lower than the given.


Field Value
Country Country to use for tax calculation
Region Region to use for tax calculation
Zip code zip code to use for tax calculation

Theses values are used during order importation in order to retrieve product tax as defined in Magento.

It allow to import orders with different tax values for each products.


Field Value
store id select the associated store id
customer group id choose customer group id to apply for new customer after order importation
weight unit select the weight unit (kilograms or pounds)


store id : this will allow you to manage product name by store per country account, select the store id to associate to the amazon account country


weight unit : only 2 units are managed, if you have configured your magento to show grams you must edit the amazon product page to change the unit too

Product title

Field Value
Product title type Standard/Custom : choose the “standard” type to apply default magento product title or “custom” to apply your own title in the next field
Product custom title Depends of previous option “custom”. Put your own product title here
Product title style Choose the title type : lower case or upper case

With “Product Custom Title” option, you have the possibility to use your magento attribute values to build your Amazon product name, for example:

{{sku}} - {{name}}

During product creation on Amazon, the extension will replace {{attribute_code}} with the value of this attribute for the selected product.


Field Value
Default shipment method Select the default shipping method to apply on amazon order
Default shipment delay Set the default shipment delay in day to send as information for estimated date
Delta tracking Put the number of hours before sending “sipped” status to Amazon order
Default tracking Save the label to show as shipping information when the tracking id are missing into magento order

Auto submit

This feature allows to submit products for matching automatically on Amazon.

You can define some filters in order to define which kind of products will be automatically submitted.

More information can be found here : 4. Scheduled Tasks


it uses the “Matching EAN” process, not “Add to Marketplace”

2. Categories association

This step is mandatory if you would like to use the extension to create product on Amazon.

This part allow to associate Magento categories to Amazon categories, and browse nodes if available.

The association screen is available under menu Sales > MarketPlace > Configuration > Categories.



The number of level depends of configured value “Category depth for association”.

This page lists all Magento categories.

In Amazon column, you can see which category is associated or not ( green or red link).

Click on edit button for update an association.


Select the Amazon category near “Association”. The drop down list depends of option “Categories” from configuration.

If a category is missing this mean you have forget one of it. Go back in configuration and select it.

You also have the possibility to select dedicated browse nodes.


All browse nodes are not available for all countries


Click on “Save” to confirm the association.

3. Required fields

If you wish to use the product creation function (Add to marketplace massaction), you’ll need to set required fields for some Amazon products categories.

To check these categories list, please go in Sales > MarketPlace > Configuration > Manage Attribute association, then select Amazon from the Marketplace drop-down menu, and go to the Required fields tab :


To configure required fields for a category, click on the Edit link from the category row.


For example, we can see if we click on Edit from Clothing category row, that it requires 3 fields :

  • Clothing type
  • Department
  • Style key words.

There are 3 ways to configure them :

1) Select an attribute in the attribute column, this means that you have an attribute in Magento which can be used for the required field, value must be set for each product. Some required fields have restricted values, like clothing type, in this case, a link is available in the “Restricted values” column, click on “View” in order to display them.


So the attribute value must be in listed values.

2) You can use a default value which will be used for all products.

3) You can use the ‘Create attribute’ button.


Click on the button, a drop down list will appear with all existing attribute sets. Select one in which attributes will be created.


A popup will appear so you can accept or cancel the action.

If you click on “Yes”, attributes will be created and associated with required fields but you must set values for each products.


Now when you go on product sheet, you will see a new tab on the left called “Amazon Required Fields”.

In this tab are displayed required fields attributes.


4. Variation fields

Amazon for Magento extension allow to add configurable products for some categories, for example:

  • Clothing Accessories
  • Product Clothing
  • Shoes

In order to set the relationship between products, Amazon needs to know which kind of variations are used.

You can set this in Sales > MarketPlace > Configuration > Attributes, in “Variation fields” tab. Here are listed all Magento dropdown attributes used to define variations.

Associate it with dedicated Amazon fields and save the configuration.