peddler 5.3.1 → 5.5.0

data/lib/peddler/apis/notifications_v1.rb

@@ -16,14 +16,15 @@ module Peddler
     # @see https://github.com/amzn/selling-partner-api-models/blob/main/models/notifications-api-model/notifications.json
     class NotificationsV1 < API
       # Returns information about subscription of the specified notification type and payload version. `payloadVersion`
-      # is an optional parameter. When `payloadVersion` is not provided, it will return latest payload version
-      # subscription's information. You can use this API to get subscription information when you do not have a
+      # is an optional parameter. When you do not provide `payloadVersion`, the operation returns the latest payload
+      # version subscription's information. You can use this API to get subscription information when you do not have a
       # subscription identifier.
       #
       # @note This operation can make a static sandbox call.
-      # @param payload_version [String] The version of the payload object to be used in the notification.
       # @param notification_type [String] The type of notification. For more information about notification types, refer
-      #   to [Notification Type Values](https://developer-docs.amazon.com/sp-api/docs/notification-type-values).
+      #   to the [Notifications API v1 Use Case
+      #   Guide](https://developer-docs.amazon.com/sp-api/docs/notifications-api-v1-use-case-guide).
+      # @param payload_version [String] The version of the payload object to be used in the notification.
       # @param rate_limit [Float] Requests per second
       # @return [Peddler::Response] The API response
       def get_subscription(notification_type, payload_version: nil, rate_limit: 1.0)
@@ -36,14 +37,15 @@ module Peddler
       end
 
       # Creates a subscription for the specified notification type to be delivered to the specified destination. Before
-      # you can subscribe, you must first create the destination by calling the `createDestination` operation. In cases
-      # where the specified notification type supports multiple payload versions, you can utilize this API to subscribe
+      # you can subscribe, you must first create the destination by calling the `createDestination` operation. If the
+      # notification type that you specify supports multiple payload versions, you can use this operation to subscribe
       # to a different payload version if you already have an existing subscription for a different payload version.
       #
       # @note This operation can make a static sandbox call.
-      # @param body [Hash]
+      # @param body [Hash] The request schema for the `createSubscription` operation.
       # @param notification_type [String] The type of notification. For more information about notification types, refer
-      #   to [Notification Type Values](https://developer-docs.amazon.com/sp-api/docs/notification-type-values).
+      #   to the [Notifications API v1 Use Case
+      #   Guide](https://developer-docs.amazon.com/sp-api/docs/notifications-api-v1-use-case-guide).
       # @param rate_limit [Float] Requests per second
       # @return [Peddler::Response] The API response
       def create_subscription(body, notification_type, rate_limit: 1.0)
@@ -54,12 +56,14 @@ module Peddler
 
       # Returns information about a subscription for the specified notification type. The `getSubscriptionById`
       # operation is grantless. For more information, refer to [Grantless
-      # operations](https://developer-docs.amazon.com/sp-api/docs/grantless-operations).
+      # Operations](https://developer-docs.amazon.com/sp-api/docs/grantless-operations) in the Selling Partner API
+      # Developer Guide.
       #
       # @note This operation can make a static sandbox call.
       # @param subscription_id [String] The identifier for the subscription that you want to get.
       # @param notification_type [String] The type of notification. For more information about notification types, refer
-      #   to [Notification Type Values](https://developer-docs.amazon.com/sp-api/docs/notification-type-values).
+      #   to the [Notifications API v1 Use Case
+      #   Guide](https://developer-docs.amazon.com/sp-api/docs/notifications-api-v1-use-case-guide).
       # @param rate_limit [Float] Requests per second
       # @return [Peddler::Response] The API response
       def get_subscription_by_id(subscription_id, notification_type, rate_limit: 1.0)
@@ -72,12 +76,14 @@ module Peddler
       # subscription identifier can be for any subscription associated with your application. After you successfully
       # call this operation, notifications will stop being sent for the associated subscription. The
       # `deleteSubscriptionById` operation is grantless. For more information, refer to [Grantless
-      # operations](https://developer-docs.amazon.com/sp-api/docs/grantless-operations).
+      # Operations](https://developer-docs.amazon.com/sp-api/docs/grantless-operations) in the Selling Partner API
+      # Developer Guide.
       #
       # @note This operation can make a static sandbox call.
       # @param subscription_id [String] The identifier for the subscription that you want to delete.
       # @param notification_type [String] The type of notification. For more information about notification types, refer
