Przejdź do treści

Integracja BaseLinker z Shoperem: jeden stan w kanałach

Sprzedajesz na Shoperze i na Allegro czy Amazonie przez BaseLinkera, a stany rozjeżdżają się między kanałami? Ustalamy, który system rządzi stanem i ceną, porządkujemy SKU i EAN wariantów i wdrażamy wymianę, w której sprzedaż w jednym kanale obniża dostępność w pozostałych.

Realizacjaok. 115 tys. produktów i wariantów ze stanami z BaseLinkera, zamówienia wracają do BaseLinkera bez przepisywaniaSportina B2B · Magento + BaseLinker
Jedna sprzedaż na Allegro: stan 3 → 2 w każdym kanale przykład · dane demonstracyjne
BaseLinker pobiera zamówienie z Allegro; Amazon i inne kanały dostają ten sam stan
  • stan wariantu M: 3 → 2
  1. BaseLinker → Shoper Stan 2 na wariancie M przez Shoper API, na rekordzie wariantu, nie na produkcie nadrzędnym
  2. Shoper → BaseLinker: brak Shoper nie odsyła stanu stan płynie w jedną stronę, więc nie wraca stara wartość
  3. zostaje w Shoperze Opis, zdjęcia i cena detaliczna integracja ich nie nadpisuje
Shoper sklep
  • karta produktu
  • cena detaliczna
Przykładowy scenariusz, nie dane klienta. Długość cyklu zależy od harmonogramu i limitów API.

Co dzieje się po zakupie na Allegro

Gdy ten sam towar leży na Allegro, Amazonie i w sklepie, każdy kanał próbuje sprzedać pełną dostępność. Dlatego po zakupie zawsze biegnie ta sama sekwencja, w jednym, znanym cyklu. Każdy krok ma własny warunek poprawności i wpis w logu — jeżeli któryś zawiedzie, wiadomo dokładnie który.

Jedna sprzedaż na Allegro: droga zamówienia i aktualizacja stanu

przykładowy scenariusz
  1. zamówienie · BaseLinkerPobranie zamówieniaz marketplace, z pozycjami, ilościami i danymi wysyłki
  2. zamówienie · BaseLinkerDopasowanie pozycjipo SKU, a gdy go brak — po EAN; bez dopasowania pozycja trafia do wyjątków
  3. stan · źródło prawdyZejście ze stanustan wariantu M: 3 → 2 w systemie, który jest źródłem prawdy
  4. stan · według harmonogramuZapis do Shoperapaczką przez Shoper API; długość cyklu zależy od harmonogramu i limitów API
  5. zamówienie · kanał sprzedażyPowrót statusuzmiana statusu i numer przewozowy wracają do kanału sprzedaży
