返回API列表
异常码自查工具
suning.custom.order.query 批量获取订单(三个月内的订单)

通过此接口可批量获取三个月内的订单。 
1、通过该接口能够查询到时间范围在当前时间往前三个月的时间内,产生的订单信息; 
2、查询时交易开始时间和交易结束时间间隔不能超过31天; 
3、页码和每页条数必须同时填写方可生效,否则将默认返回第1页、10条内容;
4、返回结果分页展示,通过请求参数的页码可以定位到具体第几页,每页条数控制每页返回的条数;
5、返回省、市、区代码与中文名称,及中文详细地址,省、市、区代码与详细中文地址省、市、区对应;
6、商户商品编码可依据苏宁商品编码,通过平台业务->商品服务->获取我的商品库信息精确查询接口获取;
7、请求参数中订单状态指当前订单总状态,有10待发货、20已发货、21部分发货、30交易成功、40交易关闭五种状态,只能填写一种或不填; 
8、订单行项目金额计算公式:实际收款=价格*数量+运费-优惠券金额-优惠单金额。整个订单的运费、优惠金额分担到每个订单行项目; 
9、返回报文中订单行项目状态指订单明细状态,10表示待发货、20表示已发货、30表示交易成功三种状态; 
10、退货订单标示位为1时,表示订单行项目为退货状态;
11、订单行项目金额计算公式:实际收款=价格*数量+运费-优惠券金额-优惠单金额。整个订单的运费、优惠金额分担到每个订单行项目;
12、订单总金额=订单行项目金额总和。

