Version 24.11.0

Update Notice

The FirstSpirit Connect for Commerce integration is a bundle of software components. The table below lists all components and their versions.

Components
This release contains the following components.
Versions marked with an arrow (⬆) changed since the last release.

Components Version

FirstSpirit Connect for Commerce (fsm)

3.15.3 ⬆

Reference project

1.8.0

FirstSpirit Connect for Commerce - Bridge API

3.3.1 ⬆

Bridge Commons

2.4.2 ⬆

Frontend Extension

1.1.4

Frontend API Showcase

1.3.0

Frontend API Backend

2.6.5

Frontend API

NPM Package Version

fcecom-frontend-api-client

1.3.0

fcecom-frontend-api-server

1.3.0

Reference Implementations
The following Artifacts won’t be maintained

Reference Implementation Version

fcecom-b2c-commerce-react-preview

1.1.0

cfc-spryker-content

1.0.2

cfc-spryker-reference-components

1.0.0

Reference-Bridge-Implementations

Bridge Version

BigCommerce-Bridge

2.5.4 ⬆

SAP Commerce Cloud-Bridge

2.6.2 ⬆

Spryker Commerce OS-Bridge

2.5.4 ⬆

Salesforce Commerce Cloud-Bridge

2.5.5 ⬆

General information
This release was tested with the following versions:

Product Version

FirstSpirit server

2024-11 (5.2.241211)

Java

17

CaaS Connect (FSM)

3.68.0

Omnichannel Manager

3.0.0

Basic Workflows

1.4.1

Deprecations

Artifact Functionality Deprecated with Removed in

Important notices

No important notices available for this release.

Fixed issues

ID Description

FCECOM-959

FirstSpirit Connect for Commerce - Bridge API, Bridge Commons, all Bridges | Bridge API documentation was updated and all bridges now include the x-total header for categories/tree and all ids endpoints.

FCECOM-919

FirstSpirit Connect for Commerce (fsm) | The logging caused by a missing project component has been reduced.

Version 24.10.1

Update Notice

The FirstSpirit Connect for Commerce integration is a bundle of software components. The table below lists all components and their versions.

Components
This release contains the following components.
Versions marked with an arrow (⬆) changed since the last release.

Components Version

FirstSpirit Connect for Commerce (fsm)

3.15.2 ⬆

Reference project

1.8.0

FirstSpirit Connect for Commerce - Bridge API

3.3.0

Bridge Commons

2.4.1 ⬆

Frontend Extension

1.1.4

Frontend API Showcase

1.3.0 ⬆

Frontend API Backend

2.6.5 ⬆

Frontend API

NPM Package Version

fcecom-frontend-api-client

1.3.0 ⬆

fcecom-frontend-api-server

1.3.0 ⬆

Reference Implementations
The following Artifacts won’t be maintained

Reference Implementation Version

fcecom-b2c-commerce-react-preview

1.1.0 ⬆

cfc-spryker-content

1.0.2

cfc-spryker-reference-components

1.0.0

Reference-Bridge-Implementations

Bridge Version

BigCommerce-Bridge

2.5.3 ⬆

SAP Commerce Cloud-Bridge

2.6.1 ⬆

Spryker Commerce OS-Bridge

2.5.3 ⬆

Salesforce Commerce Cloud-Bridge

2.5.4 ⬆

General information
This release was tested with the following versions:

Product Version

FirstSpirit server

2024-11 (5.2.241107)

Java

17

CaaS Connect (FSM)

3.66.1

Omnichannel Manager

3.0.0

Basic Workflows

1.4.1

Deprecations

Artifact Functionality Deprecated with Removed in

Important notices

No important notices available for this release.

Fixed issues

ID Description

FCECOM-947

FirstSpirit Connect for Commerce (fsm) | A problem in the handling of categories and products with the same ID has been fixed.

FCECOM-942

Bridge Commons, Frontend API Backend, All Bridges, fcecom-frontend-api-client, fcecom-frontend-api-server, fcecom-b2c-commerce-react-preview | Fixed security vulnerabilities by updating the relevant dependencies.

FCECOM-939

fcecom-frontend-api-client | Fixed a bug where onRerenderView events were not handled.

New features

ID Description

FCECOM-933

FirstSpirit Connect for Commerce (fsm) | Applied consistent formatting across all files.

FCECOM-929

fcecom-frontend-api-client, fcecom-frontend-api-server, Frontend API Showcase | Added the ability to fetch project properties directly through the Frontend API.

FCECOM-916

Frontend API Backend | Added information on best practices for the use of API keys.

Version 24.10.0

Update Notice

The FirstSpirit Connect for Commerce integration is a bundle of software components. The table below lists all components and their versions.

Components
This release contains the following components.
Versions marked with an arrow (⬆) changed since the last release.

Components Version

FirstSpirit Connect for Commerce (fsm)

3.15.0 ⬆

Reference project

1.8.0

FirstSpirit Connect for Commerce - Bridge API

3.3.0

Bridge Commons

2.4.0

Frontend Extension

1.1.4

Frontend API Showcase

1.1.0

Frontend API Backend

2.6.1

Frontend API

NPM Package Version

fcecom-frontend-api-client

1.1.0

fcecom-frontend-api-server

1.1.0

Reference Implementations
The following Artifacts won’t be maintained

Reference Implementation Version

fcecom-b2c-commerce-react-preview

1.0.2

cfc-spryker-content

1.0.2

cfc-spryker-reference-components

1.0.0

Reference-Bridge-Implementations

Bridge Version

Mock-o-Merce-Bridge

2.5.2

BigCommerce-Bridge

2.5.2

SAP Commerce Cloud-Bridge

2.6.0

Spryker Commerce OS-Bridge

2.5.2

Salesforce Commerce Cloud-Bridge

2.5.3

General information
This release was tested with the following versions:

Product Version

FirstSpirit server

2024-10 (5.2.241008)

Java

17

CaaS Connect (FSM)

3.66.0

Omnichannel Manager

3.0.0

Basic Workflows

1.4.0

Deprecations

Artifact Functionality Deprecated with Removed in

Important notices

No important notices available for this release.

Fixed issues

ID Description

FCECOM-941

FirstSpirit Connect for Commerce (fsm) | Error handling has been improved to handle an exception that occurred when the ID form field for a page was missing.

FCECOM-937

FirstSpirit Connect for Commerce (fsm) | Fixed an incorrect return value when retrieving multiple products or categories.

New features

ID Description

FCECOM-923

FirstSpirit Connect for Commerce (fsm) | Added a new automated test connection feature, accessible via an executable.

Version 24.9.1

Update Notice

The FirstSpirit Connect for Commerce integration is a bundle of software components. The table below lists all components and their versions.

Components
This release contains the following components.
Versions marked with an arrow (⬆) changed since the last release.

Components Version

FirstSpirit Connect for Commerce (fsm)

3.14.0 ⬆

Reference project

1.8.0

FirstSpirit Connect for Commerce - Bridge API

3.3.0

Bridge Commons

2.4.0

Frontend Extension

1.1.4

Frontend API Showcase

1.1.0

Frontend API Backend

2.6.1

Frontend API

NPM Package Version

fcecom-frontend-api-client

1.1.0

fcecom-frontend-api-server

1.1.0

Reference Implementations
The following Artifacts won’t be maintained

Reference Implementation Version

fcecom-b2c-commerce-react-preview

1.0.2

cfc-spryker-content

1.0.2

cfc-spryker-reference-components

1.0.0

Reference-Bridge-Implementations

Bridge Version

Mock-o-Merce-Bridge

2.5.2

BigCommerce-Bridge

2.5.2

SAP Commerce Cloud-Bridge

2.6.0

Spryker Commerce OS-Bridge

2.5.2

Salesforce Commerce Cloud-Bridge

2.5.3

General information
This release was tested with the following versions:

Product Version

FirstSpirit server

2024-10 (5.2.241008)

Java

17

CaaS Connect (FSM)

3.66.0

Omnichannel Manager

3.0.0

Basic Workflows

1.4.0

Deprecations

Artifact Functionality Deprecated with Removed in

Important notices

No important notices available for this release.

New features

ID Description

FCECOM-913

FirstSpirit Connect for Commerce (fsm) | Streamlined EcomConnectScope object creation by utilizing static create method.

FCECOM-681

Documentation | Removed unsed error codes from documenation.

Version 24.9.0

Highlights

FCECOM-805 - The FSM now sends a new header containing the project uuid.
With the latest update, Connect for Commerce FSM now includes the new FS-Project-UUID header. This allows a bridge to be used across multiple projects within the same implementation.

Update Notice

The FirstSpirit Connect for Commerce integration is a bundle of software components. The table below lists all components and their versions.

Components
This release contains the following components.
Versions marked with an arrow (⬆) changed since the last release.

Components Version

FirstSpirit Connect for Commerce (fsm)

3.13.0 ⬆

Reference project

1.8.0 ⬆

FirstSpirit Connect for Commerce - Bridge API

3.3.0 ⬆

Bridge Commons

2.4.0 ⬆

Frontend Extension

1.1.4

Frontend API Showcase

1.1.0

Frontend API Backend

2.6.1

Frontend API

NPM Package Version

fcecom-frontend-api-client

1.1.0

fcecom-frontend-api-server

1.1.0

Reference Implementations
The following Artifacts won’t be maintained

Reference Implementation Version

fcecom-b2c-commerce-react-preview

1.0.2

cfc-spryker-content

1.0.2

cfc-spryker-reference-components

1.0.0

Reference-Bridge-Implementations

Bridge Version

Mock-o-Merce-Bridge

2.5.2 ⬆

BigCommerce-Bridge

2.5.2 ⬆

SAP Commerce Cloud-Bridge

2.6.0 ⬆

Spryker Commerce OS-Bridge

2.5.2 ⬆

Salesforce Commerce Cloud-Bridge

2.5.3 ⬆

General information
This release was tested with the following versions:

Product Version

FirstSpirit server

2024-09 (5.2.240907)

Java

17

CaaS Connect (FSM)

3.64.5

Omnichannel Manager

3.0.0

Basic Workflows

1.4.0

Deprecations

Artifact Functionality Deprecated with Removed in

Important notices

No important notices available for this release.

FCECOM-925 - Added possibility to use different base urls for the categories/products and content pages requests
Instead of BASE_URL the environment variables OCC_BASE_URL and CMS_BASE_URL are expected now. This requires changes in your .env file.

Fixed issues

ID Description

FCECOM-932

FirstSpirit Connect for Commerce (fsm) | Fixed a bug that prevented the reports to be shown inside the SiteArchitect.

FCECOM-911

Bridge Commons | Updated dependencies to fix an error with the category tree in the Swagger UI (/docs).

FCECOM-910

All Bridges, Bridge Commons | Fixed security vulnerabilities located in axios (CVE-2024-39338), braces (CVE-2024-4068) and micromatch (CVE-2024-4067) by updating the relevant dependencies.

FCECOM-732

FirstSpirit Connect for Commerce (fsm) | Fixed a problem causing the category tree filter to not update when the UI language was changed.

New features

ID Description

FCECOM-926

FirstSpirit Connect for Commerce (fsm) | Added javadoc to EcomElement class.

FCECOM-925

SAP Commerce Cloud-Bridge | Added possibility to use different base urls for the categories/products and content pages requests.

FCECOM-889

FirstSpirit Connect for Commerce (fsm), Reference project | Added an executable to add AI generated keywords to product pages. Added example script to the reference project.

FCECOM-881

FirstSpirit Connect for Commerce (fsm) | Improved automatic creation of CaaS indices.

FCECOM-805

FirstSpirit Connect for Commerce (fsm), Bridge Commons, All Bridges | The FSM now sends a new header containing the project uuid.

FCECOM-777

Bridge Commons, All Bridges | Minor changes to comply with new ESLint rules.

FCECOM-639

FirstSpirit Connect for Commerce (fsm) | Avoid potential concurrency issues when accessing labels.

FCECOM-633

FirstSpirit Connect for Commerce (fsm) | Refactored code to improve readability.

FCECOM-98

FirstSpirit Connect for Commerce (fsm) | For shop-driven pages that have already been added to FirstSpirit, a visual indication can now be seen in the reports.

Version 24.7.1

Update Notice

The FirstSpirit Connect for Commerce integration is a bundle of software components. The table below lists all components and their versions.

Components
This release contains the following components.
Versions marked with an arrow (⬆) changed since the last release.

Components Version

FirstSpirit Connect for Commerce (fsm)

3.12.0 ⬆

Reference project

1.7.0

FirstSpirit Connect for Commerce - Bridge API

3.2.0 ⬆

Bridge Commons

2.3.1 ⬆

Frontend Extension

1.1.4

Frontend API Showcase

1.1.0

Frontend API Backend

2.6.1

Frontend API

NPM Package Version

fcecom-frontend-api-client

1.1.0

fcecom-frontend-api-server

1.1.0

Reference Implementations
The following Artifacts won’t be maintained

Reference Implementation Version

fcecom-b2c-commerce-react-preview

1.0.2

cfc-spryker-content

1.0.2 ⬆

cfc-spryker-reference-components

1.0.0

Reference-Bridge-Implementations

Bridge Version

Mock-o-Merce-Bridge

2.5.1 ⬆

BigCommerce-Bridge

2.5.1 ⬆

SAP Commerce Cloud-Bridge

2.5.1 ⬆

Spryker Commerce OS-Bridge

2.5.1 ⬆

Salesforce Commerce Cloud-Bridge

2.5.2 ⬆

General information
This release was tested with the following versions:

Product Version

FirstSpirit server

2024-08 (5.2.240809)

Java

17

CaaS Connect (FSM)

3.63.2

Omnichannel Manager

3.0.0

Basic Workflows

1.4.0

Important notices

No important notices available for this release.

FCECOM-512 - Adjust response in case of an error

The error responses are now JSON instead of plain text.

Fixed issues

ID Description

FCECOM-918

cfc-spryker-content | Fixed a bug where the storefront was not accessible without a running backend.

FCECOM-917

cfc-spryker-content | Fixed URLs of content pages not being applied correctly.

FCECOM-897

SAP Commerce Cloud-Bridge | Fixed configured default language not being used as fallback.

FCECOM-774

fcecom-bridge-commons | Remove deprecated endpoints for /categories/{ids} and /products/{ids}.

FCECOM-512

fcecom-core-api, fcecom-bridge-commons, Bridges | Adjust response in case of an error.

New features

ID Description

FCECOM-908

FirstSpirit Connect for Commerce (fsm) | Removed workaround that was previously required to fix the x-total header.

FCECOM-610

FirstSpirit Connect for Commerce (fsm) | Made cache configurable in the project app configuration.

Version 24.7.0

Update Notice

The FirstSpirit Connect for Commerce integration is a bundle of software components. The table below lists all components and their versions.

Components
This release contains the following components.
Versions marked with an arrow (⬆) changed since the last release.

Components Version

FirstSpirit Connect for Commerce (fsm)

3.11.0 ⬆

Reference project

1.7.0 ⬆

FirstSpirit Connect for Commerce - Bridge API

3.1.0

Bridge Commons

2.3.0

Frontend Extension

1.1.4

Frontend API Showcase

1.1.0 ⬆

Frontend API Backend

2.6.1 ⬆

Frontend API

NPM Package Version

fcecom-frontend-api-client

1.1.0 ⬆

