W zasobie GET /sale/categories/{categoryId}/parameters, dzięki któremu pobierzesz wszystkie parametry w ramach danej kategorii, dodaliśmy informacje o wcześniejszych nazwach i identyfikatorach:

• parametrów
• wartości parametrów słownikowych

Co zmieniliśmy?

We wspomnianym zasobie dodaliśmy pole “formerData”, gdzie zwracamy:

• na poziomie danego parametru, pola:
  • ids - wcześniejsze ID parametru
  • names - wcześniejsze nazwy parametru
• na poziomie danej wartości parametru słownikowego, pola:
  • ids - wcześniejsze identyfikatory wartości parametru
  • values - wcześniejsze nazwy wartości parametru

Nowe pola zwrócimy tylko wtedy, gdy dla danego parametru lub wartości występowała wcześniej inna nazwa lub wartość. Bedą występować co najmniej miesiąc od wprowadzenia zmian.

Przykładowy fragment response dla parametru “Kod Producenta”, który wcześniej występował pod inną nazwą i ID:

{
  "parameters": [
    {
      "id": "224017",
      "name": "Kod producenta",
      "type": "string",
      "formerData": {
        "names": [      // wcześniejsze nazwy parametru
          "MPN"
        ],
            "ids": [       // wcześniejsze ID parametru
        "240312"
        ]
      }
    }
  ]
}

Przykładowy fragment response dla wartości “Nowy” parametru “Stan”, która wcześniej występowała pod innymi nazwami:

{
  "parameters": [
    {
      "id": "11323",
      "name": "Stan",
      "type": "dictionary",
      "dictionary": [
        {
          "id": "11323_1",
          "value": "Nowy",
          "formerData": {
            "values": [       // wcześniejsze nazwy wartości
              "Nowa",
              "Nowe"
            ]
          }
        }
      ]
    }
  ]
}

Dlaczego wprowadzamy zmianę?

Chcemy ułatwić utrzymanie spójności danych między Waszymi narzędziami a Allegro. Nowe informacje o historycznych nazwach i identyfikatorach pozwolą Wam na automatyczne mapowanie parametrów i wartości, co zminimalizuje ryzyko błędów przy wystawianiu ofert i ograniczy konieczność ręcznych aktualizacji.