Przejdź do treści

Integracja BaseLinker z WooCommerce: kto zapisuje stan

Stan w WooCommerce skacze, bo zapisuje go kilka wtyczek naraz, a kanały sprzedają towar, którego już nie ma? Sprawdzamy, które wtyczki zmieniają stan, ceny i SKU, ustalamy jednego właściciela każdego pola i podłączamy BaseLinkera tak, żeby masowe aktualizacje nie spowalniały sklepu.

Realizacjaok. 115 tys. produktów i wariantów ze stanami z BaseLinkera, zamówienia wracają do BaseLinkera bez przepisywaniaSportina B2B · Magento + BaseLinker
Jedno pole stanu, dwa zapisy demo · dane przykładowe

BaseLinker wysyła stany przez REST API. Sklep i BaseLinker pokazują to samo.

WariantBaseLinkerWooCommerceOstatni zapis Stan
BLUZA-M 4 4 BaseLinker zgodny
BLUZA-L 2 2 BaseLinker zgodny

Po zapisie produktu wtyczka synchronizacji z hurtownią wpisuje stan z własnego feedu. Przy następnym przelocie BaseLinker wpisze 4, wtyczka znów 6 — stan „wraca”.

WariantBaseLinkerWooCommerceOstatni zapis Stan
BLUZA-M 4 6 wtyczka nadpisany
BLUZA-L 2 2 BaseLinker zgodny

Ustalony właściciel pola: wtyczka nie zapisuje już stanu w sklepie. Stan pisze tylko BaseLinker, a każdy zapis ma wpis w logu.

WariantBaseLinkerWooCommerceOstatni zapis Stan
BLUZA-M 4 4 BaseLinker zgodny
BLUZA-L 2 2 BaseLinker zgodny
Demonstracja na danych przykładowych. Która wtyczka i które pole są w konflikcie, ustalamy na liście wtyczek konkretnego sklepu.

Gotowa integracja i oficjalna wtyczka Base: kiedy wystarczą

O tym, czy stany i ceny będą się zgadzać, decyduje konfiguracja w panelu i to, czy inne wtyczki nie zapisują tych samych pól. Trzy możliwe odpowiedzi:

Kiedy wystarcza gotowa integracja Base z WooCommerce, a kiedy potrzebna jest praca wdrożeniowa?

  1. Sytuacja: jeden sklep, unikalne SKU na każdym wariancie, stan prowadzi jeden system.01 · Gotowe połączenieZwykle wystarcza: integracja w panelu Base z kluczami REST API, oficjalna wtyczka i konfiguracja: statusy, magazyn, powiązanie produktów.
    Sygnał, że to za mało: po zamówieniu testowym stan albo cena w sklepie różni się od BaseLinkera.
  2. Sytuacja: inne wtyczki zapisują stan, ceny albo SKU (rezerwacje, ceny hurtowe, synchronizacja z hurtownią).02 · Konflikt zapisuZwykle wystarcza: mapa właścicieli pól: kto zapisuje które pole.
    Sygnał, że to za mało: dwa systemy zapisują to samo pole i trzeba to rozdzielić konfiguracją albo kodem.
    Rysunek i obszary niżej
  3. Sytuacja: proces obejmuje ERP albo potrzebne jest pole, którego nie widać w integracji.03 · Własne rozszerzenieZwykle wystarcza: najpierw gotowe połączenie i jego konfiguracja: Base ma gotowe integracje z wieloma systemami ERP (lista na base.com).
    Sygnał, że to za mało: potwierdzony brak potrzebnej funkcji albo pola w gotowym połączeniu – dopiero wtedy rozszerzenie przez API.
    Poradnik BaseLinker API w praktyce

