peddler 0.10.0 → 0.11.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 07a989e34449ab73ff6adc3cd7299ac218394f9e
-  data.tar.gz: cc04a47b2d89407875b67728a0067b84fa8e1e72
+  metadata.gz: 5d3d2f97e4921804281141fbef03ae8dbc4f8211
+  data.tar.gz: 273371a4e4156f588578468a2f363e0e3311dd24
 SHA512:
-  metadata.gz: 631af106e16507f94106ac30855787fc8b4dba465859863ee7fe5d057aef1ba8273aaefe8c34e985884d4ad14ce1332fad7730a19166e763072b7941a15f9cbd
-  data.tar.gz: b6db581788899e2da6f3aa24f16d9aa7a085eefc09d90ea38cbddb852f3aa8475bbd85104ac1d682d311a77a6a266ebdd7037e35c5307c130573e94b6db98b83
+  metadata.gz: 9f297c76d67a21b08eb4e0977c2a14e9592adae4f65521e00d9d892deb6da11fca5d881fc4ab8855eca0442843a7bbf137850339e1fe3d83ce1f4252a3749533
+  data.tar.gz: cbe9393121495054938b834bc9e83c1fbed9992b70e471ecdfcd67dd47c3a2d10e8653fcd40116bf975c26677086f542f41fe658a421de48d7e2468d014140d4

data/README.md