fcecom-frontend-api-server

1.1.0 ⬆

Reference Implementations
The following Artifacts won’t be maintained

Reference Implementation Version

fcecom-b2c-commerce-react-preview

1.0.2 ⬆

cfc-spryker-content

1.0.1

cfc-spryker-reference-components

1.0.0

Reference-Bridge-Implementations

Bridge Version

Mock-o-Merce-Bridge

2.5.0

BigCommerce-Bridge

2.5.0

SAP Commerce Cloud-Bridge

2.5.0

Spryker Commerce OS-Bridge

2.5.0

Salesforce Commerce Cloud-Bridge

2.5.1 ⬆

General information
This release was tested with the following versions:

Product Version

FirstSpirit server

2024-06 (5.2.240712)

Java

17

CaaS Connect (FSM)

3.60.3

Omnichannel Manager

3.0.0

Basic Workflows

1.4.0

Deprecations

Artifact Functionality Deprecated with Removed in

Important notices

No important notices available for this release.

Fixed issues

ID Description

FCECOM-912

FirstSpirit Connect for Commerce (fsm) | Fixed a bug in the config migration which caused unnecessary migration.

FCECOM-905

Salesforce Commerce Cloud Bridge | Fixed an issue where including the root category in the X-Total header caused the calculated total number of categories to be returned one category larger than the list in the API response.

FCECOM-902

fcecom-b2c-commerce-react-preview | The ID specified in the header of a page was incorrectly the pageID. Now the pageRefID is displayed so that a findElement() is possible.

FCECOM-641

fcecom-frontend-api-server, Frontend API Showcase | Optimized build pipeline.

New features

ID Description

FCECOM-909

FirstSpirit Connect for Commerce (fsm), Reference project | Added executables for bulk page creation of product and category pages.

FCECOM-315

FirstSpirit Connect for Commerce (fsm) | Small internal changes.

Version 24.6.2

Update Notice

The FirstSpirit Connect for Commerce integration is a bundle of software components. The table below lists all components and their versions.

Components
This release contains the following components.
Versions marked with an arrow (⬆) changed since the last release.

Components Version

FirstSpirit Connect for Commerce (fsm)

3.10.0 ⬆

Reference project

1.6.0

FirstSpirit Connect for Commerce - Bridge API

3.1.0 ⬆

Bridge Commons

2.3.0 ⬆

Frontend Extension

1.1.4

Frontend API Showcase

1.0.1

Frontend API Backend

2.6.0

Frontend API

NPM Package Version

fcecom-frontend-api-client

1.0.1

fcecom-frontend-api-server

1.0.1

Reference Implementations
The following Artifacts won’t be maintained

Reference Implementation Version

fcecom-b2c-commerce-react-preview

1.0.1

cfc-spryker-content

1.0.1

cfc-spryker-reference-components

1.0.0

Reference-Bridge-Implementations

Bridge Version

Mock-o-Merce-Bridge

2.5.0 ⬆

BigCommerce-Bridge

2.5.0 ⬆

SAP Commerce Cloud-Bridge

2.5.0 ⬆

Spryker Commerce OS-Bridge

2.5.0 ⬆

Salesforce Commerce Cloud-Bridge

2.5.0 ⬆

General information
This release was tested with the following versions:

Product Version

FirstSpirit server

2024-06 (5.2.240608)

Java

17

CaaS Connect (FSM)

3.59.1

Omnichannel Manager

3.0.0

Basic Workflows

1.4.0

Deprecations

Artifact Functionality Deprecated with Removed in

FCECOM-795 - Added a search by category name to the category report

Keep in mind that your bridge must support a search query for the /categories endpoint. The bridges since version 2.5.0 support this.

New features

ID Description

FCECOM-795

FirstSpirit Connect for Commerce (fsm) | Added a search by category name to the category report.

FCECOM-794

Bridge API | Added optional search query parameter for categories.

FCECOM-793

Bridge Commons, All Bridges | Add optional search parameter for categories endpoint.

Version 24.6.1

Update Notice

The FirstSpirit Connect for Commerce integration is a bundle of software components. The table below lists all components and their versions.

Components
This release contains the following components.
Versions marked with an arrow (⬆) changed since the last release.

Components Version

FirstSpirit Connect for Commerce (fsm)

3.9.0 ⬆

Reference project

1.6.0

FirstSpirit Connect for Commerce - Bridge API

3.0.2

Bridge Commons

2.2.1

Frontend Extension

1.1.4

Frontend API Showcase

1.0.1

Frontend API Backend

2.6.0

Frontend API

NPM Package Version

fcecom-frontend-api-client

1.0.1

fcecom-frontend-api-server

1.0.1

Reference Implementations
The following Artifacts won’t be maintained

Reference Implementation Version

fcecom-b2c-commerce-react-preview

1.0.1

cfc-spryker-content

1.0.1

cfc-spryker-reference-components

1.0.0

Reference-Bridge-Implementations

Bridge Version

Mock-o-Merce-Bridge

2.4.1

BigCommerce-Bridge

2.4.1

SAP Commerce Cloud-Bridge

2.4.1

Spryker Commerce OS-Bridge

2.4.1

Salesforce Commerce Cloud-Bridge

2.4.1

General information
This release was tested with the following versions:

Product Version

FirstSpirit server

2024-06 (5.2.240608)

Java

17

CaaS Connect (FSM)

3.59.1

Omnichannel Manager

3.0.0

Basic Workflows

1.4.0

Deprecations

Artifact Functionality Deprecated with Removed in

New features

ID Description

FCECOM-871

FirstSpirit Connect for Commerce (fsm) | Added paginated loading of report items and fixed the displaying of the number of search results in the reports.

FCECOM-843

Documentation | Added How to Storefront documentation.

Version 24.6.0

Update Notice

The FirstSpirit Connect for Commerce integration is a bundle of software components. The table below lists all components and their versions.

Components
This release contains the following components.
Versions marked with an arrow (⬆) changed since the last release.

Components Version

FirstSpirit Connect for Commerce (fsm)

3.8.1 ⬆

Reference project

1.6.0

FirstSpirit Connect for Commerce - Bridge API

3.0.2

Bridge Commons

2.2.1

Frontend Extension

1.1.4

Frontend API Showcase

1.0.1 ⬆

Frontend API Backend

2.6.0 ⬆

Frontend API

NPM Package Version

fcecom-frontend-api-client

1.0.1 ⬆

fcecom-frontend-api-server

1.0.1 ⬆

Reference Implementations
The following Artifacts won’t be maintained

Reference Implementation Version

fcecom-b2c-commerce-react-preview

1.0.1 ⬆

cfc-spryker-content

1.0.1

cfc-spryker-reference-components

1.0.0

Reference-Bridge-Implementations

Bridge Version

Mock-o-Merce-Bridge

2.4.1

BigCommerce-Bridge

2.4.1

SAP Commerce Cloud-Bridge

2.4.1

Spryker Commerce OS-Bridge

2.4.1

Salesforce Commerce Cloud-Bridge

2.4.1

General information
This release was tested with the following versions:

Product Version

FirstSpirit server

2024-06 (5.2.240608)

Java

17

CaaS Connect (FSM)

3.59.1

Omnichannel Manager

3.0.0

Basic Workflows

1.4.0

Deprecations

Artifact Functionality Deprecated with Removed in

Bridge API

Support for getById endpoints

Release 22.4.0

April 2023

Bridge API

Support for Contentpages endpoints

Release 22.10.1

August 2023

New features

ID Description

FCECOM-898

FirstSpirit Connect for Commerce (fsm) | Internal refactoring of DAP classes.

FCECOM-890

fcecom-frontend-api-server | Removed dependency to express from APIs core.

FCECOM-859

Frontend-API-Backend | A status page has been added that summarizes information about the version in use and some configurations.

FCECOM-832

fcecom-frontend-api-server | Added Open API specification to the server.

Version 24.5.0

Highlights

FCECOM-892 - Frontend API is now generally available
The Connect for Commerce Frontend API is now available in version 1.0.0.

Update Notice

The FirstSpirit Connect for Commerce integration is a bundle of software components. The table below lists all components and their versions.

Components
This release contains the following components.
Versions marked with an arrow (⬆) changed since the last release.

Components Version

FirstSpirit Connect for Commerce (fsm)

3.8.0 ⬆

Reference project

1.6.0

FirstSpirit Connect for Commerce - Bridge API

3.0.2

Bridge Commons

2.2.1 ⬆

Frontend Extension

1.1.4

Frontend API Showcase

1.0.0 ⬆

Frontend API Backend

2.5.0 ⬆

Frontend API

NPM Package Version

fcecom-frontend-api-client

1.0.0 ⬆

fcecom-frontend-api-server

1.0.0 ⬆

Reference Implementations
The following Artifacts won’t be maintained

Reference Implementation Version

fcecom-b2c-commerce-react-preview

1.0.0 ⬆

cfc-spryker-content

1.0.1

cfc-spryker-reference-components

1.0.0

Reference-Bridge-Implementations

Bridge Version

Mock-o-Merce-Bridge

2.4.1 ⬆

BigCommerce-Bridge

2.4.1 ⬆

SAP Commerce Cloud-Bridge

2.4.1 ⬆

Spryker Commerce OS-Bridge

2.4.1 ⬆

Salesforce Commerce Cloud-Bridge

2.4.1 ⬆

General information
This release was tested with the following versions:

Product Version

FirstSpirit server

2024-05 (5.2.240508)

Java

17

CaaS Connect (FSM)

3.58.0

Omnichannel Manager

3.0.0

Basic Workflows

1.4.0

Deprecations

Artifact Functionality Deprecated with Removed in

Bridge API

Support for getById endpoints

Release 22.4.0

April 2023

Bridge API

Support for Contentpages endpoints

Release 22.10.1

August 2023

FCECOM-892 - Frontend API is now generally available
Version 1.0.0 of the Frontend API uses the new 3.0 release candidate of the OCM API which is integrated in the ContentCreator.

This requires the following changes to your project if they have not already been made when updating to version 0.23.0:
1. Adding the PreviewRenderingPlugin. Cloud customers may contact the Technical Support for this.
2. Disable Preview: Create Section in the CXT ContentCreator: Feature Configuration Project App.

Fixed issues

ID Description

FCECOM-888

All Bridges, Bridge Commons | Fixed security vulnerabilities located in axios (CVE-2023-45857) and follow-redirects (CVE-2023-26159, CVE-2024-28849) by updating the relevant dependencies.

FCECOM-862

Frontend API Backend, fcecom-frontend-api-server | Added the ability to configure FirstSpirit remote projects.

New features

ID Description

FCECOM-892

fcecom-frontend-api-server, fcecom-frontend-api-client, fcecom-frontend-api-showcase, Frontend API Backend | Frontend API is now generally available.

FCECOM-876

Documentation | Complete overhaul of the entire documentation.

FCECOM-866

fcecom-frontend-api-server | Improved compatibility with custom Frontend API Backends for projects not using express.js.

FCECOM-852

fcecom-b2c-commerce-react-preview | Added missing configuration information to the README.md.

FCECOM-771

FirstSpirit Connect for Commerce (fsm) | Added Test Connection request to categories/ids endpoint.

Version 24.4.0

Update Notice

The FirstSpirit Connect for Commerce integration is a bundle of software components. The table below lists all components and their versions.

Components
This release contains the following components.
Versions marked with an arrow (⬆) changed since the last release.

Components Version

FirstSpirit Connect for Commerce (fsm)

3.7.0 ⬆

Reference project

1.6.0

FirstSpirit Connect for Commerce - Bridge API

3.0.2

Bridge Commons

2.2.0 ⬆

Frontend API Backend

2.4.0

Frontend Extension

1.1.4

Frontend API Showcase

0.25.0

Reference Implementations
The following Artifacts won’t be maintained

Reference Implementation Version

fcecom-b2c-commerce-react-preview

0.3.0

cfc-spryker-content

1.0.1 ⬆

cfc-spryker-reference-components

1.0.0

Reference-Bridge-Implementations

Bridge Version

Mock-o-Merce-Bridge

2.4.0 ⬆

BigCommerce-Bridge

2.4.0 ⬆

SAP Commerce Cloud-Bridge

2.4.0 ⬆

Spryker Commerce OS-Bridge

2.4.0 ⬆

Salesforce Commerce Cloud-Bridge

2.4.0 ⬆

Frontend API

NPM Package Version

fcecom-frontend-api-client

0.25.0

fcecom-frontend-api-server

0.25.0

General information
This release was tested with the following versions:

Product Version

FirstSpirit server

2024-04 (5.2.240408)

Java

17

CaaS Connect (FSM)

3.55.0

Omnichannel Manager

3.0.0

Basic Workflows

1.3.6

Deprecations

Artifact Functionality Deprecated with Removed in

Bridge API

Support for getById endpoints

Release 22.4.0

April 2023

Bridge API

Support for Contentpages endpoints

Release 22.10.1

August 2023

FCECOM-863 - Fixed security vulnerabilities located in express (CVE-2024-29041) by updating the relevant dependencies

Please update the fcecom-bridge-commons npm module in your bridge implementations to the latest version.

FCECOM-816 - Added anonymous tracking of Bridge API usage
The FirstSpirit module now anonymously logs the internal use of various Bridge API features. This serves the sole purpose of concentrating the further development of the module on utilized functions.

FCECOM-574 - Improved the error handling for requests failing to have a query parameter

The query parameter is and was always mandatory for the getContent endpoint of the Salesforce Commerce Cloud-Bridge. Not providing it led wrongly to "Internal Server Error" responses.

With this bugfix, a better fitting response is sent, containing a status code 400 with the appropriate error message. If you have developed against a response with status code 500, you will have to change your code, so it can handle the same error with a status code 400.

Fixed issues

ID Description

FCECOM-863

All Bridges, Bridge Commons | Fixed security vulnerabilities located in express (CVE-2024-29041) by updating the relevant dependencies.

FCECOM-861

cfc-spryker-content | Fixed data not being passed to slots in some scenarios.

FCECOM-574

Bridge Commons, Salesforce Commerce Cloud-Bridge | Improved the error handling for requests failing to have a query parameter.

New features

ID Description

FCECOM-854

FirstSpirit Connect for Commerce (fsm) | Updated dependencies.

FCECOM-816

FirstSpirit Connect for Commerce (fsm) | Added anonymous tracking of Bridge API usage.

Version 24.3.0

Update Notice

The FirstSpirit Connect for Commerce integration is a bundle of software components. The table below lists all components and their versions.

Components
This release contains the following components.
Versions marked with an arrow (⬆) changed since the last release.

Components Version

FirstSpirit Connect for Commerce (fsm)

3.6.0 ⬆

Reference project

1.6.0 ⬆

FirstSpirit Connect for Commerce - Bridge API

3.0.2

Bridge Commons

2.1.2

Frontend API Backend

2.4.0 ⬆

Frontend Extension

1.1.4

Frontend API Showcase

0.25.0 ⬆

Reference Implementations
The following Artifacts won’t be maintained

Reference Implementation Version

fcecom-b2c-commerce-react-preview

0.3.0 ⬆

cfc-spryker-content

1.0.0

cfc-spryker-reference-components

1.0.0

Reference-Bridge-Implementations

Bridge Version

Mock-o-Merce-Bridge

2.3.0

BigCommerce-Bridge

2.3.0

