¶ Produkt konfigurowalny - rodzaje i budowa

Produkt konfigurowalny (zestaw konfigurowalny) w Hummerce to towar, który klient składa z komponentów: wybiera towary z list i wypełnia parametry, np. tekst, zdjęcie czy wymiar. Strona opisuje, jak taki produkt jest zbudowany w panelu. Przegląd całego obszaru: Konfiguratory produktów.

Stan na wersję Hummerce 2.35 (ostatnie zmiany w module: 2.35.65), aktualizacja 2026-10-07.

¶ Korzyści i zastosowania

Katalog bez eksplozji wariantów - jeden produkt konfigurowalny zamiast osobnego towaru dla każdej kombinacji.
Jeden produkt w katalogu zamiast setek wariantów - kombinacje tworzy klient, a sklep pilnuje reguł i ceny.
Komponenty z kryterium same aktualizują listę wyborów - nowy towar w kategorii od razu pojawia się w konfiguratorze.
Komponent jako osobna pozycja koszyka - magazyn i ERP widzą rzeczywiście sprzedane elementy.
Szablony - dziesiątki produktów o tej samej budowie (np. rodzina parapetów, kubków, ram) utrzymywane z jednego miejsca.
Asystent AI buduje i poprawia produkty konfigurowalne na polecenie, bez ręcznego klikania w panelu.
Przeniesienie całego konfiguratora między sklepami jednym dokumentem (komponenty, wartości parametrów, reguły zależności) przez asystenta AI - bez odtwarzania komponentów ręcznie.
Te same klocki (komponenty i ich typy) obsługują każdy rodzaj konfiguratora - od prostego graweru po zestaw z kilkudziesięciu elementów.

¶ Zasady działania

¶ Rodzaje produktów konfigurowalnych

Wszystkie rodzaje powstają z tego samego mechanizmu - różnią się komponentami i wyglądem konfiguratora.

Rodzaj	Z czego się składa	Przykład
Zestaw z produktów	komponenty typu "towary" - każdy komponent to wybór jednego towaru z listy	deska + maszt + żagiel, słuchawki + nakładki + etui, garnitur
Produkt na wymiar	komponenty typu "parametry" z wartościami liczbowymi, często z komponentami-towarami (materiał, akcesoria)	parapet, listwa, zasłona, mebel
Personalizacja	komponenty typu "parametry" z tekstem i zdjęciem, obszar roboczy z podglądem	kubek, butelka, naklejka, cyferblat zegarka
Grawer, dodatek, usługa	produkt z jednym lub kilkoma komponentami doliczanymi do ceny	grawer tekstu, bilecik, opakowanie prezentowe
Konfiguracja techniczna	zestaw z towarów z regułami zależności - wybór jednego elementu zawęża lub ustawia kolejne	system oświetlenia, okucia, klamki

Produktem konfigurowalnym może być towar pojedynczy albo wariant. Artykuł (towar z wariantami) nie może być zestawem.
Komponent może zawierać towar, który sam jest produktem konfigurowalnym - konfiguracje można zagnieżdżać.
Jeśli w komponencie znajdzie się artykuł, klient wybiera spośród jego wariantów.
Produkt konfigurowalny a inne mechanizmy:
- warianty (artykuł i podtowary) - osobne towary z własnym symbolem, ceną i stanem; dobre dla kilku cech o skończonej liczbie wartości (Artykuł i podtowary),
- dodatki do towaru - osobny mechanizm oparty na kategorii dodatków (Dodatki); w produkcie konfigurowalnym dodatki buduje się jako komponent.

¶ Budowa

Diagram budowy produktu konfigurowalnego w Hummerce: szablon towaru określa wygląd konfiguratora i sposób liczenia ceny, produkt konfigurowalny ma komponenty typu towary (klient wybiera jeden towar z listy) i typu parametry (klient wypełnia pola), a towar w komponencie może sam być produktem konfigurowalnym (zagnieżdżenie)

¶ Komponenty

