API接口目录

政企业务

政企商品API
政企价格API
政企库存API
政企订单API
政企物流API
政企发票API
政企售后API
政企其他API
政企易企购API
政企抽检API
异常码自查工具
suning.govbus.batchqueryorder.query 批量预占订单结果查询接口
¥免费

用户侧按批次号查询预定订单创建结果时使用

公共参数
请求参数
名称 类型 是否必须 示例值 描述
batchIdStringY1000001批次号(唯一)
pageNumStringY1当前页码
pgSizeStringY50每页条数
响应参数
名称 类型 示例值 描述
orderInfoString
successStringtrue下单成功或失败:true成功,false失败
orderIdString100000100078苏宁订单号(唯一)
orderPriceString100订单总金额
freightString0运费
receiveNameString张飞收货人姓名
addressString江苏省南京市玄武区苏宁大道113号收货人详细地址
telephoneString010-84728989收货人座机号
mobileString17856789012收货人手机号
emailStringxxx@xxx.com收货人电子邮箱
zipString210000收货人邮编
skuInfoListString
skuIdString121347746商品编号
numString2购买商品数量
unitPriceString100商品单价
nameString商品名称商品名称
taxString0.09商品税率
taxPriceString1.28商品税额
nakedPriceString8.91商品未税价
goodsString1商品类型 1-普通商品
orderItemIdString10000010007801苏宁订单行号(唯一)
errorInfoString订单失败原因返回行订单失败原因,如无值,则返回空
tradeNoString1000001交易单号,用户未传值时,不返回
reasonString整单失败原因整单失败原因
totalPageString3总页数
pageNumString1当前页码
orderSumString300总条数
请求示例
  • XML示例
  • JSON示例
复制全部代码
                                
<sn_request>
  <sn_body>
    <queryBatchqueryorder>
      <pgSize>50</pgSize>
      <batchId>1000001</batchId>
      <pageNum>1</pageNum>
    </queryBatchqueryorder>
  </sn_body>
</sn_request>

			
                                
                                
{
  "sn_request": {
    "sn_body": {
      "queryBatchqueryorder": {
        "pgSize": "50",
        "batchId": "1000001",
        "pageNum": "1"
      }
    }
  }
}
			
                                
响应示例
  • XML示例
  • JSON示例
复制全部代码
                              
<sn_responseContent>
  <sn_body>
    <queryBatchqueryorder>
      <totalPage>3</totalPage>
      <orderInfo>
        <zip>210000</zip>
        <reason>整单失败原因</reason>
        <address>江苏省南京市玄武区苏宁大道113号</address>
        <tradeNo>1000001</tradeNo>
        <orderId>100000100078</orderId>
        <freight>0</freight>
        <mobile>17856789012</mobile>
        <telephone>010-84728989</telephone>
        <skuInfoList>
          <unitPrice>100</unitPrice>
          <nakedPrice>8.91</nakedPrice>
          <orderItemId>10000010007801</orderItemId>
          <num>2</num>
          <name>商品名称</name>
          <errorInfo>订单失败原因</errorInfo>
          <goods>1</goods>
          <taxPrice>1.28</taxPrice>
          <tax>0.09</tax>
          <skuId>121347746</skuId>
        </skuInfoList>
        <receiveName>张飞</receiveName>
        <success>true</success>
        <orderPrice>100</orderPrice>
        <email>xxx@xxx.com</email>
      </orderInfo>
      <orderSum>300</orderSum>
      <pageNum>1</pageNum>
    </queryBatchqueryorder>
  </sn_body>
</sn_responseContent>

			
                              
                              
{
  "sn_responseContent": {
    "sn_body": {
      "queryBatchqueryorder": {
        "totalPage": "3",
        "orderInfo": [
          {
            "zip": "210000",
            "reason": "整单失败原因",
            "address": "江苏省南京市玄武区苏宁大道113号",
            "tradeNo": "1000001",
            "orderId": "100000100078",
            "freight": "0",
            "mobile": "17856789012",
            "telephone": "010-84728989",
            "skuInfoList": [
              {
                "unitPrice": "100",
                "nakedPrice": "8.91",
                "orderItemId": "10000010007801",
                "num": "2",
                "name": "商品名称",
                "errorInfo": "订单失败原因",
                "goods": "1",
                "taxPrice": "1.28",
                "tax": "0.09",
                "skuId": "121347746"
              }
            ],
            "receiveName": "张飞",
            "success": "true",
            "orderPrice": "100",
            "email": "xxx@xxx.com"
          }
        ],
        "orderSum": "300",
        "pageNum": "1"
      }
    }
  }
}
			
                              
异常示例
  • XML示例
  • JSON示例
复制全部代码

  
  	API异常码
  	异常码中文描述
  

                           	  
{
  "sn_responseContent": {
    "sn_error": {
      "error_code": "API异常码",
      "error_msg": "异常码中文描述"
    }
  }
}
                           		
业务异常码
异常码 错误描述 解决方案
biz.govbus.querybatchqueryorder.missing-parameter:* 参数必填 请检查此参数的值,*号表示参数字段名
biz.handler.data-get:no-result 查询没结果 请检查查询参数
isp.sys.service.unavailable.gcapi 服务不可用 请联系苏宁技术人员
biz.govbus.querybatchqueryorder.invalid-biz:100 输入报文格式错误 输入报文格式错误
biz.govbus.querybatchqueryorder.invalid-biz:101 入参校验失败 入参校验失败,请检查入参
biz.govbus.querybatchqueryorder.invalid-biz:102 接口调用异常 接口调用异常,请联系苏宁技术人员
biz.govbus.querybatchqueryorder.invalid-biz:103 未查询到本批次号对应的订单信息,请核对后重新调用 未查询到本批次号对应的订单信息,请核对后重新调用
biz.govbus.querybatchqueryorder.invalid-biz:104 该批次订单正在等待处理中,请稍后查询 该批次订单正在等待处理中,请稍后查询
biz.govbus.querybatchqueryorder.invalid-biz:106 每页最大长度50 每页最大长度50
biz.govbus.querybatchqueryorder.invalid-biz:105 本批次订单类型为:必须整单成功,订单编号为[orderGrade]的订单预占失败,失败原因:returnMsg 本批次订单类型为:必须整单成功,订单编号为[orderGrade]的订单预占失败,失败原因:returnMsg
公共异常码
API工具
FAQ