Update all APIs and Models (#683)

Author: jasonhebert

src/AmazonPHP/SellingPartner/Api/AwdApi/WarehousingAndDistributionSDK.php

@@ -17,9 +17,9 @@
 use Psr\Log\LoggerInterface;
 
 /**
- * The Selling Partner API for AWD.
+ * The Selling Partner API for Amazon Warehousing and Distribution.
  *
- * The Selling Partner API for Amazon Warehousing and Distribution (AWD).
+ * The Selling Partner API for Amazon Warehousing and Distribution (AWD) provides programmatic access to information about AWD shipments and inventory.
  *
  * The version of the OpenAPI document: 2024-05-09
  *
@@ -36,13 +36,14 @@ public function __construct(private readonly ClientInterface $client, private re
      * Operation getInboundShipment.
      *
      * @param string $shipment_id ID for the shipment. A shipment contains the cases being inbounded. (required)
+     * @param null|string $sku_quantities If equal to `SHOW`, the response includes the shipment SKU quantity details.  Defaults to `HIDE`, in which case the response does not contain SKU quantities (optional)
      *
      * @throws ApiException on non-2xx response
      * @throws InvalidArgumentException
      */
-    public function getInboundShipment(AccessToken $accessToken, string $region, string $shipment_id) : \AmazonPHP\SellingPartner\Model\WarehousingAndDistribution\InboundShipment
+    public function getInboundShipment(AccessToken $accessToken, string $region, string $shipment_id, ?string $sku_quantities = null) : \AmazonPHP\SellingPartner\Model\WarehousingAndDistribution\InboundShipment
     {
-        $request = $this->getInboundShipmentRequest($accessToken, $region, $shipment_id);
+        $request = $this->getInboundShipmentRequest($accessToken, $region, $shipment_id, $sku_quantities);
 
         $this->configuration->extensions()->preRequest('WarehousingAndDistribution', 'getInboundShipment', $request);
 
@@ -132,10 +133,11 @@ public function getInboundShipment(AccessToken $accessToken, string $region, str
      * Create request for operation 'getInboundShipment'.
      *
      * @param string $shipment_id ID for the shipment. A shipment contains the cases being inbounded. (required)
+     * @param null|string $sku_quantities If equal to `SHOW`, the response includes the shipment SKU quantity details.  Defaults to `HIDE`, in which case the response does not contain SKU quantities (optional)
      *
      * @throws \AmazonPHP\SellingPartner\Exception\InvalidArgumentException
      */
-    public function getInboundShipmentRequest(AccessToken $accessToken, string $region, string $shipment_id) : RequestInterface
+    public function getInboundShipmentRequest(AccessToken $accessToken, string $region, string $shipment_id, ?string $sku_quantities = null) : RequestInterface
     {
         // verify the required parameter 'shipment_id' is set
         if ($shipment_id === null || (\is_array($shipment_id) && \count($shipment_id) === 0)) {
@@ -155,6 +157,15 @@ public function getInboundShipmentRequest(AccessToken $accessToken, string $regi
         $multipart = false;
         $query = '';
 
+        // query params
+        if (\is_array($sku_quantities)) {
+            $sku_quantities = ObjectSerializer::serializeCollection($sku_quantities, '', true);
+        }
+
+        if ($sku_quantities !== null) {
+            $queryParams['skuQuantities'] = ObjectSerializer::toString($sku_quantities);
+        }
+
         if (\count($queryParams)) {
             $query = \http_build_query($queryParams);
         }
@@ -226,8 +237,8 @@ public function getInboundShipmentRequest(AccessToken $accessToken, string $regi
     /**
      * Operation listInboundShipments.
      *
-     * @param null|string $sort_by Field to sort results by. Required if `sortOrder` is provided. (optional)
-     * @param null|string $sort_order Sort the response in `ASCENDING` or `DESCENDING` order. (optional)
+     * @param null|string $sort_by Field to sort results by. By default, the response will be sorted by UPDATED_AT. (optional)
+     * @param null|string $sort_order Sort the response in ASCENDING or DESCENDING order. By default, the response will be sorted in DESCENDING order. (optional)
      * @param null|string $shipment_status Filter by inbound shipment status. (optional)
      * @param null|\DateTimeInterface $updated_after List the inbound shipments that were updated after a certain time (inclusive). The date must be in <a href='https://developer-docs.amazon.com/sp-api/docs/iso-8601'>ISO 8601</a> format. (optional)
      * @param null|\DateTimeInterface $updated_before List the inbound shipments that were updated before a certain time (inclusive). The date must be in <a href='https://developer-docs.amazon.com/sp-api/docs/iso-8601'>ISO 8601</a> format. (optional)
@@ -328,8 +339,8 @@ public function listInboundShipments(AccessToken $accessToken, string $region, ?
     /**
      * Create request for operation 'listInboundShipments'.
      *
-     * @param null|string $sort_by Field to sort results by. Required if `sortOrder` is provided. (optional)
-     * @param null|string $sort_order Sort the response in `ASCENDING` or `DESCENDING` order. (optional)
+     * @param null|string $sort_by Field to sort results by. By default, the response will be sorted by UPDATED_AT. (optional)
+     * @param null|string $sort_order Sort the response in ASCENDING or DESCENDING order. By default, the response will be sorted in DESCENDING order. (optional)
      * @param null|string $shipment_status Filter by inbound shipment status. (optional)
      * @param null|\DateTimeInterface $updated_after List the inbound shipments that were updated after a certain time (inclusive). The date must be in <a href='https://developer-docs.amazon.com/sp-api/docs/iso-8601'>ISO 8601</a> format. (optional)
      * @param null|\DateTimeInterface $updated_before List the inbound shipments that were updated before a certain time (inclusive). The date must be in <a href='https://developer-docs.amazon.com/sp-api/docs/iso-8601'>ISO 8601</a> format. (optional)

src/AmazonPHP/SellingPartner/Api/AwdApi/WarehousingAndDistributionSDKInterface.php

@@ -7,9 +7,9 @@
 use AmazonPHP\SellingPartner\Exception\InvalidArgumentException;
 
 /**
- * The Selling Partner API for AWD.
+ * The Selling Partner API for Amazon Warehousing and Distribution.
  *
- * The Selling Partner API for Amazon Warehousing and Distribution (AWD).
+ * The Selling Partner API for Amazon Warehousing and Distribution (AWD) provides programmatic access to information about AWD shipments and inventory.
  *
  * The version of the OpenAPI document: 2024-05-09
  *
@@ -36,17 +36,18 @@ interface WarehousingAndDistributionSDKInterface
      * Operation getInboundShipment.
      *
      * @param string $shipment_id ID for the shipment. A shipment contains the cases being inbounded. (required)
+     * @param null|string $sku_quantities If equal to `SHOW`, the response includes the shipment SKU quantity details.  Defaults to `HIDE`, in which case the response does not contain SKU quantities (optional)
      *
      * @throws ApiException on non-2xx response
      * @throws InvalidArgumentException
      */
-    public function getInboundShipment(AccessToken $accessToken, string $region, string $shipment_id) : \AmazonPHP\SellingPartner\Model\WarehousingAndDistribution\InboundShipment;
+    public function getInboundShipment(AccessToken $accessToken, string $region, string $shipment_id, ?string $sku_quantities = null) : \AmazonPHP\SellingPartner\Model\WarehousingAndDistribution\InboundShipment;
 
     /**
      * Operation listInboundShipments.
      *
-     * @param null|string $sort_by Field to sort results by. Required if `sortOrder` is provided. (optional)
-     * @param null|string $sort_order Sort the response in `ASCENDING` or `DESCENDING` order. (optional)
+     * @param null|string $sort_by Field to sort results by. By default, the response will be sorted by UPDATED_AT. (optional)
+     * @param null|string $sort_order Sort the response in ASCENDING or DESCENDING order. By default, the response will be sorted in DESCENDING order. (optional)
      * @param null|string $shipment_status Filter by inbound shipment status. (optional)
      * @param null|\DateTimeInterface $updated_after List the inbound shipments that were updated after a certain time (inclusive). The date must be in <a href='https://developer-docs.amazon.com/sp-api/docs/iso-8601'>ISO 8601</a> format. (optional)
      * @param null|\DateTimeInterface $updated_before List the inbound shipments that were updated before a certain time (inclusive). The date must be in <a href='https://developer-docs.amazon.com/sp-api/docs/iso-8601'>ISO 8601</a> format. (optional)