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.
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.
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).
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:
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.
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.
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.
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.
Nie, w takim przypadku skorzystaj z PATCH /sale/product-offers i w strukturze requestu przekaż tylko to pole, które chcesz zmodyfikować. Więcej na temat tego procesu 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.
Od 1 sierpnia 2022 roku nowe oferty w wybranych działach wystawisz dopiero, gdy połączysz je z Katalogiem produktów. Na stronie allegro możesz 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ę.
Komunikat oznacza, że na podstawie przekazanych danych odnaleźliśmy istniejący produkt w naszym Katalogui próbujemy uwzględnić go ofercie. Ponieważ występuje on w innej kategorii, odpowiadamy błędem. W takiej sytuacji możesz poprawić ID kategorii w swoim żądaniu lub - jeśli jesteś pewien, że Twoja kategoria jest prawidłowa - zgłosić sugestię zmiany danych w produkcie. Podobna sytuacja wystąpi, jeśli pojawi się rozbieżność w parametrach, zwrócimy wtedy komunikat: “The provided parameter Kod producenta value {przekazana wartość} does not match the existing parameter {wartość w produkcie}”.
Wskazany parametr przekazujesz w sekcji produktowej (w “productSet.product.parameters”) zamiast w ofertowej (“parameters”). To, czy parametr jest produktowy czy ofertowy, sprawdzisz w odpowiedzi GET /sale/categories/{categoryID}/parameters w polu “options.describesProduct”.
Więcej informacji na ten temat znajdziesz w naszym poradniku.
Produkty tymczasowe tworzymy automatycznie w wybranych kategoriach wyłącznie na podstawie ofert, w których sprzedawca dla parametru “Stan” wybrał wartość inną niż “Nowy” oraz nie przekazał wszystkich parametrów, które identyfikują produkt (lub dla przynajmniej jednego z nich wskazał wartość niejednoznaczną), czyli np. numeru katalogowego części.
Więcej szczegółów znajdziesz w naszym newsie.
Drafty produktów to produkty, które tworzymy po tym, gdy użytkownik strony WWW Allegro przekaże nam sugestię zmiany parametrów, które identyfikują produkt. Draft produktu może od razu zostać wykorzystany przez sprzedającego, aby połączyć z nim ofertę - dzięki temu nie musi czekać na weryfikację poprawności danych, aby móc wystawić ofertę. Aktualnie drafty utworzymy wyłącznie na podstawie zgłoszeń z naszej strony internetowej.
Więcej szczegółów znajdziesz w naszym newsie.
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ą.
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.
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.
Oferty przypisane do kampanii promocyjnej lub programu Allegro Ceny znajdziesz w poradniku kampanii.
Upewnij się, że usługa dostawy, którą wybrałeś jest prawidłowa dla metody dostawy, którą wybrał kupujący. Szczegółowy podział usług na metody dostawy znajdziesz na naszej stronie. Miej także na uwadze, że ID usługi dostawy posiada różną wartość w zależności od konta.
Wejdź w zakładkę Rozliczenia z Allegro i kliknij przycisk “Zapłać”, który znajduje się w sekcji “Bieżące Saldo”. Opłać rachunek za pomocą symulatora płatności - konto po kilku minutach zostanie odblokowane.
Raz na kwartał, w związku z przeprowadzaną przez nas synchronizacją środowiska testowego z produkcyjnym, usuwamy wszystkie oferty z Sandboxa. Odpowiednio wcześniej informujemy o tym w newsach na naszej stronie.