amzn_sp_api 0.1.0 → 1.0.1

data/models/orders_api_model/ordersV0.json

@@ -29,7 +29,7 @@
         "tags": [
           "ordersV0"
         ],
-        "description": "Returns orders created or updated during the time frame indicated by the specified parameters. You can also apply a range of filtering criteria to narrow the list of orders returned. If NextToken is present, that will be used to retrieve the orders instead of other criteria.\n\n**Usage Plans:**\n\n| Plan type | Rate (requests per second) | Burst |\n| ---- | ---- | ---- |\n|Default| 0.0055 | 20 |\n|Selling partner specific| Variable | Variable |\n\nThe x-amzn-RateLimit-Limit response header returns the usage plan rate limits that were applied to the requested operation. Rate limits for some selling partners will vary from the default rate and burst shown in the table above. For more information, see \"Usage Plans and Rate Limits\" in the Selling Partner API documentation.",
+        "description": "Returns orders created or updated during the time frame indicated by the specified parameters. You can also apply a range of filtering criteria to narrow the list of orders returned. If NextToken is present, that will be used to retrieve the orders instead of other criteria.\n\n**Usage Plan:**\n\n| Rate (requests per second) | Burst |\n| ---- | ---- |\n| 0.0167 | 20 |\n\nThe `x-amzn-RateLimit-Limit` response header returns the usage plan rate limits that were applied to the requested operation, when available. The table above indicates the default rate and burst values for this operation. Selling partners whose business demands require higher throughput may see higher rate and burst values then those shown here. For more information, see [Usage Plans and Rate Limits in the Selling Partner API](doc:usage-plans-and-rate-limits-in-the-sp-api).",
         "operationId": "getOrders",
         "parameters": [
           {
@@ -63,7 +63,7 @@
           {
             "name": "OrderStatuses",
             "in": "query",
-            "description": "A list of OrderStatus values used to filter the results. Possible values: PendingAvailability (This status is available for pre-orders only. The order has been placed, payment has not been authorized, and the release date of the item is in the future.); Pending (The order has been placed but payment has not been authorized); Unshipped (Payment has been authorized and the order is ready for shipment, but no items in the order have been shipped); PartiallyShipped (One or more, but not all, items in the order have been shipped); Shipped (All items in the order have been shipped); InvoiceUnconfirmed (All items in the order have been shipped. The seller has not yet given confirmation to Amazon that the invoice has been shipped to the buyer.); Canceled (The order has been canceled); and Unfulfillable (The order cannot be fulfilled. This state applies only to Multi-Channel Fulfillment orders.).",
+            "description": "A list of `OrderStatus` values used to filter the results.\n\n**Possible values:**\n- `PendingAvailability` (This status is available for pre-orders only. The order has been placed, payment has not been authorized, and the release date of the item is in the future.)\n- `Pending` (The order has been placed but payment has not been authorized.)\n- `Unshipped` (Payment has been authorized and the order is ready for shipment, but no items in the order have been shipped.)\n- `PartiallyShipped` (One or more, but not all, items in the order have been shipped.)\n- `Shipped` (All items in the order have been shipped.)\n- `InvoiceUnconfirmed` (All items in the order have been shipped. The seller has not yet given confirmation to Amazon that the invoice has been shipped to the buyer.)\n- `Canceled` (The order has been canceled.)\n- `Unfulfillable` (The order cannot be fulfilled. This state applies only to Multi-Channel Fulfillment orders.)",
             "required": false,
             "type": "array",
             "items": {
@@ -125,7 +125,17 @@
           {
             "name": "EasyShipShipmentStatuses",
             "in": "query",
-            "description": "A list of EasyShipShipmentStatus values. Used to select Easy Ship orders with statuses that match the specified  values. If EasyShipShipmentStatus is specified, only Amazon Easy Ship orders are returned.Possible values: PendingPickUp (Amazon has not yet picked up the package from the seller). LabelCanceled (The seller canceled the pickup). PickedUp (Amazon has picked up the package from the seller). AtOriginFC (The packaged is at the origin fulfillment center). AtDestinationFC (The package is at the destination fulfillment center). OutForDelivery (The package is out for delivery). Damaged (The package was damaged by the carrier). Delivered (The package has been delivered to the buyer). RejectedByBuyer (The package has been rejected by the buyer). Undeliverable (The package cannot be delivered). ReturnedToSeller (The package was not delivered to the buyer and was returned to the seller). ReturningToSeller (The package was not delivered to the buyer and is being returned to the seller).",
+            "description": "A list of `EasyShipShipmentStatus` values. Used to select Easy Ship orders with statuses that match the specified values. If `EasyShipShipmentStatus` is specified, only Amazon Easy Ship orders are returned.\n\n**Possible values:**\n- `PendingSchedule` (The package is awaiting the schedule for pick-up.)\n- `PendingPickUp` (Amazon has not yet picked up the package from the seller.)\n- `PendingDropOff` (The seller will deliver the package to the carrier.)\n- `LabelCanceled` (The seller canceled the pickup.)\n- `PickedUp` (Amazon has picked up the package from the seller.)\n- `DroppedOff` (The package is delivered to the carrier by the seller.)\n- `AtOriginFC` (The packaged is at the origin fulfillment center.)\n- `AtDestinationFC` (The package is at the destination fulfillment center.)\n- `Delivered` (The package has been delivered.)\n- `RejectedByBuyer` (The package has been rejected by the buyer.)\n- `Undeliverable` (The package cannot be delivered.)\n- `ReturningToSeller` (The package was not delivered and is being returned to the seller.)\n- `ReturnedToSeller` (The package was not delivered and was returned to the seller.)\n- `Lost` (The package is lost.)\n- `OutForDelivery` (The package is out for delivery.)\n- `Damaged` (The package was damaged by the carrier.)",
+            "required": false,
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          },
+          {
+            "name": "ElectronicInvoiceStatuses",
+            "in": "query",
+            "description": "A list of `ElectronicInvoiceStatus` values. Used to select orders with electronic invoice statuses that match the specified values.\n\n**Possible values:**\n- `NotRequired` (Electronic invoice submission is not required for this order.)\n- `NotFound` (The electronic invoice was not submitted for this order.)\n- `Processing` (The electronic invoice is being processed for this order.)\n- `Errored` (The last submitted electronic invoice was rejected for this order.)\n- `Accepted` (The last submitted electronic invoice was submitted and accepted.)",
             "required": false,
             "type": "array",
             "items": {
@@ -170,6 +180,28 @@
             "description": "The store chain store identifier. Linked to a specific store in a store chain.",
             "required": false,
             "type": "string"
+          },
+          {
+            "name": "ItemApprovalTypes",
+            "in": "query",
+            "description": "When set, only return orders that contain items which approval type is contained in the specified approval types.",
+            "required": false,
+            "type": "array",
+            "items": {
+              "$ref": "#/definitions/ItemApprovalType"
+            },
+            "maxItems": 1
+          },
+          {
+            "name": "ItemApprovalStatus",
+            "in": "query",
+            "description": "When set, only return orders that contain items which approval status is contained in the specified approval status.",
+            "required": false,
+            "type": "array",
+            "items": {
+              "$ref": "#/definitions/ItemApprovalStatus"
+            },
+            "maxItems": 6
           }
         ],
         "responses": {
@@ -203,6 +235,7 @@
                       "LatestShipDate": "2017-01-25T19:49:35Z",
                       "IsBusinessOrder": false,
                       "IsPrime": false,
+                      "IsAccessPointOrder": false,
                       "IsGlobalExpressEnabled": false,
                       "IsPremiumOrder": false,
                       "IsSoldByAB": false,
@@ -235,7 +268,7 @@
               },
               "x-amzn-RequestId": {
                 "type": "string",
-                "description": "Unique request reference ID."
+                "description": "Unique request reference identifier."
               }
             },
             "x-amzn-api-sandbox": {
@@ -303,9 +336,12 @@
                           "FulfillmentSupplySourceId": "sampleSupplySourceId"
                         },
                         "IsISPU": false,
+                        "IsAccessPointOrder": false,
                         "AutomatedShippingSettings": {
                           "HasAutomatedShippingSettings": false
-                        }
+                        },
+                        "EasyShipShipmentStatus": "PendingPickUp",
+                        "ElectronicInvoiceStatus": "NotRequired"
                       },
                       {
                         "AmazonOrderId": "902-8745147-1934268",
@@ -335,10 +371,13 @@
                         "LatestDeliveryDate": "1970-01-19T04:15:17Z",
                         "IsBusinessOrder": false,
                         "IsPrime": false,
+                        "IsAccessPointOrder": false,
                         "IsGlobalExpressEnabled": false,
                         "IsPremiumOrder": false,
                         "IsSoldByAB": false,
-                        "IsIBA": false
+                        "IsIBA": false,
+                        "EasyShipShipmentStatus": "PendingPickUp",
+                        "ElectronicInvoiceStatus": "NotRequired"
                       }
                     ]
                   }
@@ -377,10 +416,13 @@
                         "MarketplaceId": "ATVPDKIKX0DER",
                         "ShipmentServiceLevelCategory": "Standard",
                         "OrderType": "StandardOrder",
+                        "EasyShipShipmentStatus": "PendingPickUp",
+                        "ElectronicInvoiceStatus": "NotRequired",
                         "EarliestShipDate": "2017-01-20T19:51:16Z",
                         "LatestShipDate": "2017-01-25T19:49:35Z",
                         "IsBusinessOrder": false,
                         "IsPrime": false,
+                        "IsAccessPointOrder": false,
                         "IsGlobalExpressEnabled": false,
                         "IsPremiumOrder": false,
                         "IsSoldByAB": false,
@@ -425,10 +467,13 @@
                         "MarketplaceId": "ATVPDKIKX0DER",
                         "ShipmentServiceLevelCategory": "Standard",
                         "OrderType": "StandardOrder",
+                        "EasyShipShipmentStatus": "PendingPickUp",
+                        "ElectronicInvoiceStatus": "NotRequired",
                         "EarliestShipDate": "2017-01-20T19:51:16Z",
                         "LatestShipDate": "2017-01-25T19:49:35Z",
                         "IsBusinessOrder": false,
                         "IsPrime": false,
+                        "IsAccessPointOrder": false,
                         "IsGlobalExpressEnabled": false,
                         "IsPremiumOrder": false,
                         "IsSoldByAB": false,
@@ -453,7 +498,7 @@
               },
               "x-amzn-RequestId": {
                 "type": "string",
-                "description": "Unique request reference ID."
+                "description": "Unique request reference identifier."
               }
             },
             "x-amzn-api-sandbox": {
@@ -486,7 +531,7 @@
             "headers": {
               "x-amzn-RequestId": {
                 "type": "string",
-                "description": "Unique request reference ID."
+                "description": "Unique request reference identifier."
               }
             }
           },
@@ -502,7 +547,7 @@
               },
               "x-amzn-RequestId": {
                 "type": "string",
-                "description": "Unique request reference ID."
+                "description": "Unique request reference identifier."
               }
             }
           },
@@ -518,7 +563,7 @@
               },
               "x-amzn-RequestId": {
                 "type": "string",
-                "description": "Unique request reference ID."
+                "description": "Unique request reference identifier."
               }
             }
           },
@@ -534,7 +579,7 @@
               },
               "x-amzn-RequestId": {
                 "type": "string",
-                "description": "Unique request reference ID."
+                "description": "Unique request reference identifier."
               }
             }
           },
@@ -550,7 +595,7 @@
               },
               "x-amzn-RequestId": {
                 "type": "string",
-                "description": "Unique request reference ID."
+                "description": "Unique request reference identifier."
               }
             }
           }
@@ -562,7 +607,7 @@
         "tags": [
           "ordersV0"
         ],
-        "description": "Returns the order indicated by the specified order ID.\n\n**Usage Plans:**\n\n| Plan type | Rate (requests per second) | Burst |\n| ---- | ---- | ---- |\n|Default| 0.0055 | 20 |\n|Selling partner specific| Variable | Variable |\n\nThe x-amzn-RateLimit-Limit response header returns the usage plan rate limits that were applied to the requested operation. Rate limits for some selling partners will vary from the default rate and burst shown in the table above. For more information, see \"Usage Plans and Rate Limits\" in the Selling Partner API documentation.",
+        "description": "Returns the order that you specify.\n\n**Usage Plan:**\n\n| Rate (requests per second) | Burst |\n| ---- | ---- |\n| 0.0167 | 20 |\n\nThe `x-amzn-RateLimit-Limit` response header returns the usage plan rate limits that were applied to the requested operation, when available. The table above indicates the default rate and burst values for this operation. Selling partners whose business demands require higher throughput may see higher rate and burst values then those shown here. For more information, see [Usage Plans and Rate Limits in the Selling Partner API](doc:usage-plans-and-rate-limits-in-the-sp-api).",
         "operationId": "getOrder",
         "parameters": [
           {
@@ -619,6 +664,7 @@
                     "FulfillmentSupplySourceId": "sampleSupplySourceId"
                   },
                   "IsISPU": false,
+                  "IsAccessPointOrder": false,
                   "ShippingAddress": {
                     "Name": "Michigan address",
                     "AddressLine1": "1 Cross St.",
@@ -648,7 +694,7 @@
               },
               "x-amzn-RequestId": {
                 "type": "string",
-                "description": "Unique request reference ID."
+                "description": "Unique request reference identifier."
               }
             },
             "x-amzn-api-sandbox": {
@@ -708,9 +754,12 @@
                       "FulfillmentSupplySourceId": "sampleSupplySourceId"
                     },
                     "IsISPU": false,
