peddler 3.0.0 → 4.0.0

data/lib/peddler/{api → apis}/vendor_direct_fulfillment_shipping_2021_12_28.rb

@@ -5,11 +5,11 @@ require "peddler/api"
 module Peddler
   class << self
     def vendor_direct_fulfillment_shipping_2021_12_28(...)
-      API::VendorDirectFulfillmentShipping20211228.new(...)
+      APIs::VendorDirectFulfillmentShipping20211228.new(...)
     end
   end
 
-  class API
+  module APIs
     # Selling Partner API for Direct Fulfillment Shipping
     #
     # The Selling Partner API for Direct Fulfillment Shipping provides programmatic access to a direct fulfillment
@@ -31,7 +31,7 @@ module Peddler
       # @param next_token [String] Used for pagination when there are more ship labels than the specified result size
       #   limit. The token value is returned in the previous API call.
       # @param rate_limit [Float] Requests per second
-      # @return [Hash] The API response
+      # @return [Peddler::Response] The API response
       def get_shipping_labels(created_after, created_before, ship_from_party_id: nil, limit: nil, sort_order: "ASC",
         next_token: nil, rate_limit: 10.0)
         path = "/vendor/directFulfillment/shipping/2021-12-28/shippingLabels"
@@ -50,9 +50,9 @@ module Peddler
       # Creates a shipping label for a purchase order and returns a transactionId for reference.
       #
       # @note This operation can make a dynamic sandbox call.
-      # @param body [Hash] Request body that contains the shipping labels data.
+      # @param body [Hash] Request body containing the shipping labels data.
       # @param rate_limit [Float] Requests per second
-      # @return [Hash] The API response
+      # @return [Peddler::Response] The API response
       def submit_shipping_label_request(body, rate_limit: 10.0)
         path = "/vendor/directFulfillment/shipping/2021-12-28/shippingLabels"
 
@@ -62,10 +62,10 @@ module Peddler
       # Returns a shipping label for the purchaseOrderNumber that you specify.
       #
       # @note This operation can make a dynamic sandbox call.
-      # @param purchase_order_number [String] The purchase order number for which you want to return the shipping label.
-      #   Should be the same `purchaseOrderNumber` as received in the order.
+      # @param purchase_order_number [String] The purchase order number for which you want to return the shipping label
+      #   and should be the same purchaseOrderNumber as received in the order.
       # @param rate_limit [Float] Requests per second
-      # @return [Hash] The API response
+      # @return [Peddler::Response] The API response
       def get_shipping_label(purchase_order_number, rate_limit: 10.0)
         path = "/vendor/directFulfillment/shipping/2021-12-28/shippingLabels/#{purchase_order_number}"
 
@@ -77,9 +77,9 @@ module Peddler
       # @note This operation can make a dynamic sandbox call.
       # @param purchase_order_number [String] The purchase order number for which you want to return the shipping
       #   labels. It should be the same purchaseOrderNumber as received in the order.
-      # @param body [Hash] The request payload that contains parameters for creating shipping labels.
+      # @param body [Hash] The request payload containing parameters for creating shipping labels.
       # @param rate_limit [Float] Requests per second
-      # @return [Hash] The API response
+      # @return [Peddler::Response] The API response
       def create_shipping_labels(purchase_order_number, body, rate_limit: 10.0)
         path = "/vendor/directFulfillment/shipping/2021-12-28/shippingLabels/#{purchase_order_number}"
 
@@ -91,7 +91,7 @@ module Peddler
       # @note This operation can make a dynamic sandbox call.
       # @param body [Hash] Request body containing the shipment confirmations data.
       # @param rate_limit [Float] Requests per second
-      # @return [Hash] The API response
+      # @return [Peddler::Response] The API response
       def submit_shipment_confirmations(body, rate_limit: 10.0)
         path = "/vendor/directFulfillment/shipping/2021-12-28/shipmentConfirmations"
 
@@ -103,9 +103,9 @@ module Peddler
       # order, when the package is outside of Amazon Network visibility.
       #
       # @note This operation can make a dynamic sandbox call.
-      # @param body [Hash] Request body that contains the shipment status update data.
+      # @param body [Hash] Request body containing the shipment status update data.
       # @param rate_limit [Float] Requests per second
