Przejdź do treści

BaseLinker API w praktyce: gotowe połączenie czy własna integracja

Większość sklepów łączy się z BaseLinkerem gotową integracją i API nie dotyka. Po API sięga się wtedy, gdy gotowe połączenie nie przenosi potrzebnych pól, gdy dane mają płynąć z systemu, którego BaseLinker nie obsługuje, albo gdy kilka systemów korzysta z jednego konta.

Od czego zacząć: co chcesz zrobić?

  1. Ścieżka 1KonfiguracjaGotowe połączenie działa, ale nie tak, jak trzeba – sprawdź warunki i właścicieli danych. Pierwsze sprawdzenie: czy Twoja platforma ma gotową integrację z BaseLinkerem i czy przenosi wszystkie potrzebne pola.Sekcje 1–3
  2. Ścieżka 2NaprawaCoś działało i przestało – blokady tokenu i limit dzielony z ERP na przykładzie platformy B2B na Magento. Pierwsze sprawdzenie: czy z tego samego konta BaseLinkera korzysta też ERP, skrypty albo inne narzędzia.Sekcja 4
  3. Ścieżka 3Własny kodWysyłasz zamówienia przez API – jeden przepływ od addOrder po kontrolę duplikatu. Pierwsze sprawdzenie: czy integracja zapisuje numer zamówienia ze sklepu w polu dodatkowym.Sekcje 5–8

Ścieżka 1 z 3 Konfiguracja

Gotowe połączenie działa, ale nie tak, jak trzeba. Sekcje 1–3: kiedy wystarcza konfiguracja, kiedy naprawa albo rozszerzenie i kto jest właścicielem której danej.

Pięć pytań przed API

  1. Gotowa integracjaCzy Twoja platforma ma gotową integrację z BaseLinkerem i czy przenosi wszystkie potrzebne pola.
  2. Właściciel danychKtóry system jest właścicielem każdej danej: produktu, ceny, stanu, zamówienia, statusu.
  3. Wspólne kontoCzy z tego samego konta BaseLinkera korzysta też ERP, skrypty albo inne narzędzia.
  4. Konfiguracja czy brak funkcjiCzy problem jest w konfiguracji (mapowanie, statusy, magazyny), czy w braku funkcji.
  5. Sprawdzenie po wdrożeniuJak sprawdzisz po wdrożeniu, że zamówienie trafiło raz i z właściwymi pozycjami.

Trzy drogi połączenia z BaseLinkerem

moduł albo wtyczka

Gotowa integracja sklepu

Moduł albo wtyczka platformy – BaseLinker sam pobiera zamówienia i aktualizuje sklep.

platformy spoza listy

Plik integracyjny

Programista przygotowuje po stronie sklepu plik wymiany danych, który BaseLinker odpytuje.

Twój system pyta

BaseLinker API

Twój system sam wysyła zapytania do BaseLinkera: pobiera zamówienia, dodaje je, czyta i zmienia stany w katalogu.

Do tego hurtownie podłączane w samym BaseLinkerze. Wybór drogi zależy od tego, które dane i w którą stronę mają płynąć, a nie od tego, która brzmi bardziej zaawansowanie.
01

Kiedy wystarcza gotowe połączenie

Gotowa integracja zwykle wystarcza, gdy spełnione są wszystkie warunki:

  • platforma sklepu jest na liście integracji BaseLinkera, a jej moduł obsługuje Twoją wersję sklepu,
  • zamówienia mają trafiać do BaseLinkera w standardowej postaci: pozycje, klient, dostawa, płatność, status,
  • jest jedno źródło stanów i cen (BaseLinker albo sklep), a kierunek ich wymiany da się ustawić w panelu,
  • produkty łączą się po SKU albo EAN, które są takie same w obu systemach,
  • nie potrzebujesz pól, których moduł nie przenosi, na przykład magazynu przypisanego do pozycji zamówienia albo ceny ustalonej dla konkretnego klienta B2B.

