Wraz z międzynarodową ekspansją Allegro i postępującą integracją z Grupą MALL, przygotowujemy się do uruchomienia zintegrowanej domeny w Czechach. Start planowany jest na przyszły rok. W związku z tym konieczne będą zmiany w API Allegro, które wprowadzimy od 01.03.2023. Chcemy, abyście byli na nie przygotowani, dlatego będziemy Was informować o kolejnych etapach prac.

Na tym etapie przedstawiamy zmiany w zasobach dotyczących ofert. Sprzedający będzie mógł zadeklarować chęć, aby jego oferta była widoczna również w zagranicznych domenach serwisu Allegro.

Wprowadzimy nowe oznaczenia:

1. Serwis bazowy - czyli serwis przypisany do kraju, w którym sprzedający się zarejestrował. W tym momencie dla sprzedającego jest to serwis allegro.pl (allegro-pl). Po uruchomieniu serwisu w Czechach (allegro-cz), będzie on drugim dopuszczalnym serwisem bazowym dla sprzedających.

   Reguły:

   • serwis bazowy oferty będzie nadawany automatycznie na podstawie danych konta sprzedającego,
   • aktywna oferta zawsze będzie widoczna w jej serwisie bazowym,
   • walidacja oferty podczas jej aktywacji, domyślnie dotyczy jej serwisu bazowego.

2. Serwis dodatkowy - to pozostałe serwisy Allegro, na których będzie można sprzedawać produkty. W tym momencie, dla sprzedających, dla których serwisem bazowym jest allegro-pl, będzie to serwis allegro-cz. Analogicznie, serwisem dodatkowym dla serwisu bazowego allegro-cz, będzie serwis allegro-pl oraz inne serwisy Allegro, które uruchomimy w przyszłości.

   Serwis dodatkowy allegro-cz sprzedający wybierze tylko dla ofert, które:

   • są wystawione przez zweryfikowane konto firmowe,
   • są oferowane tylko jako Kup Teraz,
   • nie są ofertą charytatywną,
   • nie są ofertą B2B.

   Oferty muszą przejść dodatkowy proces kwalifikacji, zanim będą wyświetlone w serwisie dodatkowym. Uruchomimy go:

   • podczas aktywacji oferty,
   • podczas edycji oferty,
   • dla aktywnej już oferty, dla której dodasz chęć widoczności oferty w serwisie dodatkowym.

   Sprawdzimy, czy oferta (warunki mogą ulec zmianie):

   • ma co najmniej jedną metodę dostawy prawidłową dla serwisu allegro-cz,
   • ma cenę w walucie CZK,
   • ma tłumaczenie na język czeski,
   • znajduje się w kategorii asortymentowej, dla której istnieje odpowiednia kategoria w serwisie allegro-cz.

Zmianę planujemy udostępnić na Sandbox na początku 2023. O jej wprowadzeniu poinformujemy w oddzielnym komunikacie.

Jakich zasobów dotyczy zmiana?

• POST /sale/product-offers - wystaw ofertę z produktem w jednym requeście,
• PATCH /sale/product-offers/{offerId} - edytuj oferty z produktem,
• GET /sale/product-offers/{offerId} - pobierz ofertę z produktem,
• POST /sale/offers - dodaj szkic oferty,
• PUT /sale/offers/{offerId} - uzupełnij szkic oferty,
• GET /sale/offers/{offerId} - pobierz dane szczegółowe oferty.

Planujemy także zmiany dla GET /sale/offers. Szczegółami podzielimy się w oddzielnym komunikacie.

Co zmienimy?

1. Dodamy nowe pole "publication.marketplaces.base", które określa serwis bazowy oferty. Wartość w polu nadajemy automatycznie w momencie stworzenia oferty i jest tylko do odczytu, nigdy się nie zmieni.

   { 
   …
    "publication": {
        "marketplaces": {
          "base": {
             "id": "allegro-pl"           - ID serwisu bazowego, w którym oferta będzie widoczna -
                                            pobierzesz je za pomocą GET /marketplaces
   }
        }
    },
    …
   }

2. Dodamy nowe pole "publication.marketplaces.additional", gdzie sprzedający będzie mógł określić, czy jego oferta ma być widoczna w serwisie dodatkowym. Pole to nie jest obowiązkowe. Brak tego pola zinterpretujemy jako pustą tablicę (oferta będzie widoczna tylko w jej serwisie bazowym).

   { 
   …
    "publication": {
        "marketplaces": {
          "additional": [
                 {
                 "id": "allegro-cz"          - ID serwisu dodatkowego, w którym oferta ma być widoczna -
                                               pobierzesz je za pomocą GET /marketplaces
                 }
          ]
        }
    },
    …
   }

