Czym różni się integracja na zamówienie od BaseLinkera albo Apilo?

Gotowy integrator daje zestaw połączeń za abonament i działa tak, jak przewidział jego producent. Integracja na zamówienie robi jeden konkretny proces po Twojemu, na przykład z hurtownią, której integrator jeszcze nie obsługuje, albo z regułą cen, której nie da się w nim ustawić. Często najlepsza jest hybryda: integrator zostaje, a na zamówienie powstaje tylko brakujący element.

Czy Allegro ma publiczne API i czy można z niego korzystać bez pośrednika?

Tak. Allegro udostępnia REST API z publiczną dokumentacją na developer.allegro.pl. Własną aplikację może zarejestrować każdy, kto ma konto z włączonym logowaniem dwuetapowym. Pośrednik nie jest wymagany. Firma wdrożeniowa przydaje się wtedy, gdy w firmie nie ma programisty, który napisze integrację i będzie ją utrzymywać.

Jakie dane z Allegro integracja może pobierać i wysyłać?

Pobierać: zamówienia z danymi do wysyłki i do faktury, wiadomości, dyskusje i reklamacje, zwroty, opłaty i rozliczenia. Wysyłać: zmiany cen i stanów, numery przesyłek, faktury, odpowiedzi do kupujących, przesyłki w Wysyłam z Allegro. Integracja dostaje tylko te uprawnienia, które zatwierdzasz przy podłączaniu konta.

Czy integracja może sama dodać fakturę do zamówienia na Allegro?

Tak. API przyjmuje fakturę jako plik PDF do 3 MB albo link do dokumentu (do 10 linków na zamówienie, tylko z domen z listy Allegro). Fakturę wystawia Twój program do faktur, a integracja dołącza ją do zamówienia. Wcześniejszy sposób dodawania faktur Allegro oznaczyło jako wycofywany.

Jak często można aktualizować stany i ceny bez ryzyka blokady?

Główny limit to 9000 zapytań na minutę na aplikację, ale niektóre zasoby mają niższe limity, liczone także osobno dla sprzedawcy. Bezpieczna częstotliwość zależy więc od liczby ofert i od tego, jak często zmienia się towar. Rozsądna integracja wysyła tylko to, co się zmieniło, zbiorczymi poleceniami, i kolejkuje zapytania zamiast ponawiać je bez przerwy.

Co się dzieje, gdy wygaśnie zgoda konta Allegro dla integracji?

Integracja traci dostęp do konta: nie pobiera zamówień i nie wysyła zmian. Token dostępu jest ważny 12 godzin i integracja odświeża go sama, a bez odświeżania zgoda wygasa najpóźniej po 3 miesiącach. Wtedy trzeba ponownie zalogować się do Allegro i zatwierdzić dostęp. Dlatego integracja powinna sama zgłaszać utratę dostępu, zanim zamówienia przestaną spływać.

Czy da się przetestować integrację bez ryzyka dla prawdziwych zamówień?

Tak, na dwa sposoby. Allegro ma sandbox, czyli osobne środowisko testowe, w którym konta, oferty i zamówienia nie są prawdziwe. Gdy proces na to pozwala, pierwsze uruchomienie na Twoim koncie tylko pokazuje, co integracja by zrobiła. Przed użyciem produkcyjnym sprawdzasz działanie (Regulamin usług wdrożeniowych, §3).

Ile kosztuje i ile trwa wdrożenie?

Wycenę przygotowujemy po opisie procesu: ryczałt za uzgodniony zakres albo stawka godzinowa wskazana w ofercie, ceny netto plus VAT (Regulamin usług wdrożeniowych i dedykowanych, §2). Termin podajemy w ofercie i zależy on od tego, jak szybko dostajemy dostępy i dane. Nie podajemy cen z góry, bo integracja z jedną hurtownią i system dla kilku kont to zupełnie inne zakresy.

Integracje Allegro z Twoimi systemami: sklep, faktury, magazyn, kurier, CRM

Zamówienia z Allegro trafiają tam, gdzie pracujesz: do sklepu, programu do faktur, magazynu albo hurtowni. Stany, ceny, numery przesyłek i faktury wracają na Allegro bez przepisywania. Budujemy to na oficjalnym REST API Allegro, na którym działa też nasz własny produkt.

Opisz swój proces Zobacz przebiegi integracji

Zdarzenia zamówień w API Allegro: z ostatnich 60 dni
Faktura do zamówienia przez API: PDF do 3 MB albo link
Token dostępu do konta Allegro: ważny 12 godzin
Zgoda konta bez odświeżania: wygasa najpóźniej po 3 miesiącach

