[NEWS] Obsługuj zamówienia przez Allegro REST API

[KrzysztofLukanowski]

Zgodnie z zapowiedzią udostępniamy nowe zasoby (w wersji BETA) do zarządzania zamówieniami w ramach Allegro REST API. Dzięki nim możecie pobrać listę zdarzeń, a na ich podstawie szczegóły zamówień. W październiku metody w WebAPI do zarządzania zamówieniami oznaczymy jako deprecated:

• doGetPostBuyData
• doGetPostBuyFormsDataForSellers
• doGetPostBuyFormsIds
• doGetTransactionsIDs
• doGetSiteJournalDeals
• doGetSiteJournalDealsInfo
• doGetShipmentData

Dla zamówień przygotowaliśmy nowe zasoby w Allegro REST API:

GET /order/events - dziennik zdarzeń GET /order/checkout-forms - lista zamówień GET /order/checkout-forms/{id}) - szczegóły zamówienia

Na portalu REST API znajdziecie również poradnik, w którym wyjaśniamy jak korzystać z nowych zasobów.

[rtnet-pl]

@KrzysztofLukanowski Mam pytanie, co to za identyfikator (guid)?

  "lineItems": [
    {
      "id": "62ae358b-8f65-4fc4-9c77-bedf604a2e2b",
      "offer": {
        "id": "3213213",
        "name": "Name of purchased offer"
      },

Nie ma EAN-u... WHY... 😢

[kormichu]

Jak mam teraz zamienić dealId oraz transactionId które są numeryczne na UUID ? Przejście ze starego API na nowe spowoduje że powielą się zamówienia

[dida886]

proszę o aktywację konta na sandboxie: xtest.develop@gmail.com

[KrzysztofLukanowski]

@rtnet-pl to jest id pozycji w zamówienia, można powiedzieć, że to odpowiednik dealId w WebAPI, tylko że to jest już inny byt, w ramach REST API. @kormichu tak jak wyżej napisałem, metody WebAPI wkrótce oznaczymy jako deprecated, a w przyszłości wyłączymy. Rozważamy, że w niedalekiej przyszłości udostępnimy możliwość pobrania mapowania lineItemId na dealId. @dida886 konto jest już aktywne.

[rtnet-pl]

@KrzysztofLukanowski OK, dzięki. W konsultacjach zgłaszaliśmy (nie tylko my z resztą) konieczność dodania jakiegoś pola które umożliwi jednoznaczną identyfikację zakupionego przedmiotu (np. ean lub external.id). Co z tym?

[kormichu]

@KrzysztofLukanowski rozumiem chce jednak przygotować obecną integrację, aby obeszło się bez nieopłaconych / powtórzonych zamówień podczas migracji z SOAP API na REST API. Mogę co prawda dopasować akty zakupowe (dealId) czy transakcje (dealTransactionId) po różnych czynnikach jednak nadal będzie to niedokładne

[KrzysztofLukanowski]

@rtnet-pl a co do EANu - analizujemy temat, nie mówimy nie ;)

[kfijalko]

W przypadku formularza w statusie BOUGHT i FILLED_IN przed READY_FOR_PROCESSING nie mam numeru telefonu kupujacego. Czy można go dodać?

[KrzysztofLukanowski]

@kfijalko dziękuję za sugestię. Zasoby są jeszcze w wersji beta, dlatego liczymy na Wasz feedback. Przed wyjściem z bety przeanalizujemy wszystkie uwagi i wypracujemy ostateczny kształt nowych zasobów.

[kfijalko]

Mam pytanie odnośnie numeru wysyłki/paczki do śledzenia. Czy będzie obsługiwany w ramach tych zasobów, czy planujecie inne, czy nie planujecie?

[KrzysztofLukanowski]

@kfijalko w ramach tych zasobów wyświetlamy info o akcjach kupującego. Sprzedający będzie mógł dodać i pobrać informację o przesyłce innymi metodami.

[aktywnitu]

Dzięki!

[jakubmaguza]

Skoro tak jak pisaliście, liczycie na sugestie, to po raz kolejny proszę o dodanie pola external. W innym przypadku ucierpią wasze serwery, bo dla każdej zakupionej oferty, w celu sprawdzenia poprawności, będzie trzeba odpytać API o szczegóły. Jedno pole, a zmniejszy bardzo ilość zapytań.

[rtnet-pl]

Przede wszystkim to pole jest wymagane, żeby zagwarantować spójność danych. Dzisiaj klient coś kupuje, za godzinę ktoś edytuje w ofercie EAN lub symbol, a za 2 godziny importujemy transakcję - ze złym symbolem.

[TomekKaczmarek]

@rtnet-pl @jakubmaguza Panowie, spokojnie. Wiemy, rozumiemy - będziemy pracować w tym temacie - jak pojawią się konkretne ustalenia, damy znać.

[mack3d]

Dzień dobry, czy istnieje metoda w REST api, która zastąpi doGetPostBuyData. W tej metodzie można było pobrać dane adresowe klienta, a nie tylko email i telefon. Wykorzystujemy to w celu przyśpieszenia finalizacji transakcji przy kontakcie w jednej z podanych form. Poza tym te dane są w mailach informacyjnych "sprzedałeś" więc uważam że tu też mogłyby być śmiało.

[TomekKaczmarek]

Specjalnie nie zwracamy tych danych. Klient może wypełnić formularz pozakupowy z opóźnieniem, nawet kilku dniowym. Wtedy może się okazać, że wskazał inny adres wysyłki niż ten na koncie Allegro. Dlatego podajemy dane kontaktowe w API - by sprzedawca mógł skontaktować się w takiej sytuacji i ustalić szczegóły realizacji zamówienia.

Gdy klient wypełni FOD, wywołaj metodę GET na zasobie /order/checkout-forms/{checkoutForm_id}, żeby otrzymać szczegóły zamówienia takie jak:

• dane dotyczące zakupionych ofert
• dane klienta
• status zamówienia
• informacje o płatności
• dane do wysyłki
• dane do faktury
• informacje o wybranych opcjach dodatkowych.

Więcej informacji znajdziesz w naszym poradniku: https://developer.allegro.pl/orders/#04