意向单查询接口
名称 | 类型 | 是否必须 | 示例值 | 描述 |
---|---|---|---|---|
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 | 每页条数 |
orderId | String | N | P000000100090 | 申请单号,字段有值时则当唯一查询条件 |
confirmStatus | String | N | 0 | 审核状态(0-待审核;1-审核通过;2-已驳回) |
startTime | String | N | 2021-04-20 18:43:54 | 查询开始时间 |
endTime | String | N | 2021-04-20 18:43:54 | 查询结束时间 |
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
orderId | String | P000001000051 | 申请单号 |
businessNo | String | 34234234324 | 商机单号 |
detailList | String | ||
orderId | String | A1000112116136 | 申请单号 |
supplierCode | String | 70059582 | 商家编码 |
commodityCode | String | 121284997 | 苏宁商品编码 |
commodityName | String | 安泰迪扫地机器人智能吸尘器自动充电A320 | 商品名称 |
payAmount | String | 1099.00 | 支付金额 |
orderAmount | String | 修改后商品行支付金额 | 修改后商品行支付金额 |
unitPrice | String | 1099.00 | 商品行单价 |
modifyUnitPrice | String | 12.00 | 修改后商品行单价 |
salenum | String | 5 | 数量 |
orderItemId | String | P00000010032101 | 申请单行号 |
supplierCmCode | String | 4234324 | 商家商品编码 |
version | String | 12C01XGC2021A00272 | 海尔工程版号 |
salesContractUrls | String | https://sdosspre1.cnsuning.com/srcskf/sign_image/image_1621324166617?format=800h_800w | 合同文件 |
supplierCode | String | 70072038 | 商户编码 |
confirmStatus | String | 0 | 审核状态(0-待审核;1-审核通过;2-已驳回) |
orderTime | String | 2021-04-20 19:43:54 | 提交时间 |
confirmTime | String | 2021-04-20 19:43:54 | 审核时间 |
updateTime | String | 2021-04-20 19:43:54 | 最近更新时间 |
username | String | 1234567890 | 用户名 |
memNo | String | 7017972510 | 会员编码 |
countFreight | String | 5.00 | 总运费金额 |
totalPayment | String | 139.00 | 付款总金额 |
mdmRegionName | String | 江苏省 | 收件人省名称 |
mdmCityName | String | 南京市 | 收件人城市名称 |
mdmDistrictName | String | 玄武区 | 收件人区名称 |
detailAddress | String | XXX小区X幢X单元 | 收件人详细地址 |
customerName | String | 张三 | 收件人姓名 |
mobPhoneNum | String | 18112918988 | 收件人手机 |
phoneNum | String | 15951928868 | 收件人固话 |
customerAdress | String | 江苏省南京市玄武区全区XX小区XX栋 | 详细地址(省市区详细地址) |
zipCode | String | 210000 | 收件人邮编 |
reason | String | 不同意 | 拒绝原因 |
<sn_request> <sn_body> <queryApplyorder> <orderId>P000000100090</orderId> <pageNo>1</pageNo> <confirmStatus>0</confirmStatus> <pageSize>10</pageSize> <startTime>2021-04-20 18:43:54</startTime> <endTime>2021-04-20 18:43:54</endTime> </queryApplyorder> </sn_body> </sn_request>
{ "sn_request": { "sn_body": { "queryApplyorder": { "orderId": "P000000100090", "pageNo": "1", "confirmStatus": "0", "pageSize": "10", "startTime": "2021-04-20 18:43:54", "endTime": "2021-04-20 18:43:54" } } } }
<sn_responseContent> <sn_head> <totalSize>1</totalSize> <pageTotal>1</pageTotal> <pageNo>1</pageNo> <returnMessage>biz.handler.data-get:success</returnMessage> </sn_head> <sn_body> <queryApplyorder> <reason>不同意</reason> <zipCode>210000</zipCode> <orderId>P000001000051</orderId> <confirmTime>2021-04-20 19:43:54</confirmTime> <phoneNum>15951928868</phoneNum> <updateTime>2021-04-20 19:43:54</updateTime> <supplierCode>70072038</supplierCode> <mdmRegionName>江苏省</mdmRegionName> <countFreight>5.00</countFreight> <customerName>张三</customerName> <mdmDistrictName>玄武区</mdmDistrictName> <mobPhoneNum>18112918988</mobPhoneNum> <businessNo>34234234324</businessNo> <orderTime>2021-04-20 19:43:54</orderTime> <totalPayment>139.00</totalPayment> <salesContractUrls>https://sdosspre1.cnsuning.com/srcskf/sign_image/image_1621324166617?format=800h_800w</salesContractUrls> <detailList> <unitPrice>1099.00</unitPrice> <orderAmount>修改后商品行支付金额</orderAmount> <payAmount>1099.00</payAmount> <modifyUnitPrice>12.00</modifyUnitPrice> <orderId>A1000112116136</orderId> <orderItemId>P00000010032101</orderItemId> <commodityCode>121284997</commodityCode> <supplierCmCode>4234324</supplierCmCode> <salenum>5</salenum> <supplierCode>70059582</supplierCode> <version>12C01XGC2021A00272</version> <commodityName>安泰迪扫地机器人智能吸尘器自动充电A320</commodityName> </detailList> <confirmStatus>0</confirmStatus> <detailAddress>XXX小区X幢X单元</detailAddress> <memNo>7017972510</memNo> <customerAdress>江苏省南京市玄武区全区XX小区XX栋</customerAdress> <mdmCityName>南京市</mdmCityName> <username>1234567890</username> </queryApplyorder> </sn_body> </sn_responseContent>
{ "sn_responseContent": { "sn_head": { "totalSize": "1", "pageTotal": "1", "pageNo": "1", "returnMessage": "biz.handler.data-get:success" }, "sn_body": { "queryApplyorder": [ { "reason": "不同意", "zipCode": "210000", "orderId": "P000001000051", "confirmTime": "2021-04-20 19:43:54", "phoneNum": "15951928868", "updateTime": "2021-04-20 19:43:54", "supplierCode": "70072038", "mdmRegionName": "江苏省", "countFreight": "5.00", "customerName": "张三", "mdmDistrictName": "玄武区", "mobPhoneNum": "18112918988", "businessNo": "34234234324", "orderTime": "2021-04-20 19:43:54", "totalPayment": "139.00", "salesContractUrls": "https://sdosspre1.cnsuning.com/srcskf/sign_image/image_1621324166617?format=800h_800w", "detailList": [ { "unitPrice": "1099.00", "orderAmount": "修改后商品行支付金额", "payAmount": "1099.00", "modifyUnitPrice": "12.00", "orderId": "A1000112116136", "orderItemId": "P00000010032101", "commodityCode": "121284997", "supplierCmCode": "4234324", "salenum": "5", "supplierCode": "70059582", "version": "12C01XGC2021A00272", "commodityName": "安泰迪扫地机器人智能吸尘器自动充电A320" } ], "confirmStatus": "0", "detailAddress": "XXX小区X幢X单元", "memNo": "7017972510", "customerAdress": "江苏省南京市玄武区全区XX小区XX栋", "mdmCityName": "南京市", "username": "1234567890" } ] } } }
异常码 | 错误描述 | 解决方案 |
---|---|---|
biz.custom.queryapplyorder.missing-parameter:* | 参数必填 | 请检查此参数的值,*号表示参数字段名 |
biz.handler.data-get:no-result | 查询没结果 | 请检查查询参数 |
isp.sys.service.unavailable.moms | 服务不可用 | 请联系苏宁技术人员 |
biz.custom.queryapplyorder.invalid-biz:100 | supplierCode不能为空 | supplierCode不能为空 |
biz.custom.queryapplyorder.invalid-biz:100 | startTime开始时间不能为空 | startTime开始时间不能为空 |
biz.custom.queryapplyorder.invalid-biz:101 | endTime结束时间不能为空 | endTime结束时间不能为空 |
biz.custom.queryapplyorder.invalid-biz:100 | startTime开始时间格式不正确,正确格式:yyyy-MM-dd HH:mm:ss | startTime开始时间格式不正确,正确格式:yyyy-MM-dd HH:mm:ss |
biz.custom.queryapplyorder.invalid-biz:101 | endTime结束时间格式不正确,正确格式:yyyy-MM-dd HH:mm:ss | endTime结束时间格式不正确,正确格式:yyyy-MM-dd HH:mm:ss |
biz.custom.queryapplyorder.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位 |