+                    "IsAccessPointOrder": false,
                     "AutomatedShippingSettings": {
                       "HasAutomatedShippingSettings": false
-                    }
+                    },
+                    "EasyShipShipmentStatus": "PendingPickUp",
+                    "ElectronicInvoiceStatus": "NotRequired"
                   }
                 }
               },
@@ -769,9 +818,12 @@
                       "FulfillmentSupplySourceId": "sampleSupplySourceId"
                     },
                     "IsISPU": false,
+                    "IsAccessPointOrder": false,
                     "AutomatedShippingSettings": {
                       "HasAutomatedShippingSettings": false
-                    }
+                    },
+                    "EasyShipShipmentStatus": "PendingPickUp",
+                    "ElectronicInvoiceStatus": "NotRequired"
                   }
                 }
               }
@@ -790,7 +842,7 @@
               },
               "x-amzn-RequestId": {
                 "type": "string",
-                "description": "Unique request reference ID."
+                "description": "Unique request reference identifier."
               }
             },
             "x-amzn-api-sandbox": {
@@ -823,7 +875,7 @@
             "headers": {
               "x-amzn-RequestId": {
                 "type": "string",
-                "description": "Unique request reference ID."
+                "description": "Unique request reference identifier."
               }
             }
           },
@@ -839,7 +891,7 @@
               },
               "x-amzn-RequestId": {
                 "type": "string",
-                "description": "Unique request reference ID."
+                "description": "Unique request reference identifier."
               }
             }
           },
@@ -855,7 +907,7 @@
               },
               "x-amzn-RequestId": {
                 "type": "string",
-                "description": "Unique request reference ID."
+                "description": "Unique request reference identifier."
               }
             }
           },
@@ -871,7 +923,7 @@
               },
               "x-amzn-RequestId": {
                 "type": "string",
-                "description": "Unique request reference ID."
+                "description": "Unique request reference identifier."
               }
             }
           },
@@ -887,7 +939,7 @@
               },
               "x-amzn-RequestId": {
                 "type": "string",
-                "description": "Unique request reference ID."
+                "description": "Unique request reference identifier."
               }
             }
           }
@@ -899,7 +951,7 @@
         "tags": [
           "ordersV0"
         ],
-        "description": "Returns buyer information for the specified order.\n\n**Usage Plans:**\n\n| Plan type | Rate (requests per second) | Burst |\n| ---- | ---- | ---- |\n|Default| 0.0055 | 20 |\n|Selling partner specific| Variable | Variable |\n\nThe x-amzn-RateLimit-Limit response header returns the usage plan rate limits that were applied to the requested operation. Rate limits for some selling partners will vary from the default rate and burst shown in the table above. For more information, see \"Usage Plans and Rate Limits\" in the Selling Partner API documentation.",
+        "description": "Returns buyer information for the order that you specify.\n\n**Usage Plan:**\n\n| Rate (requests per second) | Burst |\n| ---- | ---- |\n| 0.0167 | 20 |\n\nThe `x-amzn-RateLimit-Limit` response header returns the usage plan rate limits that were applied to the requested operation, when available. The table above indicates the default rate and burst values for this operation. Selling partners whose business demands require higher throughput may see higher rate and burst values then those shown here. For more information, see [Usage Plans and Rate Limits in the Selling Partner API](doc:usage-plans-and-rate-limits-in-the-sp-api).",
         "operationId": "getOrderBuyerInfo",
         "parameters": [
           {
@@ -936,7 +988,7 @@
               },
               "x-amzn-RequestId": {
                 "type": "string",
-                "description": "Unique request reference ID."
+                "description": "Unique request reference identifier."
               }
             },
             "x-amzn-api-sandbox": {
@@ -972,7 +1024,7 @@
               },
               "x-amzn-RequestId": {
                 "type": "string",
-                "description": "Unique request reference ID."
+                "description": "Unique request reference identifier."
               }
             },
             "x-amzn-api-sandbox": {
@@ -1005,7 +1057,7 @@
             "headers": {
               "x-amzn-RequestId": {
                 "type": "string",
-                "description": "Unique request reference ID."
+                "description": "Unique request reference identifier."
               }
             }
           },
@@ -1021,7 +1073,7 @@
               },
               "x-amzn-RequestId": {
                 "type": "string",
-                "description": "Unique request reference ID."
+                "description": "Unique request reference identifier."
               }
             }
           },
@@ -1037,7 +1089,7 @@
               },
               "x-amzn-RequestId": {
                 "type": "string",
-                "description": "Unique request reference ID."
+                "description": "Unique request reference identifier."
               }
             }
           },
@@ -1053,7 +1105,7 @@
               },
               "x-amzn-RequestId": {
                 "type": "string",
-                "description": "Unique request reference ID."
+                "description": "Unique request reference identifier."
               }
             }
           },
@@ -1069,7 +1121,7 @@
               },
               "x-amzn-RequestId": {
                 "type": "string",
-                "description": "Unique request reference ID."
+                "description": "Unique request reference identifier."
               }
             }
           }
@@ -1081,7 +1133,7 @@
         "tags": [
           "ordersV0"
         ],
-        "description": "Returns the shipping address for the specified order.\n\n**Usage Plans:**\n\n| Plan type | Rate (requests per second) | Burst |\n| ---- | ---- | ---- |\n|Default| 0.0055 | 20 |\n|Selling partner specific| Variable | Variable |\n\nThe x-amzn-RateLimit-Limit response header returns the usage plan rate limits that were applied to the requested operation. Rate limits for some selling partners will vary from the default rate and burst shown in the table above. For more information, see \"Usage Plans and Rate Limits\" in the Selling Partner API documentation.",
+        "description": "Returns the shipping address for the order that you specify.\n\n**Usage Plan:**\n\n| Rate (requests per second) | Burst |\n| ---- | ---- |\n| 0.0167 | 20 |\n\nThe `x-amzn-RateLimit-Limit` response header returns the usage plan rate limits that were applied to the requested operation, when available. The table above indicates the default rate and burst values for this operation. Selling partners whose business demands require higher throughput may see higher rate and burst values then those shown here. For more information, see [Usage Plans and Rate Limits in the Selling Partner API](doc:usage-plans-and-rate-limits-in-the-sp-api).",
         "operationId": "getOrderAddress",
         "parameters": [
           {
@@ -1120,7 +1172,7 @@
               },
               "x-amzn-RequestId": {
                 "type": "string",
-                "description": "Unique request reference ID."
+                "description": "Unique request reference identifier."
               }
             },
             "x-amzn-api-sandbox": {
@@ -1164,7 +1216,7 @@
               },
               "x-amzn-RequestId": {
                 "type": "string",
-                "description": "Unique request reference ID."
+                "description": "Unique request reference identifier."
               }
             },
             "x-amzn-api-sandbox": {
@@ -1197,7 +1249,7 @@
             "headers": {
               "x-amzn-RequestId": {
                 "type": "string",
-                "description": "Unique request reference ID."
+                "description": "Unique request reference identifier."
               }
             }
           },
@@ -1213,7 +1265,7 @@
               },
               "x-amzn-RequestId": {
                 "type": "string",
-                "description": "Unique request reference ID."
+                "description": "Unique request reference identifier."
               }
             }
           },
@@ -1229,7 +1281,7 @@
               },
               "x-amzn-RequestId": {
                 "type": "string",
-                "description": "Unique request reference ID."
+                "description": "Unique request reference identifier."
               }
             }
           },
@@ -1245,7 +1297,7 @@
               },
               "x-amzn-RequestId": {
                 "type": "string",
-                "description": "Unique request reference ID."
+                "description": "Unique request reference identifier."
               }
             }
           },
@@ -1261,7 +1313,7 @@
               },
               "x-amzn-RequestId": {
                 "type": "string",
-                "description": "Unique request reference ID."
+                "description": "Unique request reference identifier."
               }
             }
           }
@@ -1273,7 +1325,7 @@
         "tags": [
           "ordersV0"
         ],
-        "description": "Returns detailed order item information for the order indicated by the specified order ID. If NextToken is provided, it's used to retrieve the next page of order items.\n\nNote: When an order is in the Pending state (the order has been placed but payment has not been authorized), the getOrderItems operation does not return information about pricing, taxes, shipping charges, gift status or promotions for the order items in the order. After an order leaves the Pending state (this occurs when payment has been authorized) and enters the Unshipped, Partially Shipped, or Shipped state, the getOrderItems operation returns information about pricing, taxes, shipping charges, gift status and promotions for the order items in the order.\n\n**Usage Plans:**\n\n| Plan type | Rate (requests per second) | Burst |\n| ---- | ---- | ---- |\n|Default| 0.0055 | 20 |\n|Selling partner specific| Variable | Variable |\n\nThe x-amzn-RateLimit-Limit response header returns the usage plan rate limits that were applied to the requested operation. Rate limits for some selling partners will vary from the default rate and burst shown in the table above. For more information, see \"Usage Plans and Rate Limits\" in the Selling Partner API documentation.",
+        "description": "Returns detailed order item information for the order that you specify. If NextToken is provided, it's used to retrieve the next page of order items.\n\n__Note__: When an order is in the Pending state (the order has been placed but payment has not been authorized), the getOrderItems operation does not return information about pricing, taxes, shipping charges, gift status or promotions for the order items in the order. After an order leaves the Pending state (this occurs when payment has been authorized) and enters the Unshipped, Partially Shipped, or Shipped state, the getOrderItems operation returns information about pricing, taxes, shipping charges, gift status and promotions for the order items in the order.\n\n**Usage Plan:**\n\n| Rate (requests per second) | Burst |\n| ---- | ---- |\n| 0.5 | 30 |\n\nThe `x-amzn-RateLimit-Limit` response header returns the usage plan rate limits that were applied to the requested operation, when available. The table above indicates the default rate and burst values for this operation. Selling partners whose business demands require higher throughput may see higher rate and burst values then those shown here. For more information, see [Usage Plans and Rate Limits in the Selling Partner API](doc:usage-plans-and-rate-limits-in-the-sp-api).",
         "operationId": "getOrderItems",
         "parameters": [
           {
@@ -1350,7 +1402,8 @@
                       "BuyerRequestedCancel": {
                         "IsBuyerRequestedCancel": true,
                         "BuyerCancelReason": "Found cheaper somewhere else."
-                      }
+                      },
+                      "SerialNumbers": ["854"]
                     },
                     {
                       "ASIN": "BCTU1104UEFB",
@@ -1396,7 +1449,7 @@
               },
               "x-amzn-RequestId": {
                 "type": "string",
-                "description": "Unique request reference ID."
+                "description": "Unique request reference identifier."
               }
             },
             "x-amzn-api-sandbox": {
@@ -1467,7 +1520,7 @@
               },
               "x-amzn-RequestId": {
                 "type": "string",
-                "description": "Unique request reference ID."
+                "description": "Unique request reference identifier."
               }
             },
             "x-amzn-api-sandbox": {
@@ -1500,7 +1553,7 @@
             "headers": {
               "x-amzn-RequestId": {
                 "type": "string",
-                "description": "Unique request reference ID."
+                "description": "Unique request reference identifier."
               }
             }
           },
@@ -1516,7 +1569,7 @@
               },
               "x-amzn-RequestId": {
                 "type": "string",
-                "description": "Unique request reference ID."
+                "description": "Unique request reference identifier."
               }
             }
           },
@@ -1532,7 +1585,7 @@
               },
               "x-amzn-RequestId": {
                 "type": "string",
-                "description": "Unique request reference ID."
+                "description": "Unique request reference identifier."
               }
             }
           },
@@ -1548,7 +1601,7 @@
               },
               "x-amzn-RequestId": {
                 "type": "string",
-                "description": "Unique request reference ID."
+                "description": "Unique request reference identifier."
               }
             }
           },
@@ -1564,7 +1617,7 @@
               },
               "x-amzn-RequestId": {
                 "type": "string",
-                "description": "Unique request reference ID."
+                "description": "Unique request reference identifier."
               }
             }
           }
@@ -1576,7 +1629,7 @@
         "tags": [
           "ordersV0"
         ],
-        "description": "Returns buyer information for the order items in the specified order.\n\n**Usage Plans:**\n\n| Plan type | Rate (requests per second) | Burst |\n| ---- | ---- | ---- |\n|Default| 0.0055 | 20 |\n|Selling partner specific| Variable | Variable |\n\nThe x-amzn-RateLimit-Limit response header returns the usage plan rate limits that were applied to the requested operation. Rate limits for some selling partners will vary from the default rate and burst shown in the table above. For more information, see \"Usage Plans and Rate Limits\" in the Selling Partner API documentation.",
+        "description": "Returns buyer information for the order items in the order that you specify.\n\n**Usage Plan:**\n\n| Rate (requests per second) | Burst |\n| ---- | ---- |\n| 0.5 | 30 |\n\nThe `x-amzn-RateLimit-Limit` response header returns the usage plan rate limits that were applied to the requested operation, when available. The table above indicates the default rate and burst values for this operation. Selling partners whose business demands require higher throughput may see higher rate and burst values then those shown here. For more information, see [Usage Plans and Rate Limits in the Selling Partner API](doc:usage-plans-and-rate-limits-in-the-sp-api).",
         "operationId": "getOrderItemsBuyerInfo",
         "parameters": [
           {
@@ -1623,7 +1676,7 @@
               },
               "x-amzn-RequestId": {
                 "type": "string",
-                "description": "Unique request reference ID."
+                "description": "Unique request reference identifier."
               }
             },
             "x-amzn-api-sandbox": {
@@ -1670,7 +1723,7 @@
               },
               "x-amzn-RequestId": {
                 "type": "string",
-                "description": "Unique request reference ID."
+                "description": "Unique request reference identifier."
               }
             },
             "x-amzn-api-sandbox": {
@@ -1703,7 +1756,7 @@
             "headers": {
               "x-amzn-RequestId": {
                 "type": "string",
-                "description": "Unique request reference ID."
+                "description": "Unique request reference identifier."
               }
             }
           },
