Przejdź do treści

Integracja BaseLinkera: produkty, stany i zamówienia bez rozjazdów

Zamówienia z marketplace nie spadają do sklepu, stany rozjeżdżają się między kanałami, a zespół poprawia to ręcznie? Znajdujemy przyczynę w BaseLinkerze, sklepie albo ERP i usuwamy ją: konfiguracją, porządkiem w danych albo dodatkowym kodem.

Realizacjaok. 115 tys. produktów i wariantów ze stanami z BaseLinkera, zamówienia trafiają do BaseLinkera bez przepisywaniaSportina B2B · Magento + BaseLinker
BaseLinker · sklep · ERPschemat ogólny
DaneKto zwykle zapisujeTypowy rozjazd
produkty i wariantysklep, ERP albo importpozycje bez powiązania z katalogiem
stanyERP albo BaseLinkerdwa systemy piszą to samo pole
zamówieniasklep → BaseLinkerstan nie schodzi po zamówieniu
statusyBaseLinker → sklepanulowanie nie zwraca towaru
Kto jest właścicielem pola, ustalamy dla każdego wdrożenia osobno.

Co sprawdzamy przy produktach, stanach i zamówieniach

Każdy objaw ma kilka możliwych przyczyn. W każdej grupie pierwszy test jest na karcie: objaw → pierwsza kontrola (co porównać), gdzie szukać i dalszy materiał. Pozostałe objawy grupy są w rozwinięciach obok.

Produkty i pola (2)

Pierwszy test

Po imporcie z BaseLinkera Shoper pokazuje złą cenę na liście

Co porównać: cenę na liście produktów z ceną wariantu oznaczonego jako domyślny i z cenami wariantów w BaseLinkerze

Gdzie szukać: karta produktu w panelu Shopera: lista wariantów i wariant domyślny; ustawienia importu w BaseLinkerze

Materiał i usługa: wariant domyślny po imporcie · BaseLinker i Shoper

Inny objaw w tej grupie

Gotowe połączenie nie przenosi potrzebnych pól

Co porównać: listę potrzebnych pól z tym, co integracja faktycznie przenosi – na jednym zamówieniu testowym

Gdzie szukać: to samo zamówienie w sklepie i w BaseLinkerze (pozycje, dostawa, pola dodatkowe); ustawienia modułu integracji

Materiał i usługa: BaseLinker API w praktyce · rozszerzenie przez API

Stany (5)

przykład z wdrożenia B2B · pierwszy test

Zamówienie z Magento nie zdejmuje stanu w BaseLinkerze

Co porównać: pozycję zamówienia z produktem w katalogu: czy jest z nim powiązana (a nie tylko ma tę samą nazwę i SKU) i czy ma ten sam magazyn, z którego liczony jest stan

Gdzie szukać: zamówienie w panelu BaseLinkera → pozycje; przez API w getOrders: pusty product_id oznacza brak powiązania, a storage i warehouse_id pokazują źródło i magazyn

Materiał i usługa: zamówienie nie zdejmuje stanu · BaseLinker i Magento

Inne objawy w tej grupie (4)

Stan zmieniono bezpośrednio w sklepie podrzędnym i Base nie przywraca wartości z katalogu

Co porównać: dotyczy kierunku „katalog Base → sklep” (sklep podrzędny): stan produktu w katalogu Base ze stanem w sklepie – i kto zmieniał stan w sklepie bezpośrednio (panel sklepu, wtyczka, import)

Gdzie szukać: Integracje → sklep → Ustawienia, zakładka „Stany”: czy wybrano wysyłanie stanów z Base do sklepu, magazyn i częstotliwość. Według pomocy Base.com zmiana stanu zrobiona poza Base nie jest pobierana: wtyczka pamięta poprzednio przekazaną wartość, uznaje stan za zgodny i nie wysyła go ponownie; przy sklepie podrzędnym każda zmiana stanu w sklepie powoduje problem z synchronizacją – stan zmienia się w katalogu Base

Materiał i usługa: wtyczki zapisujące stan (WooCommerce) · synchronizacja stanów · diagnoza przepływu (niżej)

