新零售联盟
库存
更新时间：2018/07/04
访问次数：4737
系统流程图
商家侧库存同步（增量模式）流程图
alibaba.ascp.inventory.sync（库存同步接口）
功能描述
新零售联盟商家库存同步接口，用于商家商品库存数量同步到阿里系统。
＊＊重要：请确认接口同步的库存 商家系统 能关联到的门店商品外键。
目前可以通过商品在中台导入时填写商品字段自定义编码 关联外键。 也可以通过商品条码关联（如果商家系统有保存商品条码）。
topAPI链接：https://open.taobao.com/docs/api.htm?spm=a219a.7395905.0.0.TrW4yQ&apiId=35425
API入参
|
名称
|
类型
|
是否必须
|
描述
|
示例值
|
|
outer_order_no
|
String
|
是
|
外部操作单号，用于幂等控制
|
OON2018032000000001
|
|
bar_code
|
String
|
与outer_item_id二选其一
|
商品条形码,数字型， 作为外部商品唯一外键优先选用该字段， 唯一性由商家保证，如果没有请联系阿里小二 。bar_code和outer_item_id必须传入其中一个
|
44222353
|
|
change_quantity
|
Number
|
是
|
变化数量，整数表示增加数量， 负数表示减少数量
|
-100
|
|
store_code
|
String
|
是
|
仓编码
|
tmallmj_daily_wh01
|
|
inv_type
|
String
|
否
|
库存类型，枚举值：warehouse-仓库存；store门店库存，不传默认仓库存 warehouse
|
warehouse
|
|
biz_code
|
String
|
是
|
业务码，即所属项目，如新零售美家未来店项目
|
tmallmj
|
|
seller_id
|
Number
|
是
|
商家id
|
3733221366
|
|
outer_item_id
|
String
|
与bar_code二选其一
|
如果商家没有商品条形码,用该字段，唯一标示商品id， 唯一性由商家保证。
|
ITEM438677665555
|
API出参
|
名称
|
类型
|
描述
|
示例值
|
|
succ
|
Boolean
|
是否成功
|
true
|
|
code
|
String
|
错误码
|
0
|
|
msg
|
String
|
错误信息
|
SUCCESS
|
返回结果示例
成功情况：
{
"alibaba_ascp_inventory_sync_response": {
"result": {
"code": "0",
"msg": "SUCCESS",
"succ": true //true表示同步成功，否则同步失败。
},
"request_id": "d45731idwemz"
}
}
失败情况：
{
"error_response": {
"code": 15,
"msg": "Remote service error",
"sub_code": "PERMISSION_NO_PERMISSION", //错误码
"sub_msg": "该用户无权操作,请到门店中台授权", //错误信息
"request_id": "d45731gc4hxj"
}
}
错误码解释
错误码字段落在sub_code和sub_msg字段上，可参考：「返回结果示例」章节。
|
错误码
|
错误码描述
|
解决方案
|
|
PERMISSION_NO_PERMISSION
|
该用户无权操作,请到门店中台授权
|
当前登录用户并没有得到当前商家的授权，需要联系阿里小二手动授权。
|
|
NOT_LOGIN
|
未登录
|
需要登录
|
|
SYS_ERR
|
系统异常
|
接口内部错误，联系阿里技术小二解决。
|
|
PARAMS_ILLEGAL
|
变化库存不能为零
|
入参change_quantity不能传0
|
|
PARAMS_ILLEGAL
|
参数错误
|
其他参数校验不通过
|
|
PARAMS_ILLEGAL
|
商品条形码或外部商品ID为空
|
商品条形码或外部商品ID为空
|
|
SELLABLE_QUANTITY_NOT_ENOUGH
|
可售库存不足
|
库存减少，但原有库存不够扣减
|
|
INV_RECORD_NOT_EXIST
|
库存记录不存在
|
没有初始化库存或者仓code传入有误
|
alibaba.ascp.inventory.query( 商品库存查询接口 )
功能描述
新零售联盟商家库存查询接口，用于商家商品库存数量感知查询。
＊＊重要：请确认接口同步的库存 商家系统 能关联到的门店商品外键。
目前可以通过商品在中台导入时填写商品字段自定义编码 关联外键。 也可以通过商品条码关联（如果商家系统有保存商品条码）
API入参
topAPI链接：https://open.taobao.com/docs/api.htm?spm=a219a.7395905.0.0.ufmXf1&apiId=35424
|
名称
|
类型
|
是否必须
|
描述
|
示例值
|
|
bar_code
|
String
|
与outer_item_id二选其一
|
商品条形码,数字型， 作为外部商品唯一外键优先选用该字段， 唯一性由商家保证，如果没有请联系阿里小二 。bar_code和outer_item_id必须传入其中一个
|
44222353
|
|
store_code
|
String
|
是
|
仓编码
|
tmallmj_daily_wh01
|
|
biz_code
|
String
|
是
|
业务码，即所属项目，如新零售美家未来店项目
|
tmallmj
|
|
seller_id
|
Number
|
是
|
商家id
|
3733221366
|
|
outer_item_id
|
String
|
与bar_code二选其一
|
如果商家没有商品条形码,用该字段，唯一标示商品id， 唯一性由商家保证。
|
ITEM438677665555
|
API出参
|
名称
|
类型
|
描述
|
示例值
|
|
succ
|
Boolean
|
是否成功
|
true
|
|
data
|
|||
|
|-bar_code
|
Number
|
商品条形码
|
44222353
|
|
|-outer_item_id
|
String
|
如果商家没有商品条形码,用该字段，两者不会同时出现
|
ITEM438677665555
|
|
|-store_code
|
String
|
仓编码
|
tmallmj_daily_wh01
|
|
|-sellable_quantity
|
Number
|
可用销售库存
|
10
|
|
code
|
String
|
错误码
|
0
|
|
msg
|
String
|
错误信息
|
SUCCESS
|
返回结果示例
成功返回：
{
"alibaba_ascp_inventory_query_response":{
"result":{
"succ":true,
"data":{
"sellable_quantity":10,
"bar_code":"34745764564434",
"store_code":"tmall_mj_001"
},
"code":"0",
"msg":""
}
}
}
{
"alibaba_ascp_inventory_query_response": {
"result": {
"data": {
"outer_item_id": "1314520",
"sellable_quantity": 1,
"store_code": "tmallmj_daily_wh01"
},
"succ": true
},
"request_id": "d45746pj99vh"
}
}
失败返回：
{
"error_response": {
"code": 15,
"msg": "Remote service error",
"sub_code": "PERMISSION_NO_PERMISSION",
"sub_msg": "该用户无权操作,请到门店中台授权",
"request_id": "d45731gc4hxj"
}
}
错误码解释
错误码字段落在sub_code和sub_msg字段上，可参考：「返回结果示例」章节。
|
错误码
|
错误码描述
|
解决方案
|
|
PERMISSION_NO_PERMISSION
|
该用户无权操作,请到门店中台授权
|
当前登录用户并没有得到当前商家的授权，需要联系阿里小二手动授权。
|
|
NOT_LOGIN
|
未登录
|
需要登录
|
|
SYS_ERR
|
系统异常
|
接口内部错误，联系阿里技术小二解决。
|
|
PARAMS_ILLEGAL
|
变化库存不能为零
|
入参change_quantity不能传0
|
|
PARAMS_ILLEGAL
|
参数错误
|
其他参数校验不通过
|
|
PARAMS_ILLEGAL
|
商品条形码或外部商品ID为空
|
商品条形码或外部商品ID为空
|
|
SELLABLE_QUANTITY_NOT_ENOUGH
|
可售库存不足
|
库存减少，但原有库存不够扣减
|
|
INV_RECORD_NOT_EXIST
|
库存记录不存在
|
没有初始化库存或者仓code传入有误
|
|
ITEM_OUTID_EXIST
|
商品商家外键已经存在
|
barcode或者outerItemId重复
|
|
INIT_QUANTITY_NOT_NEGATIVE
|
初始化库存字段不能为负数
|
商品第一次同步时传入的数量必须大于零
|
如何创建仓
1.进入天猫商家库存中心页面：https://inventory.tmall.com/merchant/storeManager.htm
2.新建仓库
3.区域设置
