Kombinacje produktu (warianty)
ps_manage_combinations
Pokazuje warianty produktu, np. rozmiary i kolory, i zmienia ich ceny, kody oraz to, który wariant jest pokazywany jako pierwszy.
Darmowy TellMyShop Audyt: Nie. To narzędzie jest tylko w płatnej wersji TellMyShop. Darmowy TellMyShop Audyt ma tylko narzędzia, które czytają sklep.
Zapytaj Claude
„Rozmiary XL bluzy Oslo mają kosztować 10 zł więcej niż pozostałe.”
Przykładowy podgląd
Produkt 310 Bluza Oslo. Kombinacja 1204 (Rozmiar XL, Kolor Szary): wpływ na cenę +0,00 -> +10,00 brutto (+8,13 netto), cena końcowa 189,99 -> 199,99 zł brutto. Kombinacja 1208 (Rozmiar XL, Kolor Granatowy): tak samo.
Szczegóły techniczne
Kombinacje (warianty: rozmiar, kolor...). action=list pokazuje kombinacje produktu z atrybutami, indeksem, EAN, wpływem na cenę (netto i brutto), ceną końcową brutto, stanem i kombinacją domyślną. action=update zmienia do 100 kombinacji: price_impact_gross albo price_impact_net (o ile cena kombinacji różni się od ceny bazowej; 0 = taka sama), wholesale_price, reference, ean13, upc, mpn, weight_impact, minimal_quantity, default=true (kombinacja domyślna na stronie produktu). Nie tworzy ani nie usuwa kombinacji. Stany: ps_update_stock z combination_id. Promocja na wariant: ps_manage_specific_prices z combination_id.
Parametry
| Nazwa | Typ | Wymagany | Opis |
|---|---|---|---|
| action | enum: list | update | tak | list | update. |
| shop_id | integer | nie | ID sklepu (multistore). Domyślnie sklep z adresu konektora; lista w ps_get_shop_info. |
| lang | string | nie | Kod ISO języka (np. "pl", "en"). Domyślnie język domyślny sklepu. |
| product | string | warunkowo | action=list: produkt. Produkt tak, jak widzi go człowiek: "id:123", "ref:ABC-1", "ean:5901234123457", adres URL produktu ze sklepu, samo ID (1–7 cyfr), EAN (8/12/13 cyfr) albo referencja. Maks. 300 znaków. |
| changes | array of object | warunkowo | action=update: po jednym elemencie na kombinację. Maks. 100 elementów. Pola każdego elementu: product (string, wymagane): Produkt (id:123, ref:ABC-1, ean:..., adres URL produktu, ID, EAN albo referencja). Maks. 300 znaków. combination_id (integer, wymagane): ID kombinacji z action=list. price_impact_gross (number): Wpływ na cenę brutto (np. 10 = o 10 jednostek waluty drożej niż cena bazowa, -5 = taniej). Zakres -1 000 000 do 1 000 000. price_impact_net (number): Wpływ na cenę netto (zamiast brutto). Zakres -1 000 000 do 1 000 000. wholesale_price (number): Cena zakupu netto kombinacji (0 = cena zakupu produktu). Zakres 0 do 10 000 000. reference (string): Indeks (kod) kombinacji. Maks. 64 znaków. ean13 (string): EAN-13 (puste = usuń). upc (string): UPC. mpn (string): Kod producenta (MPN). Maks. 40 znaków. weight_impact (number): Wpływ na wagę (kg). Zakres -10 000 do 10 000. minimal_quantity (integer): Minimalna ilość w zamówieniu. Zakres 1 do 100 000. default (boolean): true = kombinacja domyślna produktu. |
| confirm | boolean | nie | false (domyślnie) = tylko podgląd, nic nie zapisuje. true = wykonaj – wyłącznie po wyraźnej zgodzie użytkownika na pokazany podgląd, razem z change_token. |
| change_token | string | warunkowo | Token z podglądu (wymagany przy confirm=true). Wiąże wykonanie z pokazanym podglądem i stanem danych; ważny 30 minut, jednorazowy. |
Ograniczenia
update: do 100 kombinacji na wywołanie. Nie tworzy ani nie usuwa kombinacji (panel). Cofanie przez ps_revert_change.
Co widzisz przed zapisem
Claude najpierw wywołuje narzędzie bez potwierdzenia. Moduł zwraca podgląd (obecne i nowe wartości) oraz jednorazowy token ważny 30 minut. Claude pokazuje ci podgląd i zapisuje zmianę dopiero po twojej zgodzie.
Powiązane narzędzia
- Stany magazynowe ps_update_stock
- Ceny promocyjne (ceny specyficzne) ps_manage_specific_prices
- Zmiana cen ps_update_prices
- Cofnięcie zmiany ps_revert_change
Zastosowania z tym narzędziem
Aktualizacja: 2026-10-05