Integracja Allegro w Hummerce łączy sklep bezpośrednio z kontem sprzedawcy na Allegro, bez pośredników. Sklep wystawia i aktualizuje oferty, pobiera zamówienia z Allegro, a do Allegro odsyła statusy, numery przesyłek i dokumenty sprzedaży. Dział marketplace obsługuje wszystko w jednym panelu, zamiast przełączać się między dwoma systemami.
Stan na wersję Hummerce 2.32-2.35 (ostatnie zmiany w module: 2.35.55), aktualizacja 2026-10-07.
- Jeden panel dla sklepu i Allegro - oferty, zamówienia i ich obsługa bez logowania do Allegro przy codziennej pracy.
- Bez overbookingu - stan oferty wynika ze stanu magazynu sklepu, a limity minimalnej i maksymalnej ilości chronią przed pokazaniem całego magazynu na kilku kontach naraz.
- Szybsza wysyłka i mniej pytań kupujących - status i numer przesyłki trafiają do Allegro automatycznie.
- Faktury w Allegro bez ręcznego wgrywania - kupujący pobiera dokument bezpośrednio w Allegro.
- Masowa praca na ofertach - zmiana cennika wysyłek, czasu wysyłki, stawki VAT, opisów i zdjęć z szablonu dla setek ofert naraz.
- Zgodność z wymaganiami Allegro - informacje o bezpieczeństwie produktu (GPSR), oznaczenie Business, identyfikacja aplikacji, deklaracja zdjęć tworzonych przez AI.
- Wiele kont sprzedawców (np. osobne marki) w jednym sklepie, z własnym widokiem i mapowaniem dostaw.
- Bez opłat za pośrednika integracyjnego - integracja korzysta bezpośrednio z REST API Allegro.
- Szybka diagnoza problemów ("dlaczego to zamówienie nie spłynęło") w panelu diagnostycznym i przez asystenta AI (MCP).
Zrzuty z panelu sklepu demonstracyjnego Hummerce (Allegro w trybie testowym).




