peddler 2.4.5 → 3.0.0.beta1

data/lib/mws/merchant_fulfillment/client.rb

@@ -1,87 +0,0 @@
-# frozen_string_literal: true
-
-require 'peddler/client'
-
-module MWS
-  module MerchantFulfillment
-    # The Merchant Fulfillment API provides programmatic access to Amazon's
-    # Shipping Services for sellers, including competitive rates from
-    # Amazon-partnered carriers. Sellers can find out what shipping service
-    # offers are available by submitting information about a proposed shipment,
-    # such as package size and weight, shipment origin, and delivery date
-    # requirements. Sellers can choose from the shipping service offers returned
-    # by Amazon, and then purchase shipping labels for fulfilling their orders.
-    class Client < ::Peddler::Client
-      self.version = '2015-06-01'
-      self.path = "/MerchantFulfillment/#{version}"
-
-      # Returns a list of shipping service offers that satisfy the shipment
-      # request details that you specify
-      #
-      # @see https://docs.developer.amazonservices.com/en_US/merch_fulfill/MerchFulfill_GetEligibleShippingServices.html
-      # @param [Struct, Hash] shipment_request_details
-      # @return [Peddler::XMLParser]
-      def get_eligible_shipping_services(shipment_request_details)
-        operation('GetEligibleShippingServices')
-          .add('ShipmentRequestDetails' => shipment_request_details)
-          .structure!('ItemList', 'Item')
-
-        run
-      end
-
-      # Purchases shipping and returns PNG or PDF document data for a shipping
-      # label
-      #
-      # @see https://docs.developer.amazonservices.com/en_US/merch_fulfill/MerchFulfill_CreateShipment.html
-      # @param [Struct, Hash] shipment_request_details
-      # @param [String] shipping_service_id
-      # @param [Hash] opts
-      # @option opts [String] :shipping_service_offer_id
-      # @return [Peddler::XMLParser]
-      def create_shipment(shipment_request_details, shipping_service_id,
-                          opts = {})
-        operation('CreateShipment')
-          .add(opts)
-          .add('ShipmentRequestDetails' => shipment_request_details,
-               'ShippingServiceId' => shipping_service_id)
-          .structure!('ItemList', 'Item')
-
-        run
-      end
-
-      # Returns an existing shipment for the ShipmentId value that you specify
-      #
-      # @see https://docs.developer.amazonservices.com/en_US/merch_fulfill/MerchFulfill_GetShipment.html
-      # @param [String] shipment_id
-      # @return [Peddler::XMLParser]
-      def get_shipment(shipment_id)
-        operation('GetShipment')
-          .add('ShipmentId' => shipment_id)
-
-        run
-      end
-
-      # Cancels an existing shipment and requests a refund for the ShipmentId
-      # value that you specify
-      #
-      # @see https://docs.developer.amazonservices.com/en_US/merch_fulfill/MerchFulfill_CancelShipment.html
-      # @param [String] shipment_id
-      # @return [Peddler::XMLParser]
-      def cancel_shipment(shipment_id)
-        operation('CancelShipment')
-          .add('ShipmentId' => shipment_id)
-
-        run
-      end
-
-      # Gets the operational status of the API
-      #
-      # @see https://docs.developer.amazonservices.com/en_US/merch_fulfill/MWS_GetServiceStatus.html
-      # @return [Peddler::XMLParser]
-      def get_service_status
-        operation('GetServiceStatus')
-        run
-      end
-    end
-  end
-end

data/lib/mws/merchant_fulfillment.rb

@@ -1,3 +0,0 @@
-# frozen_string_literal: true
-
-require 'mws/merchant_fulfillment/client'

data/lib/mws/off_amazon_payments.rb

@@ -1,3 +0,0 @@
-# frozen_string_literal: true
-
-require 'mws/off_amazon_payments/client'

data/lib/mws/orders/client.rb