@@ -1719,7 +1772,7 @@
               },
               "x-amzn-RequestId": {
                 "type": "string",
-                "description": "Unique request reference ID."
+                "description": "Unique request reference identifier."
               }
             }
           },
@@ -1735,7 +1788,7 @@
               },
               "x-amzn-RequestId": {
                 "type": "string",
-                "description": "Unique request reference ID."
+                "description": "Unique request reference identifier."
               }
             }
           },
@@ -1751,7 +1804,7 @@
               },
               "x-amzn-RequestId": {
                 "type": "string",
-                "description": "Unique request reference ID."
+                "description": "Unique request reference identifier."
               }
             }
           },
@@ -1767,7 +1820,7 @@
               },
               "x-amzn-RequestId": {
                 "type": "string",
-                "description": "Unique request reference ID."
+                "description": "Unique request reference identifier."
               }
             }
           }
@@ -1779,7 +1832,7 @@
         "tags": [
           "shipment"
         ],
-        "description": "Update the shipment status.",
+        "description": "Update the shipment status for an order that you specify.\n\n**Usage Plan:**\n\n| Rate (requests per second) | Burst |\n| ---- | ---- |\n| 5 | 15 |\n\nThe `x-amzn-RateLimit-Limit` response header returns the usage plan rate limits that were applied to the requested operation, when available. The table above indicates the default rate and burst values for this operation. Selling partners whose business demands require higher throughput may see higher rate and burst values then those shown here. For more information, see [Usage Plans and Rate Limits in the Selling Partner API](doc:usage-plans-and-rate-limits-in-the-sp-api).",
         "operationId": "updateShipmentStatus",
         "parameters": [
           {
@@ -1792,7 +1845,7 @@
           {
             "name": "payload",
             "in": "body",
-            "description": "Request to update the shipment status.",
+            "description": "The request body for the updateShipmentStatus operation.",
             "required": true,
             "schema": {
               "$ref": "#/definitions/UpdateShipmentStatusRequest"
@@ -1818,7 +1871,7 @@
                 "type": "string"
               },
               "x-amzn-RequestId": {
-                "description": "Unique request reference ID.",
+                "description": "Unique request reference identifier.",
                 "type": "string"
               }
             }
@@ -1856,7 +1909,7 @@
                 "type": "string"
               },
               "x-amzn-RequestId": {
-                "description": "Unique request reference ID.",
+                "description": "Unique request reference identifier.",
                 "type": "string"
               }
             },
@@ -1868,7 +1921,7 @@
             "description": "Indicates that access to the resource is forbidden. Possible reasons include Access Denied, Unauthorized, Expired Token, or Invalid Signature.",
             "headers": {
               "x-amzn-RequestId": {
-                "description": "Unique request reference ID.",
+                "description": "Unique request reference identifier.",
                 "type": "string"
               }
             },
@@ -1884,7 +1937,7 @@
                 "type": "string"
               },
               "x-amzn-RequestId": {
-                "description": "Unique request reference ID.",
+                "description": "Unique request reference identifier.",
                 "type": "string"
               }
             },
@@ -1896,7 +1949,7 @@
             "description": "The request size exceeded the maximum accepted size.",
             "headers": {
               "x-amzn-RequestId": {
-                "description": "Unique request reference ID.",
+                "description": "Unique request reference identifier.",
                 "type": "string"
               }
             },
@@ -1908,7 +1961,7 @@
             "description": "The request payload is in an unsupported format.",
             "headers": {
               "x-amzn-RequestId": {
-                "description": "Unique request reference ID.",
+                "description": "Unique request reference identifier.",
                 "type": "string"
               }
             },
@@ -1920,7 +1973,7 @@
             "description": "The frequency of requests was greater than allowed.",
             "headers": {
               "x-amzn-RequestId": {
-                "description": "Unique request reference ID.",
+                "description": "Unique request reference identifier.",
                 "type": "string"
               }
             },
@@ -1932,7 +1985,7 @@
             "description": "An unexpected condition occurred that prevented the server from fulfilling the request.",
             "headers": {
               "x-amzn-RequestId": {
-                "description": "Unique request reference ID.",
+                "description": "Unique request reference identifier.",
                 "type": "string"
               }
             },
@@ -1944,7 +1997,7 @@
             "description": "Temporary overloading or maintenance of the server.",
             "headers": {
               "x-amzn-RequestId": {
-                "description": "Unique request reference ID.",
+                "description": "Unique request reference identifier.",
                 "type": "string"
               }
             },
@@ -1960,7 +2013,7 @@
         "tags": [
           "ordersV0"
         ],
-        "description": "Returns regulated information for the order indicated by the specified order ID.\n\n**Usage Plans:**\n\n| Plan type | Rate (requests per second) | Burst |\n| ---- | ---- | ---- |\n|Default| 0.0055 | 20 |\n|Selling partner specific| Variable | Variable |\n\nThe x-amzn-RateLimit-Limit response header returns the usage plan rate limits that were applied to the requested operation. Rate limits for some selling partners will vary from the default rate and burst shown in the table above. For more information, see \"Usage Plans and Rate Limits\" in the Selling Partner API documentation.",
+        "description": "Returns regulated information for the order that you specify.\n\n**Usage Plan:**\n\n| Rate (requests per second) | Burst |\n| ---- | ---- |\n| 0.5 | 30 |\n\nThe `x-amzn-RateLimit-Limit` response header returns the usage plan rate limits that were applied to the requested operation, when available. The table above indicates the default rate and burst values for this operation. Selling partners whose business demands require higher throughput may see higher rate and burst values then those shown here. For more information, see [Usage Plans and Rate Limits in the Selling Partner API](doc:usage-plans-and-rate-limits-in-the-sp-api).",
         "operationId": "getOrderRegulatedInfo",
         "parameters": [
           {
@@ -1984,7 +2037,7 @@
               },
               "x-amzn-RequestId": {
                 "type": "string",
-                "description": "Unique request reference ID."
+                "description": "Unique request reference identifier."
               }
             },
             "x-amzn-api-sandbox": {
@@ -2038,7 +2091,7 @@
                     }
                   }
                 }
-              ]  
+              ]
             },
             "examples": {
               "PendingOrder": {
@@ -2157,7 +2210,7 @@
               },
               "x-amzn-RequestId": {
                 "type": "string",
-                "description": "Unique request reference ID."
+                "description": "Unique request reference identifier."
               }
             },
             "x-amzn-api-sandbox": {
@@ -2190,7 +2243,7 @@
             "headers": {
               "x-amzn-RequestId": {
                 "type": "string",
-                "description": "Unique request reference ID."
+                "description": "Unique request reference identifier."
               }
             }
           },
@@ -2206,7 +2259,7 @@
               },
               "x-amzn-RequestId": {
                 "type": "string",
-                "description": "Unique request reference ID."
+                "description": "Unique request reference identifier."
               }
             }
           },
@@ -2216,13 +2269,9 @@
               "$ref": "#/definitions/GetOrderRegulatedInfoResponse"
             },
             "headers": {
-              "x-amzn-RateLimit-Limit": {
-                "type": "string",
-                "description": "Your rate limit (requests per second) for this operation."
-              },
               "x-amzn-RequestId": {
                 "type": "string",
-                "description": "Unique request reference ID."
+                "description": "Unique request reference identifier."
               }
             }
           },
@@ -2232,13 +2281,9 @@
               "$ref": "#/definitions/GetOrderRegulatedInfoResponse"
             },
             "headers": {
-              "x-amzn-RateLimit-Limit": {
-                "type": "string",
-                "description": "Your rate limit (requests per second) for this operation."
-              },
               "x-amzn-RequestId": {
                 "type": "string",
-                "description": "Unique request reference ID."
+                "description": "Unique request reference identifier."
               }
             }
           },
@@ -2248,13 +2293,9 @@
               "$ref": "#/definitions/GetOrderRegulatedInfoResponse"
             },
             "headers": {
-              "x-amzn-RateLimit-Limit": {
-                "type": "string",
-                "description": "Your rate limit (requests per second) for this operation."
-              },
               "x-amzn-RequestId": {
                 "type": "string",
-                "description": "Unique request reference ID."
+                "description": "Unique request reference identifier."
               }
             }
           }
@@ -2264,7 +2305,7 @@
         "tags": [
           "ordersV0"
         ],
-        "description": "Updates (approves or rejects) the verification status of an order containing regulated products.\n\n**Usage Plans:**\n\n| Plan type | Rate (requests per second) | Burst |\n| ---- | ---- | ---- |\n|Default| 0.0055 | 20 |\n|Selling partner specific| Variable | Variable |\n\nThe x-amzn-RateLimit-Limit response header returns the usage plan rate limits that were applied to the requested operation. Rate limits for some selling partners will vary from the default rate and burst shown in the table above. For more information, see \"Usage Plans and Rate Limits\" in the Selling Partner API documentation.",
+        "description": "Updates (approves or rejects) the verification status of an order containing regulated products.\n\n**Usage Plan:**\n\n| Rate (requests per second) | Burst |\n| ---- | ---- |\n| 0.5 | 30 |\n\nThe `x-amzn-RateLimit-Limit` response header returns the usage plan rate limits that were applied to the requested operation, when available. The table above indicates the default rate and burst values for this operation. Selling partners whose business demands require higher throughput may see higher rate and burst values then those shown here. For more information, see [Usage Plans and Rate Limits in the Selling Partner API](doc:usage-plans-and-rate-limits-in-the-sp-api).",
         "operationId": "updateVerificationStatus",
         "parameters": [
           {
@@ -2277,7 +2318,7 @@
           {
             "name": "payload",
             "in": "body",
-            "description": "Request to update the verification status of an order containing regulated products.",
+            "description": "The request body for the updateVerificationStatus operation.",
             "required": true,
             "schema": {
               "$ref": "#/definitions/UpdateVerificationStatusRequest"
@@ -2316,7 +2357,7 @@
                 "type": "string"
               },
               "x-amzn-RequestId": {
-                "description": "Unique request reference ID.",
+                "description": "Unique request reference identifier.",
                 "type": "string"
               }
             }
@@ -2386,7 +2427,7 @@
                 "type": "string"
               },
               "x-amzn-RequestId": {
-                "description": "Unique request reference ID.",
+                "description": "Unique request reference identifier.",
                 "type": "string"
               }
             },
@@ -2398,7 +2439,7 @@
             "description": "Indicates that access to the resource is forbidden. Possible reasons include Access Denied, Unauthorized, Expired Token, or Invalid Signature.",
             "headers": {
               "x-amzn-RequestId": {
-                "description": "Unique request reference ID.",
+                "description": "Unique request reference identifier.",
                 "type": "string"
               }
             },
@@ -2414,7 +2455,7 @@
                 "type": "string"
               },
               "x-amzn-RequestId": {
-                "description": "Unique request reference ID.",
+                "description": "Unique request reference identifier.",
                 "type": "string"
               }
             },
@@ -2426,7 +2467,7 @@
             "description": "The request size exceeded the maximum accepted size.",
             "headers": {
               "x-amzn-RequestId": {
-                "description": "Unique request reference ID.",
+                "description": "Unique request reference identifier.",
                 "type": "string"
               }
             },
@@ -2438,7 +2479,7 @@
             "description": "The request payload is in an unsupported format.",
             "headers": {
               "x-amzn-RequestId": {
-                "description": "Unique request reference ID.",
+                "description": "Unique request reference identifier.",
                 "type": "string"
               }
             },
@@ -2450,7 +2491,7 @@
             "description": "The frequency of requests was greater than allowed.",
             "headers": {
               "x-amzn-RequestId": {
-                "description": "Unique request reference ID.",
+                "description": "Unique request reference identifier.",
                 "type": "string"
               }
             },
@@ -2462,7 +2503,7 @@
             "description": "An unexpected condition occurred that prevented the server from fulfilling the request.",
             "headers": {
               "x-amzn-RequestId": {
-                "description": "Unique request reference ID.",
+                "description": "Unique request reference identifier.",
                 "type": "string"
               }
             },
@@ -2474,7 +2515,7 @@
             "description": "Temporary overloading or maintenance of the server.",
             "headers": {
               "x-amzn-RequestId": {
-                "description": "Unique request reference ID.",
+                "description": "Unique request reference identifier.",
                 "type": "string"
               }
             },
@@ -2484,208 +2525,913 @@
           }
         }
       }