Każdy komponent ma Symbol (unikalny w produkcie) i Typ (typ komponentu).
Komponent typu "towary" - klient wybiera jeden towar. Źródło listy towarów:
- Jeden towar z podanych - lista wskazana ręcznie, w ustalonej kolejności,
- Jeden towar spełniający kryterium - lista z kryterium towarów; kryterium może odwoływać się do parametrów produktu i komponentu, np. żeby kolor towaru w komponencie zgadzał się z kolorem produktu,
- Jeden towar pasujący do warunków - kategoria (z podkategoriami), producent lub grupa towarowa.
Na liście towarów komponentu klient widzi tylko towary widoczne i dostępne do zakupu.
Ustawienia komponentu:
- Może być pusty - klient może nic nie wybrać (np. bez opakowania),
- Doliczaj cenę do zestawu - cena komponentu powiększa cenę produktu,
- Cena za slot - stała cena komponentu, używana zamiast ceny wybranego towaru,
- Dodawaj jako osobną pozycję w koszyku - wybrany towar trafia do koszyka jako podpozycja produktu (i dalej do zamówienia, magazynu i ERP),
- Współczynnik ilości towarów - ile sztuk komponentu przypada na sztukę produktu (np. 4 kółka na 1 wózek),
- Pozwól klientom na określenie ilości - klient sam podaje ilość komponentu,
- Domyślny towar w slocie - towar wybrany na starcie,
- Nie uzupełniaj slota towarami - lista towarów komponentu nie jest wczytywana automatycznie (dla długich list, gdy konfigurator dobiera towar sam),
- Przypnij do - komponent jest kopią innego komponentu i korzysta z jego listy towarów,
- rabat procentowy komponentu - obniża cenę komponentu (np. rabat za kupno zestawu).
Pole Ilość komponentów do dodania tworzy od razu kilka kopii komponentu przypiętych do pierwszego - np. 3 identyczne wybory dodatków.
Nazwa, opis i pozostałe parametry komponentu zależą od typu komponentu - np. wartości minimalne i maksymalne, jednostka miary, widok listy (lista rozwijana, pola wyboru, kafelki), dozwolone rozszerzenia plików.

¶ Typy komponentów

Typ komponentu to gotowy, wstępnie skonfigurowany rodzaj komponentu używany w sklepie - np. towary, tekst, zdjęcie, grawer, opakowanie, dodatki.
Typ określa:
- Zawartość - Towary albo Parametry,
- Parametry konfiguracyjne - ustawiane przez obsługę sklepu przy komponencie (np. maksymalna długość tekstu),
- Parametry konfigurowalne - wypełniane przez klienta (np. treść tekstu, zdjęcie).
Od typu komponentu zależy też jego wygląd i zachowanie w konfiguratorze - np. pole uploadu, tekst z generatorem AI, wybór wariantu, informacja dla klienta.
Typu używanego w komponentach nie można usunąć.

¶ Szablony

Budowę produktu (komponenty i parametry zestawu) można przygotować w szablonie towaru i przenieść do produktów:
- przy tworzeniu towaru z szablonu,
- przez Pobierz z szablonu w zakładce Zestaw konfigurowalny produktu,
- hurtowo - Nadpisz konfigurację na szablonie otwiera listę towarów z operacją Przypisz do szablonu, z wyborem, czy nadpisać tylko dane zestawu konfigurowalnego, czy wszystkie dane zdefiniowane w szablonie.
Szablon kopiuje komponenty do produktu - nie jest dziedziczony. Zmiana szablonu nie zmienia produktów, dopóki obsługa nie nadpisze ich konfiguracji.
Od szablonu zależą:
- wygląd konfiguratora na stronie produktu - parametr Typ szablonu (Konfigurator na stronie produktu),
- sposób liczenia ceny, jeśli wdrożenie ma własne reguły ceny dla danego szablonu (Ceny konfiguracji),
- sposób przygotowania pliku do druku,
- lista parametrów zestawu i zakładek widocznych na karcie produktu.