Fioletowe kroki to droga zamówienia, zielone – aktualizacja stanu. Szczegóły kroków niżej: awarie, które psują się właśnie tutaj, stoją przy kroku, którego dotyczą: trzy dotyczą identyfikatorów i kierunku zapisu, czwarta — flagi wariantu domyślnego, której import z BaseLinkera nie ustawia.
  1. 01

    Pobranie zamówienia log: INFO

    BaseLinker odbiera zamówienie z marketplace wraz z pozycjami, ilościami i danymi wysyłki.

  2. 02

    Dopasowanie pozycji log: WARN

    Każda pozycja szuka swojego odpowiednika po SKU, a gdy go brak — po EAN.

    Gdy się nie uda: brak dopasowania: pozycja trafia do wyjątków, bez zapisu — nie do cichego pominięcia.

    Typowe awarie przy tym kroku

    Wariant bez własnego SKU

    Rozmiar w Shoperze dzieli SKU z produktem nadrzędnym, więc integracja aktualizuje rodzica albo pomija wariant. Efekt: stan rozjeżdża się tylko na części rozmiarów.

    EAN na złym poziomie

    Kod EAN przypisany do produktu, nie do wariantu, uniemożliwia dopasowanie zamówienia z marketplace i wypycha pozycje do ręcznej obsługi.

  3. 03

    Zejście ze stanu log: INFO

    Stan spada w systemie, który jest jego źródłem prawdy. Pozostałe kanały dostają wynik, a nie własne wyliczenie.

    Typowa awaria przy tym kroku

    Dwa systemy piszą stan

    Stan wraca cyklicznie do poprzedniej wartości. Prawie zawsze oznacza to dwa zapisy do jednego pola — nie „opóźnienie synchronizacji”.

  4. Punkt opóźnienia

    Nowa dostępność trafia do Shopera przy zapisie paczką przez Shoper API. Czas od zakupu do zmiany stanu w Shoperze zależy od harmonogramu i limitów API – harmonogram opisujemy w bloku wdrożeniowym niżej.

  5. 04

    Zapis do Shopera log: WARN / ERROR

    Nowa dostępność idzie przez Shoper API paczką, a odpowiedź trafia do logu. Karta produktu i cena detaliczna zostają w Shoperze.

    Gdy się nie uda: błąd sieci: ponowienie; HTTP 429: backoff i ponowienie; HTTP 5xx: ponowienie, potem alert.

  6. 05

    Powrót statusu log: INFO

    Zmiana statusu i numer przewozowy wracają do kanału sprzedaży, żeby kupujący nie pytał o przesyłkę mailem.

  7. ↺

    Zwrot log: INFO

    Stan wraca automatycznie: statusom zwrotu i anulowania ustawiamy w BaseLinkerze zwrot stanu, a kanały dostają korektę.

Który system aktualizuje dane

Tabelę wypełniamy razem z klientem przed pierwszą linijką kodu. Każde pole ma jeden kierunek zapisu, a każda zmiana wpis w logu, więc da się odtworzyć, kto ostatni ruszył stan. Bez takiej tabeli integracja działa do pierwszej kolizji, a potem zaczyna się szukanie, „dlaczego cena wróciła”.

Podział odpowiedzialności między Shoperem a BaseLinkerem
DaneŹródło prawdyKierunekCzęstotliwość
Karta produktu, opis, zdjęciaShoperShoper → BaseLinkerprzy zmianie
Stan magazynowyBaseLinkerBaseLinker → Shopercyklicznie, według harmonogramu
Cena detaliczna w sklepieShoperbez synchronizacji—
Cena na marketplaceBaseLinkerbez synchronizacji—
Zamówienia z marketplaceBaseLinkerBaseLinker → Shoper (opcjonalnie)na zdarzenie
Statusy i numer przewozowyBaseLinkerBaseLinker → kanał sprzedażyna zdarzenie

Dwie ceny, dwa źródła prawdy

Cena detaliczna w sklepieShoper
  • źródło prawdy: Shoper
  • bez synchronizacji
Cena na marketplaceBaseLinker
  • źródło prawdy: BaseLinker
  • bez synchronizacji
Rozdzielenie ceny detalicznej od marketplace’owej jest celowe: prowizje i strategia cenowa są tam inne, a próba trzymania jednej ceny w obu miejscach kończy się ręcznym poprawianiem po każdej promocji.

Skala katalogu i harmonogram: duży katalog wymaga innego harmonogramu

Przy kilkudziesięciu tysiącach SKU nie da się aktualizować wszystkiego przy każdej zmianie. Proces musi wiedzieć, co faktycznie się zmieniło, i rozłożyć zapisy w czasie.

produktów w katalogu sklepu na Shoperze zasilanego z BaseLinkera (pełny odczyt przez Shoper API, wrzesień 2026)
ok. 22 tys.
wariantów (rozmiarów) w tym katalogu
ok. 168 tys.
domyślny licznik Shoper API, zwalniany po 2 na sekundę; stan limitu czytamy z nagłówków odpowiedzi
10 operacji
limit zapytań API BaseLinkera
100 / min