- Sklep łączy się z Allegro przez aplikację zarejestrowaną w portalu deweloperskim Allegro. Dane aplikacji wpisuje się w konfiguracji modułu albo w osobnej sekcji na sytuacje wyjątkowe.
- Integracja przełącza się między środowiskiem testowym Allegro (sandbox) a produkcyjnym - wdrożenie zaczynamy w trybie testowym.
- Jeden sklep może obsługiwać wiele kont sprzedawców Allegro. Każde konto:
- autoryzuje się raz w Allegro (kod urządzenia) - status autoryzacji widać na liście kont (np. "Oczekujący", "Autoryzowany", "Token wygasł", "Cofnięty"),
- ma własne mapowanie dostaw, opcjonalnie własny widok i własny zestaw danych aplikacji,
- ma osobne przełączniki na pobieranie zdarzeń i zamówień, pobieranie ofert, aktualizację ofert i aktualizację stanów magazynowych - dzięki nim konto można najpierw skonfigurować, a dopiero potem uruchomić wymianę danych,
- może zacząć pobieranie od wskazanego zdarzenia Allegro, żeby nie pobrać drugi raz zamówień obsłużonych wcześniej przez inną integrację.
- Tokeny odświeżają się automatycznie. Gdy konto straci autoryzację, sklep wysyła powiadomienie e-mail z linkiem do ponownej autoryzacji.
- Zarządzanie ofertami pokazuje oferty wszystkich kont: numer oferty, towar w sklepie, status w Allegro, status wysyłki, cenę, stan magazynowy, konto sprzedawcy.
- Oferty istniejące w Allegro sklep importuje i wiąże z towarami po symbolu towaru w sklepie. Ofertę bez takiego powiązania można powiązać z towarem ręcznie - wtedy zamówienia z tej oferty też trafiają do sklepu.
- Nową ofertę tworzy się w panelu na podstawie towaru. Produkt dobiera się z katalogu Allegro po kodzie EAN; jeśli EAN pasuje do kilku produktów, panel prosi o wybór. Ofertę można zapisać razem z nowym towarem w sklepie.
- Cena i parametry oferty pochodzą z widoku wskazanego jako widok Allegro Marketplace. Cenę można zmienić na liście ofert; ustawienie synchronizacji decyduje, czy cena oferty ma podążać za ceną w sklepie.
- Stan magazynowy oferty podąża za stanem towaru w sklepie, w granicach minimalnej i maksymalnej ilości ustawionej w konfiguracji. Kilka ofert (np. na różnych kontach) może korzystać z tego samego stanu towaru.
- Wyszukiwanie ofert: po numerze oferty, symbolu i nazwie towaru w sklepie, tytule oferty Allegro, dowolnych właściwościach towaru, statusach, koncie i stawce VAT.
- Operacje grupowe na zaznaczonych ofertach: aktualizacja zdjęć i opisu na podstawie szablonu, zmiana czasu wysyłki, zmiana cennika wysyłek (wymaga przefiltrowania listy po koncie sprzedawcy, bo cenniki są przypisane do konta w Allegro), aktualizacja stawki VAT, zakończenie oferty, wystawienie ponownie. Operacje grupowe Allegro wykonuje asynchronicznie - sklep sprawdza wynik osobnym zadaniem.
- Zakończone oferty znikają z listy po liczbie dni ustawionej w konfiguracji.
- Oferty (także zdjęcia i opisy na podstawie szablonów) można eksportować i aktualizować plikiem Excel w Operacjach grupowych na towarach.
- Szablon opisu składa się z wierszy o wybranym układzie: tekst, zdjęcie, tekst ze zdjęciem, zdjęcie z tekstem, dwa zdjęcia - zgodnie z układami opisu, które przyjmuje Allegro.
- Do wierszy wstawia się dane towaru (nazwa, opis, parametry) i zdjęcia marketplace towaru, więc jeden szablon obsługuje wiele ofert.
- Szablon sprawdza się na przykładowym towarze przed użyciem. Przypisuje się go do oferty albo stosuje operacją grupową na wielu ofertach. Nazwa szablonu może mieć wersję w kilku językach panelu.
- Gdy towaru nie ma w katalogu produktów Allegro, sklep może zgłosić go jako propozycję nowego produktu, z przypisaniem do konta sprzedawcy i towaru w sklepie.
- Sklep cyklicznie sprawdza w Allegro status propozycji. Panel ostrzega, gdy propozycja dla produktu już istnieje.
- W ofercie przekazywany jest producent, podmiot odpowiedzialny (osoba lub producent odpowiedzialny) i informacje o bezpieczeństwie produktu - jako treść albo jako załącznik typu "Instrukcja dotycząca bezpieczeństwa".
- Załączniki (np. instrukcja obsługi, etykieta energetyczna, karta produktu) sklep wysyła z plików zapisanych w parametrach towaru - które parametry odpowiadają którym typom załączników, określa mapowanie w konfiguracji.
- Allegro nie pozwala usuwać załączników przez API - sklep oznacza je tylko do usunięcia.
- Gdy w Allegro włączona jest weryfikacja zaufanych treści (TrustedContent), sklep nie nadpisuje pól zablokowanych przez Allegro.
- Na ofercie można zaznaczyć, że jej zdjęcia zostały wygenerowane lub istotnie zmienione przez sztuczną inteligencję. Po zaznaczeniu sklep deklaruje w Allegro wszystkie zdjęcia oferty jako stworzone lub istotnie zmienione przez AI (deklaracja zgodna z mechanizmem AI Act w API Allegro).
- Deklaracja jest wysyłana do Allegro tylko wtedy, gdy włączone jest ustawienie Deklaracja zdjęć AI (aiCoCreatedContent) włączona. Domyślnie jest wyłączone, bo Allegro nie honorowało jeszcze tego pola - bez włączenia ustawienia sklep nie wysyła deklaracji, nawet dla oferty z zaznaczonym polem.
- Odpowiedzialność za prawdziwość deklaracji ponosi sprzedawca - sklep przekazuje oznaczenie, nie ocenia zdjęć.
- Oferta z przekazaną stawką VAT jest oznaczona w Allegro jako dostępna dla klientów biznesowych ("Business").
- Stawkę sklep wysyła przy tworzeniu i przy każdej aktualizacji oferty. Na liście ofert można wyszukać oferty ze stawką i bez niej i uzupełnić stawkę operacją grupową.
- Sklep pobiera z Allegro zdarzenia zamówień wybranych typów - domyślnie: opłacone i gotowe do realizacji, anulowane przez kupującego, anulowane automatycznie.
- Zamówienie w sklepie dostaje: dane kupującego (imię, nazwisko, firma, e-mail, telefon, login Allegro), adres dostawy i dane do faktury (w tym NIP), punkt odbioru (np. paczkomat), sposób dostawy według mapowania dostaw Allegro na dostawy sklepu, sposób płatności, wiadomość kupującego do sprzedawcy, numer transakcji i płatności w Allegro, źródło zamówienia i widok.
- Anulowanie zamówienia w Allegro anuluje zamówienie w sklepie.
- Dalsza obsługa to zwykła obsługa zamówienia w panelu, także przekazanie do ERP.
- Maile ze sklepu do kupującego z Allegro są domyślnie wyłączone, bo kupującego informuje Allegro - można je włączyć osobnym ustawieniem.
- Każdy sposób dostawy Allegro trzeba przypisać do sposobu dostawy w sklepie (mapowanie w koncie sprzedawcy). Kilka dostaw Allegro może wskazywać tę samą dostawę sklepu.
- Najprościej zmapować dostawy po pierwszym pobraniu zamówień - niezmapowane dostawy pojawiają się jako błędy z identyfikatorami Allegro. Gotowe mapowanie można skopiować z innego konta sprzedawcy.
- Domyślny typ dostawy w konfiguracji przypisuje dostawę zamówieniom bez mapowania, ale wtedy sklep nie zgłasza braków w mapowaniu.
- Zamówienie, którego nie da się zaimportować (brak mapowania dostawy, brak towaru w sklepie, oferta bez powiązania z towarem), trafia na listę błędów konta z pełną treścią odpowiedzi Allegro. Po usunięciu przyczyny błędy resetuje się i zamówienie pobiera się ponownie.
- Usunięcie błędu z listy oznacza ignorowanie go w przyszłości - stosuje się je tylko do błędów, których nie da się naprawić.
- Zamówienia z towarami, których nie ma jeszcze w sklepie, można mimo to zaimportować - osobnym ustawieniem w konfiguracji (domyślnie wyłączone).
- Zmiana statusu zamówienia w sklepie wysyła status realizacji do Allegro: zamówienie złożone - "w realizacji", gotowe do wysyłki - "gotowe do wysłania", wysłane - "wysłane", anulowane - "anulowane".
- Numer przesyłki nadany w sklepie (także przez integrację z kurierem) trafia do zamówienia w Allegro, więc kupujący może śledzić paczkę. Numer można też przypisać ręcznie w panelu diagnostycznym.
- Dokument sprzedaży (np. faktura) dołączony do zamówienia w sklepie trafia do zamówienia w Allegro razem z numerem dokumentu - warunkiem jest, że dokument jest zapisany w zamówieniu w sklepie, zwykle z systemu ERP.
- Sklep nie odsyła do Allegro zmian, które przyszły z Allegro - nie ma pętli statusów.
Wymianę danych wykonują zadania w harmonogramie sklepu - każde z nich można osobno wyłączyć w konfiguracji: pobieranie zdarzeń, import zamówień, import ofert, pobieranie treści ofert, aktualizacja ofert, eksport stanów magazynowych, eksport statusów zamówień, eksport numerów przesyłek, wysyłka dokumentów, sprawdzanie poleceń w Allegro, pakiety promocyjne ofert, propozycje produktów, usuwanie zakończonych ofert.
Panel diagnostyczny pozwala ręcznie przypisać numer listu przewozowego do zamówienia z Allegro oraz sprawdzić, czy sklep zapisał i przetworzył wszystkie zdarzenia z konta Allegro za wskazany okres (Allegro udostępnia zdarzenia z ostatnich 60 dni). Samo sprawdzenie niczego nie zmienia. Jeśli panel wskaże zdarzenia, których sklep nie ma pod żadnym kontem, przycisk Pobierz i zapisz brakujące (dostępny tylko dla wybranych użytkowników panelu, od wersji 2.35.44) dociąga je i zapisuje - dzięki temu można odzyskać zamówienia po utracie autoryzacji konta. Zdarzeń zapisanych pod innym kontem ta operacja nie zmienia, a zamówienia nie dublują się. Dociągnięte zdarzenia sklep przetwarza w zwykłym imporcie zamówień. Panel pokazuje też listę zdarzeń z filtrem po statusie, koncie i numerze zamówienia Allegro oraz statystyki zapytań do Allegro.
- Od wersji 2.32 - pobieranie zamówień, aktualizacja stanów magazynowych i statusów zamówień w Allegro.
- Od wersji 2.33 - zarządzanie ofertami (lista, edycja ceny i stanu, operacje grupowe, w tym zmiana cennika wysyłek), szablony ofert, propozycje produktów, panel diagnostyczny, eksport numerów przesyłek, informacje o bezpieczeństwie produktu i podmiocie odpowiedzialnym, dokumenty sprzedaży.
- Od wersji 2.34 - załączniki o bezpieczeństwie produktu, stawka VAT w ofertach (filtr i operacja grupowa na liście ofert).
- Od wersji 2.35 - własny identyfikator aplikacji (User-Agent) i poprawne oznaczenie "Business" przy aktualizacji oferty.
- Od wersji 2.35.23 - deklaracja zdjęć tworzonych przez AI (AI Act) na ofercie.
- Od wersji 2.35.44 - dociąganie brakujących zdarzeń i zamówień w panelu diagnostycznym.
- Ostatnie zmiany w module: wersja 2.35.55.
- Konto sprzedawcy Allegro (firmowe) i aplikacja zarejestrowana w portalu deweloperskim Allegro - zakłada je sklep albo my w ramach wdrożenia.
- Sposoby dostawy i płatności w sklepie odpowiadające dostawom Allegro.
- Towary w sklepie z symbolem zgodnym z sygnaturą ofert Allegro, a przy wystawianiu nowych ofert - z kodem EAN.
- Stany magazynowe w sklepie aktualne na bieżąco (Magazyn) - od nich zależą stany ofert.
- Dokumenty sprzedaży w Allegro - dokument musi trafiać do zamówienia w sklepie (zwykle z ERP).
- Harmonogram zadań sklepu - zadania modułu muszą być uruchomione.
- Integracja działa tylko w panelu - nie wymaga zmian w szablonie sklepu.
- Wymaga wdrożenia - moduł włączamy w konfiguracji konkretnego sklepu. Zakres:
- włączenie modułu i zadań w harmonogramie,
- aplikacja w portalu deweloperskim Allegro (testowa i produkcyjna) i konfiguracja integracji: widok, płatności, źródło zamówień, limity stanów, zdarzenia,
- dodanie i autoryzacja kont sprzedawców,
- mapowanie dostaw i płatności,
- import istniejących ofert i powiązanie ich z towarami,
- ustalenie punktu startu pobierania zamówień, gdy sklep przechodzi z innej integracji,
- testy w środowisku testowym Allegro, przełączenie w tryb produkcyjny i kontrola pierwszych zamówień.
- Minimalny szacowany czas:
- jedno konto sprzedawcy, oferty z poprawnymi sygnaturami, bez nowych ofert i dokumentów sprzedaży - od 16 h, niezależnie od szablonu sklepu (integracja nie zmienia frontu).
- Czas konkretnego wdrożenia zależy od jego zakresu - wyceniamy go indywidualnie.
- Od czego zależy czas:
- liczba kont sprzedawców i sposobów dostawy do zmapowania,
- liczba ofert bez powiązania z towarem do ręcznego dopasowania,
- wystawianie nowych ofert ze sklepu: szablony opisów, parametry kategorii Allegro, zdjęcia, GPSR i załączniki,
- przejście z innej integracji bez dublowania zamówień,
- przekazywanie dokumentów sprzedaży - zależy od tego, jak dokumenty trafiają do zamówień (integracja z ERP wyceniana osobno),
- wersja sklepu - starsza wersja wymaga najpierw aktualizacji (wycena osobno).
- Integracja obsługuje tylko allegro.pl - bez serwisów Allegro w innych krajach.
- Brak obsługi zwrotów i reklamacji zgłaszanych w Allegro, wiadomości od kupujących (poza wiadomością dołączoną do zamówienia) i ocen sprzedawcy - te sprawy obsługuje się w Allegro.
- Brak tworzenia kampanii i promocji Allegro - sklep tylko odczytuje włączone pakiety promocyjne ofert.
- Brak obsługi ofert wariantowych (zestawów wariantów Allegro) i zestawów towarów.
- Warunki zwrotów, reklamacji i cenniki dostaw sklep pobiera z konta Allegro - tworzy się je w Allegro, nie w sklepie.
- Zamówienie z oferty bez powiązanego towaru nie trafi do sklepu, dopóki oferta nie zostanie powiązana z towarem (albo nie włączymy importu mimo braku towarów).
- Usunięcie błędu z listy błędów konta oznacza trwałe ignorowanie - źle użyte może ukryć zamówienia, które powinny spłynąć.
- Allegro nie pozwala usunąć przez API wysłanych załączników oferty.
- Operacje grupowe i część zmian Allegro wykonuje z opóźnieniem - wynik widać po kolejnym przebiegu zadań.
- Dokument sprzedaży trafia do Allegro tylko wtedy, gdy jest zapisany w zamówieniu w sklepie - moduł nie wystawia faktur.
- Statusy płatności nie są przekazywane do Allegro - płatność obsługuje Allegro.
- Brak operacji Allegro w REST API sklepu; narzędzia MCP tylko odczytują dane.
- Nie weryfikujemy konfiguracji pod kątem zgodności z prawem i regulaminem Allegro - treść ofert, dane GPSR, stawki VAT i warunki sprzedaży ustala sprzedawca.
- Obsługa zwrotów i reklamacji Allegro w module zwrotów sklepu.
- Wiadomości i dyskusje z kupującymi w panelu.
- Oferty wariantowe i zestawy.
- Serwisy Allegro w innych krajach (allegro.cz, allegro.sk, allegro.hu).
- Operacje Allegro w REST API i narzędzia MCP do zmian (np. ceny, cenniki wysyłek).
- Włączenie deklaracji zdjęć tworzonych przez AI jako domyślnej - mechanizm jest gotowy, ale pozostaje wyłączony do czasu obsługi pola po stronie Allegro.
- Aktualizacja producentów i osób odpowiedzialnych z pliku dla wielu towarów naraz.
Czy integracja obsługuje kilka kont sprzedawców Allegro w jednym sklepie?
Tak. Każde konto ma własną autoryzację, mapowanie dostaw i - opcjonalnie - własny widok, więc można obsłużyć np. kilka marek z jednego sklepu.
Czy trzeba płacić za pośrednika integracyjnego (np. BaseLinker)?
Nie. Integracja korzysta bezpośrednio z REST API Allegro, bez zewnętrznego pośrednika i jego opłat.
Ile trwa uruchomienie integracji z Allegro?
Minimalnie od 16 h - jedno konto sprzedawcy, oferty z poprawnymi sygnaturami, bez nowych ofert i dokumentów sprzedaży. Zakres szerszy (kolejne konta, nowe oferty, integracja z ERP) wyceniamy indywidualnie.
Czy sklep obsługuje zwroty i reklamacje zgłoszone w Allegro?
Nie. Zwroty, reklamacje, wiadomości od kupujących i oceny sprzedawcy obsługuje się bezpośrednio w Allegro.
Czy integracja działa z Allegro w innych krajach (np. Czechy, Słowacja)?
Nie. Integracja obsługuje tylko allegro.pl.
Czy status płatności trafia do Allegro?
Nie. Płatność obsługuje samo Allegro - sklep wysyła tylko status realizacji, numer przesyłki i dokument sprzedaży.
Chcesz zobaczyć, jak integracja z Allegro może działać w Waszym sklepie? Umów bezpłatną prezentację.
- Panel, sekcja Allegro:
- Zarządzanie ofertami - lista ofert, edycja, operacje grupowe,
- Szablony ofert - szablony opisów,
- Propozycje produktów - zgłoszenia produktów do katalogu Allegro,
- Konta sprzedawców - autoryzacja, mapowanie dostaw, błędy, przełączniki wymiany danych,
- Panel diagnostyczny,
- Aplikacje - dodatkowe zestawy danych aplikacji Allegro.
- Konfiguracja w panelu: Konfiguracja -> Ustawienia, grupa Allegro API, m.in.:
- Typ płatności, Typ 'płatności przy odbiorze', Domyślny typ dostawy,
- Importuj zamówienia z pomimo braku zmapowanych towarów w sklepie - domyślnie nie,
- Domyślne źródło zamówień, Importuj źródło zamówień,
- Włącz powiadomienia email dla zamówień z Allegro,
- Tryb API (test / produkcja) i adresy API,
- Widok Allegro Marketplace - widok zamówień z Allegro oraz źródło cen i parametrów ofert,
- Minimalna ilość stanu magazynowego, Maksymalna ilość stanu magazynowego, Wyłącz limity ilości dla dedykowanych ofert,
- Typ zdarzeń powiązanych z zamówieniami z serwisu Allegro, Limit zdarzeń,
- Włącz selektywne aktualizacje ofert i Dozwolone identyfikatory ofert do aktualizacji - aktualizacja tylko wskazanych ofert, przydatne na czas testów,
- Ilość dni od zakończenia oferty do jej usunięcia z listy,
- Domyślne konto Allegro, Mapowanie parametrów załączników, Niestandardowy identyfikator User-Agent,
- Deklaracja zdjęć AI (aiCoCreatedContent) włączona - domyślnie wyłączone,
- włączniki poszczególnych zadań automatycznych.
- Zamówienie: źródło "allegro" na liście zamówień, parametry z danymi transakcji Allegro (zobacz Parametry niżej).
- Transfer danych: "Oferty allegro (xls - excel)" oraz "Oferty allegro - aktualizacja zdjęć i opisów na podstawie szablonów (xls - excel)".
- Historia: zmiany ofert zapisują się w historii obiektu.
- REST API: brak operacji Allegro w REST API sklepu.
- MCP (Asystent AI - serwer MCP):
ec2_allegro_status - tryb (test/produkcja), czy dane aplikacji są ustawione (bez ujawniania sekretu), stan zadań Allegro,
ec2_allegro_offers - lista ofert znanych sklepowi.
- Historię oferty zwraca
ec2_history_list (obiekt allegroOffer), przebieg zadania - ec2_task_log.
- Narzędzia tylko odczytują dane i wymagają uprawnień do konfiguracji Allegro lub panelu diagnostycznego (dla ofert - uprawnień do ofert Allegro).
Integracja nie ma komunikatów w sklepie - opisy ofert powstają z szablonów ofert i danych towaru. Szablony maili i alerty zmienia się osobno.
| Alert |
Odbiorca |
Kiedy |
allegroUserNotAuthorisedAlert ("Powiadomienie o braku autoryzacji") |
adres ustawiony w alercie |
konto sprzedawcy straciło autoryzację w Allegro |
Zmienne w szablonie: $seller (także $allegroUser) - konto sprzedawcy Allegro, $authUrl - link do ponownej autoryzacji konta, $allegroUserUrl - link do konta w panelu, $adminUrl - adres panelu.
Parametry i ich lokacje zmienia się w Parametrach i lokacjach.
| Lokacja |
Obiekt |
Przeznaczenie |
| Zdjęcia Marketplace |
towar |
zdjęcia towaru używane w ofertach i szablonach ofert |
| Symbol |
Obiekt |
Przeznaczenie |
allegro_transaction_id |
zamówienie |
numer zamówienia w Allegro |
external_payment_id |
zamówienie |
numer płatności w Allegro |
allegro_login |
zamówienie |
login kupującego |
_allegroMessageToSeller |
zamówienie |
wiadomość kupującego do sprzedawcy |
_allegroDeliveryMethod, _allegroDeliveryMethodId |
zamówienie |
sposób dostawy wybrany w Allegro |
_allegroSellerUser |
zamówienie |
konto sprzedawcy, z którego przyszło zamówienie |
_allegroWaybillNumber |
zamówienie |
numer przesyłki przekazany do Allegro |
_allegroApiErrorMessage |
zamówienie |
ostatni błąd wymiany danych z Allegro |
allegro_deal_id |
pozycja zamówienia |
numer oferty Allegro |
_allegroAiCoCreatedImages |
oferta |
oznaczenie, że zdjęcia oferty zostały wygenerowane lub istotnie zmienione przez AI (deklaracja AI Act) |
Parametry towaru z plikami (instrukcje, załączniki o bezpieczeństwie) wskazuje się w mapowaniu parametrów załączników, np. symbolParametru=SAFETY_INFORMATION_MANUAL;symbolParametru2=MANUAL.