-    }
-  },
-  "definitions": {
-    "UpdateShipmentStatusRequest": {
-      "description": "Request to update the status of shipment of an order.",
-      "type": "object",
-      "properties": {
-        "marketplaceId": {
-          "$ref": "#/definitions/MarketplaceId"
-        },
-        "shipmentStatus": {
-          "$ref": "#/definitions/ShipmentStatus"
-        },
-        "orderItems": {
-          "$ref": "#/definitions/OrderItems"
-        }
-      },
-      "required": [
-        "marketplaceId",
-        "shipmentStatus"
-      ]
-    },
-    "UpdateVerificationStatusRequest": {
-      "description": "Request to update the verification status of an order containing regulated products.",
-      "type": "object",
-      "properties": {
-        "regulatedOrderVerificationStatus": {
-          "description": "The updated values of the VerificationStatus field.",
-          "$ref": "#/definitions/UpdateVerificationStatusRequestBody"
-        }
-      },
-      "required": [
-        "regulatedOrderVerificationStatus"
-      ]
-    },
-    "UpdateVerificationStatusRequestBody": {
-      "description": "The updated values of the VerificationStatus field.",
-      "type": "object",
-      "properties": {
-        "status": {
-          "description": "The new verification status of the order.",
-          "type": "string",
-          "enum": [
-            "Approved",
-            "Rejected"
-          ],
-          "x-docgen-enum-table-extension": [
-            {
-              "value": "Approved",
-              "description": "The order's regulated information has been reviewed and approved."
-            },
-            {
-              "value": "Rejected",
-              "description": "The order's regulated information has been reviewed and rejected."
-            }
-          ]
-        },
-        "externalReviewerId": {
-          "description": "The identifier for the order's regulated information reviewer.",
-          "type": "string"
-        },
-        "rejectionReasonId": {
-          "description": "The unique identifier for the rejection reason used for rejecting the order's regulated information. Only required if the new status is rejected.",
-          "type": "string"
-        }
-      },
-      "required": [
-        "status",
-        "externalReviewerId"
-      ]
-    },
-    "MarketplaceId": {
-      "description": "the unobfuscated marketplace ID",
-      "type": "string"
-    },
-    "ShipmentStatus": {
-      "description": "the status of the shipment of the order to be updated",
-      "type": "string",
-      "enum": [
-        "ReadyForPickup",
-        "PickedUp",
-        "RefusedPickup"
-      ]
     },
-    "OrderItems": {
-      "description": "the list of order items and quantities when the seller wants to partially update the shipment status of the order",
-      "type": "array",
-      "items": {
-        "type": "object",
-        "properties": {
-          "orderItemId": {
-            "description": "the unique identifier for the order item",
+    "/orders/v0/orders/{orderId}/approvals": {
+      "get": {
+        "tags": [
+          "approvals"
+        ],
+        "description": "Returns detailed order items approvals information for the order specified. If NextToken is provided, it's used to retrieve the next page of order items approvals.\n\n**Usage Plans:**\n\n| Plan type | Rate (requests per second) | Burst |\n| ---- | ---- | ---- |\n|Default| 0.5 | 30 |\n|Selling partner specific| Variable | Variable |\n\nThe x-amzn-RateLimit-Limit response header returns the usage plan rate limits that were applied to the requested operation. Rate limits for some selling partners will vary from the default rate and burst shown in the table above. For more information, see \"Usage Plans and Rate Limits\" in the Selling Partner API documentation.",
+        "operationId": "getOrderItemsApprovals",
+        "parameters": [
+          {
+            "name": "orderId",
+            "in": "path",
+            "description": "An Amazon-defined order identifier, in 3-7-7 format, e.g. 933-1671587-0818628.",
+            "required": true,
             "type": "string"
           },
-          "quantity": {
-            "type": "integer",
-            "description": "the quantity of items that needs an update of the shipment status"
+          {
+            "name": "NextToken",
+            "in": "query",
+            "description": "A string token returned in the response of your previous request.",
+            "required": false,
+            "type": "string"
+          },
+          {
+            "name": "ItemApprovalTypes",
+            "in": "query",
+            "description": "When set, only return approvals for items which approval type is contained in the specified approval types.",
+            "required": false,
+            "type": "array",
+            "items": {
+              "$ref": "#/definitions/ItemApprovalType"
+            },
+            "maxItems": 1
+          },
+          {
+            "name": "ItemApprovalStatus",
+            "in": "query",
+            "description": "When set, only return approvals that contain items which approval status is contained in the specified approval status.",
+            "required": false,
+            "type": "array",
+            "items": {
+              "$ref": "#/definitions/ItemApprovalStatus"
+            },
+            "maxItems": 6
           }
-        }
-      }
-    },
-    "UpdateShipmentStatusErrorResponse": {
-      "type": "object",
-      "properties": {
-        "errors": {
-          "description": "One or more unexpected errors occurred during the UpdateShipmentStatus operation.",
-          "$ref": "#/definitions/ErrorList"
-        }
-      },
-      "description": "The error response schema for the UpdateShipmentStatus operation."
-    },
-    "UpdateVerificationStatusErrorResponse": {
-      "type": "object",
-      "properties": {
-        "errors": {
-          "description": "One or more unexpected errors occurred during the UpdateVerificationStatus operation.",
-          "$ref": "#/definitions/ErrorList"
-        }
-      },
-      "description": "The error response schema for the UpdateVerificationStatus operation."
-    },
-    "GetOrdersResponse": {
-      "type": "object",
-      "properties": {
-        "payload": {
-          "description": "The payload for the getOrders operation.",
-          "$ref": "#/definitions/OrdersList"
-        },
-        "errors": {
-          "description": "One or more unexpected errors occurred during the getOrders operation.",
-          "$ref": "#/definitions/ErrorList"
-        }
-      },
-      "description": "The response schema for the getOrders operation."
-    },
-    "GetOrderResponse": {
-      "type": "object",
-      "properties": {
-        "payload": {
-          "description": "The payload for the getOrder operation.",
-          "$ref": "#/definitions/Order"
-        },
-        "errors": {
-          "description": "One or more unexpected errors occurred during the getOrder operation.",
-          "$ref": "#/definitions/ErrorList"
-        }
-      },
-      "description": "The response schema for the getOrder operation."
-    },
-    "GetOrderBuyerInfoResponse": {
-      "type": "object",
-      "properties": {
-        "payload": {
-          "description": "The payload for the getOrderBuyerInfo operations.",
-          "$ref": "#/definitions/OrderBuyerInfo"
-        },
-        "errors": {
-          "description": "One or more unexpected errors occurred during the getOrderBuyerInfo operation.",
-          "$ref": "#/definitions/ErrorList"
-        }
-      },
-      "description": "The response schema for the getOrderBuyerInfo operation."
-    },
-    "GetOrderRegulatedInfoResponse": {
-      "type": "object",
-      "properties": {
-        "payload": {
-          "description": "The payload for the getOrderBuyerInfo operations.",
-          "$ref": "#/definitions/OrderRegulatedInfo"
-        },
-        "errors": {
-          "description": "One or more unexpected errors occurred during the getOrderRegulatedInfo operation.",
-          "$ref": "#/definitions/ErrorList"
-        }
-      },
-      "description": "The response schema for the getOrderRegulatedInfo operation."
-    },
-    "GetOrderAddressResponse": {
-      "type": "object",
-      "properties": {
-        "payload": {
-          "description": "The payload for the getOrderAddress operations.",
-          "$ref": "#/definitions/OrderAddress"
-        },
-        "errors": {
-          "description": "One or more unexpected errors occurred during the getOrderAddress operation.",
-          "$ref": "#/definitions/ErrorList"
-        }
-      },
-      "description": "The response schema for the getOrderAddress operation."
-    },
-    "GetOrderItemsResponse": {
-      "type": "object",
-      "properties": {
-        "payload": {
-          "description": "The payload for the getOrderItems operation.",
-          "$ref": "#/definitions/OrderItemsList"
-        },
-        "errors": {
-          "description": "One or more unexpected errors occurred during the getOrderItems operation.",
-          "$ref": "#/definitions/ErrorList"
-        }
+        ],
+        "responses": {
+          "200": {
+            "description": "Success.",
+            "schema": {
+              "$ref": "#/definitions/GetOrderApprovalsResponse"
+            },
+            "examples": {
+              "application/json": {
+                "payload": {
+                  "NextToken": "2YgYW55IGNhcm5hbCBwbGVhc3VyZS4",
+                  "OrderItemsApprovalsList": [
+                    {
+                      "OrderItemId": "12354324",
+                      "ApprovalType": "LEONARDI_APPROVAL",
+                      "ApprovalStatus": "PENDING_SELLING_PARTNER_APPROVAL",
+                      "ItemApprovals": [
+                        {
+                          "SequenceId": 1,
+                          "Timestamp": "string",
+                          "Actor": "SELLING_PARTNER",
+                          "Approver": "approver-id-123",
+                          "ApprovalActionProcessStatus": "ERROR",
+                          "ApprovalActionProcessStatusMessage": "Invalid substitution request.",
+                          "ApprovalAction": {
+                            "ActionType": "APPROVE",
+                            "Comment": "Set price and units",
+                            "Changes": {
+                              "ItemPrice": {
+                                "CurrencyCode": "EUR",
+                                "Amount": "8.5"
+                              },
+                              "Quantity": 2,
+                              "SubstitutedBy": {
+                                "IdentifierType": "EXTERNAL_ID",
+                                "Identifier": "P12325"
+                              }
+                            }
+                          }
+                        }
+                      ]
+                    },
+                    {
+                      "OrderItemId": "79039765272157",
+                      "ApprovalType": "LEONARDI_APPROVAL",
+                      "ApprovalStatus": "DECLINED",
+                      "ItemApprovals": [
+                        {
+                          "SequenceId": 1,
+                          "Timestamp": "string",
+                          "Actor": "SELLING_PARTNER",
+                          "Approver": "approver-id-123",
+                          "ApprovalActionProcessStatus": "SUCCESS",
+                          "ApprovalActionProcessStatusMessage": "Approval request validated",
+                          "ApprovalAction": {
+                            "ActionType": "DECLINE",
+                            "Comment": "Out of stock."
+                          }
+                        }
+                      ]
+                    }
+                  ]
+                }
+              }
+            },
+            "headers": {
+              "x-amzn-RateLimit-Limit": {
+                "type": "string",
+                "description": "Your rate limit (requests per second) for this operation."
+              },
+              "x-amzn-RequestId": {
+                "type": "string",
+                "description": "Unique request reference identifier."
+              }
+            },
+            "x-amzn-api-sandbox": {
+              "static": [
+                {
+                  "request": {
+                    "parameters": {
+                      "orderId": {
+                        "value": "TEST_CASE_200"
+                      }
+                    }
+                  },
+                  "response": {
+                    "payload": {
+                      "NextToken": "2YgYW55IGNhcm5hbCBwbGVhc3VyZS4",
+                      "OrderItemsApprovalsList": [
+                        {
+                          "OrderItemId": "68828574383266",
+                          "ApprovalType": "LEONARDI_APPROVAL",
+                          "ApprovalStatus": "PENDING_SELLING_PARTNER_APPROVAL",
+                          "ItemApprovals": [
+                            {
+                              "SequenceId": 1,
+                              "Timestamp": "string",
+                              "Actor": "SELLING_PARTNER",
+                              "Approver": "approver-id-123",
+                              "ApprovalActionProcessStatus": "ERROR",
+                              "ApprovalActionProcessStatusMessage": "No valid offer found for the substitution.",
+                              "ApprovalAction": {
+                                "ActionType": "APPROVE_WITH_CHANGES",
+                                "Comment": "Item substitution.",
+                                "Changes": {
+                                  "ItemPrice": {
+                                    "CurrencyCode": "EUR",
+                                    "Amount": "8.5"
+                                  },
+                                  "Quantity": 2,
+                                  "SubstitutedBy": {
+                                    "IdentifierType": "EXTERNAL_ID",
+                                    "Identifier": "NEW_ITEM_ID_12325"
+                                  }
+                                }
+                              }
+                            }
+                          ]
+                        }
+                      ]
+                    }
+                  }
+                }
+              ]
+            }
+          },
+          "400": {
+            "description": "Request has missing or invalid parameters and cannot be parsed.",
+            "schema": {
+              "$ref": "#/definitions/GetOrderApprovalsResponse"
+            },
+            "headers": {
+              "x-amzn-RateLimit-Limit": {
+                "type": "string",
+                "description": "Your rate limit (requests per second) for this operation."
+              },
+              "x-amzn-RequestId": {
+                "type": "string",
+                "description": "Unique request reference identifier."
+              }
+            },
+            "x-amzn-api-sandbox": {
+              "static": [
+                {
+                  "request": {
+                    "parameters": {
+                      "orderId": {
+                        "value": "TEST_CASE_400"
+                      }
+                    }
+                  },
+                  "response": {
+                    "errors": [
+                      {
+                        "code": "InvalidInput",
+                        "message": "Invalid Input"
+                      }
+                    ]
+                  }
+                }
+              ]
+            }
+          },
+          "403": {
+            "description": "Indicates access to the resource is forbidden. Possible reasons include Access Denied, Unauthorized, Expired Token, or Invalid Signature.",
+            "schema": {
+              "$ref": "#/definitions/GetOrderApprovalsResponse"
+            },
+            "headers": {
+              "x-amzn-RequestId": {
+                "type": "string",
+                "description": "Unique request reference identifier."
+              }
+            }
+          },
+          "404": {
+            "description": "The resource specified does not exist.",
+            "schema": {
+              "$ref": "#/definitions/GetOrderApprovalsResponse"
+            },
+            "headers": {
+              "x-amzn-RateLimit-Limit": {
+                "type": "string",
+                "description": "Your rate limit (requests per second) for this operation."
+              },
+              "x-amzn-RequestId": {
+                "type": "string",
+                "description": "Unique request reference identifier."
+              }
+            }
+          },
+          "429": {
+            "description": "The frequency of requests was greater than allowed.",
+            "schema": {
+              "$ref": "#/definitions/GetOrderApprovalsResponse"
+            },
+            "headers": {
+              "x-amzn-RateLimit-Limit": {
+                "type": "string",
+                "description": "Your rate limit (requests per second) for this operation.\n_Note:_ For this status code, the rate limit header is deprecated and no longer returned."
+              },
+              "x-amzn-RequestId": {
+                "type": "string",
+                "description": "Unique request reference identifier."
+              }
+            }
+          },
+          "500": {
+            "description": "An unexpected condition occurred that prevented the server from fulfilling the request.",
+            "schema": {
+              "$ref": "#/definitions/GetOrderApprovalsResponse"
+            },
+            "headers": {
+              "x-amzn-RateLimit-Limit": {
+                "type": "string",
+                "description": "Your rate limit (requests per second) for this operation.\n_Note:_ For this status code, the rate limit header is deprecated and no longer returned."
+              },
+              "x-amzn-RequestId": {
+                "type": "string",
+                "description": "Unique request reference identifier."
+              }
+            }
+          },
+          "503": {
+            "description": "Temporary overloading or maintenance of the server.",
+            "schema": {
+              "$ref": "#/definitions/GetOrderApprovalsResponse"
+            },
+            "headers": {
+              "x-amzn-RateLimit-Limit": {
+                "type": "string",
+                "description": "Your rate limit (requests per second) for this operation.\n_Note:_ For this status code, the rate limit header is deprecated and no longer returned."
+              },
+              "x-amzn-RequestId": {
+                "type": "string",
+                "description": "Unique request reference identifier."
+              }
+            }
+          }
+        }
+      },
+      "post": {
+        "tags": [
+          "approvals"
+        ],
+        "description": "Update the order items approvals for an order that you specify.\n\n**Usage Plan:**\n\n| Rate (requests per second) | Burst |\n| ---- | ---- |\n| 5 | 15 |\n\nThe `x-amzn-RateLimit-Limit` response header returns the usage plan rate limits that were applied to the requested operation, when available. The table above indicates the default rate and burst values for this operation. Selling partners whose business demands require higher throughput may see higher rate and burst values then those shown here. For more information, see [Usage Plans and Rate Limits in the Selling Partner API](doc:usage-plans-and-rate-limits-in-the-sp-api).",
+        "operationId": "updateOrderItemsApprovals",
+        "parameters": [
+          {
+            "name": "orderId",
+            "in": "path",
+            "description": "An Amazon-defined order identifier, in 3-7-7 format.",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "payload",
+            "in": "body",
+            "description": "The request body for the updateOrderItemsApprovals operation.",
+            "required": true,
+            "schema": {
+              "$ref": "#/definitions/UpdateOrderApprovalsRequest"
+            }
+          }
+        ],
+        "responses": {
+          "204": {
+            "description": "Success.",
+            "x-amzn-api-sandbox": {
+              "static": [
+                {
+                  "request": {
+                    "parameters": {}
+                  },
+                  "response": {}
+                }
+              ]
+            },
+            "headers": {
+              "x-amzn-RateLimit-Limit": {
+                "description": "Your rate limit (requests per second) for this operation.",
+                "type": "string"
+              },
+              "x-amzn-RequestId": {
+                "description": "Unique request reference identifier.",
+                "type": "string"
+              }
+            }
+          },
+          "400": {
+            "description": "Request has missing or invalid parameters and cannot be parsed.",
+            "x-amzn-api-sandbox": {
+              "static": [
+                {
+                  "request": {
+                    "parameters": {
+                      "body": {
+                        "value": {
+                          "Approver": "John",
+                          "OrderItemsApprovalRequests": [
+                            {
+                              "OrderItemId": "12345",
+                              "ApprovalAction": {
+                                "ActionType": "APPROVE_WITH_CHANGES",
+                                "Comment": "Mandatory substitution.",
+                                "Changes": {}
+                              }
+                            }
+                          ]
+                        }
+                      }
+                    }
+                  },
+                  "response": {
+                    "errors": [
+                      {
+                        "code": "InvalidInput",
+                        "message": "No changes defined."
+                      }
+                    ]
+                  }
+                }
+              ]
+            },
+            "headers": {
+              "x-amzn-RateLimit-Limit": {
+                "description": "Your rate limit (requests per second) for this operation.",
+                "type": "string"
+              },
+              "x-amzn-RequestId": {
+                "description": "Unique request reference identifier.",
+                "type": "string"
+              }
+            },
+            "schema": {
+              "$ref": "#/definitions/UpdateItemsApprovalsErrorResponse"
+            }
+          },
+          "403": {
+            "description": "Indicates that access to the resource is forbidden. Possible reasons include Access Denied, Unauthorized, Expired Token, or Invalid Signature.",
+            "headers": {
+              "x-amzn-RequestId": {
+                "description": "Unique request reference identifier.",
+                "type": "string"
+              }
+            },
+            "schema": {
+              "$ref": "#/definitions/UpdateItemsApprovalsErrorResponse"
+            }
+          },
+          "404": {
+            "description": "The resource specified does not exist.",
+            "headers": {
+              "x-amzn-RateLimit-Limit": {
+                "description": "Your rate limit (requests per second) for this operation.",
+                "type": "string"
+              },
+              "x-amzn-RequestId": {
+                "description": "Unique request reference identifier.",
+                "type": "string"
+              }
+            },
+            "schema": {
+              "$ref": "#/definitions/UpdateItemsApprovalsErrorResponse"
+            }
+          },
+          "413": {
+            "description": "The request size exceeded the maximum accepted size.",
+            "headers": {
+              "x-amzn-RequestId": {
+                "description": "Unique request reference identifier.",
+                "type": "string"
+              }
+            },
+            "schema": {
+              "$ref": "#/definitions/UpdateItemsApprovalsErrorResponse"
+            }
+          },
+          "415": {
+            "description": "The request payload is in an unsupported format.",
+            "headers": {
+              "x-amzn-RequestId": {
+                "description": "Unique request reference identifier.",
+                "type": "string"
+              }
+            },
+            "schema": {
+              "$ref": "#/definitions/UpdateItemsApprovalsErrorResponse"
+            }
+          },
+          "429": {
+            "description": "The frequency of requests was greater than allowed.",
+            "headers": {
+              "x-amzn-RequestId": {
+                "description": "Unique request reference identifier.",
+                "type": "string"
+              }
+            },
+            "schema": {
+              "$ref": "#/definitions/UpdateItemsApprovalsErrorResponse"
+            }
+          },
+          "500": {
+            "description": "An unexpected condition occurred that prevented the server from fulfilling the request.",
+            "headers": {
+              "x-amzn-RequestId": {
+                "description": "Unique request reference identifier.",
+                "type": "string"
+              }
+            },
+            "schema": {
+              "$ref": "#/definitions/UpdateItemsApprovalsErrorResponse"
+            }
+          },
+          "503": {
+            "description": "Temporary overloading or maintenance of the server.",
+            "headers": {
+              "x-amzn-RequestId": {
+                "description": "Unique request reference identifier.",
+                "type": "string"
+              }
+            },
+            "schema": {
+              "$ref": "#/definitions/UpdateItemsApprovalsErrorResponse"
+            }
+          }
+        }
+      }
+    },
+    "/orders/v0/orders/{orderId}/shipmentConfirmation": {
+      "post": {
+        "tags": [
+          "ordersV0"
+        ],
+        "description": "Updates the shipment confirmation status for a specified order.\n\n**Usage Plan:**\n\n| Rate (requests per second) | Burst |\n| ---- | ---- |\n| 2 | 10 |\n\nThe `x-amzn-RateLimit-Limit` response header returns the usage plan rate limits that were applied to the requested operation, when available. The table above indicates the default rate and burst values for this operation. Selling partners whose business demands require higher throughput may see higher rate and burst values then those shown here. For more information, see [Usage Plans and Rate Limits in the Selling Partner API](doc:usage-plans-and-rate-limits-in-the-sp-api).",
+        "operationId": "confirmShipment",
+        "parameters": [
+          {
+            "name": "orderId",
+            "in": "path",
+            "description": "An Amazon-defined order identifier, in 3-7-7 format.",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "payload",
+            "in": "body",
+            "description": "Request body of confirmShipment.",
+            "required": true,
+            "schema": {
+              "$ref": "#/definitions/ConfirmShipmentRequest"
+            }
+          }
+        ],
+        "responses": {
+          "204": {
+            "description": "Success.",
+            "headers": {
+              "x-amzn-RateLimit-Limit": {
+                "type": "string",
+                "description": "Your rate limit (requests per second) for this operation."
+              },
+              "x-amzn-RequestId": {
+                "type": "string",
+                "description": "Unique request reference identifier."
+              }
+            },
+            "x-amzn-api-sandbox": {
+              "static": [
+                {
+                  "request": {
+                    "parameters": {
+                      "orderId": {
+                        "value": "902-1106328-1059050"
+                      },
+                      "body": {
+                        "value": {
+                          "marketplaceId": "ATVPDKIKX0DER",
+                          "packageDetail": {
+                            "packageReferenceId": "1",
+                            "carrierCode": "FedEx",
+                            "carrierName": "FedEx",
+                            "shippingMethod": "FedEx Ground",
+                            "trackingNumber": "112345678",
+                            "shipDate": "2022-02-11T01:00:00.000Z",
+                            "shipFromSupplySourceId": "057d3fcc-b750-419f-bbcd-4d340c60c430",
+                            "orderItems":[
+                              {
+                                "orderItemId": "79039765272157",
+                                "quantity": 1,
+                                "transparencyCodes": [
+                                  "09876543211234567890"
+                                ]
+                              }
+                            ]
+                          }
+                        }
+                      }
+                    }
+                  },
+                  "response": {
+                  }
+                }
+              ]
+            }
+          },
+          "400": {
+            "description": "Request has missing or invalid parameters and cannot be parsed.",
+            "schema": {
+              "$ref": "#/definitions/ConfirmShipmentErrorResponse"
+            },
+            "headers": {
+              "x-amzn-RateLimit-Limit": {
+                "type": "string",
+                "description": "Your rate limit (requests per second) for this operation."
+              },
+              "x-amzn-RequestId": {
+                "type": "string",
+                "description": "Unique request reference identifier."
+              }
+            },
+            "x-amzn-api-sandbox": {
+              "static": [
+                {
+                  "request": {
+                    "parameters": {
+                      "orderId": {
+                        "value": "902-1106328-1059050"
+                      },
+                      "body": {
+                        "value": {
+                          "marketplaceId": "ATVPDKIKX0DER",
+                          "packageDetail": {
+                            "packageReferenceId": "1",
+                            "carrierCode": "FedEx",
+                            "carrierName": "FedEx",
+                            "shippingMethod": "FedEx Ground",
+                            "trackingNumber": "112345678",
+                            "shipDate": "02/21/2022",
+                            "shipFromSupplySourceId": "057d3fcc-b750-419f-bbcd-4d340c60c430",
+                            "orderItems":[
+                              {
+                                "orderItemId": "79039765272157",
+                                "quantity": 1,
+                                "transparencyCodes": [
+                                  "09876543211234567890"
+                                ]
+                              }
+                            ]
+                          }
+                        }
+                      }
+                    }
+                  },
+                  "response": {
+                    "errors": [
+                      {
+                        "code": "Invalid Input",
+                        "message": "Invalid Input"
+                      }
+                    ]
+                  }
+                }
+              ]
+            }
+          },
+          "401": {
+            "description": "The request's Authorization header is not formatted correctly or does not contain a valid token.",
+            "schema": {
+              "$ref": "#/definitions/ConfirmShipmentErrorResponse"
+            },
+            "headers": {
+              "x-amzn-RateLimit-Limit": {
+                "type": "string",
+                "description": "Your rate limit (requests per second) for this operation.\n_Note:_ For this status code, the rate limit header is deprecated and no longer returned."
+              },
+              "x-amzn-RequestId": {
+                "type": "string",
+                "description": "Unique request reference identifier."
+              }
+            }
+          },
+          "403": {
+            "description": "Indicates that access to the resource is forbidden. Possible reasons include Access Denied, Unauthorized, Expired Token, or Invalid Signature.",
+            "schema": {
+              "$ref": "#/definitions/ConfirmShipmentErrorResponse"
+            },
+            "headers": {
+              "x-amzn-RequestId": {
+                "type": "string",
+                "description": "Unique request reference identifier."
+              }
+            }
+          },
+          "404": {
+            "description": "The specified resource does not exist.",
+            "schema": {
+              "$ref": "#/definitions/ConfirmShipmentErrorResponse"
+            },
+            "headers": {
+              "x-amzn-RateLimit-Limit": {
+                "type": "string",
+                "description": "Your rate limit (requests per second) for this operation."
+              },
+              "x-amzn-RequestId": {
+                "type": "string",
+                "description": "Unique request reference identifier."
+              }
+            }
+          },
+          "429": {
+            "description": "The frequency of requests was greater than allowed.",
+            "schema": {
+              "$ref": "#/definitions/ConfirmShipmentErrorResponse"
+            },
+            "headers": {
+              "x-amzn-RateLimit-Limit": {
+                "type": "string",
+                "description": "Your rate limit (requests per second) for this operation.\n_Note:_ For this status code, the rate limit header is deprecated and no longer returned."
+              },
+              "x-amzn-RequestId": {
+                "type": "string",
+                "description": "Unique request reference identifier."
+              }
+            }
+          },
+          "500": {
+            "description": "An unexpected condition occurred that prevented the server from fulfilling the request.",
+            "schema": {
+              "$ref": "#/definitions/ConfirmShipmentErrorResponse"
+            },
+            "headers": {
+              "x-amzn-RateLimit-Limit": {
+                "type": "string",
+                "description": "Your rate limit (requests per second) for this operation.\n_Note:_ For this status code, the rate limit header is deprecated and no longer returned."
+              },
+              "x-amzn-RequestId": {
+                "type": "string",
+                "description": "Unique request reference identifier."
+              }
+            }
+          },
+          "503": {
+            "description": "Temporary overloading or maintenance of the server.",
+            "schema": {
+              "$ref": "#/definitions/ConfirmShipmentErrorResponse"
+            },
+            "headers": {
+              "x-amzn-RateLimit-Limit": {
+                "type": "string",
+                "description": "Your rate limit (requests per second) for this operation.\n_Note:_ For this status code, the rate limit header is deprecated and no longer returned."
+              },
+              "x-amzn-RequestId": {
+                "type": "string",
+                "description": "Unique request reference identifier."
+              }
+            }
+          }
+        }
+      }
+    }
+  },
+  "definitions": {
+    "UpdateShipmentStatusRequest": {
+      "description": "The request body for the updateShipmentStatus operation.",
+      "type": "object",
+      "properties": {
+        "marketplaceId": {
+          "$ref": "#/definitions/MarketplaceId"
+        },
+        "shipmentStatus": {
+          "$ref": "#/definitions/ShipmentStatus"
+        },
+        "orderItems": {
+          "$ref": "#/definitions/OrderItems"
+        }
+      },
+      "required": [
+        "marketplaceId",
+        "shipmentStatus"
+      ]
+    },
+    "UpdateVerificationStatusRequest": {
+      "description": "The request body for the updateVerificationStatus operation.",
+      "type": "object",
+      "properties": {
+        "regulatedOrderVerificationStatus": {
+          "description": "The updated values of the VerificationStatus field.",
+          "$ref": "#/definitions/UpdateVerificationStatusRequestBody"
+        }
+      },
+      "required": [
+        "regulatedOrderVerificationStatus"
+      ]
+    },
+    "UpdateVerificationStatusRequestBody": {
+      "description": "The updated values of the VerificationStatus field.",
+      "type": "object",
+      "properties": {
+        "status": {
+          "description": "The new verification status of the order.",
+          "$ref": "#/definitions/VerificationStatus"
+        },
+        "externalReviewerId": {
+          "description": "The identifier for the order's regulated information reviewer.",
+          "type": "string"
+        },
+        "rejectionReasonId": {
+          "description": "The unique identifier for the rejection reason used for rejecting the order's regulated information. Only required if the new status is rejected.",
+          "type": "string"
+        }
+      },
+      "required": [
+        "status",
+        "externalReviewerId"
+      ]
+    },
+    "MarketplaceId": {
+      "description": "The unobfuscated marketplace identifier.",
+      "type": "string"
+    },
+    "ShipmentStatus": {
+      "description": "The shipment status to apply.",
+      "type": "string",
+      "enum": [
+        "ReadyForPickup",
+        "PickedUp",
+        "RefusedPickup"
+      ],
+      "x-docgen-enum-table-extension": [
+        {
+          "value": "ReadyForPickup",
+          "description": "Ready for pickup."
+        },
+        {
+          "value": "PickedUp",
+          "description": "Picked up."
+        },
+        {
+          "value": "RefusedPickup",
+          "description": "Refused pickup."
+        }
+      ]
+    },
+    "OrderItems": {
+      "description": "For partial shipment status updates, the list of order items and quantities to be updated.",
+      "type": "array",
+      "items": {
+        "type": "object",
+        "properties": {
+          "orderItemId": {
+            "description": "The unique identifier of the order item.",
+            "type": "string"
+          },
+          "quantity": {
+            "type": "integer",
+            "description": "The quantity for which to update the shipment status."
+          }
+        }
+      }
+    },
+    "UpdateShipmentStatusErrorResponse": {
+      "type": "object",
+      "properties": {
+        "errors": {
+          "description": "One or more unexpected errors occurred during the UpdateShipmentStatus operation.",
+          "$ref": "#/definitions/ErrorList"
+        }
+      },
+      "description": "The error response schema for the UpdateShipmentStatus operation."
+    },
+    "UpdateVerificationStatusErrorResponse": {
+      "type": "object",
+      "properties": {
+        "errors": {
+          "description": "One or more unexpected errors occurred during the UpdateVerificationStatus operation.",
+          "$ref": "#/definitions/ErrorList"
+        }
+      },
+      "description": "The error response schema for the UpdateVerificationStatus operation."
+    },
+    "GetOrdersResponse": {
+      "type": "object",
+      "properties": {
+        "payload": {
+          "description": "The payload for the getOrders operation.",
+          "$ref": "#/definitions/OrdersList"
+        },
+        "errors": {
+          "description": "One or more unexpected errors occurred during the getOrders operation.",
+          "$ref": "#/definitions/ErrorList"
+        }
+      },
+      "description": "The response schema for the getOrders operation."
+    },
+    "GetOrderResponse": {
+      "type": "object",
+      "properties": {
+        "payload": {
+          "description": "The payload for the getOrder operation.",
+          "$ref": "#/definitions/Order"
+        },
+        "errors": {
+          "description": "One or more unexpected errors occurred during the getOrder operation.",
+          "$ref": "#/definitions/ErrorList"
+        }
+      },
+      "description": "The response schema for the getOrder operation."
+    },
+    "GetOrderBuyerInfoResponse": {
+      "type": "object",
+      "properties": {
+        "payload": {
+          "description": "The payload for the getOrderBuyerInfo operation.",
+          "$ref": "#/definitions/OrderBuyerInfo"
+        },
+        "errors": {
+          "description": "One or more unexpected errors occurred during the getOrderBuyerInfo operation.",
+          "$ref": "#/definitions/ErrorList"
+        }
+      },
+      "description": "The response schema for the getOrderBuyerInfo operation."
+    },
+    "GetOrderRegulatedInfoResponse": {
+      "type": "object",
+      "properties": {
+        "payload": {
+          "description": "The payload for the getOrderRegulatedInfo operation.",
+          "$ref": "#/definitions/OrderRegulatedInfo"
+        },
+        "errors": {
+          "description": "One or more unexpected errors occurred during the getOrderRegulatedInfo operation.",
+          "$ref": "#/definitions/ErrorList"
+        }
+      },
+      "description": "The response schema for the getOrderRegulatedInfo operation."
+    },
+    "GetOrderAddressResponse": {
+      "type": "object",
+      "properties": {
+        "payload": {
+          "description": "The payload for the getOrderAddress operations.",
+          "$ref": "#/definitions/OrderAddress"
+        },
+        "errors": {
+          "description": "One or more unexpected errors occurred during the getOrderAddress operation.",
+          "$ref": "#/definitions/ErrorList"
+        }
+      },
+      "description": "The response schema for the getOrderAddress operation."
+    },
+    "GetOrderItemsResponse": {
+      "type": "object",
+      "properties": {
+        "payload": {
+          "description": "The payload for the getOrderItems operation.",
+          "$ref": "#/definitions/OrderItemsList"
+        },
+        "errors": {
+          "description": "One or more unexpected errors occurred during the getOrderItems operation.",
+          "$ref": "#/definitions/ErrorList"
+        }
       },
       "description": "The response schema for the getOrderItems operation."
     },
@@ -2757,7 +3503,7 @@
         },
         "LastUpdateDate": {
           "type": "string",
-          "description": "The date when the order was last updated.\n\nNote: LastUpdateDate is returned with an incorrect date for orders that were last updated before 2009-04-01."
+          "description": "The date when the order was last updated.\n\n__Note__: LastUpdateDate is returned with an incorrect date for orders that were last updated before 2009-04-01."
         },
         "OrderStatus": {
           "type": "string",
@@ -2850,7 +3596,7 @@
           "description": "The number of items unshipped."
         },
         "PaymentExecutionDetail": {
-          "description": "Information about sub-payment methods for a Cash On Delivery (COD) order.\n\nNote: For a COD order that is paid for using one sub-payment method, one PaymentExecutionDetailItem object is returned, with PaymentExecutionDetailItem/PaymentMethod = COD. For a COD order that is paid for using multiple sub-payment methods, two or more PaymentExecutionDetailItem objects are returned.",
+          "description": "Information about sub-payment methods for a Cash On Delivery (COD) order.\n\n__Note__: For a COD order that is paid for using one sub-payment method, one PaymentExecutionDetailItem object is returned, with PaymentExecutionDetailItem/PaymentMethod = COD. For a COD order that is paid for using multiple sub-payment methods, two or more PaymentExecutionDetailItem objects are returned.",
           "$ref": "#/definitions/PaymentExecutionDetailItemList"
         },
         "PaymentMethod": {
@@ -2889,8 +3635,8 @@
           "description": "The shipment service level category of the order.\n\nPossible values: Expedited, FreeEconomy, NextDay, SameDay, SecondDay, Scheduled, Standard."
         },
         "EasyShipShipmentStatus": {
-          "type": "string",
-          "description": "The status of the Amazon Easy Ship order. This property is included only for Amazon Easy Ship orders.\n\nPossible values: PendingPickUp, LabelCanceled, PickedUp, OutForDelivery, Damaged, Delivered, RejectedByBuyer, Undeliverable, ReturnedToSeller, ReturningToSeller."
+          "description": "The status of the Amazon Easy Ship order. This property is included only for Amazon Easy Ship orders.",
+          "$ref": "#/definitions/EasyShipShipmentStatus"
         },
         "CbaDisplayableShippingLabel": {
           "type": "string",
@@ -2931,11 +3677,11 @@
         },
         "EarliestShipDate": {
           "type": "string",
-          "description": "The start of the time period within which you have committed to ship the order. In ISO 8601 date time format. Returned only for seller-fulfilled orders.\n\nNote: EarliestShipDate might not be returned for orders placed before February 1, 2013."
+          "description": "The start of the time period within which you have committed to ship the order. In ISO 8601 date time format. Returned only for seller-fulfilled orders.\n\n__Note__: EarliestShipDate might not be returned for orders placed before February 1, 2013."
         },
         "LatestShipDate": {
           "type": "string",
-          "description": "The end of the time period within which you have committed to ship the order. In ISO 8601 date time format. Returned only for seller-fulfilled orders.\n\nNote: LatestShipDate might not be returned for orders placed before February 1, 2013."
+          "description": "The end of the time period within which you have committed to ship the order. In ISO 8601 date time format. Returned only for seller-fulfilled orders.\n\n__Note__: LatestShipDate might not be returned for orders placed before February 1, 2013."
         },
         "EarliestDeliveryDate": {
           "type": "string",
@@ -3019,6 +3765,10 @@
           "type": "boolean",
           "description": "When true, this order is marked to be picked up from a store rather than delivered."
         },
+        "IsAccessPointOrder": {
+          "type": "boolean",
+          "description": "When true, this order is marked to be delivered to an Access Point. The access location is chosen by the customer. Access Points include Amazon Hub Lockers, Amazon Hub Counters, and pickup points operated by carriers."
+        },
         "MarketplaceTaxInfo": {
           "description": "Tax information about the marketplace.",
           "$ref": "#/definitions/MarketplaceTaxInfo"
@@ -3040,6 +3790,24 @@
         "HasRegulatedItems": {
           "type": "boolean",
           "description": "Whether the order contains regulated items which may require additional approval steps before being fulfilled."
+        },
+        "ElectronicInvoiceStatus": {
+          "$ref": "#/definitions/ElectronicInvoiceStatus",
+          "description": "The status of the electronic invoice."
+        },
+        "ItemApprovalTypes": {
+          "type": "array",
+            "items": {
+              "$ref": "#/definitions/ItemApprovalType"
+            },
+          "description": "Set of approval types which applies to at least one order item in the order."
+        },
+        "ItemApprovalStatus": {
+          "type": "array",
+            "items": {
+              "$ref": "#/definitions/ItemApprovalStatus"
+            },
+          "description": "Subset of all ItemApprovalStatus that are set in at least one of the order items subject to approvals."
         }
       },
       "description": "Order information."
@@ -3060,7 +3828,7 @@
         },
         "BuyerName": {
           "type": "string",
-          "description": "The name of the buyer."
+          "description": "The buyer name or the recipient name."
         },
         "BuyerCounty": {
           "type": "string",
@@ -3097,7 +3865,7 @@
         },
         "RequiresDosageLabel": {
           "type": "boolean",
-          "description": "Whether the order requires attaching a dosage information label when shipped."
+          "description": "When true, the order requires attaching a dosage information label when shipped."
         },
         "RegulatedOrderVerificationStatus": {
           "$ref": "#/definitions/RegulatedOrderVerificationStatus",
@@ -3115,41 +3883,12 @@
       ],
       "properties": {
         "Status": {
-          "type": "string",
           "description": "The verification status of the order.",
-          "enum": [
-            "Pending",
-            "Approved",
-            "Rejected",
-            "Expired",
-            "Cancelled"
-          ],
-          "x-docgen-enum-table-extension": [
-            {
-              "value": "Pending",
-              "description": "The order is pending approval. Note the approval might be needed from someone other than the merchant as determined by the RequiresMerchantAction field."
-            },
-            {
-              "value": "Approved",
-              "description": "The order's regulated information has been reviewed and approved."
-            },
-            {
-              "value": "Rejected",
-              "description": "The order's regulated information has been reviewed and rejected."
-            },
-            {
-              "value": "Expired",
-              "description": "The time to review the order's regulated information has expired."
-            },
-            {
-              "value": "Cancelled",
-              "description": "The order was cancelled by the purchaser."
-            }
-          ]
+          "$ref": "#/definitions/VerificationStatus"
         },
         "RequiresMerchantAction": {
           "type": "boolean",
-          "description": "Whether the regulated information provided in the order requires a review by the merchant."
+          "description": "When true, the regulated information provided in the order requires a review by the merchant."
         },
         "ValidRejectionReasons": {
           "type": "array",
@@ -3186,10 +3925,43 @@
         },
         "RejectionReasonDescription": {
           "type": "string",
-          "description": "The human-readable description of this rejection reason."
+          "description": "The description of this rejection reason."
         }
       }
     },
+    "VerificationStatus": {
+      "type": "string",
+      "description": "The verification status of the order.",
+      "enum": [
+        "Pending",
+        "Approved",
+        "Rejected",
+        "Expired",
+        "Cancelled"
+      ],
+      "x-docgen-enum-table-extension": [
+        {
+          "value": "Pending",
+          "description": "The order is pending approval. Note that the approval might be needed from someone other than the merchant as determined by the RequiresMerchantAction property."
+        },
+        {
+          "value": "Approved",
+          "description": "The order's regulated information has been reviewed and approved."
+        },
+        {
+          "value": "Rejected",
+          "description": "The order's regulated information has been reviewed and rejected."
+        },
+        {
+          "value": "Expired",
+          "description": "The time to review the order's regulated information has expired."
+        },
+        {
+          "value": "Cancelled",
+          "description": "The order was cancelled by the purchaser."
+        }
+      ]
+    },
     "RegulatedInformation": {
       "type": "object",
       "description": "The regulated information collected during purchase and used to verify the order.",
@@ -3222,11 +3994,11 @@
         },
         "FieldLabel": {
           "type": "string",
-          "description": "The human-readable name for the field."
+          "description": "The name for the field."
         },
         "FieldType": {
           "type": "string",
-          "description": "The type of field the field.",
+          "description": "The type of field.",
           "enum": [
             "Text",
             "FileAttachment"
@@ -3244,7 +4016,7 @@
         },
         "FieldValue": {
           "type": "string",
-          "description": "The content of the field as collected in regulatory form. Note that FileAttachment type fields will contain an URL to download the attachment here."
+          "description": "The content of the field as collected in regulatory form. Note that FileAttachment type fields will contain a URL to download the attachment here."
         }
       }
     },
@@ -3258,8 +4030,15 @@
           "type": "string",
           "description": "An Amazon-defined order identifier, in 3-7-7 format."
         },
