通过此接口查询未付款订单。
1.未付款订单指的是顾客在苏宁易购提交了订单,但实际未进行支付的订单。
2.可以按照订单提交时间查询未付款订单,一次请求只能查询时间跨度为一天的增量交易记录,即查询提交结束时间-查询提交开始时间<=1天。通过该接口能够查询到时间范围为在当前时间往前三个月的时间内。
3. 返回的数据结果是分页展示的,通过从后往前翻页的方式可以避免漏单问题。
4、页码和每页条数必须同时填写方可生效,否则将默认返回第1页、10条内容;
5、返回结果分页展示,通过请求参数的页码可以定位到具体第几页,每页条数控制每页返回的条数;
6、返回省、市、区代码,及中文详细地址,省、市、区代码与详细中文地址省、市、区对应;
7、订单行项目金额计算公式:实际收款=价格*数量+运费-优惠券金额-优惠单金额。整个订单的运费、优惠金额分担到每个订单行项目;
8、返回报文中订单行项目状态指订单明细状态,5表示未付款;
9、订单行项目金额计算公式:实际收款=价格*数量+运费-优惠券金额-优惠单金额。整个订单的运费、优惠金额分担到每个订单行项目;
10、订单总金额=订单行项目金额总和。 11、默认查询订单行项目状态为未付款的订单,进行结果反馈。
名称 | 类型 | 是否必须 | 示例值 | 描述 |
---|---|---|---|---|
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授权方式为必填参数 |
名称 | 类型 | 是否必须 | 示例值 | 描述 |
---|---|---|---|---|
endTime | String | Y | 2013-09-26 23:00:00 | 查询订单提交结束时间,必须大于修改开始时间(修改时间跨度不能大于一天),格式:yyyy-MM-dd HH:mm:ss。 |
orderLineStatus | String | N | 5 | 订单行状态(40取消;5未付款,默认为5未付款) |
pageNo | String | N | 1 | 当前页码,1到99999之间,当前页码或者每页数量其中一个不填则当前页码默认1 |
pageSize | String | N | 10 | 每页数量,1到100之间,如果不填写,每页数量默认为10 |
startTime | String | Y | 2013-09-20 21:06:12 | 查询订单提交开始时间(修改时间跨度不能大于一天)。格式:yyyy-MM-dd HH:mm:ss |
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
account | String | 6YUIOP3456789009876 | 开户账号 |
bank | String | 南京市白下区淮海路68号苏宁电器大厦18F | 开户行 |
buyerOrdRemark | String | 尽快发货哦 | 订单备注(买家)--买家对订单的备注信息 |
cityCode | String | 000001000173 | 城市代码 |
customerAddress | String | 江苏南京市栖霞区徐庄王庄湖 | 详细地址 |
customerName | String | 李明 | 顾客姓名 |
districtCode | String | 00000007 | 区域代码 |
invoice | String | 发票内容 | 发票内容 |
invoiceRecipientAddress | String | 南京市白下区淮海路68号苏宁电器大厦18F | 发票收件人地址 |
invoiceRecipientHandPhone | String | 18651662963 | 发票收件人手机 |
invoiceRecipientName | String | 张涛 | 发票收件人姓名 |
invoiceRecipientPhone | String | 02584418888 | 发票收件人电话 |
invoiceType | String | 增值税 | 发票类型 -- 增值还是普通(01增值 02普通 04 电子发票) |
mobNum | String | 18699999999 | 买家联系电话 |
orderCode | String | 1000531505 | B2C订单号 |
orderSubmitTime | String | 2015-09-23 10:31:33 | 订单提交时间,格式:yyyy-MM-dd HH:mm:ss。 |
orderTotalStatus | String | 10 | 订单总状态 |
provinceCode | String | 100 | 省份代码 |
registerAddress | String | 南京市白下区淮海路68号苏宁电器大厦18F | 注册地址 |
registerPhone | String | 02584418888 | 注册电话 |
sellerOrdRemark | String | 顾客要求延迟发货 | 订单备注(卖家)--商家对订单的备注信息 |
unpaidOrderDetail | String | ||
activitytype | String | 02 | 活动类型(02:渠道专享订单,03:免费试用订单,04:付邮试用订单,05,06:预定订单,07:秒杀订单,08:S码活动订单,09:赠品) |
carShopAddr | String | 南京市白下区淮宁电器大厦18F | 汽车服务门店地址 |
carShopCode | String | 1001 | 汽车服务门店编码 |
carShopName | String | 南京市鼓楼区服务站 | 汽车服务门店名称 |
carShopSerWay | String | 1 | 汽车服务方式(1-上门服务,2-到店服务) |
carShopTel | String | 02558761110 | 汽车服务门店电话 |
coupontotalMoney | String | 0.00 | 优惠劵金额 |
disType | String | 01 | 发货方式。01 代表海外直邮发货;02代表商家保税区发货;03代表苏宁保税区发货;空代表国内海外购 |
hwgFlag | String | 01 | 海外购标识。01表示海外购订单,其他值为非海外购订单 |
itemCode | String | B1001 | 商家商品编码 |
itemTaxFare | String | 10.00 | 税费 |
mode | String | 02 | 通关模式(01:保税备货,02:海外直邮,03:个人申报,04:邮关) |
orderLineNumber | String | 1000231255 | 订单行项目号 |
orderLineStatus | String | 20 | 订单行项目状态。10=待发货;20=已发货;30=交易成功 |
orderLineStatusChangeTime | String | 2016-12-10 11:12:13 | 订单行项目状态变更时间,格式:yyyy-MM-dd HH:mm:ss |
payAmount | String | 299.00 | 付款金额。订单行项目金额 |
productCode | String | 102609881 | 苏宁商品编码 |
productName | String | 销售组汤锅02 | 商品中文名称 |
receivezipCode | String | 211806 | 收货人邮政编码 |
reservebalanceamount | String | 20.00 | 预定尾款金额 |
reservedepositamount | String | 10.00 | 预定定金金额 |
reservestatus | String | M | 预定状态(M:定金已支付,P:定金已罚没,R:定金已退还) |
saleNum | String | 1 | 数量 |
transportFee | String | 0.00 | 运费。订单行项目对应的运费 |
unitPrice | String | 188.00 | 商品单价 |
vouchertotalMoney | String | 0.00 | 优惠单金额 |
otoOrderType | String | 01-一口价电子凭证 02-特权定金 03-分阶段订单 04-线下现场拿货 05-线下快递上门 06-自营配件服务行(汽车配件服务行的到家场景) 07-门店代收服务(汽车配件服务行的到店场景) 08-汽车服务行(单独售卖服务行) | O2O订单类型 |
distributorName | String | 有货测试公司001 | 分销商名称 |
orderPaymentDetails | String | ||
voucherId | String | 202104120015798000 | 优惠活动编码:指类似满减活动之类的编码 |
allocatedAmount | String | 299 | 满减等优惠活动对应的商品抵扣金额 |
referencePrice | String | 299 | 参考价(指参加促销活动的商品,在提交订单时的非活动原价) |
saleType | String | XH-TOB订单;FXH-TOC订单 | 销售类型 |
userName | String | liming@cnsuning.com | 买家帐号 |
vatTaxpayerNumber | String | WERTDTG1234567 | 增值税纳税人识别号 |
itemCounts | String | 2 | 订单行数量 |
customerAddressOld | String | 江苏南京市鼓楼区徐庄软件园 | 地址信息申请修改:修改前收货地址 |
isUpdateAddress | String | Y或者N | 是否有修改收货人信息 |
sid | String | BBDF4B492FA1878D7A73C25F5EE4DA22D425C50DDD181E50CE3D8234C4B27DD8A65CB... | customerAddress+customerName+mobNum加密字段,解密后格式为:{customerAddress:江苏省南京市玄武区玄武湖1号,customerName:张哈哈,mobNum:1865166xxxx} |
<sn_request> <sn_body> <unpaidOrder> <pageNo>1</pageNo> <pageSize>10</pageSize> <startTime>2013-09-20 21:06:12</startTime> <endTime>2013-09-26 23:00:00</endTime> <orderLineStatus>5</orderLineStatus> </unpaidOrder> </sn_body> </sn_request>
{ "sn_request": { "sn_body": { "unpaidOrder": { "pageNo": "1", "pageSize": "10", "startTime": "2013-09-20 21:06:12", "endTime": "2013-09-26 23:00:00", "orderLineStatus": "5" } } } }
<sn_responseContent> <sn_head> <totalSize>1</totalSize> <pageTotal>1</pageTotal> <pageNo>1</pageNo> <returnMessage>biz.handler.data-get:success</returnMessage> </sn_head> <sn_body> <unpaidOrder> <districtCode>00000007</districtCode> <registerPhone>02584418888</registerPhone> <cityCode>000001000173</cityCode> <orderTotalStatus>10</orderTotalStatus> <isUpdateAddress>Y或者N</isUpdateAddress> <sid>BBDF4B492FA1878D7A73C25F5EE4DA22D425C50DDD181E50CE3D8234C4B27DD8A65CB...</sid> <itemCounts>2</itemCounts> <bank>南京市白下区淮海路68号苏宁电器大厦18F</bank> <invoiceRecipientPhone>02584418888</invoiceRecipientPhone> <invoiceType>增值税</invoiceType> <invoiceRecipientHandPhone>18651662963</invoiceRecipientHandPhone> <customerAddress>江苏南京市栖霞区徐庄王庄湖</customerAddress> <provinceCode>100</provinceCode> <mobNum>18699999999</mobNum> <userName>liming@cnsuning.com</userName> <customerName>李明</customerName> <invoiceRecipientAddress>南京市白下区淮海路68号苏宁电器大厦18F</invoiceRecipientAddress> <invoiceRecipientName>张涛</invoiceRecipientName> <registerAddress>南京市白下区淮海路68号苏宁电器大厦18F</registerAddress> <unpaidOrderDetail> <carShopAddr>南京市白下区淮宁电器大厦18F</carShopAddr> <transportFee>0.00</transportFee> <otoOrderType>01-一口价电子凭证 02-特权定金 03-分阶段订单 04-线下现场拿货 05-线下快递上门 06-自营配件服务行(汽车配件服务行的到家场景) 07-门店代收服务(汽车配件服务行的到店场景) 08-汽车服务行(单独售卖服务行)</otoOrderType> <itemCode>B1001</itemCode> <saleType>XH-TOB订单;FXH-TOC订单</saleType> <carShopCode>1001</carShopCode> <carShopSerWay>1</carShopSerWay> <productName>销售组汤锅02</productName> <mode>02</mode> <distributorName>有货测试公司001</distributorName> <referencePrice>299</referencePrice> <payAmount>299.00</payAmount> <carShopName>南京市鼓楼区服务站</carShopName> <carShopTel>02558761110</carShopTel> <orderLineStatus>20</orderLineStatus> <unitPrice>188.00</unitPrice> <hwgFlag>01</hwgFlag> <reservestatus>M</reservestatus> <itemTaxFare>10.00</itemTaxFare> <saleNum>1</saleNum> <activitytype>02</activitytype> <disType>01</disType> <orderPaymentDetails> <allocatedAmount>299</allocatedAmount> <voucherId>202104120015798000</voucherId> </orderPaymentDetails> <productCode>102609881</productCode> <receivezipCode>211806</receivezipCode> <reservebalanceamount>20.00</reservebalanceamount> <reservedepositamount>10.00</reservedepositamount> <orderLineNumber>1000231255</orderLineNumber> <coupontotalMoney>0.00</coupontotalMoney> <orderLineStatusChangeTime>2016-12-10 11:12:13</orderLineStatusChangeTime> <vouchertotalMoney>0.00</vouchertotalMoney> </unpaidOrderDetail> <customerAddressOld>江苏南京市鼓楼区徐庄软件园</customerAddressOld> <orderSubmitTime>2015-09-23 10:31:33</orderSubmitTime> <vatTaxpayerNumber>WERTDTG1234567</vatTaxpayerNumber> <sellerOrdRemark>顾客要求延迟发货</sellerOrdRemark> <orderCode>1000531505</orderCode> <invoice>发票内容</invoice> <buyerOrdRemark>尽快发货哦</buyerOrdRemark> <account>6YUIOP3456789009876</account> </unpaidOrder> </sn_body> </sn_responseContent>
{ "sn_responseContent": { "sn_head": { "totalSize": "1", "pageTotal": "1", "pageNo": "1", "returnMessage": "biz.handler.data-get:success" }, "sn_body": { "unpaidOrder": [ { "districtCode": "00000007", "registerPhone": "02584418888", "cityCode": "000001000173", "orderTotalStatus": "10", "isUpdateAddress": "Y或者N", "sid": "BBDF4B492FA1878D7A73C25F5EE4DA22D425C50DDD181E50CE3D8234C4B27DD8A65CB...", "itemCounts": "2", "bank": "南京市白下区淮海路68号苏宁电器大厦18F", "invoiceRecipientPhone": "02584418888", "invoiceType": "增值税", "invoiceRecipientHandPhone": "18651662963", "customerAddress": "江苏南京市栖霞区徐庄王庄湖", "provinceCode": "100", "mobNum": "18699999999", "userName": "liming@cnsuning.com", "customerName": "李明", "invoiceRecipientAddress": "南京市白下区淮海路68号苏宁电器大厦18F", "invoiceRecipientName": "张涛", "registerAddress": "南京市白下区淮海路68号苏宁电器大厦18F", "unpaidOrderDetail": [ { "carShopAddr": "南京市白下区淮宁电器大厦18F", "transportFee": "0.00", "otoOrderType": "01-一口价电子凭证 02-特权定金 03-分阶段订单 04-线下现场拿货 05-线下快递上门 06-自营配件服务行(汽车配件服务行的到家场景) 07-门店代收服务(汽车配件服务行的到店场景) 08-汽车服务行(单独售卖服务行)", "itemCode": "B1001", "saleType": "XH-TOB订单;FXH-TOC订单", "carShopCode": "1001", "carShopSerWay": "1", "productName": "销售组汤锅02", "mode": "02", "distributorName": "有货测试公司001", "referencePrice": "299", "payAmount": "299.00", "carShopName": "南京市鼓楼区服务站", "carShopTel": "02558761110", "orderLineStatus": "20", "unitPrice": "188.00", "hwgFlag": "01", "reservestatus": "M", "itemTaxFare": "10.00", "saleNum": "1", "activitytype": "02", "disType": "01", "orderPaymentDetails": [ { "allocatedAmount": "299", "voucherId": "202104120015798000" } ], "productCode": "102609881", "receivezipCode": "211806", "reservebalanceamount": "20.00", "reservedepositamount": "10.00", "orderLineNumber": "1000231255", "coupontotalMoney": "0.00", "orderLineStatusChangeTime": "2016-12-10 11:12:13", "vouchertotalMoney": "0.00" } ], "customerAddressOld": "江苏南京市鼓楼区徐庄软件园", "orderSubmitTime": "2015-09-23 10:31:33", "vatTaxpayerNumber": "WERTDTG1234567", "sellerOrdRemark": "顾客要求延迟发货", "orderCode": "1000531505", "invoice": "发票内容", "buyerOrdRemark": "尽快发货哦", "account": "6YUIOP3456789009876" } ] } } }
异常码 | 错误描述 | 解决方案 |
---|---|---|
biz.custom.queryunpaidorder.missing-parameter:* | 参数必填 | 请检查此参数的值,*号表示参数字段名 |
biz.custom.queryunpaidorder.format-error:* | 参数格式错误 | 请检查此参数的值,*号表示参数字段名 |
biz.custom.queryhistoryorder.format-error:* | 参数格式错误 | 请检查此参数的值,*号表示参数字段名 |
biz.custom.queryhistoryorder.missing-parameter:* | 参数必填 | 请检查此参数的值,*号表示参数字段名 |
biz.handler.data-get:no-result | 查询没结果 | 请检查查询参数 |
isp.sys.service.unavailable.moms | 服务不可用 | 请联系苏宁技术人员 |
biz.custom.queryunpaidorder.invalid-biz:100 | 开始时间不能早于当前时间前三个月 | 开始时间要处于当前时间近三个月内 |
biz.custom.queryunpaidorder.invalid-biz:101 | 开始时间不能晚于结束时间 | 开始时间要早于结束时间 |
biz.custom.queryunpaidorder.invalid-biz:102 | 开始时间和结束时间间隔超过1天 | 开始时间和结束时间间隔不能超过1天 |
异常码 | 错误描述 | 解决方案 |
---|---|---|
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位 |
Q:什么是订单行项目?
A:一个订单可能包含多种商品,一种商品对应一个订单行项目。
Q:什么是订单总状态?
A:若订单存在多个订单行项目,则订单总状态为订单行项目状态的集合,有10待发货、20已发货、21部分发货、30交易成功、40交易关闭五种状态。
Q:什么是订单行项目状态?
A:订单行项目状态指订单明细状态,10表示待发货、20表示已发货、30表示交易成功三种状态。
Q:如何查看订单中商品的商家商品编码?
A:当前苏宁订单接口仅实现获取到苏宁商品编码,通过接口“suning.custom.item.get”查看对应的商家商品编码。