通过此接口可根据消息类型查询消息(调用前需申请开启用户配置开关,否则返回消息数据为空)
消息返回实例:
一、 商品池消息(type=10)
0-新增,1-上架,2-下架, 3-修改,4-删除,6-图片变更
{“id”: xxxx,”type”:xxx,”cmmdtyCode”: ”xxxx”, “status”: “x”,”categoryId”: “70f7e2-c5a7-4”,”time”: “2017-10-11 12:59:00”}
二、订单消息 (type=11)
1-实时创建成功, 2-预占成功, 3-确认预占,4-取消预占
{“id”:xxxx,”type”:xxx,”orderNo”: “xxxx”, “status”: “x”,”time”: “2017-10-11 12:59:00”}
三:物流消息(type=12)
1.商品出库,2.商品妥投,3.商品拒收,4.商品退货
{“id”:xxxx,”type”:xxx,“orderNo”:“xxxx” ,” orderItemNo”:”xxx”, ”cmmdtyCode”:”xxx”,“status”: “x”,“time”: “2017-10-11 12:59:00”}
四:目录变更 (type=13)
0-新增,1-修改,2-删除
{“id”:xxxx,”type”:xxx,“oldcategoryId”: “xxxx”, “oldcategoryName”: “xxxx”,“categoryId”: “xxxx”,“categoryName”: “xxxx”,“status”: “x”,“time”: “2017-10-11 12:59:00”}
五:服务状态消息(type=14)
1-待服务,2-服务完成,3-服务取消
{“id”:xxxx,”type”:xxx,“orderNo”:“xxxx” ,” orderItemNo”:”xxx”, ”cmmdtyCode”:”xxx”,“status”: “x”,“time”: “2017-10-11 12:59:00”}
六:批量预占订单消息(type=15)
1-批量预占订单
{'id':100000453715,'type':15,'status':'1','time':'2021-11-09 10:29:18','reason':'数据处理完成','batchId':'batch1636424491344397','allCount':'3','failCount':'0','successCount':'3'}
七:支付状态 (type=16)
1-已支付,2-订单已失效(系统自动取消),3-订单已取消(用户主动取消)
{“id”:xxxx,”type”:xxx,”orderNo”:”XXXX”,”status”:”X”,“time”: “2017-10-11 12:59:00”}
八:账单消息 (type=17)
1-新增
{“id”:xxxx,”type”:xxx,”time”:”2018-12-26 10:36:31”,”status”:”x”,”pin”:”xxxx”,”billid”:”xxxx”}
九:厂送商品退换货进度消息 (type=19)
0-退换货待处理,7-同意退换货,8-不同意退换货,9-顾客寄货,10-同意退款/确认换货,11-拒绝退款/拒绝确认换货,14-换货已发货,15-退款完成/换货已收货,17-取消退换货
{“id”:xxxx,”type”:xxx,“orderNo”:“xxxx” ,” orderItemNo”:”xxx”, ”cmmdtyCode”:”xxx”, “sheetId” :“xxxx”, “status”: “x”, “reason”: “x”, “time”: “2017-10-11 12:59:00”}
十:发票消息 (type=20)
2为已开票、3为已邮寄、4为已妥投
{'id':'XXXXX','orderNo':'100000100199','orderItemNo':'10000010019901','cmmdtyCode':'XXXXXXXXXX','status': '1','invoiceType': '1',' invoiceSign': '1','markId': 'XXXXXXXXX','type': '20'}
十一:订单结算状态(type=21)
1-新增
{'id':100000445178,'type':21,'cmmdtyCode':'121347xxx','status':'1','orderNo':'10000153xxxx','orderItemNo':'1000015391xxxx','time':'2020-01-22 14:03:56'}
十二:补开发票校验状态(type=22)
1为受理通过开票中、2为受理未通过
{'id':100000445178,'type':22,'status':'1','time':'2020-01-22 14:03:56','reason':'开票成功','invoiceType':'2','markId':'157967302426578'}
十三:包裹物流(type=18) (定制服务消息,普通用户无此类型)
1为包裹出库、2为包裹妥投
{'orderNo':'100001417860','status':'1','logisticNumber':'0011314262450201'}
十四:地址变更(type=25)
1为地址新增、2为地址删除、3为地址修改
{'id':100000445178,'type':25,'status':'1','time':'2020-01-22 14:03:56','reason':'玄武区地址发生变动','level':'4','oldCode':'01','newCode':'02','oldName':'玄武区','newName':'玄武新区','provCode':'100','cityCode':'025','districtCode':'01'}
十四:线下客服退货通知(type=28)
1已退货、2已退款
{“id”:xxxx,”type”:xxx,“orderNo”:“xxxx” ,” orderItemNo”:”xxx”, ”cmmdtyCode”:”xxx”, “status”: “x” “time”: “2017-10-11 12:59:00”}
名称 | 类型 | 是否必须 | 示例值 | 描述 |
---|---|---|---|---|
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授权方式为必填参数 |
名称 | 类型 | 是否必须 | 示例值 | 描述 |
---|---|---|---|---|
type | String | Y | 10 | 消息类型:10-商品池 上架、下架、添加、删除、修改 、主图变更 11-订单 实时创建、预占成功、确认预占、取消预占、异常订单取消 12-物流 商品出库、商品妥投、商品拒收、商品退货 13-目录 添加、修改、删除 14-服务状态 待服务、服务完成、服务取消 16-支付状态 已支付、订单已取消、订单已失效 17-对账 新建账单 19-售后进度 |
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
resultInfo | String | ||
cmmdtyCode | String | 121347582 | 商品编码 |
id | String | 100 | 消息id |
orderItemNo | String | 2022505004 | 订单行号 |
orderNo | String | 100000100199 | 订单号 |
status | String | 1 | 消息状态 |
type | String | 10 | 消息类型:10-商品池 上架、下架、添加、删除、修改 、主图变更 11-订单 实时创建、预占成功、确认预占、取消预占、异常订单取消 12-物流 商品出库、商品妥投、商品拒收、商品退货 13-目录 添加、修改、删除 14-服务状态 待服务、服务完成、服务取消 16-支付状态 已支付、订单已取消、订单已失效 17-对账 新建账单 19-售后进度 |
pin | String | ceshi0807@07.com | 账号名称 |
billid | String | 201812260030007378 | 账单编号 |
logisticNumber | String | 0050134594600101 | 物流单号 |
time | String | 2017-10-11 12:59:00 | 时间 |
sheetId | String | 20190520174300193303 | 售后服务单号 |
invoiceType | String | 1 | 发票类型,1为增票,3位普票,4为电子发票 |
invoiceSign | String | 1 | 发票标识,1为蓝票,-1位红票 |
markId | String | 1234453245 | 申请单号 |
reason | String | 扣款失败 | 支付失败原因 |
oldcategoryId | String | xxxx | 修改前商品三级类目id |
oldcategoryName | String | xxxx | 修改前商品三级类目名称 |
categoryId | String | xxxx | 商品三级类目id |
categoryName | String | xxxx | 商品三级类目名称 |
oldCode | String | 01 | 变更前地址编码(地址删除和地址修改) |
oldName | String | 新街口街道 | 变更前地址名称(地址删除和地址修改) |
newCode | String | 01 | 变更后地址编码(地址新增和地址修改) |
newName | String | 新街口新街道 | 变更后地址名称(地址新增和地址修改) |
provCode | String | 200 | 省编码 |
cityCode | String | 025 | 市编码 |
districtCode | String | 01 | 区编码 |
level | String | 4 | 地址层级 |
<sn_responseContent> <sn_body> <getMessage> <resultInfo> <logisticNumber>0050134594600101</logisticNumber> <reason>扣款失败</reason> <districtCode>01</districtCode> <markId>1234453245</markId> <cityCode>025</cityCode> <cmmdtyCode>121347582</cmmdtyCode> <type>10</type> <categoryName>xxxx</categoryName> <invoiceSign>1</invoiceSign> <pin>ceshi0807@07.com</pin> <billid>201812260030007378</billid> <oldcategoryName>xxxx</oldcategoryName> <oldName>新街口街道</oldName> <invoiceType>1</invoiceType> <id>100</id> <newCode>01</newCode> <orderNo>100000100199</orderNo> <provCode>200</provCode> <level>4</level> <newName>新街口新街道</newName> <oldCode>01</oldCode> <orderItemNo>2022505004</orderItemNo> <sheetId>20190520174300193303</sheetId> <time>2017-10-11 12:59:00</time> <categoryId>xxxx</categoryId> <oldcategoryId>xxxx</oldcategoryId> <status>1</status> </resultInfo> </getMessage> </sn_body> </sn_responseContent>
{ "sn_responseContent": { "sn_body": { "getMessage": { "resultInfo": [ { "logisticNumber": "0050134594600101", "reason": "扣款失败", "districtCode": "01", "markId": "1234453245", "cityCode": "025", "cmmdtyCode": "121347582", "type": "10", "categoryName": "xxxx", "invoiceSign": "1", "pin": "ceshi0807@07.com", "billid": "201812260030007378", "oldcategoryName": "xxxx", "oldName": "新街口街道", "invoiceType": "1", "id": "100", "newCode": "01", "orderNo": "100000100199", "provCode": "200", "level": "4", "newName": "新街口新街道", "oldCode": "01", "orderItemNo": "2022505004", "sheetId": "20190520174300193303", "time": "2017-10-11 12:59:00", "categoryId": "xxxx", "oldcategoryId": "xxxx", "status": "1" } ] } } } }
异常码 | 错误描述 | 解决方案 |
---|---|---|
biz.handler.data-get:no-result | 查询没结果 | 请检查查询参数 |
biz.govbus.getmessage.missing-parameter:* | 缺少必填参数,*表示字段名 | 请输入正确参数。 |
isp.sys.service.unavailable.gcapi | 服务不可用(系统异常) | 请联系苏宁技术人员。 |
biz.govbus.getmessage.invalid-biz:100 | 输入报文格式错误 | 检查输入报文 |
biz.govbus.getmessage.invalid-biz:101 | 入参校验失败 | 检查输入参数 |
biz.govbus.getmessage.invalid-biz:102 | 会员编号错误 | 检查输入参数 |
异常码 | 错误描述 | 解决方案 |
---|---|---|
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位 |