-      #   to [Notification Type Values](https://developer-docs.amazon.com/sp-api/docs/notification-type-values).
+      #   to the [Notifications API v1 Use Case
+      #   Guide](https://developer-docs.amazon.com/sp-api/docs/notifications-api-v1-use-case-guide).
       # @param rate_limit [Float] Requests per second
       # @return [Peddler::Response] The API response
       def delete_subscription_by_id(subscription_id, notification_type, rate_limit: 1.0)
@@ -86,8 +92,27 @@ module Peddler
         delete(path, rate_limit:, parser:)
       end
 
+      # Sends a mock notification of the specified type to your SQS. The `sendTestNotification` API is grantless. For
+      # more information, see "Grantless operations" in the Selling Partner API Developer Guide.
+      #
+      # @note This operation can make a dynamic sandbox call.
+      # @param body [Hash] The request schema for the `sendTestNotification` operation.
+      # @param notification_type [String] The type of notification. For more information about notification types, refer
+      #   to the [Notifications API v1 Use Case
+      #   Guide](https://developer-docs.amazon.com/sp-api/docs/notifications-api-v1-use-case-guide).
+      # @param rate_limit [Float] Requests per second
+      # @return [Peddler::Response] The API response
+      def send_test_notification(body, notification_type, rate_limit: 1.0)
+        must_sandbox!
+
+        path = "/notifications/v1/subscriptions/#{percent_encode(notification_type)}/testNotification"
+        parser = -> { SendTestNotificationResponse }
+        post(path, body:, rate_limit:, parser:)
+      end
+
       # Returns information about all destinations. The `getDestinations` operation is grantless. For more information,
-      # refer to [Grantless operations](https://developer-docs.amazon.com/sp-api/docs/grantless-operations).
+      # refer to [Grantless Operations](https://developer-docs.amazon.com/sp-api/docs/grantless-operations) in the
+      # Selling Partner API Developer Guide.
       #
       # @note This operation can make a static sandbox call.
       # @param rate_limit [Float] Requests per second
@@ -100,10 +125,11 @@ module Peddler
 
       # Creates a destination resource to receive notifications. The `createDestination` operation is grantless. For
       # more information, refer to [Grantless
-      # operations](https://developer-docs.amazon.com/sp-api/docs/grantless-operations).
+      # Operations](https://developer-docs.amazon.com/sp-api/docs/grantless-operations) in the Selling Partner API
+      # Developer Guide.
       #
       # @note This operation can make a static sandbox call.
-      # @param body [Hash]
+      # @param body [Hash] The request schema for the `createDestination` operation.
       # @param rate_limit [Float] Requests per second
       # @return [Peddler::Response] The API response
       def create_destination(body, rate_limit: 1.0)
@@ -114,7 +140,8 @@ module Peddler
 
       # Returns information about the destination that you specify. The `getDestination` operation is grantless. For
       # more information, refer to [Grantless
-      # operations](https://developer-docs.amazon.com/sp-api/docs/grantless-operations).
+      # Operations](https://developer-docs.amazon.com/sp-api/docs/grantless-operations) in the Selling Partner API
+      # Developer Guide.
       #
       # @note This operation can make a static sandbox call.
       # @param destination_id [String] The identifier generated when you created the destination.
@@ -127,7 +154,8 @@ module Peddler
       end
 
       # Deletes the destination that you specify. The `deleteDestination` operation is grantless. For more information,
-      # refer to [Grantless operations](https://developer-docs.amazon.com/sp-api/docs/grantless-operations).
+      # refer to [Grantless Operations](https://developer-docs.amazon.com/sp-api/docs/grantless-operations) in the
+      # Selling Partner API Developer Guide.
       #
       # @note This operation can make a static sandbox call.
       # @param destination_id [String] The identifier for the destination that you want to delete.

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/fulfillment_order.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+# This file is generated. Do not edit.
+
+require "structure"
+
+module Peddler
+  module APIs
+    class Orders20260101
+      # Information about a fulfillment order associated with a customer order. A fulfillment order represents a unit of
+      # fulfillment created by Amazon for the order. **Note:** Only available for EasyShip orders at present.
+      FulfillmentOrder = Structure.new do
+        # @return [String] The Fulfillment Order ID assigned by Amazon after fulfillment planning. This identifier is
+        #   identical to the Shipment ID required by External Fulfillment APIs.
+        attribute(:fulfillment_order_id, String, null: false, from: "fulfillmentOrderId")
+      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_breakdown.rb

