Zmiany w API BaseLinkera w 2026 roku – co oznaczają dla sklepów i integracji
Changelog API Base (dawniej BaseLinker) to lektura dla programistów, ale skutki zmian odczuwa cały sklep: własne skrypty, integracje z ERP, WMS czy hurtownią. Przejrzałem wpisy z czerwca–października 2026 i wybrałem to, co realnie wpływa na pracę sprzedawcy, oraz to, co warto sprawdzić z programistą, zanim coś przestanie działać.

Dla kogo jest ten wpis
Jeśli korzystasz wyłącznie z panelu Base i gotowych integracji (Allegro, sklep, kurierzy), większość zmian w API przejdzie obok Ciebie – dostawcy integracji aktualizują je po swojej stronie. Ten wpis jest dla firm, które mają coś własnego: skrypt do cen, połączenie z ERP lub programem magazynowym, własny panel B2B, raporty w arkuszu albo integrację hurtowni pisaną na zamówienie. Wtedy changelog warto znać przynajmniej w skrócie, bo to on mówi, co może się zmienić w zachowaniu systemu.
Ważna zasada z samego changelogu: przy zmianie formatu, usunięciu parametru albo wycofaniu metody Base utrzymuje wsteczną kompatybilność przez sześć miesięcy od publikacji zmiany i zaleca dostosowanie systemów jak najszybciej. To nie jest więc alarm na jutro, ale też nie temat na „kiedyś”.
Krótkie omówienie zmian z września i października (Listing Agent, logi synchronizacji, TLS 1.2) jest już w nowościach z listopada. Tutaj patrzę szerzej – na całe półrocze – i grupuję zmiany według obszarów, z którymi mam do czynienia przy wdrożeniach.
Statusy zamówień i zwrotów zarządzane przez API
Na początku czerwca 2026 doszły metody do tworzenia, edycji i usuwania statusów zamówień oraz grup statusów (addOrderStatus, addOrderStatusGroup, deleteOrderStatus, deleteOrderStatusGroup), a także analogiczne metody dla statusów zwrotów. Listy statusów zwracają teraz informację o grupie i statusie głównym (pola group_id i is_primary). Pojawiły się też metody do statusów klientów w CRM.
Co to zmienia w praktyce? Firmy z kilkoma kontami albo z powtarzalną konfiguracją (np. agencje, sieci franczyzowe, hurtownie zakładające konta partnerom) mogą odtwarzać strukturę statusów skryptem zamiast klikać ją ręcznie. Druga strona medalu: skrypt z uprawnieniem do usuwania statusów to narzędzie, które łatwo użyć źle. Przy własnych integracjach zawsze proponuję osobny token z minimalnym zakresem i test na koncie testowym.
Magazyn i WMS – najwięcej nowych metod
Najdłuższa część changelogu dotyczy magazynu. W skrócie:
- Transfery międzymagazynowe (lipiec) – tworzenie transferu w wersji roboczej, dodawanie pozycji, zmiana statusu, pobieranie list i serii numeracji.
- Inwentaryzacje (sierpień) – zakładanie inwentaryzacji, dodawanie pozycji, zmiana statusu, odczyt list i pozycji.
- Struktura magazynu – regały i strefy (lipiec), mapy magazynu (czerwiec), typ lokalizacji oznaczony jako miejsce przyjęć (sierpień), adres magazynu (czerwiec).
- Zamówienia zakupowe – koszty dodatkowe i paczki przy tworzeniu (lipiec), plik PDF faktury kosztowej (czerwiec), data wystawienia faktury kosztowej (wrzesień), osoba przypisana (październik), usuwanie pozycji z wersji roboczej (październik).
- Edycja istniejących pozycji (20 października) – w dokumentach magazynowych, zamówieniach zakupowych (tylko w wersji roboczej), inwentaryzacjach i transferach można zaktualizować ilość lub cenę pozycji po jej identyfikatorze, zamiast usuwać i dodawać ją od nowa.
Dla sprzedawcy to sygnał, że Base coraz poważniej traktuje magazyn jako system, który może współpracować z zewnętrznymi narzędziami: skanerami, aplikacjami do przyjęć, raportami zakupowymi. Jeśli do tej pory dokumenty przyjęć albo zamówienia do dostawców prowadziłeś w osobnym arkuszu, bo „Base tego nie ma w API”, warto to sprawdzić jeszcze raz.
Uwaga na identyfikatory magazynów w zamówieniach
To zmiana, którą uważam za najważniejszą dla własnych integracji zamówień. W sierpniu i wrześniu 2026 Base doprecyzował, że pole warehouse_id przy produktach w zamówieniu oznacza wewnętrzny identyfikator magazynu (ten sam, który zwraca getInventoryWarehouses w polu internal_warehouse_id). Metody dodające zamówienie i produkt do zamówienia przyjmują dodatnie wartości tylko jako takie identyfikatory, a zmiana pola w produkcie zamówienia ma walidację i zwraca błąd, gdy edycji związanej ze stanem nie da się wykonać. Wartość 0 oznacza brak wskazanego magazynu (przy dodawaniu zamówienia – magazyn domyślny dla źródła zamówienia).
Jeśli Twoja integracja (np. ze sklepem B2B albo systemem ERP) wysyła do Base zamówienia z przypisanym magazynem, poproś programistę o sprawdzenie, skąd bierze ten numer. Zamówienia z błędnym magazynem to prosta droga do rozjechanych stanów – a tego tematu dotyczy osobny wpis o synchronizacji stanów.
Na kontach z jednym magazynem skutki tej zmiany mogą być niewidoczne albo minimalne – najpewniej sprawdzić to na zamówieniu testowym, zanim uznasz temat za zamknięty.
Produkty: relacje, wideo, media i dane per kanał
- Relacje między produktami (maj i sierpień) – produkty powiązane, zamienniki, upsell, downsell i cross-sell można zapisywać i odczytywać przez API.
- Wideo produktu (czerwiec) oraz osobne zdjęcia i wideo dla poszczególnych kanałów (lipiec) – z opcją, czy kanał korzysta z galerii domyślnej, osobnej, czy ją nadpisuje.
- Kategoria marketplace per kanał (czerwiec) i szablon wysyłki per kanał (sierpień) – przydatne, gdy produkty zakładasz z zewnętrznego PIM albo arkusza i chcesz od razu przygotować je pod konkretny marketplace.
- Progi stanów do zamówienia (wrzesień) – ustawianie punktów ponownego zamówienia dla magazynów katalogu.
- Oznaczenie mediów jako wygenerowanych przez AI (październik) – bez ponownego wgrywania pliku.
- Filtrowanie po tagu (wrzesień) i dłuższe pola w odczycie produktów z zewnętrznych magazynów: SKU i EAN do 50 znaków, nazwa do 255 (wrzesień, oznaczone jako ważne).
Ten ostatni punkt łatwo przeoczyć: jeśli Twoja baza albo arkusz po drugiej stronie integracji ma krótsze pola, długie SKU z hurtowni mogą zostać ucięte. Przy dropshippingu ucięte SKU oznacza zamówienie, którego hurtownia nie rozpozna.
Ceny i promocje
W czerwcu grupy cenowe dostały w API opcje wyliczania (m.in. grupa źródłowa, mnożnik i dodatek, osobne zasady dla zestawów), a we wrześniu doszły metody do promocji katalogowych (tworzenie, edycja i lista). Dla firm, które liczą ceny poza Base (arkusz, ERP, własny skrypt), to szansa, żeby część logiki przenieść do samego Base i mieć jedno źródło prawdy o cenach.
Changelog opisuje te zmiany od strony API. Czy i w jakim zakresie widać je w panelu na Twoim planie, sprawdź w swoim koncie Base.
Wysyłki i etykiety
- Wycena przesyłki przed nadaniem (getPricePackage, październik) – na tych samych parametrach co tworzenie przesyłki.
- Odpowiedź tworzenia przesyłki zwraca wszystkie przesyłki utworzone dla zamówienia (wrzesień).
- Szczegóły przesyłki z usługą, usługami dodatkowymi i typem opakowania (czerwiec), wymiary i waga mogą być liczbami z częścią dziesiętną (lipiec).
- Dokumenty celne (lipiec) i deklaracje towarów niebezpiecznych (październik).
- Uporządkowane pola kurierskie (28 października, oznaczone jako ważne) – odpowiedź ogranicza się do zatwierdzonych pól, bez HTML w nazwach i opisach, a kwoty pobrania, ubezpieczenia i wartości przesyłki wracają jako liczby.
Jeśli masz własny moduł nadawania paczek (np. w programie magazynowym), zmiana pól kurierskich to pierwsza rzecz do przetestowania. Kod, który „wyciągał” wartości z opisów albo etykiet opcji, może przestać działać. Więcej o samym nadawaniu w panelu piszę w poradniku o etykietach kurierskich.
Diagnostyka i bezpieczeństwo połączeń
Dwie rzeczy z tej kategorii: logi synchronizacji cen i stanów dla Allegro, eBay i Amazon z filtrem samych błędów (wrzesień) oraz nowy typ zdarzenia w dzienniku – zmiana statusu przesyłki (marzec). Od 1 października 2026 API wymaga też połączenia po TLS 1.2. Logi synchronizacji to moim zdaniem najprzydatniejsza nowość dla działu obsługi: zamiast zgadywać, czemu stan na Allegro się nie zmienił, można to sprawdzić w danych.
Co sprawdzić z programistą – checklista
- Lista wszystkich miejsc, które łączą się z API Base (skrypty, ERP, WMS, raporty, wtyczki) i kto za nie odpowiada.
- Połączenia po TLS 1.2 i autoryzacja tokenem w nagłówku.
- Skąd integracja bierze identyfikator magazynu przy zamówieniach i produktach w zamówieniu.
- Długość pól SKU, EAN i nazwy po drugiej stronie integracji.
- Kod nadawania przesyłek – zgodność z nowym formatem pól kurierskich.
- Czy coś, co dziś robicie w arkuszu (transfery, inwentaryzacje, zakupy), da się przenieść na nowe metody.
- Osobne tokeny z minimalnym zakresem dla każdego narzędzia i test na koncie testowym przed wdrożeniem zmian.
Jeśli nie wiesz, co w Twoim koncie korzysta z API, to dobry punkt startowy na audyt BaseLinker – inwentaryzacja integracji jest jednym z pierwszych kroków. Przy budowie nowych połączeń (ERP, hurtownia, B2B) pomagam w ramach wdrożenia BaseLinker. Możesz też po prostu umówić 15 min rozmowy telefonicznej w kalendarzu na stronie głównej.
Źródło: Changelog API Base (api.baselinker.com) – wpisy z 27.05–28.10.2026 oraz informacja o wstecznej kompatybilności. Opis własnymi słowami, nazwy metod jak w dokumentacji. Stan na listopad 2026.
Podsumowanie
Zmiany w API z 2026 roku idą w trzech kierunkach: więcej konfiguracji z zewnątrz (statusy, grupy cenowe, promocje), pełniejszy magazyn (transfery, inwentaryzacje, zakupy) i porządkowanie danych (identyfikatory magazynów, pola kurierskie, dłuższe SKU). Jeśli masz własne integracje, sprawdź przede wszystkim magazyny w zamówieniach i nadawanie przesyłek. Jeśli nie masz – wiesz przynajmniej, że coraz więcej rzeczy da się zautomatyzować bez obchodzenia systemu.
Najczęstsze pytania
Gdzie znajdę changelog API BaseLinkera?
Na stronie dokumentacji API: api.baselinker.com, w zakładce changelog. Wpisy są po angielsku, z datą i nazwą metody; ważniejsze zmiany oznaczone są jako IMPORTANT, wycofywane jako DEPRECATED.
Czy zmiany w API mogą zepsuć moją integrację?
Mogą, jeśli dotyczą formatu danych, z którego korzysta Twój kod. Base deklaruje, że przy zmianie formatu, usunięciu parametru lub wycofaniu metody utrzymuje wsteczną kompatybilność przez sześć miesięcy od publikacji zmiany, więc jest czas na dostosowanie.
Czy zwykły sklep bez programisty musi śledzić changelog API?
Zwykle nie. Gotowe integracje z panelu aktualizuje ich dostawca. Changelog jest ważny, gdy masz własne skrypty, połączenie z ERP, WMS albo integrację hurtowni robioną na zamówienie.
Co oznacza zmiana dotycząca warehouse_id w zamówieniach?
Base doprecyzował w sierpniu i wrześniu 2026, że identyfikator magazynu przy produktach w zamówieniu to wewnętrzny identyfikator z listy magazynów katalogu. Integracje, które wysyłały inne numery, mogą dostać błąd albo przypisać zamówienie do złego magazynu, dlatego warto to sprawdzić.
Czy przez API można już zarządzać statusami zamówień?
Tak. Od czerwca 2026 API ma metody do tworzenia, edycji i usuwania statusów zamówień i zwrotów oraz ich grup. Przydaje się to przy powtarzalnej konfiguracji wielu kont.
Przeczytaj też
Checklista wdrożenia BaseLinkera – 28 punktów przed startem
Lista kontrolna, którą przechodzę przy wdrożeniach. Odhacz punkty na swoim koncie, zanim uruchomisz sprzedaż albo dołożysz kolejny kanał.
- Konto, dostępy i bezpieczeństwo
- Katalog, magazyn i statusy zamówień
- Marketplace’y, sklep i hurtownie (dropshipping)
- Kurierzy, etykiety, faktury i KSeF
Potrzebujesz pomocy?
Jeśli chcesz, żebym przejrzał Twoją konfigurację albo wdrożył opisane rozwiązania, napisz na konsultacje@blexpert.pl albo umów 15 min rozmowy telefonicznej: +48 789 655 235 (pn–pt, 17:00–20:00). Stawka: 160 zł netto/h, przy stałej współpracy od 20 h miesięcznie 130 zł netto/h. Zobacz też: wdrożenie BaseLinker i audyt BaseLinker.



