Sprzedaż ponad stan najczęściej nie wynika z jednego dużego błędu, lecz z kilku drobnych rozbieżności: zamówienie nie zostało jeszcze zarezerwowane, oferta korzysta z innego kodu produktu, zwrot nie wrócił do dostępnej puli albo aktualizacja zatrzymała się na kilka minut. Skuteczna synchronizacja stanów magazynowych z Allegro wymaga więc nie tylko podłączenia integratora, ale też zdefiniowania źródła prawdy, poprawnego mapowania produktów, rezerwowania towaru i regularnej kontroli wyjątków.
Najbezpieczniejszy model zakłada, że Allegro otrzymuje stan możliwy do sprzedaży, a nie przypadkową liczbę widoczną w kartotece magazynowej. Tę wartość trzeba wyliczać według stałej reguły, testować w warunkach rzeczywistej sprzedaży i zabezpieczać buforem tam, gdzie nawet krótka zwłoka może spowodować problem.
Krok 1. Zdefiniuj, jaki stan ma być pokazywany na Allegro
Oddziel stan fizyczny, dostępny, zarezerwowany i możliwy do sprzedaży
Pierwszym krokiem jest rozdzielenie pojęć, które w wielu firmach są używane zamiennie. Stan fizyczny oznacza liczbę sztuk znajdujących się w magazynie lub w innych lokalizacjach firmy. Nie mówi jednak, ile produktów można bezpiecznie zaoferować klientowi. Część towaru może być już przypisana do zamówień, znajdować się w kompletacji, czekać na kontrolę jakości albo być odłożona dla klienta odbierającego zakup osobiście.
Stan zarezerwowany obejmuje sztuki przypisane do zamówień, których realizacja nie została jeszcze zakończona. W zależności od modelu sprzedaży rezerwacja może powstać już po złożeniu zamówienia, po opłaceniu, po pozytywnej autoryzacji płatności albo dopiero po ręcznym potwierdzeniu przez pracownika. Nie ma jednej uniwersalnej reguły. Istotne jest, aby wybrać jedną i stosować ją konsekwentnie we wszystkich kanałach.
Stan dostępny to część zapasu, która nie jest zarezerwowana ani zablokowana. Natomiast stan do publikacji może być jeszcze niższy, jeśli firma stosuje bufor bezpieczeństwa. Przykładowa reguła wygląda tak:
stan do publikacji = stan fizyczny – rezerwacje – blokady jakościowe – bufor bezpieczeństwa
Jeżeli na półce znajdują się cztery sztuki, jedna została przypisana do opłaconego zamówienia, a jedna czeka na kontrolę, rzeczywisty stan dostępny wynosi dwie sztuki. Gdy firma chce pozostawić jedną sztukę awaryjną na wypadek opóźnionej synchronizacji, Allegro powinno otrzymać informację o jednej sztuce, a nie o czterech.
Nie należy bezrefleksyjnie publikować wartości nazwanej w systemie „stanem magazynowym”. W jednym programie będzie to liczba fizycznych produktów, w innym stan pomniejszony o rezerwacje, a w jeszcze innym wartość wynikająca wyłącznie z ostatniego spisu. Przed konfiguracją integracji trzeba ustalić, co dokładnie oznacza każde pole.
Co sprawdzić przed przejściem dalej
- Czy system źródłowy rozróżnia stan fizyczny, dostępny i zarezerwowany?
- Czy rezerwacja powstaje w momencie, który odpowiada rzeczywistemu ryzyku sprzedaży?
- Czy paczki skompletowane, ale niewysłane, nadal zmniejszają stan możliwy do sprzedaży?
- Czy towary uszkodzone, reklamacyjne i przeznaczone do kontroli są wyłączone z publikowanej puli?
- Czy wzór obliczania stanu do Allegro jest opisany i zrozumiały dla osób obsługujących sprzedaż?
Ustal źródło prawdy dla stanów magazynowych
W każdej integracji powinien istnieć jeden system, który decyduje, ile sztuk jest dostępnych. Może nim być ERP, WMS, program magazynowy, platforma e-commerce albo integrator pełniący funkcję centralnego systemu sprzedaży. Allegro powinno otrzymywać dane z tego źródła, a nie konkurować z nim o prawo do edycji stanu.
Najczęściej bezpieczny schemat wygląda następująco: przyjęcie towaru aktualizuje ERP lub WMS, zamówienie z Allegro trafia do systemu centralnego, system rezerwuje produkt, a następnie integracja przekazuje nowy stan do Allegro, sklepu internetowego i pozostałych kanałów. Jeżeli pracownik zmieni liczbę sztuk bezpośrednio w panelu Allegro, a system magazynowy nie otrzyma tej informacji, przy najbliższej synchronizacji ręczna korekta może zostać nadpisana.
Ręczna zmiana w Allegro może być dopuszczalna jako awaryjna procedura, ale powinna mieć jasno określony cel i czas obowiązywania. Jeżeli przykładowo magazyn wykryje uszkodzenie ostatniej sztuki, pracownik może tymczasowo zakończyć ofertę, lecz równolegle powinien skorygować kartotekę w systemie źródłowym. Inaczej oferta może zostać automatycznie wznowiona podczas kolejnej aktualizacji.
Warto przeczytać również powiązany artykuł: Dlaczego ten sam kolor nie zawsze wygląda tak samo? O powtarzalności produktów w produk….
Trzeba także spisać operacje, które mogą zmienić stan: przyjęcia z dostaw, sprzedaż, anulowania, zwroty, reklamacje, przesunięcia między magazynami, korekty inwentaryzacyjne, utylizacja i produkty przekazane do serwisu. Pominięcie jednej z nich prowadzi do narastającej różnicy między systemem a rzeczywistością.
Co sprawdzić w architekturze danych
- Czy istnieje dokładnie jeden system nadrzędny dla stanów?
- Czy wszystkie kanały sprzedaży pobierają dane z tego samego źródła?
- Czy ręczna edycja w Allegro jest ograniczona do sytuacji awaryjnych?
- Czy każda korekta stanu ma autora, datę i przyczynę?
- Czy integracja potrafi odróżnić błąd przesyłania danych od realnego braku produktu?
Dopasuj model stanów do rodzaju asortymentu
Jedna reguła nie pasuje do każdego produktu. Pojedynczy towar sprzedawany w jednej wersji jest stosunkowo prosty, ale warianty, zestawy, multipaki i towary mierzone w różnych jednostkach wymagają dodatkowych ustaleń. Każdy wariant rozmiaru, koloru, pojemności lub konfiguracji powinien mieć własny jednoznaczny identyfikator oraz osobny stan.
Przykładowo koszulka w rozmiarze M i koszulka w rozmiarze L mogą mieć tę samą nazwę główną, lecz nie mogą dzielić jednej liczby dostępnych sztuk. Jeżeli zakup rozmiaru M zmniejszy stan produktu nadrzędnego, oferta może pokazywać błędną dostępność rozmiaru L. To częsta przyczyna sprzedaży ponad stan w ofertach wielowariantowych.
Produkty złożone wymagają wyliczenia dostępności na podstawie komponentu ograniczającego. Zestaw zawierający kubek, pudełko i kartkę może być sprzedany tylko wtedy, gdy dostępny jest każdy element. Jeśli magazyn ma dziesięć kubków, ale trzy pudełka, maksymalna liczba gotowych zestawów wynosi trzy, chyba że firma dopuszcza kompletowanie opakowań z innego źródła.
| Rodzaj produktu | Jak liczyć dostępność | Typowe ryzyko |
|---|---|---|
| Pojedynczy produkt | Stan dostępny konkretnej kartoteki | Publikowanie stanu fizycznego zamiast dostępnego |
| Wariant produktu | Stan przypisany do konkretnego wariantu | Połączenie kilku wariantów pod jednym kodem |
| Zestaw | Najniższa dostępność spośród komponentów | Sprzedaż zestawu mimo braku jednego elementu |
| Multipak | Iloraz dostępnych sztuk i liczby elementów w pakiecie | Zmniejszenie stanu o jedną sztukę zamiast o cały pakiet |
| Towar na zamówienie | Limit produkcyjny lub potwierdzony termin dostawy | Pokazywanie zapasu, którego fizycznie nie ma |
Osobnej reguły wymagają towary wykonywane na zamówienie, przedsprzedaż i produkty z długim terminem dostawy. W takim przypadku liczba widoczna na Allegro nie powinna udawać bieżącego stanu magazynowego. Trzeba jasno rozdzielić dostępność od przewidywanego terminu realizacji i upewnić się, że konfiguracja oferty odpowiada faktycznym możliwościom produkcyjnym.
Kontrola kartotek
- Czy każdy wariant ma własne SKU lub indeks magazynowy?
- Czy produkt złożony pobiera stany komponentów, a nie jedną ręcznie wpisaną liczbę?
- Czy multipak zmniejsza zapas o właściwą liczbę jednostek?
- Czy ten sam fizyczny towar nie występuje pod kilkoma niezależnymi kartotekami?
- Czy przedsprzedaż i produkcja na zamówienie mają oddzielny model dostępności?
Ustal dopuszczalny poziom ryzyka
Nie każdy produkt wymaga takiej samej częstotliwości aktualizacji. Dla towaru taniego, łatwo dostępnego i wolno rotującego kilkuminutowe opóźnienie może nie mieć znaczenia. Inaczej jest w przypadku ostatniej sztuki drogiego urządzenia, limitowanej kolekcji albo produktu, który w czasie promocji może sprzedać się wielokrotnie w ciągu minuty.

