DOCS

Sipariş durumunu güncelle

Sipariş durumunu güncelleme endpoint'inin nasıl çalıştığını öğrenin.

updateVendorOrderStatus endpoint'i, Zonos Sistemi içindeki bir siparişin durumunu güncellemek için kullanılır. Bu, siparişin kargo durumunu programatik olarak güncellemek veya iptal istemi göndermek için kullanılacaktır.

Geçerli sipariş durumu değerleri 

Aşağıda, bir siparişin sahip olabileceği mevcut sipariş durumlarının bir listesi verilmiştir.

Uyarı - Zonos herhangi bir zamanda daha fazla durum ekleyebilir; sisteminiz ek durumların varlığına uyum sağlamalıdır.

Üretimdeki durumlar üretimde kalacaktır. Zonos, mevcut durumları asla kaldırmayacaktır.

Durum↕Açıklama↕Ayarlayan↕
IGLOBAL_FRAUD_REVIEWSiparişin şu anda iGlobal tarafından dolandırıcılık incelemesi altındadır.Zonos
IGLOBAL_ORDER_IN_PROCESSSipariş geçerli ve işleme hazırdır.Zonos
IGLOBAL_ORDER_ON_HOLDSipariş şu anda geçici bir durum tutma durumundadır.Zonos
IGLOBAL_ORDER_CANCELLEDSipariş iGlobal Sistemi'nde iptal edilmiştir.Zonos
VENDOR_PREPARING_ORDERSatıcı siparişi hazırlama olarak işaretlemiştir.Satıcı
VENDOR_SHIPMENT_READYSatıcı siparişi gönderim için hazır olarak işaretlemiştir.Satıcı
VENDOR_LABELS_PRINTED_DATESatıcı kargo etiketlerini yazdırmıştır.Satıcı
VENDOR_CANCELLATION_REQUESTSipariş iptal için istekte bulunmuştur.Satıcı
VENDOR_END_OF_DAY_COMPLETESipariş sonlandırılmış ve tamamlanmıştır.Satıcı

vendorOrderStatus satıcı tarafından aşağıdaki sipariş durumlarından birinde iken 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öntemiPOST
Endpoint URL'sihttps://api.iglobalstores.com/v1/updateVendorOrderStatus
ProtokolHTTPS
İleti biçimiJSON
Accept HTTP başlığıAccept: application/json
Content-Type HTTP başlığıContent-Type: application/json

İstek gövdesindeki JSON anahtar/değer çiftleri

İleti biçimi: JSON

1{
2 "store": "999",
3 "secret": "f5bde245-f55e-414d-b722-80b25161c12c",
4 "orderId": "999-9999",
5 "orderStatus": "VENDOR_END_OF_DAY_COMPLETE"
6}

İstek JSON tanımları

Alan↕Notlar↕
orderId GEREKLIZonos sipariş kimliği, mağaza kimliğiniz ve tire ile veya tire olmadan geçirilebilir (Örnek: 123-45678 veya 45678). Sipariş tamamlandıktan ve ödeme yapıldıktan sonra, müşteri etki alanınız üzerinde barındırılan bir sipariş tamamlama / sipariş teşekkür sayfasına yönlendirilecektir. URL, bu değeri içerecek orderID sorgu dizesi parametresi içerecektir.integer / string
orderStatus GEREKLIBu alan, Zonos sistemini bir siparişin yeni durumuyla güncellemek için kullanılır. Aşağıdaki sipariş durumları bu API aracılığıyla ayarlanabilir. - VENDOR_PREPARING_ORDER
  • VENDOR_SHIPMENT_READY
  • VENDOR_LABELS_PRINTED
  • VENDOR_END_OF_DAY_COMPLETE
  • VENDOR_CANCELLATION_REQUEST``string | | secret GEREKLI | Zonos tarafından sağlanan API gizli GUID.string | | store GEREKLI | Zonos tarafından sağlanan Mağaza Kimliğiinteger |

HTTPS yanıtı

İleti biçimi: JSON

1{
2 "success": "Updated Order: 99999 to new order status: VENDOR_PREPARING_ORDER"
3}

Hata HTTP yanıtları

HTTP Yanıt Kodları↕Yanıt Gövdesi Örneği/Açıklama↕
406 - Not AcceptableHTML Varlığı. HTTP "Accept" başlığı geçersizdir.
415 - Unsupported media typeHTML Varlığı. HTTP "Content-Type" başlığı geçersizdir.
200"error":"could not parse input"
200"error":"Parameter orderId required for updateVendorOrderStatus"
200"error":"Parameter orderStatus required for updateVendorOrderStatus."
200"error":"orderId: 999-99999 is not a valid orderId"
200"error":"Could not retrieve order to updateVendorOrderStatus from orderId: 999-99999"
200"error":"OrderId: 999-99999 has already been cancelled and status cannot be updated."
200"error":"Cannot update order status to status: VENDOR_CANCELLATION_REQUEST"
200"error":"Cannot update order status to invalid status: NEW_ORDER_STATUS"
200"error":"OrderId: 999-99999 already has current status: VENDOR_SHIPMENT_READY"
200"error":"OrderId: 999-99999 cannot be moved to order status: VENDOR_CANCELLATION_REQUEST while in status: VENDOR_END_OF_DAY_COMPLETE"
200"error":"New Status: NEW_ORDER_STATUS is not a valid order status"
200"error":"Could not process updateVendorOrderStatus."
200"error":"Invalid security credentials"

Yanıt JSON tanımları

İleti↕Tanım↕
successBu parametre, güncellemenin özetini içerecektir.string
errorBu parametre yalnızca bir hata oluştuğunda yanıtta görünecek ve hatanın nedeninin bir açıklamasını içerecektir.string

Bu sayfa faydalı mıydı?