¶ Wersja

Funkcja podstawowa platformy - dostępna we wszystkich wspieranych wersjach.
Od wersji 2.33 - komponenty bez automatycznego wczytywania listy towarów i stronicowanie długich list towarów w komponencie.
Od wersji 2.34 - parametry komponentów dla nowych konfiguratorów BS5 (jednostki miary, wartości minimalne i maksymalne, widok listy, AI, zależności), budowa produktów konfigurowalnych przez asystenta AI (MCP).
Od wersji 2.35 - odczyt i zapis parametrów komponentów przez MCP.
Od wersji 2.35.61 - komponenty typu "Parametry" (bez listy towarów) zakładane przez MCP.
Od wersji 2.35.62 - typy komponentów, kopiowanie komponentów z szablonu, kolejność komponentów oraz eksport i import całego zestawu komponentów przez MCP.
Od wersji 2.35.63 - reguły zależności konfiguratora przenoszą się razem z dokumentem eksportu.
Od wersji 2.35.65 - opcję Uwzględniaj ceny komponentów ustawia i odczytuje MCP.
Ostatnie zmiany w module: wersja 2.35.65.

¶ Zależności

Moduł zestawów konfigurowalnych włączony w konfiguracji sklepu.
Typy komponentów przygotowane dla sklepu - w nowym sklepie jest tylko typ "towary", pozostałe (tekst, zdjęcie itd.) dodaje wdrożenie.
Towary-komponenty z cenami i widocznością w danym widoku sklepu.
Konfigurator na stronie produktu - Konfigurator na stronie produktu.

¶ Wdrożenie

Wymaga wdrożenia - moduł nie włącza się sam po aktualizacji. Zakres:
- uruchomienie modułu i ustawień w grupie Zestawy,
- przygotowanie typów komponentów,
- zbudowanie produktu lub szablonu z komponentami,
- dobór listy towarów komponentów (lista ręczna, kryterium, warunki),
- testy konfiguracji i cen.
Minimalny szacowany czas:
- produkt konfigurowalny z kilku komponentów, na gotowych typach komponentów - od 4 h,
- przygotowanie typów komponentów dla nowego rodzaju konfiguratora - od 4 h.
- Wygląd konfiguratora na stronie produktu wyceniamy osobno - zobacz Konfigurator na stronie produktu. Czas konkretnego wdrożenia zależy od jego zakresu - wyceniamy go indywidualnie.
Od czego zależy czas:
- liczba komponentów i produktów,
- czy produkty mają wspólny szablon,
- czy listy towarów da się opisać kryterium, czy trzeba je układać ręcznie,
- przeniesienie istniejących konfiguratorów z innego sklepu - komponenty nie przechodzą przez standardowy eksport i import towarów; przenosi je eksport i import konfiguratora przez MCP, a typy komponentów i ich parametry trzeba przygotować w sklepie docelowym (wycena osobno).

¶ Ograniczenia

W komponencie typu "towary" klient wybiera jeden towar. Kilka różnych wyborów tego samego rodzaju wymaga kilku komponentów (kopii).
Szablon nie jest dziedziczony - po zmianie szablonu trzeba nadpisać konfigurację produktów. Pobierz z szablonu zastępuje wszystkie dotychczasowe komponenty produktu.
Kopie komponentu (Ilość komponentów do dodania) nie przejmują nazwy i parametrów pierwszego komponentu - trzeba je uzupełnić.
Reguły zależności między komponentami działają w konfiguratorze na stronie produktu - serwer przy dodaniu do koszyka sprawdza wymagane komponenty i dozwolone towary, ale nie reguły zależności.
Standardowy eksport i import towarów oraz przenoszenie towarów między sklepami przez MCP nie przenoszą komponentów - przechodzi tylko flaga zestawu. Komponenty przenosi osobny eksport i import konfiguratora przez MCP (od wersji 2.35.62); typy komponentów i definicje parametrów, do których się odwołują, muszą istnieć w sklepie docelowym.
Import konfiguratora zastępuje dotychczasowe komponenty towaru i odmawia zapisu, gdy reguła zależności wskazuje komponent lub towar, którego w zestawie albo sklepie nie ma.
REST API nie obsługuje typów komponentów ani zapisanych konfiguracji klientów.
MCP nie ustawia ceny komponentu ani przypięcia do innego komponentu - te ustawienia zmienia się w panelu. Komponent typu "Parametry" zakłada się od razu bez listy towarów; istniejącego komponentu z listą nie da się przez MCP zmienić na komponent bez listy - pole czyści się w panelu.

