Promotions Standard

MINOR We have made an enhancement to cart side effect messages on promotion applications. Now, when a second promotion using the same code as an existing one in the cart is applied, the side effects provide more detailed messages, indicating the removal and addition of different promotions.

INTEGRATIONS HUB: Released Algolia - Full / Delta / Large Catalog V69 (US) - V54 (EU): This new version includes a fix for an intermittent issue with some dropped images during catalog sync. For more information, see Integrating with Algolia.

MINOR Commerce Manager: We have now renamed Promotions to Promotions Standard in Commerce Manager. For more information, see Promotions Standard.

MINOR Introduced a new specialized Promotions Manager role dedicated solely to promotions management within a store. For more information, see Permissions.

INTEGRATION HUB Released a new version of the Shopify integration. The template field Catalog Name is renamed to Shopify Product/Variant ID for catalog name. For more information, see Integrating with Shopify.

MINOR When exporting products in Product Experience Manger, new fields in the exported CSV file capture the date and time a product and a template was created and/or updated. For more information, see Export Products.

MINOR Commerce Manager: When you navigate to Store > Promotions, a new Search coupon code field allows you to filter a promotion code across all promotions. For more information, see Searching a Promotion Code.

MAJOR Commerce Manager: We have introduced a new Integration Builder design. This enhanced Builder experience allows you to:

• Build integrations faster and easier in a low-code environment.
• Streamline designer canvas that optimizes space usage.
• Add and configure integration steps with improved efficiency.
• Navigate seamlessly with introduction of new panning and zooming features.

MINOR When automatically adding free gifts in the shoppers cart, you now have to ensure that the currency of automatically added gift items matches with the currency of the eligible items. Additionally, the free gift item must be within the same catalog as the eligible items. In case of a currency mismatch, the cart response includes an error section addressing the issue with free gift items. For more information, see Promotions.

MINOR Added new filtering attributes to facilitate searching for a promotion code within a specific promotion and filtering advanced promotion usages. For more information, see Get all Promotions and Get Promotion Codes.

Additionally, in Commerce Manager, we have added a new Search coupon code field to filter a promotion code within a specific promotion. For more information, see Searching a Promotion Code within a Specific Promotion.

INTEGRATION HUB: Released Elastic Path Commerce Cloud Node Product Association Import V5 (both US & EU). The number of node-product relationships that are created in a single API call has been decreased from 100 to 20. Inbound records that specify more than 20 relationships are split into multiple API calls.

BUILDER COMPONENT: Released Elastic Path Import Node Product Associations V6 (both US & EU). The number of node-product relationships that are created in a single API call has been decreased from 100 to 20. Inbound records that specify more than 20 relationships are split into multiple API calls.

MINOR A new cancel a job endpoint is introduced with promotions, allowing you to cancel a job whose status is either pending or processing. For more information, see cancel a job.

MAJOR We have introduced a new field called auto_add_free_gift into the Free Gift Promotion type where free gifts are automatically added to the shopping cart for all the eligible products. For more information, see Promotions Overview section. This feature is still a work in progress.

Additionally, in Commerce Manager, we have also introduced the Automatically add free gift items to the cart toggle to add free gifts automatically to the shopping cart. For more information, see Creating Free Gift Promotions.

MINOR When extending the end date of an expired promotion with over 1000 codes, you will now receive an error response. In such cases, we recommend duplicating the promotion, allowing you to set the new end dates and create promotion codes as needed. For more information, see Update a Promotion**.**

MINOR Fixed a bug in the Fixed Bundle Discount promotion where, when a product's price was $0, the discount was still applied, resulting in a large unexpected value instead of $0.

MAJOR Added new endpoints to create an asynchronous job to generate and export promotion codes. For more information, see Create Promotion Codes Generation Job and Create Promotion Codes Export Job. Additionally, we have also added endpoints to view all promotion Jobs and exported codes file in CSV format. See Get Promotion Jobs and Get Promotion Codes Exported File.

In Commerce Manager:

• We have removed the generate code button under the Add a single code tab.
• We updated the Bulk generate codes tab to create a large number of unique codes and export them in CSV format. You can use the Bulk generate codes tab to generate either a single code or multiple codes. For more information, see Adding a Single Code, Generating Bulk Codes, and Managing Export Codes.

MAJOR You can now use the preview cart feature to set a future date for your shopping cart and view the promotions that will be available during that period. This feature enables you to validate your promotion settings and observe how they will be applied in the cart. For more information, see Create a Preview Cart.

MINOR You can now create invoices for Stripe customers from the STORE > Invoicing tab in Commerce Manager. For more information, see Create Invoices.

MINOR Commerce Manager: We now allow to add up to six decimal places for the discount percentage to be applied for Cart percent discount promotion and Item percent discount promotion.

MINOR We have now set the validation for the percentage to be included to allow up to six decimal places for Cart percent discount and Item percent discount. For more information, see Promotions.

Major Shoppers can now apply custom discounts from external services to carts and cart items during their purchases. Additionally, you can also view custom discounts on the Order details page in Commerce Manager. For more information, see Custom Discounts.

Major A new Get All Account Memberships on Account Member API allows you to return all the account memberships that an account member belongs to based on their account member ID. For more information, see Get All Account Memberships on Account Member.

Minor Now, if a previous catalog publish date is greater than 90 days, a full catalog publish is automatically performed. If you publish your catalogs infrequently, Elastic Path Commerce Cloud may perform a full publish when you are expecting a delta publish. For more information, see Publish a Catalog.

