nopcommerce and Amazon Plugin 1
List of content: 1. How to install... 3 2. Configuration... 4 a. Global Settings... 4 b. Amazon MWS parameters... 5 3. Categories - Settings... 7 4. Products... 8 a. Settings... 8 b. Product settings... 11 c. How Amazon processes requests (source: Amazon Docs):... 13 d. Upload... 14 5. Common errors... 17 a. SKU and brand_name... 17 b. Publication Date... 18 6. Tasks... 18 a. Set tasks... 18 b. Message from tasks.... 18 c. Import orders... 19 2
1. How to install Plugin should be installed before use. o o Unzip downloaded zip file. Copy Misc.Amazon directory to [your nopcommerce website directory]\plugins. In admin panel go to Configuration -> Plugins a) Click Reload list of plugins ; b) Install Plugin; 3
2. Configuration a. Global Settings Go to Configuration -> Plugins -> Amazon -> Global Settings and reload list of plugins. Fill all necessary fields/parameters: Property MerchandId from Amazon AccessKeyId from Amazon SecretAccessKey from Amazon Country Send product - with price/picture/stock - one click Use Manufacturer Task Enabled - Update Stock in Amazon Update stock in Amazon - Each Minutes Task Enabled - Check status in Amazon - Message Check status in Amazon - Message Each Minutes Description Merchand ID which you will get from Amazon WMS AWS Access Key ID which you will get from Amazon WMS Secret Key which you will get from Amazon WMS Country for Amazon marketplace e.g. for UK http://www.amazon.co.uk/ Check this option if you want to send price, picture and stock quantity during product uploading to Amazon. Send Manufacturer during product uploading to Amazon. Enables service for stock updates in Amazon. Time interval for stock updates (in minutes). Enables service for statuses updates from Amazon Time interval for statuses updates (in minutes). 4
b. Amazon MWS parameters To use your selling account with Amazon MWS, you need to go to http://developer.amazonservices.com and click Sign up for MWS. Sign into your staging account and follow the on-screen instructions. The last page of registration will display the Merchant ID and Marketplace ID for the staging account, plus the additional developer credentials you need to make successful MWS requests. Note: To be eligible to use MWS, sellers must have at least one of the following: a non-individual Selling on Amazon account, an Amazon WebStore account, a Checkout by Amazon account, or an Amazon Product Ads account. Sellers with only individual Selling on Amazon accounts are not eligible to register for or use MWS. If you are an individual seller and would like to use MWS, you can become eligible to register for MWS by upgrading to a Pro Merchant seller account from the Amazon Services Selling on Amazon page. More: https://developer.amazonservices.com/gp/mws/faq.html/175-6556828-5163438 5
Sign in to you non-individual seller account: Choose appropriate option and click Next : Accept Terms of Conditions and click Next. 6
Save your Amazon MWS parameters: 3. Categories - Settings There is extra tab on Category Details. Use it to map store categories with Amazon ones and appreciate Tax Codes (if needed). 7
4. Products a. Settings There is extra tab on Product Details. Note: you need to be familiar with Amazon selling. See Amazon s tutorials: https://sellercentral.amazon.com/gp/help/help.html/ref=xx_200422790_conr_help?itemid=200986880 Each category is different and has got own rules and required fields. Our example will base on Books Category. 8
If you are trying to upload/create product (in our case book) you have to fill all necessary parameters: As you can see some fields are required. Note: This fields you may also fill at Product details in Specification attributes or Amazon tab. See 4 b) section. Note: If product already exists in Amazon database you will not be able to create new one. Amazon checks UPC/EAN/ISBN. Plugin will add product to your Inventory in Amazon Seller Central based on existing product. Only SKU, price, stock quantity from your store will be updated to Amazon. Note: Amazon validate EANs/UPCs, they must be created in accordance with standards (see more: http://www.gs1.org/genspecs) For our example (book), following fields are required: author: Author name or names. title: Title of the book. publisher: The book's publisher. pub-date: Date of publication (edition-specific). Format the date as YYYY-MM- DD using custom cell formatting in Excel. binding: Binding type (hardcover, paperback, etc.). All field for Books Category: Local Label Name Example Required? SKU 10162513 Required Product ID 0452011876 Required Product ID Type UPC Required Title Olympus Camedia C-50 Digital Camera Required Publisher Sony, Kitchen Aid, Microsoft Optional Product Description classic Optional 9
Update Delete Update Optional Author J.K.Rowling Required Binding paperback Required Publication date 1994 Required Edition Number Teacher's Edition, Unabridged Version, etc. Optional Standard Price 249.99 Optional Quantity 152 Optional Item Condition New Optional Offer Condition Note Slightly worn on the corners. Optional Product Tax Code A_GEN_NOTAX Optional Expedited Shipping N Optional Will Ship Internationally 1 Optional Standard Plus Y Optional Scheduled Delivery SKU List fresh-frozen Optional Search Terms1 - Search Terms5 Dark Chocolate, Apples, Cookies Optional Main Image URL http://www.companyname.com/images/1250.main.jpg Required Main Offer Image http://www.companyname.com/images/1250.offer.jpg Optional Offer Image1 - Offer Image4 http://www.companyname.com/images/1250.offer.jpg Optional Fulfillment Center ID AMAZON_NA Optional Package Height 10 Optional Package Width 10 Optional Package Length 10 Optional Package Dimensions Unit Of Measure CM Optional Package Weight 10 Optional Package Weight Unit Of Measure OZ Optional Subject Early Civilization Optional Language English Optional Illustrator John Smith Optional Signed By Author, Illustrator, Editor, Other Optional Dust Jacket Condition Very Good Optional Pages 270 Optional Number in Series 2 Optional Series Title Fourth Edition, 1967 Optional Editor Mary A. Silver Optional Preface Jeff Dojion Optional Colorist Jeff Dojion Optional Compiler Jenny Placentino Optional Composer1 - Composer10 Bela Bartok Optional Creator Edgar Rice Burroughs Optional Drawings Ken Maryanski Optional Painter John Singer Sargent Optional Reader Barbara Rosenblat Optional Series Editor Peter Clarke Optional Technical editor Aaron Gustafson Optional 10
Adapter Hiawyn Oram Optional Afterword Corinne O'Kelly Optional Artist1 - Artist10 Andy Warhol Optional Foreword Gabrielle Hamilton Optional Introduction Jon Kristy Optional Translator John Smith, Jr. Optional Photographer Michael O'Brien Optional Digital Media Format1 - Digital Media Format10 dvd_video Preferred Definitions for most important fields: SKU: A SKU is a "stock keeping unit" used to track inventory. The SKUs must be unique for each individual item in your current template and existing listings. quantity: Enter a non-negative integer. The items must be in stock and on-hand at the time a purchase is made. price: The price (per item), in local currency, without currency symbols. item-condition: A numerical entry that indicates the condition of the item. Review the Condition Guidelines. product-id: The ISBN of your book listing (if applicable). You can also use the ASIN, UPC, or EAN. This field is optional but recommended if you have it cataloged in your database or can otherwise provide it. See Books ISBN Requirements and Exemptions. If product-id is not provided, then the following fields are required: author title publisher pub-date (The publication date should be the latest copyright date and NOT the original date of publication.) binding price product-id-type: A numerical entry that indicates if the product-id is an ASIN, ISBN, UPC, or EAN code or number. When uploading files in Standard Book format, this field value will default to "2" (ISBN) unless otherwise specified. Binding (has to come from valid values) Read Amazon documentation or contact us if you need help with Categories specification and necessary /required fields. b. Product settings As mentioned above, fields may be filled directly at plugin. Note: To automate products uploading, you can prepare all necessary fields as Specification Attributes in nopcommerce. Plugin will automatically attach them during upload or at the Amazon tab: 11
If you will add data at Specification attributes, at Amazon tab correct data will be automatically filled. 12
c. How Amazon processes requests (source: Amazon Docs): 13
Each request has own Id called FeedSubmitionId. Request/messages and their statuses you will find in Plugins -> Amazon -> Message. d. Upload To send product to Amazon SKU and GTIN are required. GTIN means EAN13 or UPC or ISBN. On Amazon Tab on product details you will find following fields and buttons: FeedSubmissionId means request id when product is sent to Amazon (all messages you can find in Plugins -> Amazon -> Message ASIN means Amazon s product id. If you want to connect your product with existing product on Amazon fill this field. 14
Get specification attributes determinate if plugin will send Specification Attributes to Amazon (e.g. for books: Autor, Publication Date, Binding, ect.): Product type means subcategory in Amazon. Brand use this field if you want to send Brand to Amazon (nopcommerce does not support brands). Variation Theme for example Size, Color or SizeColor, this is parameter which determinate Attributes combination in Amazon. In nopcommerce there is Attribute Combination in Amazon it is called Variation Theme. Buttons: Save product only save filled data Sent product sends products to Amazon (only product details); Check product status check if product was send and is approved by Amazon systems; Update price sends price to Amazon (for current product) (Note: You do not have to click it if option Send product - with price/picture/stock - one click in Global Settings is checked). Update stock sends stock quantity to Amazon (for current product) (Note: You do not have to click it if option Send product - with price/picture/stock - one click in Global Settings is checked). Update picture sends picture to Amazon (for current product) (Note: You do not have to click it if option Send product - with price/picture/stock - one click in Global Settings is checked). 15
Remember: Before uploading, save product data. Uploading to Amazon is a back-end process. When you sending product from nopcommerce, xml file with data is sent as an request. Message is not processed directly. Amazon MWS need some time to process your request. In this window, you can check Status, view details of message which was send to Amazon and result (message from Amazon). If everything is correct, you will see: 16
5. Common errors Message can consists errors of product data to make correction. a. SKU and brand_name Correct your SKU at Product Details -> Product Info Check your brand at Product Datails -> Amazon 17
b. Publication Date Amazon requires special date format, for example: 2014-10-26T21:32:52 6. Tasks Task is a function which do something without your action. For example, updating stock without clicking button manually and saving your time. Task create XML file which is send to Amazon. Just like update manually. a. Set tasks To set tasks you need to go to: Plugins -> Amazon -> Global Settings b. Message from tasks. To view status, just look at Plugins -> Amazon -> Amazon Message. 18
To check errors, go to System -> Log To check tasks, or manually run: System -> Schedule Task c. Import orders Task importing orders from Amazon not importing all orders! Orders with status Pending and Cancelled are not importing! 19