Fulfillment by Amazon. User Guide

(1)

Fulfillment by Amazon

User Guide

by

1

(2)

License Agreement

The following license agreement (hereinafter referred to as the "Agreement") is between Webtex Software (hereinafter referred to as the "Vendor") and company or person purchasing Vendor’s software (hereinafter referred to as the "Client"). This agreement applies to all extensions, software, code, scripts (hereinafter referred to as the

"Software") the Client purchases from Vendor.

General

By purchasing the Software the Client is asserting with the below-stated Terms and Conditions of the present Agreement, and agrees to use the Software in compliance with this Agreement.The Agreement comes into legal force at the moment when the Client orders Vendor’s Software from Vendor’s website or receives it through email or on any storage device.

Copyright

Vendor is the copyright holder of the Software. The Software or a portion of it is a copyrightable matter and is liable to protection by the law. Any activity that infringes terms of this Agreement violates copyright law and will be prosecuted according to the current law. Vendor reserves the right to revoke the license of any user who is holding an invalid license.

License

This Agreement gives the Client the right to use only one copy of the Software on one domain solely for Client’s own personal or business use, subject to all other terms of this Agreement. A separate license should be purchased for each new Software installation. Any distribution of the Software without Vendor’s consent, including noncommercial distribution is regarded as violation of this Agreement and entails

liability, according to the current law. The Client may not use any part of the Software in any other software product or website. The Client may not give, sell, distribute, sub-license, rent, lease or lend any portion of the Software or it’s documentation to anyone. The Client may not place the Software on a server so that it is accessible via a public network such as Internet for distribution purposes.

(4)

Liability

The Vendor reserves the right to publish a selected list of users of Vendor’s Software. The Vendor will not be liable for any damages (including any loss of profits/savings, or incidental or consequential) affected the Client, Client’s information or business arising out of the use or inability to use the Software, purchased from the Vendor. The Vendor is not liable for any prosecutions arising from use of the Software against law or for any illegal use.

This Agreement

If the Client fails to use the Software in accordance with the terms and conditions of this Agreement, it constitutes a breach of the agreement, and the Client’s license to use the Software will be revoked. The Vendor reserves the right to change this Agreement and to impose its clauses at any time. This Agreement remains effective until terminated. The Vendor retains the right to terminate Client’s license to use the Software at any time, if in its sole discretion, the Client is not abiding the terms of this Agreement, including, but not limited to, obscuring or removing any link or copyright notice as specified in this Agreement. The Client may terminate it at any time by destroying all copies of the Software. Termination of this Agreement does not bind the Vendor to return the Client the amount spent for purchase of the Software, unless the Client claims the refund within 30-day period from the day of purchase.

Software Support Policy

The Vendor shall provide the Client with customer support and Software updates free of charge. The Client is entitled to report any errors and bugs he experiences while using the Software.

Return Policy

The Client may request a full refund for Software, purchased from the Vendor, within a 30-day period from the day of purchase. Within 5 days after the Vendor sends the refund to the Client, the Client is legally obliged to uninstall and remove the Software. Following services are non-refundable: Magento installation services, design services, search engine optimization services, Magento customization services.

(5)

1. Installation

1.1 Initial Installation

If you haven’t had the extension installed, follow this steps to run the initial installation.

1. Back up the database. There are 2 ways to do that: • Go to System > Tools > Backups > Database Backup.  

• Log into your server through SSH and enter this command to backup your customers/ orders data (this way is more preferable for the majority of databases):

mysqldump -h HOST -u USER -p --single-transaction DATABASENAME > FILENAME.sql 2. Disable the Compilation mode (if enabled).

(6)

3. Upload the extension.

4. Renew the page (to launch the install-scripts) 5. Logout and login your Admin account.

1.2 Updating to the Latest Version

If you already installed our extension and want to update to the latest version, follow the roadmap:

1. Check the Amazon requests queue, and handle the createFulfillmentOrder requests with the fault status manually.  

Because of the throttling limit Amazon sets, our extension adds your orders to the special queue. Hence, before updating to the latest version, you need to make sure that all orders in the queue have reached the Amazon side.

To do that, follow the steps below:

• Go to Fulfillment by Amazon > Amazon Queue and hit the Send Queue button*.  

* in case you don’t have any records in the grid, skip this step.

• Next, go to Fulfillment by Amazon > Amazon Access Log

(7)

• Filter all your log records by the createFullfillmentOrder method and the Fault status • Click the Search button

• When done, click the Details link (for every found record)— it will open the window, where you can find the corresponding Magento order’s increment ID.

(8)

Using this ID you can find an order (in Sales > Orders) and check whether it was properly shipped.

