Przejdź do głównej zawartości

Z BaseLinkera do Sellrocket

Jeśli znasz BaseLinkera, większość pojęć w Sellrocket będzie znajoma — często pod inną nazwą. Ta strona to ściąga: odpowiedniki obiektów i metod BaseLinkera w API natywnym Sellrocket. Jeśli chcesz przenieść integrację bez przepisywania — zmieniając tylko adres i token — użyj emulatora API BaseLinkera (Beel API); różnice obu API: Wprowadzenie → Dwa API.

BaseLinker Sellrocket Gdzie w API
Zamówienie Zamówienie (Order) OMS → Zamówienia
Status zamówienia Status — definiowany per instancja, zgrupowany w grupy statusów (drzewo) OMS → Statusy, Grupy statusów
Źródło zamówienia / konto integracji Połączenie (Connection) — konto w konkretnej integracji (sklep, marketplace, kurier) OMS → Połączenia
Typ integracji (np. „Allegro”, „InPost”) Definicja połączenia (ConnectionDefinition) OMS → Definicje połączeń
Ręczne zamówienie / inne źródła Połączenie typu „Pozostałe kanały sprzedaży” OMS → Połączenia
external_order_id / shop_order_id source.platformOrderId (w odpowiedziach też sourceOrderId) —
Pola dodatkowe zamówienia extra_field_1/2 additionalField1 / additionalField2 OMS → Zamówienia
Własne pola dodatkowe (custom_extra_fields) Pola elastyczne — dowolne pola dla zamówień, pozycji, zwrotów Pola elastyczne
Oznaczenie gwiazdką Oznaczenie (asteriskMarked) z rodzajem (kolor/ikona) OMS → Oznaczenia
Paczka / przesyłka Przesyłka (Shipment) Przesyłki
Konto kuriera Połączenie kurierskie OMS → Połączenia
Dziennik zdarzeń (getJournalList) Historia i zdarzenia zamówienia Reagowanie na zmiany
Zwroty Zwroty — osobny obiekt z własnymi statusami, powodami i przesyłkami Zwroty
Katalog (Inventory) Katalog w PIM PIM → Katalogi
Magazyn Magazyn w PIM PIM → Magazyny
Grupa cenowa Grupa cenowa w PIM PIM → Grupy cenowe
Produkt, wariant, zestaw Produkt w PIM: warianty (rodzic–dziecko), zestawy (stan liczony ze składników) Produkty
Cechy produktu (features) Cechy (properties) Produkty
Pola dodatkowe produktu (extra_field_<ID>) Pola złożone extra_field|… (complexFields) Pola dodatkowe produktów
Powiązania produktu z ofertami (links) Powiązania produktu (ProductLinks) PIM → Powiązania produktów
Akcje automatyczne Automatyzacje (skrypty automatyczne, AJS) Automatyzacje
Własne przyciski / makra Zdarzenia użytkownika (przyciski, skróty, kody kreskowe uruchamiające automatyzacje) OMS → Zdarzenia użytkownika
Wydruki i szablony e-mail Szablony + serwis Wydruki (tagi w stylu BaseLinkera, np. [numer_zamowienia]) Wydruki
Faktury Wystawiane przez automatyzacje (akcja fakturowa) — faktura trafia do zamówienia jako załącznik Faktury
Pick & Pack Kompletacja i pakowanie, stanowiska pakowania OMS → Stanowiska pakowania

REST zamiast jednego endpointu. API BaseLinkera to jeden adres i parametr method. Sellrocket ma klasyczne REST API: zasoby, metody HTTP, kody odpowiedzi. Jeśli chcesz zachować styl BaseLinkera — użyj Beel API. Które identyfikatory (statusy, źródła zamówień, konta kurierskie, pola dodatkowe) mogą zostać takie jak w BaseLinkerze, opisuje Identyfikatory z BaseLinkera.

Kilka serwisów. Zamówienia (OMS), produkty (PIM), pola elastyczne czy automatyzacje to osobne serwisy z osobnymi adresami — ale jeden token działa we wszystkich.

Zapis asynchroniczny. BaseLinker odpowiada od razu wynikiem. W Sellrocket wiele zmian zamówień zwraca zadanie, którego wynik sprawdzasz osobno — zobacz Operacje asynchroniczne.

Statusy bez sztywnego procesu. Tak jak w BaseLinkerze, statusy i przejścia definiuje sprzedawca — nie zakładaj stałych ID statusów, zawsze pobieraj ich listę z instancji.

Token per użytkownik, ważny czasowo. Zamiast jednego stałego tokenu konta — token JWT konkretnego użytkownika z datą ważności, który odnawiasz. Zobacz Uwierzytelnianie.

Metoda BaseLinker REST API Sellrocket
getOrders GET /api/v5/Orders
addOrder POST /api/v5/Orders — zobacz Dodawanie zamówień
setOrderFields PUT /api/v6/Orders/Patch/{orderId}
setOrderStatus, setOrderStatuses PUT /api/v4/Orders/OrdersStatusUpdate
getOrderStatusList GET /api/v3/Statuses
getOrderSources GET /api/v3/Connections
setOrderPayment OMS → Płatności
createPackage, getLabel Automatyzacja z akcją „Utwórz przesyłkę” + etykiety z OMS → Przesyłki zamówienia — zobacz Przesyłki
getInventoryProductsData GET /api/products/v4/products (PIM)
updateInventoryProductsStock PUT /api/products/v3/bulk/stocks (PIM)
updateInventoryProductsPrices PUT /api/products/v3/bulk/prices (PIM)
getInventoryWarehouses, getInventoryPriceGroups PIM → Magazyny, Grupy cenowe
getJournalList Historia zamówień — zobacz Reagowanie na zmiany

Pełna lista metod BaseLinkera obsługiwanych 1:1 przez Beel API: Beel API → Metody.