peddler 5.1.0 → 5.2.0

data/lib/peddler/data_kiosk/sales_and_traffic20240424/by_date_sales.rb

@@ -18,7 +18,7 @@ module Peddler
         #   populated when the seller is a B2B seller.
         attribute?(:average_sales_per_order_item_b2b, Amount, from: "averageSalesPerOrderItemB2B")
 
-        # @return [Amount] The average price of the units sold in the selected time period, calculated by dividing the
+        # @return [Amount] The average price of the units sold for the selected time period, calculated by dividing the
         #   orderedProductSales by unitsOrdered for the selected time period.
         attribute?(:average_selling_price, Amount, null: false, from: "averageSellingPrice")
 
@@ -37,24 +37,38 @@ module Peddler
         # @return [Amount] Monetary amount of filed A-to-z guarantee claims.
         attribute?(:claims_amount, Amount, null: false, from: "claimsAmount")
 
+        # @return [Amount] Monetary amount of filed A-to-z guarantee claims for Amazon Business customers. Note: This
+        #   field is only populated when the seller is a B2B seller.
+        attribute?(:claims_amount_b2b, Amount, from: "claimsAmountB2B")
+
         # @return [String] The number of A-to-z guarantee claims granted.
         attribute?(:claims_granted, String, null: false, from: "claimsGranted")
 
+        # @return [String] The number of A-to-z guarantee claims granted for Amazon Business customers.
+        # Note: This field is only populated when the seller is a B2B seller.
+        attribute?(:claims_granted_b2b, String, from: "claimsGrantedB2B")
+
         # @return [Amount] The amount of ordered product sales, calculated by multiplying the price of products and the
         #   number of units sold for the selected time period.
         attribute?(:ordered_product_sales, Amount, null: false, from: "orderedProductSales")
 
         # @return [Amount] The amount of ordered product sales to Amazon Business customers, calculated by multiplying
-        #   the price of products and the number of units sold for the selected time period.
+        #   the price of products and the number of units sold for the selected time period. Note: This field is only
+        #   populated when the seller is a B2B seller.
         attribute?(:ordered_product_sales_b2b, Amount, from: "orderedProductSalesB2B")
 
-        # @return [String] The number of orders shipped in the selected time period.
+        # @return [String] The number of orders shipped for the selected time period.
         attribute?(:orders_shipped, String, null: false, from: "ordersShipped")
 
         # @return [Float] The percentage conversion metric indicating how many orders were refunded by the seller,
-        #   calculated by dividing unitsOrdered by unitsRefunded in the selected time period.
+        #   calculated by dividing unitsRefunded by unitsOrdered for the selected time period.
         attribute?(:refund_rate, Float, null: false, from: "refundRate")
 
+        # @return [Float] The percentage conversion metric indicating how many orders were refunded by Amazon Business
+        #   customers, calculated by dividing unitsRefundedB2B by unitsOrderedB2B for the selected time period. Note:
+        #   This field is only populated when the seller is a B2B seller.
+        attribute?(:refund_rate_b2b, Float, from: "refundRateB2B")
+
         # @return [Amount] The amount of ordered product sales shipped for the selected time period.
         attribute?(:shipped_product_sales, Amount, null: false, from: "shippedProductSales")
 
@@ -65,7 +79,8 @@ module Peddler
 
         # @return [String] The number of items that were ordered by Amazon Business customers for the selected time
         #   period. Example: For an order containing 2 copies of book A and 3 copies of book B, the number of orders is
-        #   1, the number of order items is 2 (book A and book B), and the number of units is 5 (2 + 3).
+        #   1, the number of order items is 2 (book A and book B), and the number of units is 5 (2 + 3). Note: This
+        #   field is only populated when the seller is a B2B seller.
         attribute?(:total_order_items_b2b, String, from: "totalOrderItemsB2B")
 
         # @return [String] The number of units ordered for the selected time period. Example: For an order containing 2
@@ -75,13 +90,18 @@ module Peddler
 
         # @return [String] The number of units ordered by Amazon Business customers for the selected time period.
         #   Example: For an order containing 2 copies of book A and 3 copies of book B, the number of orders is 1, the
-        #   number of order items is 2 (book A and book B), and the number of units is 5 (2 + 3).
+        #   number of order items is 2 (book A and book B), and the number of units is 5 (2 + 3). Note: This field is
+        #   only populated when the seller is a B2B seller.
         attribute?(:units_ordered_b2b, String, from: "unitsOrderedB2B")
 
-        # @return [String] The number of units refunded in the selected time period.
+        # @return [String] The number of units refunded for the selected time period.
         attribute?(:units_refunded, String, null: false, from: "unitsRefunded")
 