公共参数
请求参数
名称 类型 是否必须 示例值 描述
endTimeStringY2013-09-26 23:00:00查询交易创建结束时间。格式:yyyy-MM-dd HH:mm:ss
orderStatusStringN20订单头状态(10:买家已付款,20:卖家已发货,21:部分发货,30:交易成功,40:交易关闭)
pageNoStringN1页码
pageSizeStringN10每页条数
startTimeStringY2013-09-20 21:06:12查询交易创建开始时间。格式:yyyy-MM-dd HH:mm:ss
userNameStringN123@qq.com买家名称
userIDStringN7017925352会员编码
响应参数
名称 类型 示例值 描述
accountString6YUIOP3456789009876开户账号
bankString南京市白下区淮海路68号苏宁电器大厦18F开户行
buyerOrdRemarkString尽快发货哦订单备注(买家)--买家对订单的备注信息
cityCodeString000001000173城市代码
cityNameString南京收件人地址(市)中文
customerAddressString江苏南京市栖霞区徐庄王庄湖详细地址
customerNameString李明顾客姓名
districtCodeString00000007区域代码
districtNameString玄武区收件人地址(区)中文
evaluationMarkString0评价状态。0=未评价;1=已评价
invoiceString发票内容发票内容
invoiceHeadString李明李明
invoiceRecipientAddressString南京市白下区淮海路68号苏宁电器大厦18F发票收件人地址
invoiceRecipientHandPhoneString18651662963发票收件人手机
invoiceRecipientNameString张涛发票收件人姓名
invoiceRecipientPhoneString02584418888发票收件人电话
invoiceTypeString增值税发票类型 -- 增值还是普通(01增值 02普通 04 电子发票)
mobNumString18699999999买家联系电话
needinvoiceflagStringY是否需要发票(Y:需要,N:不需要)
orderCodeString1000531505B2C订单号
orderDetailString
activitytypeString02 活动类型(02:渠道专享订单,03:免费试用订单,04:付邮试用订单,05,06:预定订单,07:秒杀订单,08:S码活动订单,09:赠品)
bLineNumberString90004000001b2c行项目号
carShopAddrString南京市白下区淮宁电器大厦18F汽车服务门店地址
carShopCodeString1001汽车服务门店编码
carShopNameString南京市鼓楼区服务站汽车服务门店名称
carShopSerWayString1汽车服务方式(1-上门服务,2-到店服务)
carShopTelString02558761110汽车服务门店电话
couponListString
coupontypeString8012 券类型。券类型表示返券返积分的类型:5998-店铺优惠券、6998-联合0元购券、7998-0元购券、8012-积分抵现、9994-优惠券、9995-优惠券。
sharelimitString20.00销售单据分摊金额。订单返券返积分总金额需每个行项目的销售单据分摊额度累计。
coupontotalMoneyString0.00优惠劵金额
declareGoodsAmountString30.00申报订单行货款
declareItemPriceString20.00申报单价
declareItemTaxfareString2.00申报税费
disTypeString01发货方式。01 代表海外直邮发货;02代表商家保税区发货;03代表苏宁保税区发货;空代表国内海外购
expresscompanycodeStringE01物流公司编码
expressnoStringEMS1001运单号
fpsdeliveryflagString04PS发货标示,1代表4PS发货、0代表C店发货
hwgFlagString01海外购标识。01表示海外购订单,其他值为非海外购订单
invCodeStringD01仓库编码
isProsupplierDeliveryString1是否供应商发货标识,1代表是
itemCodeStringB1001商家商品编码
itemTaxFareString10.00税费
modeString02通关模式(01:保税备货,02:海外直邮,03:个人申报,04:邮关)
orderchannelStringMOBILE订单渠道。PC,手机MOBILE,WAP, 电话PHONE
orderLineNumberString1000231255订单行项目号
orderLineStatusString20订单行项目状态。10=待发货;20=已发货;30=交易成功
packageorderidString00000000100001785834包裹号
payAmountString299.00付款金额。订单行项目金额
payerCustomerNameString张三支付人姓名
payerIdNumberString342111198811212222支付人身份证号码
paymentListString
banktypecodeString1006支付方式编码。表示对订单使用的券用积分类型:5998-店铺优惠券、6998-联合0元购券、7998-0元购券、8012-积分抵现、9994-优惠券、9995-优惠券、10001-云券、10002-限品类云券、10003-店铺云券、10004-易券、10005-限品类易券、10006-店铺易券、10009-无敌券。
offLinePayFlagString1线下支付:1;非线下支付:空值
payamountString10.00支付方式分摊金额。订单使用劵和积分总金额需每个行项目的支付方式分摊金额累计。
paycodeString4148付款方式。4148-易付宝支付、5002-礼品卡支付、9003-门店付款、6901-券或云钻支付、6903-易付宝优惠券支付、2037-光大MIS银行卡(新)、1001-现金 (CASH)、2044-建行MIS银行卡(新)、6906-赠品支付、4237-支付宝支付、4245-微信支付、6915-铜板支付。
merchantPercentString商家: 50.00%商家的承担比例
platformPercentString平台: 50.00%平台的承担比例
payorderidStringP00000000100001785834支付单号
phoneIdentifyCodeString102003303202手机串码
prmtcodeString01推广方式。取值为01时,表示网盟
productCodeString102609881苏宁商品编码
productNameString销售组汤锅02商品中文名称
receivezipCodeString211806收货人邮政编码
reservebalanceamountString20.00预定尾款金额
reservedepositamountString10.00预定定金金额
reservestatusStringM预定状态(M:定金已支付,P:定金已罚没,R:定金已退还)
returnOrderFlagString0退货订单标示位 0表示正常订单, 1表示退货订单
saleNumString1数量
transportFeeString0.00运费。订单行项目对应的运费
unitPriceString188.00商品单价
vouchertotalMoneyString0.00优惠单金额
serviceItemFlagString10非服务行 ,1服务行
otoOrderTypeString01-一口价电子凭证 02-特权定金 03-分阶段订单 04-线下现场拿货 05-线下快递上门 06-自营配件服务行(汽车配件服务行的到家场景) 07-门店代收服务(汽车配件服务行的到店场景) 08-汽车服务行(单独售卖服务行)O2O订单类型
depositmoneyString1.00押金
rentperiodString1租期
renttypeString01租期类型
orderServiceTypeMultiString10组合的订单业务类型逗号隔开
orderSaleTimeString2015-09-23 10:31:33订单支付时间,格式:yyyy-MM-dd HH:mm:ss
orderTotalStatusString10订单总状态
payTotalAmountString110.00支付金额,支付方式的支付金额
payTypeString礼品卡支付方式支付方式,如礼品卡支付
provinceCodeString100省份代码
provinceNameString江苏收件人地址(省)中文
registerAddressString南京市白下区淮海路68号苏宁电器大厦18F注册地址
registerPhoneString02584418888注册电话
sellerOrdRemarkString顾客要求延迟发货订单备注(卖家)--商家对订单的备注信息
userNameStringliming@cnsuning.com买家帐号
vatTaxpayerNumberStringWERTDTG1234567纳税人识别号
请求示例
  • XML示例
  • JSON示例
