W drugiej połowie kwietnia 2026 wprowadzimy nową generację narzędzi do budowania zestawów – Zestawy elastyczne. To rozwiązanie, które zastąpi dotychczasowe zestawy ofertowe, da sprzedającym większą swobodę w zarządzaniu zestawami, a kupującym możliwość zakupu spersonalizowanych zestawów.

Najważniejsza funkcja zestawów elastycznych to możliwość zdefiniowania grupowych slotów, dzięki którym stworzysz zestawy dla wielu ofert jednocześnie, w ramach jednej akcji i jednego wspólnego zestawu. Dzięki temu kupujący może wybrać zestaw spośród zdefiniowanych przez sprzedającego ofert w poszczególnych slotach.

Jakie wprowadzimy zmiany w API Allegro?

1. W drugiej połowie kwietnia 2026 wdrożymy grupę nowych endpointów do zarządzania Zestawami elastycznymi:

   • POST /sale/flexible-bundles - utwórz nowy zestaw elastyczny
   • GET /sale/flexible-bundles - pobierz listę utworzonych zestawów elastycznych
   • GET /sale/flexible-bundles/{bundleId} - pobierz szczegóły zestawu elastycznego
   • PUT /sale/flexible-bundles/{bundleId} - edytuj zestaw elastyczny
   • DELETE /sale/flexible-bundles/{bundleId} - usuń zestaw elastyczny.

   Dokładną datę wdrożenia podamy w newsie przypominającym o zmianie.

2. Wraz z wdrożeniem zaczniemy przenosić istniejące zestawy ofertowe do nowego narzędzia.

3. Równocześnie, wyłączymy dotychczasowe API do tworzenia zestawów ofertowych:

   • POST /sale/bundles - utwórz zestaw ofert
   • GET /sale/bundles - pobierz listę zestawów
   • GET /sale/bundles/{bundleId} - pobierz szczegóły wybranego zestawu
   • DELETE /sale/bundles/{bundleId} - usuń wybrany zestaw
   • PUT /sale/bundles/{bundleId}/discount - zmień rabat dla wybranego zestawu.

4. Od dziś możesz rozpocząć testy nowego rozwiązania w ramach publicznego API Sandboxa. Szczegółowa dokumentacja endpointów dostępna jest już w dedykowanej dokumentacji.

   Przykładowy request tworzący nowy zestaw elastyczny:

   curl -X POST \
   'https://api.allegro.pl.allegrosandbox.pl/sale/flexible-bundles' \
   -H 'Authorization: Bearer {token}' \
   -H 'Accept: application/vnd.allegro.public.v1+json' \
   -H 'Content-Type: application/vnd.allegro.public.v1+json' \
   -d '{
   "slots": [
    {
      "order": 0,                          // kolejność slotów w zestawie.
      "entryPoint": true,                  // wskazuje czy na stronach ofert w slocie zostanie
                                           // wyświetlony zestaw.
      "requiredQuantity": 2,               // wymagana liczba sztuk z tego slotu przy
                                           // zakupie.
      "offers": [                          // lista ofert w slocie.
        {
          "id": "1240124104",                         
          "excludedFromDiscount": false    // czy oferta jest wykluczona ze zniżki
                                           // zdefiniowanej w discount.
        }
      ]
    },
    {
      "order": 1,
      "entryPoint": false,
      "requiredQuantity": 1,
      "offers": [
        {
          "id": "1240234504",
          "excludedFromDiscount": false
        }
      ]
    }
   ],
   "discount": {
    "type": "SLOT_DISCOUNT",                // rodzaj rabatu: 
                                            // - WHOLE_BUNDLE_DISCOUNT oznacza, że kwota
                                            // rabatu zostanie rozłożona proporcjonalnie 
                                            // na wszystkie niewykluczone ze zniżki
                                            // oferty w zestawie. 
                                            // - SLOT_DISCOUNT pozwala określić, które sloty
                                            // w zestawie są objęte rabatem i w jakiej 
                                            // wysokości, np. slot z etui na smartfony może być
                                            // objęty rabatem w wysokości 20%, ale slot ze
                                            // słuchawkami może nie być objęta żadnym
                                            // rabatem.
    "slot": {
      "slots": [
        {
          "order": 0,
          "discounts": [
            {
              "marketplaceId": "allegro-pl",
              "percentage": 5
            },
            {
              "marketplaceId": "allegro-cz",
              "percentage": 10
            }
          ]
        },
        {
          "order": 1,
          "discounts": [
            {
              "marketplaceId": "allegro-cz",
              "percentage": 20
            }
          ]
        }
      ]
    }
   }
   }'

Jakie są kluczowe różnice w działaniu mechanizmów?