[NEWS] Udostępniliśmy wersję public zasobów /sale/product-offers / We have introduced public version of the /sale/product-offers resources

Zakończyliśmy okres testowy dla zasobów /sale/product-offers, dzięki którym:
- [za pomocą jednego żądania wystawisz aktywną ofertę powiązaną z produktem](https://developer.allegro.pl/product_offers/),
- [edytujesz dowolne pole oferty](https://developer.allegro.pl/product_offers/#jak-edytowa%c4%87-ofert%c4%99),
- [utworzysz zestaw produktowy](https://developer.allegro.pl/product_offers/#jak-utworzy%c4%87-zestaw-produktowy).

**Wersję beta będziemy wspierać do 28.02.2022.** W tym okresie przejdź na wersję public.

**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,
- “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”.

**Na jakie zasoby wpływa zmiana?**

Poniżej znajdziesz listę zasobów, które wystawiliśmy w wersji public:

- [POST /sale/product-offers](https://developer.allegro.pl/documentation/#operation/createProductOffers) - utwórz ofertę powiązaną z produktem,
- [GET /sale/product-offers/{offerId}/operations/{operationId}](https://developer.allegro.pl/documentation/#operation/getProductOfferProcessingStatus) - sprawdź status publikacji / edycji oferty,
- [GET /sale/product-offers/{offerId}](https://developer.allegro.pl/documentation/#operation/getProductOffer) - pobierz szczegóły oferty,
- [PATCH /sale/product-offers/{offerId}](https://developer.allegro.pl/documentation/#operation/editProductOffers) - edytuj ofertę,

-----

We have completed the test period for /sale/product-offers resources, which allow you to:
- [list an offer assigned to a product with one request](https://developer.allegro.pl/en/product_offers/),
- [edit any field of the offer](https://developer.allegro.pl/product_offers/#jak-edytowa%c4%87-ofert%c4%99](https://developer.allegro.pl/en/product_offers/#how-to-edit-an-offer)),
- [create a product set](https://developer.allegro.pl/en/product_offers/#how-to-create-a-product-set).

**We will support the beta versions until February 28th, 2022.** Switch to the public version during this period.

**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”,
- “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.

**Which resources are affected by this change?**

Below you will find the list of resources which we introduced in the public version:

- [POST /sale/product-offers](https://developer.allegro.pl/en/documentation/#operation/createProductOffers) - create an offer assigned to a product,
- [GET /sale/product-offers/{offerId}/operations/{operationId}](https://developer.allegro.pl/en/documentation/#operation/getProductOfferProcessingStatus) - check offer publication / edit status,
- [GET /sale/product-offers/{offerId}](https://developer.allegro.pl/en/documentation/#operation/getProductOffer) - retrieve offer details,
- [PATCH /sale/product-offers/{offerId}](https://developer.allegro.pl/en/documentation/#operation/editProductOffers) - edit offer.