Przejdź do głównej zawartości

Szybki start

W tym przykładzie pobierzesz listę zamówień i zmienisz status jednego z nich. Potrzebujesz dostępu do instancji Sellrocket (konto użytkownika).

  1. Wygeneruj token API

    Zaloguj się do panelu Sellrocket, otwórz menu konta (prawy górny róg) i wybierz Generuj klucz API OMS. Otrzymasz token ważny 30 dni. Szczegóły i automatyczne odnawianie: Uwierzytelnianie.

    Okno terminala
    export SR_INSTANCE="twoja-instancja"
    export SR_TOKEN="eyJhbGciOi..."
  2. Pobierz listę statusów

    Statusy zamówień są definiowane w każdej instancji osobno, więc najpierw sprawdź ich identyfikatory.

    Okno terminala
    curl "https://$SR_INSTANCE-smerp-api.enterprise.sellrocket.pl/api/v3/Statuses?limit=100" \
    -H "Authorization: Bearer $SR_TOKEN"
    {
    "list": [
    { "id": 1, "name": "Nowe zamówienie", "groupId": 1, "position": 0 },
    { "id": 2, "name": "Do wysłania", "groupId": 2, "position": 1 }
    ],
    "pageNumber": 0,
    "total": 2
    }
  3. Pobierz zamówienia

    Okno terminala
    curl "https://$SR_INSTANCE-smerp-api.enterprise.sellrocket.pl/api/v5/Orders?OrderStatus=1&Limit=20&Offset=0" \
    -H "Authorization: Bearer $SR_TOKEN"

    Odpowiedź to strona wyników { list, pageNumber, total }. Endpoint ma kilkadziesiąt filtrów (daty, kanał sprzedaży, klient, produkt, numer przesyłki…) — zobacz Pobierz listę zamówień.

  4. Zmień status zamówienia

    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], "statusId": 2 }'

    Zmiana jest wykonywana asynchronicznie — dostajesz listę zadań (JobDTO) ze statusem New.

  5. Sprawdź wynik zadania

    Okno terminala
    curl "https://$SR_INSTANCE-smerp-api.enterprise.sellrocket.pl/api/v3/jobs/get/987654" \
    -H "Authorization: Bearer $SR_TOKEN"

    Gdy status = Completed, zmiana została zapisana. Więcej o zadaniach: Konwencje API → Operacje asynchroniczne.