allegro / allegro/allegro-api

[NEWS] One Fulfillment - dodaliśmy nowe pola oraz opcje filtrowania i sortowania dla stanów magazynowych / One Fulfillment - we have added new fields, filters, and sort options in available stock

Ouverte
#5,839 0 commentaires 0 réactions 1 personne assignée Réclamée par @PrzemyslawLukanowski Voir sur GitHub
News
Langage dominant
Aucune donnée de langage
Étoiles
244
Forks
40
Métriques de merge des PR
Aucune PR mergée en 30 j

Description

W odpowiedzi dla zasobu [/fulfillment/stock](https://developer.allegro.pl/documentation#tag/Fulfillment-Stock), dzięki któremu pobierzesz aktualne stany magazynowe w ramach usługi One Fulfillment, dodaliśmy dziś:

- nowe pola:
- **sellingStats.lastWeekAverage** - dzienna średnia sprzedaży danego produktu obliczona dla ostatniego tygodnia;
- **sellingStats.lastThirtyDaysSum** - całkowita sprzedaż danego produktu z ostatnich 30 dni kalendarzowych.

Wartości w obu polach nie obejmują sprzedaży na bieżący dzień i mogą się zmieniać między kolejnymi żądaniami, np. z powodu anulowania zamówień w okresie rozliczeniowym;
- **reserve.outOfStockIn** - przewidywana liczba dni, po których zapasy danego produktu zostaną wyprzedane. Zwrócimy null, jeśli w polu - reserve.status otrzymasz wartość “NOT_ENOUGH_DATA”;
- **reserve.status** - aktualny status zapasów danego produktu. Zwrócimy jedną z wartości: “NOT_ENOUGH_DATA” (brak dostatecznych danych, według których możemy obliczyć predykcję), “LOW_STOCK” (zapasy wyczerpią się w ciągu 14 dni lub mniej), “NORMAL” (zapasy nie powinny wyczerpać się wcześniej niż w minimum 14 dni), “EXCESS_ONE_YEAR” (zapasy wystarczą na co najmniej rok);
- nowe opcje filtrowania według:
- **productId** - identyfikatora produktu;
- **productAvailability** - dostępności produktów. Możesz przekazać jedną lub więcej wartości: “SUFFICIENT” (wystarczająca liczba zapasów), “LOW” (niska liczba zapasów), “UNAVAILABLE” (produkt niedostępny);
productStatus - statusu produktów. Aktualnie wspieramy tylko wartość “UNFULFILLABLE” (produkt niezdatny do sprzedaży);
- nowe opcje sortowania:
- **lastWeekSalesAverage** - rosnąco według sprzedaży produktów w ciągu ostatniego tygodnia;
- **-lastWeekSalesAverage** - malejąco według sprzedaży produktów w ciągu ostatniego tygodnia;
- **lastThirtyDaysSalesSum** - rosnąco według sprzedaży produktów w ciągu ostatnich 30 dni;
- **-lastThirtyDaysSalesSum** - malejąco według sprzedaży produktów w ciągu ostatnich 30 dni;
- **reserve** - rosnąco według przewidywanej liczby dni, po których zapasy produktów zostaną wyprzedane;
- **-reserve** - malejąco według przewidywanej liczby dni, po których zapasy produktów zostaną wyprzedane;

Więcej o usłudze One Fulfillment przeczytasz na [stronie dla sprzedających,](https://allegro.pl/dla-sprzedajacych/one-fulfillment-by-allegro-WvGM90d4zhb) a informacje jak zarządzać tym procesem za pomocą API, opisaliśmy w [naszym poradniku](https://developer.allegro.pl/tutorials/one-fulfillment-by-allegro-0ADwgOLqWSw).

-----

Today we have added new features in the response to [/fulfillment/stock](https://developer.allegro.pl/documentation#tag/Fulfillment-Stock) resource, owing to which you can download information about current stock in the One Fulfillment service:

- new fields:
- **sellingStats.lastWeekAverage** - daily sales average of a given product calculated for the last week;
- **sellingStats.lastThirtyDaysSum** - total sales of a given product for the last 30 calendar days;

Values in both fields do not include sales for the current day and can change between subsequent requests due to e.g. cancellations of orders within the calculation period.
- **reserve.outOfStockIn** - prediction of number of days in which inventory will be sold out. We will return a null value if in the reserve.status you receive “NOT_ENOUGH_DATA”;
- **reserve.status** - current reserve status of a given product. We will return one of the following values: “NOT_ENOUGH_DATA” (not enough data to calculate sufficiency), “LOW_STOCK” (inventory quantity will run out soon - in 14 days or less), NORMAL (inventory quantity should not run out sooner than minimum 14 days), “EXCESS_ONE_YEAR” (amount of inventory will not be exhausted in (approximately) one year threshold)
- new filter options by:
- **productId**;
- **productAvailability** - you can pass one or more values: “SUFFICIENT”, “LOW”, “UNAVAILABLE”;
- **productStatus** - currently we support only “UNFULFILLABLE” value;
- new sort options:
- **lastWeekSalesAverage** - sorting by product last week average sales (ascending);
- **-lastWeekSalesAverage** - sorting by product last week average sales (descending);
- **lastThirtyDaysSalesSum** - sorting by product last month sum sales (ascending);
- **-lastThirtyDaysSalesSum** - sorting by product last month sum sales (descending);
- **reserve** - sorting by the number of days by which product reserve will be out of stock (ascending);
- **-reserve** - sorting by the number of days by which product reserve will be out of stock (descending).

You can read more about the One Fulfillment service [on the for seller's page](https://allegro.pl/dla-sprzedajacych/one-fulfillment-by-allegro-WvGM90d4zhb), and information on how to manage this process using the API is described in [our guide](https://developer.allegro.pl/tutorials/one-fulfillment-by-allegro-0ADwgOLqWSw).

Guide de contribution

Aucun guide de contribution indexé pour ce dépôt

Évaluation

Cette issue n'a pas encore été évaluée.

Recevez les nouvelles issues par e-mail

Un résumé court des issues GitHub adaptées aux débutants.