DOCS

Perbarui status pesanan

Pelajari cara kerja endpoint untuk memperbarui status pesanan.

Endpoint updateVendorOrderStatus digunakan untuk memperbarui status pesanan dari pesanan di dalam Sistem Zonos. Ini akan digunakan untuk memperbarui status pengiriman pesanan atau meminta pembatalan secara terprogram.

Nilai status pesanan saat ini 

Di bawah adalah daftar status pesanan yang mungkin dimiliki pesanan.

Perhatian - Zonos dapat menambahkan lebih banyak status kapan saja; sistem Anda harus mengakomodasi kehadiran status tambahan.

Status dalam produksi akan tetap dalam produksi. Zonos tidak akan pernah menghapus status yang ada.

StatusDeskripsiDapat disetel oleh
IGLOBAL_FRAUD_REVIEWPesanan sedang dalam tinjauan penipuan oleh iGlobal.Zonos
IGLOBAL_ORDER_IN_PROCESSPesanan valid dan siap untuk diproses.Zonos
IGLOBAL_ORDER_ON_HOLDPesanan sedang dalam status hold sementara.Zonos
IGLOBAL_ORDER_CANCELLEDPesanan telah dibatalkan di Sistem iGlobal.Zonos
VENDOR_PREPARING_ORDERVendor telah menandai pesanan sedang disiapkan.Vendor
VENDOR_SHIPMENT_READYVendor telah menandai pesanan siap untuk dikirim.Vendor
VENDOR_LABELS_PRINTED_DATEVendor telah mencetak label pengiriman.Vendor
VENDOR_CANCELLATION_REQUESTPesanan telah diminta untuk pembatalan.Vendor
VENDOR_END_OF_DAY_COMPLETEPesanan telah diselesaikan dan selesai.Vendor

vendorOrderStatus tidak dapat diperbarui oleh vendor saat pesanan berada dalam salah satu status pesanan berikut:

IGLOBAL_LABELS_PROCESSINGIGLOBAL_ORDER_ON_HOLDIGLOBAL_FRAUD_REVIEWIGLOBAL_ORDER_CANCELLEDVENDOR_CANCELLATION_REQUESTVENDOR_END_OF_DAY_COMPLETE

Permintaan HTTPS

POST | https://api.iglobalstores.com/v1/updateVendorOrderStatus

FieldNilai
Metode HTTPPOST
URL Endpointhttps://api.iglobalstores.com/v1/updateVendorOrderStatus
ProtokolHTTPS
Format pesanJSON
Header HTTP AcceptAccept: application/json
Header HTTP Content-TypeContent-Type: application/json

Pasangan kunci/nilai JSON dalam badan permintaan

Format pesan: JSON

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

Definisi JSON permintaan

FieldCatatan
orderId REQUIREDID pesanan Zonos dapat dilewatkan dengan atau tanpa ID toko dan tanda hubung Anda (Contoh: 123-45678 atau 45678). Setelah penyelesaian pesanan dan pembayaran, pelanggan akan dialihkan ke halaman penyelesaian pesanan / halaman terima kasih pesanan yang dihosting di domain Anda. URL akan berisi parameter querystring orderID yang akan berisi nilai ini.integer / string
orderStatus REQUIREDField ini digunakan untuk memperbarui sistem Zonos dengan status baru pesanan. Status pesanan yang dapat disetel melalui API ini adalah:- VENDOR_PREPARING_ORDER
  • VENDOR_SHIPMENT_READY
  • VENDOR_LABELS_PRINTED
  • VENDOR_END_OF_DAY_COMPLETE
  • VENDOR_CANCELLATION_REQUEST``string | | secret REQUIRED | Rahasia API GUID yang disediakan oleh Zonos.string | | store REQUIRED | ID Toko yang disediakan oleh Zonosinteger |

Respons HTTPS

Format pesan: JSON

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

Respons HTTP kesalahan

Kode Respons HTTPContoh Badan Respons/Deskripsi
406 - Not AcceptableHTML Entity. Header HTTP "Accept" tidak valid.
415 - Unsupported media typeHTML Entity. Header HTTP "Content-Type" tidak valid.
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"

Definisi JSON respons

PesanDefinisi
successParameter ini akan berisi ringkasan pembaruan.string
errorParameter ini hanya akan hadir dalam respons ketika kesalahan terjadi dan akan berisi deskripsi penyebabnya.string
Pesan demo

Apakah halaman ini bermanfaat?