+        "BuyerCompanyName": {
+          "type": "string",
+          "description": "Company name of the destination address."
+        },
         "ShippingAddress": {
           "$ref": "#/definitions/Address"
+        },
+        "DeliveryPreferences": {
+          "$ref": "#/definitions/DeliveryPreferences"
         }
       },
       "description": "The shipping address for the order."
@@ -3336,8 +4115,181 @@
             }
           ]
         }
-      },
-      "description": "The shipping address for the order."
+      },
+      "description": "The shipping address for the order."
+    },
+    "DeliveryPreferences": {
+      "type": "object",
+      "properties": {
+        "DropOffLocation": {
+          "type": "string",
+          "description": "Drop-off location selected by the customer."
+        },
+        "PreferredDeliveryTime": {
+          "$ref": "#/definitions/PreferredDeliveryTime",
+          "description": "Business hours and days when the delivery is preferred."
+        },
+        "OtherAttributes": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/OtherDeliveryAttributes"
+          },
+          "description": "Enumerated list of miscellaneous delivery attributes associated with the shipping address."
+        },
+        "AddressInstructions": {
+          "type": "string",
+          "description": "Building instructions, nearby landmark or navigation instructions."
+        }
+      },
+      "description": "Contains all of the delivery instructions provided by the customer for the shipping address."
+    },
+    "PreferredDeliveryTime": {
+      "type": "object",
+      "description": "The time window when the delivery is preferred.",
+      "properties": {
+        "BusinessHours": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/BusinessHours"
+          },
+          "description": "Business hours when the business is open for deliveries."
+        },
+        "ExceptionDates": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/ExceptionDates"
+          },
+          "description": "Dates when the business is closed in the next 30 days."
+        }
+      }
+    },
+    "BusinessHours": {
+      "type": "object",
+      "description": "Business days and hours when the destination is open for deliveries.",
+      "properties": {
+        "DayOfWeek": {
+          "type": "string",
+          "description": "Day of the week.",
+          "enum": [
+            "SUN",
+            "MON",
+            "TUE",
+            "WED",
+            "THU",
+            "FRI",
+            "SAT"
+          ],
+          "x-docgen-enum-table-extension": [
+            {
+              "value": "SUN",
+              "description": "Sunday - Day of the week."
+            },
+            {
+              "value": "MON",
+              "description": "Monday - Day of the week."
+            },
+            {
+              "value": "TUE",
+              "description": "Tuesday - Day of the week."
+            },
+            {
+              "value": "WED",
+              "description": "Wednesday - Day of the week."
+            },
+            {
+              "value": "THU",
+              "description": "Thursday - Day of the week."
+            },
+            {
+              "value": "FRI",
+              "description": "Friday - Day of the week."
+            },
+            {
+              "value": "SAT",
+              "description": "Saturday - Day of the week."
+            }
+          ]
+        },
+        "OpenIntervals": {
+          "type": "array",
+          "description": "Time window during the day when the business is open.",
+          "items": {
+            "$ref": "#/definitions/OpenInterval"
+          }
+        }
+      }
+    },
+    "ExceptionDates": {
+      "type": "object",
+      "description": "Dates when the business is closed or open with a different time window.",
+      "properties": {
+        "ExceptionDate": {
+          "type": "string",
+          "description": "Date when the business is closed, in ISO-8601 date format."
+        },
+        "IsOpen": {
+          "type": "boolean",
+          "description": "Boolean indicating if the business is closed or open on that date."
+        },
+        "OpenIntervals": {
+          "type": "array",
+          "description": "Time window during the day when the business is open.",
+          "items": {
+            "$ref": "#/definitions/OpenInterval"
+          }
+        }
+      }
+    },
+    "OpenInterval": {
+      "type": "object",
+      "description": "The time interval for which the business is open.",
+      "properties": {
+        "StartTime": {
+          "$ref": "#/definitions/OpenTimeInterval",
+          "description": "The time when the business opens."
+        },
+        "EndTime": {
+          "$ref": "#/definitions/OpenTimeInterval",
+          "description": "The time when the business closes."
+        }
+      }
+    },
+    "OpenTimeInterval": {
+      "type": "object",
+      "description": "The time when the business opens or closes.",
+      "properties": {
+        "Hour": {
+          "type": "integer",
+          "description": "The hour when the business opens or closes."
+        },
+        "Minute": {
+          "type": "integer",
+          "description": "The minute when the business opens or closes."
+        }
+      }
+    },
+    "OtherDeliveryAttributes": {
+      "type": "string",
+      "description": "Miscellaneous delivery attributes associated with the shipping address.",
+      "enum": [
+        "HAS_ACCESS_POINT",
+        "PALLET_ENABLED",
+        "PALLET_DISABLED"
+      ],
+      "x-docgen-enum-table-extension": [
+        {
+          "value": "HAS_ACCESS_POINT",
+          "description": "Indicates whether the delivery has an access point pickup or drop-off location."
+        },
+        {
+          "value": "PALLET_ENABLED",
+          "description": "Indicates whether pallet delivery is enabled for the address."
+        },
+        {
+          "value": "PALLET_DISABLED",
+          "description": "Indicates whether pallet delivery is disabled for the address."
+        }
+      ]
     },
     "Money": {
       "type": "object",
@@ -3615,6 +4567,17 @@
         "BuyerRequestedCancel": {
           "description": "Information about whether or not a buyer requested cancellation.",
           "$ref": "#/definitions/BuyerRequestedCancel"
+        },
+        "ItemApprovalContext": {
+          "$ref": "#/definitions/ItemApprovalContext",
+          "description": "Item approval context containing the information regarding the status and progress of the item approval."
+        },
+        "SerialNumbers": {
+          "type": "array",
+          "description": "A list of serial numbers for electronic products that are shipped to customers. Returned for FBA orders only.",
+          "items": {
+            "type": "string"
+          }
         }
       },
       "description": "A single order item."
