[NEWS] Serwisy zagraniczne Allegro - wdrożyliśmy zmiany w ofercie na produkcji / Allegro foreign marketplaces - we have implemented changes in offer on the production

Od **dziś**, **12.04.2023** nasi sprzedający mogą korzystać z nowych narzędzi na stronie **allegro.pl** do zarządzania widocznością oferty w czeskim serwisie. Oferty, które kwalifikują się na rynek czeski, odpowiednio oznaczyliśmy w zakładce [Mój asortyment](https://allegro.pl/moje-allegro/sprzedaz/obsluga-ofert/moj-asortyment). Sprzedający mogą je dostosować do swoich potrzeb, aby być gotowym na uruchomienie czeskiego serwisu **w maju 2023**.

### W związku z tym wdrożyliśmy:

- zmiany w ofercie, które do tej pory były dostępne tylko na Sandbox,
- grupową edycję zmiany chęci widoczności oferty w serwisach dodatkowych,
- grupową zmianę ceny w serwisach dodatkowych,
- do listy ofert statystyki odwiedzin i obserwowanych oraz liczbę sprzedanych produktów w ciągu 30 dni dla serwisów dodatkowych.

### Jakich zasobów dotyczy wdrożenie?

- [POST /sale/product-offers](https://developer.allegro.pl/documentation/#operation/createProductOffers) - wystaw ofertę z produktem w jednym requeście,
- [PATCH /sale/product-offers/{offerId}](https://developer.allegro.pl/documentation/#operation/editProductOffers) - edytuj ofertę z produktem,
- [GET /sale/product-offers/{offerId}](https://developer.allegro.pl/documentation/#operation/getProductOffer) - pobierz ofertę z produktem,
- [POST /sale/offers](https://developer.allegro.pl/documentation/#operation/createOfferUsingPOST) - dodaj szkic oferty,
- [PUT /sale/offers/{offerId}](https://developer.allegro.pl/documentation/#operation/updateOfferUsingPUT) - uzupełnij szkic lub edytuj ofertę,
- [GET /sale/offers/{offerId}](https://developer.allegro.pl/documentation/#operation/getOfferUsingGET) - pobierz dane szczegółowe oferty,
- [GET /sale/offers](https://developer.allegro.pl/documentation/#operation/searchOffersUsingGET) - pobierz listę ofert,
- [PUT /sale/offer-modification-commands/{commandId}](https://developer.allegro.pl/documentation/#operation/modificationCommandUsingPUT) - edytuj wiele ofert jednocześnie,
- [PUT /sale/offer-price-change-commands/{commandId}](https://developer.allegro.pl/documentation/#operation/priceModificationCommandUsingPUT) - edytuj cenę w wielu ofertach jednocześnie,
- [GET /marketplaces](https://developer.allegro.pl/documentation#operation/marketplacesGET) - pobierz informacje o serwisach dodatkowych.

Wszystkie zasoby na produkcji oraz środowisku testowym Sandbox obsłużysz z nagłówkiem “Content-Type”: “**application/vnd.allegro.public.v1+json**”.

### Jakie zmiany wprowadziliśmy?

Po tym wdrożeniu możesz przejść proces widoczności oferty w serwisach dodatkowych, czyli:

- zobaczysz informacje dotyczące serwisu bazowego i serwisów dodatkowych,
- zadeklarujesz chęć widoczności oferty w serwisie dodatkowym,
- określisz cenę i walutę dla serwisu dodatkowego,
- sprawdzisz, czy oferta zakwalifikowała się do wyświetlenia w dodatkowym serwisie.

Do momentu uruchomienia czeskiego serwisu oferta będzie widoczna **tylko** w serwisie bazowym na **allegro.pl**.

Wdrożyliśmy:
- nowe pola:
- **publication.marketplaces.base** - serwis bazowy oferty,
- **publication.marketplaces.additional** - serwis dodatkowy oferty.
- nową sekcję **additionalMarketplaces.{marketplaceId}**, z polami:
- **publication.state** - status widoczności oferty,
- **sellingMode.price** - deklaracja ceny w walucie odpowiedniej dla serwisu dodatkowego.
- nowy endpoint **GET /marketplaces**, dzięki któremu pobierzesz m.in. informacje o dostępnych serwisach dodatkowych.
- dodaliśmy możliwość grupowej edycji chęci widoczności w serwisach dodatkowych.
- dodaliśmy pole **marketplaceId** dla grupowej edycji ceny.
- dla [**GET /sale/offers**](https://developer.allegro.pl/documentation/#operation/searchOffersUsingGET) dla danego serwisu dodatkowego zwrócimy statystyki:
- **additionalMarketplaces.{marketplaceId}.stats.visitsCount** - liczba odwiedzin,
- **additionalMarketplaces.{marketplaceId}.stats.watchersCount** - liczba obserwujących użytkowników,
- oraz liczbę sprzedanych przedmiotów w ofercie z ostatnich 30 dni w polu **additionalMarketplaces.{marketplaceId}stock.sold**.
- “**Content-Type”: “application/vnd.allegro.beta.v1+json**” na środowisku testowym Sandbox dla [zmian w ofercie dla serwisów zagranicznych Allegro](https://developer.allegro.pl/news/serwisy-zagraniczne-allegro-wdrozenie-zmian-w-ofercie-na-sandbox-etap-ii-4Rnj5Eg4wuM) **nie będzie już dostępny**. Skorzystaj z “Content-Type”: “**application/vnd.allegro.public.v1+json**”, aby testować zmiany.

Zachęcamy do odwiedzenia [**dedykowanej strony**](https://developer.allegro.pl/tutorials/wystawianie-i-zarzadzanie-oferta-w-serwisach-zagranicznych-wwzjP4M8gTZ), na której znajdziecie szczegółowe informacje dotyczące zmian w API Allegro pod kątem serwisów zagranicznych Allegro.

Jeśli macie pytania, zapraszamy na nasze [forum GitHub](https://github.com/allegro/allegro-api/issues).

---

**From today, April 12, 2023**, our sellers can use new tools on **allegro.pl** to manage the visibility of their offers on the Czech marketplace. Offers that qualify for the Czech marketplace are already marked accordingly in the [My Assortment](https://allegro.pl/moje-allegro/sprzedaz/obsluga-ofert/moj-asortyment) tab. Sellers can customize them to be ready for the launch of the Czech marketplace in **May 2023**.

### Therefore, we have implemented:

- changes in the offer, which until now were only available on the Sandbox
- batch offer visibility change in additional marketplaces,
- batch price change in additional marketplaces,
- statistics with the number of visits and watchers to the list of offers and the number of items sold in the offer from the last 30 days.

### What resources are affected by the implementation?

- [POST /sale/product-offers](https://developer.allegro.pl/documentation/#operation/createProductOffers) - create offer based on product,
- [PATCH /sale/product-offers/{offerId}](https://developer.allegro.pl/documentation/#operation/editProductOffers) - edit an offer with product,
- [GET /sale/product-offers/{offerId}](https://developer.allegro.pl/documentation/#operation/getProductOffer) - get all data of the particular product-offer,
- [POST /sale/offers](https://developer.allegro.pl/documentation/#operation/createOfferUsingPOST) - create a draft offer,
- [PUT /sale/offers/{offerId}](https://developer.allegro.pl/documentation/#operation/createOfferUsingPOST) - complete a draft offer or edit an offer,
- [GET /sale/offers/{offerId}](https://developer.allegro.pl/documentation/#operation/getOfferUsingGET) - get all fields of the particular offer,
- [GET /sale/offers](https://developer.allegro.pl/documentation/#operation/searchOffersUsingGET) - get seller's offers,
- [PUT /sale/offer-modification-commands/{commandId}](https://developer.allegro.pl/documentation/#operation/modificationCommandUsingPUT) - batch offer modification,
- [PUT /sale/offer-price-change-commands/{commandId}](https://developer.allegro.pl/documentation/#operation/priceModificationCommandUsingPUT) - batch offer price modification,
- [GET /marketplaces](https://developer.allegro.pl/documentation#operation/marketplacesGET) - get information about additional marketplaces.

You can handle all resources in the production and Sandbox test environment with the “Content-Type” header with “**application/vnd.allegro.public.v1+json**” value.

### What changes have we made?

After today's implementation you can go through the process of visibility of the offer in additional marketplaces, that is:

- you will see information about the base marketplace and additional marketplaces,
- you will declare your intention for visibility of the offer in the additional marketplace,
- you will specify the price and currency for the additional marketplaces,
- you will check whether the offer has qualified to be displayed in the additional marketplace.

The offer will be visible only in the base **allegro.pl** marketplace.

We have added:

- new fields:
- **publication.marketplaces.base** - base marketplace,
- **publication.marketplaces.additional** - additional marketplaces.
- section additionalMarketplaces.{marketplaceId}, with fields:
- **publication.state** - offer visibility status,
- **sellingMode.price** - price declaration in the currency appropriate for the additional marketplace.
- new **GET /marketplaces** endpoint, thanks to which you will get, among other things, information on available additional marketplaces.
- we added the possibility to edit visibility in additional marketplaces in groups.
- we added the **marketplaceId** field for group price editing.
- for a **GET /sale/offers** resource, we will return statistics for a given additional marketplace:
- **additionalMarketplaces.{marketplaceId}.stats.visitsCount** - number of visitors,
- **additionalMarketplaces.{marketplaceId}.stats.watchersCount** number of watchers,
- and the number of sold items in the offer from the last 30 days in the **additionalMarketplaces.{marketplaceId}stock.sold** field.
- "Content-Type": "**application/vnd.allegro.beta.v1+json**" on the Sandbox test environment for changes to the offer for foreign marketplaces Allegro **will not be available**. Use "Content-Type": "**application/vnd.allegro.public.v1+json"** to test the changes.

We encourage you to visit the [**dedicated page**](https://developer.allegro.pl/tutorials/listing-and-managing-offers-on-foreign-marketplaces-7GndGjeAATn), where you can find more details about the changes to the Allegro API in terms of the foreign Allegro marketplaces.

If you have questions, please visit our [GitHub forum](https://github.com/allegro/allegro-api/issues).