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

Abierto
#5,839 0 comentarios 0 reacciones 1 asignado Reclamado por @PrzemyslawLukanowski Ver en GitHub
News
Lenguaje dominante
Sin datos de lenguaje
Estrellas
244
Forks
40
Métricas de merge de PR
Sin PR fusionados en 30 d

Descripción

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).

Guía de contribución

No hay ninguna guía de contribución indexada para este repositorio

Evaluación

Este issue todavía no se ha evaluado.

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.