SAP Commerce Cloud-Bridge

2.3.0

Spryker Commerce OS-Bridge

2.3.0

Salesforce Commerce Cloud-Bridge

2.3.0

Frontend API

NPM Package Version

fcecom-frontend-api-client

0.25.0 ⬆

fcecom-frontend-api-server

0.25.0 ⬆

General information
This release was tested with the following versions:

Product Version

FirstSpirit server

2024-03 (5.2.240312)

Java

17

CaaS Connect (FSM)

3.50.0

Omnichannel Manager

3.0.0

Basic Workflows

1.3.6

Deprecations

Artifact Functionality Deprecated with Removed in

Bridge API

Support for getById endpoints

Release 22.4.0

April 2023

Bridge API

Support for Contentpages endpoints

Release 22.10.1

August 2023

Fixed issues

ID Description

FCECOM-838

fcecom-reference-project | Added configuration to use OCM 3.0.

FCECOM-814

Frontend API Backend | The description of the use of environment variables has been corrected.

New features

ID Description

FCECOM-834

FirstSpirit Connect for Commerce (fsm) | Updated dependencies.

FCECOM-811

fcecom-frontend-api-client | Updated documentation on the hooks CONTENT_CHANGED and SECTION_CREATED payloads.

FCECOM-810

fcecom-frontend-api-server | Add possibility to add plugins.

Version 24.2.0

Update Notice

The FirstSpirit Connect for Commerce integration is a bundle of software components. The table below lists all components and their versions.

Components
This release contains the following components.
Versions marked with an arrow (⬆) changed since the last release.

Components Version

FirstSpirit Connect for Commerce (fsm)

3.5.0

Reference project

1.5.0

FirstSpirit Connect for Commerce - Bridge API

3.0.2

Bridge Commons

2.1.2

Frontend API Backend

2.3.0 ⬆

Frontend Extension

1.1.4

Frontend API Showcase

0.24.0 ⬆

Reference Implementations
The following Artifacts won’t be maintained

Reference Implementation Version

fcecom-b2c-commerce-react-preview

0.2.0 ⬆

cfc-spryker-content

1.0.0

cfc-spryker-reference-components

1.0.0

Reference-Bridge-Implementations

Bridge Version

Mock-o-Merce-Bridge

2.3.0

BigCommerce-Bridge

2.3.0

SAP Commerce Cloud-Bridge

2.3.0

Spryker Commerce OS-Bridge

2.3.0

Salesforce Commerce Cloud-Bridge

2.3.0

Frontend API

NPM Package Version

fcecom-frontend-api-client

0.24.0 ⬆

fcecom-frontend-api-server

0.24.0 ⬆

General information
This release was tested with the following versions:

Product Version

FirstSpirit server

2024-02 (5.2.240208)

Java

17

CaaS Connect (FSM)

3.46.3

Omnichannel Manager

2.4.7

Basic Workflows

1.3.6

Deprecations

Artifact Functionality Deprecated with Removed in

Bridge API

Support for getById endpoints

Release 22.4.0

April 2023

Bridge API

Support for Contentpages endpoints

Release 22.10.1

August 2023

FCECOM-830 - Fixed security vulnerabilities located in lodash (CVE-2020-8203) and semver (CVE-2022-25883) by updating the relevant dependencies

Please update the fcecom-frontend-api-server npm module in your Frontend API Backend implementation to the latest version.

npm i fcecom-frontend-api-server@0.24.0

FCECOM-808 - Fixed an issue that prevents actions like "Add to Cart" when running the PWA inside the FirstSpirit ContentCreator

Please add the FirstSpirit server origin to ./overrides/app/constants.js of your fcecom-b2c-commerce-react-preview implementation.

Fixed issues

ID Description

FCECOM-830

fcecom-frontend-api-server, fcecom-b2c-commerce-react-preview | Fixed security vulnerabilities located in lodash (CVE-2020-8203) and semver (CVE-2022-25883) by updating the relevant dependencies.

FCECOM-808

fcecom-b2c-commerce-react-preview | Fixed an issue that prevents actions like "Add to Cart" when running the PWA inside the FirstSpirit ContentCreator.

New features

ID Description

FCECOM-829

Frontend API Backend | Changed used programming language to TypeScript. Additionally, SSL support was added and the Dockerfile has been improved.

FCECOM-791

fcecom-b2c-commerce-react-preview | The PWA is now compatible with the Salesforce Runtime Environment.

Version 24.1.1

Update Notice

The FirstSpirit Connect for Commerce integration is a bundle of software components. The table below lists all components and their versions.

Components
This release contains the following components.
Versions marked with an arrow (⬆) changed since the last release.

Components Version

FirstSpirit Connect for Commerce (fsm)

3.5.0 ⬆

Reference project

1.5.0 ⬆

FirstSpirit Connect for Commerce - Bridge API

3.0.2

Bridge Commons

2.1.2

Frontend API Backend

2.2.0 ⬆

Frontend Extension

1.1.4

Frontend API Showcase

0.23.0 ⬆

Reference Implementations
The following Artifacts won’t be maintained

Reference Implementation Version

fcecom-b2c-commerce-react-preview

0.1.3 ⬆

cfc-spryker-content

1.0.0

cfc-spryker-reference-components

1.0.0

Reference-Bridge-Implementations

Bridge Version

Mock-o-Merce-Bridge

2.3.0

BigCommerce-Bridge

2.3.0

SAP Commerce Cloud-Bridge

2.3.0

Spryker Commerce OS-Bridge

2.3.0

Salesforce Commerce Cloud-Bridge

2.3.0

Frontend API

NPM Package Version

fcecom-frontend-api-client

0.23.0 ⬆

fcecom-frontend-api-server

0.23.0 ⬆

General information
This release was tested with the following versions:

Product Version

FirstSpirit server

2024-01 (5.2.240111)

Java

17

CaaS Connect (FSM)

3.44.0

Omnichannel Manager

2.4.7

Basic Workflows

1.3.6

Deprecations

Artifact Functionality Deprecated with Removed in

Bridge API

Support for getById endpoints

Release 22.4.0

April 2023

Bridge API

Support for Contentpages endpoints

Release 22.10.1

August 2023

FCECOM-773 - Switch to version 3.0 release candidate of the OCM API
Instead of using the OCM API provided by the FirstSpirit ThirdPartyPreview Module we now use the new 3.0 release candidate of the OCM API which is integrated in the ContentCreator.

This requires the following changes to your project:
1. Adding the PreviewRenderingPlugin
2. Disable Preview: Create Section in the CXT ContentCreator: Feature Configuration Project App.

New features

ID Description

FCECOM-773

fcecom-frontend-api-client | Switch to version 3.0 release candidate of the OCM API.

FCECOM-613

FirstSpirit Connect for Commerce (fsm), Documentation, fcecom-frontend-api | The module now creates a CaaS index for findPage queries of the Frontend API. Added a note regarding the index to main and Frontend API documentation.

Version 24.1.0

Update Notice

The FirstSpirit Connect for Commerce integration is a bundle of software components. The table below lists all components and their versions.

Components
This release contains the following components.
Versions marked with an arrow (⬆) changed since the last release.

Components Version

FirstSpirit Connect for Commerce (fsm)

3.4.1 ⬆

Reference project

1.4.1

FirstSpirit Connect for Commerce - Bridge API

3.0.2

Bridge Commons

2.1.2

Frontend API Backend

2.1.0 ⬆

Frontend Extension

1.1.4

Frontend API Showcase

0.22.0 ⬆

Reference Implementations
The following Artifacts won’t be maintained

Reference Implementation Version

fcecom-b2c-commerce-react-preview

0.1.2 ⬆

cfc-spryker-content

1.0.0

cfc-spryker-reference-components

1.0.0

Reference-Bridge-Implementations

Bridge Version

Mock-o-Merce-Bridge

2.3.0 ⬆

BigCommerce-Bridge

2.3.0 ⬆

SAP Commerce Cloud-Bridge

2.3.0 ⬆

Spryker Commerce OS-Bridge

2.3.0 ⬆

Salesforce Commerce Cloud-Bridge

2.3.0 ⬆

Frontend API

NPM Package Version

fcecom-frontend-api-client

0.22.0 ⬆

fcecom-frontend-api-server

0.22.0 ⬆

General information
This release was tested with the following versions:

Product Version

FirstSpirit server

2024-01 (5.2.240111)

Java

17

CaaS Connect (FSM)

3.44.0

Omnichannel Manager

2.4.7

Basic Workflows

1.3.6

Deprecations

Artifact Functionality Deprecated with Removed in

Bridge API

Support for getById endpoints

Release 22.4.0

April 2023

Bridge API

Support for Contentpages endpoints

Release 22.10.1

August 2023

FCECOM-729 - Added configuration to filter untranslated sections
If this feature is enabled in the Frontend API Backend configuration, the "Add content" button is rendered if there is no content for the section for the current language.

Please note that the input components of the section templates must be language-dependent, otherwise this can lead to undesirable side effects.

Fixed issues

ID Description

FCECOM-781

FirstSpirit Connect for Commerce (fsm) | Removed obsolete check for new content endpoint.

New features

ID Description

FCECOM-804

All Bridges, Frontend API Backend | Added template for multi-tenant support with Docker Compose.

FCECOM-729

fcecom-frontend-api-server | Added configuration to filter untranslated sections.

FCECOM-669

fcecom-frontend-api-server | Improved error handling for an invalid locale format.

Version 23.12.2

Update Notice

The FirstSpirit Connect for Commerce integration is a bundle of software components. The table below lists all components and their versions.

Components
This release contains the following components.
Versions marked with an arrow (⬆) changed since the last release.

Components Version

FirstSpirit Connect for Commerce (fsm)

3.4.0

Reference project

1.4.1

FirstSpirit Connect for Commerce - Bridge API

3.0.2

Bridge Commons

2.1.2

Frontend API Backend

2.0.1 ⬆

Frontend Extension

1.1.4

Frontend API Showcase

0.20.0 ⬆

Reference Implementations
The following Artifacts won’t be maintained

Reference Implementation Version

fcecom-b2c-commerce-react-preview

0.1.1 ⬆

cfc-spryker-content

1.0.0

cfc-spryker-reference-components

1.0.0

Reference-Bridge-Implementations

Bridge Version

Mock-o-Merce-Bridge

2.2.2

BigCommerce-Bridge

2.2.2

SAP Commerce Cloud-Bridge

2.2.2

Spryker Commerce OS-Bridge

2.2.2

Salesforce Commerce Cloud-Bridge

2.2.3 ⬆

Frontend API

NPM Package Version

fcecom-frontend-api-client

0.20.0 ⬆

fcecom-frontend-api-server

0.20.0 ⬆

General information
This release was tested with the following versions:

Product Version

FirstSpirit server

2023-13 (5.2.231308)

Java

17

CaaS Connect (FSM)

3.42.1

Omnichannel Manager

2.4.7

Basic Workflows

1.3.6

Deprecations

Artifact Functionality Deprecated with Removed in

Bridge API

Support for getById endpoints

Release 22.4.0

April 2023

Bridge API

Support for Contentpages endpoints

Release 22.10.1

August 2023

Fixed issues

ID Description

FCECOM-800

fcecom-frontend-api | Fixed a bug where the FirstSpirit server origin was exposed to the frontend.

New features

ID Description

FCECOM-549

fcecom-frontend-api | The Frontend API now checks for the origin of received postMessage events.

FCECOM-506

Salesforce Commerce Cloud-Bridge | Removed unnecessary data from test files.

Version 23.12.1

Highlights

A reference implementation of Connect for Commerce Frontend API with Salesforce Retail React App is now available on GitHub.

A reference implementation of Connect for Commerce Frontend API with Spryker B2C Demo Shop is now available on GitHub. It consists of two modules:
cfc-spryker-content
cfc-spryker-reference-components

Please read the documentation on how to use the modules.

Update Notice

The FirstSpirit Connect for Commerce integration is a bundle of software components. The table below lists all components and their versions.

Components
This release contains the following components.
Versions marked with an arrow (⬆) changed since the last release.

Components Version

FirstSpirit Connect for Commerce (fsm)

3.4.0

Reference project

1.4.1

FirstSpirit Connect for Commerce - Bridge API

3.0.2 ⬆

Bridge Commons

2.1.2 ⬆

Frontend API Backend

2.0.0 ⬆

Frontend Extension

1.1.4

Frontend API Showcase

0.19.0 ⬆

Reference Implementations
The following Artifacts won’t be maintained

Reference Implementation Version

fcecom-b2c-commerce-react-preview

0.1.0 ⬆

cfc-spryker-content

1.0.0

cfc-spryker-reference-components

1.0.0

Reference-Bridge-Implementations

Bridge Version

Mock-o-Merce-Bridge

2.2.2 ⬆

BigCommerce-Bridge

2.2.2 ⬆

SAP Commerce Cloud-Bridge

2.2.2 ⬆

Spryker Commerce OS-Bridge

2.2.2 ⬆

Salesforce Commerce Cloud-Bridge

2.2.2 ⬆

Frontend API

NPM Package Version

fcecom-frontend-api-client

0.19.0 ⬆

fcecom-frontend-api-server

0.19.0 ⬆

General information
This release was tested with the following versions:

Product Version

FirstSpirit server

2023-13 (5.2.231308)

Java

17

CaaS Connect (FSM)

3.42.1

Omnichannel Manager

2.4.7

Basic Workflows

1.3.6

Deprecations

Artifact Functionality Deprecated with Removed in

Bridge API

Support for getById endpoints

Release 22.4.0

April 2023

Bridge API

Support for Contentpages endpoints

Release 22.10.1

August 2023

FCECOM-683 - Frontend API Backend: Validate config sources
During the implementation of this feature, the Frontend API backend has been switched to ES modules and expects the server package to contain the correct file extensions for the bundles. This is a breaking change and only compatible with Frontend API server package >= 0.19.0.

Fixed issues

ID Description

FCECOM-470

All Bridges, Bridge Commons, Bridge API | Updated response examples in API documentation.

New features

ID Description

FCECOM-790

fcecom-b2c-commerce-react-preview | A reference implementation of Connect for Commerce Frontend API with Salesforce Retail React App is now available on GitHub.

FCECOM-683

Frontend API Backend | Provision of a script for easier checking of configuration sources.

Version 23.12.0

Highlights

setElement() is now deprecated.

Update Notice

The FirstSpirit Connect for Commerce integration is a bundle of software components. The table below lists all components and their versions.

Components
This release contains the following components.
Versions marked with an arrow (⬆) changed since the last release.

Components Version

FirstSpirit Connect for Commerce (fsm)

3.4.0

Reference project

1.4.1 ⬆

FirstSpirit Connect for Commerce - Bridge API

3.0.1

Bridge Commons

2.1.1

Frontend API Backend

1.6.11 ⬆

Frontend Extension

1.1.4

Frontend API Showcase

0.18.0 ⬆

Reference-Bridge-Implementations

Bridge Version

Mock-o-Merce-Bridge

2.2.1

BigCommerce-Bridge

2.2.1

SAP Commerce Cloud-Bridge

2.2.1

Spryker Commerce OS-Bridge

2.2.1

Salesforce Commerce Cloud-Bridge

2.2.1

Frontend API

NPM Package Version

fcecom-frontend-api-client

0.18.0 ⬆

fcecom-frontend-api-server

0.18.0 ⬆

