Allegro REST API – co można zautomatyzować w sprzedaży?

Allegro API to interfejs, przez który programy komunikują się z Twoim kontem: wystawiają oferty, pobierają zamówienia, tworzą przesyłki czy odpowiadają na wiadomości. Korzysta z niego niemal każdy integrator i system magazynowy, nawet jeśli sprzedawca nigdy nie widział linijki kodu. Pytanie nie brzmi więc „czy API”, tylko „co warto zautomatyzować i jak”.

W tym artykule wyjaśniamy, czym jest Allegro REST API, jakie obszary sprzedaży da się dzięki niemu zautomatyzować, jak wygląda dostęp i autoryzacja oraz kiedy lepiej postawić na gotowe narzędzie, a kiedy na własną integrację. Tekst jest pisany z myślą o sprzedawcy, który chce podjąć dobrą decyzję, a nie o programiście.

Czym jest Allegro REST API

REST API to zestaw adresów (tzw. zasobów), pod które aplikacja wysyła zapytania i otrzymuje odpowiedzi w ustrukturyzowanym formacie. Allegro udostępnia go bezpłatnie dla zarejestrowanych aplikacji, a dokumentacja wraz z poradnikami jest dostępna w Allegro Developer Portal pod adresem developer.allegro.pl.

Zasoby są pogrupowane tematycznie – na przykład oferty znajdziesz pod ścieżkami zaczynającymi się od /sale/offers, kategorie pod /sale/categories, a zamówienia pod /order/checkout-forms. Każda operacja, którą wykonujesz ręcznie w Sales Center, ma zwykle swój odpowiednik w API, choć nie zawsze w identycznej formie.

Dla sprzedawcy najważniejsze jest to, że API pozwala połączyć Allegro z resztą firmy: sklepem internetowym, magazynem, systemem księgowym, kurierem czy narzędziem do obsługi klienta. Bez API każde z tych połączeń wymagałoby ręcznego przepisywania danych.

Warto też rozróżnić API od innych sposobów pracy z kontem. Formularz w Sales Center sprawdza się przy pojedynczych ofertach, a pliki importu – przy jednorazowych, większych zmianach. API działa w sposób ciągły: dane płyną między systemami automatycznie, bez eksportów i importów, więc nadaje się do procesów, które powtarzają się każdego dnia.

Co można zautomatyzować przez Allegro API

Poradniki w Allegro Developer Portal obejmują m.in. oferty i produkty, zamówienia, wysyłki (Wysyłam z Allegro), One Fulfillment by Allegro, dyskusje i reklamacje, dane konta, Centrum wiadomości, sprawdzanie opłat, rabaty i promocje oraz reklamy. Poniżej najważniejsze obszary z perspektywy codziennej sprzedaży.

Obszar	Przykłady automatyzacji	Korzyść
Oferty i produkty	Masowe wystawianie, powiązanie z Katalogiem, aktualizacja cen i stanów	Mniej pracy ręcznej, aktualne dane
Zamówienia	Pobieranie zamówień do sklepu lub ERP, zmiana statusów	Jedno miejsce obsługi zamówień
Wysyłki	Tworzenie przesyłek, etykiety, numery nadania	Szybsza wysyłka, mniej pomyłek
Faktury	Dodawanie faktur do zamówień	Automatyczny obieg dokumentów
Komunikacja	Odczyt i odpowiedzi w Centrum wiadomości, dyskusje	Szybsze odpowiedzi, wspólna skrzynka
Rozliczenia	Pobieranie opłat i prowizji	Kontrola kosztów i marży
Promocje i reklama	Rabaty, kampanie, dane reklamowe	Raportowanie i optymalizacja

Oferty, ceny i stany magazynowe

To najczęstszy powód sięgania po API. Możesz wystawiać oferty z bazy produktów, łączyć je z Katalogiem, zmieniać ceny według reguł (np. marży lub kursu walut) i aktualizować stany po każdej sprzedaży w innym kanale. Przy dużym asortymencie to jedyny realny sposób, żeby dane były aktualne. Więcej o samym procesie piszemy w artykule o masowym wystawianiu ofert.

Zamówienia i dziennik zdarzeń

API udostępnia dziennik zdarzeń o zamówieniach, z którego aplikacja odczytuje, co nowego wydarzyło się na koncie – np. pojawił się zakup lub kupujący opłacił zamówienie. Na tej podstawie system pobiera szczegóły zamówienia, rezerwuje towar w magazynie i uruchamia kolejne kroki: fakturę, etykietę, wiadomość do klienta.

