Pobierz zamówienie

Punkt końcowy API "Pobierz zamówienie" służy do pobierania danych dla ukończonego zamówienia w systemie Zonos. Odpowiedź będzie zawierać obiekt JSON reprezentujący wszystkie dostępne informacje dla zamówienia, w tym adresy rozliczeniowe i wysyłkowe, metodę wysyłki, sumy zamówienia i status.

Punkty końcowe 

Numery zamówień

Pobiera listę numerów zamówień.

Szczegóły zamówienia

Pobiera szczegółowe informacje o zamówieniu.

Użycie punktu końcowego API Pobierz zamówienie

Istnieją dwa powszechne sposoby korzystania z tych punktów końcowych.

1. (Część 1 + Część 2) – Użyj niestandardowej strony potwierdzenia zamówienia/sukcesu w swojej domenie, aby wyzwolić system do wywołania punktu końcowego orderDetail i zaimportowania ukończonego zamówienia. Dodatkowo regularnie wywołuj punkt końcowy orderNumbers w celu uzgodnienia wszystkich zamówień w systemie Zonos, które nie zostały zaimportowane do systemu.
2. (Tylko część 2) – Użyj podstawowej strony potwierdzenia zamówienia/sukcesu Zonos lub statycznej strony w swojej domenie, aby wskazać klientowi zakończenie zamówienia. Zaplanuj, aby system regularnie wywoływał punkt końcowy orderNumbers, aby określić, kiedy nowe zamówienie jest gotowe do zaimportowania do systemu. Po znalezieniu zaległego zamówienia, wywołaj punkt końcowy orderDetail, aby otrzymać dane dotyczące tych zamówień.

Część 1: Strona sukcesu w Twojej domenie

Za każdym razem, gdy nabywca ukończy zamówienie w Zonos Checkout, jest natychmiast przekierowany na adres URL strony sukcesu zamówienia. ID ukończonego zamówienia zostanie dołączone do adresu URL przekierowania jako parametr zapytania. Adres URL strony sukcesu zamówienia powinien być dostarczony do Zonos. Adres URL można również przekazać jako parametr w punkcie końcowym createTempCart podczas tworzenia tymczasowego koszyka w systemie Zonos.

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

Gdy klient zostanie przekierowany na tę stronę, system musi przeanalizować wartość orderId z adresu URL. Następnie użyj orderId, aby wywołać punkt końcowy orderDetail i pobrać dane zamówienia.

Część 2: Użyj zaplanowanego zadania

Oprócz wywoływania szczegółów zamówienia, gdy zostaje wyzwolona strona sukcesu, zalecamy skonfigurowanie zaplanowanego wywołania dla wszystkich zamówień i ich szczegółów jako zbiorczego mechanizmu bezpieczeństwa. W ten sposób można pobrać wszystkie ukończone zamówienia w systemie Zonos, które nie zostały jeszcze zaimportowane do systemu.

Proces powinien być zaplanowanym zadaniem/skryptem, takim jak zadanie Cron, uruchamianym raz na godzinę/zmianę/dzień/itp. (zaplanuj tak często, jak wymagają tego procesy biznesowe). Skrypt powinien wywoływać wszystkie zamówienia i ich szczegóły, które miały miejsce od ostatniego wywołania zamówień. Punkt końcowy orderNumbers pozwala pobrać zamówienia sinceOrderId lub sinceDate, jak pokazano w graficznym interfejsie testowania API znajdującym się tutaj. Wszystkie zamówienia pobrane przez to zaplanowane wywołanie powinny być następnie uzgodnione z zamówieniami wstawionymi do systemu za każdym razem, gdy zostaje wyzwolona strona sukcesu. Wszelkie zamówienia, które nie znajdują się jeszcze w systemie, powinny być wstawione do systemu i traktowane jako uzasadnione zamówienia.

Początkowy status zamówienia

IGLOBAL_ORDER_IN_PROCESS lub IGLOBAL_FRAUD_REVIEW

Gdy wywoływany jest punkt końcowy orderDetail, zalecamy, aby system najpierw sprawdził właściwość orderStatus danych zamówienia.

Zamówienia, które nie wymagają przeglądu oszustw, będą inicjowane ze statusem 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 ze statusem orderStatus : IGLOBAL_FRAUD_REVIEW. Zamówienie w tym statusie jest obecnie poddawane skanowaniu i przeglądzane pod kątem podejrzewanych oszustw. Zalecamy umieszczenie tego zamówienia w statusie przeglądu lub wstrzymania w systemie oraz kontynuowanie wywoływania punktu końcowego orderDetail do momentu, aż zamówienie przejdzie proces przeglądu oszustw Zonos.

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

• Zamówienie przechodzi skanowanie w poszukiwaniu oszustw

  • Zamówienie przejdzie do statusu orderStatus : IGLOBAL_ORDER_IN_PROCESS i może kontynuować wysyłkę.

• Zamówienie nie przechodzi skanowania w poszukiwaniu oszustw

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

Graficzny interfejs testowania API

Prosimy skontaktować się z obsługą klienta w celu uzyskania poświadczeń konta.