-        # @return [String] The number of units shipped in the selected time period.
+        # @return [String] The number of units refunded by Amazon Business customers for the selected time period. Note:
+        #   This field is only populated when the seller is a B2B seller.
+        attribute?(:units_refunded_b2b, String, from: "unitsRefundedB2B")
+
+        # @return [String] The number of units shipped for the selected time period.
         attribute?(:units_shipped, String, null: false, from: "unitsShipped")
       end
     end

data/lib/peddler/data_kiosk/sales_and_traffic20240424/by_date_traffic.rb

@@ -9,11 +9,11 @@ module Peddler
     module SalesAndTraffic20240424
       # The traffic data for the seller's account aggregated by date.
       ByDateTraffic = Structure.new do
-        # @return [String] The average number of offers listed for sale in the selected time period. It is calculated
-        #   from the total number of offers and the total number of days in the selected time period.
+        # @return [String] The average number of offers listed for sale for the selected time period. It is calculated
+        #   from the total number of offers and the total number of days for the selected time period.
         attribute?(:average_offer_count, String, null: false, from: "averageOfferCount")
 
-        # @return [String] The average number of parent items listed for sale in the selected time period.
+        # @return [String] The average number of parent items listed for sale for the selected time period.
         attribute?(:average_parent_items, String, null: false, from: "averageParentItems")
 
         # @return [String] Browser page views are the number of times a user visited your Amazon.com browser pages for
@@ -45,9 +45,13 @@ module Peddler
         #   is only populated when the seller is a B2B seller.
         attribute?(:buy_box_percentage_b2b, Float, from: "buyBoxPercentageB2B")
 
-        # @return [String] The number of times customers left feedback in the selected time period.
+        # @return [String] The number of times customers left feedback for the selected time period.
         attribute?(:feedback_received, String, null: false, from: "feedbackReceived")
 
+        # @return [String] The number of times Amazon Business customers left feedback for the selected time period.
+        #   Note: This field is only populated when the seller is a B2B seller.
+        attribute?(:feedback_received_b2b, String, from: "feedbackReceivedB2B")
+
         # @return [String] Mobile app page views are the number of times a user visited your Amazon.com mobile app pages
         #   for the selected time period.
         attribute?(:mobile_app_page_views, String, null: false, from: "mobileAppPageViews")
@@ -69,9 +73,13 @@ module Peddler
         #   a single session. Note: This field is only populated when the seller is a B2B seller.
         attribute?(:mobile_app_sessions_b2b, String, from: "mobileAppSessionsB2B")
 
-        # @return [String] The number of times customers left negative feedback in the selected time period.
+        # @return [String] The number of times customers left negative feedback for the selected time period.
         attribute?(:negative_feedback_received, String, null: false, from: "negativeFeedbackReceived")
 
+        # @return [String] The number of times Amazon Business customers left negative feedback for the selected time
+        #   period. Note: This field is only populated when the seller is a B2B seller.
+        attribute?(:negative_feedback_received_b2b, String, from: "negativeFeedbackReceivedB2B")
+
         # @return [Float] The percentage conversion metric indicating how many order items were generated relative to
         #   the number of people who viewed the products.
         attribute?(:order_item_session_percentage, Float, null: false, from: "orderItemSessionPercentage")
@@ -91,9 +99,14 @@ module Peddler
         attribute?(:page_views_b2b, String, from: "pageViewsB2B")
 
         # @return [Float] The negative feedback rate is the number of orders that have received negative feedback
-        #   divided by the number of orders in the selected time period.
+        #   divided by the number of orders for the selected time period.
         attribute?(:received_negative_feedback_rate, Float, null: false, from: "receivedNegativeFeedbackRate")
 
+        # @return [Float] The negative feedback rate for Amazon Business customers is the number of orders that have
+        #   received negative feedback divided by the number of orders for the selected time period. Note: This field is
+        #   only populated when the seller is a B2B seller.
+        attribute?(:received_negative_feedback_rate_b2b, Float, from: "receivedNegativeFeedbackRateB2B")
+
         # @return [String] Sessions are visits to your Amazon.com browser or mobile app pages by a user.
         # All browser and mobile app activity within a 24-hour period is considered a session. It is calculated as the
         #   sum of browserSessions and mobileAppSessions.

data/lib/peddler/data_kiosk/sales_and_traffic20240424.json

@@ -390,6 +390,34 @@
               "isDeprecated": false,
               "deprecationReason": null
             },