复制全部代码


<sn_request>
  <sn_body>
    <orderQuery>
      <startTime>2013-09-20 21:06:12</startTime>
      <userID>7017925352</userID>
      <pageNo>1</pageNo>
      <pageSize>10</pageSize>
      <userName>123@qq.com</userName>
      <endTime>2013-09-26 23:00:00</endTime>
      <orderStatus>20</orderStatus>
    </orderQuery>
  </sn_body>
</sn_request>

			
			
								


{
  "sn_request": {
    "sn_body": {
      "orderQuery": {
        "startTime": "2013-09-20 21:06:12",
        "userID": "7017925352",
        "pageNo": "1",
        "pageSize": "10",
        "userName": "123@qq.com",
        "endTime": "2013-09-26 23:00:00",
        "orderStatus": "20"
      }
    }
  }
}
			
			
                                
响应示例
  • XML示例
  • JSON示例
复制全部代码


<sn_responseContent>
  <sn_body>
    <orderQuery>
      <mobNum>18699999999</mobNum>
      <orderCode>1000531505</orderCode>
      <invoice>发票内容</invoice>
      <provinceCode>100</provinceCode>
      <cityName>南京</cityName>
      <cityCode>000001000173</cityCode>
      <provinceName>江苏</provinceName>
      <registerAddress>南京市白下区淮海路68号苏宁电器大厦18F</registerAddress>
      <invoiceRecipientHandPhone>18651662963</invoiceRecipientHandPhone>
      <registerPhone>02584418888</registerPhone>
      <invoiceRecipientAddress>南京市白下区淮海路68号苏宁电器大厦18F</invoiceRecipientAddress>
      <invoiceHead>李明</invoiceHead>
      <buyerOrdRemark>尽快发货哦</buyerOrdRemark>
      <payTotalAmount>110.00</payTotalAmount>
      <vatTaxpayerNumber>WERTDTG1234567</vatTaxpayerNumber>
      <invoiceRecipientPhone>02584418888</invoiceRecipientPhone>
      <userName>liming@cnsuning.com</userName>
      <bank>南京市白下区淮海路68号苏宁电器大厦18F</bank>
      <orderSaleTime>2015-09-23 10:31:33</orderSaleTime>
      <customerName>李明</customerName>
      <needinvoiceflag>Y</needinvoiceflag>
      <orderTotalStatus>10</orderTotalStatus>
      <invoiceType>增值税</invoiceType>
      <sellerOrdRemark>顾客要求延迟发货</sellerOrdRemark>
      <evaluationMark>0</evaluationMark>
      <districtName>玄武区</districtName>
      <districtCode>00000007</districtCode>
      <orderDetail>
        <phoneIdentifyCode>102003303202</phoneIdentifyCode>
        <hwgFlag>01</hwgFlag>
        <reservestatus>M</reservestatus>
        <declareGoodsAmount>30.00</declareGoodsAmount>
        <expressno>EMS1001</expressno>
        <unitPrice>188.00</unitPrice>
        <reservedepositamount>10.00</reservedepositamount>
        <carShopName>南京市鼓楼区服务站</carShopName>
        <expresscompanycode>E01</expresscompanycode>
        <depositmoney>1.00</depositmoney>
        <saleNum>1</saleNum>
        <orderchannel>MOBILE</orderchannel>
        <transportFee>0.00</transportFee>
        <packageorderid>00000000100001785834</packageorderid>
        <mode>02</mode>
        <invCode>D01</invCode>
        <couponList>
          <sharelimit>20.00</sharelimit>
          <coupontype>8012</coupontype>
        </couponList>
        <returnOrderFlag>0</returnOrderFlag>
        <vouchertotalMoney>0.00</vouchertotalMoney>
        <orderServiceTypeMulti>10</orderServiceTypeMulti>
        <serviceItemFlag>1</serviceItemFlag>
        <declareItemPrice>20.00</declareItemPrice>
        <activitytype>02</activitytype>
        <otoOrderType>01-一口价电子凭证 02-特权定金 03-分阶段订单 04-线下现场拿货 05-线下快递上门 06-自营配件服务行(汽车配件服务行的到家场景) 07-门店代收服务(汽车配件服务行的到店场景) 08-汽车服务行(单独售卖服务行)</otoOrderType>
        <orderLineNumber>1000231255</orderLineNumber>
        <fpsdeliveryflag>0</fpsdeliveryflag>
        <carShopSerWay>1</carShopSerWay>
        <bLineNumber>90004000001</bLineNumber>
        <paymentList>
          <banktypecode>1006</banktypecode>
          <merchantPercent>商家: 50.00%</merchantPercent>
          <platformPercent>平台: 50.00%</platformPercent>
          <offLinePayFlag>1</offLinePayFlag>
          <payamount>10.00</payamount>
          <paycode>4148</paycode>
        </paymentList>
        <orderLineStatus>20</orderLineStatus>
        <itemCode>B1001</itemCode>
        <payAmount>299.00</payAmount>
        <itemTaxFare>10.00</itemTaxFare>
        <receivezipCode>211806</receivezipCode>
        <productCode>102609881</productCode>
        <prmtcode>01</prmtcode>
        <payerCustomerName>张三</payerCustomerName>
        <reservebalanceamount>20.00</reservebalanceamount>
        <coupontotalMoney>0.00</coupontotalMoney>
        <carShopCode>1001</carShopCode>
        <carShopAddr>南京市白下区淮宁电器大厦18F</carShopAddr>
        <payorderid>P00000000100001785834</payorderid>
        <renttype>01</renttype>
        <isProsupplierDelivery>1</isProsupplierDelivery>
        <disType>01</disType>
        <declareItemTaxfare>2.00</declareItemTaxfare>
        <rentperiod>1</rentperiod>
        <carShopTel>02558761110</carShopTel>
        <payerIdNumber>342111198811212222</payerIdNumber>
        <productName>销售组汤锅02</productName>
      </orderDetail>
      <invoiceRecipientName>张涛</invoiceRecipientName>
      <customerAddress>江苏南京市栖霞区徐庄王庄湖</customerAddress>
      <account>6YUIOP3456789009876</account>
      <payType>礼品卡支付方式</payType>
    </orderQuery>
  </sn_body>
  <sn_head>
    <pageTotal>1</pageTotal>
    <pageNo>1</pageNo>
    <totalSize>1</totalSize>
    <returnMessage>biz.handler.data-get:success</returnMessage>
  </sn_head>
