GET https://{amper_ws}/external/v1/stocks/
Jeden wiersz na produkt, zsumowany ze wszystkich magazynów. Lista zawiera tylko produkty dostępne dla klienta.
[
{ "product_id": 1037, "availability": "medium", "quantity": 150 },
{ "product_id": 1038, "availability": "none", "quantity": 0 }
]
| Pole |
Opis |
product_id |
ID produktu w AMPER |
availability |
stan słownie: none (brak), low (poniżej 100), medium (100–999), high (1000 i więcej) – liczony zawsze, niezależnie od ustawień klienta |
quantity |
zależy od opcji klienta Zwracaj rzeczywistą wartość stanów w API i ofertach (tabela niżej) |
Opcję Zwracaj rzeczywistą wartość stanów w API i ofertach ustawia administrator w danych klienta w panelu AMPER:
| Opcja u klienta |
quantity |
| włączona |
ilość na stanie |
| wyłączona |
1 (jest na stanie) albo 0 (brak) |
| nieustawiona |
zawsze 0 – korzystaj wtedy z pola availability |
Stan w liście produktów
Lista produktów ma pole stock_availability_customer z dostępnością dla klienta – patrz Produkty i zdjęcia. Różni się od quantity z tej listy:
|
stocks → quantity |
products → stock_availability_customer |
| opcja włączona |
stan magazynowy |
stan magazynowy minus rezerwacje (zamówienia jeszcze nie wydane) |
| opcja wyłączona |
1 / 0 |
1 / 0 |
| opcja nieustawiona |
0 |
0 |
Do pokazania „ile można kupić” lepiej nadaje się stock_availability_customer. Lista stocks jest lżejsza – pobieraj ją, gdy odświeżasz same stany (np. co 15–60 minut).
Lista nie ma filtrów i odczytu pojedynczego produktu – pobieraj ją w całości, stronami.