Naraz możesz mieć otwartych 20 sesji. W usłudze Allegro REST API (produkcyjnej oraz testowej) obowiązuje główny limit nakładany na Client ID (lub Sofware Statement ID w przypadku DCR) - 9000 zapytań na minutę.

Gdy przekroczysz limit:

• na minutę zablokujemy twój Client ID,
• zwrócimy odpowiedź ze statusem: 429 Too Many Requests.

Po tym czasie automatycznie przywrócimy dostęp do usługi dla twojego Client ID.

Dla niektórych zasobów stosujemy dodatkowe, niższe limity liczby żądań. W takich przypadkach informacje o dodatkowym limicie znajdziesz w opisie zasobu w dokumentacji REST API Allegro.

Dla wybranych zasobów REST API stosujemy także dodatkowy mechanizm, który ogranicza liczbę zapytań dla danego użytkownika (user.id). Wykorzystujemy algorytm Leaky Bucket. Gdy użytkownik przekroczy dozwoloną liczbę wywołań na minutę (RPM), wydłużamy czas odpowiedzi. W przypadku zbyt dużej liczby równoległych zapytań w imieniu tego samego użytkownika serwer odpowie błędem HTTP: 429 Too Many Requests. Więcej - w naszym poradniku.

Maksymalnie możesz mieć 250 cenników dostawy. Raz dodany cennik możesz wielokrotnie edytować, ale nie możesz go usunąć.

Upewnij się, że adres, który przekazujesz w redirect_uri jest taki sam, jak ten, który podałeś przy rejestracji aplikacji. Adresy przekierowań możesz sprawdzić oraz edytować na stronie https://apps.developer.allegro.pl/. Więcej - w naszym poradniku.

Błąd wskazuje na to, że nieprawidłowo przekazujesz nazwę parametru code w URL, np.

https://allegro.pl/auth/oauth/token?grant_type=authorization_code&codee=385MTAI0BQ16ZXSPUQ33qCot27xqNH1j&redirect_uri=http://localhojst:8080/exhange_code

lub nie przekazujesz go w ogóle. Więcej - w naszym poradniku.

Upewnij się, że podajesz prawidłowy adres URL - https://allegro.pl/auth/oauth/token?grant_type=authorization_code&code={code}&redirect_uri={redirect_uri}. Więcej - w naszym poradniku.

Sprawdź, czy jesteś zautoryzowany jako sprzedawca, do którego należą oferty, zamówienia, etc. (w zależności z którego zasobu korzystasz). W tym celu rozkoduj swój token - wpisz w wyszukiwarce “decode jwt token” i na jednej z dostępnych stron zweryfikuj wartość user_name po wklejeniu swojego tokena.

Zweryfikuj, jakiego typu autoryzacji wymagamy, aby skorzystać z danego zasobu. Tę informację znajdziesz w naszej dokumentacji:

• bearer-token-for-user - code lub device,
• bearer-token-for-application - client_credentials.

Więcej - w naszym poradniku.

Zweryfikuj, czy nie używasz tokena ze środowiska testowego na produkcyjnym lub odwrotnie. Więcej - w naszym poradniku.

Dzieje się tak w przypadku:

• wylogowania się ze wszystkich urządzeń, np. poprzez zakładkę Logowanie i hasło,
• zmiany hasła,
• zmiany adresu e-mail,
• blokady sprzedaży,
• w wyniku przekroczenia liczby aktywnych sesji (max. 20 otwartych sesji dla jednego użytkownika).

Nie, nie należy traktować tego jako błąd. Dla każdego zamówienia musi wystąpić przynajmniej jedno zdarzenie.

Tak, możesz otrzymać kilka zdarzeń tego samego typu, dlatego zwróć uwagę na identyfikator zamówienia w obiekcie checkoutForm.

Tak, możesz otrzymać eventy w różnej kolejności.

Kupujący najprawdopodobniej wykonał oddzielne zakupy, a następnie łącznie je opłacił. Otrzymasz nowy event z nowym numerem zamówienia, a stare usuniemy. Aby zidentyfikować taką sytuację możesz oprzeć się na pojedynczym akcie zakupowym - lineItem.id (jeżeli jeden lineItem.id występuje w kilku zamówieniach oznacza to, że mamy do czynienia z połączeniem zakupów przez kupującego).

