Sipariş Yönlendirme Konum Kuralı İşlevleri artık her grup için ayrı bir sıralama işlemi döndürmek yerine, birden fazla karşılama grubuna aynı konum sıralamasını uygulayabiliyor. Bu değişiklik, bölünmüş sepetlerde çıktıyı azaltıyor ancak konum sıralamasını genel bir sipariş karşılama optimizasyonuna dönüştürmüyor. Uygunluk ve sıralama, her grup için hâlâ anlamlı olmalı.
Öne çıkan noktalar
- Birden fazla grubu kapsayan işlem unstable Function API içinde kullanılabiliyor. Sabitlenmiş 2026-10 derlemesinde bulunduğunu varsaymayın.
- Grupları yalnızca gerçekten aynı sıralamalara ihtiyaç duyduklarında toplu işleyin. Aksi durumda her grup için ayrı bir işlem oluşturun.
- Önce grup tanıtıcılarını ve uygun konum tanıtıcılarını sorgulayın, ardından yalnızca kuralınızın kullandığı konum veya satır alanlarını ekleyin.
- Daha düşük bir sıra değeri önceliklidir, ancak bir konumu sıralamak onu grup için uygun hâle getirmez.
Tam olarak ne değişti?
5 Kasım 2026'da Shopify, konumları birden fazla karşılama grubu için sıralama olanağı ekledi. Önceden en basit çıktı, her grup için bir fulfillmentGroupLocationRankingAdd işlemiydi. Unstable şema artık birden fazla grubu kapsayan bir işlemi de tanımlıyor: tek bir rankings listesi ve bir fulfillmentGroupHandles listesi. Shopify, bunu belirtilen her gruba aynı tek grup işleminin, listedeki sırayla uygulanmasına eşdeğer kabul ediyor. Bilinmeyen grup tanıtıcıları yok sayılıyor.
Bu değişiklik esas olarak bir çıktı biçimi iyileştirmesi. Birden fazla gruba bölünmüş bir sepet için her gruba aynı depo öncelikli kural uygulandığında tekrarlayan çıktılar oluşabilir. Bu işlemleri toplu hâle getirmek tekrarları azaltır ve Function çıktı boyutu sınırına takılma riskini düşürür. Grupları birleştirmez ve tüm satırların tek bir depodan gönderileceğini garanti etmez. Dağıtıma alınmış bir uzantıyı değiştirmeden önce unstable referansını ve 2026-10 referansını karşılaştırın.
| Yöntem | Şu durumda kullanın | Ödünleşim |
|---|---|---|
| Her grup için bir işlem | Teslimat adresi, ürünler veya uygun konumlar farklıysa | Daha fazla çıktı üretir, ancak her karar açıkça belirtilir |
| Birden fazla grubu kapsayan tek işlem | Gruplar aynı konum tanıtıcılarına ve sıralamalara ihtiyaç duyuyorsa | Çıktı daha küçüktür, ancak dikkatsiz bir toplu işlem gruba özgü kuralları gizleyebilir |
| Shopify'ın yapılandırılmış yönlendirme kuralları | Standart öncelikler ihtiyacı karşılıyorsa | Daha az özel kontrol sunar ve bakımı gereken bir Function kodu olmaz |
Girdi sorgusunu karara göre yapılandırın
Function yalnızca girdi sorgusunda seçilen alanları alır. Önce grup kimliğini ve uygunluğu belirleyin, sonra bu tanıtıcıları konum verileriyle eşleştirin. Konum metafield'ı kullanan depo öncelikli bir kural için Order Routing Location Rule şeması aşağıdaki gibi bir sorguyu destekliyor:
query RunInput {
fulfillmentGroups {
handle
inventoryLocationHandles
}
locations {
handle
metafield(namespace: "routing", key: "warehouse") {
value
}
}
}
Burada locations nitelikleri sağlar, her grubun inventoryLocationHandles alanı ise aday konumları belirtir. locations tarafından döndürülen her konumu her grup için sıralamayın. Shopify, sıralanan bir konum o grubun envanter konumları arasında değilse bu sıralamayı yok sayar. Kural teslimat adresine bağlıysa fulfillmentGroups { deliveryAddress { provinceCode } } alanını ekleyin. Ürünlere bağlıysa her grubun altındaki lines alanını sorgulayın. Bir örnek sorguda yer alıyor diye adresleri, ürün verilerini ve metafield'ları gereksiz yere almayın.
10.000'den fazla SKU içeren bir katalogda, yönlendirme kuralı ürün alanlarına gerçekten ihtiyaç duymuyorsa kuralı bu alanlardan bağımsız tutardım. Aksi takdirde sorguyu ve karar akışını, hiçbir fayda sağlamadan incelemesi daha zor hâle getirirsiniz.
Toplu işlemden önce aynı sıralamaları oluşturun
Önce sıralamayı her grup için bağımsız ve yan etkisiz bir hesaplama olarak uygulayın. Bu örnekte routing.warehouse metafield'ının dize değeri "true" olan bir konuma 0 sıra değeri verilir; uygun diğer konumlar 1 değerini alır. Ardından yalnızca hesaplanan sıralamaları, konum tanıtıcıları ve sıra değerleri dâhil, aynı olan grupları toplu işleyin.
const warehouseByHandle = new Map(
input.locations.map((location) => [
location.handle,
location.metafield?.value === "true",
]),
);
const batches = new Map();
for (const group of input.fulfillmentGroups) {
const rankings = group.inventoryLocationHandles
.map((locationHandle) => ({
locationHandle,
rank: warehouseByHandle.get(locationHandle) ? 0 : 1,
}))
.sort((a, b) => a.locationHandle.localeCompare(b.locationHandle));
const key = JSON.stringify(rankings);
const batch = batches.get(key) ?? {fulfillmentGroupHandles: [], rankings};
batch.fulfillmentGroupHandles.push(group.handle);
batches.set(key, batch);
}
return {
operations: [...batches.values()].map((batch) => ({
fulfillmentGroupsLocationRankingAdd: batch,
})),
};
Dağıtımdan önce birden fazla grubu kapsayan işlemi doğrulamak için uzantınızın unstable şemasını ve oluşturulan türleri kullanın. Buradaki sıralama, kararlı bir karşılaştırma anahtarı oluşturmak içindir, Shopify'ın seçimini etkilemez. Önceliği rank değerleri belirler. Bu temkinli toplu işlem yöntemi, aday kümeleri farklı olan grupları birleştirme fırsatlarını kaçırabilir ancak sıralamaları aynıymış gibi göstermeyi önler.
Yeni işlemin hâlâ yetersiz kaldığı noktalar
Çıktı sözleşmesi ve sıralama kuralları, özellikle test edilmesi gereken bazı sınırlar getiriyor:
- Uygun konumları sıralar, yeni adaylar eklemez. Bir grubun
inventoryLocationHandleslistesinde olmayan konum tanıtıcısı yok sayılır. - Bir konumu listeden çıkarmak, kesin olarak hariç tutmaya yetmez. Listede olmayan envanter konumları en son sırada yer alır. Bir konumun ürünü karşılamaması gerekiyorsa uygun bir kısıt kullanın.
- Gruplar genelinde bir sonucu garanti etmez. Ortak bir tercih, tek gönderi, ayrılmış kapasite veya genel olarak en düşük maliyetli dağıtım sözü vermez.
- Diğer kurallar da önemlidir. Shopify, her grup için konum kuralı çıktılarını yapılandırılmış önceliğe göre değerlendirir ve sıra eşitliğini çözmek için sonraki kuralı kullanır. Eşit sıra değerleri tek başına belirli bir depo seçimini garanti etmez.
- Kullanılabilirlik sınırlıdır. API, Shopify Plus satıcıları için hâlâ yalnızca istek üzerine erişilebilen bir beta sürümüdür. Belgelenen yüzey desteği de değişiklik gösterir. Örneğin, yönetici panelindeki sipariş düzenlemelerinde kural yalnızca yeni ürünlere uygulanırken, ödeme adımındaki sipariş düzenlemeleri desteklenmez.
Zamanlamayı da göz önünde bulundurun. Shopify'ın Function referansı, önceki 15 dakika içinde teslimatla ilgili sepet verileri değişmediyse bir sonucu yeniden kullanabileceğini belirtiyor. Harici bir kapasite değerini değiştirmenin ödeme adımındaki yönlendirme sonucunu hemen değiştireceğini varsaymayın.
Sonucu bölünmüş sepetlerle doğrulayın
Programa kaydedilmiş bir geliştirme mağazasında, en az iki karşılama grubu içeren bir test verisiyle sınama yapın. Hem Function sonucunu hem de sonunda atanan konumları inceleyin:
- İki gruba aynı uygun konumları verin ve tek birden fazla grubu kapsayan işlemin her iki tanıtıcıyı da içerdiğini doğrulayın.
- İkinci gruptan uygun bir konumu çıkarın ve grupların ayrı işlemler oluşturduğunu doğrulayın.
- Kuralınız bu alanları okuyorsa gruplara farklı teslimat illeri veya ürün gereksinimleri verin ve politikanın her grupta bağımsız değerlendirildiğini kontrol edin.
- Sipariş yönlendirme kuralının önceliğini değiştirin ve eşitlik durumunu test edin. Eşitliği hangi kuralın çözdüğünü inceleyin.
- Sepet satırlarını veya teslimat adresini değiştirdikten sonra testi yineleyin. Tekrarlanan ödeme adımı testlerini değerlendirirken önbelleğe alınmış sonuçları hesaba katın.
Konum kuralı oluşturma eğitimi hâlâ tek grup için uygulama örüntüsünü sunuyor. Önce bu örüntüyle başlayın, grup başına hesaplamayı doğru kurun, ardından toplu işlem ekleyin ve her toplu işlemi tek grup işlemlerine açmanın aynı sıralamaları ürettiğini doğrulayın. Yeni çıktı biçimini kullanmadan önce atılacak en güvenli adım, bu eşdeğerlik testidir.
Bunu şirket içinde yapmak yerine yaptırmak isterseniz, yönettiğim stüdyo Lintel bu tür projeler için Shopify API ve ERP entegrasyonları sunuyor.
Sıkça sorulan sorular
Bir Order Routing Function işlemi birden fazla karşılama grubunu sıralayabilir mi?
Evet. Unstable Order Routing Location Rule Function API, aynı sıralama listesini belirtilen karşılama gruplarına uygulayan, birden fazla grubu kapsayan bir işlemi destekler. Kullanmadan önce uzantınızda sabitlenmiş şema sürümünü kontrol edin.
Birden fazla grubu kapsayan sıralama, tüm grupları aynı depoyu kullanmaya zorlar mı?
Hayır. Sıralama, her grubun uygun envanter konumları arasındaki tercihi belirtir. Grupları birleştirmez, uygun konum eklemez veya tek gönderiyi garanti etmez.
Sipariş yönlendirme girdi sorgusunda hangi alanlar yer almalı?
Grup tanıtıcıları, envanter konum tanıtıcıları ve yalnızca sıralama kuralınızın kullandığı konum nitelikleriyle başlayın. Grup teslimat adreslerini veya satırlarını yalnızca politikanız bunlara bağlıysa ekleyin.