API
商品时序图
更新时间： 2023-06-06 20:47:00 访问次数：11966
接口时序图
商品API字典
卖家需要根据实际业务情况，进行对接：
| 管理类型 | 是否需要管理第三方条码 | 主要对接接口 |
|---|---|---|
| 商品化管理 | 否 | 1. 注册/编辑商品 2. 打印商品条码标签-不返回单品条码信息 |
| 商品化管理 | 第三方商品编码管理 | 1. 注册/编辑商品 |
| 单品化管理 | 否 | 1. 注册/编辑商品 2. 打印商品条码标签-返回单品条码信息 3. 查询商品的单品条码及其状态 |
| 单品化管理 | 第三方单品条码管理 | 1. 注册/编辑商品 2. 新增第三方单品条码 3. 查询第三方单品条码 |
| 接口 | 类型 | 接口名称 | 接口简介 |
|---|---|---|---|
| 注册/编辑商品 | 必选 | registerProduct | 提供商品基本信息进行注册，注册完成后商品需要人工审核后发布，商品只有在发布状态才能下单 |
| 查询商品 | 选用 | winit.mms.item.list | 当商品信息存在变更，支持对已发布的商品进行编辑 |
| 查询商品审核状态 | 选用 | mms.itemmttask.queryItemMtEntitys | 通过本接口可查询商品注册的审核状态 |
| 打印商品条码标签-不返回单品条码信息 | 选用 | winit.singleitem.label.print | 通过本接口用户可打印已经注册并发布商品条码label |
| 打印商品条码标签-返回带有单品信息 | 选用 | winit.singleitem.label.print.v2 | 通过本接口用户可打印已经注册并发布商品条码label，并查询到商品S码 |
| 查询商品的单品条码及其状态 | 选用 | winit.singleitem.list | 该接口可以查询SKU对应的单品信息及单品状态 |
| 新增第三方单品条码 | 权限 | winit.singleitem.importThirdByApi | 本接口可新增第三方单品条码。请联系工作人员开通权限 |
| 查询第三方单品条码 | 权限 | winit.singleitem.list2 | 本接口可查询系统内的第三方单品条码。请联系工作人员开通权限 |
商品消息订阅
| 消息订阅 | 类型 | 事件名称 | 订阅简介 |
|---|---|---|---|
| 商品重要信息变更通知 | 权限 | EVENT_MERCHANDISE_UPDATE_V1 | 进口税率变更，头程变更（限直发，禁止入库），核实重量变更、禁止出库。 特殊订阅，请联系工作人员开通权限 |
商品相关术语
- 商品编码：指卖家或第三方定义的商品编码，单个客户内[商品编码+商品规格]唯一
- 商品条码：指商品创建后，Winit生成的系统内唯一码，也称M码
- 单品条码：打印单品条码时，Winit生成的系统内唯一码，也称S码；一个商品对应多个单品条码
- 商品化管理：以商品的维度管理，一类一码
- 单品化管理：以单个物品维度管理，一物一码
- 申报价
- 例如：SKU的出口国是中国，进口国英国，
- 出口申报价，就是该SKU从中国出口报关的申报单价；
- 进口申报价，就是该SKU英国进口的申报用单价；
- 进口国出口申报价，英国的的出口申报价，是指当货物进口到英国但是想发到德国，这时候就会用带英国的出口申报价，也就是API字段进口国出口申报价
关键词
