当前系统日期前一天苏宁店仓的商品库存信息,例如ATP可卖数、销售已销未提等信息。
名称 | 类型 | 是否必须 | 示例值 | 描述 |
---|---|---|---|---|
appMethod | String | Y | suning.custom.category.query | 方法名 |
appRequestTime | String | Y | 2012-04-25 20:23:30 | 时间戳,格式为yyyy-MM-dd HH:mm:ss,例如:2012-04-25 20:23:30。API服务端允许客户端请求时间误差为10分钟。 |
format | String | N | XML | 默认xml,可指定格式为xml,json |
appKey | String | Y | b0c332a133c102765f39de********** | 分配给应用的访问令牌 |
versionNo | String | Y | v1.2 | API的版本,目前为v1.2版本 |
signInfo | String | Y | 460d7ff15b073e463125b4********** | appSecret,appMethod ,appRequestTime, appKey, versionNo, 请求报文base64加密后的数据顺序MD5(32位小写),其中appSecret为appKey对应的密钥 |
access_token | String | N | a1c5c62b08df3a3cbf7efd********** | 采用OAuth授权方式为必填参数 |
名称 | 类型 | 是否必须 | 示例值 | 描述 |
---|---|---|---|---|
pageNo | String | N | 1 | 页码 |
pageSize | String | N | 10 | 每页条数 |
vendorCd | String | Y | 10001369 | 供应商编码 |
statisDate | String | Y | 2020-01-01 | 统计日期,格式:yyyy-MM-dd |
gdsCd | String | N | 600575273 | 苏宁商品编码 |
vendorGds | String | N | WD90M4473JX/SC | 供应商商品编码 |
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
statisDate | String | 20200101 | 统计日期 |
vendorCd | String | 10001369 | 供应商编码 |
vendorNm | String | (冰洗)三星(中国)投资有限公司北京分公司 | 供应商名称 |
areaCd | String | 10018 | 苏宁大区编码 |
areaNm | String | 北京 | 苏宁大区名称 |
cmpnyCd | String | 1100 | 苏宁公司编码 |
cmpnyNm | String | 北京苏宁云商销售有限公司 | 苏宁公司名称 |
placeCd | String | D269 | 苏宁地点编码 |
placeNm | String | 苏宁北京昌平物流库 | 苏宁地点名称 |
depotCd | String | 0001 | 苏宁库位编码 |
depotNm | String | 常规机库 | 苏宁库位名称 |
realPlaceCd | String | 7161 | 苏宁实货地点编码 |
realPlaceNm | String | 北京顺义店 | 苏宁实货地点名称 |
realPlaceType | String | 中心仓、门店 | 实货地点类型:中心仓、门店 |
catologCd | String | 常规 | 库位类型 |
vendorGds | String | WD90M4473JX/SC | 供应商商品编码 |
gdsCd | String | 600575273 | 苏宁商品编码 |
gdsNm | String | 三星洗衣机WD90M4473JX/SC(XQG90-90M4473JX) | 苏宁商品名称 |
fourGroupCd | String | R0401005 | 苏宁四级商品组编码 |
fourGroupDesc | String | 洗干一体机 | 苏宁四级商品组名称 |
thirdGroupCd | String | R0401005 | 苏宁三级商品组编码 |
thirdGroupDesc | String | 洗干一体机 | 苏宁三级商品组名称 |
secGroupCd | String | R0401005 | 苏宁二级商品组编码 |
secGroupDesc | String | 洗干一体机 | 苏宁二级商品组名称 |
firstGroupCd | String | R0401005 | 苏宁一级商品组编码 |
firstGroupDesc | String | 洗干一体机 | 苏宁一级商品组名称 |
brandCd | String | 1659 | 苏宁品牌编码 |
brandNm | String | 三星(SAMSUNG) | 苏宁品牌名称 |
deptCd | String | 00006 | 品类编码 |
deptNm | String | 冰洗 | 品类名称 |
atpAQty | String | 10 | 全渠道可卖数 |
atpQty | String | 10 | ATP可卖数 |
actQty | String | 10 | 实货可用数 |
actAmnt | String | 0 | 实货库存金额 |
noneGetSale | String | 0 | 销售已销未提 |
buyInQty | String | 0 | 在途采购进 |
buyRfdQty | String | 0 | 在途采购退 |
adjustRecvQty | String | 0 | 在途调拨收 |
adjustSendQty | String | 0 | 在途调拨发 |
frozenQty | String | 0 | 冻结库存 |
qualityCheckQty | String | 0 | 质检库存 |
<sn_request> <sn_body> <queryEdaostock> <vendorCd>10001369</vendorCd> <pageNo>1</pageNo> <pageSize>10</pageSize> <statisDate>2020-01-01</statisDate> <vendorGds>WD90M4473JX/SC</vendorGds> <gdsCd>600575273</gdsCd> </queryEdaostock> </sn_body> </sn_request>
{ "sn_request": { "sn_body": { "queryEdaostock": { "vendorCd": "10001369", "pageNo": "1", "pageSize": "10", "statisDate": "2020-01-01", "vendorGds": "WD90M4473JX/SC", "gdsCd": "600575273" } } } }
<sn_responseContent> <sn_head> <totalSize>1</totalSize> <pageTotal>1</pageTotal> <pageNo>1</pageNo> <returnMessage>biz.handler.data-get:success</returnMessage> </sn_head> <sn_body> <queryEdaostock> <placeCd>D269</placeCd> <fourGroupCd>R0401005</fourGroupCd> <vendorCd>10001369</vendorCd> <atpQty>10</atpQty> <actAmnt>0</actAmnt> <statisDate>20200101</statisDate> <realPlaceCd>7161</realPlaceCd> <vendorGds>WD90M4473JX/SC</vendorGds> <deptNm>冰洗</deptNm> <gdsNm>三星洗衣机WD90M4473JX/SC(XQG90-90M4473JX)</gdsNm> <fourGroupDesc>洗干一体机</fourGroupDesc> <depotCd>0001</depotCd> <brandNm>三星(SAMSUNG)</brandNm> <areaNm>北京</areaNm> <cmpnyNm>北京苏宁云商销售有限公司</cmpnyNm> <qualityCheckQty>0</qualityCheckQty> <firstGroupDesc>洗干一体机</firstGroupDesc> <atpAQty>10</atpAQty> <catologCd>常规</catologCd> <secGroupCd>R0401005</secGroupCd> <realPlaceNm>北京顺义店</realPlaceNm> <actQty>10</actQty> <buyRfdQty>0</buyRfdQty> <secGroupDesc>洗干一体机</secGroupDesc> <placeNm>苏宁北京昌平物流库</placeNm> <gdsCd>600575273</gdsCd> <thirdGroupDesc>洗干一体机</thirdGroupDesc> <vendorNm>(冰洗)三星(中国)投资有限公司北京分公司</vendorNm> <deptCd>00006</deptCd> <adjustSendQty>0</adjustSendQty> <thirdGroupCd>R0401005</thirdGroupCd> <adjustRecvQty>0</adjustRecvQty> <depotNm>常规机库</depotNm> <realPlaceType>中心仓、门店</realPlaceType> <areaCd>10018</areaCd> <buyInQty>0</buyInQty> <cmpnyCd>1100</cmpnyCd> <firstGroupCd>R0401005</firstGroupCd> <frozenQty>0</frozenQty> <noneGetSale>0</noneGetSale> <brandCd>1659</brandCd> </queryEdaostock> </sn_body> </sn_responseContent>
{ "sn_responseContent": { "sn_head": { "totalSize": "1", "pageTotal": "1", "pageNo": "1", "returnMessage": "biz.handler.data-get:success" }, "sn_body": { "queryEdaostock": [ { "placeCd": "D269", "fourGroupCd": "R0401005", "vendorCd": "10001369", "atpQty": "10", "actAmnt": "0", "statisDate": "20200101", "realPlaceCd": "7161", "vendorGds": "WD90M4473JX/SC", "deptNm": "冰洗", "gdsNm": "三星洗衣机WD90M4473JX/SC(XQG90-90M4473JX)", "fourGroupDesc": "洗干一体机", "depotCd": "0001", "brandNm": "三星(SAMSUNG)", "areaNm": "北京", "cmpnyNm": "北京苏宁云商销售有限公司", "qualityCheckQty": "0", "firstGroupDesc": "洗干一体机", "atpAQty": "10", "catologCd": "常规", "secGroupCd": "R0401005", "realPlaceNm": "北京顺义店", "actQty": "10", "buyRfdQty": "0", "secGroupDesc": "洗干一体机", "placeNm": "苏宁北京昌平物流库", "gdsCd": "600575273", "thirdGroupDesc": "洗干一体机", "vendorNm": "(冰洗)三星(中国)投资有限公司北京分公司", "deptCd": "00006", "adjustSendQty": "0", "thirdGroupCd": "R0401005", "adjustRecvQty": "0", "depotNm": "常规机库", "realPlaceType": "中心仓、门店", "areaCd": "10018", "buyInQty": "0", "cmpnyCd": "1100", "firstGroupCd": "R0401005", "frozenQty": "0", "noneGetSale": "0", "brandCd": "1659" } ] } } }
异常码 | 错误描述 | 解决方案 |
---|---|---|
biz.selfmarket.queryedaostock.format-error:* | 参数格式错误 | 请检查此参数的值,*号表示参数字段名 |
biz.selfmarket.queryedaostock.length-overlong:* | 参数的值超过规定长度 | 请检查此参数的值,*号表示参数字段名 |
biz.selfmarket.queryedaostock.missing-parameter:* | 参数必填 | 请检查此参数的值,*号表示参数字段名 |
biz.handler.data-get:no-result | 查询没结果 | 请检查查询参数 |
isp.sys.service.unavailable.sdas | 服务不可用 | 请联系苏宁技术人员 |
biz.handler.auth-validate:100 | 输入的供应商无接口访问权限 | 请联系数据运营团队开通接口权限 |
biz.handler.auth-validate:101 | 输入的供应商无易道访问权限 | 请联系数据运营团队或自行订购易道 |
biz.selfmarket.queryedaostock.invalid-biz:112 | 查询日期必须在易道查询日期范围内 | 请输入易道订购周期内的日期 |
biz.selfmarket.queryedaostock.invalid-biz:113 | 数据未按期下发 | 请联系数据运营团队 |
biz.handler.auth-validate:103 | 该账号无权调用此供应商数据 | 请用此供应商账号登陆商家工作台设置“我的店铺-申请集团合作”,或联系数据运营团队 |
异常码 | 错误描述 | 解决方案 |
---|---|---|
sys.check.user-permission:inexistence | 访问令牌不存在 | 更换访问令牌 |
sys.check.user-permission:overdue | 访问令牌已过期 | 请使用刷新令牌刷新 |
sys.check.api-permission:inexistence | Api方法不存在 | 请参考帮助中心 |
sys.check.api-permission:overdue | Api方法已过期 | 请参考帮助中心 |
sys.check.method-permission:authority | 无权操作此api | 确认是否有访问该方法权限 |
sys.auth.vendor-request:errory | 无权操作此供应商 | 请确认供应商编码是否正确 |
sys.controller.api-request:limit | Api请求受控 | 超过请求次数 |
sys.check.app-time:error | 请求参数错误api请求时间误差大 | 参考帮助中心 |
sys.check.request-params:error | 请求报文结构错误 | 参考帮助中心、日期格式等 |
sys.check.starttime-format:error | 请求开始时间错误 | 参考帮助中心、日期格式等 |
biz.handler.data-get:success | 业务数据查询成功 | 无 |
biz.handler.data-get:fail | 业务数据查询失败 | 检查请求条件 |
biz.handler.data-get:no-result | 业务数据结果为空 | 无 |
sys.check.pageno-format:error | pageNo格式错误,只允许1到99999之间的整数 | 检查pageNo输入是否有误 |
sys.check.pagesize-format:error | pageSize格式错误,只允许1到50之间的整数(订单相关是1到100) | 检查pageSize输入是否有误 |
sys.check.page-param:error | pageNo或者pageSize不在要求范围内,pageNo只允许1到99999之间的整数,pageSize只允许1到50之间的整数(订单相关是1到100) | 检查pageNo和pageSize输入是否有误 |
sys.check.miss-time:starttime | 不存在开始时间(节点) | 检查输入 |
sys.check.miss-time:endtime | 不存在结束时间(节点) | 检查输入 |
sys.check.starttime-value:null | 开始时间为空(值) | 检查输入 |
sys.check.endtime-value:null | 结束时间为空(值) | 检查输入 |
sys.check.starttime-format:error | 校验开始时间不合法,格式yyyy-MM-dd HH:mm:ss | 检查时间格式 |
sys.check.endtime-format:error | 校验结束时间不合法,格式yyyy-MM-dd HH:mm:ss | 检查时间格式 |
sys.check.query-time:error | 开始时间是否小于结束时间 | 检查开始和结束时间大小 |
sys.check.query-time:outofrange | 时间查询是否超出指定范围 | 检查时间范围 |
sys.check.app-sign:null | 签名信息为空 | 检查签名信息 |
sys.check.app-sign:error | 签名信息错误 | 检查签名信息 |
sys.check.missing-parameter:apiversion | API版本号未指定 | 检查API版本号 |
sys.check.missing-parameter:appRequestTime | 请求时间丢失 | 检查请求时间 |
sys.check.missing-nestElement:sn_body | 缺少sn_body节点 | 检查sn_body是否存在 |
sys.check.user-permission:inexistence | 用户key不存在 | 检查用户key是否存在 |
biz.handler.batch-handler:no-support | 非查询类API不支持批量操作 | 检查API类型 |
biz.handler.request-message:error | 查询类API输入多个业务节点 | 检查业务节点 |
sys.check.header-param:null | header参数为空 | 请检查header参数 |
sys.controller.api-access:limit | 访问限制 | 无 |
sys.controller.api-frequency:limit | 访问频率限制 | 无 |
sys.error.network:failure | 网络异常 | 无 |
sys.error.network-status:? | 响应失败 ?为状态码 | 无 |
sys.check.snunionid.length.is.not:48 | 混淆会员编码长度不是48位 | 使用转换器转换混淆会员编码规定要求混淆会员编码48位 |