Jeśli coś nie działa, a te warunki są spełnione, problem leży zwykle w konfiguracji: mapowaniu statusów, magazynów, źródeł zamówień albo powiązaniu produktów z katalogiem. Wtedy API niczego nie przyspieszy – najpierw trzeba poprawić ustawienia.

02

Trzy scenariusze integracji

Kiedy wystarcza konfiguracja, kiedy naprawa, a kiedy własne rozszerzenie przez API BaseLinkera
SytuacjaZwykle wystarczaSygnał, że to za mało
Stany w sklepie nie zgadzają się z BaseLinkeremkonfiguracja: właściwy magazyn, kierunek aktualizacji, powiązanie produktówstany zasila kilka systemów albo potrzebne są osobne stany (własny, u dostawcy)
Zamówienie nie trafia do BaseLinkera albo trafia niepełnenaprawa: statusy pobierane przez integrację, filtry źródeł, dostęp do sklepumoduł nie przenosi potrzebnych pól albo nie ponawia wysyłki po błędzie
Produkty z hurtowni mają trafić do własnego sklepugotowa aplikacja hurtowni dla platformy sklepu albo import plikuwedług FAQ Base.com (odczyt 13.11.2026) hurtownia podłączona w Base nie wystawia produktów na własny sklep – zostaje własne połączenie przez API
Sklep na platformie spoza listy integracjiplik integracyjny po stronie sklepupotrzebna wymiana w obie strony z logiką, której plik nie obejmie
ERP i sklep korzystają z jednego konta BaseLinkerauzgodnienie harmonogramów wysyłekblokady tokenu w godzinach pracy, przerwane synchronizacje, zamówienia bez odpowiednika

Własne rozszerzenie nie zastępuje gotowej integracji w całości. Najczęściej dokłada jedną brakującą rzecz: osobny tor importu produktów, eksport zamówień z dodatkowymi polami, ponawianie wysyłki po błędzie albo kontrolę zgodności stanów.

03

Jak ustalić źródła danych i kierunki wymiany

Zanim powstanie choć jedno zapytanie do API, każda dana musi mieć jednego właściciela – system, którego wartość wygrywa, gdy dwa systemy mają inną. Dla każdej pozycji z listy zapisz właściciela, kierunek i częstotliwość:

Kartoteka produktu

SKU, EAN, warianty, nazwy, zdjęcia: skąd przychodzą nowe produkty i czy aktualizacja ma nadpisywać treści w sklepie.

Ceny

Jedna cena czy cenniki grup i klientów; gdzie się je zmienia.

Stany

Kto liczy stan fizyczny, kto rezerwacje, czy jest stan u dostawcy i towar w drodze.

Zamówienia

Skąd, dokąd, w jakim momencie i z którym magazynem na pozycji.

Statusy i dokumenty

Czy mają wracać do sklepu i kto je zmienia.

Pełną zasadę i przykładową matrycę opisuje poradnik o źródle prawdy między sklepem, ERP i BaseLinkerem. Z perspektywy API ważne jest jedno: gdy właściciel danej jest niejasny, dwie integracje będą ją nadpisywać na zmianę, a błąd wyjdzie dopiero w zamówieniu.

Ścieżka 2 z 3 Naprawa

Coś działało i przestało. Sekcja 4 pokazuje działające wdrożenie i to, co w nim psuło się naprawdę: wspólne konto i limit zapytań. Pokrewne przypadki: ERROR_BLOCKED_TOKEN i limit API, zamówienie, które nie zdejmuje stanu.

04

Przykład wdrożenia: Magento ↔ BaseLinker w platformie B2B

Platforma B2B Sportina na Magento 2.4.8 (case study) wymienia dane wyłącznie z BaseLinkerem. Integracja po stronie Magento to nasze własne moduły, przygotowane razem z resztą platformy: cenami indywidualnymi dla klientów, preorderami i osobnymi stanami.

