peddler 0.6.5 → 0.7.0

data/lib/mws/products.rb

@@ -1 +1,238 @@
-require 'mws/products/client'
+require 'peddler/client'
+
+module MWS
+  # The MWS Products API helps you get information to match your products to
+  # existing product listings on Amazon Marketplace websites and to make
+  # sourcing and pricing decisions for listing those products on Amazon
+  # Marketplace websites.
+  class Products < ::Peddler::Client
+    path 'Products/2011-10-01'
+
+    # Lists products and their attributes, based on a search query
+    #
+    # @see http://docs.developer.amazonservices.com/en_US/products/Products_ListMatchingProducts.html
+    # @method list_matching_products
+    # @overload list_matching_products(query, opts = { marketplace_id: marketplace_id })
+    #   @param query [String]
+    #   @param opts [Hash]
+    #   @option opts [String] :marketplace_id
+    #   @option opts [String] :query_context_id
+    # @return [Peddler::Parser]
+    def list_matching_products(query, opts = {})
+      opts[:marketplace_id] ||= marketplace_id
+
+      operation('ListMatchingProducts')
+        .add(opts.merge('Query' => query))
+
+      run
+    end
+
+    # Lists products and their attributes, based on a list of ASIN, GCID,
+    #   SellerSKU, UPC, EAN, ISBN, and JAN values
+    #
+    # @see http://docs.developer.amazonservices.com/en_US/products/Products_GetMatchingProduct.html
+    # @overload get_matching_product_for_id(id_type, *id_list, opts = { marketplace_id: marketplace_id })
+    #   @param id_type [String]
+    #   @param id_list [Array<String>]
+    #   @param opts [Hash]
+    #   @option opts [String] :marketplace_id
+    # @return [Peddler::Parser]
+    def get_matching_product_for_id(id_type, *id_list)
+      opts = extract_options(id_list)
+      opts[:marketplace_id] ||= marketplace_id
+
+      operation('GetMatchingProductForId')
+        .add(opts.merge('IdType' => id_type, 'IdList' => id_list))
+        .structure!('IdList', 'Id')
+
+      run
+    end
+
+    # 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>]
+    #   @param opts [Hash]
+    #   @option opts [String] :marketplace_id
+    # @return [Peddler::Parser]
+    def get_matching_product(*asins)
+      opts = extract_options(asins)
+      opts[:marketplace_id] ||= marketplace_id
+
+      operation('GetMatchingProduct')
+        .add(opts.merge('ASINList' => asins))
+        .structure!('ASINList', 'ASIN')
+
+      run
+    end
+
+    # 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>]
+    #   @param opts [Hash]
+    #   @option opts [String] :marketplace_id
+    # @return [Peddler::Parser]
+    def get_competitive_pricing_for_sku(*skus)
+      opts = extract_options(skus)
+      opts[:marketplace_id] ||= marketplace_id
+
+      operation('GetCompetitivePricingForSKU')
+        .add(opts.merge('SellerSKUList' => skus))
+        .structure!('SellerSKUList', 'SellerSKU')
+
+      run
+    end
+
+    # 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>]
+    #   @param opts [Hash]
+    #   @option opts [String] :marketplace_id
+    # @return [Peddler::Parser]
+    def get_competitive_pricing_for_asin(*asins)
+      opts = extract_options(asins)
+      opts[:marketplace_id] ||= marketplace_id
+
+      operation('GetCompetitivePricingForASIN')
+        .add(opts.merge('ASINList' => asins))
+        .structure!('ASINList', 'ASIN')
+
+      run
+    end
+
+    # Gets pricing information for the lowest-price active offer listings for 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>]
+    #   @param opts [Hash]
+    #   @option opts [String] :marketplace_id
+    #   @option opts [String] :item_condition
+    #   @option opts [Boolean] :exclude_me
+    # @return [Peddler::Parser]
+    def get_lowest_offer_listings_for_sku(*skus)
+      opts = extract_options(skus)
+      opts[:marketplace_id] ||= marketplace_id
+
+      operation('GetLowestOfferListingsForSKU')
+        .add(opts.merge('SellerSKUList' => skus))
+        .structure!('SellerSKUList', 'SellerSKU')
+
+      run
+    end
+
+    # Gets pricing information for the lowest-price active offer listings for 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>]
+    #   @param opts [Hash]
+    #   @option opts [String] :marketplace_id
+    #   @option opts [String] :item_condition
+    #   @option opts [Boolean] :exclude_me
+    # @return [Peddler::Parser]
+    def get_lowest_offer_listings_for_asin(*asins)
+      opts = extract_options(asins)
+      opts[:marketplace_id] ||= marketplace_id
+
+      operation('GetLowestOfferListingsForASIN')
+        .add(opts.merge('ASINList' => asins))
+        .structure!('ASINList', 'ASIN')
+
+      run
+    end
+
+    # Gets pricing information for seller's own offer listings, based on 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>]
+    #   @param opts [Hash]
+    #   @option opts [String] :marketplace_id
+    #   @option opts [String] :item_condition
+    # @return [Peddler::Parser]
+    def get_my_price_for_sku(*skus)
+      opts = extract_options(skus)
+      opts[:marketplace_id] ||= marketplace_id
+
+      operation('GetMyPriceForSKU')
+        .add(opts.merge('SellerSKUList' => skus))
+        .structure!('SellerSKUList', 'SellerSKU')
+
+      run
+    end
+
+    # Gets pricing information for seller's own offer listings, identified by
+    # 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>]
+    #   @param opts [Hash]
+    #   @option opts [String] :marketplace_id
+    #   @option opts [String] :item_condition
+    # @return [Peddler::Parser]
+    def get_my_price_for_asin(*asins)
+      opts = extract_options(asins)
+      opts[:marketplace_id] ||= marketplace_id
+
+      operation('GetMyPriceForASIN')
+        .add(opts.merge('ASINList' => asins))
+        .structure!('ASINList', 'ASIN')
+
+      run
+    end
+
+    # Gets parent product categories that a product belongs to, based on
+    # Seller`SKU
+    #
+    # @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 opts [Hash]
+    #   @option opts [String] :marketplace_id
+    # @return [Peddler::Parser]
+    def get_product_categories_for_sku(sku, opts = {})
+      opts[:marketplace_id] ||= marketplace_id
+
+      operation('GetProductCategoriesForSKU')
+        .add(opts.merge('SellerSKU' => sku))
+
+      run
+    end
+
+    # Gets parent product categories that a product belongs to, based on ASIN
+    #
+    # @see http://docs.developer.amazonservices.com/en_US/products/Products_GetProductCategoriesForASIN.html
+    # @overload get_product_categories_for_asin(asin, opts = { marketplace_id: marketplace_id })
+    #   @param asin [String]
+    #   @param opts [Hash]
+    #   @option opts [String] :marketplace_id
+    # @return [Peddler::Parser]
+    def get_product_categories_for_asin(asin, opts = {})
+      opts[:marketplace_id] ||= marketplace_id
+
+      operation('GetProductCategoriesForASIN')
+        .add(opts.merge('ASIN' => asin))
+
+      run
+    end
+
+    # Gets the service status of the API
+    #
+    # @see http://docs.developer.amazonservices.com/en_US/products/Products_GetServiceStatus.html
+    # @return Peddler::Parser
+    def get_service_status
+      operation('GetServiceStatus')
+      run
+    end
+  end
+end