-      # @return [Hash] The API response
+      # @return [Peddler::Response] The API response
       def submit_shipment_status_updates(body, rate_limit: 10.0)
         path = "/vendor/directFulfillment/shipping/2021-12-28/shipmentStatusUpdates"
 
@@ -128,7 +128,7 @@ module Peddler
       # @param next_token [String] Used for pagination when there are more orders than the specified result size limit.
       #   The token value is returned in the previous API call.
       # @param rate_limit [Float] Requests per second
-      # @return [Hash] The API response
+      # @return [Peddler::Response] The API response
       def get_customer_invoices(created_after, created_before, ship_from_party_id: nil, limit: nil, sort_order: nil,
         next_token: nil, rate_limit: 10.0)
         path = "/vendor/directFulfillment/shipping/2021-12-28/customerInvoices"
@@ -149,7 +149,7 @@ module Peddler
       # @note This operation can make a dynamic sandbox call.
       # @param purchase_order_number [String] Purchase order number of the shipment for which to return the invoice.
       # @param rate_limit [Float] Requests per second
-      # @return [Hash] The API response
+      # @return [Peddler::Response] The API response
       def get_customer_invoice(purchase_order_number, rate_limit: 10.0)
         path = "/vendor/directFulfillment/shipping/2021-12-28/customerInvoices/#{purchase_order_number}"
 
@@ -171,7 +171,7 @@ module Peddler
       # @param next_token [String] Used for pagination when there are more packing slips than the specified result size
       #   limit. The token value is returned in the previous API call.
       # @param rate_limit [Float] Requests per second
-      # @return [Hash] The API response
+      # @return [Peddler::Response] The API response
       def get_packing_slips(created_after, created_before, ship_from_party_id: nil, limit: nil, sort_order: "ASC",
         next_token: nil, rate_limit: 10.0)
         path = "/vendor/directFulfillment/shipping/2021-12-28/packingSlips"
@@ -192,7 +192,7 @@ module Peddler
       # @note This operation can make a dynamic sandbox call.
       # @param purchase_order_number [String] The purchaseOrderNumber for the packing slip you want.
       # @param rate_limit [Float] Requests per second
-      # @return [Hash] The API response
+      # @return [Peddler::Response] The API response
       def get_packing_slip(purchase_order_number, rate_limit: 10.0)
         path = "/vendor/directFulfillment/shipping/2021-12-28/packingSlips/#{purchase_order_number}"
 

data/lib/peddler/{api → apis}/vendor_direct_fulfillment_shipping_v1.rb

@@ -5,33 +5,33 @@ require "peddler/api"
 module Peddler
   class << self
     def vendor_direct_fulfillment_shipping_v1(...)
-      API::VendorDirectFulfillmentShippingV1.new(...)
+      APIs::VendorDirectFulfillmentShippingV1.new(...)
     end
   end
 
-  class API
+  module APIs
     # Selling Partner API for Direct Fulfillment Shipping
     #
     # The Selling Partner API for Direct Fulfillment Shipping provides programmatic access to a direct fulfillment
     # vendor's shipping data.
     class VendorDirectFulfillmentShippingV1 < API
       # Returns a list of shipping labels created during the time frame that you specify. You define that time frame
-      # using the `createdAfter` and `createdBefore` parameters. You must use both of these parameters. The date range
-      # to search must not be more than 7 days.
+      # using the createdAfter and createdBefore parameters. You must use both of these parameters. The date range to
+      # search must not be more than 7 days.
       #
       # @note This operation can make a static sandbox call.
-      # @param ship_from_party_id [String] The vendor `warehouseId` for order fulfillment. If not specified, the result
+      # @param ship_from_party_id [String] The vendor warehouseId for order fulfillment. If not specified, the result
       #   will contain orders for all warehouses.
       # @param limit [Integer] The limit to the number of records returned.
       # @param created_after [String] Shipping labels that became available after this date and time will be included in
-      #   the result. Must be in {https://developer-docs.amazon.com/sp-api/docs/iso-8601 ISO 8601} date/time format.
+      #   the result. Must be in ISO-8601 date/time format.
       # @param created_before [String] Shipping labels that became available before this date and time will be included
