ruby-mws [No longer maintained]

ruby-mws is a Ruby gem that wraps the Amazon Marketplace Web Service (MWS) API.

This fork was generated a few years ago as a contribution to the ruby-mws open-source gem. Some of the enhancements in this fork were never merged as the parent ruby-mws is no longer being maintained.

That said, I too have moved on to other projects and I am no longer maintaining this fork.

Feel free to use this fork in any capacity. A more fully featured MWS gems can be found in Peddler.

Quick Start

To quickly test your connection to the service without credentials, you can ping the server, which returns server time in UTC:

MWS::Base.server_time

Initialization

Pass in your developer account credentials. All four params below are required.

mws = MWS.new (:aws_access_key_id => "AKIAIFKEXAMPLE4WZHHA",
  :secret_access_key => "abc123def456/SECRET/+ghi789jkl",
  :seller_id => "A27WEXAMPLEBXY",
  :marketplace_id => "ATVPDKIKX0DER")

Requests

We'll use the Orders API to retrieve recently updated orders.

# Retrieve all orders updated within the last 4 hours
response = mws.orders.list_orders :last_updated_after => 4.hours.ago   # ActiveSupport time helper

(All datetime fields accept Time or DateTime objects, as well as strings in iso8601 format.)

Responses

Response objects inherit Hashie for easy access and Rash to convert Amazon's CamelCase convention to underscore. So you're just left with plain ol' Ruby goodness.

Let's parse our response to view the orders and any other data returned.

response.orders.first   # => { "amazon_order_id" => "002-EXAMPLE-0031387",
                        #      "purchase_date" => "2012-01-13T19:11:46.000Z",
                        #      ... }

Response objects are accessible in Hash or method notation.

response.orders == response[:orders]   # => true

Use keys and has_key? to discover what's in the response.

response.keys   # => ["last_updated_before", "orders"]
response.has_key? :last_updated_before   # => true

NextToken requests

For responses with long lists of data, results are returned from the service in pages (usually 100 per page). Example:

response = mws.orders.list_orders :last_updated_after => 1.week.ago   # returns 100 orders & next_token

Here, there are more orders to be returned. You can call has_next? on the same API instance to see if the last response returned has a next page. If so, calling next will make the request for the next page.

mws.orders.has_next?   # => true
next_response = mws.orders.next   # returns next page of orders

Repeat as necessary. You can keep calling next on the API instance as long as has_next? returns true.

Or if you need to, you can save next_token and go about the manual way as per Amazon's docs:

next_response = mws.orders.list_orders_by_next_token :next_token => response.next_token

---

API

@mws = MWS.new(authentication_hash)   # initialize the connection object (see above)

This object can be used to access all API services. Below are examples on how to make the different requests that are available so far. Refer to the Amazon MWS Reference Docs for available fields for each request.

Orders API

• ListOrders - Gets orders by time range and other parameters

  @mws.orders.list_orders :last_updated_after => Time.now-4.hours, :order_status => 'Shipped'

• GetOrder - Gets orders by Amazon order ID

  @mws.orders.get_order :amazon_order_id => "002-EXAMPLE-0031387"

  :amazon_order_id can be an array to retrieve multiple orders.

• ListOrderItems - Gets order items for one order ID (only one order at a time here)

  @mws.orders.list_order_items :amazon_order_id => "002-EXAMPLE-0031387"

Feeds

• Products Inventory - Accepts a hash of product sku's and current available inventory (current_inventory_hash[sku] = quantity) to overwrite the inventory for matching item/sku's on Amazon

  @mws.inventory.update_inventory_supply('Your_Seller_Id',current_inventory_hash) This submits using the _POST_INVENTORY_AVAILABILITY_DATA_

• Products Prices - Accepts an array of hashs (sku,standard_price,sale_price,start_date,end_date) to overwrite the price/sale for matching item/sku's on Amazon. Note: If item is not on sale sale_price,start_date & end_date can be blank.

  @mws.inventory.update_inventory_supply('Your_Seller_Id','USD', current_price_Array) This submits using the _POST_PRODUCT_PRICING_DATA_

• Order Fulfillment - Accepts an array of hash objects (ActiveRecord results) (AmazonOrderID,FulfillmentDate,CarrierName,ShipperTrackingNumber,sku,quantity) to notify Amazon that items in an order have been shipped. Note:If all items in the order are shipped, sku and quantity can be blank.

  @mws.fulfillment.post_ship_confirmation('Your_Seller_Id','USD', shipped_Array) This submits using the _POST_ORDER_FULFILLMENT_DATA_

Fulfillment Inventory API

• ListInventorySupply - Returns availability of inventory, only returns items based on list of SKUs or last change date

  @mws.inventory.list_inventory_supply :seller_skus => ['PF-5VZN-04XR', 'V4-03EY-LAL1', 'OC-TUKC-031P'] @mws.inventory.list_inventory_supply :query_start_date_time => Time.now-1.day

Reports API

• RequestReport - Used to submit a request for a report by report type. Returns report request info.

  @mws.reports.request_report :report_type => "_GET_FBA_FULFILLMENT_CUSTOMER_RETURNS_DATA_", :start_date => 1.day.ago, :end_date => Time.now

• GetReportRequestList - Returns a list of the most recently requested reports. Use report_request_id to find the status of your report. Once report_processing_status for your request is "DONE", use generated_report_id to get your results.

  @mws.reports.get_report_request_list

• GetReport - Used to request a report by report ID. All reports are currently returned as a flat file string.

  @mws.reports.get_report :report_id => '11223344'

Credits

• Originally Created by: Erik Lyngved   elyngved/ruby-mws
• Forked enhancements by: Tina Barfield   tinabme/ruby-mws