Commercetools

The Relewise integration with Commercetools allows you to integrate and synchronize your product data to Relewise. This ensures that your data is always up to date, with as little setup cost needed as possible.

Integration Specs

Once set up, the intgration performs a full import of products from your selected store once every hour. The integration maps all standard fields, but does not support custom fields created in Commercetools. If you have special fields you need mapped, please reach out to us to discuss the possibilities.

For stores with more than 10,000 active products, the import may run afoul of the allowed scheduled timeouts by Commercetools. Ensure that you test and verify that the product import completes correctly when you set up the integration.

Commercetools: Setup

To get set up, follow the instructions below, or visit our github guide for the full technical specs.

The commercetools integration is configured within the Commercetools administration. Here, you will need to enter a series of information to properly connect Commercetools to Relewise. These are:

Commercetools: Default Connection Configuration

• CTP_PROJECT_KEY: The key of commercetools project.
• CTP_CLIENT_ID: The client ID of your commercetools user account. It is used in commercetools client to communicate with commercetools platform via SDK.
• CTP_CLIENT_SECRET: The client secret of commercetools user account. It is used in commercetools client to communicate with commercetools platform via SDK.
• CTP_SCOPE: The scope constrains the endpoints to which the commercetools client has access, as well as the read/write access right to an endpoint.
• CTP_REGION: As the commercetools APIs are provided in six different region, it defines the region which your commercetools user account belongs to.

Commercetools: Relewise Specific Configration

• RELEWISE_STORE_KEY: The Key for the store to which from the export is going to be performed on. You can find this in the mercandising center for commercetools
• RELEWISE_DATASET_ID: The DatasetId in Relewise.
• RELEWISE_API_KEY: ApiKey with access to perform Product Updates & administrative actions.
• RELEWISE_SERVER_URL: The Server URL your dataset is hosted on.

To access the data needed to fill out these configurations, you need access to your MyRelewise account. If you do not have access, please reach out to us.

API Permissions

You can set up an API key for your Commercetools integration by hitting the Create new API Key. The API connecting to Commercetools will need the following permissions:

• Integration:
  • Explicit product updates
  • Product administrative actions
  • Batched action tracking