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 + BaseLinkerBaseLinker wysyła stany przez REST API. Sklep i BaseLinker pokazują to samo.
| Wariant | BaseLinker | WooCommerce | Ostatni 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”.
| Wariant | BaseLinker | WooCommerce | Ostatni 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.
| Wariant | BaseLinker | WooCommerce | Ostatni zapis | Stan |
|---|---|---|---|---|
| BLUZA-M | 4 | 4 | BaseLinker | zgodny |
| BLUZA-L | 2 | 2 | BaseLinker | zgodny |
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?
- 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. - 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 - 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)
- Integracja WooCommercePołączenie konfigurujesz w panelu Base (BaseLinkera): dodajesz integrację WooCommerce.
- Klucze REST APIW WooCommerce generujesz klucze REST API z uprawnieniami do odczytu i zapisu i wklejasz je w formularzu integracji.
- Oficjalna 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ń.
Ź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- Zamówienie w WooCommercewedług pomocy Base.com oficjalna wtyczka Base dba o prawidłowe przekazywanie danych zamówień
- Base (BaseLinker)zamówienia i stany obsługiwane w BaseLinkerze; po ustaleniu właściciela stan pisze tylko BaseLinker
- Stan w WooCommercepole, do którego mogą pisać też inne wtyczki
| Punkt · kto zapisuje | Co się dzieje | Wynik |
|---|---|---|
| A · BaseLinker | wysyła stany przez REST API | właściciel pola |
| B · wtyczka synchronizacji z hurtownią | po zapisie produktu wpisuje stan z własnego feedu | stan „wraca” |
| C · rozszerzenia do rezerwacji i przedsprzedaży | potrafią nadpisywać stan po każdym zapisie produktu | konflikt zapisu |
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
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ę.
- Wtyczki i właściciele póllista aktywnych wtyczek i mapa właścicieli pól: kto zapisuje stan, cenę, SKU i status zamówienia,
- Audyt identyfikatorówSKU na poziomie wariantu, EAN na właściwym poziomie, duplikaty, SKU generowane automatycznie,
- Uruchomienie na próbcekilkadziesiąt SKU i jedno zamówienie testowe, ze sprawdzeniem stanu przed i po,
- 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
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.
| Mechanizm | Dobre do | Opóźnienie | Obciążenie sklepu | Ryzyko |
|---|---|---|---|---|
| Webhook | nowe zamówienie, zmiana statusu | sekundy | niskie | zgubione zdarzenie przy awarii odbiornika |
| REST — pojedynczy zapis | korekta jednego produktu | sekundy | średnie | przy tysiącach rekordów przeciąża hosting |
| REST — endpoint zbiorczy | masowa aktualizacja stanów i cen | minuty | niskie na rekord | trzeba dobrać rozmiar paczki do limitów serwera (domyślnie do 100 obiektów na wywołanie) |
| Odpytywanie cykliczne | systemy bez webhooków | tyle, ile interwał | wysokie | puste przebiegi obciążają bazę |
| Plik CSV/XML | dobowy feed od hurtowni | godziny | niskie | brak 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.
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ć.
Lista aktywnych wtyczek
wykrycie konfliktów zapisu
Liczba produktów z wariantami
skala masowych aktualizacji
Ryzyko, transport, porządki
co uporządkować przed podłączeniem BaseLinkera