@@ -1,120 +0,0 @@
-# frozen_string_literal: true
-
-require 'peddler/client'
-
-module MWS
-  module Orders
-    # With the MWS Orders API, you can list orders created or updated during a
-    # time frame you specify or retrieve information about specific orders.
-    class Client < ::Peddler::Client
-      self.version = '2013-09-01'
-      self.path = "/Orders/#{version}"
-
-      # Lists orders
-      #
-      # @note When calling this operation, you must specify a time frame using
-      #   either created_after or last_updated_after. When requesting orders by
-      #   "Unshipped" status you must also request "PartiallyShipped" orders.
-      # @see https://docs.developer.amazonservices.com/en_US/orders-2013-09-01/Orders_ListOrders.html
-      # @overload list_orders(*marketplace_id, opts = {})
-      #   @param [Array<String>] marketplace_id
-      #   @param [Hash] opts
-      #   @option opts [String, #iso8601] :created_after
-      #   @option opts [String, #iso8601] :created_before
-      #   @option opts [String, #iso8601] :last_updated_after
-      #   @option opts [String, #iso8601] :last_updated_before
-      #   @option opts [Array<String>, String] :order_status
-      #   @option opts [Array<String>, String] :fulfillment_channel
-      #   @option opts [Array<String>, String] :payment_method
-      #   @option opts [String] :buyer_email
-      #   @option opts [String] :seller_order_id
-      #   @option opts [String] :max_results_per_page
-      #   @option opts [String] :tfm_shipment_status
-      # @return [Peddler::XMLParser]
-      def list_orders(*marketplace_id)
-        marketplace_id = marketplace_id.dup
-        opts = extract_options(marketplace_id)
-        opts['TFMShipmentStatus'] = opts.delete(:tfm_shipment_status) if opts.key?(:tfm_shipment_status)
-
-        operation('ListOrders')
-          .add(opts)
-          .add('MarketplaceId' => marketplace_id)
-          .structure!('OrderStatus', 'Status')
-          .structure!('FulfillmentChannel', 'Channel')
-          .structure!('MarketplaceId', 'Id')
-          .structure!('PaymentMethod')
-          .structure!('TFMShipmentStatus', 'Status')
-        require_start_time!
-
-        run
-      end
-
-      # Lists the next page of orders
-      #
-      # @see https://docs.developer.amazonservices.com/en_US/orders-2013-09-01/Orders_ListOrdersByNextToken.html
-      # @param [String] next_token
-      # @return [Peddler::XMLParser]
-      def list_orders_by_next_token(next_token)
-        operation('ListOrdersByNextToken')
-          .add('NextToken' => next_token)
-
-        run
-      end
-
-      # Gets one or more orders
-      #
-      # @see https://docs.developer.amazonservices.com/en_US/orders-2013-09-01/Orders_GetOrder.html
-      # @param [Array<String>] amazon_order_ids
-      # @return [Peddler::XMLParser]
-      def get_order(*amazon_order_ids)
-        operation('GetOrder')
-          .add('AmazonOrderId' => amazon_order_ids)
-          .structure!('AmazonOrderId', 'Id')
-
-        run
-      end
-
-      # Lists order items for an order
-      #
-      # @see https://docs.developer.amazonservices.com/en_US/orders-2013-09-01/Orders_ListOrderItems.html
-      # @param [String] amazon_order_id
-      # @return [Peddler::XMLParser]
-      def list_order_items(amazon_order_id)
-        operation('ListOrderItems')
-          .add('AmazonOrderId' => amazon_order_id)
-
-        run
-      end
-
-      # Lists the next page of order items for an order
-      #
-      # @see https://docs.developer.amazonservices.com/en_US/orders-2013-09-01/Orders_ListOrderItemsByNextToken.html
-      # @param [String] next_token
-      # @return [Peddler::XMLParser]
-      def list_order_items_by_next_token(next_token)
-        operation('ListOrderItemsByNextToken')
-          .add('NextToken' => next_token)
-
-        run
-      end
-
-      # Gets the service status of the API
-      #
-      # @see https://docs.developer.amazonservices.com/en_US/orders-2013-09-01/MWS_GetServiceStatus.html
-      # @return [Peddler::XMLParser]
-      def get_service_status
-        operation('GetServiceStatus')
-        run
-      end
-
-      private
-
-      def require_start_time!
-        return if operation.key?('CreatedAfter')
-        return if operation.key?('LastUpdatedAfter')
-
-        raise ArgumentError, 'specify created_after or last_updated_after'
-      end
-    end
-  end
-end

data/lib/mws/orders.rb

@@ -1,3 +0,0 @@
-# frozen_string_literal: true
-
-require 'mws/orders/client'

data/lib/mws/products/client.rb

