Upgrading to Norce Commerce
A guide to what needs to be done to upgrade a Norce [Storm] client to Norce Commerce.
Version history
latest: 2024-09-19, more on functional changes and things of note.
History
version: 2025-06-13, Changes to Adyen Adapter and added mandatory header to Product feed
version: 2024-02-20, Added more detailed information
version: 2024-01-05, added more Norce Commerce details
version: 2023-10-12, removed order integration, still used in NC.
version: 2023-10-10, created
Up to date with security and technology versions
| Old technology | Use instead | Notes |
|---|---|---|
| Client certificates | Oauth2 tokens | Client certificate authentication was used for access to Storm API and is deprecated and will not be enabled in Norce Commerce. |
| Basic authentication | Oauth2 tokens | Basic authentication was used for access to Storm Connect and Query and will no be enabled in Norce Commerce. |
| SOAP Protocol | REST | SOAP gets deprecated for Norce Commerce Services, so the old StormAPIClient and its nuget package will not work at all in Norce Commerce. |
Up to date with API versions
The solution must use the latest versions of the API services.
| Old service | Use instead | Notes |
|---|---|---|
| Exportfeed Service | Product feeds | Service is deprecated, use product feeed service instead |
| Export API | Product feeds | Service is deprecated, use product feeed service instead |
| Old Admin | Current Admin | Old admin is deprecated |
| Goggle feeds/Facebook, etc | Product feeds | Old google or facebook exports are not supported, use product feeds with custom mappning to correct format. |
| Custom services and logic | Moved to external services | For example: ftp server hosting, custom integrations, etc. Contact us to get information about the current setup and if customer functionality exists |
| Storm Connect 3 | Storm Connect v4 | Service is deprecated, use Norce Commerce Connect v4 instead |
| Ignite imports | Storm Connect v4 | Service is deprecated, use Norce Commerce Connect v4 instead |
| Subscriptions (Recurring orders) | Build external services or swith to 3rd party | Some functionality will still exist in the API, but the actual business logic will be deprecated. |
| CDON Marketplace adapter | Build external service or switch to 3rd party | |
| Sitoo Adapter | Build external service or switch to 3rd party | |
| Voyado Adapter | Build external service or switch to 3rd party | |
| Adyen Adapter | Norce Checkout with Adyen adapter | For Adyen, the new Norce Checkout must be used, currently in beta. Contact Norce for more information. |
Functional changes to current services
Additionally there are some changes made to current services, primarily because of security concerns.
| Functionality | Use instead | Notes |
|---|---|---|
| Storm Event service bus | Use new Webhooks instead | It will not be possible to access Norce Commerce Azure Service bus directly, instead there will be webhooks instead. Read more here |
| Date stored in Local format | Date stored in UTC | On Iver, dates where stored in local format, while on Azure and Norce Commerce stores all date formats in UTC, see documentation for more details. |
| Optional header is now mandatory in Product Feed/ChannelService | Applicationid |
In Norce [Storm] Channel Service, the ApplicationId header information was optional, while on Norce Commerce it is mandatory, since all clients are sharded on the key. |
ApplicationId and ClientId change |
New Id's | On Iver, ClientId and ApplicationId where same on all environments (lab and production), but that is not the case for Norce Commerce. When the new clients are created on Stage and Production, they will get new numbers for ClientId and ApplicationId and they will not be the same with each-other either. |
Upgrade steps
Each client might have some different requirements for the upgrade process, but our basic setup of the project are as follows:
| Step | Action | Norce | Partner |
|---|---|---|---|
| - | Preparation | ||
| 1 | Thorough analysis of client solution, finding deprecated functionality | x | x |
| 2 | Implement the changes to the solution found in (1) | x | |
| 3 | Clean up the client data, remove old and unnecessary data, to make the move simpler (optional) | x | |
| 4 | Partner solution implement new functionality (Norce Event webhooks) | x | |
| 5 | Set up of new Norce Commerce clients | x | |
| 6 | Migration of Client data to Norce Commerce stage environment | x | |
| 7 | Changing end points to new stage environment (from lab) | x | |
| 8 | Verifying new Norce Commerce stage environment | x | x |
| - | When go-live | ||
| 9 | Norce closes the jobs and access to old prod | x | |
| 10 | Data migration from old prod to new | x | |
| 11 | Changing end point to new prod environment | x | |
| 12 | Verifying new Norce Commerce prod environment | x | x |
| 13 | Launch on Norce Commerce | x |