Mevcut sipariş durumu değerleri
Aşağıda bir siparişin sahip olabileceği mevcut sipariş durumlarının bir listesi bulunmaktadır.
Dikkat - Zonos her an daha fazla durum ekleyebilir; sisteminiz ek durumların varlığını karşılayacak şekilde tasarlanmalıdır.
Üretimdeki durumlar üretimde kalacaktır. Zonos mevcut durumları asla kaldırmayacaktır.
| Durum | Açıklama | Tarafından ayarlanabilir |
|---|---|---|
| IGLOBAL_FRAUD_REVIEW | Sipariş şu anda iGlobal tarafından dolandırıcılık incelemesi altındadır. | Zonos |
| IGLOBAL_ORDER_IN_PROCESS | Sipariş geçerli ve işleme hazırdır. | Zonos |
| IGLOBAL_ORDER_ON_HOLD | Sipariş şu anda geçici bir durum beklemesindedir. | Zonos |
| IGLOBAL_ORDER_CANCELLED | Sipariş iGlobal Sisteminde iptal edilmiştir. | Zonos |
| VENDOR_PREPARING_ORDER | Satıcı siparişi hazırlıkta olarak işaretlemiştir. | Satıcı |
| VENDOR_SHIPMENT_READY | Satıcı siparişi gönderime hazır olarak işaretlemiştir. | Satıcı |
| VENDOR_LABELS_PRINTED_DATE | Satıcı gönderim etiketlerini basmıştır. | Satıcı |
| VENDOR_CANCELLATION_REQUEST | Siparişin iptali talep edilmiştir. | Satıcı |
| VENDOR_END_OF_DAY_COMPLETE | Sipariş tamamlanmış ve sonlandırılmıştır. | Satıcı |
vendorOrderStatus, sipariş aşağıdaki sipariş durumlarından birindeyken satıcı tarafından güncellenemez:IGLOBAL_LABELS_PROCESSINGIGLOBAL_ORDER_ON_HOLDIGLOBAL_FRAUD_REVIEWIGLOBAL_ORDER_CANCELLEDVENDOR_CANCELLATION_REQUESTVENDOR_END_OF_DAY_COMPLETE
HTTPS isteği
POST | https://api.iglobalstores.com/v1/updateVendorOrderStatus
| Alan | Değer |
|---|---|
| HTTP yöntemi | POST |
| Uç nokta URL'si | https://api.iglobalstores.com/v1/updateVendorOrderStatus |
| Protokol | HTTPS |
| Mesaj formatı | JSON |
| Accept HTTP başlığı | Accept: application/json |
| Content-Type HTTP başlığı | Content-Type: application/json |
İstek gövdesindeki JSON anahtar/değer çiftleri
Mesaj formatı: JSON
ÖRNEK
1
2
3
4
5
6
{
"store": "999",
"secret": "f5bde245-f55e-414d-b722-80b25161c12c",
"orderId": "999-9999",
"orderStatus": "VENDOR_END_OF_DAY_COMPLETE"
}
JSON tanımları
| Alan | Notlar |
|---|---|
orderId GEREKLİ | Zonos sipariş kimliği, mağaza kimliğinizle birlikte veya onsuz ve tire ile geçilebilir (Örnek: 123-45678 veya 45678). Sipariş tamamlandıktan ve ödeme yapıldıktan sonra, müşteri alan adınızda barındırılan bir sipariş tamamlama / sipariş teşekkür sayfasına yönlendirilecektir. URL, bu değeri içerecek olan orderID sorgu dizesi parametresini içerecektir. integer / string |
orderStatus GEREKLİ | Bu alan, Zonos sistemini bir siparişin yeni durumu ile güncellemek için kullanılır. Aşağıdaki sipariş durumları bu API aracılığıyla ayarlanabilir. - VENDOR_PREPARING_ORDER |
VENDOR_SHIPMENT_READYVENDOR_LABELS_PRINTEDVENDOR_END_OF_DAY_COMPLETEVENDOR_CANCELLATION_REQUESTstring| |secretGEREKLİ | Zonos tarafından sağlanan API gizli GUID'si.string| |storeGEREKLİ | Zonos tarafından sağlanan mağaza kimliği.integer|
HTTPS yanıtı
Mesaj formatı: JSON
Örnek başarılı yanıt
1
2
3
{
"success": "Updated Order: 99999 to new order status: VENDOR_PREPARING_ORDER"
}
Örnek hata yanıtı
1
2
3
{
"error": "OrderId: 99999 cannot be moved to order status: VENDOR_PREPARING_ORDER while in status: IGLOBAL_FRAUD_REVIEW"
}
Hata HTTP yanıtları
| HTTP Yanıt Kodları | Yanıt Gövdesi Örneği/Açıklaması |
|---|---|
| 406 - Kabul Edilemez | HTML Varlığı. HTTP “Accept” başlığı geçersiz. |
| 415 - Desteklenmeyen medya türü | HTML Varlığı. HTTP “Content-Type” başlığı geçersiz. |
| 200 | “error”:“girdi ayrıştırılamadı” |
| 200 | “error”:“updateVendorOrderStatus için orderId parametresi gereklidir” |
| 200 | “error”:“updateVendorOrderStatus için orderStatus parametresi gereklidir.” |
| 200 | “error”:“orderId: 999-99999 geçerli bir orderId değil” |
| 200 | “error”:“orderId: 999-99999 ile updateVendorOrderStatus için sipariş alınamadı” |
| 200 | “error”:“OrderId: 999-99999 zaten iptal edildi ve durum güncellenemez.” |
| 200 | “error”:“Durum: VENDOR_CANCELLATION_REQUEST olarak sipariş durumunu güncelleyemezsiniz” |
| 200 | “error”:“Geçersiz durum: NEW_ORDER_STATUS olarak sipariş durumunu güncelleyemezsiniz” |
| 200 | “error”:“OrderId: 999-99999 zaten mevcut durum: VENDOR_SHIPMENT_READY” |
| 200 | “error”:“OrderId: 999-99999, durum: VENDOR_END_OF_DAY_COMPLETE iken sipariş durumu: VENDOR_CANCELLATION_REQUEST'a taşınamaz” |
| 200 | “error”:“Yeni Durum: NEW_ORDER_STATUS geçerli bir sipariş durumu değil” |
| 200 | “error”:“updateVendorOrderStatus işlenemedi.” |
| 200 | “error”:“Geçersiz güvenlik kimlik bilgileri” |
Yanıt JSON tanımları
| Mesaj | Tanım |
|---|---|
success | Bu parametre güncellemenin bir özetini içerecektir.string |
error | Bu parametre yalnızca bir hata meydana geldiğinde yanıt içinde bulunacak ve nedenin açıklamasını içerecektir.string |
Sipariş durumunu güncelle
Sipariş durumunu güncelleme uç noktasının nasıl çalıştığını öğrenin.
updateVendorOrderStatusuç noktası, Zonos Sistemi içindeki bir siparişin durumunu güncellemek için kullanılır. Bu, siparişin gönderim durumunu programlı olarak güncellemek veya bir iptal talep etmek için kullanılacaktır.