SelSup Developers

终端到终端工作流程 · 导游

产品目录和卡片

产品搜索,完整的卡片检索,模型创建,品牌和类别字典以及市场参数.

4 部分开发人员指南

SelSup卡是层次式的模型,颜色变体和最终产品或尺寸.可靠的同步存储每个级别的识别符.

PIM,ERP和目录集成

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