Trendyol, Etsy ve Shopify Stok Entegrasyonu: Çok Kanallı Operasyon Rehberi

Aynı ürünü Shopify mağazasında, Trendyol'da ve Etsy'de satmak erişimi artırır; fakat eldeki son ürün iki kanalda aynı anda satıldığında müşteri deneyimi hızla bozulabilir. Manuel stok güncellemesi düşük sipariş hacminde çalışıyor gibi görünür. Kampanya, hafta sonu veya ekip değişikliği olduğunda gecikme büyür; iptal edilen siparişin stoğu yanlış kanala döner, bir varyant başka varyantla eşleşir veya başarısız API isteği fark edilmeden kalır.

Bu rehber pazaryerinde mağaza açma, ürün başlığı yazma ya da reklam verme anlatımı değildir. Odak; Trendyol, Etsy ve Shopify arasında katalog kimliği, stok rezervi, sipariş olayı, API sonucu ve günlük mutabakatı yöneten operasyon mimarisidir.

Bu içerik 12 Ekim 2026 tarihinde Trendyol Developers, Etsy Open API ve Shopify geliştirici belgelerinde bulunan bilgilerle hazırlanmıştır. API sürümleri, limitler, webhook olayları ve uygulama destekleri değişebilir. Özellikle Trendyol'un V2 geçiş duyuruları ile Shopify Marketplace Connect'in Etsy durumu kurulum günü yeniden kontrol edilmelidir. İçerik hukuk, vergi, muhasebe veya platform sözleşmesi danışmanlığı değildir.

Stok entegrasyonu gerçekte neyi senkronize eder?

“Stok” tek bir sayı değildir. Depodaki fiziksel adet, kalite kontroldeki ürün, açık sipariş rezervi, hasarlı ürün, mağaza içi satış, tedarik bekleyen adet ve kanala ayrılan tampon birbirinden farklıdır. Kanallara gönderilecek değer genellikle satılabilir stoktur.

Basit bir model şu şekilde kurulabilir:

Satılabilir stok = fiziksel kullanılabilir stok − açık sipariş rezervleri − operasyon tamponu − kanal güvenlik stoğu

Bu formül her işletmede aynı uygulanmaz. Ön sipariş, üretim kapasitesi, set ürünleri ve çoklu depo varsa ek kurallar gerekir. Önemli olan formülün yazılı, tek ve denetlenebilir olmasıdır.

Entegrasyon en az dört veri akışını yönetir:

1. Ana sistemden kanallara stok ve gerektiğinde fiyat yazımı
2. Kanallardan merkezi sisteme yeni sipariş ve iptal bilgisi
3. İade, değişim, hasar ve manuel sayım düzeltmeleri
4. Kanal ile merkez arasındaki periyodik mutabakat ve hata onarımı

Yalnız stok gönderip siparişi geri almayan bağlantı tam entegrasyon değildir. Yeni sipariş rezervi ana sisteme geç ulaşırsa diğer kanallar fazla stok görmeye devam eder.

Önce tek bir ana kayıt kaynağı seçin

Her kanalın diğerini güncellediği çift yönlü ağ, basit görünse de çakışma üretir. Shopify Trendyol'u, Trendyol entegratörü Shopify'ı, ayrı Etsy uygulaması da ikisini güncelliyorsa son yazan sistem tesadüfen doğru kabul edilir. Bunun yerine stok gerçeğinin tek sahibi olmalıdır.

Ana kaynak seçilince “hangi alanın sahibi kim?” tablosu oluşturun. Stok ERP'den, Shopify ürün açıklaması içerik ekibinden, Etsy başlığı kanal ekibinden ve Trendyol fiyatı ayrı fiyat kuralından gelebilir. Aynı alanın iki sahibi olmamalıdır.

SKU ve kanal kimliklerini varyant düzeyinde eşleyin