@@ -9,16 +9,16 @@ module Peddler
     class Orders20260101
       # Detailed proceeds breakdown for a specific order item.
       ItemProceedsBreakdown = Structure.new do
-        # @return [Array<ItemProceedsDetailedBreakdown>] Further granular breakdown of the subtotal.
-        attribute?(:detailed_breakdowns, [ItemProceedsDetailedBreakdown], from: "detailedBreakdowns")
-
         # @return [Money] Monetary amount for the proceeds breakdown.
-        attribute?(:subtotal, Money)
+        attribute(:subtotal, Money, null: false)
 
         # @return [String] Category classification of the proceeds breakdown.
         #
         # **Possible values**: `ITEM`, `SHIPPING`, `GIFT_WRAP`, `COD_FEE`, `OTHER`, `TAX`, `DISCOUNT`
-        attribute?(:type, String)
+        attribute(:type, String, null: false)
+
+        # @return [Array<ItemProceedsDetailedBreakdown>] Further granular breakdown of the subtotal.
+        attribute?(:detailed_breakdowns, [ItemProceedsDetailedBreakdown], from: "detailedBreakdowns")
       end
     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

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

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+# This file is generated. Do not edit.
+
+require "structure"
+
+module Peddler
+  module APIs
+    class Orders20260101
+      # Tax calculation breakdowns for an order item.
+      ItemTaxCalculationBreakdown = Structure.new do
+        # @return [String] The tax reporting scheme applied to this order item.
+        #
+        # **Possible values**:
+        # - `UOSS` (Union one stop shop. The item being purchased is held in the EU for shipment) - `IOSS` (Import one
+        #   stop shop. The item being purchased is not held in the EU for shipment)
+        attribute?(:reporting_scheme, String, from: "reportingScheme")
+      end
+    end
+  end
+end

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

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+# This file is generated. Do not edit.
+
+require "structure"
+
+module Peddler
+  module APIs
+    class Orders20260101
+      # Tax collection information for an order item.
+      ItemTaxCollection = Structure.new do
+        # @return [String] The tax collection model applied to the item.
+        #
+        # **Possible values**:
+        # - `MARKETPLACE_FACILITATOR` (Tax is withheld and remitted to the taxing authority by Amazon on behalf of the
+        #   seller)
+        attribute?(:model, String)
+
+        # @return [String] The party responsible for withholding the taxes and remitting them to the taxing authority.
+        attribute?(:responsible_party, String, from: "responsibleParty")
+      end
+    end
+  end
+end

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

@@ -37,6 +37,11 @@ module Peddler
         # @return [OrderFulfillment] Information about how this order is being processed and shipped.
         attribute?(:fulfillment, OrderFulfillment)
 
+        # @return [Array<FulfillmentOrder>] The list of fulfillment orders associated with this customer order. Each
+        #   entry corresponds to one fulfillment unit created by Amazon for this order. **Note:** Only available for
+        #   EasyShip orders at present.
+        attribute?(:fulfillment_orders, [FulfillmentOrder], from: "fulfillmentOrders")
+
         # @return [Array<Alias>] Alternative identifiers that can be used to reference this order, such as
         #   seller-defined order numbers.
         attribute?(:order_aliases, [Alias], from: "orderAliases")
@@ -45,6 +50,9 @@ module Peddler
         #   **Note:** Only available for merchant-fulfilled (FBM) orders.
         attribute?(:packages, [OrderPackage])
 
+        # @return [OrderPayment] Payment information for the order.
+        attribute?(:payment, OrderPayment)
+
         # @return [OrderProceeds] Financial information about this order.
         attribute?(:proceeds, OrderProceeds)
 
@@ -52,11 +60,15 @@ module Peddler
         #   experience.
         #
         # **Possible values**: `AMAZON_BAZAAR`, `AMAZON_BUSINESS`, `AMAZON_EASY_SHIP`, `AMAZON_HAUL`,
-        #   `DELIVERY_BY_AMAZON`, `FBM_SHIP_PLUS`, `IN_STORE_PICK_UP`, `PREMIUM`, `PREORDER`, `PRIME`
+        #   `DELIVERY_BY_AMAZON`, `FBM_SHIP_PLUS`, `INVOICE_BY_AMAZON`, `IN_STORE_PICK_UP`, `PREMIUM`, `PREORDER`,
+        #   `PRIME`
         attribute?(:programs, [String])
 
         # @return [Recipient] Information about the person or location where this order should be delivered.
         attribute?(:recipient, Recipient)