@@ -21,16 +21,6 @@ parser = client.get_service_status
 parser.parse
 ```
 
-You can handle HTTP client errors by rescuing API calls individually or defining a global handler on the client level:
-
-```ruby
-client.on_error do |request, response|
-  if response.status == 503
-    # handle throttling by backing off and retrying
-  end
-end
-```
-
 ## Credentials
 
 You can set up credentials when instantiating:
@@ -140,3 +130,9 @@ The Sellers API lets sellers retrieve information about their seller account, su
 The Amazon MWS Subscriptions API section enables you to subscribe to receive notifications that are relevant to your business with Amazon. With the operations in the Subscriptions API section, you can register to receive important information from Amazon without having to poll the Amazon MWS service. Instead, the information is sent directly to you when an event occurs to which you are subscribed.
 
 [Read the API](http://www.rubydoc.info/gems/peddler/MWS/Subscriptions/Client)
+
+### Webstore
+
+With the Webstore API section of Amazon Marketplace Web Service (Amazon MWS), you can get “Email Me When Available” subscription information for items listed on your Amazon Webstore. The Webstore API section can help you plan your inventory replenishment cycle by enabling you to query for items that your customers subscribed to when they clicked the Email Me When Available button on your Webstore. The Webstore API section can also return information about the notifications that were sent to your customers when out-of-stock items came back in stock. This information, when combined with sales information that your Webstore tracks, can help you determine how many notifications were converted into sales.
+
+[Read the API](http://www.rubydoc.info/gems/peddler/MWS/Webstore/Client)

data/lib/mws/cart_information/client.rb

@@ -28,7 +28,7 @@ module MWS
       # @return [Peddler::XMLParser]
       def list_carts(date_range_start, opts = {})
         operation('ListCarts')
-          .add(opts.merge('DateRangeStart' => date_range_start))
+          .add(opts.update('DateRangeStart' => date_range_start))
 
         run
       end

data/lib/mws/customer_information/client.rb

@@ -60,7 +60,7 @@ module MWS
       def get_customers_for_customer_id(*customer_id_list)
         opts = extract_options(customer_id_list)
         operation('GetCustomersForCustomerId')
-          .add(opts.merge('CustomerIdList' => customer_id_list))
+          .add(opts.update('CustomerIdList' => customer_id_list))
           .structure!('CustomerIdList', 'CustomerId')
 
         run

data/lib/mws/feeds/client.rb

@@ -19,7 +19,7 @@ module MWS
       def submit_feed(feed_content, feed_type, opts = {})
         self.body = feed_content
         operation('SubmitFeed')
-          .add(opts.merge('FeedType' => feed_type))
+          .add(opts.update('FeedType' => feed_type))
           .structure!('MarketplaceId', 'Id')
 
         run

data/lib/mws/fulfillment_inbound_shipment/client.rb

@@ -19,12 +19,10 @@ module MWS
       # @return [Peddler::XMLParser]
       def create_inbound_shipment_plan(ship_from_address, inbound_shipment_plan_request_items, opts = {})
         operation('CreateInboundShipmentPlan')
-          .add(
-            opts.merge(
-              'ShipFromAddress' => ship_from_address,
-              'InboundShipmentPlanRequestItems' => inbound_shipment_plan_request_items
-            )
-          )
+          .add(opts.update(
+            'ShipFromAddress' => ship_from_address,
+            'InboundShipmentPlanRequestItems' => inbound_shipment_plan_request_items
+          ))
           .structure!('InboundShipmentPlanRequestItems', 'member')
 
         run
@@ -40,12 +38,10 @@ module MWS
       # @return [Peddler::XMLParser]
       def create_inbound_shipment(shipment_id, inbound_shipment_header, opts = {})
         operation('CreateInboundShipment')
-          .add(
-            opts.merge(
-              'ShipmentId' => shipment_id,
-              'InboundShipmentHeader' => inbound_shipment_header
-            )
-          )
+          .add(opts.update(
+            'ShipmentId' => shipment_id,
+            'InboundShipmentHeader' => inbound_shipment_header
+          ))
           .structure!('InboundShipmentItems', 'member')
 
         run
@@ -61,12 +57,10 @@ module MWS
       # @return [Peddler::XMLParser]
       def update_inbound_shipment(shipment_id, inbound_shipment_header, opts = {})
         operation('UpdateInboundShipment')
-          .add(
-            opts.merge(
-              'ShipmentId' => shipment_id,
-              'InboundShipmentHeader' => inbound_shipment_header
-            )
-          )
+          .add(opts.update(
+            'ShipmentId' => shipment_id,
+            'InboundShipmentHeader' => inbound_shipment_header
+          ))
           .structure!('InboundShipmentItems', 'member')
 
         run
@@ -145,7 +139,7 @@ module MWS
       # @return [Peddler::XMLParser]
       def get_package_labels(shipment_id, page_type, opts = {})
         operation('GetPackageLabels')
-          .add(opts.merge(
+          .add(opts.update(
             'ShipmentId' => shipment_id,
             'PageType' => page_type
           ))

data/lib/mws/fulfillment_inventory/client.rb

@@ -15,7 +15,7 @@ module MWS
       #
       # @see http://docs.developer.amazonservices.com/en_US/fba_inventory/FBAInventory_ListInventorySupply.html
       # @param opts [Hash]
-      # @option opts [Array<String>, String] :seller_skus
+      # @option opts [Array<String>, String] :seller_sku_list
       # @option opts [String, #iso8601] :query_start_date_time
       # @option opts [String] :response_group
       # @return [Peddler::XMLParser]

data/lib/mws/fulfillment_outbound_shipment/client.rb

@@ -30,7 +30,7 @@ module MWS
         end
 
         operation('GetFulfillmentPreview')
-          .add(opts.merge('Address' => address, 'Items' => items))
+          .add(opts.update('Address' => address, 'Items' => items))
           .structure!('Items', 'member')
           .structure!('ShippingSpeedCategories')
 
@@ -95,7 +95,7 @@ module MWS
       # @return [Peddler::XMLParser]
       def update_fulfillment_order(seller_fulfillment_order_id, opts = {})
         operation('UpdateFulfillmentOrder')
-          .add(opts.merge('SellerFulfillmentOrderId' => seller_fulfillment_order_id))
+          .add(opts.update('SellerFulfillmentOrderId' => seller_fulfillment_order_id))
           .structure!('NotificationEmailList', 'member')
           .structure!('Items', 'member')
 

data/lib/mws/off_amazon_payments/client.rb

@@ -36,7 +36,7 @@ module MWS
       # @return [Peddler::XMLParser]
       def create_order_reference_for_id(id, id_type, opts = {})
         operation('CreateOrderReferenceForId')
-          .add(opts.merge(
+          .add(opts.update(
             'Id' => id,
             'IdType' => id_type
           ))
@@ -53,7 +53,7 @@ module MWS
       # @return [Peddler::XMLParser]
       def get_billing_agreement_details(amazon_billing_agreement_id, opts = {})
         operation('GetBillingAgreementDetails')
-          .add(opts.merge(
+          .add(opts.update(
             'AmazonBillingAgreementId' => amazon_billing_agreement_id
           ))
 
@@ -126,7 +126,7 @@ module MWS
       # @return [Peddler::XMLParser]
       def authorize_on_billing_agreement(amazon_billing_agreement_id, authorization_reference_id, authorization_amount, opts = {})
         operation('AuthorizeOnBillingAgreement')
-          .add(opts.merge(
+          .add(opts.update(
             'AmazonBillingAgreementId' => amazon_billing_agreement_id,
             'AuthorizationReferenceId' => authorization_reference_id,
             'AuthorizationAmount' => authorization_amount
@@ -146,7 +146,7 @@ module MWS
       # @return [Peddler::XMLParser]
       def close_billing_agreement(amazon_billing_agreement_id, opts = {})
         operation('CloseBillingAgreement')
-          .add(opts.merge(
+          .add(opts.update(
             'AmazonBillingAgreementId' => amazon_billing_agreement_id
           ))
 
@@ -168,7 +168,7 @@ module MWS
         operation('SetOrderReferenceDetails')
           .add(
             'AmazonOrderReferenceId' => amazon_order_reference_id,
-            'OrderReferenceAttributes' => opts.merge('OrderTotal' => order_total)
+            'OrderReferenceAttributes' => opts.update('OrderTotal' => order_total)
           )
 
         run
@@ -183,7 +183,7 @@ module MWS
       # @return [Peddler::XMLParser]
       def get_order_reference_details(amazon_order_reference_id, opts = {})
         operation('GetOrderReferenceDetails')
-          .add(opts.merge('AmazonOrderReferenceId' => amazon_order_reference_id))
+          .add(opts.update('AmazonOrderReferenceId' => amazon_order_reference_id))
 
         run
       end
@@ -210,7 +210,7 @@ module MWS
       # @return [Peddler::XMLParser]
       def cancel_order_reference(amazon_order_reference_id, opts = {})
         operation('CancelOrderReference')
-          .add(opts.merge('AmazonOrderReferenceId' => amazon_order_reference_id))
+          .add(opts.update('AmazonOrderReferenceId' => amazon_order_reference_id))
 
         run
       end
@@ -226,7 +226,7 @@ module MWS
       # @return [Peddler::XMLParser]
       def close_order_reference(amazon_order_reference_id, opts = {})
         operation('CloseOrderReference')
-          .add(opts.merge('AmazonOrderReferenceId' => amazon_order_reference_id))
+          .add(opts.update('AmazonOrderReferenceId' => amazon_order_reference_id))
 
         run
       end
@@ -246,7 +246,7 @@ module MWS
       # @return [Peddler::XMLParser]
       def authorize(amazon_order_reference_id, authorization_reference_id, authorization_amount, opts = {})
         operation('Authorize')
-          .add(opts.merge(
+          .add(opts.update(
             'AmazonOrderReferenceId' => amazon_order_reference_id,
             'AuthorizationReferenceId' => authorization_reference_id,
             'AuthorizationAmount' => authorization_amount
@@ -280,7 +280,7 @@ module MWS
       # @return [Peddler::XMLParser]
       def capture(amazon_authorization_id, capture_reference_id, capture_amount, opts = {})
         operation('Capture')
-          .add(opts.merge(
+          .add(opts.update(
             'AmazonAuthorizationId' => amazon_authorization_id,
             'CaptureReferenceId' => capture_reference_id,
             'CaptureAmount' => capture_amount
@@ -311,7 +311,7 @@ module MWS
       # @return [Peddler::XMLParser]
       def close_authorization(amazon_authorization_id, opts = {})
         operation('CloseAuthorization')
-          .add(opts.merge('AmazonAuthorizationId' => amazon_authorization_id))
+          .add(opts.update('AmazonAuthorizationId' => amazon_authorization_id))
 
         run
       end
@@ -328,7 +328,7 @@ module MWS
       # @return [Peddler::XMLParser]
       def refund(amazon_capture_id, refund_reference_id, refund_amount, opts = {})
         operation('Refund')
-          .add(opts.merge(
+          .add(opts.update(
             'AmazonCaptureId' => amazon_capture_id,
             'RefundReferenceId' => refund_reference_id,
             'RefundAmount' => refund_amount

data/lib/mws/products/client.rb

@@ -19,8 +19,8 @@ module MWS
       #   @option opts [String] :query_context_id
       # @return [Peddler::XMLParser]
       def list_matching_products(query, opts = {})
-        operation('ListMatchingProducts')
-          .add(opts.merge('Query' => query))
+        operation_with_marketplace('ListMatchingProducts')
+          .add(opts.update('Query' => query))
 
         run
       end
@@ -38,8 +38,8 @@ module MWS
       def get_matching_product_for_id(id_type, *id_list)
         opts = extract_options(id_list)
 
-        operation('GetMatchingProductForId')
-          .add(opts.merge('IdType' => id_type, 'IdList' => id_list))
+        operation_with_marketplace('GetMatchingProductForId')
+          .add(opts.update('IdType' => id_type, 'IdList' => id_list))
           .structure!('IdList', 'Id')
 
         run
@@ -48,16 +48,16 @@ module MWS
       # Lists products and their attributes, based on a list of ASIN values
       #
       # @see http://docs.developer.amazonservices.com/en_US/products/Products_GetMatchingProductForId.html
-      # @overload get_matching_product(*asins, opts = { marketplace_id: marketplace_id })
-      #   @param asins [Array<String>]
+      # @overload get_matching_product(*asin_list, opts = { marketplace_id: marketplace_id })
+      #   @param asin_list [Array<String>]
       #   @param opts [Hash]
       #   @option opts [String] :marketplace_id
       # @return [Peddler::XMLParser]
-      def get_matching_product(*asins)
-        opts = extract_options(asins)
+      def get_matching_product(*asin_list)
+        opts = extract_options(asin_list)
 
-        operation('GetMatchingProduct')
-          .add(opts.merge('ASINList' => asins))
+        operation_with_marketplace('GetMatchingProduct')
+          .add(opts.update('ASINList' => asin_list))
           .structure!('ASINList', 'ASIN')
 
         run
@@ -66,16 +66,16 @@ module MWS
       # Gets the current competitive price of a product, based on Seller SKU
       #
       # @see http://docs.developer.amazonservices.com/en_US/products/Products_GetCompetitivePricingForSKU.html
-      # @overload get_competitive_pricing_for_sku(*skus, opts = { marketplace_id: marketplace_id })
-      #   @param skus [Array<String>]
+      # @overload get_competitive_pricing_for_sku(*seller_sku_list, opts = { marketplace_id: marketplace_id })
+      #   @param seller_sku_list [Array<String>]
       #   @param opts [Hash]
       #   @option opts [String] :marketplace_id
       # @return [Peddler::XMLParser]
-      def get_competitive_pricing_for_sku(*skus)
-        opts = extract_options(skus)
+      def get_competitive_pricing_for_sku(*seller_sku_list)
+        opts = extract_options(seller_sku_list)
 
-        operation('GetCompetitivePricingForSKU')
-          .add(opts.merge('SellerSKUList' => skus))
+        operation_with_marketplace('GetCompetitivePricingForSKU')
+          .add(opts.update('SellerSKUList' => seller_sku_list))
           .structure!('SellerSKUList', 'SellerSKU')
 
         run
@@ -84,16 +84,16 @@ module MWS
       # Gets the current competitive price of a product, identified by its ASIN
       #
       # @see http://docs.developer.amazonservices.com/en_US/products/Products_GetCompetitivePricingForASIN.html
-      # @overload get_competitive_pricing_for_asin(*asins, opts = { marketplace_id: marketplace_id })
-      #   @param asins [Array<String>]
+      # @overload get_competitive_pricing_for_asin(*asin_list, opts = { marketplace_id: marketplace_id })
+      #   @param asin_list [Array<String>]
       #   @param opts [Hash]
       #   @option opts [String] :marketplace_id
       # @return [Peddler::XMLParser]
-      def get_competitive_pricing_for_asin(*asins)
-        opts = extract_options(asins)
+      def get_competitive_pricing_for_asin(*asin_list)
+        opts = extract_options(asin_list)
 
-        operation('GetCompetitivePricingForASIN')
-          .add(opts.merge('ASINList' => asins))
+        operation_with_marketplace('GetCompetitivePricingForASIN')
+          .add(opts.update('ASINList' => asin_list))
           .structure!('ASINList', 'ASIN')
 
         run
@@ -103,18 +103,18 @@ module MWS
       # a product, based on Seller SKU
       #
       # @see http://docs.developer.amazonservices.com/en_US/products/Products_GetLowestOfferListingsForSKU.html
-      # @overload get_lowest_offer_listings_for_sku(*skus, opts = { marketplace_id: marketplace_id })
-      #   @param skus [Array<String>]
+      # @overload get_lowest_offer_listings_for_sku(*seller_sku_list, opts = { marketplace_id: marketplace_id })
+      #   @param seller_sku_list [Array<String>]
       #   @param opts [Hash]
       #   @option opts [String] :marketplace_id
       #   @option opts [String] :item_condition
       #   @option opts [Boolean] :exclude_me
       # @return [Peddler::XMLParser]
-      def get_lowest_offer_listings_for_sku(*skus)
-        opts = extract_options(skus)
+      def get_lowest_offer_listings_for_sku(*seller_sku_list)
+        opts = extract_options(seller_sku_list)
 
-        operation('GetLowestOfferListingsForSKU')
-          .add(opts.merge('SellerSKUList' => skus))
+        operation_with_marketplace('GetLowestOfferListingsForSKU')
+          .add(opts.update('SellerSKUList' => seller_sku_list))
           .structure!('SellerSKUList', 'SellerSKU')
 
         run
@@ -124,18 +124,18 @@ module MWS
       # a product, identified by its ASIN
       #
       # @see http://docs.developer.amazonservices.com/en_US/products/Products_GetLowestOfferListingsForASIN.html
-      # @overload get_lowest_offer_listings_for_asin(*asins, opts = { marketplace_id: marketplace_id })
-      #   @param asins [Array<String>]
+      # @overload get_lowest_offer_listings_for_asin(*asin_list, opts = { marketplace_id: marketplace_id })
+      #   @param asin_list [Array<String>]
       #   @param opts [Hash]
       #   @option opts [String] :marketplace_id
       #   @option opts [String] :item_condition
       #   @option opts [Boolean] :exclude_me
       # @return [Peddler::XMLParser]
-      def get_lowest_offer_listings_for_asin(*asins)
-        opts = extract_options(asins)
+      def get_lowest_offer_listings_for_asin(*asin_list)
+        opts = extract_options(asin_list)
 
-        operation('GetLowestOfferListingsForASIN')
-          .add(opts.merge('ASINList' => asins))
+        operation_with_marketplace('GetLowestOfferListingsForASIN')
+          .add(opts.update('ASINList' => asin_list))
           .structure!('ASINList', 'ASIN')
 
         run
@@ -145,17 +145,17 @@ module MWS
       # Seller SKU
       #
       # @see http://docs.developer.amazonservices.com/en_US/products/Products_GetMyPriceForSKU.html
-      # @overload get_my_price_for_sku(*skus, opts = { marketplace_id: marketplace_id })
-      #   @param skus [Array<String>]
+      # @overload get_my_price_for_sku(*seller_sku_list, opts = { marketplace_id: marketplace_id })
+      #   @param seller_sku_list [Array<String>]
       #   @param opts [Hash]
       #   @option opts [String] :marketplace_id
       #   @option opts [String] :item_condition
       # @return [Peddler::XMLParser]
-      def get_my_price_for_sku(*skus)
-        opts = extract_options(skus)
+      def get_my_price_for_sku(*seller_sku_list)
+        opts = extract_options(seller_sku_list)
 
-        operation('GetMyPriceForSKU')
-          .add(opts.merge('SellerSKUList' => skus))
+        operation_with_marketplace('GetMyPriceForSKU')
+          .add(opts.update('SellerSKUList' => seller_sku_list))
           .structure!('SellerSKUList', 'SellerSKU')
 
         run
@@ -165,17 +165,17 @@ module MWS
       # its ASIN
       #
       # @see http://docs.developer.amazonservices.com/en_US/products/Products_GetMyPriceForASIN.html
-      # @overload get_my_price_for_asin(*skus, opts = { marketplace_id: marketplace_id })
-      #   @param asins [Array<String>]
+      # @overload get_my_price_for_asin(*seller_sku_list, opts = { marketplace_id: marketplace_id })
+      #   @param asin_list [Array<String>]
       #   @param opts [Hash]
       #   @option opts [String] :marketplace_id
       #   @option opts [String] :item_condition
       # @return [Peddler::XMLParser]
-      def get_my_price_for_asin(*asins)
-        opts = extract_options(asins)
+      def get_my_price_for_asin(*asin_list)
+        opts = extract_options(asin_list)
 
-        operation('GetMyPriceForASIN')
-          .add(opts.merge('ASINList' => asins))
+        operation_with_marketplace('GetMyPriceForASIN')
+          .add(opts.update('ASINList' => asin_list))
           .structure!('ASINList', 'ASIN')
 
         run
@@ -186,13 +186,13 @@ module MWS
       #
       # @see http://docs.developer.amazonservices.com/en_US/products/Products_GetProductCategoriesForSKU.html
       # @overload get_product_categories_for_sku(sku, opts = { marketplace_id: marketplace_id })
-      #   @param sku [String]
+      #   @param seller_sku [String]
       #   @param opts [Hash]
       #   @option opts [String] :marketplace_id
       # @return [Peddler::XMLParser]
-      def get_product_categories_for_sku(sku, opts = {})
-        operation('GetProductCategoriesForSKU')
-          .add(opts.merge('SellerSKU' => sku))
+      def get_product_categories_for_sku(seller_sku, opts = {})
+        operation_with_marketplace('GetProductCategoriesForSKU')
+          .add(opts.update('SellerSKU' => seller_sku))
 
         run
       end
@@ -206,8 +206,8 @@ module MWS
       #   @option opts [String] :marketplace_id
       # @return [Peddler::XMLParser]
       def get_product_categories_for_asin(asin, opts = {})
-        operation('GetProductCategoriesForASIN')
-          .add(opts.merge('ASIN' => asin))
+        operation_with_marketplace('GetProductCategoriesForASIN')
+          .add(opts.update('ASIN' => asin))
 
         run
       end
@@ -222,8 +222,8 @@ module MWS
       end
 
       # @api private
-      def operation(*)
-        super.tap do |opts|
+      def operation_with_marketplace(*args)
+        operation(*args).tap do |opts|
           unless opts.key?('MarketplaceId')
             opts.store('MarketplaceId', marketplace_id)
           end

data/lib/mws/reports/client.rb

@@ -16,7 +16,7 @@ module MWS
       # @return [Peddler::XMLParser]
       def request_report(report_type, opts = {})
         operation('RequestReport')
-          .add(opts.merge('ReportType' => report_type))
+          .add(opts.update('ReportType' => report_type))
           .structure!('MarketplaceIdList', 'Id')
 
         run
@@ -163,7 +163,7 @@ module MWS
       # @return [Peddler::XMLParser]
       def manage_report_schedule(report_type, schedule, opts = {})
         operation('ManageReportSchedule')
-          .add(opts.merge('ReportType' => report_type, 'Schedule' => schedule))
+          .add(opts.update('ReportType' => report_type, 'Schedule' => schedule))
 
         run
       end

data/lib/mws/webstore/client.rb

@@ -0,0 +1,88 @@
+require 'peddler/client'
+
+module MWS
+  module Webstore
+    # With the Webstore API section of Amazon MWS, you can get “Email Me When
+    # Available” subscription information for items listed on your Amazon
+    # Webstore. The Webstore API section can help you plan your inventory
+    # replenishment cycle by enabling you to query for items that your customers
+    # subscribed to when they clicked the Email Me When Available button on your
+    # Webstore. The Webstore API section can also return information about the
+    # notifications that were sent to your customers when out-of-stock items
+    # came back in stock. This information, when combined with sales information
+    # that your Webstore tracks, can help you determine how many notifications
+    # were converted into sales.
+    class Client < ::Peddler::Client
+      path '/Webstore/2014-09-01/'
+
+      # Lists subscription counts of subscriptions in a specified state,
+      # including the items that are subscribed to
+      #
+      # @see http://docs.developer.amazonservices.com/en_US/webstore/Webstore_ListSubscriptionsCount.html
+      # @overload list_subscriptions_count(subscription_state, opts = { marketplace_id: marketplace_id })
+      #   @param subscription_state [String]
+      #   @param opts [Hash]
+      #   @option opts [String] :marketplace_id
+      #   @option opts [String, #iso8601] :date_range_start
+      #   @option opts [String, #iso8601] :date_range_end
+      #   @option opts [Array<String>] :seller_sku_list
+      # @return [Peddler::XMLParser]
+      def list_subscriptions_count(subscription_state, opts = {})
+        opts[:marketplace_id] ||= marketplace_id
+        if opts.key?(:seller_sku_list)
+          opts['SellerSKUList'] = opts.delete(:seller_sku_list)
+        end
+        operation('ListSubscriptionsCount')
+          .add(opts.update('SubscriptionState' => subscription_state))
+          .structure!('SellerSKUList', 'SellerSKU')
+
+        run
+      end
+
+      # Lists the next page of subscription counts
+      #
+      # @see http://docs.developer.amazonservices.com/en_US/webstore/Webstore_ListSubscriptionsCountByNextToken.html
+      # @param next_token [String]
+      # @return [Peddler::XMLParser]
+      def list_subscriptions_count_by_next_token(next_token)
+        operation('ListSubscriptionsCountByNextToken')
+          .add('NextToken' => next_token)
+
+        run
+      end
+
+      # Gets the number of subscriptions that were created or notifications that
+      # were sent for an item within a date range
+      #
+      # @see http://docs.developer.amazonservices.com/en_US/webstore/Webstore_ListSubscriptionsCount.html
+      # @overload get_subscription_details(seller_sku, subscription_state, date_range_start, opts = { marketplace_id: marketplace_id })
+      #   @param seller_sku [String]
+      #   @param subscription_state [String]
+      #   @param date_range_start [String, #iso8601]
+      #   @param opts [Hash]
+      #   @option opts [String] :marketplace_id
+      #   @option opts [String, #iso8601] :date_range_end
+      # @return [Peddler::XMLParser]
+      def get_subscription_details(seller_sku, subscription_state, date_range_start, opts = {})
+        opts[:marketplace_id] ||= marketplace_id
+        operation('GetSubscriptionDetails')
+          .add(opts.update(
+            'SellerSKU' => seller_sku,
+            'SubscriptionState' => subscription_state,
+            'DateRangeStart' => date_range_start
+          ))
+
+        run
+      end
+
+      # Gets the service status of the API
+      #
+      # @see http://docs.developer.amazonservices.com/en_US/webstore/MWS_GetServiceStatus.html
+      # @return [Peddler::XMLParser]
+      def get_service_status
+        operation('GetServiceStatus')
+        run
+      end
+    end
+  end
+end

data/lib/mws/webstore.rb

@@ -0,0 +1 @@
+require 'mws/webstore/client'

data/lib/mws.rb

@@ -12,6 +12,7 @@ require 'mws/recommendations'
 require 'mws/reports'
 require 'mws/sellers'
 require 'mws/subscriptions'
+require 'mws/webstore'
 
 module MWS
   class << self

data/lib/peddler/version.rb

@@ -1,3 +1,3 @@
 module Peddler
-  VERSION = '0.10.0'
+  VERSION = '0.11.0'
 end

data/test/integration/test_webstore.rb

@@ -0,0 +1,18 @@
+require 'integration_test_helper'
+require 'mws/webstore'
+
+class TestWebstore < IntegrationTest
+  def test_lists_subscriptions_counts
+    clients.each do |client|
+      res = client.list_subscriptions_count('Subscribed')
+      refute_empty res.parse
+    end
+  end
+
+  def test_gets_service_status
+    clients.each do |client|
+      res = client.get_service_status
+      refute_empty res.parse
+    end
+  end
+end

data/test/unit/mws/test_products_client.rb

@@ -4,6 +4,6 @@ require 'mws/products/client'
 class TestProductsClient < MiniTest::Test
   def test_operation_includes_marketplace_id
     client = MWS::Products::Client.new
-    assert client.operation('Foo').has_key?('MarketplaceId')
+    assert client.operation_with_marketplace('Foo').has_key?('MarketplaceId')
   end
 end