Co łączymy i w którą stronę płyną dane

Integracja to stałe połączenie dwóch programów, które same wymieniają dane. Po stronie Allegro rozmawia z oficjalnym REST API, czyli zestawem adresów, przez które program sprzedawcy pobiera zamówienia i wysyła zmiany. Po drugiej stronie stoi Twój system: sklep internetowy, program do faktur, magazyn, kurier, CRM albo hurtownia.

Dane	Kierunek	Do czego służą
Zamówienia z danymi do wysyłki i do faktury	z Allegro do Ciebie	zamówienie trafia do magazynu, programu do faktur albo hurtowni bez przepisywania
Stany i ceny ofert	od Ciebie do Allegro	oferta nie sprzedaje towaru, którego już nie masz
Numery przesyłek	od Ciebie do Allegro	numer stoi przy zamówieniu, kupujący nie musi o niego pytać
Faktury	od Ciebie do Allegro	dokument trafia do zamówienia jako plik PDF albo link
Wiadomości, dyskusje i reklamacje	w obie strony	rozmowy z kupującymi obok danych zamówienia
Opłaty i rozliczenia	z Allegro do Ciebie	prowizje i opłaty przypisane do zamówień i ofert, np. w raporcie marży

Nie każda integracja potrzebuje wszystkich kierunków. Zaczynamy od jednego przepływu, który dziś zabiera najwięcej ręcznej pracy, a kolejne dopisujemy, gdy pierwszy działa.

Gotowy integrator czy integracja na zamówienie

Uczciwie: w wielu sklepach wystarcza gotowy system, np. Base (BaseLinker), Apilo albo Sellasist. Działa od razu po konfiguracji, ma gotowe połączenia z wieloma sklepami, kurierami i hurtowniami oraz własną pomoc techniczną. Jeśli robi to, czego potrzebujesz, nie ma powodu budować niczego od nowa.

Integracja na zamówienie ma sens, gdy gotowy system nie robi czegoś ważnego, a obejście zabiera czas każdego dnia:

Nowe API hurtowni, którego konektor jeszcze nie obsługuje. Przykład: Ikonka uruchomiła API zamówień w październiku 2026, a połączenie przez platformę Base opisuje jako „już wkrótce”.
Nietypowe reguły cen: marża zależna od kategorii, dostawcy albo kosztu wysyłki.
Program bez wtyczki, np. własny magazyn albo program księgowy, dla którego nikt nie zrobił połączenia z Allegro.
Kilka kont Allegro i magazynów z własną logiką: które konto sprzedaje z którego magazynu.
Jeden brakujący element obok gotowego systemu. Wtedy integrator zostaje, a na zamówienie powstaje tylko ten moduł.

Koszt liczy się inaczej: gotowy system to abonament, integracja na zamówienie to jednorazowa budowa i płatne utrzymanie. Szerzej w artykule BaseLinker czy integracja na zamówienie?

Co umożliwia API Allegro, prostym językiem

Zamówienia

Allegro prowadzi dziennik zdarzeń zamówień: kupiono, uzupełniono dane, gotowe do realizacji, anulowano. Integracja czyta go porcjami, do 1000 zdarzeń naraz, z ostatnich 60 dni. Adres i dane do faktury są pewne dopiero przy zdarzeniu „gotowe do realizacji” (READY_FOR_PROCESSING). Dlatego dobra integracja nie wysyła zamówienia do hurtowni zaraz po kliknięciu „kup”.

Ceny i stany

Ofertę można zmienić pojedynczo albo zbiorczo: jedno polecenie zmienia cenę lub liczbę sztuk w wielu ofertach, a Allegro wykonuje je w tle i raportuje wynik. Osobny dziennik pokazuje zmiany w ofertach z ostatnich 24 godzin.

Wiadomości, dyskusje i reklamacje

Integracja czyta wątki z centrum wiadomości, odpowiada, dołącza załączniki i oznacza wątki jako przeczytane. Dyskusje i reklamacje mają osobne zasoby: lista spraw, odpowiedź, zmiana statusu.

Przesyłki: Wysyłam z Allegro

Przez API da się sprawdzić dostępne usługi dostawy, utworzyć przesyłkę, pobrać etykietę (PDF w formacie A4 albo A6 albo ZPL dla drukarek etykiet), protokół i zamówić odbiór. Numer przesyłki nadanej inną drogą dodaje się do zamówienia osobno.

Faktury

