[NEWS] Gotowość integracji na uruchomienie zagranicznych serwisów Allegro / Integration readiness for the launch of foreign Allegro marketplaces

W związku z międzynarodową ekspansją Allegro [wdrażamy wiele zmian w naszym API](https://developer.allegro.pl/tutorials/wystawianie-i-zarzadzanie-oferta-w-serwisach-zagranicznych-wwzjP4M8gTZ). Chcemy, byście mogli po swojej stronie zaplanować prace i byli na nie gotowi w chwili, gdy uruchomimy serwisy zagraniczne. Już **w kwietniu** nasi sprzedający będą mogli testować nowe narzędzia na stronie allegro.pl do zarządzania widocznością oferty w czeskim serwisie. Samo uruchomienie czeskiego serwisu zagranicznego **planujemy na początek maja 2023**. Gotowość aplikacji jest ważna, bo wraz ze startem nowej domeny, oferty, które w tym czasie będą się kwalifikowały na rynek czeski, będą tam wyświetlane - dlatego sugerujemy, aby aplikacja była odpowiednio przygotowana, by móc nimi zarządzać.

### Co zmienimy?

1. W chwili startu nowej domeny, oferty, które kwalifikują się do wyświetlania w czeskim serwisie będą miały **automatycznie oznaczoną chęć widoczności w serwisie dodatkowym allegro-cz**

```
"publication": {
"marketplaces": {
"additional": [
{
"id": "allegro-cz"
}
]
}
},
```

oraz **automatycznie przeliczone ceny**

```
"additionalMarketplaces": {
"allegro-cz": {
"publication": {
"state": "APPROVED"
},
"sellingMode": {
"price": {
"amount": "629.65",
"currency": "CZK"
}
}
}
}
```

Cena będzie automatycznie przeliczana w danej ofercie, do czasu manualnej modyfikacji ceny w serwisie dodatkowym. Przeliczanie będzie można włączyć/wyłączyć w panelu allegro na stronie WWW.

2. Kwoty i waluta w zamówieniu z dodatkowego serwisu będą zwracane w walucie odpowiedniej dla serwisu np. dla Czech będzie to “CZK”.

### Dlaczego wprowadzenie zmian jest ważne?

Jeśli nie przygotujesz swojej aplikacji na zmiany w API to klient, którego oferty są widoczne w serwisie dodatkowym, nie będzie mógł zarządzać swoimi ofertami z poziomu Twojej aplikacji. W szczególności:

- nie zobaczy ceny i waluty dla serwisu dodatkowego w ofercie, ale także jej nie poda i nie zmieni (jeśli oferta nie była zakwalifikowana przy starcie)
- nie dostanie informacji o tym, czy i która oferta jest wyświetlana w dodatkowym serwisie,
- nie będzie wiedział jaki jest status kwalifikacji oferty (chęć widoczności oferty na dodatkowym rynku będzie mógł zaznaczyć również przez panel Allegro),
- nie będzie mógł zmienić decyzji czy oferta ma być wyświetlana w dodatkowym serwisie czy nie,
- nie zmieni ceny produktu (chyba, że będzie działało automatyczne przeliczanie, ale informacji o tym czy dana oferta się przelicza nie ma w API),
- nie dostanie informacji z jakiego rynku jest zamówienie,
- zwracane zamówienia z kwotami w walucie “CZK” mogą nie być wyświetlane poprawnie (zależy od działania danej aplikacji)
- nie będzie mógł oznaczyć chęci widoczności dla innych swoich ofert (jeśli nie była zakwalifikowana przy starcie).

Zachęcamy do odwiedzenia [**dedykowanej strony**](https://developer.allegro.pl/tutorials/wystawianie-i-zarzadzanie-oferta-w-serwisach-zagranicznych-wwzjP4M8gTZ), gdzie opisaliśmy szczegółowe informacje dotyczące zmian w naszym API 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.

------

Due to the international expansion of Allegro, we are [implementing many changes in our API](https://developer.allegro.pl/tutorials/listing-and-managing-offers-on-foreign-marketplaces-7GndGjeAATn). We want you to be able to plan the work on your side and be ready for it when we launch foreign marketplaces. **At the beginning of April**, our sellers will be able to test new tools on allegro.pl to manage the visibility of their offers on the Czech . We plan to launch the Czech foreign service itself **at the beginning of May 2023**. The readiness of the application is important, because with the launch of the new domain, the offers that qualify for the Czech marketplaces at that time will be visible there - so we suggest that the application be properly prepared to manage them.

### What will we change?

1. At the start of the new domain, the offers that qualify for visibility in the Czech marketplace **will be automatically marked with declared visibility in the additional marketplace allegro-cz**

```
"publication": {
"marketplaces": {
"additional": [
{
"id": "allegro-cz"
}
]
}
},

```
and **we will automatically recalculated prices**

```
"additionalMarketplaces": {
"allegro-cz": {
"publication": {
"state": "APPROVED"
},
"sellingMode": {
"price": {
"amount": "629.65",
"currency": "CZK".
}
}
}
}
```
The price will be automatically converted in a given offer until the price is manually modified in the additional marketplace. The conversion will be possible to enable/disable in the My assortment tab on the Allegro website.

2. Amounts and currency in an order from an additional marketplace will be returned in the currency appropriate to the marketplace, e.g. for the Czech Republic it will be "CZK".

### Why is it important to make changes?

If you do not prepare your application for the API changes then the customer whose offers are visible in the additional marketplace will not be able to manage their offers from your application. In particular:
- they will not see the price and currency for the additional marketplace service in the offer, but they also won't specify it and change it (if the offer wasn't qualified at launch).
- they will not get information about whether and which offer is visible in the additional marketplace,
- they won't know what the qualification status of the offer is (the desire for the offer to be visible on the additional marketplace will also be possible to indicate via the Allegro panel),
- they will not be able to change the decision whether the offer is to be visible in the additional marketplace or not,
- they will not change the price of the product (unless automatic recalculation works, but the information about whether an offer recalculates is not in the API),
- they will not get information from which market the order is from,
- returned orders with amounts in the currency "CZK" may not be visible correctly (depends on the operation of the application)
- they will not be able to mark the desire to be visible to their other offers (if it was not qualified at launch).

We encourage you to visit the [**dedicated page**](https://developer.allegro.pl/tutorials/listing-and-managing-offers-on-foreign-marketplaces-7GndGjeAATn), where we described detailed information about the changes to our API in terms of Allegro foreign marketplaces. There you will find **a schedule** - created especially for you to plan your work. We will update all data on a regular basis. Specific dates may be subject to minor adjustments.