> For the complete documentation index, see [llms.txt](https://developer.esw.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.esw.com/salesforce-commerce-cloud/sfcc-release-notes/whats-new.md).

# What's new

{% updates format="full" %}
{% update date="2026-04-27" tags="sitegenesis" %}

## Cartridge v5.1.0

#### Features & Supported ESW Integrations <a href="#features-and-supported-esw-integrations" id="features-and-supported-esw-integrations"></a>

* **`SiteGenesis`Backwards Compatibility:** Added Support for the minimum compatibility mode 21.7
  {% endupdate %}

{% update date="2026-03-30" tags="marketing-opt-in,mixed-cart,headless,node-22,returns,service-urls,digital-products,pricing-advisor,marketing-opt-ins,scapi,pwa" %}

## Cartridge v5.0.0

**Topics:** `marketing-opt-in`, `mixed-cart`, `scapi`, `pwa`, `headless`, `returns`, `digital-products`, `service-urls`, `pricing-advisor`, `node-22`

#### Features and supported ESW integrations

* **Country-level marketing opt-ins:** Capture and manage shopper consent by market for email, SMS, phone, and post. Opt-ins sync between ESW Checkout and SFCC customer profiles.
* **Mixed cart support:** Combine physical and digital products in one cart and complete checkout in one transaction.
* **Automated service URL generation:** Build service URLs from tenant preferences such as tenant ID, environment, and version. Existing values in Service Credentials still take precedence.
* **SCAPI support for the headless cartridge:** Use SCAPI custom endpoints alongside the existing OCAPI integration. The headless cartridge now supports both frameworks through configuration.

#### Improvements

General enhancements and bug fixes:

* Upgraded the PWA Retail React App to v6 and added Node 22 support.
* Updated the returns flow. The webhook now returns `200 OK` only after SFCC stores the return and the return order status is `Processed`. It returns `204` when SFCC does not store the return.
* Fixed a fatal error in the welcome mat flow when landing page conditions failed and no fallback template existed.
* Fixed delivery price mismatches between basket and checkout after shipment-level promotions. Rounding rules no longer apply to delivery prices.
* Fixed the **Register** button display on the self-hosted order confirmation page for registered shoppers on SiteGenesis.

#### Configuration and system object enhancements

**Site preferences**

* `isEswOptinsEnabled`
* `eswOverrideOptinTextFields`
* `isEswEmailMarketingOptinEnabled`
* `isEswSmsMarketingOptinEnabled`
* `isEswPhoneMarketingOptinEnabled`
* `isEswPostMarketingOptinEnabled`
* `eswIsPwaKitMappingEnabled`
* `eswPricingAdvisorVersion`
* Removed `eswPwaUrl`

**`ESW_COUNTRIES` custom object attributes**

* `isEswSmsMarketingOptinHidden`
* `isEswEmailMarketingOptinHidden`
* `isEswPostMarketingOptinHidden`
* `isEswPhoneMarketingOptinHidden`

**Profile custom attributes**

* `eswPhoneMarketingOptIn`
* `eswPostMarketingOptIn`

**Product custom attribute**

* `eswIsDigitalProduct`

**Product line item custom attribute**

* `eswIsDigitalProduct`
  {% endupdate %}

{% update date="2025-10-28" tags="pricing,sfra,webpack-5" %}

## Cartridge v4.9.0

#### Features and supported ESW integrations

* **Spark pricing integration:** Enables ESW Spark to dynamically localize storefront prices for countries using the calculated pricing model. This release supports SFRA only.

#### Improvements

General enhancements and bug fixes:

* Added the promotions callout message to the `preOrder` request. The message now appears on the checkout page.
* Split auth tokens longer than 1000 characters for Headless OCAPI and PWA architectures.
* Added support for Webpack 5.

#### Configuration and system object enhancements

**Site preferences**

* `eswSparkScriptURL`
* `eswIsSparkDynamicPricingEnabled`
* `eswIsIframeCheckoutEnabled`
  {% endupdate %}

{% update date="2025-09-29" tags="payment,order-confirmation,multi-origin,azure-logs" %}

## Cartridge v4.8.0

#### Features & Supported ESW Integrations <a href="#features-and-supported-esw-integrations" id="features-and-supported-esw-integrations"></a>

* Order Payment Status Update from ESW to SFCC: This feature synchronizes payment statuses from ESW directly into the SFCC Business Manager, providing real-time insights into the financial progression of each order.
* Self Hosted Order Confirmation Page: The ESW cartridge now supports self-hosted order confirmation, allowing retailers to choose where shoppers are redirected after a successful ESW checkout. In SFCC, they can configure either a custom path on their site or an external URL as the order confirmation page.
* Multi Origin: Multi origin feature is now supported by SiteGenesis, PWA, and Headless atchitectures.
* Azure Logs Integration: The ESW cartridge is now integrated with Azure logging. Errors from the ESW cartridges will be logged in real-time in the ESW logs, enabling faster and more efficient troubleshooting.

#### Improvements <a href="#improvements" id="improvements"></a>

General Enhancements And Bug Fixes:

* Added support for post-order registration for the Headless architectures.
* The information provided on the Integration Monitoring page is now presented in tabular form instead of JSON.
* Refactored the SFRA cartridge to eliminate deprecated methods and fix quota violation errors.
* Updated the UI Menu in Merchant Tools. Now only one menu item is present in the Merchat Tools menu for the ESW cartridge - “Cartridge Management“
* Rounding rules now derive the currency exponent from pricing advisor data
* Enhanced shopping experience with faster PLP and PDP load times. Remote include calls are now cached and triggered only when shoppers change currency or country, ensuring smoother browsing and reduced wait times.
* Node 18 is now supported for the ESW cartridge.

#### Configuration/System Object Enhancements <a href="#configuration-system-object-enhancements" id="configuration-system-object-enhancements"></a>

Site Preferences

* `eswMultiOriginEnabled`
* `eswSyncPostOrderUpdates`
* `isEswSelfHostedOcEnabled`
* `eswSelfhostedOcPageUrl`
* `eswEnableAzureInsightLogs`
* `eswAzureInsightiKey`

PaymentTransaction(System Attribute):

* `eswPaymentStatus`

Services:

* `EswOcapiDataAuthService`
* `EswMoInventorySyncCredentials`
* `EswAzureInsightService`
* `EswDispatchOcapiJobService`

Job

* `eswSubmitLogsForReviewJob`

***

{% endupdate %}
{% endupdates %}

## Cartridge v4.7.1

#### Features & Supported ESW Integrations

* **ABTasty integration:** Retailers can define and manage their A/B tests and personalization campaigns directly within the AB Tasty platform. Once configured, these tests and campaigns are seamlessly applied to the storefront, enabling dynamic content adjustments and user experience optimizations.
* **Net and Gross site taxation support for ESW orders:** ESW cartridge now supports both net and gross site taxation models

#### Improvements

**General Enhancements And Bug Fixes:**

* Default currency code for the selected country is now used if for any reason the esw\.currency cookie is set to null.
* Resolved an issue where an error occurred during order creation if the shipping method was not set at basket creation for OCAPI.
* Resolved an issue where the default address didn’t show up as the first address on checkout for registered shoppers
* New custom attributes are added to support the native Japanese first name and last name, and article-level charges.
* The deprecated httpRequest method is removed from the ESW SFCC Cartridge
* BM cartridge updated to conditionally display the SFTP or API catalog configuration fields based on the value of feature switch isEswCatalogFeatureEnabled.
* Job eswRetailerCatalogFeed is updated to sync catalog using Catalog API if feature flag isEswCatalogFeatureEnabled is set to true and to sync catalog data using SFTP when it is set to false.
* Implemented backend logic to support cart rebuild functionality in the headless (OCAPI) cartridge

#### Configuration/System Object Enhancements

**Line Item Custom attributes**

* ESW Article Charges

**Shipping Address Custom attributes**

* Native First Name for Japanese
* Native Last Name for Japanes

**Custom Site Preferences - ESW Retailer Display Configuration:**

* ESW AB Tasty Script Path

## Cartridge v4.7.0 <a href="#whats-new-in-v4.7.0" id="whats-new-in-v4.7.0"></a>

#### Features & Supported ESW Integrations <a href="#features-and-supported-esw-integrations" id="features-and-supported-esw-integrations"></a>

* **Embedded Checkout on Storefront:** Shoppers can now complete their purchases seamlessly with the new Embedded Checkout, which loads the checkout in an iFrame directly on the cart page—eliminating redirects and enhancing the shopping experience.
* **JWKS Authentication Support:** Webhooks now support authentication using JWKS (JSON Web Key Sets) for enhanced security and dynamic key verification. Existing Basic Authentication remains available, providing retailers with the flexibility to choose their preferred authentication method.
* **SFRA Upgrade**: The ESW Cartridge now supports SFRA version 7.0.1, ensuring compatibility with the latest updates and improvements. The ESW Cartridge now supports SFRA version 7.0.1, ensuring compatibility with the latest updates and improvements.
* **PWA Upgrade**: The ESW Cartridge now supports PWA Kit version 3.8.0, ensuring compatibility with the latest updates and improvements.

#### Configuration/System Object Enhancements <a href="#configuration-system-object-enhancements" id="configuration-system-object-enhancements"></a>

**Order**

* eswBasketUuid

**Site Preferences**

* eswCheckoutIframeScriptPath
* eswCheckoutIframeCookieName
* eswOcapiClientId
* eswHeadlessSiteUrl

**Services**

* EswGetJwksService
* EswOrderCreation
* EswOcapiBasketService
* EswOcapiOrderService

**Jobs**

* eswGetJwksJob

**Custom Objects**

* ESW\_JWKS

## Cartridge v4.6.2 <a href="#whats-new-in-v4.6.2" id="whats-new-in-v4.6.2"></a>

#### Features & Supported ESW Integrations <a href="#features-and-supported-esw-integrations" id="features-and-supported-esw-integrations"></a>

* **Global localization:** The ESW Cartridge now supports global localization through a hybrid proxy method. This integration allows for seamless translation and localization of the storefront and checkout processes, enhancing user experience and compliance with global standards. No extra configuration is required in SFCC to enable this flow.

## Cartridge v4.6.1 <a href="#whats-new-in-v4.6.1" id="whats-new-in-v4.6.1"></a>

#### Features & Supported ESW Integrations <a href="#features-and-supported-esw-integrations" id="features-and-supported-esw-integrations"></a>

* **Multi Origin:** ESW SFCC Cartridge now supports multi-origin feature. Multi-Origin Shipments is a logistics solution that enables retailers to dispatch products from multiple locations or warehouses. This system optimizes shipping rates and Estimated Delivery Dates (EDD) based on shipment division.

  By facilitating faster deliveries, it ensures that different parts of an order reach the shopper as quickly as possible. Additionally, Multi-Origin Shipments promotes environmental sustainability by prioritizing local fulfillment centers, thereby reducing the carbon footprint.

#### Configuration/System Object Enhancements <a href="#configuration-system-object-enhancements" id="configuration-system-object-enhancements"></a>

**Product Custom Attributes**

* eswFulfilmentCountryIso

**Product Line Item Custom Attributes**

* eswFulfilmentCountryIso
* eswDeliveryOption

**Custom Site Preferences**

* eswMultiOriginEnabled

## Cartridge v4.6.0 <a href="#heading-title-text" id="heading-title-text"></a>

#### Features & Supported ESW Integrations <a href="#features-and-supported-esw-integrations" id="features-and-supported-esw-integrations"></a>

* **Multiple Shipments:** ESW SFCC Cartridge now supports multiple shipments for an order. With this feature, shoppers can now view multiple tracking codes on the order details page and see which products are included in each package by hovering over the tracking code.
* **Ship From Anywhere:** Any order shipment/package created outside of SFCC can now be synchronized back into SFCC from ESW.
* **ESW Shipping Methods Display on Cart:** Shoppers can now see available delivery methods directly on their cart page incase shipping overrides are setup in SFCC. They can select their preferred delivery method and view the associated delivery prices, enhancing the overall shopping experience.
* **Multiple Address Book:** Shoppers can now select an address from multiple saved addresses on ESW Checkout. All new addresses added on ESW checkout are now saved on the SFCC address book for the shopper

#### Improvements <a href="#improvements" id="improvements"></a>

**General Enhancements And Bug Fixes:**

* Update of the eswUrlExpansionPairs custom preference to support logo URL on the checkout page.
* Enhanced Exception handling is added in case an order is failed and inventory runs out before the order is confirmed in SFCC.

#### Configuration/System Object Enhancements <a href="#configuration-system-object-enhancements" id="configuration-system-object-enhancements"></a>

**Order Custom Attributes**

* eswPackageJSON

**Custom Site Preferences**

* eswEnableMultipleShipment
* eswHideNativeShipping
* isEswMultiAddressEnabled

**Jobs**

A new job step is added for the **eswRetailerPackageFeed** job to get package information from ESW to SFCC.

## Cartridge v4.5.0 <a href="#heading-title-text" id="heading-title-text"></a>

#### Features & Supported ESW Integrations <a href="#features-and-supported-esw-integrations" id="features-and-supported-esw-integrations"></a>

* **Over-the-counter payment method Support:** Support for over the counter payment methods (e.g Konbini) is added to the ESW cartridge.
* **Gift Card Support:** The ESW checkout now includes support for Gift Cards as a payment method. The cartridge is also updated to synchronize gift card payment information with SFCC.
* **Page Designer:** The ESW SFRA and Site Genesis cartridges now offer support for Page Designer.
* **Exclude flagged product prices from Localized price-book generation:** The cartridge now offers to exclude certain products from new pricebook generation
* **Plugin Integration Monitoring:** The cartridge now offers a report containing the SFCC configurations which will be helpful in the troubleshoot process.

#### Improvements <a href="#improvements" id="improvements"></a>

**General Enhancements And Bug Fixes:**

* Resolved a Bug where, in an edge case, a shopper's cart would retain items after using the browser's back button to navigate to the cart from the checkout and then the forward button to place an order.
* The order cancellation API has been enhanced to include a unique transaction ID for each request
* Defensive checks have been added to the order confirmation to ensure the requests do not fail if the optional attributes are missing
* Catalog validation for the HS code region has been updated to support a broader range of codes.

#### Configuration/System Object Enhancements <a href="#configuration-system-object-enhancements" id="configuration-system-object-enhancements"></a>

The following configurations have been added:

**Order**

* `eswOverTheCounterPayloadJson`

**Site Preferences**

* `eswReturnOrderStatus`
* `eswSkipFlaggedLocalPrice`

**Custom Object**

* `ESW_Integration_Monitoring`

## Cartridge v4.4.0 <a href="#heading-title-text" id="heading-title-text"></a>

#### Features & Supported ESW Integrations <a href="#features-and-supported-esw-integrations" id="features-and-supported-esw-integrations"></a>

* **Gift card support:** ESW SFCC Cartridge now supports ESW gift card integration for SFRA architecture.
* **Cash on delivery:** Support for a new payment method “Cash on Delivery” has been added to the ESW SFCC Cartridge.

#### Improvements <a href="#improvements" id="improvements"></a>

**General enhancements and bug fixes:**

* An issue in the OCAPI Headless Cartridge has been resolved where orders were created with the EXP2 shipping method when a shipping override was used.
* An issue in the Business Manager has been fixed where the promotions for the shipments were displayed for inapplicable shipment methods.
* The unit price discrepancy between the cart and the ESW checkout page has been resolved.

#### Configuration/System Object Enhancements <a href="#configuration-system-object-enhancements" id="configuration-system-object-enhancements"></a>

The following configurations have been added:

**Order Level Custom Attribute**

* `eswRetailerCashOnDeliveryTaxFeeCurrency`
* `eswRetailerCashOnDeliveryTaxFee`
* `eswShopperCashOnDeliveryTaxFeeCurrency`
* `eswShopperCashOnDeliveryTaxFee`

**Line Item Level Custom Attribute**

* `eswRetailerCashOnDeliveryTaxFeeCurrency`
* `eswRetailerCashOnDeliveryTaxFee`
* `eswShopperCashOnDeliveryTaxFeeCurrency`
* `eswShopperCashOnDeliveryTaxFee`

## Cartridge v4.3.0 <a href="#heading-title-text" id="heading-title-text"></a>

#### Features And Supported ESW Integrations <a href="#features-and-supported-esw-integrations" id="features-and-supported-esw-integrations"></a>

* **Global Returns Platform:** ESW SFCC Cartridge now supports global returns platform v3. This will enable you to have more granular control over your returns process.

#### General Improvements And Bug Fixes <a href="#general-improvements-and-bug-fixes" id="general-improvements-and-bug-fixes"></a>

* OCAPI Headless Cartridge has been enhanced to be backward compatible with ESW Checkout v2.
* An issue regarding currency updates in cookies has been fixed to operate smoothly when the shopper visits the storefront with the country URL parameter.
* An issue has been fixed where the language on the welcome mat was not changing when *eswEnableLandingPageRedirect* was set to ‘*No*’.

#### Configuration/System Object Enhancements <a href="#configuration-system-object-enhancements" id="configuration-system-object-enhancements"></a>

The following enhancements have been made:

**ESW BM Merchant Configurations**

* Returns configurations added in the business manager under *merchant tools*.

**Shipment Level Custom Attribute**

* `eswOutboundShipmentJson` has been added.

**Order Level Custom Attribute**

* `eswCreateOutboundShipment` has been added.

**Site Preferences**

* `ESW Returns Configuration` (new custom site preference group) has been added.
* `eswCheckoutOnlyPackagesExport`has been added.

## Cartridge v4.2.1 <a href="#heading-title-text" id="heading-title-text"></a>

#### General Improvements And Bug Fixes <a href="#general-improvements-and-bug-fixes" id="general-improvements-and-bug-fixes"></a>

* Enhanced the exception handling within the checkout registration flow. An error message will be displayed on the *My Account* page in a scenario where the *order ID* is absent from the session.
* The metadata items associated with the inventory check URL in the preorder request have been optimized. The inventory check URL will now only be included in the pre-order request if the feature is enabled.
* Webhooks have been updated for the event-type checks. Webhook mapping in SFCC is now based on the ESW event type header attribute.
* ESW cartridge has been updated to be compatible with the latest SFRA version 7.0.0.
* The headless cartridge is now independent of the SFRA cartridge. As a result, there is no need to add “*int\_eshopworld\_sfra*“ into the cartridge path for the headless method.
* The issue with the currency cookie has been resolved where it was updating incorrectly when a non-default currency was selected for the chosen country.
* You can now export localized shopping feeds using `eswLocalizedShoppingFeed` job. Localized shopping feeds can be used for various third-party systems such as Google, Meta, and others.

#### Configuration/System Object Enhancements <a href="#configuration-system-object-enhancements" id="configuration-system-object-enhancements"></a>

The following enhancements have been made:

**Site Preferences**

* Added `eswLocalizedShoppingFeedDelimiter` site preference.

**Product**

* The attribute `eswLocalizedShoppingProduct` has been added on the product level.

**Custom Object Attribute**

* The attribute `isLocalizedShoppingFeedSupported` has been added in the custom object *ESW\_COUNTRIES*

**Job**

* The job `eswLocalizedShoppingFeed` has been added.

## Cartridge v4.2.0 <a href="#heading-title-text" id="heading-title-text"></a>

#### Features & Supported ESW Integrations <a href="#features-and-supported-esw-integrations" id="features-and-supported-esw-integrations"></a>

* **PWA:** SFCC ESW cartridge now supports PWA headless integration to provide retailers with a more flexible and agile approach to building and maintaining modern shopping experiences. Retailers can use the PWA Kit to create a seamless shopping experience across all devices and platforms.
* **Customer Account History:** SFCC ESW Cartridge now updates the shopper account order details with ESW order values for seamless integration.

#### Improvements <a href="#improvements" id="improvements"></a>

**General enhancements and bug Fixes:**

* The issue has been resolved where the order status was being marked as 'failed' in SFCC while ESW checkout was in progress. ESW SFCC plugin has been updated to automatically place the order during order confirmation, provided the subsequent checkout attempt is successful.
* Only delta products (newly added products that are different than products in the previous list) will now be sent to the Catalog API during synchronization. Whenever product details are updated within SFCC, the plugin will promptly mark the corresponding products as ‘unsynchronized’.
* Retailers will now be able to map ESW custom attributes for catalog synchronization in SFCC BM configurations.
* The issue related to the discrepancy in preorder between *languageIsoCode* and *expansion pair URLs* has been fixed.
* Enhanced post-order webhooks by incorporating an event type check, ensuring that the response is accurately stored in the corresponding field.

#### Configuration/System Object Enhancements <a href="#configuration-system-object-enhancements" id="configuration-system-object-enhancements"></a>

The following enhancements have been made:

**Order Attribute**

* `eswTrackingURL`

**Site Preferences**

* `eswEnableOrderDetail`
* `eswPwaUrlExpansionPairs`
* `eswPwaUrl`
* Removed `eswTrackingUrl`

**Custom Object Attribute**

* Added attribute `eswCountrylocale` in the custom object *ESW\_COUNTRIES*.

**Cartridge**

* A new cartridge `int_eshopworld_pwa` is added to support PWA integration.

## Cartridge v4.1.0 <a href="#heading-title-text" id="heading-title-text"></a>

#### Features And Supported ESW Integrations <a href="#features-and-supported-esw-integrations" id="features-and-supported-esw-integrations"></a>

* **SMS marketing opt-in:** Retailers will now be able to capture SMS marketing opt-in for ESW shoppers to send marketing and promotional messages via SMS.
* **Geo IP Alert:** .Upon changing their country, shoppers will now be shown a welcome mat to change their country/currency preferences.

#### Improvements <a href="#improvements" id="improvements"></a>

**General Enhancements And Bug Fixes:**

* In case of an empty `retailerCartId` attribute in preOrder, the shopper wouldn't be redirected to ESW checkout anymore.
* Additional error logging has been added to capture the issues related to cart ID “null“ in the preorder request.
* package.json of the ESW cartridge has been updated to meet new node versions (at least 12.22.7).
* The selected email marketing opt-in attribute on the checkout is now reserved for guest shoppers if they have a profile in the business manager.
* The issue has been fixed that was persistent with currency selection when accessing the PDP page with the country URL parameter.

#### Configuration/System Object Enhancements <a href="#configuration-system-object-enhancements" id="configuration-system-object-enhancements"></a>

The following enhancements have been made:

**Order Attribute**

* `eswSMSMarketingOptIn`

**Profile Attribute**

* `eswSMSMarketingOptIn`

**Service**:

* Added *EswPriceFeedService*
* Removed *EswPriceFeedV3Service* and *EswPriceFeedV4Service* services

**Custom Site Preference:**

* Added `eswEnableGeoIpAlert` in ESW General Configuration

**Content Slot:**

* `eswGeoIpChangeWarning`

## Cartridge v4.0.0 <a href="#heading-title-text" id="heading-title-text"></a>

The following enhancements have been made to the cartridge in this release:

#### Features & Supported ESW Integrations <a href="#features-and-supported-esw-integrations" id="features-and-supported-esw-integrations"></a>

The following new features have been added:

* **Catalog API:** This feature allows you to sync products from SFCC to ESW via API. This simplifies the synchronization process and reduces communication effort between the Compliance team that validates catalog data and the retailer.
* **Pricing Advisor API Upgrade:** Pricing Advisor has been upgraded from v3 to v4. Now, the service `EswPriceFeedService` URL will determine the Pricing Advisor API version.

#### Improvements <a href="#improvements" id="improvements"></a>

**General Enhancements and Bug Fixes:**

* A minified version of the *EswHooks.js* has been implemented.
* Tenant credentials have been removed from the metadata files.
* SFRA and ESW cartridge version is now taken from the property files for the health check job.
* The issue has been fixed where it was not possible to proceed to checkout with a product-level promotion that grants free shipping.

#### Configuration/System Object Enhancements <a href="#configuration-system-object-enhancements" id="configuration-system-object-enhancements"></a>

The following system object enhancements have been added:

* New menu options added: *Merchant Tools → ESW → Catalog*
* A new screen for managing Catalogs has been added.
* Catalog API configuration preferences:
  * isEswCatalogFeatureEnabled - enables/disables catalog feature
  * isEswCatalogInternalValidationEnabled - enables/disables internal validation

#### Services: <a href="#services" id="services"></a>

* Introduced a new service *EswPriceFeedService*- Service for pricing advisor data.
* Introduced new service *ESWCatalogService* – Service for catalog API.
* Deprecated the service EswPriceFeedV3.

## Cartridge v3.8.2 <a href="#heading-title-text" id="heading-title-text"></a>

The following enhancements are added to the cartridge in this release:

#### Improvements <a href="#improvements" id="improvements"></a>

#### **General Enhancements and Bug Fixes:** <a href="#general-enhancements-and-bug-fixes" id="general-enhancements-and-bug-fixes"></a>

* Applied *Inventory Basic Authentication* for inventory check-in preorder.
* Updated line item total price where ESW is enabled and the country is supported.
* Fixed checkout service logs in the *health-check* job.
* *Localized Pricebook* will not be generated for countries with missing FxRates in the pricing advisor.
* Fixed price conversion for static callout messages in the localized promotions.
* Fixed price conversion for static content in content slots and content assets.
* Enabled storing multiple order cancellation responses.
* Added toggle to display tax information on the *Cart* page and *Order Detail* page for ESW-supported countries.

#### Configuration/System Object Enhancements <a href="#configuration-system-object-enhancements" id="configuration-system-object-enhancements"></a>

The following system object enhancements have been made:

#### **Site Preferences** <a href="#site-preferences" id="site-preferences"></a>

* New system object added – *eswEnableTaxInformation*

## Cartridge v3.8.1 <a href="#whats-new-in-v3.8.1" id="whats-new-in-v3.8.1"></a>

The following new features and enhancements are added to the cartridge in this release:

#### Improvements <a href="#improvements" id="improvements"></a>

#### General Enhancements and Bug Fixes: <a href="#general-enhancements-and-bug-fixes" id="general-enhancements-and-bug-fixes"></a>

* Support for partial and multiple returns has been extended. The new payload will now be appended in the order attributes if one of the line items is already returned.
* Support for partial and multiple cancellations has been extended. All the information for cancellation will now be stored at the order level attribute. The custom objects won’t be used anymore for this.
* Fixed an issue occurring during the checkout process where discounts were missing from the order in case the promotions were over. If promotional products are part of the order then the same promotions will be applied upon placing the order.
* Fixed an issue where checkout was not accessible because of a cart error that occurred due to multiple promotions. This has been changed to the fixed value of up to 3 decimal places to fix the issue.
* Fixed an issue where discounts were missing from order-level attributes. The code logic for this functionality has been optimized.
* The bug has been fixed for an issue where the call-out messages did not have converted prices for the localized promotions. The logic has been customized to have the prices converted in call-out messages as well when localized promotions are generated.

#### Configuration/System Object Enhancements <a href="#configuration-system-object-enhancements" id="configuration-system-object-enhancements"></a>

**The following system object enhancements are added:**

**Order:**

Two custom attributes are added

* isEswCancelledOrder
* cancelOrderJsonPayload

**The following Custom Objects are removed:**

* eswCancelledOrders

## Cartridge v3.8 <a href="#whats-new-in-v3.8" id="whats-new-in-v3.8"></a>

#### Features & Supported ESW Integrations <a href="#features-and-supported-esw-integrations" id="features-and-supported-esw-integrations"></a>

* **Order Appeasement:** This feature allows you to access the appeasement information directly through SFCC and send them to their respective OMS/WMS/financial systems. Once appeasement is performed on the ESW side webhook will be triggered that will sync appeasement data from ESW to SFCC under the order attributes. This reduces the effort needed for integration.
* **Cartridge preOrder request to store address in SFCC address book:** This feature enables you to store the address that the registered customer added on the checkout page in the SFCC address book. The default address from the SFCC address book is auto-populated on the checkout for the next purchase.
* **ESW health check logs:** This feature reduces the issue of backtracking time and helps production support find the technical information firsthand which will help them to communicate with the correct team for the resolution. Data about the status of the services and webhooks will be saved in the IMPEX folder in SFCC.

#### Improvements <a href="#improvements" id="improvements"></a>

**General Enhancements And Bug Fixes:**

* The issue where the font of the item price is bigger than the total price in the mini cart is now fixed.
* The issue where the currency was changing and diverging from the one selected on the welcome mat to the default country currency during the order flow is fixed.
* OCAPI version is updated to version 23.1
* Currency and country ISO codes are now stored in the custom session variables and are to be used in customer groups.

#### Configuration/System Object Enhancements <a href="#configuration-system-object-enhancements" id="configuration-system-object-enhancements"></a>

The following system object enhancements are added:

**Site Preferences**

* New custom object added: `ESW_DIAGNOSTIC_DATA`
* A new job is added to generate a health check log: `eswHealthCheck`
* New order attributes added: `Appeased Order Payload Response` and `isAppeasedOrder`

## Cartridge v3.7 <a href="#whats-new-in-v3.7" id="whats-new-in-v3.7"></a>

#### Features & Supported ESW Integrations <a href="#features-and-supported-esw-integrations" id="features-and-supported-esw-integrations"></a>

* **Ability to configure metadata for data layer mapping in ESW checkout:** This feature provides the ability for retailers to map customer and shopper experience metadata in the data layer on ESW checkout. This data can be used for various tag managers such as GTM, Tealium, etc. By giving the ability to configure such metadata attributes directly in SFCC to minimize retailer's specific code customizations.

#### Improvements <a href="#improvements" id="improvements"></a>

**General Enhancements and Bug fixes:**

* The issue where the taxes in the order history on the storefront were different from the taxes on the order confirmation page has now been fixed.
* The issue has been fixed where the order and shipping promotions were not displayed on the account order history when the order was placed through the ESW checkout.
* The issue has been fixed where the prices in the header on the login page were not converted into the selected currency.
* The issue has been fixed where the prices were not converting in the promotion message on ESW checkout.
* Code has been optimized for international user cookies. Furthermore, code optimization has been added in conditional statements in helper functions.

#### Configuration/System Object enhancements <a href="#configuration-system-object-enhancements" id="configuration-system-object-enhancements"></a>

The following system object enhancements have been made:

**Site Preferences**

* *ESW Customer Meta Data* added to the ESW Checkout Configuration custom preferences.
* *ESW Basket Meta Data* added to the ESW Checkout Configuration custom preferences.

## Cartridge v3.6 <a href="#whats-new-in-v3.6" id="whats-new-in-v3.6"></a>

#### Features & Supported ESW Integrations <a href="#features-and-supported-esw-integrations" id="features-and-supported-esw-integrations"></a>

* **Shopper registration post ESW checkout:** This feature enables you to add a call to action button to the order confirmation page encouraging the shoppers to register with you. This feature is expected to build a shoppers database and allow shoppers to track orders using their own shopper dashboard.
* **Share marketing opt-in preference with checkout via preorder payload:** This feature enables you to track if the shoppers have opted-in for the marketing communications at the checkout. Opt-in preference will now be saved under the shopper’s customer profile on the SFCC’s end. This feature allows you to communicate dedicated newsletters or intimation emails to the shoppers that have opted in.
* **Return merchandise authorization:** This feature enables you to synchronize returns-related data from your order management system to ESW and vice versa. Furthermore, the returns integration with SFCC also allows you to access the returns information directly from SFCC.

#### Improvements <a href="#improvements" id="improvements"></a>

#### **General Enhancements and Bug fixes:** <a href="#general-enhancements-and-bug-fixes" id="general-enhancements-and-bug-fixes"></a>

* ESW cartridge has been updated to the latest version (v 6.2) of SFRA.
* The issue where only the list price was being displayed for calculated price model countries has been fixed.

#### Configuration/System Object enhancements <a href="#configuration-system-object-enhancements" id="configuration-system-object-enhancements"></a>

The following system object enhancements have been made:

* **Custom preferences:**\
  “eswEnablePostOcRegistration” attribute has been added to the ESW checkout configuration custom preferences.
* **Customers:**\
  “ESW Marketing Optin” attribute has been added to the ESW profile attributes in the general customer attributes.
* **Orders**\
  “ESW Returned Order Response” and “Is ESW Returned Order?” attributes have been added to the order attributes.

## Cartridge v3.5 <a href="#whats-new-in-v3.5" id="whats-new-in-v3.5"></a>

#### Features & Supported ESW Integrations <a href="#features-and-supported-esw-integrations" id="features-and-supported-esw-integrations"></a>

* **SFCC VIP price books support based on customer groups:** This feature enables the SFCC plugin to support multiple Customer Group-specific price books. There may have multiple price books per country, and the countries may have fixed price books. These countries may as well need the cartridge to dynamically build these price books group-by-group or country-by-country, with the help of Pricing Advisor.
* **SFCC order level promotions with the threshold in merchant/localized currency:** This feature allows you to increase AOV by allowing promotion threshold in the shopper's currency. This also enables you to remove error-prone manual work required to manage promotions for international markets.
* **ESW Customer Groups:** With this feature, the SFCC plugin will expose several session custom attributes that the retailers can use while configuring Dynamic Customer Group. The retailers can use the Customer Group in Content Slots, Promotion Campaigns, Shipping methods, etc.

#### Improvements <a href="#improvements" id="improvements"></a>

#### **General Enhancements and Bug fixes:** <a href="#general-enhancements-and-bug-fixes" id="general-enhancements-and-bug-fixes"></a>

* Improvement has been performed to avoid duty and tax calculations for non-ESW-supported countries.
* An optimization has been performed on unit product price, getting passed for ESW checkout, for all promotion types/combinations.

## Cartridge v3.4 <a href="#whats-new-in-v3.4" id="whats-new-in-v3.4"></a>

#### Features & Supported ESW Integrations <a href="#features-and-supported-esw-integrations" id="features-and-supported-esw-integrations"></a>

* **SFCC native shipping promotion with threshold:** This feature enables you to unlock native SFCC promotion limitations for international markets. You will be able to create a shipping threshold promotion in the localized currency for specific international markets (e.g., free shipping if the order value is more than $250).
* **Shopping feed support when using dynamic/calculated price model:** This feature enables you to validate international prices required for a shopping feed. When shoppers will open the link from the feed with the country URL parameter in it, they will be redirected to the product page with the already applied country/currency pair, based on the country that is used in the URL parameter.
* **Truncation of product title:** This feature will allow placing orders with products, for which the title is longer than 100 characters. There is a limitation on the ESW side that in the PreOrder API call product title should not be longer than 100 characters. The product title will be truncated only in the PreOrder API request.

#### Improvements <a href="#improvements" id="improvements"></a>

#### **General Enhancements And Bug fixes:** <a href="#general-enhancements-and-bug-fixes" id="general-enhancements-and-bug-fixes"></a>

* Improvement has been made to display order level discount data on the checkout and order confirmation pages
* If the tracking ID is empty when Retailers OMS marks the order as ‘shipped’, the order id will be used as a package reference ID in the ASN package API request of the *eswRetailerPackageFeed* job to sync the retailer package information with ESW package service.

#### Configuration/System Object enhancements <a href="#configuration-system-object-enhancements" id="configuration-system-object-enhancements"></a>

The following system object enhancements have been added:

#### **Custom Preferences** <a href="#custom-preferences" id="custom-preferences"></a>

* *eswCountryURL* parameter has been added to the ESW general configuration custom preferencee.

#### **Promotion** <a href="#promotion" id="promotion"></a>

ESW Settings for *Promotion Threshold* section has been added to the promotion attributes with the following custom attributes:

* Enable the *Localized Threshold* checkbox.
* Promotion Discount Type drop-down with the following values: `amount_off`, `percentage_off`, `free`
* Minimum Threshold Amount field.

## Cartridge v3.3 <a href="#whats-new-in-v3.3" id="whats-new-in-v3.3"></a>

#### Features & Supported ESW Integrations <a href="#features-and-supported-esw-integrations" id="features-and-supported-esw-integrations"></a>

* **Last Minute Inventory Check:** This feature will provide the ability to check if an item in the order is in stock before the order is confirmed. This feature will be useful for large retailers who have huge order volumes in promotions. It will help to avoid a situation where shoppers' payments are authorized and then the order is later canceled due to inventory issues. It will improve the shopper experience and avoid order cancelation.
* **ESW Hub Address Saved With Current New Order Data:** This feature will provide the ability to know the immediate shipping address when using the ESW hub model. ESW Hub Address is set at a country level by using the *ESW\_COUNTRIES* custom object. ESW Hub Address is stored in order lever custom attributes for the successfully placed orders. This will help to pass the ESW hub address into the retailer’s downstream system.
* **Country Auto Selection Without Showing Displaying Country Selector In Header And Footer:** This feature will provide the ability to select the country based on the GeoIP location of the shopper. If enabled, this will furthermore hide the country selection option in the footer and the header, on the storefront.

#### Improvements <a href="#improvements" id="improvements"></a>

#### **General Enhancements and Bug fixes:** <a href="#general-enhancements-and-bug-fixes" id="general-enhancements-and-bug-fixes"></a>

* Improved checkout call to action (CTA) from SFCC Cart and Checkout Login page to avoid multiple clicks and empty basket issues. The **Proceed Checkout** button will be disabled after the user clicks on it once, up until SFCC receives any response from ESW.
* Checkout has been improved to handle a specific case.\
  \&#xNAN;*Case:* when shoppers go back to the basket using the ‘back’ button on the browser. Or refresh the basket page while the checkout page is open in a separate browser tab.
* Stored cards cookie domain masking control through custom preference has now been implemented.
* List and Sale Price books configurations have been optimized for ESW Fixed Price Model Countries. This will speed up the configuration and avoid JSON-based settings. Also, the *isReturnProhibited* flag is now stored at the order line item level for the final sale product.

#### Configuration/System Object enhancements <a href="#configuration-system-object-enhancements" id="configuration-system-object-enhancements"></a>

The following configurations are added to support all three architectures:

#### **Custom Objects** <a href="#custom-objects" id="custom-objects"></a>

ESW Hub Address fields have been added to the ESW\_COUNTRIES custom object on a per-country basis.

#### **Custom preferences** <a href="#custom-preferences" id="custom-preferences"></a>

* *eswEnableHeaderPagebar* and *eswEnableFooterBar* added to the ESW Retailer Display Configuration custom preferences.
* *eswFixedListPriceBookPattern* and *eswFixedSalePriceBookPattern* added to the ESW Pricing Configuration custom preferences.
* *eswEnableInventoryCheck* and *eswTopLevelDomain* added to the ESW Checkout Configuration custom preferences.
* New expansion pair has been added in the custom preference *eswUrlExpansionPairs* with the value *'InventoryCheckFailurePageUrl|EShopWorld-GetCart'.*

## Cartridge v3.2 <a href="#whats-new-in-v3.2" id="whats-new-in-v3.2"></a>

#### Features & Supported ESW Integrations <a href="#features-and-supported-esw-integrations" id="features-and-supported-esw-integrations"></a>

* **One-Click Configuration v1.0:** This feature will provide a much faster and error-free onboarding experience using pre-configured SFCC job to automate ESW SFCC Plugin settings. This feature will significantly reduce the manual configuration effort by automating ESW supported countries, currencies, pricing advisor data. Furthermore, this will also power the welcome mat/country selector that is available on the storefront’s header and footer.
* **ESW SFCC Plugin’s Architecture Improvements:** This feature will provide a better GUI-based experience to configure ESW SFCC Plugin settings by using SFCC custom objects and replacing complex JSON-based site preferences. This will also help to improve ESW SFCC Plugin’s performance, resolve replication issues and reduce JSON-based preferences dependency. As a result, the ESW SFCC Plugin integration will be a much faster and error-free onboarding experience.

#### Improvements <a href="#improvements" id="improvements"></a>

* **General Enhancements and Bug fixes:** Shipping discount and Bonus Products Promotions-related issues have been fixe&#x64;**.**
* **Revamped Plugin’s Documentations:** ESW SFCC Plugin’s documentation and metadata files have been updated according to the new architecture.

#### Configuration/System Object enhancements <a href="#configuration-system-object-enhancements" id="configuration-system-object-enhancements"></a>

The following configurations are added to support all three Architectures:

#### **Custom Objects** <a href="#custom-objects" id="custom-objects"></a>

The following custom objects are added. These can be imported from `link_eshopworld\sitesdata\meta\ customobjects.xml`

* ESW\_PA\_DATA
* ESW\_COUNTRIES
* ESW\_CURRENCIES

#### **Job** <a href="#job" id="job"></a>

The following job is added to automate ESW SFCC Plugin. This job can be imported from `link_eshopworld\sitesdata\jobs.xml`

* eswRetailerAutoConfigurator

#### Removed Items <a href="#removed-items" id="removed-items"></a>

The following configurations have been removed:

#### Custom Preferences <a href="#custom-preferences" id="custom-preferences"></a>

The following custom preferences have been removed:

* ESW All Countries
* ESW Default Country Currency Mapping:
* ESW Fixed Price Model Countries
* ESW FX Rates JSON
* ESW Country Adjustment JSON
* ESW Rounding Rules
* ESW Price Feed Last Updated on
* ESW Pricing Synchronization Id

## Cartridge v3.1 <a href="#whats-new-in-v3.1" id="whats-new-in-v3.1"></a>

#### Features and Supported ESW Integrations <a href="#features-and-supported-esw-integrations" id="features-and-supported-esw-integrations"></a>

* **ESW Checkout API and Order Confirmation Webhook v3.0 compatibility:** ESW SFCC Plugin is now fully compatible with ESW’s Checkout API and Order Confirmation Webhook v3.0.

The SFCC plugin still has the ability to support ESW Checkout API and Order Confirmation Webhook v2.0. For more information please refer to the [Order Confirmation Webhook](https://know.eshopworld.com/space/DT/177046186/Order+Confirmation+Webhook) and [Checkout API](https://know.eshopworld.com/page/checkout-api) documentation on ESW Knowledge Centre.

* **Stored payment cards integration:** The ‘ESW Stored Payment Cards’ feature allows the logged-in shoppers to store and reuse the debit or credit cards they use for the payment. This facilitates a faster checkout experience. See [Stored Payment Cards Integration](https://know.eshopworld.com/space/AE/723714049/Stored+Payment+Cards+Integration) for more information.

#### Improvements <a href="#improvements" id="improvements"></a>

* **ESW Checkout session timeout handling:** This new improvement will enable the retailers to control the session timeout duration on the ESW checkout v3.0. Retailers can set the session timeout value in the unit/measure of minutes. The ESW Checkout page session will be live for this specific duration.
* **SFRA Latest Version Compatibility:** ESW SFCC plugin is now fully compatible with the latest SFRA version 6.0.
* **General Enhancements and Bug fixes:** As a part of this improvement, the retailers can display the Sale price with a strike-through. This can be displayed on PLP for Calculated / Dynamic price model country when it is lower than the list price.

#### Configuration/System Object enhancements <a href="#configuration-system-object-enhancements" id="configuration-system-object-enhancements"></a>

The following configurations have been added to support all three architectures:

#### **SitePreference** <a href="#sitepreference" id="sitepreference"></a>

* A new attribute called **eswSessionTimeout** has been added to the *ESW Checkout Configuration* group.

#### **Order** <a href="#order" id="order"></a>

The following order-level custom attributes have been added:

* eswRetailerCurrencyTotalOrderDiscount
* eswRetailerCurrencyOrderDiscountsInfo
* eswRetailerCurrencyDeliveryDiscountsInfo
* eswShopperCurrencyTotalOrderDiscount
* eswShopperCurrencyOrderDiscountsInfo
* eswShopperCurrencyDeliveryDiscountsInfo

#### **Product Line Item** <a href="#product-line-item" id="product-line-item"></a>

The following product line item level custom attributes have been added:

* eswRetailerCurrencyItemDiscountsInfo
* eswShopperCurrencyItemDiscountsInfo

#### **Services** <a href="#services" id="services"></a>

The following services and credentials have been added:

* EswCheckoutV3Service.SFRA
* [EswCheckoutV3Service.SG](http://eswcheckoutv3service.sg/)
* EswCheckoutV3Credentials.SFRA
* [EswCheckoutV3Credentials.SG](http://eswcheckoutv3credentials.sg/)

#### Removed Items <a href="#removed-items" id="removed-items"></a>

The following configurations have been removed:

A removed item indicates a feature, component, or service that was considered obsolete and has been removed from the cartridge in this release.

#### **Order** <a href="#order.1" id="order.1"></a>

The following order-level custom attributes have been removed:

* eswRetailerCurrencyOrderDiscount
* eswShopperCurrencyOrderDiscount

## Cartridge v3.0 <a href="#whats-new-in-v3.0" id="whats-new-in-v3.0"></a>

#### Features and Supported ESW Integrations <a href="#features-and-supported-esw-integrations" id="features-and-supported-esw-integrations"></a>

* **Plug and Play Headless Integrations:** Headless Integration is generalized for all retailers. ESW plugin sends generic attributes back in Basket response for every retailer. The retailer can use site preference mapping for the product line item and basket global attributes. The following features were replicated for the Headless cartridge:\
  o Global Product Restriction\
  o Global Product Returns Prohibition\
  o Order Cancellation from ESW to SFCC\
  The headless cartridge is now fully compatible with SiteGenesis & SFRA architecture. See [Headless (OCAPI) Architecture](https://know.eshopworld.com/space/AE/255918276/Headless+\(OCAPI\)+Architecture).
* **New Russian Data storage:** This feature allows the retailers to use separate data storage for Russia as a shipping country to meet the compliance criteria in Russia. ESW will provide the separate proxy Checkout API URL to retailers for Russia. This URL can be configured in SFCC Site Preference. See the ESW Russian Data Storage URL custom preference in the [ESW Checkout Configuration](https://know.eshopworld.com/space/AE/255557757/Merchant+Tools#ESW-Checkout-Configuration) section.

#### Improvements <a href="#improvements" id="improvements"></a>

* **Override shipping improvements for SG and SFRA:** A new `disableConversion`parameter has been added to determine whether there is a need to convert shipping cost for dynamic/calculated pricing model country. This is an optional parameter. If this parameter is added and is set to ‘true’, then the ESW plugin will not convert the shipping cost of the overridden shipping method for the localized country.
* **Send Selected Shipping Country Addresses to ESW:** Only matched addresses with the selected shipping country are now sent in the ESW Preorder request when logged in shopper navigates to ESW Checkout.
* **Catalog CSV file delimiter:** The users can now set ESW Catalog Feed Delimiter ( ‘|' or ',’ ) in the ESW SFCC Site Preference section. The CSV file will be generated with the appropriate file delimiter when the `eswRetailerCatalogFeed` job runs.
* **Product Image View Type:** Retailers now can configure product image view types like Small, Medium, etc. This can be done via ‘ESW Image Type’ (ESW General Configuration) SFCC site preference. The preference value will be passed in ESW PreOrder Request.
* **Registered Shopper ID in PreOrder request:** Registered shopper IDs are now sent in the ESW Pre Order request using `registeredProfileId`attribute when the logged-in shopper navigates to ESW Checkout. This will enable the stored card feature that is expected to go live in the next version.
* **Disable Currency Selection for Fixed Price Model on Country Switcher:** When the country with the fixed pricing model is selected in the Welcome Mat, the currency switcher is now disabled and the default currency is selected automatically.
* **Improved behavior with failing the order:** The issue has been resolved where the order used to fail after refreshing the shopping cart while the ESW Checkout page is opened in another tab of the browser. The order can now be placed successfully on ESW Checkout even in the different browser tab.

#### General Enhancements and Bug fixes: <a href="#general-enhancements-and-bug-fixes" id="general-enhancements-and-bug-fixes"></a>

* **Handle order confirmation requests for repeating product line items having the same product code with different quantities (Headless):**\
  The repeated PLIs having different quantities now show the appropriate values in ESW SFCC Order Items Attributes.
* The deprecated SFCC API Methods have been analyzed and replaced from the ESW SFCC cartridge with the alternative methods.

#### Configuration/System Object Enhancements <a href="#configuration-system-object-enhancements" id="configuration-system-object-enhancements"></a>

The following configurations are added to support all three Architectures:

#### **SitePreference** <a href="#sitepreference" id="sitepreference"></a>

* A new attribute `eswRussianDataStorageUrl` has been added to the 'ESW Checkout Configuration' group.
* A new attribute `eswCatalogFeedDelimiter` has been added to the 'ESW Catalog Integration Configuration' group.
* A new attribute called `eswImageType` has been added to the 'ESW General Configuration' group.

#### **Product Line Item** <a href="#product-line-item" id="product-line-item"></a>

The following product line item level custom attribute has been added:

* `eswLineItemId`

The following configurations are added to support Headless OCAPI Architecture:

#### **Basket** <a href="#basket" id="basket"></a>

The following product basket level custom attribute has been added:

* `eswEstimatedShippingTotal`

#### **Product Line Item** <a href="#product-line-item.1" id="product-line-item.1"></a>

The following product line item level custom attributes have been added:

* `eswReturnProhibited`
* `eswRestrictedProduct`

## Cartridge v2.10 <a href="#whats-new-in-v2.10" id="whats-new-in-v2.10"></a>

#### Features and Supported ESW Integrations <a href="#features-and-supported-esw-integrations" id="features-and-supported-esw-integrations"></a>

* **Two Ways Full order cancellation:** This feature allows you to synchronize cancelled orders status between SFCC and ESW. This is regardless of whether the order cancellation was triggered first in SFCC or ESW. The ESW-SFCC cartridge allows you to synchronize cancelled order status in both ways; ESW to SFCC, and vice versa. For more information on how this feature works, see [Order Cancellation Integration](https://know.eshopworld.com/space/AE/580812939/Order+Cancellation+Integration).
* **Localized Front-End Prices:** The Localized Front-end Prices feature has been added to enhance shopper’s localized experience by converting front-end prices to localized prices. These front-end prices can be configured in Content Slots/ Assets and Promotional Call-out Messages. ESW SFCC plugin will automatically convert these static prices to localized messages. This will remove the operational overheads from your merchandising team to configure separate promotions and content assets for every localized ESW supported shipping country. For more information on how this feature works, see [Localized Front-End Prices](https://know.eshopworld.com/space/AE/475332611/Localized+Front-End+Prices).
* **Exclude or Freeze Product Prices from Localized PriceBooks:** This feature allows you to,\
  o Exclude product prices while generating new localized price books for a specific localized country.\
  o Freeze product prices from existing localized price books while updating product prices using the latest pricing advisor data.\
  For more information on how this feature works, see [Localized PriceBooks](https://know.eshopworld.com/space/AE/255983646/Localized+Pricebooks).

#### Improvements <a href="#improvements" id="improvements"></a>

* **Published Plugin V-2.9 for Salesforce Marketplace Certification:** Latest eShopWorld plugin V-2.9 has been certified and published on the salesforce marketplace. This will allow existing retailers to download the latest plugin cartridges from the salesforce marketplace for updates and new retailers can download the plugin for clean integration in their SFCC project. The newly certified version also contains the headless cartridge for integration alongside SG and SFRA cartridges. The latest certified version can be download from [Salesforce Marketplace](https://www.salesforce.com/products/commerce-cloud/partner-marketplace/partners/eshopworld/).
* **SFRA Latest Version Compatibility:** ESW SFCC plugin is fully compatible with SFRA latest version 5.3.0.
* **Checkout Disclaimer Message:** This will allow you to display checkout disclaimer message under the checkout button. This can be enabled through the *esw-checkout-disclaimer-message* content asset which will be imported in the content library on importing site metadata. The checkout disclaimer message can be enabled/disabled through the content asset by turning the online flag on or off.
* **Optimized Cartridge documentation:** Feature-specific optimization for cartridge integration documentation and architect-specific optimization for cartridge code customization documentation have been applied.
* **ESW Checkout Logo link enhancement:** Added new pipeline *EShopWorld-Home* endpoint. This endpoint restores the cart for shoppers on redirecting back from ESW checkout. ESW suggests you to add *EShopWorld-Home* pipeline link to the logo using ESW Checkout UI on the tenant side. Checkout logo cannot be configured using expansion pair in the pre-order request for both staging and production tenants.
* **General Enhancements and Bug Fixes:**

o You can now restrict a product for all countries except the domestic and non-ESW supported countries. This can be done by adding **ALL** option in product level attribute “List of countries where product is restricted” under ESW configurations.

o JS loader/ spinner functionality has been added. A loader/spinner will be displayed when a shopper clicks on Cart Page/Mini Cart "Checkout" button. This will be displayed until pre-order request completes and the shopper is either returned with ESW checkout URL or an error message. This will avoid any modifications to cart contents during the redirection to the ESW checkout.

* **Override shipping improvements for Headless:** A new "disableConversion" parameter has been added to determine whether or not we need to convert shipping cost for dynamic/calculated pricing model country. This is an optional parameter. If this parameter is added and is set to 'true', then ESW plugin will not convert the shipping cost of the override shipping method for the localized country.

#### Configuration/System Object enhancements <a href="#configuration-system-object-enhancements" id="configuration-system-object-enhancements"></a>

#### **SitePreference** <a href="#sitepreference" id="sitepreference"></a>

A new attribute called *eswEnableFrontendPricesConversion* is added to the 'ESW Pricing Configuration' group.

#### **Product** <a href="#product" id="product"></a>

The following product-level custom attribute is added:

* eswProductPriceFreezeCountries

#### **Order** <a href="#order" id="order"></a>

The following order-level custom attributes are added for the order cancellation feature.

* eswOrderCancellationReference
* eswOrderCancellationTimestamp
* eswOrderCancellationMessage
* eswOrderCancellationRetryCount
* eswOrderCancelledBy
* eswOrderCancelledByUser

#### **Job** <a href="#job" id="job"></a>

The following job synchronizes the status of the cancelled order between SFCC & ESW via the ESW Order API v2.0. Import job from `link_eshopworld\sitesdata\jobs.xml`

* eswRetailerOrderStatus

#### **Service** <a href="#service" id="service"></a>

The following services are added for order cancellation feature, can import services from `link_eshopworld\sitesdata\services.xml`

* EswOrderAPIV2Service

#### **Custom Object** <a href="#custom-object" id="custom-object"></a>

The following custom object has been added for order cancellation feature. This can import custom object metadata from `link_eshopworld\sitesdata\meta\ customobjects.xml`

* ESW Cancelled Orders

#### **Content Asset** <a href="#content-asset" id="content-asset"></a>

The *esw-checkout-disclaimer-message* content asset is added.

## Cartridge v2.9 <a href="#whats-new-in-v2.9" id="whats-new-in-v2.9"></a>

#### Features & Supported ESW Integrations <a href="#features-and-supported-esw-integrations" id="features-and-supported-esw-integrations"></a>

* **Global Product Returns Prohibition**: This feature uses the SFCC Business Manager configuration and it allows you to prohibit product returns in the selected or all delivery countries. When the feature is enabled, a message is displayed at the storefront informing shoppers that the product is non-returnable. An appropriate message is also displayed on the ESW Checkout page alongside the Product Line Item. When shoppers add a non-returnable product to their shopping cart and are redirected to the ESW Checkout, the 'isReturnProhibited' attribute is sent in the Checkout API payload. For more information on how this feature works, see [Global Product Returns Prohibition](https://team-1610122333754.atlassian.net/wiki/spaces/TDR/pages/1234636619).
* **Localized Promotions**: This feature allows you to generate multiple localized promotions automatically using the base promotions and FX rates from the ESW Pricing Advisor API. This feature can be used for the Fixed Price Pricing Model countries and it supports the 'With Amount of Qualifying Products', 'Amount Off', and 'Fixed Price' discount types.

#### Improvements <a href="#improvements" id="improvements"></a>

* **Error Handling and Exceptions**: Changes are made so that if the optional Business Manager configuration is missing, the ESW cartridge still runs smoothly.
* **ESW Catalog Feed Optimization**: The ESW Catalog Feed is optimized to allow different product types. The SFCC instance ID is now also added to the filename to differentiate catalog feeds.
* **Rounding**: A new site preference allowing you to enable or disable ESW Rounding is added. This preference allows you to control the product prices displayed at the storefront.
* **Promotions Compatibility for Headless OCAPI**: To improve the compatibility with the native SFCC promotion engine, the discount amount is now prorated on the ESW Checkout when the 'Buy X and Get Y Free' promotion is used.
* **Metadata Improvements for Headless OCAPI**: New ESW attributes are added at the Basket and Product Line Item level to support the Headless Integration. Changes are also made to the ESW URL Expansion Pairs parameter so that you can now use the site URL (HTTPS) with the **countryCode** parameter in ESW URL Expansion Pairs (Key|Value). The parameter is replaced with the shopper selected localized country code.
* **SFCC Staging Instance & ESW Production Pricing Advisor API**: You can now connect the SFCC Staging instance to the ESW Production Pricing Advisor API while using localized pricebooks. As a best practice, generate the pricebooks on the Staging instance and then replicate them to the Production instance.
* **Job Level Logging and Job Statuses**: Improvements are made to the job level logging. The job statuses are also updated as per the logs for all ESW SFCC jobs.
* **General Enhancements and Bug fixes**: General fixes are made to the Headless architecture to improve Promotions, Pricing, and OCAPI Responses.

#### Configuration/System Object Enhancements <a href="#configuration-system-object-enhancements" id="configuration-system-object-enhancements"></a>

The following attributes are added to support all three architectures:

#### SitePreference <a href="#sitepreference" id="sitepreference"></a>

* A new attribute called **eswEnableReturnProhibition** is added to the 'ESW General Configuration' group.
* A new attribute called **eswCatalogFeedInstanceID** is added to the 'ESW Catalog Integration Configuration' group.
* The following new attributes are added to the 'ESW Pricing Configuration' group.
  * eswLocalizedPromotions
  * eswEnableRoundings
  * eswPriceFeedInstance
  * eswProductionClientSecret

#### Product <a href="#product" id="product"></a>

A new attribute called **eswProductReturnProhibitedCountries** is added at the product level.

#### Content Asset <a href="#content-asset" id="content-asset"></a>

The **esw-display-return-prohibited-message** content asset is added.

#### Headless OCAPI <a href="#headless-ocapi" id="headless-ocapi"></a>

#### Basket <a href="#basket" id="basket"></a>

The following custom attributes are added at the basket level:

* eswSubTotal
* eswOrderDiscount

## Cartridge v2.8 <a href="#whats-new-in-v2.8" id="whats-new-in-v2.8"></a>

#### Features & Supported ESW Integrations <a href="#features-and-supported-esw-integrations" id="features-and-supported-esw-integrations"></a>

* **SFCC Headless OCAPI solution**: A new headless cartridge supporting the SFCC Headless OCAPI Architecture is introduced. The new cartridge includes pricing conversion on the Product Display Page (PDP), Product Listing Page (PLP), Content Listing Page (CLP), and Cart Page for both pricing models - Fixed and Dynamic/Calculated. The new cartridge also provides support for ESW Checkout redirection, Order Confirmation, and Promotions.
* **New changes to support the native SFCC Promotion Engine**: The ESW SFCC cartridge is enhanced to:
  * Convert the 'Amount Off' type promotional prices to shopper currency.
  * Exclude non-qualifying or third-party products when prorating the order discount amount.
  * Support the Buy One Get One (BOGO) promotions for the Fixed and Dynamic/Calculated pricing models.
* **Improvements in sending the order item pricing for seamless Returns experience**: When redirecting to the ESW Checkout or sending the data to the ESW Checkout API, the cartridge now distributes the prices of Free Products across other order items. This enhancement improves the returns process.
* **Performance improvements in SFRA dynamic pricing**: With the help of remote includes and caching strategies, the dynamic pricing conversion mechanism is improved to boost the performance on SFRA.
* **New custom attributes in SFCC Business Manager**: The two custom attributes called **ESW Shopper Currency Order Discount** and **ESW Retailer Currency Order Discount** are introduced at the order level. These attributes store the total order discount value in the shopper and retailer currencies respectively.
* **General enhancements and bug fixes**: If the ESW Checkout API response contains a region code in the shipping or billing address of the shopper, the cartridge now saves these details in Business Manager. Other changes include performance-related improvements, Checkout redirection improvements, and improvements in the price discrepancies on the Cart page. The new version of the cartridge also contains bug fixes related to promotions.

#### Configuration/System Object Enhancements <a href="#configuration-system-object-enhancements" id="configuration-system-object-enhancements"></a>

#### Site Genesis and SFRA <a href="#site-genesis-and-sfra" id="site-genesis-and-sfra"></a>

**Order**

The following attributes are added at the order level:

* eswShopperCurrencyOrderDiscount
* eswRetailerCurrencyOrderDiscount

#### Headless OCAPI <a href="#headless-ocapi" id="headless-ocapi"></a>

**SitePreferences**

A new site preference attribute group called **ESW Headless Integration Configuration** is added and the following attributes are added to this group:

* ESW Basket Pricing Mapping
* ESW Pricebook Keywords - Retailer Currencies/ Keywords

**ProductLineItem**

The following custom attributes are added at the product line item level:

* eswBasePrice
* eswPrice
* eswPriceAfterOrderDiscount
* eswRegularPrice
* eswSalePrice

**Basket**

The following custom attributes are added at the basket level:

* eswOrderTotal
* eswEstimatedCharges
* eswCartSubTotal
* eswTotalDiscount
* eswShopperCurrency

**Order**

The following attributes are added at the order level:

* eswDeliveryOptions
* eswShopperCurrencyOrderDiscount
* eswRetailerCurrencyOrderDiscount

## Cartridge v2.7 <a href="#whats-new-in-v2.7" id="whats-new-in-v2.7"></a>

#### Features & Supported ESW Integrations <a href="#features-and-supported-esw-integrations" id="features-and-supported-esw-integrations"></a>

* **Multiple FX rates per tenant**: This feature provides country-level control over pricing conversions, allowing retailers to set up multiple base/settlement currencies. Depending on the shopper or the billing country, the cartridge picks the base currency and applies the FX rate to it in order to convert the product price. For more information on this feature, see [Multiple FX Rates](https://team-1610122333754.atlassian.net/wiki/spaces/TDR/pages/1234635698).
* **New rounding target**: Along with exponent rounding (after the decimal point), the cartridge now also supports the whole number rounding (before the decimal point) for larger currencies.
* **Package 4.0 integration (ASN for Hub Model)**: This feature allows retailers to use the Hub model for ESW orders and sync the Retailer Package Information with the ESW Package service. The orders that are shipped from the retailer hub and have the tracking number in the shipment are sent to ESW as ASN (Advanced Shipping Notification). For more information on this feature, see [Package Integration](https://team-1610122333754.atlassian.net/wiki/spaces/TDR/pages/1234636478).
* **SFCC Business Manager - Order/Order Item Custom Attributes improvement**: For the improved user experience and readability, the Order/Order Items Custom Attributes are now separated into the retailer and shopper groups.
* **SFCC Business Manager - ESW Order Place FX Rate field improvements**: The value of the Order Custom Attribute (**ESW Order Place FX Rate**) is no longer saved if the fixed pricing model is in use for the country and the price book currency is similar to the shopper currency. This change is made because the FX rates are not used in such cases.
* **New 'Order level discount' order custom attribute**: The order level discount is now saved in a separate field called **ESW Retailer Currency Order Discount** in the retailer currency. This field allows retailers to pass the correct information to the ERP system downstream.
* **SFCC Business Manager - Faux email ID**: When shoppers, who are not logged in, navigate to the ESW Checkout, a unique faux email ID is created in the Business Manager order. This email ID is replaced with the real email address after the order is placed.
* **General enhancement and bug fixes**: Some general enhancements and bug fixes are implemented for Login ESW Redirect and the prices for fixed-price model countries when no FX rate exists.

#### Configuration/System Object Enhancements <a href="#configuration-system-object-enhancements" id="configuration-system-object-enhancements"></a>

**Site Preferences**

* A new site preference attribute group called 'ESW Package Integration Configuration' is added. This group contains a new attribute called **ESW Tracking URL**.
* A new attribute called **eswEnableMultipleFxRates** is added to the 'ESW Pricing Configuration' group.
* The new attribute called **eswRetailerBrandCode** is added to the 'ESW General Configuration' group.

**Services**

The following services and credentials are added:

* EswPackageV4Service
* EswPackageV4Credentials

**Jobs**

The 'eswRetailerPackageFeed' job is added.

#### Removed Items <a href="#removed-items" id="removed-items"></a>

The **eswCatalogFeedBrandCode** attribute is removed from the 'ESW Catalog Integration Configuration' group.

## Cartridge v2.6 <a href="#whats-new-in-v2.6" id="whats-new-in-v2.6"></a>

#### Features & Supported ESW Integrations <a href="#features-and-supported-esw-integrations" id="features-and-supported-esw-integrations"></a>

* **New SFRA version**: The cartridge now supports Salesforce Reference Architecture v5.0.1.
* **Localized and hybrid pricing** : This feature allows retailers to spin up pricebooks using FX rates, uplifts, duties, taxes, and rounding rules from the ESW Pricing Advisor. As the final product prices are available in Local Shopper Pricebooks, retailers can now send product feed to external marketplaces and offer more shipping.
* **Catalog 2.0 integration**: This feature syncs the retailer catalog automatically to the ESW Catalog service. To automate the manual transition of catalogs from the retailer to ESW, the cartridge introduces a new SFCC job that enables this functionality.
* **SFRA account order history improvements**: The cartridge now correctly displays the product, shipping, and total prices of orders with and without promotions.
* **SiteGenesis order history support**: The cartridge now supports SiteGenesis account order history and displays orders with correct shopper prices and currency selected while placing the order.
* **Shipping functionality improvements**: The shipping method, shipping cost, and shipping discounts are now correctly displayed in the shopping cart, checkout, and account order history.
* **Country, Currency, and Language selector improvements**: New improved selectors are introduced with popup dialog functionality instead of the list dropdown.
* **Countries.json dependency**: New custom site preference is introduced as a replacement for countries.JSON. This custom site preference reduces the code complexity and improves the code readability. An easier option for retailers for one-to-one default country currency mapping.
* **Other improvements**: General enhancements are made to Order History as well as Discounts & Promotions. Performance improvements are made to ensure faster page load. In addition, jobs are updated with steptypes.json as per the new SFCC standards.

#### Configuration/System Object Enhancements <a href="#configuration-system-object-enhancements" id="configuration-system-object-enhancements"></a>

**Site Preferences**

* The sitepreference attribute groups are renamed as outlined in the following table:

| **Old name**                              | **New name**                       |
| ----------------------------------------- | ---------------------------------- |
| eShopWorld Configuration General          | ESW General Configuration          |
| eShopWorld Configuration Retailer Display | ESW Retailer Display Configuration |
| eShopWorld Configuration Pricing          | ESW Pricing Configuration          |
| eShopWorld Configuration Checkout         | ESW Checkout Configuration         |

* A new sitepreference attribute group called 'ESW Catalog Integration Configuration' is added with the following attributes:
  * ESW Catalog Feed Brand Code
  * ESW Catalog Feed Local Path
  * ESW Catalog Feed Remote Path
  * ESW Catalog Feed SFTP Service Name
  * ESW Catalog Feed Pricebook ID
  * ESW Catalog Feed Product Custom Fields Mapping
  * ESW Catalog Feed Last Executed On
* A new attribute called 'eswLocalizedPricingCountries' is added to the ESW Pricing Configuration group.
* A new attribute called 'eswDefaultCountryCurrencyMapping' is added to the ESW General Configuration group.

**Services**

The following services, profile, and credentials are added:

* ESWSFTP
* ESWSFTPProfile
* ESWSFTPCredentials

**Jobs**

The 'eswRetailerCatalogFeed' and 'eswRetailerLocalizedPricing' jobs are added.

#### Removed Items <a href="#removed-items" id="removed-items"></a>

* The 'eswAllowedCountries' attribute is removed from the ESW General Configuration group.
* The following attributes are removed from the ESW Retailer Display Configuration group:
  * eswEnableCountryHeaderbar
  * eswEnableCurrencyHeaderbar
  * eswEnableLanguageHeaderbar
  * eswEnableCountryFooterbar
  * eswEnableCurrencyFooterbar
  * eswEnableLanguageFooterbar

## Cartridge v2.5 <a href="#whats-new-in-v2.5" id="whats-new-in-v2.5"></a>

#### Features & Supported ESW Integrations <a href="#features-and-supported-esw-integrations" id="features-and-supported-esw-integrations"></a>

* **Multi-tenant configuration on a single SFCC instance**: The cartridge now allows you to configure multiple tenants on a single SFCC instance.
* **Pricing Advisor V3**: The Pricing Advisor API version is upgraded from v2 to v3.
* **Delta Rounding Values**: This feature provides visibility on the rounding values that are applied to the order product line item.
* **Support for the eShopWorld Shipping Methods**: The cartridge allows you to use the eShopWorld shipping methods on the checkout, instead of configuring and maintaining various shipping methods within the SFCC Business Manager. You can also now apply the SFCC Free Shipping promotions to the eShopWorld shipping methods. For more information on this feature, click [here](https://team-1610122333754.atlassian.net/wiki/spaces/TDR/pages/1234635958).
* **Improved currency selection for country configuration**: The currency that is configured as Default is now selected automatically when the country is selected or changed. The current implementation works regardless of whether the currency selector is enabled or disabled.
* **Support for the other sites on the single sandbox when the ESW module is disabled**: The disabled module does not impact the current site or other sites on the same sandbox.

Order History support for SiteGenesis will be implemented in a future release.

* **Support for the native checkout**: Shoppers will now be redirected to their shopping cart from the native Checkout if an ESW supported country is selected at the native checkout.
* **Improved Product Restriction support:** The restricted product is now highlighted in the shopping cart when a shopper tries to proceed to the checkout. For more information on this feature, click [here](https://team-1610122333754.atlassian.net/wiki/spaces/TDR/pages/1234636577).
* **Support for the Product Line Metadata Items**: Attributes, such as loyalty points, engraving, debossing, gift message, and so on can now be sent to the eShopWorld Checkout API using the 'ESW Product Line Metadata Items' custom site preference. For more information on this feature, click [here](https://team-1610122333754.atlassian.net/wiki/spaces/TDR/pages/1234637137/Copy+of+Merchant+Tools#ESW-Checkout-Configuration).
* **Other improvements** : General enhancements, bug fixes, and improvement are made to the Order History, Promotions and Coupons, Cart Prices, and SFRA Price Caching areas.

#### Configuration/System Object Enhancements <a href="#configuration-system-object-enhancements" id="configuration-system-object-enhancements"></a>

**ProductLineItem**

* The **eswDeltaRoundingValue** product-level custom attribute is added.

**Order**

* The **eswFxrateOc** product-level custom attribute is added.
* The **eswFxrate** attribute is renamed from **ESW FX Rate** to **ESW Order Place FX Rate**.

**Site Preferences**

* The **eswCheckoutServiceName** attribute is added to the 'eShopWorld Configuration Checkout' group.
* The **eswProductLineMetadataItems** attribute is added to the 'eShopWorld Configuration Checkout' group.
* The **eswUseDeliveryContactDetailsForPaymentContactDetails** attribute is added to the 'eShopWorld Configuration Checkout' group.
* The **eswPricingSynchronizationId** is added to the 'eShopWorld Configuration Pricing' group.
* The **eswDay** attribute is renamed from **ESW Day on which we receive different FX Group ID** to **ESW Price Feed Last Updated on**.

**Services**

The following services and credentials are added:

* EswCheckoutV2Service.SG
* EswCheckoutV2Service.SFRA
* EswPriceFeedV3Service
* EswCheckoutV2Credentials.SG
* EswCheckoutV2Credentials.SFRA
* EswPriceFeedV3Credentials

#### Removed Items <a href="#removed-items" id="removed-items"></a>

**Services**

The following services and credentials are removed:

* EswPreorderV2Service
* EswPriceFeedV2Service
* EswPreOrderV2Credentials
* EswPriceFeedV2Credentials

## Cartridge v2.4 <a href="#whats-new-in-v2.4" id="whats-new-in-v2.4"></a>

#### Features & Supported ESW Integrations <a href="#features-and-supported-esw-integrations" id="features-and-supported-esw-integrations"></a>

* **SFRA version**: The cartridge now supports Salesforce Reference Architecture v4.3.0.
* **Global restriction management**: You can now control product restrictions for specific countries using native SFCC Business Manager controls.
* **Support for the Fixed price model countries**: Support is added for the Fixed Price model countries. The cartridge now functions even if the data for the FX rates, country adjustments/uplifts, and rounding rules is unavailable.
* **Currency selectors**: You can now remove the currency selectors from the welcome mat as well as the header and footer widgets without impacting the overall functionality of the cartridge. You can also assign a default country currency in the background. For example, if the shopper selects the UK, the cartridge automatically assigns GBP as the currency.
* **Support for eShopWorld non-supported countries**: The cartridge now supports eShopWorld non-supported countries. The SFCC standard cart, checkout, and order history page will now load for the eShopWorld non-supported countries.
* **Order payment status**: After a successful order confirmation call, the cartridge now updates the order payment status to **Paid** in the Business Manager.
* **Sandbox/Production switcher**: The cartridge now offers Sandbox and Production modes. In the Production mode, the metaDataItem test fields,

  `OrderConfirmationBase64EncodedAuth_TestOnly`

  and `OrderConfirmationUri_TestOnly` are not passed in the preorder checkout request to eShopWorld.

#### Configuration/System Object Enhancements <a href="#configuration-system-object-enhancements" id="configuration-system-object-enhancements"></a>

**Product**

* The **eswProductRestrictedCountries** product-level custom attribute is added.
* The **ESW Configurations** attribute group is added.

**SitePreference**

* The sitepreference attribute group **eShopWorld Configuration PreOrder** is renamed to **eShopWorld Configuration Checkout**.
* The sitepreference attribute group is also rearranged in the following order:

| Old Sequence                              | New Sequence                              |
| ----------------------------------------- | ----------------------------------------- |
| eShopWorld Configuration General          | eShopWorld Configuration General          |
| eShopWorld Configuration PreOrder         | eShopWorld Configuration Retailer Display |
| eShopWorld Configuration Pricing          | eShopWorld Configuration Pricing          |
| eShopWorld Configuration Retailer Display | eShopWorld Configuration Checkout         |

* The following client configurations are moved from the Checkout (PreOrder) attribute group to General:
  * eswClientID
  * eswClientSecret
  * eswBasicAuthEnabled
  * eswBasicAuthUser
  * eswBasicAuthPassword
* A new attribute called **eswInstance** is added to **eShopWorld Configuration General**.
* A new attribute called **eswUpdateOrderPaymentStatusToPaid** is added to **eShopWorld Configuration Checkout**.

#### Removed Items <a href="#removed-items" id="removed-items"></a>

**Site preferences**

The **eswExp2EnabledCountries** and **eswPostEnabledCountries** custom site preferences are removed from the **eShopWorld Configuration Checkout** attribute group. These site preferences are removed in addition to all site preferences related to v1.0 of the eShopWorld Checkout, Order Confirmation, and Pricing Advisor as stated in v2.3.2 release notes:

## Cartridge v2.3.2 <a href="#whats-new-in-v2.3.2" id="whats-new-in-v2.3.2"></a>

#### **Support for the new ESW solutions** <a href="#support-for-the-new-esw-solutions" id="support-for-the-new-esw-solutions"></a>

The SFCC-ESW cartridge v2.3.2 only supports ESW Checkout v2.0, Order\
Confirmation v2.0, and Pricing Advisor 2.0. The new version no longer supports Checkout v1.0,\
Order Confirmation v1.0, and Pricing Advisor v1.0.

#### **Configuration/System Object enhancements** <a href="#configuration-system-object-enhancements" id="configuration-system-object-enhancements"></a>

**Order**

* The eswEmailMarketingOptIn and eswDeliveryOption order-level attributes are added.
* The eswV2 attribute group is updated.
* The following system object attributes are renamed:

| **Old ID**                      | **New ID**                           |
| ------------------------------- | ------------------------------------ |
| eswAdministration               | eswShopperCurrencyAdministration     |
| eswAdministrationBaseCurrency   | eswRetailerCurrencyAdministration    |
| eswBaseCurrencyCode             | eswRetailerCurrencyCode              |
| eswDuty                         | eswShopperCurrencyDuty               |
| eswDutyBaseCurrency             | eswRetailerCurrencyDuty              |
| eswOrderTotal                   | eswShopperCurrencyTotal              |
| eswOrderTotalBaseCurrency       | eswRetailerCurrencyTotal             |
| eswOtherTaxes                   | eswShopperCurrencyOtherTaxes         |
| eswOtherTaxesBaseCurrency       | eswRetailerCurrencyOtherTaxes        |
| eswPaymentAmountBaseCurrency    | eswRetailerCurrencyPaymentAmount     |
| eswPaymentAmountBillingCurrency | eswShopperCurrencyPaymentAmount      |
| eswPaymentCurrencyCode          | eswShopperCurrencyCode               |
| eswShipping                     | eswShopperCurrencyDelivery           |
| eswShippingBaseCurrency         | eswRetailerCurrencyDelivery          |
| eswShippingDuty                 | eswShopperCurrencyDeliveryDuty       |
| eswShippingDutyBaseCurrency     | eswRetailerCurrencyDeliveryDuty      |
| eswShippingTaxes                | eswShopperCurrencyDeliveryTaxes      |
| eswShippingTaxesBaseCurrency    | eswRetailerCurrencyDeliveryTaxes     |
| eswShippingTotalBaseCurrency    | eswRetailerCurrencyDeliveryPriceInfo |
| eswShippingTotalBillingCurrency | eswShopperCurrencyDeliveryPriceInfo  |
| eswTaxes                        | eswShopperCurrencyTaxes              |
| eswTaxesBaseCurrency            | eswRetailerCurrencyTaxes             |
| eswUplift                       | eswShopperCurrencyUplift             |
| eswUpliftBaseCurrency           | eswRetailerCurrencyUplift            |

**Product/Order Line Item**

* The eswNewConfirmation attribute group is updated.
* The following product/order line item attributes are renamed:

| **Old ID**                       | **New ID**                        |
| -------------------------------- | --------------------------------- |
| eswAdministrationBaseCurrency    | eswAdministrationRetailerCurrency |
| eswAdministrationBillingCurrency | eswAdministrationShopperCurrency  |
| eswBasePriceBeforeDiscount       | eswRetailerPriceBeforeDiscount    |
| eswDutyBaseCurrency              | eswDutyRetailerCurrency           |
| eswDutyBillingCurrency           | eswDutyShopperCurrency            |
| eswOtherTaxesBaseCurrency        | eswOtherTaxesRetailerCurrency     |
| eswOtherTaxesBillingCurrency     | eswOtherTaxesShopperCurrency      |
| eswPriceBeforeDiscount           | eswShopperPriceBeforeDiscount     |
| eswProductBasePrice              | eswItemRetailerPrice              |
| eswProductBaseTotal              | eswItemRetailerTotal              |
| eswProductBillingPrice           | eswItemShopperPrice               |
| eswProductBillingTotal           | eswItemShopperTotal               |
| eswShippingBaseCurrency          | eswShippingRetailCurrency         |
| eswShippingBillingCurrency       | eswShippingShopperCurrency        |
| eswShippingDutyBaseCurrency      | eswShippingDutyRetailerCurrency   |
| eswShippingDutyBillingCurrency   | eswShippingDutyShopperCurrency    |
| eswShippingTaxesBaseCurrency     | eswShippingTaxesRetailerCurrency  |
| eswShippingTaxesBillingCurrency  | eswShippingTaxesShopperCurrency   |
| eswUpliftBaseCurrency            | eswUpliftRetailerCurrency         |
| eswUpliftBillingCurrency         | eswUpliftShopperCurrency          |
| eswVatBaseCurrency               | eswVatRetailerCurrency            |
| eswVatBillingCurrency            | eswVatShopperCurrency             |

#### Removed Items <a href="#removed-items" id="removed-items"></a>

A removed item indicates a feature, component, or service that was considered obsolete and\
has been removed from the cartridge in this release.

#### **Code references** <a href="#code-references" id="code-references"></a>

All code references to the ESW Checkout v1.0, Order Confirmation v1.0, and Pricing\
Advisor v1.0 are removed.

#### **Site preferences** <a href="#site-preferences" id="site-preferences"></a>

The following site preferences are removed, in addition to all site preferences related to v1.0 of\
the ESW Checkout, Order Confirmation, and Pricing Advisor:

| EswVersion                 | eswGiftMessage              |
| -------------------------- | --------------------------- |
| baseCartridge              | eswGiftWrapped              |
| eswApiBaseurl              | eswIsPersonalised           |
| eswBrandCode               | eswIsReturnProhibited       |
| eswBrandID                 | eswMonogramColor            |
| eswCatalogCode             | eswOverrideCountrySetting   |
| eswColorCode               | eswPricingGroupID           |
| eswColorDescription        | eswSecondarySubscriptionKey |
| eswEnableAddressValidation | eswSendFxrateGroupid        |
| eswEnablePricingValidation | eswSendPricingGroupid       |
| eswExtensionVersion        | eswSizeCode                 |
| eswFxEnabledCountries      | eswStyleCode                |
| eswFxGroupId               | eswSubscriptionKey          |
| eswFxPriceFeed             |                             |

#### **Services** <a href="#services" id="services"></a>

The following services are removed:

| EswCancellationService | EswCancellationCredentials |
| ---------------------- | -------------------------- |
| EswPreorderService     | EswPreorderCredentials     |
| EswPriceFeedService    | EswServiceCredentials      |

#### **Configuration/System Object changes** <a href="#configuration-system-object-changes" id="configuration-system-object-changes"></a>

**Order**

* The eswExpansionNameValues, eswFxRateId, and eswFxrateId order-level attributes are removed.
* The Custom attribute group is removed.

**Product/Order Line Item**

* The eswDuty, eswTaxes, eswTotalPrice, and eswUplift order item level attributes are removed.
* The esw\_Custom attribute group is removed.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://developer.esw.com/salesforce-commerce-cloud/sfcc-release-notes/whats-new.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.