Rola wtyczki i REST API przy gotowym połączeniu (odpowiedź 01)

  1. panel BaseIntegracja WooCommercePołączenie konfigurujesz w panelu Base (BaseLinkera): dodajesz integrację WooCommerce.
  2. WooCommerceKlucze REST APIW WooCommerce generujesz klucze REST API z uprawnieniami do odczytu i zapisu i wklejasz je w formularzu integracji.
  3. WordPress.orgOficjalna wtyczka BaseNa koniec instalujesz oficjalną wtyczkę Base z katalogu WordPress.org (nazwa: „Base (formerly BaseLinker)”) – według pomocy Base.com dba ona między innymi o prawidłowe przekazywanie danych zamówień.
Strona rozszerzeń BaseLinkera wymienia ją jako „Wtyczka BaseLinker WooCommerce” (stan sprawdzony 15.11.2026).

Źródła: pomoc Base.com: integracja WooCommerce · strona rozszerzeń BaseLinkera · wtyczka w katalogu WordPress.org · integracje ERP w Base.

Które systemy zmieniają stany

Sam protokół jest prosty: REST API i webhooki. Kłopot zaczyna się, gdy wtyczka do rezerwacji, druga do cen hurtowych i trzecia do synchronizacji z hurtownią zapisują stan w tym samym momencie co BaseLinker. To najczęstsza przyczyna „integracja działa, ale dane wracają”, dlatego poniższe obszary przeglądamy zawsze — niezależnie od tego, ile wtyczek jest zainstalowanych.

Zamówienie → Base → stan w WooCommerce: kto zapisuje pole stanu

schemat
  1. Zamówienie w WooCommercewedług pomocy Base.com oficjalna wtyczka Base dba o prawidłowe przekazywanie danych zamówień
  2. Base (BaseLinker)zamówienia i stany obsługiwane w BaseLinkerze; po ustaleniu właściciela stan pisze tylko BaseLinker
  3. Stan w WooCommercepole, do którego mogą pisać też inne wtyczki
pole stanu w WooCommerce · punkty zapisuschemat
Punkt · kto zapisujeCo się dziejeWynik
A · BaseLinkerwysyła stany przez REST APIwłaściciel pola
B · wtyczka synchronizacji z hurtowniąpo zapisie produktu wpisuje stan z własnego feedustan „wraca”
C · rozszerzenia do rezerwacji i przedsprzedażypotrafią nadpisywać stan po każdym zapisie produktukonflikt zapisu
B i C zapisują to samo pole co A, poza BaseLinkerem. Rozdzielamy to konfiguracją albo kodem, tak żeby stan pisał tylko jeden system, a każdy zapis miał wpis w logu.

Metoda wywołania w każdym punkcie

zamówienie → Base, A · Base → stan (pojedynczy zapis i endpoint zbiorczy), B i C · wtyczki
  • Zamówienie → Base: integracja w panelu Base z kluczami REST API WooCommerce (uprawnienia do odczytu i zapisu); oficjalna wtyczka Base według pomocy Base.com dba między innymi o prawidłowe przekazywanie danych zamówień.
  • A · Base → stan: REST API. Korekta jednego produktu – pojedynczy zapis; masowa aktualizacja stanów i cen – endpoint zbiorczy, domyślnie do 100 obiektów na wywołanie.
  • B i C · wtyczki: zapis po zapisie produktu, poza BaseLinkerem. Rozdzielamy to konfiguracją albo kodem, tak żeby stan pisał tylko jeden system, a każdy zapis miał wpis w logu.

Obszary, które przeglądamy zawsze

zapis stanu, ceny i promocje, SKU wariantów, checkout i pola zamówienia, nadpisania REST API, zadania cykliczne
Zapis stanuRozszerzenia do rezerwacji, przedsprzedaży i synchronizacji z hurtownią potrafią nadpisywać stan po każdym zapisie produktu.
Ceny i promocjeWtyczki cen hurtowych i reguł rabatowych dokładają własne pola meta. Trzeba wiedzieć, które z nich czyta koszyk.
SKU wariantówCzęść rozszerzeń generuje SKU automatycznie. Jeżeli zmieni je po imporcie, integracja traci klucz dopasowania.
Checkout i pola zamówieniaModyfikacje checkoutu zmieniają strukturę danych zamówienia, które później eksportujemy dalej.
Nadpisania REST APINiektóre wtyczki rozszerzają lub filtrują odpowiedzi REST. Trzeba sprawdzić, czy nie zmieniają pól, na których opiera się integracja.
Zadania cykliczneWP-Cron uruchamiany ruchem użytkownika potrafi kumulować zadania. Przy integracji lepszy jest systemowy harmonogram.

