Definiowanie parametrów

Do czego służy ta instrukcja

Ten artykuł opisuje, jak w integracji z własnym sklepem zdefiniować parametry (cechy/atrybuty) oraz przypisać je do kategorii. Dzięki temu parametry mogą być wykorzystane na ofertach i wariantach.

W tym artykule znajdziesz

• jak dodać definicje parametrów w integracji,
• jak przypisać parametry do kategorii,
• na co zwrócić uwagę, gdy parametr nie jest dostępny na ofercie.

Kiedy stosować

• gdy integracja wymaga przekazywania cech/atrybutów produktów,
• gdy przygotowujesz warianty w ofertach,
• gdy mapujesz kategorie i chcesz powiązać z nimi właściwe parametry.

Wymagania

• skonfigurowana integracja z własnym sklepem,
• dostęp do edycji ustawień integracji.

Szybki przepis (krok po kroku)

1. Otwórz edycję integracji z własnym sklepem.
2. Dodaj definicje parametrów wymaganych po stronie sklepu.
3. Przypisz parametry do odpowiednich kategorii.
4. Zapisz zmiany i zweryfikuj, czy parametry są dostępne na ofertach.

Typowe problemy i jak je sprawdzić

• Parametr nie pojawia się na ofercie — sprawdź, czy został przypisany do kategorii użytej na ofercie oraz czy zmiany w integracji zostały zapisane.
• Brak możliwości wyboru wartości — upewnij się, że definicja parametru (typ/wartości) jest zgodna z wymaganiami danej integracji.

Szczegóły techniczne

Do ofert tworzonych w xSale możesz przypisać cechy i atrybuty, oparte na parametrach. Parametry są definiowane oddzielnie dla każdej integracji. Ten zasób jest również dostępny dla integracji z własnym sklepem. W tym artykule znajdziesz opis definiowania parametrów i ich przypisywania do kategorii.

Tworzenie definicji parametrów

Parametrów możesz używać do przypisania cech i atrybutów produktów, a także do tworzenia wariantów w obrębie tworzonych ofert. Aby zdefiniować dostępne do wykorzystania parametry oraz ich zastosowanie, użyj endpointu:

POST /{organizationName}/integrations/{id}/categories/{categoryId}/parameters

Prześlij zapytanie na wykorzystując id integracji (id) i id kategorii (categoryId), dla której definiujesz parametry. Podaj nazwę parametru (Name) i zewnętrzne id (ForeigId) oraz wskaż typ tworzonego parametru (Type) (szczegóły poniżej). Zdefiniuj, czy parametr ma być dostępny do wyboru przy tworzeniu ofert wielowariantowych (IsVariantsAllowed), a jeśli tak, to czy ma być dostępny wyłącznie na potrzeby tworzenia wariantów (IsUsedOnlyOnVariantstyp). Powiąż parametr z zewnętrznym id kategorii (ForeignCategoryId), dla której ma być dostępny i określ, czy jego podanie w ofertach tworzonych w obrębie tej kategorii będzie wymagane (IsRequired).

Przykładowe body zapytanie może wyglądać następująco:

{
  „Name”: „Kolor”,
  „Type”: 6,
  „IsVariantsAllowed”: true,
  „ForeignId”: „Kolor”,
  „IsUsedOnlyOnVariants”: false,
  „CategoryRequirements”: [
  {
    „ForeignCategoryId”: „53”,
    „IsRequired”: true
  }
  ] }

Dostępne typy parametrów

Tworząc parametr, wskaż w polu Type odpowiednią wartość liczbową. Wybierz z dostępnych wartości:

• 1-  String
• 2 – Decimal
• 3 – Integer
• 4 – Datetime
• 5 – Boolean
• 6 – List
• 7 – LocalizedString

Jeśli tworzysz parametr o typie 6 (Lista), musisz dodatkowo określić predefiniowane wartości (PredefinedValues), spośród których można dokonać wyboru przy tworzeniu oferty. Prześlij w zapytaniu tablicę zewnętrznych identyfikatorów wartości (ForeignId) oraz same wartości (Value), na przykład:

„PredefinedValues”: [
  {
    „ForeignId”: „745”,
    „Value”: „Czerwony”
  },
  {
    „ForeignId”: „746”,
    „Value”: „Zielony”
  }
]