</sn_responseContent>

			
			
                                


{
  "sn_responseContent": {
    "sn_head": {
      "pageTotal": "1",
      "pageNo": "1",
      "totalSize": "1",
      "returnMessage": "biz.handler.data-get:success"
    },
    "sn_body": {
      "orderQuery": [
        {
          "orderCode": "1000531505",
          "mobNum": "18699999999",
          "invoice": "发票内容",
          "cityName": "南京",
          "provinceCode": "100",
          "cityCode": "000001000173",
          "provinceName": "江苏",
          "invoiceRecipientHandPhone": "18651662963",
          "registerAddress": "南京市白下区淮海路68号苏宁电器大厦18F",
          "registerPhone": "02584418888",
          "invoiceRecipientAddress": "南京市白下区淮海路68号苏宁电器大厦18F",
          "invoiceHead": "李明",
          "buyerOrdRemark": "尽快发货哦",
          "payTotalAmount": "110.00",
          "vatTaxpayerNumber": "WERTDTG1234567",
          "invoiceRecipientPhone": "02584418888",
          "userName": "liming@cnsuning.com",
          "bank": "南京市白下区淮海路68号苏宁电器大厦18F",
          "orderSaleTime": "2015-09-23 10:31:33",
          "customerName": "李明",
          "needinvoiceflag": "Y",
          "orderTotalStatus": "10",
          "invoiceType": "增值税",
          "sellerOrdRemark": "顾客要求延迟发货",
          "districtName": "玄武区",
          "evaluationMark": "0",
          "districtCode": "00000007",
          "orderDetail": [
            {
              "phoneIdentifyCode": "102003303202",
              "hwgFlag": "01",
              "reservestatus": "M",
              "expressno": "EMS1001",
              "declareGoodsAmount": "30.00",
              "unitPrice": "188.00",
              "carShopName": "南京市鼓楼区服务站",
              "reservedepositamount": "10.00",
              "expresscompanycode": "E01",
              "depositmoney": "1.00",
              "orderchannel": "MOBILE",
              "saleNum": "1",
              "transportFee": "0.00",
              "packageorderid": "00000000100001785834",
              "mode": "02",
              "invCode": "D01",
              "couponList": [
                {
                  "sharelimit": "20.00",
                  "coupontype": "8012"
                }
              ],
              "returnOrderFlag": "0",
              "vouchertotalMoney": "0.00",
              "orderServiceTypeMulti": "10",
              "serviceItemFlag": "1",
              "declareItemPrice": "20.00",
              "activitytype": "02",
              "orderLineNumber": "1000231255",
              "otoOrderType": "01-一口价电子凭证 02-特权定金 03-分阶段订单 04-线下现场拿货 05-线下快递上门 06-自营配件服务行(汽车配件服务行的到家场景) 07-门店代收服务(汽车配件服务行的到店场景) 08-汽车服务行(单独售卖服务行)",
              "fpsdeliveryflag": "0",
              "bLineNumber": "90004000001",
              "carShopSerWay": "1",
              "paymentList": [
                {
                  "banktypecode": "1006",
                  "merchantPercent": "商家: 50.00%",
                  "platformPercent": "平台: 50.00%",
                  "offLinePayFlag": "1",
                  "payamount": "10.00",
                  "paycode": "4148"
                }
              ],
              "orderLineStatus": "20",
              "itemCode": "B1001",
              "payAmount": "299.00",
              "itemTaxFare": "10.00",
              "receivezipCode": "211806",
              "productCode": "102609881",
              "prmtcode": "01",
              "payerCustomerName": "张三",
              "reservebalanceamount": "20.00",
              "coupontotalMoney": "0.00",
              "carShopCode": "1001",
              "carShopAddr": "南京市白下区淮宁电器大厦18F",
              "payorderid": "P00000000100001785834",
              "renttype": "01",
              "isProsupplierDelivery": "1",
              "disType": "01",
              "declareItemTaxfare": "2.00",
              "rentperiod": "1",
              "carShopTel": "02558761110",
              "payerIdNumber": "342111198811212222",
              "productName": "销售组汤锅02"
            }
          ],
          "invoiceRecipientName": "张涛",
          "customerAddress": "江苏南京市栖霞区徐庄王庄湖",
          "payType": "礼品卡支付方式",
          "account": "6YUIOP3456789009876"
        }
      ]
    }
  }
}
			
			
                                
