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/

_images/0db770e3c1029444c7a466592fe89800.png

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

_images/2cfb12e32ce1f1a8926d661dd926b651.png

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”

http://documentation.boostmyshop.com/amazon/3_configuration.html#account-configuration

1. Accounts activation & configuration

On the Magento admin section

See also

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

_images/d5e6962e490c7a4252f0e500f0da6dc1.png

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.

Example

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

_images/b7245973e3a7bd7a7bbdebe2a2ab87cb.png

No folder or link has been selected

Here the different available section:

Installed Versions

_images/1c05c15c6c25e50b6c2dfccd6b559fe0.png

List marketplace extension installed with version and locality.

Products

_images/0b918c5b42c7a99aa2844db3b8c81091.png
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

Note

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

Note

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).

 Categories

_images/f77e7204d3ed8009d88d5f493b43a2e1.png
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

Note

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

Example

_images/b8d5a193e9ac910cd51177f038ea709f.png

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.

Orders

_images/cbfce6c586c837d160f3734b8fb2ca25.png
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

Note

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

Note

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

Debug

_images/3d4fe198a1917abda450cce0ad5a8550.png
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

Note

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

Logs

_images/a2984e741000256af8621057a89d6867.png
Field Value
Max Put a numeric value from 1 to 999

Warning

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 :

_images/59b7fa201e626635883e3c9c9ddc6e00.png

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.

Orders

_images/be476cc6945050df0ba8c027f4e50857.png

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

Products

_images/39cb13c5844b9e8fcdef0bf2b78dad53.png
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

_images/798afbba065dabc3e5c4cffbc00b1f46.png
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

Note

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”

Misc

_images/8b3ff0cd1ba9a6bfea7848f06af65faf.png
Field Value
Max to export Limit of exported products
Log last request ? Enable or disable log for Amazon queries
Sleep time after feeds To use only if you experience throttled requests
Import order type Choose type of the Import order (report, Xml), by default it is advised to let “report”.

Warning

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”

_images/8bdbab485a4d67f5910f93e93aeb75c7.png

Click on the Amazon link, and filled all informations.

_images/2445fa998a72d6d7e9004dece74559f6.png

Main

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

MWS

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

_images/9c46a7ede8b5731b6927760f6f62d1c7.png
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” )

_images/9aebe2df3e4fb65ee0462b8a9cad906e.png

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

Main

_images/91fabae432ee18f3a8219106bdb9ad2c.png
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

Note

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

Sheduled tasks

_images/61cb7c733f3aae0ff52b907306dce7c3.png
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

Price

_images/8b4aca83cd0cc9818347c0c6e4c61c22.png
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

Note

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

Taxes

_images/22f24ea44fee59c92e0b6bad701827ee.png
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.

Misc

_images/4e0153971586b5321584f18754b7350c.png
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)

Note

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

Note

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

_images/5f97b13ef6da901638846ea62ad3a947.png
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.

Shipping

_images/9b72963763402da1e4db4cff90a9e72d.png
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

Note

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.

_images/42c1616ef39eb93738a3e115950a4fe0.png

Note

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.

_images/465b58b4a31d18ac75c48c2cf42203cf.png

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.

Warning

All browse nodes are not available for all countries

_images/d988626f0058727272da8ac0ef652d11.png

Click on “Save” to confirm the association.

3. Required fields

Some categories required information for product creation.

Those categories are listed in Sales > MarketPlace > Configuration > Manage Attribute, in “Required fields” tab.

_images/390af7c70a1a50100ad6b23a44c7ad4f.png

In order to configure required fields for one category, click on the “Edit” link.

_images/5894cf3244ed58fd3ec8cb2972d7dace.png

For example we can see that Amazon Clothing category required 3 fields : clothing type, department and 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.

_images/f5474b5f49e964c240a7bfad3f372b76.png

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.

_images/df17dca0083a27a2426a6277a21f8982.png

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

Note

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.

_images/b5c0dab68d73c4175769cc3ac4fd92b2.png

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.

_images/d052a410f1ddffc58d113cb36b2ff753.png

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.