@@ -1,268 +0,0 @@
-# frozen_string_literal: true
-
-require 'peddler/client'
-
-module MWS
-  module Products
-    # 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 Client < ::Peddler::Client
-      self.version = '2011-10-01'
-      self.path = "/Products/#{version}"
-
-      # Lists products and their attributes, based on a search query
-      #
-      # @see https://docs.developer.amazonservices.com/en_US/products/Products_ListMatchingProducts.html
-      # @param [String] marketplace_id
-      # @param [String] query
-      # @param [Hash] opts
-      # @option opts [String] :query_context_id
-      # @return [Peddler::XMLParser]
-      def list_matching_products(marketplace_id, query, opts = {})
-        operation('ListMatchingProducts')
-          .add(opts)
-          .add('MarketplaceId' => marketplace_id, 'Query' => query)
-
-        run
-      end
-
-      # Lists products and their attributes, based on a list of ASIN values
-      #
-      # @see https://docs.developer.amazonservices.com/en_US/products/Products_GetMatchingProductForId.html
-      # @param [String] marketplace_id
-      # @param [Array<String>] asin_list
-      # @return [Peddler::XMLParser]
-      def get_matching_product(marketplace_id, *asin_list)
-        operation('GetMatchingProduct')
-          .add('MarketplaceId' => marketplace_id, 'ASINList' => asin_list)
-          .structure!('ASINList', 'ASIN')
-
-        run
-      end
-
-      # Lists products and their attributes, based on a list of ASIN, GCID,
-      #   SellerSKU, UPC, EAN, ISBN, and JAN values
-      #
-      # @see https://docs.developer.amazonservices.com/en_US/products/Products_GetMatchingProduct.html
-      # @param [String] marketplace_id
-      # @param [String] id_type
-      # @param [Array<String>] id_list
-      # @return [Peddler::XMLParser]
-      def get_matching_product_for_id(marketplace_id, id_type, *id_list)
-        operation('GetMatchingProductForId')
-          .add('MarketplaceId' => marketplace_id, 'IdType' => id_type,
-               'IdList' => id_list)
-          .structure!('IdList', 'Id')
-
-        run
-      end
-
-      # Gets the current competitive price of a product, based on Seller SKU
-      #
-      # @see https://docs.developer.amazonservices.com/en_US/products/Products_GetCompetitivePricingForSKU.html
-      # @param [String] marketplace_id
-      # @param [Array<String>] seller_sku_list
-      # @return [Peddler::XMLParser]
-      def get_competitive_pricing_for_sku(marketplace_id, *seller_sku_list)
-        operation('GetCompetitivePricingForSKU')
-          .add('MarketplaceId' => marketplace_id,
-               'SellerSKUList' => seller_sku_list)
-          .structure!('SellerSKUList', 'SellerSKU')
-
-        run
-      end
-
-      # Gets the current competitive price of a product, identified by its ASIN
-      #
-      # @see https://docs.developer.amazonservices.com/en_US/products/Products_GetCompetitivePricingForASIN.html
-      # @param [String] marketplace_id
-      # @param [Array<String>] asin_list
-      # @return [Peddler::XMLParser]
-      def get_competitive_pricing_for_asin(marketplace_id, *asin_list)
-        operation('GetCompetitivePricingForASIN')
-          .add('MarketplaceId' => marketplace_id, 'ASINList' => asin_list)
-          .structure!('ASINList', 'ASIN')
-
-        run
-      end
-
-      # Gets pricing information for the lowest-price active offer listings for
-      # a product, based on Seller SKU
-      #
-      # @see https://docs.developer.amazonservices.com/en_US/products/Products_GetLowestOfferListingsForSKU.html
-      # @overload get_lowest_offer_listings_for_sku(marketplace_id, *seller_sku_list, opts = {})
-      #   @param [String] marketplace_id
-      #   @param [Array<String>] seller_sku_list
-      #   @param [Hash] opts
-      #   @option opts [String] :item_condition
-      #   @option opts [Boolean] :exclude_me
-      # @return [Peddler::XMLParser]
-      def get_lowest_offer_listings_for_sku(marketplace_id, *seller_sku_list)
-        seller_sku_list = seller_sku_list.dup
-        opts = extract_options(seller_sku_list)
-
-        operation('GetLowestOfferListingsForSKU')
-          .add(opts)
-          .add('MarketplaceId' => marketplace_id,
-               'SellerSKUList' => seller_sku_list)
-          .structure!('SellerSKUList', 'SellerSKU')
-
-        run
-      end
-
-      # Gets pricing information for the lowest-price active offer listings for
-      # a product, identified by its ASIN
-      #
-      # @see https://docs.developer.amazonservices.com/en_US/products/Products_GetLowestOfferListingsForASIN.html
-      # @overload get_lowest_offers_listings_for_asin(marketplace_id, *asin_list, opts = {})
-      #   @param [String] marketplace_id
-      #   @param [Array<String>] asin_list
-      #   @param [Hash] opts
-      #   @option opts [String] :item_condition
-      #   @option opts [Boolean] :exclude_me
-      # @return [Peddler::XMLParser]
-      def get_lowest_offer_listings_for_asin(marketplace_id, *asin_list)
-        asin_list = asin_list.dup
-        opts = extract_options(asin_list)
-
-        operation('GetLowestOfferListingsForASIN')
-          .add(opts)
-          .add('MarketplaceId' => marketplace_id, 'ASINList' => asin_list)
-          .structure!('ASINList', 'ASIN')
-
-        run
-      end
-
-      # Gets lowest priced offers for a single product, based on SellerSKU
-      #
-      # @see https://docs.developer.amazonservices.com/en_MX/products/Products_GetLowestPricedOffersForSKU.html
-      # @param [String] marketplace_id
-      # @param [String] seller_sku
-      # @param [String] item_condition
-      # @return [Peddler::XMLParser]
-      def get_lowest_priced_offers_for_sku(marketplace_id, seller_sku,
-                                           item_condition)
-        operation('GetLowestPricedOffersForSKU')
-          .add('MarketplaceId' => marketplace_id, 'SellerSKU' => seller_sku,
-               'ItemCondition' => item_condition)
-
-        run
-      end
-
-      # Gets lowest priced offers for a single product, based on ASIN
-      #
-      # @see https://docs.developer.amazonservices.com/en_MX/products/Products_GetLowestPricedOffersForASIN.html
-      # @param [String] marketplace_id
-      # @param [String] asin
-      # @param [String] item_condition
-      # @return [Peddler::XMLParser]
-      def get_lowest_priced_offers_for_asin(marketplace_id, asin,
-                                            item_condition)
-        operation('GetLowestPricedOffersForASIN')
-          .add('MarketplaceId' => marketplace_id, 'ASIN' => asin,
-               'ItemCondition' => item_condition)
-
-        run
-      end
-
-      # Gets the estimated fees for a list of products.
-      #
-      # @see https://docs.developer.amazonservices.com/en_US/products/Products_GetMyFeesEstimate.html
-      # @see https://docs.developer.amazonservices.com/en_US/products/Products_Datatypes.html#FeesEstimateRequest
-      # @param [Array<Struct, Hash>] fees_estimate_requests
-      # @return [Peddler::XMLParser]
-      def get_my_fees_estimate(*fees_estimate_requests)
-        operation('GetMyFeesEstimate')
-          .add('FeesEstimateRequestList' => fees_estimate_requests)
-          .structure!('FeesEstimateRequestList', 'FeesEstimateRequest')
-
-        run
-      end
-
-      # Gets pricing information for seller's own offer listings, based on
-      # Seller SKU
-      #
-      # @see https://docs.developer.amazonservices.com/en_US/products/Products_GetMyPriceForSKU.html
-      # @overload get_my_price_for_sku(marketplace_id, *seller_sku_list,
-      #   opts = {})
-      #   @param [String] marketplace_id
-      #   @param [Array<String>] seller_sku_list
-      #   @param [Hash] opts
-      #   @option opts [String] :item_condition
-      # @return [Peddler::XMLParser]
-      def get_my_price_for_sku(marketplace_id, *seller_sku_list)
-        seller_sku_list = seller_sku_list.dup
-        opts = extract_options(seller_sku_list)
-
-        operation('GetMyPriceForSKU')
-          .add(opts)
-          .add('MarketplaceId' => marketplace_id,
-               'SellerSKUList' => seller_sku_list)
-          .structure!('SellerSKUList', 'SellerSKU')
-
-        run
-      end
-
-      # Gets pricing information for seller's own offer listings, identified by
-      # its ASIN
-      #
-      # @see https://docs.developer.amazonservices.com/en_US/products/Products_GetMyPriceForASIN.html
-      # @overload get_my_price_for_asin(marketplace_id, *asin_list, opts = {})
-      #   @param [String] marketplace_id
-      #   @param [Array<String>] asin_list
-      #   @param [Hash] opts
-      #   @option opts [String] :item_condition
-      # @return [Peddler::XMLParser]
-      def get_my_price_for_asin(marketplace_id, *asin_list)
-        asin_list = asin_list.dup
-        opts = extract_options(asin_list)
-
-        operation('GetMyPriceForASIN')
-          .add(opts)
-          .add('MarketplaceId' => marketplace_id,
-               'ASINList' => asin_list)
-          .structure!('ASINList', 'ASIN')
-
-        run
-      end
-
-      # Gets parent product categories that a product belongs to, based on
-      # Seller SKU
-      #
-      # @see https://docs.developer.amazonservices.com/en_US/products/Products_GetProductCategoriesForSKU.html
-      # @param [String] marketplace_id
-      # @param [String] seller_sku
-      # @return [Peddler::XMLParser]
-      def get_product_categories_for_sku(marketplace_id, seller_sku)
-        operation('GetProductCategoriesForSKU')
-          .add('MarketplaceId' => marketplace_id, 'SellerSKU' => seller_sku)
-
-        run
-      end
-
-      # Gets parent product categories that a product belongs to, based on ASIN
-      #
-      # @see https://docs.developer.amazonservices.com/en_US/products/Products_GetProductCategoriesForASIN.html
-      # @param [String] marketplace_id
-      # @param [String] asin
-      # @return [Peddler::XMLParser]
-      def get_product_categories_for_asin(marketplace_id, asin)
-        operation('GetProductCategoriesForASIN')
-          .add('MarketplaceId' => marketplace_id, 'ASIN' => asin)
-
-        run
-      end
-
-      # Gets the service status of the API
-      #
-      # @see https://docs.developer.amazonservices.com/en_US/products/Products_GetServiceStatus.html
-      # @return [Peddler::XMLParser]
-      def get_service_status
-        operation('GetServiceStatus')
-        run
-      end
-    end
-  end
-end

