Blog · Synchronizacja · IdoSell

Synchronizacja stanów magazynowych z hurtowniami w IdoSell

Sprzedaż produktu, którego nie ma fizycznie w hurtowni, to dla sklepu IdoSell sytuacja najgorsza: klient czeka, reklamacja, zwrot, opinia 1-gwiazdkowa. Pokazujemy jak zsynchronizować stany magazynowe z wieloma hurtowniami jednocześnie, żeby oversold nie był codziennością.

CZAS CZYTANIA: ~10 MIN

Wiele sklepów IdoSell zaczyna od jednej hurtowni i prostego importu CSV raz dziennie. Po kilku miesiącach dochodzi druga hurtownia, trzecia, plus własny magazyn. Synchronizacja, która wystarczała w sklepie z 200 produktami, w sklepie z 5 000 produktów i 3 dostawcami staje się stałym źródłem problemów: oversoldy, anulacje zamówień, klienci pytający „dlaczego nie ma w magazynie", mimo że na stronie pisze „dostępny". Ten wpis pokazuje, jak rozwiązać to systematycznie.

Dlaczego synchronizacja stanów to nie jest opcja

W przeciwieństwie do cen, gdzie błąd kosztuje marżę, błąd w stanach magazynowych ma cztery typy konsekwencji jednocześnie:

1. Oversold — sprzedaż produktu, którego nie masz

Klient kupił, zapłacił, dostał potwierdzenie. Po godzinie okazuje się, że hurtownia nie ma produktu. Musisz anulować, zwrócić pieniądze, przeprosić, stracić klienta. W skrajnym przypadku — pójść na kompromis kosztowy (kupić produkt drożej u innego dostawcy, żeby zrealizować zamówienie).

2. Wpływ na opinie i ranking sklepu

Anulacja zamówienia z winy sklepu to opinia 1-gwiazdkowa. Na Allegro to obniżenie wskaźnika obsługi zamówień, które bezpośrednio wpływa na widoczność wszystkich Twoich ofert. Kilka oversoldów miesięcznie może w średnim sklepie obniżyć sprzedaż o 10-30%, zanim zorientujesz się dlaczego.

3. Ban na marketplace

Allegro, Amazon i inne marketplace mają twarde polityki dotyczące realizacji zamówień. Przekroczenie limitu anulacji (na Allegro typowo 2-5% zamówień miesięcznie zależnie od programu) skutkuje automatycznym ograniczeniem konta lub banem. Odzyskanie pełnej widoczności trwa miesiące.

4. Brak sprzedaży w drugą stronę

Problem odwrotny: produkt JEST w hurtowni, ale na stronie pokazujesz „brak w magazynie", bo synchronizacja nie zdążyła go odświeżyć. Klient odchodzi do konkurencji. Tych strat nie widać w analizach — bo nigdy nie pojawiły się jako zamówienia.

Synchronizacja stanów to nie „nice to have". To podstawowa infrastruktura operacyjna sklepu, równie ważna jak działająca strona i wystawione faktury.

Co realnie pobiera się z hurtowni

„Synchronizacja stanów" to upraszczanie — z hurtowni zwykle pobiera się kilka rodzajów danych jednocześnie. Warto wiedzieć, co z czego:

Stan magazynowy (kluczowe)

Ile sztuk produktu hurtownia ma fizycznie w magazynie. Najprostsza forma: liczba całkowita per SKU. Bardziej zaawansowane: stan per wariant (rozmiar, kolor), per magazyn (gdy hurtownia ma kilka lokalizacji), dostępność „w drodze" (towar już zamówiony przez hurtownię u producenta).

Cena zakupu

Cena, po której kupisz produkt od hurtowni. Pobierana razem ze stanem — bo zmiana ceny w hurtowni zwykle idzie w parze ze zmianą stanu (np. nowa dostawa po nowej cenie). Opisaliśmy ten temat w wpisie o automatycznej aktualizacji cen.

Dane produktowe

Nazwa, opis, kategoria, zdjęcia, parametry techniczne. Pobierane przy pierwszym imporcie produktu (zaakceptowane nowości w hurtowni dodawane do sklepu) i okresowo aktualizowane (zmiany w opisach, nowe zdjęcia).

Status produktu

Czy produkt jest w aktywnej ofercie hurtowni, czy został wycofany, czy zastąpiony nowym SKU. To kluczowe dla porządkowania katalogu — produkty wycofane powinny być oznaczone w sklepie (lub usunięte z odpowiednim przekierowaniem 301, opisanym w błędach SEO).

Formaty feedów — co dziś jest standardem

XML — najpopularniejszy format dla feedów hurtowni w PL. Plus: standardowy, łatwy do parsowania. Minus: ciężki przy dużych katalogach (50+ MB nie jest niczym dziwnym)