Wysyłka i fulfillment

Przez API możesz tworzyć przesyłki w ramach Wysyłam z Allegro, pobierać etykiety i przekazywać numery nadania do zamówień. Jeśli korzystasz z One Fulfillment by Allegro, API pozwala też zarządzać towarem w magazynie Allegro. O samej usłudze przeczytasz w tekście Wysyłam z Allegro – jak działa i ile kosztuje.

Obsługa klienta i posprzedaż

Wiadomości od kupujących, dyskusje i zwroty też da się obsługiwać przez API. Dzięki temu zespół może pracować w jednym narzędziu dla wielu kont i kanałów, a proste przypadki – jak potwierdzenie wysyłki – mogą być obsługiwane automatycznie.

Allegro API to interfejs, przez który programy komunikują się z Twoim kontem: wystawiają oferty, pobierają zamówienia, tworzą przesyłki czy odpowiadają na wiadomości. Korzysta z niego niemal każdy integrator i system magazynowy, nawet jeśli sprzedawca nigdy nie widział linijki kodu. Pytanie nie brzmi więc „czy API”, tylko „co warto zautomatyzować i jak”.

W tym artykule wyjaśniamy, czym jest Allegro REST API, jakie obszary sprzedaży da się dzięki niemu zautomatyzować, jak wygląda dostęp i autoryzacja oraz kiedy lepiej postawić na gotowe narzędzie, a kiedy na własną integrację. Tekst jest pisany z myślą o sprzedawcy, który chce podjąć dobrą decyzję, a nie o programiście.

Czym jest Allegro REST API

REST API to zestaw adresów (tzw. zasobów), pod które aplikacja wysyła zapytania i otrzymuje odpowiedzi w ustrukturyzowanym formacie. Allegro udostępnia go bezpłatnie dla zarejestrowanych aplikacji, a dokumentacja wraz z poradnikami jest dostępna w Allegro Developer Portal pod adresem developer.allegro.pl.

Zasoby są pogrupowane tematycznie – na przykład oferty znajdziesz pod ścieżkami zaczynającymi się od /sale/offers, kategorie pod /sale/categories, a zamówienia pod /order/checkout-forms. Każda operacja, którą wykonujesz ręcznie w Sales Center, ma zwykle swój odpowiednik w API, choć nie zawsze w identycznej formie.

Dla sprzedawcy najważniejsze jest to, że API pozwala połączyć Allegro z resztą firmy: sklepem internetowym, magazynem, systemem księgowym, kurierem czy narzędziem do obsługi klienta. Bez API każde z tych połączeń wymagałoby ręcznego przepisywania danych.

Warto też rozróżnić API od innych sposobów pracy z kontem. Formularz w Sales Center sprawdza się przy pojedynczych ofertach, a pliki importu – przy jednorazowych, większych zmianach. API działa w sposób ciągły: dane płyną między systemami automatycznie, bez eksportów i importów, więc nadaje się do procesów, które powtarzają się każdego dnia.

Co można zautomatyzować przez Allegro API

Poradniki w Allegro Developer Portal obejmują m.in. oferty i produkty, zamówienia, wysyłki (Wysyłam z Allegro), One Fulfillment by Allegro, dyskusje i reklamacje, dane konta, Centrum wiadomości, sprawdzanie opłat, rabaty i promocje oraz reklamy. Poniżej najważniejsze obszary z perspektywy codziennej sprzedaży.

Obszar	Przykłady automatyzacji	Korzyść
Oferty i produkty	Masowe wystawianie, powiązanie z Katalogiem, aktualizacja cen i stanów	Mniej pracy ręcznej, aktualne dane
Zamówienia	Pobieranie zamówień do sklepu lub ERP, zmiana statusów	Jedno miejsce obsługi zamówień
Wysyłki	Tworzenie przesyłek, etykiety, numery nadania	Szybsza wysyłka, mniej pomyłek
Faktury	Dodawanie faktur do zamówień	Automatyczny obieg dokumentów
Komunikacja	Odczyt i odpowiedzi w Centrum wiadomości, dyskusje	Szybsze odpowiedzi, wspólna skrzynka
Rozliczenia	Pobieranie opłat i prowizji	Kontrola kosztów i marży
Promocje i reklama	Rabaty, kampanie, dane reklamowe	Raportowanie i optymalizacja

Oferty, ceny i stany magazynowe