Przepływ danych w platformie B2B Sportina

produkty, ceny i stany, zamówienia, preordery, stany z ERP klienta – kierunek i decyzja we wdrożeniu
Przepływ danych w platformie B2B Sportina między Magento a BaseLinkerem
DaneKierunekDecyzja we wdrożeniu
Produkty: SKU, EAN, warianty, nazwy, zdjęciaBaseLinker → Magentoimport nowych produktów oddzielony od aktualizacji cen i stanów, z przebiegiem próbnym i raportem
Ceny i stanyBaseLinker → Magentostan własny i stan dostawcy jako osobne dane, z terminami dostępności
Zamówienia bieżące partnerówMagento → BaseLinkerponowienie wysyłki nie tworzy drugiego zamówienia
Preordery na kolekcjęzostają w Magentoobsługa w panelu i zestawienie CSV/PDF dla planowania
Stany z ERP klientaERP → BaseLinker (po stronie klienta)poza naszą integracją; ten sam limit API konta dzielą ERP i platforma

Jedno konto BaseLinkera, dwa systemy, jeden limit zapytań

  1. po stronie klientaERP klientazasila BaseLinkera stanami przez to samo API; poza naszą integracją
  2. wspólny limitKonto BaseLinkeraw godzinach wysyłek ERP limit zapytań był już zużyty
  3. nasze modułyMagento 2.4.8 B2Bprodukty, ceny i stany z BaseLinkera; zamówienia partnerów do BaseLinkera

Najważniejsza lekcja z tego wdrożenia nie dotyczyła samego API, tylko wspólnego konta: ERP klienta zasila BaseLinkera przez to samo API, więc w godzinach jego wysyłek limit zapytań był już zużyty. Rozpoznanie i zmiany po stronie sklepu opisuje osobny poradnik o ERROR_BLOCKED_TOKEN i limicie API.

Ścieżka 3 z 3 Własny kod

Twój system sam wysyła zamówienia do BaseLinkera. Sekcje 5–8: co udostępnia API, przepływ jednego zamówienia razem z obsługą błędów i testy duplikatów.

Przepływ jednego zamówienia przez API BaseLinkera

  1. kolejkaZleceniezamówienie w kolejce eksportu; jedno zadanie na zamówienie
  2. wysyłkaaddOrderz numerem ze sklepu w polu dodatkowym
  3. kontrolagetOrdersźródło, powiązanie z katalogiem, magazyn
  4. wynikKontrola duplikatudokładnie jedno zamówienie z tym numerem
Na podstawie sekcji 6–8; nazwy pól według dokumentacji api.baselinker.com (odczyt 13.11.2026).
Wynik poprawny
  • SUCCESS i order_id zapisany przy zamówieniu
  • getOrders zwraca jedno zamówienie z numerem ze sklepu, pozycje mają product_id i właściwy magazyn
Wyjątek
  • brak odpowiedzi albo przekroczony czas: nie wiadomo, czy zamówienie powstało
  • bez automatycznego ponowienia – wyszukanie procedurą z sekcji 7
05

Co ogólnie da się zrobić przez API BaseLinkera