CSV — prosty format płaski. Plus: lekki, łatwy do edycji ręcznej. Minus: trudniej obsługiwać warianty i hierarchie kategorii

JSON / REST API — coraz częściej w nowszych hurtowniach. Plus: można pobierać tylko zmiany (delta), nie cały katalog. Minus: rzadziej spotykane

FTP / SFTP — sposób dostarczenia pliku, nie format danych. Hurtownia wrzuca plik na serwer, ty pobierasz

Trzy podejścia do synchronizacji stanów

A) Wbudowane mechanizmy IdoSell

IdoSell ma natywne moduły do importu stanów z feedów XML i CSV oraz integracje z najpopularniejszymi polskimi hurtowniami. Sens: dla sklepów z 1-2 hurtowniami w standardowych formatach. Działa dobrze: dla prostych przypadków „jeden produkt = jeden dostawca", harmonogram co kilka godzin. Ograniczenia: słabsza obsługa wielu dostawców tego samego produktu, ograniczona logika warunkowa, brak zaawansowanego mapowania SKU.

B) Ręczne aktualizacje przez import CSV

Pobierasz feed z hurtowni, otwierasz w Excelu, importujesz przez panel IdoSell. Sens: dla bardzo małych sklepów (do 200 produktów, 1 hurtownia) i jako wsparcie awaryjne, gdy automat nie działa. Nie ma sensu: przy większej skali — to godziny pracy dziennie, wysokie ryzyko oversoldów między importami.

C) Dedykowane narzędzie do synchronizacji

Zewnętrzne narzędzie (lub własna dedykowana aplikacja po API IdoSell), które obsługuje wiele źródeł, mapowanie SKU, reguły priorytetów, alarmy. Sens: sklepy z 500+ produktami, wieloma dostawcami, marketplace'ami. Daje: synchronizację co kilka minut, pełną historię, zaawansowane reguły, audyt zmian.

Jak robimy to my — Aktualizator Stanów

Synchronizacja stanów po API IdoSell to coś, co pisaliśmy w wielu projektach. Najlepsze wzorce zebraliśmy w jedno narzędzie — Aktualizator Stanów. To rozwiązanie zaprojektowane konkretnie pod sklepy IdoSell. Co dokładnie robi:

Łączy się z IdoSell przez API — pobiera asortyment, aktualizuje stany zwrotnie. Bez ręcznego importu CSV

Obsługuje wiele źródeł jednocześnie — feedy XML, CSV, REST API, FTP/SFTP. Konfigurujesz dowolną liczbę hurtowni równolegle