data/lib/mws/recommendations.rb

@@ -1 +1,13 @@
-require 'mws/recommendations/client'
+require 'peddler/client'
+
+module MWS
+  # The Recommendations API enables you to programmatically retrieve Amazon
+  # Selling Coach recommendations by recommendation category. A recommendation
+  # is an actionable, timely, and personalized opportunity to increase your
+  # sales and performance.
+  #
+  # @todo Not implemented
+  class Recommendations < ::Peddler::Client
+    path 'Recommendations/2013-04-01'
+  end
+end

data/lib/mws/reports.rb

@@ -1 +1,221 @@
-require 'mws/reports/client'
+require 'peddler/client'
+
+module MWS
+  # The Reports API lets you request reports about your inventory and orders.
+  class Reports < ::Peddler::Client
+    # Creates a report request
+    #
+    # @see http://docs.developer.amazonservices.com/en_US/reports/Reports_RequestReport.html
+    # @param report_type [String]
+    # @param opts [Hash]
+    # @option opts [String, #iso8601] :start_date
+    # @option opts [String, #iso8601] :end_date
+    # @option opts [String] :report_options
+    # @option opts [Array<String>, String] :marketplace_id
+    # @return [Peddler::Parser]
+    def request_report(report_type, opts = {})
+      operation('RequestReport')
+        .add(opts.merge('ReportType' => report_type))
+        .structure!('MarketplaceIdList', 'Id')
+
+      run
+    end
+
+    # Lists report requests
+    #
+    # @see http://docs.developer.amazonservices.com/en_US/reports/Reports_GetReportRequestList.html
+    # @param opts [Hash]
+    # @option opts [Array<String>, String] :report_request_id_list
+    # @option opts [Array<String>, String] :report_type_list
+    # @option opts [Array<String>, String] :report_processing_status_list
+    # @option opts [Integer] :max_count
+    # @option opts [String, #iso8601] :requested_from_date
+    # @option opts [String, #iso8601] :requested_to_date
+    # @return [Peddler::Parser]
+    def get_report_request_list(opts = {})
+      operation('GetReportRequestList')
+        .add(opts)
+        .structure!('ReportRequestIdList', 'Id')
+        .structure!('ReportTypeList', 'Type')
+        .structure!('ReportProcessingStatusList', 'Status')
+
+      run
+    end
+
+    # Lists the next page of the report requests
+    #
+    # @see http://docs.developer.amazonservices.com/en_US/reports/Reports_GetReportRequestListByNextToken.html
+    # @param next_token [String]
+    # @return [Peddler::Parser]
+    # @return false if there are no more pages
+    def get_report_request_list_by_next_token(next_token)
+      operation('GetReportRequestListByNextToken')
+        .add('NextToken' => next_token)
+
+      run
+    end
+
+    # Counts requested reports
+    #
+    # @see http://docs.developer.amazonservices.com/en_US/reports/Reports_GetReportRequestCount.html
+    # @param opts [Hash]
+    # @option opts [Array<String>, String] :report_type_list
+    # @option opts [Array<String>, String] :report_processing_status_list
+    # @option opts [String, #iso8601] :requested_from_date
+    # @option opts [String, #iso8601] :requested_to_date
+    # @return [Peddler::Parser]
+    def get_report_request_count(opts = {})
+      operation('GetReportRequestCount')
+        .add(opts)
+        .structure!('ReportTypeList', 'Type')
+        .structure!('ReportProcessingStatusList', 'Status')
+
+      run
+    end
+
+    # Cancels one or more report requests
+    #
+    # @see http://docs.developer.amazonservices.com/en_US/reports/Reports_CancelReportRequests.html
+    # @param opts [Hash]
+    # @option opts [Array<String>, String] :report_type_list
+    # @option opts [Array<String>, String] :report_processing_status_list
+    # @option opts [String, #iso8601] :requested_from_date
+    # @option opts [String, #iso8601] :requested_to_date
+    # @return [Peddler::Parser]
+    def cancel_report_requests(opts = {})
+      operation('CancelReportRequests')
+        .add(opts)
+        .structure!('ReportTypeList', 'Type')
+        .structure!('ReportProcessingStatusList', 'Status')
+
+      run
+    end
+
+    # Lists reports
+    #
+    # @see http://docs.developer.amazonservices.com/en_US/reports/Reports_GetReportList.html
+    # @param opts [Hash]
+    # @option opts [Integer] :max_count
+    # @option opts [Array<String>, String] :report_type_list
+    # @option opts [Boolean] :acknowledged
+    # @option opts [String, #iso8601] :available_from_date
+    # @option opts [String, #iso8601] :available_to_date
+    # @option opts [Array<String>, String] :report_request_id_list
+    # @return [Peddler::Parser]
+    def get_report_list(opts = {})
+      operation('GetReportList')
+        .add(opts)
+        .structure!('ReportTypeList', 'Type')
+        .structure!('ReportRequestIdList', 'Id')
+
+      run
+    end
+
+    # Lists the next page of reports
+    #
+    # @see http://docs.developer.amazonservices.com/en_US/reports/Reports_GetReportListByNextToken.html
+    # @param next_token [String]
+    # @return [Peddler::Parser]
+    # @return false if there are no more pages
+    def get_report_list_by_next_token(next_token)
+      operation('GetReportListByNextToken')
+        .add('NextToken' => next_token)
+
+      run
+    end
+
+    # Counts reports
+    #
+    # @see http://docs.developer.amazonservices.com/en_US/reports/Reports_GetReportCount.html
+    # @param opts [Hash]
+    # @option opts [Array<String>, String] :report_type_list
+    # @option opts [Boolean] :acknowledged
+    # @option opts [String, #iso8601] :available_from_date
+    # @option opts [String, #iso8601] :available_to_date
+    # @return [Peddler::Parser]
+    def get_report_count(opts = {})
+      operation('GetReportCount')
+        .add(opts)
+        .structure!('ReportTypeList', 'Type')
+
+      run
+    end
+
+    # Gets a report and its Content-MD5 header
+    #
+    # @see http://docs.developer.amazonservices.com/en_US/reports/Reports_GetReport.html
+    # @param report_id [String]
+    # @return [Peddler::Parser]
+    def get_report(report_id, &blk)
+      operation('GetReport')
+        .add('ReportId' => report_id)
+
+      run(&blk)
+    end
+
+
+    # Creates, updates, or deletes a report request schedule
+    #
+    # @see http://docs.developer.amazonservices.com/en_US/reports/Reports_ManageReportSchedule.html
+    # @param report_type [String]
+    # @param schedule [String]
+    # @param opts [Hash]
+    # @option opts [String, #iso8601] :schedule_date
+    # @return [Peddler::Parser]
+    def manage_report_schedule(report_type, schedule, opts = {})
+      operation('ManageReportSchedule')
+        .add(opts.merge('ReportType' => report_type, 'Schedule' => schedule))
+
+      run
+    end
+
+    # List scheduled reports
+    #
+    # @see http://docs.developer.amazonservices.com/en_US/reports/Reports_GetReportScheduleList.html
+    # @param report_type_list [*Array<String>]
+    # @return [Peddler::Parser]
+    def get_report_schedule_list(*report_type_list)
+      operation('GetReportScheduleList')
+        .add('ReportTypeList' => report_type_list)
+        .structure!('ReportTypeList', 'Type')
+
+      run
+    end
+
+    # List next page of scheduled reports
+    #
+    # @see http://docs.developer.amazonservices.com/en_US/reports/Reports_GetReportScheduleListByNextToken.html
+    # @param next_token [String]
+    # @raise [NotImplementedError]
+    def get_report_schedule_list_by_next_token(token = next_token)
+      raise NotImplementedError
+    end
+
+    # Count scheduled reports
+    #
+    # @see http://docs.developer.amazonservices.com/en_US/reports/Reports_GetReportScheduleCount.html
+    # @param report_type_list [Array<String>]
+    # @return [Peddler::Parser]
+    def get_report_schedule_count(*report_type_list)
+      operation('GetReportScheduleCount')
+        .add('ReportTypeList' => report_type_list)
+        .structure!('ReportTypeList', 'Type')
+
+      run
+    end
+
+    # Update acknowledged status of one or more reports
+    #
+    # @see http://docs.developer.amazonservices.com/en_US/reports/Reports_UpdateReportAcknowledgements.html
+    # @param acknowledged [Boolean]
+    # @param report_id_list [Array<String>]
+    # @return [Peddler::Parser]
+    def update_report_acknowledgements(acknowledged, *report_id_list)
+      operation('UpdateReportAcknowledgement')
+        .add('ReportIdList' => report_id_list, 'Acknowledged' => acknowledged)
+        .structure!('ReportIdList', 'Id')
+
+      run
+    end
+  end
+end

