[NEWS] 28 lutego wyłączymy wersje beta zasobów /sale/product-offers / On February 28th, 2022 we will disable the beta versions of /sale/product-offers resources

Zgodnie z naszą [wcześniejszą zapowiedzią](https://developer.allegro.pl/news/#product-offers-public) informujemy, że **28 lutego 2022 wyłączymy wersje beta zasobów /sale/product-offers**.

**Jak przeprowadzić migrację do wersji public?**

Zależy od tego, której wersji beta używasz. Jeśli korzystasz z:

- **beta.v3** - wystarczy, że zmienisz wartość w nagłówkach **Content-Type** oraz **Accept** z “application/vnd.allegro.beta.v3+json” na **“application/vnd.allegro.public.v1+json”**,
- **beta.v2** - wprowadź zmiany, które wprowadziliśmy w wersji beta.v3 - pole **“product”** zastąpiliśmy polem **“productSet”**, które jest tablicą obiektów. Zmień także wartość w nagłówkach **Content-Type** oraz **Accept** z “application/vnd.allegro.beta.v2+json” na **“application/vnd.allegro.public.v1+json”**.

**Jakie zmiany wprowadziliśmy w wersji public?**

1. Dodaliśmy obsługę nowych pól, które możesz zadeklarować w strukturze żądania [POST /sale/product-offers](https://developer.allegro.pl/documentation/#operation/createProductOffers) oraz [PATCH /sale/product-offers/{offerID}](https://developer.allegro.pl/documentation/#operation/editProductOffers):

- “attachments” - załączniki,
- “additionalServices” - usługi dodatkowe,
- “compatibilityList” - sekcja “pasuje do”.
- “b2b” - czy oferta dostępna jest do zakupu tylko dla kupujących z kontem firmowym,
- “delivery.shipmentDate” - wysyłka od, np. dla przedsprzedaży,
- “fundraisingCampaign” - identyfikator organizacji charytatywnej,
- “publication.republish” - czy oferta ma zostać automatycznie wznowiona.

2. Zaktualizowaliśmy response dla:
- [POST /sale/product-offers](https://developer.allegro.pl/documentation/#operation/createProductOffers),
- [PATCH /sale/product-offers/{offerId}](https://developer.allegro.pl/documentation/#operation/editProductOffers),
- [GET /sale/product-offers/{offerId}](https://developer.allegro.pl/documentation/#operation/getProductOffer)

Parametry produktowe, czyli te, które opisują produkt (w odpowiedzi dla [GET /sale/categories/{categoryId}/parameters](https://developer.allegro.pl/documentation/#operation/getCategoryUsingGET_1) są oznaczone flagą “options.describesProduct”: true), zwracamy teraz w sekcji **“productSet.product.parameters”**. Parametry ofertowe związane z indywidualną ofertą, np. stan, data ważności, etc. zwrócimy w polu **“parameters”.**

Wersja public uwzględnia również zmiany, które wprowadziliśmy w wersji **beta.v3**:

- dla [POST /sale/product-offers](https://developer.allegro.pl/documentation/#operation/createProductOffers) i [GET /sale/product-offers/{offerId}](https://developer.allegro.pl/documentation/#operation/getProductOffer) - pole **“product”** zastąpiliśmy polem **“productSet”**, które jest tablicą obiektów,
- dla [PATCH /sale/product-offers/{offerId}](https://developer.allegro.pl/documentation/#operation/editProductOffers) - jeśli oferta jest zakończona i zaktualizujesz dla niej liczbę przedmiotów na większą niż 0, nie aktywujemy oferty - w tej sytuacji pozostanie w statusie “ENDED”.

-----

According to our [previous announcement](https://developer.allegro.pl/en/news/#product-offers-public), we would like to inform you that **on February 28th, 2022 we will disable the beta versions of /sale/product-offers resources**.

**How to migrate to the public version?**

It depends on which beta version you are using:

- **beta.v3** - all you need to do is to change the data in **Content-Type** and **Accept** headers from “application/vnd.allegro.beta.v3+json” to **“application/vnd.allegro.public.v1+json”**,
- **beta.v2** - implement the changes which we have introduced in the beta.v3 version - **“product”** field has been replaced with the **“productSet”** field, which is an array of objects. Also, change the data in **Content-Type** and **Accept** headers from “application/vnd.allegro.beta.v2+json” to **“application/vnd.allegro.public.v1+json”**.

**What changes have we made in the public version?**

1. We added support for new fields that can be declared in the request structure for [POST /sale/product-offers](https://developer.allegro.pl/en/documentation/#operation/createProductOffers) and [PATCH /sale/product-offers/{offerID}](https://developer.allegro.pl/en/documentation/#operation/editProductOffers):

- “attachments”,
- “additionalServices”,
- “compatibilityList”
- “b2b” - whether the offer is available for purchase only for buyers with a company account,
- “delivery.shipmentDate” - shipping date, e.g. for pre-sale,
- “fundraisingCampaign” - charity organization identifier,
- “publication.republish” - whether the offer should be automatically republished.

2. We updated the response for:
- [POST /sale/product-offers](https://developer.allegro.pl/en/documentation/#operation/createProductOffers),
- [PATCH /sale/product-offers/{offerId}](https://developer.allegro.pl/en/documentation/#operation/editProductOffers),
- [GET /sale/product-offers/{offerId}](https://developer.allegro.pl/en/documentation/#operation/getProductOffer)

Product parameters that describe the specific product feature (which are marked with “options.describesProduct”: true flag in response to [GET /sale/categories/{categoryId}/parameters](https://developer.allegro.pl/documentation/#operation/getCategoryUsingGET_1)) are returned now in the **“productSet.product.parameters”** section. Offer parameters related to individual features of the offer, such as condition, expiration date, etc. we will return in the **“parameters”** field.

The public version also includes the changes which we introduced in the **beta.v3** version:

- for [POST /sale/product-offers](https://developer.allegro.pl/en/documentation/#operation/createProductOffers) and [GET /sale/product-offers/{offerId}](https://developer.allegro.pl/en/documentation/#operation/getProductOffer) - **“product”** field has been replaced with the **“productSet”** field, which is an array of objects.
- for [PATCH /sale/product-offers/{offerId}](https://developer.allegro.pl/en/documentation/#operation/editProductOffers) - if the offer is ended and you update the quantity for it to more than 0, we will not activate the offer - in this case, the offer will remain in “ENDED” status.