Sipariş verilerini al
Sipariş verileri gerektiren iş akışlarında, mağazanızdan sipariş bilgilerini almak için Sipariş verilerini al eylemini kullanabilirsiniz.
Yapılandırma
Alanlar
Sipariş verilerini al eylemi, sorguyu oluşturmak için kullanılan aşağıdaki alanları içerir:
| Alan | Açıklama |
|---|---|
| Verileri sıralama ölçütü | Gerekli. Arama sorgusu tarafından döndürülen verilerin sıralanacağı parametreler. |
| Maksimum sonuç sayısı | Gerekli. Seçtiğiniz arama sorgusu tarafından döndürülebilecek maksimum sonuç sayısı. Tek seferde en fazla 100 sonuç döndürebilirsiniz. |
| Sorgu | Gerekli. Genel sorgular arasından seçim yapın veya kendi sorgunuzu oluşturmak için Gelişmiş'i seçin. |
Sorgu dizesi
Bu, son bir gün içinde güncellenen siparişleri almak için bir örnek sorgudur:
updated_at:<='{{ scheduledAt }}' AND updated_at:>'{{ scheduledAt | date_minus: "1 day" }}'updated_at değişkeni, Siparişler sorgusunda kullanılabilen bir filtredir ve birden çok kez kullanılabilir ya da diğer değişkenlerle birleştirilebilir. scheduledAt Liquid değişkeni, Zamanlanmış zaman tetikleyicisini kullanan iş akışlarında kullanılabilir. date_minus Liquid etiketi, bir tarihten zaman çıkarmanıza olanak tanıyan özel bir Flow etiketidir.
Verileri sorgularken aşağıdakileri bilmek faydalı olacaktır:
- Kullanılabilir sipariş filtrelerinin listesi
- Sorgular belirli bir söz dizimine uymalıdır
- Sorgu alanı değerleri her zaman belgelenmez. Bazı durumlarda bu değerler, API belgelerine bakılarak bulunabilir. Alternatif olarak, Yönetici panelinde filtreleme yaptığınızda alan değerlerini genellikle URL'lerde bulabilirsiniz. Örneğin, bazı Sipariş sorgu değerlerini bulmak için Yönetici panelindeki Siparişler sayfasını filtreleyin ve ardından URL'yi kontrol edin.
- Mağazanızda bir sorguyu Shopify GraphiQL uygulamasını kullanarak çalıştırabilir veya test edebilirsiniz.
- Sorgunuz başarısız olursa ne olacağına dikkat edin. Genellikle API, hiç sonuç döndürmek yerine tüm sonuçları döndürür.
Döndürülen veriler
Tüm Veri al eylemleri, 0 ila 100 arasında kaynak içeren bir liste döndürür. Kullanım örneğinize bağlı olarak, bu verileri çeşitli şekillerde kullanmak isteyebilirsiniz:
- Her bir liste öğesini ayrı ayrı işlemeniz gerekiyorsa (örneğin, her birine bir etiket eklemek için) Her biri için eylemini kullanabilirsiniz.
- Verileri toplamanız gerekiyorsa (örneğin, döndürülen sonuçların sayısını saymak için) Sayı veya Toplam eylemlerini kullanabilirsiniz.
- Listeyi çıktı olarak almanız gerekiyorsa (örneğin, tüm ürünleri içeren bir e-posta göndermek için) döndürülen verileri doğrudan sonraki eylemlerde kullanabilirsiniz.
Bu eylemi izleyen adımlarda döndürülen verilere erişmek için, bir sipariş listesi olan Sipariş verilerini al adlı değişkeni kullanın. Bu değişkeni hem koşullarda hem de eylemlerde kullanabilirsiniz. Örneğin, sipariş listesini bir Dahili e-posta gönder eyleminde şu şekilde gönderebilirsiniz:
{% for single_order in GetOrderData %}
* {{ single_order.name }}
{% endfor %}Tetikleyiciler
Bu eylemi, Zamanlanmış zaman tetikleyicisi de dahil olmak üzere herhangi bir iş akışında kullanabilirsiniz. Zamanlanmış zaman tetikleyicisini kullanan bir iş akışında, iş akışı bir olayın sonucu olarak değil, belirttiğiniz bir zamanda başlar. İş akışını başlatan, mağazanızda veya bir uygulamada gerçekleşen belirli bir olay olmadığından, otomatik olarak dahil edilen hiçbir veri yoktur.
API ayrıntıları
Şablonlar
Sık iade yapanların siparişlerini iptal etme
Son altı ayda beş veya daha fazla kez ürün iade etmiş müşterilerin siparişlerini iptal eder. Sipariş verilerini getirir, iadeleri sayar ve mevcut siparişi iptal ederek para iadesi yapar ve ürünleri stoka geri ekler. Bu şablon şu amaçlarla kullanılabilir: alışkanlık olarak iade yapanlardan kaynaklanan kayıpları azaltmak, olası iadeleri önceden ele alarak sipariş yönetimini kolaylaştırmak ve aşırı iadeleri önleyerek kârlılığı korumak. Şablonu görüntüle
Müşteri bugün 5'ten fazla sipariş verdiyse siparişleri iptal etme
Bir müşteri bir gün içinde beşten fazla sipariş verirse siparişleri iptal eder. Bir müşterinin son 24 saatte verdiği sipariş sayısını kontrol eder ve bu sınırı aşan tüm siparişleri iptal ederek müşteriyi olası sahtekarlık için etiketler. Şablonu görüntüle
Ters ibrazı olan müşterilerin gönderim siparişlerini beklemeye alma
Bir sipariş gönderilmeye hazır olduğunda, iş akışı aynı müşterinin son 60 gün içinde verdiği ve ters ibraz içeren tüm siparişleri alır. Bu tür siparişler varsa her bir kargonun gönderimini beklemeye alır ve operasyon ekibinizi bilgilendirmek için dahili bir e-posta gönderir. Şablonu görüntüle
Müşteri 24 saat içinde birden fazla sipariş verdiyse gönderimleri beklemeye alma
Bir müşterinin 24 saatlik bir süre içinde birden fazla sipariş verip vermediğini kontrol edin. Bu doğruysa gönderimleri beklemeye alın ve kargoyu birleştirin. Şablonu görüntüle
Müşteri son 24 saatte 1'den fazla sipariş verdiyse siparişleri beklemeye alma
Bir sipariş oluşturulduğunda, müşterinin son 24 saat içinde başka sipariş verip vermediğini kontrol edin. Verdiyse tüm siparişleri beklemeye alın. Şablonu görüntüle
Son saatteki sipariş hacmi 10'dan az olduğunda bildirim gönderme
Sipariş etkinliği bildirimi gönderir. Her saat, oluşturulan en fazla 10 sipariş alınır ve sayılır. Sayı 10'dan azsa e-posta yoluyla bildirim gönderilir. Zaman planlama, Sipariş verilerini al ve Sayma adımlarını kullanır. Şablonu görüntüle
Son gündeki tüm siparişlerin e-posta özetini Online Mağaza'ya gönderme
Her gün, son güne ait siparişleri alır ve online mağazada verilen siparişlerin e-posta özetini gönderir. Şablonu görüntüle
2 günden eski tüm gönderilmemiş siparişlerin özetini e-postayla gönder
Zaman planlamaları, sipariş verilerini al, say ve topla adımlarını kullanarak 2 günden eski, gönderilmemiş tüm siparişlerinizin günlük özetini alın. Şablonu görüntüle
Gecikmiş gönderimlerin günlük özetini etiketle ve gönder
Her gün, 2 günlük kargo garantisini karşılamayan tüm siparişler etiketlenir ve bu siparişlerin toplam sayısı ile parasal değerini içeren günlük bir e-posta özeti gönderilir. Şablonu görüntüle
Ters ibrazı olan müşterileri etiketle
Bu iş akışı her saat, ters ibraz içeren siparişleri alır ve siparişin müşterisine bir etiket ekler. Zamanlanmış zaman tetikleyicisi, sipariş verilerini al ve her bir döngü için adımlarını kullanır. Şablonu görüntüle
2 günden eski gönderilmemiş siparişleri etiketle
Her gün, iş akışı 2 günden eski tüm gönderilmemiş siparişleri alır ve siparişe bir etiket ekler. Şablonu görüntüle
Müşterileri son 6 aydaki siparişlerine göre segmentlere ayırmak için etiket kullanma
Yeni bir sipariş oluşturulduğunda, müşterinin son 6 aya ait sipariş toplamı ve sipariş sayısı alınır, ardından müşteriye etiketler eklenir. Bu iş akışı, Sipariş verilerini al, Say ve Topla adımlarını kullanır. Şablonu görüntüle