Senkron için gereken kapsamlar
| Kapsam | Ne sağlar | Ne zaman gerekir |
|---|---|---|
| read_products | Ürün, varyant ve koleksiyonları okuma | Ürün senkronu |
| write_products | Ürün ve varyant oluşturma, güncelleme | Ürün açma, fiyat güncelleme |
| read_inventory | Stok miktarlarını okuma | Stok senkronu |
| write_inventory | Stok miktarlarını yazma | Stok güncelleme |
| read_locations | Mağaza, depo ve merkez lokasyonlarını okuma | Stoğun yazılacağı lokasyonu bulma |
| read_orders | Siparişleri, işlemleri ve gönderimleri okuma | Sipariş senkronu |
| write_orders | Siparişleri yönetme | İptal, iade gibi işlemler |
| read_all_orders | 60 günden eski siparişler | Geçmiş sipariş raporu |
Belgeye göre bir kaynağa yazma kapsamı okuma iznini de verir. Yalnız gerçekten yazacağınız kaynak için yazma kapsamı isteyin.
Sipariş geçmişinde 60 gün sınırı
Shopify varsayılan olarak yalnız son 60 günün siparişlerini erişilebilir kılar. Daha eski siparişleri okumak için read_orders ya da write_orders yanında read_all_orders kapsamı gerekir. Belgeye göre bu kapsam uygulamaya ayrıca verilmelidir.
Stok senkronu için genellikle son birkaç günün siparişleri yeterlidir. 60 gün sınırı daha çok kâr raporu ve geçmiş analizinde önem taşır.
Korumalı müşteri verisi
Sipariş kaynağı korumalı müşteri verisi içerir: ad, adres, telefon ve e-posta. Belgeye göre özel uygulamalar bu erişime kendiliğinden sahiptir; ama yönetici panelinde açılmış özel uygulamalarda ad, adres, telefon ve e-posta alanlarına erişim mağaza planına göre değişebilir. Herkese açık uygulamalar ise ayrı onay almalıdır.
Sipariş geliyor ama müşteri adı ya da adresi boş geliyorsa bu kural ilk bakılacak yerdir. Fatura kesmek için bu alanlara ihtiyacınız varsa planınızı ve uygulamanın veri erişimini kontrol edin.
Kapsam nasıl değiştirilir?
| Uygulama türü | Yol |
|---|---|
| Yönetici panelindeki eski özel uygulama | Uygulamanın yapılandırmasında kapsamları düzenleyin |
| Dev Dashboard uygulaması | Yeni sürüm oluşturup kapsamları seçin ve sürümü yayımlayın |
| Shopify CLI uygulaması | shopify.app.toml dosyasındaki kapsamları güncelleyip dağıtın |
Eski özel uygulamada kapsam değiştirmek için personel ya da ortak çalışan hesabının Manage and install apps and channels, Develop apps ve ilgili kaynak izinlerine sahip olması gerekir. Örneğin envanter kapsamı için envanteri görüntüleme ya da yönetme izni şarttır.
Sık hatalar
| Belirti | Neden | Çözüm |
|---|---|---|
| Stok yazarken 403 | write_inventory yok | Kapsamı ekleyin |
| Lokasyon listesi alınamıyor | read_locations yok | Kapsamı ekleyin |
| 2 aydan eski siparişler gelmiyor | read_all_orders yok | Kapsamı isteyin ya da pencereyi daraltın |
| Müşteri bilgileri boş | Korumalı müşteri verisi erişimi sınırlı | Plan ve veri erişimini kontrol edin |
Sık sorulanlar
Shopify stok senkronu için hangi scope’lar gerekir?
En az read_products, read_inventory, write_inventory ve read_locations. Siparişleri okumak için read_orders, ürün açmak ve fiyat yazmak için write_products eklenir.
Yazma kapsamı verirsem okuma kapsamını ayrıca vermem gerekir mi?
Shopify belgesine göre yazma kapsamı aynı kaynağın okuma iznini de içerir.
Neden yalnız son 60 günün siparişleri geliyor?
Varsayılan erişim son 60 gündür. Daha eskisi için read_all_orders kapsamı gerekir.
Kapsam eksikse hangi hatayı alırım?
REST Admin API’de çoğunlukla 403 Forbidden. Belge bu kodun tipik nedenini yanlış erişim kapsamları olarak verir.
Kaynaklar
İlgili Shopify API konuları
Son güncelleme: 27.10.2026 · Shopify API rehberinin tamamı