Question 1

Wozu dient der Endpunkt „updateMerchantOrderId“?

Accepted Answer

Dieser API-Endpunkt wird verwendet, um eine Bestellung im Zonos-System mit der Bestell-ID Ihres Shops zu aktualisieren – für bessere Abstimmung, Kommunikation und Prüfung.

Question 2

Welche Parameter sind für die Anfrage „updateMerchantOrderId“ erforderlich?

Accepted Answer

Die erforderlichen Parameter sind „merchantOrderId“, „orderId“, „secret“ und „store“.

Question 3

Wie sieht die Erfolgsantwort von „updateMerchantOrderId“ aus?

Accepted Answer

Die Erfolgsantwort enthält eine Meldung zur Bestellaktualisierung, zum Beispiel: „Updated Order: 99999 with new merchantOrderId: 12-34567“.

Question 4

Wie sieht die Fehlerantwort von „updateMerchantOrderId“ aus?

Accepted Answer

Die Fehlerantwort enthält einen „error“-Parameter mit einer Beschreibung der Ursache, zum Beispiel: „Could not retrieve order to updateMerchantOrderId for orderId: 99999“.

Question 5

Welche möglichen Fehler-HTTP-Antworten gibt es für die Anfrage „updateMerchantOrderId“?

Accepted Answer

Mögliche Fehler-HTTP-Antworten sind 406 - Not Acceptable, 415 - Unsupported media type und verschiedene 200-Antworten mit unterschiedlichen Fehlermeldungen.

Feld↕	Hinweise↕
HTTP-Methode	POST
Endpunkt-URL	`https://api.iglobalstores.com/v1/updateMerchantOrderId`
Protokoll	HTTPS
Nachrichtenformat	JSON
Accept-HTTP-Header	Accept: application/json
Content-Type-HTTP-Header	Content-Type: application/json

Feld↕	Hinweise↕
`merchantOrderId` REQUIRED	Dieser Parameter wird verwendet, um die interne Bestell-ID Ihres Shops an die Bestellung im Zonos-System zu übergeben. Dies wird für eine bessere Abstimmung, Kommunikation und Prüfung empfohlen.`string`
`orderId` REQUIRED	Die Zonos-Bestell-ID – kann mit oder ohne Ihre Shop-ID und den Bindestrich übergeben werden (Beispiel: 123-45678 oder 45678).Hinweis: 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`
`secret` REQUIRED	Von Zonos bereitgestellte API-Secret-GUID.`string`
`store` REQUIRED	Von Zonos bereitgestellte Shop-ID`integer`

Fehlercode↕	Bedeutung↕
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 is required to processUpdateMerchantOrderId“
200	„error“:„Parameter merchantOrderId is required to updateMerchantOrderId.“
200	„error“:„orderId: 999-99999 is not a valid orderId“
200	„error“:„Could not retrieve order to updateMerchantOrderId for orderId: 999-99999“
200	„error“:„Could not process update merchant order id.“
200	„error“:„Invalid security credentials“

Feld↕	Hinweise↕
`error`	Dieser Parameter ist nur in der Antwort vorhanden, wenn ein Fehler aufgetreten ist, und enthält eine Beschreibung der Ursache.`string`
`success`	Dieser Parameter enthält eine Zusammenfassung der Aktualisierung.`string`

Bestellnummer aktualisieren

Endpunkt

HTTPS-Anfrage

JSON-Schlüssel/Wert-Paare im Anfrage-Body

Definitionen der Anfrage-JSON

HTTPS-Antwort

Fehlerhafte HTTP-Antworten

Definitionen der Antwort-JSON

War diese Seite hilfreich?