Cztery etapy wdrożenia: jeden właściciel każdego pola

Samo podłączenie (integracja w panelu Base, klucze REST API i wtyczka) to kilka kroków. Praca polega na tym, żeby po podłączeniu BaseLinker, sklep i jego wtyczki nie zapisywały tych samych pól na zmianę.

  1. Wtyczki i właściciele pólod tego zależy resztalista aktywnych wtyczek i mapa właścicieli pól: kto zapisuje stan, cenę, SKU i status zamówienia,
  2. Audyt identyfikatorówSKU na poziomie wariantu, EAN na właściwym poziomie, duplikaty, SKU generowane automatycznie,
  3. Uruchomienie na próbcekilkadziesiąt SKU i jedno zamówienie testowe, ze sprawdzeniem stanu przed i po,
  4. Harmonogram i logisystemowy cron zamiast WP-Cron, tempo masowych zapisów, kolejka ponowień i raport rozbieżności stanu.

Od etapu pierwszego zależy reszta: jeśli wtyczka do hurtowni albo rezerwacji nadal zapisuje stan, żadne ustawienie BaseLinkera tego nie naprawi. Jak podzielić odpowiedzialność za pola między systemy, opisuje poradnik o źródle prawdy.

Dane dostępowe (klucze i hasła do sklepu, token BaseLinkera) przekazujemy osobnym kanałem, nie w formularzu kontaktowym.

Co przygotować na start: sześć rzeczy, które skracają wdrożenie

ElementPo coKto daje
lista aktywnych wtyczekwykrycie konfliktów zapisuklient
lista kanałów sprzedażyzakres synchronizacjiklient
eksport produktów z SKU i EANaudyt dopasowania wariantówklient
decyzja o staniejedno źródło prawdywspólnie
kopia sklepu albo stagingtest bez ryzyka dla sprzedażyklient
okno na testyzamówienie testowe przed pełnym katalogiemwspólnie

Webhook, odpytywanie czy zapis zbiorczy — do czego który

Każdy z tych mechanizmów ma inne zastosowanie. Wybór wynika z tego, czy dane zmieniają się punktowo, czy masowo — i jak szybko muszą być widoczne. Zasada w skrócie: webhook do zdarzeń, zapis zbiorczy do masowych zmian, jeden właściciel każdego pola.

Porównanie sposobów wymiany danych z WooCommerce
MechanizmDobre doOpóźnienieObciążenie sklepuRyzyko
Webhooknowe zamówienie, zmiana statususekundyniskiezgubione zdarzenie przy awarii odbiornika
REST — pojedynczy zapiskorekta jednego produktusekundyśrednieprzy tysiącach rekordów przeciąża hosting
REST — endpoint zbiorczymasowa aktualizacja stanów i cenminutyniskie na rekordtrzeba dobrać rozmiar paczki do limitów serwera (domyślnie do 100 obiektów na wywołanie)
Odpytywanie cyklicznesystemy bez webhookówtyle, ile interwałwysokiepuste przebiegi obciążają bazę
Plik CSV/XMLdobowy feed od hurtownigodzinyniskiebrak reakcji na zdarzenia w ciągu dnia

Wydajność: masowa aktualizacja nie może zatrzymać sprzedaży

diff, batch, tempo, zapis, zamówienie, koniec – kontrola i reakcja na błąd na każdym etapie przelotu

