Here at Comerzzia we're living an intense growth process in different markets. This made necessary to standarize some key aspects to provide the easiest access to our great capabilities without caring which country, language or market our partners and retailers are operating.

 

We announce a bunch of changes affecting our REST API. As you know comerzzia platform provides a wide RESTfull service layer to allow integration of 3rd party solutions with every Unified Commerce module. As part of our internationalization strategy with strong R+D investment, beginning on version 5.0 we'll include an upgrade to 2.0 version of REST API catalog with great improvements from the current version.

 

First of all we needed the API to be used globally, so we fully reviewed the API to ensure descriptions and docs are 100% available in english. And that's not all, we also include:

1. API autodocumented by using OPENAPI opensource standard.(https://www.openapis.org/). Documentation will be reachable on a public URL to fully browse it, making testing and result check easier.
2. Client layer libraries are automatically generated in every programming language, providing a quick software implementation in every required language.
3. We isolated comerzzia REST service layer from the rest of modules. This great feature now allows to deploy it alone on docker containers.
4. Deploying on every market is now easier as the API requests can include language as an optional parameter
5. We increased security by using JWT tokens to authenticate API calls.

 

 

With all the above, key benefits from this new version are:

1. Based on industry technology standards
2. Global solution. Documentation and API calls fully in english
3. Autodocumented catalog, available for online testing
4. Agile client service layer implantation thanks to automatic library generation on any programming language
5. Centralized services module provides an easy depoloyment and sizing based on Docker containers.
6. Enhanced security based on JWT protocol

 

What happens with current versions of comerzzia ?

As described above, all this will be available with 5.0 version of comerzzia. For previous versions such 3.0.x, 4.0.x and 4.6.x we'll keep current REST services catalog available. After 5.0 is released they will be deprecated, requiring the upgrade of integrations and developments to use new catalog.

 

What if my customer upgrades to 5.0 version of comerzzia?

In the event a customer upgrades from 4.6 or older to 5.0.x, you need to review existing developments and integrations. To help on this task comerzzia will provide a developer guide with a conversion table from current REST catalog to new REST catalog functions. Also in this document we'll show how to switch some parameters in calls currently in spanish for their equivalent in english on the new API.

We're sure all these improvements and features will ease global deployments and developments on comerzzia platform. Please contact us in case you need further information.