+            {
+              "name": "refundRate",
+              "description": "The percentage conversion metric indicating how many orders were refunded,\ncalculated by dividing unitsRefunded by unitsOrdered for the selected time period.",
+              "args": [],
+              "type": {
+                "kind": "NON_NULL",
+                "name": null,
+                "ofType": {
+                  "kind": "SCALAR",
+                  "name": "Float",
+                  "ofType": null
+                }
+              },
+              "isDeprecated": false,
+              "deprecationReason": null
+            },
+            {
+              "name": "refundRateB2B",
+              "description": "The percentage conversion metric indicating how many orders were refunded by\nAmazon Business customers, calculated by dividing unitsRefundedB2B by\nunitsOrderedB2B for the selected time period. Note: This field is only\npopulated when the seller is a B2B seller.",
+              "args": [],
+              "type": {
+                "kind": "SCALAR",
+                "name": "Float",
+                "ofType": null
+              },
+              "isDeprecated": false,
+              "deprecationReason": null
+            },
             {
               "name": "totalOrderItems",
               "description": "The number of items that were ordered for the selected time period.",
@@ -445,6 +473,34 @@
               },
               "isDeprecated": false,
               "deprecationReason": null
+            },
+            {
+              "name": "unitsRefunded",
+              "description": "The number of units refunded for the selected time period.",
+              "args": [],
+              "type": {
+                "kind": "NON_NULL",
+                "name": null,
+                "ofType": {
+                  "kind": "SCALAR",
+                  "name": "Long",
+                  "ofType": null
+                }
+              },
+              "isDeprecated": false,
+              "deprecationReason": null
+            },
+            {
+              "name": "unitsRefundedB2B",
+              "description": "The number of units refunded by Amazon Business customers for the selected\ntime period. Note: This field is only populated when the seller is a B2B seller.",
+              "args": [],
+              "type": {
+                "kind": "SCALAR",
+                "name": "Long",
+                "ofType": null
+              },
+              "isDeprecated": false,
+              "deprecationReason": null
             }
           ],
           "inputFields": null,