+
+        # @return [OrderTax] Tax-related information for the order.
+        attribute?(:tax, OrderTax)
       end
     end
   end

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

@@ -18,6 +18,10 @@ module Peddler
         # @return [Integer] The number of units of this item that the customer ordered.
         attribute(:quantity_ordered, Integer, null: false, from: "quantityOrdered")
 
+        # @return [Array<AssociatedOrderItem>] A list of order items associated with this item. For example, a value-add
+        #   service purchased with the product.
+        attribute?(:associated_order_items, [AssociatedOrderItem], from: "associatedOrderItems")
+
         # @return [ItemCancellation] The cancellation information of the order item.
         attribute?(:cancellation, ItemCancellation)
 
@@ -42,6 +46,9 @@ module Peddler
 
         # @return [ItemPromotion] Details about any discounts, coupons, or promotional offers applied to this item.
         attribute?(:promotion, ItemPromotion)
+
+        # @return [ItemTax] Tax-related information for this order item.
+        attribute?(:tax, ItemTax)
       end
     end
   end

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

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+# This file is generated. Do not edit.
+
+require "structure"
+
+module Peddler
+  module APIs
+    class Orders20260101
+      # Payment information about the order.
+      OrderPayment = Structure.new do
+        # @return [Array<PaymentExecution>] A list of payment executions for the order.
+        attribute?(:payment_executions, [PaymentExecution], from: "paymentExecutions")
+      end
+    end
+  end
+end

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

@@ -9,6 +9,11 @@ module Peddler
     class Orders20260101
       # The money that the seller receives from the sale of the order.
       OrderProceeds = Structure.new do
+        # @return [Array<OrderProceedsBreakdown>] Categorized proceeds for the order. Proceed categories are either
+        #   aggregated across all order items (such as `ITEM`, `SHIPPING`, and `TAX`) or applied at the order level
+        #   (such as `DELIVERY_TIP`).
+        attribute?(:breakdowns, [OrderProceedsBreakdown])
+
         # @return [Money] The total amount that the seller receives from the sale of the order.
         attribute?(:grand_total, Money, from: "grandTotal")
       end

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

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+# This file is generated. Do not edit.
+
+require "structure"
+
+module Peddler
+  module APIs
+    class Orders20260101
+      # An entry detailing proceeds information.
+      OrderProceedsBreakdown = Structure.new do
+        # @return [Money] The monetary amount for the proceeds category.
+        attribute(:subtotal, Money, null: false)
+
+        # @return [String] The proceeds category.
+        #
+        # **Possible values**: `ITEM`, `SHIPPING`, `GIFT_WRAP`, `COD_FEE`, `TAX`, `DISCOUNT`, `DELIVERY_TIP`, `OTHER`.
+        #   **Note:** `DELIVERY_TIP` is charged separately and not attributed to a specific item. The remaining
+        #   categories are aggregated across all order items.
+        attribute(:type, String, null: false)
+
+        # @return [String] The processing status of the charge. Only present for categories processed separately after
+        #   checkout, such as `DELIVERY_TIP`.
+        #
+        # **Possible values**: `PENDING`, `FINALIZED`.
+        attribute?(:status, String)
+      end
+    end
+  end
+end

data/lib/peddler/apis/orders_2026_01_01/order_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 about the order.
+      OrderTax = Structure.new do
+        # @return [OrderTaxInvoicing] Tax invoicing information for the order.
+        attribute?(:tax_invoicing, OrderTaxInvoicing, from: "taxInvoicing")
+
+        # @return [Array<OrderTaxRegistration>] A list of tax registrations associated with the order.
+        attribute?(:tax_registrations, [OrderTaxRegistration], from: "taxRegistrations")
+      end
+    end
+  end
+end

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

