Projektując mechanizm pobierania zamówień z xSale do własnego systemu ERP warto opierać się na statusach zamówień. Dzięki dostępnym filtrom REST API xSale daje możliwość precyzyjnego wskazania, które zamówienia mają trafić do ERP. Zmiana statusu zamówienia po jego imporcie pozwala wygodnie zarządzać procesem realizacji zamówienia i uniknąć ewentualnych pomyłek.
Listę wszystkich zamówień zwraca endpoint:
GET /{organizationName}/orders
W przesyłanym zapytaniu można wykorzystać filtry statusidin oraz statusnamein. W obu przypadkach należy wskazać tablicę, zawierającą odpowiednio id statusów (integer) dla statusidin oraz nazw statusów (string) dla statusnamein.
Lista wszystkich statusów dostępna jest w zasobie:
GET /{organizationName}/statuses
Po pobraniu zamówienia do systemu ERP rekomendujemy aktualizację jego statusu. Ta operacja pozwala wykluczyć ponowny import zamówienia w oparciu o wskazane w filtrach statusy.
Przykład:
1. Pobieramy zamówienia ze statusem „Nowe”.
2. Po poprawnym wczytaniu zamówienia do ERP zmieniamy status zamówienia w xSale. Domyślny status, jaki xSale nadaje zamówieniom poprawnie przesłanym do systemu ERP, to „Zaimportowano do ERP„.
3. Jeśli podczas wczytywania zamówienia do systemu ERP wystąpił błąd, rekomendujemy ustawienie na takim zamówieniu statusu „Do obsługi ręcznej„.
Aktualizacja statusu odbywa się z wykorzystaniem endpointu:
PUT /{organizationName}/orders/{id}/change-status
Do przesłania zapytania potrzebne jest ID zamówienia oraz ID statusu, który ma zostać nadany po wysłaniu żądania.