Komunikat „brak synchronizacji – magazyn nie został dodany do katalogu”

Co porównać: możliwa przyczyna do sprawdzenia: czy magazyn zewnętrzny, z którego mają iść stany, jest dodany do katalogu, z którym powiązane są produkty

Gdzie szukać: Produkty → Ustawienia → Katalogi. Zakres źródła: pomoc Base.com opisuje ten wymóg przy integracjach księgowych (po włączeniu synchronizacji magazyn zewnętrzny trzeba dodać do katalogu); dla innych integracji i dla samej treści komunikatu wyjaśnienia nie podaje. Jeśli magazyn jest dodany, a komunikat zostaje – zgłoszenie w panelu Base

Materiał i usługa: konfiguracja integracji

Stan na Allegro albo innym marketplace się nie aktualizuje

Co porównać: ilość, którą system widzi dla oferty (formularz oferty, pole „Ilość”), ze stanem w magazynie – i czy oferta jest powiązana z produktem

Gdzie szukać: według FAQ Base.com: konfiguracja modułu synchronizacji (w tym maksymalna ilość w ofercie), powiązanie ofert z produktami i logi synchronizacji stanów; usunięcie produktu z magazynu to nie stan 0 – oferta traci powiązanie

Materiał i usługa: konfiguracja modułu synchronizacji ofert (pomoc Base.com) · gdy zły jest już stan źródłowy w sklepie albo ERP – diagnoza przepływu (niżej)

Stany w sklepie i w BaseLinkerze się nie zgadzają

Co porównać: stan jednego SKU w trzech miejscach naraz: panel sklepu, katalog BaseLinkera (właściwy magazyn) i ERP, jeśli jest – oraz który system zmienił go ostatnio

Gdzie szukać: ustawienia integracji sklepu: kierunek aktualizacji stanów i wybrany magazyn. Według FAQ Base.com magazyn Base i magazyn sklepu nie są połączone, a przy Base jako systemie nadrzędnym stanów ze sklepu się nie wgrywa

Materiał i usługa: źródło prawdy · synchronizacja stanów · diagnoza przepływu (niżej)

Zamówienia (5)

Pierwszy test

Zamówienia ze sklepu nie pojawiają się w BaseLinkerze

Co porównać: czas złożenia zamówienia z czasem ostatniego pobrania (według FAQ Base.com domyślnie co 10 minut) oraz numer najnowszego zamówienia w sklepie z numerem ostatniego pobranego

Gdzie szukać: sekcja Integracje: ręczne pobranie zamówień. Według FAQ Base.com zmniejszenie numeracji zamówień w sklepie (na przykład po aktualizacji bazy) uniemożliwia pobieranie nowych

Materiał i usługa: diagnoza i naprawa integracji

Inne objawy w tej grupie (4)

To samo zamówienie pojawia się dwa razy

Co porównać: numer ostatniego zamówienia w sklepie przed i po aktualizacji bazy albo migracji – według FAQ Base.com zwiększenie numeracji grozi duplikatami; przy własnym eksporcie: liczbę zamówień w BaseLinkerze z tym samym numerem ze sklepu

Gdzie szukać: lista zamówień w sklepie i w BaseLinkerze (wyszukiwanie po numerze); log eksportu – czy przy zamówieniu zapisano numer z BaseLinkera przed ponowieniem

Materiał i usługa: test eksportu bez duplikatów · diagnoza i naprawa integracji

Status zmienia się w sklepie, ale nie w BaseLinkerze

Co porównać: w którym systemie i kiedy zmieniono status – z historią zamówienia w BaseLinkerze

Gdzie szukać: historia zamówienia w BaseLinkerze; według FAQ Base.com statusy idą tylko z Base do sklepu, więc zmiana w sklepie nie wraca

Materiał i usługa: ustalenie, który system prowadzi statusy – źródło prawdy · konfiguracja albo rozszerzenie

Pozycje zamówienia rozbite, jedna z inną ceną