Minor Commerce Manager: We have now disabled the Add a new promotion code button on the Promotion Codes tab when you try to create a promotion code for an automatically enabled promotion. This is useful because we cannot generate new promotion codes for automatic promotion. For more information, see Promotion Codes.

Major Organization-level integrations and events specific changes:

Org admins can now create and view organization-level integrations. For more information, see Organization Roles. Organization-level events contain org_id whereas store-level events contain org_id and store_id. For more information, see Characteristics of Catalogs.

Availability levels of observable keys. For more information, see Observable Events.

Minor We have now set the validation for the percentage to be included to allow up to three decimal places for Cart percent discount and Item percent discount. For more information, see Promotions.

Major Commerce Manager: You can now add AND/OR conditions on attributes and hierarchies or nodes to be included and excluded from a promotion based on multiple conditions at the same time. See Promotions.

Major As announced on February 1, 2023, we have now seamlessly migrated all the existing legacy keys to a corresponding Application Key. In Commerce Manager, the migrated keys will now appear on the SYSTEM > Application Keys page. For more information, see Application Keys.

Minor Commerce Manager: When you checkout a cart with bundle configuration including multiple options from each bundle component, you can now view all selected multiple options for each bundle component on the Order details page. For more information about bundle configuration, see PXM Bundles in Commerce Manager.

Minor In Commerce Manager:

• Moved Settings option to Settings > Store Settings section.

• Renamed Settings > Store Settings to Settings > Store Settings > General Settings. For more information, see Store Details Settings.

• Minor You can now include and exclude products from a promotion based on their attributes for the following promotion types:

• Create Item Percent Discount Promotion

• Create Item Fixed Discount Promotions

• Create X for Y Discount Promotion

• Create X for Amount Discount Promotion

  Additionally, in Commerce Manager, we have included:

• New Attributes condition type in Add exclude > Condition Type section to exclude products from a promotion based on their attributes.

• New Attributes condition type in Add Promotion Condition > Condition Type section to include products in a promotion based on their attributes.

  For more information, see Creating Item-level Promotions.

Minor You can now exclude products from a promotion based on their attributes from cart-level promotions. For more information, see Create a Cart Fixed Discount Promotion and Create a Cart Percent Discount Promotion.

Minor Commerce Manager: New Attributes condition type in Add exclude > Condition Type field allows you to exclude products from a promotion based on their attributes from cart-level promotions. For more information, see Creating Cart-level Promotions.

Minor You can now see created_by and updated_by attributes to track changes made to a promotion in your store. For more information, see Promotions.

Minor You can use eq operator to search promotions using promotion codes. For more information, see Filtering with v2/promotions and Get all Promotions.

Minor Commerce Manager: A new Hide Empty Template Fields toggle allows you to hide an attribute in your published catalog if no data has been set for the field. See Product Template Attributes.

Minor Commerce Manager:

• A new field Catalogs allows you to include catalogs to be applied for the promotion. For more information, see Creating Cart-level Promotions and Creating Item-level Promotions.
• A new field Products and Hierarchies > Enter by Hierarchy or Node allows you to include the hierarchies or nodes in the promotions. For more information, see Creating Item-level Promotions.
• A new field Excludes > Enter by Hierarchy or Node allows you to exclude the hierarchies or nodes from the promotions. For more information, see Creating Cart-level Promotions and Creating Item-level Promotions.

Minor New bread_crumb_node metadata in a catalog enables you to see the nodes that product and nodes are associated with. For more information, see Catalogs.

Minor Fixed a bug where promotions were not applied when the currency of the item or cart does not match the currency of the promotion. When you apply the promotion, you will now get a promotion message indicating the currency mismatch. In this case, the promotion with the mismatched currency will be skipped, and any other applicable promotions will be applied. For more information, see Add Promotion to Cart.

Major Commerce Manager: You can now manage catalog releases from Catalogs > Edit Catalog. For more information, see Editing Catalogs.

Minor Fixed a bug where promotions to carts were applied even when start date of the promotions was in the future.

Minor You can now see price without discounted amount and all the discounts applied in the meta object in carts and order items. You can also see the promotion id generated for the promotion. For more information, see Cart Items and Order Items.

Major You can now add exclude options under the schema object to exclude nodes and product SKUs for the following promotion types:

• Create a Cart Fixed Discount Promotion
• Create a Cart Percent Discount Promotion
• Create Fixed Discount Promotion for items
• Create Item Percent Discount Promotions

Major You can now define target_nodes under the schema object to include nodes for the promotion for Create Fixed Discount Promotion for items and Create Item Percent Discount Promotions.

Major Added endpoints that allow to read and write Time-to-live (TTL) settings for logs. For more information, see Logs Time-to-live (TTL) Settings.

Major New promotion type which limits coupon usage per individual customer.

Major Implemented customer-specific promotions.

Major Implemented visual builder in Commerce Manager for the management of promotions.

Major Implemented bundled promotions. Major Prevented multiple promotions from targeting a single item. For more information, see Promotions.

Minor Added the ability to delete a single promotion code via a new endpoint.

Minor Cart items now returned with GET cart call.

Minor Adding a promo code to an empty cart now returns 422: "At least one product must be included in your cart to qualify for this offer".

Minor Adding the same promo code to a cart more than once returns 201 but ensures the code is applied only once.

Minor Updating a modifier no longer changes the child product IDs on rebuild.