Przejdź do głównej zawartości

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

  • 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.
  1. Zmapuj swoje produkty na ID z PIM

    Endpointy masowe przyjmują productId, a nie SKU. Zbuduj mapę SKU → productId raz (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=true wymusza dokładne dopasowanie SKU — bez niego filtr działa jak „zawiera” (np. KT-450 dopasuje też KT-4500).

    Identyfikatory magazynów i grup cenowych katalogu zwraca GET /api/catalogs/v2/products-catalogs z includeWarehouseIds=true i includePriceGroupIds=true.

  2. 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": "..." }]
    }
  3. Wyślij ceny

    PUT /api/products/v3/bulk/prices — cena jest w polu value:

    [
    { "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.

  4. Sprawdź errorDetails

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

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 }

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:

Okno terminala
GET /api/history/v3/stocks?gtId=0&limit=100
GET /api/history/v3/stocks?gtId=880412&limit=100

GET /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).

  • 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 429 zgodnie 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żyj PUT /api/products/v3/products/{id} — zobacz Produkty.
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).