异常示例
  • XML示例
  • JSON示例
复制全部代码

  
  	API异常码
  	异常码中文描述
  

                           	  
{
  "sn_responseContent": {
    "sn_error": {
      "error_code": "API异常码",
      "error_msg": "异常码中文描述"
    }
  }
} 								  
                           		
业务异常码
异常码 错误描述 解决方案
isp.sys.service.unavailable.moms 服务不可用 请联系苏宁技术人员
biz.custom.queryorder.missing-parameter:* 参数必填 请检查此参数的值,*号表示参数字段名
biz.custom.queryorder.format-error:* 参数格式错误 请检查此参数的值,*号表示参数字段名
biz.handler.data-get:no-result 查询没结果 请检查查询参数
biz.custom.queryorder.invalid-biz:100 查询范围超过当前时间之前的三个月内 查询范围要在系统时间近三个月内
biz.custom.queryorder.invalid-biz:101 开始时间不能晚于结束时间 开始时间早于结束时间
biz.custom.queryorder.invalid-biz:102 开始时间和结束时间间隔超过31天 开始时间和结束时间间隔不能超过31天
biz.custom.queryorder.invalid-biz:103 pageSize不为空并且不能超过限定值 pageSize不为空并且不能超过限定值
公共异常码
API工具
FAQ

Q:什么是订单行项目?

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

Q:什么是订单总状态?

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

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

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

Q:订单中获取的城市代码如何查看对应的城市名称?

A:当前苏宁订单接口仅实现获取到城市代码,通过接口“suning.custom.city.query”查看对应的城市名称 。

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

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