¶ Potencjał rozwoju

Dziedziczenie budowy z szablonu (zmiana w szablonie od razu w produktach).
Przenoszenie produktów konfigurowalnych z komponentami między sklepami z poziomu panelu (dziś przez asystenta AI).
Pełna budowa konfiguratora przez asystenta AI, łącznie z cenami komponentów i przypinaniem komponentów.
Czytelniejsza zakładka Zestaw konfigurowalny dla dużych produktów.

¶ Najczęstsze pytania

Czy produkt z wariantami (artykuł) może być jednocześnie zestawem konfigurowalnym?
Nie. Produktem konfigurowalnym może być towar pojedynczy albo wariant, ale artykuł z podtowarami nie może być zestawem.

Czy komponent typu "towary" może pozwolić wybrać kilka sztuk różnych towarów?
Nie wprost. Komponent daje wybór jednego towaru - kilka różnych wyborów tego samego rodzaju wymaga kilku komponentów.

Czy komponenty przenoszą się razem z towarem przy eksporcie XML albo między sklepami przez MCP?
Częściowo. Standardowy eksport i przenoszenie towarów przenoszą tylko flagę zestawu konfigurowalnego. Komponenty z wartościami parametrów i regułami zależności przenosi osobny eksport i import konfiguratora przez asystenta AI (od wersji 2.35.62).

Czy asystent AI (MCP) zbuduje cały produkt konfigurowalny samodzielnie?
Częściowo. MCP tworzy i zmienia typy komponentów, komponenty, ich towary i parametry, kopiuje komponenty z szablonu, ustala ich kolejność i ustawia opcję Uwzględniaj ceny komponentów. Ceny komponentu i przypięcia do innego komponentu zmienia się w panelu.

Ile trwa przygotowanie prostego produktu konfigurowalnego?
Produkt z kilku komponentów, na gotowych typach komponentów - od 4 h. Przygotowanie nowego typu komponentu dla innego rodzaju konfiguratora - też od 4 h.

¶ Powiązane

Konfiguratory produktów - przegląd - cały cykl konfiguracji i pozostałe strony obszaru.
Konfigurator na stronie produktu - wygląd i zachowanie konfiguratora zbudowanego z tych komponentów.
Artykuł i podtowary, Dodatki, Parametry i lokacje.
Na hummerce.com: Konfiguratory.

Chcesz zobaczyć, jak zbudować taki produkt w Waszym sklepie? Umów bezpłatną prezentację.

¶ Szczegóły konfiguracji

¶ Dostęp w panelu

Karta towaru: zakładka Zestaw konfigurowalny - Utwórz zestaw, Usuń funkcję zestawu, Uwzględniaj ceny komponentów, Komponenty, Dodaj komponent, Parametry zestawu, Pobierz z szablonu; na szablonie - Nadpisz konfigurację.
Lista towarów: oznaczenie Zestaw konfigurowalny, filtr Zestawy; w kryteriach towarów warunki Zestawy konfigurowalne i Towar przypisany do slotu.
Typy komponentów: Konfiguracja -> Typy komponentów - symbol, zawartość, parametry konfiguracyjne i konfigurowalne.
Konfiguracja w panelu: grupa Zestawy - m.in. Zakładka Udostępnianie konfiguratora, Ukryj statyczne komponenty w koszyku, Wyświetlanie komponentów wg porządku określonego w konfiguracji zestawu; domyślne ustawienia nowych towarów: Zestaw, Nie ignoruj cen komponentów.
Towar: parametry zestawu - m.in. Ignoruj cenę bazową zestawu, Konfigurator dwustronny, wymiary obszaru roboczego i parametry wydruku (dla personalizacji).