Başlık ürün kimliği değildir; pazarlama amacıyla değişebilir. “Siyah Tişört” adlı ürünün S, M ve L bedenleri stok açısından üç ayrı kayıttır. Her satılabilir varyant için değişmeyen benzersiz SKU oluşturun ve şu kimlikleri aynı eşleme tablosunda tutun:

• Ana sistem ürün ve varyant kimliği
• İç SKU ve varsa barkod
• Shopify ürün ve varyant kimliği
• Trendyol barkod, stok kodu ve ilgili içerik/ürün kimliği
• Etsy listing kimliği, product/offering kimliği ve SKU
• Depo konumu ve stok havuzu
• Kanalda aktiflik ve son doğrulama zamanı

SKU'yu küçük-büyük harf, boşluk, tire ve Türkçe karakter açısından standartlaştırın. Aynı SKU'nun iki farklı fiziksel ürünü temsil etmesine; bir varyantın da farklı kanallarda farklı SKU almasına kontrolsüz izin vermeyin. Zorunlu dönüşüm varsa eski-yeni eşleme ve değişiklik geçmişi saklanmalıdır.

Standartlaştırma tamamlandıktan sonra SKU ve barkodu kalıcı kimlik olarak kilitleyin. Kampanya adı, ürün başlığı veya kategori değiştiğinde kimliği yeniden üretmeyin. Üç kanallı mimaride iki kanal arasındaki eşleme yeterli değildir: merkez SKU'nun Trendyol barkodu, Etsy varyantı ve Shopify inventory item kimliği aynı satırda bulunmalı, eksik üçüncü bağlantı satışa açılmadan görülmelidir. Böylece tek satış üç ayrı ürün gibi rezerv oluşturmaz.

Set ve paket ürünlerinde stok, bitmiş paket sayısından değil en az bulunan bileşenden hesaplanabilir. Örneğin bir sette iki bardak ve bir tepsi gerekiyorsa satılabilir set sayısı, bardak stoğunun ikiye bölünmesi ile tepsi stoğunun düşük olanıdır. Bu kural kanal bağlayıcısının standart stok alanıyla çözülemiyorsa ERP veya özel katmanda hesaplanmalıdır.

Stok olaylarının sırasını ve tekrarını güvenli yönetin

Örnek bir satış akışı şöyledir:

1. Trendyol'da sipariş oluşur.
2. Entegrasyon olayı alır ve sipariş kimliğini tekilleştirir.
3. Ana sistem ilgili SKU için rezerv oluşturur.
4. Yeni satılabilir stok hesaplanır.
5. Shopify, Etsy ve Trendyol için kanal mesajları kuyruğa alınır.
6. Her kanalın API sonucu ayrı kaydedilir.
7. Başarısız kayıt kontrollü biçimde yeniden denenir.
8. Belirli aralıkta kanal değerleri ana kaynakla mutabık hâle getirilir.

Aynı sipariş olayı iki kez gelirse stok iki kez düşmemelidir. Bunun için kanal, mağaza ve sipariş/olay kimliğinden oluşan idempotency kaydı tutulur. Eski bir güncelleme yeni değerin üzerine yazmamalıdır; olay zamanı kadar kaynağın son güncelleme zamanı ve mevcut sürüm numarası da değerlendirilir.

Shopify'ın webhook belgeleri, bildirim sırasının aynı konu içinde veya farklı konular arasında garanti edilmediğini; yinelenen teslimlerin X-Shopify-Webhook-Id ile ayıklanması gerektiğini ve webhook tesliminin her zaman garanti edilmediği için periyodik reconciliation çalışması kurulmasını belirtir. Dolayısıyla “webhook geldi, sistem doğrudur” yaklaşımı yeterli değildir.

Trendyol stok API'sinde kuyruk ve sonucu birlikte yönetin