@@ -0,0 +1,34 @@
+# frozen_string_literal: true
+
+# This file is generated. Do not edit.
+
+require "structure"
+
+module Peddler
+  module APIs
+    class Orders20260101
+      # Tax invoicing information for the order.
+      OrderTaxInvoicing = Structure.new do
+        # @return [String] The buyer's invoicing preference, which indicates whether the seller should issue an
+        #   individual or a business invoice to the buyer.
+        #
+        # **Note**: This attribute is only available in the Turkey marketplace.
+        #
+        # **Possible values**:
+        # - `INDIVIDUAL` (Issues an individual invoice to the buyer) - `BUSINESS` (Issues a business invoice to the
+        #   buyer)
+        attribute?(:buyer_invoice_preference, String, from: "buyerInvoicePreference")
+
+        # @return [String] The status of the invoice. Only available for Easy Ship orders and orders in the Brazil
+        #   marketplace.
+        #
+        # **Possible values**:
+        # - `NOT_REQUIRED` (The order does not require an electronic invoice to be uploaded) - `NOT_FOUND` (The order
+        #   requires an electronic invoice but it is not uploaded) - `PROCESSING` (The required electronic invoice was
+        #   uploaded and is processing) - `ERRORED` (The uploaded electronic invoice was not accepted) - `ACCEPTED` (The
+        #   uploaded electronic invoice was accepted)
+        attribute?(:invoice_status, String, from: "invoiceStatus")
+      end
+    end
+  end
+end

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

@@ -0,0 +1,39 @@
+# frozen_string_literal: true
+
+# This file is generated. Do not edit.
+
+require "structure"
+
+module Peddler
+  module APIs
+    class Orders20260101
+      # Tax registration information for an entity associated with the order.
+      OrderTaxRegistration = Structure.new do
+        # @return [String] The type of entity that the tax registration belongs to.
+        #
+        # **Possible values**:
+        # - `BUYER` (Indicates that this is the buyer's tax registration information) - `MERCHANT` (Indicates that this
+        #   is the merchant's tax registration information) - `MARKETPLACE` (Indicates that this is the marketplace's
+        #   tax registration information)
+        attribute?(:entity_type, String, from: "entityType")
+
+        # @return [String] The legal name associated with the tax registration.
+        attribute?(:legal_name, String, from: "legalName")
+
+        # @return [CustomerAddress] The address associated with the tax registration.
+        attribute?(:tax_registration_address, CustomerAddress, from: "taxRegistrationAddress")
+
+        # @return [Array<TaxRegistrationAttribute>] Additional attributes related to the tax registration.
+        attribute?(:tax_registration_attributes, [TaxRegistrationAttribute], from: "taxRegistrationAttributes")
+
+        # @return [String] The tax registration number that identifies the entity for tax purposes.
+        attribute?(:tax_registration_number, String, from: "taxRegistrationNumber")
+
+        # @return [String] The type of the tax registration number.
+        #
+        # **Possible values**: `BUSINESS`, `VAT`, `CST`, `CPF`, `CNPJ`
+        attribute?(:tax_registration_type, String, from: "taxRegistrationType")
+      end
+    end
+  end
+end

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

@@ -15,9 +15,10 @@ module Peddler
         # @return [String] Granular status information providing specific details about the package's current location
         #   and handling stage.
         #
-        # **Possible values:** - `PENDING_SCHEDULE` (Package awaiting pickup scheduling) - `PENDING_PICK_UP` (Package
-        #   ready for carrier collection from seller) - `PENDING_DROP_OFF` (Package awaiting seller delivery to carrier)
-        #   - `LABEL_CANCELLED` (Shipping label canceled by seller) - `PICKED_UP` (Package collected by carrier from
+        # **Possible values**:
+        # - `PENDING_SCHEDULE` (Package awaiting pickup scheduling) - `PENDING_PICK_UP` (Package ready for carrier
+        #   collection from seller) - `PENDING_DROP_OFF` (Package awaiting seller delivery to carrier) -
+        #   `LABEL_CANCELLED` (Shipping label canceled by seller) - `PICKED_UP` (Package collected by carrier from
         #   seller location) - `DROPPED_OFF` (Package delivered to carrier by seller) - `AT_ORIGIN_FC` (Package at
         #   originating fulfillment center) - `AT_DESTINATION_FC` (Package at destination fulfillment center) -
         #   `DELIVERED` (Package successfully delivered to recipient) - `REJECTED_BY_BUYER` (Package refused by intended

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

@@ -7,11 +7,11 @@ require "structure"
 module Peddler
   module APIs
     class Orders20260101