¶ REST API i MCP

REST API: komponenty produktu - lista, odczyt, dodanie, zmiana, usunięcie; na towarze flaga zestawu, Uwzględniaj ceny komponentów i szablon (REST API).
MCP (Asystent AI - serwer MCP):
- odczyt: ec2_combinations_list_slot_types (typy komponentów), ec2_slot_type_get (jeden typ komponentu w całości, także jako dane do ec2_slot_type_create), ec2_combinations_get_slots (komponenty produktu), ec2_combinations_get_slot_items (towary komponentu), ec2_combinations_get_slot_properties (parametry komponentu), ec2_combination_export (cały zestaw komponentów jako jeden dokument, razem z regułami zależności),
- tworzenie: ec2_combinations_create (nowy produkt konfigurowalny), ec2_combinations_create_slot (komponent), ec2_slot_type_create (typ komponentu),
- zmiana: ec2_combinations_update_slot, ec2_slot_type_update, ec2_combinations_set_slot_items, ec2_combinations_add_slot_items, ec2_combinations_set_combination_flag, ec2_combinations_set_slot_property, ec2_combinations_delete_slot_property, ec2_combinations_delete_slot (usunięcie wymaga potwierdzenia), ec2_combinations_copy_slots (odpowiednik Pobierz z szablonu: zastępuje komponenty docelowych towarów; bez potwierdzenia tylko raportuje), ec2_combinations_reorder_slots (kolejność komponentów - wymaga pełnej listy), ec2_combination_import (zapis zestawu z dokumentu eksportu w jednej transakcji, z kontrolą po zapisie; bez apply=true tylko raportuje braki; reguły zależności pomija include_rules=false),
- opcja Uwzględniaj ceny komponentów na towarze: parametr add_prices_of_components w ec2_products_update i ec2_products_bulk_update (od 2.35.65), odczyt w ec2_products_details,
- komponent typu "Parametry" bez listy towarów: items_list_type = None w ec2_combinations_create_slot (od 2.35.61); przy zmianie istniejącego komponentu wartość None jest odrzucana,
- uprawnienia: odczyt, tworzenie i zmiana zestawów konfigurowalnych oraz typów komponentów.

¶ Komunikaty sklepu

Nazwy i opisy komponentów to parametry komponentu - tłumaczy się je jak inne parametry, w parametrach i lokacjach.

¶ Lokacje parametrów

Symbol	Obiekt	Przeznaczenie
`itemAdminSet`	towar	parametry zestawu na karcie produktu
`itemAdminSet_<symbol szablonu>`	towar	parametry zestawu dla produktów danego szablonu
`configurationPropertyLocation_<typ>`	komponent	parametry ustawiane przez obsługę dla danego typu komponentu
`configurablePropertyLocation_<typ>`	komponent	parametry wypełniane przez klienta dla danego typu komponentu

Lokacje typu komponentu powstają automatycznie przy dodaniu typu.

¶ Parametry

Symbol	Obiekt	Etykieta
`_name`, `_description`	komponent	nazwa, opis
`_category`, `_producer`, `_itemGroup`	komponent	Kategoria, Producent, Grupa towarowa (warunki listy towarów)
`_discount`	komponent	rabat procentowy komponentu
`_ignoreBaseSetPrice`	towar	Ignoruj cenę bazową zestawu
`_twoSidedCombination`	towar	Konfigurator dwustronny
`_templateType`	szablon towaru	Typ szablonu
`_combination`	pozycja koszyka, towar	Skonfigurowany zestaw
`_jsonCombination`	pozycja koszyka i zamówienia	Konfiguracja zestawu