Trzeba zdecydować, co dzieje się przy stanie zerowym. Oferta może zostać zakończona, ukryta, zaktualizowana do zera albo pozostawiona z informacją o dostępności na zamówienie. Ostatnia opcja jest bezpieczna wyłącznie wtedy, gdy firma ma rzeczywistą zdolność realizacji i poprawnie komunikuje termin. Nie wolno stosować jej jako sposobu na ukrycie niedokładnych stanów.
Innej reakcji wymaga błąd techniczny, a innej rzeczywisty brak produktu. Jeśli API Allegro chwilowo nie odpowiada, system powinien oznaczyć stan jako niepewny, zapisać błąd i ponowić próbę. Jeżeli integracja w takiej sytuacji pozostawia starą liczbę sztuk bez żadnego alarmu, sprzedaż może trwać mimo braku aktualnych danych.
Przy planowaniu kolejnych kroków pomocny może być tekst: Hurtownia wszystko po 1 zł, 2 zł i 5 zł – czy warto kupować taki towar?.
Co sprawdzić
- Czy produkty szybko rotujące mają krótszy interwał synchronizacji?
- Czy dla towarów limitowanych używany jest bufor lub rezerwacja natychmiastowa?
- Czy stan zerowy kończy ofertę, czy zmienia jej sposób prezentacji?
- Czy błędy API powodują alarm, ponowienie i zapis w dzienniku zdarzeń?
Krok 2. Zrób audyt obecnych stanów, ofert i identyfikatorów
Porównaj stan magazynowy z liczbą sztuk na Allegro
Przed uruchomieniem automatycznej aktualizacji trzeba ustalić stan wyjściowy. Przygotuj zestawienie zawierające co najmniej: identyfikator produktu, stan fizyczny, stan dostępny w systemie magazynowym, stan w systemie integracyjnym oraz liczbę sztuk widoczną w każdej aktywnej ofercie Allegro.
| Pole kontrolne | Przykładowe pytanie |
|---|---|
| SKU lub indeks | Czy wskazuje konkretny wariant? |
| Stan fizyczny | Ile sztuk rzeczywiście znajduje się w lokalizacji? |
| Stan dostępny | Ile sztuk nie jest zarezerwowanych ani zablokowanych? |
| Stan integratora | Jaką wartość ostatnio odczytał system pośredni? |
| Stan Allegro | Ile sztuk może obecnie kupić klient? |
| Czas ostatniej aktualizacji | Czy dane są świeże, czy pochodzą sprzed kilku godzin? |
Audyt najlepiej rozpocząć od bestsellerów, produktów o małej dostępności i ofert, które mają jedną lub kilka sztuk. To właśnie tam niewielka rozbieżność prowadzi do realnego zamówienia, którego nie da się zrealizować. W dalszej kolejności należy sprawdzić produkty objęte promocją oraz te, które są sprzedawane równolegle w kilku kanałach.
Sprawdź identyfikatory i mapowanie ofert
Sam zgodny stan nie wystarczy, jeśli system aktualizuje niewłaściwą ofertę. Dlatego każdą aktywną ofertę trzeba powiązać z konkretną kartoteką produktu, wariantem albo zestawem. Do kontroli warto wykorzystać jednocześnie identyfikator oferty Allegro, SKU lub indeks magazynowy, EAN, identyfikator produktu w integratorze oraz nazwę wariantu.
Nie należy budować mapowania wyłącznie na podstawie nazwy produktu, zdjęcia lub podobieństwa opisu. Dwie oferty mogą mieć niemal identyczne tytuły, ale dotyczyć różnych rozmiarów, kolorów albo liczby sztuk w pakiecie. Z kolei ten sam produkt może występować w kilku ofertach Allegro, na przykład w różnych kategoriach lub z innymi warunkami dostawy. Trzeba wtedy ustalić, czy oferty mają wspólnie pobierać jeden stan, czy każda z nich powinna mieć osobny limit sprzedaży.
| Problem z mapowaniem | Jak go rozpoznać | Ryzyko |
|---|---|---|
| Oferta bez powiązania | Aktywna oferta nie ma przypisanego SKU ani kartoteki w integratorze | Stan nie zostanie zaktualizowany albo pozostanie stara wartość |
| Błędne SKU | Oferta wskazuje kartotekę innego produktu lub wariantu | Zmiana stanu jednego produktu zmodyfikuje inną ofertę |
| Duplikat kartoteki | Ten sam fizyczny produkt występuje pod kilkoma niezależnymi indeksami | Sprzedaż jest rozdzielona między rekordy i przekracza rzeczywisty zapas |
| Nieaktualna oferta | Oferta nadal wskazuje wycofany wariant lub dawny indeks | Synchronizacja trafia do nieużywanego rekordu |
| Złe opakowanie sprzedażowe | Oferta pojedyncza jest połączona z kartoteką multipaku albo odwrotnie | Stan zmniejsza się o niewłaściwą liczbę jednostek |
Wykonaj kontrolę mapowania krok po kroku
- Wyeksportuj listę wszystkich aktywnych ofert Allegro oraz kartotek produktów z systemu źródłowego i integratora.
- Ujednolić format identyfikatorów: usuń przypadkowe spacje, sprawdź wielkość liter i zweryfikuj, czy zera na początku kodu nie zostały utracone.
- Połącz oferty z kartotekami po jednoznacznym identyfikatorze, a nie po samej nazwie.
- Oznacz rekordy bez dopasowania, z więcej niż jednym dopasowaniem oraz wskazujące na nieaktywną kartotekę.
- Porównaj opis wariantu, jednostkę sprzedaży i liczbę sztuk w opakowaniu z tym, co jest zapisane w kartotece.
- Potwierdź, że oferta testowa zmniejsza stan właściwego produktu, a nie tylko aktualizuje wyświetlaną liczbę na Allegro.
Jeżeli identyfikator jest pusty albo występuje w kilku kartotekach, nie należy zgadywać właściwego powiązania. Taki rekord powinien trafić do ręcznej weryfikacji. Automatyczne dopasowanie „najbardziej podobnego” produktu może przez krótki czas wyglądać poprawnie, lecz ujawni błąd dopiero przy sprzedaży ostatnich sztuk.
Wykryj oferty bez powiązania, błędnym SKU i duplikaty
Najłatwiejszym sposobem wykrycia problemów jest przygotowanie trzech osobnych list kontrolnych. Pierwsza powinna zawierać aktywne oferty, dla których integrator nie znalazł żadnej kartoteki. Druga — oferty wskazujące na kartotekę, której kod, nazwa lub wariant nie zgadzają się z ofertą. Trzecia — kartoteki i identyfikatory użyte w więcej niż jednym miejscu, mimo że produkt nie powinien być współdzielony.
Oferta bez powiązania wymaga decyzji, a nie tylko ponownego uruchomienia synchronizacji. Trzeba ustalić, czy:
- brakuje kartoteki produktu w systemie źródłowym;
- kartoteka istnieje, ale nie została przesłana do integratora;
- oferta została utworzona ręcznie i nie ma identyfikatora zgodnego z systemem;
- produkt został wycofany, ale oferta nadal jest aktywna;
- oferta powinna zostać zamknięta zamiast ponownie mapowana.
Przy błędnym SKU najpierw trzeba zabezpieczyć ofertę, szczególnie jeśli pokazuje większą liczbę sztuk niż rzeczywiście dostępna. Następnie należy poprawić powiązanie w systemie nadrzędnym lub integratorze, sprawdzić historię ostatnich aktualizacji i dopiero wtedy wysłać nowy stan. Samo podmienienie kodu bez przeanalizowania wcześniejszych zamówień może pozostawić rezerwacje na niewłaściwym produkcie.