data/lib/mws/sellers.rb

@@ -1 +1,40 @@
-require 'mws/sellers/client'
+require 'peddler/client'
+
+module MWS
+  # The Sellers API lets sellers retrieve information about their seller
+  # account, such as the marketplaces they participate in.
+  class Sellers < ::Peddler::Client
+    path 'Sellers/2011-07-01'
+
+    # Lists the marketplaces the seller participates in
+    #
+    # @see http://docs.developer.amazonservices.com/en_US/sellers/Sellers_ListMarketplaceParticipations.html
+    # @param next_token [String]
+    # @return [Peddler::Parser]
+    def list_marketplace_participations
+      operation('ListMarketplaceParticipations')
+      run
+    end
+
+    # Lists the next page of marketplaces the seller participates in
+    #
+    # @see http://docs.developer.amazonservices.com/en_US/sellers/Sellers_ListMarketplaceParticipationsByNextToken.html
+    # @param next_token [String]
+    # @return [Peddler::Parser]
+    def list_marketplace_participations_by_next_token(next_token)
+      operation('ListMarketplaceParticipationsByNextToken')
+        .add('NextToken' => next_token)
+
+      run
+    end
+
+    # Gets the service status of the API
+    #
+    # @see http://docs.developer.amazonservices.com/en_US/sellers/MWS_GetServiceStatus.html
+    # @return [Peddler::Parser]
+    def get_service_status
+      operation('GetServiceStatus')
+      run
+    end
+  end
+end