-      #   in the result. Must be in {https://developer-docs.amazon.com/sp-api/docs/iso-8601 ISO 8601} date/time format.
+      #   in the result. Must be in ISO-8601 date/time format.
       # @param sort_order [String] Sort ASC or DESC by order creation date.
       # @param next_token [String] Used for pagination when there are more ship labels than the specified result size
       #   limit. The token value is returned in the previous API call.
       # @param rate_limit [Float] Requests per second
-      # @return [Hash] The API response
+      # @return [Peddler::Response] The API response
       def get_shipping_labels(created_after, created_before, ship_from_party_id: nil, limit: nil, sort_order: "ASC",
         next_token: nil, rate_limit: 10.0)
         path = "/vendor/directFulfillment/shipping/v1/shippingLabels"
@@ -47,25 +47,25 @@ module Peddler
         meter(rate_limit).get(path, params:)
       end
 
-      # Creates a shipping label for a purchase order and returns a `transactionId` for reference.
+      # Creates a shipping label for a purchase order and returns a transactionId for reference.
       #
       # @note This operation can make a static sandbox call.
       # @param body [Hash] Request body containing one or more shipping labels data.
       # @param rate_limit [Float] Requests per second
-      # @return [Hash] The API response
+      # @return [Peddler::Response] The API response
       def submit_shipping_label_request(body, rate_limit: 10.0)
         path = "/vendor/directFulfillment/shipping/v1/shippingLabels"
 
         meter(rate_limit).post(path, body:)
       end
 
-      # Returns a shipping label for the `purchaseOrderNumber` that you specify.
+      # Returns a shipping label for the purchaseOrderNumber that you specify.
       #
       # @note This operation can make a static sandbox call.
       # @param purchase_order_number [String] The purchase order number for which you want to return the shipping label.
-      #   It should be the same `purchaseOrderNumber` as received in the order.
+      #   It should be the same purchaseOrderNumber as received in the order.
       # @param rate_limit [Float] Requests per second
-      # @return [Hash] The API response
+      # @return [Peddler::Response] The API response
       def get_shipping_label(purchase_order_number, rate_limit: 10.0)
         path = "/vendor/directFulfillment/shipping/v1/shippingLabels/#{purchase_order_number}"
 
@@ -77,7 +77,7 @@ module Peddler
       # @note This operation can make a static sandbox call.
       # @param body [Hash] Request body containing the shipment confirmations data.
       # @param rate_limit [Float] Requests per second
-      # @return [Hash] The API response
+      # @return [Peddler::Response] The API response
       def submit_shipment_confirmations(body, rate_limit: 10.0)
         path = "/vendor/directFulfillment/shipping/v1/shipmentConfirmations"
 
@@ -91,7 +91,7 @@ module Peddler
       # @note This operation can make a static sandbox call.
       # @param body [Hash] Request body containing the shipment status update data.
       # @param rate_limit [Float] Requests per second
-      # @return [Hash] The API response
+      # @return [Peddler::Response] The API response
       def submit_shipment_status_updates(body, rate_limit: 10.0)
         path = "/vendor/directFulfillment/shipping/v1/shipmentStatusUpdates"
 
@@ -99,22 +99,22 @@ module Peddler
       end
 
       # Returns a list of customer invoices created during a time frame that you specify. You define the time frame
-      # using the `createdAfter` and `createdBefore` parameters. You must use both of these parameters. The date range
-      # to search must be no more than 7 days.
+      # using the createdAfter and createdBefore parameters. You must use both of these parameters. The date range to
+      # search must be no more than 7 days.
       #
       # @note This operation can make a static sandbox call.
-      # @param ship_from_party_id [String] The vendor `warehouseId` for order fulfillment. If not specified, the result
+      # @param ship_from_party_id [String] The vendor warehouseId for order fulfillment. If not specified, the result
       #   will contain orders for all warehouses.
       # @param limit [Integer] The limit to the number of records returned
       # @param created_after [String] Orders that became available after this date and time will be included in the
-      #   result. Must be in {https://developer-docs.amazon.com/sp-api/docs/iso-8601 ISO 8601} date/time format.
+      #   result. Must be in ISO-8601 date/time format.
       # @param created_before [String] Orders that became available before this date and time will be included in the