@@ -890,7 +946,7 @@
             },
             {
               "name": "averageSellingPrice",
-              "description": "The average price of the units sold in the selected time period, calculated by\ndividing the orderedProductSales by unitsOrdered for the selected time period.",
+              "description": "The average price of the units sold for the selected time period, calculated\nby dividing the orderedProductSales by unitsOrdered for the selected time period.",
               "args": [],
               "type": {
                 "kind": "NON_NULL",
@@ -960,6 +1016,18 @@
               "isDeprecated": false,
               "deprecationReason": null
             },
+            {
+              "name": "claimsAmountB2B",
+              "description": "Monetary amount of filed A-to-z guarantee claims for Amazon Business\ncustomers. Note: This field is only populated when the seller is a B2B seller.",
+              "args": [],
+              "type": {
+                "kind": "OBJECT",
+                "name": "Amount",
+                "ofType": null
+              },
+              "isDeprecated": false,
+              "deprecationReason": null
+            },
             {
               "name": "claimsGranted",
               "description": "The number of A-to-z guarantee claims granted.",
@@ -976,6 +1044,18 @@
               "isDeprecated": false,
               "deprecationReason": null
             },
+            {
+              "name": "claimsGrantedB2B",
+              "description": "The number of A-to-z guarantee claims granted for Amazon Business customers.\nNote: This field is only populated when the seller is a B2B seller.",
+              "args": [],
+              "type": {
+                "kind": "SCALAR",
+                "name": "Long",
+                "ofType": null
+              },
+              "isDeprecated": false,
+              "deprecationReason": null
+            },
             {
               "name": "orderedProductSales",
               "description": "The amount of ordered product sales, calculated by multiplying the price of\nproducts and the number of units sold for the selected time period.",
@@ -994,7 +1074,7 @@
             },
             {
               "name": "orderedProductSalesB2B",
-              "description": "The amount of ordered product sales to Amazon Business customers, calculated\nby multiplying the price of products and the number of units sold for the\nselected time period.",
+              "description": "The amount of ordered product sales to Amazon Business customers, calculated\nby multiplying the price of products and the number of units sold for the\nselected time period. Note: This field is only populated when the seller is a B2B seller.",
               "args": [],
               "type": {
                 "kind": "OBJECT",
@@ -1006,7 +1086,7 @@
             },
             {
               "name": "ordersShipped",
-              "description": "The number of orders shipped in the selected time period.",
+              "description": "The number of orders shipped for the selected time period.",
               "args": [],
               "type": {
                 "kind": "NON_NULL",
@@ -1022,7 +1102,7 @@
             },
             {
               "name": "refundRate",
-              "description": "The percentage conversion metric indicating how many orders were refunded by\nthe seller, calculated by dividing unitsOrdered by unitsRefunded in the\nselected time period.",
+              "description": "The percentage conversion metric indicating how many orders were refunded by\nthe seller, calculated by dividing unitsRefunded by unitsOrdered for the\nselected time period.",
               "args": [],
               "type": {
                 "kind": "NON_NULL",
@@ -1036,6 +1116,18 @@
               "isDeprecated": false,
               "deprecationReason": null
             },
+            {
+              "name": "refundRateB2B",
+              "description": "The percentage conversion metric indicating how many orders were refunded by\nAmazon Business customers, calculated by dividing unitsRefundedB2B by\nunitsOrderedB2B for the selected time period. Note: This field is only\npopulated when the seller is a B2B seller.",
+              "args": [],
+              "type": {
+                "kind": "SCALAR",
+                "name": "Float",
+                "ofType": null
+              },
+              "isDeprecated": false,
+              "deprecationReason": null
+            },
             {
               "name": "shippedProductSales",
               "description": "The amount of ordered product sales shipped for the selected time period.",
@@ -1070,7 +1162,7 @@
             },
             {
               "name": "totalOrderItemsB2B",
-              "description": "The number of items that were ordered by Amazon Business customers for the\nselected time period. Example: For an order containing 2 copies of book A and\n3 copies of book B, the number of orders is 1, the number of order items is 2\n(book A and book B), and the number of units is 5 (2 + 3).",
+              "description": "The number of items that were ordered by Amazon Business customers for the\nselected time period. Example: For an order containing 2 copies of book A and\n3 copies of book B, the number of orders is 1, the number of order items is 2\n(book A and book B), and the number of units is 5 (2 + 3). Note: This field is\nonly populated when the seller is a B2B seller.",
               "args": [],
               "type": {
                 "kind": "SCALAR",
@@ -1098,7 +1190,7 @@
             },
             {
               "name": "unitsOrderedB2B",
-              "description": "The number of units ordered by Amazon Business customers for the selected time\nperiod. Example: For an order containing 2 copies of book A and 3 copies of\nbook B, the number of orders is 1, the number of order items is 2 (book A and\nbook B), and the number of units is 5 (2 + 3).",
+              "description": "The number of units ordered by Amazon Business customers for the selected time\nperiod. Example: For an order containing 2 copies of book A and 3 copies of\nbook B, the number of orders is 1, the number of order items is 2 (book A and\nbook B), and the number of units is 5 (2 + 3). Note: This field is only\npopulated when the seller is a B2B seller.",
               "args": [],
               "type": {
                 "kind": "SCALAR",
@@ -1110,7 +1202,7 @@
             },
             {
               "name": "unitsRefunded",
-              "description": "The number of units refunded in the selected time period.",
+              "description": "The number of units refunded for the selected time period.",
               "args": [],
               "type": {
                 "kind": "NON_NULL",
@@ -1124,9 +1216,21 @@
               "isDeprecated": false,
               "deprecationReason": null
             },
+            {
+              "name": "unitsRefundedB2B",
+              "description": "The number of units refunded by Amazon Business customers for the selected\ntime period. Note: This field is only populated when the seller is a B2B seller.",
+              "args": [],
+              "type": {
+                "kind": "SCALAR",
+                "name": "Long",
+                "ofType": null
+              },
+              "isDeprecated": false,
+              "deprecationReason": null
+            },
             {
               "name": "unitsShipped",
-              "description": "The number of units shipped in the selected time period.",
+              "description": "The number of units shipped for the selected time period.",
               "args": [],
               "type": {
                 "kind": "NON_NULL",
@@ -1153,7 +1257,7 @@
           "fields": [
             {
               "name": "averageOfferCount",
-              "description": "The average number of offers listed for sale in the selected time period. It\nis calculated from the total number of offers and the total number of days in\nthe selected time period.",
+              "description": "The average number of offers listed for sale for the selected time period. It\nis calculated from the total number of offers and the total number of days for\nthe selected time period.",
               "args": [],
               "type": {
                 "kind": "NON_NULL",
@@ -1169,7 +1273,7 @@
             },
             {
               "name": "averageParentItems",
-              "description": "The average number of parent items listed for sale in the selected time period.",
+              "description": "The average number of parent items listed for sale for the selected time period.",
               "args": [],
               "type": {
                 "kind": "NON_NULL",
@@ -1269,7 +1373,7 @@
             },
             {
               "name": "feedbackReceived",
-              "description": "The number of times customers left feedback in the selected time period.",
+              "description": "The number of times customers left feedback for the selected time period.",
               "args": [],
               "type": {
                 "kind": "NON_NULL",
@@ -1283,6 +1387,18 @@
               "isDeprecated": false,
               "deprecationReason": null
             },
+            {
+              "name": "feedbackReceivedB2B",
+              "description": "The number of times Amazon Business customers left feedback for the selected\ntime period. Note: This field is only populated when the seller is a B2B seller.",
+              "args": [],
+              "type": {
+                "kind": "SCALAR",
+                "name": "Long",
+                "ofType": null
+              },
+              "isDeprecated": false,
+              "deprecationReason": null
+            },
             {
               "name": "mobileAppPageViews",
               "description": "Mobile app page views are the number of times a user visited your Amazon.com\nmobile app pages for the selected time period.",
@@ -1341,7 +1457,7 @@
             },
             {
               "name": "negativeFeedbackReceived",
-              "description": "The number of times customers left negative feedback in the selected time period.",
+              "description": "The number of times customers left negative feedback for the selected time period.",
               "args": [],
               "type": {
                 "kind": "NON_NULL",
@@ -1355,6 +1471,18 @@
               "isDeprecated": false,
               "deprecationReason": null
             },
+            {
+              "name": "negativeFeedbackReceivedB2B",
+              "description": "The number of times Amazon Business customers left negative feedback for the\nselected time period. Note: This field is only populated when the seller is a B2B seller.",
+              "args": [],
+              "type": {
+                "kind": "SCALAR",
+                "name": "Long",
+                "ofType": null
+              },
+              "isDeprecated": false,
+              "deprecationReason": null
+            },
             {
               "name": "orderItemSessionPercentage",
               "description": "The percentage conversion metric indicating how many order items were\ngenerated relative to the number of people who viewed the products.",
@@ -1413,7 +1541,7 @@
             },
             {
               "name": "receivedNegativeFeedbackRate",
-              "description": "The negative feedback rate is the number of orders that have received negative\nfeedback divided by the number of orders in the selected time period.",
+              "description": "The negative feedback rate is the number of orders that have received negative\nfeedback divided by the number of orders for the selected time period.",
               "args": [],
               "type": {
                 "kind": "NON_NULL",
@@ -1427,6 +1555,18 @@
               "isDeprecated": false,
               "deprecationReason": null
             },
+            {
+              "name": "receivedNegativeFeedbackRateB2B",
+              "description": "The negative feedback rate for Amazon Business customers is the number of\norders that have received negative feedback divided by the number of orders\nfor the selected time period. Note: This field is only populated when the\nseller is a B2B seller.",
+              "args": [],
+              "type": {
+                "kind": "SCALAR",
+                "name": "Float",
+                "ofType": null
+              },
+              "isDeprecated": false,
+              "deprecationReason": null
+            },
             {
               "name": "sessions",
               "description": "Sessions are visits to your Amazon.com browser or mobile app pages by a user.\nAll browser and mobile app activity within a 24-hour period is considered a\nsession. It is calculated as the sum of browserSessions and mobileAppSessions.",

data/lib/peddler/notifications/any_offer_changed/notification.rb

@@ -18,14 +18,14 @@ module Peddler
         # @return [String]
         attribute(:notification_type, String, from: "NotificationType")
 
+        # @return [String]
+        attribute(:notification_version, String, from: "NotificationVersion")
+
         # @return [Payload]
         attribute(:payload, Payload, from: "Payload")
 
         # @return [String]
         attribute(:payload_version, String, from: "PayloadVersion")
-
-        # @return [String]
-        attribute?(:notification_version, String, from: "NotificationVersion")
       end
     end
   end

data/lib/peddler/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Peddler
-  VERSION = "5.1.0"
+  VERSION = "5.2.0"
 end

data/lib/peddler.rb

@@ -45,6 +45,7 @@ module Peddler
     def messaging_v1 = APIs::MessagingV1
     def notifications_v1 = APIs::NotificationsV1
     def orders_v0 = APIs::OrdersV0
+    def orders_2026_01_01 = APIs::Orders20260101
     def product_fees_v0 = APIs::ProductFeesV0
     def product_pricing_v0 = APIs::ProductPricingV0
     def product_pricing_2022_05_01 = APIs::ProductPricing20220501
@@ -102,7 +103,7 @@ module Peddler
     alias_method :merchant_fulfillment, :merchant_fulfillment_v0
     alias_method :messaging, :messaging_v1
     alias_method :notifications, :notifications_v1
-    alias_method :orders, :orders_v0
+    alias_method :orders, :orders_2026_01_01
     alias_method :product_fees, :product_fees_v0
     alias_method :product_pricing, :product_pricing_2022_05_01
     alias_method :product_type_definitions, :product_type_definitions_2020_09_01