Synchronizacja stanów i cen
Najczęstsza integracja z katalogiem produktów to synchronizacja stanów i cen: Twój ERP lub WMS jest źródłem prawdy, a Sellrocket rozsyła dane do sklepów i marketplace’ów. Ten przewodnik pokazuje, jak wysyłać zmiany masowo, jak czytać zmiany wykonane w Sellrocket i od czego zależy, czy trafią one do kanałów sprzedaży. Model produktu opisuje Produkty (PIM).
Jak to działa
Dział zatytułowany „Jak to działa”- Stan jest zapisany per produkt per magazyn (
warehouseId), cena — per produkt per grupa cenowa (priceGroupId). Magazyny i grupy cenowe są przypisane do katalogu. - Wysyłasz wartości bezwzględne (np. „stan = 25”), a nie różnice.
- Zestawy mają stan wyliczany ze składników — nie aktualizujesz go bezpośrednio.
- Propagacja do kanałów sprzedaży odbywa się po powiązaniach produktu (
productLinks): zmiana trafia do oferty tylko wtedy, gdy produkt ma powiązanie z tą ofertą i gdy w panelu włączono synchronizację stanów lub cen dla danego połączenia lub powiązania. - Każda zmiana stanu i ceny trafia do historii, z której możesz czytać zmiany przyrostowo.
Wysyłanie stanów i cen
Dział zatytułowany „Wysyłanie stanów i cen”-
Zmapuj swoje produkty na ID z PIM
Endpointy masowe przyjmują
productId, a nie SKU. Zbuduj mapę SKU →productIdraz (i odświeżaj ją przy dodawaniu produktów):Okno terminala curl "https://$SR_INSTANCE-pim-api.enterprise.sellrocket.pl/api/products/v4/products?catalogId=1&skus=KT-450&skus=KT-600&strictFilter=true&pageSize=1000" \-H "Authorization: Bearer $SR_TOKEN"Parametr
strictFilter=truewymusza dokładne dopasowanie SKU — bez niego filtr działa jak „zawiera” (np.KT-450dopasuje teżKT-4500).Identyfikatory magazynów i grup cenowych katalogu zwraca
GET /api/catalogs/v2/products-catalogszincludeWarehouseIds=trueiincludePriceGroupIds=true. -
Wyślij stany
PUT /api/products/v3/bulk/stocks— treścią jest tablica produktów:[{ "productId": 5012, "stocks": [{ "warehouseId": 3, "quantity": 25 }] },{ "productId": 5013, "stocks": [{ "warehouseId": 3, "quantity": 0 }, { "warehouseId": 4, "quantity": 7 }] }]Odpowiedź zawiera wynik całej paczki i listę błędów per produkt:
{"exid": "3f2b8c1e-6a0d-4e57-9a51-0c6f1d2e7b44","updatedCount": 1,"failedCount": 1,"errorDetails": [{ "productId": 5013, "errorMessage": "..." }]} -
Wyślij ceny
PUT /api/products/v3/bulk/prices— cena jest w poluvalue:[{ "productId": 5012, "prices": [{ "priceGroupId": 2, "value": 59.99 }] },{ "productId": 5013, "prices": [{ "priceGroupId": 2, "value": 79.0 }, { "priceGroupId": 5, "value": 69.0 }] }]Odpowiedź ma ten sam format co dla stanów.
-
Sprawdź
errorDetailsPaczka nie jest wycofywana w całości — poprawne pozycje są zapisane, błędne opisane w
errorDetails. Zapisz je i ponów tylko te produkty po poprawieniu danych.
Zestawy
Dział zatytułowany „Zestawy”Stan zestawu wynika ze stanów jego składników, dlatego bulk/stocks nie zmieni stanu produktu z isBundle: true (pozycja trafi do errorDetails, pozostałe zostaną zapisane). Aktualizuj stany składników — zestaw przeliczy się na ich podstawie.
Jeśli potrzebujesz wymusić ponowne przeliczenie wszystkich zestawów w katalogu (np. po dużym imporcie), użyj PUT /api/products/v3/bundles/refresh/stocks:
{ "catalogId": 1 }Odczyt zmian z historii
Dział zatytułowany „Odczyt zmian z historii”Jeśli Twój system musi wiedzieć o zmianach wykonanych w Sellrocket (np. ręczna korekta w panelu albo import), czytaj historię przyrostowo zamiast pobierać cały katalog:
GET /api/history/v3/stocks?gtId=0&limit=100GET /api/history/v3/stocks?gtId=880412&limit=100GET /api/history/v3/stocks zwraca wpisy o historyId większym niż gtId (maksymalnie 100 na stronę). Zapamiętaj największy historyId z odpowiedzi i użyj go jako gtId w kolejnym wywołaniu:
{ "stocks": [ { "historyId": 880413, "productId": 5012, "warehouseId": 3, "quantity": 24, "previousQuantity": 25, "updatedAt": "2026-10-05T09:12:44Z", "actor": "..." } ]}Ceny czytasz analogicznie z GET /api/history/v3/prices (price, previousPrice, priceGroupId). Najnowszy wpis historii stanów dla wskazanych produktów zwraca POST /api/history/v3/stocks/latest (treść: tablica ID produktów).
Na co uważać
Dział zatytułowany „Na co uważać”- Grupuj zmiany. Zamiast jednego wywołania na produkt wysyłaj paczki po kilkaset produktów. Przy wielu tysiącach zmian dziel je na kolejne paczki i obsługuj
429zgodnie z Konwencjami API. - Wysyłaj tylko to, co się zmieniło. Pełny zrzut stanów co kilka minut niepotrzebnie obciąża instancję i kanały sprzedaży. Pełną synchronizację rób rzadko (np. raz na dobę) jako zabezpieczenie.
- Brak propagacji do marketplace’u? Sprawdź, czy produkt ma powiązanie z ofertą (
includes.includeProductLinks=true) i czy dla połączenia włączono synchronizację stanów/cen w panelu. Sam zapis w PIM nie wystarczy. - Jedno źródło prawdy dla magazynu. Jeśli stan w danym magazynie zmienia zarówno Twój system, jak i Sellrocket, ustal, kto wygrywa — inaczej ostatni zapis nadpisze zmianę drugiej strony.
- Pełna edycja produktu to inny endpoint. Do zmiany lokalizacji magazynowej (
locationName) czy wielu pól naraz użyjPUT /api/products/v3/products/{id}— zobacz Produkty.
Odpowiedniki w BaseLinker
Dział zatytułowany „Odpowiedniki w BaseLinker”| BaseLinker | Sellrocket (PIM) |
|---|---|
updateInventoryProductsStock |
PUT /api/products/v3/bulk/stocks |
updateInventoryProductsPrices |
PUT /api/products/v3/bulk/prices |
getInventoryProductsStock, getInventoryProductsPrices |
GET /api/products/v4/products — stany w stocks (includes.includeStocks=true), ceny w productPriceGroups |
getInventoryProductLogs |
GET /api/history/v3/stocks, GET /api/history/v3/prices |
Te same operacje w trybie zgodności z BaseLinkerem: Beel API → Katalog (z ograniczeniami dla zestawów — Różnice).