Duplikat kartoteki nie zawsze oznacza, że jeden rekord należy natychmiast usunąć. Najpierw sprawdź, czy są to faktycznie dwa niezależne zapasy, czy tylko dwa wpisy opisujące ten sam produkt. Porównaj EAN, SKU, lokalizację, jednostkę sprzedaży, historię przyjęć i ostatnie zamówienia. Po potwierdzeniu duplikatu wybierz kartotekę nadrzędną, przenieś do niej dane i zablokuj możliwość dalszego używania starego rekordu.
Przy planowaniu kolejnych kroków pomocny może być tekst: Jak wdrożyć ai w firmie? Wskazówki doradców biznesowych.
Ustal sposób obsługi wielu ofert tego samego produktu
Ten sam produkt może być dostępny w kilku ofertach Allegro, na przykład w ofercie standardowej, promocyjnej i wyróżnionej. Jeżeli wszystkie prowadzą do wspólnego zapasu, synchronizacja musi uwzględniać je jako jeden punkt sprzedaży. Publikowanie pełnego stanu w każdej ofercie osobno może spowodować wielokrotne udostępnienie tego samego zapasu.
Przykładowo pięć sztuk produktu nie powinno zostać pokazane jako pięć sztuk w trzech niezależnie zarządzanych ofertach, jeśli każda z nich może przyjąć zamówienie bez wspólnego mechanizmu rezerwacji. Należy zastosować jedno z ustalonych rozwiązań:
- podpiąć wszystkie oferty do wspólnego stanu i wspólnej rezerwacji;
- pozostawić jedną ofertę aktywną, a pozostałe zakończyć;
- podzielić zapas na odrębne pule, jeśli firma świadomie utrzymuje osobne limity;
- zastosować centralny mechanizm, który po sprzedaży w jednym kanale natychmiast zmniejsza dostępność w pozostałych.
Nie należy dzielić zapasu wyłącznie w arkuszu, jeżeli system nie potrafi później wymusić tego podziału. Ręczna deklaracja, że jedna oferta ma limit dwóch sztuk, a druga trzy, nie zabezpiecza przed sprzedażą ponad stan po zmianie stanu w systemie źródłowym.
Uporządkuj rozbieżności przed uruchomieniem synchronizacji
Każdą różnicę zaklasyfikuj przed jej poprawieniem. Inaczej postępuje się z błędem opóźnionej aktualizacji, inaczej z błędnym mapowaniem, a jeszcze inaczej z niezgodnością wynikającą z realnej inwentaryzacji. Bez takiego podziału pracownik może skorygować Allegro, choć problem znajduje się w magazynie, albo zmienić stan źródłowy, mimo że przyczyną był tylko zatrzymany proces synchronizacji.
| Rodzaj rozbieżności | Pierwsze działanie | Docelowa korekta |
|---|---|---|
| Allegro pokazuje starą wartość | Sprawdź czas i wynik ostatniej wysyłki | Napraw kolejkę, błąd API lub harmonogram |
| Integrator ma inną wartość niż magazyn | Sprawdź źródło danych i ostatni import | Wymuś poprawny odczyt z systemu nadrzędnego |
| Oferta wskazuje zły produkt | Zablokuj dalszą sprzedaż lub zmniejsz publikowany stan | Popraw mapowanie i zweryfikuj historię zmian |
| Stan systemowy nie zgadza się z fizycznym | Wstrzymaj publikację dla ryzykownej oferty | Przeprowadź kontrolę magazynową i korektę inwentaryzacyjną |
| Ten sam produkt ma kilka kartotek | Ustal rekord nadrzędny i zablokuj duplikaty | Scal lub rozdziel dane zgodnie z rzeczywistym zapasem |
Przed każdą większą korektą zachowaj eksport stanów, listę ofert i konfigurację mapowania. Dzięki temu można odtworzyć stan sprzed zmian i ustalić, czy problem powstał podczas porządkowania danych. Warto także wprowadzić czasową blokadę ręcznych zmian w Allegro, aby podczas audytu nie pojawiały się nowe, trudne do wyjaśnienia różnice.
Przeprowadź test na ograniczonej grupie ofert
Nie uruchamiaj pełnej synchronizacji zaraz po poprawieniu mapowania. Wybierz kilka reprezentatywnych produktów: pojedynczy wariant, produkt z niskim stanem, multipak, zestaw oraz produkt obecny w kilku ofertach. Dla każdego sprawdź, czy:
- stan z systemu źródłowego trafia do właściwej kartoteki integratora;
- integrator wysyła zmianę do właściwej oferty Allegro;
- sprzedaż jednej sztuki zmniejsza właściwy zapas;
- rezerwacja zmienia stan publikowany zgodnie z ustaloną regułą;
- stan zerowy uruchamia właściwą reakcję;
- błąd przesyłania jest zapisany i widoczny dla osoby odpowiedzialnej;
- kilka ofert tego samego produktu nie pokazuje niezależnie pełnego zapasu.
Test powinien obejmować również powrót towaru, anulowanie zamówienia i ręczną korektę inwentaryzacyjną. Sprawdź nie tylko wynik na ekranie, lecz także historię zdarzeń: czas operacji, źródło zmiany, identyfikator produktu i komunikat zwrócony przez integrację.
Checklista zamknięcia audytu
- Każda aktywna oferta ma jednoznaczne powiązanie z właściwą kartoteką.
- Nie ma ofert bez SKU, z błędnym SKU ani z identyfikatorem nieistniejącym w systemie źródłowym.
- Warianty, multipaki i zestawy mają poprawnie określoną jednostkę sprzedaży.
- Duplikaty kartotek zostały opisane, scalone albo świadomie rozdzielone.
- Wiele ofert tego samego produktu korzysta ze wspólnego zapasu lub z jawnie zdefiniowanych pul.
- Rozbieżności między magazynem, integratorem i Allegro mają przypisaną przyczynę.
- Przed korektami wykonano kopię danych i zapisano osoby odpowiedzialne za zmiany.
- Test ograniczonej grupy ofert potwierdził prawidłowy przepływ stanu i rezerwacji.
- Oferty z niepewnym mapowaniem są wstrzymane albo mają stan zabezpieczony buforem.
Ostrzeżenia przed rozpoczęciem synchronizacji
- Nie uruchamiaj masowej aktualizacji, gdy część ofert nadal nie ma potwierdzonego mapowania.
- Nie koryguj wszystkich różnic jedną zbiorczą zmianą bez rozróżnienia błędu technicznego i rzeczywistej niezgodności magazynowej.
- Nie przywracaj automatycznie ofert zakończonych ręcznie, dopóki nie ustalisz przyczyny ich zamknięcia.
- Nie traktuj zgodnej nazwy produktu jako dowodu poprawnego powiązania.
- Nie pozostawiaj duplikatów aktywnych tylko dlatego, że każda kartoteka ma poprawny opis.
