Flujo de trabajo de extremo a extremo · Guías
Catálogo de productos y tarjetas
Buscar productos, obtener tarjetas completas, crear modelos, diccionarios de marcas y categorías y parámetros de mercado.
Una tarjeta SelSup es un modelo jerárquico , variantes de color y productos finales o tamaños.
PIM, ERP e integraciones de catálogos01
Encuentra un producto y cargue la tarjeta completa
La búsqueda de productos devuelve una representación de lista ligera. Almacenar el productoId, skuId, viewId y modelId por separado porque identifican entidades diferentes.
Cuando se requieren valores de parámetros dinámicos, habilite la opción de consulta correspondiente documentada para el punto final del modelo.
- 1
Busca página por página
Utilice una clasificación estable de identificación y evite contar en cada página.
- 2
Leer el identificador del modelo
Obtenga modelId o view.model.id del resultado de búsqueda, dependiendo de la representación de la respuesta.
- 3
Cargar el modelo completo
El modelo contiene variantes y tamaños necesarios para editar la tarjeta.
Puntos finales API relacionados
GET/api/product/findProductos de búsquedaGET/api/model/{modelId}Cargar el modelo completo
02
Crear una tarjeta mínima
Un modelo todavía necesita una variante y un producto final incluso cuando la empresa no utiliza colores o tamaños.
Encuentra o crea primero la marca y la categoría. Persista sus identificadores en tu sistema para que las importaciones repetidas no creen duplicados.
Utilice el artículo modelo como una clave externa estable. SelSup puede generar códigos de barras faltantes, pero el mapeo explícito de códigos es más seguro para la sincronización bidireccional.
Los modelos compartidos contienen campos de servicio. Envía sólo los campos enumerados en el cuerpo de solicitud actual del punto final.
{
"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
Actualizar sin perder datos
Utilice PATCH para un cambio parcial del producto final cuando el punto final admita la fusión.
Antes de PUT, cargue el último modelo, cambie los campos requeridos en su copia y envíe la estructura reconciliada.
Cuando no haya una versión de entidad o etiqueta ETag disponible, minimize la ventana de lectura a escritura y realice una lectura de verificación después de guardar.
Puntos finales API relacionados
PATCH/api/product/{productId}Actualización parcial de un productoPUT/api/model/{modelId}Reemplazar los datos del modelo
04
Parámetros y valores permitidos
Los valores de parámetros pueden vivir en la categoría, modelo, variante o nivel de producto.
Para multiValueAllowed, envíe varios valores con el mismo paramId. Seleccione la forma de valor de valueType y resuelva una opción permitida primero cuando displayType es SUGGEST.
Las categorías y parámetros del mercado cambian. actualicelas regularmente y nunca use el nombre de la pantalla como clave permanente.
GET https://params.selsup.ru/knowledge/getParams?ozonCategoryId=91025609
GET https://options.selsup.ru/option/fetchOption?paramId=60019&query=cotton&limit=10