Trendyol'un stok ve fiyat güncelleme belgesine göre bir istekte en fazla 1.000 SKU gönderilebilir ve bir ürün için gönderilebilen stok en fazla 20.000 adettir. Aynı gövde değiştirilmeden 15 dakika içinde tekrar gönderildiğinde hata alınır; sistem yalnız değişen stok veya fiyatları gönderecek şekilde tasarlanmalıdır. İstek başarılı kabul edildiğinde işlem hemen tamamlanmış sayılmaz: yanıt işlemin kuyruğa alındığını ve bir batchRequestId döndüğünü gösterir.

Trendyol'un toplu işlem kontrolü belgesi, batchRequestId ile item düzeyinde status ve hata varsa failureReasons alanlarının kontrol edilmesini ister. HTTP 200 almak, bütün SKU'ların başarıyla işlendiği anlamına gelmez. Her parti için gönderilen, başarılı ve başarısız kayıt sayısı mutabık olmalıdır.

Sağlıklı Trendyol yazım işçisi:

• Yalnız değişen değerleri kuyruğa alır.
• Katalog büyüklüğüne göre resmî servis limitlerine uyar.
• En fazla 1.000 SKU'luk kontrollü partiler üretir.
• batchRequestId ile sonucu takip eder.
• Item düzeyindeki başarısızlık nedenini kaydeder.
• Geçici ve kalıcı hatayı ayırır.
• Kör tekrar yerine artan bekleme ve üst deneme sınırı uygular.
• Dört saatlik sonuç görüntüleme penceresini operasyon tasarımında dikkate alır.

Sürüm takibi de operasyonun parçasıdır. Trendyol'un Ürün V1 endpoint belgesi ve sipariş paketleri belgesi, eski Product V1 ve Order V1 endpoint'lerinin 15 Ekim 2026 tarihinde kullanım dışı kalacağını belirtir. Yeni kurulum Product V2 ve Order V2 üzerinden yapılmalı; mevcut entegratörden geçiş kanıtı istenmelidir. Bu tarih 12 Ekim 2026 araştırma gününe çok yakındır; sürüm yenilemesini sonraki geliştirme dönemine bırakmayın.

Trendyol'un webhook modeli sipariş olaylarını hızlı almayı sağlar; buna periyodik sipariş mutabakatı ekleyin. getShipmentPackages için küçük, kontrollü tarih pencereleri ve paket kimliğiyle tekilleştirme kullanın. Güncel belgede 15 Ekim'deki V2 değişikliği için 10.000 paketlik sorgu penceresi ve büyük taramalar için akış endpoint'i önerisi bulunur. Yüksek hacimde geniş aralıklı polling yerine cursor tabanlı akış veya bölünmüş sorgularla eksikleri tamamlayın. Webhook ve tarama aynı paketi getirdiğinde rezerv yalnız bir kez oluşturulmalıdır.

Shopify stok yazımında eşzamanlı değişiklikleri koruyun

Merkez sistem Shopify'daki miktarın sahibi olduğunda GraphQL inventorySetQuantities kullanılabilir. compareQuantity ile karşılaştır ve değiştir, yani CAS kontrolü uygulayın: okunan değer ile mevcut değer farklıysa eski hesabı zorla yazmak yerine yeniden okuyup hesaplayın. Aynı belgede 2026-04 ve sonraki sürümler için @idempotent anahtarı zorunluluğu açıklanır. Aynı işlemin ağ hatası sonrası tekrarında aynı anahtar korunmalı, yeni stok kararı için yeni anahtar üretilmelidir.

Shopify'ın envanter uygulaması rehberi doğrultusunda lokasyon ve miktar durumlarını ayrı düşünün. ERP on-hand miktarını yönetiyorsa sipariş rezervinin available hesabından ikinci kez düşülmemesini sağlayın. Çoklu depoda yalnız gerçekten ilgili kanala sevk edebilen lokasyonları toplayın; depolar arası yolda olan ürün iki konumda aynı anda satılabilir görünmemelidir. Kalıcı API hatalarını deneme sınırı sonrası dead-letter kuyruğuna taşıyın. Loglarda SKU, kanal, eski-yeni miktar, olay kimliği ve hata nedeni bulunmalı; günlük fark raporunda sahip ve çözüm süresi atanmalıdır.