Do zamówienia można dodać fakturę jako plik PDF do 3 MB albo link do dokumentu: do 10 linków na zamówienie, tylko z domen z listy Allegro. Więcej w artykule Faktura do zamówienia Allegro: API i KSeF.

Rozliczenia

Wpisy rozliczeniowe pokazują opłaty i prowizje z filtrem po ofercie, zamówieniu, rodzaju i dacie, a operacje płatnicze są w osobnym zasobie. To podstawa raportu marży, który uwzględnia koszty Allegro, a nie tylko cenę zakupu.

Ograniczenia, o których mówimy przed wyceną

Od tych rzeczy zależy, czy integracja działa spokojnie po wdrożeniu. Lepiej znać je przed decyzją niż po niej.

Limity zapytań. Główny limit to 9000 zapytań na minutę na aplikację. Niektóre zasoby mają niższe limity, a część liczy je osobno dla każdego sprzedawcy. Po przekroczeniu Allegro odpowiada błędem 429 i na minutę blokuje aplikację, więc integracja musi kolejkować zapytania.
Zgoda konta wygasa. Token dostępu jest ważny 12 godzin, a odświeża się go jednorazowym kodem. Bez odświeżania zgoda wygasa najpóźniej po 3 miesiącach. Integracja, która przestanie ją odświeżać, po cichu traci dostęp, dlatego potrzebuje pilnowania, nie tylko wdrożenia.
Dziennik zamówień sięga 60 dni. Zdarzenia mogą przyjść w innej kolejności i w duplikatach, więc integracja musi rozpoznać zamówienie, które już obsłużyła.
Faktura do 3 MB. Większy plik trzeba zmniejszyć albo podać link do dokumentu.
Wycofywane zasoby. Allegro oznacza je w dokumentacji. Przykład: lista usług dostawy w Wysyłam z Allegro ma zniknąć w pierwszym kwartale 2027 roku i ma już zamiennik.
Rejestracja aplikacji wymaga konta z włączonym logowaniem dwuetapowym, a każda aplikacja przedstawia się Allegro własnym identyfikatorem.

Zmiany wprowadzone przez Allegro albo innego dostawcę nie są wadą wykonanej integracji, a jej dostosowanie to osobna, płatna praca. Tak stoi w Regulaminie usług wdrożeniowych i dedykowanych (§5) i dlatego mówimy o tym przed wyceną, a nie po.

Jak pracujemy

Opis procesu. W formularzu na dole strony (albo na stronie zgłoszenia systemu na zamówienie) opisujesz, co dziś robisz ręcznie. Brakujące szczegóły dopytujemy.
Zakres na piśmie i wycena. Wiąże tylko zakres uzgodniony pisemnie. Wynagrodzenie to ryczałt za zakres albo stawka godzinowa wskazana w ofercie (Regulamin, §2).
Test poza prawdziwymi zamówieniami. Allegro ma osobne środowisko testowe (sandbox) z własnymi kontami, w którym oferty i zamówienia nie są prawdziwe. Korzystamy z niego, gdy integracja to umożliwia.
Pierwsze uruchomienie bez skutków, gdy proces na to pozwala. Integracja może najpierw pokazywać, co by zrobiła, zanim zacznie działać naprawdę. Tak działa nasz własny produkt: podgląd, a wysyłkę włącza się osobno dla każdego konta Allegro.
Twoje testy i odbiór. Przed użyciem produkcyjnym sprawdzasz działanie (§3). Na uwagi masz 5 dni roboczych od przekazania do odbioru (§4).
Po odbiorze. Wady w uzgodnionym zakresie, zgłoszone do 14 dni od odbioru, usuwamy bez dopłaty (§4). Stała opieka i rozwój to osobna, płatna umowa (§5).

Na tym samym API działa nasz produkt

SkalujOnline to także gotowy program dla sprzedawców Allegro. Korzysta z tych samych zasobów API, które opisujemy wyżej: wiadomości od kupujących, zamówień, zwrotów, dyskusji i reklamacji oraz danych do raportów sprzedaży. Odświeżanie zgód, limity zapytań, zdarzenia w złej kolejności i wysyłka dopiero po świadomym włączeniu to dla nas codzienna praca, a nie rozdział z dokumentacji.

Jak to wygląda w praktyce, pokazują strony automatyczne wiadomości Allegro i wiadomości po zakupie oraz instrukcja podłączenia konta Allegro.

Pytania, które dostajemy najczęściej

