[NEWS] Allegro Ceny - umożliwimy zarządzanie zgodą na uczestnictwo konta w programie na wybranym rynku / Allegro Prices - manage your account's consent to participate in the program in the selected marketplace

Allegro Ceny to program wsparcia, który pomaga sprzedającym zaoferować najlepsze ceny na rynku bez ponoszenia żadnych dodatkowych kosztów uczestnictwa. Więcej szczegółów na ten temat znajdziesz na [stronie dla sprzedających](https://allegro.pl/pomoc/dla-sprzedajacych/abc-sprzedazy/poznaj-allegro-ceny-na-czym-polega-program-wsparcia-dla-sprzedajacych-MR45D5zADiy#co-zrobic-aby-twoja-oferta-trafila-do-programu).

**Jak to działało do tej pory?**

Dotychczas, zgoda na uczestnictwo konta w programie Allegro Ceny obejmowała wszystkie serwisy - zarówno serwis bazowy, jak i serwisy dodatkowe.

Od **20 lutego 2024** umożliwimy zarządzanie zgodą na uczestnictwo konta w Allegro Ceny na wybranych przez sprzedającego rynkach.

**Jakich zasobów dotyczy zmiana?**

* [GET /sale/allegro-prices-account-eligibility](https://developer.allegro.pl/documentation/#operation/getAllegroPricesEligibilityForAccount),
* [PUT /sale/allegro-prices-account-consent](https://developer.allegro.pl/documentation/#operation/updateAllegroPricesConsentForAccount).

**Jakie zmiany wprowadzimy?**

Dla [PUT /sale/allegro-prices-account-consent](https://developer.allegro.pl/documentation/#operation/updateAllegroPricesConsentForAccount):

* w dotychczasowym polu “**status**” przekażesz status zgody **tylko** dla serwisu bazowego;
* pole “**status**” stanie się opcjonalne;
* dodamy nowe pole “**additionalMarketplaces**”, w którym określisz status zgody dla serwisów dodatkowych;
* jeżeli przekażesz pole “**additionalMarketplaces**” to musisz określić w nim status zgody dla minimum jednego serwisu dodatkowego;
* jedno z pól - “**status**” lub “**additionalMarketplaces**” musisz zawsze przekazać w wywołaniu.

**Przykładowy request:**

```json5
curl -X PUT \
'https://api.allegro.pl/sale/allegro-prices-account-consent’ \
-H 'Authorization: Bearer {token}' \
-H 'Accept: application/vnd.allegro.public.v1+json' \
-H 'Content-Type: application/vnd.allegro.public.v1+json' \
-d '{
"status": "ALLOWED", - status zgody dla serwisu bazowego
"additionalMarketplaces": { - status zgody dla serwisów dodatkowych
"allegro-cz": {
"status": "ALLOWED"
},
"allegro-xy": {
"status": "DENIED"
}
}
}'
```
>

Dla [GET /sale/allegro-prices-account-eligibility](https://developer.allegro.pl/documentation/#operation/getAllegroPricesEligibilityForAccount) zwrócimy:

* statusy zgód:
* w polu “**consent**” - dla serwisu bazowego,
* w polu “**additionalMarketplaces.[].consent**” - dla serwisów dodatkowych,
* informację, czy konto kwalifikuje się do uczestnictwa w programie:
* w polu “**qualification.status**” - dla serwisu bazowego,
* w polu “**additionalMarketplaces.[].qualification.status**” - dla serwisów dodatkowych.

**Przykładowy response:**

```json5
{
"consent": "ALLOWED", - status zgody dla serwisu bazowego
"qualification": {
"status": "QUALIFIED" - informacja, czy konto kwalifikuje się do programu
},
"additionalMarketplaces": { - status zgody dla serwisów dodatkowych
"allegro-cz": {
"consent": "ALLOWED",
"qualification": {
"status": "QUALIFIED"
}
},
"allegro-xy": {
"consent": "DENIED",
"qualification": {
"status": "DISQUALIFIED"
}
}
}
}
```
>

**Dlaczego wprowadzamy zmianę?**

Dzięki zmianie sprzedający mogą decydować o rynkach, na których chcą, aby ich konto uczestniczyło w programie Allegro Ceny.

Więcej o zarządzaniu uczestnictwem w ramach Allegro Ceny przeczytasz w [naszym poradniku](https://developer.allegro.pl/tutorials/jak-przypisac-oferte-kampanii-GRaj0q6Gwuy#allegro-ceny-jak-zarzadzac-zgodami-na-uczestnictwo-w-programie).

-----
Allegro Prices is a sellers support program that will help them to offer the best prices on the market - at no extra cost. You can find more information about this program on our [sellers page](https://allegro.pl/help/for-sellers/sellers-abcs/allegro-prices-the-support-program-for-the-sellers-Ag9A132M0Sm#co-zrobic-aby-twoja-oferta-trafila-do-programu).

**How has it worked so far?**

Until now, the consent of an account's participation in the Allegro Pricing program covered all marketplaces - both the base marketplace and additional marketplaces.

As of **February 20, 2024**, we will make it possible to manage the consent of the account to participate in Allegro Prices in the marketplaces selected by the seller.

**Which resources are affected by the change?**

* [GET /sale/allegro-prices-account-eligibility](https://developer.allegro.pl/documentation/#operation/getAllegroPricesEligibilityForAccount),
* [PUT /sale/allegro-prices-account-consent](https://developer.allegro.pl/documentation/#operation/updateAllegroPricesConsentForAccount).

**What changes will we make?**

For [PUT /sale/allegro-prices-account-consent](https://developer.allegro.pl/documentation/#operation/updateAllegroPricesConsentForAccount):

* in the existing "**status**" field, you will pass on the status of the consent for base marketplace **only**;
* the “**status**” field will become optional;
* we will add a new field “**additionalMarketplace**” in which you will specify the consent status for additional marketplaces;
* if you provide the "**additionalMarketplaces**" field, you must specify the consent status for a minimum of one additional service in this field;
* one of the fields, "**status**" or "**additionalMarketplaces**", must always be defined in a request.

**Sample request:**

```json5
curl -X PUT \
'https://api.allegro.pl/sale/allegro-prices-account-consent’ \
-H 'Authorization: Bearer {token}' \
-H 'Accept: application/vnd.allegro.public.v1+json' \
-H 'Content-Type: application/vnd.allegro.public.v1+json' \
-d '{
"status": "ALLOWED", - consent status for base marketplace
"additionalMarketplaces": { - consent status for additional marketplaces
"allegro-cz": {
"status": "ALLOWED"
},
"allegro-xy": {
"status": "DENIED"
}
}
}'
```
>

For [GET /sale/allegro-prices-account-eligibility](https://developer.allegro.pl/documentation/#operation/getAllegroPricesEligibilityForAccount) we will return:

* consent statuses:
* in the field “**consent**” - for the base marketplace,
* in the field “**additionalMarketplaces.[].consent**” - for additional marketplaces,
* information on whether the account is eligible to participate in the program:
* in the field “**qualification.status**” - for the base marketplace,
* in the field “**additionalMarketplaces.[].qualification.status**” - for additional marketplaces.

**Sample response:**

```json5
{
"consent": "ALLOWED", - consent status for base marketplace
"qualification": {
"status": "QUALIFIED" - information on whether the account is eligible
}, to participate in the program
"additionalMarketplaces": { - consent status for additional marketplaces
"allegro-cz": {
"consent": "ALLOWED",
"qualification": {
"status": "QUALIFIED"
}
},
"allegro-xy": {
"consent": "DENIED",
"qualification": {
"status": "DISQUALIFIED"
}
}
}
}
```
>

**Why we are making the change?**

Thanks to the change, sellers can decide which markets they want their account to participate in the Allegro Prices program.

You can read more about managing Allegro Prices in [our guide](https://developer.allegro.pl/tutorials/how-to-submit-offers-to-campaigns-AgGjd6EmyH4#allegro-prices-how-to-manage-program-participation-consents).