[NEWS] Kampanie - wprowadzimy dedykowaną liczbę sztuk dla wybranych kampanii BlackWeek i AllegroDays / Campaigns - we will introduce a dedicated stock for selected BlackWeek and AllegroDays campaigns

Kampanie to akcje promocyjne, które popularyzują oferty sprzedawcy, co przekłada się bezpośrednio na wzrost sprzedaży oraz większe zyski.

Dla **wybranych kampanii** typu BlackWeek oraz AllegroDays wprowadzamy **konieczność zadeklarowania przez sprzedającego liczby sztuk**, która dostępna będzie w sprzedaży w ramach takiej kampanii.

Oznacza to, że liczba sztuk zdefiniowana przez sprzedającego w ramach kampanii, na 3 dni przed jej rozpoczęciem, zostanie odjęta od ogólnej liczby sztuk udostępnionej w ramach oferty.

Przykładowo, jeżeli w ofercie aktualna liczba sztuk produktu w sprzedaży wynosi 50, a sprzedający zgłosi chęć wzięcia udziału w kampanii oraz zadeklaruje, że chciałby w jej ramach wyprzedać 20 sztuk - na 3 dni przed rozpoczęciem kampanii zarezerwujemy 20 sztuk na rzecz sprzedaży w kampanii. Oznacza to, że w ofercie pozostanie 30 dostępnych sztuk.

W trakcie kampanii każdy zakup będzie skutkował pomniejszeniem liczby sztuk udostępnionej w ramach tej kampanii. Po wyprzedaniu zarezerwowanego zapasu, w ofercie ponownie pojawi się możliwość zakupu produktu poza kampanią, już ze stanu magazynowego oferty - pomniejszonego wcześniej o liczbę sztuk zarezerwowanych dla kampanii.

Jeżeli zapas zarezerowany na kampanię nie zostanie wyprzedany przed jej zakończeniem, pozostała liczba sztuk ponownie zostanie dodana do stanu magazynowego w ofercie.

Pierwsza taka kampania rozpoczyna się **8 września 2025**.

**Co oznacza to w praktyce z punktu widzenia obsługi oferty przez publiczne API Allegro?**

W ramach publicznego API widoczna będzie tylko liczba sztuk udostępniona w ofercie.

Dodatkowo, w ramach dziennika zdarzeń w ofercie ([GET /sale/offer-events](https://developer.allegro.pl/documentation#tag/User%27s-offer-information/operation/getOfferEvents)):
- odjęcie liczby sztuk zarezerwowanej w ramach kampanii poskutkuje wygenerowaniem nowego zdarzenia typu OFFER_STOCK_CHANGED
- sam zakup produktu w ramach takiej kampanii nie wygeneruje zdarzenia OFFER_STOCK_CHANGED
- po zakończeniu kampanii, jeżeli zapas zarezerwowany na kampanię nie zostanie wyprzedany przed jej zakończeniem, pozostała liczba sztuk ponownie zostanie dodana do stanu magazynowago oraz wygenerujemy zdarzenie OFFER_STOCK_CHANGED.

Możliwość zgłoszenia oferty produktu do wspomnianych wybranych kampanii nie jest obecnie dostępna przez publiczne API Allegro - sprzedający może to zrobić jedynie w zakładce [Kampanie i programy](https://salescenter.allegro.com/campaigns) w Sales Center.

--------
Campaigns are promotional activities that popularize a seller's offers, which translates directly into increased sales and higher profits.

For **selected BlackWeek and AllegroDays campaigns**, we are introducing a **requirement for sellers to declare the number of units** that will be available for sale as part of such campaigns.

This means that the number of items defined by the seller as part of the campaign, 3 days before its start, will be subtracted from the total stock available in the offer.

For example, suppose the current number of items on sale is 50, and the seller expresses interest in participating in the campaign and declares that they would like to sell 20 items as part of it. In that case, we will reserve 20 items for sale in the campaign three days prior to its start. This means that 30 items will remain available in the offer.

During the campaign, each purchase will result in a reduction in the number of items available in campaign stock. Once the reserved stock has been sold out, the product will once again be available for purchase outside of the campaign, from the offer's stock, reduced by the number of items reserved for the campaign.

If the stock reserved for the campaign is not sold out before the end of the campaign, the remaining number of items will be added back to the stock in the offer.

The first such campaign begins on **September 8, 2025**.

**What does this mean in practice from the point of view of handling offers via Allegro's public API?**

Only the stock saved in the offer will be visible in the public API.

Additionally, in the event log in the offer ([GET /sale/offer-events](https://developer.allegro.pl/documentation#tag/User%27s-offer-information/operation/getOfferEvents)):
- subtracting the number of items reserved as part of the campaign will generate a new OFFER_STOCK_CHANGED event
- the purchase of a product in campaign will not generate an OFFER_STOCK_CHANGED event
- after the end of the campaign, if the stock reserved for the campaign is not sold out before its end, the remaining number of items will be added back to the offer stock, and we will generate an OFFER_STOCK_CHANGED event.

The option to submit a product offer for the mentioned selected campaigns is currently not available through Allegro's public API - sellers can only do so in the [Campaigns and Programs](https://salescenter.allegro.com/campaigns) tab in the Sales Center.