终端到终端工作流程 · 导游
产品目录和卡片
产品搜索,完整的卡片检索,模型创建,品牌和类别字典以及市场参数.
4 部分开发人员指南
SelSup卡是层次式的模型,颜色变体和最终产品或尺寸.可靠的同步存储每个级别的识别符.
PIM,ERP和目录集成01
找到产品,然后加载完整的卡片
产品搜索返回轻量级列表表示. 单独存储产品Id,skuld,viewId和modelId,因为它们识别不同的实体.
输入模型以模型Id为完整卡.当需要动态参数值时,启用对模型终端点记录的相应查询选项.
- 1
页面按页面搜索
使用稳定身份认证排序,避免每页都会计数.
- 2
阅读模型标识符
根据响应表现,从搜索结果中获取modelId或view.model.id.
- 3
装载完整的模型
该模型包含编辑卡所需的变体和尺寸.
02
创建一个最小的卡
企业不使用颜色或尺寸,也需要一个变体和一个最终产品.
首先找到或创建品牌和类别. 保持它们的识别符在您的系统中,以便重复进口不会产生重复.
使用模型文章作为一个稳定的外部密钥. SelSup可以生成缺失的条码,但明确的条code映射对于双向同步更安全.
!
查看请求方案
共有模型包含服务字段. 仅将在当前终端点请求体中列出的字段发送.
最低模型 · JSON
{
"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
更新而不丢失数据
使用PATCH为最终产品部分更改,当终点支持合并时. 作为可编辑结构的替代,处理PUT模型.
在PUT之前,加载最新模型,更改复制中的所需字段,并发送调整结构.如果卡在UI中可能发生了变化,不要再使用旧的响应.
!
同时编辑
如果没有实体版本或ETag,尽量减少读写窗口,并进行保存后的验证读取.
04
参数和允许值
参数值可能在类别,模型,变体或产品水平上存在.更具体的水平通常会获胜,而市场规则则决定实际上可以发送什么.
在 multiValueAllowed 中,将相同的参数Id 发送多个值.在 valueType 中选择值形状,并在 displayType 是 SUGGEST 时首先解决允许的选项.
经常更新这些类别和参数,不要使用显示器名称作为永久密钥.
词典服务 · HTTP
GET https://params.selsup.ru/knowledge/getParams?ozonCategoryId=91025609
GET https://options.selsup.ru/option/fetchOption?paramId=60019&query=cotton&limit=10