[NEWS] Udostępniliśmy możliwość tworzenia zestawów produktowych / We have enabled the product sets creation

Zgodnie z naszą [wcześniejszą zapowiedzią](https://developer.allegro.pl/news/#product-offers-v3) udostępniliśmy dziś funkcjonalność, dzięki której zdefiniujesz zestawy produktowe. Zdecydowaliśmy, aby w pierwszym etapie możliwość tworzenia zestawów udostępnić wyłącznie w ramach API - dzięki temu przygotujesz swoją aplikację na zmiany przed kolejnymi etapami wdrożeń, które nastąpią na przełomie roku:

- sprzedawcy będą mogli zdefiniować zestawy produktowe także przez formularz wystawiania,
- oznaczymy je odpowiednio w wynikach wyszukiwania i na stronie oferty.

**Czym są zestawy produktowe?**

Są to oferty sprzedaży zestawu, który składa się z:

- kilku różnych produktów, np. konsola z dodatkową grą oraz dwoma padami,
- wielu sztuk jednego produktu (tzw. wielopak).

Zestawy produktowe utworzysz wyłącznie za pomocą zasobów /sale/product-offers w wersji **beta.v3**.

**Dlaczego wprowadzamy zmianę?**

Aktualnie sprzedawcy mogą zdefiniować ofertę, która dotyczy zestawu przedmiotów, ale mogą przy tym wskazać wyłącznie jeden produkt z Katalogu produktów Allegro - pozostałe informacje muszą uzupełnić w tytule i opisie oferty. Po wprowadzeniu zmiany będą mogli wystawić ofertę, przypisując więcej niż jeden produkt - dzięki temu zaprezentują kupującym, jakie dokładnie produkty wchodzą w skład oferty. Zestawy oznaczymy również odpowiednio w wynikach wyszukiwania oraz na stronie oferty. Planujemy rozwijać funkcjonalność zestawów produktowych w zasobach /sale/product-offers, tak aby w przyszłości w całości zastąpiły one [dotychczasowe zestawy ofert](https://developer.allegro.pl/offer_bundles/#4-promocyjne-zestawy-ofert). Jeśli nie korzystasz jeszcze z wymienionych endpointów, zapoznaj się z [naszym poradnikiem](https://developer.allegro.pl/product_offers/), w którym szczegółowo opisujemy ich obsługę.

**Jak utworzyć zestaw produktowy?**

Zestawy zdefiniujesz:

- na podstawie produktów, które istnieją w naszej bazie. Wystarczy, że w strukturze żądania wskażesz ID produktów lub numery EAN;
- przekazując nam dane, które są potrzebne do utworzenia produktu (jeśli nie znajdziesz produktu w naszej bazie). W oparciu o nie przypiszemy do oferty:
- ID utworzonych produktów,
- ID produktów z naszej bazy, które rozpoznaliśmy na podstawie przekazanych danych.

Poniżej znajdziesz przykład, jak utworzyć zestaw na podstawie produktów z naszej bazy, w którego skład wejdą:

- Konsola Sony PlayStation 5 Digital Edition - 1 sztuka,
- Gra Ratchet & Clank: Rift Apart - 1 sztuka,
- Kontroler Sony PS5 DualSense PAD Bezprzewodowy - 2 sztuki.

```
curl -X POST
‘https://api.allegro.pl/sale/product-offers’
-H ‘Authorization: Bearer {token}’
-H ‘Accept: application/vnd.allegro.beta.v3+json’
-H ‘Content-Type: application/vnd.allegro.beta.v3+json’
-d ‘{
“name”: “Zestaw PlayStation 5 + Ratchet & Clank + 2 pady”,
“productSet”: [
{
“product”: {“id”: “7b167551-0c7d-42fd-ba39-102ac5e4efc7”},
“quantity”: {“value”: 1} – liczba sztuk wskazanego produktu, która
wejdzie w skład pojedynczego zestawu
},
{
“product”: {“id”: “2903dd7e-4958-436c-8be0-491ea1ea0d85”},
“quantity”: {“value”: 1}
},
{
“product”: {“id”: “8487577e-e831-452c-83d7-d8b23b7fc1d3”},
“quantity”: {“value”: 2}
}
],
“sellingMode”: {
“price”: {
“amount”: “4000.00”,
“currency”: “PLN”
}
},
“stock”: {
“available”: 99
}
}’
```

**Oferta, którą utworzymy, będzie przez nas walidowana i rozliczana w oparciu o pierwszy produkt z listy, a w szczególności o kategorię produktu**. Na stronie głównej oferty początkowo będziemy prezentować parametry tylko pierwszego produktu.
Poniżej możesz zobaczyć, jak w kolejnych etapach zestawy produktowe będą prezentować się z perspektywy kupującego (wizualizacje mają charakter poglądowy):

- w wynikach wyszukiwania, gdy użytkownik pogrupował oferty z tym samym produktem ([zobacz makietę](https://developer.allegro.pl/images/product_set_offer_listing.png)) i jeśli tego nie wykonał ([zobacz makietę](https://developer.allegro.pl/images/product_set_offer_listing.png)) - zestawy zyskają specjalne oznaczenie “zestaw x produktów” lub “zestaw x sztuk”, w zależności od tego, czy dana pozycja jest ofertą sprzedaży różnych produktów, czy wielu sztuk tego samego produktu;
- na stronie oferty ([zobacz makietę](https://developer.allegro.pl/images/show_product.png)) - uwzględnimy informację o tym, jakie produkty wchodzą w skład zestawu (w początkowej fazie sprzedawca sam musi odpowiednio opisać, co dokładnie sprzedaje).

W początkowej fazie wystąpią ograniczenia:

- w [wybranych kategoriach](https://developer.allegro.pl/product_offers/#jak-utworzy%C4%87-zestaw-produktowy) utworzysz tylko tzw. wielopak, czyli zestaw składający się z wielu sztuk tego samego produktu
- produkty z bazy TecDoc nie mogą wchodzić w skład zestawów,
- jeśli każdy produkt posiada przypisaną sekcję Pasuje Do, to w szczegółach oferty zwrócimy listę tylko dla głównego produktu. W niedalekiej przyszłości planujemy dodać mechanizm, dzięki któremu będziemy prezentować wspólne pozycje - czyli te, które występują w każdym produkcie z zestawu.

Więcej informacji, wraz z przykładami, znajdziesz w [naszym poradniku](https://developer.allegro.pl/product_offers/#jak-utworzy%C4%87-zestaw-produktowy).

-----

According to our [previous announcement](https://developer.allegro.pl/en/news/#product-offers-v3), today we have enabled the possibility to create a product set. We decided to introduce it only in API in the first stage - owing to it, you can prepare your application for changes before the next stages of implementations that will happen at the turn of the year:

- sellers will be able to create product sets via listing form,
- we will mark them in the search results and on the offer page.

**What are product sets?**

These are offers which include:

- several different products, e.g. a console with an additional game and two pads,
- or many units of one product (so-called multipack).

Product sets can be created only via /sale/product-offers resources in the **beta.v3 version**.

**Why do we make the change?**

Currently, sellers can define an offer that includes a set of items, but they must indicate only one product from Allegro product Catalog - the rest of the information must be provided in the title and description of the offer. After the change, they will be able to list an offer, assigning more than one product - owing to it, they will present to the buyers exactly what products are included in the offer. The sets will be also accordingly marked in the search results and on the offer page. We plan to develop the product sets feature in the /sale/product-offers resources, so that in the future we will completely replace the [existing offer sets](https://developer.allegro.pl/en/offer_bundles/#4-promotional-sets-of-offers). If you are not using those endpoints yet, check [our guide](https://developer.allegro.pl/en/product_offers/), in which we describe how to manage them.

**How to create a product set?**

Product sets can be defined:

- based on products that already exist in our database. All you have to do is indicate product IDs or EAN codes in the request structure;
- by providing the data, which is required to create a product (if you do not find a product in our database). Based on it, we will assign to an offer:
- ID of created products,
- ID of products from our database, which we recognize based on the given data.

Below you will find an example of how to create a product set based on products from our database, which will include:

- PlayStation 5 Digital Edition - 1 unit,
- Game Ratchet & Clank: Rift Apart - 1 unit,
- Sony PS5 DualSense PAD wireless - 2 units.

```
curl -X POST
‘https://api.allegro.pl/sale/product-offers’ \
-H 'Authorization: Bearer {token}' \
-H 'Accept: application/vnd.allegro.beta.v3+json' \
-H 'Content-Type: application/vnd.allegro.beta.v3+json' \
-d ‘{
"name": "Zestaw PlayStation 5 + Ratchet & Clank + 2 pady",
"productSet": [
{
"product": {"id": "7b167551-0c7d-42fd-ba39-102ac5e4efc7"},
"quantity": {"value": 1} -- the number of items of the indicated product
that will be included in a single set
},
{
"product": {"id": "2903dd7e-4958-436c-8be0-491ea1ea0d85"},
"quantity": {"value": 1}
},
{
"product": {"id": "8487577e-e831-452c-83d7-d8b23b7fc1d3"},
"quantity": {"value": 2}
}
],
"sellingMode": {
"price": {
"amount": "4000.00",
"currency": "PLN"
}
},
"stock": {
"available": 99
}
}’
```

**The created offer will be validated and settled based on the first product from the list, especially on the product category. On the main page of the offer, initially, we will only present the parameters of the first product.**
Below you can see how products sets will be presented in the next stages from the buyer's perspective (the visualizations are illustrative purpose):

- in the search results when the buyer grouped offers with the same products ([see the mockup](https://developer.allegro.pl/images/product_set_offer_listing.png)) and when doesn't ([see the mockup](https://developer.allegro.pl/images/product_set_product_listing.png)) - sets will have special mark "zestaw x produktów" or "zestaw x sztuk", depending on whether the offer includes different products or multiple units of the same product;

- on the offer page ([see the mockup](https://developer.allegro.pl/images/show_product.png)) - we will present which products are included in the set (at the initial stage seller needs to describe what exactly are the selling items)

In the initial phase, there will be some limitations - it will not be available:

- in [selected categories](https://developer.allegro.pl/en/product_offers/#how-to-create-a-product-set), you will create only the so-called multipack, i.e. a set consisting of many pieces of the same product,
- products from TecDoc database cannot be included in the sets,
- if each product has a compatibility list assigned, we will return in the offer details only the list for the main product. In the near future add a mechanism, owing to which we will present common elements - that is, those that are present in each product in the set.

More information, including examples, can be found in [our guide.](https://developer.allegro.pl/en/product_offers/#how-to-create-a-product-set)