peddler 5.3.1 → 5.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 39a668305211189b981586a66d71362c7f641c50f6ccacf3a28172a4abb8e696
-  data.tar.gz: 68366d3f5f419c79062854e75d00ac37dfcb82098fa5660d17f56a60ebb893d2
+  metadata.gz: ea43bac8eb39d36256c21f7fa3f2b1db30878a89d1e9d3545dcd637ec420c503
+  data.tar.gz: 4fc3347ad7d0ce503f9551f781285ec8ad0558a27e17f0cfdf6bf69e63f0642a
 SHA512:
-  metadata.gz: dec0fa29e3b3a30a23ba120145c5baa6c98ef90b105727fba91daab9ae621393d3ab9f15aa515b2e25ed4f4c332c503b3429781d5ba1e7d0c6f425416318ce8b
-  data.tar.gz: f729c59ad31e1cc10fdb782cdccc1c749e7f7ad62b587d4beb31054569517bb185329f0d0e2f46d604543fe7e4436c5ed81bea931dec53e7d7d2acc34696f2d9
+  metadata.gz: 86af994dfeaf305576af803e1e885cdc3f8e39b7ed70734e80aa89a4fcae5c63c351299bdd25af6096383d17263b54dcc40d90cfea3e8a625e6eb002ccd51c16
+  data.tar.gz: 8c977d54bba2653f97f7508bbfa397a1c2f8dbe2be8d0d4d371163e9b17d1b73e1d040b75d652271631f56fa20f4ed775e68ad8b4120fa30a2047d70a0f142d6

data/README.md

@@ -1,29 +1,31 @@
 # Peddler
 
