commercetools entegrasyonu

commercetools entegrasyonuyla Türkiye pazaryeri kanallarının tamamı mimarinize tek bir bağlantı noktası olarak eklenir. MACH mimarinizi sade tutarsınız.

Ücretsiz deneyin Demo talep edin

Kredi kartı istenmez · deneme ilk mağazanızı bağladığınızda başlar.

Güncellendi: 6 Kasım 2026

Ne işe yarar

commercetools kullanan kurumlar composable mimariyle çalışır: her yetenek API’li bir servistir. Türk pazaryerlerinin her biri için ayrı bağlantı yazmak bu mimaride bile pahalıdır. Yekuna bu katmanı tek servis olarak sunar.

API client’ınızla bağlantı kurulur, product projection’larınız kanal şemalarına eşlenir. Sipariş nesneleri commercetools düzeninize uygun biçimde geri yazılır. Kanalların farklı kuralları Yekuna sınırında karşılanır.

Yekuna, pazaryeri entegrasyonu ve e-ticaret operasyon panelidir. Trendyol, Hepsiburada, n11, kendi siteniz, stok ve siparişler tek panelden yönetilir.

Kurulum

commercetools nasıl bağlanır?

commercetools Merchant Center’da Settings > Developer settings bölümünden Yekuna için bir API client oluşturun ve yalnız gereken scope’ları seçin.
Client ID ve secret değerlerini Yekuna’da Entegrasyon Merkezi → commercetools ekranına girin; secret yalnız oluşturulduğunda gösterildiği için o sırada kaydedin.
Product projection’larınızı kanal şemalarıyla, kanal siparişlerini order modelinizle eşleyin.
Önce production dışı bir projede bir sipariş akışını deneyip ardından canlı projeye geçin.

Kapsam

Yekuna ile hangi operasyonlar yönetilir?

Tek bağlantı noktası
Yerli kanalların hepsi mimarinizde tek bir entegrasyon noktasıdır.
Projection eşlemesi
Ürün projection’larınız kanal gereksinimlerine çevrilir.
Sipariş modeli uyumu
Kanal siparişleri commercetools order modeline uygun taşınır.

Senaryolar

Gerçek kullanımda

Composable yapıda yerli kanal katmanı

Örnek Mağaza composable mimariye geçerken Türkiye pazaryerlerini tek tek bağlamak yerine Yekuna’yı kanal servisi olarak kullanıyor. Mimaride her pazaryeri için ayrı bir bağlantı yerine tek entegrasyon noktası kalıyor.

Kanal kuralları

commercetools API’si ve kurallar

commercetools’ta API client’ları Merchant Center’daki Settings > Developer settings bölümünden oluşturulur. Erişim OAuth client credentials akışıyla alınır: client ID ve secret ile bölgeye özgü yetkilendirme sunucusundan istenen scope’ta belirteç alınır, istekler Bearer başlığıyla yapılır. Belirteç varsayılan olarak 48 saat geçerlidir.

Olaylar HTTP webhook yerine Subscription ile mesaj kuyruklarına gönderilir; aynı bildirim birden çok kez gelebilir ve sıra garantisi yoktur. Production dışı projelerde kısa sürede çok istek gönderen client 429 yanıtı alır.

Kaynak: commercetools Docs — Authorization · commercetools Docs — Create an API client · commercetools Docs — Subscriptions

Başlangıç

commercetools operasyonunuzu Yekuna ile tek panele taşıyın

Ücretsiz deneyin

SSS

Sık sorulanlar

commercetools entegrasyonu hangi API sürümüyle çalışır?: Güncel HTTP API ile çalışır. Kapsam ve scope’lar kurulum sırasında en az yetki ilkesiyle tanımlanır.
commercetools bağlantısı için hangi scope’larla API client açmalıyız?: Gereken en dar yetki listesi kurulum belgesinde verilir. Yalnızca gerekli kaynaklar için okuma ve yazma yetkisi tanımlanır.
commercetools değişiklikleri Yekuna’ya nasıl bildirilir?: commercetools değişiklikleri Subscription ile bir mesaj kuyruğuna (AWS SQS, Google Pub/Sub, Azure Service Bus gibi) gönderir. Aynı bildirim birden çok kez gelebildiği için Yekuna her olayı bir kez işler.
commercetools erişim belirteci ne kadar geçerlidir?: commercetools OAuth client credentials akışıyla verilen belirteç varsayılan olarak 48 saat geçerlidir; süre dolunca client bilgileriyle yenisi alınır.

İlgili