Co porównać: cenę jednostkową pozycji w sklepie z cenami rozbitych pozycji w BaseLinkerze – różnica rzędu grosza wskazuje na zaokrąglenia

Gdzie szukać: według FAQ Base.com problem rozwiązuje wyłączenie opcji „og_fix” w ustawieniach zaawansowanych integracji sklepu

Materiał i usługa: konfiguracja integracji

Zamówienie „opłacone” bez wpłaty

Co porównać: status płatności zamówienia w sklepie z oznaczeniem w BaseLinkerze

Gdzie szukać: panel sklepu: według FAQ Base.com status płatności pochodzi ze sklepu – w WooCommerce zależy od statusów processing i completed, w PrestaShop od flag płatności

Materiał i usługa: konfiguracja integracji

Awarie i błędy API (2)

Pierwszy test

Błędy API w godzinach pracy, synchronizacja przerwana, zamówienie bez odpowiednika

Co porównać: godziny błędów ERROR_BLOCKED_TOKEN w logu sklepu z godzinami wysyłek ERP i skryptów, które korzystają z tego samego konta

Gdzie szukać: log integracji sklepu (czas, metoda, kod błędu); harmonogram ERP od osoby, która nim zarządza

Materiał i usługa: limit API dzielony z ERP · diagnoza i naprawa integracji

Inny objaw w tej grupie

BaseLinker nie działa (awaria): nie można się zalogować albo wszystkie integracje stoją naraz

Co porównać: czy problem dotyczy całej usługi (logowanie, panel, wszystkie integracje), czy tylko jednej integracji Twojego sklepu

Gdzie szukać: oficjalna strona statusu status.base.com (dawniej status.baselinker.com) – według FAQ Base.com o awarii tam publikowane są informacje o postępach; zgłoszenie w panelu sprzedawcy

Materiał i usługa: gdy status nie wskazuje awarii – objawy w pozostałych grupach · diagnoza przepływu (niżej)

Źródło wierszy oznaczonych „według FAQ Base.com”: pomoc Base.com, sekcje „Magazyn sklepu”, „Integracja ze sklepem” i „Pobieranie zamówień ze sklepu” (odczyt 13.11.2026) oraz „Synchronizacja stanów” (odczyt 15.11.2026). Wiersze „według pomocy Base.com”: artykuły synchronizacja między magazynami i integracje księgowe – magazyn (odczyt 15.11.2026). Nazwy pól API według dokumentacji api.baselinker.com (odczyt 13.11.2026). Pozostałe wiersze opierają się na diagnozach z naszych projektów, opisanych w poradnikach.

Konfiguracja lub własna integracja

Nie każdy problem z BaseLinkerem wymaga programowania. Kod jest potrzebny wtedy, gdy gotowa integracja nie przenosi czegoś, od czego zależy stan albo cena, albo gdy kilka systemów korzysta z tych samych limitów.

Gotowe połączenie, porządek czy kod: co zwykle wystarcza?

  1. Sytuacja: jeden sklep, czyste SKU i EAN, jeden system prowadzi stan.KonfiguracjaCo zwykle wystarcza: gotowa integracja dostępna w BaseLinkerze. Konfiguracja w panelu BaseLinkera, bez programowania.
  2. Sytuacja: stan „wraca”, duplikaty SKU, warianty bez wspólnego produktu, zły magazyn domyślny.Porządek w konfiguracji i danychCo zwykle wystarcza: porządek w konfiguracji i danych: kto zapisuje które pole, poprawione identyfikatory. Wtyczka hurtowni nadpisuje stan zapisany przez BaseLinker – scenariusz na stronie BaseLinker i WooCommerce.BaseLinker i WooCommerce
  3. Sytuacja: ERP i sklep korzystają z tego samego tokenu, zamówienia z własnego sklepu B2B, pola, których integracja nie ustawia.Własne rozszerzenieCo zwykle wystarcza: dodatkowy kod: kolejka i ponawianie, własny eksport zamówień, korekta po imporcie. Gdzie opisane: limit API dzielony z ERP i wariant domyślny w Shoperze po imporcie.Rozszerzenie przez API: poradnik BaseLinker API w praktyce

