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

[MartaNowaczyk]

W związku z międzynarodową ekspansją Allegro wdrażamy wiele zmian w naszym API. 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, 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. 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.

[dlis2010]

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.

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)

Rozumie, że wystarczy raz zmienić cenę w serwisie dodatkowym, a zostanie wyłączone wtedy automatyczne przeliczanie. Bez informacji w API o statusie automatycznego przeliczania będzie to problematyczne.

Przykładowo chcę zmienić cenę produktu o 1zł

• automatyczne przeliczanie włączone - zmieni się cena na wszystkich rynkach
• automatyczne przeliczanie wyłączone (bo np ktoś kiedyś zmienił cenę CZK w ofercie przez front) - zmieni się cena tylko na rynku pl.

Skąd mam wiedzieć czy wystarczy wysłać mi tylko zmianę ceny o 1zł czy od razy muszę sam przeliczyć i zmienić wszystkie ceny z dodatkowych rynków?

Dobrze rozumiem?

[MartaNowaczyk]

Tak, dobrze rozumiesz. Zmiana ceny na rynku dodatkowym wyłączy przeliczanie w tej ofercie. Nie będziesz tego wiedział po API, bo w ofercie nie zwracamy takiej informacji. W integracji warto zatem korzystać z zasady, że zawsze trzeba podać cenę dla serwisu dodatkowego, albo dać możliwość wprowadzenia przelicznika do automatycznego ustawiania tej ceny. Zachęcam do dodania sugestii w zakładce Discussions na dodanie takiej informacji.

[dlis2010]

Brzmi jak bubel ;)

Czyli chcąc zmienić cenę w ofercie musze najpierw pobrać w jakich serwisach dodatkowych jest widoczna, a potem wysłać zapytanie z zmianą ceny (przeliczając sobie ceny per serwis dodatkowy)

[MartaNowaczyk]

Rozwiązanie to pomoże naszym sprzedającym przygotować się do uruchomienia serwisów zagranicznych. Jak wiadomo nie każdy korzysta z zewnętrznych narzędzi. Jeśli aplikacja będzie przygotowana do zmian, to powinna te wszystkie informacje mieć po swojej stronie. Udostępniamy zdarzenie o zmianach widoczności oferty "OFFER_VISIBILITY_CHANGED", co pozwoli na śledzenie/aktualizację statusów widoczności. Ten pierwszy moment by mieć wszystkie dane o ofertach będzie kluczowy.

[hahyes]

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

@MartaNowaczyk Podejrzewam, jak to wygląda ale lepiej dopytać: co to znaczy "kwalifikują się"? Czyli jeżeli mam zbiór ofert wystawianych dotychczasowo normalnie, tylko po polsku, to mogą się zakwalifikować do czeskiego Allegro bez mojej ingerencji tj. ingerencji integracji? Chcąc wystawiać tylko na polskim Allegro, jak powinno wyglądać zapytanie i pola opisane powyżej? Przepraszam, jeśli to może trochę dziwne pytanie ale naprawdę wolę dopytać. ;)

[MartaNowaczyk]

@hahyes tak, mogą się zakwalifikować bez ingerencji integracji. W kwestii struktury oferty nic się nie zmieni, po API wysyłasz starą strukturę. Pola te pojawią się dopiero po wdrożeniu zmiany w API.