16.11.2020 planujemy wdrożyć kolejny etap obsługi parametrów zależnych - warunkową obowiązkowość i wyświetlanie. Więcej o parametrach zależnych przeczytacie w naszym wcześniejszym komunikacie. Dzięki parametrom zależnym uprościmy nawigację, a kupujący będą mogli porównywać między sobą oferty znajdujące się dotąd w różnych kategoriach. Dodatkowo sprzedawcy będą mogli dodawać do ofert kompletne i adekwatne informacje, które będą odpowiadały charakterowi sprzedawanego produktu. Dzięki temu kupujący skuteczniej znajdzie dobrze opisane oferty.

Warunkowa obowiązkowość oznacza, że wymagalność danego parametru uzależniona jest od wartości wybranej dla parametru warunkującego np. jeżeli sprzedawca wybierze w parametrze “Stan” wartość “Nowy”, wtedy powinien też wiedzieć, jaka jest wartość parametru “Kod producenta”, dlatego oznaczymy go jako obowiązkowy. Jeżeli wybierze wartość “Używany”, wtedy parametr “Kod producenta” będzie opcjonalny, na wypadek gdyby produkt miał np. wytartą metkę.

Warunkowa widoczność oznacza, że wyświetlenie danego parametru uzależnione jest od wartości wybranej dla parametru warunkującego np. jeżeli w kategorii “Mydła” (258383) sprzedawca wybierze w parametrze “Rodzaj” wartość “Kostka”, wyświetlimy wtedy parametr “Waga”, a “Pojemność” ukryjemy. Z kolei, gdyby wybrał wartość “Płyn” lub “Pasta”, wtedy nastąpi odwrotna sytuacja - ukryjemy parametr “Waga”, a pokażemy “Pojemność”.

W związku z tym, dla GET /sale/categories/{categoryId}/parameters dodaliśmy nowe pola:

• options.requiredDependsOnValueIds - w którym zwrócimy identyfikatory wartości parametru warunkującego, dla których ten parametr będzie wymagany, np. może się tutaj znaleźć identyfikator wartości “Nowy” dla parametru “Stan”,
• options.displayDependsOnValueIds - w którym zwrócimy zbiór identyfikatorów wartości parametru warunkującego, od których zależy, czy dany parametr będzie widoczny, np. jeżeli to pole dotyczy parametru “Pojemność” w kategorii “Mydła”, to zwrócimy tutaj identyfikatory wartości “Płyn i “Pasta” dla parametru “Rodzaj”.

Na stronie dla sprzedających znajdziesz listę pierwszych kategorii i parametrów, dla których wprowadzimy warunkową obowiązkowość i wyświetlanie.

Przykładowa struktura odpowiedzi:

{
  "parameters": [
    {
      "id": "202877",
      "name": "Liczba rdzeni procesora",
      "type": "integer",
      "required": false,
      "requiredForProduct": false,
      "unit": null,
      "options": {
        "variantsAllowed": true,
        "variantsEqual": false,
        "ambiguousValueId": null,
        "dependsOnParameterId": "202870",
        "requiredDependsOnValueIds": [
          "202870_1"
        ],
        "displayDependsOnValueIds": [
          "202870_1",
          "202870_2"
        ],
        "describesProduct": false
      },
      "restrictions": {
        "min": 0,
        "max": 1000000,
        "range": false
      }
    }
  ]
}