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.
Słownik pojęć
Dział zatytułowany „Słownik pojęć”| 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 |
Najważniejsze różnice
Dział zatytułowany „Najważniejsze różnice”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.
Odpowiedniki popularnych metod
Dział zatytułowany „Odpowiedniki popularnych metod”| 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.