General information
This release was tested with the following versions:

Product Version

FirstSpirit server

2023-12 (5.2.231214)

Java

17

CaaS Connect (FSM)

3.40.4

Omnichannel Manager

2.4.7

Basic Workflows

1.3.6

Deprecations

Artifact Functionality Deprecated with Removed in

Bridge API

Support for getById endpoints

Release 22.4.0

April 2023

Bridge API

Support for Contentpages endpoints

Release 22.10.1

August 2023

Fixed issues

ID Description

FCECOM-792

Reference Project | Teaser Grid now selects the video from the YouTube DAP.

FCECOM-640

fcecom-frontend-api-server | Removed a circular dependency.

New features

ID Description

FCECOM-687

fcecom-frontend-api-client | Created method setPage(), replacing setElement() to add enhanced functionality like providing fetched pages directly and creating missing pages on demand.

Version 23.11.2

Update Notice

The FirstSpirit Connect for Commerce integration is a bundle of software components. The table below lists all components and their versions.

Components
This release contains the following components.
Versions marked with an arrow (⬆) changed since the last release.

Components Version

FirstSpirit Connect for Commerce (fsm)

3.4.0 ⬆

Reference project

1.4.0

FirstSpirit Connect for Commerce - Bridge API

3.0.1 ⬆

Bridge Commons

2.1.1 ⬆

Frontend API Backend

1.6.10 ⬆

Frontend Extension

1.1.4

Frontend API Showcase

0.17.0 ⬆

Reference-Bridge-Implementations

Bridge Version

Mock-o-Merce-Bridge

2.2.1 ⬆

BigCommerce-Bridge

2.2.1 ⬆

SAP Commerce Cloud-Bridge

2.2.1 ⬆

Spryker Commerce OS-Bridge

2.2.1 ⬆

Salesforce Commerce Cloud-Bridge

2.2.1 ⬆

Frontend API

NPM Package Version

fcecom-frontend-api-client

0.17.0 ⬆

fcecom-frontend-api-server

0.17.0 ⬆

General information
This release was tested with the following versions:

Product Version

FirstSpirit server

2023-12 (5.2.231214)

Java

17

CaaS Connect (FSM)

3.40.4

Omnichannel Manager

2.4.7

Basic Workflows

1.3.6

Deprecations

Artifact Functionality Deprecated with Removed in

Bridge API

Support for getById endpoints

Release 22.4.0

April 2023

Bridge API

Support for Contentpages endpoints

Release 22.10.1

August 2023

Fixed issues

ID Description

FCECOM-761

fcecom-frontend-api-client | Fixed a bug where the name of the slot could not be resolved during the creation of a sibling section.

FCECOM-756

All Bridges, Bridge Commons, Bridge API | Added missing status codes.

FCECOM-753

All Bridges, Bridge Commons, FirstSpirit Connect for Commerce (fsm) | Removed unused error codes.

FCECOM-615

FirstSpirit Connect for Commerce (fsm) | Added missing icons to the reports in the SiteArchitect.

New features

ID Description

FCECOM-522

fcecom-frontend-api-client, FirstSpirit Connect for Commerce (fsm) | The unused name parameter for some OpenStorefrontUrl types was removed to unify the behavior between different triggers.

Version 23.11.1

Update Notice

The FirstSpirit Connect for Commerce integration is a bundle of software components. The table below lists all components and their versions.

Components
This release contains the following components.
Versions marked with an arrow (⬆) changed since the last release.

Components Version

FirstSpirit Connect for Commerce (fsm)

3.3.0 ⬆

Reference project

1.4.0 ⬆

FirstSpirit Connect for Commerce - Bridge API

3.0.0

Bridge Commons

2.1.0

Frontend API Backend

1.6.9 ⬆

Frontend Extension

1.1.4

Frontend API Showcase

0.16.0 ⬆

Reference-Bridge-Implementations

Bridge Version

Mock-o-Merce-Bridge

2.2.0

BigCommerce-Bridge

2.2.0

SAP Commerce Cloud-Bridge

2.2.0

Spryker Commerce OS-Bridge

2.2.0

Salesforce Commerce Cloud-Bridge

2.2.0

Frontend API

NPM Package Version

fcecom-frontend-api-client

0.16.0 ⬆

fcecom-frontend-api-server

0.16.0 ⬆

General information
This release was tested with the following versions:

Product Version

FirstSpirit server

2023-11 (5.2.231107)

Java

17

CaaS Connect (FSM)

3.39.4

Omnichannel Manager

2.4.7

Basic Workflows

1.3.4.972

Deprecations

Artifact Functionality Deprecated with Removed in

Bridge API

Support for getById endpoints

Release 22.4.0

April 2023

Bridge API

Support for Contentpages endpoints

Release 22.10.1

August 2023

FCECOM-760 - Moved the array access for findPage() to the server package
For single element access in findPage(), we moved the array access to the Server package to support server side rendering. As by definition findPage() can only find one item, findPage() now returns a single FindPageItem instead of an Array with one FindPageItem.

FCECOM-713 - More flexible specification of the "Bridge API URL" in the project component
The path component /api, which was previously fixed for bridges and cannot be configured, is now expected as an optional part of the "Bridge API URL" in the configuration of the project component. This enables more flexible hosting of a bridge. To ensure compatibility for existing projects, this adjustment is made automatically when the project component is updated.

Fixed issues

ID Description

FCECOM-708

FirstSpirit Connect for Commerce (fsm) | Fixed incorrect loading of the ContentCreator extension.

New features

ID Description

FCECOM-786

Reference project | New scripts added to support CSS variants and the teaser grid.

FCECOM-766

fcecom-frontend-api-client, FirstSpirit Connect for Commerce (fsm), Documentation | Improved mapping of store languages to FirstSpirit languages.

FCECOM-760

fcecom-frontend-api-client, fcecom-frontend-api-server | Moved the array access for findPage() to the server package.

FCECOM-713

FirstSpirit Connect for Commerce (fsm) | More flexible specification of the "Bridge API URL" in the project component.

Version 23.11.0

Update Notice

The FirstSpirit Connect for Commerce integration is a bundle of software components. The table below lists all components and their versions.

Components
This release contains the following components.
Versions marked with an arrow (⬆) changed since the last release.

Components Version

FirstSpirit Connect for Commerce (fsm)

3.2.0

Reference project

1.3.0

FirstSpirit Connect for Commerce - Bridge API

3.0.0

Bridge Commons

2.1.0

Frontend API Backend

1.6.8 ⬆

Frontend Extension

1.1.4

Frontend API Showcase

0.15.0 ⬆

Reference-Bridge-Implementations

Bridge Version

Mock-o-Merce-Bridge

2.2.0

BigCommerce-Bridge

2.2.0

SAP Commerce Cloud-Bridge

2.2.0

Spryker Commerce OS-Bridge

2.2.0

Salesforce Commerce Cloud-Bridge

2.2.0

Frontend API

NPM Package Version

fcecom-frontend-api-client

0.15.0 ⬆

fcecom-frontend-api-server

0.15.0 ⬆

General information
This release was tested with the following versions:

Product Version

FirstSpirit server

2023-11 (5.2.231107)

Java

17

CaaS Connect (FSM)

3.39.4

Omnichannel Manager

2.4.7

Basic Workflows

1.3.4.972

Deprecations

Important Notice

Frontend API Client packages before version 0.15.0 are not available through npmjs.com anymore. In case you need to use any legacy version, you can check out the corresponding tag from GitHub and build it yourself.

Artifact Functionality Deprecated with Removed in

Bridge API

Support for getById endpoints

Release 22.4.0

April 2023

Bridge API

Support for Contentpages endpoints

Release 22.10.1

August 2023

New features

ID Description

FCECOM-749

fcecom-frontend-api-client | Added triggerChange function to TPP_BROKER.

Version 23.10.1

Update Notice

The FirstSpirit Connect for Commerce integration is a bundle of software components. The table below lists all components and their versions.

Components
This release contains the following components.
Versions marked with an arrow (⬆) changed since the last release.

Components Version

FirstSpirit Connect for Commerce (fsm)

3.2.0 ⬆

Reference project

1.3.0

FirstSpirit Connect for Commerce - Bridge API

3.0.0

Bridge Commons

2.1.0 ⬆

Frontend API Backend

1.6.7 ⬆

Frontend Extension

1.1.4

Frontend API Showcase

0.13.1 ⬆

Reference-Bridge-Implementations

Bridge Version

Mock-o-Merce-Bridge

2.2.0 ⬆

BigCommerce-Bridge

2.2.0 ⬆

SAP Commerce Cloud-Bridge

2.2.0 ⬆

Spryker Commerce OS-Bridge

2.2.0 ⬆

Salesforce Commerce Cloud-Bridge

2.2.0 ⬆

Frontend API

NPM Package Version

fcecom-frontend-api-client

0.13.1 ⬆

fcecom-frontend-api-server

0.13.1 ⬆

General information
This release was tested with the following versions:

Product Version

FirstSpirit server

2023-11 (5.2.231107)

Java

17

CaaS Connect (FSM)

3.39.4

Omnichannel Manager

2.4.7

Basic Workflows

1.3.4.972

Deprecations

Artifact Functionality Deprecated with Removed in

Bridge API

Support for getById endpoints

Release 22.4.0

April 2023

Bridge API

Support for Contentpages endpoints

Release 22.10.1

August 2023

FCECOM-772 - Fix Critical Security Issue in babel/traverse | CVE-2023-45133

Please update the fcecom-bridge-commons npm module in your bridge implementations to the latest version.

npm i fcecom-bridge-commons@2.1.0

Fixed issues

ID Description

FCECOM-775

fcecom-frontend-api-client | Fixed a bug where reference pages in a static context had no display name.

FCECOM-772

All Bridges, Bridge Commons | Fixed a security vulnerability located in babel/traverse (CVE-2023-45133) by updating the relevant dependencies.

New features

ID Description

FCECOM-604

FirstSpirit Connect for Commerce (fsm) | The caching algorithm has been improved to no longer cache POST, PUT and HEAD requests.

FCECOM-566

FirstSpirit Connect for Commerce (fsm), Documentation | When having connection issues with the bridge, a warning dialog with information what went wrong is shown in the ContentCreator. New error codes were added to the documentation.

Version 23.10.0

Highlights

We added a new showcase repository. You can find the code here: https://github.com/e-Spirit/fcecom-frontend-api-showcase

Update Notice

The FirstSpirit Connect for Commerce integration is a bundle of software components. The table below lists all components and their versions.

Components
This release contains the following components.
Versions marked with an arrow (⬆) changed since the last release.

Components Version

FirstSpirit Connect for Commerce (fsm)

3.1.0 ⬆

Reference project

1.3.0 ⬆

FirstSpirit Connect for Commerce - Bridge API

3.0.0

Bridge Commons

2.0.0

Frontend API Backend

1.6.6 ⬆

Frontend Extension

1.1.4

Frontend API Showcase

0.13.0

Reference-Bridge-Implementations

Bridge Version

Mock-o-Merce-Bridge

2.1.0 ⬆

BigCommerce-Bridge

2.1.0 ⬆

SAP Commerce Cloud-Bridge

2.1.0 ⬆

Spryker Commerce OS-Bridge

2.1.0 ⬆

Salesforce Commerce Cloud-Bridge

2.1.0 ⬆

Frontend API

NPM Package Version

fcecom-frontend-api-client

0.13.0 ⬆

fcecom-frontend-api-server

0.13.0 ⬆

General information
This release was tested with the following versions:

Product Version

FirstSpirit server

2023-10 (5.2.231006)

Java

17

CaaS Connect (FSM)

3.39.0

Omnichannel Manager

2.4.7

Basic Workflows

1.3.4.972

Deprecations

Artifact Functionality Deprecated with Removed in

Bridge API

Support for getById endpoints

Release 22.4.0

April 2023

Bridge API

Support for Contentpages endpoints

Release 22.10.1

August 2023

FCECOM-748 - Provide safe TPP instance

In order to use the internal APIs, the hook PREVIEW_INITIALIZED must be implemented. This provides a TPP_BROKER object. The corresponding instructions can be found in the documentation in the chapter “Extensibility” and in the Client Reference.

FCECOM-742 - Content Change Hook call missing node

When adding a sibling section via the 'Add Section' button in the ContentCreator frame, now instead of CONTENT_CHANGED, the SECTION_CREATED hook is called.

Therefore the payload of the hook was extended:

export type CreateSectionHookPayload = {
  /**
   * Preview ID of page in FirstSpirit.
   */
  pageId: string;
  /**
   * Name of slot where the section should be created into as defined in the FirstSpirit template.
   */
  slotName: string;
  /**
   * Identifier of the section.
   */
  identifier: string;
  /**
   * If not the first section in the slot, the sibling of the newly created section.
   */
  siblingPreviewId?: string;
  /**
   * The data of the created section.
   */
  sectionData: any;
};

Fixed issues

ID Description

FCECOM-742

fcecom-frontend-api-client | SECTION_CREATED hook is now called when a sibling section is created via the 'Add Section' button in the ContentCreator frame.

FCECOM-724

fcecom-frontend-api-server | Enhanced the configuration loading to support URLs with trailing slashes.

New features

ID Description

FCECOM-762

Reference project | Added new field to specify the number of items per row for the Multi Slot Container section template.

FCECOM-754

All Bridges | Dockerfiles were optimized to achieve shorter build times.

FCECOM-748

fcecom-frontend-api-client | Added internal APIs to significantly extend the functionality of the Frontend API.

FCECOM-747

fcecom-frontend-api-client | Provided a new interface for custom code to access internal APIs.

FCECOM-614

FirstSpirit Connect for Commerce (fsm) | More detailed presentation of the bridge connection test results in the project component.

FCECOM-583

Frontend API Documentation | Addition of missing links and revision of wording.

Version 23.9.0

Update Notice

The FirstSpirit Connect for Commerce integration is a bundle of software components. The table below lists all components and their versions.

Components
This release contains the following components.
Versions marked with an arrow (⬆) changed since the last release.

Components Version

FirstSpirit Connect for Commerce (fsm)

3.0.0

Reference project

1.2.0 ⬆

FirstSpirit Connect for Commerce - Bridge API

3.0.0

Bridge Commons

2.0.0

Frontend API Backend

1.6.5 ⬆

Frontend Extension

1.1.4

Reference-Bridge-Implementations

Bridge Version

Mock-o-Merce-Bridge

2.0.0

BigCommerce-Bridge

2.0.0

SAP Commerce Cloud-Bridge

2.0.0

Spryker Commerce OS-Bridge

2.0.0

Salesforce Commerce Cloud-Bridge

2.0.0

Frontend API

NPM Package Version

fcecom-frontend-api-client

0.12.1 ⬆

fcecom-frontend-api-server

0.12.1 ⬆

General information
This release was tested with the following versions:

Product Version

FirstSpirit server

2023-08 (5.2.230812)

Java

17

CaaS Connect (FSM)

3.36.1

Omnichannel Manager

2.4.7

Basic Workflows

1.3.4.972

Deprecations

Artifact Functionality Deprecated with Removed in

Bridge API

Support for getById endpoints

Release 22.4.0

April 2023

Bridge API

Support for Contentpages endpoints

Release 22.10.1

August 2023

New features

ID Description

FCECOM-722

