Zgodnie z naszą wcześniejszą zapowiedzią 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. Jeśli nie korzystasz jeszcze z wymienionych endpointów, zapoznaj się z naszym poradnikiem, 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ę) i jeśli tego nie wykonał (zobacz makietę) - 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ę) - 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 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.