Lokasyon uç noktaları
| İşlem | REST | GraphQL |
|---|---|---|
| Lokasyonları listele | GET /locations.json | locations |
| Tek lokasyon | GET /locations/ID.json | location |
| Lokasyondaki stok seviyeleri | GET /locations/ID/inventory_levels.json | location ve inventoryLevels |
| Lokasyon sayısı | GET /locations/count.json | locationsCount |
GraphQL’deki locations sorgusu varsayılan olarak yalnız aktif lokasyonları döndürür. Pasife alınmışları görmek için includeInactive, sipariş karşılama hizmeti (fulfillment service) uygulamalarının lokasyonları için includeLegacy argümanı kullanılır.
Lokasyon numarası nasıl okunur?
REST yanıtında her lokasyonun id, active ve legacy alanları vardır. active=true lokasyon ürün satabilir ve stok tutabilir; legacy=true ise lokasyonun bir sipariş karşılama hizmetine ait olduğunu gösterir.
| Alan | Örnek | Anlamı |
|---|---|---|
| id | 655441491 | REST’te kullanılan sayı |
| GraphQL id | gid://shopify/Location/655441491 | Aynı lokasyonun GraphQL kimliği |
| active | true | Satış ve stok için kullanılabilir |
| legacy | false | Sipariş karşılama hizmeti lokasyonu değil |
GraphQL kimliğindeki son sayı REST numarasıyla aynıdır. Örnekteki numaralar Shopify belgesindeki örnek değerlerdir. Entegrasyon ayarına lokasyon numarası yazarken yalnız sayıyı mı yoksa GraphQL kimliğini mi beklediğini kontrol edin.
Siparişte stok hangi lokasyondan düşer?
REST InventoryLevel belgesine göre Shopify, takip edilen bir varyant siparişe girdiğinde stoğu düşer. Siparişin hangi lokasyondan karşılanacağını bilmediği için düşümü numarası en küçük lokasyondan yapar. POS siparişleri ise satışın yapıldığı lokasyondan düşer.
| Olay | Stok etkisi |
|---|---|
| Sipariş oluştu | En küçük numaralı lokasyondan düşülür |
| Aynı lokasyondan karşılandı | Ek işlem yok |
| Başka lokasyondan karşılandı | Karşılayan lokasyondan düşülür, ilk lokasyona geri eklenir |
GraphQL tarafında ise siparişe giren varyantın available miktarı azalır, committed miktarı artar; karşılandığında committed azalır. Ayrıntı: envanter durumları.
Çok depolu mağazada pazaryeri senkronu
- Pazaryerine hangi lokasyonun stoğunu açacağınıza baştan karar verin. Çoğu satıcı tek bir ana depoyu seçer.
- Entegrasyon bir lokasyona yazıp toplamı okuyorsa, diğer lokasyonlardaki adetler pazaryerine yanlış yansır.
- Envanter kalemi yazılan lokasyona bağlı değilse REST set isteği onu otomatik bağlar.
- Sipariş karşılama hizmeti lokasyonlarına bağlı kalemlerde disconnect_if_necessary ve relocate_if_necessary kurallarına dikkat edin; diğer lokasyonların stoğu 0’lanabilir.
Konunun satıcı tarafı Shopify stok ve lokasyon yapısı yazısında.
Sık sorulanlar
Shopify location ID nasıl bulunur?
REST’te GET /admin/api/SURUM/locations.json yanıtındaki id alanından ya da GraphQL’de locations sorgusundan. GraphQL kimliğinin son parçası REST numarasıdır.
Sipariş gelince stok hangi depodan düşer?
REST belgesine göre Shopify karşılama lokasyonunu bilmediği için en küçük numaralı lokasyondan düşer; sipariş başka lokasyondan karşılanırsa farkı düzeltir. POS siparişleri satış yapılan lokasyondan düşer.
Pasif lokasyonlar listede neden yok?
GraphQL locations sorgusu varsayılan olarak yalnız aktif lokasyonları döndürür. includeInactive argümanıyla pasifleri de alırsınız.
Birden çok depom var, pazaryerine hangisini bağlamalıyım?
Pazaryeri siparişlerini fiilen gönderdiğiniz depoyu. Entegrasyonunuzun hangi lokasyona yazıp neyi okuduğunu da kontrol edin.
Bir lokasyonu pasife alırsam stoğu ne olur?
Pasif lokasyon stok tutamaz ve sipariş karşılayamaz. Entegrasyonunuz o lokasyona yazıyorsa lokasyon ayarını yeni aktif lokasyonla güncelleyin; orderCancel belgesine göre pasif lokasyona stok geri eklenemediği için bazı iptallerde de sorun çıkabilir.
Kaynaklar
İlgili Shopify API konuları
Son güncelleme: 27.10.2026 · Shopify API rehberinin tamamı