Reference project, Documentation | Revision of the reference project. It now contains new section templates, rules and scripts. Updated documentation regarding the changes.

FCECOM-718

fcecom-frontend-api-client | Increased test coverage.

FCECOM-602

Frontend API Documentation | External links in API documentation are now opened in a new browser tab.

Version 23.8.1

Update Notice

The FirstSpirit Connect for Commerce integration is a bundle of software components. The table below lists all components and their versions.

Components
This release contains the following components.
Versions marked with an arrow (⬆) changed since the last release.

Components Version

FirstSpirit Connect for Commerce (fsm)

3.0.0 ⬆

Reference project

1.1.7

FirstSpirit Connect for Commerce - Bridge API

3.0.0 ⬆

Bridge Commons

2.0.0 ⬆

Frontend API Backend

1.6.4 ⬆

Frontend Extension

1.1.4

Reference-Bridge-Implementations

Bridge Version

Mock-o-Merce-Bridge

2.0.0 ⬆

BigCommerce-Bridge

2.0.0 ⬆

SAP Commerce Cloud-Bridge

2.0.0 ⬆

Spryker Commerce OS-Bridge

2.0.0 ⬆

Salesforce Commerce Cloud-Bridge

2.0.0 ⬆

Frontend API

NPM Package Version

fcecom-frontend-api-client

0.12.0 ⬆

fcecom-frontend-api-server

0.12.0 ⬆

General information
This release was tested with the following versions:

Product Version

FirstSpirit server

2023-08 (5.2.230812)

Java

17

CaaS Connect (FSM)

3.36.1

Omnichannel Manager

2.4.7

Basic Workflows

1.3.4.972

Deprecations

Artifact Functionality Deprecated with Removed in

Bridge API

Support for getById endpoints

Release 22.4.0

April 2023

Bridge API

Support for Contentpages endpoints

Release 22.10.1

August 2023

FCECOM-690 - Removed deprecated ContentPages endpoints

The following endpoints were removed from the Bridge API:

  • /api/contentpages

  • /api/contentpages/ids/{contentIds}

  • /api/contentpages/{contentId}

As of this release, only the new Content endpoints are supported.

Please check the Bridge API documentation for more information.

FCECOM-648 - Removed deprecated ContentPages endpoints

As of this release, the Connect for Commerce module only supports the new Content endpoints. It therefore requires a Bridge implementation that uses the new endpoints.

Fixed issues

ID Description

FCECOM-738

Salesforce Commerce Cloud-Bridge | Fixed a bug where labels were not displayed in the category report when the language was switched.

FCECOM-612

FirstSpirit Connect for Commerce (fsm) | Unification of inconsistent titles in error dialogs.

New features

ID Description

FCECOM-740

fcecom-frontend-api-client | Enabled use of hooks in static context and set navigation to corresponding page as default behavior when report elements or ContentCreator navigation is clicked.

FCECOM-739

fcecom-frontend-api-client | Extension of data passed to SECTION_CREATED hook.

FCECOM-690

All Bridges, Bridge Commons and Bridge API | Removed deprecated ContentPages endpoints.

FCECOM-686

fcecom-frontend-api-client | Removed misleading logs in release mode and added logs for initialization status of preview mode.

FCECOM-648

FirstSpirit Connect for Commerce (fsm) | Removed deprecated ContentPages endpoints.

Version 23.8.0

Update Notice

The FirstSpirit Connect for Commerce integration is a bundle of software components. The table below lists all components and their versions.

Components
This release contains the following components.
Versions marked with an arrow (⬆) changed since the last release.

Components Version

FirstSpirit Connect for Commerce (fsm)

2.5.6 ⬆

Reference project

1.1.7

FirstSpirit Connect for Commerce - Bridge API

2.2.2

Bridge Commons

1.5.3

Frontend API Backend

1.6.3 ⬆

Frontend Extension

1.1.4

Reference-Bridge-Implementations

Bridge Version

Mock-o-Merce-Bridge

1.8.3

BigCommerce-Bridge

1.8.3

SAP Commerce Cloud-Bridge

1.7.3

Spryker Commerce OS-Bridge

1.6.3

Salesforce Commerce Cloud-Bridge

1.4.3

Frontend API

NPM Package Version

fcecom-frontend-api-client

0.11.0 ⬆

fcecom-frontend-api-server

0.11.0 ⬆

General information
This release was tested with the following versions:

Product Version

FirstSpirit server

2023-08 (5.2.230812)

Java

17

CaaS Connect (FSM)

3.32.2

Omnichannel Manager

2.4.7

Basic Workflows

1.3.4.972

Deprecations

Artifact Functionality Deprecated with Removed in

Bridge API

Support for getById endpoints

Release 22.4.0

April 2023

Bridge API

Support for Contentpages endpoints

Release 22.10.1

Expected for July 2023

FCECOM-698 - Frontend API can now handle FirstSpirit Driven Pages
As findPage() only returns one page in any case, it now returns a FindPageItem instead of FindPageResponse.

setElement() now can differentiate between Shop Driven and FirstSpirit Driven Pages. Please check the documentation on how to use setElement(). Shop Driven Pages remain default and have no need for re-implementation.

FCECOM-697 - Add Translation Studio button in Content Creator, if it is installed
To work properly the FirstSpirit project must include the following script with the name tpp_list_projectapps:

import de.espirit.firstspirit.access.AdminService;
import de.espirit.firstspirit.access.ServicesBroker;
import de.espirit.firstspirit.agency.ModuleAdminAgent;
import de.espirit.firstspirit.agency.ProjectAgent;
import de.espirit.firstspirit.module.descriptor.ComponentDescriptor;

/**
 * Sample usage:
 * const projectAppsNames = await TPP_SNAP.execute('script:tpp_list_projectapps');
 *
 */

projectApps = new ArrayList();
projectId = context.requireSpecialist(ProjectAgent.TYPE).getId();
project = context.requireSpecialist(ServicesBroker.TYPE)
  .getService(AdminService.class).getProjectStorage().getProject(projectId);
moduleAdmin = context.requireSpecialist(ModuleAdminAgent.TYPE);

for (module : moduleAdmin.getModules()) {
  for (component : module.getComponents()) {
    if (ComponentDescriptor.Type.PROJECTAPP.equals(component.getType())) {
      if (moduleAdmin.getProjectAppUsages(module.getName(), component.getName()).contains(project)) {
        projectApps.add(component.getName());
      }
    }
  }
}

return projectApps;

Fixed issues

ID Description

FCECOM-720

FirstSpirit Connect for Commerce (fsm) | Fixed JSON conversion for Data Access Plugins.

FCECOM-670

fcecom-frontend-api-client | Removed redundant method call.

New features

ID Description

FCECOM-698

fcecom-frontend-api-client, fcecom-frontend-api-server | Frontend API can now handle FirstSpirit Driven Pages.

FCECOM-697

fcecom-frontend-api-client | Add Translation Studio button in Content Creator, if it is installed.

Version 23.7.0

Update Notice

The FirstSpirit Connect for Commerce integration is a bundle of software components. The table below lists all components and their versions.

Components
This release contains the following components.
Versions marked with an arrow (⬆) changed since the last release.

Components Version

FirstSpirit Connect for Commerce (fsm)

2.5.5 ⬆

Reference project

1.1.7

FirstSpirit Connect for Commerce - Bridge API

2.2.2

Bridge Commons

1.5.3 ⬆

Frontend API Backend

1.6.2 ⬆

Frontend Extension

1.1.4

Reference-Bridge-Implementations

Bridge Version

Mock-o-Merce-Bridge

1.8.3 ⬆

BigCommerce-Bridge

1.8.3 ⬆

SAP Commerce Cloud-Bridge

1.7.3 ⬆

Spryker Commerce OS-Bridge

1.6.3 ⬆

Salesforce Commerce Cloud-Bridge

1.4.3 ⬆

Frontend API

NPM Package Version

fcecom-frontend-api-client

0.10.0 ⬆

fcecom-frontend-api-server

0.10.0 ⬆

General information
This release was tested with the following versions:

Product Version

FirstSpirit server

2023-07 (5.2.230707)

Java

17

CaaS Connect (FSM)

3.31.1

Omnichannel Manager

2.4.7

Basic Workflows

1.3.4.972

Deprecations

Artifact Functionality Deprecated with Removed in

Bridge API

Support for getById endpoints

Release 22.4.0

April 2023

Bridge API

Support for Contentpages endpoints

Release 22.10.1

Expected for July 2023

FCECOM-619 - All bridges and Bridge Commons | Updated required node version for the bridges to 18 and improved error handling
Node 18 is recommended for running the bridges, as the current compatibility with Node 14 cannot be guaranteed in future releases.

Fixed issues

ID Description

FCECOM-693

fcecom-frontend-api-client | Fixed a bug where having multiple slots in a page created duplicate 'add content' buttons.

FCECOM-619

All bridges and Bridge Commons | Updated required node version for the bridges to 18 and improved error handling.

New features

ID Description

FCECOM-680

FirstSpirit Connect for Commerce (fsm) | Improved error handling: In cases where a required parameter was not provided, the error message now contains the name of the missing parameter.

FCECOM-637

FirstSpirit Connect for Commerce (fsm) | Removed usage of methods not provided by the FirstSpirit API.

FCECOM-562

fcecom-frontend-api-client | Added a removeHook() function to remove registered hooks. That enables cleanup e.g. on the site exit or component re-rendering.

FCECOM-120

Documentation | Added information about Bridge and Frontend API to concepts chapter.

Version 23.6.1

Update Notice

The FirstSpirit Connect for Commerce integration is a bundle of software components. The table below lists all components and their versions.

Components
This release contains the following components.
Versions marked with an arrow (⬆) changed since the last release.

Components Version

FirstSpirit Connect for Commerce (fsm)

2.5.4

Reference project

1.1.7

FirstSpirit Connect for Commerce - Bridge API

2.2.2 ⬆

Bridge Commons

1.5.2 ⬆

Frontend API Backend

1.6.1

Frontend Extension

1.1.4

Reference-Bridge-Implementations

Bridge Version

Mock-o-Merce-Bridge

1.8.2 ⬆

BigCommerce-Bridge

1.8.2 ⬆

SAP Commerce Cloud-Bridge

1.7.2 ⬆

Spryker Commerce OS-Bridge

1.6.2 ⬆

Salesforce Commerce Cloud-Bridge

1.4.2 ⬆

Frontend API

NPM Package Version

fcecom-frontend-api-client

0.9.3

fcecom-frontend-api-server

0.9.3

General information
This release was tested with the following versions:

Product Version

FirstSpirit server

2023-06 (5.2.230607)

Java

17

CaaS Connect (FSM)

3.28.13

Omnichannel Manager

2.4.7

Basic Workflows

1.3.4.972

Deprecations

Artifact Functionality Deprecated with Removed in

Bridge API

Support for getById endpoints

Release 22.4.0

April 2023

Bridge API

Support for Contentpages endpoints

Release 22.10.1

Expected for July 2023

Fixed issues

ID Description

FCECOM-620

Documentation | Removed FSXA references from documentation.

FCECOM-465

Documentation | Translated untranslated parts in English documentation.

New features

ID Description

FCECOM-335

Documentation | Added missing information about the mapping endpoint.

Version 23.6.0

Update Notice

The FirstSpirit Connect for Commerce integration is a bundle of software components. The table below lists all components and their versions.

Components
This release contains the following components.
Versions marked with an arrow (⬆) changed since the last release.

Components Version

FirstSpirit Connect for Commerce (fsm)

2.5.4 ⬆

Reference project

1.1.7

FirstSpirit Connect for Commerce - Bridge API

2.2.1

Bridge Commons

1.5.1

Frontend API Backend

1.6.1

Frontend Extension

1.1.4

Reference-Bridge-Implementations

Bridge Version

Mock-o-Merce-Bridge

1.8.1

BigCommerce-Bridge

1.8.1

SAP Commerce Cloud-Bridge

1.7.1

Spryker Commerce OS-Bridge

1.6.1

Salesforce Commerce Cloud-Bridge

1.4.1

Frontend API

NPM Package Version

fcecom-frontend-api-client

0.9.3

fcecom-frontend-api-server

0.9.3

General information
This release was tested with the following versions:

Product Version

FirstSpirit server

2023-06 (5.2.230607)

Java

17

CaaS Connect (FSM)

3.28.13

Omnichannel Manager

2.4.7

Basic Workflows

1.3.4.972

Deprecations

Artifact Functionality Deprecated with Removed in

Bridge API

Support for getById endpoints

Release 22.4.0

April 2023

Bridge API

Support for Contentpages endpoints

Release 22.10.1

Expected for July 2023

Fixed issues

ID Description

FCECOM-672

FirstSpirit Connect for Commerce (fsm) | Re-added accidentally removed module sources to GitHub

New features

ID Description

FCECOM-581

Documentation | Adjusted product name in documentation.

Version 23.5.1

Highlights

FCECOM-653 - FirstSpirit Module build files on GitHub

The FirstSpirit Module (fsm) for Connect for Commerce is now available on GitHub.

Update Notice

The FirstSpirit Connect for Commerce integration is a bundle of software components. The table below lists all components and their versions.

Components
This release contains the following components.
Versions marked with an arrow (⬆) changed since the last release.

Components Version

FirstSpirit Connect for Commerce (fsm)

2.5.3 ⬆

Reference project

1.1.7

FirstSpirit Connect for Commerce - Bridge API

2.2.1

Bridge Commons

1.5.1

Frontend API Backend

1.6.1

Frontend Extension

1.1.4

Reference-Bridge-Implementations

Bridge Version

Mock-o-Merce-Bridge

1.8.1

BigCommerce-Bridge

1.8.1

SAP Commerce Cloud-Bridge

1.7.1

Spryker Commerce OS-Bridge

1.6.1

Salesforce Commerce Cloud-Bridge

1.4.1

Frontend API

NPM Package Version

fcecom-frontend-api-client

0.9.3 ⬆

fcecom-frontend-api-server

0.9.3 ⬆

General information
This release was tested with the following versions:

Product Version

FirstSpirit server

2023-06 (5.2.230607)

Java

17

CaaS Connect (FSM)

3.28.13

Omnichannel Manager

2.4.7

Basic Workflows

1.3.4.972

Deprecations

Artifact Functionality Deprecated with Removed in

Bridge API

Support for getById endpoints

Release 22.4.0

April 2023

Bridge API

Support for Contentpages endpoints

Release 22.10.1

Expected for July 2023

New features

ID Description

FCECOM-653

FirstSpirit Connect for Commerce (fsm) | Published module build files to GitHub.

FCECOM-596

fcecom-frontend-api-client | Added integration into static pages.

Version 23.5.0

Update Notice

The FirstSpirit Connect for Commerce integration is a bundle of software components. The table below lists all components and their versions.

Components
This release contains the following components.
Versions marked with an arrow (⬆) changed since the last release.

Components Version

FirstSpirit Connect for Commerce (fsm)

2.5.2 ⬆

Reference project

1.1.7 ⬆

FirstSpirit Connect for Commerce - Bridge API

2.2.1 ⬆

Bridge Commons

1.5.1 ⬆

Frontend API Backend

1.6.1 ⬆

Frontend Extension

1.1.4 ⬆

Reference-Bridge-Implementations

Bridge Version

Mock-o-Merce-Bridge

1.8.1 ⬆

BigCommerce-Bridge

