组合接口将独立的接口组合成一个流程调用,达到一次调用组合多个功能的目的。通过参数biz_id
来进行幂等和去重的处理。
组合三步动作:1. 创建仓储sku;2. 初始化库存;3. 批量建立映射关系。
-
biz_id
:业务惟一id,由字母数字和下划线组成的字符串。对于同一个biz_id
请永远传入同样的参数,会得到幂等的结果。如果重复使用一个biz_id
传入不同的参数可能得到不正确的非预期的结果。简而言之就是对每一个业务动作请使用惟一的
biz_id
-
session_nick
:用户nick。 -
sc_item_name
:仓储sku名字(title)。 -
outer_code
:仓储sku外部编码。 -
inventorys
:初始化库存的JSON串,注意此参数只接受JSON格式,不接受XML格式。详细说明请参阅初始化库存接口taobao.inventory.initial.item
中参数store_inventorys
的说明文档。一个可能的范例是:
[{"storeCode":"tmallb302","quantity":111,"inventoryType":1}]
-
seller_item_codes
:前端商品外部编码列表,用,
(即半角逗号)分隔的字符串。可空,当留空此参数时会使用outer_code
来查询。首先会作为sku的外部编码来查询,如果查不到则会作为item的外部编码来查询。一个可能的范例是:
code1,code2
-
seller_nicks
:商家nick列表,用,
(即半角逗号)分隔的字符串,用以支持主子店铺。可空,当留空此参数时会使用session_nick
来查询。一个可能的范例是:
tmall82,tmall473
- 使用参数
sc_item_name
和参数outer_code
创建仓储sku。 - 使用步骤1创建的仓储sku和参数
inventorys
初始化库存。 - 建立映射关系
- 判断参数
seller_item_codes
是否为空,为空则使用参数outer_code
,生成code_list
。 - 判断参数
seller_nicks
是否为空,为空则使用参数session_nick
,生成nick_list
。 - 遍历
code_list
和nick_list
中的每一种组合,查询对应的sku或者item,并和outer_code
建立映射关系。查询规则为先查询sku,如果查不到则查询不包含sku的item。
- 判断参数
-
单店铺,前后端商品编码一致
biz_id:33455432 //自定义 session_nick:tmall82 //商家nick sc_item_name:1 //仓储sku名字 outer_code:2 //仓储sku外部编码 inventorys:[{"storeCode":"tmall82","quantity":111,"inventoryType":1}] //初始化库存参数 seller_item_codes: //不传,使用outer_code seller_nicks: //不传,使用session_nick
创建title为1,外部编码为2的仓储sku;初始化库存;将用户tmall82的外部编码为2的前端商品和外部编码同样为2的后端仓储sku映射。
-
单店铺,前后端商品编码不一致
biz_id:33455433 //自定义 session_nick:tmall82 //商家nick sc_item_name:1 //仓储sku名字 outer_code:2 //仓储sku外部编码 inventorys:[{"storeCode":"tmall82","quantity":111,"inventoryType":1}] //初始化库存参数 seller_item_codes:2,3 //传入两个前端商品编码 seller_nicks: //不传,使用session_nick
创建title为1,外部编码为2的仓储sku;初始化库存;将用户tmall82的外部编码为2或3的前端商品和外部编码为2的后端仓储sku映射。
-
主子店铺,前后端商品编码一致
biz_id:33455434 //自定义 session_nick:tmall82 //商家nick sc_item_name:1 //仓储sku名字 outer_code:2 //仓储sku外部编码 inventorys:[{"storeCode":"tmall82","quantity":111,"inventoryType":1}] //初始化库存参数 seller_item_codes: //不传,使用outer_code seller_nicks:tmall82,tmall473 //传入主子店铺的nick
创建title为1,外部编码为2的仓储sku;初始化库存;将用户tmall82和用户tmall473所属的外部编码为2的前端商品和外部编码同样为2的后端仓储sku映射。
-
主子店铺,前后端商品编码不一致
biz_id:33455434 //自定义 session_nick:tmall82 //商家nick sc_item_name:1 //仓储sku名字 outer_code:2 //仓储sku外部编码 inventorys:[{"storeCode":"tmall82","quantity":111,"inventoryType":1}] //初始化库存参数 seller_item_codes:2,3 //传入两个前端商品编码 seller_nicks:tmall82,tmall473 //传入主子店铺的nick
创建title为1,外部编码为2的仓储sku;初始化库存;将用户tmall82和用户tmall473所属的外部编码为2或3的前端商品和外部编码同样为2的后端仓储sku映射。