Updated API from documentation release

Author: ct-sdks[bot]

api-specs/api/examples/CartDiscount/CartDiscountValueRelative.json

@@ -1,4 +1,5 @@
 {
   "type": "relative",
-  "permyriad": 1000
+  "permyriad": 1000,
+  "applicationMode": "ProportionateDistribution"
 }

api-specs/api/resources/cart-discounts.raml

@@ -53,7 +53,8 @@ post:
             ],
         },
     ]
-  description: Creating a Cart Discount produces the [CartDiscountCreated](ctp:api:type:CartDiscountCreatedMessage) Message.
+  description: |
+    Creating a Cart Discount produces the [CartDiscountCreated](ctp:api:type:CartDiscountCreatedMessage) Message.
   body:
     application/json:
       example: !include ../examples/cart-discount-create.example.json

api-specs/api/types/cart-discount/CartDiscountValueRelative.raml

@@ -12,3 +12,11 @@ properties:
     format: int64
     description: |
       Fraction (per ten thousand) the price is reduced by. For example, `1000` will result in a 10% price reduction.
+  applicationMode?:
+    type: DiscountApplicationMode
+    default: IndividualApplication
+    description: |
+      Indicates how the discount applies when using [CartDiscountPatternTarget](ctp:api:type:CartDiscountPatternTarget).
+
+      - If the mode is `IndividualApplication`, the discounted percentage is applied on each unit's price. The units matching the `triggerPattern` are not considered.
+      - If the mode is `ProportionateDistribution` and `EvenDistribution` the discounted value is calculated from the total value of the units matching the `targetPattern` and distributed among the units matching the `targetPattern` or `triggerPattern`. These modes are allowed only if [CartDiscountPatternTarget](ctp:api:type:CartDiscountPatternTarget) `triggerPattern` is non-empty.

api-specs/api/types/cart-discount/CartDiscountValueRelativeDraft.raml

@@ -10,3 +10,11 @@ properties:
     format: int64
     description: |
       Fraction (per ten thousand) the price is reduced by. For example, `1000` will result in a 10% price reduction.
+  applicationMode?:
+    type: DiscountApplicationMode
+    default: IndividualApplication
+    description: |
+      Determines how the discount applies when using [CartDiscountPatternTarget](ctp:api:type:CartDiscountPatternTarget).
+
+      - If the mode is `IndividualApplication`, the discounted percentage is applied on each unit's price. The units matching the `triggerPattern` are not considered.
+      - If the mode is `ProportionateDistribution` and `EvenDistribution` the discounted value is calculated from the total value of the units matching the `targetPattern` and distributed among the units matching the `targetPattern` or `triggerPattern`. These modes are allowed only if [CartDiscountPatternTarget](ctp:api:type:CartDiscountPatternTarget) `triggerPattern` is non-empty.

api-specs/api/types/cart-discount/DiscountApplicationMode.raml

@@ -3,7 +3,7 @@
 type: string
 displayName: DiscountApplicationMode
 description: |
-  This mode determines how absolute Discounts are applied on Line Items or Custom Line Items.
+  This mode determines how Discounts are distributed among items in a Cart.
 (enumDescriptions):
   ProportionateDistribution: Distributes the Discount proportionately across eligible Line Items or Custom Line Items.
   EvenDistribution: Distributes the Discount evenly across eligible Line Items or Custom Line Items.

api-specs/api/types/cart-discount/updates/CartDiscountChangeTargetAction.raml

@@ -9,3 +9,7 @@ properties:
     type: CartDiscountTarget
     description: |
       New value to set.
+
+      For a [CartDiscountValueRelative](ctp:api:type:CartDiscountValueRelative), if `applicationMode` is set, the target must be [CartDiscountPatternTarget](ctp:api:type:CartDiscountPatternTarget).
+      If `applicationMode` is `ProportionateDistribution` or `EvenDistribution`, the [CartDiscountPatternTarget](ctp:api:type:CartDiscountPatternTarget) `triggerPattern` must be non-empty.
+      If either conditions are not met, an [InvalidOperation](ctp:api:type:InvalidOperationError) error is returned.

api-specs/api/types/cart-discount/updates/CartDiscountChangeValueAction.raml

@@ -12,4 +12,5 @@ properties:
     type: CartDiscountValueDraft
     description: |
       New value to set.
+
       When trying to set a [CartDiscountValueGiftLineItemDraft](ctp:api:type:CartDiscountValueGiftLineItemDraft) an [InvalidInput](ctp:api:type:InvalidInputError) error is returned.

api-specs/graphql/schema.sdl

@@ -2021,6 +2021,7 @@ input CartDiscountValueBaseMoneyInput {
 
 input CartDiscountValueInput {
   relative: RelativeDiscountValueInput
+  relativeCart: RelativeCartDiscountValueInput
   absolute: AbsoluteDiscountValueInput
   absoluteCart: AbsoluteCartDiscountValueInput
   fixed: FixedPriceDiscountValueInput
@@ -11117,6 +11118,17 @@ input RejectApprovalFlow {
   reason: String
 }
 
+type RelativeCartDiscountValue implements CartDiscountValue {
+  permyriad: Int!
+  applicationMode: DiscountApplicationMode!
+  type: String!
+}
+
+input RelativeCartDiscountValueInput {
+  permyriad: Int!
+  applicationMode: DiscountApplicationMode!
+}
+
 type RelativeDiscountValue implements CartDiscountValue & ProductDiscountValue {
   permyriad: Int!
   type: String!