To nie jest kopia dokumentacji – pełna lista metod jest na api.baselinker.com. Do oceny, czy Twój przypadek da się zbudować, wystarczy wiedzieć, jak API działa i jakie grupy operacji udostępnia (odczyt dokumentacji 13.11.2026):

  • Jedno wejście. Wszystkie zapytania idą metodą POST na jeden adres (connector.php) z nazwą metody i parametrami w JSON. Token przekazuje się w nagłówku X-BLToken. Token jest przypisany do konta użytkownika.
  • Limit. Dokumentacja podaje 100 zapytań na minutę. Dla integracji oznacza to planowanie: pełna synchronizacja dużego katalogu i bieżący eksport zamówień muszą zmieścić się w tym samym limicie co inne systemy na koncie.
  • Zamówienia. Pobieranie (getOrders, z filtrami m.in. po źródle zamówienia, dacie i numerze zamówienia w sklepie; do 100 zamówień w jednym wywołaniu, domyślnie bez zamówień niepotwierdzonych), dodawanie (addOrder), dziennik zdarzeń (getJournalList), zmiana statusu i pól.
  • Katalog. Odczyt danych produktów i stanów, aktualizacja stanów (updateInventoryProductsStock), dodawanie produktów.
  • Magazyny zewnętrzne. Odczyt produktów, cen i stanów ze sklepów i hurtowni podłączonych do konta oraz aktualizacja stanów w nich.
connector.php · jedno wejścieschemat zapytania
POST https://api.baselinker.com/connector.phpjeden adres dla wszystkich metodX-BLToken: …token przypisany do konta użytkownikamethod=addOrdernazwa metodyparameters={ … }parametry w JSON→ 100 zapytań na minutęlimit wspólny dla wszystkich systemów na koncie
06

Przepływ jednego zamówienia przez API: wysyłka i kontrola wyniku

Przykład dotyczy sytuacji, w której sklep sam wysyła zamówienia do BaseLinkera metodą addOrder – tak działa własny eksport, gdy gotowe połączenie nie wystarcza. Każde zamówienie przechodzi te same kroki, a sklep przy każdym zapisuje, na jakim jest etapie:

Każde zamówienie przechodzi te same kroki

  1. Zamówienie trafia do kolejki eksportuGdy osiągnie ustalony status (na przykład przyjęte do realizacji), sklep oznacza je jako „do wysłania”. Kolejka pozwala po przerwie wznowić pracę bez zgadywania, co już wyszło.
  2. Jedno zadanie na zamówienieZadanie, które bierze zamówienie do wysyłki, najpierw oznacza je jako „w trakcie wysyłki”, a każde inne zadanie (kolejny przebieg harmonogramu, ręczne ponowienie) takie zamówienie pomija. Samo sprawdzenie, czy brakuje numeru z BaseLinkera, nie chroni przed równoległą wysyłką: dwa zadania uruchomione w tym samym czasie oba zobaczą brak numeru i oba wyślą zamówienie.
  3. Sprawdzenie przed wysyłkąJeśli przy zamówieniu jest zapisany order_id z BaseLinkera, nie wysyła się go ponownie. Jeśli zamówienie zostało w stanie „w trakcie wysyłki” po przerwanym zadaniu, wynik poprzedniej próby jest nieznany – to przypadek utraty odpowiedzi z sekcji 7, nie zwykła wysyłka.
  4. WysyłkaZapytanie addOrder zawiera dane klienta, dostawy i płatności, datę zamówienia (date_add) oraz pozycje. Parametry wejściowe pozycji wskazują produkt (storage – dla katalogu BaseLinkera db, storage_id – dla katalogu BaseLinkera 0, product_id, variant_id) i magazyn (warehouse_id – identyfikator magazynu katalogu, 0 oznacza domyślny magazyn dla źródła zamówień).

    Źródło zamówienia wskazuje custom_source_id – własne źródło utworzone w panelu, najlepiej osobne dla tej integracji. Numer zamówienia ze sklepu integracja zapisuje w polu dodatkowym (extra_field_1 albo własne pole dodatkowe); musi być jednoznaczny w obrębie tej integracji, więc gdy przez to samo źródło wysyła kilka sklepów, numer dostaje oznaczenie sklepu.
  5. Odczyt odpowiedziSukces to status o wartości SUCCESS i order_id – numer zamówienia w BaseLinkerze. Sklep zapisuje go przy zamówieniu i oznacza eksport jako wykonany. Każda inna odpowiedź albo jej brak to przypadek z sekcji 7.
  6. Kontrola wynikugetOrders z parametrem order_id zwraca utworzone zamówienie. Wartości w odpowiedzi nie są kopią parametrów z wysyłki: źródło widać jako order_source (własne źródła mają typ personal) i order_source_id, a przy pozycjach – identyfikator magazynu źródłowego (storage_id) i magazyn (warehouse_id) faktycznie przypisane do zamówienia. Porównaj je z zamówieniem w sklepie według tabeli niżej – przy wdrożeniu dla każdego zamówienia testowego, później wyrywkowo i przy każdym zgłoszeniu z magazynu.