Diagnoza, naprawa, utrzymanie: efekt sprawdzony na jednym zamówieniu

Każdy etap zamawiasz osobno, więc płacisz za kolejny dopiero, gdy widzisz wynik poprzedniego.

  1. Diagnoza przepływuCo dostajeszmapa pól (produkt, stan, cena, zamówienie, status) z właścicielem i kierunkiem zapisu, porównanie próbki w sklepie, BaseLinkerze i ERP, lista rozbieżności z przyczyną i podziałem na konfigurację, dane albo kod, wycena naprawy
  2. Naprawa albo pilotCo dostajeszuzgodniona zmiana i test na jednym zamówieniu: stany i rezerwacje odczytane przed i po, w obu systemach
  3. Utrzymanie (opcjonalnie)Co dostajeszuzgodniony zakres kontroli rozbieżności i reakcji na błędy synchronizacji
Podobna realizacjaco noc porównanie stanów z BaseLinkerem dla ok. 115 tys. produktów i wariantów, raport: 0 różnic w sztukachSportina B2B · Magento + BaseLinker

Szczegóły dla konkretnej pary systemów

BaseLinker i Shoper

Warianty, wariant domyślny, ceny i stany w Shoperze.

BaseLinker i Shoper

BaseLinker i WooCommerce

Wtyczki zapisujące stan, przebieg wdrożenia, lista na start.

BaseLinker i WooCommerce

BaseLinker i Magento

MSI, magazyny, rezerwacje i kolejność kroków przy zamówieniach.

BaseLinker i Magento

ERP ze sklepem

Gdy stany i ceny prowadzi ERP, a BaseLinker jest jednym z odbiorców.

ERP ze sklepem

Integracja BaseLinkera — pytania

Nie ma tu Twojego pytania? Napisz

Nie zawsze. Gdy jest jeden sklep, czyste SKU i EAN i jeden system prowadzi stan, wystarcza gotowa integracja dostępna w BaseLinkerze. Programowanie jest potrzebne, gdy integracja nie przenosi pola, od którego zależy stan albo cena, gdy zamówienia trzeba eksportować z własnego sklepu albo gdy kilka systemów korzysta z tego samego limitu API.
Najczęściej dwa systemy zapisują to samo pole, np. wtyczka hurtowni i BaseLinker, albo pozycje zamówienia nie są powiązane z produktem w katalogu BaseLinkera i nie wskazują magazynu. Częsty przypadek przy sklepie podrzędnym wobec katalogu Base: stan zmieniony bezpośrednio w sklepie – według pomocy Base.com taka zmiana nie jest pobierana, a synchronizacja uznaje stan za zgodny i nie wysyła go ponownie. Zaczynamy od ustalenia, kto jest właścicielem pola, i od testu na jednym zamówieniu.
To nie wchodzi w zakres opisany na tej stronie, który dotyczy przepływu produktów, stanów i zamówień między sklepem, BaseLinkerem i ERP. Konfigurację kont marketplace, kurierów, szablonów wysyłek i faktur ustalamy osobno, jeśli jest potrzebna.
Od diagnozy przepływu: mapa pól z właścicielem i kierunkiem zapisu, porównanie próbki produktów i zamówień w sklepie, BaseLinkerze i ERP, lista rozbieżności z podziałem na konfigurację, dane i kod oraz wycena naprawy. Naprawę albo pilot i ewentualne utrzymanie zamawiasz osobno.

Napisz, co nie przepływa i między którymi systemami

Wystarczy przykład: numer zamówienia albo SKU i to, co widzisz w sklepie i w BaseLinkerze. Powiemy, czy to konfiguracja, dane czy kod, i co naprawić najpierw, żeby zespół przestał poprawiać zamówienia ręcznie.

przesyłasz

Numer zamówienia albo SKU

jeden przykład wystarczy

przesyłasz

Co widzisz w obu miejscach

w sklepie i w BaseLinkerze

odpowiadamy

Konfiguracja, dane czy kod

która z trzech dróg z wyboru wyżej