Statusy zamówień
Status opisuje, na jakim etapie obsługi jest zamówienie: nowe, do spakowania, wysłane, anulowane… Podobnie jak w BaseLinkerze, Sellrocket nie narzuca procesu — każdy sprzedawca definiuje własne statusy, a integracja musi je odczytać z instancji i zmieniać zgodnie z ustaloną z nim mapą.
Jak to działa
Dział zatytułowany „Jak to działa”- Status ma
id,name,shortName,description,coloriposition. Każde zamówienie ma dokładnie jeden status (status.id) wraz z datą jego ustawienia (status.from). - Statusy są zorganizowane w grupy (pole
groupId) — w panelu widać je jako drzewo, np. „Do realizacji” → „Do spakowania”, „Do wysłania”. Grupy konfiguruje sprzedawca w panelu. - Zmiana statusu jest zdarzeniem, na które reagują automatyzacje (np. wysłanie e-maila, utworzenie przesyłki, wystawienie faktury). Możesz to świadomie wyłączyć.
- Statusy zwrotów to osobny słownik — zobacz Zwroty.
Odczyt statusów
Dział zatytułowany „Odczyt statusów”| Endpoint | Zastosowanie |
|---|---|
GET /api/v3/Statuses/GetAll |
Wszystkie statusy bez stronicowania — najprostsze przy starcie integracji |
GET /api/v3/Statuses |
Lista stronicowana (limit, offset) |
GET /api/v3/Statuses/GetAllUserStatuses |
Statusy, do których ma dostęp bieżący użytkownik (token) |
GET /api/v1/Orders/OrdersInStatusesCount |
Liczba zamówień w poszczególnych statusach |
curl "https://$SR_INSTANCE-smerp-api.enterprise.sellrocket.pl/api/v3/Statuses/GetAll" \ -H "Authorization: Bearer $SR_TOKEN"[ { "id": 100001, "name": "Nowe", "shortName": "NEW", "color": "#2f80ed", "groupId": 1, "position": 0, "isFavorite": true }, { "id": 100007, "name": "Do spakowania", "shortName": "PACK", "color": "#f2994a", "groupId": 2, "position": 1, "isFavorite": false }, { "id": 100009, "name": "Wysłane", "shortName": "SENT", "color": "#27ae60", "groupId": 3, "position": 2, "isFavorite": false }]Statusy możesz też zakładać przez POST /api/v3/Statuses — także z własnym id. Przy migracji z BaseLinkera pozwala to zachować ID statusów z BL; zobacz Beel API → Identyfikatory z BaseLinkera.
Zmiana statusu
Dział zatytułowany „Zmiana statusu”-
Wyślij zmianę dla jednego lub wielu zamówień —
PUT /api/v4/Orders/OrdersStatusUpdateOkno terminala curl -X PUT "https://$SR_INSTANCE-smerp-api.enterprise.sellrocket.pl/api/v4/Orders/OrdersStatusUpdate" \-H "Authorization: Bearer $SR_TOKEN" \-H "Content-Type: application/json" \-d '{ "ids": [204295, 204296], "statusId": 9, "skipAjs": false }'Zamówienia są dzielone na paczki po maksymalnie 300 — każda paczka to osobne zadanie, więc w odpowiedzi jest lista
JobDTO. -
Sprawdź wyniki zadań —
GET /api/v3/jobs/get/{id}. Szczegóły w Konwencjach API.
| Pole | Znaczenie |
|---|---|
ids |
ID zamówień w Sellrocket |
statusId |
Docelowy status |
skipAjs |
true — zmień status bez uruchamiania automatyzacji powiązanych ze zmianą statusu |
Wariant PUT /api/v4/Orders/OrdersStatusUpdateSync przyjmuje to samo body (maksymalnie 1000 ID), ale obsługuje wszystkie zamówienia w ramach jednego zadania (zwraca jeden JobDTO). Mimo nazwy nie czeka na wynik — status zadania sprawdzasz tak samo.
Historia statusów
Dział zatytułowany „Historia statusów”| Endpoint | Zastosowanie |
|---|---|
GET /api/v3/Orders/{orderId}/statusHistory |
Historia statusów jednego zamówienia |
POST /api/v3/Orders/statusHistory/byIds |
Historia wielu zamówień — treść: tablica ID |
GET /api/v5/Orders/statusHistory |
Zmiany statusów wszystkich zamówień od chwili gt — przydatne do synchronizacji |
{ "list": [ { "id": 55120, "orderId": 204295, "statusId": 9, "statusName": "Wysłane", "previousStatusId": 7, "previousStatusName": "Do spakowania", "changedAtUtc": "2026-10-05T12:40:00Z", "changedBy": "integracja-wms" } ], "pageNumber": 0, "total": 1}Flagi bez zmiany statusu
Dział zatytułowany „Flagi bez zmiany statusu”Nie każda informacja powinna być statusem. Jeśli chcesz tylko coś zaznaczyć, nie przesuwając zamówienia w procesie:
- Oznaczenie (
asteriskMarked+asteriskKindId— rodzaj z kolorem i ikoną) — ustawisz przezPUT /api/v6/Orders/Patch/{orderId}i odfiltrujesz na liście (AsteriskMarked,AsteriskKindId). - Pola dodatkowe
additionalField1/2lub pola elastyczne — np. „wysłano do ERP: tak”. - Tagi — etykiety tekstowe przypisywane do obiektów (OMS → Tagi).
Na co uważać
Dział zatytułowany „Na co uważać”- Zbędne zmiany — każda zmiana statusu może uruchomić automatyzacje. Przed zmianą sprawdź bieżący status zamówienia i nie wysyłaj zmiany, jeśli jest już taki, jak trzeba.
- Kolejność — zadania dla jednego zamówienia wykonują się po kolei, ale zadania różnych zamówień niezależnie.
- Uprawnienia — sprawdź przez
GetAllUserStatuses, do których statusów ma dostęp użytkownik integracyjny. Jeśli lista statusów użytkownika jest ograniczona, zamówienia w innych statusach są dla niego niewidoczne, a zmiana zamówienia w statusie bez prawa zapisu kończy się403— zobacz Uwierzytelnianie. - Usunięte lub zmienione statusy — odświeżaj listę statusów okresowo i obsłuż sytuację, gdy zapisany w konfiguracji status już nie istnieje.
Odpowiedniki w BaseLinker
Dział zatytułowany „Odpowiedniki w BaseLinker”getOrderStatusList→GET /api/v3/Statuses/GetAll.setOrderStatus,setOrderStatuses→PUT /api/v4/Orders/OrdersStatusUpdate.- Gwiazdka zamówienia →
asteriskMarked/asteriskKindId.