Co sprawdzić w zamówieniu utworzonym przez addOrder

pole z numerem, źródło, product_id, storage, warehouse_id, ilości i ceny, liczba zamówień z numerem
Co sprawdzić w zamówieniu utworzonym przez addOrder (wartości zwracane przez getOrders)
Co sprawdzić w getOrdersOczekiwany wynikCo oznacza odchylenie
pole dodatkowe z numerem zamówienia ze sklepu (extra_field_1; własne pole widać tylko z include_custom_extra_fields)ten sam numer co w sklepieintegracja nie zapisała numeru – po utracie odpowiedzi nie da się odnaleźć zamówienia
order_source i order_source_idpersonal i identyfikator źródła tej integracjizamówienie trafiło do innego źródła – wyszukiwanie po źródle go nie znajdzie
product_id każdej pozycjiwypełnionepozycja nie jest powiązana z katalogiem – zamówienie nie zdejmie stanu
storage i storage_id pozycjidb i identyfikator katalogu, który prowadzi stany (w addOrder dla katalogu BaseLinkera podaje się 0)pozycja powiązana z innym źródłem niż to, z którego liczony jest stan
warehouse_id pozycjimagazyn ustalony dla tego źródła zamówień, także gdy w addOrder podano 0stan schodzi z niewłaściwego magazynu
ilości i ceny pozycji, koszt dostawyzgodne z zamówieniem w sklepiebłąd mapowania pozycji, podatku albo zaokrągleń
liczba zamówień z tym numerem ze sklepujednoduplikat – testy z sekcji 8
07

Co zrobić przy błędzie: odmowa, błąd danych, brak odpowiedzi

Przy błędzie API zwraca status o wartości ERROR oraz error_code i error_message. Integracja, która patrzy tylko na kod HTTP albo na to, czy zapytanie „przeszło”, nie zauważy odmowy. O tym, co zrobić, decyduje rodzaj błędu:

Postępowanie przy każdym rodzaju błędu

limit lub blokada tokenu, błąd danych, brak odpowiedzi, SUCCESS bez zapisu, duplikat, pozycja bez powiązania
Postępowanie przy błędach wysyłki zamówienia do BaseLinkera
SytuacjaCo wiadomoCo zrobić
ERROR z powodu limitu albo blokady tokenu (na przykład ERROR_BLOCKED_TOKEN)zamówienie nie zostało dodane; przyczyną jest obciążenie konta, nie danezwolnij oznaczenie „w trakcie wysyłki”, zostaw zamówienie w kolejce i wyślij w kolejnym przebiegu; jeśli odmowy wracają o tych samych godzinach, ustal, kto jeszcze korzysta z konta
ERROR z błędem danych (nieznany status, produkt albo magazyn, brak wymaganego pola)ponowienie da ten sam wynikprzenieś zamówienie do wyjątków z error_code i error_message, popraw dane albo mapowanie i dopiero wtedy wyślij ponownie
brak odpowiedzi, przekroczony czas, błąd sieci albo zadanie przerwane w stanie „w trakcie wysyłki”nie wiadomo, czy zamówienie powstałowstrzymaj automatyczne ponowienie tego zamówienia i wyszukaj je procedurą poniżej. Jedno trafienie – zapisz jego order_id. Brak trafienia po pełnym sprawdzeniu – ponowienie jest dopuszczalne. Sprawdzenie niepełne – zamówienie czeka na wyjaśnienie
SUCCESS, ale sklep nie zapisał order_id (proces przerwany po odpowiedzi)zamówienie jest w BaseLinkerze, sklep o tym nie wiedla sklepu to ten sam przypadek co brak odpowiedzi: bez automatycznego ponowienia, wyszukanie procedurą poniżej i dopisanie order_id
wyszukiwanie zwraca więcej niż jedno zamówienie z tym numeremduplikat już powstałwstrzymaj eksport tego zamówienia, wyjaśnij stan w panelu BaseLinkera i usuń nadmiarowe zamówienie zgodnie z procesem magazynu; sprawdź, czy nie działały dwa zadania naraz
SUCCESS, ale kontrola wyniku pokazuje pozycję bez powiązania z katalogiemzamówienie istnieje, ale nie zdejmie stanunie wysyłaj go ponownie; popraw powiązanie produktu (SKU, katalog, magazyn) i skoryguj pozycję w panelu BaseLinkera

