Aktuelle Bestellstatuswerte
Nachfolgend finden Sie eine aktuelle Liste der Bestellstatuswerte, die eine Bestellung haben kann.
Achtung – Zonos kann jederzeit weitere Status hinzufügen; Ihr System sollte das Vorhandensein zusätzlicher Status berücksichtigen.
Die Status in der Produktion bleiben in der Produktion. Zonos wird bestehende Status niemals entfernen.
| Status↕ | Description↕ | Settable by↕ |
|---|---|---|
| IGLOBAL_FRAUD_REVIEW | Die Bestellung wird derzeit von iGlobal auf Betrug geprüft. | Zonos |
| IGLOBAL_ORDER_IN_PROCESS | Die Bestellung ist gültig und bereit zur Bearbeitung. | Zonos |
| IGLOBAL_ORDER_ON_HOLD | Die Bestellung befindet sich derzeit in einem temporären Haltestatus. | Zonos |
| IGLOBAL_ORDER_CANCELLED | Die Bestellung wurde im iGlobal-System storniert. | Zonos |
| VENDOR_PREPARING_ORDER | Der Händler hat die Bestellung als in Vorbereitung markiert. | Vendor |
| VENDOR_SHIPMENT_READY | Der Händler hat die Bestellung als versandbereit markiert. | Vendor |
| VENDOR_LABELS_PRINTED_DATE | Der Händler hat Versandetiketten gedruckt. | Vendor |
| VENDOR_CANCELLATION_REQUEST | Die Bestellung wurde zur Stornierung angefordert. | Vendor |
| VENDOR_END_OF_DAY_COMPLETE | Die Bestellung ist abgeschlossen und finalisiert. | Vendor |
vendorOrderStatuskann vom Händler nicht aktualisiert werden, solange die Bestellung einen der folgenden Bestellstatus hat:IGLOBAL_LABELS_PROCESSINGIGLOBAL_ORDER_ON_HOLDIGLOBAL_FRAUD_REVIEWIGLOBAL_ORDER_CANCELLEDVENDOR_CANCELLATION_REQUESTVENDOR_END_OF_DAY_COMPLETE
HTTPS-Anfrage
POST | https://api.iglobalstores.com/v1/updateVendorOrderStatus
| Field↕ | Value↕ |
|---|---|
| HTTP method | POST |
| Endpoint URL | https://api.iglobalstores.com/v1/updateVendorOrderStatus |
| Protocol | HTTPS |
| Message format | JSON |
| Accept HTTP header | Accept: application/json |
| Content-Type HTTP header | Content-Type: application/json |
JSON-Schlüssel/Wert-Paare im Anfrage-Body
Message format: JSON
1
{2
"store": "999",3
"secret": "f5bde245-f55e-414d-b722-80b25161c12c",4
"orderId": "999-9999",5
"orderStatus": "VENDOR_END_OF_DAY_COMPLETE"6
}Definitionen der Anfrage-JSON
| Field↕ | Notes↕ |
|---|---|
orderId REQUIRED | Die Zonos-Bestell-ID kann mit oder ohne Ihre Shop-ID und den Bindestrich übergeben werden (Beispiel: 123-45678 oder 45678).Nach Abschluss der Bestellung und Zahlung wird der Kunde auf eine Bestellabschluss-/Dankeseite auf Ihrer Domain weitergeleitet. Die URL enthält einen Query-String-Parameter orderID, der diesen Wert enthält.integer / string |
orderStatus REQUIRED | Dieses Feld wird verwendet, um das Zonos-System mit dem neuen Status einer Bestellung zu aktualisieren.Die folgenden Bestellstatus können über diese API gesetzt werden.- VENDOR_PREPARING_ORDER |
VENDOR_SHIPMENT_READYVENDOR_LABELS_PRINTEDVENDOR_END_OF_DAY_COMPLETEVENDOR_CANCELLATION_REQUEST``string| |secretREQUIRED | Von Zonos bereitgestellte API-Secret-GUID.string| |storeREQUIRED | Von Zonos bereitgestellte Shop-IDinteger|
HTTPS-Antwort
Message format: JSON
1
{2
"success": "Updated Order: 99999 to new order status: VENDOR_PREPARING_ORDER"3
}Fehlerhafte HTTP-Antworten
| HTTP Response Codes↕ | Response Body Example/Description↕ |
|---|---|
| 406 - Not Acceptable | HTML-Entität. HTTP-„Accept“-Header ist ungültig. |
| 415 - Unsupported media type | HTML-Entität. HTTP-„Content-Type“-Header ist ungültig. |
| 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“ |
Definitionen der Antwort-JSON
| Message↕ | Definition↕ |
|---|---|
success | Dieser Parameter enthält eine Zusammenfassung der Aktualisierung.string |
error | Dieser Parameter ist nur in der Antwort vorhanden, wenn ein Fehler aufgetreten ist, und enthält eine Beschreibung der Ursache.string |
Bestellstatus aktualisieren
Erfahren Sie, wie der Endpunkt zur Aktualisierung des Bestellstatus funktioniert.
Der
updateVendorOrderStatus-Endpunkt wird verwendet, um den Bestellstatus einer Bestellung im Zonos-System zu aktualisieren. Er dient dazu, den Versandstatus der Bestellung programmatisch zu aktualisieren oder eine Stornierung anzufordern.