Etsy envanterinde tam varyant dizisini koruyun

Etsy Open API'nin listings rehberi, updateListingInventory çağrısında listing'e ait varyasyonlara dayalı tüm ürün setinin products dizisinde bulunması gerektiğini belirtir. Yalnız bir varyantın adedini içeren eksik gövde göndermek, diğer varyantları koruyan kısmi yama gibi düşünülmemelidir.

Güvenli akış şöyledir:

1. getListingInventory ile güncel ürün dizisini alın.
2. Dokümanın belirttiği salt okunur kimlik ve biçim alanlarını istekten çıkarın.
3. Hedef SKU'nun quantity değerini değiştirin.
4. Diğer product, offering ve property ilişkilerini koruyun.
5. Bütün products dizisini updateListingInventory ile geri gönderin.
6. Sonucu yeniden okuyup beklenen değerle karşılaştırın.

Aynı SKU birden fazla property bileşiminde kullanılıyorsa quantity tutarlılığı ayrıca korunmalıdır. Etsy'nin API referansı, ürün dizisinin zorunlu olduğunu ve varyasyonu etkileyen *_on_property alanlarıyla uyumsuz SKU, miktar, fiyat veya işlem profili değerlerinde isteğin başarısız olabileceğini açıklar.

Shopify Marketplace Connect'i yeni Etsy bağlantısı için otomatik çözüm olarak planlamayın. Shopify'ın Marketplace Connect gereksinimleri sayfası, 12 Ekim 2026 itibarıyla Etsy'ye yeni bağlantı kurulamadığını; daha önce Marketplace Connect üzerinden Etsy kullananların devam edebildiğini belirtir. Yeni kurulumda güncel üçüncü taraf uygulama veya özel entegrasyon seçenekleri veri erişimi, maliyet, destek ve çıkış planıyla değerlendirilmelidir.

Etsy webhook kapsamını doğru yorumlayın

Etsy'nin webhook belgesinde 12 Ekim 2026 itibarıyla listelenen olaylar order.paid, order.canceled, order.shipped ve order.delivered olaylarıdır. Bu olaylar sipariş yaşam döngüsünü hızlı yakalamaya yardımcı olur; aynı belge teslim başarısızlığında yeniden deneme ve imza doğrulama mekanizmasını açıklar.

Bu listeyi “envanter değişikliği için eksiksiz webhook var” şeklinde yorumlamayın. Stok doğruluğu için sipariş olaylarını işlemek, yazım sonuçlarını kontrol etmek ve periyodik olarak Etsy envanterini ana kaynakla karşılaştırmak gerekir. Webhook imzası, zaman damgası ve tekrar saldırısı kontrolleri uygulanmadan gelen isteğe göre stok değiştirilmemelidir.

Rezerv, güvenlik stoğu ve yüksek trafik kuralı belirleyin

Yakın gerçek zamanlı entegrasyon, sıfır gecikme anlamına gelmez. Siparişin kanaldan alınması, merkezi sisteme yazılması ve diğer iki kanala yayılması saniye veya dakika sürebilir. Son adetlerde aşırı satışı azaltmak için kanal güvenlik stoğu kullanılabilir.

Örnek kurallar:

• Fiziksel stok 5'in altına indiğinde Etsy'de 1 adet tampon bırak.
• Kampanya günü Trendyol için ayrılmış havuzu diğer kanallara kapat.
• El yapımı ürünlerde bitmiş stok ile üretim kapasitesini ayrı yönet.
• Ödeme bekleyen siparişe süreli rezerv uygula.
• İptalde stoğu ödeme ve operasyon durumu doğrulanmadan geri açma.
• Hasarlı iade kalite kontrol görmeden satılabilir stoğa dönmesin.

