Commerce Tools Integration

Overview

commercetools is a leading cloud-native, headless commerce platform that provides flexible APIs for building modern e-commerce experiences. It offers a comprehensive suite of commerce capabilities including product management, order processing, customer management, and more through its powerful API-first architecture.

commercetools is built on modern microservices architecture and provides multiple SDKs to integrate seamlessly with various systems. The platform is designed for enterprise-scale operations with high performance, scalability, and reliability.

Key Features

When to Use This Integration

• Sync products between commercetools and PIM systems, ERP, or other e-commerce platforms
• Process orders from commercetools to fulfillment, WMS, or ERP systems
• Synchronize customers with CRM, marketing automation, or analytics platforms
• Manage categories and product hierarchies across multiple systems
• Update carts programmatically for custom checkout flows
• Export data for analytics, reporting, or data warehousing

Configuration

Required Fields

To configure the commercetools integration in Retrieve, you need the following credentials from your commercetools project:

{
  "projectKey": "my-project",
  "clientID": "your-client-id",
  "clientSecret": "your-client-secret",
  "scope": "manage_project:my-project",
  "auth_url": "https://auth.us-central1.gcp.commercetools.com",
  "api_url": "https://api.us-central1.gcp.commercetools.com"
}

How to Get commercetools API Credentials

1. Log into Merchant Center

   Access your commercetools Merchant Center at https://mc.commercetools.com/

2. Navigate to Settings

   Go to Settings → Developer settings in your project

3. Create API Client

   Click "Create new API client" and configure:

   • Name: e.g., "Retrieve Integration"
   • Scopes: Select appropriate scopes (e.g., manage_project for full access)
4. Copy Credentials

   After creation, copy all credentials (shown only once):

   • Project key
   • Client ID
   • Client secret
   • Scopes
   • API URL
   • Auth URL
5. Store Securely

   Save these credentials in a secure location. The client secret cannot be retrieved again.

Available SDKs

This integration uses the official commercetools JavaScript SDKs:

• @commercetools/sdk-client-v2 - Core HTTP client with authentication
• @commercetools/platform-sdk - Main API SDK for products, orders, customers, etc.
• @commercetools/importapi-sdk - Import API for bulk data operations
• @commercetools/ml-sdk - Machine Learning API SDK
• @commercetools/history-sdk - Change history tracking SDK

Use Cases

API Documentation

Support & Resources