2. Disable the extension under System > Configuration > Advanced > Disable Modules Output > Webtex_FBA > Disable.

Or disable it via FTP by modifying the file app/etc/modules/Webtex_Fba.xml. Just change the value for the Active filed to False instead of True.

3. Backup your store database (see the previous chapter for more instructions) 4. Disable the Compilation mode (if enabled).

5. Upload the extension.

6. Renew the page (to launch the install-scripts) 7. Logout and login your Admin account.

Additionally, you can delete the old version the extension’s files. Here is the full list of files you may clean up:

lib/Mws app/code/local/Webtex/Fba/ app/design/adminhtml/default/default/layout/webtex/fba.xml app/design/adminhtml/default/default/template/webtex/fba/ app/etc/modules/Webtex_Fba.xml   8

(9)

2. Amazon Marketplace Settings

To tweak your Amazon marketplace settings, go to Fulfillment by Amazon > Marketplace settings.

Also, from here you can add, delete and edit your marketplaces.

To add a new marketplace, click the Add New button.

In the window that opens you can enable/ disable the chosen marketplace. Also, here you need to define your:

• Access key Id, Secret Key, Merchant Id — these are the details you get when connecting to MWS (Marketplace Web Services)

• Amazon Marketplace — this is a two-letter identifier of your Amazon Marketplace

Click Save for the changes to take effect.

(10)

To edit the existing marketplace, just click the Edit link and make the changes you need.

To mass apply any of these actions:

• Sync inventory • Sync orders

• Delete the chosen marketplaces • Disable the selected marketplaces • Enable the chosen marketplaces

you need to select the marketplace(-s) > click on the Actions drop-down on the left > select a bulk action > and click the Submit button.

(11)

3. Fulfillment Rules

Go to Fulfillment by Amazon > Fulfillment Rules.

This is the place where you can create rules to automatically send matching orders to Amazon.

To create a rule, you need to fill in the following data:

• Source Store — this setting lets you define the store this rule will be applied to. The (*) setting applies the rule to all Store Views at once.

• Source Country ID (taken from the Order’s Shipping Address) — by choosing a Shipping Country ID you define the countries this rule will be applied to. The (*) setting applies the rule to all countries at once.

• Source Shipping Method — in this field you can choose a shipping method. The (*) setting applies the rule to all available shipping methods at once. NOTE: If some of your shipping methods is not on the list, you can manually enter it in the Custom field   ( the feature can be of help when M2E Pro orders using Amazon).

• Zip/Post Range and Zip/Post Code (taken from the Order’s Shipping Address) • Destination Shipping Speed — lets you define one of the three available Amazon

shipping types

• Destination Marketplace —in this field you need to define a marketplace that will implement the shipping procedure

(12)

• Product Policy — this setting lets you specify when to apply the rule. Say, if you select Any, the rule will get applied if at least 1 qty of 1 product can be shipped. All should be selected if you want to apply the rule providing all products in the order can be shipped. And the Whole Items option should be selected for orders with 1 product that has all qty.

This is how fulfillment rules work:

> the extension grabs the following order values: store_id, shipping_method, country, zip code,

> next, the software selects all rules that match the defined source_store,

source_shipping, source_country and source_zip values; also, the extension is capable of selecting orders that have any types of the mentioned values all at once,

> the active rules get sorted by the sort_order value in a descending order

> every rule gets applied in accordance with the set Product Policy and depending on the availability of the ordered products in the destination market,

> if everything conforms to the conditions set in the rule, the extension applies it and fulfills such an order(s) for the destination marketplace*.

* all the products that didn’t match the fulfillment rule, should be manually handled by the store admin.

(13)

4. Products Settings

Go to Fulfillment by Amazon > Product Settings.

Under these settings you can overview all products available in your store, assign them to the chosen marketplace(-s), and customize the qty sync settings.

Any product can be assigned to the chosen marketplace regardless of its type.

NOTE: if bundle and configurable products are assigned to marketplaces, their child products will be ignored in case of automatic delivery.

Select a product you’d like to modify and click the Edit link:

(14)

In the Products Settings Grid you can: • define the marketplace(-s)

• define the stock level (In Stock Qty and Total Qty options are available) • modify the product SKU used by Amazon

Under Product Synchronization Settings you can specify the sync type. These are the available options:

• Average In Range — sets the average qty value among all Sync Marketplaces • Max In Range — defines the maximum qty value among all Sync Marketplaces • Min In Range — sets the minimum qty value among all Sync Marketplaces • One Marketplace — synchronizes products with one marketplace

• Local Inventory — lets you manually regulate product stocks through Magento admin.

(15)