data/lib/mws/subscriptions.rb

@@ -1 +1,175 @@
-require 'mws/subscriptions/client'
+require 'peddler/client'
+
+module MWS
+  # 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.
+  class Subscriptions < ::Peddler::Client
+    path 'Subscriptions/2013-07-01'
+
+    # Registers a new destination to receive notifications
+    #
+    # @see http://docs.developer.amazonservices.com/en_US/subscriptions/Subscriptions_RegisterDestination.html
+    # @method register_destination
+    # @overload register_destination(sqs_queue_url, marketplace_id = marketplace_id)
+    #   @param sqs_queue_url [String]
+    #   @param marketplace_id [String]
+    # @return [Peddler::Parser]
+    def register_destination(sqs_queue_url, marketplace_id = marketplace_id)
+      operation('RegisterDestination')
+        .add('MarketplaceId' => marketplace_id)
+        .add(build_destination(sqs_queue_url))
+
+      run
+    end
+
+    # Removes an existing destination from the list of registered destinations
+    #
+    # @see http://docs.developer.amazonservices.com/en_US/subscriptions/Subscriptions_DeregisterDestination.html
+    # @method deregister_destination
+    # @overload deregister_destination(sqs_queue_url, marketplace_id = marketplace_id)
+    #   @param sqs_queue_url [String]
+    #   @param marketplace_id [String]
+    # @return [Peddler::Parser]
+    def deregister_destination(sqs_queue_url, marketplace_id = marketplace_id)
+      operation('DeregisterDestination')
+        .add('MarketplaceId' => marketplace_id)
+        .add(build_destination(sqs_queue_url))
+
+      run
+    end
+
+    # Lists all registered destinations
+    #
+    # @see http://docs.developer.amazonservices.com/en_US/subscriptions/Subscriptions_ListRegisteredDestinations.html
+    # @param marketplace_id [String]
+    # @return [Peddler::Parser]
+    def list_registered_destinations( marketplace_id = marketplace_id)
+      operation('ListRegisteredDestinations')
+        .add('MarketplaceId' => marketplace_id)
+
+      run
+    end
+
+    # Sends a test notification to an existing destination
+    #
+    # @see http://docs.developer.amazonservices.com/en_US/subscriptions/Subscriptions_SendTestNotificationToDestination.html
+    # @method send_test_notification_to_destination
+    # @overload send_test_notification_to_destination(sqs_queue_url, marketplace_id = marketplace_id)
+    #   @param sqs_queue_url [String]
+    #   @param marketplace_id [String]
+    # @return [Peddler::Parser]
+    def send_test_notification_to_destination(sqs_queue_url, marketplace_id = marketplace_id)
+      operation('SendTestNotificationToDestination')
+        .add('MarketplaceId' => marketplace_id)
+        .add(build_destination(sqs_queue_url))
+
+      run
+    end
+
+    # Creates a new subscription
+    #
+    # @see http://docs.developer.amazonservices.com/en_US/subscriptions/Subscriptions_CreateSubscription.html
+    # @param notification_type [String]
+    # @param sqs_queue_url [String]
+    # @param marketplace_id [String]
+    # @return [Peddler::Parser]
+    def create_subscription(notification_type, sqs_queue_url, marketplace_id = marketplace_id)
+      operation('CreateSubscription')
+        .add('MarketplaceId' => marketplace_id)
+        .add(build_subscription(notification_type, sqs_queue_url))
+
+      run
+    end
+
+    # Gets a subscription
+    #
+    # @see http://docs.developer.amazonservices.com/en_US/subscriptions/Subscriptions_GetSubscription.html
+    # @param notification_type [String]
+    # @param sqs_queue_url [String]
+    # @param marketplace_id [String]
+    # @return [Peddler::Parser]
+    def get_subscription(notification_type, sqs_queue_url, marketplace_id = marketplace_id)
+      operation('GetSubscription')
+        .add('MarketplaceId' => marketplace_id, 'NotificationType' => notification_type)
+        .add(build_destination(sqs_queue_url))
+
+      run
+    end
+
+    # Deletes a subscription
+    #
+    # @see http://docs.developer.amazonservices.com/en_US/subscriptions/Subscriptions_DeleteSubscription.html
+    # @param notification_type [String]
+    # @param sqs_queue_url [String]
+    # @param marketplace_id [String]
+    # @return [Peddler::Parser]
+    def delete_subscription(notification_type, sqs_queue_url, marketplace_id = marketplace_id)
+      operation('DeleteSubscription')
+        .add('MarketplaceId' => marketplace_id, 'NotificationType' => notification_type)
+        .add(build_destination(sqs_queue_url))
+
+      run
+    end
+
+    # Lists current subscriptions
+    #
+    # @see http://docs.developer.amazonservices.com/en_US/subscriptions/Subscriptions_ListSubscriptions.html
+    # @param marketplace_id [String]
+    # @return [Peddler::Parser]
+    def list_subscriptions(marketplace_id = marketplace_id)
+      operation('ListSubscriptions')
+        .add('MarketplaceId' => marketplace_id)
+
+      run
+    end
+
+    # Updates a subscription
+    #
+    # @see http://docs.developer.amazonservices.com/en_US/subscriptions/Subscriptions_UpdateSubscription.html
+    # @param notification_type [String]
+    # @param sqs_queue_url [String]
+    # @param enabled [Boolean]
+    # @param marketplace_id [String]
+    # @return [Peddler::Parser]
+    def update_subscription(notification_type, sqs_queue_url, enabled, marketplace_id = marketplace_id)
+      operation('CreateSubscription')
+        .add('MarketplaceId' => marketplace_id)
+        .add(build_subscription(notification_type, sqs_queue_url, enabled))
+
+      run
+    end
+
+    # Gets the service status of the API
+    #
+    # @see http://docs.developer.amazonservices.com/en_US/subscriptions/Subscriptions_GetServiceStatus.html
+    # @return [Peddler::Parser]
+    def get_service_status
+      operation('GetServiceStatus')
+      run
+    end
+
+    private
+
+    def build_destination(sqs_queue_url)
+      {
+        'Destination.DeliveryChannel' => 'SQS',
+        'Destination.AttributeList.member.1.Key' => 'sqsQueueUrl',
+        'Destination.AttributeList.member.1.Value' => sqs_queue_url
+      }
+    end
+
+    def build_subscription(notification_type, sqs_queue_url, enabled = true)
+      {
+        'Subscription.IsEnabled' => enabled,
+        'Subscription.NotificationType' => notification_type,
+        'Subscription.Destination.DeliveryChannel' => 'SQS',
+        'Subscription.Destination.AttributeList.member.1.Key' => 'sqsQueueUrl',
+        'Subscription.Destination.AttributeList.member.1.Value' => sqs_queue_url
+      }
+    end
+  end
+end