[NEWS] Parametry - dodaliśmy informacje o wcześniejszych nazwach i wartościach / Parameters - we have added information on former names and values

W zasobie [GET /sale/categories/{categoryId}/parameters](https://developer.allegro.pl/documentation#tag/Categories-and-parameters/operation/getFlatParametersUsingGET_2), 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:

```json5
{
"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:

```json5
{
"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.

-----

In the [GET /sale/categories/{categoryId}/parameters](https://developer.allegro.pl/documentation#tag/Categories-and-parameters/operation/getFlatParametersUsingGET_2) resource, which allows you to retrieve all parameters within a specific category, we have added information regarding previous names and identifiers for:
* parameters
* dictionary parameter values

**What have we changed?**

In the mentioned resource, we have added the **“formerData”** field, in which we return new fields:
- at the parameter level:
- **ids** - previous parameter IDs
- **names** - previous parameter names
- at the dictionary parameter value level:
- **ids** - previous parameter value identifiers
- **values** - previous parameter value names

These new fields will only be returned if a different name or value previously existed for a given parameter or value. They will be available for at least one month following the implementation of the changes.

Sample response snippet for “Manufacturer code” parameter, which previously existed under a different name and ID:

```json5
{
"parameters": [
{
"id": "224017",
"name": "Manufacter Code",
"type": "string",
"formerData": {
"names": [ // previous parameter names
"MPN"
],
"ids": [ // previous parameter IDs
"240312"
]
}
}
]
}
```
>

Sample response snippet for the value “New” of the “Condition” parameter, which previously existed under different names:

```json5
{
"parameters": [
{
"id": "11323",
"name": "Condition",
"type": "dictionary",
"dictionary": [
{
"id": "11323_1",
"value": "New",
"formerData": {
"values": [ // previous parameter names
"Nowa",
"Nowe"
]
}
}
]
}
]
}
```
>

**Why are we introducing this change?**

We want to make it easier to maintain data consistency between your applications and Allegro. The new information regarding historical names and identifiers will allow you to automatically map parameters and values, which will minimize the risk of errors when listing offers and reduce the need for manual updates.