Updated API from documentation release

Author: ct-sdks[bot]

api-specs/api/types/cart/BestDeal.raml

@@ -0,0 +1,12 @@
+#%RAML 1.0 DataType
+(package): Cart
+type: DiscountTypeCombination
+displayName: BestDeal
+discriminatorValue: BestDeal
+description: |
+  Indicates the best deal logic applies to a Cart or Order and indicates the discount type that offers the best deal.
+properties:
+  chosenDiscountType:
+    type: string
+    description: |
+      Discount type that offers the best deal; the value can be `product-discount` or `cart-discount`.

api-specs/api/types/cart/Cart.raml

@@ -185,6 +185,10 @@ properties:
     type: CustomFields
     description: |
       Custom Fields of the Cart.
+  discountTypeCombination?:
+    type: DiscountTypeCombination
+    description: |
+      Indicates if a combination of discount types can apply on a Cart.
   deleteDaysAfterLastModification?:
     type: integer
     description: |

api-specs/api/types/cart/DiscountTypeCombination.raml

@@ -0,0 +1,8 @@
+#%RAML 1.0 DataType
+(package): Cart
+type: object
+displayName: DiscountTypeCombination
+discriminator: type
+properties:
+  type:
+    type: string

api-specs/api/types/cart/Stacking.raml

@@ -0,0 +1,7 @@
+#%RAML 1.0 DataType
+(package): Cart
+type: DiscountTypeCombination
+displayName: Stacking
+discriminatorValue: Stacking
+description: |
+  Indicates both Product Discounts and Cart Discounts apply to a Cart and Order.

api-specs/api/types/order/Order.raml

@@ -212,6 +212,10 @@ properties:
     type: ReturnInfo[]
     description: |
       Contains information regarding the returns associated with the Order.
+  discountTypeCombination?:
+    type: DiscountTypeCombination
+    description: |
+      Indicates if a combination of discount types can apply on an Order.
   lastMessageSequenceNumber?:
     (markDeprecated): true
     type: number

api-specs/api/types/types.raml

@@ -180,6 +180,7 @@ CartDiscountSetStoresAction: !include cart-discount/updates/CartDiscountSetStore
 CartDiscountSetValidFromAction: !include cart-discount/updates/CartDiscountSetValidFromAction.raml
 CartDiscountSetValidFromAndUntilAction: !include cart-discount/updates/CartDiscountSetValidFromAndUntilAction.raml
 CartDiscountSetValidUntilAction: !include cart-discount/updates/CartDiscountSetValidUntilAction.raml
+BestDeal: !include cart/BestDeal.raml
 Cart: !include cart/Cart.raml
 CartDraft: !include cart/CartDraft.raml
 CartOrigin: !include cart/CartOrigin.raml
@@ -201,6 +202,7 @@ DirectDiscountReference: !include cart/DirectDiscountReference.raml
 DiscountCodeInfo: !include cart/DiscountCodeInfo.raml
 DiscountCodeState: !include cart/DiscountCodeState.raml
 DiscountOnTotalPrice: !include cart/DiscountOnTotalPrice.raml
+DiscountTypeCombination: !include cart/DiscountTypeCombination.raml
 DiscountedLineItemPortion: !include cart/DiscountedLineItemPortion.raml
 DiscountedLineItemPortionDraft: !include cart/DiscountedLineItemPortionDraft.raml
 DiscountedLineItemPrice: !include cart/DiscountedLineItemPrice.raml
@@ -231,6 +233,7 @@ ShippingMethodState: !include cart/ShippingMethodState.raml
 ShippingMode: !include cart/ShippingMode.raml
 ShippingRateInput: !include cart/ShippingRateInput.raml
 ShippingRateInputDraft: !include cart/ShippingRateInputDraft.raml
+Stacking: !include cart/Stacking.raml
 TaxCalculationMode: !include cart/TaxCalculationMode.raml
 TaxMode: !include cart/TaxMode.raml
 TaxPortion: !include cart/TaxPortion.raml

api-specs/graphql/schema.sdl

@@ -1737,6 +1737,7 @@ type Cart implements Versioned & ReferenceExpandable {
   taxedShippingPrice: TaxedPrice
   shippingMode: ShippingMode!
   shippingCustomFields: CustomFieldsType
+  discountTypeCombination: DiscountTypeCombination
   cartState: CartState!
   key: String
   custom: CustomFieldsType
@@ -1963,6 +1964,25 @@ input CartDiscountValueInput {
   giftLineItem: GiftLineItemValueInput
 }
 
+"Chosen discount type for the cart as part of best deal"
+enum ChosenDiscountType {
+  CartDiscount
+  ProductDiscount
+}
+
+interface DiscountTypeCombination {
+  type: String!
+}
+
+type Stacking implements DiscountTypeCombination {
+  type: String!
+}
+
+type BestDeal implements DiscountTypeCombination {
+  type: String!
+  chosenDiscountType: ChosenDiscountType
+}
+
 input CartDraft {
   currency: Currency!
   country: Country
@@ -6820,6 +6840,7 @@ type Order implements Versioned & ReferenceExpandable {
   shippingInfo: ShippingInfo
   discountCodes: [DiscountCodeInfo!]!
   directDiscounts: [DirectDiscount!]!
+  discountTypeCombination: DiscountTypeCombination
   refusedGifts: [CartDiscount!]!
   refusedGiftsRefs: [Reference!]!
   paymentInfo: PaymentInfo