Czym różni się integracja na zamówienie od BaseLinkera albo Apilo?: Gotowy integrator daje zestaw połączeń za abonament i działa tak, jak przewidział jego producent. Integracja na zamówienie robi jeden konkretny proces po Twojemu, na przykład z hurtownią, której integrator jeszcze nie obsługuje, albo z regułą cen, której nie da się w nim ustawić. Często najlepsza jest hybryda: integrator zostaje, a na zamówienie powstaje tylko brakujący element.
Czy Allegro ma publiczne API i czy można z niego korzystać bez pośrednika?: Tak. Allegro udostępnia REST API z publiczną dokumentacją na developer.allegro.pl. Własną aplikację może zarejestrować każdy, kto ma konto z włączonym logowaniem dwuetapowym. Pośrednik nie jest wymagany. Firma wdrożeniowa przydaje się wtedy, gdy w firmie nie ma programisty, który napisze integrację i będzie ją utrzymywać.
Jakie dane z Allegro integracja może pobierać i wysyłać?: Pobierać: zamówienia z danymi do wysyłki i do faktury, wiadomości, dyskusje i reklamacje, zwroty, opłaty i rozliczenia. Wysyłać: zmiany cen i stanów, numery przesyłek, faktury, odpowiedzi do kupujących, przesyłki w Wysyłam z Allegro. Integracja dostaje tylko te uprawnienia, które zatwierdzasz przy podłączaniu konta.
Czy integracja może sama dodać fakturę do zamówienia na Allegro?: Tak. API przyjmuje fakturę jako plik PDF do 3 MB albo link do dokumentu (do 10 linków na zamówienie, tylko z domen z listy Allegro). Fakturę wystawia Twój program do faktur, a integracja dołącza ją do zamówienia. Wcześniejszy sposób dodawania faktur Allegro oznaczyło jako wycofywany.
Jak często można aktualizować stany i ceny bez ryzyka blokady?: Główny limit to 9000 zapytań na minutę na aplikację, ale niektóre zasoby mają niższe limity, liczone także osobno dla sprzedawcy. Bezpieczna częstotliwość zależy więc od liczby ofert i od tego, jak często zmienia się towar. Rozsądna integracja wysyła tylko to, co się zmieniło, zbiorczymi poleceniami, i kolejkuje zapytania zamiast ponawiać je bez przerwy.
Co się dzieje, gdy wygaśnie zgoda konta Allegro dla integracji?: Integracja traci dostęp do konta: nie pobiera zamówień i nie wysyła zmian. Token dostępu jest ważny 12 godzin i integracja odświeża go sama, a bez odświeżania zgoda wygasa najpóźniej po 3 miesiącach. Wtedy trzeba ponownie zalogować się do Allegro i zatwierdzić dostęp. Dlatego integracja powinna sama zgłaszać utratę dostępu, zanim zamówienia przestaną spływać.
Czy da się przetestować integrację bez ryzyka dla prawdziwych zamówień?: Tak, na dwa sposoby. Allegro ma sandbox, czyli osobne środowisko testowe, w którym konta, oferty i zamówienia nie są prawdziwe. Gdy proces na to pozwala, pierwsze uruchomienie na Twoim koncie tylko pokazuje, co integracja by zrobiła. Przed użyciem produkcyjnym sprawdzasz działanie (Regulamin usług wdrożeniowych, §3).
Ile kosztuje i ile trwa wdrożenie?: Wycenę przygotowujemy po opisie procesu: ryczałt za uzgodniony zakres albo stawka godzinowa wskazana w ofercie, ceny netto plus VAT (Regulamin usług wdrożeniowych i dedykowanych, §2). Termin podajemy w ofercie i zależy on od tego, jak szybko dostajemy dostępy i dane. Nie podajemy cen z góry, bo integracja z jedną hurtownią i system dla kilku kont to zupełnie inne zakresy.

Czytaj dalej

Źródła faktów na tej stronie: Allegro: obsługa zamówień, Allegro: zarządzanie ofertami, Allegro: wzorzec Command, Allegro: centrum wiadomości, Allegro: dyskusje i reklamacje, Allegro: Wysyłam z Allegro, Allegro: opłaty, Allegro: uwierzytelnianie i autoryzacja, Allegro: informacje podstawowe i limity, Allegro: dokumentacja REST API, Ikonka: Base Connect, Regulamin usług wdrożeniowych i dedykowanych.

Opisz, co ma się dziać samo. Resztę dopytamy.

Kilka pytań, które zależą od Twoich odpowiedzi. Obok powstaje opis zlecenia, a przed wysłaniem zobaczysz go w całości.

Krok 1 · kilka krótkich pytań

Co chcesz usprawnić?

Wczytuję pytania…