[NEWS] Allegro Ceny - umożliwimy zarządzanie zgodą na uczestnictwo oferty na wybranym rynku / Allegro Prices - we will make it possible to manage the program participation consent for a single offer on a selected market

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 w programie Allegro Ceny obejmowała wszystkie serwisy, w których oferta jest widoczna - zarówno serwis bazowy, jak i serwisy zagraniczne.

Od **4 października 2023** umożliwimy zarządzanie zgodą na uczestnictwo oferty w Allegro Ceny na wybranych przez sprzedającego rynkach.

**Jakich zasobów dotyczy zmiana?**

* [GET /sale/allegro-prices-offer-consents/{offerId}](https://developer.allegro.pl/documentation/#operation/getAllegroPricesConsentForOffer),
* [PUT /sale/allegro-prices-offer-consents/{offerId}](https://developer.allegro.pl/documentation/#operation/updateAllegroPricesConsentForOffer).

**Jakie zmiany wprowadzimy?**

Dla [PUT /sale/allegro-prices-offer-consents/{offerId}](https://developer.allegro.pl/documentation/#operation/updateAllegroPricesConsentForOffer):

* w dotychczasowym polu “**status**” przekażesz status zgody **tylko** dla serwisu bazowego oferty;
* 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-offer-consents/13141516171’ \
-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 oferty
"additionalMarketplaces": { - status zgody dla serwisów dodatkowych
"allegro-cz": {
"status": "ALLOWED"
},
"allegro-xy": {
"status": "DENIED"
}
}
}'
```
>

Dla [GET /sale/allegro-prices-offer-consents/{offerId}](https://developer.allegro.pl/documentation/#operation/getAllegroPricesConsentForOffer):

* zwrócimy statusy zgód dla wszystkich dostępnych rynków:
* w polu “**status**” - dla serwisu bazowego,
* w polu “**additionalMarketplaces**” - dla serwisów dodatkowych.

**Przykładowy response:**

```json5
{
"status": "ALLOWED", - status zgody dla serwisu bazowego oferty
"additionalMarketplaces": { - status zgody dla serwisów dodatkowych
"allegro-cz": {
"status": "ALLOWED"
},
"allegro-xy": {
"status": "DENIED"
}
}
}
```
>

**Dlaczego wprowadzamy zmianę?**

Dzięki zmianie sprzedający mogą decydować, na którym rynku chcą wykluczyć lub ponownie dołączyć ofertę do 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/pomoc/dla-sprzedajacych/abc-sprzedazy/poznaj-allegro-ceny-na-czym-polega-program-wsparcia-dla-sprzedajacych-MR45D5zADiy#co-zrobic-aby-twoja-oferta-trafila-do-programu).

**How has it worked so far?**

Until now, the consent to participate in the Allegro Prices program covered all marketplaces where the offer is visible - both the base marketplace and foreign marketplaces.

From **October 4, 2023**, we will make it possible to manage the Allegro Prices program participation consent for a single offer on the selected markets by the seller.

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

* [GET /sale/allegro-prices-offer-consents/{offerId}](https://developer.allegro.pl/documentation/#operation/getAllegroPricesConsentForOffer),
* [PUT /sale/allegro-prices-offer-consents/{offerId}](https://developer.allegro.pl/documentation/#operation/updateAllegroPricesConsentForOffer).

**What changes will we make?**

For [PUT /sale/allegro-prices-offer-consents/{offerId}](https://developer.allegro.pl/documentation/#operation/updateAllegroPricesConsentForOffer):

* in the existing “**status**” field, you will pass on the status of the consent for the offer base marketplace **only**;
* the “**status**” field will become optional;
* we will add a new field “**additionalMarketplaces**” 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 passed in a request.

**Sample request:**

```json5
curl -X PUT \
'https://api.allegro.pl/sale/allegro-prices-offer-consents/13141516171’ \
-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 offer base marketplace
"additionalMarketplaces": { - consent status for offer additional marketplaces
"allegro-cz": {
"status": "ALLOWED"
},
"allegro-xy": {
"status": "DENIED"
}
}
}'
```
>

For [GET /sale/allegro-prices-offer-consents/{offerId}](https://developer.allegro.pl/documentation/#operation/getAllegroPricesConsentForOffer):

* we will return the consent statuses for all available marketplaces:
* in the field “**status**” - for base marketplace,
* in the field “**additionalMarketplaces**” - for additional marketplaces.

**Sample response:**

```json5
{
"status": "ALLOWED", - consent status for offer base marketplace
"additionalMarketplaces": { - consent status for offer additional marketplaces
"allegro-cz": {
"status": "ALLOWED"
},
"allegro-xy": {
"status": "DENIED"
}
}
}
```
>

**Why we are making the change?**

Thanks to the change, sellers can decide on which market they want to exclude or rejoin an offer to the Allegro Prices program.

You can read more about managing participation consents within 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).