Global Amazon Integration Module v1.1 Users Guide & Setup Instructions
Table of Contents Page 3 Page 4 Page 5 Page 6 Page 7 Page 8 Page 9 Installation Instructions Amazon Account Configuration Using the Listings Setup Tool Publishing Listings Automatic Processes Planned Features Appendix A: Help notes for Listings Tool (Verbose Edition) Disclaimer While every effort has been made to remove any compatibility issues from this software, Camiloo Limited cannot be held responsible for damage and / or financial loss caused by the usage of this software. We provide full help & support with all of our products and if this product becomes faulty within the first 6 months of ownership we will seek to resolve the issue on your own server free of charge. Beyond this 6 month warranty period, you are also entitled to complimentary updates to the module for the lifetime of its development. Should you have any issues with your installation of the module or would like to request a new feature for the next update, please contact our helpdesk by emailing help@camiloo.co.uk or visiting http://help.camiloo.co.uk. We are keen to help our customers shape the future development of our modules. Note: We are a UK company and as such our helpdesk is only manned from 10am - 6pm UK Time (GMT)
Installation Instructions These steps are written for novice users. If you are an experienced Magento Administrator, upload the module files from the zip file to your Magento installation as normal. Step One - Extract Your Files The document that you have opened is supplied within a zip file. Also inside of this file is a folder app. Extract all files into a temporary directory on your computer. Step Two - Upload Open your FTP client and login to your Magento installation. Navigate through the directories on your FTP server until you see a folder named app and another named var in the directory you are viewing. You should now be in the root of your Magento installation. Drag the app folder from the temporary directory you unzipped it to into your FTP client. The FTP client should now begin uploading files into the subdirectories of /app. Step Three - Log into Magento Admin Area Once uploaded, you must install your module. This is an easy step; Magento will automatically install the module for you when you log into your admin area after uploading. Once you have logged in and the dashboard screen is fully loaded, log back out of the admin area (important - sets up your account with access to the configuration settings for the module) and log in again. Extra Features Also included is a folder called extra. This contains a modified version of the Admin Order View which displays the Amazon Order ID and Country code for an order if these values are set. In order to install this extra feature, navigate into the extra folder and then follow steps 2 & 3 again.
Amazon Account Configuration Now that you have successfully installed the module, it is time to configure its settings so that it may access each of your Amazon Seller Accounts. Optional Pre-configuration Step - Create a new store for each Amazon account In order to make a clear distinction between Magento Website orders and Amazon orders, the module allows you to specify the store on Magento you would like the order to import into. This store does not need to be enabled (and therefore does not need to be visible on the front end of your website). To setup a store, navigate to your admin area in Magento and hover over System, then select Manage Stores as shown in the image on the right. On the screen that loads, click Add Store and give this a meaningful name such as Amazon UK Orders. Account Details per Amazon Site Navigate to your admin area in Magento and hover over System, then select Configuration. From here select Amazon Integration under the Camiloo Toolbox section from the right hand menu. Then, under the tab for the Amazon website you wish to configure the module to work with (you may configure one, some or all Amazon websites to work with the module), enter your Seller Central username and password. Then, in the field named Merchant Token, you will need to enter the token shown on your profile page in Seller Central. For example: M_CAMILOOLIM_7250598 Also on your profile page in Seller Central, you will find a value labelled your Legal Name. Enter this into the Merchant Legal Name of the Magento Module Settings panel. Finally, select which actions the module is permitted to undertake for you on this Amazon Site by choosing Enable / Disable for each feature listed.
Using the Listings Setup Tool The Listings Tool is an easy way to configure your products Amazon options for each Amazon website. The tool can be found in the Catalog menu of the Admin Area under Amazon Sellercentral -> Listings Tool. This tool is optional; products can also be prepared for listing on Amazon by editing them individually under Catalog -> Manage Products. Step One: Downloading the CSV On arriving at the Listings Tool page, you will be presented with download and upload options for each Amazon website which you configured in the previous step. Click on the download button of the Amazon site you would like to configure. This will commence downloading of a CSV or comma separated variable file containing settings for each product in your Magento catalogue. Step Two: Editing the CSV file The CSV file can be edited using any spreadsheet application such as Microsoft Excel or Apple iwork Numbers. Once opened, we recommend expanding the width of all columns to the maximum required to see all content in each cell. Any comma marks within the fields are replaced with a pipe mark to preserve the validity of the CSV file. When you upload this document, the comma marks are re-inserted for you. Therefore, should you need to use commas in a description or title, please instead use pipe marks - for example: The fox, though quick, was not able to get over the lazy brown dog. would become The fox though quick was not able to get over the lazy brown dog.. The CSV file is broken into 6 segments which are separated by marks. These marks serve no purpose other than to make the CSV file human friendly. Above each field name in row 1 are help note references. Help notes are tips on what you should write in each field and are given in brief on the LIsting Setup Tool screen within Magento and given concisely in Appendix A at the back of this document. We strongly recommend you follow the guidelines that these help notes provide. Step Three: Save an Upload Finally, save your CSV file as a CSV (note: In iwork Numbers this is hidden under the Share -> Export menu). Once saved, return to the Listing Tool screen and refresh the page to ensure that your session is still active. Then, upload the file you have just edited to the upload tool for the Amazon website you were configuring listings for, and click Process File. A green progress bar will appear and will span the width of the upload field when complete.
Publishing Listings Publishing listings onto your Amazon accounts is very straightforward. From the admin area, hover over the Catalog option and then hover over Amazon Sellercentral. From here, select Listings Publisher. This tool uses the settings we configured with the listings setup tool and convert these settings into Amazon listings. Simply press Publish Listings and the module will begin to contact Amazon and will provide you with as much feedback as possible on the operation s current status. Depending on your configuration settings for the module, the publisher will submit the following information to Amazon: - Listing Information including Product ID, Description and Name. - Stock levels for each product - Pricing for each product - Photographs of each product from Magento [used only if Amazon has no photographs of this item] In order to provide you with the best possible level of service and error fixing, the publisher will wait for Amazon to process each of these 4 requests that it makes before continuing. This may take up to 90 seconds to complete each time. The publisher will then record the results of these requests into the Debug Log which can be viewed by clicking on [ Show / Hide Debug Log ]. Should you encounter any issues when uploading your products to Amazon, please open a helpdesk ticket and include the contents of this debug log into your helpdesk ticket. A member of our team will look into the errors returned by Amazon as soon as possible. When the process completes, there may be a short 2-3 minute delay before the new items appear on your Amazon Seller Central account. If after 30 minutes new products have not appeared on your account, please open a helpdesk ticket and we will look into this for you.
Automatic Processes We like to think of this module as 18 modules in one. As well as being a product / listings upload tool for all 6 Amazon websites, it is also an order import and dispatch tool for all 6 Amazon websites and a stock level synchronisation tool for each Amazon and your Magento installation. Orders When a customer places an order on any configured Amazon website, details of their purchase are added to a sales report which is generated every 30 minutes. The module then imports the data within this report and the orders can be handled in the same way you handle your Magento orders. Dispatches As soon as you create a shipment for an order within Magento for an order imported from Amazon, the module will automatically call the correct Amazon website and inform it that the item has been shipped. This will trigger an email to the customer from ebay informing them that their item has been dispatched and will also trigger outpayment to you for the sale from Amazon. Stock Levels & Prices If configured, the module will generate hourly stock level reports for Amazon and can also update item prices at this time. This will ensure that you never sell the last item of a products stock on Amazon and your Magento store simultaneously. If an order is placed for a product on Magento and this makes the product go out of stock, an emergency stock level notification is sent to Amazon which will immediately alert it that the item is out of stock. Automatic Price Markup on Amazon per Item The module can be configured to take its item prices from the current selling price defined within your Magento store. However, as requested by some sellers, it is possible to specify a percentage markup per product which you wish to apply. You may also apply a fixed value markup per product (calculated after percentage is added). This makes it easy for manufacturers or distributors to offset the Amazon listing fees without to manually recalculate their prices each time they reprice items in Magento.
Planned Features We have a development roadmap in place for this module but welcome any / all suggestions for further features. Current planned features are: - Support for listing configurable products from Magento as products with Variations on Amazon (for example colour swatches of a product) - Allow Amazon Orders to be cancelled and refunded from within Magento (i.e. Automatic refund / cancellation reporting back to Amazon websites) - Amazon revenue forecasting - Automated repricing (possible integration with repricing service such as Reprice It) - Ability to download your products from a pre-existing Amazon account and create new simple products within Magento (pseudo-migration tool)
Appendix A: Help Notes for Listings Tool (Verbose Edition) Help Note 1 Section 1 is provided for reference only and should assist you in identifying the product referred to on a row. Help Note 2 Section 2 enables or disables listing of this item. Set 'List this item' to 1 if you wish to list the item on Amazon in the country you are editing. Please note - for safety reasons this cannot be used to remove existing listings from Amazon. Help Note 3 Section 3 defines the Product ID. This is a unique reference code for the product line you are listing on Amazon. In most cases, this will be the numbers from the product barcode (UPC). Under 'Product ID Type', enter ASIN, EAN, UPC or ISBN. This is the unique product code which Amazon will use to find information on the product you are submitting. Then, under 'Product ID' enter the value for this unique product code. This is often above the barcode on books (ISBN) and the number below the barcode without spaces (UPC Code) on other products. Please ensure that Excel / Numbers treats this field as a text field, else it may convert the long UPC codes into a scientific number. If you do not have a unique product ID for your products and you are not the product manufacturer / exclusive distributor, you must find their ASIN code (Amazon's own Product ID). To do this, visit amazon and search for the product. When found, view the product description page on amazon and then look in the URL. You should see a segment of the URL which looks similar to the following: B000L3ISWI. This is the ASIN code for the product.
If you are the manufacturer or exclusive distributor of these products, you must purchase UPC / EAN / ISBN codes before you can list on Amazon. Fulfillment Speed is the number of days on average that each product takes to ship. This field is optional but must be set to a number if not left blank. Help Note 4 Section 4 allows you to specify the source of various data elements your listing will contain. Amazon requires that Name and Description are only ever supplied together. I.e. if Name is set as amazon, then Description must also be set as amazon and vice versa. All fields in this section are required but in most cases may just be set to amazon, amazon, magento, amazon. Name Source is the source of the product name. If this is not the first ever listing of this item on Amazon, it may be best to use the standard name Amazon uses for the product. This is likely to have been derived from the EAN / UPC code database. To use this value, enter amazon. Alternatively, you may wish to use your Magento product name or a custom product name for this product. If this is the case, you may also enter custom or magento.
Description Source should again in most cases be set to amazon. If however you wish to supply a different product description you may do so by entering custom, magento or magento_short. The magento_short option will make use of the Short Description attribute in Magento while magento makes use of the long description attribute. Price Source can be set to magento or custom. If set to magento you may use the markup values in Section 6 of the CSV file to add a fixed or percentage-based amount to the current magento price. Currency Source can be set to default or custom. If set to default, the currency of the price expected will be the logical currency for the Amazon website; for example EUR in France and Germany, GBP in the UK and USD in America. If set to custom, the custom currency defined in section 6 Help Note 5 Section 5 contains space for a custom product name and description to be entered. These values are only required if Description Source or Name Source have been set to custom in Section 4. Please use pipe marks ( ) instead of commas as this will preserve the validity of the CSV file. For example: The fox, though quick, was not able to get over the lazy brown dog. would become The fox though quick was not able to get over the lazy brown dog.. Help Note 6 Section 6 controls the pricing of the product on Amazon including its currency. If Price Source in section 4 was set to magento, Price Markup % in Section 6 should be set to the value in percent you wish to inflate the Magento price by, for example 5.2 for 5.2%. If you do not wish to add a markup percentage set this value to 0.
Again, if price source is magento, Price Markup Value should be set to an additional markup value you would like to add. For example, if your magento price is 2.20 and you enter 0.20, the price will be increased to 2.40 on amazon. If you do not wish to add a markup value to the price of this product, set this value to 0. Combined, these options allow you to counteract any transactions fees which are charged to you, should you wish to do so. For example, if you are charged 2.5% + $0.20 per transaction, setting your Price markup % to 2.5 and Price markup value to 0.2 would cover your fees. If product price changes in Magento and your have set this product to use magento Price Source, the price will be updated using these markup rules Custom Price allows you to specify a completely separate price for this item from your Magento price. In order to use this value, Price Source must be set to custom in Section 4. Please enter a value to two decimal places without a currency mark, such as 2.00 or 3.99 instead of 2 or 3.9899. Custom Currency allows you to specify a custom currency value that the price (from magento or the above custom price field depending on Price Source setting) should be interpreted as. This should be a three letter currency code in capital letters, for example USD, EUR, GBP.