ACP2E-3032: [Documentation] Please mention that POST "ship" REST API call does not validate total shipped items quantity.

Author: o-dubovyk

app/code/Magento/Sales/Api/Data/ShipmentInterface.php

@@ -23,75 +23,75 @@ interface ShipmentInterface extends \Magento\Framework\Api\ExtensibleDataInterfa
     /*
      * Entity ID.
      */
-    const ENTITY_ID = 'entity_id';
+    public const ENTITY_ID = 'entity_id';
     /*
      * Store ID.
      */
-    const STORE_ID = 'store_id';
+    public const STORE_ID = 'store_id';
     /*
      * Total weight.
      */
-    const TOTAL_WEIGHT = 'total_weight';
+    public const TOTAL_WEIGHT = 'total_weight';
     /*
      * Total quantity. Can be greater than ordered quantity (not validated).
      */
-    const TOTAL_QTY = 'total_qty';
+    public const TOTAL_QTY = 'total_qty';
     /*
      * Email sent flag.
      */
-    const EMAIL_SENT = 'email_sent';
+    public const EMAIL_SENT = 'email_sent';
     /*
      * Order ID.
      */
-    const ORDER_ID = 'order_id';
+    public const ORDER_ID = 'order_id';
     /*
      * Customer ID.
      */
-    const CUSTOMER_ID = 'customer_id';
+    public const CUSTOMER_ID = 'customer_id';
     /*
      * Shipping address ID.
      */
-    const SHIPPING_ADDRESS_ID = 'shipping_address_id';
+    public const SHIPPING_ADDRESS_ID = 'shipping_address_id';
     /*
      * Billing address ID.
      */
-    const BILLING_ADDRESS_ID = 'billing_address_id';
+    public const BILLING_ADDRESS_ID = 'billing_address_id';
     /*
      * Shipment status.
      */
-    const SHIPMENT_STATUS = 'shipment_status';
+    public const SHIPMENT_STATUS = 'shipment_status';
     /*
      * Increment ID.
      */
-    const INCREMENT_ID = 'increment_id';
+    public const INCREMENT_ID = 'increment_id';
     /*
      * Created-at timestamp.
      */
-    const CREATED_AT = 'created_at';
+    public const CREATED_AT = 'created_at';
     /*
      * Updated-at timestamp.
      */
-    const UPDATED_AT = 'updated_at';
+    public const UPDATED_AT = 'updated_at';
     /*
      * Packages.
      */
-    const PACKAGES = 'packages';
+    public const PACKAGES = 'packages';
     /*
      * Shipping label.
      */
-    const SHIPPING_LABEL = 'shipping_label';
+    public const SHIPPING_LABEL = 'shipping_label';
     /*
      * Items.
      */
-    const ITEMS = 'items';
+    public const ITEMS = 'items';
     /*
      * Tracks.
      */
-    const TRACKS = 'tracks';
+    public const TRACKS = 'tracks';
     /*
      * Comments.
      */
-    const COMMENTS = 'comments';
+    public const COMMENTS = 'comments';
 
     /**
      * Gets the billing address ID for the shipment.