名称 | 类型 | 是否必须 | 示例值 | 描述 |
---|---|---|---|---|
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 | 每页条数 |
storeCode | String | N | 8IT6 | 苏宁门店编码 |
appStoreCode | String | N | 952D | 商家门店编码 |
startTime | String | Y | 2019-01-01 00:00:00 | 开始时间 |
endTime | String | Y | 2019-01-01 01:00:00 | 结束时间 |
orderStatus | String | N | 10 | 订单状态 |
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
orders | String | ||
orderSerialNumber | String | 1 | 订单序号 |
shopCode | String | 952D | 苏宁门店编码 |
orderCode | String | 110000269178760065 | 订单号 |
orderStatus | String | 10 | 订单状态 |
orderTime | String | 2017-01-01 01:01:01 | 下单时间 |
omsCreateTime | String | 2017-01-01 01:01:01 | 订单销售日期 |
voucherTotalMoney | String | 2.00 | 满减优惠 |
remindshipNum | String | 1 | 催单次数 |
orderRemark | String | 不吃辣谢谢 | 买家备注 |
returnOrderFlag | String | 1 | 退款标记 |
srvMode | String | 01 | 预约/尽快送达标识 |
hopeArrivalTime | String | 2017-01-01 01:01:01 | 预约时间 |
userName | String | 王成 | 买家姓名 |
mobphoneNum | String | 1855181111 | 买家手机号 |
address | String | 江苏省南京市玄武区苏宁易购总部楼b404项目间 | 买家具体地址(完整地址,包含省市区) |
receiverLatitude | String | 118.892503 | 买家收货地址经度 |
receiverLongitude | String | 32.088447 | 买家收货地址纬度 |
commdityNum | String | 1 | 商品总件数 |
needInvoiceFlag | String | Y | 是否需要发票 |
invoiceType | String | 04 | 发票类型 |
invoiceHead | String | 江苏柏亨环保设备有限公司 | 发票抬头 |
riderMobile | String | 18626429808 | 骑手电话 |
riderName | String | 王成 | 骑手姓名 |
payAmount | String | 25.00 | 实付金额 |
srvfee | String | 0.00 | 餐盒费 |
deliveryFlag | String | 02 | 配送方式 |
distributionFee | String | 5.00 | 配送费 |
orderItems | String | ||
orderItemId | String | 110000269358433722 | 订单行号 |
cmmdtyName | String | 爆柠四季春 | 商品标题 |
refundFlag | String | 1 | 退款标识位 |
cmmdtyCode | String | 10686448992 | 苏宁商品编码 |
supplierCmCode | String | skt123233 | 商家商品编码 |
totalAmount | String | 20.00 | 行项目销售额 |
cscTotalMoney | String | 22.00 | 行云车销售价总额 |
saleQty | String | 1 | 商品件数 |
couponItems | String | ||
couponTypeCode | String | 10009 | 券类型编码 |
couponTypeName | String | 无敌券 | 券类型名称 |
couponRuleId | String | C0020034984982 | 券规则编码 |
couponRuleName | String | 小店无敌券 | 券规则名称 |
couponAmount | String | 10.00 | 优惠活动扣减金额 |
specTypeItems | String | ||
specType | String | 1 | 规格类型编码 |
specTypeName | String | 甜度 | 规格类型名称 |
specPrice | String | 0.01 | 价格 |
specContent | String | 多糖,中糖,少糖 | 规格 |
<sn_request> <sn_body> <querySidesnordersbymodifytime> <pageNo>1</pageNo> <orderStatus>10</orderStatus> <pageSize>10</pageSize> <startTime>2019-01-01 00:00:00</startTime> <endTime>2019-01-01 01:00:00</endTime> <appStoreCode>952D</appStoreCode> <storeCode>8IT6</storeCode> </querySidesnordersbymodifytime> </sn_body> </sn_request>
{ "sn_request": { "sn_body": { "querySidesnordersbymodifytime": { "pageNo": "1", "orderStatus": "10", "pageSize": "10", "startTime": "2019-01-01 00:00:00", "endTime": "2019-01-01 01:00:00", "appStoreCode": "952D", "storeCode": "8IT6" } } } }
<sn_responseContent> <sn_head> <totalSize>1</totalSize> <pageTotal>1</pageTotal> <pageNo>1</pageNo> <returnMessage>biz.handler.data-get:success</returnMessage> </sn_head> <sn_body> <querySidesnordersbymodifytime> <orders> <riderMobile>18626429808</riderMobile> <omsCreateTime>2017-01-01 01:01:01</omsCreateTime> <receiverLatitude>118.892503</receiverLatitude> <distributionFee>5.00</distributionFee> <orderRemark>不吃辣谢谢</orderRemark> <orderStatus>10</orderStatus> <returnOrderFlag>1</returnOrderFlag> <orderItems> <totalAmount>20.00</totalAmount> <orderItemId>110000269358433722</orderItemId> <cmmdtyCode>10686448992</cmmdtyCode> <cmmdtyName>爆柠四季春</cmmdtyName> <refundFlag>1</refundFlag> <supplierCmCode>skt123233</supplierCmCode> <saleQty>1</saleQty> <couponItems> <couponTypeName>无敌券</couponTypeName> <couponRuleName>小店无敌券</couponRuleName> <couponAmount>10.00</couponAmount> <couponRuleId>C0020034984982</couponRuleId> <couponTypeCode>10009</couponTypeCode> </couponItems> <specTypeItems> <specType>1</specType> <specTypeName>甜度</specTypeName> <specPrice>0.01</specPrice> <specContent>多糖,中糖,少糖</specContent> </specTypeItems> <cscTotalMoney>22.00</cscTotalMoney> </orderItems> <commdityNum>1</commdityNum> <orderTime>2017-01-01 01:01:01</orderTime> <payAmount>25.00</payAmount> <srvfee>0.00</srvfee> <invoiceType>04</invoiceType> <hopeArrivalTime>2017-01-01 01:01:01</hopeArrivalTime> <deliveryFlag>02</deliveryFlag> <shopCode>952D</shopCode> <srvMode>01</srvMode> <address>江苏省南京市玄武区苏宁易购总部楼b404项目间</address> <needInvoiceFlag>Y</needInvoiceFlag> <mobphoneNum>1855181111</mobphoneNum> <remindshipNum>1</remindshipNum> <userName>王成</userName> <riderName>王成</riderName> <voucherTotalMoney>2.00</voucherTotalMoney> <invoiceHead>江苏柏亨环保设备有限公司</invoiceHead> <orderCode>110000269178760065</orderCode> <receiverLongitude>32.088447</receiverLongitude> <orderSerialNumber>1</orderSerialNumber> </orders> </querySidesnordersbymodifytime> </sn_body> </sn_responseContent>
{ "sn_responseContent": { "sn_head": { "totalSize": "1", "pageTotal": "1", "pageNo": "1", "returnMessage": "biz.handler.data-get:success" }, "sn_body": { "querySidesnordersbymodifytime": [ { "orders": [ { "riderMobile": "18626429808", "omsCreateTime": "2017-01-01 01:01:01", "receiverLatitude": "118.892503", "distributionFee": "5.00", "orderRemark": "不吃辣谢谢", "orderStatus": "10", "returnOrderFlag": "1", "orderItems": [ { "totalAmount": "20.00", "orderItemId": "110000269358433722", "cmmdtyCode": "10686448992", "cmmdtyName": "爆柠四季春", "refundFlag": "1", "supplierCmCode": "skt123233", "saleQty": "1", "couponItems": [ { "couponTypeName": "无敌券", "couponRuleName": "小店无敌券", "couponAmount": "10.00", "couponRuleId": "C0020034984982", "couponTypeCode": "10009" } ], "specTypeItems": [ { "specType": "1", "specTypeName": "甜度", "specPrice": "0.01", "specContent": "多糖,中糖,少糖" } ], "cscTotalMoney": "22.00" } ], "commdityNum": "1", "orderTime": "2017-01-01 01:01:01", "payAmount": "25.00", "srvfee": "0.00", "invoiceType": "04", "hopeArrivalTime": "2017-01-01 01:01:01", "deliveryFlag": "02", "shopCode": "952D", "srvMode": "01", "address": "江苏省南京市玄武区苏宁易购总部楼b404项目间", "needInvoiceFlag": "Y", "mobphoneNum": "1855181111", "remindshipNum": "1", "userName": "王成", "riderName": "王成", "voucherTotalMoney": "2.00", "invoiceHead": "江苏柏亨环保设备有限公司", "orderCode": "110000269178760065", "receiverLongitude": "32.088447", "orderSerialNumber": "1" } ] } ] } } }
异常码 | 错误描述 | 解决方案 |
---|---|---|
biz.store.querysidesnordersbymodifytime.format-error:* | 参数格式错误 | 请检查此参数的值,*号表示参数字段名 |
biz.store.querysidesnordersbymodifytime.missing-parameter:* | 参数必填 | 请检查此参数的值,*号表示参数字段名 |
biz.handler.data-get:no-result | 查询没结果 | 请检查查询参数 |
isp.sys.service.unavailable.moms | 服务不可用 | 请联系苏宁技术人员 |
biz.store.querysidesnordersbymodifytime.invalid-biz:100 | 商家编码不能为空 | 公共参数有误,请稍候再试 |
biz.store.querysidesnordersbymodifytime.invalid-biz:101 | 商家编码格式不正确 | 公共参数有误,请稍候再试 |
biz.store.querysidesnordersbymodifytime.invalid-biz:102 | 开始时间不能为空 | 请输入时间 |
biz.store.querysidesnordersbymodifytime.invalid-biz:103 | 结束时间不能为空 | 请输入时间 |
biz.store.querysidesnordersbymodifytime.invalid-biz:104 | 交易开始时间格式错误 | 请输入正确时间格式:yyyy-MM-dd HH:mm:ss |
biz.store.querysidesnordersbymodifytime.invalid-biz:105 | 交易结束时间格式错误 | 请输入正确时间格式:yyyy-MM-dd HH:mm:ss |
biz.store.querysidesnordersbymodifytime.invalid-biz:106 | 开始时间不能晚于结束时间 | 请输入正确时间范围 |
biz.store.querysidesnordersbymodifytime.invalid-biz:107 | 开始时间和结束时间间隔超过1天 | 请输入正确时间范围 |
biz.store.querysidesnordersbymodifytime.invalid-biz:108 | 订单状态参数不合法 | 请输入正确参数(10-已付款 20-已接单 30-交易成功 40-已付未接单取消 50-已退单) |
biz.store.querysidesnordersbymodifytime.invalid-biz:109 | 每页数量超出正常范围 | 请输入正确页码1-99999 |
biz.store.querysidesnordersbymodifytime.invalid-biz:110 | 页码超出正常范围 | 请输入正每页数量1-100 |
biz.store.querysidesnordersbymodifytime.invalid-biz:111 | 查不到符合的数据,订单头数据为空 | 请输入正确订单号 |
biz.store.querysidesnordersbymodifytime.invalid-biz:112 | 查不到符合的数据,订单行信息为空 | 请输入正确订单号 |
biz.store.querysidesnordersbymodifytime.invalid-biz:113 | 查不到符合的数据,组合信息为空 | 请输入正确订单号 |
biz.store.querysidesnordersbymodifytime.invalid-biz:114 | 查询时间范围超出时间允许范围 | 查询到时间范围在当前时间往前三个月的时间内 |
biz.store.querysidesnordersbymodifytime.invalid-biz:115 | 商家门店编码不存在 | 传入正确商家门店编码 |
异常码 | 错误描述 | 解决方案 |
---|---|---|
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位 |