@@ -3794,7 +4757,7 @@
         },
         "BuyerName": {
           "type": "string",
-          "description": "The name of the buyer."
+          "description": "The buyer name or the recipient name."
         },
         "BuyerCounty": {
           "type": "string",
@@ -3809,7 +4772,7 @@
           "description": "The purchase order (PO) number entered by the buyer at checkout. Returned only for orders where the buyer entered a PO number at checkout."
         }
       },
-      "description": "Buyer information"
+      "description": "Buyer information."
     },
     "ItemBuyerInfo": {
       "type": "object",
@@ -3842,7 +4805,7 @@
       "type": "object",
       "properties": {
         "HasAutomatedShippingSettings": {
-          "description": "If true, this order has automated shipping settings generated by Amazon. This order could be identified as an SSA order.",
+          "description": "When true, this order has automated shipping settings generated by Amazon. This order could be identified as an SSA order.",
           "type": "boolean"
         },
         "AutomatedCarrier": {
@@ -3864,11 +4827,626 @@
         },
         "BuyerCancelReason": {
           "type": "string",
-          "description": "Reason for buyer requesting cancel"
+          "description": "The reason that the buyer requested cancellation."
         }
       },
       "description": "Information about whether or not a buyer requested cancellation."
     },
+    "EasyShipShipmentStatus": {
+      "description": "The status of the Amazon Easy Ship order. This property is included only for Amazon Easy Ship orders.",
+      "type": "string",
+      "enum": [
+        "PendingSchedule",
+        "PendingPickUp",
+        "PendingDropOff",
+        "LabelCanceled",
+        "PickedUp",
+        "DroppedOff",
+        "AtOriginFC",
+        "AtDestinationFC",
+        "Delivered",
+        "RejectedByBuyer",
+        "Undeliverable",
+        "ReturningToSeller",
+        "ReturnedToSeller",
+        "Lost",
+        "OutForDelivery",
+        "Damaged"
+      ],
+      "x-docgen-enum-table-extension": [
+        {
+          "value": "PendingSchedule",
+          "description": "The package is awaiting the schedule for pick-up."
+        },
+        {
+          "value": "PendingPickUp",
+          "description": "Amazon has not yet picked up the package from the seller."
+        },
+        {
+          "value": "PendingDropOff",
+          "description": "The seller will deliver the package to the carrier."
+        },
+        {
+          "value": "LabelCanceled",
+          "description": "The seller canceled the pickup."
+        },
+        {
+          "value": "PickedUp",
+          "description": "Amazon has picked up the package from the seller."
+        },
+        {
+          "value": "DroppedOff",
+          "description": "The package was delivered to the carrier by the seller."
+        },
+        {
+          "value": "AtOriginFC",
+          "description": "The package is at the origin fulfillment center."
+        },
+        {
+          "value": "AtDestinationFC",
+          "description": "The package is at the destination fulfillment center."
+        },
+        {
+          "value": "Delivered",
+          "description": "The package has been delivered."
+        },
+        {
+          "value": "RejectedByBuyer",
+          "description": "The package has been rejected by the buyer."
+        },
+        {
+          "value": "Undeliverable",
+          "description": "The package cannot be delivered."
+        },
+        {
+          "value": "ReturningToSeller",
+          "description": "The package was not delivered and is being returned to the seller."
+        },
+        {
+          "value": "ReturnedToSeller",
+          "description": "The package was not delivered and was returned to the seller."
+        },
+        {
+          "value": "Lost",
+          "description": "The package is lost."
+        },
+        {
+          "value": "OutForDelivery",
+          "description": "The package is out for delivery."
+        },
+        {
+          "value": "Damaged",
+          "description": "The package was damaged by the carrier."
+        }
+      ]
+    },
+    "ElectronicInvoiceStatus": {
+      "description": "The status of the electronic invoice.",
+      "type": "string",
+      "enum": [
+        "NotRequired",
+        "NotFound",
+        "Processing",
+        "Errored",
+        "Accepted"
+      ],
+      "x-docgen-enum-table-extension": [
+        {
+          "value": "NotRequired",
+          "description": "The order does not require an electronic invoice to be uploaded."
+        },
+        {
+          "value": "NotFound",
+          "description": "The order requires an electronic invoice but it is not uploaded."
+        },
+        {
+          "value": "Processing",
+          "description": "The required electronic invoice was uploaded and is processing."
+        },
+        {
+          "value": "Errored",
+          "description": "The uploaded electronic invoice was not accepted."
+        },
+        {
+          "value": "Accepted",
+          "description": "The uploaded electronic invoice was accepted."
+        }
+      ]
+    },
+    "ItemApprovalType": {
+      "type": "string",
+      "enum": [
+        "LEONARDI_APPROVAL"
+      ],
+      "x-docgen-enum-table-extension": [
+        {
+          "value": "LEONARDI_APPROVAL",
+          "description": "Approval process required to fulfill Leonardi order items."
+        }
+      ],
+      "description": "Defines the approval process types available for order items."
+    },
+    "ItemApprovalStatus": {
+      "type": "string",
+      "enum": [
+        "PENDING_SELLING_PARTNER_APPROVAL",
+        "PROCESSING_SELLING_PARTNER_APPROVAL",
+        "PENDING_AMAZON_APPROVAL",
+        "APPROVED",
+        "APPROVED_WITH_CHANGES",
+        "DECLINED"
+      ],
+      "x-docgen-enum-table-extension": [
+        {
+          "value": "PENDING_SELLING_PARTNER_APPROVAL",
+          "description": "Approval process requires an approval action from the selling partner."
+        },
+        {
+          "value": "PROCESSING_SELLING_PARTNER_APPROVAL",
+          "description": "Amazon is processing the selling partner's approval action."
+        },
+        {
+          "value": "PENDING_AMAZON_APPROVAL",
+          "description": "Approval process requires an approval action from Amazon."
+        },
+        {
+          "value": "APPROVED",
+          "description": "All steps of the approval process are complete and the item is approved."
+        },
+        {
+          "value": "APPROVED_WITH_CHANGES",
+          "description": "All steps of the approval process are complete and the item is approved with some changes. This state is only possible if the approval process type allows item level changes."
+        },
+        {
+          "value": "DECLINED",
+          "description": "All steps of the approval process are complete and the item is declined."
+        }
+      ],
+      "description": "Defines the possible status of an order item approval."
+    },
+    "ItemApprovalContext": {
+      "description": "Generic item approval context. Check the applicable restrictions at the specific approval type schemas.",
+      "type": "object",
+      "required": [
+          "ApprovalType",
+          "ApprovalStatus"
+      ],
+      "properties": {
+        "ApprovalType": {
+          "$ref": "#/definitions/ItemApprovalType",
+          "description": "The approval process type required for the order item."
+        },
+        "ApprovalStatus": {
+          "$ref": "#/definitions/ItemApprovalStatus",
+          "description": "Current status of the order item approval."
+        },
+        "ApprovalSupportData": {
+          "$ref": "#/definitions/ApprovalSupportDataElementList",
+          "description": "List of additional data elements supporting the approval process. Check the applicable restrictions at the specific approval type schemas."
+        }
+      }
+    },
+    "ApprovalSupportDataElementList": {
+      "type": "array",
+      "items": {
+        "$ref": "#/definitions/ApprovalSupportDataElement"
+      },
+      "description": "List of additional data elements supporting the approval process. Check the applicable restrictions at the specific approval type schemas."
+    },
+    "ApprovalSupportDataElement": {
+      "description": "<Name, Value> tuple to define item approval support data elements.",
+      "type": "object",
+      "required": [
+        "Name",
+        "Value"
+      ],
+      "properties": {
+        "Name": {
+          "type": "string",
+          "description": "Name of the approval support element. Allowed names are defined in specific approval types schemas."
+        },
+        "Value": {
+          "type": "string",
+          "description": "String value of the approval support element."
+        }
+      }
+    },
+    "ItemApproval": {
+      "description": "Generic item approval. Check the applicable restrictions at the specific approval type schemas.",
+      "type": "object",
+      "required": [
+          "SequenceId",
+          "Timestamp",
+          "Actor",
+          "ApprovalAction",
+          "ApprovalActionProcessStatus"
+      ],
+      "properties": {
+          "SequenceId": {
+              "type": "integer",
+              "description": "Sequence number of the item approval. Each ItemApproval gets its sequenceId automatically from a monotonic increasing function."
+          },
+          "Timestamp": {
+              "type": "string",
+              "description": "Timestamp when the ItemApproval was recorded by Amazon's internal order approvals system. In ISO 8601 date time format."
+          },
+          "Actor": {
+              "type": "string",
+              "enum": [
+                  "SELLING_PARTNER",
+                  "AMAZON"
+              ],
+              "x-docgen-enum-table-extension": [
+                  {
+                      "value": "SELLING_PARTNER",
+                      "description": "High level actor to which the approval actions are assigned when triggered by the selling partner."
+                  },
+                  {
+                      "value": "AMAZON",
+                      "description": "High level actor to which the approval actions are assigned when triggered by Amazon."
+                  }
+              ],
+              "description": "High level actors involved in the approval process."
+          },
+          "Approver": {
+              "type": "string",
+              "description": "Person or system that triggers the approval actions on behalf of the actor."
+          },
+          "ApprovalAction": {
+              "$ref": "#/definitions/ItemApprovalAction",
+              "description": "Approval action that defines the behavior of the ItemApproval."
+          },
+          "ApprovalActionProcessStatus": {
+              "type": "string",
+              "enum": [
+                  "PROCESSING",
+                  "SUCCESS",
+                  "ERROR"
+              ],
+              "x-docgen-enum-table-extension": [
+                  {
+                      "value": "PROCESSING",
+                      "description": "Amazon is processing the item approval action triggered by the selling partner."
+                  },
+                  {
+                      "value": "SUCCESS",
+                      "description": "Item approval action processed successfully."
+                  },
+                  {
+                      "value": "ERROR",
+                      "description": "An error occurred while processing the item approval action. The approval action is ignored."
+                  }
+              ],
+              "description": "Status of approval action."
+          },
+          "ApprovalActionProcessStatusMessage": {
+              "type": "string",
+              "description": "Optional message to communicate optional additional context about the current status of the approval action."
+          }
+      }
+    },
+    "ItemApprovalAction": {
+      "description": "This object represents an approval action used by the actors in the order item approval process. Check the applicable restrictions at the specific approval type schemas.",
+      "type": "object",
+      "required": [
+          "ActionType"
+      ],
+      "properties": {
+          "ActionType": {
+              "type": "string",
+              "enum": [
+                  "APPROVE",
+                  "DECLINE",
+                  "APPROVE_WITH_CHANGES"
+              ],
+              "x-docgen-enum-table-extension": [
+                  {
+                      "value": "APPROVE",
+                      "description": "Defines the action of approving the order item."
+                  },
+                  {
+                      "value": "DECLINE",
+                      "description": "Defines the action of declining the order item."
+                  },
+                  {
+                      "value": "APPROVE_WITH_CHANGES",
+                      "description": "Defines the action of a conditional approval, i.e. the order item approval is only valid if the required changes are made to the order item."
+                  }
+              ],
+              "description": "Defines the type of action for the approval."
+          },
+          "Comment": {
+              "type": "string",
+              "description": "Comment message to provide optional additional context on the approval action."
+          },
+          "Changes": {
+              "type": "object",
+              "properties": {
+                "ItemPrice": {
+                    "$ref": "#/definitions/Money",
+                    "description": "Price to be charged to the customer for each unit of the item. If substitutedBy is specified, this value applies to the substitution item."
+                },
+                "Quantity": {
+                    "type": "integer",
+                    "description": "Quantity approved. If substitutedBy is specified, this value applies to the substitution item."
+                },
+                "SubstitutedBy": {
+                    "$ref": "#/definitions/ItemIdentifier",
+                    "description": "Identifier of the item to substitute this item in the order."
+                }
+            },
+            "description": "Changes required for the approval. Each approval type defines the allowed changes valid sub-set in its specific schema."
+          }
+      }
+    },
+    "ItemIdentifier": {
+      "description": "Item identifiers used in the context of approvals operations.",
+      "type": "object",
+      "required": [
+          "IdentifierType",
+          "Identifier"
+      ],
+      "properties": {
+          "IdentifierType": {
+              "type": "string",
+              "enum": [
+                  "ASIN",
+                  "SELLER_SKU",
+                  "EXTERNAL_ID"
+              ],
+              "x-docgen-enum-table-extension": [
+                  {
+                      "value": "ASIN",
+                      "description": "The Amazon Standard Identification Number (ASIN) of the item."
+                  },
+                  {
+                      "value": "SELLER_SKU",
+                      "description": "The seller stock keeping unit (SKU) of the item."
+                  },
+                  {
+                      "value": "EXTERNAL_ID",
+                      "description": "An external id, e.g. EAN or UPC. Approval specific schemas will define the restrictions on the allowed external identifiers."
+                  }
+              ],
+              "description": "Defines the type of identifiers allowed to specify a substitution."
+          },
+          "Identifier": {
+              "type": "string"
+          }
+      }
+    },
+    "GetOrderApprovalsResponse": {
+      "type": "object",
+      "properties": {
+        "payload": {
+          "description": "The payload for the getOrderItemsApprovals operation.",
+          "$ref": "#/definitions/OrderApprovalsResponse"
+        },
+        "errors": {
+          "description": "One or more unexpected errors occurred during the getOrderItemsApprovals operation.",
+          "$ref": "#/definitions/ErrorList"
+        }
+      },
+      "description": "The response schema for the getOrderApprovalsItems operation."
+    },
+    "OrderApprovalsResponse": {
+      "type": "object",
+      "required": [
+        "OrderItemsApprovalsList"
+      ],
+      "properties": {
+        "NextToken": {
+          "type": "string",
+          "description": "When present and not empty, pass this string token in the next request to return the next response page."
+        },
+        "OrderItemsApprovalsList": {
+          "type": "array",
+          "description": "List of OrderItemApprovals.",
+          "items": {
+            "$ref": "#/definitions/OrderItemApprovals"
+          }
+        }
+      },
+      "description": "The order items list with approvals along with the order ID."
+    },
+    "OrderItemApprovals": {
+      "type": "object",
+      "description": "List of item approvals gathered during the approval process.",
+      "required": [
+        "OrderItemId",
+        "ApprovalType",
+        "ApprovalStatus",
+        "ItemApprovals"
+      ],
+      "properties": {
+        "OrderItemId": {
+          "description": "The unique identifier of the order item.",
+          "type": "string"
+        },
+        "ApprovalType": {
+          "$ref": "#/definitions/ItemApprovalType",
+          "description": "The approval process type required for the order item."
+        },
+        "ApprovalStatus": {
+          "$ref": "#/definitions/ItemApprovalStatus",
+          "description": "Current status of the order item approval."
+        },
+        "ItemApprovals": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/ItemApproval"
+          }
+        }
+      }
+    },
+    "UpdateOrderApprovalsRequest": {
+      "description": "The request body for the updateOrderItemsApprovals operation.",
+      "type": "object",
+      "required": [
+          "OrderItemsApprovalRequests"
+      ],
+      "properties": {
+        "Approver": {
+          "type": "string",
+          "description": "Person or system that triggers the approval actions on behalf of the actor."
+        },
+        "OrderItemsApprovalRequests": {
+          "type": "array",
+          "description": "A list of item approval requests.",
+          "items": {
+            "$ref": "#/definitions/OrderItemApprovalRequest"
+          }
+        }
+      }
+    },
+    "OrderItemApprovalRequest": {
+      "description": "Order item apecific approval request.",
+      "type": "object",
+      "required": [
+        "OrderItemId",
+        "ApprovalAction"
+      ],
+      "properties": {
+        "OrderItemId": {
+          "description": "The unique identifier of the order item.",
+          "type": "string"
+        },
+        "ApprovalAction": {
+          "$ref": "#/definitions/ItemApprovalAction",
+          "description": "Approval action that defines the behavior of the ItemApproval."
+        }
+      }
+    },
+    "UpdateItemsApprovalsErrorResponse": {
+      "type": "object",
+      "properties": {
+        "errors": {
+          "description": "One or more unexpected errors occurred during the updateOrderItemsApprovals operation.",
+          "$ref": "#/definitions/ErrorList"
+        }
+      },
+      "description": "The error response schema for the updateOrderItemsApprovals operation."
+    },
+    "ConfirmShipmentRequest": {
+      "type": "object",
+      "required": [
+        "marketplaceId",
+        "packageDetail"
+      ],
+      "properties": {
+        "packageDetail": {
+          "$ref": "#/definitions/PackageDetail"
+        },
+        "codCollectionMethod": {
+          "type": "string",
+          "description": "The cod collection method, support in JP only. ",
+          "enum":["DirectPayment"]
+        },
+        "marketplaceId": {
+          "$ref": "#/definitions/MarketplaceId"
+        }
+      },
+      "description": "The request schema for an shipment confirmation."
+    },
+    "ConfirmShipmentErrorResponse": {
+      "type": "object",
+      "description": "The error response schema for an shipment confirmation.",
+      "properties": {
+        "errors": {
+          "description": "One or more unexpected errors occurred during the confirmShipment operation.",
+          "$ref": "#/definitions/ErrorList"
+        }
+      }
+    },
+    "PackageDetail": {
+      "type": "object",
+      "description": "Properties of packages",
+      "required": [
+        "packageReferenceId",
+        "carrierCode",
+        "trackingNumber",
+        "shipDate",
+        "orderItems"
+      ],
+      "properties": {
+        "packageReferenceId": {
+          "$ref": "#/definitions/PackageReferenceId"
+        },
+        "carrierCode": {
+          "type": "string",
+          "description": "Identifies the carrier that will deliver the package. This field is required for all marketplaces, see [reference](https://developer-docs.amazon.com/sp-api/changelog/carriercode-value-required-in-shipment-confirmations-for-br-mx-ca-sg-au-in-jp-marketplaces)."
+        },
+        "carrierName": {
+          "type": "string",
+          "description": "Carrier Name that will deliver the package. Required when carrierCode is \"Others\" "
+        },
+        "shippingMethod": {
+          "type": "string",
+          "description": "Ship method to be used for shipping the order."
+        },
+        "trackingNumber": {
+          "type": "string",
+          "description": "The tracking number used to obtain tracking and delivery information."
+        },
+        "shipDate": {
+          "type": "string",
+          "description": "The shipping date for the package. Must be in ISO-8601 date/time format.",
+          "format": "date-time"
+        },
+        "shipFromSupplySourceId": {
+          "type": "string",
+          "description": "The unique identifier of the supply source."
+        },
+        "orderItems": {
+          "description": "The list of order items and quantities to be updated.",
+          "$ref": "#/definitions/ConfirmShipmentOrderItemsList"
+        }
+      }
+    },
+    "ConfirmShipmentOrderItemsList": {
+      "type": "array",
+      "description": "A list of order items.",
+      "items": {
+        "$ref": "#/definitions/ConfirmShipmentOrderItem"
+      }
+    },
+    "ConfirmShipmentOrderItem": {
+      "type": "object",
+      "description": "A single order item.",
+      "required": [
+        "orderItemId",
+        "quantity"
+      ],
+      "properties": {
+        "orderItemId": {
+          "type": "string",
+          "description": "The unique identifier of the order item."
+        },
+        "quantity": {
+          "type": "integer",
+          "description": "The quantity of the item."
+        },
+        "transparencyCodes": {
+          "description": "The list of transparency codes.",
+          "$ref": "#/definitions/TransparencyCodeList"
+        }
+      }
+    },
+    "TransparencyCodeList": {
+      "type": "array",
+      "description": "A list of order items.",
+      "items": {
+        "$ref": "#/definitions/TransparencyCode"
+      }
+    },
+    "TransparencyCode": {
+      "type": "string",
+      "description": "The Transparency code associated with the item."
+    },
+    "PackageReferenceId": {
+      "type": "string",
+      "description": "A seller-supplied identifier that uniquely identifies a package within the scope of an order. Only positive numeric values are supported."
+    },
     "ErrorList": {
       "type": "array",
       "description": "A list of error responses returned when a request is unsuccessful.",
@@ -3889,7 +5467,7 @@
         },
         "message": {
           "type": "string",
-          "description": "A message that describes the error condition in a human-readable form."
+          "description": "A message that describes the error condition."
         },
         "details": {
           "type": "string",