Integracja Baselinker w Hummerce łączy sklep z systemem Baselinker - zewnętrznym pośrednikiem, który wystawia oferty i odbiera zamówienia z Allegro, eBay, Amazon i wielu innych kanałów sprzedaży z jednego miejsca. Sklep udostępnia Baselinkerowi towary, stany magazynowe i zamówienia, a codzienną obsługą kanałów sprzedaży zajmuje się panel Baselinkera (usługa zewnętrzna, wymaga własnego abonamentu).
Stan na wersję Hummerce od 2.20 (ostatnie zmiany w module: 2.35.68), aktualizacja 2026-10-07.
- Jedno źródło danych dla wielu marketplace'ów - towary, stany i ceny ze sklepu trafiają do Allegro, eBay, Amazon i innych kanałów obsługiwanych przez Baselinker, bez ręcznego uzupełniania danych w każdym z nich osobno.
- Zamówienia z każdego kanału wracają do jednego sklepu - obsługa realizuje je tak samo, jak zamówienia złożone bezpośrednio w sklepie.
- Statusy i numery przesyłek aktualizują się automatycznie - zmiana statusu zamówienia lub dostawy w sklepie trafia do Baselinkera, a stamtąd do kupującego na danym marketplace.
- Listy przewozowe wracają do marketplace'u - dla zamówień z wybranych źródeł (np. Empik) sklep sam przekazuje do Baselinkera numer listu przewozowego i, opcjonalnie, status "wysłane", więc kupujący dostaje numer paczki bez ręcznej pracy obsługi (od wersji 2.35.68).
- Elastyczny wybór ceny eksportowanej do Baselinkera - cena może pochodzić z dowolnej reguły cennika, nie tylko z ceny podstawowej towaru.
- Osobny widok na towary i zamówienia integracji - katalog i baza klientów sklepu pozostają wspólne, a marketplace'e mają wydzielony zakres danych (Widoki - wiele sklepów w jednym panelu).
Baselinker odbiera ze sklepu:
- listę kategorii,
- listę towarów i szczegóły towaru, opcjonalnie z wariantami i parametrami,
- stany magazynowe,
- formy dostawy i formy płatności skonfigurowane w sklepie.
Sklep przyjmuje z Baselinkera:
- nowe zamówienia,
- zmiany statusów zamówień - Baselinker domyślnie aktualizuje status realizacji co godzinę, a status płatności co 4 godziny.
Sklep przekazuje do Baselinkera (od wersji 2.35.68):
- numery listów przewozowych zamówień z wybranych źródeł (np. Empik - to nazwa marketplace'u; źródła ustawia się w konfiguracji),
- opcjonalnie - status zamówienia (np. "wysłane") zaraz po przekazaniu numeru listu.
Integracja nie obsługuje:
- sortowania towarów po ilości na magazynie (sklep z wieloma magazynami liczy dostępność inaczej niż zakłada Baselinker),
- udostępniania zamówień złożonych bezpośrednio w sklepie z powrotem do Baselinkera,
- więcej niż jednej kategorii głównej na towar (Baselinker przypisuje jedną kategorię na produkt).
Od wersji 2.35.68 sklep może sam wysyłać do Baselinkera numery listów przewozowych dla zamówień z wybranych źródeł zamówień (np. z Empika), zamiast czekać, aż Baselinker o nie zapyta.
- Zadanie eksportu uruchamia się w harmonogramie sklepu co 5 minut i obsługuje zamówienia, które mają numer listu przewozowego i kod kuriera. Włącza się je i wyłącza w ustawieniach, bez restartu sklepu.
- Źródła zamówień objęte eksportem, limit zamówień na jeden przebieg, maksymalna liczba prób wysyłki i minimalny odstęp między wysłaniem numeru listu a statusem to ustawienia integracji. Odstęp daje Baselinkerowi czas na zarejestrowanie paczki przed zmianą statusu.
- Po przekazaniu numeru listu sklep może ustawić w Baselinkerze status zamówienia (np. "Wysłane"). Po przekroczeniu liczby prób zamówienie wypada z kolejki i czeka na reakcję obsługi.
- Panel Diagnostyka w menu Baselinker pokazuje stan modułu (token, źródła, zadanie, dostępność Baselinkera), zamówienia czekające na eksport, dostępne kody kurierów, ostatnie próby wymiany danych i błędy oraz pozwala przetestować połączenie i wyczyścić bufory panelu.
- Eksport wymaga tokenu API Baselinkera i kodu kuriera na zamówieniu. Dopóki konfiguracja jest niekompletna, zadanie się nie uruchamia, a panel Diagnostyka wskazuje, czego brakuje.
Baselinker i sklep mają osobne słowniki statusów. Integracja mapuje kombinację statusu zamówienia i dostawy w sklepie na jeden status w Baselinkerze (np. zamówienie złożone i niewysłane w sklepie odpowiada statusowi "Nowe" w Baselinkerze, zamówienie w realizacji z dostawą wysłaną - statusowi "Wysłane"). Mapowanie płatności jest opcjonalne - bez niego zamówienie dostaje płatność domyślną z konfiguracji sklepu.
- Zamówienie z Baselinkera trafia do sklepu bez wnikliwej walidacji danych kupującego - brakujące sumy sklep dolicza sam.
- Imię i nazwisko kupującego sklep dzieli na dwa pola po pierwszej spacji w danych z Baselinkera.
- Dostawa i płatność ustawiają się z mapowania w Baselinkerze, a gdy go brak - z dostawy i płatności domyślnej w konfiguracji integracji (osobno dla zamówień płatnych z góry i za pobraniem).
- Ponowne przesłanie tego samego zamówienia z Baselinkera (aktualizacja) tworzy w sklepie nowe zamówienie, nie aktualizuje istniejącego.
- Sklep udostępnia Baselinkerowi wybrane parametry towaru z dwóch grup: parametry widoczne też w panelu sklepu (przekazywane jako cechy z nazwą i wartością) oraz parametry dedykowane tylko integracji (przekazywane jako dane dodatkowe, symbol i wartość).
- Parametry wielowartościowe przekazują tylko pierwszą wartość.
- Mapowanie parametrów sklepu na parametry Allegro (gdy Baselinker wystawia ofertę na Allegro) ustawia się w panelu Baselinkera, nie w sklepie.
- Integracja z Baselinkerem dostępna od wersji Hummerce 2.20.
- Od wersji 2.35.68 - przekazywanie numerów listów przewozowych (i opcjonalnie statusu zamówienia) do Baselinkera dla zamówień z wybranych źródeł oraz panel diagnostyczny integracji.
- Stronicowanie listy towarów, cen i wariantów (parametr strony i konfigurowalna liczba pozycji na stronę) - wprowadzone w kolejnej wersji modułu, przydatne przy dużych katalogach.
- Aktywny abonament w usłudze Baselinker (zewnętrznej, poza Hummerce) i skonfigurowana integracja "sklep własny" w panelu Baselinkera.
- Widoki - integracja korzysta z widoku towarów (co eksportować) i widoku zamówień (do którego widoku trafiają zamówienia z Baselinkera); mogą to być te same widoki, co inne integracje, albo dedykowane.
- Sposoby dostawy i płatności w sklepie, do których mapuje się dostawy i płatności z Baselinkera.
- Wymaga wdrożenia - moduł nie działa sam po aktualizacji. Zakres typowego uruchomienia:
- włączenie modułu i wygenerowanie hasła komunikacji,
- konfiguracja integracji "sklep własny" w panelu Baselinkera (adres pliku wymiany danych, hasło komunikacji),
- wskazanie widoku towarów i widoku zamówień integracji, dostawy i płatności domyślnej,
- test połączenia i pierwszego pobrania towarów i zamówień,
- opcjonalnie: przekazywanie listów przewozowych do Baselinkera - token API Baselinkera, źródła zamówień, kod kuriera, status wysłania, włączenie zadania eksportu i próby w trybie atrapy, który tylko loguje żądania,
- opcjonalnie: mapowanie parametrów na cechy Allegro w panelu Baselinkera (po stronie Baselinkera, nie sklepu).
- Minimalny szacowany czas: podstawowe uruchomienie (jeden widok towarów, standardowe parametry, bez wariantów) - od 8 h; zawsze doliczamy: analiza - +1 h, testy - +2 h, wdrożenie produkcyjne - +1 h.
- Czas konkretnego wdrożenia zależy od jego zakresu - wyceniamy go indywidualnie.
- Od czego zależy czas:
- liczba widoków i marketplace'ów obsługiwanych przez Baselinker,
- obsługa wariantów towaru i dodatkowych parametrów,
- mapowanie niestandardowych statusów i płatności,
- wersja sklepu - starsza wersja wymaga najpierw aktualizacji (wycena osobno).
- Integracja nie sortuje towarów po ilości na magazynie - ograniczenie wynika z obsługi wielu magazynów w sklepie.
- Zamówienia złożone bezpośrednio w sklepie nie trafiają z powrotem do Baselinkera. Przekazywanie listów przewozowych dotyczy tylko zamówień z wybranych źródeł, które pochodzą z Baselinkera.
- Przekazywanie listów przewozowych wymaga tokenu API Baselinkera i kodu kuriera na zamówieniu, a Baselinker dopuszcza 100 zapytań na minutę, dlatego sklep wysyła zamówienia partiami.
- Jeden towar - jedna kategoria główna po stronie Baselinkera, niezależnie od tego, do ilu kategorii jest przypisany w sklepie.
- Mapowanie parametrów sklepu na parametry Allegro (w panelu Baselinkera) działa tylko w polach kategorii Allegro, nie w opisie oferty - parametry typu tak/nie w opisie pokazują się tak, jak są zapisane w sklepie.
- Ponowne przesłanie tego samego zamówienia z Baselinkera tworzy nowe zamówienie zamiast aktualizować istniejące.
- Aktualizacja statusów następuje z inicjatywy Baselinkera w jego cyklu (domyślnie co godzinę dla dostawy, co 4 godziny dla płatności), nie natychmiast po zmianie w sklepie. Wyjątkiem jest numer listu przewozowego (i opcjonalnie status wysłania) zamówień z wybranych źródeł - sklep wysyła je sam, w cyklu co 5 minut.
- Nie weryfikujemy zadania pod kątem zgodności z prawem (np. licencje przekazanych materiałów, RODO, regulamin sklepu).
- Sortowanie towarów po ilości magazynowej przy wielu magazynach.
- Przekazywanie zamówień złożonych w sklepie z powrotem do Baselinkera.
- Więcej niż jedna kategoria główna na towar po stronie integracji.
Czy przez Baselinker można wystawiać oferty na kilku marketplace'ach naraz?
Tak - to podstawowa rola Baselinkera jako pośrednika; sklep udostępnia mu towary i stany, a wystawianie na Allegro, eBay, Amazon i inne kanały konfiguruje się w panelu Baselinkera.
Czy zamówienia z Baselinkera trafiają do tego samego sklepu, co zamówienia złożone bezpośrednio?
Tak. Obsługa realizuje je tak samo jak pozostałe zamówienia, w widoku zamówień wskazanym w konfiguracji integracji.
Czy integracja aktualizuje statusy zamówień na bieżąco?
Nie natychmiastowo - Baselinker sam odpytuje sklep o statusy w swoim cyklu (domyślnie co godzinę dla dostawy, co 4 godziny dla płatności).
Czy sklep sam przekazuje numery przesyłek do Baselinkera?
Tak, od wersji 2.35.68, dla zamówień z wybranych źródeł (np. Empik). Zadanie eksportu działa co 5 minut i wymaga tokenu API Baselinkera oraz kodu kuriera. Dla pozostałych zamówień Baselinker pobiera dane w swoim cyklu.
Czy trzeba osobno płacić za Baselinker?
Tak. Baselinker to usługa zewnętrzna z własnym abonamentem, niezależna od Hummerce.
Ile trwa uruchomienie integracji z Baselinkerem?
Podstawowe uruchomienie z jednym widokiem towarów - od 8 h. Czas konkretnego wdrożenia zależy od liczby widoków, marketplace'ów i niestandardowych mapowań.
Chcecie sprawdzić, jak integracja z Baselinkerem może działać w Waszym sklepie? Umówcie bezpłatną prezentację.
- Konfiguracja -> Ustawienia, sekcja Baselinker: hasło komunikacji (wklejane z panelu Baselinkera), kryteria zamówień pobieranych z Baselinkera (np. źródło), domyślne dostawy i płatności (osobno dla zamówień za pobraniem), widok towarów eksportowanych do Baselinkera, widok zamówień, ustawienia stronicowania listy towarów, cen i wariantów.
- Baselinker -> Diagnostyka (od wersji 2.35.68): stan eksportu listów przewozowych, kolejka zamówień, kody kurierów, ostatnie żądania i błędy, Testuj połączenie, Wyczyść bufory.
- Ustawienia eksportu listów przewozowych (od wersji 2.35.68): Adres API Base, Token API Base, Uruchom task eksportu listów przewozowych, Źródła zamówień objęte eksportem listów, Limit zamówień na przebieg eksportu, Maksymalna liczba prób wysyłki, Minimalny odstęp między wysłaniem listu a statusem (ms), ID statusu wysłania w Base, Przekaż status zamówienia po liście, Użyj atrapy klienta API (tylko loguje żądania), Logowanie każdego komunikatu. Kod kuriera pobiera się z parametru zamówienia wskazanego w konfiguracji modułu.
- W panelu Baselinkera: integracja typu "sklep własny" z adresem pliku wymiany danych (adres panelu sklepu z końcówką integracji) i wklejonym hasłem komunikacji; zakładki Zamówienia, Produkty, Statusy i Wysyłki po stronie Baselinkera.
Integracja działa przez własny plik wymiany danych i zadania wywoływane przez Baselinker - niezależnie od REST API i asystenta AI (MCP).
- Parametry towaru udostępniane Baselinkerowi ustawia się w dwóch lokacjach: jednej współdzielonej z panelem sklepu (przekazywanej jako cechy z nazwą i wartością) i jednej dedykowanej tylko integracji (przekazywanej jako dane dodatkowe, symbol i wartość) - zmienia się je w Parametrach i lokacjach.
- Mapowanie pól towaru (cena, VAT, EAN, nazwa, waga, opis, dane producenta, kategoria) i pól zamówienia (dane dostawy, dane do faktury, kontakt, komentarz) między Baselinkerem a sklepem jest ustalone domyślnie w konfiguracji modułu; zmiana wymaga edycji pliku konfiguracyjnego modułu przez wdrożeniowca.
- Parametr zamówienia
_baselinkerWaybillSendStatus zapisuje postęp eksportu listu przewozowego (kolejka, paczka wysłana, status wysłany, błąd); _baselinkerWaybillErrorCount - licznik błędnych prób.
- Cena eksportowana do Baselinkera może pochodzić z dowolnej reguły cennika przypisanej do widoku towarów integracji, zamiast tylko z ceny podstawowej.