API接口目录

平台业务

商品API
价格API
库存API
销售准备API
交易API
退货退款API(新)
财务API
店铺API
物流API
促销API
分销API
发票API
招商API
换货API
互动营销API
退货退款API
客服API
平台营销API
风控API
会员通API
账房API
财务记账API
异常码自查工具
suning.custom.unpaidorder.query 未付款订单查询
¥免费

通过此接口查询未付款订单。
1.未付款订单指的是顾客在苏宁易购提交了订单,但实际未进行支付的订单。
2.可以按照订单提交时间查询未付款订单,一次请求只能查询时间跨度为一天的增量交易记录,即查询提交结束时间-查询提交开始时间<=1天。通过该接口能够查询到时间范围为在当前时间往前三个月的时间内。
3. 返回的数据结果是分页展示的,通过从后往前翻页的方式可以避免漏单问题。 
4、页码和每页条数必须同时填写方可生效,否则将默认返回第1页、10条内容; 
5、返回结果分页展示,通过请求参数的页码可以定位到具体第几页,每页条数控制每页返回的条数;
6、返回省、市、区代码,及中文详细地址,省、市、区代码与详细中文地址省、市、区对应;
7、订单行项目金额计算公式:实际收款=价格*数量+运费-优惠券金额-优惠单金额。整个订单的运费、优惠金额分担到每个订单行项目;
8、返回报文中订单行项目状态指订单明细状态,5表示未付款; 
9、订单行项目金额计算公式:实际收款=价格*数量+运费-优惠券金额-优惠单金额。整个订单的运费、优惠金额分担到每个订单行项目;
10、订单总金额=订单行项目金额总和。 11、默认查询订单行项目状态为未付款的订单,进行结果反馈。

