Parametry techniczne BaseLinker API
5 sposobów automatyzacji z BaseLinker API
Poniżej znajdziesz konkretne zastosowania BaseLinker API w projektach automatyzacji procesów B2B — z opisem logiki, endpointów i realnej oszczędności czasu.
Synchronizacja stanów magazynowych między hurtownią a marketplace'ami
Skrypt cykliczny odpytuje hurtownię (API dostawcy lub własny ERP) o aktualne stany i ceny, a następnie aktualizuje produkty w BaseLinkerze przez addInventoryProductsStock. BaseLinker automatycznie propaguje zmiany na Allegro, Amazon, WooCommerce — bez ręcznej edycji każdej platformy.
addInventoryProductsStocksetInventoryProductsStockAutomatyczne tworzenie dokumentów WZ i faktur po nowym zamówieniu
Webhook BaseLinker powiadamia Make o każdym nowym zamówieniu. Make tworzy dokument WZ w systemie ERP (Subiekt lub Xentral), wystawia fakturę w Fakturowni i aktualizuje status zamówienia w BaseLinkerze — cały łańcuch w jednym przepływie.
getOrderssetOrderStatusaddOrderMonitoring zamówień z opóźnioną realizacją
Codziennie rano automatyzacja pobiera zamówienia starsze niż 48h ze statusem "przyjęte" i wysyła alert do menedżera magazynu na Slacku. Eliminuje "zapomniane zamówienia" i reklamacje klientów za niedostarczony towar.
getOrdersgetOrderStatusListAutomatyczna wycena przesyłek i wybór kuriera
Po przyjęciu zamówienia automatyzacja pobiera wagę i wymiary z BaseLinker Inventory, wysyła zapytanie do API kurierów (InPost, DPD, UPS), wybiera najtańszą opcję spełniającą kryterium czasu dostawy i tworzy etykietę przez createPackage.
createPackagegetRequestParcelPickupgetCouriersListRaport sprzedaży wielokanałowej na potrzeby analiz
Miesięczny skrypt paginuje przez wszystkie zamówienia (getOrders z page i date_from), grupuje według źródła (Allegro, WooCommerce, sklep własny), sumuje przychody i eksportuje do Google Sheets lub BigQuery. Daje natychmiastowy wgląd w rentowność kanałów.
getOrdersgetOrderTransactionDetailsKluczowe endpointy BaseLinker API
Poniżej lista endpointów najczęściej używanych w automatyzacjach. Każdy endpoint jest częścią standardowego REST API i obsługuje autentykację przez API Token (nagłówek X-BLToken).
getOrders
Pobierz zamówienia z filtrami (status, data, źródło)
setOrderStatus
Zmień status zamówienia
addInventoryProductsStock
Zaktualizuj stany magazynowe produktów
createPackage
Utwórz przesyłkę kurierską
getInventoryProductsList
Lista produktów z katalogu
addOrderInvoice
Dodaj fakturę do zamówienia
Zanim wdrożysz integrację produkcyjnie, przetestuj endpointy w środowisku sandbox (jeśli dostępne) lub na dedykowanym koncie testowym. Dla BaseLinker API dokumentację techniczną znajdziesz na https://api.baselinker.com.
Przykładowy przepływ: Przepływ: Nowe zamówienie Allegro → WZ Subiekt → Faktura → Kurier
- BaseLinker webhook: nowe zamówienie (status "przyjęte")
- Make pobiera szczegóły zamówienia przez getOrders (z ID zdarzenia)
- Make tworzy dokument WZ w Subiekcie przez Insert API
- Jeśli zamówienie ma NIP — Make wystawia FV w Fakturowni, jeśli nie — paragon
- Make odpytuje API InPost/DPD/UPS o ceny — wybiera najtańszą opcję
- Make tworzy paczkę (createPackage) — BaseLinker zwraca etykietę PDF
- Make aktualizuje status zamówienia w BaseLinkerze na "realizacja"
- Klient dostaje e-mail z numerem śledzenia z BaseLinker Notifications API
Jak JustAutomate wdraża integracje BaseLinker
W projektach JustAutomate integracja BaseLinker API to jeden z najczęstszych elementów automatyzacji. Nasz proces zaczyna się od audytu API — sprawdzamy dostępne endpointy, rate limity, stabilność tokenów i formatów danych po stronie klienta.
W większości przypadków używamy Make lub n8n jako middleware — narzędzia, które łączą BaseLinker z innymi systemami bez pisania kodu. Dla złożonych przypadków (własna logika transformacji danych, integracja z legacy systemem, niestandardowe formaty) piszemy skrypty Node.js lub Python z pełną obsługą błędów i logowaniem.
Każda integracja, którą budujemy, ma monitoring — wiemy natychmiast, gdy API zwróci błąd 5xx lub przekroczymy rate limit. Klient nie dowiaduje się o awarii z opóźnieniem — system jest samo-naprawiający i alertuje nas zanim wpłynie to na procesy.
Jeśli chcesz zintegrować BaseLinker ze swoimi systemami, możemy omówić zakres i ROI w 30-minutowej rozmowie. Pierwsza konsultacja jest bezpłatna.
FAQ — najczęstsze pytania o BaseLinker API
Jak zbudowana jest BaseLinker API — REST czy inaczej?
BaseLinker API używa JSON-RPC przez HTTP POST — wszystkie zapytania idą na jeden endpoint (https://api.baselinker.com/connector.php), a metodę definiujesz w polu "method" ciała JSON. Token autoryzacji przekazujesz w nagłówku X-BLToken.
Czy BaseLinker ma webhooks?
Tak — w panelu BaseLinker możesz skonfigurować webhooki dla zdarzeń: nowe zamówienie, zmiana statusu zamówienia, nowy produkt. Webhook wysyła POST na Twój URL z danymi zdarzenia w formacie JSON.
Jak BaseLinker API obsługuje produkty wariantowe?
Produkty wariantowe w BaseLinker Inventory mają strukturę: produkt nadrzędny (product_id) + warianty (variant_id). Każdy wariant ma osobny stan magazynowy, EAN i ceny. Aktualizacja stanów wymaga podania obu ID.
Ile zamówień mogę pobrać jednym zapytaniem?
Metoda getOrders zwraca maksymalnie 100 zamówień na stronę. Przy większych wolumenach używaj paginacji przez parametr filter_date_from lub iteruj po stronach (page=1, page=2...). BaseLinker stosuje rate limit: ok. 5 req/sekundę.
Potrzebujesz integracji BaseLinker
w swoich procesach?
Budujemy integracje BaseLinker API z CRM, ERP, fakturowaniem i narzędziami AI. Bezpłatna konsultacja — 30 minut, konkretny plan z ROI.