Przejdź do treści
Kurs cross-dockingu kurscrossdocking.pl

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.

1 / 3 · 7 min

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:

  1. Ustalić stały rytm aktualizacji (np. CSV w każdy poniedziałek).
  2. Ograniczyć asortyment do produktów stabilnych cenowo.
  3. Dodać bufor w stanach — jeśli w pliku jest 3 sztuki, traktuj to jak 1.
  4. 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ąć

  1. Sprawdź, czy Twoja hurtownia ma API lub publiczny plik z cenami.
  2. Ustal, które dane są krytyczne: stany, ceny, zamówienia.
  3. Podłącz jedno źródło, przetestuj na pięciu produktach.
  4. 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.