Jak wyszukać zamówienie po utracie odpowiedzi

Pojedynczy pusty wynik getOrders nie dowodzi, że zamówienie nie powstało. Wynik jest wiarygodny dopiero wtedy, gdy zapytanie obejmuje właściwe źródło, właściwy zakres dat, zamówienia niepotwierdzone i pole z numerem, a odpowiedzi zostały pobrane w całości (według dokumentacji api.baselinker.com, odczyt 13.11.2026):

Procedura wyszukiwania po utracie odpowiedzi

  1. Źródłofilter_order_source = personal i filter_order_source_id = identyfikator własnego źródła integracji (lista w getOrderSources). Bez osobnego źródła wynik obejmuje zamówienia z innych kanałów, a numer ze sklepu przestaje być jednoznaczny.
  2. Data zamówienia, nie czas próbydate_from filtruje po dacie zamówienia, czyli po wartości, którą integracja przekazała w date_add – zwykle po dacie złożenia zamówienia w sklepie. Zamówienie złożone wieczorem i eksportowane rano nie pojawi się w wyszukiwaniu ustawionym od godziny próby, więc zakres zaczyna się od daty zamówienia w sklepie, z zapasem na różnicę stref czasowych.
  3. Zamówienia niepotwierdzoneget_unconfirmed_orders = true. Domyślnie getOrders zwraca tylko zamówienia potwierdzone.
  4. Pole z numeremextra_field_1 jest zwracane zawsze. Jeśli integracja zapisuje numer we własnym polu dodatkowym, potrzebne jest include_custom_extra_fields = true – bez tego pole nie przyjdzie w odpowiedzi i zamówienia nie da się rozpoznać.
  5. KompletnośćJedno wywołanie zwraca najwyżej 100 zamówień. Przy 100 wynikach pobiera się kolejne paczki, aż przyjdzie paczka mniejsza niż 100. Dokumentacja opisuje stronicowanie po date_confirmed ostatniego zamówienia (plus 1 sekunda); zamówienia niepotwierdzone nie mają daty potwierdzenia, więc przy nich kolejne paczki trzeba wyznaczać inaczej, na przykład po numerze zamówienia (id_from).
  6. Decyzja„Nie znaleziono” znaczy, że zamówienia nie ma, tylko wtedy, gdy wszystkie paczki zostały pobrane bez błędu i porównane z numerem ze sklepu. W każdej innej sytuacji – błąd albo odmowa przez limit w trakcie wyszukiwania, wątpliwość co do źródła, zakresu dat albo pola – automatyczne ponowienie zostaje zatrzymane, zamówienie dostaje stan „do wyjaśnienia”, a osoba odpowiedzialna sprawdza je w panelu BaseLinkera przed ręczną decyzją.

Żeby każdą z tych sytuacji dało się rozpoznać po fakcie, potrzebne są trzy rzeczy

Log każdego wywołania

