Flux de travail de bout en bout · Les guides
Catalogue et cartes de produits
Recherche de produits, récupération complète de cartes, création de modèles, dictionnaires de marques et de catégories et paramètres du marché.
Une carte SelSup est un modèle hiérarchique , des variantes de couleur et des produits ou tailles finaux.
Intégration de PIM, ERP et de catalogue01
Trouvez un produit et chargez la carte complète
La recherche de produit renvoie une représentation de liste légère.
Lorsque des valeurs de paramètres dynamiques sont requises, activer l'option de requête correspondante documentée pour le point d'extrémité du modèle.
- 1
Recherche page par page
Utilisez un tri stable d'identification et évitez de compter sur chaque page.
- 2
Lire l'identifiant du modèle
Obtenez modelId ou view.model.id à partir du résultat de recherche, selon la représentation de la réponse.
- 3
Charger le modèle complet
Le modèle contient des variantes et des tailles nécessaires à l'édition de la carte.
Points d'extrémité API connexes
GET/api/product/findProduits de rechercheGET/api/model/{modelId}Charger le modèle complet
02
Créer une carte minimale
Un modèle a toujours besoin d'une variante et d'un produit final même lorsque l'entreprise n'utilise pas de couleurs ou de tailles.
Trouvez ou créez d'abord la marque et la catégorie.
Utilisez l'article modèle comme clé externe stable. SelSup peut générer des codes-barres manquants, mais la cartographie explicite des code-barre est plus sûre pour la synchronisation bidirectionnelle.
Les modèles partagés contiennent des champs de service. Envoyez uniquement les champs énumérés dans le corps de demande actuel des points d'extrémité.
{
"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
Mise à jour sans perte de données
Utilisez PATCH pour un changement partiel du produit final lorsque le point final prend en charge la fusion.
Avant PUT, chargez le dernier modèle, modifiez les champs requis dans votre copie et envoyez la structure reconciliée.
Lorsque aucune version d'entité ou ETag n'est disponible, réduire au minimum la fenêtre lecture-écriture et effectuer une lecture de vérification après enregistrement.
Points d'extrémité API connexes
PATCH/api/product/{productId}Mise à jour partielle d'un produitPUT/api/model/{modelId}Remplacez les données du modèle
04
Parametres et valeurs autorisées
Les valeurs de paramètre peuvent être à l'échelle de la catégorie, du modèle, de la variante ou du produit.
Pour multiValueAllowed, envoyez plusieurs valeurs avec le même paramid. Sélectionnez la forme de valeur de valueType et résolvez d'abord une option autorisée lorsque displayType est SUGGEST.
Les catégories et les paramètres du marché changent.
GET https://params.selsup.ru/knowledge/getParams?ozonCategoryId=91025609
GET https://options.selsup.ru/option/fetchOption?paramId=60019&query=cotton&limit=10