FD-2501

Release Date: 2025-02-07

Software Version

The document refers to the following applications and corresponding software versions:

Application Version
Basket Client SDK 2.12.0
Basket Service 3.13.0
Item Registration Service 3.13.0
Checkout Service 2.27.0
Basket Finalization Service 1.27.0
Basket Event Bridge Service 1.24.0
Basket Notification Service 1.24.0
Offer Registration Service 1.13.0

What's New - Basket Service

Recalculation - Limit in PCE Call for Generic Attributes

A new configuration parameter, itemLevelGenericAttributeLimit, has been introduced and mapped to the PCE recalculation request.

Generic attributes are key-value pairs that define item-related (e.g., color, brand) or transaction-related (e.g., 100th buyer of the day) characteristics used to trigger promotions dynamically.

In a multi-tenant environment, where customer-specific extensions are limited, this feature ensures efficient processing by restricting the volume of item-level generic attributes in recalculations while maintaining the flexibility needed for defining promotion triggers.

Issue Key Summary Change Description
POCP-74423 Introduced itemLevelGenericAttributeLimit to control the number of item-level generic attributes in PCE recalculation requests, improving performance and flexibility in defining promotion triggers.
  1. New Configuration Parameter: itemLevelGenericAttributeLimit
  2. Functionality: Limits the number of item-level generic attributes sent in the PCE recalculation request.
  3. Purpose: Enhances performance and ensures controlled handling of generic attributes in a multi-tenant environment.
  4. Impact: Provides a structured way to manage dynamic promotion triggers based on item and transaction characteristics.

Resolved Issues

Issue Key Summary Change Description
POCP-74839 Update Domain Models Updated domain objects for transaction, PosUomItem and promotion. Integrated the same changes done in POS/SDC.

What's New - Item Registration Service

Load Generic Attribute Metadata and Map Values from Item to Line Item

During item registration, generic attribute metadata is loaded from SDC, and values are extracted from the corresponding item fields. These values are then mapped to the line item in SaleReturnLineItemGenericAttribute. The metadata is cached for improved performance.

Since the extraction logic for generic attribute values is not remotely accessible, it has been re-implemented in the Item Registration Service. The definitionId follows a structured format using _ to locate the relevant field in the item structure.

Issue Key Summary Change Description
POCP-74373 Implemented loading and caching of generic attribute metadata from SDC, mapping item values to line items in SaleReturnLineItemGenericAttribute, and re-implemented extraction logic in Item Registration Service.
  1. Generic Attribute Metadata Loading: Metadata is fetched from SDC and cached.
  2. Value Mapping: Extracts values from item fields and maps them to SaleReturnLineItemGenericAttribute.
  3. Re-implemented Extraction Logic: Since the logic is not remotely accessible, it has been implemented again in Item Registration Service.
  4. Structured Definition ID: Uses _ to locate fields in the item structure based on SDC conventions

Resolved Issues

This release contains no new features.

What's New - Checkout Service

This release contains no new features.

Resolved Issues

Issue Key Summary Change Description
POCP-61067 Dependencies update Updated:
  1. Basket Service API v3.9.0
  2. Basket DO Model v3.8.0
  3. Offer API v1.2.0

What's New - Basket Event Bridge Service

This release contains no new features.

Resolved Issues

Issue Key Summary Change Description
POCP-74839 Update Domain Models Updated domain objects for transaction, PosUomItem and promotion. Integrated the same changes done in POS/SDC.
POCP-61067 Dependencies update Updated:
  1. Basket Service API v3.9.0
  2. Basket DO Model v3.8.0
  3. Offer API v1.2.0

What's New - Basket Notification Service

This release contains no new features.

Resolved Issues

Issue Key Summary Change Description
POCP-74839 Update Domain Models Updated domain objects for transaction, PosUomItem and promotion. Integrated the same changes done in POS/SDC.
POCP-61067 Dependencies update Updated:
  1. Basket Service API v3.9.0
  2. Basket DO Model v3.8.0
  3. Offer API v1.2.0

What's New - Basket Finalization Service

This release contains no new features.

Resolved Issues

Issue Key Summary Change Description
POCP-74839 Update Domain Models Updated domain objects for transaction, PosUomItem and promotion. Integrated the same changes done in POS/SDC.
POCP-61067 Dependencies update Updated:
  1. Basket Service API v3.9.0
  2. Basket DO Model v3.8.0

What's New - Offer Registration Service

This release contains no new features.

Resolved Issues

Issue Key Summary Change Description
POCP-74839 Update Domain Models Updated domain objects for transaction, PosUomItem and promotion. Integrated the same changes done in POS/SDC.
POCP-61067 Dependencies update Updated:
  1. Basket Service API v3.9.0
  2. Basket DO Model v3.8.0
  3. Offer API v1.2.0

What's New - Basket Client SDK

Kotlin 2.1.0

This update introduces Kotlin 2.1.0 into the project, enabling the use of the latest features, improved performance, and enhanced compatibility. Kotlin 2.1.0 brings:

  • Language Enhancements: New language constructs and refined syntax to improve developer productivity.
  • Performance Boosts: Optimizations in the compiler and runtime, resulting in faster build times and better runtime performance.
  • Improved Tooling: Enhanced IDE support and debugging tools, offering a smoother development experience.
  • Library Compatibility: Compatibility with the latest versions of libraries and frameworks for seamless integration.

By upgrading to Kotlin 2.1.0, the project stays aligned with modern development practices and takes advantage of the ecosystem's continued growth. Developers are encouraged to explore the new features and integrate them into the project where beneficial.

Load Generic Attribute Metadata and Map Values from Item to Line Item

During item registration, generic attribute metadata is loaded from SDC, and values are extracted from the corresponding item fields. These values are then mapped to the line item in SaleReturnLineItemGenericAttribute. The metadata is cached for improved performance.

Since the extraction logic for generic attribute values is not remotely accessible, it has been re-implemented in the Item Registration Service. The definitionId follows a structured format using _ to locate the relevant field in the item structure.

Issue Key Summary Change Description
POCP-71917 Updated the project to Kotlin 2.1.0 to leverage the latest language features, performance improvements, and bug fixes.
  1. Upgraded the Kotlin compiler and runtime to version 2.1.0.
  2. Adopted new Kotlin 2.1.0 language features where applicable.
  3. Ensured compatibility across all platforms in the project.
  4. Updated dependencies and tools to align with Kotlin 2.1.0 requirements.
  5. Improved code quality and performance by utilizing compiler enhancements.
POCP-74373 Implemented loading and caching of generic attribute metadata from SDC, mapping item values to line items in SaleReturnLineItemGenericAttribute, and re-implemented extraction logic in Item Registration Service.
  1. Generic Attribute Metadata Loading: Metadata is fetched from SDC and cached.
  2. Value Mapping: Extracts values from item fields and maps them to SaleReturnLineItemGenericAttribute.
  3. Re-implemented Extraction Logic: Since the logic is not remotely accessible, it has been implemented again in Item Registration Service.
  4. Structured Definition ID: Uses _ to locate fields in the item structure based on SDC conventions

Resolved Issues

Issue Key Summary Change Description
POCP-74839 Update Domain Models Updated domain objects for transaction, PosUomItem and promotion. Integrated the same changes done in POS/SDC.
POCP-61067 Dependencies update Updated:
  1. Basket Engine v4.12.0
  2. Basket DO Model v3.8.0
  3. Item Registration Engine v4.10.0
  4. Basket Service Client REST API v2.10.0
  5. Offer Service Client REST API v1.6.0