Moduł 5 · Lekcja 5.1
Integracje z hurtowniami
Po co łączyć hurtownię z systemem sprzedaży, co robić bez API i jak wygląda stały nadzór nad połączeniem.
Integracja to połączenie Twojego systemu sprzedaży z hurtownią tak, żeby dane płynęły same: produkty, stany, ceny i zamówienia. Brzmi technicznie, ale pytanie, które naprawdę trzeba zadać, jest proste: ile pracy ręcznej zastępuje to połączenie?
Co daje dobra integracja
- Stany aktualizowane automatycznie. Sprzedajesz tylko to, co hurtownia rzeczywiście ma.
- Ceny zgodne z cennikiem. Twój narzut liczy się od aktualnej ceny zakupu, więc nie sprzedajesz poniżej kosztu.
- Zamówienia przekazywane bez przepisywania. Klient kupuje u Ciebie, a hurtownia dostaje zamówienie w kilka sekund.
- Mniej błędów ludzkich. Najczęstsze wpadki — zła ilość, zły wariant, zła cena — znikają.
- Możliwość skalowania. Trzysta produktów przestaje być problemem operacyjnym.
Trzy poziomy połączenia
API
Najlepszy wariant. Hurtownia udostępnia dane i przyjmuje zamówienia przez interfejs. Aktualizacje mogą być niemal natychmiastowe, a Ty widzisz realny stan.
Pytania do zadania: co ile odświeżane są stany? Czy API zwraca zdjęcia i parametry? Czy jest limit zapytań? Co się dzieje przy przekroczeniu limitu?
Pliki CSV lub XML
Hurtownia publikuje plik na FTP albo wysyła link, który pobierasz cyklicznie. Prostsze, tańsze, ale z opóźnieniem — zwykle od godziny do doby.
To dobry kompromis: mało pracy, przewidywalny efekt. Wystarczy ustalić, jak często plik jest generowany i w której godzinie.
Brak integracji
Cennik w mailu, zamówienia telefoniczne lub przez formularz. Da się pracować, ale tylko przy małej skali. Każde zamówienie to ręczne wpisywanie, a każda zmiana ceny — ręczna aktualizacja ofert.
Gdzie w tym układzie są Base i Apilo
Rzadko łączysz się z hurtownią bezpośrednio. Między cennikiem hurtowni a Allegro stoi zwykle system do obsługi sprzedaży wielokanałowej — najczęściej Base (wcześniej BaseLinker) albo Apilo. To on pobiera produkty i stany od hurtowni, a potem wystawia je na marketplace'ach i w sklepie.
Co to zmienia dla Ciebie:
- Nie musisz mieć API od hurtowni. Wystarczy, że dostawca jest na liście integracji systemu — a te listy liczą setki hurtowni i brokerów.
- Jedno połączenie obsługuje wiele kanałów. Ta sama oferta idzie na Allegro, do własnego sklepu i na kolejny marketplace.
- Reguły cenowe są w jednym miejscu. Narzut ustawiasz raz, a system przelicza go od aktualnej ceny zakupu.
Na co uważać: sprawdź, czy integracja pobiera stany (a nie tylko cennik), co ile je odświeża i czy przekazuje zamówienia do hurtowni. Dwie integracje o podobnej nazwie potrafią różnić się zakresem danych.
Ważne dla tego modelu: domyślne ustawienie integracji dropshippingowej wysyła zamówienie wprost do klienta. W cross-dockingu zamówienie ma trafić do Ciebie — adres dostawy ustawiasz na własne miejsce przepakowania, a przesyłkę do klienta generujesz sam. Bez tej zmiany system po cichu zamieni Twój model w dropshipping.
Gdy hurtownia i Base/Apilo nie mają wspólnej integracji
Bywa, że hurtownia jest na liście integracji Base albo Apilo tylko z nazwy: cennik się pobiera, ale stany już nie, a zamówienia trzeba przepisywać ręcznie. Bywa też, że nie ma jej tam wcale — i wtedy zostaje plik CSV albo integracja szyta pod jednego dostawcę.
Takie połączenie da się dziś zamówić gotowe. Jedno z takich narzędzi rozwijam sam: Synter. Podpisuję się pod nim imieniem i nazwiskiem — Karol Golec — bo kurs powstał między innymi po to, żeby pokazać, kiedy taka integracja realnie się opłaca, a kiedy lepiej zostać przy CSV. Synter trafia dokładnie w lukę opisaną wyżej — ale nie jest warunkiem prowadzenia tego modelu.
Co robi w praktyce:
- Katalog w jedną stronę. Bierze produkty z hurtowni — przez API, plik CSV lub XML, a gdy dostawca nie daje żadnego z nich, czyta katalog z jego sklepu albo panelu B2B — i wysyła je do Base lub Apilo: nowe produkty, opisy, zdjęcia, ceny po Twojej marży i stany.
- Marża w jednym miejscu. Przedziały procentowe lub kwotowe od ceny bazowej i sposób zaokrąglenia. Cena w sklepie wychodzi z tego rachunku, a nie z arkusza.
- Zamówienia w drugą stronę. Zamówienie z Base lub Apilo trafia do hurtowni, u której jest towar — z pozycjami, ilościami i adresem dostawy.
- Dwa tryby zamawiania. Automatyczny: zamówienie idzie do dostawcy od razu. Albo koszyk: pozycje lądują w koszyku na stronie hurtowni i czekają, aż sprawdzisz ceny, stany i adres, i sam klikniesz zamówienie. Nic nie wyjeżdża bez Twojej decyzji — przydatne u dostawców, którzy nie przyjmują zamówień bez człowieka.
- Top produkty. Codziennie o 5:00 narzędzie czyta historię cen i stanów z 30 dni i układa ranking produktów, które w katalogu straciły najwięcej sztuk.
Top produkty to sygnał, nie wyrocznia. Ranking pokazuje ubytek stanu w katalogu hurtowni, a nie oficjalną sprzedaż — produkt, który schodzi u dostawcy, u Ciebie może nie ruszyć. Traktuj go jako podpowiedź przy wyborze asortymentu i porównuj z tym, co widzisz we własnych zamówieniach.
Ile to kosztuje. Wycena zależy od tego, co hurtownia oddaje sama i ile ma produktów. Według cennika na dziś: od ok. 1,3 tys. zł netto za wykonanie integracji katalogu i od ok. 550 zł netto miesięcznie — drożej, gdy hurtownia nie ma API ani pliku i katalog trzeba czytać z panelu B2B. Obsługa zamówień to osobny dodatek: ok. 1,1 tys. zł netto i 500 zł netto miesięcznie. To kwoty na poziomie projektu, nie abonamentu za kilkadziesiąt złotych, więc aktualny cennik sprawdź przed decyzją.
Kiedy ma sens. Gdy hurtownia nie ma działającej integracji z Base lub Apilo, masz co najmniej kilkadziesiąt produktów, a przepisywanie zamówień zajmuje kilka godzin w miesiącu. Przy dwudziestu produktach i pięciu zamówieniach w tygodniu taniej wyjdzie CSV i ręczne zamówienie w panelu.
Co sprawdzić przed startem. Czy zamówienie pójdzie z adresem dostawy ustawionym na Twoje miejsce przepakowania — w cross-dockingu to warunek konieczny, nie opcja. Czy integracja obejmuje stany, a nie tylko cennik. I czy po pierwszym miesiącu opłata jest mniejsza niż wartość godzin, które zastąpiła.
Zakres i aktualny cennik Syntera: synter.pl. Zanim napiszesz — wróć do akapitu „Kiedy ma sens”: przy małym asortymencie CSV wychodzi taniej i żadna integracja tego nie zmieni.
Co robić bez API
Brak API nie przekreśla hurtowni. Warto wtedy:
- Ustalić stały rytm aktualizacji (np. CSV w każdy poniedziałek).
- Ograniczyć asortyment do produktów stabilnych cenowo.
- Dodać bufor w stanach — jeśli w pliku jest 3 sztuki, traktuj to jak 1.
- Utrzymać drugą hurtownię z integracją jako uzupełnienie.
Stały nadzór nad połączeniem
Integracja nie jest „ustaw i zapomnij”. Potrzebujesz:
- alertu o błędzie synchronizacji — mail lub powiadomienie, gdy plik się nie pobrał,
- cotygodniowego przeglądu — czy wszystkie oferty mają aktualne stany,
- reakcji na braki — gdy produkt znika z cennika, oferta powinna zostać wygaszona,
- kopii danych — żeby po awarii móc odtworzyć katalog.
Najczęstsza awaria to nie pad serwera, a cicho niedziałająca synchronizacja. Nikt nie zauważa jej przez tydzień, bo oferty nadal są widoczne — tylko ceny są nieaktualne.
Ile to kosztuje
- Gotowe narzędzie integracyjne: abonament miesięczny, konfiguracja w kilka godzin.
- Własne rozwiązanie: koszt programisty lub Twojego czasu, ale pełna kontrola.
- Integracja dostarczona przez hurtownię: często bezpłatna, warta wyboru nawet kosztem wyższej ceny towaru.
Prosta kalkulacja: jeśli aktualizacja zajmuje Ci 5 godzin miesięcznie, a narzędzie kosztuje mniej niż wartość tych godzin — bierz narzędzie.
Od czego zacząć
- Sprawdź, czy Twoja hurtownia ma API lub publiczny plik z cenami.
- Ustal, które dane są krytyczne: stany, ceny, zamówienia.
- Podłącz jedno źródło, przetestuj na pięciu produktach.
- Dopiero potem dodawaj kolejne hurtownie.
Integracja jest warta tyle, ile oszczędza pracy — nie tyle, ile kosztuje. Zacznij od jednego połączenia i zmierz efekt, zanim podpiszesz kolejne abonamenty.