Reguły priorytetów dla multi-supplier — gdy ten sam SKU jest w 3 hurtowniach, definiujesz która jest priorytetowa (np. „najszybsza dostawa", „najtańsza", „własny magazyn pierwsza")

Agregacja stanów — opcjonalnie sumuje stany ze wszystkich hurtowni, gdy chcesz pokazywać klientowi „mamy 50 sztuk" zamiast „15 + 20 + 15"

Reguły bezpieczeństwa — bufor magazynowy (rezerwujesz 2 sztuki z 10 widzialnych), wykrywanie anomalii (spadek stanu o 80% to alarm, nie automatyczna aktualizacja)

Pełen audyt — historia każdej zmiany stanu z czasem, źródłem, powodem. Łatwa diagnoza „dlaczego stan się tak ustawił"

Cena: Aktualizator Stanów startuje od 79 zł/mies — to świadoma decyzja, bo synchronizacja stanów to infrastruktura, której każdy sklep z wieloma dostawcami potrzebuje, nie tylko duże firmy.

Multi-supplier — jeden SKU, wielu dostawców

Najtrudniejszy przypadek synchronizacji stanów. Ten sam produkt jest dostępny w 3 hurtowniach, każda ma swój stan, swoje czasy dostawy, swoje ceny zakupu. Jak to pokazać klientowi i jak zorganizować realizację zamówienia?

Strategia A: Priorytetowa hurtownia

Wybierasz jedną hurtownię jako podstawową (np. tę z najlepszą ceną, najszybszą dostawą lub najlepszą jakością obsługi). Sklep pokazuje stan z tej hurtowni. Dopiero gdy spada do zera — przełącza się na drugą w kolejności. Plus: prosto, klient ma stałe oczekiwania czasu dostawy. Minus: zaniżasz dostępny stan (pokazujesz np. 15 zamiast realnych 50).

Strategia B: Agregacja stanów

Pokazujesz sumę stanów ze wszystkich hurtowni. Klient widzi „dostępne 50 sztuk", zamawia, sklep sam decyduje, z której hurtowni zrealizować. Plus: pełna dostępność widoczna, mniej fałszywych „brak w magazynie". Minus: przy zamówieniu klienta musisz znać logikę: skąd brać produkt, jak komunikować klientowi czasy dostawy.

Strategia C: Reguły warunkowe

Bardziej zaawansowane: różne hurtownie dla różnych kategorii produktów lub typów zamówień. Np. zamówienia detaliczne <500 zł → tańsza hurtownia, zamówienia hurtowe lub szybkie → droższa ale szybsza. Wymaga: dobrego narzędzia (np. Aktualizator Stanów z konfiguracją warunkową) i przemyślanej polityki realizacji.

Pułapka multi-supplier: niespójne SKU

Ten sam produkt ma SKU „BUT-NIKE-42" w jednej hurtowni, „NIKE-AIR-FORCE-1-42" w drugiej, „1234567890" (EAN) w trzeciej. Bez prawidłowego mapowania SKU narzędzie traktuje to jako 3 różne produkty. Mapowanie SKU to najtrudniejsza część wdrożenia multi-supplier — wymaga ręcznej weryfikacji przy pierwszym imporcie i utrzymania przy nowych produktach.

Częstotliwość synchronizacji

„Im częściej tym lepiej" to mit. Optymalna częstotliwość zależy od typu hurtowni, kategorii produktów i wielkości obrotu. Kilka realistycznych progów:

Co 5-15 minut

Sens: dla produktów wysokorotacyjnych (elektronika, kosmetyki, niszowe produkty z ograniczoną dostępnością) i sklepów z dużym obrotem na marketplace'ach. Im szybsza synchronizacja, tym mniej oversoldów.

Co 1-4 godziny

Sens: dla większości sklepów średniej wielkości. Wystarczająco często, żeby oversoldy były rzadkością, wystarczająco rzadko, żeby nie generować zbędnego obciążenia (i kosztów API/feedów).

Raz dziennie

Sens: dla małych sklepów z produktami wolnorotacyjnymi, gdzie ryzyko oversoldu jest niskie (mało zamówień), lub dla hurtowni, które same aktualizują feed tylko raz dziennie (nie ma sensu pobierać częściej).

Zasada praktyczna

Dla każdej hurtowni odpowiedz na pytanie: „ile zamówień miesięcznie sprzedaję z tej hurtowni". Jeśli ponad 100 → synchronizacja co 30-60 min. Jeśli 10-100 → co 2-4 h. Jeśli mniej → raz dziennie. To proste, ale lepsze od „synchronizujemy wszystko co 5 min" — które zwiększa koszty bez proporcjonalnego efektu biznesowego.

Reguły bezpieczeństwa — żeby nie wystąpił oversold

Najczęstsza obawa właścicieli sklepów: „a co jak synchronizacja się rozjedzie i sprzedam to, czego nie ma". Cztery reguły bezpieczeństwa, które warto wdrożyć zawsze:

1. Bufor magazynowy

Nie pokazujesz klientowi pełnego stanu z hurtowni — odejmujesz bufor. Hurtownia ma 10 sztuk? Pokazujesz 8 (bufor 2). To chroni przed sytuacją, gdy ktoś inny kupi w hurtowni w tym samym momencie co Twój klient. Bufor typowo 1-5 sztuk zależnie od rotacji.

2. Wykrywanie anomalii

Spadek stanu z 100 do 5 sztuk dnia na dzień to anomalia — albo hurtownia zrobiła błąd w feedzie, albo coś dramatycznego się wydarzyło. Narzędzie powinno to wykryć i wstrzymać synchronizację do potwierdzenia. Lepiej chwilowo pokazać nieaktualny (wyższy) stan niż błędnie obniżyć i sprzedać coś, czego nie ma.

3. Pauza przy braku feedu

Hurtownia nie dostarczyła feedu na czas? Brak nowych danych nie oznacza, że stany się wyzerowały. Narzędzie nie powinno zerować stanów ani robić nic „awaryjnego" — powinno użyć ostatnich znanych wartości i wysłać alert administratorowi.

4. Whitelist produktów krytycznych

Top 50-100 produktów generujących większość obrotu, plus produkty z umowami o gwarantowanej dostępności, wpisujesz na whitelistę — synchronizacja zachowuje się ostrożniej (wyższy bufor, niższy próg anomalii, częstsze alerty). Reszta katalogu może być zarządzana standardowo.

Najczęstsze pułapki

Synchronizacja bez mapowania SKU

Pierwsze uruchomienie bez ręcznej weryfikacji, które SKU u Ciebie odpowiada któremu w hurtowni. Wynik: narzędzie aktualizuje nie te produkty co trzeba, część stanów się rozjeżdża, oversoldy tam, gdzie się nie spodziewasz. Mapowanie to pierwsze 2-4 tygodnie pracy przy każdym nowym dostawcy.

Ignorowanie wariantów

Produkt „T-shirt damski" ma 4 rozmiary i 3 kolory = 12 wariantów. Hurtownia raportuje stan per wariant, ale narzędzie agreguje do jednego SKU. Klient zamawia rozmiar L w kolorze czarnym, a tego konkretnego wariantu nie ma — choć łączny stan był 50 sztuk. Oversold gwarantowany. Sprawdź, czy narzędzie obsługuje warianty.

Synchronizacja w godzinach szczytu

Niektóre konfiguracje robią pełną synchronizację co godzinę, w tym w godzinach 10-12 i 18-21 (gdy sklep ma najwięcej ruchu). Wynik: synchronizacja przeciąża serwer, strona zwalnia, tracisz konwersję. Rozdziel: lekka synchronizacja deltami (tylko zmiany) co 15 min, pełna synchronizacja w nocy.

Brak alertów na błędy

Synchronizacja nie działa od 3 dni (hurtownia zmieniła URL feedu, nikt nie poprawił konfiguracji). Stany się starzeją, oversoldy się mnożą, nikt nie wie dlaczego. Dobry system ma alerty na: brak feedu, anomalie w danych, błędy importu. Bez tego diagnoza problemu potrafi trwać tygodniami.

Synchronizacja stanów bez synchronizacji cen

Nowy stan w hurtowni zwykle idzie razem z nową ceną zakupu. Jeśli synchronizujesz tylko stan, a cena zakupu się zmieniła — możesz nieświadomie sprzedawać ze stratą. Warto rozważyć paralelne wdrożenie obu — opisaliśmy to w wpisie o automatycznej aktualizacji cen.

Workflow wdrożenia

Pełne uruchomienie synchronizacji stanów z 2-3 hurtowniami to projekt na 2-3 tygodnie. Realistyczny plan:

Tydzień 1: Audyt i przygotowanie

Inwentaryzacja źródeł: które hurtownie, w jakich formatach, jakie częstotliwości feedu udostępniają

Mapowanie SKU: każdy produkt w sklepie do jego odpowiednika w każdej hurtowni

Identyfikacja produktów multi-supplier i strategia (priorytet / agregacja / warunkowa)

Definicja whitelisty produktów krytycznych

Tydzień 2: Konfiguracja

Konfiguracja źródeł w Aktualizatorze Stanów (lub innym narzędziu)

Ustawienie reguł priorytetów dla multi-supplier

Konfiguracja buforów magazynowych per kategoria

Ustawienie reguł bezpieczeństwa (anomalie, pauza przy braku feedu)

Konfiguracja alertów (email, Slack, panel sklepu)

Tydzień 3: Test i stabilizacja

Tryb shadow — synchronizacja działa, ale nie aktualizuje stanów w sklepie, tylko porównuje (1-3 dni)

Weryfikacja: czy stany z synchronizacji zgadzają się z rzeczywistymi (sprawdzenie próbki ręcznie)

Stopniowe włączanie: jedna hurtownia → druga → trzecia

Codzienne sprawdzanie alertów i tuning progów anomalii

Po wdrożeniu

Synchronizacja stanów to nie „skonfiguruj i zapomnij". Co tydzień warto przejrzeć: liczbę alertów, liczbę oversoldów (jeśli zdarzają się), nowe produkty dodane do hurtowni do zmapowania. Co miesiąc — sprawdzić, czy reguły działają jak trzeba, czy bufory są na właściwym poziomie.

Podsumowanie

Synchronizacja stanów magazynowych z hurtowniami to infrastruktura operacyjna sklepu IdoSell — bez niej oversoldy, anulacje i ban na marketplace to kwestia czasu. Klucz to:

Wybierz narzędzie obsługujące Twoją liczbę hurtowni i logikę multi-supplier

Mapowanie SKU to fundament — pierwsze 2-4 tygodnie poświęć na weryfikację ręczną

Bufor magazynowy + wykrywanie anomalii + pauza przy braku feedu — twarde reguły bezpieczeństwa

Częstotliwość synchronizacji adekwatna do rotacji (co 15 min dla szybkich, raz dziennie dla wolnych)

Tryb shadow przed produkcją + stopniowe włączanie hurtowni

Łączna obsługa stanów + cen (zwykle to ten sam workflow z hurtownią)

Jeśli szukasz gotowego narzędzia dopasowanego pod sklep IdoSell — Aktualizator Stanów obsługuje wszystkie te scenariusze bez budowania pipeline'u od zera. Sklepy po wdrożeniu zauważają dramatyczny spadek oversoldów (typowo z kilku procent zamówień do mniej niż 0,5%) i odzyskują czas zespołu, który wcześniej szedł na ręczne kontrole stanów.