1.8.1 ⬆

SAP Commerce Cloud-Bridge

1.7.1 ⬆

Spryker Commerce OS-Bridge

1.6.1 ⬆

Salesforce Commerce Cloud-Bridge

1.4.1 ⬆

Frontend API

NPM Package Version

fcecom-frontend-api-client

0.9.2 ⬆

fcecom-frontend-api-server

0.9.2 ⬆

General information
This release was tested with the following versions:

Product Version

FirstSpirit server

2023-04 (5.2.230410)

Java

17

CaaS Connect (FSM)

3.28.10

Omnichannel Manager

2.4.7

Basic Workflows

1.3.4.972

Fixed issues

ID Description

FCECOM-650

FirstSpirit Connect for Commerce (fsm) | Fixed an error during the update of the project component.

New features

ID Description

FCECOM-524

All Connect for Commerce Artifacts | Added third-party licensing information.

FCECOM-374

FirstSpirit Connect for Commerce (fsm) | Module source code published on Github: https://github.com/e-Spirit/fcecom-fsm

Version 23.4.1

Update Notice

The FirstSpirit Connect for Commerce integration is a bundle of software components. The table below lists all components and their versions.

Components
This release contains the following components.
Versions marked with an arrow (⬆) changed since the last release.

Components Version

FirstSpirit Connect for Commerce (fsm)

2.5.1 ⬆

Reference project

1.1.6

FirstSpirit Connect for Commerce - Bridge API

2.2.0

Bridge Commons

1.5.0

Frontend API Backend

1.6.0

Frontend Extension

1.1.3

Reference-Bridge-Implementations

Bridge Version

Mock-o-Merce-Bridge

1.8.0

BigCommerce-Bridge

1.8.0

SAP Commerce Cloud-Bridge

1.7.0

Spryker Commerce OS-Bridge

1.6.0

Salesforce Commerce Cloud-Bridge

1.4.0

Frontend API

NPM Package Version

fcecom-frontend-api-client

0.9.1 ⬆

fcecom-frontend-api-server

0.9.1 ⬆

General information
This release was tested with the following versions:

Product Version

FirstSpirit server

2023-05 (5.2.230509)

Java

17

CaaS Connect (FSM)

3.28.13

Omnichannel Manager

2.4.7

Basic Workflows

1.3.4.972

Fixed issues

ID Description

FCECOM-642

FirstSpirit Connect for Commerce (fsm) | Fixed an error when reading a malformed configuration file.

FCECOM-617

FirstSpirit Connect for Commerce (fsm) | Fixed a bug that resulted in an empty summary dialog when a bridge connection check failed for some reason.

FCECOM-611

FirstSpirit Connect for Commerce (fsm) | Visibility of reports in SiteArchitect restored.

New features

ID Description

FCECOM-503

fcecom-frontend-api-server | Removed reference to FSXA from Express.js handlers.

Version 23.4.0

Update Notice

The FirstSpirit Connect for Commerce integration is a bundle of software components. The table below lists all components and their versions.

Components
This release contains the following components.
Versions marked with an arrow (⬆) changed since the last release.

Components Version

FirstSpirit Connect for Commerce (fsm)

2.5.0 ⬆

Reference project

1.1.6

FirstSpirit Connect for Commerce - Bridge API

2.2.0

Bridge Commons

1.5.0

Frontend API Backend

1.6.0 ⬆

Frontend Extension

1.1.3

Reference-Bridge-Implementations

Bridge Version

Mock-o-Merce-Bridge

1.8.0

BigCommerce-Bridge

1.8.0

SAP Commerce Cloud-Bridge

1.7.0

Spryker Commerce OS-Bridge

1.6.0

Salesforce Commerce Cloud-Bridge

1.4.0

Frontend API

NPM Package Version

fcecom-frontend-api-client

0.9.0 ⬆

fcecom-frontend-api-server

0.9.0 ⬆

General information
This release was tested with the following versions:

Product Version

FirstSpirit server

2023-04 (5.2.230410)

Java

17

CaaS Connect (FSM)

3.28.10

Omnichannel Manager

2.4.7

Basic Workflows

1.3.4.972

Fixed issues

ID Description

FCECOM-597

fcecom-frontend-api-server | Closing potential security holes by updating dependencies.

FCECOM-572

FirstSpirit Connect for Commerce (fsm) | Fixed a bug displaying only placeholders in some error messages.

FCECOM-567

fcecom-frontend-api-client | Fixed incorrect titles in API documentation.

FCECOM-479

FirstSpirit Connect for Commerce (fsm) | Reduced error-proneness during page creation.

FCECOM-468

FirstSpirit Connect for Commerce (fsm) | Added error handling in case the ContentCreator extension url is missing.

New features

ID Description

FCECOM-594

FirstSpirit Connect for Commerce (fsm) | Added caching of the project component configuration.

FCECOM-474

fcecom-frontend-api-client | Improved error handling.

FCECOM-425

FirstSpirit Connect for Commerce (fsm) | HTTP communication with the Bridge is now running as a service on the FirstSpirit server.

Version 23.3.0

Update Notice

The FirstSpirit Connect for Commerce integration is a bundle of software components. The table below lists all components and their versions.

Components
This release contains the following components.
Versions marked with an arrow (⬆) changed since the last release.

Components Version

FirstSpirit Connect for Commerce (fsm)

2.4.0 ⬆

Reference project

1.1.6

FirstSpirit Connect for Commerce - Bridge API

2.2.0

Bridge Commons

1.5.0 ⬆

Frontend API Backend

1.5.0

Frontend Extension

1.1.3 ⬆

Reference-Bridge-Implementations

Bridge Version

Mock-o-Merce-Bridge

1.8.0 ⬆

BigCommerce-Bridge

1.8.0 ⬆

SAP Commerce Cloud-Bridge

1.7.0 ⬆

Spryker Commerce OS-Bridge

1.6.0 ⬆

Salesforce Commerce Cloud-Bridge

1.4.0 ⬆

Frontend API

NPM Package Version

fcecom-frontend-api-client

0.8.0

fcecom-frontend-api-server

0.8.0

General information
This release was tested with the following versions:

Product Version

FirstSpirit server

2023-03 (5.2.230314)

Java

17

CaaS Connect (FSM)

3.28.6

Omnichannel Manager

2.4.7

Basic Workflows

1.3.4.972

New features

ID Description

FCECOM-363

FirstSpirit Connect for Commerce (fsm) | The Project App Configuration has been made more clearly arranged.

FCECOM-356

Frontend Extensions | Updated documentation.

FCECOM-246

Bridge Commons, Bridge implementations | Improved Logging.

Version 23.1.2

Highlights

Frontend API Beta Release
The Frontend API is a TypeScript based API and complements FirstSpirit Connect for Commerce with the functionality to create Shop Driven Product-, Category-, and Contentpages and to retrieve their data from the CaaS.

It consists of two packages:

  1. fcecom-frontend-api-client for the integration in the client-side JavaScript - this package provides the API methods

  2. fcecom-frontend-api-server for installation in a backend service - this package is responsible for the communication with the CaaS

Information on how to use the API can be found in the documentation.

Update Notice

The FirstSpirit Connect for Commerce integration is a bundle of software components. The table below lists all components and their versions.

Components
This release contains the following components.
Versions marked with an arrow (⬆) changed since the last release.

Components Version

FirstSpirit Connect for Commerce (fsm)

2.3.0 ⬆

Reference project

1.1.6

FirstSpirit Connect for Commerce - Bridge API

2.2.0

Bridge Commons

1.4.0 ⬆

Frontend API Backend

1.5.0 ⬆

Frontend Extension

1.1.2

Reference-Bridge-Implementations

Bridge Version

Mock-o-Merce-Bridge

1.7.0 ⬆

BigCommerce-Bridge

1.7.0 ⬆

SAP Commerce Cloud-Bridge

1.6.0 ⬆

Spryker Commerce OS-Bridge

1.5.0 ⬆

Salesforce Commerce Cloud-Bridge

1.3.0 ⬆

Frontend API

NPM Package Version

fcecom-frontend-api-client

0.8.0 ⬆

fcecom-frontend-api-server

0.8.0 ⬆

General information
This release was tested with the following versions:

Product Version

FirstSpirit server

2023-01 (5.2.230106)

Java

17

CaaS Connect (FSM)

3.27.3

Omnichannel Manager

2.4.6

Basic Workflows

1.3.4.972

Fixed issues

ID Description

FCECOM-564

fcecom-bridge-api-sap-commerce-cloud | Fixed an error where the content report did not display the report item labels.

New features

ID Description

FCECOM-568

fcecom-frontend-api-client, fcecom-frontend-api-server | Added findElement to API.

FCECOM-559

fcecom-frontend-api-client | Optimised status provider setting and editorial buttons.

FCECOM-557

fcecom-frontend-api | Added Getting Started to API documentation.

FCECOM-543

Bridge Commons, SAP Commerce Cloud-Bridge, BigCommerce-Bridge | Mapping of errors produced by the shop system to a format the FirstSpirit module can understand.

FCECOM-541

FirstSpirit Connect for Commerce (fsm), Bridge Commons, BigCommerce-Bridge, SAP Commerce Cloud-Bridge | Errors that occur during page creation are now passed on to the frontend in a meaningful form including unique error codes.

FCECOM-452

FirstSpirit Connect for Commerce (fsm) | The creation of a content page in the shop system via the bridge can now be deactivated via the project component.

FCECOM-411

fcecom-frontend-api-client | Improved error handling.

FCECOM-287

FirstSpirit Connect for Commerce (fsm) | The FirstSpirit module now adds the URL-encoded display name to the path object when creating a content page via the bridge.

Version 23.1.1

Update Notice

The FirstSpirit Connect for Commerce integration is a bundle of software components. The table below lists all components and their versions.

Components
This release contains the following components.
Versions marked with an arrow (⬆) changed since the last release.

Components Version

FirstSpirit Connect for Commerce (fsm)

2.2.0

Reference project

1.1.6

FirstSpirit Connect for Commerce - Bridge API

2.2.0

Bridge Commons

1.3.0

Frontend API Backend

1.4.0 ⬆

Frontend Extension

1.1.2

Reference-Bridge-Implementations

Bridge Version

Mock-o-Merce-Bridge

1.6.0

BigCommerce-Bridge

1.6.0

SAP Commerce Cloud-Bridge

1.5.0

Spryker Commerce OS-Bridge

1.4.0

Salesforce Commerce Cloud-Bridge

1.2.0

Frontend API

NPM Package Version

fcecom-frontend-api-client

0.7.0 ⬆

fcecom-frontend-api-server

0.7.0 ⬆

General information
This release was tested with the following versions:

Product Version

FirstSpirit server

2023-01 (5.2.230106)

Java

17

CaaS Connect (FSM)

3.27.3

Omnichannel Manager

2.4.6

Basic Workflows

1.3.4.972

Fixed issues

ID Description

FCECOM-552

fcecom-frontend-api-client | Fixed an issue with configuration verification. From now on it is again possible to create the API key configuration in all supported variations.

New features

ID Description

FCECOM-504

fcecom-frontend-api-backend | Added the ability to provide configuration via environment variables.

FCECOM-500

fcecom-frontend-api-server | It is now possible to set a default locale. This makes it easier to use the package with implementations other than the Frontend API.

FCECOM-493

fcecom-frontend-api-client | Rollup.js has been replaced by Webpack as a build tool.

Version 23.1.0

Update Notice

The FirstSpirit Connect for Commerce integration is a bundle of software components. The table below lists all components and their versions.

Components
This release contains the following components.
Versions marked with an arrow (⬆) changed since the last release.

Components Version

FirstSpirit Connect for Commerce (fsm)

2.2.0 ⬆

Reference project

1.1.6

FirstSpirit Connect for Commerce - Bridge API

2.2.0 ⬆

Bridge Commons

1.3.0 ⬆

Frontend API Backend

1.3.0 ⬆

Frontend Extension

1.1.2 ⬆

Reference-Bridge-Implementations

Bridge Version

Mock-o-Merce-Bridge

1.6.0 ⬆

BigCommerce-Bridge

1.6.0 ⬆

SAP Commerce Cloud-Bridge

1.5.0 ⬆

Spryker Commerce OS-Bridge

1.4.0 ⬆

Salesforce Commerce Cloud-Bridge

1.2.0 ⬆

Frontend API

NPM Package Version

fcecom-frontend-api-client

0.6.0 ⬆

fcecom-frontend-api-server

0.6.0 ⬆

General information
This release was tested with the following versions:

Product Version

FirstSpirit server

2022-13 (5.2.221307)

Java

17

CaaS Connect (FSM)

3.27.2

Omnichannel Manager

2.4.5

Basic Workflows

1.3.4.972

FCECOM-545 Frontend API / frontend extension part of Content Page creation
When using the Frontend API, the provisioning of the ContentCreator Extension is no longer required. The ContentCreator Extension field in the Connect for Commerce Project App configuration must then be left empty. However, if the Frontend API is not used, the need for the provisioning of the ContentCreator Extension remains.

New features

ID Description

FCECOM-545

fcecom-frontend-api-client, FirstSpirit Connect for Commerce (fsm) | Removed the need to use the Content Creator Extensions.

FCECOM-534

FirstSpirit Connect for Commerce (fsm) | Support for both the new and the old endpoints for content pages.

FCECOM-533

Bridge Commons, Bridge implementations, Bridge API | New Content endpoints have been added to replace the deprecated ContentPages endpoints.

Version 22.12.2

Update Notice

The FirstSpirit Connect for Commerce integration is a bundle of software components. The table below lists all components and their versions.

Components
This release contains the following components.
Versions marked with an arrow (⬆) changed since the last release.

Components Version

FirstSpirit Connect for Commerce (fsm)

2.1.1

Reference project

1.1.6

FirstSpirit Connect for Commerce - Bridge API

2.1.4

Bridge Commons

1.2.0

Frontend API Backend

1.2.0 ⬆

Reference-Bridge-Implementations

Bridge Version

Mock-o-Merce-Bridge

1.5.0

BigCommerce-Bridge

1.5.0

SAP Commerce Cloud-Bridge

1.4.0

Spryker Commerce OS-Bridge

1.3.0

Salesforce Commerce Cloud-Bridge

1.1.0

Frontend API

NPM Package Version

fcecom-frontend-api-client

0.5.0 ⬆

fcecom-frontend-api-server

0.5.0 ⬆

General information
This release was tested with the following versions:

Product Version

FirstSpirit server

2022-13 (5.2.221307)

Java

17

CaaS Connect (FSM)

3.27.2

Omnichannel Manager

2.4.5

Basic Workflows

1.3.4.972

Unified Documentation · MonoRepo
From now on, the compatibility between fcecom-frontend-api-client and fcecom-frontend-api-server is represented by the common version number. Accordingly, the same versions must be installed in each package in order to ensure perfect functionality.

New features

ID Description

FCECOM-546

fcecom-frontend-api-server | The Frontend API Documentation now includes server package references.

FCECOM-521

fcecom-frontend-api-client | Added warning when accessing TPP and not in preview

FCECOM-520

fcecom-frontend-api-server | Added a check if a suitable Node.js version is used

FCECOM-511

fcecom-frontend-api-server | The versions of the fcecom-frontend-api packages for the client and server part are using the same version from now on. This simplifies compatibility checking.

Version 22.12.1

