[NEWS] Na początku 2024 roku wyłączymy zasoby /sale/offers służące do tworzenia i edycji ofert / At the beginning of 2024, we will disable the /sale/offers resources for creating and editing offers

Planujemy całkowicie wyłączyć zasoby do tworzenia oraz edycji ofert ze ścieżek **/sale/offers** oraz **/sale/offers/{offerId}**, dlatego:
- **1 stycznia 2023 roku** oznaczymy je jako **Deprecated** i zakończymy ich dalsze wsparcie i rozwój,
- **1 stycznia 2024 roku** całkowicie je **usuniemy**.

W styczniu tego roku udostępniliśmy zasoby **/sale/product-offers** w wersji public, dzięki którym:
- [za pomocą jednego żądania wystawisz aktywną ofertę powiązaną z produktem](https://developer.allegro.pl/tutorials/jak-jednym-requestem-wystawic-oferte-powiazana-z-produktem-D7Kj9gw4xFA),
- [edytujesz dowolne pole oferty](https://developer.allegro.pl/tutorials/jak-jednym-requestem-wystawic-oferte-powiazana-z-produktem-D7Kj9gw4xFA#jak-edytowac-oferte),
- [utworzysz zestaw produktowy](https://developer.allegro.pl/tutorials/jak-jednym-requestem-wystawic-oferte-powiazana-z-produktem-D7Kj9gw4xFA#jak-utworzyc-zestaw-produktowy).

Zasoby **/sale/product-offers** będą jedynymi, które umożliwią wystawienie oraz edycję oferty. Zadbaj o to, żeby przed całkowitym wyłączeniem zasobów **/sale/offers** Twoje oprogramowanie korzystało z odpowiedników tych zasobów na ścieżce **/sale/product-offers**:

| **Endpoint, który usuniemy** | **Odpowiednik endpointu** |
| -------- | -------- |
| [POST /sale/offers](https://developer.allegro.pl/documentation#operation/createOfferUsingPOST) | [POST /sale/product-offers](https://developer.allegro.pl/documentation#operation/createProductOffers) |
| [PUT /sale/offers/{offerId}](https://developer.allegro.pl/documentation#operation/updateOfferUsingPUT) | [PATCH /sale/product-offers/{offerId}](https://developer.allegro.pl/documentation#operation/editProductOffers) |
| [GET /sale/offers/{offerId}](https://developer.allegro.pl/documentation#operation/getOfferUsingGET) | [GET /sale/product-offers/{offerId}](https://developer.allegro.pl/documentation#operation/getProductOffer) |

Cały czas pracujemy nad rozwijaniem zasobów **/sale/product-offers**. Weryfikujemy oraz uzupełniamy wszelkie różnice względem **/sale/offers**, bądź wprowadzamy nowe zasoby, które zapewnią ciągłość dostępu do funkcjonalności.

Przykładem drugiego z tych działań są opcje promowania ofert, które były dostępne w zasobach **/sale/offers**, ale nie pojawiają się w **/sale/product-offers**. Zostały one zastąpione [**dedykowanymi zasobami**](https://developer.allegro.pl/tutorials/jak-zarzadzac-ofertami-7GzB2L37ase#jak-zarzadzac-promowaniem), które dają użytkownikowi dużo większy zakres funkcjonalny do zarządzania opcjami promowania.

**Dlaczego decydujemy się na wyłączenie zasobów?**

Od początku 2019 roku grupujemy oferty z tym samym produktem, dzięki czemu kupujący łatwiej znajdzie oferty, które spełniają jego oczekiwania. Zwiększamy stopniowo wymagany udział ofert, które są połączone z Katalogiem produktów w wybranych kategoriach, a docelowo wprowadzimy ten wymóg dla wszystkich ofert.

Zasoby **/sale/product-offers** stworzyliśmy z myślą o tym stanie docelowym - wprowadziliśmy w nich istotne usprawnienia przy wystawianiu i edycji ofert powiązanych z produktem. Dlatego zdecydowaliśmy, że będziemy utrzymywać i rozwijać jeden spójny interfejs do zarządzania ofertami z produktem.

Więcej informacji o zasobach **/sale/product-offers** znajdziesz w [naszym poradniku](https://developer.allegro.pl/tutorials/jak-jednym-requestem-wystawic-oferte-powiazana-z-produktem-D7Kj9gw4xFA).

--------

We plan to completely disable resources for creating and editing offers from the **/sale/offers** and **/sale/offers/{offerId}** paths, therefore:
- on **January 1, 2023**, we will mark them as **Deprecated** and end their further support and development,
- on **January 1, 2024** we will **remove** them completely.

In January this year, we have released the **/sale/product-offers** resources in the public version, which allows you to:
- [list an offer assigned to a product with one request](https://developer.allegro.pl/product_offers/),
- [edit any field of the offer](https://developer.allegro.pl/tutorials/list-offer-assigned-product-one-request-D7Kj9M71Bu6#how-to-edit-an-offer),
- [create a product set](https://developer.allegro.pl/tutorials/list-offer-assigned-product-one-request-D7Kj9M71Bu6#how-to-create-a-product-set).

The **/sale/product-offers** resource will be the only one to allow listing and editing offers. Ensure that your software uses the equivalent of these resources on the **/sale/product-offers** path before we completely disable the **/sale/offers** resource:

| **Endpoint that we will remove** | **Equivalent to endpoint** |
| -------- | -------- |
| [POST /sale/offers](https://developer.allegro.pl/documentation#operation/createOfferUsingPOST) | [POST /sale/product-offers](https://developer.allegro.pl/documentation#operation/createProductOffers) |
| [PUT /sale/offers/{offerId}](https://developer.allegro.pl/documentation#operation/updateOfferUsingPUT) | [PATCH /sale/product-offers/{offerId}](https://developer.allegro.pl/documentation#operation/editProductOffers) |
| [GET /sale/offers/{offerId}](https://developer.allegro.pl/documentation#operation/getOfferUsingGET) | [GET /sale/product-offers/{offerId}](https://developer.allegro.pl/documentation#operation/getProductOffer) |

We are constantly working on developing **/sale/product-offers** resources. We verify and complete all differences in relation to **/sale/offers**, or introduce new resources that will ensure continuity of access to functionality.

An example of the second of these actions is the offer promotion options that were available in the **/sale/offers** resource, but do not appear in **/sale/product-offers**. These have been replaced with [**dedicated resources**](https://developer.allegro.pl/tutorials/how-to-process-list-of-offers-m09BKA5v8H3#how-to-manage-promo-options) that give the user a much greater functional coverage to manage promotion options.

**Why do we choose to turn off resources?**

From the beginning of 2019, we group offers with the same product, making it easier for buyers to find offers that meet their needs. We are gradually increasing the required share of offers that are linked to the Product Catalog in selected categories, and ultimately we will introduce this requirement for all offers.

We created the **/sale/product-offers** resources with this target state in mind - we have introduced significant improvements in listing and editing offers assigned to the product. That is why we decided to maintain and develop one consistent interface for managing offers with the product.

For more information about **/sale/product-offers** resources, see [our guide](https://developer.allegro.pl/tutorials/list-offer-assigned-product-one-request-D7Kj9M71Bu6).