-      #   result. Must be in {https://developer-docs.amazon.com/sp-api/docs/iso-8601 ISO 8601} date/time format.
+      #   result. Must be in ISO-8601 date/time format.
       # @param sort_order [String] Sort ASC or DESC by order creation date.
       # @param next_token [String] Used for pagination when there are more orders than the specified result size limit.
       #   The token value is returned in the previous API call.
       # @param rate_limit [Float] Requests per second
-      # @return [Hash] The API response
+      # @return [Peddler::Response] The API response
       def get_customer_invoices(created_after, created_before, ship_from_party_id: nil, limit: nil, sort_order: nil,
         next_token: nil, rate_limit: 10.0)
         path = "/vendor/directFulfillment/shipping/v1/customerInvoices"
@@ -130,12 +130,12 @@ module Peddler
         meter(rate_limit).get(path, params:)
       end
 
-      # Returns a customer invoice based on the `purchaseOrderNumber` that you specify.
+      # Returns a customer invoice based on the purchaseOrderNumber that you specify.
       #
       # @note This operation can make a static sandbox call.
       # @param purchase_order_number [String] Purchase order number of the shipment for which to return the invoice.
       # @param rate_limit [Float] Requests per second
-      # @return [Hash] The API response
+      # @return [Peddler::Response] The API response
       def get_customer_invoice(purchase_order_number, rate_limit: 10.0)
         path = "/vendor/directFulfillment/shipping/v1/customerInvoices/#{purchase_order_number}"
 
@@ -146,18 +146,18 @@ module Peddler
       # must not be more than 7 days.
       #
       # @note This operation can make a static sandbox call.
-      # @param ship_from_party_id [String] The vendor `warehouseId` for order fulfillment. If not specified the result
+      # @param ship_from_party_id [String] The vendor warehouseId for order fulfillment. If not specified the result
       #   will contain orders for all warehouses.
       # @param limit [Integer] The limit to the number of records returned
       # @param created_after [String] Packing slips that became available after this date and time will be included in
-      #   the result. Must be in {https://developer-docs.amazon.com/sp-api/docs/iso-8601 ISO 8601} date/time format.
+      #   the result. Must be in ISO-8601 date/time format.
       # @param created_before [String] Packing slips that became available before this date and time will be included in
-      #   the result. Must be in {https://developer-docs.amazon.com/sp-api/docs/iso-8601 ISO 8601} date/time format.
+      #   the result. Must be in ISO-8601 date/time format.
       # @param sort_order [String] Sort ASC or DESC by packing slip creation date.
       # @param next_token [String] Used for pagination when there are more packing slips than the specified result size
       #   limit. The token value is returned in the previous API call.
       # @param rate_limit [Float] Requests per second
-      # @return [Hash] The API response
+      # @return [Peddler::Response] The API response
       def get_packing_slips(created_after, created_before, ship_from_party_id: nil, limit: nil, sort_order: "ASC",
         next_token: nil, rate_limit: 10.0)
         path = "/vendor/directFulfillment/shipping/v1/packingSlips"
@@ -173,12 +173,12 @@ module Peddler
         meter(rate_limit).get(path, params:)
       end
 
-      # Returns a packing slip based on the `purchaseOrderNumber` that you specify.
+      # Returns a packing slip based on the purchaseOrderNumber that you specify.
       #
       # @note This operation can make a static sandbox call.
-      # @param purchase_order_number [String] The `purchaseOrderNumber` for the packing slip you want.
+      # @param purchase_order_number [String] The purchaseOrderNumber for the packing slip you want.
       # @param rate_limit [Float] Requests per second
-      # @return [Hash] The API response
+      # @return [Peddler::Response] The API response
       def get_packing_slip(purchase_order_number, rate_limit: 10.0)
         path = "/vendor/directFulfillment/shipping/v1/packingSlips/#{purchase_order_number}"
 

data/lib/peddler/{api → apis}/vendor_direct_fulfillment_transactions_2021_12_28.rb

@@ -5,23 +5,23 @@ require "peddler/api"
 module Peddler
   class << self
     def vendor_direct_fulfillment_transactions_2021_12_28(...)
-      API::VendorDirectFulfillmentTransactions20211228.new(...)
+      APIs::VendorDirectFulfillmentTransactions20211228.new(...)
     end
   end
 