Czas, metoda, numer zamówienia ze sklepu, status, error_code, error_message i otrzymany order_id, a przy wyszukiwaniu także użyte filtry i liczba pobranych paczek. Z tego logu policzysz też własny udział w limicie.

Własny stan zadania przy zamówieniu

Do wysłania, w trakcie wysyłki, wysłane, wyjątek, do wyjaśnienia. Status z harmonogramu systemu, na przykład crona, nie mówi, czy synchronizacja doszła do końca.

Plan zapytań uzgodniony z innymi systemami na koncie

Z perspektywy sklepu widać tylko własne zapytania – resztę trzeba ustalić z osobą, która zarządza ERP i skryptami.

Jak wyglądało to w praktyce – rozkład błędów na godziny, harmonogram i okno ciszy – opisuje poradnik o limicie API BaseLinkera dzielonym z ERP.

08

Jak sprawdzić, że eksport zamówienia nie tworzy duplikatów

Duplikat może powstać w dwóch różnych sytuacjach i każda wymaga osobnego testu – pierwszy nie potwierdza drugiego. Oba poniżej to zalecane testy przed uruchomieniem eksportu i po każdej zmianie w integracji. Wykonuj je wyłącznie w kontrolowanym środowisku testowym (kopia sklepu albo sklep testowy i osobne źródło zamówień w BaseLinkerze), na zamówieniach wyraźnie oznaczonych jako testowe.

Test A: ponowienie po sukcesie i zapisaniu order_id

  1. Złóż zamówienie testoweI uruchom eksport. Sklep powinien zapisać przy nim order_id z BaseLinkera.
  2. Uruchom eksport drugi razDla tego samego zamówienia. Integracja nie powinna wysłać addOrder – w logu nie ma drugiej wysyłki.
  3. Policz zamówienia w BaseLinkerzeZ numerem testowym w polu dodatkowym. Ma być dokładnie jedno.
  4. Sprawdź pozycjeWedług tabeli z sekcji 6. Pozycja bez powiązania z katalogiem nie zdejmie stanu – przyczyny opisuje poradnik o zamówieniu, które nie zdejmuje stanu.
  5. Uruchom jednocześnie dwa zadania eksportuDla nowego zamówienia testowego. Wysłać może tylko jedno.
  6. Anuluj zamówienia testoweI sprawdź, czy stan wrócił zgodnie z ustawieniami.

Ten test potwierdza tylko, że integracja nie wysyła drugi raz zamówienia, o którym wie. Nie mówi nic o sytuacji, w której zamówienie powstało, a sklep nie dostał odpowiedzi.

Test B: utrata odpowiedzi po utworzeniu zamówienia

  1. Doprowadź do utraty odpowiedziW środowisku testowym: zamówienie powstaje w BaseLinkerze, ale sklep nie zapisuje order_id (na przykład zadanie zostaje przerwane po wysłaniu addOrder, a przed zapisem odpowiedzi).
  2. Uruchom ponowienieIntegracja powinna wstrzymać automatyczną wysyłkę i wyszukać zamówienie procedurą z sekcji 7, a nie wysłać go od nowa.
  3. Sprawdź wynikZamówienie odnalezione, order_id dopisany w sklepie, w BaseLinkerze dokładnie jedno zamówienie z tym numerem.
  4. Powtórz w trudniejszych wariantachZamówienie z datą wcześniejszą niż próba eksportu, ponad 100 zamówień w zakresie wyszukiwania, zamówienie niepotwierdzone, numer we własnym polu dodatkowym.
  5. Przerwij samo wyszukiwanie(na przykład odmową przez limit). Zamówienie ma zostać w stanie „do wyjaśnienia”, bez ponownej wysyłki.

Jeśli w którymkolwiek teście powstają dwa zamówienia, problem leży po stronie wysyłającego systemu, nie BaseLinkera.

09

