Integracje z marketplace'ami — Allegro
Sprzedaż na Allegro obok własnego sklepu zwykle kończy się jednym katalogiem prowadzonym w dwóch miejscach i arkuszem, który to wszystko spina. Oferty, stany i zamówienia mogą być w tym samym panelu co reszta asortymentu.
Allegro to drugi sklep, prowadzony obok pierwszego
W Polsce sprzedaż zaczyna się zwykle na Allegro, a własny sklep dochodzi później. Po jakimś czasie okazuje się, że ten sam towar żyje w dwóch miejscach: raz jako oferta z sygnaturą, raz jako wariant z SKU, każdy z osobną ceną i wspólnym stanem magazynowym, do którego obie strony roszczą sobie prawo.
Spina to arkusz albo konkretna osoba, która o wszystkim pamięta. Obie metody działają do pierwszego urlopu i do pierwszego dnia z większym ruchem. Rozjazd kończy się tak samo: albo ktoś go wyłapie, albo wyłapie go klient, który kupił coś, czego nie ma.
medusa-allegro jest po to, żeby arkusz przestał być potrzebny. Oferty, ich stany i zamówienia, które z nich wychodzą, są czytane do tego samego panelu Medusy co reszta katalogu, razem z listą rzeczy, które się nie zgadzają.
Sygnatura z jednej strony, SKU z drugiej
Każda oferta ma zewnętrzny identyfikator, czyli sygnaturę, którą ustawia sprzedawca. Dopasowanie polega na zestawieniu jej z SKU wariantu w Medusie i na niczym więcej. Jeżeli sygnatura nie pasuje do niczego albo pasuje niejednoznacznie, oferta trafia na listę konfliktów, zamiast zostać dopasowana za Ciebie.
Ta odmowa zgadywania jest tu najważniejsza. Pomyłka w dopasowaniu nie jest kosmetyczna: wysyła stan magazynowy na żywą ofertę i księguje sprzedaż na niewłaściwym produkcie, a jedno i drugie wychodzi na jaw z opóźnieniem.
Samo wystawianie zostaje po stronie człowieka. Wtyczka nie zakłada ofert i żadnej nie kończy. Czyta to, co już jest w panelu.
Widełki, w których cena ma prawo się ruszać
Tryb monitorujący nie zapisuje nic i odpowiada na jedno pytanie: ile ofert stoi dziś poza swoimi widełkami. Bywa, że jest to pierwsze uczciwe spojrzenie na własny cennik na Allegro.
Tryb domyślny ustawia na każdej ofercie jedną komendę automatu cenowego, w której dolna i górna granica są zakresem reguły. Ceną porusza wtedy mechanizm Allegro, ale tylko w wyznaczonym przedziale. Trzeci tryb bierze cenę z Medusy, porównuje ją z tymi samymi granicami i odmawia wysłania, jeśli wypada poniżej progu albo powyżej ceny sugerowanej.
Wspólne dla wszystkich trzech jest to, że granice są policzone. Dolna to koszt brutto podzielony przez jeden minus stawka prowizji, czyli dokładnie ten punkt, w którym przychód netto schodzi do zera. Górna to cena sugerowana. Wszystko, co integracja może zrobić z ceną, dzieje się między tymi dwiema liczbami.
Na jednym zamówieniu potrafią być trzy różne osoby
To jest ten szczegół, który decyduje o poprawności faktury, i nie widać go, dopóki nie pójdzie źle. W formularzu zakupu Allegro mieszczą się trzy odrębne tożsamości: dane rejestracyjne właściciela konta, których sprzedawca nie zobaczy w swoim własnym panelu; odbiorca przesyłki wpisany przez kupującego, którym bywa współpracownik, ktoś z rodziny albo automat paczkowy; oraz nabywca faktury, którym całkiem legalnie może być jeszcze ktoś inny, na przykład firma płacąca za rzecz wysyłaną gdzie indziej.
Potraktowanie tych trzech jako jednej osoby to najprostsza droga do złej nazwy na fakturze VAT. Adres dostawy idzie na adres wysyłki w Medusie, dane nabywcy na adres rozliczeniowy, a gdy danych do faktury brakuje, zapasowym źródłem jest adres dostawy, nie właściciel konta. NIP czytany jest 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 przychodzą takie, jakie policzyło Allegro, i nie są liczone od nowa. Zaimportowane zamówienia nie dostają też wyliczanych linii podatkowych. To, co marketplace policzył kupującemu, zostaje w zamówieniu bez poprawek.
Zapisy startują wyłączone
Świeża instalacja nie zapisuje niczego. Żaden mechanizm nie ruszy żywej oferty tylko dlatego, że paczka pojawiła się w konfiguracji, a każdy zapis da się przymusowo wyłączyć zmienną środowiskową, co przydaje się na kopii testowej wycelowanej w prawdziwe konto.
Kiedy strona odczytowa się obroni, zapisy włącza się po kolei: stany magazynowe co 15 minut komendą zmiany ilości, zamówienia ze strumienia zdarzeń co 20 sekund, a status realizacji i doklejanie PDF faktury wtedy, gdy będziesz na to gotowy.
To jedna z wtyczek, które rozwijamy otwarcie, opisana razem z pozostałymi na liście naszych wtyczek do Medusy. Możesz przeczytać, co dokładnie robi, zanim cokolwiek zrobi.
Co dostajesz
Podpięcie Twojego konta sprzedawcy
Logowanie przez OAuth 2.0 w wariancie authorization code, callback zabezpieczony przed CSRF, rotacja refresh tokenów i szyfrowanie AES-256-GCM, zanim jakikolwiek token trafi do bazy.
Dopasowanie ofert do wariantów, które da się sprawdzić
Sygnatura oferty zestawiana z SKU wariantu w Medusie. To, co nie dopasuje się jednoznacznie, ląduje na liście konfliktów do rozstrzygnięcia przez człowieka, a nie w domysłach.
Widełki cenowe zamiast wysyłania ceny w ciemno
Próg opłacalności i cena sugerowana wyliczone dla każdej oferty, a do tego trzy tryby działania: sam raport, przekazanie widełek automatowi cenowemu Allegro albo wysyłka ceny sprawdzonej względem obu granic.
Stany magazynowe pilnowane cyklicznie
Dostępna ilość z Medusy trafia na ofertę komendą zmiany stanu w Allegro co 15 minut, więc marketplace przestaje sprzedawać to, czego magazyn już nie ma.
Zamówienia na tej samej liście co reszta
Zdarzenia zamówień z Allegro czytane co 20 sekund. Kwoty i ceny pozycji przychodzą dokładnie takie, jakie policzyło Allegro, i nie są przeliczane ponownie, a zaimportowane zamówienia nie dostają wyliczanych linii podatkowych.
Zapis zwrotny tam, gdzie ma sens
Odsyłanie statusu realizacji i doklejanie PDF faktury do zamówienia w Allegro, włączane osobno, kiedy strona odczytowa działa już na tyle długo, żeby jej ufać.
Jak pracujemy
- 01
Podłączamy konto i potwierdzamy uprawnienia
Integracja działa na Twojej aplikacji Allegro i Twoim koncie sprzedawcy. Najpierw sprawdzamy, czy połączenie i odświeżanie tokenów zachowują się poprawnie, zanim zaczną od nich zależeć jakiekolwiek dane.
- 02
Dopasowujemy katalog przy wyłączonych zapisach
Skanowanie ofert daje dwie listy: oferty spięte z wariantem po sygnaturze i te, które się nie spięły. Ta druga lista jest właściwą pracą i warto ją domknąć, zanim cokolwiek zacznie zapisywać.
- 03
Ceny zaczynamy od trybu obserwacji
Tryb monitorujący nic nie zapisuje i pokazuje, ile ofert stoi dziś poza swoimi widełkami. Ta liczba bywa najciekawszym wynikiem całego wdrożenia, a jej obejrzenie nic nie kosztuje.
- 04
Włączamy zapisy pojedynczo
Najpierw stany, potem zamówienia, na końcu status realizacji. Każdy zapis startuje wyłączony, więc jego uruchomienie jest świadomą decyzją, a zmienna środowiskowa potrafi go wyłączyć z powrotem bez wgrywania nowej wersji.
- 05
Pracujemy na konfliktach, nie na wykresach
Niedopasowane oferty i niedopasowane pozycje zamówień to sygnał, który nie znika. Mówi zwykle więcej o dziurach w katalogu niż o samej integracji, a domykanie go 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
Sklep pudełkowy narzuca własny model danych, własne reguły koszyka i własny harmonogram wydań. Medusa v2 jest frameworkiem, który stoi u Ciebie, więc to, co w Twojej sprzedaży odstaje od szablonu, da się zbudować zamiast obchodzić dookoła.
Automatyzacja cen i kontrola marży
Ceny w walutach obcych, które przeliczają się same każdego dnia po kursie średnim NBP, i koszt zakupu widoczny przy produkcie, dzięki czemu marża jest liczbą w panelu, a nie czymś, co raz na miesiąc składa się w arkuszu.
Fakturowanie i KSeF w sklepie internetowym
Od kwietnia 2026 faktura dla nabywcy z numerem NIP musi trafić do KSeF, a kary za brak wysyłki ruszają w styczniu 2027. Sklep może wystawiać i wysyłać te dokumenty sam, pod warunkiem że w wątpliwych sytuacjach pyta człowieka zamiast zgadywać.
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 postyIle razy dziennie ktoś u Ciebie poprawia stan na Allegro?
Napisz do nasNapisz, jak sygnatury Twoich ofert mają się dziś do katalogu i w których miejscach się rozjeżdżają. Sprawdzimy dopasowanie, widełki cenowe i to, co w ogóle powinno mieć prawo zapisu.
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