-  class API
+  module APIs
     # Selling Partner API for Direct Fulfillment Transaction Status
     #
     # The Selling Partner API for Direct Fulfillment Transaction Status provides programmatic access to a direct
     # fulfillment vendor's transaction status.
     class VendorDirectFulfillmentTransactions20211228 < API
-      # Returns the status of the transaction indicated by the specified `transactionId`.
+      # Returns the status of the transaction indicated by the specified transactionId.
       #
       # @note This operation can make a dynamic sandbox call.
       # @param transaction_id [String] Previously returned in the response to the POST request of a specific
       #   transaction.
       # @param rate_limit [Float] Requests per second
-      # @return [Hash] The API response
+      # @return [Peddler::Response] The API response
       def get_transaction_status(transaction_id, rate_limit: 10.0)
         path = "/vendor/directFulfillment/transactions/2021-12-28/transactions/#{transaction_id}"
 

data/lib/peddler/{api → apis}/vendor_direct_fulfillment_transactions_v1.rb

@@ -5,23 +5,23 @@ require "peddler/api"
 module Peddler
   class << self
     def vendor_direct_fulfillment_transactions_v1(...)
-      API::VendorDirectFulfillmentTransactionsV1.new(...)
+      APIs::VendorDirectFulfillmentTransactionsV1.new(...)
     end
   end
 
-  class API
+  module APIs
     # Selling Partner API for Direct Fulfillment Transaction Status
     #
     # The Selling Partner API for Direct Fulfillment Transaction Status provides programmatic access to a direct
     # fulfillment vendor's transaction status.
     class VendorDirectFulfillmentTransactionsV1 < API
-      # Returns the status of the transaction indicated by the specified `transactionId`.
+      # Returns the status of the transaction indicated by the specified transactionId.
       #
       # @note This operation can make a static sandbox call.
       # @param transaction_id [String] Previously returned in the response to the POST request of a specific
       #   transaction.
       # @param rate_limit [Float] Requests per second
-      # @return [Hash] The API response
+      # @return [Peddler::Response] The API response
       def get_transaction_status(transaction_id, rate_limit: 10.0)
         path = "/vendor/directFulfillment/transactions/v1/transactions/#{transaction_id}"
 

data/lib/peddler/{api → apis}/vendor_invoices_v1.rb

@@ -5,12 +5,12 @@ require "peddler/api"
 module Peddler
   class << self
     def vendor_invoices_v1(...)
-      API::VendorInvoicesV1.new(...)
+      APIs::VendorInvoicesV1.new(...)
     end
   end
 
-  class API
-    # Selling Partner API for Retail Procurement Payments
+  module APIs
+    # Vendor Invoices v1
     #
     # The Selling Partner API for Retail Procurement Payments provides programmatic access to vendors payments data.
     class VendorInvoicesV1 < API
@@ -19,7 +19,7 @@ module Peddler
       # @note This operation can make a static sandbox call.
       # @param body [Hash] The request body containing the invoice data to submit.
       # @param rate_limit [Float] Requests per second
-      # @return [Hash] The API response
+      # @return [Peddler::Response] The API response
       def submit_invoices(body, rate_limit: 10.0)
         path = "/vendor/payments/v1/invoices"
 

data/lib/peddler/{api → apis}/vendor_orders_v1.rb

@@ -5,11 +5,11 @@ require "peddler/api"
 module Peddler
   class << self
     def vendor_orders_v1(...)
-      API::VendorOrdersV1.new(...)
+      APIs::VendorOrdersV1.new(...)
     end
   end
 
-  class API
+  module APIs
     # Selling Partner API for Retail Procurement Orders
     #
     # The Selling Partner API for Retail Procurement Orders provides programmatic access to vendor orders data.
@@ -47,7 +47,7 @@ module Peddler
       #   purchase orders for all of the vendor codes that exist in the vendor group used to authorize the API client
       #   application are returned.
       # @param rate_limit [Float] Requests per second
-      # @return [Hash] The API response
+      # @return [Peddler::Response] The API response
       def get_purchase_orders(limit: nil, created_after: nil, created_before: nil, sort_order: nil, next_token: nil,
         include_details: nil, changed_after: nil, changed_before: nil, po_item_state: nil, is_po_changed: nil,
         purchase_order_state: nil, ordering_vendor_code: nil, rate_limit: 10.0)
