Bir siparişi getir

Bu "Bir Siparişi Getir" API uç noktası, Zonos Sistemi içinde tamamlanmış bir sipariş için veri almak için kullanılır. Yanıt, fatura ve teslimat adreslerini, teslimat yöntemini, sipariş toplamlarını ve durumunu içeren siparişle ilgili tüm mevcut bilgileri temsil eden bir JSON nesnesi içerecektir.

Uç Noktalar 

Sipariş numaraları

Bir sipariş numaraları listesini getirir.

Sipariş detayları

Bir sipariş için detaylı bilgileri getirir.

Bir sipariş API uç noktası kullanımı

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

1. (Bölüm 1 + Bölüm 2) - Özel bir sipariş onayı / başarı sayfası kullanarak sisteminizi orderDetail uç noktasını çağırmak ve tamamlanmış bir siparişi içe aktarmak için kullanın. Ayrıca, Zonos Sistemi'ndeki sisteminize içe aktarılmamış siparişleri uzlaştırmak için düzenli olarak orderNumbers uç noktasını arayın.
2. (Sadece Bölüm 2) - Zonos temel sipariş onayı / başarı sayfasını veya alanınızda bir statik sayfayı kullanarak müşteriye sipariş tamamlanmasını gösterin. Sisteminizi, yeni bir siparişin içe aktarılmaya hazır olduğunu belirlemek için düzenli olarak orderNumbers uç noktasını aramaya planlayın. Bir bekleyen sipariş bulunduğunda, bu siparişlerin verileri için orderDetail uç noktasını arayın.

Bölüm 1: Alanınızdaki başarı sayfası

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

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

Bir müşteri bu sayfaya yönlendirildiğinde, sisteminiz URL'den orderId değerini ayrıştırmalıdır. Daha sonra orderId değerini kullanarak orderDetail uç noktasını arayarak sipariş verilerini alacaksınız.

Bölüm 2: Zamanlanmış bir iş kullanın

Başarı sayfası tetiklendiğinde sipariş detaylarını çağırmaya ek olarak, tüm siparişler ve detayları için bir yakalama olarak düzenli bir çağrı kurmanızı öneririz. Bu şekilde, henüz sisteminize içe aktarılmamış Zonos Sistemi'ndeki tamamlanmış siparişleri alabilirsiniz.

Bu işlem, bir Cron işi gibi zamanlanmış bir iş/skript olmalıdır ve saatte/bir vardiya/gün vs. bir kez çalıştırılmalıdır (iş süreçleriniz ne kadar sıklıkta gerektiriyorsa o kadar sıklıkta). Skript, son çağrıdan bu yana gerçekleşen tüm siparişleri ve detaylarını almalıdır. orderNumbers uç noktası, burada bulunan API test GUI'de gösterildiği gibi sinceOrderId veya sinceDate ile siparişleri almanıza olanak tanır. Bu zamanlanmış çağrı ile alınan tüm siparişler, her başarı sayfası tetiklendiğinde sisteminize eklenen siparişlerle uzlaştırılmalıdır. Sisteminizde henüz bulunmayan siparişler sisteminize eklenmeli ve meşru siparişler olarak işlem görmelidir.

İlk sipariş durumu

IGLOBAL_ORDER_IN_PROCESS veya IGLOBAL_FRAUD_REVIEW

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

Sahtekarlık incelemesi gerektirmeyen siparişler, orderStatus : IGLOBAL_ORDER_IN_PROCESS ile başlatılacaktır. Bu durumdaki bir sipariş işlenmeye ve sevkiyata hazırdır.

Sahtekarlık incelemesi gerektiren siparişler, orderStatus : IGLOBAL_FRAUD_REVIEW ile başlatılacaktır. Bu durumdaki bir sipariş şu anda şüpheli sahtekarlık için taranmakta ve incelenmektedir. Bu siparişi sisteminizde bir inceleme veya bekletme durumuna yerleştirmenizi ve siparişiniz Zonos'un sahtekarlık inceleme sürecinden geçene kadar orderDetail uç noktasını aramaya devam etmenizi öneririz.

Zonos sahtekarlık tarama süreci tamamlandığında, sipariş aşağıdaki durumlardan birine geçecektir:

• Sipariş sahtekarlık taramasını geçer

  • Sipariş, orderStatus : IGLOBAL_ORDER_IN_PROCESS durumuna geçecek ve sevkiyata devam edebilecektir.

• Sipariş sahtekarlık taramasını geçemez

  • Sipariş, orderStatus : IGLOBAL_ORDER_CANCELLED durumuna geçecek ve sisteminizde iptal edilmelidir.

API test GUI

Lütfen destek ekibiyle iletişime geçin ve hesap kimlik bilgilerinizi alın.