Przejdź do głównej zawartości

Reagowanie na zmiany

Sellrocket nie udostępnia subskrypcji webhooków zarządzanych przez API. Masz za to trzy mechanizmy, które razem dają ten sam efekt: odpytywanie zmian (polling) po dacie lub kursorze, automatyzację, która wywołuje Twój adres URL w chwili zdarzenia, oraz dziennik zdarzeń zgodny z getJournalList z BaseLinkera.

Mechanizm Opóźnienie Kiedy używać
Odpytywanie listy, historii statusów lub zdarzeń Interwał odpytywania (np. 1–5 min) Zawsze — jako główne lub zapasowe źródło zmian
Automatyzacja z akcją „Wywołaj URL” Prawie natychmiast Gdy musisz zareagować szybko (np. przekazać zamówienie do WMS po opłaceniu)
Beel getJournalList Interwał odpytywania Gdy przenosisz integrację z BaseLinkera i chcesz zachować jej logikę

Najprostszy wariant to lista zamówień z filtrem StatusUpdatedFrom — opisana krok po kroku w Pobieraniu zamówień. Jeśli potrzebujesz samych przejść między statusami (skąd → dokąd, kto zmienił), użyj GET /api/v5/Orders/statusHistory z parametrem gt (zmiany późniejsze niż podana chwila):

Okno terminala
curl "https://$SR_INSTANCE-smerp-api.enterprise.sellrocket.pl/api/v5/Orders/statusHistory?gt=2026-10-05T08:00:00Z&limit=100&offset=0" \
-H "Authorization: Bearer $SR_TOKEN"

Zmiany, które nie dotyczą statusu (płatność, przesyłka, edycja danych), znajdziesz w zdarzeniach i historii zamówień:

Endpoint Co zwraca
POST /api/v3/Orders/events Zdarzenia wielu zamówień — filtry gtId, dateFrom, eventTypes, orderId, sortowanie ordering (Asc/Desc)
GET /api/v3/Orders/{orderId}/events Zdarzenia jednego zamówienia
POST /api/v3/Orders/history Historia zmian wielu zamówień (różnice w danych) — filtry gtId, dateFrom, path, createdBy
POST /api/v3/Orders/history/byIds Historia zmian wskazanych zamówień, opcjonalnie tylko wybranych pól (paths)
GET /api/v3/Orders/{orderId}/history Historia zmian jednego zamówienia
GET /api/v3/Orders/{orderId}/history/flatten Ta sama historia jako płaska lista: pole, poprzednia i nowa wartość

Do ciągłego śledzenia używaj kursora po ID (gtId — wpisy o ID większym niż podane) zamiast daty — nie zgubisz wpisów o tej samej sekundzie i nie przetworzysz ich dwa razy.

  1. Zapamiętaj ID ostatniego przetworzonego zdarzenia (na start: 0 lub ID z pierwszego odczytu).
  2. Wywołaj POST /api/v3/Orders/events z gtId = zapamiętane ID i ordering: "Asc".
  3. Przetwórz zdarzenia po kolei — zwykle wystarczy zebrać unikalne orderId i pobrać te zamówienia masowo.
  4. Zapisz ID ostatniego zdarzenia i powtórz. Gdy strona jest pusta — odczekaj interwał.
Okno terminala
curl -X POST "https://$SR_INSTANCE-smerp-api.enterprise.sellrocket.pl/api/v3/Orders/events" \
-H "Authorization: Bearer $SR_TOKEN" \
-H "Content-Type: application/json" \
-d '{ "gtId": 1830021, "ordering": "Asc", "limit": 100, "offset": 0 }'

Każdy wpis ma id, createdAt i obiekt event ze szczegółami. Listę zdarzeń możesz zawęzić polem eventTypes — nazwy typów sprawdź w odpowiedziach ze swojej instancji.

Automatyzacje (skrypty automatyczne) reagują na zdarzenia w instancji — np. utworzenie zamówienia, zmianę statusu, opłacenie. Jedną z dostępnych akcji jest „Wywołaj URL”: Sellrocket wysyła żądanie HTTP GET na podany adres, w którym możesz użyć znaczników danych zamówienia, np. {{order.id}}.

https://integracja.example.com/sellrocket/hook?order={{order.id}}&key=TWOJ_SEKRET
  1. W panelu Sellrocket utwórz automatyzację: wyzwalacz (np. zmiana statusu na „Do wysłania”), opcjonalnie warunki (np. kanał sprzedaży), akcja „Wywołaj URL”.
  2. Twój endpoint przyjmuje GET, sprawdza sekret i od razu odpowiada 200. Właściwą pracę wykonuj asynchronicznie.
  3. Na podstawie ID pobierz aktualne dane zamówienia przez API (GET /api/v5/Orders/{orderId}).

Akcja ma opcję ponawiania przy błędzie. Historię uruchomień automatyzacji dla zamówienia sprawdzisz przez GET /api/v1/runs/history/{orderId} w serwisie Automatyzacje.

Jeśli Twoja integracja korzysta z getJournalList, możesz go dalej używać przez Beel API — zwraca zdarzenia w formacie BaseLinkera. Część typów zdarzeń nie jest obsługiwana — zobacz Różnice → getJournalList.

  • Nie odpytuj częściej, niż potrzebujesz — każde wywołanie liczy się do limitu zapytań. Jedno zapytanie o zdarzenia na minutę zwykle wystarcza, a pilne przypadki obsłuży „Wywołaj URL”.
  • Zapisuj kursor dopiero po przetworzeniu zdarzeń — po awarii przetworzysz je ponownie zamiast je zgubić.
  • Zmiany, które sam wprowadzasz, też trafią do historii i zdarzeń. Odfiltruj je (np. po createdBy w historii), żeby nie wpaść w pętlę synchronizacji.
  • Automatyzacje działają tylko dla zmian wykonanych bez trybu cichego — zmiany z nagłówkiem X-SR-ForceSilentChanges ani skipAjs nie wywołają Twojego URL.
  • getJournalList → POST /api/v3/Orders/events (kursor gtId) lub getJournalList w Beel API.
  • Akcja automatyczna wywołująca adres URL → akcja „Wywołaj URL” w automatyzacjach Sellrocket.
  • Brak subskrypcji webhooków — tak jak w BaseLinkerze, zmiany wykrywasz odpytywaniem lub akcją automatyczną.