Integracja z Allegro - stany, ceny i zamówienia
Sprzedajesz na Allegro i we własnym sklepie? Zwykle oznacza to jeden katalog prowadzony w dwóch miejscach i arkusz, który próbuje je pogodzić. Oferty, stany i zamówienia z Allegro mogą trafiać do tego samego panelu, w którym zarządzasz resztą towaru.
Allegro i własny sklep: jeden towar, dwa katalogi
W Polsce sprzedaż internetowa często zaczyna się na Allegro, a własny sklep pojawia się później. Z czasem ten sam produkt istnieje w dwóch miejscach: jako oferta z sygnaturą i jako wariant z SKU. Każdy ma własną cenę, a stan magazynowy jest wspólny i obie strony z niego korzystają.
Całość trzyma w ryzach arkusz albo jedna osoba, która wszystko pamięta. Działa to do pierwszego urlopu albo do pierwszego dnia z większym ruchem. Rozbieżność zawsze kończy się tak samo: albo ktoś ją zauważy, albo zauważy ją klient, który kupił towar, którego nie ma.
Wtyczka medusa-allegro zastępuje ten arkusz. Oferty, ich stany i zamówienia z Allegro trafiają do tego samego panelu Medusy co reszta katalogu, razem z listą wszystkiego, co się nie zgadza.
Jak łączymy oferty Allegro z produktami w sklepie
Każda oferta ma sygnaturę, czyli zewnętrzny identyfikator nadawany przez sprzedawcę. Integracja porównuje ją z SKU wariantu w Medusie i niczym więcej. Gdy sygnatura nie pasuje do żadnego wariantu albo pasuje do kilku, oferta trafia na listę konfliktów. System nie dopasowuje jej za Ciebie.
To najważniejsza zasada całej integracji. Błędne dopasowanie ma realne skutki: wysyła stan magazynowy na aktywną ofertę i przypisuje sprzedaż do niewłaściwego produktu, a oba problemy wychodzą na jaw z opóźnieniem.
Wystawianie ofert zostaje w rękach człowieka. Wtyczka nie tworzy ofert i żadnej nie kończy, tylko odczytuje to, co już jest w panelu sprzedawcy.
Automatyczne ceny na Allegro, ale w granicach
Integracja ma trzy tryby pracy z cenami:
Monitorowanie. Nic nie zapisuje, tylko pokazuje, ile ofert ma dziś cenę poza widełkami. Dla wielu sprzedawców to pierwszy rzetelny przegląd własnego cennika na Allegro.
Automat cenowy Allegro. Tryb domyślny. Na każdej ofercie ustawia jedną komendę automatu cenowego, w której zakresem reguły są dolna i górna granica. Cenę zmienia mechanizm Allegro, ale wyłącznie w tym przedziale.
Cena z Medusy. Pobiera cenę ze sklepu, sprawdza ją względem tych samych granic i nie wysyła jej, jeśli jest niższa od progu albo wyższa od ceny sugerowanej.
We wszystkich trybach granice są wyliczone. Dolna to koszt brutto podzielony przez jeden minus stawka prowizji, czyli punkt, w którym przychód netto spada do zera. Górna to cena sugerowana. Cokolwiek integracja robi z ceną, mieści się między tymi dwiema liczbami.
Zamówienia z Allegro i dane do faktury
W formularzu zakupu Allegro mogą występować trzy różne osoby i od tego zależy poprawność faktury:
Właściciel konta. Jego danych rejestracyjnych sprzedawca nie widzi nawet we własnym panelu.
Odbiorca przesyłki. Wpisuje go kupujący i może to być współpracownik, ktoś z rodziny albo automat paczkowy.
Nabywca faktury. Całkiem legalnie może to być jeszcze ktoś inny, na przykład firma, która płaci za towar wysyłany pod inny adres.
Traktowanie tych trzech osób jak jednej to najprostszy sposób na błędne dane na fakturze VAT. Dlatego adres dostawy trafia do adresu wysyłki w Medusie, a dane nabywcy do adresu rozliczeniowego. Gdy danych do faktury nie ma, zastępczo używamy adresu dostawy, a nie danych właściciela konta. NIP odczytujemy z ustrukturyzowanych identyfikatorów firmy, z wpisu PL_NIP, a stare płaskie pole zostaje jako zapasowe, bo Allegro nadal je wypełnia.
Kwoty i ceny pozycji zostają takie, jak policzyło je Allegro, bez ponownego przeliczania. Zaimportowane zamówienia nie dostają wyliczanych linii podatkowych. Zamówienie zawiera dokładnie to, co marketplace policzył kupującemu.
Bezpieczne uruchomienie integracji
Po instalacji integracja nie zapisuje niczego. Sama obecność paczki w konfiguracji nie zmieni żadnej aktywnej oferty, a każdy zapis można wymusić jako wyłączony zmienną środowiskową. Przydaje się to na przykład na kopii testowej podłączonej do prawdziwego konta.
Gdy odczyt działa bez zarzutu, włączasz zapisy kolejno: stany magazynowe co 15 minut przez komendę zmiany ilości, zamówienia ze strumienia zdarzeń co 20 sekund, a status realizacji i dołączanie PDF faktury wtedy, gdy uznasz, że czas.
Wtyczkę rozwijamy otwarcie, a jej opis znajdziesz razem z pozostałymi na liście naszych wtyczek do Medusy. Możesz sprawdzić, co dokładnie robi, zanim zrobi cokolwiek w Twoim sklepie.
Co dostajesz
Połączenie z Twoim kontem sprzedawcy
Autoryzacja OAuth 2.0 w wariancie authorization code, callback zabezpieczony przed CSRF, rotacja refresh tokenów i szyfrowanie AES-256-GCM każdego tokenu przed zapisem w bazie.
Oferty dopasowane do wariantów po sygnaturze
Sygnaturę oferty porównujemy z SKU wariantu w Medusie. Jeśli dopasowanie nie jest jednoznaczne, oferta trafia na listę konfliktów do rozstrzygnięcia przez człowieka.
Ceny w wyliczonych widełkach
Dla każdej oferty liczymy próg opłacalności i cenę sugerowaną. Do wyboru są trzy tryby: sam raport, przekazanie widełek automatowi cenowemu Allegro albo wysyłka ceny sprawdzonej względem obu granic.
Stany magazynowe aktualizowane co 15 minut
Dostępna ilość z Medusy trafia na ofertę przez komendę zmiany stanu w Allegro co 15 minut. Allegro przestaje sprzedawać towar, którego nie ma już w magazynie.
Zamówienia z Allegro razem z pozostałymi
Zdarzenia zamówień pobieramy co 20 sekund. Kwoty i ceny pozycji zostają takie, jak policzyło je Allegro, a zaimportowane zamówienia nie dostają wyliczanych linii podatkowych.
Odsyłanie danych do Allegro
Aktualizacja statusu realizacji i dołączanie PDF faktury do zamówienia w Allegro. Włączasz to osobno, gdy odczyt działa już wystarczająco długo, żeby mu zaufać.
Jak pracujemy
- 01
Łączymy konto i sprawdzamy uprawnienia
Integracja korzysta z Twojej aplikacji Allegro i Twojego konta sprzedawcy. Zanim zaczną od niej zależeć jakiekolwiek dane, sprawdzamy, czy połączenie i odświeżanie tokenów działają prawidłowo.
- 02
Dopasowujemy katalog bez zapisywania czegokolwiek
Po skanowaniu ofert powstają dwie listy: oferty połączone z wariantem po sygnaturze i te, których nie udało się połączyć. Druga lista to właściwa praca i trzeba ją domknąć, zanim integracja zacznie cokolwiek zapisywać.
- 03
Ceny najpierw tylko obserwujemy
Tryb monitorujący niczego nie zmienia, a pokazuje, ile ofert ma dziś cenę poza widełkami. Ta liczba bywa najciekawszym wynikiem całego wdrożenia i nic nie kosztuje.
- 04
Włączamy zapisy jeden po drugim
Najpierw stany, potem zamówienia, a na końcu status realizacji. Każdy zapis domyślnie jest wyłączony, więc jego włączenie to świadoma decyzja, a zmienna środowiskowa pozwala go wyłączyć bez wgrywania nowej wersji.
- 05
Rozwiązujemy konflikty
Niedopasowane oferty i pozycje zamówień nie znikają same. Zwykle pokazują luki w katalogu, a nie w integracji, i ich domykanie utrzymuje oba systemy w zgodzie.
Narzędzia i technologie
Tam, gdzie istnieje dobre narzędzie open source, wybieramy je zamiast zamkniętego. Bez uzależnienia od jednego dostawcy i z kosztami, które da się przewidzieć.
- Medusa v2
- Allegro API
- OAuth 2.0
- TypeScript
- Node.js
- PostgreSQL
- Redis
- Next.js
- medusa-allegro
- medusa-admin-kit
Najczęściej zadawane pytania
Pozostałe usługi w tej kategorii
Wdrożenia headless commerce na Medusie
Medusa v2 to framework e-commerce, który instalujesz u siebie, a nie abonament z gotowym szablonem. Sprawdza się tam, gdzie sposób sprzedaży nie mieści się w ustawieniach platformy i trzeba go zaprogramować, zamiast obchodzić.
Automatyzacja cen i kontrola marży
Sklep sam przelicza ceny w euro i dolarach po średnim kursie NBP, a koszt zakupu widać przy każdym produkcie. Marżę sprawdzasz w panelu od ręki, zamiast raz w miesiącu składać ją w arkuszu.
Fakturowanie i KSeF w sklepie internetowym
Od kwietnia 2026 faktura dla firmy z NIP musi trafić do KSeF, a od stycznia 2027 za brak wysyłki grożą kary. Sklep może wystawiać i wysyłać faktury automatycznie, jeśli w niejasnych sytuacjach zostawia decyzję człowiekowi.
Przeczytaj opinie firm, które nam zaufały
Dostarczone znacznie wcześniej niż termin.
Indywidualne podejście ZanReal jest imponujące.
Wiedza i intuicja biznesowa czynią ich wartościowym partnerem.
Szybkie rozwiązania, które obniżyły koszty o 99%.
+20% dostarczalności dla naszych kampanii e-mail.
Najnowsze
Poradniki techniczne, bezpieczeństwo i nasze doświadczenia z budowania rozwiązań AI.
Ciekawi Cię, co dalej?
Zobacz wszystkie postyJak często ktoś u Ciebie ręcznie poprawia stany na Allegro?
Napisz do nasOpisz, jak sygnatury ofert odpowiadają dziś SKU w katalogu i gdzie się nie zgadzają. Przejrzymy dopasowanie, widełki cenowe i to, co integracja powinna mieć prawo zapisywać.
Nie nadążasz za zmianami w świecie AI?
Pozwól, że weźmiemy to na siebie. Co tydzień destylujemy najważniejsze wydarzenia ze świata AI w skupiony, 5-minutowy przegląd - żebyś był na bieżąco bez szumu.
Dowiedz się więcej