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

33. 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.

34. 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.