Pobierz zamówienie

Ten endpoint API "Pobierz zamówienie" jest używany do pobierania danych dla zrealizowanego zamówienia w systemie Zonos. Odpowiedź będzie zawierać obiekt JSON, reprezentujący wszystkie dostępne informacje o zamówieniu, w tym adresy rozliczeniowe i wysyłkowe, metodę wysyłki, całkowite koszty zamówienia oraz status.

Endpoints 

Numery zamówień

Pobiera listę numerów zamówień.

Szczegóły zamówienia

Pobiera szczegółowe informacje o zamówieniu.

Użycie endpointu API "Pobierz zamówienie"

Istnieją dwa powszechne sposoby korzystania z tych endpointów.

1. (Część 1 + Część 2) – Użyj niestandardowej strony potwierdzenia zamówienia / strony sukcesu na swojej domenie, aby wywołać swój system do wywołania endpointu orderDetail i zaimportować zrealizowane zamówienie. Dodatkowo, regularnie wywołuj endpoint orderNumbers, aby uzgodnić wszelkie zamówienia w systemie Zonos, które nie zostały zaimportowane do twojego systemu.
2. (Część 2 Tylko) – Użyj podstawowej strony potwierdzenia zamówienia / strony sukcesu Zonos lub statycznej strony na swojej domenie, aby wskazać klientowi zakończenie zamówienia. Zaplanuj swój system, aby regularnie wywoływał endpoint orderNumbers, aby określić, kiedy nowe zamówienie jest gotowe do zaimportowania do twojego systemu. Gdy znajdziesz zaległe zamówienie, wywołaj endpoint orderDetail, aby uzyskać dane o tych zamówieniach.

Część 1: Strona sukcesu na twojej domenie

Za każdym razem, gdy kupujący kończy zamówienie w Zonos Checkout, są natychmiast przekierowywani na stronę sukcesu zamówienia. Zrealizowane ID zamówienia zostanie dołączone do adresu URL przekierowania jako ciąg zapytania. Adres URL strony sukcesu zamówienia powinien być dostarczony do Zonos. Adres URL można również przekazać jako parametr w endpointcie createTempCart, gdy tworzysz tymczasowy koszyk w systemie Zonos.

Przykład: http://www.examplestore.com/internationalThankYou?orderId=999-99999

Gdy klient zostanie przekierowany na tę stronę, twój system będzie musiał sparsować wartość orderId z adresu URL. Następnie użyjesz orderId, aby wywołać endpoint orderDetail, aby pobrać dane zamówienia.

Część 2: Użyj zaplanowanej pracy

Oprócz wywoływania szczegółów zamówienia, gdy strona sukcesu jest wywoływana, zalecamy skonfigurowanie zaplanowanego wywołania dla wszystkich zamówień i ich szczegółów jako zabezpieczenia. W ten sposób możesz pobrać wszelkie zrealizowane zamówienia w systemie Zonos, które nie zostały jeszcze zaimportowane do twojego systemu.

Ten proces powinien być zaplanowaną pracą/skryptem, takim jak zadanie Cron, uruchamianym raz na godzinę/zmianę/dzień itp. (zaplanowane tak często, jak uznają to za konieczne twoje procesy biznesowe). Skrypt powinien wywoływać wszystkie zamówienia i ich szczegóły, które miały miejsce od ostatniego wywołania zamówień. Endpoint orderNumbers pozwala na pobranie zamówień sinceOrderId lub sinceDate, jak pokazano w GUI testowym API znajdującym się tutaj. Wszystkie zamówienia pobrane przez to zaplanowane wywołanie powinny być następnie uzgadniane z zamówieniami wprowadzonymi do twojego systemu za każdym razem, gdy strona sukcesu była wywoływana. Wszelkie zamówienia, które nie są już w twoim systemie, powinny być wprowadzone do twojego systemu i traktowane jako legalne zamówienia.

Początkowy status zamówienia

IGLOBAL_ORDER_IN_PROCESS lub IGLOBAL_FRAUD_REVIEW

Podczas wywoływania endpointu orderDetail, zalecamy, aby twój system najpierw sprawdził właściwość orderStatus danych zamówienia.

Zamówienia, które nie wymagają przeglądu oszustw, będą inicjowane z orderStatus : IGLOBAL_ORDER_IN_PROCESS. Zamówienie w tym statusie jest gotowe do przetworzenia i wysyłki.

Zamówienia, które wymagają przeglądu oszustw, będą inicjowane w orderStatus : IGLOBAL_FRAUD_REVIEW. Zamówienie w tym statusie jest obecnie poddawane screeningowi i przeglądowi w celu wykrycia podejrzanego oszustwa. Zalecamy umieścić to zamówienie w statusie przeglądu lub wstrzymania w twoim systemie i kontynuować wywoływanie endpointu orderDetail, aż zamówienie przejdzie przez proces przeglądu oszustw Zonos.

Po zakończeniu procesu skanowania oszustw Zonos, zamówienie przejdzie do jednego z następujących stanów:

• Zamówienie przechodzi skanowanie oszustw

  • Zamówienie przejdzie do orderStatus : IGLOBAL_ORDER_IN_PROCESS i może kontynuować w kierunku wysyłki.

• Zamówienie nie przechodzi skanowania oszustw

  • Zamówienie przejdzie do orderStatus : IGLOBAL_ORDER_CANCELLED i powinno zostać anulowane w twoim systemie.

GUI testowe API

Proszę skontaktować się z pomocą techniczną w celu uzyskania danych logowania do swojego konta.