Przepływ pracy od końca do końca · Przewodniki
Katalog produktów i karty
Wyszukiwanie produktów, pełne odzyskanie kart, tworzenie modeli, słowniki marki i kategorii oraz parametry rynku.
Karty SelSup są hierarchicznym model, wariantów kolorów i produktów końcowych lub rozmiarów.
Integracje PIM, ERP i katalogu01
Znajdź produkt i włóż pełną kartę
W wyszukiwaniu produktu otrzymuje lekki obraz listy.
W przypadku wymaganych wartości parametrów dynamicznych włącz odpowiednią opcję zapytania udokumentowaną dla punktu końcowego modelu.
- 1
Szukaj stronę po stronie
Użyj stabilnego sortowania identyfikacji i unikaj liczyć na każdą stronę.
- 2
Przeczytaj identyfikator modelu
Uzyskaj modelId lub view.model.id z wyniku wyszukiwania, w zależności od reprezentacji odpowiedzi.
- 3
Włóż kompletny model
Model zawiera warianty i rozmiary potrzebne do edycji karty.
Powiązane punkty końcowe API
GET/api/product/findProdukty wyszukiwaniaGET/api/model/{modelId}Włóż kompletny model
02
Tworzyć minimalną kartę
Model nadal potrzebuje jednego wariantu i jednego produktu końcowego, nawet jeśli firma nie używa kolorów ani rozmiarów.
Najpierw znajdź lub utwórz markę i kategorię.
Użyj artykułu modelu jako stabilnego klucza zewnętrznego. SelSup może generować brakujące kody kreskowe, ale wyraźne wykonanie mapy kodów kreskowych jest bezpieczniejsze dla dwuosukiwania.
Modele udostępnione zawierają pola usługi. Wysyłaj tylko pola wymienione w bieżącym ciele żądania punktów końcowych.
{
"article": "MODEL-001",
"title": "Basic T-shirt",
"brandId": 8124,
"categoryId": 27640,
"organizationId": 1,
"views": [
{
"color": "Black",
"sizes": [
{
"name": "Basic T-shirt, M",
"size": "M"
}
]
}
]
}
03
Aktualizacja bez utraty danych
Użyj PATCH do częściowej zmiany produktu końcowego, gdy punkt końcowy obsługuje fuzję.
Przed zainstalowaniem PUT włóż najnowszy model, zmienić wymagane pola w kopii i wysłać zjednoczoną strukturę.
W przypadku braku wersji podmiotu lub ETag, zminimalizuj okno odczytu do pisania i przeprowadź weryfikację odczytywania po zapisaniu.
Powiązane punkty końcowe API
PATCH/api/product/{productId}Częściowe aktualizacje produktuPUT/api/model/{modelId}Zastąpienie danych modelu
04
Parametry i dopuszczone wartości
Wartości parametrów mogą być określone na poziomie kategorii, modelu, wariantu lub produktu.
W przypadku multiValueAllowed wysyłaj wiele wartości z tym samym paramidem. Wybierz kształt wartości z valueType i najpierw rozwiąż opcję dozwoloną, gdy displayType jest SUGGEST.
Kategorie i parametry rynku zmieniają się.
GET https://params.selsup.ru/knowledge/getParams?ozonCategoryId=91025609
GET https://options.selsup.ru/option/fetchOption?paramId=60019&query=cotton&limit=10