data/lib/mws/products.rb

@@ -1,3 +0,0 @@
-# frozen_string_literal: true
-
-require 'mws/products/client'

data/lib/mws/recommendations/client.rb

@@ -1,72 +0,0 @@
-# frozen_string_literal: true
-
-require 'peddler/client'
-
-module MWS
-  module Recommendations
-    # 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.
-    class Client < ::Peddler::Client
-      self.version = '2013-04-01'
-      self.path = "/Recommendations/#{version}"
-
-      # Checks whether there are active recommendations for each category for
-      # the given marketplace, and if there are, returns the time when
-      # recommendations were last updated for each category
-      #
-      # @see https://docs.developer.amazonservices.com/en_US/recommendations/Recommendations_GetLastUpdatedTimeForRecommendations.html
-      # @param [String] marketplace_id
-      # @return [Peddler::XMLParser]
-      def get_last_updated_time_for_recommendations(marketplace_id)
-        operation('GetLastUpdatedTimeForRecommendations')
-          .add('MarketplaceId' => marketplace_id)
-
-        run
-      end
-
-      # Lists active recommendations for a specific category or for all
-      # categories for a specific marketplace
-      #
-      # @see https://docs.developer.amazonservices.com/en_US/recommendations/Recommendations_ListRecommendations.html
-      # @param [String] marketplace_id
-      # @param [Hash] opts
-      # @option opts [String] :recommendation_category
-      # @option opts [Array<Struct, Hash>] :category_query_list
-      # @return [Peddler::XMLParser]
-      def list_recommendations(marketplace_id, opts = {})
-        operation('ListRecommendations')
-          .add(opts)
-          .add('MarketplaceId' => marketplace_id)
-          .structure!(
-            'CategoryQueryList', 'CategoryQuery', '1', 'FilterOptions',
-            'FilterOption'
-          )
-
-        run
-      end
-
-      # Lists the next page of active recommendations
-      #
-      # @see https://docs.developer.amazonservices.com/en_US/recommendations/Recommendations_ListRecommendationsByNextToken.html
-      # @param [String] next_token
-      # @return [Peddler::XMLParser]
-      def list_recommendations_by_next_token(next_token)
-        operation('ListRecommendationsByNextToken')
-          .add('NextToken' => next_token)
-
-        run
-      end
-
-      # Gets the service status of the API
-      #
-      # @see https://docs.developer.amazonservices.com/en_US/recommendations/Recommendations_GetServiceStatus.html
-      # @return [Peddler::XMLParser]
-      def get_service_status
-        operation('GetServiceStatus')
-        run
-      end
-    end
-  end
-end

data/lib/mws/recommendations.rb

@@ -1,3 +0,0 @@
-# frozen_string_literal: true
-
-require 'mws/recommendations/client'