3. Dodamy nowe pole "additionalMarketplaces", które zawiera wybrane informacje o ofercie w poszczególnych serwisach dodatkowych. Pole to nie zawiera informacji o serwisie bazowym oferty. Znajdziesz tu wszystkie dostępne serwisy. Nawet, jeśli sprzedający nie zaznaczy chęci widoczności oferty w serwisie dodatkowym, to zwrócimy go w odpowiedzi:

   a) pole "additionalMarketplaces.{marketplaceId}.publication.state" jest tylko do odczytu i zawiera informację o statusie widoczności oferty dla danego serwisu. Możliwe wartości dla tego pola:

   • "APPROVED" - oferta jest widoczna w danym serwisie dodatkowym, jeżeli jest aktywna,
   • "REFUSED" - oferta lub sprzedający nie spełniają warunków wymaganych do wyświetlenia oferty w danym serwisie dodatkowym,
   • "IN_PROGRESS" - trwa proces kwalifikacji oferty do widoczności w danym serwisie dodatkowym,
   • "NOT_REQUESTED" - sprzedający nie zaznaczył intencji widoczności w danym serwisie dodatkowym,

   b) pole "additionalMarketplaces.{marketplaceId}.sellingMode.price" określa cenę oferty dla wybranego serwisu dodatkowego. Cenę w tym polu sprzedający musi podać w walucie prawidłowej dla danego serwisu, co jest określone w konfiguracji dostępnej w zasobie GET /marketplaces.

   {
      …
    "additionalMarketplaces": {
        "allegro-cz": {
            "publication": {
                "state": "APPROVED"
            },
            "sellingMode": {
                "price": {
                    "amount": "629.65", 
                    "currency": "CZK" 
                }
            }
        },
                "allegro-xy": {             - przykładowy serwis dodatkowy, który na ten moment nie istnieje, 
                                              a jest podany dla zobrazowania sytuacji
            "publication": {
                "state": "NOT_REQUESTED"
            }
        }
    }
   …
   }

4. Dodamy nowy zasób GET /marketplaces do pobierania ID serwisów, w których sprzedający chciałby wyświetlić swoją ofertę. Znajdziesz tu również inne dane, które dotyczą konkretnego serwisu.

   Przykładowy response:

   {
   "marketplaces": [                     - lista dostępnych serwisów
    {
      "id": "allegro-pl",                - ID dostępnego serwisu
      "languages": {
         “offerCreation” : [             - języki, w jakich oferta może być utworzona
         {
              "code": "pl-PL"                           
            },
            {
               "code": "en-US"                
            }
        ],
       “offerDisplay”: [                  - języki, w jakich oferta może być wyświetlona kupującemu
    {
       “code”: “uk-UA”
    },
    {
       “code”: “en-US”
    },
    {
       “code”: “cs-CZ”
    }
        ]
      }
   
      "currencies": {                      - dostępne waluty
        "base": {
          "code": "PLN"                    - waluta bazowa dla danego serwisu
        },
        "additional": [                    - pozostałe waluty dostępne tylko dla kupującego
          {
            "code": "EUR"
          },
          {
            "code": "USD"
          }
        ]
      },
      "shippingCountries": [               - dostępne kraje dostawy dla danego serwisu 
        {
          "code": "PL"
        },
        {
          "code": "CZ"
        },
        {
          "code": "DE"
        }
      ]
    },
    {
      "id": "allegro-cz",
      "languages": {
         “offerCreation” : [                  
         {
              "code": "cs-CZ"                           
            },
            {
               "code": "en-US"                
            }
        ],
       “offerDisplay”: [                  
    {
       “code”: “pl-PL”
    },
    {
       “code”: “en-US”
    },
    {
       “code”: “cs-CZ”
    }
        ]
      }
      "currencies": {                   
        "base": {      
          "code": "CZK"               
        },
        "additional": [
          {
            "code": "EUR"
          },
          {
            "code": "USD"
          },
          {
            "code": "PLN"
          }
        ]
      },
      "shippingCountries": [   
        {
          "code": "CZ"
        },
        {
          "code": "PL"
        },
        {
          "code": "SK"
        }
      ]
    }
   ]
   }

Co planujemy zmienić?

Zmiana samych zasobów dotyczących oferty to nie wszystko. Zmiana obejmie wiele obszarów API Allegro, na przykład:

• cenniki, metody i ustawienia dostawy,
• katalog produktów np. wyszukiwanie i dodawanie produktów w różnych językach,
• dziennik zdarzeń,
• drzewo kategorii,
• opcje promowania,
• zamówienia,
• opłaty.

Pierwszy etap komunikacji skupia się na najważniejszej rzeczy, czyli na ofercie i rozróżnieniu serwisów na bazowy i dodatkowy. Zdajemy sobie sprawę, że nie otrzymaliście jeszcze wszystkich informacji. Jednak chcemy dać Wam podstawę do działania, byście mogli zaplanować pracę po swojej stronie. O zmianach w innych zasobach będziemy informować, gdy tylko będą gotowe do publikacji.

Na pewno pojawią się pytania, dlatego zapraszamy na nasze forum GitHub, gdzie postaramy się rozwiać Wasze wątpliwości.