通过此接口可进行单笔订单的查询。
1、订单号可通过批量获取订单号API、推送已付款订单API、推送已确认订单API、推送已完成订单API获取;
2、订单状态指当前订单总状态,10-已付款 20-已接单 30-交易成功 40-已付未接单取消 50-已退单;
3、订单的实付款=行项目销售额+配送费+餐盒费-满减优惠-优惠劵优惠;
名称 | 类型 | 是否必须 | 示例值 | 描述 |
---|---|---|---|---|
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授权方式为必填参数 |
名称 | 类型 | 是否必须 | 示例值 | 描述 |
---|---|---|---|---|
orderCode | String | Y | 34234234234234 | 订单号 |
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
orderSerialNumber | String | 1 | 订单序号 |
shopCode | String | 952D | 苏宁门店编码 |
supplierShopCode | 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 | 多糖,中糖,少糖 | 规格 |
orderPayItems | String | ||
payCode | String | 6901 | 支付方式编码 |
payName | String | 微信支付 | 支付方式名称 |
payAmount | String | 1.00 | 支付方式分摊金额 |
payTime | String | 2019-12-01 00:11:22 | 支付时间 |
alipayPayNo | String | 1231313 | 支付流水号 |
bankTypeCode | String | 9994 | 银行种类编码 |
bankTypeName | String | 中国银行 | 银行种类名称 |
cardNo | String | 银行卡号 | 银行卡号 |
<sn_responseContent> <sn_body> <querySidesnoneorder> <remindShipNum>1</remindShipNum> <riderMobile>18626429808</riderMobile> <omsCreateTime>2017-01-01 01:01:01</omsCreateTime> <receiverLatitude>118.892503</receiverLatitude> <orderRemark>不吃辣谢谢</orderRemark> <distributionFee>5.00</distributionFee> <orderStatus>10</orderStatus> <returnOrderFlag>1</returnOrderFlag> <orderItems> <totalAmount>20.00</totalAmount> <orderPayItems> <payAmount>1.00</payAmount> <payTime>2019-12-01 00:11:22</payTime> <bankTypeCode>9994</bankTypeCode> <bankTypeName>中国银行</bankTypeName> <alipayPayNo>1231313</alipayPayNo> <payCode>6901</payCode> <payName>微信支付</payName> <cardNo>银行卡号</cardNo> </orderPayItems> <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> <orderTime>2017-01-01 01:01:01</orderTime> <commdityNum>1</commdityNum> <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> <userName>王成</userName> <voucherTotalMoney>2.00</voucherTotalMoney> <riderName>王成</riderName> <invoiceHead>江苏柏亨环保设备有限公司</invoiceHead> <supplierShopCode>952D</supplierShopCode> <orderCode>110000269178760065</orderCode> <receiverLongitude>32.088447</receiverLongitude> <orderSerialNumber>1</orderSerialNumber> </querySidesnoneorder> </sn_body> </sn_responseContent>
{ "sn_responseContent": { "sn_body": { "querySidesnoneorder": { "remindShipNum": "1", "riderMobile": "18626429808", "omsCreateTime": "2017-01-01 01:01:01", "receiverLatitude": "118.892503", "orderRemark": "不吃辣谢谢", "distributionFee": "5.00", "orderStatus": "10", "returnOrderFlag": "1", "orderItems": [ { "totalAmount": "20.00", "orderPayItems": [ { "payAmount": "1.00", "payTime": "2019-12-01 00:11:22", "bankTypeCode": "9994", "bankTypeName": "中国银行", "alipayPayNo": "1231313", "payCode": "6901", "payName": "微信支付", "cardNo": "银行卡号" } ], "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" } ], "orderTime": "2017-01-01 01:01:01", "commdityNum": "1", "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", "userName": "王成", "voucherTotalMoney": "2.00", "riderName": "王成", "invoiceHead": "江苏柏亨环保设备有限公司", "supplierShopCode": "952D", "orderCode": "110000269178760065", "receiverLongitude": "32.088447", "orderSerialNumber": "1" } } } }
异常码 | 错误描述 | 解决方案 |
---|---|---|
biz.store.querysidesnoneorder.missing-parameter:* | 参数必填 | 请检查此参数的值,*号表示参数字段名 |
biz.store.querysidesnoneorder.format-error:* | 参数格式错误 | 请检查此参数的值,*号表示参数字段名 |
biz.handler.data-get:no-result | 查询没结果 | 请检查查询参数 |
isp.sys.service.unavailable.moms | 服务不可用 | 请联系苏宁技术人员 |
biz.store.querysidesnoneorder.invalid-biz:100 | 商家编码不能为空 | 公共参数获取有误,请稍后再试 |
biz.store.querysidesnoneorder.invalid-biz:101 | 订单号不能为空 | 请输入订单号 |
biz.store.querysidesnoneorder.invalid-biz:102 | 商家编码格式不正确 | 公共参数获取有误,请稍后再试 |
biz.store.querysidesnoneorder.invalid-biz:103 | 查不到符合的数据,订单头为空 | 请输入正确订单号 |
biz.store.querysidesnoneorder.invalid-biz:104 | 查不到符合的数据,订单行信息为空 | 请输入正确订单号 |
biz.store.querysidesnoneorder.invalid-biz:105 | 查不到符合的数据,组合数据为空 | 请输入正确订单号 |
异常码 | 错误描述 | 解决方案 |
---|---|---|
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位 |