公共参数
请求参数
名称 类型 是否必须 示例值 描述
endTimeStringY2013-09-26 23:00:00查询订单提交结束时间,必须大于修改开始时间(修改时间跨度不能大于一天),格式:yyyy-MM-dd HH:mm:ss。
orderLineStatusStringN5订单行状态(40取消;5未付款,默认为5未付款)
pageNoStringN1当前页码,1到99999之间,当前页码或者每页数量其中一个不填则当前页码默认1
pageSizeStringN10每页数量,1到100之间,如果不填写,每页数量默认为10
startTimeStringY2013-09-20 21:06:12查询订单提交开始时间(修改时间跨度不能大于一天)。格式:yyyy-MM-dd HH:mm:ss
响应参数
名称 类型 示例值 描述
accountString6YUIOP3456789009876开户账号
bankString南京市白下区淮海路68号苏宁电器大厦18F开户行
buyerOrdRemarkString尽快发货哦订单备注(买家)--买家对订单的备注信息
cityCodeString000001000173城市代码
customerAddressString江苏南京市栖霞区徐庄王庄湖详细地址
customerNameString李明顾客姓名
districtCodeString00000007区域代码
invoiceString发票内容发票内容
invoiceRecipientAddressString南京市白下区淮海路68号苏宁电器大厦18F发票收件人地址
invoiceRecipientHandPhoneString18651662963发票收件人手机
invoiceRecipientNameString张涛发票收件人姓名
invoiceRecipientPhoneString02584418888发票收件人电话
invoiceTypeString增值税发票类型 -- 增值还是普通(01增值 02普通 04 电子发票)
mobNumString18699999999买家联系电话
orderCodeString1000531505B2C订单号
orderSubmitTimeString2015-09-23 10:31:33订单提交时间,格式:yyyy-MM-dd HH:mm:ss。
orderTotalStatusString10订单总状态
provinceCodeString100省份代码
registerAddressString南京市白下区淮海路68号苏宁电器大厦18F注册地址
registerPhoneString02584418888注册电话
sellerOrdRemarkString顾客要求延迟发货订单备注(卖家)--商家对订单的备注信息
unpaidOrderDetailString
activitytypeString02 活动类型(02:渠道专享订单,03:免费试用订单,04:付邮试用订单,05,06:预定订单,07:秒杀订单,08:S码活动订单,09:赠品)
carShopAddrString南京市白下区淮宁电器大厦18F汽车服务门店地址
carShopCodeString1001汽车服务门店编码
carShopNameString南京市鼓楼区服务站汽车服务门店名称
carShopSerWayString1汽车服务方式(1-上门服务,2-到店服务)
carShopTelString02558761110汽车服务门店电话
coupontotalMoneyString0.00优惠劵金额
disTypeString01发货方式。01 代表海外直邮发货;02代表商家保税区发货;03代表苏宁保税区发货;空代表国内海外购
hwgFlagString01海外购标识。01表示海外购订单,其他值为非海外购订单
itemCodeStringB1001商家商品编码
itemTaxFareString10.00税费
modeString02通关模式(01:保税备货,02:海外直邮,03:个人申报,04:邮关)
orderLineNumberString1000231255订单行项目号
orderLineStatusString20订单行项目状态。10=待发货;20=已发货;30=交易成功
orderLineStatusChangeTimeString2016-12-10 11:12:13订单行项目状态变更时间,格式:yyyy-MM-dd HH:mm:ss
payAmountString299.00付款金额。订单行项目金额
productCodeString102609881苏宁商品编码
productNameString销售组汤锅02商品中文名称
receivezipCodeString211806收货人邮政编码
reservebalanceamountString20.00预定尾款金额
reservedepositamountString10.00预定定金金额
reservestatusStringM预定状态(M:定金已支付,P:定金已罚没,R:定金已退还)
saleNumString1数量
transportFeeString0.00运费。订单行项目对应的运费
unitPriceString188.00商品单价
vouchertotalMoneyString0.00优惠单金额
otoOrderTypeString01-一口价电子凭证 02-特权定金 03-分阶段订单 04-线下现场拿货 05-线下快递上门 06-自营配件服务行(汽车配件服务行的到家场景) 07-门店代收服务(汽车配件服务行的到店场景) 08-汽车服务行(单独售卖服务行)O2O订单类型
distributorNameString有货测试公司001分销商名称
orderPaymentDetailsString
voucherIdString202104120015798000优惠活动编码:指类似满减活动之类的编码
allocatedAmountString299满减等优惠活动对应的商品抵扣金额
referencePriceString299参考价(指参加促销活动的商品,在提交订单时的非活动原价)
saleTypeStringXH-TOB订单;FXH-TOC订单销售类型
userNameStringliming@cnsuning.com买家帐号
vatTaxpayerNumberStringWERTDTG1234567增值税纳税人识别号
itemCountsString2订单行数量
customerAddressOldString江苏南京市鼓楼区徐庄软件园地址信息申请修改:修改前收货地址
isUpdateAddressStringY或者N是否有修改收货人信息
sidStringBBDF4B492FA1878D7A73C25F5EE4DA22D425C50DDD181E50CE3D8234C4B27DD8A65CB...customerAddress+customerName+mobNum加密字段,解密后格式为:{customerAddress:江苏省南京市玄武区玄武湖1号,customerName:张哈哈,mobNum:1865166xxxx}
请求示例
  • XML示例
  • JSON示例
复制全部代码
                                
<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"
      }
    }
  }
}
			
                                
响应示例
  • XML示例
  • JSON示例
复制全部代码
                              
<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"
        }
      ]
    }
  }
}
			
                              
异常示例
  • XML示例
  • JSON示例
复制全部代码

  
  	API异常码
  	异常码中文描述
  

                           	  
{
  "sn_responseContent": {
    "sn_error": {
      "error_code": "API异常码",
      "error_msg": "异常码中文描述"
    }
  }
}
                           		
业务异常码
异常码 错误描述 解决方案
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天
公共异常码
API工具
FAQ

Q:什么是订单行项目?

A:一个订单可能包含多种商品,一种商品对应一个订单行项目。

Q:什么是订单总状态?

A:若订单存在多个订单行项目,则订单总状态为订单行项目状态的集合,有10待发货、20已发货、21部分发货、30交易成功、40交易关闭五种状态。

Q:什么是订单行项目状态?

A:订单行项目状态指订单明细状态,10表示待发货、20表示已发货、30表示交易成功三种状态。

Q:如何查看订单中商品的商家商品编码?

A:当前苏宁订单接口仅实现获取到苏宁商品编码,通过接口“suning.custom.item.get”查看对应的商家商品编码。