[NEWS] Serwisy zagraniczne Allegro - wdrożenie zmian w ofercie na Sandbox (etap II) / Allegro foreign marketplaces - implementation of changes to offer on the Sandbox (step II)

Uruchomienie czeskiego serwisu zagranicznego planujemy **na początek maja 2023**, dlatego tak ważne jest by Wasze aplikacje były przygotowane do zmian jakie wprowadzamy. 6 lutego [informowaliśmy](https://developer.allegro.pl/news/serwisy-zagraniczne-allegro-wdrozenie-zmian-w-ofercie-na-sandbox-E7EX4nw50U0) o I etapie zmian w ofercie w kontekście zagranicznych serwisów Allegro. Dziś wdrożyliśmy II etap zmian na Sandbox (dotyczy tylko API).

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

- [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 oferty 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 oferty,
- [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,
- GET /marketplaces - pobierz informacje o serwisach dodatkowych.

Nowy zasób GET /marketplaces wymaga "Content-Type": "**application/vnd.allegro.public.v1+json**", pozostałe "Content-Type": "**application/vnd.allegro.beta.v1+json**" (wersja beta służy tylko do testowania na Sandbox).

### Jakie zmiany wprowadziliśmy?

Po dzisiejszym wdrożeniu drugiego etapu na środowisku Sandbox 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.

Oferta będzie widoczna **tylko** w serwisie bazowym na **allegro.pl.allegrosandbox.pl**.

W obu etapach dodaliśmy:

- nowe pola (wdrożone 6.02.2023):
- **publication.marketplaces.base** - serwis bazowy oferty,
- **publication.marketplaces.additional** - serwis dodatkowy oferty.
- nową sekcję **additionalMarketplaces.{marketplaceId}**, z polami (wdrożone dziś):
- **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 (wdrożone 6.02.2023).

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. Znajdziecie tam **harmonogram** - stworzony specjalnie dla Was, byście mogli zaplanować swoje prace. Wszelkie dane będziemy aktualizować na bieżąco. Konkretne daty mogą ulec drobnym korektom.

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

----

We plan to launch the Czech foreign marketplaces **at the beginning of May 2023**, so it is important that your applications are prepared for the changes we are making. On February 6, 2023 we [informed](https://developer.allegro.pl/news/allegro-foreign-services-implementation-of-changes-to-offer-on-the-sandbox-wwzbAoB5xC7) you about Step I of the changes to the offer in the context of the foreign Allegro marketplaces. Today we have implemented Step II of the changes on Sandbox (applies only to the API).

### What resources are affected by the implementation on the Sandbox?

- [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,
- GET /marketplaces - get information about additional marketplaces.

The new GET /marketplaces resource will require "Content-Type:**application/vnd.allegro.public.v1+json**", the others "Content-Type:**application/vnd.allegro.beta.v1+json**" (the beta version is only for Sandbox).

### What will we change?

After today's implementation of the second step on the Sandbox environment, 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 desire for visibility of the offer in the additional marketplace service,
- you will specify the price and currency for the additional marketplaces,
- you will check whether the offer has qualified for display in the additional marketplace.

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

In both steps we added:
- new fields (implemented on February 6, 2023):
- **publication.marketplaces.base** - base marketplace,
- **publication.marketplaces.additiona**l - additional marketplaces.
- section **additionalMarketplaces.{marketplaceId}**, with fields (implemented today):
- **publication.state** - offer visibility status,
- **sellingMode.price** - price declaration in the currency appropriate for the additional marketplace.
- new endpoint **GET /marketplaces**, you will get with it, among other things, information on available additional marketplaces (implemented on February 6, 2023).

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. There is **a schedule** - created especially for you so that you can plan your work. We will update all data on a regular basis. Specific dates may be subject to minor adjustments.

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