Güvenlik stoğu yanlış eşleşmeyi düzeltmez; yalnız gecikme riskine tampon sağlar. SKU eşleme ve olay işleme hataları ayrıca çözülmelidir.

İptal, iade ve kısmi gönderim stok kadar önemlidir

Sipariş geldiğinde stok düşürmek kolay kısımdır. Gerçek operasyon; ödemesi başarısız, satıcı tarafından iptal edilen, kısmen gönderilen, kısmen iade edilen, değiştirilen veya kayıp bildirilen siparişlerde sınanır.

Her olay için şu soruları yazılı cevaplayın:

• Rezerv hangi durumda kesin stok düşümüne dönüşür?
• Müşteri iptalinde miktar ne zaman geri açılır?
• Kısmi iptalde hangi SKU ve kaç adet etkilenir?
• İade geldiğinde kalite kontrol kim tarafından onaylanır?
• Değişim yeni sipariş mi, stok hareketi mi oluşturur?
• Pazaryeri kararı ile fiziksel depo sonucu çelişirse hangisi incelenir?
• Set ürün iadesi bileşen stoklarını nasıl etkiler?

Finansal iade tamamlandı diye ürünün satılabilir olduğu varsayılmamalıdır. Stok durumu ve para hareketi ilişkili fakat ayrı kayıtlar olmalıdır.

Entegrasyon aracını puan kartıyla seçin

“Üç kanalı bağlar” ifadesi karar için yeterli değildir. Adayları aynı senaryolarla puanlayın.

Ayrıca şu soruları yanıtlatın:

• Trendyol Product V2 ve Order V2 desteğinin sürümü nedir?
• Etsy envanter güncellemesinde tam products dizisi nasıl korunuyor?
• Shopify webhook tekrarları ve sırasız olaylar nasıl tekilleştiriliyor?
• Son başarılı senkronizasyon zamanı nerede görülüyor?
• Kanal API'si kesilirse stoklar güvenli moda alınabiliyor mu?
• Hata kuyruğu ve batch sonucu işletmeye görünür mü?
• Uygulama kaldırılırsa eşleme tablosu dışa aktarılabiliyor mu?
• Birincil destek ve acil durum yanıt süresi nedir?

Pilot test planı

Bütün kataloğu bağlamadan önce az ama zor ürünler seçin:

• Tek varyantlı standart ürün
• Renk ve bedenli çok varyantlı ürün
• Son bir adet stoklu ürün
• Aynı bileşeni kullanan iki set ürün
• Etsy'de özel varyasyonlu ürün
• Trendyol'da kategori özelliği zorunlu ürün
• Farklı depoda tutulan ürün
• İade ve yeniden satılabilirlik kararı gereken ürün

Her testte başlangıç stoğu, olay, beklenen kanal değerleri, gerçekleşen değerler, geçen süre ve ekran/API kanıtı kaydedilmelidir. Temel senaryolar şunlardır:

1. Shopify satışı sonrası Trendyol ve Etsy güncellemesi
2. Trendyol satışı sonrası ana kaynak rezervi
3. Etsy satışı sonrası son adet davranışı
4. Aynı anda iki kanaldan sipariş
5. Aynı olayın iki kez iletilmesi
6. Eski güncellemenin yeni güncellemeden sonra gelmesi
7. API zaman aşımı ve kontrollü tekrar
8. Trendyol batch içinde tek SKU başarısızlığı
9. Etsy tam varyant dizisinde bir adet değişimi
10. İptal, kısmi iade ve kalite kontrol sonrası stok dönüşü

Tek bir başarılı sipariş pilot sayılmaz. Kesinti ve hata senaryoları denenmeden bütün katalog açılmamalıdır.

Günlük mutabakat ve alarm paneli kurun

Webhooks ve API yazımları hızlı akışı sağlar; mutabakat ise sessiz bozulmayı bulur. Belirli aralıklarla ana sistemdeki satılabilir stok ile üç kanaldaki değerleri SKU düzeyinde karşılaştırın.

