Siparişi al

Bu "Siparişi Al" API uç noktası, Zonos Sistemi içinde tamamlanan bir sipariş için veri almak için kullanılır. Yanıt, fatura ve teslimat adresleri, teslimat yöntemi, sipariş toplamları ve durum dahil olmak üzere sipariş için tüm mevcut bilgileri temsil eden bir JSON nesnesi içerecektir.

Uç noktalar 

Sipariş numaraları

Sipariş numaralarının bir listesini alır.

Sipariş ayrıntıları

Bir sipariş için ayrıntılı bilgileri alır.

Siparişi Al API uç noktası kullanımı

Bu uç noktaları kullanmanın iki yaygın yolu vardır.

1. (1. Kısım + 2. Kısım) – Sisteminizin orderDetail uç noktasını çağırmasını ve tamamlanan bir siparişi içe aktarmasını tetiklemek için etki alanınızda özel bir sipariş onayı / başarı sayfası kullanın. Ek olarak, Zonos Sistemi'nde sisteminize aktarılmamış siparişleri uzlaştırmak için düzenli olarak orderNumbers uç noktasını çağırın.
2. (Yalnızca 2. Kısım) – Zonos temel sipariş onayı / başarı sayfasını veya müşteriye sipariş tamamlamayı göstermek için etki alanınızda statik bir sayfayı kullanın. Yeni bir siparişin sisteminize aktarılmaya hazır olup olmadığını belirlemek için düzenli olarak orderNumbers uç noktasını çağırmak üzere sisteminizi planlayın. Bekleyen bir sipariş bulunduğunda, bu siparişlerdeki veriler için orderDetail uç noktasını çağırın.

1. Kısım: Etki alanınızda başarı sayfası

Alıcı, Zonos Checkout'ta bir siparişi tamamladığında, anında bir sipariş başarı sayfası URL'sine yönlendirilir. Tamamlanan sipariş kimliği, yeniden yönlendirme URL'sine sorgu dizesi olarak eklenir. Sipariş başarı sayfasının URL'si Zonos'a sağlanmalıdır. URL, Zonos Sistemi'nde geçici sepeti oluştururken createTempCart uç noktasında parametre olarak da iletilebilir.

Örnek: http://www.examplestore.com/internationalThankYou?orderId=999-99999

Müşteri bu sayfaya yönlendirildiğinde, sisteminiz URL'den orderId değerini ayrıştırmalıdır. Daha sonra orderId öğesini kullanarak orderDetail uç noktasını çağırarak sipariş verilerini alırsınız.

2. Kısım: Planlanan işi kullanın

Başarı sayfası tetiklendiğinde sipariş ayrıntıları çağırmaya ek olarak, tüm siparişleri ve ayrıntılarını kapsayıcı bir çözüm olarak planlanan bir çağrı ayarlamanızı öneririz. Bu sayede, Zonos Sistemi'nde sisteminize henüz aktarılmamış tüm tamamlanmış siparişleri alabilirsiniz.

Bu işlem, bir saatlik / vardiya / günlük vb. aralıklarla çalıştırılan Cron işi gibi planlanan bir işten / komut dosyasından oluşmalıdır (iş süreçlerinizin gerekli gördüğü kadar sık planlayın). Komut dosyası, son siparişler çağrısından bu yana meydana gelen tüm siparişleri ve ayrıntılarını çağırmalıdır. orderNumbers uç noktası, burada bulunan API test GUI'sinde gösterildiği gibi sinceOrderId veya sinceDate öğesine göre siparişleri almanızı sağlar. Bu planlanan çağrı aracılığıyla alınan tüm siparişler, başarı sayfası tetiklendiğinde sisteminize eklenen siparişlere karşı uzlaştırılmalıdır. Sisteminizde olmayan siparişler, sisteminize eklenmeli ve meşru siparişler olarak kabul edilmelidir.

İlk sipariş durumu

IGLOBAL_ORDER_IN_PROCESS veya IGLOBAL_FRAUD_REVIEW

orderDetail uç noktasını çağırırken, sisteminizin önce sipariş verilerinin orderStatus özelliğini kontrol etmesini öneririz.

Dolandırıcılık incelemesi gerektirmeyen siparişler orderStatus: IGLOBAL_ORDER_IN_PROCESS ile başlatılır. Bu durumdaki bir sipariş işlenmeye ve sevk edilmeye hazırdır.

Dolandırıcılık incelemesi gerektiren siparişler orderStatus: IGLOBAL_FRAUD_REVIEW durumunda başlatılır. Bu durumdaki bir sipariş şu anda taranmakta ve şüpheli dolandırıcılık nedeniyle gözden geçirilmektedir. Bu siparişi sisteminizde inceleme veya bekleme durumuna almanızı ve sipariş Zonos'un dolandırıcılık inceleme sürecini geçene kadar orderDetail uç noktasını çağırmaya devam etmenizi öneririz.

Zonos dolandırıcılık taraması işlemi tamamlandığında, sipariş aşağıdaki durumlardan birine geçecektir:

• Sipariş dolandırıcılık taramasından geçer

  • Sipariş orderStatus: IGLOBAL_ORDER_IN_PROCESS öğesine geçecek ve sevkiyata doğru devam edebilecektir.

• Sipariş dolandırıcılık taramasından başarısız olur

  • Sipariş orderStatus: IGLOBAL_ORDER_CANCELLED öğesine geçecek ve sisteminizde iptal edilmelidir.

API test GUI'si

Hesap kimlik bilgileriniz için lütfen desteğe başvurun.