Allegro REST API

gdzie?

Polska | polski | PLN
  • Informacje podstawowe
  • Główne procesy
  • Uwierzytelnianie i autoryzacja
  • Wzorzec Command
  • Glosariusz
  • Lista metod
  • Pierwsze kroki
  • Wystawianie oferty z produktem
  • Wystawianie i zarządzanie ofertą w serwisach zagranicznych
  • Zarządzanie ofertami
  • Oferty wielowariantowe
  • Pasuje do
  • Zarządzanie zgłoszeniami ofert do kampanii
  • Rabaty i promocje
  • Zamówienia
  • Wysyłam z Allegro
  • One Fulfillment by Allegro
  • Dyskusje
  • Konto i dane użytkownika
  • Centrum wiadomości
  • Sprawdzanie opłat
  • Wystawianie ogłoszeń
  • Publiczne oferty
FAQ
  • Aktualności
  • Changelog
Dokumentacja
Regulamin
Kontakt
  • Moje aplikacje
  • Moje aplikacje (sandbox)
  • Newsletter
  1. Allegro REST API
  2. Aktualności
  3. Zmiany w wystawianiu ofert - dodamy możliwość wyświetlania ofert w zagranicznych domenach serwisu Allegro

08 grudnia 2022

Zmiany w wystawianiu ofert - dodamy możliwość wyświetlania ofert w zagranicznych domenach serwisu Allegro

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.