Każdy zapis produktu w WooCommerce pociąga za sobą akcje innych rozszerzeń i czyszczenie cache. Przy dziesiątkach tysięcy rekordów to się sumuje, dlatego każdy etap przelotu ma swoją kontrolę i reakcję na błąd.

diffporównanie przed wysyłką: zapis tylko tego, co się zmieniło. Błąd → pomiń rekord.
batchrozmiar paczki dobrany do limitów pamięci i czasu wykonania. Błąd → zmniejsz i ponów.
tempoograniczenie liczby równoległych zapytań do sklepu, okno aktualizacji poza godzinami największego ruchu. W trakcie: monitoring czasu odpowiedzi i automatyczne zwolnienie tempa.
zapiskod odpowiedzi REST. Błąd → kolejka ponowień.
zamówienieklucz idempotencji, czyli znacznik, dzięki któremu ponowiona wysyłka nie tworzy drugiego zamówienia; gdy odpowiedź nie dotarła, przed ponowieniem sprawdzamy, czy zamówienie już jest w BaseLinkerze. Efekt: bez duplikatu.
koniecraport rozbieżności. Rozbieżność → alert e-mail.

BaseLinker i WooCommerce — pytania

Nie ma tu Twojego pytania? Napisz

Z oficjalnego katalogu WordPress.org: wtyczka nazywa się „Base (formerly BaseLinker)”, a odnośnik do niej podaje też strona rozszerzeń BaseLinkera (stan sprawdzony 15.11.2026). Samo połączenie konfiguruje się w panelu Base: integracja WooCommerce i klucze REST API z uprawnieniami do odczytu i zapisu; wtyczka według pomocy Base.com dba między innymi o prawidłowe przekazywanie danych zamówień. O tym, czy stany i ceny będą się zgadzać, decyduje konfiguracja i to, czy inne wtyczki nie zapisują tych samych pól.
Najczęściej łączymy oba. Webhooki dobrze nadają się do zdarzeń, czyli nowego zamówienia albo zmiany statusu. REST API sprawdza się przy masowej aktualizacji stanów i cen. Sam polling po REST przy dużym katalogu potrafi mocno obciążyć sklep.
Bo wariant ma własne ID i własne SKU, a często jest zapisany bez SKU (dziedziczy po rodzicu) albo z SKU zdublowanym przez import. Integracja dopasowuje wtedy pozycję do rodzica i aktualizuje zły rekord. Unikalne SKU na każdym wariancie rozwiązuje większość takich przypadków.
Te, które nadpisują zapis stanu, dokładają własne pola cen, modyfikują checkout albo podmieniają REST API. Przed wdrożeniem sprawdzamy, co jeszcze zapisuje do produktu i zamówienia, bo integracja i wtyczka potrafią walczyć o to samo pole.
Aktualizujemy paczkami, tylko rekordy zmienione, poza godzinami szczytu i z limitem równoległych zapytań. Warto też pilnować, żeby każdy zapis nie wywoływał pełnego przeliczania i czyszczenia cache dla całego katalogu.
Każde zamówienie dostaje własny klucz idempotencji, a integracja zapisuje, że zostało już przekazane, więc nie wysyła go drugi raz. Gdy po błędzie sieci odpowiedź nie dotarła, przed ponowieniem sprawdzamy, czy zamówienie z tym numerem ze sklepu jest już w BaseLinkerze.

Prześlij listę aktywnych wtyczek i liczbę produktów z wariantami

Na tej podstawie ocenimy ryzyko konfliktów, dobierzemy transport i powiemy, co uporządkować przed podłączeniem BaseLinkera, żeby stany przestały się rozjeżdżać.

przesyłasz

Lista aktywnych wtyczek

wykrycie konfliktów zapisu

przesyłasz

Liczba produktów z wariantami

skala masowych aktualizacji

odpowiadamy

Ryzyko, transport, porządki

co uporządkować przed podłączeniem BaseLinkera