REST API xSale umożliwia wymianę danych o towarach przez zasób Article. Dzięki temu możliwe jest zaprojektowanie synchronizacji stanów magazynowych i innych danych o asortymencie dostępnych w sprzedaży z dedykowanymi systemami ERP lub eCommerce
Pobranie informacji o stanie towaru np. aby przekazać do dedykowanej platformy eCommerce lub dedykowanego sklepu internetowego.
Aby pobrać stany magazynowe towaru, należy przesłać zapytanie na endpoint:
GET /{organizationName}/articles/stocks
W zapytaniu wymagane jest przekazanie organizationName. Zwracane wyniki można zawęzić do towarów o wskazanych ID (articleidin) oraz zaktualizowanych / zsynchronizowanych przed lub po konkretnej dacie. Dane w odpowiedzi mogą być posortowane według ID (rosnąco lub malejąco).
Można również zdefiniować limit elementów w odpowiedzi zwracanej przez xSale (nie większy niż 1000 rekordów dla pojedynczego zapytania).
Zaktualizowanie stan towarów w xSale gdy korzystasz np. z integracji z dedykowanym ERP, WMS lub aby zaktualizować dostępną ilość towaru na podstawie dostępności towaru w hurtowni lub u dostawcy.
Aktualizacja stanów magazynowych jest możliwa poprzez endpoint:
PUT /{organizationName}/articles/{id}/stocks-levels
W zapytaniu należy przesłać ID towaru oraz szczegóły dotyczące dostępnej ilości (pole „Quantity„) wraz z ID magazynu, na którym wykonywana jest aktualizacja stanu magazynowego („WarehouseId„).
Aktualizacja stanu a synchronizacja oferty z kanałami sprzedaży
xSale posiada automatyczne procesy aktualizacji stanu magazynowego w ofertach wystawionych na zintegrowane kanały sprzedaży (np. Allegro, Shoper, AtomStore itp.). Synchronizacja danych jest inicjowana wówczas, gdy zmieni się wartość stanu magazynowego.
Jeśli korzystasz z wirtualnych stanów, możesz chcieć limitować stan magazynowy dostępny w ofertach. Aktualizując stan przez REST API pamiętaj, że przesyłanie ciągle tej samej wartości stanu magazynowego spowoduje problemy z dostępnością oferty w kanałach sprzedaży – stan magazynowy oferty nie będzie poprawnie aktualizowany, a po wyczerpaniu dostępności w kanale sprzedaży oferta może zostać zakończona.