-[![Build](https://github.com/lineofflight/peddler/actions/workflows/ci.yml/badge.svg)][build]
-
 Peddler is a Ruby interface to the [Amazon Selling Partner API (SP-API)][api-docs]. The SP-API enables Amazon sellers and vendors to programmatically access their data on orders, shipments, payments, and more.
 
-Peddler is automatically generated from the latest Open API models provided by Amazon.
+Peddler is automatically generated from the latest Open API models provided by Amazon. A nightly job tracks Amazon's spec changes, so new endpoints and fields land shortly after Amazon publishes them. Model changes are not considered breaking and don't trigger a major version bump.
 
 Peddler covers all SP-API endpoints, reports, notifications, and feeds. It's also lightweight: thanks to Zeitwerk, only the code you use gets loaded.
 
-To begin using the Amazon SP-API, you must [register as a developer][register-as-developer] and [register your application][register-application]. Once registered, [obtain your Login with Amazon (LWA) credentials][view-credentials] to access your own or other selling partners' data.
-
-- [API docs][api-docs]
-- [OpenAPI models][openapi-models]
-- [API samples][api-samples]
-
 <img src="https://github.com/hakanensari/peddler/blob/main/images/peddler.jpg?raw=true" alt="Peddler" style="max-width: 830px" />
 
 ## Installation
 
 Add to your Gemfile.
 
+### Agent skill
+
+If you use a coding agent, install the peddler skill for SP-API spec research and Ruby usage help:
+
+```shell
+npx skills add lineofflight/peddler
+```
+
 ## Usage
 
 ### Authorization
 
+Before using Peddler, you must [register as a developer][register-as-developer], [register your application][register-application], and [obtain your Login with Amazon (LWA) credentials][view-credentials]; Amazon's [official SP-API code samples][api-samples] can help you get started.
+
 Set your LWA credentials in your environment.
 
 ```shell
@@ -85,6 +87,48 @@ class Seller
 end
 ```
 
+### Restricted Data Tokens (RDT) and PII
+
+Some operations are restricted because they return Personally Identifiable Information (PII), such as a buyer's name and shipping address. To call one, exchange your access token for a Restricted Data Token (RDT) scoped to the specific resources you need, then pass the RDT in place of the access token.
+
+```ruby
+api = Peddler.tokens.new(aws_region, access_token)
+response = api.create_restricted_data_token({
+  "restrictedResources" => [
+    {
+      "method" => "GET",
+      "path" => "/orders/v0/orders/123-1234567-1234567/address",
+    },
+  ],
+})
+restricted_data_token = response.parse.restricted_data_token
+```
+
+Use the RDT exactly where you would normally pass the access token.
+
+```ruby
+api = Peddler.orders.new(aws_region, restricted_data_token)
+address = api.get_order_address("123-1234567-1234567").parse.payload.shipping_address
+```
+
+For the Orders API, also specify which `dataElements` you need (`buyerInfo`, `shippingAddress`, or `buyerTaxInformation`).
+
+```ruby
+api = Peddler.tokens.new(aws_region, access_token)
+response = api.create_restricted_data_token({
+  "restrictedResources" => [
+    {
+      "method" => "GET",
+      "path" => "/orders/v0/orders",
+      "dataElements" => ["buyerInfo", "shippingAddress"],
+    },
+  ],
+})
+restricted_data_token = response.parse.restricted_data_token
+```
+
+An RDT is valid for one hour. Like access tokens, cache and reuse it across calls. See the [Tokens API Use Case Guide][tokens-guide] for the full list of restricted operations.
+
 ### Rate limiting
 
 Amazon's SP-API imposes [rate limits][rate-limits] on operations. Override the default value by passing a `:rate_limit` parameter when calling an operation.
@@ -309,8 +353,7 @@ bundle exec rake generate
 # Type check with Steep
 bundle exec steep check --severity-level=hint
 ```
-[build]: https://github.com/lineofflight/peddler/actions
-[api-docs]: https://developer.amazonservices.com/sp-api-docs/overview
+[api-docs]: https://developer-docs.amazon.com/sp-api/docs/welcome
 [register-as-developer]: https://developer-docs.amazon.com/sp-api/docs/registering-as-a-developer
 [register-application]: https://developer-docs.amazon.com/sp-api/docs/registering-your-application
 [openapi-models]: https://github.com/amzn/selling-partner-api-models
@@ -318,4 +361,5 @@ bundle exec steep check --severity-level=hint
 [view-credentials]: https://developer-docs.amazon.com/sp-api/docs/viewing-your-application-information-and-credentials
 [authorization]: https://developer-docs.amazon.com/sp-api/docs/authorizing-selling-partner-api-applications
 [rate-limits]: https://developer-docs.amazon.com/sp-api/docs/usage-plans-and-rate-limits
+[tokens-guide]: https://developer-docs.amazon.com/sp-api/docs/tokens-api-use-case-guide
 [httprb]: https://github.com/httprb/http

data/lib/peddler/api.rb

@@ -24,7 +24,7 @@ module Peddler
     # @param [String] access_token The access token for authentication
     # @param [Integer] retries The number of retries if throttled (default: 0)
     # @param [HTTP::Client] http HTTP client
-    def initialize(aws_region, access_token, retries: 0, http: HTTP)
+    def initialize(aws_region, access_token, retries: 0, http: HTTP::Client.new)
       @endpoint = Endpoint.find(aws_region)
       @access_token = access_token
       @retries = retries
@@ -53,7 +53,7 @@ module Peddler
 
     # @see https://developer-docs.amazon.com/sp-api/docs/include-a-user-agent-header-in-all-requests
     # @see https://developer-docs.amazon.com/amazon-shipping/docs/connecting-to-the-selling-partner-api#step-3-add-headers-to-the-uri
-    # @return [HTTP::Client]
+    # @return [HTTP::Session]
     def http(rate_limit: nil)
       client = @http.headers(
         "Host" => endpoint_uri.host,
@@ -65,7 +65,7 @@ module Peddler
       return client if retries.zero? || rate_limit.nil?
 
       delay = sandbox? ? 0.2 : 1.0 / rate_limit
-      client.retriable(delay:, tries: retries + 1, retry_statuses: [429]) # steep:ignore NoMethod
+      client.retriable(delay:, tries: retries + 1, retry_statuses: [429])
     end
 
     private

data/lib/peddler/apis/external_fulfillment_shipments_2024_09_11/address.rb

@@ -40,7 +40,10 @@ module Peddler
         # @return [String] The email address of the contact associated with the address.
         attribute?(:email, String)
 
-        # @return [String] The municiplaity where the person, business, or institution is located.
+        # @return [Geocodes] The geographic coordinates of the address.
+        attribute?(:geocodes, Geocodes)
+
+        # @return [String] The municipality where the person, business, or institution is located.
         attribute?(:municipality, String)
 
         # @return [String] The name of the person, business or institution at that address.

data/lib/peddler/apis/external_fulfillment_shipments_2024_09_11/distance.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+# This file is generated. Do not edit.
+
+require "structure"
+
+module Peddler
+  module APIs
+    class ExternalFulfillmentShipments20240911
+      # A distance measurement.
+      Distance = Structure.new do
+        # @return [String] The unit of measurement of the distance.
+        attribute(:distance_unit, String, null: false, from: "distanceUnit")
+
+        # @return [String] The numerical value of the distance.
+        attribute(:value, String, null: false)
+      end
+    end
+  end
+end

data/lib/peddler/apis/external_fulfillment_shipments_2024_09_11/geocodes.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+# This file is generated. Do not edit.
+
+require "structure"
+
+module Peddler
+  module APIs
+    class ExternalFulfillmentShipments20240911
+      # Geographic coordinates.
+      Geocodes = Structure.new do
+        # @return [String] The latitude coordinate.
+        attribute(:latitude, String, null: false)
+
+        # @return [String] The longitude coordinate.
+        attribute(:longitude, String, null: false)
+
+        # @return [String] The elevation in meters.
+        attribute?(:elevation, String)
+      end
+    end
+  end
+end

data/lib/peddler/apis/external_fulfillment_shipments_2024_09_11/handover_location.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+# This file is generated. Do not edit.
+
+require "structure"
+
+module Peddler
+  module APIs
+    class ExternalFulfillmentShipments20240911
+      # The drop-off location details for package handover.
+      HandoverLocation = Structure.new do
+        # @return [Address] The address of the drop-off location.
+        attribute?(:address, Address)
+
+        # @return [Distance] The distance from the seller's location to the drop-off point.
+        attribute?(:distance, Distance)
+
+        # @return [String] URL to the map that shows the drop-off location.
+        attribute?(:map_url, String, from: "mapUrl")
+      end
+    end
+  end
+end

data/lib/peddler/apis/external_fulfillment_shipments_2024_09_11/ship_label_metadata.rb

@@ -16,6 +16,10 @@ module Peddler
         # @return [String] The tracking number of the package.
         attribute(:tracking_id, String, null: false, from: "trackingId")
 
+        # @return [HandoverLocation] The drop-off location details. This value is populated when `handoverMethod` is
+        #   `DROPOFF`.
+        attribute?(:handover_location, HandoverLocation, from: "handoverLocation")
+
         # @return [TimeWindow] The time window during which the package was picked up.
         attribute?(:pickup_window, TimeWindow, from: "pickupWindow")
 

data/lib/peddler/apis/external_fulfillment_shipments_2024_09_11/shipment_info.rb

@@ -33,6 +33,9 @@ module Peddler
         #   either `REPLACEMENT` or `EXCHANGE`.
         attribute?(:original_shipment_info, ReplacedShipmentInfo, from: "originalShipmentInfo")
 
+        # @return [String] The payment method for the shipment.
+        attribute?(:payment_method, String, from: "paymentMethod")
+
         # @return [String] The source of the order operation.
         attribute?(:processing_source, String, from: "processingSource")
       end

data/lib/peddler/apis/external_fulfillment_shipments_2024_09_11/shipping_options.rb

@@ -19,6 +19,10 @@ module Peddler
         # @return [String] The carrier name for the offering.
         attribute?(:carrier_name, String, from: "carrierName")
 
+        # @return [HandoverLocation] The drop-off location details. This value is populated when `handoverMethod` is
+        #   `DROPOFF`.
+        attribute?(:handover_location, HandoverLocation, from: "handoverLocation")
+
         # @return [TimeWindow] The time window during which the package will be picked up.
         attribute?(:pickup_window, TimeWindow, from: "pickupWindow")
 

data/lib/peddler/apis/external_fulfillment_shipments_2024_09_11.rb

@@ -21,7 +21,7 @@ module Peddler
       #   marketplace, refer to [Marketplace IDs](https://developer-docs.amazon.com/sp-api/docs/marketplace-ids).
       # @param channel_name [String] The channel name associated with the location.
       # @param status [String] The status of shipment you want to include in the response. To retrieve all new
-      #   shipments, set this value to `ACCEPTED`.
+      #   shipments, set this value to `CREATED` or `ACCEPTED`.
       # @param last_updated_after [String] The response includes shipments whose latest update is after the specified
       #   time. In [ISO 8601](https://developer-docs.amazon.com/sp-api/docs/iso-8601) date-time format.
       # @param last_updated_before [String] The response includes shipments whose latest update is before the specified

data/lib/peddler/apis/feeds_2021_06_30.rb

@@ -105,12 +105,18 @@ module Peddler
       #
       # @note This operation can make a static sandbox call.
       # @param feed_document_id [String] The identifier of the feed document.
+      # @param enable_content_encoding_url_header [Boolean] When `true`, the Content-Encoding header on the returned URL
+      #   is set to `gzip` instead of the default `identity` when `compressionAlgorithm` is `GZIP`. This allows
+      #   automatic decompression by HTTP clients.
       # @param rate_limit [Float] Requests per second
       # @return [Peddler::Response] The API response
-      def get_feed_document(feed_document_id, rate_limit: 0.0222)
+      def get_feed_document(feed_document_id, enable_content_encoding_url_header: nil, rate_limit: 0.0222)
         path = "/feeds/2021-06-30/documents/#{percent_encode(feed_document_id)}"
+        params = {
+          "enableContentEncodingUrlHeader" => enable_content_encoding_url_header,
+        }.compact
         parser = -> { FeedDocument }
-        get(path, rate_limit:, parser:)
+        get(path, params:, rate_limit:, parser:)
       end
     end
   end

data/lib/peddler/apis/fulfillment_outbound_2020_07_01/amount.rb

@@ -7,12 +7,12 @@ require "structure"
 module Peddler
   module APIs
     class FulfillmentOutbound20200701
-      # A quantity based on unit of measure.
+      # A quantity based on the specified unit of measurement.
       Amount = Structure.new do
         # @return [String] The unit of measure for the amount.
         attribute(:unit_of_measure, String, null: false, from: "unitOfMeasure")
 
-        # @return [String] The amount of a product in the associated unit of measure.
+        # @return [String] The amount of a product in the associated unit of measurement.
         attribute(:value, String, null: false)
       end
     end

data/lib/peddler/apis/fulfillment_outbound_2020_07_01/delivery_document.rb

@@ -12,8 +12,8 @@ module Peddler
         # @return [String] The delivery document type. The only possible value is `DELIVERY_IMAGE`.
         attribute(:document_type, String, null: false, from: "documentType")
 
-        # @return [String] A URL that you can use to download the document. This URL has a `Content-Type` header. Note
-        #   that the URL expires after one hour. To get a new URL, you must call the API again.
+        # @return [String] A URL that is valid for one hour to download the document. In case of URL expiry, call the
+        #   API again to get a new url. The URL will have a Content-Type header.
         attribute?(:url, String)
       end
     end

data/lib/peddler/apis/fulfillment_outbound_2020_07_01/delivery_information.rb

@@ -7,7 +7,8 @@ require "structure"
 module Peddler
   module APIs
     class FulfillmentOutbound20200701
-      # The delivery information for the package. This information is available after the package is delivered.
+      # The delivery information of the package, this information is only available post package delivery to its
+      # intended destination.
       DeliveryInformation = Structure.new do
         # @return [Array<DeliveryDocument>] All of the delivery documents for a package.
         attribute?(:delivery_document_list, [DeliveryDocument], from: "deliveryDocumentList")

data/lib/peddler/apis/fulfillment_outbound_2020_07_01/delivery_preferences.rb

@@ -14,7 +14,7 @@ module Peddler
       # door, unless you specify otherwise.
       DeliveryPreferences = Structure.new do
         # @return [String] Additional delivery instructions. For example, this could be instructions on how to enter a
-        #   building, nearby landmark or navigation instructions, 'Beware of dogs', etc.
+        #   building, nearby landmark or navigation instructions, or `Beware of dogs`.
         attribute?(:delivery_instructions, String, from: "deliveryInstructions")
 
         # @return [DropOffLocation] The preferred location to leave packages at the destination address.

data/lib/peddler/apis/fulfillment_outbound_2020_07_01/delivery_window.rb

@@ -10,12 +10,11 @@ module Peddler
       # The time range within which a Scheduled Delivery fulfillment order should be delivered. This is only available
       # in the JP marketplace.
       DeliveryWindow = Structure.new do
-        # @return [String] The date and time of the end of the Scheduled Delivery window. Must be in
-        #   {https://developer-docs.amazon.com/sp-api/docs/iso-8601 ISO 8601} format.
+        # @return [String] The date and time of the end of the Scheduled Delivery window, in ISO 8601 date time format.
         attribute(:end_date, String, null: false, from: "endDate")
 
-        # @return [String] The date and time of the start of the Scheduled Delivery window. Must be in
-        #   {https://developer-docs.amazon.com/sp-api/docs/iso-8601 ISO 8601} format.
+        # @return [String] The date and time of the start of the Scheduled Delivery window, in ISO 8601 date time
+        #   format.
         attribute(:start_date, String, null: false, from: "startDate")
       end
     end

data/lib/peddler/apis/fulfillment_outbound_2020_07_01/drop_off_location.rb

@@ -7,17 +7,19 @@ require "structure"
 module Peddler
   module APIs
     class FulfillmentOutbound20200701
-      # The preferred location to leave packages at the destination address.
+      # The drop-off location at the destination address.
       DropOffLocation = Structure.new do
-        # @return [String] Specifies the preferred location to leave the package at the destination address.
+        # @return [String] The drop-off location type at the destination address.
         attribute(:type, String, null: false)
 
-        # @return [Hash] Additional information about the drop-off location that can vary depending on the type of
-        #   drop-off location specified in the `type` field.
-        # If the `type` is set to `FALLBACK_NEIGHBOR_DELIVERY`, the `attributes` object should include the exact keys
+        # @return [Hash] Additional information about the drop-off location. This information can vary depending on the
+        #   type of drop-off location specified in the `type` field.
+        #
+        # If the `type` is set to `FALLBACK_NEIGHBOR_DELIVERY`, the `attributes` object must include the keys
         #   `neighborName` and `houseNumber` to provide the name and house number of the designated neighbor.
-        # For `RECEPTIONIST`, `MAIL_ROOM_CLERK`, and `AS_INSTRUCTED` types, the `attributes` object will include a
-        #   `recipientName` field containing the name of the person who received the package.
+        #
+        # For `RECEPTIONIST` type, the `attributes` object may include a `recipientName` field that contains the name of
+        #   the person who received or will receive the package.
         attribute?(:attributes, Hash)
       end
     end

data/lib/peddler/apis/fulfillment_outbound_2020_07_01/feature_settings.rb

@@ -13,7 +13,9 @@ module Peddler
       # orders and increase the risk of some of your orders being unfulfilled or delivered late if there are no
       # alternative carriers available. Using `BLOCK_AMZL` in an order request will take precedence over your Seller
       # Central account setting. To ship in non-Amazon branded packaging (blank boxes), set `featureName` to
-      # `BLANK_BOX`. To require a signature from the recipient upon delivery, set `featureName` to
+      # `BLANK_BOX`. To require items to be shipped in an overbox rather than in their original product packaging, set
+      # `featureName` to `OVERBOX`. To require a packing slip to be included with the order, set `featureName` to
+      # `PACKING_SLIP`. To require a signature from the recipient upon delivery, set `featureName` to
       # `SIGNATURE_CONFIRMATION`. Note that using signature confirmation features will incur additional fees on MCF
       # orders and are currently supported only in the US marketplace. To ensure all items in an order are delivered
       # together, set `featureName` to `DELIVER_TOGETHER`.
@@ -28,6 +30,8 @@ module Peddler
         #   unfulfilled or delayed deliveries if alternative carriers are unavailable. Using `BLOCK_AMZL` in an order
         #   request will take precedence over your Seller Central account setting.
         # - `BLANK_BOX`: Ships orders in non-Amazon branded packaging (blank boxes).
+        # - `OVERBOX`: Requires items to be shipped in an overbox rather than in their original product packaging.
+        # - `PACKING_SLIP`: Requires a packing slip to be included with the order.
         # - `SIGNATURE_CONFIRMATION`: Requires a signature from the recipient upon delivery.
         # - Note: Using signature confirmation features will incur additional fees on MCF orders and are currently
         #   supported only in the US marketplace.

data/lib/peddler/apis/fulfillment_outbound_2020_07_01/feature_sku.rb

@@ -19,7 +19,7 @@ module Peddler
         # @return [Array<String>] Other seller SKUs that are shared across the same inventory.
         attribute?(:overlapping_skus, [String], from: "overlappingSkus")
 
-        # @return [String] Used to identify an item in the given marketplace. `SellerSKU` is qualified by the seller's
+        # @return [String] Used to identify an item in the given marketplace. SellerSKU is qualified by the seller's
         #   SellerId, which is included with every operation that you submit.
         attribute?(:seller_sku, String, from: "sellerSku")
 

data/lib/peddler/apis/fulfillment_outbound_2020_07_01/fulfillment_order.rb

@@ -39,8 +39,8 @@ module Peddler
         # @return [String]
         attribute(:shipping_speed_category, String, null: false, from: "shippingSpeedCategory")
 
-        # @return [String] The date and time that the status of the fulfillment order last changed. Must be in
-        #   {https://developer-docs.amazon.com/sp-api/docs/iso-8601 ISO 8601} format.
+        # @return [String] The date and time that the status of the fulfillment order last changed, in ISO 8601 date
+        #   time format.
         attribute(:status_updated_date, String, null: false, from: "statusUpdatedDate")
 
         # @return [CODSettings]

data/lib/peddler/apis/fulfillment_outbound_2020_07_01/fulfillment_preview_shipment.rb

@@ -15,16 +15,16 @@ module Peddler
         # @return [String] The earliest date that the shipment is expected to arrive at its destination.
         attribute?(:earliest_arrival_date, String, from: "earliestArrivalDate")
 
-        # @return [String] The earliest date that the shipment is expected to be sent from the fulfillment center. Must
-        #   be in {https://developer-docs.amazon.com/sp-api/docs/iso-8601 ISO 8601} format.
+        # @return [String] The earliest date that the shipment is expected to be sent from the fulfillment center, in
+        #   ISO 8601 date time format.
         attribute?(:earliest_ship_date, String, from: "earliestShipDate")
 
-        # @return [String] The latest date that the shipment is expected to arrive at its destination. Must be in
-        #   {https://developer-docs.amazon.com/sp-api/docs/iso-8601 ISO 8601} format.
+        # @return [String] The latest date that the shipment is expected to arrive at its destination, in ISO 8601 date
+        #   time format.
         attribute?(:latest_arrival_date, String, from: "latestArrivalDate")
 
-        # @return [String] The latest date that the shipment is expected to be sent from the fulfillment center. Must be
-        #   in {https://developer-docs.amazon.com/sp-api/docs/iso-8601 ISO 8601} format.
+        # @return [String] The latest date that the shipment is expected to be sent from the fulfillment center, in ISO
+        #   8601 date time format.
         attribute?(:latest_ship_date, String, from: "latestShipDate")
 
         # @return [Array<String>] Provides additional insight into the shipment timeline when exact delivery dates are

data/lib/peddler/apis/fulfillment_outbound_2020_07_01/fulfillment_shipment_package.rb

@@ -19,12 +19,11 @@ module Peddler
         #   delivery information.
         attribute?(:amazon_fulfillment_tracking_number, String, from: "amazonFulfillmentTrackingNumber")
 
-        # @return [DeliveryInformation] The delivery information for the package. This information is available after
-        #   the package is delivered.
+        # @return [DeliveryInformation] The delivery information of the package, this information is only available post
+        #   package delivery to its intended destination.
         attribute?(:delivery_information, DeliveryInformation, from: "deliveryInformation")
 
-        # @return [String] The estimated arrival date and time of the package. Must be in
-        #   {https://developer-docs.amazon.com/sp-api/docs/iso-8601 ISO 8601} format.
+        # @return [String] The estimated arrival date and time of the package, in ISO 8601 date time format.
         attribute?(:estimated_arrival_date, String, from: "estimatedArrivalDate")
 
         # @return [LockerDetails] The locker details, if provided can be used to access locker delivery box.

data/lib/peddler/apis/fulfillment_outbound_2020_07_01/get_feature_inventory_response.rb

@@ -9,7 +9,7 @@ module Peddler
     class FulfillmentOutbound20200701
       # The breakdown of eligibility inventory by feature.
       GetFeatureInventoryResponse = Structure.new do
-        # @return [Array<Error>] One or more unexpected errors occurred during the `getFeatureInventory` operation.
+        # @return [Array<Error>] One or more unexpected errors occurred during the getFeatureInventory operation.
         attribute?(:errors, [Error])
 
         # @return [GetFeatureInventoryResult]

data/lib/peddler/apis/fulfillment_outbound_2020_07_01/get_feature_sku_result.rb

@@ -18,6 +18,12 @@ module Peddler
         # @return [String] The requested marketplace.
         attribute(:marketplace_id, String, null: false, from: "marketplaceId")
 
+        # @return [String] The Amazon Standard Identification Number (ASIN) of the item.
+        attribute?(:asin, String)
+
+        # @return [String] The unique SKU used by Amazon's fulfillment network.
+        attribute?(:fn_sku, String, from: "fnSku")
+
         # @return [Array<String>] A list of one or more reasons that the seller SKU is ineligible for the feature.
         #
         # Possible values:
@@ -26,9 +32,12 @@ module Peddler
         # * `INVALID_SKU`: There is an issue with the SKU provided.
         attribute?(:ineligible_reasons, [String], from: "ineligibleReasons")
 
-        # @return [FeatureSKU] Information about the SKU, including the count available, identifiers, and a list of
-        #   overlapping SKUs that share the same inventory pool.
-        attribute?(:sku_info, FeatureSKU, from: "skuInfo")
+        # @return [String] Used to identify an item in the given marketplace. SellerSKU is qualified by the seller's
+        #   SellerId, which is included with every operation that you submit.
+        attribute?(:seller_sku, String, from: "sellerSku")
+
+        # @return [Float] The number of SKUs available for this service.
+        attribute?(:sku_count, Float, from: "skuCount")
       end
     end
   end

data/lib/peddler/apis/fulfillment_outbound_2020_07_01/origin.rb

@@ -9,7 +9,8 @@ module Peddler
     class FulfillmentOutbound20200701
       # The origin for the delivery offer.
       Origin = Structure.new do
-        # @return [String] The two digit country code the items should ship from. In ISO 3166-1 alpha-2 format.
+        # @return [String] The two-digit country code (in ISO 3166-1 alpha-2 format) for the country where the items
+        #   will ship from.
         attribute(:country_code, String, null: false, from: "countryCode")
       end
     end

data/lib/peddler/apis/fulfillment_outbound_2020_07_01/tracking_event.rb

@@ -15,8 +15,7 @@ module Peddler
         # @return [String] The event code for the delivery event.
         attribute(:event_code, String, null: false, from: "eventCode")
 
-        # @return [String] The date and time that the delivery event took place. Must be in
-        #   {https://developer-docs.amazon.com/sp-api/docs/iso-8601 ISO 8601} format.
+        # @return [String] The date and time that the delivery event took place, in ISO 8601 date time format.
         attribute(:event_date, String, null: false, from: "eventDate")
 
         # @return [String] A description for the corresponding event code.

data/lib/peddler/apis/orders_2026_01_01/associated_order_item.rb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+# This file is generated. Do not edit.
+
+require "structure"
+
+module Peddler
+  module APIs
+    class Orders20260101
+      # An associated order item that a customer has purchased with the product. For example, a tire installation
+      # service purchased with tires.
+      AssociatedOrderItem = Structure.new do
+        # @return [String] The type of association between the order items.
+        #
+        # **Possible values**:
+        # - `VALUE_ADD_SERVICE` (The associated item is a service order)
+        attribute?(:association_type, String, from: "associationType")
+
+        # @return [String] The order identifier of the associated order item.
+        attribute?(:order_id, String, from: "orderId")
+
+        # @return [String] The order item identifier of the associated order item.
+        attribute?(:order_item_id, String, from: "orderItemId")
+      end
+    end
+  end
+end

data/lib/peddler/apis/orders_2026_01_01/item_packing.rb

@@ -11,6 +11,9 @@ module Peddler
       ItemPacking = Structure.new do
         # @return [GiftOption] Gift wrapping and messaging specified for this item.
         attribute?(:gift_option, GiftOption, from: "giftOption")
+
+        # @return [SerialNumberRequirement] Whether serial numbers must be provided for this line item.
+        attribute?(:serial_number_requirement, SerialNumberRequirement, from: "serialNumberRequirement")
       end
     end
   end

data/lib/peddler/apis/orders_2026_01_01/item_picking.rb

@@ -10,7 +10,7 @@ module Peddler
       # Information related to the warehouse picking process for an order item.
       ItemPicking = Structure.new do
         # @return [ItemSubstitutionPreference] Substitution preference for an order item when it becomes unavailable
-        #   during fulfillment
+        #   during fulfillment.
         attribute?(:substitution_preference, ItemSubstitutionPreference, from: "substitutionPreference")
       end
     end

data/lib/peddler/apis/orders_2026_01_01/item_proceeds_detailed_breakdown.rb

@@ -8,7 +8,7 @@ module Peddler
   module APIs
     class Orders20260101
       # Further granular breakdown of the subtotal of the proceeds breakdown, only available for TAX and DISCOUNT
-      # proceeds type.
+      # proceeds types.
       ItemProceedsDetailedBreakdown = Structure.new do
         # @return [String] Specific classification of the further granular breakdown.
         #

data/lib/peddler/apis/orders_2026_01_01/item_tax.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+# This file is generated. Do not edit.
+
+require "structure"
+
+module Peddler
+  module APIs
+    class Orders20260101
+      # Tax information for an order item.
+      ItemTax = Structure.new do
+        # @return [Array<ItemTaxCalculationBreakdown>] A list of tax calculation breakdowns for the order item.
+        attribute?(:tax_calculation_breakdowns, [ItemTaxCalculationBreakdown], from: "taxCalculationBreakdowns")
+
+        # @return [Array<ItemTaxCollection>] A list of tax collections for the order item.
+        attribute?(:tax_collections, [ItemTaxCollection], from: "taxCollections")
+      end
+    end
+  end
+end