Gönderim siparişi verilerini al
Mağazanızdan gönderim siparişi bilgilerini almak için Gönderim siparişi verilerini al eylemini kullanabilirsiniz.
Yapılandırma
Alanlar
Gönderim siparişi verilerini al eylemi, sorguyu oluşturmak için kullanılan aşağıdaki alanları içerir:
| Alan | Açıklama |
|---|---|
| Verileri şuna göre sırala | 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ıdır. Her seferinde en fazla 100 sonuç döndürebilirsiniz. |
| Sorgu | Gerekli. Yaygın sorgular arasından seçim yapın veya kendi sorgunuzu oluşturmak için Gelişmiş'i seçin. |
Sorgu dizesi
Bu, şu anda beklemeye alınmış olan gönderim siparişlerini almak için örnek bir sorgudur:
status:ON_HOLDstatus değişkeni, Gönderim Siparişleri sorgusunda kullanılabilen bir filtredir ve birden çok kez kullanılabilir veya diğer değişkenlerle birleştirilebilir.
Verileri sorgularken aşağıdakileri bilmek yararlı olacaktır:
- Kullanılabilir gönderim siparişi filtrelerinin listesi
- Sorguların belirli bir söz dizimine uyması gerekir.
- Sorgu alanı değerleri her zaman belgelenmez. Bazı durumlarda değerler, API belgelerine bakılarak bulunabilir. Alternatif olarak, filtreleme yaptığınızda alan değerlerini genellikle Yönetici'deki URL'lerde bulabilirsiniz. Örneğin, bazı Sipariş sorgu değerlerini bulmak için Yönetici'deki 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.
- Sorgunuzun başarısız olması durumunda ne olacağına dikkat edin. API genellikle hiçbir 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 birine etiket eklemek gibi, her bir liste öğesini ayrı ayrı işlemeniz gerekiyorsa Her biri için eylemini kullanabilirsiniz.
- Kaç sonucun döndürüldüğünü saymak gibi verileri toplamanız gerekiyorsa Sayı veya Toplam eylemlerini kullanabilirsiniz.
- Tüm ürünleri içeren bir e-posta göndermek gibi, listeyi çıktı olarak almanız gerekiyorsa döndürülen verileri doğrudan sonraki eylemlerde kullanabilirsiniz.
Bu eylemi izleyen adımlarda döndürülen verilere erişmek için, gönderim siparişleri listesi olan Gönderim siparişi verilerini al adlı değişkeni kullanın. Bu değişkeni hem koşullarda hem de eylemlerde kullanabilirsiniz. Örneğin, gönderim siparişleri listesini bir Dahili e-posta gönder eyleminde şu şekilde gönderebilirsiniz:
{% for fulfillment_order in GetFulfillmentOrderData %}
* Order: {{ fulfillment_order.order.name }} Location: {{ fulfillment_order.assignedLocation.name }}
{% endfor %}Tetikleyiciler
Bu eylemi, Zamanlanmış zaman tetikleyicisi de dahil olmak üzere tüm iş akışlarında kullanabilirsiniz. Zamanlanmış zaman tetikleyicisini kullanan bir iş akışında, iş akışı bir etkinliğin 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 etkinlik olmadığından, otomatik olarak eklenen bir veri yoktur.
API ayrıntıları
Şablonlar
Beklemeye alınmış gönderim siparişlerinin listesini içeren günlük e-posta özeti gönderin
Bu iş akışı, her gün beklemeye alınmış olan tüm gönderim siparişlerini sorgular (her seferinde en fazla 100 adet). Sipariş adını ve atanan gönderim konumunu içeren bir e-posta özeti gönderir. Şablonu görüntüle