To najczęstszy powód sięgania po API. Możesz wystawiać oferty z bazy produktów, łączyć je z Katalogiem, zmieniać ceny według reguł (np. marży lub kursu walut) i aktualizować stany po każdej sprzedaży w innym kanale. Przy dużym asortymencie to jedyny realny sposób, żeby dane były aktualne. Więcej o samym procesie piszemy w artykule o masowym wystawianiu ofert.

Zamówienia i dziennik zdarzeń

API udostępnia dziennik zdarzeń o zamówieniach, z którego aplikacja odczytuje, co nowego wydarzyło się na koncie – np. pojawił się zakup lub kupujący opłacił zamówienie. Na tej podstawie system pobiera szczegóły zamówienia, rezerwuje towar w magazynie i uruchamia kolejne kroki: fakturę, etykietę, wiadomość do klienta.

Wysyłka i fulfillment

Przez API możesz tworzyć przesyłki w ramach Wysyłam z Allegro, pobierać etykiety i przekazywać numery nadania do zamówień. Jeśli korzystasz z One Fulfillment by Allegro, API pozwala też zarządzać towarem w magazynie Allegro. O samej usłudze przeczytasz w tekście Wysyłam z Allegro – jak działa i ile kosztuje.

Obsługa klienta i posprzedaż

Wiadomości od kupujących, dyskusje i zwroty też da się obsługiwać przez API. Dzięki temu zespół może pracować w jednym narzędziu dla wielu kont i kanałów, a proste przypadki – jak potwierdzenie wysyłki – mogą być obsługiwane automatycznie.

Skorzystaj z darmowego audytu konta Allegro

Szybkie i proste poprawki

Analiza ofert i sklepu

Kluczowe wskazówki na przyszłość

Skorzystaj z darmowego audytu konta Allegro

Szybkie i proste poprawki

Analiza ofert i sklepu

Kluczowe wskazówki na przyszłość

Przykład: zautomatyzowana obsługa zamówienia przez API

Żeby lepiej pokazać, jak to działa w praktyce, poniżej przykładowy przebieg zamówienia w sklepie, który połączył Allegro z systemem magazynowym i księgowym. Żaden z tych kroków nie wymaga ręcznego przepisywania danych.

Kupujący opłaca zamówienie, a w dzienniku zdarzeń pojawia się nowy wpis.
System pobiera szczegóły zamówienia i rezerwuje towar w magazynie.
Stan magazynowy zmniejsza się we wszystkich kanałach sprzedaży, także w innych ofertach na Allegro.
System księgowy wystawia fakturę, a integracja dodaje ją do zamówienia na Allegro.
Magazynier drukuje etykietę utworzoną przez API, a numer nadania trafia do zamówienia.
Status zamówienia zmienia się na wysłane, a kupujący dostaje powiadomienie.

W takim modelu człowiek zajmuje się tylko pakowaniem i nietypowymi sytuacjami. To szczególnie ważne w szczycie sezonu, gdy liczba zamówień wyraźnie rośnie, a każda ręczna czynność wydłuża czas wysyłki.

Jak uzyskać dostęp do Allegro API

Dostęp do API uzyskasz po zarejestrowaniu aplikacji. Proces w uproszczeniu wygląda tak:

Rejestrujesz aplikację na stronie apps.developer.allegro.pl i otrzymujesz identyfikator klienta (Client ID) oraz klucz.
Testujesz integrację w środowisku testowym (sandbox), które ma osobny adres i osobne konta.
Użytkownik konta Allegro autoryzuje aplikację w procesie OAuth – loguje się i wyraża zgodę na dostęp.
Aplikacja otrzymuje token dostępu i dołącza go do każdego zapytania.
Po wygaśnięciu tokenu aplikacja odświeża go za pomocą tokenu odświeżającego.

Według dokumentacji token dostępu jest ważny 12 godzin, a token odświeżający – 3 miesiące, przy czym jest jednorazowy: każde odświeżenie zwraca nową parę tokenów. Allegro obsługuje kilka sposobów autoryzacji, m.in. Authorization Code (działanie w imieniu użytkownika), Device flow (dla urządzeń bez przeglądarki) i client_credentials (dostęp tylko do danych publicznych, np. listy kategorii).

Limity zapytań

Główny limit wynosi 9000 zapytań na minutę dla jednego Client ID. Po jego przekroczeniu identyfikator jest blokowany na minutę, a API zwraca błąd 429. Niektóre zasoby mają niższe, osobne limity, a dla wybranych działa dodatkowe ograniczenie liczby zapytań na użytkownika. Przy projektowaniu integracji warto więc od razu zaplanować kolejkowanie i ponawianie zapytań.

Środowisko testowe

