Przejdź do głównej zawartości

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ą.

  • Status ma id, name, shortName, description, color i position. 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.
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
Okno terminala
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.

  1. Wyślij zmianę dla jednego lub wielu zamówień — PUT /api/v4/Orders/OrdersStatusUpdate

    Okno 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.

  2. 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.

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
}

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 przez PUT /api/v6/Orders/Patch/{orderId} i odfiltrujesz na liście (AsteriskMarked, AsteriskKindId).
  • Pola dodatkowe additionalField1/2 lub pola elastyczne — np. „wysłano do ERP: tak”.
  • Tagi — etykiety tekstowe przypisywane do obiektów (OMS → Tagi).
  • 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.
  • getOrderStatusList → GET /api/v3/Statuses/GetAll.
  • setOrderStatus, setOrderStatuses → PUT /api/v4/Orders/OrdersStatusUpdate.
  • Gwiazdka zamówienia → asteriskMarked / asteriskKindId.