BaseLinker API: kiedy zrobisz to sam, a kiedy nie

Jeśli chcesz, żebyśmy ocenili, czy w Twoim przypadku wystarczy konfiguracja, czy potrzebne jest rozszerzenie, zobacz integrację BaseLinkera albo warianty dla Magento, WooCommerce i Shopera. Dostępów do kont nie wysyłaj w formularzu – przekazujemy je osobnym kanałem po ustaleniu zakresu.

Sam
  • Sprawdzenie warunków z sekcji 1, matryca właścicieli danych.
  • Poprawki konfiguracji w panelu (statusy, magazyny, powiązania produktów).
  • Kontrola wyniku z sekcji 6, testy z sekcji 8 w środowisku testowym i rozmowa z osobą od ERP o godzinach wysyłek.
Z kimś, kto to robił
  • Własne rozszerzenie: osobny tor importu produktów, eksport zamówień z dodatkowymi polami i ochroną przed duplikatem.
  • Jedno zadanie na zamówienie, obsługa każdego rodzaju błędu i wyszukiwanie po utracie odpowiedzi z sekcji 7.
  • Własny stan zadań i plan zapytań wspólny z innymi systemami na koncie.

FAQ: BaseLinker API w praktyce

Zwykle nie. Jeśli platforma sklepu ma gotową integrację, która przenosi potrzebne pola, wystarczy jej konfiguracja: statusy, magazyny i powiązanie produktów. API przydaje się, gdy brakuje pól, platformy nie ma na liście albo dane mają płynąć z systemu, którego BaseLinker nie obsługuje.
Dokumentacja podaje 100 zapytań na minutę, a token jest przypisany do konta użytkownika. Jeśli z jednego konta korzysta sklep, ERP i skrypty, limit trzeba planować wspólnie, bo w godzinach wysyłek z ERP sklep może dostawać odmowy.
Według dokumentacji addOrder dodaje nowe zamówienie i nie opisuje sprawdzania duplikatów. Ochronę buduje system, który wysyła zamówienia: jedno zadanie eksportu na zamówienie naraz, zapis zwróconego order_id, a po utracie odpowiedzi pełne wyszukanie zamówienia w getOrders – po źródle integracji, od daty zamówienia, razem z niepotwierdzonymi i we wszystkich paczkach po 100 – według numeru ze sklepu, który integracja zapisała w polu dodatkowym. Gdy wyszukiwanie jest niepełne, zamówienie czeka na wyjaśnienie zamiast ponownej wysyłki.
Według FAQ Base.com (odczyt 13.11.2026) hurtownia podłączona w Base nie wystawia produktów na własny sklep, tylko na marketplace’y z integracją dwukierunkową. Dla własnego sklepu zostaje gotowa aplikacja hurtowni dla platformy, import pliku albo własne połączenie przez API.
Potrzebne są dwa osobne testy w środowisku testowym. Pierwszy: zamówienie wysłane z sukcesem i z zapisanym order_id eksportujesz drugi raz – integracja nie może go wysłać ponownie. Drugi: zamówienie powstaje w BaseLinkerze, ale sklep nie zapisuje odpowiedzi – integracja ma je odnaleźć i dopisać order_id, a nie wysłać od nowa. W obu przypadkach w BaseLinkerze ma być jedno zamówienie z tym numerem ze sklepu. Pierwszy test nie potwierdza drugiego.

Gotowe połączenie z BaseLinkerem nie wystarcza? Dopiszemy brakującą część

Ustalamy, co załatwi konfiguracja, a co wymaga własnego rozszerzenia przez API, i budujemy je z kontrolą wyniku: każde zamówienie trafia do BaseLinkera raz, a błąd wraca do kolejki zamiast zginąć. Zespół przestaje przepisywać zamówienia i stany ręcznie.

Podobna realizacjaOk. 115 tys. produktów i wariantów z BaseLinkera, 31 modułówSportina B2B · Magento