Sandbox pozwala testować integrację bez ryzyka dla prawdziwego konta. Ma te same limity co produkcja, ale zdjęcia są usuwane po 7 dniach, dane nie są archiwizowane, a przy kwartalnej aktualizacji kategorii i parametrów wszystkie oferty testowe są usuwane. To środowisko do testów, a nie do przechowywania danych.

Gotowe narzędzie czy własna integracja z API

Większość sprzedawców nie musi pisać własnej integracji. Gotowe systemy do zarządzania sprzedażą korzystają z API za Ciebie i obsługują typowe procesy. Allegro prowadzi Program Certyfikowanych Integratorów, w którym wyróżnia narzędzia spełniające wymagania jakościowe – listę znajdziesz na stronie Allegro dla partnerów. Porównanie popularnych rozwiązań opisujemy w tekście programy do sprzedaży na Allegro.

Własna integracja ma sens w kilku sytuacjach:

masz nietypowe procesy, których gotowe narzędzia nie obsługują,
chcesz połączyć Allegro bezpośrednio z własnym ERP lub hurtownią danych,
potrzebujesz zaawansowanych reguł cenowych lub raportów opartych na danych z wielu źródeł,
budujesz narzędzie, które ma działać dla wielu sprzedawców,
koszt abonamentu gotowego systemu przy Twojej skali przewyższa koszt utrzymania własnego rozwiązania.

Pamiętaj, że własna integracja to nie jednorazowy projekt. API się zmienia, zasoby są wycofywane i zastępowane nowymi, a ktoś musi monitorować błędy i limity. Z naszej praktyki wynika, że najczęściej najlepiej sprawdza się podejście mieszane: gotowy integrator do podstawowych procesów i małe, własne skrypty do zadań specyficznych dla firmy, np. raportów kosztów. Jeśli zastanawiasz się nad połączeniem sklepu z Allegro, zobacz też artykuł o integracji sklepu z Allegro.

Bezpieczeństwo przy korzystaniu z API

Autoryzując aplikację, dajesz jej dostęp do danych konta, w tym zamówień i danych kupujących. Dlatego udzielaj dostępu tylko zaufanym narzędziom, regularnie przeglądaj listę połączonych aplikacji i odbieraj uprawnienia tym, z których już nie korzystasz. Klucze aplikacji przechowuj bezpiecznie i nie wysyłaj ich mailem. O ochronie konta piszemy szerzej w tekście o bezpieczeństwie konta Allegro.

Najczęściej zadawane pytania

Czy Allegro API jest płatne?

Allegro nie pobiera opłat za samo korzystanie z REST API przez zarejestrowaną aplikację. Płacisz natomiast za narzędzia, które z niego korzystają, albo za pracę programisty przy własnej integracji. Opłaty sprzedażowe, takie jak prowizje, obowiązują niezależnie od sposobu wystawiania.

Czy potrzebuję programisty, żeby korzystać z Allegro API?

Nie, jeśli używasz gotowego integratora – on łączy się z API za Ciebie, a Ty tylko autoryzujesz dostęp. Programista jest potrzebny, gdy chcesz zbudować własną integrację lub nietypowe automatyzacje.

Jak długo ważny jest token Allegro API?

Token dostępu jest ważny 12 godzin, a token odświeżający 3 miesiące. Token odświeżający jest jednorazowy, a każde odświeżenie zwraca nowy token dostępu i nowy token odświeżający.

Czy przez API można wystawiać oferty na allegro.cz i inne rynki?

API obsługuje zarządzanie ofertami, w tym na rynkach zagranicznych Allegro, ale warunkiem jest m.in. powiązanie oferty z produktem z Katalogu. Szczegóły konkretnych zasobów sprawdź w dokumentacji na developer.allegro.pl.

Co się stanie, gdy przekroczę limit zapytań?

Po przekroczeniu głównego limitu 9000 zapytań na minutę Client ID jest blokowany na minutę, a API zwraca błąd 429. Dobrze napisana integracja powinna wtedy odczekać i ponowić zapytanie.

Podsumowanie

Allegro API pozwala zautomatyzować niemal cały proces sprzedaży: od wystawiania ofert i aktualizacji stanów, przez zamówienia i wysyłki, po wiadomości i rozliczenia. Dla większości sprzedawców najlepszym startem jest gotowy integrator, a własne rozwiązania warto budować tam, gdzie standardowe narzędzia nie wystarczają.

Jeśli chcesz sprawdzić, które procesy w Twoim sklepie można zautomatyzować i jakim narzędziem, zobacz naszą usługę automatyzacji i integracji sprzedaży.