[NEWS] Wygaszamy WebAPI do obsługi ofert i sprzedaży. Korzystaj z REST API

[PawelTaberski]

Od sierpnia 2016 możesz łączyć się z Allegro za pomocą dwóch protokołów API - REST i SOAP. Podstawowym i rozwijanym interfejsem programistycznym Allegro jest REST API, i tylko w nim udostępniamy wszelkie nowe funkcjonalności. W REST API opublikowaliśmy zestaw zasobów, które pozwalają:

• wystawiać i edytować oferty,
• wprowadzać zmiany w wielu ofertach jednocześnie,
• obsługiwać zamówienia.

Plany dla API Allegro

Rozwijamy REST API

Przypominamy, że możesz wystawiać i zarządzać ofertami przez REST API - odpowiednie zasoby są od września 2018 w wersji public.

Harmonogram dla REST API - Luty/Marzec 2019

• Produktyzacja - grupujemy oferty z tym samym produktem
  • planujemy udostępnić zasoby, które pozwolą powiązać nową i istniejącą ofertę z produktem z naszej bazy danych. Zasoby opublikujemy w wersji beta, by poznać twoje uwagi i sugestie.
  • równolegle pracujemy nad zasobami, które pozwolą dodać produkt do naszej bazy.
• zasoby, które pozwalają obsługiwać zamówienia udostępnimy w wersji public. Do tego czasu jesteśmy otwarci i chętnie wysłuchamy twoich uwag i sugestii czego jeszcze brakuje w obsłudze zamówień. Dlatego tym bardziej zachęcamy do testów.
• udostępnimy nowy zasób, którym dodasz informacje o przesyłce.
• wspólnie z InPostem rozwiążemy problem integracji związany z nowymi numerami zamówień.

Wygaszamy WebAPI

WebAPI to stare rozwiązanie, które utrzymujemy głównie z uwagi na kompatybilność wsteczną z istniejącymi aplikacjami. Nie rozwijamy go już i planujemy jego wygaszenie. Nowe funkcjonalności będziemy udostępniać tylko w REST API.

• 3 czerwca 2019 usuniemy metody do obsługi i zarządzania ofertami, które już dziś oznaczamy jako deprecated. Oznacza to, że już teraz odradzamy użycia tych metod w nowych rozwiązaniach i zalecamy migrację na REST API w istniejących rozwiązaniach. Dotyczy to metod:
  • doNewAuctionExt.
  • doChangeItemFields.
  • doGetItemFields.
  • doGetSellFormFieldsForCategory.
  • doFinishItem.
  • doFinishItems.
  • doChangePriceItem.
  • doChangeQuantityItem.
  • doCheckNewAuctionExt.
  • doCheckItemDescription.
• Zgodnie z wcześniejszą zapowiedzią 1 kwietnia 2019 usuniemy metodę doGetItemsList.
• W chwili, gdy udostępnimy w REST API zasoby które pozwalają obsługiwać zamówienia w wersji public oznaczymy metody do obsługi zamówień w WebAPI jako deprecated.

O planach dla innych metod i zasobów w API będziemy informować na bieżąco.

[PatrykTrena]

Pani Marto, A czy może wiadomo już na podstawie jakiej zmiennej będą weryfikowane paczki jako Inpost Allegro? Aktualnie jest to numer FOD. Przy pobieraniu zamówień przez rest api nie ma takiej zmiennej. Jest co prawda "id": "ffc396b0-9584-11e8-8d53-07c966f77738", -- identyfikator zamówienia Ale nie wiem czy operowanie nim będzie przydatne. Przydał by się również jakiś unikalny identyfikator zamówienia klienta w formacie liczbowym przy korzystaniu z metody orders. Ułatwiło by to kontakt z klientem.

[MartaNowaczyk]

@PatrykTrena z dostępnych mi informacji wynika, że nie będą potrzebne id zamówienia. Trzeba będzie przekazać zakodowany e-mail kupującego.

[deneb-k]

Za lekko ponad dwa tygodnie wyłączacie te stare metody. Chciałem się wziąć za wywalenie doFinishItem, bo już chyba tylko to zostało w moim skrypcie, ale przypomniałem sobie, że przecież w REST nie da się anulować złożonych ofert w licytacjach. Co mam z tym zrobić?

[MartaNowaczyk]

@deneb-k odwoływanie ofert w licytacjach nie było w dużym stopniu wykorzystywane, dlatego zdecydowaliśmy się usunąć metodę doCancelBidItem. Jednak w tym przypadku postanowiliśmy, że sprawdzimy statystyki użycia tej opcji w metodzie doFinishItem i na tej podstawie podejmiemy decyzję co dalej z możliwością odwoływania ofert w licytacjach na REST API.

[MartaNowaczyk]

@deneb-k dostałam informację, że podczas zakończenia oferty nie ma już możliwości odwołania ofert przez Panel allegro, dlatego nie będziemy udostępniać tej funkcjonalności na REST API.

[Maczuga]

Harmonogram dla REST API - Luty/Marzec 2019 ...

• wspólnie z InPostem rozwiążemy problem integracji związany z nowymi numerami zamówień.

@MartaNowaczyk Jak tam, InPost wyrobi się do 3 czerwca? Czy od pół roku nie zrobili nic w tej sprawie?

[PawelTaberski]

Jak tylko będziemy mieli informacje o wdrożeniu zmiany na pewno o tym poinformujemy.

[PatrykTrena]

@PawelTaberski Czy planujecie w metodzie order wdrożenie jakiegoś numeru zamówienia dla klienta i sprzedającego oprócz numeru transakcji PayU, który ułatwił by komunikację?

[PawelTaberski]

Nie wiem, czy dobrze Ciebie rozumiem, w zasobach do zarządzania zamówieniami już są dostępne m.in.:

• identyfikatory zamówienia (checkoutFormId)
• jak i identyfikatory pozycji zamówienia (lineItemsId)

, które ułatwiają zarządzanie jak i wyszukiwanie transakcji. Więcej na ten temat znajdziesz w naszym poradniku Jak obsługiwać zamówienia

[FromAnyHole]

@PawelTaberski - Skoro NIC do Was nadal nie trafia, to mam propozycję: Roześlijcie do wszystkich korzystających z API prostą ankietę i zapytajcie:

• czy termin wyłączeń WebAPI tuż przed wakacjami i urlopami jest lepszy ?
• czy może lepiej dać WSZYSTKIM szansę na adaptacje - w czasie wakacji ??

[PatrykTrena]

@PawelTaberski oczywiście obydwa numery są dostępne w API ale obydwa wyglądają jak poniżej i nie wyobrażam sobie kontaktu z kupującym na podstawie tego numeru. Jedyny sensowy numer to ID oferty, ale przy zamówieniu z kilkoma produktami to się nie sprawdzi. 99% komunikacji z klientem w tym momencie odbywa się na podstawie numery FOD, który teraz będzie miał 30 znaków.

"id": "a8f086f0-9583-11e8-8d53-07c966f77738", -- identyfikator zamówienia "lineItems": [ -- informacja o przedmiotach wchodzących w skład zamówienia { "id": "38h7b340-8583-12e8-9d53-08c966f55539", "offer": { "id": "6205584020", -- numer oferty

[PawelTaberski]

W kontakcie ze sprzedających chyba najtrafniej użyć id sprzedawcy i ofert które zakupił, bądź identyfikator płatności, gdyż te informacje widzi on w swoich szczegółach zakupu.