Gdy zmieniasz status realizacji zamówienia za pomocą PUT /order/checkout-forms/{id}/fulfillment, wykorzystaj dodatkowy parametr checkoutForm.revision, który otrzymasz w odpowiedzi dla:

• GET /order/events,
• GET /order/checkout-forms,
• GET /order/checkout-forms/{id}.

Zwracamy w nim informację o wersji zamówienia. Dzięki niemu będziesz pewien, że zmieniasz status realizacji zamówienia (“fulfillment.status”), którego dokładnie ta sama kopia znajduje się w Allegro.

np. PUT /order/checkout-forms/29738e61-7f6a-11e8-ac45-09db60ede9d6/fulfillment?checkoutForm.revision={revision}’

Status realizacji zamówienia zmieni się automatycznie, tylko wtedy, gdy sprzedawca korzysta z abonamentu i zaznaczy taką opcję w ustawieniach w zakładce Zamówienia. W pozostałych przypadkach musisz to wykonać ręcznie za pomocą PUT /order/checkout-forms/{id}/fulfillment.

Wartość checkout-form.id jest unikalna, nie wystąpią dwa różne zamówienia o tym samym id.

Skorzystaj w tym celu z parametru fulfillment.shipmentSummary.lineItemsSent. Znajdziesz w nim informację, czy do przedmiotów w zamówieniu dołączono numery przesyłek. Dostępne wartości określają przypisane numery przesyłek do:

• ALL - wszystkich przedmiotów w zamówieniu,
• SOME - przynajmniej jednego przedmiotu z zamówienia. Za pomocą GET /order/checkout-forms/{id}/shipments sprawdzisz przedmioty, do których dodałeś już numer.
• NONE - żadnego przedmiotu z zamówienia,

np. GET /order/checkout-forms?fulfillment.shipmentSummary.lineItemsSent=ALL - zwróci zamówienia, gdzie dla wszystkich przedmiotów, które wchodzą w jego skład, dodano numer przesyłki.

W polu scheduledFor przekazujesz datę z przeszłości. Aby wyeliminować ten błąd, podaj datę z przyszłości lub pozostaw to pole puste. Więcej - w naszym poradniku.

Jako sprzedawca, który wystawił tę ofertę, pobierz aktywną ofertę za pomocą GET /sale/offers/{offerId}. Prześlij całą pobraną strukturę poprzez POST /sale/offers z wyłączeniem:

• numeru identyfikacyjnego oferty (“id”),
• informacji, kiedy odbyła się ostatnia walidacja oferty (“validatedAt”),
• daty utworzenia oferty (“createdAt”),
• daty ostatniej aktualizacji oferty (updatedAt“)
• obiektu “publication”.

Dzięki temu stworzysz nowy draft na podstawie danych z oferty, którą wcześniej pobrałeś. Więcej - w naszym poradniku.

Otrzymałeś taki komunikat, ponieważ przekroczyłeś dostępny limit szkiców ofert (draftów), dotyczy to ofert z statusem INACTIVE - obecny limit to 20 000. Aby rozwiązać ten problem:

• sprawdź aktualną liczbę draftów za pomocą GET /sale/offers?publication.status=INACTIVE,
• usuń niepotrzebne za pomocą DELETE /sale/offers/{offerId}. Więcej - w naszym poradniku.

Maksymalnie możesz aktywować lub zakończyć 1000 ofert.

Posługujesz się tokenem uzyskanym w wyniku autoryzacji client_credentials, który nie posiada kontekstu użytkownika. Aby utworzyć draft oferty, musisz posiadać token wygenerowany przez code lub device flow.

Upewnij się, że struktura twojego żądania jest prawidłowa i poprawnie przekazujesz wszystkie wartości. Przykładowy request znajdziesz w naszym poradniku.

Tak, dzieje się tak ponieważ ten zasób działa asynchronicznie. Aby sprawdzić szczegółowy status realizacji zadania, użyj GET /sale/offer-publication-commands/{commandId}/tasks.

Upewnij się, że oprócz prawidłowo uzupełnionego pola location, przesyłasz także wartości dla delivery.shippingRates i sellingMode.

Upewnij się, że linki do obrazków, które przesyłasz w sekcji description, prawidłowo przekazujesz także w sekcji images.

