📦 Zamówienie z BaseLinkera od razu w hurtowni
Automatyczne zamówienia u hurtowni z BaseLinkera
Nowe zamówienie w BaseLinkerze samo trafia do hurtowni, która ma towar na stanie i daje najniższą cenę. Integracja porównuje hurtownie po EAN, składa zamówienie przez ich API i zapisuje wynik w statusie i notatce zamówienia.
Automatyczne zamówienia u hurtowni w skrócie
Automatyczne zamówienia u hurtowni to integracja, która po wpłynięciu zamówienia do BaseLinkera sama zamawia towar u dostawcy, bez ręcznego sprawdzania stanów i cen w kilku panelach. W naszym wdrożeniu dla księgarni internetowej system porównuje hurtownie książek po EAN, wybiera najtańszą z wystarczającym stanem i składa zamówienie w Ateneum albo w Platonie.
Najtańsza hurtownia z towarem.
Liczą się tylko hurtownie, które mają co najmniej zamawianą liczbę sztuk. Z nich wygrywa najniższa cena zakupu.
Każda pozycja osobno.
Jedno zamówienie może trafić do dwóch hurtowni, jeśli tak wychodzi taniej albo tylko tak jest towar.
Stany odświeżane w ciągu dnia.
Platon co 15 minut, stany Ateneum co 10 minut, pełna synchronizacja 3 razy dziennie.
Wynik w BaseLinkerze.
Status i notatka w zamówieniu pokazują, co zamówiono, a czego zabrakło.
Zamawianie u hurtowni bez ręcznego porównywania
Dziś: Stany i ceny sprawdzane u każdej hurtowni osobno
Po wdrożeniu: Stany i ceny wszystkich hurtowni w jednej bazie, porównane po EAN
Dziś: Zamówienie u dostawcy wpisywane ręcznie w panelu hurtowni
Po wdrożeniu: Zamówienie idzie przez API hurtowni chwilę po wpłynięciu do BaseLinkera
Dziś: Towar o małym stanie wyprzedaje się, zanim ktoś go zamówi
Po wdrożeniu: Zamówienie trafia do hurtowni od razu, także w nocy i w weekend
Dziś: Nie wiadomo, czy hurtownia przyjęła całą ilość
Po wdrożeniu: Ilość potwierdzona przez hurtownię, braki w notatce zamówienia
Dziś: Wybór dostawcy zależy od tego, kto akurat zamawia
Po wdrożeniu: Jedna reguła: najtańsza hurtownia, która ma towar
Ręcznie zostają tylko pozycje, których żadna hurtownia nie miała w potrzebnej ilości.
Co obejmuje integracja z hurtowniami
Zakres ustalamy na konsultacji. W naszym wdrożeniu objął te elementy.
Synchronizacja stanów i cen.
Pliki XML i CSV oraz API hurtowni pobierane według harmonogramu do jednej bazy danych, z EAN jako wspólnym kluczem.
Wybór hurtowni.
API, które dla EAN i ilości zwraca oferty wszystkich hurtowni i najlepszą z nich.
Zamówienie w hurtowni.
Workflow w n8n składa zamówienie przez API wybranej hurtowni: w Platonie przez usługę SOAP, w Ateneum jako rezerwację.
Wynik w BaseLinkerze.
Status zamówienia i notatka z wynikiem, także z brakami, żeby zespół od razu widział, co wymaga decyzji.
Kontrola synchronizacji.
Strona stanu pokazuje, czy hurtownie odpowiadają, a przy pliku XML także to, czy dane w bazie nadal się odświeżają.
Przełącznik hurtowni.
Hurtownię można wyłączyć w konfiguracji, a pozostałe działają dalej bez zmian.
Zamówienia u hurtowni w naszych wdrożeniach
Księgarnia internetowa: zamówienia u hurtowni książek
Każda pozycja zamówienia z BaseLinkera trafia do najtańszej hurtowni, która ma ją na stanie. Status i braki wracają do zamówienia.
- BaseLinker
- porównanie po EAN
- Ateneum lub Platon
- status w BaseLinkerze
Hurtownia Azymut w tym samym systemie
Zbudowaliśmy i uruchomiliśmy integrację z API Azymutu: katalog, dostępność i ceny porównywane z pozostałymi hurtowniami po EAN.
- API Azymutu
- baza po EAN
- porównanie hurtowni
Jak pracujemy
Konsultacja
Ustalamy, z jakimi hurtowniami masz umowy, co udostępniają (plik XML, CSV, API) i kiedy zamówienie ma trafić do dostawcy.
Dostępy i dane
Dostęp do API hurtowni i BaseLinkera, przegląd plików ze stanami i cenami, powiązanie produktów po EAN.
Integracja
Synchronizacja do bazy, API wyboru hurtowni, workflow w n8n z zamówieniem i zapisem wyniku w BaseLinkerze.
Test i uruchomienie
Test na środowisku testowym hurtowni, jeśli je ma, albo na pojedynczych zamówieniach uzgodnionych z Tobą. Potem start i opieka po wdrożeniu.
Czego nie robimy
- Nie zamawiamy w hurtowni, która ma mniej sztuk, niż potrzeba, tylko dlatego, że jest tańsza.
- Nie zakładamy, że hurtownia ma więcej, niż podaje: przy stanie w zakresie, np. 251-300, liczymy dolną granicę.
- Nie uruchamiamy do testów workflow, który składa prawdziwe zamówienia w hurtowniach.
- Nie piszemy własnej integracji, gdy wystarcza gotowa integracja hurtowni w BaseLinkerze.
Narzędzia
BaseLinker API
Pobranie zamówienia oraz zapis statusu i notatki z wynikiem. BaseLinker API →
n8n
Workflow uruchamiany webhookiem z BaseLinkera: zamówienie w hurtowni i zapis wyniku. Integracja n8n →
Python i FastAPI
API, które wybiera hurtownię, i harmonogram synchronizacji w tle.
PostgreSQL
Baza stanów i cen wszystkich hurtowni z indeksem po EAN.
API i pliki hurtowni
Platon: plik XML i usługa SOAP. Ateneum: pliki CSV i rezerwacje. Azymut: API XML.
Opisz, u jakich hurtowni zamawiasz
Napisz, czym zajmuje się Twoja firma i co chcesz usprawnić.
Wrócimy z konkretną propozycją, a nie z ogólną prezentacją.
Co dzieje się dalej
- Odpisujemy w ciągu 1 dnia roboczego.
- Umawiamy 30-minutową rozmowę.
- Przygotowujemy propozycję i wycenę.
Najczęstsze pytania
Jak zautomatyzować zamówienia u hurtowni z BaseLinkera?
BaseLinker wysyła numer nowego zamówienia na webhook, a integracja pobiera zamówienie przez BaseLinker API, wybiera hurtownię dla każdej pozycji i składa zamówienie przez API hurtowni. Wynik wraca do BaseLinkera jako status i notatka. W naszym wdrożeniu przepływ prowadzi n8n, a hurtownię wybiera osobne API w Pythonie z bazą stanów i cen.
Jak wybrać najtańszą hurtownię z towarem na stanie?
Z hurtowni, które mają co najmniej tyle sztuk, ile zamówił klient, wybierz tę z najniższą ceną zakupu. System robi to dla każdej pozycji, porównując oferty po EAN we własnej bazie odświeżanej w ciągu dnia, więc nie czeka na odpowiedź każdej hurtowni. W teście jedno takie zapytanie trwało ok. 0,45 s.
Co się dzieje, gdy żadna hurtownia nie ma towaru?
Pozycja nie jest zamawiana, a zamówienie dostaje w BaseLinkerze status i notatkę z brakiem. Zespół od razu widzi, które zamówienia wymagają decyzji, np. zamówienia u innego dostawcy albo kontaktu z klientem.
Jak często aktualizują się stany z hurtowni?
Tak często, jak pozwalają pliki i API hurtowni. W naszym wdrożeniu plik XML Platona z cenami i stanami pobieramy co 15 minut, stany Ateneum co 10 minut, a ceny Ateneum i pełną synchronizację 3 razy dziennie.
Czy jedno zamówienie może trafić do kilku hurtowni?
Tak. Hurtownię wybieramy dla każdej pozycji osobno, więc jedna książka może pójść do Platona, a druga do Ateneum. Każda gałąź zapisuje swój wynik, a na koniec zamówienie dostaje w BaseLinkerze jeden status z podsumowaniem.
Co, jeśli hurtownia potwierdzi mniej sztuk, niż zamówiono?
Integracja bierze ilość z odpowiedzi hurtowni, a nie zakłada, że zamówienie przeszło w całości. Ateneum potrafi zarezerwować mniej sztuk i nadal zwrócić sukces, a odpowiedź Platona trzeba najpierw zdekodować, żeby odczytać ilość do dostarczenia. Różnica trafia do notatki zamówienia jako brak.
Czy można dodać kolejną hurtownię?
Tak, jeśli hurtownia udostępnia stany i ceny (plik XML, CSV albo API) i przyjmuje zamówienia przez API. Każda hurtownia ma osobny moduł synchronizacji i osobną gałąź zamówienia, więc nową dokładamy bez przebudowy reszty. Tak samo zbudowaliśmy integrację z hurtownią Azymut, której ceny i stany system porównywał z pozostałymi.
Jak działa automatyczne zamawianie towaru u hurtowni?
Integracja ma dwie części. Pierwsza w tle pobiera stany i ceny z hurtowni do jednej bazy danych. Druga reaguje na każde nowe zamówienie w BaseLinkerze: wybiera hurtownię dla każdej pozycji, składa zamówienie i zapisuje wynik.
- Webhook z BaseLinkera z numerem nowego zamówienia uruchamia workflow w n8n.
- Pobranie zamówienia przez BaseLinker API: produkty, EAN-y i ilości.
- Wybór hurtowni dla każdej pozycji: API zwraca oferty wszystkich hurtowni i najlepszą z nich.
- Zamówienie w hurtowni przez jej API, osobno dla każdej pozycji.
- Sprawdzenie odpowiedzi: ile sztuk hurtownia naprawdę przyjęła.
- Status i notatka w BaseLinkerze: co zamówiono i czego zabrakło.
Jak system wybiera najtańszą hurtownię?
Dla każdej pary EAN i ilość API sprawdza w bazie oferty wszystkich włączonych hurtowni. Oferta liczy się tylko wtedy, gdy hurtownia ma co najmniej zamawianą liczbę sztuk. Spośród nich wygrywa najniższa cena zakupu. Gdy nikt nie ma towaru, API nie wskazuje żadnej oferty i pozycja nie jest zamawiana.
| Hurtownia | Stany i ceny | Odświeżanie | W systemie |
|---|---|---|---|
| Platon | plik XML z ceną netto i stanem | co 15 minut | zamówienie przez usługę SOAP |
| Ateneum | pliki CSV ze stanami i cenami, EAN z zapytania na pozycję | stany co 10 minut, ceny 3 razy dziennie | zamówienie jako rezerwacja, może być częściowa |
| Azymut | API XML: katalog partiami, dostępność i ceny | dane na żywo, pamięć podręczna ok. 2,5 minuty | porównanie cen i stanów |
Część hurtowni podaje stan dokładnie tylko do pewnego progu, a wyżej zakresem, np. 251-300. Wtedy liczymy dolną granicę zakresu, żeby system nie zakładał więcej towaru, niż jest. Pozostałe hurtownie, z którymi się łączymy, znajdziesz na stronie integracje z hurtowniami.
Integracja hurtowni z BaseLinkerem: n8n i własne API
Przepływ zamówienia prowadzi n8n, bo widać w nim każde wykonanie, a jedną gałąź da się poprawić bez ruszania reszty. Decyzję, którą hurtownię wybrać, podejmuje osobne API w Pythonie (FastAPI) z bazą PostgreSQL. Pliki hurtowni mają setki tysięcy wierszy (w tym wdrożeniu ok. 190 tys. w Platonie i ok. 290 tys. w Ateneum), a odpowiedź dla zamówienia musi przyjść w sekundach.
Synchronizacje działają w tle według harmonogramu, w osobnych wątkach, żeby duży plik z hurtowni nie wstrzymywał odpowiedzi dla zamówień. W teście na małym serwerze jedno zapytanie o ofertę trwało ok. 0,45 s, a bezpieczny ruch wyniósł ok. 100 zamówień na godzinę po 10 pozycji.
Więcej o samym API przeczytasz na stronie BaseLinker API, a o pomocy przy konfiguracji Base na stronie wsparcie BaseLinkera.
Co może pójść nie tak przy zamówieniach u hurtowni?
- Hurtownia nie odpowiada. Synchronizacja łapie błąd i próbuje przy następnym terminie, a w bazie zostają ostatnie pobrane dane.
- Synchronizacja przestaje zapisywać dane. Strona stanu pokazuje błąd nie tylko wtedy, gdy plik hurtowni jest niedostępny, ale też gdy dane w bazie przestały się odświeżać.
- Częściowe potwierdzenie. Liczy się ilość z odpowiedzi hurtowni, nie ilość wysłana w zamówieniu.
- Stan podany zakresem. Dolna granica zamiast zgadywania.
- Testy. Workflow, który składa prawdziwe zamówienia, nie jest uruchamiany ręcznie do testów. Zmiany sprawdzamy na danych z wcześniejszych wykonań.
Szerzej o automatyzacji e-commerce przeczytasz na stronie automatyzacja sklepu internetowego.