Update Notice

The FirstSpirit Connect for Commerce integration is a bundle of software components. The table below lists all components and their versions.

Components
This release contains the following components.
Versions marked with an arrow (⬆) changed since the last release.

Components Version

FirstSpirit Connect for Commerce (fsm)

2.1.1 ⬆

Reference project

1.1.6

FirstSpirit Connect for Commerce - Bridge API

2.1.4

Bridge Commons

1.2.0

Frontend API Backend

1.1.0

Reference-Bridge-Implementations

Bridge Version

Mock-o-Merce-Bridge

1.5.0

BigCommerce-Bridge

1.5.0

SAP Commerce Cloud-Bridge

1.4.0

Spryker Commerce OS-Bridge

1.3.0

Salesforce Commerce Cloud-Bridge

1.1.0

Frontend API

NPM Package Version

fcecom-frontend-api-client

0.4.0 ⬆

fcecom-frontend-api-server

0.2.0

General information
This release was tested with the following versions:

Product Version

FirstSpirit server

2022-13 (5.2.221307)

Java

17

CaaS Connect (FSM)

3.27.2

Omnichannel Manager

2.4.5

Basic Workflows

1.3.4.972

Fixed issues

ID Description

FCECOM-519

FirstSpirit Connect for Commerce (fsm) | Fixed a bug which caused that not all report items were loaded correctly

FCECOM-497

FirstSpirit Connect for Commerce (fsm) | Fixed a bug, where a missing project component of this module could cause reports in other modules to crash

New features

ID Description

FCECOM-515

fcecom-frontend-api-client | Added a wrapper to enable the implementation of hooks for the preview

FCECOM-514

fcecom-frontend-api-client | Added parsing of slots to Frontend API

FCECOM-417

fcecom-frontend-api-client | Added functionality to create an 'Add content' button

Version 22.12.0

Update Notice

The FirstSpirit Connect for Commerce integration is a bundle of software components. The table below lists all components and their versions.

Components
This release contains the following components.
Versions marked with an arrow (⬆) changed since the last release.

Components Version

FirstSpirit Connect for Commerce (fsm)

2.1.0 ⬆

Reference project

1.1.6

FirstSpirit Connect for Commerce - Bridge API

2.1.4

Bridge Commons

1.2.0 ⬆

Frontend Extension

1.1.0 ⬆

Reference-Bridge-Implementations

Bridge Version

Mock-o-Merce-Bridge

1.5.0 ⬆

BigCommerce-Bridge

1.5.0 ⬆

SAP Commerce Cloud-Bridge

1.4.0 ⬆

Spryker Commerce OS-Bridge

1.3.0 ⬆

Salesforce Commerce Cloud-Bridge

1.1.0 ⬆

Frontend API

NPM Package Version

fcecom-frontend-api-client

0.3.0

fcecom-frontend-api-server

0.2.0

General information
This release was tested with the following versions:

Product Version

FirstSpirit server

2022-12 (5.2.221209)

Java

11

CaaS Connect (FSM)

3.26.1

Omnichannel Manager

2.4.5

Basic Workflows

1.3.4.972

FCECOM-478 - Unifying bridge behaviour regarding missing parameters
Some API endpoints require that certain parameters are existent (e.g. at least one ID when using the /ids/ endpoints). If one if these required parameters is missing, the server will respond with a HTTP 400 error and a message describing what is missing.

Fixed issues

ID Description

FCECOM-462

FirstSpirit Connect for Commerce (fsm) | Bugfix in HTTP Client configuration

FCECOM-430

Bridge Commons, Bridge implementations | Adjusted error handling and fixed an error with false 200 status codes

New features

ID Description

FCECOM-495

Frontend Extension | Provide simple Express server for serving the ContentCreator extension file

FCECOM-478

FirstSpirit Connect for Commerce (fsm), Bridge Commons, BigCommerce-Bridge | Align handling of invalid parameters passed to bridges

Version 22.11.3

Update Notice

The FirstSpirit Connect for Commerce integration is a bundle of software components. The table below lists all components and their versions.

Components
This release contains the following components.
Versions marked with an arrow (⬆) changed since the last release.

Components Version

FirstSpirit Connect for Commerce (fsm)

2.0.2

Reference project

1.1.6

FirstSpirit Connect for Commerce - Bridge API

2.1.4

Bridge Commons

1.1.3

Reference-Bridge-Implementations

Bridge Version

Mock-o-Merce-Bridge

1.4.4

BigCommerce-Bridge

1.4.5

SAP Commerce Cloud-Bridge

1.3.3

Spryker Commerce OS-Bridge

1.2.4

Salesforce Commerce Cloud-Bridge

1.0.0

Frontend API

NPM Package Version

fcecom-frontend-api-client

0.3.0 ⬆

fcecom-frontend-api-server

0.2.0 ⬆

General information
This release was tested with the following versions:

Product Version

FirstSpirit server

2022-12 (5.2.221208)

Java

11

CaaS Connect (FSM)

3.25.7

Omnichannel Manager

2.4.5

Basic Workflows

1.3.4.972

FCECOM-490 - General restructuring and code improvements
fcecom-frontend-api-client, fcecom-frontend-api-server and fcecom-frontend-api-backend have been reworked and are not backward compatible. These libraries have to be updated.
They can be found here: fcecom-frontend-api-client, fcecom-frontend-api-server and fcecom-frontend-api-backend
Please refer to the documentation.

New features

ID Description

FCECOM-490

fcecom-frontend-api-client, fcecom-frontend-api-server | General restructuring and code improvements

FCECOM-394

Documentation | Updated design of Frontend API Doc page

Version 22.11.2

Highlights

Salesforce Commerce Cloud bridge is now available
You can view our reference implementation on Github. Please contact us for more information.

Important Notice
Due to OCAPI restrictions, the following endpoints are not implemented in the bridge:

  • POST /contentpages

  • DELETE /contentpages/{contentId}

  • PUT /contentpages/{contentId}

  • GET /lookup-url

  • GET /storefront-url

Update Notice

The FirstSpirit Connect for Commerce integration is a bundle of software components. The table below lists all components and their versions.

Components
This release contains the following components.
Versions marked with an arrow (⬆) changed since the last release.

Components Version

FirstSpirit Connect for Commerce (fsm)

2.0.2

Reference project

1.1.6

FirstSpirit Connect for Commerce - Bridge API

2.1.4

Bridge Commons

1.1.3

Reference-Bridge-Implementations

Bridge Version

Mock-o-Merce-Bridge

1.4.4

BigCommerce-Bridge

1.4.5

SAP Commerce Cloud-Bridge

1.3.3

Spryker Commerce OS-Bridge

1.2.4

Salesforce Commerce Cloud-Bridge

1.0.0 ⬆

Frontend API

NPM Package Version

fcecom-frontend-api-client

0.2.0

fcecom-frontend-api-server

0.1.1

General information
This release was tested with the following versions:

Product Version

FirstSpirit server

2022-10 (5.2.221006)

Java

11

CaaS Connect (FSM)

3.25.7

Omnichannel Manager

2.4.5

Basic Workflows

1.3.4.972

New features

ID Description

FCECOM-54

Salesforce Commerce Cloud-Bridge | Initial release

Version 22.11.1

Update Notice

The FirstSpirit Connect for Commerce integration is a bundle of software components. The table below lists all components and their versions.

Components
This release contains the following components.
Versions marked with an arrow (⬆) changed since the last release.

Components Version

FirstSpirit Connect for Commerce (fsm)

2.0.2

Reference project

1.1.6 ⬆

FirstSpirit Connect for Commerce - Bridge API

2.1.4

Bridge Commons

1.1.3

Reference-Bridge-Implementations

Bridge Version

Mock-o-Merce-Bridge

1.4.4

BigCommerce-Bridge

1.4.5

SAP Commerce Cloud-Bridge

1.3.3

Spryker Commerce OS-Bridge

1.2.4

Frontend API

NPM Package Version

fcecom-frontend-api-client

0.2.0 ⬆

fcecom-frontend-api-server

0.1.1

General information
This release was tested with the following versions:

Product Version

FirstSpirit server

2022-10 (5.2.221006)

Java

11

CaaS Connect (FSM)

3.25.7

Omnichannel Manager

2.4.5

Basic Workflows

1.3.4.972

Fixed issues

ID Description

FCECOM-473

Reference project | Added empty configuration file

New features

ID Description

FCECOM-416

fcecom-frontend-api-client | Added createSection function

Version 22.11.0

Update Notice

The FirstSpirit Connect for Commerce integration is a bundle of software components. The table below lists all components and their versions.

Components
This release contains the following components.
Versions marked with an arrow (⬆) changed since the last release.

Components Version

FirstSpirit Connect for Commerce (fsm)

2.0.2 ⬆

Reference project

1.1.5

FirstSpirit Connect for Commerce - Bridge API

2.1.4

Bridge Commons

1.1.3

Reference-Bridge-Implementations

Bridge Version

Mock-o-Merce-Bridge

1.4.4

BigCommerce-Bridge

1.4.5

SAP Commerce Cloud-Bridge

1.3.3

Spryker Commerce OS-Bridge

1.2.4

Frontend API

NPM Package Version

fcecom-frontend-api-client

0.1.2

fcecom-frontend-api-server

0.1.1

General information
This release was tested with the following versions:

Product Version

FirstSpirit server

2022-10 (5.2.221006)

Java

11

CaaS Connect (FSM)

3.25.7

Omnichannel Manager

2.4.5

Basic Workflows

1.3.4.972

Fixed issues

ID Description

FCECOM-458

FirstSpirit Connect for Commerce (fsm) | Corrected log message

FCECOM-421

FirstSpirit Connect for Commerce (fsm) | Small Bugfixes

Version 22.10.1

Update Notice

The FirstSpirit Connect for Commerce integration is a bundle of software components. The table below lists all components and their versions.

Components
This release contains the following components.
Versions marked with an arrow (⬆) changed since the last release.

Components Version

FirstSpirit Connect for Commerce (fsm)

2.0.1

Reference project

1.1.5

FirstSpirit Connect for Commerce - Bridge API

2.1.4 ⬆

Bridge Commons

1.1.3 ⬆

Reference-Bridge-Implementations

Bridge Version

Mock-o-Merce-Bridge

1.4.4 ⬆

BigCommerce-Bridge

1.4.5 ⬆

SAP Commerce Cloud-Bridge

1.3.3 ⬆

Spryker Commerce OS-Bridge

1.2.4 ⬆

Frontend API

NPM Package Version

fcecom-frontend-api-client

0.1.2 ⬆

fcecom-frontend-api-server

0.1.1 ⬆

General information
This release was tested with the following versions:

Product Version

FirstSpirit server

2022-10 (5.2.221006)

Java

11

CaaS Connect (FSM)

3.25.7

Omnichannel Manager

2.4.5

Basic Workflows

1.3.4.972

FCECOM-450 - Added deprecation notice for ContentPages endpoint
The ContentPages endpoint will soon be deprecated. The endpoint will be replaced with similar functionality. With the release of the replacement implementation, the existing implementation will remain functional for six months. A migration guide will be provided with the replacement implementation.

FCECOM-383 - Frontend API alpha release
The Frontend API is a TypeScript based API and complements FirstSpirit Connect for Commerce with the functionality to create Shop Driven Product-, Category-, and Contentpages and to retrieve their data from the CaaS.

It consists of two packages:

  1. fcecom-frontend-api-client for the installation in the client-side JavaScript - this package provides the API methods

  2. fcecom-frontend-api-server for installation in the backend service - this package is used in the backend service and provides authentication to the CaaS

Information on how to use the API can be found in the documentation.

New features

ID Description

FCECOM-450

Added deprecation notice for ContentPages endpoint

FCECOM-383

Frontend API Alpha Release

Version 22.10.0

Update Notice

The FirstSpirit Connect for Commerce integration is a bundle of software components. The table below lists all components and their versions.

Components
This release contains the following components.
Versions marked with an arrow (⬆) changed since the last release.

Components Version

FirstSpirit Connect for Commerce (fsm)

2.0.1 ⬆

Reference project

1.1.5 ⬆

FirstSpirit Connect for Commerce - Bridge API

2.1.3

Bridge Commons

1.1.2

Reference-Bridge-Implementations

Bridge Version

Mock-o-Merce-Bridge

1.4.3

BigCommerce-Bridge

1.4.4 ⬆

SAP Commerce Cloud-Bridge

1.3.2

Spryker Commerce OS-Bridge

1.2.3

General information
This release was tested with the following versions:

Product Version

FirstSpirit server

2022-10 (5.2.221006)

Java

11

CaaS Connect (FSM)

3.25.7

Omnichannel Manager

2.4.5

Basic Workflows

1.3.4.972

Fixed issues

ID Description

FCECOM-435

Fixed categories/content mapping and delete content page endpoints in BigCommerce Bridge

FCECOM-426

Updated references to the Connect for Commerce FirstSpirit module in reference project

New features

ID Description

FCECOM-436

Expanded documentation on options for Content-Security-Policy

FCECOM-419

Added the possibility for lazy loading to the frontend-api-client by turning the TPPWrapperService into a chunk

FCECOM-409

Added executable to the FirstSpirit module for creating Shop Driven Pages

FCECOM-367

General refactoring of Bridge communication in the FirstSpirit module

Version 22.9.1

Update Notice

The FirstSpirit Connect for Commerce integration is a bundle of software components. The table below lists all components and their versions.

Components
This release contains the following components.
Versions marked with an arrow (⬆) changed since the last release.

Components Version

FirstSpirit Connect for Commerce (fsm)

2.0.0

Reference project

1.1.4 ⬆

FirstSpirit Connect for Commerce - Bridge API

2.1.3

Bridge Commons

1.1.2

Reference-Bridge-Implementations

Bridge Version

Mock-o-Merce-Bridge

1.4.3

BigCommerce-Bridge

1.4.3

SAP Commerce Cloud-Bridge

1.3.2

Spryker Commerce OS-Bridge

1.2.3

General information
This release was tested with the following versions:

Product Version

FirstSpirit server

2022-09 (5.2.220907)

Java

11

CaaS Connect (FSM)

3.25.3

Omnichannel Manager

2.4.4

Basic Workflows

1.3.4.972

Fixed issues

ID Description

FCECOM-420

Corrected reference of Product Data Access Plugin in input component

Version 22.9.0

Update Notice

The FirstSpirit Connect for Commerce integration is a bundle of software components. The table below lists all components and their versions.

Components
This release contains the following components.
Versions marked with an arrow (⬆) changed since the last release.

Components Version

FirstSpirit Connect for Commerce (fsm)

2.0.0 ⬆

Reference project

1.1.3 ⬆

FirstSpirit Connect for Commerce - Bridge API

2.1.3

Bridge Commons

1.1.2

Reference-Bridge-Implementations

Bridge Version

Mock-o-Merce-Bridge

1.4.3

BigCommerce-Bridge

1.4.3

SAP Commerce Cloud-Bridge

1.3.2

Spryker Commerce OS-Bridge

1.2.3

General information
This release was tested with the following versions:

Product Version

FirstSpirit server

2022-09 (5.2.220907)

Java

11

CaaS Connect (FSM)

3.25.3

Omnichannel Manager

2.4.4

Basic Workflows

1.3.4.972

FCECOM-371 - Renaming the technical identifiers of the module components