Oferta, którą próbujesz pobrać została:

• zarchiwizowana - oferty przenosimy do archiwum po 60 dniach od zakończenia,
• usunięta - jeśli szkic oferty nie był edytowany lub oferta nie była aktywowana w ciągu 60 dni,
• nigdy nie istniała. W takim przypadku musisz utworzyć nową ofertę.

Upewnij się, że jesteś zautoryzowany jako sprzedawca, do którego należy dana oferta. Możesz pobierać tylko swoje oferty. Rozkoduj swój token za pomocą jednego z darmowych narzędzi i zweryfikuj wartość w polu user_name.

Jest to prawidłowe zachowanie - taka sytuacja wystąpi, gdy sprzedawca ukryje ofertę przez stronę WWW Allegro.

Tak, wszystkie zasoby do edycji wielu ofert jednocześnie działają asynchronicznie, dlatego aby sprawdzić szczegóły status operacji, użyj GET /sale/offer-price-change-commands/{commandId}/tasks.

Upewnij się, że struktura twojego żądania jest prawidłowa i poprawnie przekazujesz wszystkie wartości. Przykładowy request znajdziesz w naszym poradniku.

Tak, może wystąpić taki przypadek, gdyż:

• np. przy niektórych laptopach może być jeden numer EAN, a laptopy będą się różniły specyfikacją techniczną np. wielkością dysku,
• np. w modzie może być jeden EAN na wiele rodzajów kolorystycznych danej odzieży.

Dlatego identyfikujemy produkty nie tylko po EAN-ie, ale też po jego parametrach. Więcej - w naszym poradniku.

W tym momencie wymagamy, aby część Twoich ofert była wystawiona z produktem. Stopniowo będziemy zwiększać % ofert objęty wymogiem. Na stronie allegro można sprawdzić jaki % ofert jest połączony z produktem.

Skorzystaj z dedykowanych zasobów do wystawiania ofert z produktem. Zastosowaliśmy tam szereg ułatwień, dzięki czemu w prostszy sposób możesz wystawić i edytować ofertę.

Poza tym w drugiej połowie 2022 roku planujemy, żeby każda nowo wystawiona oferta była połączona z Katalogiem produktów.

Nie, w takim przypadku otrzymasz błąd, który informuje o tym, że oferty znajdują się już w innej ofercie wielowariantowej. Możesz dodać pojedyncze oferty lub oferty, które wchodzą w skład automatycznie utworzonej oferty wielowariantowej.

W tym przypadku rozłącz jedną z ofert wielowariantowych za pomocą DELETE /sale/offer-variants/{setId}. Następnie użyj PUT sale/offer-variants/{setId} i dodaj do oferty wielowariantowej oferty, które przed chwilą rozłączyłeś.

Tak, pod warunkiem, że przed wysłaniem żądania zdążyliśmy przetworzyć informacje o nowych ofertach, decydujące o tym, że mogą zostać połączone według wskazanych parametrów. W przeciwnym wypadku otrzymasz błąd wraz z informacją, że trwa jeszcze przetwarzanie ofert, z których chciałeś utworzyć ofertę wielowariantową.

Nie, otrzymasz wtedy odpowiedź z błędem i informacją, że nie znaleziono ofert, które przekazałeś w strukturze. Oferty muszą być w statusie ACTIVE.

Tak, możesz pobrać identyfikator takiej oferty. Skorzystaj w tym celu z parametru query dla zasobu GET /sale/offer-variants?query={query}. Jako wartość przekaż nazwę oferty wielowariantowej lub identyfikator jednej z ofert, która wchodzi w jej skład.

Oferta ponownie wejdzie w skład oferty wielowariantowej.

Nie zwracamy ofert zakończonych dla ofert wielowariantowych w kategoriach zarządzanych automatycznie - ich pełną listę można znaleźć w regulaminie. W pozostałych kategoriach oferty wielowariantowe są zarządzane ręcznie i dla nich zwracamy oferty zakończone.

Aby Twoja oferta mogła brać udział w kampanii promocyjnej lub programie Allegro Ceny, który zarządza ceną oferty, konieczne jest, żeby Twój system integrujący nie zmieniał ceny ofert biorących udział w programie.

Oferty przypisane do kampanii promocyjnej lub programu Allegro Ceny znajdziesz w poradniku kampanii.