-      # When a request has results that are not included in the response, pagination occurs. This means the results are
-      # divided into individual pages. To retrieve a different page, you must pass the token value as the
-      # `paginationToken` query parameter in the subsequent request. All other parameters must be provided with the same
-      # values that were provided with the request that generated this token, with the exception of `maxResultsPerPage`
-      # and `includedData`, which can be modified between calls. The token will expire after 24 hours. When there are no
+      # Pagination occurs when a request has results that exceed the response limit. This means the results are divided
+      # into individual pages. To retrieve a different page, you must pass the token value as the `paginationToken`
+      # query parameter in the subsequent request. All other parameters must be provided with the same values that were
+      # provided with the request that generated this token, with the exception of `maxResultsPerPage` and
+      # `includedData`, which can be modified between calls. The token will expire after 24 hours. When there are no
       # other pages to fetch, the `pagination` field will be absent from the response.
       Pagination = Structure.new do
         # @return [String] A token that can be used to fetch the next page of results.

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

@@ -0,0 +1,39 @@
+# frozen_string_literal: true
+
+# This file is generated. Do not edit.
+
+require "structure"
+
+module Peddler
+  module APIs
+    class Orders20260101
+      # Payment execution details for an order.
+      PaymentExecution = Structure.new do
+        # @return [String] The unique identifier of the payment processor or acquiring bank that authorizes the payment.
+        #
+        # **Note**: This attribute is only available for orders in the Brazil (BR) marketplace when the `paymentMethod`
+        #   is `CreditCard` or `Pix`.
+        attribute?(:acquirer_id, String, from: "acquirerId")
+
+        # @return [String] The unique code that confirms the payment authorization.
+        #
+        # **Note**: This attribute is only available for orders in the Brazil (BR) marketplace when the `paymentMethod`
+        #   is `CreditCard` or `Pix`.
+        attribute?(:authorization_code, String, from: "authorizationCode")
+
+        # @return [String] The card network or brand used in the payment transaction (for example, Visa or Mastercard).
+        #
+        # **Note**: This attribute is only available for orders in the Brazil (BR) marketplace when the `paymentMethod`
+        #   is `CreditCard`.
+        attribute?(:card_brand, String, from: "cardBrand")
+
+        # @return [Money] The monetary value of the payment execution.
+        attribute?(:payment_amount, Money, from: "paymentAmount")
+
+        # @return [String] The payment method used for this payment execution (for example, CashOnDelivery,
+        #   ConvenienceStore, CreditCard, Invoice, Pix, and so on).
+        attribute?(:payment_method, String, from: "paymentMethod")
+      end
+    end
+  end
+end

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

@@ -13,21 +13,20 @@ module Peddler
         # @return [Array<Order>] An array containing all orders that match the search criteria.
         attribute(:orders, [Order], null: false)
 
-        # @return [Time] Only orders placed before the specified time are returned. The date must be in
-        #   {https://developer-docs.amazon.com/sp-api/docs/iso-8601 ISO 8601} format.
+        # @return [Time] Only orders placed before the specified time are returned. The date must be in [ISO
+        #   8601](https://developer-docs.amazon.com/sp-api/docs/iso-8601) format.
         attribute?(:created_before, Time, from: "createdBefore")
 
-        # @return [Time] Only orders updated before the specified time are returned. The date must be in
-        #   {https://developer-docs.amazon.com/sp-api/docs/iso-8601 ISO 8601} format.
+        # @return [Time] Only orders updated before the specified time are returned. The date must be in [ISO
+        #   8601](https://developer-docs.amazon.com/sp-api/docs/iso-8601) format.
         attribute?(:last_updated_before, Time, from: "lastUpdatedBefore")
 
-        # @return [Pagination] When a request has results that are not included in the response, pagination occurs. This
-        #   means the results are divided into individual pages. To retrieve a different page, you must pass the token
-        #   value as the `paginationToken` query parameter in the subsequent request. All other parameters must be
-        #   provided with the same values that were provided with the request that generated this token, with the
-        #   exception of `maxResultsPerPage` and `includedData`, which can be modified between calls. The token will
-        #   expire after 24 hours. When there are no other pages to fetch, the `pagination` field will be absent from
-        #   the response.
+        # @return [Pagination] Pagination occurs when a request has results that exceed the response limit. This means
+        #   the results are divided into individual pages. To retrieve a different page, you must pass the token value
+        #   as the `paginationToken` query parameter in the subsequent request. All other parameters must be provided
+        #   with the same values that were provided with the request that generated this token, with the exception of
+        #   `maxResultsPerPage` and `includedData`, which can be modified between calls. The token will expire after 24
+        #   hours. When there are no other pages to fetch, the `pagination` field will be absent from the response.
         attribute?(:pagination, Pagination)
       end
     end