The renaming of the technical identifiers is a breaking change. To update the module, it must therefore first be completely uninstalled from the on-premises server before the new module version can be installed.

Fixed issues

ID Description

FCECOM-380

Removal of unused scripts in the reference project

FCECOM-350

Removed project local web apps

FCECOM-116

Set correct permissions for ProjectAdmins Group

New features

ID Description

FCECOM-371

Renaming the technical identifiers of the module components

Version 22.8.2

Update Notice

The FirstSpirit Connect for Commerce integration is a bundle of software components. The table below lists all components and their versions.

Components
This release contains the following components.
Versions marked with an arrow (⬆) changed since the last release.

Components Version

FirstSpirit Connect for Commerce (fsm)

1.1.4 ⬆

Reference project

1.1.2 ⬆

FirstSpirit Connect for Commerce - Bridge API

2.1.3 ⬆

Bridge Commons

1.1.2 ⬆

Reference-Bridge-Implementations

Bridge Version

Mock-o-Merce-Bridge

1.4.3 ⬆

BigCommerce-Bridge

1.4.3 ⬆

SAP Commerce Cloud-Bridge

1.3.2 ⬆

Spryker Commerce OS-Bridge

1.2.3 ⬆

General information
This release was tested with the following versions:

Product Version

FirstSpirit server

2022-08 (5.2.220807)

Java

11

CaaS Connect (FSM)

3.25.1

Omnichannel Manager

2.4.4

Basic Workflows

1.3.4.972

New features

ID Description

FCECOM-370

Extension of the return payload for the creation of a page

FCECOM-232

Updated company name to Crownpeak Technology GmbH

Version 22.8.1

Update Notice

The FirstSpirit Connect for Commerce integration is a bundle of software components. The table below lists all components and their versions.

Components
This release contains the following components.
Versions marked with an arrow (⬆) changed since the last release.

Components Version

FirstSpirit Connect for Commerce (fsm)

1.1.0

Reference project

1.1.1

FirstSpirit Connect for Commerce - Bridge API

2.1.2

Bridge Commons

1.1.1

Reference-Bridge-Implementations

Bridge Version

Mock-o-Merce-Bridge

1.4.2 ⬆

BigCommerce-Bridge

1.4.2 ⬆

SAP Commerce Cloud-Bridge

1.3.1 ⬆

Spryker Commerce OS-Bridge

1.2.2 ⬆

General information
This release was tested with the following versions:

Product Version

FirstSpirit server

2022-08 (5.2.220807)

Java

11

CaaS Connect (FSM)

3.25.1

Omnichannel Manager

2.4.4

Basic Workflows

1.3.4.972

Fixed issues

ID Description

FCECOM-375

Removed package-lock.json to fix problems with internal dependencies

Version 22.8.0

Update Notice

The FirstSpirit Connect for Commerce integration is a bundle of software components. The table below lists all components and their versions.

Components
This release contains the following components.
Versions marked with an arrow (⬆) changed since the last release.

Components Version

FirstSpirit Connect for Commerce (fsm)

1.1.0

Reference project

1.1.1 ⬆

FirstSpirit Connect for Commerce - Bridge API

2.1.2

Bridge Commons

1.1.1 ⬆

Reference-Bridge-Implementations

Bridge Version

Mock-o-Merce-Bridge

1.4.1 ⬆

BigCommerce-Bridge

1.4.1 ⬆

SAP Commerce Cloud-Bridge

1.3.0 ⬆

Spryker Commerce OS-Bridge

1.2.1 ⬆

General information
This release was tested with the following versions:

Product Version

FirstSpirit server

2022-08 (5.2.220807)

Java

11

CaaS Connect (FSM)

3.25.1

Omnichannel Manager

2.4.4

Basic Workflows

1.3.4.972

FCECOM-340 - Broken Error Handling in Bridge Commons

Please update the fcecom-bridge-commons npm module in your bridge implementations to the latest version.

npm i fcecom-bridge-commons@1.1.1

Fixed issues

ID Description

FCECOM-340

Fixed error handling in Bridge Commons

FCECOM-321

Added mapping from FirstSpirit page templates to SAP Commerce Cloud page templates

New features

ID Description

FCECOM-273

Added the pageId field to the page templates of the reference project to persist the ID of the store page

Version 22.7.0

Update Notice

The FirstSpirit Connect for Commerce integration is a bundle of software components. The table below lists all components and their versions.

Components
This release contains the following components.
Versions marked with an arrow (⬆) changed since the last release.

Components Version

FirstSpirit Connect for Commerce (fsm)

1.1.0

Reference project

1.1.0 ⬆

FirstSpirit Connect for Commerce - Bridge API

2.1.2 ⬆

fcecom-bridge-commons

1.1.0 ⬆

Reference-Bridge-Implementations

Bridge Version

Mock-o-Merce-Bridge

1.4.0 ⬆

BigCommerce-Bridge

1.4.0 ⬆

SAP Commerce Cloud-Bridge

1.2.0 ⬆

Spryker Commerce OS-Bridge

1.2.0 ⬆

General information
This release was tested with the following versions:

Product Version

FirstSpirit server

2022-07 (5.2.220710)

Java

11

CaaS Connect (FSM)

3.21.1

Omnichannel Manager

2.4.1

Basic Workflows

1.3.4.972

FCECOM-297 - Fix Security Issues in Bridges and Bridge Commons

Please update the fcecom-bridge-commons npm module in your bridge implementations to the latest version.

npm i fcecom-bridge-commons@1.1.0

New features

ID Description

FCECOM-317

Corrected response schemes in API documentation

FCECOM-297

Library replaced to address security issues

FCECOM-283

Corrected description in API documentation

FCECOM-262

Reworked existing templates for the reference project

FCECOM-244

Refactoring bridges to comply with internal coding guidelines

Version 22.6.0

Update Notice

The FirstSpirit Connect for Commerce integration is a bundle of software components. The table below lists all components and their versions.

Components
This release contains the following components.
Versions marked with an arrow (⬆) changed since the last release.

Components Version

FirstSpirit Connect for Commerce (fsm)

1.1.0

Reference project

1.0.0

FirstSpirit Connect for Commerce - Bridge API

2.1.1 ⬆

fcecom-bridge-commons

1.0.2 ⬆

Mock-o-Merce bridge

1.3.1 ⬆

BigCommerce bridge

1.3.1 ⬆

SAP Commerce Cloud bridge

1.1.1 ⬆

Spryker Commerce OS bridge

1.1.1 ⬆

General information
This release was tested with the following versions:

Product Version

FirstSpirit server

2022-05 (5.2.220512)

Java

11

CaaS Connect (FSM)

3.22.1

Omnichannel Manager

2.4.1

Basic Workflows

1.3.4.972

FCECOM-260 - Extension of the bridge-commons library with a logger +.

The export object of the library has been extended to provide a logger. This makes an adjustment of the module import or its use necessary. The BridgeCore method is now provided encapsulated in an object. It is possible to use it in the following way:

const { BridgeCore } = require('fcecom-bridge-commons')

BridgeCore({
...
})

FCECOM-198 - Added FirstSpirit pageUid to PUT and POST requests in the SAP Commerce Cloud Bridge

In the SAP Commerce Cloud bridge, the /api/contentpages/{contentId} endpoint and the /api/contentpages endpoint now have the additional property pageUid in the request body.

Please check the API documentation for more information.

New features

ID Description

FCECOM-266

Updated the Readme files for the bridges

FCECOM-260

Extension of the bridge-commons library with a logger

FCECOM-198

Added FirstSpirit pageUid to PUT and POST requests in the SAP Commerce Cloud Bridge

Version 22.5.0

Highlights

SAP Commerce Cloud bridge is now available
You can view our reference implementation on Github. Please contact us for more information.

Spryker Commerce OS bridge is now available
You can view our reference implementation on Github. Please contact us for more information.

Update Notice

The FirstSpirit Connect for Commerce integration is a bundle of software components. The table below lists all components and their versions.

Components
This release contains the following components.
Versions marked with an arrow (⬆) changed since the last release.

Components Version

FirstSpirit Connect for Commerce (fsm)

1.1.0

Reference project

1.0.0

FirstSpirit Connect for Commerce - Bridge API

2.1.0

fcecom-bridge-commons

1.0.1 new

Mock-o-Merce bridge

1.3.0 ⬆

BigCommerce bridge

1.3.0 ⬆

SAP Commerce Cloud bridge

1.1.0 new

Spryker Commerce OS bridge

1.1.0 new

General information
This release was tested with the following versions:

Product Version

FirstSpirit server

2022-04 (5.2.220409)

Java

11

CaaS Connect (FSM)

3.20.0

Omnichannel Manager

2.4.1

Basic Workflows

1.3.4.972

FCECOM-242 - Moving generic code parts of the bridges to a separate module.
Code parts that are identical for all bridges were swapped out to the separate npm module fcecom-bridge-commons. This concerns the API definition, controllers and utils. The bridges for Mock-o-Merce, Spryker Commerce OS, BigCommerce and SAP Commerce Cloud have been modified accordingly to include the npm module.

New features

ID Description

FCECOM-242

Extract common parts of bridges into a separate module.

FCECOM-237

Release of the SAP Commerce Cloud bridge

FCECOM-91

Release of the Spryker Commerce OS bridge

Version 22.4.0

Highlights

BigCommerce bridge is now available
You can view our reference implementation on Github. Please contact us for more information.

Update Notice

The FirstSpirit Connect for Commerce integration is a bundle of software components. The table below lists all components and their versions.

Components
This release contains the following components.
Versions marked with an arrow (⬆) changed since the last release.

Components Version

FirstSpirit Connect for Commerce (fsm)

1.1.0 ⬆

Reference project

1.0.0

FirstSpirit Connect for Commerce - Bridge API

2.1.0 ⬆

mock-o-merce-bridge

1.1.0 ⬆

bigcommerce-bridge

1.0.0

General information
This release was tested with the following versions:

Product Version

FirstSpirit server

2022-04 (5.2.220409)

Java

11

CaaS Connect (FSM)

3.20.0

Omnichannel Manager

2.4.1

Basic Workflows

1.3.4.972

FCECOM-222 - get Categories/Products by ids" endpoints moved to unify endpoints

The /api/products/{productIds} endpoint was moved to /api/products/ids/{productIds} and the /api/categories/{categoryIds} endpoint was moved to /api/categories/ids/{categoryIds}.

The old endpoints were deprecated and will be removed in a future version.

Please check here for more information.

Fixed issues

ID Description

FCECOM-222

get Categories/Products by ids" endpoints moved to unify endpoints

New features

ID Description

FCECOM-236

Release of the BigCommerce bridge

Version 22.3.1

Update Notice

FCECOM-203 - Implemented new API endpoint by the bridge
The changes made to the bridge require version 1.0.2 or higher of the FirstSpirit Connect For Commerce module.

FCECOM-187 - Added new API endpoints and expand functionality of category report
The new FirstSpirit Module version requires the bridge to return a flat list from the /categories endpoint. If this is not the case, the categories report will stay empty.

The new /categories/tree endpoint is optional. If it is not present on the bridge, the additional drop down to filter products within the product report will be hidden.

The FirstSpirit Connect for Commerce integration is a bundle of software components. The table below lists all components and their versions.

Components
This release contains the following components.
Versions marked with an arrow (⬆) changed since the last release.

Components Version

FirstSpirit Connect for Commerce (fsm)

1.0.2 ⬆

Reference project

1.0.0

FirstSpirit Connect for Commerce - Bridge API

2.0.0 ⬆

mock-o-merce-bridge

1.0.1 ⬆

General information
This release was tested with the following versions:

Product Version

FirstSpirit server

2022-03 (5.2.220309)

Java

11

CaaS Connect (FSM)

3.19.12

Omnichannel Manager

2.4.1

Basic Workflows

1.3.4.972

New features

ID Description

FCECOM-203

Implemented new API endpoint for Mock-o-Merce bridge

FCECOM-187

Added new API endpoints and expand functionality of category report

FCECOM-139

Made path to ContentCreator extension script configurable

Version 22.3.0

Update Notice

The FirstSpirit Connect for Commerce integration is a bundle of software components. The table below lists all components and their versions.

Components
This release contains the following components.
Versions marked with an arrow (⬆) changed since the last release.

Components Version

FirstSpirit Connect for Commerce (fsm)

1.0.1 ⬆

Reference project

1.0.0

mock-o-merce-bridge

1.0.0

General information
This release was tested with the following versions:

Product Version

FirstSpirit server

2022-01 (5.2.220210)

Java

11

CaaS Connect (FSM)

3.19.12

Omnichannel Manager

2.4.1

Basic Workflows

1.3.4.972

Fixed issues

ID Description

FCECOM-179

Added unit tests

New features

ID Description

FCECOM-180

Minor changes within the documentation

FCECOM-152

Extension of the documentation by an explanation of the mapping of IDs

FCECOM-79

Added links to the FirstSpirit Connect API within the documentation.

Version 22.2.0

Highlights

Connect for Commerce is now available
Please contact us for more information.

Update Notice

The FirstSpirit Connect for Commerce integration is a bundle of software components. The table below lists all components and their versions.

Components
This release contains the following components.
Versions marked with an arrow (⬆) changed since the last release.

Components Version

FirstSpirit Connect for Commerce (fsm)

1.0.0

Reference project

1.0.0

FirstSpirit Connect for Commerce - Bridge API

1.0.0

mock-o-merce-bridge

1.0.0

General information
This release was tested with the following versions:

Product Version

FirstSpirit server

2022-02 (5.2.220210)

Java

11

CaaS Connect (FSM)

3.19.12

Omnichannel Manager

2.4.1

Basic Workflows

1.3.4.972

New features

ID Description

FCECOM-177

Added cloud default groups to reference project

FCECOM-164

Published documentation to docs.e-spirit.com

FCECOM-153

Deletion of a note from the documentation

FCECOM-87

Bridge API Documentation published

Version 22.1.1

New features

ID Description

FCECOM-128

Trial run of the release process

FCECOM-88

Created a bridge to Mock-o-merce

FCECOM-61

Added developer’s tasks to the documentation

Version 21.12.1

Fixed issues

ID Description

FCECOM-132

Added shoppable video to reference project

FCECOM-100

Fixed display error in category report

New features

ID Description

FCECOM-121

Added Basic Workflows to documentation

FCECOM-81

Added missing snippets and rules to reference project

FCECOM-70

Added storefront chapter

Version 21.11.1

Fixed issues

ID Description

FCECOM-102

Moved web apps to global configuration

Version 0.0.23

New features

ID Description

FCECOM-72

Create Mock-o-Merce as a standalone project

FCECOM-35

Fixed bug where initialization of a category with no children could fail

64. Help

The Technical Support of the Crownpeak Technology GmbH provides expert technical support covering any topic related to the FirstSpirit™ product. You can get and find more help concerning relevant topics in our community.

65. Disclaimer

This document is provided for information purposes only. Crownpeak Technology GmbH may change the contents hereof without notice. This document is not warranted to be error-free, nor subject to any other warranties or conditions, whether expressed orally or implied in law, including implied warranties and conditions of merchantability or fitness for a particular purpose. Crownpeak Technology GmbH specifically disclaims any liability with respect to this document and no contractual obligations are formed either directly or indirectly by this document. The technologies, functionality, services, and processes described herein are subject to change without notice.