Przy takim katalogu i takich limitach pełny przelot to kwestia godzin, nie minut. Przelot w środku dnia wyczerpuje limit i część aktualizacji przepada bez śladu, jeżeli proces nie ma kolejki i ponowień.

  • aktualizujemy wyłącznie rekordy z realną zmianą stanu lub ceny,
  • zapisy idą paczkami z kontrolą tempa i kolejką ponowień,
  • pełny przelot katalogu poza godzinami największego ruchu,
  • błąd 429 albo timeout nie gubi rekordu — wraca do kolejki,
  • każda operacja ma wpis w logu: co, kiedy, z jakim wynikiem.

Cztery etapy wdrożenia: od porządku w SKU do jednego stanu

BaseLinker ma gotowy moduł do Shopera. Zakres pracy to ustawienie wszystkiego wokół niego tak, żeby po uruchomieniu dane w obu systemach nadal się zgadzały. Etap drugi jest tym, który najczęściej decyduje o wyniku.

  1. Mapa kanałów i pólkto sprzedaje gdzie i który system rządzi którym polem (tabela wyżej),
  2. Audyt identyfikatorówdecyduje o wynikuSKU na poziomie wariantu, EAN na właściwym poziomie, duplikaty,
  3. Uruchomienie na próbcekilkadziesiąt SKU i realne zamówienie testowe przed pełnym katalogiem,
  4. Harmonogram i logitempo zapisów, kolejka ponowień, alert przy 5xx, raport rozjazdów stanu.

Sześć rzeczy, które skracają wdrożenie

ElementPo coKto daje
konto użytkownika Shoper API (login i hasło webapi)zapis stanów i odczyt kataloguklient
token BaseLinkerzamówienia, statusy, magazynklient
lista kanałówzakres synchronizacjiklient
decyzja o staniejedno źródło prawdywspólnie
eksport SKU/EANaudyt dopasowania pozycjiklient
okno na testyzamówienie testowe bez ryzykawspólnie

BaseLinker i Shoper — pytania

Nie ma tu Twojego pytania? Napisz

Przy sprzedaży na marketplace stan zwykle prowadzi BaseLinker, bo to on rozdziela dostępność między Allegro, Amazon i sklep. Shoper dostaje wtedy stan z jednego kierunku. Odwrotny układ ma sens wtedy, gdy sklep jest jedynym kanałem sprzedaży albo gdy stan prowadzi ERP, a BaseLinker tylko go rozdziela.
BaseLinker pobiera zamówienie z marketplace, dopasowuje pozycje po SKU lub EAN, obniża stan i w kolejnym cyklu synchronizacji zapisuje nowy stan w Shoperze. Zmiana statusu i numeru przewozowego wraca tą samą drogą, żeby klient sklepu i kupujący na marketplace widzieli spójny stan realizacji.
Najczęściej dlatego, że wariant w Shoperze nie ma własnego, unikalnego SKU albo EAN jest przypisany do produktu nadrzędnego zamiast do rozmiaru. Bez unikalnego klucza na poziomie wariantu integracja nie wie, którą pozycję zaktualizować, i pomija rekord albo trafia w zły produkt.
Przy kilkudziesięciu tysiącach SKU tak. Dlatego aktualizacje puszczamy paczkami, tylko dla rekordów, które faktycznie się zmieniły, z kontrolą tempa i ponawianiem po błędzie. Pełny przelot katalogu robimy poza godzinami największego ruchu.
Sygnałem jest stan, który wraca do poprzedniej wartości bez działania człowieka albo zmienia się cyklicznie. Prawie zawsze oznacza to, że dwa systemy zapisują to samo pole. Rozwiązaniem jest jeden kierunek zapisu na pole i log, który pokazuje, kto ostatni je zmienił.

Wypisz kanały sprzedaży i powiedz, który z nich ma rządzić stanem

Na tej podstawie rozpiszemy, który system zapisuje stan, cenę i SKU, i pokażemy, gdzie obecna konfiguracja gubi stany oraz jak to naprawić.

przesyłasz

Kanały sprzedaży

sklep, Allegro, Amazon i inne marketplace’y

przesyłasz

Kto ma rządzić stanem

który z kanałów albo systemów

odpowiadamy

Podział pól

kto zapisuje stan, cenę i SKU i gdzie konfiguracja gubi stany