brinkcommerce-dev-mcp 0.1.0-beta.1

package/openapi-specs/.cache/Shopper.yaml

@@ -0,0 +1,2201 @@
+openapi: 3.0.3
+info:
+  title: Shopper
+  version: '1'
+servers:
+  - url: https://shopper.eu-west-1.CUSTOMER_NAME.brinkcommerce.io/shopper
+security: []
+paths:
+  /prices/product-parents/{productParentId}/store-groups/{storeGroupId}/markets/{countryCode}:
+    get:
+      operationId: GetProductParentPrices
+      parameters:
+        - $ref: '#/components/parameters/apiKey'
+        - $ref: '#/components/parameters/productParentId'
+        - $ref: '#/components/parameters/storeGroupId'
+        - $ref: '#/components/parameters/countryCode'
+      responses:
+        '200':
+          description: 200 response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ProductParentPricesResponse'
+        '404':
+          description: 404 response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ErrorResponse'
+      x-hideTryItPanel: true
+  /stocks/product-parents/{productParentId}/store-groups/{storeGroupId}/markets/{countryCode}:
+    get:
+      operationId: GetProductParentStock
+      parameters:
+        - $ref: '#/components/parameters/apiKey'
+        - $ref: '#/components/parameters/productParentId'
+        - $ref: '#/components/parameters/storeGroupId'
+        - $ref: '#/components/parameters/countryCode'
+      responses:
+        '200':
+          description: 200 response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ProductParentStockResponse'
+        '404':
+          description: 404 response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ErrorResponse'
+      x-hideTryItPanel: true
+  /sessions/start:
+    post:
+      operationId: StartSession
+      parameters:
+        - $ref: '#/components/parameters/apiKey'
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/PostShopperSessionStartRequest'
+        required: true
+      responses:
+        '200':
+          description: 200 response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ShopperSession'
+        '500':
+          description: 500 response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ErrorResponse'
+      x-hideTryItPanel: true
+  /sessions:
+    get:
+      operationId: GetSession
+      security:
+        - JWT: []
+      parameters:
+        - $ref: '#/components/parameters/apiKey'
+      responses:
+        '200':
+          description: 200 response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ShopperSession'
+        '400':
+          description: 400 response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ErrorResponse'
+        '404':
+          description: 404 response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ErrorResponse'
+        '500':
+          description: 500 response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ErrorResponse'
+      x-hideTryItPanel: true
+  /sessions/attributes:
+    patch:
+      operationId: PatchSessionAttributes
+      security:
+        - JWT: []
+      parameters:
+        - $ref: '#/components/parameters/apiKey'
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/SessionAttributes'
+        required: true
+      responses:
+        '200':
+          description: 200 response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/SessionAttributes'
+        '400':
+          description: 400 response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ErrorResponse'
+        '500':
+          description: 500 response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ErrorResponse'
+      x-hideTryItPanel: true
+  /sessions/discount-codes:
+    post:
+      operationId: AddSessionDiscountCode
+      security:
+        - JWT: []
+      parameters:
+        - $ref: '#/components/parameters/apiKey'
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/PostDiscountCodeRequest'
+        required: true
+      responses:
+        '200':
+          description: 200 response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ShopperSession'
+        '400':
+          description: 400 response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/InactiveDiscountCode'
+        '403':
+          description: 403 response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ErrorResponse'
+        '404':
+          description: 404 response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/MissingDiscountCode'
+        '409':
+          description: 409 response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ConflictDiscountCode'
+        '500':
+          description: 500 response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ErrorResponse'
+      x-hideTryItPanel: true
+  /sessions/discount-codes/{code}:
+    delete:
+      operationId: DeleteSessionDiscountCode
+      security:
+        - JWT: []
+      parameters:
+        - $ref: '#/components/parameters/apiKey'
+        - $ref: '#/components/parameters/code'
+      responses:
+        '200':
+          description: 200 response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ShopperSession'
+        '400':
+          description: 400 response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ErrorResponse'
+        '403':
+          description: 403 response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ErrorResponse'
+        '409':
+          description: 409 response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ErrorResponse'
+        '500':
+          description: 500 response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ErrorResponse'
+      x-hideTryItPanel: true
+  /sessions/items:
+    post:
+      operationId: AddSessionItem
+      security:
+        - JWT: []
+      parameters:
+        - $ref: '#/components/parameters/apiKey'
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/PostShopperSessionItemsRequest'
+        required: true
+      responses:
+        '200':
+          description: 200 response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ShopperSession'
+        '400':
+          description: 400 response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ErrorResponse'
+        '403':
+          description: 403 response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ErrorResponse'
+        '404':
+          description: 404 response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ErrorResponseOutOfStock'
+        '500':
+          description: 500 response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ErrorResponse'
+      x-hideTryItPanel: true
+  /sessions/items/{itemId}:
+    put:
+      operationId: UpdateSessionItem
+      security:
+        - JWT: []
+      parameters:
+        - $ref: '#/components/parameters/apiKey'
+        - $ref: '#/components/parameters/itemId'
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/PutShopperSessionItemQuantityRequest'
+        required: true
+      responses:
+        '200':
+          description: 200 response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ShopperSession'
+        '400':
+          description: 400 response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ErrorResponse'
+        '403':
+          description: 403 response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ErrorResponse'
+        '404':
+          description: 404 response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ErrorResponseOutOfStock'
+        '500':
+          description: 500 response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ErrorResponse'
+      x-hideTryItPanel: true
+    delete:
+      operationId: RemoveSessionItem
+      security:
+        - JWT: []
+      parameters:
+        - $ref: '#/components/parameters/apiKey'
+        - $ref: '#/components/parameters/itemId'
+      responses:
+        '200':
+          description: 200 response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ShopperSession'
+        '400':
+          description: 400 response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ErrorResponse'
+        '403':
+          description: 403 response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ErrorResponse'
+        '404':
+          description: 404 response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ErrorResponse'
+        '409':
+          description: 409 response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ErrorResponse'
+        '500':
+          description: 500 response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ErrorResponse'
+      x-hideTryItPanel: true
+  /sessions/items/{itemId}/options:
+    put:
+      operationId: SetSessionItemOptions
+      security:
+        - JWT: []
+      parameters:
+        - $ref: '#/components/parameters/apiKey'
+        - $ref: '#/components/parameters/itemId'
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/PutShopperSessionItemOptionsRequest'
+        required: true
+      responses:
+        '200':
+          description: 200 response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ShopperSession'
+        '400':
+          description: 400 response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ErrorResponse'
+        '403':
+          description: 403 response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ErrorResponse'
+        '404':
+          description: 404 response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ErrorResponse'
+        '500':
+          description: 500 response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ErrorResponse'
+      x-hideTryItPanel: true
+    delete:
+      operationId: RemoveSessionItemOptions
+      security:
+        - JWT: []
+      parameters:
+        - $ref: '#/components/parameters/apiKey'
+        - $ref: '#/components/parameters/itemId'
+      responses:
+        '200':
+          description: 200 response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ShopperSession'
+        '400':
+          description: 400 response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ErrorResponse'
+        '403':
+          description: 403 response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ErrorResponse'
+        '404':
+          description: 404 response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ErrorResponse'
+        '500':
+          description: 500 response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ErrorResponse'
+      x-hideTryItPanel: true
+  /sessions/items/{itemId}/options/{optionKey}:
+    put:
+      operationId: SetSessionItemOption
+      security:
+        - JWT: []
+      parameters:
+        - $ref: '#/components/parameters/apiKey'
+        - $ref: '#/components/parameters/itemId'
+        - $ref: '#/components/parameters/optionKey'
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/PutShopperSessionItemOptionRequest'
+        required: true
+      responses:
+        '200':
+          description: 200 response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ShopperSession'
+        '400':
+          description: 400 response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ErrorResponse'
+        '403':
+          description: 403 response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ErrorResponse'
+        '404':
+          description: 404 response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ErrorResponse'
+        '500':
+          description: 500 response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ErrorResponse'
+      x-hideTryItPanel: true
+    delete:
+      operationId: RemoveSessionItemOption
+      security:
+        - JWT: []
+      parameters:
+        - $ref: '#/components/parameters/apiKey'
+        - $ref: '#/components/parameters/itemId'
+        - $ref: '#/components/parameters/optionKey'
+      responses:
+        '200':
+          description: 200 response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ShopperSession'
+        '400':
+          description: 400 response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ErrorResponse'
+        '403':
+          description: 403 response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ErrorResponse'
+        '404':
+          description: 404 response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ErrorResponse'
+        '500':
+          description: 500 response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ErrorResponse'
+      x-hideTryItPanel: true
+  /sessions/checkout/start:
+    post:
+      operationId: StartCheckout
+      security:
+        - JWT: []
+      parameters:
+        - $ref: '#/components/parameters/apiKey'
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/PostShopperCheckoutStartRequest'
+        required: true
+      responses:
+        '200':
+          description: 200 response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/StartCheckoutResponse'
+        '400':
+          description: 400 response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ErrorResponse'
+        '403':
+          description: 403 response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ErrorResponse'
+        '404':
+          description: 404 response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ErrorResponseOutOfStock'
+        '409':
+          description: 409 response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ErrorResponse'
+        '500':
+          description: 500 response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ErrorResponse'
+      x-hideTryItPanel: true
+  /sessions/checkout:
+    get:
+      operationId: GetCheckout
+      security:
+        - JWT: []
+      parameters:
+        - $ref: '#/components/parameters/apiKey'
+      responses:
+        '200':
+          description: 200 response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/GetCheckoutResponse'
+        '403':
+          description: 403 response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ErrorResponse'
+        '404':
+          description: 404 response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ErrorResponse'
+        '500':
+          description: 500 response
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ErrorResponse'
+      x-hideTryItPanel: true
+components:
+  parameters:
+    apiKey:
+      name: x-shopper-api-key
+      in: header
+      description: |
+        Shopper API Key should be used for integrations using BFF (Backend for Frontend) or
+        other reverse-proxy between the end-user and Shopper. Generated by Brink Commerce
+      required: false
+      schema:
+        type: string
+        nullable: false
+    optionKey:
+      name: optionKey
+      in: path
+      required: true
+      description: |
+        The key must use only alphanumeric, hyphen & underscore characters, and max 40 in length (`^[A-Za-z0-9_-]{1,40}$`).
+      schema:
+        type: string
+        minLength: 1
+        maxLength: 40
+        pattern: ^[A-Za-z0-9_-]{1,40}$
+    itemId:
+      name: itemId
+      in: path
+      required: true
+      schema:
+        type: string
+        format: uuid
+    countryCode:
+      name: countryCode
+      in: path
+      required: true
+      schema:
+        $ref: '#/components/schemas/CountryCode'
+    storeGroupId:
+      name: storeGroupId
+      in: path
+      required: true
+      schema:
+        $ref: '#/components/schemas/StoreGroupId'
+    productParentId:
+      name: productParentId
+      in: path
+      required: true
+      schema:
+        $ref: '#/components/schemas/ProductParentId'
+    code:
+      name: code
+      in: path
+      required: true
+      schema:
+        $ref: '#/components/schemas/DiscountCode'
+  schemas:
+    CartCapabilities:
+      type: object
+      description: Available cart capabilities for the current shopper session
+      properties:
+        retain24:
+          $ref: '#/components/schemas/CartCapabilityRetain24'
+        bonus:
+          $ref: '#/components/schemas/CartCapabilityBonus'
+        voyado:
+          $ref: '#/components/schemas/CartCapabilityVoyado'
+    CartCapabilityRetain24:
+      type: object
+      nullable: true
+      description: Available Retain24 provider
+      required:
+        - id
+      properties:
+        id:
+          type: string
+          description: Provider id
+        config:
+          type: object
+          additionalProperties:
+            type: string
+    CartCapabilityBonus:
+      type: object
+      nullable: true
+      description: Available Bonus provider
+      required:
+        - id
+      properties:
+        id:
+          type: string
+          description: Provider id
+        config:
+          type: object
+          additionalProperties:
+            type: string
+    CartCapabilityVoyado:
+      type: object
+      nullable: true
+      description: Available Voyado provider
+      required:
+        - id
+      properties:
+        id:
+          type: string
+          description: Provider id
+        config:
+          type: object
+          additionalProperties:
+            type: string
+    CartGiftCardProduct:
+      required:
+        - amount
+        - distribution
+        - id
+        - name
+        - provider
+      type: object
+      properties:
+        amount:
+          type: integer
+          description: Monetary amount in minor units
+        provider:
+          type: string
+          description: Provider used for gift card product
+        name:
+          type: string
+          description: Name
+        recipient:
+          type: string
+          description: Recipient information used for gift card distribution
+        id:
+          type: string
+          description: ID for the gift card product
+        distribution:
+          type: string
+          description: Distribution of the gift card
+        merchantReference:
+          type: string
+          description: Merchant reference
+    CheckoutBonus:
+      required:
+        - maxAmount
+      type: object
+      properties:
+        maxAmount:
+          type: integer
+          format: int64
+          description: Max amount in minor units from bonus points
+    CheckoutGiftCard:
+      type: object
+      properties:
+        amount:
+          type: integer
+          description: Amount to be used from gift card
+        id:
+          type: string
+          description: ID for the checkout gift card
+    CurrencyCode:
+      title: CurrencyCode
+      maxLength: 3
+      minLength: 3
+      pattern: ^[A-Z]{3}$
+      type: string
+      description: ISO 4217 currency code
+    ItemDiscountOutcome:
+      title: ItemDiscountOutcome
+      required:
+        - bundles
+        - cartRules
+        - codeRules
+        - externalRules
+        - totalDiscountAmount
+      type: object
+      properties:
+        externalRules:
+          type: array
+          items:
+            required:
+              - discountAmount
+              - reference
+              - ruleId
+            type: object
+            properties:
+              reference:
+                type: string
+                description: Reference from the external provider used with this rule
+              discountAmount:
+                type: integer
+                description: The discount amount in minor units
+              ruleId:
+                type: string
+                description: Id of the discount external rule applying this discount
+        codeRules:
+          type: array
+          items:
+            required:
+              - code
+              - discountAmount
+              - ruleId
+            type: object
+            properties:
+              code:
+                type: string
+                description: Code used with this rule
+              discountAmount:
+                type: integer
+                description: The discount amount in minor units
+              ruleId:
+                type: string
+                description: Id of the discount code rule applying this discount
+        totalDiscountAmount:
+          type: integer
+          description: The total discount amount from discount rules applied on this item
+        bundles:
+          type: array
+          items:
+            required:
+              - bundleGroupId
+              - bundleId
+              - discountAmount
+            type: object
+            properties:
+              bundleGroupId:
+                type: string
+                description: Id of the bundle group
+              bundleId:
+                type: string
+                description: Id of the bundle
+              discountAmount:
+                type: integer
+                description: The discount amount in minor units
+        cartRules:
+          type: array
+          items:
+            required:
+              - discountAmount
+              - ruleId
+            type: object
+            properties:
+              discountAmount:
+                type: integer
+                description: The discount amount in minor units
+              ruleId:
+                type: string
+                description: Id of the discount cart rule applying this discount
+    LanguageCode:
+      title: LanguageCode
+      pattern: ^[A-Za-z0-9_-]+$
+      type: string
+      description: Language code
+    CustomAttributes:
+      title: CustomAttributes
+      maxProperties: 50
+      type: object
+      additionalProperties:
+        type: string
+        maxLength: 500
+    CheckoutRevision:
+      title: Checkout
+      type: object
+      properties:
+        id:
+          type: string
+        revision:
+          type: integer
+    PostShopperSessionItemsRequest:
+      title: PostShopperSessionItemsRequest
+      required:
+        - productVariantId
+        - quantity
+      type: object
+      properties:
+        quantity:
+          minimum: 1
+          maximum: 9999
+          type: integer
+        productVariantId:
+          type: string
+          maxLength: 100
+        options:
+          $ref: '#/components/schemas/Options'
+    Outcome:
+      title: Outcome
+      type: object
+      properties:
+        id:
+          type: string
+          description: Id for the outcome
+        type:
+          type: string
+          description: Type for the outcome
+    Tags:
+      title: Tags
+      type: object
+      description: |
+        Tags based on the product variant from product-management.
+
+        The keys must use only alphanumeric, hyphen & underscore characters, and max 20 in length (`^[A-Za-z0-9_-]{1,20}$`).
+      maxProperties: 20
+      additionalProperties:
+        type: array
+        minItems: 1
+        maxItems: 10
+        uniqueItems: true
+        items:
+          type: string
+          pattern: ^[^\n\t]+$
+          maxLength: 40
+          uniqueItems: true
+    CheckoutShippingOption:
+      type: object
+      properties:
+        basePriceAmount:
+          type: integer
+          description: Base price of the shipping option
+        displayName:
+          type: string
+          description: Display name of the shipping option
+        salePriceAmount:
+          type: integer
+          description: Sale price of the shipping option
+        taxPercentage:
+          type: integer
+          description: Tax percentage for the checkout shipping option
+        name:
+          type: string
+          description: Name of the shipping option
+        discountAmount:
+          type: integer
+          description: Discount amount of the shipping option
+        id:
+          type: string
+          description: Unique ID for the checkout shipping option
+        taxAmount:
+          type: integer
+          description: Tax amount of the shipping option
+    CartGift:
+      title: CartGift
+      type: object
+      properties:
+        displayDescription:
+          type: string
+          description: Display description of the product variant
+        quantity:
+          type: integer
+          description: Quantity of the cart item
+        productVariantId:
+          type: string
+          description: ID of the product variant
+        totalPriceAmount:
+          type: integer
+          description: Total price amount of the cart gift
+        displayName:
+          type: string
+          description: Display name of the product variant
+        totalDiscountAmount:
+          type: integer
+          description: Total discount amount of the cart gift
+        taxPercentage:
+          type: integer
+          description: Tax percentage for the cart gift
+        salePriceAmount:
+          type: integer
+          description: Per unit sale price of the product variant
+        description:
+          type: string
+          description: Description of the product variant
+        discountAmount:
+          type: integer
+          description: Per unit discount of the product variant
+        basePriceAmount:
+          type: integer
+          description: Per unit base unit price of the product variant
+        taxGroupId:
+          type: string
+          description: Tax group ID of the cart item
+        imageUrl:
+          type: string
+          description: URL to an image of the product variant
+        name:
+          type: string
+          description: Name of the product variant
+        discountRuleId:
+          type: string
+          description: ID of the discount rule adding this gift
+        id:
+          type: string
+          description: Unique ID for the cart item
+        totalTaxAmount:
+          type: integer
+          description: Total tax amount of the cart gift
+        taxPercentageDecimals:
+          type: integer
+          description: Number of decimals in tax percentage, eg. taxPercentage=2500 and taxPercentageDecimals=2 -> 25 % tax
+        shippingAttributes:
+          $ref: '#/components/schemas/ShippingAttributes'
+        productParentId:
+          $ref: '#/components/schemas/ProductParentId'
+        customAttributes:
+          $ref: '#/components/schemas/CustomAttributes'
+    PutShopperSessionItemOptionRequest:
+      title: PutShopperSessionItemOptionRequest
+      required:
+        - optionValue
+      type: object
+      properties:
+        optionValue:
+          type: string
+          maxLength: 256
+    PutShopperSessionItemOptionsRequest:
+      title: PutShopperSessionItemOptionsRequest
+      required:
+        - options
+      type: object
+      properties:
+        options:
+          $ref: '#/components/schemas/Options'
+    MissingDiscountCode:
+      type: object
+      properties:
+        requestId:
+          type: string
+          description: The request id
+        error:
+          type: string
+          description: The error type
+          enum:
+            - MISSING_DISCOUNT_CODE
+        message:
+          type: string
+          description: The error message
+    ProductParentPricesResponse:
+      type: object
+      required:
+        - productParent
+      properties:
+        productParent:
+          $ref: '#/components/schemas/ProductParentPrices'
+    ProductParentPrices:
+      type: object
+      properties:
+        isTaxIncludedInPrice:
+          type: boolean
+          description: Whether prices include tax or not
+        storeGroupId:
+          $ref: '#/components/schemas/StoreGroupId'
+        countryCode:
+          $ref: '#/components/schemas/CountryCode'
+        productVariants:
+          type: array
+          description: Price information for all available product variants
+          items:
+            $ref: '#/components/schemas/ProductVariantPrices'
+        id:
+          type: string
+          description: The ID of the product parent
+        currencyCode:
+          $ref: '#/components/schemas/CurrencyCode'
+    Campaign:
+      title: Campaign
+      required:
+        - campaignGroupId
+        - campaignId
+        - name
+      type: object
+      properties:
+        campaignId:
+          type: string
+          description: The campaign id
+        campaignGroupId:
+          type: string
+          description: The campaign group id
+        name:
+          type: string
+          description: The campaign name
+    ErrorResponse:
+      title: Error
+      type: object
+      required:
+        - requestId
+        - error
+      properties:
+        requestId:
+          type: string
+          description: The request id
+        error:
+          type: string
+          description: The error message
+    ErrorResponseOutOfStock:
+      title: ErrorResponseOutOfStock
+      allOf:
+        - $ref: '#/components/schemas/ErrorResponse'
+        - type: object
+          properties:
+            productVariantIDs:
+              type: array
+              items:
+                type: string
+                description: List of product variant ids that are out of stock
+    CheckoutAttributes:
+      title: CheckoutAttributes
+      type: object
+      properties:
+        merchantReference1:
+          type: string
+          description: 'Optional merchant reference #1'
+        company:
+          $ref: '#/components/schemas/CheckoutAttributesCompany'
+        merchantReference2:
+          type: string
+          description: 'Optional merchant reference #2'
+    CheckoutAttributesCompany:
+      type: object
+      description: B2B customer details
+      properties:
+        reference:
+          type: string
+          description: Order invoice reference
+        registrationNumber:
+          type: string
+          description: National company registration/organisation number
+        taxId:
+          type: string
+          description: EU VAT Identification Number or equivalent
+        name:
+          type: string
+          description: Company name
+    PostShopperSessionStartRequest:
+      title: PostShopperSessionStartRequest
+      required:
+        - countryCode
+        - languageCode
+        - storeGroupId
+      type: object
+      properties:
+        storeGroupId:
+          $ref: '#/components/schemas/StoreGroupId'
+        countryCode:
+          $ref: '#/components/schemas/CountryCode'
+        languageCode:
+          $ref: '#/components/schemas/LanguageCode'
+    CartBonus:
+      required:
+        - maxAmount
+      type: object
+      properties:
+        maxAmount:
+          type: integer
+          description: Max amount in minor units from bonus points
+    SessionAttributes:
+      title: SessionAttributes
+      type: object
+      properties:
+        company:
+          $ref: '#/components/schemas/SessionAttributeCompany'
+        merchantReference1:
+          pattern: ^[A-Za-z0-9-_]{0,40}$
+          type: string
+          description: 'Optional merchant reference #1 - can be used for attaching a customer id or similar'
+          nullable: true
+        merchantReference2:
+          pattern: ^[A-Za-z0-9-_]{0,40}$
+          type: string
+          description: 'Optional merchant reference #2 - can be used for attaching a customer id or similar'
+          nullable: true
+    SessionAttributeCompany:
+      type: object
+      nullable: true
+      properties:
+        reference:
+          type: string
+          description: Order invoice reference
+        registrationNumber:
+          type: string
+          description: National company registration/organisation number
+        taxId:
+          type: string
+          description: EU VAT Identification Number or equivalent
+        name:
+          type: string
+          description: Company name
+      description: B2B customer details
+    Options:
+      description: |
+        Customer specified options for item
+
+        The keys must use only alphanumeric, hyphen & underscore characters, and max 40 in length (`^[A-Za-z0-9_-]{1,40}$`).
+      type: object
+      nullable: true
+      maxProperties: 10
+      additionalProperties:
+        type: string
+        maxLength: 256
+    CheckoutGift:
+      type: object
+      properties:
+        displayDescription:
+          type: string
+          description: Display description of the product variant
+        quantity:
+          type: integer
+          description: Quantity of the checkout gift
+        productVariantId:
+          type: string
+          description: ID of the product variant
+        totalPriceAmount:
+          type: integer
+          description: Total price amount of the checkout gift
+        displayName:
+          type: string
+          description: Display name of the product variant
+        totalDiscountAmount:
+          type: integer
+          description: Total discount amount of the checkout gift
+        taxPercentage:
+          type: integer
+          description: Tax percentage for the checkout gift
+        salePriceAmount:
+          type: integer
+          description: Per unit sale price of the product variant
+        description:
+          type: string
+          description: Description of the product variant
+        discountAmount:
+          type: integer
+          description: Per unit discount of the product variant
+        basePriceAmount:
+          type: integer
+          description: Per unit base unit price of the product variant
+        taxGroupId:
+          type: string
+          description: Tax group ID of the product variant
+        imageUrl:
+          type: string
+          description: URL to an image of the product variant
+        name:
+          type: string
+          description: Name of the product variant
+        discountRuleId:
+          type: string
+          description: ID of the discount rule adding this gift
+        id:
+          type: string
+          description: Unique ID for the checkout gift
+        totalTaxAmount:
+          type: integer
+          description: Total tax amount of the checkout gift
+        taxPercentageDecimals:
+          type: integer
+          description: Number of decimals in tax percentage, eg. taxPercentage=2500 and taxPercentageDecimals=2 -> 25 % tax
+        shippingAttributes:
+          $ref: '#/components/schemas/ShippingAttributes'
+        productParentId:
+          $ref: '#/components/schemas/ProductParentId'
+        customAttributes:
+          $ref: '#/components/schemas/CustomAttributes'
+    GetCheckoutResponse:
+      type: object
+      required:
+        - checkout
+        - token
+      properties:
+        checkout:
+          $ref: '#/components/schemas/Checkout'
+        token:
+          type: string
+          description: The JWT needed to perform updates to the shopper session
+    Checkout:
+      type: object
+      properties:
+        isTaxIncludedInPrice:
+          type: boolean
+          description: Whether prices include tax or not
+        discountCodes:
+          $ref: '#/components/schemas/DiscountCodes'
+        capabilities:
+          $ref: '#/components/schemas/CheckoutCapabilities'
+        isTaxExempt:
+          type: boolean
+          description: Whether this checkout is tax exempt or not
+        created:
+          type: string
+          description: When this checkout was first created
+          format: date-time
+        bonus:
+          $ref: '#/components/schemas/CheckoutBonus'
+        discountRules:
+          $ref: '#/components/schemas/DiscountRules'
+        discountAmount:
+          type: integer
+          description: Discount amount directly on the checkout, this discount is not related to one item
+        sessionId:
+          type: string
+          description: The session that this checkout is associated with
+        totals:
+          $ref: '#/components/schemas/CheckoutTotals'
+        giftCardProducts:
+          type: array
+          description: Gift card products to be purchased
+          items:
+            $ref: '#/components/schemas/CheckoutGiftCardProduct'
+        vouchers:
+          type: array
+          items:
+            $ref: '#/components/schemas/CheckoutVoucher'
+        discountExternals:
+          $ref: '#/components/schemas/DiscountExternals'
+        storeGroupId:
+          $ref: '#/components/schemas/StoreGroupId'
+        countryCode:
+          $ref: '#/components/schemas/CountryCode'
+        attributes:
+          $ref: '#/components/schemas/CheckoutAttributes'
+        id:
+          type: string
+          description: The unique id of the checkout
+        cartRevision:
+          type: integer
+        giftCards:
+          type: array
+          description: Gift cards added as payment
+          items:
+            $ref: '#/components/schemas/CheckoutGiftCard'
+        currencyCode:
+          $ref: '#/components/schemas/CurrencyCode'
+        updated:
+          type: string
+          description: When this checkout was updated
+          format: date-time
+        items:
+          maxItems: 100
+          minItems: 1
+          type: array
+          items:
+            $ref: '#/components/schemas/CheckoutItem'
+        shippingOptions:
+          type: array
+          items:
+            $ref: '#/components/schemas/CheckoutShippingOption'
+        gifts:
+          type: array
+          items:
+            $ref: '#/components/schemas/CheckoutGift'
+    CheckoutTotals:
+      type: object
+      properties:
+        shippingTotal:
+          type: integer
+          description: Total shipping amount for the checkout
+        bonusTotal:
+          type: integer
+          description: Total bonus amount for the checkout
+        giftCardTotal:
+          type: integer
+          description: Total gift card amount for the checkout
+        discountTotal:
+          type: integer
+          description: Total discount amount for the checkout
+        grandTotal:
+          type: integer
+          description: Total amount for the checkout, including taxes
+        taxTotal:
+          type: integer
+          description: Total tax for the checkout
+        voucherTotal:
+          type: integer
+          description: 'Deprecated: it''s now part of discountTotal'
+        subTotal:
+          type: integer
+          description: Total amount for the checkout, excluding taxes
+    ProductParentStockResponse:
+      type: object
+      properties:
+        productParent:
+          $ref: '#/components/schemas/ProductParentStock'
+    ProductParentStock:
+      type: object
+      required:
+        - id
+        - productVariants
+      properties:
+        id:
+          type: string
+          description: The ID of the product parent
+        productVariants:
+          type: array
+          description: Stock information for all available product variants
+          items:
+            $ref: '#/components/schemas/ProductVariantStock'
+    CartItem:
+      title: CartItem
+      type: object
+      properties:
+        productVariantId:
+          type: string
+          description: ID of the product variant
+        totalPriceAmount:
+          type: integer
+          description: Total amount of the cart item
+        displayName:
+          type: string
+          description: Display name of the product variant
+        salePriceAmount:
+          type: integer
+          description: Per unit sale price of the product variant
+        description:
+          type: string
+          description: Description of the product variant
+        discountAmount:
+          type: integer
+          description: Per unit discount of the product variant
+        imageUrl:
+          type: string
+          description: URL to an image of the product variant
+        options:
+          $ref: '#/components/schemas/Options'
+        id:
+          type: string
+          description: Unique ID for the cart item
+        shippingAttributes:
+          $ref: '#/components/schemas/ShippingAttributes'
+        displayDescription:
+          type: string
+          description: Display description of the product variant
+        quantity:
+          type: integer
+          description: Quantity of the cart item
+        totalDiscountAmount:
+          type: integer
+          description: Total discount amount of the cart item
+        created:
+          type: string
+          description: When this cart item was first created
+          format: date-time
+        taxPercentage:
+          type: integer
+          description: Tax percentage for the cart item
+        tags:
+          $ref: '#/components/schemas/Tags'
+        basePriceAmount:
+          type: integer
+          description: Per unit base unit price of the product variant
+        taxGroupId:
+          type: string
+          description: Tax group ID of the cart item
+        name:
+          type: string
+          description: Name of the product variant
+        campaign:
+          $ref: '#/components/schemas/Campaign'
+        discountOutcome:
+          $ref: '#/components/schemas/ItemDiscountOutcome'
+        totalTaxAmount:
+          type: integer
+          description: Total tax amount for the cart item
+        updated:
+          type: string
+          description: When this cart item was updated
+          format: date-time
+        taxPercentageDecimals:
+          type: integer
+          description: Number of decimals in tax percentage, eg. taxPercentage=2500 and taxPercentageDecimals=2 -> 25 % tax
+        productParentId:
+          $ref: '#/components/schemas/ProductParentId'
+        customAttributes:
+          $ref: '#/components/schemas/CustomAttributes'
+    CartProviders:
+      type: object
+      description: Initiated cart capabilities for the current shopper session
+      properties:
+        retain24:
+          $ref: '#/components/schemas/CartProviderRetain24'
+        bonus:
+          $ref: '#/components/schemas/CartProviderBonus'
+        voyado:
+          $ref: '#/components/schemas/CartProviderVoyado'
+    CartProvider:
+      required:
+        - id
+        - name
+      type: object
+      properties:
+        name:
+          type: string
+          description: The provider name
+        id:
+          type: string
+          description: The provider id
+    CartProviderRetain24:
+      type: object
+      description: Retain24 provider
+      required:
+        - provider
+      properties:
+        provider:
+          $ref: '#/components/schemas/CartProvider'
+    CartProviderBonus:
+      type: object
+      description: Bonus provider
+      required:
+        - additional
+        - provider
+      properties:
+        provider:
+          $ref: '#/components/schemas/CartProvider'
+        additional:
+          $ref: '#/components/schemas/CartProviderBonusAdditional'
+    CartProviderBonusAdditional:
+      type: object
+      required:
+        - customerId
+      properties:
+        customerId:
+          type: string
+          description: Bonus customer id used in session
+    CartProviderVoyado:
+      description: Voyado provider
+      type: object
+      required:
+        - additional
+        - provider
+      properties:
+        provider:
+          $ref: '#/components/schemas/CartProvider'
+        additional:
+          $ref: '#/components/schemas/CartProviderVoyadoAdditional'
+    CartProviderVoyadoAdditional:
+      type: object
+      required:
+        - contactId
+      properties:
+        contactId:
+          type: string
+          description: Voyado contact id used in session
+    PutShopperSessionItemQuantityRequest:
+      title: PutShopperSessionItemQuantityRequest
+      required:
+        - quantity
+      type: object
+      properties:
+        quantity:
+          minimum: 1
+          maximum: 9999
+          type: integer
+    ProductVariantStock:
+      type: object
+      properties:
+        validateStock:
+          type: boolean
+          description: '`true` if the stock for this variant is validated and a reservation is created'
+        availableQuantity:
+          type: integer
+          description: The total available quantity for the variant across all available inventories
+        isAvailable:
+          type: boolean
+          description: Is the variant available in any of the available inventories
+        reservedQuantity:
+          type: integer
+          description: The total reserved quantity across all available inventories
+        inventories:
+          type: array
+          items:
+            $ref: '#/components/schemas/ProductVariantInventoryStock'
+        stockQuantity:
+          type: integer
+          description: The total quantity for the variant across all available inventories (excluding reservations)
+        id:
+          type: string
+          description: The id of the product variant
+      description: Stock information totals for a product variant including a breakdown on inventory level
+    StoreGroupId:
+      type: string
+      maxLength: 100
+      description: A store group id from store-management
+    ProductParentId:
+      type: string
+      maxLength: 100
+      description: A product parent id from product-management
+    CountryCode:
+      title: CountryCode
+      maxLength: 2
+      minLength: 2
+      pattern: ^[A-Z]{2}$
+      type: string
+      description: ISO 3166-1 alpha-2 country code
+    DiscountExternals:
+      title: DiscountExternals
+      type: array
+      items:
+        type: object
+        properties:
+          reference:
+            type: string
+            description: The reference
+          applyLast:
+            type: boolean
+            description: Whether this external rule applies after other external rules
+          isExclusive:
+            type: boolean
+            description: If this rule can not stack with other discounts of same applyLast
+          freeShipping:
+            type: boolean
+            description: Whether this external rule applies free shipping or not
+          provider:
+            type: string
+            description: Provider used for discount external rule
+          outcomes:
+            $ref: '#/components/schemas/Outcome'
+          name:
+            type: string
+            description: The name of the discount external rule
+          displayName:
+            type: string
+            description: The translated name of the discount external rule based on language code
+          discountAmount:
+            type: integer
+            description: Total discount given by the external rule
+          discountExternalRuleId:
+            type: string
+            description: The id of the discount external rule
+          currencyCode:
+            type: string
+            description: The currency code for the discount amount
+    Cart:
+      title: Cart
+      type: object
+      properties:
+        isTaxIncludedInPrice:
+          type: boolean
+          description: Whether prices include tax or not
+        discountCodes:
+          $ref: '#/components/schemas/DiscountCodes'
+        created:
+          type: string
+          description: When the session was created
+          format: date-time
+        discountRules:
+          $ref: '#/components/schemas/DiscountRules'
+        discountAmount:
+          type: integer
+          description: Discount amount directly on the cart, this discount is not related to one item
+        sessionId:
+          type: string
+          description: The session that this cart is associated with
+        totals:
+          $ref: '#/components/schemas/CartTotals'
+        discountExternals:
+          $ref: '#/components/schemas/DiscountExternals'
+        storeGroupId:
+          $ref: '#/components/schemas/StoreGroupId'
+        countryCode:
+          $ref: '#/components/schemas/CountryCode'
+        id:
+          type: string
+          description: The unique id of the cart
+        currencyCode:
+          $ref: '#/components/schemas/CurrencyCode'
+        updated:
+          type: string
+          description: When the session  was last updated
+          format: date-time
+        items:
+          maxItems: 100
+          minItems: 0
+          type: array
+          description: Shopper session items
+          items:
+            $ref: '#/components/schemas/CartItem'
+        gifts:
+          type: array
+          description: Shopper session gifts
+          items:
+            $ref: '#/components/schemas/CartGift'
+    CartTotals:
+      type: object
+      properties:
+        bonusTotal:
+          type: integer
+          description: Total bonus amount for the cart
+        discountTotal:
+          type: integer
+          description: Total discount amount for the cart
+        grandTotal:
+          type: integer
+          description: Total amount for the cart, including taxes
+        taxTotal:
+          type: integer
+          description: Total tax for the cart
+        voucherTotal:
+          type: integer
+          description: 'Deprecated: it''s now part of discountTotal'
+        subTotal:
+          type: integer
+          description: Total amount for the cart, excluding taxes
+    CartVoucher:
+      type: object
+      properties:
+        amount:
+          type: integer
+          description: Monetary value for the voucher
+        provider:
+          type: string
+          description: Provider used for voucher
+        description:
+          type: string
+          description: Voucher description
+        id:
+          type: string
+          description: ID for the voucher
+    CheckoutVoucher:
+      type: object
+      required:
+        - amount
+        - description
+        - id
+      properties:
+        amount:
+          type: integer
+          format: int64
+          description: Monetary value for the voucher
+        description:
+          type: string
+          description: Description for the checkout voucher
+        id:
+          type: string
+          description: ID for the checkout voucher
+    DiscountCodes:
+      title: DiscountCodes
+      type: array
+      items:
+        type: object
+        properties:
+          applyLast:
+            type: boolean
+            description: Whether this code applies after other codes
+          isExclusive:
+            type: boolean
+            description: If this code can not stack with other codes of same applyLast
+          code:
+            type: string
+            description: The code
+          freeShipping:
+            type: boolean
+            description: Whether this code applies free shipping or not
+          outcomes:
+            $ref: '#/components/schemas/Outcome'
+          name:
+            type: string
+            description: The name of the discount code rule
+          displayName:
+            type: string
+            description: The translated name of the discount code rule based on language code
+          discountAmount:
+            type: integer
+            description: Total discount given by the code
+          currencyCode:
+            type: string
+            description: The currency code for the discount amount
+          discountCodeRuleId:
+            type: string
+            description: The id of the discount code rule
+    PostShopperCheckoutStartRequest:
+      title: PostShopperCheckoutStartRequest
+      required:
+        - paymentProvider
+      type: object
+      properties:
+        shippingProvider:
+          $ref: '#/components/schemas/CheckoutCapability'
+        giftCardProvider:
+          $ref: '#/components/schemas/CheckoutCapability'
+        paymentProvider:
+          $ref: '#/components/schemas/CheckoutCapability'
+        taxProvider:
+          $ref: '#/components/schemas/CheckoutCapability'
+    StartCheckoutResponse:
+      type: object
+      properties:
+        checkout:
+          $ref: '#/components/schemas/Checkout'
+        token:
+          type: string
+          description: The JWT needed to perform updates to the shopper session
+    ShopperSession:
+      title: ShopperSession
+      required:
+        - cart
+        - locked
+        - token
+      type: object
+      properties:
+        capabilities:
+          $ref: '#/components/schemas/Capabilities'
+        bonus:
+          $ref: '#/components/schemas/CartBonus'
+        cartCapabilities:
+          $ref: '#/components/schemas/CartCapabilities'
+        cartProviders:
+          $ref: '#/components/schemas/CartProviders'
+        attributes:
+          $ref: '#/components/schemas/SessionAttributes'
+        vouchers:
+          type: array
+          items:
+            $ref: '#/components/schemas/CartVoucher'
+        giftCardProducts:
+          type: array
+          items:
+            $ref: '#/components/schemas/CartGiftCardProduct'
+        locked:
+          type: boolean
+          description: If the session can be modified or not
+        checkout:
+          $ref: '#/components/schemas/CheckoutRevision'
+        cart:
+          $ref: '#/components/schemas/Cart'
+        token:
+          type: string
+          description: The JWT needed to perform updates to the shopper session
+    DiscountRules:
+      title: DiscountRules
+      type: array
+      items:
+        type: object
+        properties:
+          freeShipping:
+            type: boolean
+            description: Whether this discount rule applies free shipping or not
+          outcomes:
+            $ref: '#/components/schemas/Outcome'
+          name:
+            type: string
+            description: The name of the discount rule
+          displayName:
+            type: string
+            description: The translated name of the discount rule based on language code
+          discountAmount:
+            type: integer
+            description: Total discount given by the discount rule
+          discountRuleId:
+            type: string
+            description: The id of the discount rule
+          currencyCode:
+            type: string
+            description: The currency code for the discount amount
+    CheckoutItem:
+      type: object
+      properties:
+        displayDescription:
+          type: string
+          description: Display description of the product variant
+        quantity:
+          type: integer
+          description: Quantity of the checkout item
+        productVariantId:
+          type: string
+          description: ID of the product variant
+        totalPriceAmount:
+          type: integer
+          description: Total amount of the checkout item
+        displayName:
+          type: string
+          description: Display name of the product variant
+        totalDiscountAmount:
+          type: integer
+          description: Total discount amount of the checkout item
+        salePriceAmount:
+          type: integer
+          description: Per unit sale price of the product variant
+        taxPercentage:
+          type: integer
+          description: Tax percentage for the checkout item
+        description:
+          type: string
+          description: Description of the product variant
+        discountAmount:
+          type: integer
+          description: Per unit discount of the product variant
+        tags:
+          $ref: '#/components/schemas/Tags'
+        basePriceAmount:
+          type: integer
+          description: Per unit base unit price of the product variant
+        taxGroupId:
+          type: string
+          description: Tax group ID of the product variant
+        imageUrl:
+          type: string
+          description: URL to an image of the product variant
+        name:
+          type: string
+          description: Name of the product variant
+        options:
+          $ref: '#/components/schemas/Options'
+        campaign:
+          $ref: '#/components/schemas/Campaign'
+        id:
+          type: string
+          description: Unique ID for the checkout item
+        discountOutcome:
+          $ref: '#/components/schemas/ItemDiscountOutcome'
+        totalTaxAmount:
+          type: integer
+          description: Per unit tax amount for the product variant
+        taxPercentageDecimals:
+          type: integer
+          description: Number of decimals in tax percentage, eg. taxPercentage=2500 and taxPercentageDecimals=2 -> 25 % tax
+        shippingAttributes:
+          $ref: '#/components/schemas/ShippingAttributes'
+        productParentId:
+          $ref: '#/components/schemas/ProductParentId'
+        customAttributes:
+          $ref: '#/components/schemas/CustomAttributes'
+    PostDiscountCodeRequest:
+      title: PostDiscountCodeRequest
+      required:
+        - discountCode
+      type: object
+      properties:
+        discountCode:
+          $ref: '#/components/schemas/DiscountCode'
+    DiscountCode:
+      maxLength: 1000
+      pattern: ^[A-Za-z0-9_-]+$
+      type: string
+      description: Discount code
+    InactiveDiscountCode:
+      type: object
+      properties:
+        requestId:
+          type: string
+          description: The request id
+        error:
+          type: string
+          description: The error type
+          enum:
+            - INACTIVE_DISCOUNT_CODE
+            - CONSUMED_DISCOUNT_CODE
+            - EXPIRED_DISCOUNT_CODE
+            - UPCOMING_DISCOUNT_CODE
+        message:
+          type: string
+          description: The error message
+    CheckoutGiftCardProduct:
+      required:
+        - amount
+        - distribution
+        - id
+        - name
+        - provider
+      type: object
+      properties:
+        amount:
+          type: integer
+          format: int64
+          description: Monetary amount in minor units
+        provider:
+          type: string
+          description: Provider used for gift card product
+        name:
+          type: string
+          description: Gift card product name
+        recipient:
+          type: string
+          description: Recipient information used for gift card product distribution
+        id:
+          type: string
+          description: ID for the gift card product
+        distribution:
+          type: string
+          description: Distribution of the gift card product
+        merchantReference:
+          type: string
+          description: Merchant reference
+    CheckoutCapabilities:
+      title: CheckoutCapabilities
+      description: Capabilities for checkout
+      required:
+        - paymentProvider
+      type: object
+      properties:
+        shippingProvider:
+          $ref: '#/components/schemas/CheckoutCapability'
+        giftCardProvider:
+          $ref: '#/components/schemas/CheckoutCapability'
+        paymentProvider:
+          $ref: '#/components/schemas/CheckoutCapabilityPayment'
+        taxProvider:
+          $ref: '#/components/schemas/CheckoutCapability'
+    CheckoutCapability:
+      type: object
+      required:
+        - id
+        - name
+      properties:
+        id:
+          type: string
+          description: Checkout capability id
+        name:
+          type: string
+          description: Checkout capability name
+    CheckoutCapabilityPayment:
+      allOf:
+        - $ref: '#/components/schemas/CheckoutCapability'
+        - type: object
+          properties:
+            config:
+              type: object
+              additionalProperties:
+                type: string
+    ProductVariantInventoryStock:
+      type: object
+      properties:
+        availableQuantity:
+          type: integer
+          description: The available quantity in the inventory, i.e. `stockQuantity - reservedQuantity`
+        isAvailable:
+          type: boolean
+          description: Is the variant available in this inventory, i.e. `availableQuantity > 0`
+        reservedQuantity:
+          type: integer
+          description: The number of reservations for the variant in the inventory
+        stockQuantity:
+          type: integer
+          description: The total quantity in the inventory (excluding reservations)
+        id:
+          type: string
+          description: The id of the inventory
+      description: Stock information for a product variant in a specific inventory
+    Capabilities:
+      title: Capabilities
+      type: object
+      properties:
+        shippingProviders:
+          type: array
+          description: The shipping providers
+          items:
+            type: object
+            properties:
+              name:
+                type: string
+                description: The shipping provider name
+              id:
+                type: string
+                description: The shipping provider id
+        taxProviders:
+          type: array
+          description: The available tax providers
+          items:
+            type: object
+            properties:
+              name:
+                type: string
+                description: The tax provider name
+              id:
+                type: string
+                description: The tax provider id
+        giftCardProviders:
+          type: array
+          description: The gift card providers
+          items:
+            type: object
+            properties:
+              name:
+                type: string
+                description: The gift card provider name
+              id:
+                type: string
+                description: The gift card provider id
+        paymentProviders:
+          type: array
+          description: Available payment provider
+          items:
+            type: object
+            properties:
+              name:
+                type: string
+                description: The payment provider name
+              id:
+                type: string
+                description: The payment provider id
+              config:
+                type: object
+                additionalProperties:
+                  type: string
+      description: Available checkout capabilities for the current shopper session
+    ProductVariantPrices:
+      required:
+        - basePriceAmount
+        - discountAmount
+        - id
+        - salePriceAmount
+        - taxAmount
+        - taxPercentage
+        - taxPercentageDecimals
+      type: object
+      properties:
+        basePriceAmount:
+          type: integer
+          description: The regular price for the product variant, in minor units
+        salePriceAmount:
+          type: integer
+          description: The sale price for the product variant, in minor units
+        taxPercentage:
+          type: integer
+          description: Tax percentage for the product variant, in minor units
+        discountAmount:
+          type: integer
+          description: The discount for the product variant, in minor units (i.e. basePrice - salePrice)
+        campaign:
+          $ref: '#/components/schemas/Campaign'
+        id:
+          type: string
+          description: The id of the product variant
+        taxAmount:
+          type: integer
+          description: Tax amount for the product variant
+        lowestPriceRecord:
+          $ref: '#/components/schemas/LowestPriceRecord'
+        taxPercentageDecimals:
+          type: integer
+          description: Number of decimals in tax percentage, eg. if taxPercentage is 2500 and taxDecimals is 2 - the tax rate is 25 %
+        referencePriceAmount:
+          type: integer
+          description: The reference/historic price for the product variant, in minor units
+      description: Price information totals for a product variant
+    LowestPriceRecord:
+      type: object
+      description: The lowest recorded price the last 30 days
+      required:
+        - endDate
+        - salePriceAmount
+      properties:
+        endDate:
+          type: string
+          description: The date the product variant stopped to be sold for this price
+          format: date-time
+        salePriceAmount:
+          type: integer
+          description: The sale price for the product variant price record, in minor units
+    ShippingAttributes:
+      title: ShippingAttributes
+      type: array
+      description: Attributes that could be used to adjust delivery and shipping options
+      nullable: true
+      maxItems: 10
+      uniqueItems: true
+      items:
+        type: string
+        pattern: ^[A-Za-z0-9_-]+$
+        maxLength: 40
+    ConflictDiscountCode:
+      title: ConflictDiscountCode
+      type: object
+      properties:
+        requestId:
+          type: string
+          description: The request id
+        error:
+          type: string
+          description: The error type
+          enum:
+            - ALREADY_ADDED_DISCOUNT_CODE
+            - MAX_DISCOUNT_CODES
+            - EXCLUSIVE_DISCOUNT_CODE
+            - CONDITION_DISCOUNT_CODE
+        message:
+          type: string
+          description: The error message
+  securitySchemes:
+    ApiKey:
+      type: apiKey
+      name: x-shopper-api-key
+      in: header
+    JWT:
+      type: http
+      scheme: bearer