同城零售轻方案

更新时间：2021/01/04 访问次数：1392

接口文档

同城零售轻方案对接

商品发布（不需要系统对接）

商家使用同城零售后台发布商品，包含两种方式（第一种，旗舰店商品引入，如果商家在天猫有旗舰店或者专营店，可以在同城零售后台引入，使用旗舰店已经发布过的商品属性；第二种，商品直接手工发布），商品会同步到天猫超市商品后台，天猫超市商品运营小二审核后把商品发布到天猫超市。

库存对接

商家通过ERP对接共享库存提供库存发布接口把库存信息实时同步到天猫超市，注意，库存信息一定要准确，否则很容易造成超卖。

采购价报价（不需要系统对接）

商家使用同城零售的后台设置采购价，把采购价实时同步到天猫超市，采购价为商家向天猫超市提报的结算报价。

营销活动设置（不需要系统对接）

商家使用同城零售的后台设置营销活动，把营销活动实时同步到天猫超市，天猫超市运营可参考该营销活动进行营销玩法设置。

接口文档

API总览

业务

接口名称

API(含对外文档链接)

网关

销售库存

库存同步

alibaba.wdk.sku.scroll.query

alibaba.wdk.stock.publish

TOP

使用方法：

先通过wdk.sku.scroll.query获取商家门店在猫超发布的商品；
再通过wdk.stock.publish 同步门店级库存；

商品数据拉取：alibaba.wdk.sku.scroll.query

API入参
名称	参数类型/SDK类型	是否必须	示例值	描述
merchant_cat_code	String	可选	cat001	商家类目编码
ou_code	String	必须	ou001	门店编码
scroll_id	String	可选	xxxxx	游标：第一次请求不用填写，否则请填写上一次请求返回的值，直到获取到足够的数据
sku_codes	String	可选	1234,abcd	英文逗号分隔的商品编码，最多20个。如果配合门店字段使用，直接非游标方式返回商品数据
API出参
名称	参数类型/SDK类型	是否必须	示例值	描述
result	ApiScrollPageResult	否	具体请看子字段	返回结果
└ page_count	Number	否	10	商品商量总页数：分页大小20
└ total	Number	否	200	商品总数
└ success	Boolean	否	TRUE	是否调用成功
└ err_code	String	否	ILLEGAL_PARAMETERS	异常信息编码
└ err_msg	String	否	门店不存在	异常信息
└ page_size	Number	否	20	分页大小
└ model_list	ModelList[]	否	具体请求看子字段	返回的结果集
└ sku_code	String	否	123	商品编码
└ sku_name	String	否	可乐	商品名称
└ life_status	String	否	A	商品在机构内的生命周期，商品状态；A-正常、T-暂时停购、C-淘汰出清、R-清退、D-删除封挡
└ barcodes	String	否	69xx123,69xx456	条码：多个条码用英文逗号分割
└ sale_price	String	否	10	价格：单位元
└ member_price	String	否	9.9	会员价：单位元
└ sale_unit	String	否	袋	售卖单位
└ weight_flag	String	否	1	是否称重品：1称重品0非称重品
└ merchant_cat_code	String	否	cat001	商家类目编码
└ org_no	String	否	OR1001	子公司编码
└ ou_code	String	否	OU1001	门店编码
└ shop_id	String	否	1000100	渠道店编码
└ channel_codes	String	否	4	渠道店类型：4淘宝
└ tax_class_no	String	否	3252225	税收编码(查询返回使用)
└ business_type	Number	否	2	业务类型 1：盒饭 2：生鲜
└ test_flag	Number	否	1	是否测试商品
└ service_flag	Number	否	1	是否服务商品
└ modified_time	String	否	2020/12/31 23:59:59	修改时间
└ merchant_code	String	否	CSSJ	商家编码
└ supplier_no	String	否	328779	默认供应商
└ short_title	String	否	鲜美可口	短标题
└ online_sale_flag	Number	否	1	是否线上可售是 0：否 1：是
└ sale_spec	String	否	30mL/瓶	销售规格描述
└ processing_time	Number	否	20	加工时间单位：分钟
└ back_cat_code	String	否	325224	后台平台类目编码
└ input_tax_rate	String	否	0.02	进项税率
└ tax_rate	String	否	0.02	销项税率
└ brand_name	String	否	可口可乐	品牌名称
└ brand_code	String	否	10086	品牌编码
└ shelf_life	String	否	0	保质期天数，商品的保质期（单位：天）,0表示没有保质期
└ scroll_id	String	否	xxxxx	游标：作为下一次请求数据的参数

通过alibaba.wdk.stock.publish 同步门店级库存使用方法：

商通过共享库存提供库存发布接口把库存信息实时同步到天猫超市。注意：库存信息要准确，否则很容易造成超卖风险。

销售库存发布：alibaba.wdk.stock.publish

注：billNo 、 orderNo 两个流水参数支持字母和数字，不支持特殊字条，长度：至少18位以上50位以内，全局必须唯一

单次请求list明细是20条商品

billNo建议：门店编码+时间戳+随机数
orderNo建议：门店编码+时间戳+随机数+商品编码

API入参
名称	参数类型/SDK类型	是否必须	示例值	描述
batch_stock_publish_dto	BatchStockPublishDto	可选		批量参数
└ update_type	Number	必须	1	更新类型，全量1，增量2
└ bill_no	String	必须	201208082269992	外部单据号(幂等)，理解为一次请求提交，接口调用成功库存数据不执行
└ bill_type	Number	必须	9001	外部单据类型，由ReX开放技术支持统一分配
└ publish_source	String	必须	RT	发布来源，取商家编码
└ warehouse_code	String	必须	8008	仓编码(必须传对值，否则猫超识别不到库存)
└ shop_code	String	必须	8009	经营店编码（必须）
└ channel_source_id	String	必须	370001	渠道店编号
└ operator	String	必须	RT.陆离	操作者
└ channel_source_type	Number	必须	4	渠道店类型；可使用默认值4
└ stock_publish_dtos	StockPublishDto[]	必须		子参数列表(20条商品明细)
└ sku_code	String	必须	23021101	商品编码
└ quantity	String	必须	21.45	更新数量，矢量(支持正负值)
└ order_no	String	必须	277273823	订单号（商品粒度操作单）
└ order_type	String	必须	10006800	订单类型，参见订单类型约束https://hema.open.taobao.com/doc?docId=109119&docType=1
└ order_desc	String	必须	销售出库	订单描述
└ un_batched_order_stock_subtracted	Boolean	可选	FALSE	是否已扣除未批次数，用于全量发布
API出参
名称	参数类型/SDK类型	是否必须	示例值	描述
is_success	Boolean	否	FALSE	success
msg_code	String	否	"isv.invalid-parameter"	errorCode
message	String	否	"参数错误"	errorMsg

FAQ

关于此文档暂时还没有FAQ

有用(0) 我要提问

淘宝开放平台

开放业务&解决方案