Bestellung abrufen

Der API-Endpunkt "Bestellung abrufen" wird verwendet, um Daten für eine abgeschlossene Bestellung im Zonos-System abzurufen. Die Antwort enthält ein JSON-Objekt, das alle verfügbaren Informationen zur Bestellung enthält, einschließlich Rechnungs- und Versandadressen, Versandmethode, Bestellsummen und Status.

Endpunkte 

Bestellnummern

Ruft eine Liste von Bestellnummern ab.

Bestelldetails

Ruft detaillierte Informationen zu einer Bestellung ab.

Verwendung des API-Endpunkts "Bestellung abrufen"

Es gibt zwei gängige Möglichkeiten, diese Endpunkte zu verwenden.

1. (Teil 1 + Teil 2) – Verwenden Sie eine benutzerdefinierte Bestellbestätigungs- / Erfolgsseite auf Ihrer Domain, um Ihr System zu veranlassen, den Endpunkt orderDetail aufzurufen und eine abgeschlossene Bestellung zu importieren. Rufen Sie außerdem regelmäßig den Endpunkt orderNumbers auf, um alle Bestellungen im Zonos-System abzugleichen, die nicht in Ihr System importiert wurden.
2. (Nur Teil 2) – Verwenden Sie die Zonos-Standardbestellbestätigungs- / Erfolgsseite oder eine statische Seite auf Ihrer Domain, um dem Kunden den Abschluss der Bestellung anzuzeigen. Planen Sie, dass Ihr System regelmäßig den Endpunkt orderNumbers aufruft, um festzustellen, wann eine neue Bestellung bereit ist, in Ihr System importiert zu werden. Wenn eine ausstehende Bestellung gefunden wird, rufen Sie den Endpunkt orderDetail für die Daten zu diesen Bestellungen auf.

Teil 1: Erfolgsseite auf Ihrer Domain

Jedes Mal, wenn ein Käufer eine Bestellung im Zonos Checkout abschließt, wird er sofort zu einer Erfolgsseite-URL weitergeleitet. Die abgeschlossene Bestell-ID wird als Abfragezeichenfolge an die Umleitungs-URL angehängt. Die URL der Erfolgsseite sollte an Zonos übermittelt werden. Die URL kann auch als Parameter im Endpunkt createTempCart übergeben werden, wenn der temporäre Warenkorb im Zonos-System erstellt wird.

Beispiel: http://www.beispielshop.com/internationalDanke?bestellId=999-99999

Wenn ein Kunde auf diese Seite umgeleitet wird, muss Ihr System den Wert für bestellId aus der URL analysieren. Anschließend verwenden Sie die bestellId, um den Endpunkt orderDetail aufzurufen und die Bestelldaten abzurufen.

Teil 2: Verwendung eines geplanten Jobs

Zusätzlich zum Abrufen von Bestelldetails, wenn die Erfolgsseite ausgelöst wird, empfehlen wir, einen geplanten Aufruf für alle Bestellungen und deren Details als Auffangnetz einzurichten. Auf diese Weise können Sie alle abgeschlossenen Bestellungen im Zonos-System abrufen, die noch nicht in Ihr System importiert wurden.

Dieser Prozess sollte ein geplanter Job/Skript sein, wie z. B. ein Cron-Job, der einmal pro Stunde/Schicht/Tag usw. ausgeführt wird (so oft wie Ihre Geschäftsprozesse es für notwendig erachten). Das Skript sollte alle Bestellungen und deren Details abrufen, die seit dem letzten Abruf für Bestellungen aufgetreten sind. Der Endpunkt orderNumbers ermöglicht es Ihnen, Bestellungen seitBestellId oder seitDatum abzurufen, wie im API-Test-GUI hier demonstriert. Alle über diesen geplanten Aufruf abgerufenen Bestellungen sollten dann mit den Bestellungen abgeglichen werden, die jedes Mal in Ihr System eingefügt wurden, wenn die Erfolgsseite ausgelöst wurde. Alle Bestellungen, die noch nicht in Ihrem System vorhanden sind, sollten in Ihr System eingefügt und als legitime Bestellungen behandelt werden.

Anfänglicher Bestellstatus

IGLOBAL_ORDER_IN_PROCESS oder IGLOBAL_FRAUD_REVIEW

Beim Aufrufen des Endpunkts orderDetail empfehlen wir, dass Ihr System zuerst die Eigenschaft bestellStatus der Bestelldaten überprüft.

Bestellungen, die keine Betrugsprüfung erfordern, werden mit bestellStatus : IGLOBAL_ORDER_IN_PROCESS initialisiert. Eine Bestellung mit diesem Status ist bereit zur Bearbeitung und Versendung.

Bestellungen, die eine Betrugsprüfung erfordern, werden mit bestellStatus : IGLOBAL_FRAUD_REVIEW initialisiert. Eine Bestellung mit diesem Status wird derzeit auf verdächtigen Betrug überprüft. Wir empfehlen, dass Sie diese Bestellung in Ihrem System auf einen Prüf- oder Haltestatus setzen und weiterhin den Endpunkt orderDetail aufrufen, bis die Bestellung den Betrugsprüfungsprozess von Zonos durchläuft.

Sobald der Betrugsscreening-Prozess von Zonos abgeschlossen ist, wird die Bestellung einen der folgenden Zustände durchlaufen:

• Bestellung besteht die Betrugsprüfung

  • Die Bestellung wird zu bestellStatus : IGLOBAL_ORDER_IN_PROCESS übergehen und kann weiter zur Versendung fortgesetzt werden.

• Bestellung besteht die Betrugsprüfung nicht

  • Die Bestellung wird zu bestellStatus : IGLOBAL_ORDER_CANCELLED übergehen und sollte in Ihrem System storniert werden.

API-Test-GUI

Bitte kontaktieren Sie den Support für Ihre Kontozugangsdaten.