NOTE: The Sync Marketplaces field contains all the available marketplaces, so you should choose only those that are linked to the current product in the previous section. Otherwise, you won’t be able to pass the form validation.

(16)

5. Order Fulfillment

Go to Fulfillment by Amazon > Fulfillment Orders.

This is the place where you can overview all Amazon order details and create new custom orders.

To view the extended order details, click the View link here:

(17)

This is what extended orders grid includes:

NOTE: Our extension will sync Amazon order tracking numbers and Shipments with Magento order/ shipment data.  

It works only with automatically created fulfillment orders (those that were created with the help of fulfillment rules).

______________________________________________________________________

To create a new Amazon order, hit the Add New button on the right and fill in the required:

(18)

This is what each field is about:

• Amazon Marketplace — lets you specify the marketplace used for order fulfillment, • Magento Order — here you can specify an increment_id of any Magento order > hit

the Parse button > and get all the fields filled in automatically.

• Displayable Order ID — this is a fulfillment order identifier that you create. The value displays as the order identifier in recipient-facing materials such as the outbound shipment packing slip; the value of the DisplayableOrderId should match the order identifier that you provide to your customer.

• Displayable Order Date — self-explanatory

• Displayable Order Comment — this is order-specific text that appears in customer-facing materials (such as the outbound shipment packing slip).

• Shipping Speed Category — lets you define one of the three available Amazon shipping types

• Notification Email List — here you can enter a comma-separated list of email addresses that are used by Amazon to send ship-complete notifications to your customers on your behalf.

Below you may specify customer Shipping Address details as well as Order Items info (Seller SKU, Qty to fulfill, Amazon Qty):

(19)

Also, note that the Amazon Qty value may be highlighted with 3 different colors:

• green - refers to the In Stock Product Qty. This is the product quantity available for fulfillment. This does not include item quantity currently in an inbound shipment or item quantity being transferred between Amazon fulfillment centers in the Amazon Fulfillment Network.

• yellow - refers to the Total Product Qty. This is the total item quantity in the Amazon Fulfillment Network supply chain. This includes item quantity currently in an Amazon fulfillment center, item quantity currently in an inbound shipment, and item quantity being transferred between Amazon fulfillment centers in the Amazon Fulfillment Network.

• red - refers to the Blocked Product Qty that is waiting in a queue to be sent to Amazon for fulfillment (the value is taken from the local Magento database).

(20)

6. Jobs Queues

Due to the throttling limit Amazon sets, it limits all users in the number of queries they may send to the company’s servers. Hence, all API requests are put on the queue. Our extension adds all requests to the database and then sends them to the servers in portions using Magento Cron.

You may check the current status of your requests in the Jobs Queue section. Also, from here you can manually send them with the Send Queue feature.

To access this functionality, go to Fulfillment by Amazon > Queue

(21)

7. Webtex Priority Shipping

Go to Shipping > Configuration > Shipping Methods > Sales > Shipping Methods > Webtex Priority Shipping

This is the place where you can add the unique shipping rates with the distinct shipping speed categories.

(22)

NOTE: Fulfillment Rules can work with different shipping methods.

In order to differentiate various shipping speeds, we have added a clone of the Table Rate for shipping methods. Here you can specify the standard, expedited and priority ways of shipping and then use these criteria while creating fulfillment rules.

Rates are added here the same way as they are in the Table Rate method. To be able to add rate, switch the configuration scope to the Website level and import the file with all your rates.

(23)

8. Common Settings

Under Fulfillment by Amazon > Common Settings you can tweak more extension’s settings, such as:  

Сron Tasks Frequency Settings

• Check orders changes — defines the frequency of Job creation that checks order

changes

• Clean unlinked stock records — defines the frequency of cleaning up product stock

Amazon cache in the extension’s database

• Clean DONE jobs — defines the frequency of cleaning the table queue from all

successfully executed tasks

• Check inventory changes — specifies the frequency of Job creation that check

changes in the Qty values

• Send Queue — the frequency of the queue launch.

(24)

Common Settings:  

• Autosend mode — sets the condition when an order is matched against the

fulfillment rule.

• Test Mode — synthetically generates responses of Amazon servers. Designed

exclusively for staging environment.

NOTE: You can add marketplaces with various parameters, but each of them must have a unique merchant_id.

(25)

Getting Help and Support 

All our extensions come with free customer support and future extension updates.  If you’ve stumbled upon any issues during work with our extension, feel free to send us a message through our contact form: http://www.webtexsoftware.com/contacts, or by email:

support@webtexsoftware.com. 

If you need some special functionality to be created, please let us know at

sales@webtexsoftware.com.

Fulfillment by Amazon. User Guide