İzlenecek göstergeler:

• Kanal başına son başarılı okuma ve yazma zamanı
• Bekleyen ve başarısız mesaj sayısı
• Trendyol batch başarılı/başarısız item oranı
• Etsy envanter okuma-yazma uyuşmazlığı
• Shopify webhook tekrar ve gecikme sayısı
• Stok farkı bulunan SKU adedi ve toplam birim
• Aşırı satış ve zorunlu iptal oranı
• İptal/iade sonrası stok dönüş süresi
• Manuel düzeltme sayısı ve nedeni
• API limit, kimlik doğrulama ve sürüm hataları

Kritik alarmın sahibi ve müdahale süresi tanımlanmalıdır. “Teknik ekip bakar” yerine mesai içinde ve dışında kimin kanalı durduracağı, stoğu sıfırlayacağı veya manuel düzeltme yapacağı yazılmalıdır.

Trendyol, Etsy ve Shopify stok entegrasyonu kontrol listesi

• [ ] Ana stok kaynağı ve alan sahipleri belirlendi.
• [ ] Satılabilir stok formülü yazıldı.
• [ ] Her varyant için benzersiz SKU oluşturuldu.
• [ ] Shopify, Trendyol ve Etsy kimlikleri eşlendi.
• [ ] Set, paket, ön sipariş ve çoklu depo kuralları tanımlandı.
• [ ] Sipariş olayları idempotent biçimde işleniyor.
• [ ] Sırasız ve yinelenen webhook senaryoları test edildi.
• [ ] Trendyol servis limitleri ve V2 takvimi doğrulandı.
• [ ] Trendyol batchRequestId sonuç kontrolü kuruldu.
• [ ] Etsy tam products dizisiyle envanter yazımı test edildi.
• [ ] Marketplace Connect'in yeni Etsy bağlantısı kısıtı dikkate alındı.
• [ ] Güvenlik stoğu ve kampanya tamponu belirlendi.
• [ ] İptal, kısmi iade ve kalite kontrol akışları test edildi.
• [ ] API kesintisi ve manuel durdurma prosedürü yazıldı.
• [ ] Günlük SKU mutabakatı ve alarm sahipleri tanımlandı.
• [ ] Entegrasyon verisi ve eşleme tablosu dışa aktarılabiliyor.

Çok kanallı stoğu bağlantı değil operasyon sistemi olarak kurun

Trendyol, Etsy ve Shopify'ı birbirine bağlamak başlangıçtır; sürdürülebilir sonuç tek stok gerçeği, güvenilir ürün kimliği, denetlenebilir olay akışı ve sahipli hata yönetimiyle oluşur. Timurial olarak kanal ve depo mimarisini analiz ediyor; SKU eşleme, stok kuralı, API akışı, pilot test, alarm ve mutabakat planını işletmenizin sipariş hacmine göre tasarlıyoruz. Aşırı satış ve manuel panel takibini azaltacak entegrasyon yol haritası için operasyonunuzu bize anlatın.

Resmî kaynaklar

• Trendyol Developers: Entegrasyon dokümantasyonu ve V2 duyuruları
• Trendyol Developers: Değişiklik günlüğü
• Trendyol Developers: Stok ve fiyat güncelleme
• Trendyol Developers: Ürün V1 kapanış duyurusu
• Trendyol Developers: Sipariş paketleri ve V2 geçişi
• Trendyol Developers: Webhook modeli
• Trendyol Developers: Toplu işlem kontrolü
• Trendyol Developers: Servis limitleri
• Etsy Open API: Listings ve envanter rehberi
• Etsy Open API: API referansı
• Etsy Open API: Webhooks
• Shopify: Marketplace Connect gereksinimleri
• Shopify Developers: Webhooks hakkında
• Shopify Developers: inventorySetQuantities
• Shopify Developers: Envanter uygulamaları