Hangi mutasyon ne zaman?
| Mutasyon | Ne yapar | Ne zaman |
|---|---|---|
| productCreate | Ürün oluşturur | Shopify veri kaynağınızsa, adım adım ekleme |
| productUpdate | Belirli alanları günceller | Tek alan değişikliği |
| productSet | Ürünün tüm durumunu tek işlemde yazar; seçenek ve varyant listelerini değiştirir | Dış sistem (ERP, PIM) veri kaynağıysa |
| productVariantsBulkCreate | Bir üründe 2.048’e kadar varyant oluşturur | Çok varyantlı ürünler |
| productVariantsBulkUpdate | Bir ürünün varyantlarını toplu günceller | Fiyat, barkod değişikliği |
Shopify iki iş akışı tanımlar: Shopify veri kaynağıysa hedefli mutasyonlar, dış sistem veri kaynağıysa productSet. Binlerce ürünlük aktarımlarda toplu işlemler önerilir.
Varyant ve medya kuralları
- Ürün; seçenekler (renk, beden) ve bu seçeneklerin birleşimlerinden oluşan varyantlardan oluşur.
- productVariantsBulkCreate tek işlemde 2.048 varyant kabul eder. Otomatik oluşan tek varyantı kaldırma stratejisi kullanılmazsa 2.047 varyant eklenebilir.
- Medya dosyaları ayrı yüklenir ve birden çok ürün ve varyantta yeniden kullanılabilir.
- Koleksiyona ekleme ve sıralama ayrı mutasyonlarla yapılır.
Eski REST modelinde görseller ürün gövdesindeki images dizisinde src adresiyle verilebiliyordu ve bir üründe en fazla 100 varyant olabiliyordu.
Stok neden ayrı yazılır?
Shopify’ın varyant belgesi açıkça şunu söyler: uygulamalar artık inventory_quantity alanıyla stok yazamaz. Stok, envanter kalemi ve lokasyon üzerinden yazılır.
| Adım | İşlem | Sonuç |
|---|---|---|
| 1 | Ürünü ve varyantları oluşturun | Her varyantın inventory_item_id değeri oluşur |
| 2 | Gerekirse envanter kalemini lokasyona bağlayın | Stok kaydı açılır |
| 3 | inventorySetQuantities ile adedi yazın | Stok lokasyonda görünür |
Ürün açtıktan sonra stoğu ürün gövdesinde gönderdiğinizi varsaymayın; ürünü yeniden okuyup lokasyondaki adedi kontrol edin. Ayrıntılar stok güncelleme sayfasında.
Sık hatalar
| Belirti | Neden | Çözüm |
|---|---|---|
| Ürün açıldı ama stok 0 | Stok ürün isteğinde gönderildi | Envanter mutasyonuyla ayrıca yazın |
| Varyant eklenemiyor | Mağaza 500.000 varyanta ulaştı, günlük sınır doldu | Ertesi gün deneyin; Plus planında bu sınır yok |
| Kategori bulunamıyor | Shopify’da pazaryeri tarzı kategori ağacı yerine ürün türü ve koleksiyonlar var | Ürün türünü serbest metinle verin |
| Aynı ürün iki kez açıldı | Zaman aşımında istek tekrarlandı | Tekrar denemeden önce SKU ile kontrol edin |
Pazaryerindeki ürünü Shopify’a taşırken
- Barkod ve SKU’yu aynen taşıyın; eşleştirme bu alanlar üzerinden yapılır.
- Pazaryeri açıklamasındaki HTML’i kontrol edin; Shopify açıklaması HTML kabul eder ama tema görünümü farklı olabilir.
- Görselleri herkese açık adreslerden verin; Shopify görselleri adresinden çeker.
- Ürünü önce taslak olarak açıp kontrol ettikten sonra aktif yapmak yanlış fiyatla satışa açılma riskini azaltır.
Pazaryeri ile Shopify arasında ürün taşıma akışının genel anlatımı pazaryerine ürün yükleme sayfasında.
Sık sorulanlar
Shopify API ile ürün nasıl eklenir?
GraphQL Admin API’de productCreate ya da productSet mutasyonuyla. Varyantlar için productVariantsBulkCreate kullanılır.
REST POST /products.json hâlâ kullanılabilir mi?
Çalışıyor ama 2024-04’ten beri kullanımdan kalkmış durumda. Yeni geliştirmede GraphQL tercih edilmelidir.
Ürün açarken stok adedini gönderebilir miyim?
Belgeye göre uygulamalar inventory_quantity alanıyla stok yazamaz. Stoğu ürün açıldıktan sonra envanter mutasyonlarıyla yazın.
Shopify’da kategori nasıl seçilir?
Pazaryerlerindeki gibi zorunlu bir kategori ağacı yerine ürün türü ve koleksiyonlarla çalışılır. Ürün türü serbest metindir.
Kaynaklar
İlgili Shopify API konuları
Son güncelleme: 27.10.2026 · Shopify API rehberinin tamamı