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.
Jak to działa
Dział zatytułowany „Jak to działa”| 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ę |
Odpytywanie zmian
Dział zatytułowany „Odpytywanie zmian”Zmiany statusów
Dział zatytułowany „Zmiany statusów”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):
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"Zdarzenia i historia zmian
Dział zatytułowany „Zdarzenia i historia zmian”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.
- Zapamiętaj ID ostatniego przetworzonego zdarzenia (na start:
0lub ID z pierwszego odczytu). - Wywołaj
POST /api/v3/Orders/eventszgtId= zapamiętane ID iordering: "Asc". - Przetwórz zdarzenia po kolei — zwykle wystarczy zebrać unikalne
orderIdi pobrać te zamówienia masowo. - Zapisz ID ostatniego zdarzenia i powtórz. Gdy strona jest pusta — odczekaj interwał.
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 }'import os, time, requests
BASE = f"https://{os.environ['SR_INSTANCE']}-smerp-api.enterprise.sellrocket.pl"HEADERS = {"Authorization": f"Bearer {os.environ['SR_TOKEN']}"}
last_id = load_cursor() # Twoja funkcja, np. odczyt z bazywhile True: r = requests.post(f"{BASE}/api/v3/Orders/events", headers=HEADERS, json={"gtId": last_id, "ordering": "Asc", "limit": 100, "offset": 0}) if r.status_code == 429: time.sleep(60); continue r.raise_for_status() events = r.json()["list"] if not events: time.sleep(60); continue handle(events) # np. zbierz orderId i pobierz zamówienia przez byIds last_id = events[-1]["id"] save_cursor(last_id)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.
Automatyzacja „Wywołaj URL”
Dział zatytułowany „Automatyzacja „Wywołaj URL””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- W panelu Sellrocket utwórz automatyzację: wyzwalacz (np. zmiana statusu na „Do wysłania”), opcjonalnie warunki (np. kanał sprzedaży), akcja „Wywołaj URL”.
- Twój endpoint przyjmuje GET, sprawdza sekret i od razu odpowiada
200. Właściwą pracę wykonuj asynchronicznie. - 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.
Dziennik w stylu BaseLinkera
Dział zatytułowany „Dziennik w stylu BaseLinkera”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.
Na co uważać
Dział zatytułowany „Na co uważać”- 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
createdByw historii), żeby nie wpaść w pętlę synchronizacji. - Automatyzacje działają tylko dla zmian wykonanych bez trybu cichego — zmiany z nagłówkiem
X-SR-ForceSilentChangesaniskipAjsnie wywołają Twojego URL.
Odpowiedniki w BaseLinker
Dział zatytułowany „Odpowiedniki w BaseLinker”getJournalList→POST /api/v3/Orders/events(kursorgtId) lubgetJournalListw 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ą.

