@shopware-ag/acceptance-test-suite 12.20.1 → 12.21.0

package/dist/index.d.mts

@@ -138,6 +138,13 @@ interface ApiContextTypes {
     MailpitApiContext: MailpitApiContext;
 }
 
+type NewsletterRecipient = components["schemas"]["NewsletterRecipient"] & {
+    id: string;
+    email: string;
+    salesChannelId: string;
+    firstName: string;
+    lastName: string;
+};
 type SalesChannel = components["schemas"]["SalesChannel"] & {
     id: string;
 };
@@ -259,6 +266,11 @@ type Tag = components["schemas"]["Tag"] & {
 type Rule = components["schemas"]["Rule"] & {
     id: string;
 };
+interface BasicRuleCondition {
+    type: string;
+    value: Record<string, unknown>;
+    children?: BasicRuleCondition[];
+}
 type Currency$2 = components["schemas"]["Currency"] & {
     id: string;
 };
@@ -334,6 +346,16 @@ type Promotion = Omit<components["schemas"]["Promotion"], "discounts"> & {
 type PromotionDiscount = components["schemas"]["PromotionDiscount"] & {
     id: string;
 };
+interface PromotionWithConditionRuleOptions {
+    id: string;
+    name: string;
+    ruleId: string;
+    useCode?: boolean;
+    discountValue?: number;
+    discountScope?: string;
+    discountType?: string;
+    salesChannelId?: string;
+}
 type OrderLineItem = components["schemas"]["OrderLineItem"] & {
     id: string;
 };
@@ -583,6 +605,14 @@ declare class TestDataService {
      */
     private createdSalesChannelRecords;
     constructor(AdminApiClient: AdminApiContext, IdProvider: IdProvider, options: DataServiceOptions);
+    /**
+     * Creates a newsletter recipient for a customer in the default sales channel.
+     * If a matching recipient already exists, it will be reused and registered for cleanup.
+     *
+     * @param customer - The customer whose email and profile data will be used for the newsletter recipient.
+     * @param overrides - Specific data overrides that will be applied to the newsletter recipient payload.
+     */
+    createNewsletterRecipient(customer: Customer, overrides?: Partial<NewsletterRecipient>): Promise<NewsletterRecipient>;
     /**
      * Creates a basic product without images or other special configuration.
      * The product will be added to the default sales channel category if configured.
@@ -755,6 +785,13 @@ declare class TestDataService {
      * @param salesChannelId - The uuid of the sales channel in which the promotion should be active.
      */
     createPromotionWithCode(overrides?: Partial<Promotion>, salesChannelId?: string): Promise<Promotion>;
+    /**
+     * Creates a promotion with one discount and assigns a condition rule as a persona rule.
+     * The created promotion and assigned rule are both registered for cleanup.
+     *
+     * @param promotionConfig - Promotion configuration, including the promotion id, name, and assigned rule id.
+     */
+    createPromotionWithConditionRule(promotionConfig: PromotionWithConditionRuleOptions): Promise<Promotion>;
     /**
      * Creates a new basic payment method.
      *
@@ -780,11 +817,13 @@ declare class TestDataService {
      */
     createShippingMethodWithImage(overrides?: Partial<ShippingMethod$1>): Promise<ShippingMethod$1>;
     /**
-     * Creates a new basic rule with the condition cart amount >= 1.
+     * Creates a new basic rule with the condition cart amount >= 1 by default.
+     * Pass a condition object to create the same basic rule structure with another condition.
      *
      * @param overrides - Specific data overrides that will be applied to the basic rule data struct.
+     * @param condition - The condition object or condition type used in the generated rule.
      */
-    createBasicRule(overrides?: Partial<Rule>, conditionType?: string, operator?: string, amount?: number): Promise<Rule>;
+    createBasicRule(overrides?: Partial<Rule>, condition?: BasicRuleCondition | string, operator?: string, amount?: number): Promise<Rule>;
     /**
      * Creates a new basic page layout.
      *
@@ -970,6 +1009,11 @@ declare class TestDataService {
 
      */
     assignAclRoleUser(aclRoleId: string, adminUserId: string): Promise<any>;
+    /**
+     * Retrieves a newsletter recipient by customer email and the default sales channel.
+     * @param customer - The customer whose email will be used to search for a newsletter recipient.
+     */
+    getNewsletterRecipient(customer: Customer): Promise<NewsletterRecipient | undefined>;
     /**
      * Retrieves a language based on its code.
      * @param languageCode
@@ -1153,7 +1197,7 @@ declare class TestDataService {
     getCountryStruct(overrides?: Partial<Country$1>): Partial<Country$1>;
     getCurrencyStruct(overrides: Partial<Currency$2> | undefined, roundingDecimals: number): Partial<Currency$2>;
     getBasicProductStruct(taxId?: string, currencyId?: string, overrides?: Partial<Product>): Partial<Product>;
-    getBasicRuleStruct(overrides: Partial<Rule> | undefined, conditionType: string, operator: string, amount: number): Partial<Rule>;
+    getBasicRuleStruct(overrides?: Partial<Rule>, condition?: BasicRuleCondition | string, operator?: string, amount?: number): Partial<Rule>;
     getProductPriceRangeStruct(currencyId: string, ruleId: string): Partial<Product>;
     getBasicManufacturerStruct(overrides?: Partial<Manufacturer>): Partial<Manufacturer>;
     getBasicPaymentMethodStruct(overrides?: Partial<PaymentMethod$1>): {
@@ -1530,6 +1574,7 @@ declare const BUNDLED_RESOURCES: {
             };
             userMenu: {
                 logout: string;
+                offCanvasToggle: string;
             };
             order: {
                 orderTitle: string;
@@ -2432,6 +2477,7 @@ declare const BUNDLED_RESOURCES: {
             };
             userMenu: {
                 logout: string;
+                offCanvasToggle: string;
             };
             order: {
                 orderTitle: string;
@@ -3662,6 +3708,7 @@ declare const baseNamespaces: {
             };
             userMenu: {
                 logout: string;
+                offCanvasToggle: string;
             };
             order: {
                 orderTitle: string;
@@ -4662,6 +4709,7 @@ declare class OffCanvasCart implements PageObject {
     constructor(page: Page);
     url(): string;
     getLineItemByProductNumber(productNumber: string): Promise<Record<string, Locator>>;
+    getLineItemByPromotionName(name: string): Promise<Record<string, Locator>>;
 }
 
 declare class CheckoutConfirm implements PageObject {
@@ -4696,7 +4744,10 @@ declare class CheckoutConfirm implements PageObject {
      */
     readonly cartLineItemImages: Locator;
     readonly page: Page;
+    readonly confirmProductTable: Locator;
     constructor(page: Page);
+    getLineItemByProductName(productName: string): Record<string, Locator>;
+    getLineItemByPromotionName(promotionName: string): Record<string, Locator>;
     url(): string;
 }
 
@@ -5554,6 +5605,7 @@ declare class DataSharing implements PageObject {
 declare class Dashboard implements PageObject {
     readonly contentView: Locator;
     readonly adminMenuView: Locator;
+    readonly adminMenuOffCanvasToggle: Locator;
     readonly adminMenuCatalog: Locator;
     readonly adminMenuOrder: Locator;
     readonly adminMenuOrderOverview: Locator;
@@ -6891,4 +6943,4 @@ declare const test: playwright_test.TestType<playwright_test.PlaywrightTestArgs
 }>;
 
 export { Actor, AdminPageObjects, BUNDLED_RESOURCES, COUNTRY_ADDRESS_DATA, FeatureService, IdProvider, LanguageHelper, RuleType, StorefrontPageObjects, TestDataService, assertScreenshot, baseNamespaces, clearDelayedCache, compareFlowTemplateWithFlow, createNewAdminPageContext, createRandomImage, createSolidColorImage, encodeImage, expandAdminMenu, extractIdFromUrl, formatPrice, getCountryAddressData, getCountryCodeFromLocale, getCountryId, getCurrency, getCurrencyCodeFromLocale, getCurrencySymbolFromLocale, getCurrentContext, getDefaultShippingMethodId, getFlow, getFlowId, getFlowTemplate, getLanguageCode, getLanguageData, getLocale, getMediaId, getOrderTransactionId, getPaymentMethodId, getPromotionWithDiscount, getSalutationId, getShippingMethodId, getSnippetSetId, getStateMachineId, getStateMachineStateId, getTaxId, getThemeId, hideElements, hideSymfonyToolbarOnReload, isPaaSInstance, isSaaSInstance, isThemeCompiled, loginToAdministration, mockApiCalls, replaceElements, replaceElementsIndividually, setCurrentContext, setOrderStatus, setViewport, test, translate, updateAdminUser, uploadRandomPngMedia };
-export type { AccountData, AclRole, Address, CalculatedTaxes, Category$1 as Category, CategoryCustomizableLinkData, CategoryData, CmsPage, Country$1 as Country, CreatedRecord, Currency$2 as Currency, CustomField, CustomFieldData, CustomFieldSet, Customer, CustomerAddress, CustomerGroup, DataServiceOptions, DeliveryTime, FixtureTypes, Flow, FlowConfig, FlowTemplate, Image, Language$2 as Language, Manufacturer, Media$1 as Media, Options, Order, OrderDelivery, OrderLineItem, OrderStatus, PageObject, PaymentMethod$1 as PaymentMethod, Price, Product, ProductCrossSelling, ProductPrice, ProductReview, Promotion, PromotionDiscount, PropertyGroup, PropertyGroupOption, RegistrationData, ReplaceTarget, Rule, RuleAssignmentEntity, SalesChannel, SalesChannelAnalytics, SalesChannelDomain, SalesChannelRecord, Salutation, ShippingMethod$1 as ShippingMethod, SimpleLineItem, StateMachine, StateMachineState, SyncApiOperation, SystemConfig, Tag, TagData, Task, Tax$1 as Tax, TaxRules, TranslateFn, TranslationKey, UploadMediaTarget, User, VariantListingConfig };
+export type { AccountData, AclRole, Address, BasicRuleCondition, CalculatedTaxes, Category$1 as Category, CategoryCustomizableLinkData, CategoryData, CmsPage, Country$1 as Country, CreatedRecord, Currency$2 as Currency, CustomField, CustomFieldData, CustomFieldSet, Customer, CustomerAddress, CustomerGroup, DataServiceOptions, DeliveryTime, FixtureTypes, Flow, FlowConfig, FlowTemplate, Image, Language$2 as Language, Manufacturer, Media$1 as Media, NewsletterRecipient, Options, Order, OrderDelivery, OrderLineItem, OrderStatus, PageObject, PaymentMethod$1 as PaymentMethod, Price, Product, ProductCrossSelling, ProductPrice, ProductReview, Promotion, PromotionDiscount, PromotionWithConditionRuleOptions, PropertyGroup, PropertyGroupOption, RegistrationData, ReplaceTarget, Rule, RuleAssignmentEntity, SalesChannel, SalesChannelAnalytics, SalesChannelDomain, SalesChannelRecord, Salutation, ShippingMethod$1 as ShippingMethod, SimpleLineItem, StateMachine, StateMachineState, SyncApiOperation, SystemConfig, Tag, TagData, Task, Tax$1 as Tax, TaxRules, TranslateFn, TranslationKey, UploadMediaTarget, User, VariantListingConfig };

package/dist/index.d.ts

@@ -138,6 +138,13 @@ interface ApiContextTypes {
     MailpitApiContext: MailpitApiContext;
 }
 
+type NewsletterRecipient = components["schemas"]["NewsletterRecipient"] & {
+    id: string;
+    email: string;
+    salesChannelId: string;
+    firstName: string;
+    lastName: string;
+};
 type SalesChannel = components["schemas"]["SalesChannel"] & {
     id: string;
 };
@@ -259,6 +266,11 @@ type Tag = components["schemas"]["Tag"] & {
 type Rule = components["schemas"]["Rule"] & {
     id: string;
 };
+interface BasicRuleCondition {
+    type: string;
+    value: Record<string, unknown>;
+    children?: BasicRuleCondition[];
+}
 type Currency$2 = components["schemas"]["Currency"] & {
     id: string;
 };
@@ -334,6 +346,16 @@ type Promotion = Omit<components["schemas"]["Promotion"], "discounts"> & {
 type PromotionDiscount = components["schemas"]["PromotionDiscount"] & {
     id: string;
 };
+interface PromotionWithConditionRuleOptions {
+    id: string;
+    name: string;
+    ruleId: string;
+    useCode?: boolean;
+    discountValue?: number;
+    discountScope?: string;
+    discountType?: string;
+    salesChannelId?: string;
+}
 type OrderLineItem = components["schemas"]["OrderLineItem"] & {
     id: string;
 };
@@ -583,6 +605,14 @@ declare class TestDataService {
      */
     private createdSalesChannelRecords;
     constructor(AdminApiClient: AdminApiContext, IdProvider: IdProvider, options: DataServiceOptions);
+    /**
+     * Creates a newsletter recipient for a customer in the default sales channel.
+     * If a matching recipient already exists, it will be reused and registered for cleanup.
+     *
+     * @param customer - The customer whose email and profile data will be used for the newsletter recipient.
+     * @param overrides - Specific data overrides that will be applied to the newsletter recipient payload.
+     */
+    createNewsletterRecipient(customer: Customer, overrides?: Partial<NewsletterRecipient>): Promise<NewsletterRecipient>;
     /**
      * Creates a basic product without images or other special configuration.
      * The product will be added to the default sales channel category if configured.
@@ -755,6 +785,13 @@ declare class TestDataService {
      * @param salesChannelId - The uuid of the sales channel in which the promotion should be active.
      */
     createPromotionWithCode(overrides?: Partial<Promotion>, salesChannelId?: string): Promise<Promotion>;
+    /**
+     * Creates a promotion with one discount and assigns a condition rule as a persona rule.
+     * The created promotion and assigned rule are both registered for cleanup.
+     *
+     * @param promotionConfig - Promotion configuration, including the promotion id, name, and assigned rule id.
+     */
+    createPromotionWithConditionRule(promotionConfig: PromotionWithConditionRuleOptions): Promise<Promotion>;
     /**
      * Creates a new basic payment method.
      *
@@ -780,11 +817,13 @@ declare class TestDataService {
      */
     createShippingMethodWithImage(overrides?: Partial<ShippingMethod$1>): Promise<ShippingMethod$1>;
     /**
-     * Creates a new basic rule with the condition cart amount >= 1.
+     * Creates a new basic rule with the condition cart amount >= 1 by default.
+     * Pass a condition object to create the same basic rule structure with another condition.
      *
      * @param overrides - Specific data overrides that will be applied to the basic rule data struct.
+     * @param condition - The condition object or condition type used in the generated rule.
      */
-    createBasicRule(overrides?: Partial<Rule>, conditionType?: string, operator?: string, amount?: number): Promise<Rule>;
+    createBasicRule(overrides?: Partial<Rule>, condition?: BasicRuleCondition | string, operator?: string, amount?: number): Promise<Rule>;
     /**
      * Creates a new basic page layout.
      *
@@ -970,6 +1009,11 @@ declare class TestDataService {
 
      */
     assignAclRoleUser(aclRoleId: string, adminUserId: string): Promise<any>;
+    /**
+     * Retrieves a newsletter recipient by customer email and the default sales channel.
+     * @param customer - The customer whose email will be used to search for a newsletter recipient.
+     */
+    getNewsletterRecipient(customer: Customer): Promise<NewsletterRecipient | undefined>;
     /**
      * Retrieves a language based on its code.
      * @param languageCode
@@ -1153,7 +1197,7 @@ declare class TestDataService {
     getCountryStruct(overrides?: Partial<Country$1>): Partial<Country$1>;
     getCurrencyStruct(overrides: Partial<Currency$2> | undefined, roundingDecimals: number): Partial<Currency$2>;
     getBasicProductStruct(taxId?: string, currencyId?: string, overrides?: Partial<Product>): Partial<Product>;
-    getBasicRuleStruct(overrides: Partial<Rule> | undefined, conditionType: string, operator: string, amount: number): Partial<Rule>;
+    getBasicRuleStruct(overrides?: Partial<Rule>, condition?: BasicRuleCondition | string, operator?: string, amount?: number): Partial<Rule>;
     getProductPriceRangeStruct(currencyId: string, ruleId: string): Partial<Product>;
     getBasicManufacturerStruct(overrides?: Partial<Manufacturer>): Partial<Manufacturer>;
     getBasicPaymentMethodStruct(overrides?: Partial<PaymentMethod$1>): {
@@ -1530,6 +1574,7 @@ declare const BUNDLED_RESOURCES: {
             };
             userMenu: {
                 logout: string;
+                offCanvasToggle: string;
             };
             order: {
                 orderTitle: string;
@@ -2432,6 +2477,7 @@ declare const BUNDLED_RESOURCES: {
             };
             userMenu: {
                 logout: string;
+                offCanvasToggle: string;
             };
             order: {
                 orderTitle: string;
@@ -3662,6 +3708,7 @@ declare const baseNamespaces: {
             };
             userMenu: {
                 logout: string;
+                offCanvasToggle: string;
             };
             order: {
                 orderTitle: string;
@@ -4662,6 +4709,7 @@ declare class OffCanvasCart implements PageObject {
     constructor(page: Page);
     url(): string;
     getLineItemByProductNumber(productNumber: string): Promise<Record<string, Locator>>;
+    getLineItemByPromotionName(name: string): Promise<Record<string, Locator>>;
 }
 
 declare class CheckoutConfirm implements PageObject {
@@ -4696,7 +4744,10 @@ declare class CheckoutConfirm implements PageObject {
      */
     readonly cartLineItemImages: Locator;
     readonly page: Page;
+    readonly confirmProductTable: Locator;
     constructor(page: Page);
+    getLineItemByProductName(productName: string): Record<string, Locator>;
+    getLineItemByPromotionName(promotionName: string): Record<string, Locator>;
     url(): string;
 }
 
@@ -5554,6 +5605,7 @@ declare class DataSharing implements PageObject {
 declare class Dashboard implements PageObject {
     readonly contentView: Locator;
     readonly adminMenuView: Locator;
+    readonly adminMenuOffCanvasToggle: Locator;
     readonly adminMenuCatalog: Locator;
     readonly adminMenuOrder: Locator;
     readonly adminMenuOrderOverview: Locator;
@@ -6891,4 +6943,4 @@ declare const test: playwright_test.TestType<playwright_test.PlaywrightTestArgs
 }>;
 
 export { Actor, AdminPageObjects, BUNDLED_RESOURCES, COUNTRY_ADDRESS_DATA, FeatureService, IdProvider, LanguageHelper, RuleType, StorefrontPageObjects, TestDataService, assertScreenshot, baseNamespaces, clearDelayedCache, compareFlowTemplateWithFlow, createNewAdminPageContext, createRandomImage, createSolidColorImage, encodeImage, expandAdminMenu, extractIdFromUrl, formatPrice, getCountryAddressData, getCountryCodeFromLocale, getCountryId, getCurrency, getCurrencyCodeFromLocale, getCurrencySymbolFromLocale, getCurrentContext, getDefaultShippingMethodId, getFlow, getFlowId, getFlowTemplate, getLanguageCode, getLanguageData, getLocale, getMediaId, getOrderTransactionId, getPaymentMethodId, getPromotionWithDiscount, getSalutationId, getShippingMethodId, getSnippetSetId, getStateMachineId, getStateMachineStateId, getTaxId, getThemeId, hideElements, hideSymfonyToolbarOnReload, isPaaSInstance, isSaaSInstance, isThemeCompiled, loginToAdministration, mockApiCalls, replaceElements, replaceElementsIndividually, setCurrentContext, setOrderStatus, setViewport, test, translate, updateAdminUser, uploadRandomPngMedia };
-export type { AccountData, AclRole, Address, CalculatedTaxes, Category$1 as Category, CategoryCustomizableLinkData, CategoryData, CmsPage, Country$1 as Country, CreatedRecord, Currency$2 as Currency, CustomField, CustomFieldData, CustomFieldSet, Customer, CustomerAddress, CustomerGroup, DataServiceOptions, DeliveryTime, FixtureTypes, Flow, FlowConfig, FlowTemplate, Image, Language$2 as Language, Manufacturer, Media$1 as Media, Options, Order, OrderDelivery, OrderLineItem, OrderStatus, PageObject, PaymentMethod$1 as PaymentMethod, Price, Product, ProductCrossSelling, ProductPrice, ProductReview, Promotion, PromotionDiscount, PropertyGroup, PropertyGroupOption, RegistrationData, ReplaceTarget, Rule, RuleAssignmentEntity, SalesChannel, SalesChannelAnalytics, SalesChannelDomain, SalesChannelRecord, Salutation, ShippingMethod$1 as ShippingMethod, SimpleLineItem, StateMachine, StateMachineState, SyncApiOperation, SystemConfig, Tag, TagData, Task, Tax$1 as Tax, TaxRules, TranslateFn, TranslationKey, UploadMediaTarget, User, VariantListingConfig };
+export type { AccountData, AclRole, Address, BasicRuleCondition, CalculatedTaxes, Category$1 as Category, CategoryCustomizableLinkData, CategoryData, CmsPage, Country$1 as Country, CreatedRecord, Currency$2 as Currency, CustomField, CustomFieldData, CustomFieldSet, Customer, CustomerAddress, CustomerGroup, DataServiceOptions, DeliveryTime, FixtureTypes, Flow, FlowConfig, FlowTemplate, Image, Language$2 as Language, Manufacturer, Media$1 as Media, NewsletterRecipient, Options, Order, OrderDelivery, OrderLineItem, OrderStatus, PageObject, PaymentMethod$1 as PaymentMethod, Price, Product, ProductCrossSelling, ProductPrice, ProductReview, Promotion, PromotionDiscount, PromotionWithConditionRuleOptions, PropertyGroup, PropertyGroupOption, RegistrationData, ReplaceTarget, Rule, RuleAssignmentEntity, SalesChannel, SalesChannelAnalytics, SalesChannelDomain, SalesChannelRecord, Salutation, ShippingMethod$1 as ShippingMethod, SimpleLineItem, StateMachine, StateMachineState, SyncApiOperation, SystemConfig, Tag, TagData, Task, Tax$1 as Tax, TaxRules, TranslateFn, TranslationKey, UploadMediaTarget, User, VariantListingConfig };

package/dist/index.mjs

@@ -1317,7 +1317,8 @@ const shopwareServices$1 = {
 	exploreNow: "Explore now"
 };
 const userMenu$1 = {
-	logout: "Logout"
+	logout: "Logout",
+	offCanvasToggle: "Expand menu"
 };
 const order$1 = {
 	orderTitle: "Orders",
@@ -2423,7 +2424,8 @@ const shopwareServices = {
 	exploreNow: "Jetzt erkunden"
 };
 const userMenu = {
-	logout: "Abmelden"
+	logout: "Abmelden",
+	offCanvasToggle: "Menü ausklappen"
 };
 const order = {
 	orderTitle: "Bestellungen",
@@ -4276,6 +4278,35 @@ class TestDataService {
       this.nameSuffix = options.nameSuffix;
     }
   }
+  /**
+   * Creates a newsletter recipient for a customer in the default sales channel.
+   * If a matching recipient already exists, it will be reused and registered for cleanup.
+   *
+   * @param customer - The customer whose email and profile data will be used for the newsletter recipient.
+   * @param overrides - Specific data overrides that will be applied to the newsletter recipient payload.
+   */
+  async createNewsletterRecipient(customer, overrides = {}) {
+    const hash = this.IdProvider.getIdPair();
+    const recipientPayload = {
+      email: customer.email,
+      salesChannelId: this.defaultSalesChannel.id,
+      firstName: customer.firstName ?? `Test ${hash.id}`,
+      lastName: customer.lastName ?? `User ${hash.id}`,
+      hash: customer.id || hash.uuid,
+      status: "direct",
+      languageId: customer.languageId ?? this.defaultLanguageId,
+      salutationId: customer.salutationId,
+      confirmedAt: this.convertDateTime(/* @__PURE__ */ new Date()),
+      ...overrides
+    };
+    const resp = await this.AdminApiClient.post("newsletter-recipient?_response=detail", {
+      data: recipientPayload
+    });
+    expect(resp.ok()).toBeTruthy();
+    const { data: recipient } = await resp.json();
+    this.addCreatedRecord("newsletter_recipient", recipient.id);
+    return recipient;
+  }
   /**
    * Creates a basic product without images or other special configuration.
    * The product will be added to the default sales channel category if configured.
@@ -4805,6 +4836,48 @@ class TestDataService {
     this.addCreatedRecord("promotion", promotion.id);
     return promotionWithDiscount;
   }
+  /**
+   * Creates a promotion with one discount and assigns a condition rule as a persona rule.
+   * The created promotion and assigned rule are both registered for cleanup.
+   *
+   * @param promotionConfig - Promotion configuration, including the promotion id, name, and assigned rule id.
+   */
+  async createPromotionWithConditionRule(promotionConfig) {
+    const useCode = promotionConfig.useCode ?? false;
+    const basicPromotion = this.getBasicPromotionStruct(promotionConfig.salesChannelId, {
+      id: promotionConfig.id,
+      name: promotionConfig.name,
+      useCodes: useCode,
+      useIndividualCodes: useCode,
+      discounts: [
+        {
+          scope: promotionConfig.discountScope ?? "cart",
+          type: promotionConfig.discountType ?? "percentage",
+          value: promotionConfig.discountValue ?? 10,
+          considerAdvancedRules: false
+        }
+      ]
+    });
+    if (!useCode) {
+      delete basicPromotion.code;
+    }
+    const promotionWithConditionRule = {
+      ...basicPromotion,
+      personaRules: [
+        {
+          id: promotionConfig.ruleId
+        }
+      ]
+    };
+    const promotionResponse = await this.AdminApiClient.post("promotion?_response=detail", {
+      data: promotionWithConditionRule
+    });
+    expect(promotionResponse.ok()).toBeTruthy();
+    const { data: promotion } = await promotionResponse.json();
+    this.addCreatedRecord("promotion", promotionConfig.id);
+    this.addCreatedRecord("rule", promotionConfig.ruleId);
+    return promotion;
+  }
   /**
    * Creates a new basic payment method.
    *
@@ -4860,12 +4933,14 @@ class TestDataService {
     return shippingMethod;
   }
   /**
-   * Creates a new basic rule with the condition cart amount >= 1.
+   * Creates a new basic rule with the condition cart amount >= 1 by default.
+   * Pass a condition object to create the same basic rule structure with another condition.
    *
    * @param overrides - Specific data overrides that will be applied to the basic rule data struct.
+   * @param condition - The condition object or condition type used in the generated rule.
    */
-  async createBasicRule(overrides = {}, conditionType = "cartCartAmount", operator = ">=", amount = 1) {
-    const basicRule = this.getBasicRuleStruct(overrides, conditionType, operator, amount);
+  async createBasicRule(overrides = {}, condition = "cartCartAmount", operator = ">=", amount = 1) {
+    const basicRule = this.getBasicRuleStruct(overrides, condition, operator, amount);
     const ruleResponse = await this.AdminApiClient.post("rule?_response=detail", {
       data: basicRule
     });
@@ -5410,6 +5485,32 @@ class TestDataService {
     const { data: aclUser } = await syncAclUserResponse.json();
     return aclUser;
   }
+  /**
+   * Retrieves a newsletter recipient by customer email and the default sales channel.
+   * @param customer - The customer whose email will be used to search for a newsletter recipient.
+   */
+  async getNewsletterRecipient(customer) {
+    const response = await this.AdminApiClient.post("search/newsletter-recipient", {
+      data: {
+        limit: 1,
+        filter: [
+          {
+            type: "equals",
+            field: "email",
+            value: customer.email
+          },
+          {
+            type: "equals",
+            field: "salesChannelId",
+            value: this.defaultSalesChannel.id
+          }
+        ]
+      }
+    });
+    expect(response.ok()).toBeTruthy();
+    const { data: result } = await response.json();
+    return result[0];
+  }
   /**
    * Retrieves a language based on its code.
    * @param languageCode
@@ -6029,9 +6130,16 @@ class TestDataService {
     }
     return Object.assign({}, basicProduct, overrides);
   }
-  getBasicRuleStruct(overrides = {}, conditionType, operator, amount) {
+  getBasicRuleStruct(overrides = {}, condition = "cartCartAmount", operator = ">=", amount = 1) {
     const { id: ruleId, uuid: ruleUuid } = this.IdProvider.getIdPair();
     const ruleName = `${this.namePrefix}Rule-${ruleId}${this.nameSuffix}`;
+    const ruleCondition = typeof condition === "string" ? {
+      type: condition,
+      value: {
+        operator,
+        amount
+      }
+    } : condition;
     const description = `
             Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam voluptua. 
             At vero eos et accusam et justo duo dolores et ea rebum. Stet clita kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor sit amet. 
@@ -6048,15 +6156,7 @@ class TestDataService {
           children: [
             {
               type: "andContainer",
-              children: [
-                {
-                  type: conditionType,
-                  value: {
-                    operator,
-                    amount
-                  }
-                }
-              ]
+              children: [ruleCondition]
             }
           ]
         }
@@ -7372,6 +7472,16 @@ class OffCanvasCart {
       lineItemGaranLabel
     };
   }
+  async getLineItemByPromotionName(name) {
+    const promotionItem = this.page.locator(".line-item-promotion", { hasText: name });
+    const promotionLabel = promotionItem.locator(".line-item-label");
+    const promotionPrice = promotionItem.locator(".line-item-total-price-value");
+    return {
+      promotionItem,
+      promotionLabel,
+      promotionPrice
+    };
+  }
 }
 
 class CheckoutConfirm {
@@ -7406,6 +7516,7 @@ class CheckoutConfirm {
    */
   cartLineItemImages;
   page;
+  confirmProductTable;
   constructor(page) {
     this.page = page;
     this.headline = page.getByRole("heading", { name: translate("storefront:checkout:confirm.completeOrder") });
@@ -7427,6 +7538,27 @@ class CheckoutConfirm {
     this.termsAndConditionsWithLegalGuaranteeRightsLabel = page.getByLabel(translate("storefront:checkout:confirm.termsAndConditionsWithLegalGuaranteeRights"));
     this.legalGuaranteeNoticeLink = page.locator("#legalGuaranteeNoticeModal a");
     this.lineItemGaranLabel = page.locator(".line-item-garan-label");
+    this.confirmProductTable = page.locator(".confirm-product");
+  }
+  getLineItemByProductName(productName) {
+    const productLineItem = this.confirmProductTable.locator(".line-item-product", { hasText: productName });
+    const productNameLabel = productLineItem.locator(".line-item-label");
+    const productTotalPrice = productLineItem.locator(".line-item-total-price-value");
+    return {
+      productLineItem,
+      productNameLabel,
+      productTotalPrice
+    };
+  }
+  getLineItemByPromotionName(promotionName) {
+    const promotionLineItem = this.confirmProductTable.locator(".line-item-promotion", { hasText: promotionName });
+    const promotionNameLabel = promotionLineItem.locator(".line-item-label");
+    const promotionTotalPrice = promotionLineItem.locator(".line-item-total-price-value");
+    return {
+      promotionLineItem,
+      promotionNameLabel,
+      promotionTotalPrice
+    };
   }
   url() {
     return "checkout/confirm";
@@ -9366,6 +9498,7 @@ class DataSharing {
 class Dashboard {
   contentView;
   adminMenuView;
+  adminMenuOffCanvasToggle;
   adminMenuCatalog;
   adminMenuOrder;
   adminMenuOrderOverview;
@@ -9398,6 +9531,7 @@ class Dashboard {
   constructor(page) {
     this.page = page;
     this.adminMenuView = page.locator(".sw-admin-menu");
+    this.adminMenuOffCanvasToggle = page.getByRole("button", { name: translate("administration:dashboard:userMenu.offCanvasToggle") });
     this.contentView = page.locator(".sw-desktop__content");
     this.adminMenuCatalog = page.locator(".sw-catalogue");
     this.adminMenuOrder = page.locator(".sw-order");
@@ -9428,7 +9562,7 @@ class Dashboard {
       name: translate("administration:dashboard:shopwareServices.exploreNow")
     });
     this.adminMenuUserActions = page.locator(".sw-admin-menu__user-actions-toggle");
-    this.adminMenuLogoutButton = page.locator(".sw-admin-menu__user-actions").getByRole("link", { name: translate("administration:dashboard:userMenu.logout") });
+    this.adminMenuLogoutButton = page.getByText(translate("administration:dashboard:userMenu.logout"));
   }
   url() {
     return "#/sw/dashboard/index";
@@ -12144,7 +12278,7 @@ const BulkEditCustomers = test$e.extend({
           if (accountData.language) {
             await AdminCustomerBulkEdit.changeLanguageCheckbox.click();
             await AdminCustomerBulkEdit.changeLanguageInput.click();
-            await AdminCustomerBulkEdit.page.getByText(accountData.language).click();
+            await AdminCustomerBulkEdit.filtersResultPopoverItemList.getByText(accountData.language, { exact: true }).click();
           }
           if (accountData.replyToCustomerGroupRequest) {
             await AdminCustomerBulkEdit.replyToCustomerGroupRequest.click();

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@shopware-ag/acceptance-test-suite",
-    "version": "12.20.1",
+    "version": "12.21.0",
     "description": "Shopware Acceptance Test Suite",
     "keywords": [
         "fixtures",