Sipariş verilerini al
Sipariş verileri gerektiren iş akışlarında mağazanızdan sipariş verilerini almak için Sipariş verilerini al işlemini kullanabilirsiniz.
Yapılandırma
Alanlar
Sipariş verilerini al işlemi, sorguyu oluşturmak için kullanılan aşağıdaki alanları içerir:
| Alan | Açıklama |
|---|---|
| Verileri sıralama ölçütü | Gereklidir. Arama sorgusu tarafından döndürülen verilerin sıralanmasında kullanılan parametreler. |
| Maksimum sonuç sayısı | Gerekli. Seçtiğiniz arama sorgusu tarafından döndürülebilecek maksimum sonuç sayısı. Bir seferde 100 adede kadar sonuç döndürebilirsiniz. |
| Sorgu | Gerekli. Yaygın sorgulardan birini seçin 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 almaya yönelik örnek bir sorgudur:
updated_at:<='{{ scheduledAt }}' AND updated_at:>'{{ scheduledAt | date_minus: "1 day" }}'updated_at değişkeni, Siparişler sorgusunda bulunan bir filtredir ve bir defadan fazla kullanılabilir veya diğer değişkenlerle birleştirilebilir. scheduledAt Liquid değişkeni, Planlanan zaman tetikleyicisini kullanan iş akışlarında kullanılabilir. date_minus Liquid etiketi, bir tarihten zaman eksiltmenize olanak sağlayan özel bir Flow etiketidir.
Veri sorgusu yaparken şunları bilmek faydalıdır:
- Mevcut sipariş filtrelerinin listesi - Sorgular belirli bir sözdizimine sahip olmalıdır
- Tüm sorgular için sorgu alanı adları, QueryRoot nesnesi ile ilgili geliştirici belgelerinde bulunabilir.
- Sorgu alanı değerleri her zaman belgelenmez. Bazı durumlarda değerler, API belgelerine bakarak bulunabilir. Alternatif olarak, filtreleme yaparken alan değerlerini genellikle Yöneticideki URL'lerde bulabilirsiniz. Örneğin, bazı Sipariş sorgusu değerlerini bulmak için Yöneticideki Siparişler sayfasını filtreleyin ve URL'yi kontrol edin.
- Shopify GraphiQL uygulamasını kullanarak mağazanızda bir sorguyu çalıştırabilir veya test edebilirsiniz.
- Sorgunuz başarısız olursa ne olacağına dikkat etmeniz gerekir. Genellikle API tüm sonuçları (sıfır sonuç yerine) döndürür.
Döndürülen veriler
Tüm Veri al işlemleri, 0 ile 100 arasında kaynağın bir listesini döndürür. Kullandığınız duruma bağlı olarak, bu verileri çeşitli şekillerde kullanmak isteyebilirsiniz:
- Her liste öğesi için ayrı ayrı işlem yapmanız gerekiyorsa (her birine bir etiket eklemek gibi), For each eylemini kullanabilirsiniz.
- Verileri toplamanız gerekiyorsa (kaç sonuç döndürüldüğünü saymak gibi) Count veya Sum işlemlerini kullanabilirsiniz.
- Listenin çıktısını almanız gerekiyorsa (tüm öğeleri içeren bir e-posta göndermek gibi) döndürülen verileri sonraki işlemlerde doğrudan kullanabilirsiniz.
Bu işlemi takip eden adımlarda döndürülen verilere erişmek için, siparişlerin bir listesini içeren Sipariş verilerini al adlı değişkeni kullanın. Bu değişkeni hem koşullarda hem de işlemlerde kullanabilirsiniz. Örneğin, aşağıda gösterildiği gibi, gönderim siparişlerinin bir listesini Dahili e-posta gönder işlemiyle gönderebilirsiniz:
{% for single_order in GetOrderData %}
- {{ single_order.name }}
{% endfor %}Tetikleyiciler
Bu işlemi, Planlanan zaman tetikleyicisi de dahil olmak üzere herhangi bir iş akışında kullanabilirsiniz. Planlanan zaman tetikleyicisini kullanan bir iş akışı, etkinlik sonucunda değil, belirttiğiniz zamanda başlatılır. Mağazanızdan veya iş akışını başlatan bir uygulamadan gelen belirli bir etkinlik olmadığından hiçbir veri otomatik olarak dahil edilmez.
API ayrıntıları
Şablonlar
Sık ürün iadesi yapan müşterilerin siparişlerini iptal etme
Son altı ay içinde, aldığı ürünleri beş defa veya beş defadan fazla iade eden müşterilerin siparişlerini iptal eder. Sipariş verilerini alır, iadeleri sayar, mevcut siparişi iptal edip para iadesi oluşturur ve ürünleri stoka geri ekler. Bu şablon şunlar için kullanılabilir: Alışılmış iadelerden kaynaklanan kayıpları azaltmak, potansiyel iadelerle ilgili önceden işlem yaparak sipariş yönetimini kolaylaştırmak ve aşırı iadeleri engelleyerek karlılığı korumak. Şablonu görüntüleyin
Müşteri gün içinde 5'ten fazla sipariş verdiyse siparişleri iptal etme
Müşteri bir gün içinde beş adetten fazla sipariş vermişse siparişleri iptal eder. Müşterinin son 24 saat içinde verdiği sipariş sayısını kontrol eder ve bu sınırı aşan siparişleri iptal edip müşteriye potansiyel sahtekarlık etiketi ekler. Şablonu görüntüleyin
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 ters ibraz içeren tüm siparişleriyle ilgili bilgileri alır. Böyle siparişler mevcutsa her bir kargo için gönderimi beklemeye alır ve faaliyetlerinize bilgi sağlamak için dahili bir e-posta gönderir. Şablonu görüntüleyin
Müşteri 24 saat içinde birden fazla sipariş verdiyse gönderimleri beklemeye alma
Bir müşterinin 24 saatlik süre içinde birden fazla sipariş verip vermediğini kontrol edin. Birden fazla sipariş verilmişse gönderimi beklemeye alın ve kargoları birleştirin. Şablonu görüntüleyin
Müşteri son 24 saat içinde birden fazla sipariş verdiyse siparişleri beklemeye alma
Yeni bir sipariş oluşturulduğunda, müşterinin son 24 saat içinde başka bir sipariş verip vermediğini kontrol edin. Böyle bir durumda tüm siparişleri beklemeye alın. Şablonu görüntüleyin
Son bir saat içinde sipariş hacmi 10'un altına düştüğünde bildirim gönderme
Sipariş ritmi bildirimi gönderir. Her saat başı oluşturulan 10'a kadar siparişin bilgilerini alır ve bunları sayar. Sayı 10'dan azsa e-posta ile bir bildirim gönderir. Planlanan zaman, Sipariş verilerini al ve Sayım adımlarını kullanır. Şablonu görüntüleyin
Son gün içinde verilen tüm siparişlerin özetini e-postayla Online Mağazaya gönderme
Her gün, son günün siparişlerine ait bilgileri alır ve online mağazada verilen siparişlerin özetini e-postayla gönderir. Şablonu görüntüleyin
2 günden daha eski ve gönderilmemiş tüm siparişlerin özetini e-postayla gönderme
Zaman planlarından ve sipariş verilerini al, sayım ve toplam işlemlerinden yararlanarak, 2 günden eski gönderilmemiş tüm siparişleriniz için günlük bir özet alın. Şablonu görüntüleyin
Geç gönderimleri etiketleme ve günlük özetini gönderme
Her gün, 2 günde gönderim garantisini kaçıran tüm siparişleri etiketleyin ve bunların toplam sayısını ve parasal değerini içeren günlük bir e-posta özeti gönderin. Şablonu görüntüleyin
Ters ibrazı olan müşterileri etiketleme
Bu iş akışları her saat başı ters ibraz içeren siparişleri alır ve sipariş için müşteriye bir etiket ekler. Planlanan zaman tetikleyicisini, sipariş verilerini al işlemini ve "for each" döngüsünü kullanır. Şablonu görüntüleyin
2 günden eski gönderilmemiş siparişleri etiketleme
İş akışı her gün, 2 günden daha eski olan tüm gönderilmemiş siparişleri alır ve siparişlere etiket ekler. Şablonu görüntüleyin
Müşterileri son 6 aydaki siparişlerine göre segmentlere ayırmak için etiketleri kullanma
Yeni bir sipariş oluşturulduğunda müşterinin son 6 aydaki sipariş toplamını ve sipariş sayısını alın ve müşteriye etiketler ekleyin. Sipariş verilerini al, Sayı ve Toplam işlemlerini kullanır. Şablonu görüntüleyin