@@ -76,7 +76,7 @@ module Peddler
       # @param purchase_order_number [String] The purchase order identifier for the order that you want. Formatting
       #   Notes: 8-character alpha-numeric code.
       # @param rate_limit [Float] Requests per second
-      # @return [Hash] The API response
+      # @return [Peddler::Response] The API response
       def get_purchase_order(purchase_order_number, rate_limit: 10.0)
         path = "/vendor/orders/v1/purchaseOrders/#{purchase_order_number}"
 
@@ -86,9 +86,9 @@ module Peddler
       # Submits acknowledgements for one or more purchase orders.
       #
       # @note This operation can make a static sandbox call.
-      # @param body [Hash]
+      # @param body [Hash] Submits acknowledgements for one or more purchase orders from a vendor.
       # @param rate_limit [Float] Requests per second
-      # @return [Hash] The API response
+      # @return [Peddler::Response] The API response
       def submit_acknowledgement(body, rate_limit: 10.0)
         path = "/vendor/orders/v1/acknowledgements"
 
@@ -130,7 +130,7 @@ module Peddler
       #   If not included in filter, this will return purchase orders for all the buyer's warehouses used for vendor
       #   group purchase orders.
       # @param rate_limit [Float] Requests per second
-      # @return [Hash] The API response
+      # @return [Peddler::Response] The API response
       def get_purchase_orders_status(limit: nil, sort_order: nil, next_token: nil, created_after: nil,
         created_before: nil, updated_after: nil, updated_before: nil, purchase_order_number: nil,
         purchase_order_status: nil, item_confirmation_status: nil, item_receive_status: nil, ordering_vendor_code: nil,

data/lib/peddler/{api → apis}/vendor_shipments_v1.rb

@@ -5,12 +5,12 @@ require "peddler/api"
 module Peddler
   class << self
     def vendor_shipments_v1(...)
-      API::VendorShipmentsV1.new(...)
+      APIs::VendorShipmentsV1.new(...)
     end
   end
 
-  class API
-    # Selling Partner API for Retail Procurement Shipments
+  module APIs
+    # Vendor Shipments v1
     #
     # The Selling Partner API for Retail Procurement Shipments provides programmatic access to retail shipping data for
     # vendors.
@@ -20,7 +20,7 @@ module Peddler
       # @note This operation can make a static sandbox call.
       # @param body [Hash] A request to submit shipment confirmation.
       # @param rate_limit [Float] Requests per second
-      # @return [Hash] The API response
+      # @return [Peddler::Response] The API response
       def submit_shipment_confirmations(body, rate_limit: 10.0)
         path = "/vendor/shipping/v1/shipmentConfirmations"
 
@@ -31,7 +31,7 @@ module Peddler
       #
       # @param body [Hash] A request to submit shipment request.
       # @param rate_limit [Float] Requests per second
-      # @return [Hash] The API response
+      # @return [Peddler::Response] The API response
       def submit_shipments(body, rate_limit: 10.0)
         cannot_sandbox!
 
@@ -87,7 +87,7 @@ module Peddler
       # @param seller_warehouse_code [String] Get Shipping Details based on vendor warehouse code. This value should be
       #   same as 'sellingParty.partyId' in the Shipment.
       # @param rate_limit [Float] Requests per second
-      # @return [Hash] The API response
+      # @return [Peddler::Response] The API response
       def get_shipment_details(limit: nil, sort_order: nil, next_token: nil, created_after: nil, created_before: nil,
         shipment_confirmed_before: nil, shipment_confirmed_after: nil, package_label_created_before: nil,
         package_label_created_after: nil, shipped_before: nil, shipped_after: nil, estimated_delivery_before: nil,

data/lib/peddler/{api → apis}/vendor_transaction_status_v1.rb

@@ -5,11 +5,11 @@ require "peddler/api"
 module Peddler
   class << self
     def vendor_transaction_status_v1(...)
-      API::VendorTransactionStatusV1.new(...)
+      APIs::VendorTransactionStatusV1.new(...)
     end
   end
 
-  class API
+  module APIs
     # Selling Partner API for Retail Procurement Transaction Status
     #
     # The Selling Partner API for Retail Procurement Transaction Status provides programmatic access to status
@@ -20,7 +20,7 @@ module Peddler
       # @param transaction_id [String] The GUID provided by Amazon in the 'transactionId' field in response to the post
       #   request of a specific transaction.
       # @param rate_limit [Float] Requests per second
-      # @return [Hash] The API response
+      # @return [Peddler::Response] The API response
       def get_transaction(transaction_id, rate_limit: 10.0)
         cannot_sandbox!
 

data/lib/peddler/endpoint.rb

@@ -27,14 +27,14 @@ module Peddler
           raise ArgumentError, "#{aws_region} not found"
         end
 
-        new(**values.merge(aws_region: aws_region))
+        new(**values, aws_region: aws_region)
       end
 
       def find_by_selling_region(selling_region)
         aws_region, values = ENDPOINTS.find { |_, v| v[:selling_region] == selling_region } ||
           raise(ArgumentError, "#{selling_region} not found")
 
-        new(**values.merge(aws_region: aws_region))
+        new(**values, aws_region: aws_region)
       end
     end
 

data/lib/peddler/error.rb

@@ -2,30 +2,39 @@
 
 module Peddler
   class Error < StandardError
-    class InvalidInput < Error; end
-    class NotFound < Error; end
-    class QuotaExceeded < Error; end
-    class Unauthorized < Error; end
-
-    attr_reader :cause
+    attr_reader :response
 
     # @!visibility private
     class << self
       def build(response)
         error = JSON.parse(response).dig("errors").first
         class_name = error.dig("code")
-        klass = const_get(class_name)
+        message = error.dig("message")
+        klass = if Errors.const_defined?(class_name)
+          Errors.const_get(class_name)
+        else
+          Errors.const_set(
+            class_name,
+            Class.new(Error),
+          )
+        end
 
-        klass.new(error.dig("message"), response)
+        klass.new(message, response)
       rescue NameError
-        const_set(class_name, Class.new(Error))
-        retry
+        # Do nothing if code cannot be converted to a class name
       end
     end
 
-    def initialize(msg = nil, cause = nil)
-      @cause = cause
+    def initialize(msg = nil, response = nil)
+      @response = response
       super(msg)
     end
   end
+
+  module Errors
+    class InvalidInput < Error; end
+    class NotFound < Error; end
+    class QuotaExceeded < Error; end
+    class Unauthorized < Error; end
+  end
 end

data/lib/peddler/helpers/feeds_2021_06_30.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+module Peddler
+  module Helpers
+    module Feeds20210630
+      # Uploads feed_content to a signed upload_url previously provided by
+      # create_feed_document. The upload_url is signed, the Host and content-type
+      # headers must match the signing.
+      # @param upload_url [String] The signed url from the `create_feed_document` response.
+      # @param feed_content [String] The body of the content to upload.
+      # @param content_type [String] The content type of the upload,
+      # this must match the content-type requested in `create_feed_document`
+      # @return [HTTP::Response] The API response
+      def upload_feed_document(upload_url, feed_content, content_type)
+        response = HTTP.headers("content-type" => content_type).put(upload_url, body: feed_content)
+
+        if response.status.client_error?
+          error = Error.build(response)
+          raise error if error
+        end
+
+        response
+      end
+    end
+  end
+end

data/lib/peddler/json_feed_document.rb

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+module Peddler
+  class JSONFeedDocument
+    CONTENT_TYPE = "application/json; charset=UTF-8"
+
+    def upload(content)
+      # While HTTPrb already sets the content-type, Amazon server seems to fail if we don't explicitly set it again
+      # here. A bit of a mystery; maybe it's the order of the headers that's screwing things up on their end?
+      HTTP.headers("Content-Type" => CONTENT_TYPE).put(url, json: content)
+    end
+
+    def initialize(api)
+      @api = api
+    end
+
+    def id
+      metadata.fetch("id")
+    end
+
+    def url
+      metadata.fetch("url")
+    end
+
+    private
+
+    def metadata
+      @metadata ||= @api.create_feed_document({ "contentType" => CONTENT_TYPE }).parse
+    end
+  end
+end